@sift-wiki/conductor 0.0.0 → 0.2.0-beta.1

package/dist/conductorClient.d.ts

@@ -0,0 +1,443 @@
+import { type WorkArtifactInput, type WorkChildTaskInput, type WorkDisposition, type WorkDispositionResponse, type CreateWorkTaskRequest, type UpdateWorkTaskRequest } from "./workTypes.js";
+import type { ClaimedJob, ConductorAgent, ConductorAgentAdvertisement, ConductorClient, JsonObject, LeaseRefresh, PairConductorRequest, PairConductorResponse, RunEvent, RunEventInput } from "./types.js";
+export type FetchLike = (url: string, init: RequestInit) => Promise<Response>;
+export declare class ConductorApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly requestId?: string | undefined;
+    readonly name = "ConductorApiError";
+    constructor(status: number, code: string, message: string, requestId?: string | undefined);
+}
+export declare class ConductorHttpClient implements ConductorClient {
+    private readonly baseUrl;
+    private readonly fetch;
+    private readonly userWorkspaceId;
+    constructor(input: {
+        apiBaseUrl: string;
+        userWorkspaceId?: string | undefined;
+        fetch?: FetchLike;
+    });
+    pair(request: PairConductorRequest): Promise<PairConductorResponse>;
+    heartbeat(credential: string, request: {
+        version?: string;
+        protocolVersion?: string;
+        capabilities?: JsonObject;
+    }): Promise<unknown>;
+    advertiseAgents(credential: string, agents: ConductorAgentAdvertisement[]): Promise<ConductorAgent[]>;
+    claimJob(credential: string): Promise<ClaimedJob | undefined>;
+    refreshLease(credential: string, jobId: string): Promise<LeaseRefresh>;
+    appendRunEvent(credential: string, runId: string, event: RunEventInput): Promise<RunEvent>;
+    completeRun(credential: string, runId: string, resultSummary: JsonObject): Promise<unknown>;
+    failRun(credential: string, runId: string, errorSummary: JsonObject): Promise<unknown>;
+    acknowledgeCancellation(credential: string, runId: string, resultSummary: JsonObject): Promise<unknown>;
+    readWorkContext(credential: string, runId: string, taskId: string): Promise<{
+        schemaVersion: "sift-agent-run/v1";
+        workspaceId: string;
+        brainId: string;
+        runId: string;
+        agentPrincipalId: string;
+        task: {
+            id: string;
+            title: string;
+            bodyMarkdown: string;
+            status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+            priority: "critical" | "high" | "medium" | "low";
+            projectId?: string | undefined;
+            parentTaskId?: string | undefined;
+        };
+        wake: {
+            requestId: string;
+            source: "assignment" | "manual" | "routine" | "comment" | "approval" | "system";
+            reason: string;
+            payload?: Record<string, unknown> | undefined;
+        };
+        comments: {
+            id: string;
+            authorPrincipalId: string;
+            bodyMarkdown: string;
+            createdAt: string;
+        }[];
+        blockers: {
+            taskId: string;
+            title: string;
+            status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+        }[];
+        contextRefs: string[];
+        limits: {
+            hardStop: boolean;
+            maxRunMinutes?: number | undefined;
+            remainingCostMicros?: number | undefined;
+        };
+        pendingApproval?: {
+            id: string;
+            type: string;
+            payload: Record<string, unknown>;
+        } | undefined;
+    }>;
+    checkoutTask(credential: string, runId: string, taskId: string): Promise<{
+        [x: string]: unknown;
+        id: string;
+        workspaceId: string;
+        brainId: string;
+        title: string;
+        bodyMarkdown: string;
+        versionNumber: number;
+        status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+        priority: "critical" | "high" | "medium" | "low";
+        contextRefs: string[];
+        createdAt: string;
+        updatedAt: string;
+        projectId?: string | undefined;
+        parentTaskId?: string | undefined;
+        assigneePrincipalId?: string | undefined;
+        checkoutRunId?: string | undefined;
+    }>;
+    createChildTasks(credential: string, runId: string, taskId: string, children: WorkChildTaskInput[]): Promise<{
+        [x: string]: unknown;
+        id: string;
+        workspaceId: string;
+        brainId: string;
+        title: string;
+        bodyMarkdown: string;
+        versionNumber: number;
+        status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+        priority: "critical" | "high" | "medium" | "low";
+        contextRefs: string[];
+        createdAt: string;
+        updatedAt: string;
+        projectId?: string | undefined;
+        parentTaskId?: string | undefined;
+        assigneePrincipalId?: string | undefined;
+        checkoutRunId?: string | undefined;
+    }[]>;
+    addTaskComment(credential: string, runId: string, taskId: string, bodyMarkdown: string): Promise<{
+        [x: string]: unknown;
+        id: string;
+        taskId: string;
+        authorPrincipalId: string;
+        bodyMarkdown: string;
+        createdAt: string;
+        runId?: string | undefined;
+    }>;
+    registerArtifact(credential: string, runId: string, taskId: string, artifact: WorkArtifactInput): Promise<{
+        [x: string]: unknown;
+        id: string;
+        taskId: string;
+        type: string;
+        provider: string;
+        title: string;
+        status: "pending" | "ready" | "failed" | "superseded";
+        reviewState: "pending" | "none" | "approved" | "rejected" | "revision_requested";
+        metadata: Record<string, unknown>;
+        runId?: string | undefined;
+        url?: string | undefined;
+        brainRecordId?: string | undefined;
+        summary?: string | undefined;
+    }>;
+    requestApproval(credential: string, runId: string, taskId: string, request: {
+        type: string;
+        payload?: JsonObject;
+        idempotencyKey?: string;
+    }): Promise<{
+        [x: string]: unknown;
+        id: string;
+        taskId: string;
+        type: string;
+        status: "pending" | "approved" | "rejected" | "revision_requested";
+        payload: Record<string, unknown>;
+        decisionNote?: string | undefined;
+    }>;
+    reportUsage(credential: string, runId: string, taskId: string, usage: {
+        eventKey: string;
+        costMicros: number;
+        durationMs: number;
+    }): Promise<{
+        usageEvent: {
+            [x: string]: unknown;
+            id: string;
+            runId: string;
+            taskId: string;
+            eventKey: string;
+            costMicros: number;
+            durationMs: number;
+        };
+        effectiveLimits: {
+            hardStop: boolean;
+            maxRunMinutes?: number | undefined;
+            remainingCostMicros?: number | undefined;
+        };
+        hardStop: boolean;
+    }>;
+    setTaskDisposition(credential: string, runId: string, taskId: string, disposition: WorkDisposition, resultSummary?: JsonObject): Promise<WorkDispositionResponse>;
+    listTasks(userCredential: string, projectId?: string): Promise<{
+        [x: string]: unknown;
+        id: string;
+        workspaceId: string;
+        brainId: string;
+        title: string;
+        bodyMarkdown: string;
+        versionNumber: number;
+        status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+        priority: "critical" | "high" | "medium" | "low";
+        contextRefs: string[];
+        createdAt: string;
+        updatedAt: string;
+        projectId?: string | undefined;
+        parentTaskId?: string | undefined;
+        assigneePrincipalId?: string | undefined;
+        checkoutRunId?: string | undefined;
+    }[]>;
+    listRuns(userCredential: string, taskId?: string): Promise<{
+        id: string;
+        runId: string;
+        conductorAgentId: string;
+        localKey: string;
+        adapterType: string;
+        objective: string;
+        contextRefs: string[];
+        limits: Record<string, unknown>;
+        status: string;
+        attempts: number;
+        taskRecordId?: string | undefined;
+        wakeRequestId?: string | undefined;
+        leaseExpiresAt?: string | undefined;
+        wakeEnvelope?: {
+            schemaVersion: "sift-agent-run/v1";
+            workspaceId: string;
+            brainId: string;
+            runId: string;
+            agentPrincipalId: string;
+            task: {
+                id: string;
+                title: string;
+                bodyMarkdown: string;
+                status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+                priority: "critical" | "high" | "medium" | "low";
+                projectId?: string | undefined;
+                parentTaskId?: string | undefined;
+            };
+            wake: {
+                requestId: string;
+                source: "assignment" | "manual" | "routine" | "comment" | "approval" | "system";
+                reason: string;
+                payload?: Record<string, unknown> | undefined;
+            };
+            comments: {
+                id: string;
+                authorPrincipalId: string;
+                bodyMarkdown: string;
+                createdAt: string;
+            }[];
+            blockers: {
+                taskId: string;
+                title: string;
+                status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+            }[];
+            contextRefs: string[];
+            limits: {
+                hardStop: boolean;
+                maxRunMinutes?: number | undefined;
+                remainingCostMicros?: number | undefined;
+            };
+            pendingApproval?: {
+                id: string;
+                type: string;
+                payload: Record<string, unknown>;
+            } | undefined;
+        } | undefined;
+    }[]>;
+    listProjects(userCredential: string): Promise<{
+        [x: string]: unknown;
+        id: string;
+        name: string;
+        status: "cancelled" | "planned" | "active" | "completed";
+        contextRefs: string[];
+        members: {
+            [x: string]: unknown;
+            principalId: string;
+            role: "lead" | "member" | "reviewer";
+        }[];
+        updatedAt: string;
+        description?: string | undefined;
+        leadPrincipalId?: string | undefined;
+    }[]>;
+    readTaskDetail(userCredential: string, taskId: string): Promise<{
+        [x: string]: unknown;
+        task: {
+            [x: string]: unknown;
+            id: string;
+            workspaceId: string;
+            brainId: string;
+            title: string;
+            bodyMarkdown: string;
+            versionNumber: number;
+            status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+            priority: "critical" | "high" | "medium" | "low";
+            contextRefs: string[];
+            createdAt: string;
+            updatedAt: string;
+            projectId?: string | undefined;
+            parentTaskId?: string | undefined;
+            assigneePrincipalId?: string | undefined;
+            checkoutRunId?: string | undefined;
+        };
+        comments: {
+            [x: string]: unknown;
+            id: string;
+            taskId: string;
+            authorPrincipalId: string;
+            bodyMarkdown: string;
+            createdAt: string;
+            runId?: string | undefined;
+        }[];
+        artifacts: {
+            [x: string]: unknown;
+            id: string;
+            taskId: string;
+            type: string;
+            provider: string;
+            title: string;
+            status: "pending" | "ready" | "failed" | "superseded";
+            reviewState: "pending" | "none" | "approved" | "rejected" | "revision_requested";
+            metadata: Record<string, unknown>;
+            runId?: string | undefined;
+            url?: string | undefined;
+            brainRecordId?: string | undefined;
+            summary?: string | undefined;
+        }[];
+        approvals: {
+            [x: string]: unknown;
+            id: string;
+            taskId: string;
+            type: string;
+            status: "pending" | "approved" | "rejected" | "revision_requested";
+            payload: Record<string, unknown>;
+            decisionNote?: string | undefined;
+        }[];
+        blockers: {
+            [x: string]: unknown;
+            id: string;
+            workspaceId: string;
+            brainId: string;
+            title: string;
+            bodyMarkdown: string;
+            versionNumber: number;
+            status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+            priority: "critical" | "high" | "medium" | "low";
+            contextRefs: string[];
+            createdAt: string;
+            updatedAt: string;
+            projectId?: string | undefined;
+            parentTaskId?: string | undefined;
+            assigneePrincipalId?: string | undefined;
+            checkoutRunId?: string | undefined;
+        }[];
+        projectContextRefs: string[];
+    }>;
+    listActivity(userCredential: string, taskId?: string): Promise<{
+        [x: string]: unknown;
+        id: string;
+        action: string;
+        entityType: string;
+        entityId: string;
+        occurredAt: string;
+        metadata: Record<string, unknown>;
+        taskId?: string | undefined;
+        runId?: string | undefined;
+    }[]>;
+    createWorkTask(userCredential: string, input: CreateWorkTaskRequest): Promise<{
+        [x: string]: unknown;
+        id: string;
+        workspaceId: string;
+        brainId: string;
+        title: string;
+        bodyMarkdown: string;
+        versionNumber: number;
+        status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+        priority: "critical" | "high" | "medium" | "low";
+        contextRefs: string[];
+        createdAt: string;
+        updatedAt: string;
+        projectId?: string | undefined;
+        parentTaskId?: string | undefined;
+        assigneePrincipalId?: string | undefined;
+        checkoutRunId?: string | undefined;
+    }>;
+    updateWorkTask(userCredential: string, input: UpdateWorkTaskRequest): Promise<{
+        [x: string]: unknown;
+        id: string;
+        workspaceId: string;
+        brainId: string;
+        title: string;
+        bodyMarkdown: string;
+        versionNumber: number;
+        status: "backlog" | "todo" | "in_progress" | "in_review" | "blocked" | "done" | "cancelled";
+        priority: "critical" | "high" | "medium" | "low";
+        contextRefs: string[];
+        createdAt: string;
+        updatedAt: string;
+        projectId?: string | undefined;
+        parentTaskId?: string | undefined;
+        assigneePrincipalId?: string | undefined;
+        checkoutRunId?: string | undefined;
+    }>;
+    addHumanTaskComment(userCredential: string, taskId: string, bodyMarkdown: string): Promise<{
+        [x: string]: unknown;
+        id: string;
+        taskId: string;
+        authorPrincipalId: string;
+        bodyMarkdown: string;
+        createdAt: string;
+        runId?: string | undefined;
+    }>;
+    dispatchWorkTask(userCredential: string, input: {
+        taskId: string;
+        conductorAgentId: string;
+        reason?: string | undefined;
+        idempotencyKey: string;
+    }): Promise<unknown>;
+    decideWorkApproval(userCredential: string, input: {
+        approvalId: string;
+        decision: "approved" | "rejected" | "revision_requested";
+        decisionNote?: string | undefined;
+    }): Promise<{
+        [x: string]: unknown;
+        id: string;
+        taskId: string;
+        type: string;
+        status: "pending" | "approved" | "rejected" | "revision_requested";
+        payload: Record<string, unknown>;
+        decisionNote?: string | undefined;
+    }>;
+    cancelUserRun(userCredential: string, runId: string): Promise<unknown>;
+    listUserRunEvents(userCredential: string, runId: string, after?: number): Promise<{
+        id: string;
+        runId: string;
+        sequence: number;
+        eventType: "cancelled" | "failed" | "completed" | "health" | "progress" | "log" | "artifact" | "approval_requested";
+        payload: Record<string, unknown>;
+        occurredAt: string;
+    }[]>;
+    createPairingCode(userCredential: string, displayName: string): Promise<{
+        [x: string]: unknown;
+        id: string;
+        code: string;
+        displayName: string;
+        expiresAt: string;
+    }>;
+    listConductorAgents(userCredential: string, conductorId: string): Promise<{
+        id: string;
+        agentPrincipalId: string;
+        localKey: string;
+        displayName: string;
+        adapterType: string;
+        status: "active" | "inactive";
+        capabilities: Record<string, unknown>;
+    }[]>;
+    private post;
+    private get;
+    private request;
+    private workPath;
+    private userPath;
+    private url;
+}