@sift-wiki/conductor 0.0.0 → 0.1.0

package/dist/runtime/runEventRetryBuffer.js

@@ -0,0 +1,118 @@
+import { redactLocalLogMessage } from "./localLogSpool.js";
+const DEFAULT_MAX_ENTRIES = 1_000;
+const DEFAULT_RETRY_DELAY_MS = 5_000;
+export class RunEventRetryBuffer {
+    maxEntries;
+    retryDelayMs;
+    nowMs;
+    entries = [];
+    nextId = 1;
+    droppedEntries = 0;
+    constructor(options = {}) {
+        this.maxEntries = positiveIntegerOrDefault(options.maxEntries, DEFAULT_MAX_ENTRIES);
+        this.retryDelayMs = positiveIntegerOrDefault(options.retryDelayMs, DEFAULT_RETRY_DELAY_MS);
+        this.nowMs = options.nowMs ?? (() => Date.now());
+    }
+    enqueue(input) {
+        const now = this.nowMs();
+        const entry = {
+            id: `retry-event-${String(this.nextId)}`,
+            runId: input.runId,
+            event: cloneRunEvent(input.event),
+            attempts: 0,
+            enqueuedAt: now,
+            nextAttemptAt: now,
+            lastErrorMessage: safeErrorMessage(input.error),
+        };
+        this.nextId += 1;
+        this.entries.push(entry);
+        this.enforceBounds();
+        return cloneEntry(entry);
+    }
+    list() {
+        return this.entries.map((entry) => cloneEntry(entry));
+    }
+    due(nowMs = this.nowMs()) {
+        return this.entries
+            .filter((entry) => entry.nextAttemptAt <= nowMs)
+            .map((entry) => cloneEntry(entry));
+    }
+    stats() {
+        return {
+            retainedEntries: this.entries.length,
+            droppedEntries: this.droppedEntries,
+        };
+    }
+    recordDelivered(id) {
+        const index = this.entries.findIndex((entry) => entry.id === id);
+        if (index === -1) {
+            return false;
+        }
+        this.entries.splice(index, 1);
+        return true;
+    }
+    recordFailure(id, error) {
+        const entry = this.entries.find((candidate) => candidate.id === id);
+        if (entry === undefined) {
+            return false;
+        }
+        entry.attempts += 1;
+        entry.nextAttemptAt = this.nowMs() + this.retryDelayMs;
+        entry.lastErrorMessage = safeErrorMessage(error);
+        return true;
+    }
+    async flushDue(deliver, nowMs = this.nowMs()) {
+        const dueEntries = this.entries.filter((entry) => entry.nextAttemptAt <= nowMs);
+        for (const entry of dueEntries) {
+            try {
+                await deliver(cloneEntry(entry));
+                this.recordDelivered(entry.id);
+            }
+            catch (error) {
+                this.recordFailure(entry.id, error);
+            }
+        }
+    }
+    clear() {
+        this.entries.splice(0, this.entries.length);
+        this.droppedEntries = 0;
+    }
+    enforceBounds() {
+        const overLimit = this.entries.length - this.maxEntries;
+        if (overLimit <= 0) {
+            return;
+        }
+        this.entries.splice(0, overLimit);
+        this.droppedEntries += overLimit;
+    }
+}
+function cloneEntry(entry) {
+    return {
+        ...entry,
+        event: cloneRunEvent(entry.event),
+    };
+}
+function cloneRunEvent(event) {
+    return {
+        ...event,
+        ...(event.payload === undefined ? {} : { payload: structuredClone(event.payload) }),
+    };
+}
+function safeErrorMessage(error) {
+    if (error === undefined) {
+        return undefined;
+    }
+    const raw = error instanceof Error
+        ? error.message
+        : typeof error === "string"
+            ? error
+            : "Unknown retryable event delivery failure.";
+    return redactLocalLogMessage(raw).message;
+}
+function positiveIntegerOrDefault(value, fallback) {
+    if (value === undefined || !Number.isInteger(value) || value < 1) {
+        return fallback;
+    }
+    return value;
+}
+//# sourceMappingURL=runEventRetryBuffer.js.map

package/dist/runtime/runEventRetryBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runEventRetryBuffer.js","sourceRoot":"","sources":["../../src/runtime/runEventRetryBuffer.ts"],"names":[],"mappings":"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"}

