@lightspeed-ai/agent-client 0.1.0

package/dist/workflow.d.ts

@@ -0,0 +1,217 @@
+import type { EmissionEnvelope, PromiseResolution, WorkflowToolInvocation } from "./generated/workflow-types.js";
+export type * from "./generated/workflow-types.js";
+export declare const DELIVER_EMISSION_SIGNAL: "deliver_emission";
+export declare const WORKFLOW_TOOL_RECOVERY_QUERY: "workflow_tool_recovery";
+export declare const WORKFLOW_TOOL_EXECUTION_KIND: "workflow_tool.execution";
+export declare const WORKFLOW_TOOL_RECIPE_FORMAT_V1: 1;
+export declare const WORKFLOW_TOOL_RECIPE_FINGERPRINT_PREFIX: "wtr:sha256:";
+export declare const REPLY_COMPLETION_KEY: "reply";
+/** Activity names a connector host registers on its account task queues. */
+export declare const CHANNEL_CONNECTOR_ACTIVITIES: {
+    readonly deliverChannelMessage: "deliverChannelMessage";
+    readonly maintainChannelTyping: "maintainChannelTyping";
+    readonly prepareChannelMedia: "prepareChannelMedia";
+};
+export declare const CHANNEL_CONVERSATION_WORKFLOW_KIND: "ChannelConversationWorkflow";
+export declare const CHANNEL_INBOUND_SIGNAL: "chat_inbound";
+export declare const CHANNEL_STATE_QUERY: "chat_state";
+export declare const CHANNEL_DELIVERY_RECEIPT_SIGNAL: "bot_delivery";
+/** Known-answer vectors emitted by Rust and shared by every generated consumer. */
+export declare const WORKFLOW_CONTRACT_VECTORS: {
+    readonly channels: {
+        readonly connectorTaskQueue: "lightspeed-connector-telegram-9b32a282ab8d90f892b5916c";
+        readonly conversationKey: "tg-main/12345/7";
+        readonly conversationWorkflowId: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f/chat-telegram-4f32eceadb5d05f640c88ff4517eccbd4ab9c99c72c84db5";
+        readonly inputs: {
+            readonly accountId: "tg-main";
+            readonly chatId: "12345";
+            readonly provider: "telegram";
+            readonly threadId: "7";
+            readonly universeId: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f";
+        };
+    };
+    readonly emissionIds: {
+        readonly invocationCancellation: "emission:sha256:6b88bd2ef714193fc9274b5f212cc415da4dd25733e1717fa89c7fdddc3eca4e";
+        readonly runTerminal: "emission:sha256:a477a56dbeb4f3937959dc5ece1cf363c7030bec130415e4019b507e48098240";
+        readonly sourceResolution: "emission:sha256:8980ea03cd17fbacf2682cdf4e5a13593d6c596ca8965ebcdb601ad56e40ec85";
+        readonly toolInvocation: "wti:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
+    };
+    readonly envelopes: readonly [{
+        readonly body: {
+            readonly failure_message_ref: null;
+            readonly kind: "run_terminal";
+            readonly output_ref: "sha256:e0ee8bb50685e05fa0f47ed04203ae953fdfd055f5bd2892ea186504254f8c3a";
+            readonly run_id: 7;
+            readonly status: "completed";
+            readonly token: "terminal-token-1";
+        };
+        readonly emission_id: "emission:sha256:a477a56dbeb4f3937959dc5ece1cf363c7030bec130415e4019b507e48098240";
+        readonly producer: {
+            readonly kind: "session";
+            readonly log_seq: 42;
+            readonly session_id: "bot:v1:triage";
+            readonly universe_id: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f";
+        };
+    }, {
+        readonly body: {
+            readonly kind: "source_resolution";
+            readonly promise_id: "promise_1";
+            readonly resolution: {
+                readonly kind: "resolved";
+                readonly payload_ref: null;
+            };
+        };
+        readonly emission_id: "emission:sha256:8980ea03cd17fbacf2682cdf4e5a13593d6c596ca8965ebcdb601ad56e40ec85";
+        readonly producer: {
+            readonly kind: "workflow";
+            readonly universe_id: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f";
+            readonly workflow_id: "lightspeed.bots.v1/6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f/triage";
+        };
+    }, {
+        readonly body: {
+            readonly holder_workflow_id: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f/bot:v1:triage";
+            readonly invocation: {
+                readonly arguments_ref: "sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a";
+                readonly binding_fingerprint: "binding:v1:vector";
+                readonly completion_promises: {
+                    readonly reply: "promise_1";
+                };
+                readonly execution_context_ref: null;
+                readonly invocation_id: "wti:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
+                readonly run_id: 7;
+                readonly schema_revision: 1;
+                readonly semantic_type: "lightspeed.bots.event.resolve.v1";
+                readonly session_id: "bot:v1:triage";
+                readonly session_universe_id: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f";
+                readonly tool_batch_id: 9;
+                readonly tool_call_id: "call_1";
+                readonly tool_id: "lightspeed.bots.event.resolve.v1";
+                readonly turn_id: 8;
+            };
+            readonly kind: "tool_invocation";
+        };
+        readonly emission_id: "wti:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
+        readonly producer: {
+            readonly kind: "session";
+            readonly log_seq: 43;
+            readonly session_id: "bot:v1:triage";
+            readonly universe_id: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f";
+        };
+    }, {
+        readonly body: {
+            readonly completion_key: "reply";
+            readonly invocation_id: "wti:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
+            readonly kind: "invocation_cancellation";
+            readonly promise_id: "promise_1";
+        };
+        readonly emission_id: "emission:sha256:6b88bd2ef714193fc9274b5f212cc415da4dd25733e1717fa89c7fdddc3eca4e";
+        readonly producer: {
+            readonly kind: "session";
+            readonly log_seq: 44;
+            readonly session_id: "bot:v1:triage";
+            readonly universe_id: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f";
+        };
+    }];
+    readonly inputs: {
+        readonly completionKey: "reply";
+        readonly environmentId: "env_1";
+        readonly holderWorkflowId: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f/bot:v1:triage";
+        readonly invocationId: "wti:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
+        readonly jobGroupId: "job_1";
+        readonly producerWorkflowId: "lightspeed.bots.v1/6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f/triage";
+        readonly promiseId: "promise_1";
+        readonly recipeJson: "{\"workflowType\":\"BotControllerWorkflow\",\"taskQueue\":\"lightspeed-bots\"}";
+        readonly runId: 7;
+        readonly sessionId: "bot:v1:triage";
+        readonly token: "terminal-token-1";
+        readonly universeId: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f";
+    };
+    readonly recipe: {
+        readonly taskQueue: "lightspeed-bots";
+        readonly workflowType: "BotControllerWorkflow";
+    };
+    readonly recipeFingerprint: "wtr:sha256:7c3d35ba94ba53a7d51d12749aa2fb43e8026d6a3b69dfca7ef4b9422b846010";
+    readonly recoveryResult: {
+        readonly resolutions: {
+            readonly reply: {
+                readonly kind: "resolved";
+                readonly payload_ref: null;
+            };
+        };
+    };
+    readonly startArgs: {
+        readonly execution_id: "wte:vector";
+        readonly holder_workflow_id: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f/bot:v1:triage";
+        readonly invocation: {
+            readonly arguments_ref: "sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a";
+            readonly binding_fingerprint: "binding:v1:vector";
+            readonly completion_promises: {
+                readonly reply: "promise_1";
+            };
+            readonly execution_context_ref: null;
+            readonly invocation_id: "wti:sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
+            readonly run_id: 7;
+            readonly schema_revision: 1;
+            readonly semantic_type: "lightspeed.bots.event.resolve.v1";
+            readonly session_id: "bot:v1:triage";
+            readonly session_universe_id: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f";
+            readonly tool_batch_id: 9;
+            readonly tool_call_id: "call_1";
+            readonly tool_id: "lightspeed.bots.event.resolve.v1";
+            readonly turn_id: 8;
+        };
+        readonly universe_id: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f";
+    };
+    readonly workflowIds: {
+        readonly environmentJob: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f/envjob-env_1-job_1";
+        readonly session: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f/bot:v1:triage";
+        readonly split: {
+            readonly sessionId: "bot:v1:triage";
+            readonly universeId: "6f3a1a52-58c1-4f0e-9c2d-1a2b3c4d5e6f";
+        };
+    };
+};
+export declare const emissionId: {
+    readonly runTerminal: (universeId: string, sessionId: string, runId: number, token: string) => string;
+    /**
+     * Promise ids are session-scoped counters (`promise_7`), so the holder
+     * workflow id is part of the emission identity: one producer resolving
+     * `promise_7` for two holders sends two distinct emissions.
+     */
+    readonly sourceResolution: (universeId: string, producerWorkflowId: string, holderWorkflowId: string, promiseId: string) => string;
+    readonly toolInvocation: (invocationId: string) => string;
+    readonly invocationCancellation: (invocationId: string, completionKey: string) => string;
+};
+export interface SourceResolutionEnvelopeInput {
+    universeId: string;
+    producerWorkflowId: string;
+    /** The Lightspeed session workflow that holds the promise. */
+    holderWorkflowId: string;
+    promiseId: string;
+    resolution: PromiseResolution;
+}
+/** Build the exact envelope a workflow sends back to a Lightspeed holder. */
+export declare function sourceResolutionEnvelope(input: SourceResolutionEnvelopeInput): EmissionEnvelope;
+/** Decode and validate the fixed signal payload at a workflow boundary. */
+export declare function parseEmissionEnvelope(value: unknown): EmissionEnvelope;
+/** Return the single receiver-visible Promise under the reserved `reply` key. */
+export declare function replyPromiseId(invocation: WorkflowToolInvocation): string;
+/** Compose the stable Temporal workflow id of a Lightspeed session. */
+export declare function sessionWorkflowId(universeId: string, sessionId: string): string;
+/** Compose the stable Temporal workflow id of an environment job group. */
+export declare function environmentJobWorkflowId(universeId: string, environmentId: string, jobGroupId: string): string;
+/**
+ * Task queue of the connector host serving one channel account:
+ * `lightspeed-connector-{provider}-{24 hex}`, the hex being sha256 over the
+ * length-prefixed domain, hyphenated lowercase universe id, provider, and
+ * account id. The core routes connector activities here; the host polls it.
+ */
+export declare function connectorTaskQueue(universeId: string, provider: string, accountId: string): string;
+/** Split a canonical session workflow id, returning undefined for other ids. */
+export declare function splitWorkflowId(workflowId: string): {
+    universeId: string;
+    sessionId: string;
+} | undefined;
+/** Fingerprint the exact raw recipe bytes with the canonical prefix. */
+export declare function recipeFingerprint(recipe: string | Uint8Array): string;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAEjB,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AAEvC,mBAAmB,+BAA+B,CAAC;AAEnD,eAAO,MAAM,uBAAuB,oBACgB,CAAC;AACrD,eAAO,MAAM,4BAA4B,0BACgB,CAAC;AAC1D,eAAO,MAAM,4BAA4B,2BACe,CAAC;AACzD,eAAO,MAAM,8BAA8B,GACc,CAAC;AAC1D,eAAO,MAAM,uCAAuC,eACc,CAAC;AACnE,eAAO,MAAM,oBAAoB,SAC4B,CAAC;AAE9D,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B;;;;CACgB,CAAC;AAC1D,eAAO,MAAM,kCAAkC,+BACG,CAAC;AACnD,eAAO,MAAM,sBAAsB,gBACgB,CAAC;AACpD,eAAO,MAAM,mBAAmB,cACgB,CAAC;AACjD,eAAO,MAAM,+BAA+B,gBACe,CAAC;AAE5D,mFAAmF;AACnF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAqC,CAAC;AAS5E,eAAO,MAAM,UAAU;uCAEP,MAAM,aACP,MAAM,SACV,MAAM,SACN,MAAM,KACZ,MAAM;IAYT;;;;OAIG;4CAEW,MAAM,sBACE,MAAM,oBACR,MAAM,aACb,MAAM,KAChB,MAAM;4CAYoB,MAAM,KAAG,MAAM;oDAKP,MAAM,iBAAiB,MAAM,KAAG,MAAM;CAQnE,CAAC;AAEX,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,6BAA6B,GACnC,gBAAgB,CAwBlB;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAMtE;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,UAAU,EAAE,sBAAsB,GAAG,MAAM,CAgBzE;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAGR;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAcR;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,GACjB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAavD;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAGrE"}

