actor
└── actor project              (binds an actor + an agent)
    ├── board item (task)      (description + schedule)
    └── thread                 (runtime conversation + tool calls)

import { ai } from "@wacht/backend";

const { actor } = await ai.lookupActor({
  subject_type: "user",
  external_key: "ext-1234",
});
if (!actor) {
  // No actor for that external key yet — call createActor.
}

use wacht::models::LookupActorParams;

let response = client
    .ai()
    .actors()
    .lookup_actor(LookupActorParams {
        subject_type: "user".into(),
        external_key: "ext-1234".into(),
    })
    .send()
    .await?;
let actor = response.actor;

import { ai } from "@wacht/backend";

const delegation = await ai.delegateProjectTask(projectId, {
  target_lane_thread_id: "thread_id",
  title: "Run the data-validation lane",
  description: "Validate the rows produced by the ingestion thread.",
  capability_tags: ["data-validation"],
});
// delegation.task_key, delegation.board_item_id, delegation.assigned_agent_id

use wacht::models::DelegateProjectTaskRequest;

let delegation = client
    .ai()
    .actor_projects()
    .delegate_task(
        project_id,
        DelegateProjectTaskRequest {
            target_lane_thread_id: "thread_id".into(),
            title: "Run the data-validation lane".into(),
            description: Some("Validate the rows produced by the ingestion thread.".into()),
            capability_tags: Some(vec!["data-validation".into()]),
        },
    )
    .send()
    .await?;

import { ai } from "@wacht/backend";

const file = await ai.downloadProjectTaskBoardItemFilesystemFile(
  projectId,
  itemId,
  "/output/report.pdf",
);
// file.data is a Uint8Array; file.mime_type and file.file_name come from response headers.

let file = client
    .ai()
    .actor_projects()
    .download_board_item_filesystem_file(project_id, item_id, "/output/report.pdf")
    .send()
    .await?;
// file.data: Vec<u8>; file.mime_type / file.file_name parsed from headers.