package/dist/runtime/runtimeService.d.ts

@@ -0,0 +1,27 @@
+import type { DaemonOnceResult, RunDaemonOnceInput } from "../daemon.js";
+export type RuntimeServiceState = "stopped" | "starting" | "running" | "stopping" | "failed";
+export type RuntimeServiceStatus = {
+    state: RuntimeServiceState;
+    startedAt?: string | undefined;
+    stoppedAt?: string | undefined;
+    lastResult?: DaemonOnceResult | undefined;
+    lastErrorMessage?: string | undefined;
+};
+export declare class HeadlessRuntimeService {
+    private readonly input;
+    private state;
+    private startedAt;
+    private stoppedAt;
+    private lastResult;
+    private lastErrorMessage;
+    private controller;
+    private runPromise;
+    constructor(input: Omit<RunDaemonOnceInput, "signal">);
+    status(): RuntimeServiceStatus;
+    runOnce(): Promise<DaemonOnceResult>;
+    start(): Promise<RuntimeServiceStatus>;
+    stop(): Promise<RuntimeServiceStatus>;
+    restart(): Promise<RuntimeServiceStatus>;
+    waitUntilStopped(): Promise<RuntimeServiceStatus>;
+    private runUntilStopped;
+}

package/dist/runtime/runtimeService.js

@@ -0,0 +1,112 @@
+import { runDaemon, runDaemonOnce } from "../daemon.js";
+import { redactSecrets } from "../redaction.js";
+export class HeadlessRuntimeService {
+    input;
+    state = "stopped";
+    startedAt;
+    stoppedAt;
+    lastResult;
+    lastErrorMessage;
+    controller;
+    runPromise;
+    constructor(input) {
+        this.input = input;
+    }
+    status() {
+        return {
+            state: this.state,
+            startedAt: this.startedAt,
+            stoppedAt: this.stoppedAt,
+            lastResult: this.lastResult,
+            lastErrorMessage: this.lastErrorMessage,
+        };
+    }
+    async runOnce() {
+        if (this.state === "running" || this.state === "starting" || this.state === "stopping") {
+            throw new Error("Conductor runtime is already active.");
+        }
+        this.state = "starting";
+        this.startedAt = new Date().toISOString();
+        this.stoppedAt = undefined;
+        this.lastErrorMessage = undefined;
+        try {
+            this.state = "running";
+            const result = await runDaemonOnce(this.input);
+            this.lastResult = result;
+            this.state = "stopped";
+            this.stoppedAt = new Date().toISOString();
+            return result;
+        }
+        catch (error) {
+            this.state = "failed";
+            this.stoppedAt = new Date().toISOString();
+            this.lastErrorMessage = safeRuntimeErrorMessage(error);
+            throw error;
+        }
+    }
+    async start() {
+        await Promise.resolve();
+        if (this.state === "running" || this.state === "starting") {
+            return this.status();
+        }
+        if (this.state === "stopping") {
+            throw new Error("Conductor runtime is stopping.");
+        }
+        const controller = new AbortController();
+        this.controller = controller;
+        this.state = "starting";
+        this.startedAt = new Date().toISOString();
+        this.stoppedAt = undefined;
+        this.lastErrorMessage = undefined;
+        this.runPromise = this.runUntilStopped(controller);
+        this.state = "running";
+        return this.status();
+    }
+    async stop() {
+        if (this.controller === undefined || this.runPromise === undefined) {
+            this.state = this.state === "failed" ? "failed" : "stopped";
+            return this.status();
+        }
+        this.state = "stopping";
+        this.controller.abort();
+        await this.runPromise;
+        return this.status();
+    }
+    async restart() {
+        await this.stop();
+        return this.start();
+    }
+    async waitUntilStopped() {
+        await this.runPromise;
+        return this.status();
+    }
+    runUntilStopped(controller) {
+        return runDaemon({ ...this.input, signal: controller.signal })
+            .then(() => {
+            if (this.controller !== controller) {
+                return;
+            }
+            this.state = "stopped";
+            this.stoppedAt = new Date().toISOString();
+            this.controller = undefined;
+            this.runPromise = undefined;
+        })
+            .catch((error) => {
+            if (this.controller !== controller) {
+                return;
+            }
+            this.state = "failed";
+            this.stoppedAt = new Date().toISOString();
+            this.lastErrorMessage = safeRuntimeErrorMessage(error);
+            this.controller = undefined;
+            this.runPromise = undefined;
+        });
+    }
+}
+function safeRuntimeErrorMessage(error) {
+    if (error instanceof Error) {
+        return redactSecrets(error.message);
+    }
+    return "Unknown Conductor runtime failure.";
+}
+//# sourceMappingURL=runtimeService.js.map