package/dist/workflow.js

@@ -0,0 +1,338 @@
+import { sha256 } from "@noble/hashes/sha2.js";
+import { WORKFLOW_CONTRACT_MANIFEST } from "./generated/workflow-manifest.js";
+export const DELIVER_EMISSION_SIGNAL = WORKFLOW_CONTRACT_MANIFEST.signals.deliverEmission;
+export const WORKFLOW_TOOL_RECOVERY_QUERY = WORKFLOW_CONTRACT_MANIFEST.queries.workflowToolRecovery;
+export const WORKFLOW_TOOL_EXECUTION_KIND = WORKFLOW_CONTRACT_MANIFEST.workflowTools.executionKind;
+export const WORKFLOW_TOOL_RECIPE_FORMAT_V1 = WORKFLOW_CONTRACT_MANIFEST.workflowTools.recipeFormatV1;
+export const WORKFLOW_TOOL_RECIPE_FINGERPRINT_PREFIX = WORKFLOW_CONTRACT_MANIFEST.workflowTools.recipeFingerprintPrefix;
+export const REPLY_COMPLETION_KEY = WORKFLOW_CONTRACT_MANIFEST.workflowTools.replyCompletionKey;
+/** Activity names a connector host registers on its account task queues. */
+export const CHANNEL_CONNECTOR_ACTIVITIES = WORKFLOW_CONTRACT_MANIFEST.channels.connectorActivities;
+export const CHANNEL_CONVERSATION_WORKFLOW_KIND = WORKFLOW_CONTRACT_MANIFEST.channels.workflowKind;
+export const CHANNEL_INBOUND_SIGNAL = WORKFLOW_CONTRACT_MANIFEST.channels.inboundSignal;
+export const CHANNEL_STATE_QUERY = WORKFLOW_CONTRACT_MANIFEST.channels.stateQuery;
+export const CHANNEL_DELIVERY_RECEIPT_SIGNAL = WORKFLOW_CONTRACT_MANIFEST.channels.deliveryReceiptSignal;
+/** Known-answer vectors emitted by Rust and shared by every generated consumer. */
+export const WORKFLOW_CONTRACT_VECTORS = WORKFLOW_CONTRACT_MANIFEST.vectors;
+const EMISSION_ID = /^(?:emission|wti):sha256:[0-9a-f]{64}$/;
+const INVOCATION_ID = /^wti:sha256:[0-9a-f]{64}$/;
+const BLOB_REF = /^sha256:[0-9a-f]{64}$/;
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const SESSION_ID = /^[A-Za-z0-9][A-Za-z0-9_.:-]*$/;
+const textEncoder = new TextEncoder();
+export const emissionId = {
+    runTerminal(universeId, sessionId, runId, token) {
+        requireSessionId(sessionId);
+        requireSafeIntegerValue(runId, "runId");
+        requireNonEmpty(token, "token");
+        return derivedEmissionId("run_terminal", [
+            utf8(normalizeUniverseId(universeId)),
+            utf8(sessionId),
+            u64be(runId),
+            utf8(token),
+        ]);
+    },
+    /**
+     * Promise ids are session-scoped counters (`promise_7`), so the holder
+     * workflow id is part of the emission identity: one producer resolving
+     * `promise_7` for two holders sends two distinct emissions.
+     */
+    sourceResolution(universeId, producerWorkflowId, holderWorkflowId, promiseId) {
+        requireNonEmpty(producerWorkflowId, "producerWorkflowId");
+        requireNonEmpty(holderWorkflowId, "holderWorkflowId");
+        requireNonEmpty(promiseId, "promiseId");
+        return derivedEmissionId("source_resolution", [
+            utf8(normalizeUniverseId(universeId)),
+            utf8(producerWorkflowId),
+            utf8(holderWorkflowId),
+            utf8(promiseId),
+        ]);
+    },
+    toolInvocation(invocationId) {
+        requireCanonicalInvocationId(invocationId);
+        return invocationId;
+    },
+    invocationCancellation(invocationId, completionKey) {
+        requireCanonicalInvocationId(invocationId);
+        requireNonEmpty(completionKey, "completionKey");
+        return derivedEmissionId("invocation_cancellation", [
+            utf8(invocationId),
+            utf8(completionKey),
+        ]);
+    },
+};
+/** Build the exact envelope a workflow sends back to a Lightspeed holder. */
+export function sourceResolutionEnvelope(input) {
+    const universeId = normalizeUniverseId(input.universeId);
+    requireNonEmpty(input.producerWorkflowId, "producerWorkflowId");
+    requireNonEmpty(input.holderWorkflowId, "holderWorkflowId");
+    requireNonEmpty(input.promiseId, "promiseId");
+    parseResolution(input.resolution);
+    return {
+        emission_id: emissionId.sourceResolution(universeId, input.producerWorkflowId, input.holderWorkflowId, input.promiseId),
+        producer: {
+            kind: "workflow",
+            universe_id: universeId,
+            workflow_id: input.producerWorkflowId,
+        },
+        body: {
+            kind: "source_resolution",
+            promise_id: input.promiseId,
+            resolution: input.resolution,
+        },
+    };
+}
+/** Decode and validate the fixed signal payload at a workflow boundary. */
+export function parseEmissionEnvelope(value) {
+    const envelope = record(value, "emission envelope");
+    requirePattern(envelope, "emission_id", EMISSION_ID);
+    parseProducer(envelope.producer);
+    parseBody(envelope.body);
+    return value;
+}
+/** Return the single receiver-visible Promise under the reserved `reply` key. */
+export function replyPromiseId(invocation) {
+    const promises = invocation.completion_promises;
+    if (promises === undefined || promises === null) {
+        throw new TypeError("pushed invocation must carry exactly the reserved `reply` completion promise");
+    }
+    const keys = Object.keys(promises);
+    if (keys.length !== 1 || keys[0] !== REPLY_COMPLETION_KEY) {
+        throw new TypeError("pushed invocation must carry exactly the reserved `reply` completion promise");
+    }
+    const promiseId = promises[REPLY_COMPLETION_KEY];
+    requireNonEmptyValue(promiseId, "reply promise");
+    return promiseId;
+}
+/** Compose the stable Temporal workflow id of a Lightspeed session. */
+export function sessionWorkflowId(universeId, sessionId) {
+    requireSessionId(sessionId);
+    return `${normalizeUniverseId(universeId)}/${sessionId}`;
+}
+/** Compose the stable Temporal workflow id of an environment job group. */
+export function environmentJobWorkflowId(universeId, environmentId, jobGroupId) {
+    requireNonEmpty(environmentId, "environmentId");
+    requireNonEmpty(jobGroupId, "jobGroupId");
+    return `${normalizeUniverseId(universeId)}/envjob-${environmentId}-${jobGroupId}`;
+}
+/**
+ * Task queue of the connector host serving one channel account:
+ * `lightspeed-connector-{provider}-{24 hex}`, the hex being sha256 over the
+ * length-prefixed domain, hyphenated lowercase universe id, provider, and
+ * account id. The core routes connector activities here; the host polls it.
+ */
+export function connectorTaskQueue(universeId, provider, accountId) {
+    requireNonEmpty(provider, "provider");
+    requireNonEmpty(accountId, "accountId");
+    const digest = sha256.create();
+    for (const part of [
+        utf8(WORKFLOW_CONTRACT_MANIFEST.channels.domains.connectorTaskQueue),
+        utf8(normalizeUniverseId(universeId)),
+        utf8(provider),
+        utf8(accountId),
+    ]) {
+        digest.update(u64be(part.length));
+        digest.update(part);
+    }
+    return `lightspeed-connector-${provider}-${hex(digest.digest()).slice(0, 24)}`;
+}
+/** Split a canonical session workflow id, returning undefined for other ids. */
+export function splitWorkflowId(workflowId) {
+    const separator = workflowId.indexOf("/");
+    if (separator < 0 || workflowId.indexOf("/", separator + 1) >= 0)
+        return undefined;
+    const universeId = workflowId.slice(0, separator);
+    const sessionId = workflowId.slice(separator + 1);
+    try {
+        const normalizedUniverseId = normalizeUniverseId(universeId);
+        requireSessionId(sessionId);
+        return { universeId: normalizedUniverseId, sessionId };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Fingerprint the exact raw recipe bytes with the canonical prefix. */
+export function recipeFingerprint(recipe) {
+    const bytes = typeof recipe === "string" ? utf8(recipe) : recipe;
+    return `${WORKFLOW_TOOL_RECIPE_FINGERPRINT_PREFIX}${hex(sha256(bytes))}`;
+}
+function derivedEmissionId(kind, parts) {
+    const digest = sha256.create();
+    for (const part of [
+        utf8(WORKFLOW_CONTRACT_MANIFEST.emissionIds.hashDomain),
+        utf8(kind),
+        ...parts,
+    ]) {
+        digest.update(u64be(part.length));
+        digest.update(part);
+    }
+    return `${WORKFLOW_CONTRACT_MANIFEST.emissionIds.prefix}${hex(digest.digest())}`;
+}
+function parseProducer(value) {
+    const producer = record(value, "emission producer");
+    const kind = requireString(producer, "kind");
+    normalizeUniverseId(requireString(producer, "universe_id"));
+    if (kind === "session") {
+        requireSessionId(requireString(producer, "session_id"));
+        requireSafeInteger(producer, "log_seq");
+        return;
+    }
+    if (kind === "workflow") {
+        requireNonEmpty(requireString(producer, "workflow_id"), "producer.workflow_id");
+        return;
+    }
+    throw new TypeError(`unknown emission producer kind: ${kind}`);
+}
+function parseBody(value) {
+    const body = record(value, "emission body");
+    const kind = requireString(body, "kind");
+    switch (kind) {
+        case "run_terminal":
+            requireNonEmpty(requireString(body, "token"), "run_terminal.token");
+            requireSafeInteger(body, "run_id");
+            requireRunStatus(body.status);
+            requireOptionalBlobRef(body, "output_ref");
+            requireOptionalBlobRef(body, "failure_message_ref");
+            return;
+        case "source_resolution":
+            requireNonEmpty(requireString(body, "promise_id"), "source_resolution.promise_id");
+            parseResolution(body.resolution);
+            return;
+        case "tool_invocation":
+            parseInvocation(body.invocation);
+            requireNonEmpty(requireString(body, "holder_workflow_id"), "tool_invocation.holder_workflow_id");
+            return;
+        case "invocation_cancellation":
+            requirePattern(body, "invocation_id", INVOCATION_ID);
+            requireNonEmpty(requireString(body, "completion_key"), "cancellation.completion_key");
+            requireNonEmpty(requireString(body, "promise_id"), "cancellation.promise_id");
+            return;
+        default:
+            throw new TypeError(`unknown emission body kind: ${kind}`);
+    }
+}
+function parseInvocation(value) {
+    const invocation = record(value, "workflow tool invocation");
+    requirePattern(invocation, "invocation_id", INVOCATION_ID);
+    for (const key of [
+        "tool_id",
+        "semantic_type",
+        "binding_fingerprint",
+        "session_id",
+        "tool_call_id",
+    ]) {
+        requireNonEmpty(requireString(invocation, key), `invocation.${key}`);
+    }
+    normalizeUniverseId(requireString(invocation, "session_universe_id"));
+    requirePattern(invocation, "arguments_ref", BLOB_REF);
+    const contextRef = invocation.execution_context_ref;
+    if (contextRef !== undefined && contextRef !== null) {
+        requirePattern(invocation, "execution_context_ref", BLOB_REF);
+    }
+    for (const key of ["schema_revision", "run_id", "turn_id", "tool_batch_id"]) {
+        requireSafeInteger(invocation, key);
+    }
+    if (invocation.completion_promises !== undefined &&
+        invocation.completion_promises !== null) {
+        const promises = record(invocation.completion_promises, "completion promises");
+        for (const [key, promiseId] of Object.entries(promises)) {
+            requireNonEmpty(key, "completion promise key");
+            requireNonEmptyValue(promiseId, `completion promise ${key}`);
+        }
+    }
+}
+function parseResolution(value) {
+    const resolution = record(value, "promise resolution");
+    const kind = requireString(resolution, "kind");
+    if (kind === "resolved") {
+        requireOptionalBlobRef(resolution, "payload_ref");
+        return;
+    }
+    if (kind === "failed") {
+        requireOptionalBlobRef(resolution, "error_ref");
+        return;
+    }
+    if (kind !== "cancelled") {
+        throw new TypeError(`unknown promise resolution kind: ${kind}`);
+    }
+}
+function requireRunStatus(value) {
+    if (value !== "active" &&
+        value !== "parked" &&
+        value !== "cancelling" &&
+        value !== "cancelling_grace" &&
+        value !== "completed" &&
+        value !== "failed" &&
+        value !== "cancelled") {
+        throw new TypeError(`invalid run status: ${String(value)}`);
+    }
+}
+function requireOptionalBlobRef(value, key) {
+    const field = value[key];
+    if (field !== undefined && field !== null) {
+        requireNonEmptyValue(field, key);
+        if (!BLOB_REF.test(field))
+            throw new TypeError(`${key} is not a canonical blob ref`);
+    }
+}
+function record(value, name) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new TypeError(`${name} must be an object`);
+    }
+    return value;
+}
+function requireString(value, key) {
+    const field = value[key];
+    if (typeof field !== "string")
+        throw new TypeError(`${key} must be a string`);
+    return field;
+}
+function requirePattern(value, key, pattern) {
+    const field = requireString(value, key);
+    if (!pattern.test(field))
+        throw new TypeError(`${key} has an invalid format`);
+}
+function requireSafeInteger(value, key) {
+    requireSafeIntegerValue(value[key], key);
+}
+function requireSafeIntegerValue(value, name) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new TypeError(`${name} must be a non-negative safe integer`);
+    }
+}
+function requireSessionId(value) {
+    if (!SESSION_ID.test(value) || utf8(value).length > 128) {
+        throw new TypeError("invalid session id");
+    }
+}
+function normalizeUniverseId(value) {
+    if (!UUID.test(value))
+        throw new TypeError("universeId must be a UUID");
+    return value.toLowerCase();
+}
+function requireCanonicalInvocationId(value) {
+    if (!INVOCATION_ID.test(value))
+        throw new TypeError("invalid workflow tool invocation id");
+}
+function requireNonEmpty(value, name) {
+    if (value.length === 0)
+        throw new TypeError(`${name} must not be empty`);
+}
+function requireNonEmptyValue(value, name) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new TypeError(`${name} must be a non-empty string`);
+    }
+}
+function utf8(value) {
+    return textEncoder.encode(value);
+}
+function u64be(value) {
+    const bytes = new Uint8Array(8);
+    new DataView(bytes.buffer).setBigUint64(0, BigInt(value), false);
+    return bytes;
+}
+function hex(value) {
+    return Array.from(value, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

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

package/examples/temporal-activity.ts

@@ -0,0 +1,33 @@
+import { Context } from "@temporalio/activity";
+import { LightspeedClient, type EventCursor } from "@lightspeed-ai/agent-client";
+
+export interface RunLightspeedStepInput {
+  endpoint: string;
+  sessionId: string;
+  prompt: string;
+  submissionId: string;
+  after?: EventCursor | null;
+}
+
+export async function runLightspeedStep(input: RunLightspeedStepInput) {
+  const activity = Context.current();
+  const lightspeed = new LightspeedClient(input.endpoint);
+
+  const session = await lightspeed.call("session/start", {
+    sessionId: input.sessionId,
+    cwd: null,
+    config: null,
+  });
+
+  const run = await lightspeed.startRun(
+    session.result.session.id,
+    [{ type: "text", text: input.prompt }],
+    { submissionId: input.submissionId },
+  );
+
+  return lightspeed.awaitRun(session.result.session.id, run.result.run.id, {
+    after: input.after ?? null,
+    waitMs: 30_000,
+    heartbeat: (cursor) => activity.heartbeat({ cursor }),
+  });
+}