package/dist/runtime/runtimeService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeService.js","sourceRoot":"","sources":["../../src/runtime/runtimeService.ts"],"names":[],"mappings":"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"}

package/dist/runtime/sleep.d.ts

@@ -0,0 +1,2 @@
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+export declare function isAbortError(error: unknown): boolean;

package/dist/runtime/sleep.js

@@ -0,0 +1,21 @@
+export function sleep(ms, signal) {
+    if (signal?.aborted === true) {
+        return Promise.reject(abortError());
+    }
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(resolve, ms);
+        signal?.addEventListener("abort", () => {
+            clearTimeout(timeout);
+            reject(abortError());
+        }, { once: true });
+    });
+}
+export function isAbortError(error) {
+    return error instanceof Error && error.name === "AbortError";
+}
+function abortError() {
+    const error = new Error("Operation aborted.");
+    error.name = "AbortError";
+    return error;
+}
+//# sourceMappingURL=sleep.js.map

package/dist/runtime/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/runtime/sleep.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,EAAU,EAAE,MAAoB;IACpD,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,EAAE,gBAAgB,CACtB,OAAO,EACP,GAAG,EAAE;YACH,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvB,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;AAC/D,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/runtime/taskExecution.d.ts

@@ -0,0 +1,16 @@
+import type { ConductorClient, ConductorWorkClient, ClaimedJob } from "../types.js";
+export type TaskExecutionClient = Pick<ConductorWorkClient, "readWorkContext" | "checkoutTask" | "createChildTasks" | "addTaskComment" | "registerArtifact" | "requestApproval" | "reportUsage" | "setTaskDisposition">;
+export type OpenTaskExecution = {
+    taskId: string;
+    bridgeBaseUrl: string;
+    bridgeToken: string;
+    close(): Promise<void>;
+};
+export declare function openTaskExecution(input: {
+    coreClient: Pick<ConductorClient, "appendRunEvent">;
+    workClient: TaskExecutionClient;
+    credential: string;
+    job: ClaimedJob;
+    onHardStop?: (() => void) | undefined;
+}): Promise<OpenTaskExecution>;
+export declare function taskIdFromJob(job: ClaimedJob): string;

package/dist/runtime/taskExecution.js

@@ -0,0 +1,74 @@
+import { createLocalBridgeHandler } from "../bridge/handler.js";
+import { startLocalBridgeServer } from "../bridge/server.js";
+import { LocalBridgeSessionRegistry } from "../bridge/sessionRegistry.js";
+export async function openTaskExecution(input) {
+    const taskId = taskIdFromJob(input.job);
+    await input.workClient.checkoutTask(input.credential, input.job.runId, taskId);
+    const sessions = new LocalBridgeSessionRegistry();
+    const session = sessions.create({
+        runId: input.job.runId,
+        taskId,
+        scopes: allTaskScopes(),
+        ttlMs: bridgeSessionTtlMs(input.job),
+    });
+    const handler = createLocalBridgeHandler({
+        sessions,
+        client: bridgeClient(input.coreClient, input.workClient),
+        machineCredential: input.credential,
+        onHardStop: input.onHardStop,
+    });
+    const server = await startLocalBridgeServer({ handle: handler });
+    return {
+        taskId,
+        bridgeBaseUrl: server.baseUrl,
+        bridgeToken: session.runToken,
+        async close() {
+            sessions.revoke(input.job.runId);
+            await server.close();
+        },
+    };
+}
+export function taskIdFromJob(job) {
+    const taskId = job.wakeEnvelope?.task.id ?? job.taskRecordId;
+    if (taskId === undefined)
+        throw new Error("Task-linked wake has no task id.");
+    if (job.wakeEnvelope !== undefined) {
+        if (job.wakeEnvelope.runId !== job.runId)
+            throw new Error("Wake run does not match claimed job.");
+        if (job.taskRecordId !== undefined && job.taskRecordId !== job.wakeEnvelope.task.id) {
+            throw new Error("Wake task does not match claimed job.");
+        }
+    }
+    return taskId;
+}
+function bridgeClient(core, work) {
+    return {
+        readWorkContext: (...args) => work.readWorkContext(...args),
+        checkoutTask: (...args) => work.checkoutTask(...args),
+        createChildTasks: (...args) => work.createChildTasks(...args),
+        addTaskComment: (...args) => work.addTaskComment(...args),
+        registerArtifact: (...args) => work.registerArtifact(...args),
+        requestApproval: (...args) => work.requestApproval(...args),
+        reportUsage: (...args) => work.reportUsage(...args),
+        setTaskDisposition: (...args) => work.setTaskDisposition(...args),
+        appendRunEvent: (...args) => core.appendRunEvent(...args),
+    };
+}
+function bridgeSessionTtlMs(job) {
+    const maxRunMinutes = job.wakeEnvelope?.limits.maxRunMinutes;
+    return (maxRunMinutes ?? 60) * 60_000 + 60_000;
+}
+function allTaskScopes() {
+    return [
+        "run:read",
+        "run:event:write",
+        "task:checkout",
+        "task:child:write",
+        "task:comment:write",
+        "artifact:write",
+        "approval:write",
+        "usage:write",
+        "task:disposition:write",
+    ];
+}
+//# sourceMappingURL=taskExecution.js.map

package/dist/runtime/taskExecution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskExecution.js","sourceRoot":"","sources":["../../src/runtime/taskExecution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AA0B1E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAMvC;IACC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,IAAI,0BAA0B,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC9B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK;QACtB,MAAM;QACN,MAAM,EAAE,aAAa,EAAE;QACvB,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC;KACrC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,wBAAwB,CAAC;QACvC,QAAQ;QACR,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC;QACxD,iBAAiB,EAAE,KAAK,CAAC,UAAU;QACnC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,OAAO;QACL,MAAM;QACN,aAAa,EAAE,MAAM,CAAC,OAAO;QAC7B,WAAW,EAAE,OAAO,CAAC,QAAQ;QAC7B,KAAK,CAAC,KAAK;YACT,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAe;IAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,YAAY,CAAC;IAC7D,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC9E,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAClG,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,GAAG,CAAC,YAAY,KAAK,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CACnB,IAA6C,EAC7C,IAAyB;IAEzB,OAAO;QACL,eAAe,EAAE,CAAC,GAAG,IAAwD,EAAE,EAAE,CAC/E,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;QAC/B,YAAY,EAAE,CAAC,GAAG,IAAqD,EAAE,EAAE,CACzE,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QAC5B,gBAAgB,EAAE,CAAC,GAAG,IAAyD,EAAE,EAAE,CACjF,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;QAChC,cAAc,EAAE,CAAC,GAAG,IAAuD,EAAE,EAAE,CAC7E,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;QAC9B,gBAAgB,EAAE,CAAC,GAAG,IAAyD,EAAE,EAAE,CACjF,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;QAChC,eAAe,EAAE,CAAC,GAAG,IAAwD,EAAE,EAAE,CAC/E,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;QAC/B,WAAW,EAAE,CAAC,GAAG,IAAoD,EAAE,EAAE,CACvE,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;QAC3B,kBAAkB,EAAE,CAAC,GAAG,IAA2D,EAAE,EAAE,CACrF,IAAI,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;QAClC,cAAc,EAAE,CAAC,GAAG,IAAmD,EAAE,EAAE,CACzE,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAe;IACzC,MAAM,aAAa,GAAG,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC;IAC7D,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;AACjD,CAAC;AAED,SAAS,aAAa;IACpB,OAAO;QACL,UAAU;QACV,iBAAiB;QACjB,eAAe;QACf,kBAAkB;QAClB,oBAAoB;QACpB,gBAAgB;QAChB,gBAAgB;QAChB,aAAa;QACb,wBAAwB;KACzB,CAAC;AACJ,CAAC"}

package/dist/runtime/wakeEnvelope.d.ts

@@ -0,0 +1,76 @@
+import { z } from "zod";
+export declare const SIFT_AGENT_RUN_PROTOCOL_VERSION = "sift-agent-run/v1";
+export declare const siftWakeEnvelopeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"sift-agent-run/v1">;
+    workspaceId: z.ZodString;
+    brainId: z.ZodString;
+    runId: z.ZodString;
+    agentPrincipalId: z.ZodString;
+    task: z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodOptional<z.ZodString>;
+        parentTaskId: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        bodyMarkdown: z.ZodString;
+        status: z.ZodEnum<{
+            backlog: "backlog";
+            todo: "todo";
+            in_progress: "in_progress";
+            in_review: "in_review";
+            blocked: "blocked";
+            done: "done";
+            cancelled: "cancelled";
+        }>;
+        priority: z.ZodEnum<{
+            critical: "critical";
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+    }, z.core.$strip>;
+    wake: z.ZodObject<{
+        requestId: z.ZodString;
+        source: z.ZodEnum<{
+            assignment: "assignment";
+            manual: "manual";
+            routine: "routine";
+            comment: "comment";
+            approval: "approval";
+            system: "system";
+        }>;
+        reason: z.ZodString;
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    comments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        authorPrincipalId: z.ZodString;
+        bodyMarkdown: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>>;
+    blockers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            backlog: "backlog";
+            todo: "todo";
+            in_progress: "in_progress";
+            in_review: "in_review";
+            blocked: "blocked";
+            done: "done";
+            cancelled: "cancelled";
+        }>;
+    }, z.core.$strip>>>;
+    pendingApproval: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+    contextRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    limits: z.ZodObject<{
+        maxRunMinutes: z.ZodOptional<z.ZodNumber>;
+        remainingCostMicros: z.ZodOptional<z.ZodNumber>;
+        hardStop: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SiftWakeEnvelope = z.infer<typeof siftWakeEnvelopeSchema>;
+export declare function parseSiftWakeEnvelope(raw: unknown): SiftWakeEnvelope;

package/dist/runtime/wakeEnvelope.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+export const SIFT_AGENT_RUN_PROTOCOL_VERSION = "sift-agent-run/v1";
+const jsonObjectSchema = z.record(z.string(), z.unknown());
+const taskStatusSchema = z.enum([
+    "backlog",
+    "todo",
+    "in_progress",
+    "in_review",
+    "blocked",
+    "done",
+    "cancelled",
+]);
+export const siftWakeEnvelopeSchema = z.object({
+    schemaVersion: z.literal(SIFT_AGENT_RUN_PROTOCOL_VERSION),
+    workspaceId: z.string(),
+    brainId: z.string(),
+    runId: z.string(),
+    agentPrincipalId: z.string(),
+    task: z.object({
+        id: z.string(),
+        projectId: z.string().optional(),
+        parentTaskId: z.string().optional(),
+        title: z.string(),
+        bodyMarkdown: z.string(),
+        status: taskStatusSchema,
+        priority: z.enum(["critical", "high", "medium", "low"]),
+    }),
+    wake: z.object({
+        requestId: z.string(),
+        source: z.enum(["assignment", "manual", "routine", "comment", "approval", "system"]),
+        reason: z.string(),
+        payload: jsonObjectSchema.optional(),
+    }),
+    comments: z.array(z.object({
+        id: z.string(),
+        authorPrincipalId: z.string(),
+        bodyMarkdown: z.string(),
+        createdAt: z.string(),
+    })).default([]),
+    blockers: z.array(z.object({
+        taskId: z.string(),
+        title: z.string(),
+        status: taskStatusSchema,
+    })).default([]),
+    pendingApproval: z.object({
+        id: z.string(),
+        type: z.string(),
+        payload: jsonObjectSchema,
+    }).optional(),
+    contextRefs: z.array(z.string()).default([]),
+    limits: z.object({
+        maxRunMinutes: z.number().positive().optional(),
+        remainingCostMicros: z.number().optional(),
+        hardStop: z.boolean(),
+    }),
+});
+export function parseSiftWakeEnvelope(raw) {
+    return siftWakeEnvelopeSchema.parse(raw);
+}
+//# sourceMappingURL=wakeEnvelope.js.map

package/dist/runtime/wakeEnvelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeEnvelope.js","sourceRoot":"","sources":["../../src/runtime/wakeEnvelope.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,121 @@
+import type { SiftWakeEnvelope } from "./runtime/wakeEnvelope.js";
+import type { WorkApproval, WorkArtifact, WorkArtifactInput, WorkChildTaskInput, WorkDisposition, WorkDispositionResponse, WorkTask, WorkTaskComment, WorkUsageDecision } from "./workTypes.js";
+export type JsonObject = Record<string, unknown>;
+export type ConductorConfig = {
+    apiBaseUrl: string;
+    credential: string;
+    conductorId?: string | undefined;
+    displayName: string;
+    protocolVersion: string;
+};
+export type ConfigStore = {
+    read(): Promise<ConductorConfig | undefined>;
+    write(config: ConductorConfig): Promise<void>;
+    delete(): Promise<void>;
+};
+export type PairConductorRequest = {
+    code: string;
+    displayName?: string;
+    version?: string;
+    protocolVersion?: string;
+    capabilities?: JsonObject;
+};
+export type PairConductorResponse = {
+    conductor: {
+        id: string;
+        displayName: string;
+    };
+    credential: string;
+};
+export type PairConductorClient = {
+    pair(request: PairConductorRequest): Promise<PairConductorResponse>;
+};
+export type ConductorAgentAdvertisement = {
+    localKey: string;
+    displayName: string;
+    adapterType: string;
+    status?: "active" | "inactive";
+    capabilities?: JsonObject;
+};
+export type ConductorAgent = {
+    id: string;
+    agentPrincipalId: string;
+    localKey: string;
+    displayName: string;
+    adapterType: string;
+    status: "active" | "inactive";
+    capabilities: JsonObject;
+};
+export type ClaimedJob = {
+    id: string;
+    runId: string;
+    conductorAgentId: string;
+    localKey: string;
+    adapterType: string;
+    objective: string;
+    taskRecordId?: string | undefined;
+    wakeRequestId?: string | undefined;
+    contextRefs: string[];
+    limits: JsonObject;
+    status: string;
+    attempts: number;
+    leaseExpiresAt?: string | undefined;
+    wakeEnvelope?: SiftWakeEnvelope | undefined;
+};
+export type LeaseRefresh = {
+    job: {
+        id: string;
+        runId: string;
+        status: string;
+        leaseExpiresAt?: string | undefined;
+    };
+    cancelRequested: boolean;
+};
+export type RunEventType = "health" | "progress" | "log" | "artifact" | "approval_requested" | "completed" | "failed" | "cancelled";
+export type RunEventInput = {
+    eventType: RunEventType;
+    payload?: JsonObject;
+    occurredAt?: string;
+};
+export type RunEvent = {
+    id: string;
+    runId: string;
+    sequence: number;
+    eventType: RunEventType;
+    payload: JsonObject;
+    occurredAt: string;
+};
+export type ConductorClient = PairConductorClient & {
+    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>;
+};
+export type ConductorWorkClient = {
+    readWorkContext(credential: string, runId: string, taskId: string): Promise<SiftWakeEnvelope>;
+    checkoutTask(credential: string, runId: string, taskId: string): Promise<WorkTask>;
+    createChildTasks(credential: string, runId: string, taskId: string, children: WorkChildTaskInput[]): Promise<WorkTask[]>;
+    addTaskComment(credential: string, runId: string, taskId: string, bodyMarkdown: string): Promise<WorkTaskComment>;
+    registerArtifact(credential: string, runId: string, taskId: string, artifact: WorkArtifactInput): Promise<WorkArtifact>;
+    requestApproval(credential: string, runId: string, taskId: string, request: {
+        type: string;
+        payload?: JsonObject;
+        idempotencyKey?: string;
+    }): Promise<WorkApproval>;
+    reportUsage(credential: string, runId: string, taskId: string, usage: {
+        eventKey: string;
+        costMicros: number;
+        durationMs: number;
+    }): Promise<WorkUsageDecision>;
+    setTaskDisposition(credential: string, runId: string, taskId: string, disposition: WorkDisposition, resultSummary?: JsonObject): Promise<WorkDispositionResponse>;
+    listTasks(userCredential: string, projectId?: string): Promise<WorkTask[]>;
+    listRuns(userCredential: string, taskId?: string): Promise<ClaimedJob[]>;
+};