@cogitator-ai/server-shared 0.4.0 → 0.5.0

package/dist/stream-session.js

@@ -0,0 +1,108 @@
+import { generateId } from './helpers.js';
+import { createApprovalRequiredEvent, createErrorEvent, createFinishEvent, createReasoningDeltaEvent, createReasoningEndEvent, createReasoningStartEvent, createStartEvent, createTextDeltaEvent, createTextEndEvent, createTextStartEvent, createToolCallDeltaEvent, createToolCallEndEvent, createToolCallStartEvent, createToolResultEvent, } from './protocol.js';
+import { toAgentRunOutcome, toPendingApprovals } from './response.js';
+const PART_EVENTS = {
+    text: {
+        prefix: 'txt',
+        start: createTextStartEvent,
+        delta: createTextDeltaEvent,
+        end: createTextEndEvent,
+    },
+    reasoning: {
+        prefix: 'rsn',
+        start: createReasoningStartEvent,
+        delta: createReasoningDeltaEvent,
+        end: createReasoningEndEvent,
+    },
+};
+/** A thread id nobody can guess, since a thread without an owner is open to whoever names it */
+export function createThreadId() {
+    return `thread_${globalThis.crypto.randomUUID()}`;
+}
+/**
+ * The events of one streamed agent run or resume, the same in every adapter.
+ *
+ * `start` announces the message and the thread. Text and reasoning arrive as parts: a part
+ * opens with its first delta and closes before anything else is sent, so a client never sees
+ * two parts open at once, and a tool call never lands inside a text part. `complete` sends
+ * what the run did not stream (an answer the model gave in one piece), the approvals a paused
+ * run waits on, and `finish` with the usage, the thread and how the run ended. `fail` closes
+ * the open part and sends `error`.
+ *
+ * Pass the thread to the run (`threadId: session.threadId`) and spread `callbacks` into its
+ * options together with `stream: true`.
+ */
+export class AgentStreamSession {
+    emit;
+    messageId = generateId('msg');
+    threadId;
+    callbacks;
+    open;
+    streamedText = false;
+    streamedReasoning = false;
+    constructor(emit, options = {}) {
+        this.emit = emit;
+        this.threadId = options.threadId ?? createThreadId();
+        this.callbacks = {
+            onToken: (token) => {
+                if (!token)
+                    return;
+                this.streamedText = true;
+                this.delta('text', token);
+            },
+            onReasoning: (delta) => {
+                if (!delta)
+                    return;
+                this.streamedReasoning = true;
+                this.delta('reasoning', delta);
+            },
+            onToolCall: (call) => {
+                this.endPart();
+                this.emit(createToolCallStartEvent(call.id, call.name));
+                this.emit(createToolCallDeltaEvent(call.id, JSON.stringify(call.arguments)));
+                this.emit(createToolCallEndEvent(call.id));
+            },
+            onToolResult: (toolResult) => {
+                this.emit(createToolResultEvent(generateId('res'), toolResult.callId, toolResult.result));
+            },
+        };
+    }
+    start() {
+        this.emit(createStartEvent(this.messageId, this.threadId));
+    }
+    complete(result) {
+        if (!this.streamedReasoning && result.reasoning)
+            this.delta('reasoning', result.reasoning);
+        if (!this.streamedText && result.output)
+            this.delta('text', result.output);
+        this.endPart();
+        if (result.status === 'paused') {
+            this.emit(createApprovalRequiredEvent(result.threadId, toPendingApprovals(result.pendingApprovals ?? [])));
+        }
+        this.emit(createFinishEvent(this.messageId, result.usage, {
+            threadId: result.threadId,
+            ...toAgentRunOutcome(result),
+        }));
+    }
+    fail(message, code) {
+        this.endPart();
+        this.emit(createErrorEvent(message, code));
+    }
+    delta(kind, delta) {
+        const part = PART_EVENTS[kind];
+        if (this.open?.kind !== kind) {
+            this.endPart();
+            this.open = { kind, id: generateId(part.prefix) };
+            this.emit(part.start(this.open.id));
+        }
+        this.emit(part.delta(this.open.id, delta));
+    }
+    endPart() {
+        const open = this.open;
+        if (!open)
+            return;
+        this.open = undefined;
+        this.emit(PART_EVENTS[open.kind].end(open.id));
+    }
+}
+//# sourceMappingURL=stream-session.js.map

package/dist/stream-session.js.map

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

package/dist/swarm.d.ts

@@ -0,0 +1,51 @@
+/** The part of a `Swarm` that releases what it holds; distributed swarms hold Redis connections */
+export interface ClosableSwarm {
+    close(): Promise<void>;
+}
+/**
+ * Runs `task` with a swarm the request created, and closes the swarm when the task settles:
+ * after success, failure or abort alike.
+ *
+ * A distributed swarm opens two Redis connections and keeps its state in Redis until it is
+ * closed, which also gives that state its expiry (`distributed.cleanupAfter`). A server that
+ * built one per request without closing it would leak connections until Redis refuses new
+ * clients. Closing an in-process swarm does nothing. A failure to close is logged, not
+ * thrown, so it never replaces the run's own result or error.
+ */
+export declare function withSwarm<S extends ClosableSwarm, T>(swarm: S, task: (swarm: S) => Promise<T>): Promise<T>;
+/** The slots of a swarm config that hold agents, as `GET /swarms` reads them */
+export interface SwarmAgentSlots {
+    supervisor?: {
+        name: string;
+    };
+    workers?: readonly {
+        name: string;
+    }[];
+    agents?: readonly {
+        name: string;
+    }[];
+    moderator?: {
+        name: string;
+    };
+    router?: {
+        name: string;
+    };
+    stages?: readonly {
+        agent: {
+            name: string;
+        };
+    }[];
+    pipeline?: {
+        stages: readonly {
+            agent: {
+                name: string;
+            };
+        }[];
+    };
+}
+/**
+ * The names of every agent a swarm runs, in the order the swarm registers them: supervisor,
+ * workers, agents, moderator, router, then the pipeline stages. Each name appears once.
+ */
+export declare function swarmAgentNames(config: SwarmAgentSlots): string[];
+//# sourceMappingURL=swarm.d.ts.map

package/dist/swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../src/swarm.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,EACxD,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtC,MAAM,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrC,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EAAE,CAAC;IAChD,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,SAAS;YAAE,KAAK,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;CAC/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAWjE"}

package/dist/swarm.js

@@ -0,0 +1,37 @@
+/**
+ * Runs `task` with a swarm the request created, and closes the swarm when the task settles:
+ * after success, failure or abort alike.
+ *
+ * A distributed swarm opens two Redis connections and keeps its state in Redis until it is
+ * closed, which also gives that state its expiry (`distributed.cleanupAfter`). A server that
+ * built one per request without closing it would leak connections until Redis refuses new
+ * clients. Closing an in-process swarm does nothing. A failure to close is logged, not
+ * thrown, so it never replaces the run's own result or error.
+ */
+export async function withSwarm(swarm, task) {
+    try {
+        return await task(swarm);
+    }
+    finally {
+        await swarm.close().catch((error) => {
+            console.warn('[cogitator] Failed to close a swarm:', error);
+        });
+    }
+}
+/**
+ * The names of every agent a swarm runs, in the order the swarm registers them: supervisor,
+ * workers, agents, moderator, router, then the pipeline stages. Each name appears once.
+ */
+export function swarmAgentNames(config) {
+    const names = [
+        config.supervisor?.name,
+        ...(config.workers ?? []).map((agent) => agent.name),
+        ...(config.agents ?? []).map((agent) => agent.name),
+        config.moderator?.name,
+        config.router?.name,
+        ...(config.stages ?? []).map((stage) => stage.agent.name),
+        ...(config.pipeline?.stages ?? []).map((stage) => stage.agent.name),
+    ];
+    return [...new Set(names.filter((name) => name !== undefined))];
+}
+//# sourceMappingURL=swarm.js.map

package/dist/swarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.js","sourceRoot":"","sources":["../src/swarm.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAQ,EACR,IAA8B;IAE9B,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC3C,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAaD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,MAAM,KAAK,GAAG;QACZ,MAAM,CAAC,UAAU,EAAE,IAAI;QACvB,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QACpD,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QACnD,MAAM,CAAC,SAAS,EAAE,IAAI;QACtB,MAAM,CAAC,MAAM,EAAE,IAAI;QACnB,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;KACpE,CAAC;IACF,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC"}

package/dist/validation.d.ts

@@ -1,3 +1,4 @@
+import type { ToolApprovalDecision } from '@cogitator-ai/types';
 /** The outcome of parsing a request body: the typed value, or why it was refused */
 export type ParseResult<T> = {
     ok: true;
@@ -29,6 +30,22 @@ export interface RunRequestBody {
     context?: Record<string, unknown>;
     threadId?: string;
 }
+/**
+ * Which keys of a request's `context` a server hands to the run.
+ *
+ * The run puts `context` into the system prompt, below the agent's instructions, so a
+ * client that can set it speaks with the operator's voice. `false` (the default) refuses
+ * every key, a list accepts only those keys, and `true` accepts any key, for clients the
+ * server trusts as much as its own code.
+ */
+export type ContextPolicy = boolean | readonly string[];
+/** How a server reads run requests */
+export interface RunRequestOptions {
+    /** Keys of `context` the server accepts from clients. Default: none */
+    acceptContext?: ContextPolicy;
+}
+/** The longest `timeout` a run accepts: the largest delay a JavaScript timer can hold (about 24.8 days) */
+export declare const MAX_RUN_TIMEOUT_MS = 2147483647;
 /** The body of `POST /swarms/:name/run` and `/swarms/:name/stream` */
 export interface SwarmRunRequestBody extends RunRequestBody {
     timeout?: number;
@@ -40,7 +57,56 @@ export interface SwarmRunRequestBody extends RunRequestBody {
  * says nothing is refused before the model is called (and billed). Every adapter
  * answers a refusal with `400 { error: { message, code: 'INVALID_INPUT' } }`.
  */
-export declare function parseRunRequest(body: unknown): ParseResult<RunRequestBody>;
+export declare function parseRunRequest(body: unknown, options?: RunRequestOptions): ParseResult<RunRequestBody>;
 /** Validates the body of a swarm run or stream: a run body plus an optional `timeout` in ms */
-export declare function parseSwarmRunRequest(body: unknown): ParseResult<SwarmRunRequestBody>;
+export declare function parseSwarmRunRequest(body: unknown, options?: RunRequestOptions): ParseResult<SwarmRunRequestBody>;
+/** The body of `POST /agents/:name/resume` and `/agents/:name/resume/stream` */
+export interface ResumeRequestBody {
+    /** The thread of the paused run */
+    threadId: string;
+    /** Decisions by tool call id; calls left out pause the run again */
+    decisions?: Record<string, ToolApprovalDecision>;
+    /** The decision for every paused call that `decisions` leaves out */
+    defaultDecision?: ToolApprovalDecision;
+}
+/** Validates the body of a resume: the thread of the paused run and the decisions for it */
+export declare function parseResumeRequest(body: unknown): ParseResult<ResumeRequestBody>;
+/** The roles a message added to a memory thread can have */
+export type ThreadMessageRole = 'user' | 'assistant' | 'system';
+/**
+ * The roles a server accepts on `POST /threads/:id/messages` unless told otherwise. A
+ * `system` message in a thread is read by the model as the operator's instructions, so a
+ * client may add one only where the server allows it explicitly.
+ */
+export declare const DEFAULT_THREAD_MESSAGE_ROLES: readonly ThreadMessageRole[];
+/** The body of `POST /threads/:id/messages` */
+export interface AddMessageRequestBody {
+    role: ThreadMessageRole;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+/** How a server reads messages added to threads */
+export interface AddMessageRequestOptions {
+    /** The roles clients may add. Default: {@link DEFAULT_THREAD_MESSAGE_ROLES} */
+    roles?: readonly ThreadMessageRole[];
+}
+/** Validates a message added to a thread, refusing the roles the server does not accept */
+export declare function parseAddMessageRequest(body: unknown, options?: AddMessageRequestOptions): ParseResult<AddMessageRequestBody>;
+/** The body of `POST /workflows/:name/run` and `/workflows/:name/stream` */
+export interface WorkflowRunRequestBody {
+    /** The initial workflow state */
+    input?: Record<string, unknown>;
+    options?: {
+        maxConcurrency?: number;
+        maxIterations?: number;
+    };
+}
+/**
+ * Validates the body of a workflow run; no body at all runs the workflow from an empty state.
+ *
+ * `options.checkpoint: true` is refused: a server runs each workflow on a fresh executor and
+ * keeps no checkpoint store, so a checkpoint would be lost with the request. Run the
+ * workflow with `WorkflowExecutor` and a `CheckpointStore` to resume it later.
+ */
+export declare function parseWorkflowRunRequest(body: unknown): ParseResult<WorkflowRunRequestBody>;
 //# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAIX,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE7E;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC,cAAc,CAAC,CAqB1E;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAUpF"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}

package/dist/validation.js

@@ -20,6 +20,8 @@ export function isNonBlankString(value) {
 export function isJsonObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+/** The longest `timeout` a run accepts: the largest delay a JavaScript timer can hold (about 24.8 days) */
+export const MAX_RUN_TIMEOUT_MS = 2_147_483_647;
 function fail(message) {
     return { ok: false, message };
 }
@@ -30,7 +32,7 @@ function fail(message) {
  * says nothing is refused before the model is called (and billed). Every adapter
  * answers a refusal with `400 { error: { message, code: 'INVALID_INPUT' } }`.
  */
-export function parseRunRequest(body) {
+export function parseRunRequest(body, options = {}) {
     if (!isJsonObject(body) || body.input === undefined || body.input === null) {
         return fail('Missing required field: input');
     }
@@ -41,6 +43,10 @@ export function parseRunRequest(body) {
     if (body.context !== undefined && !isJsonObject(body.context)) {
         return fail('Field "context" must be an object');
     }
+    const refusedKey = body.context === undefined ? undefined : refusedContextKey(body.context, options.acceptContext);
+    if (refusedKey !== undefined) {
+        return fail(`Key "${refusedKey}" of field "context" is not accepted by this server`);
+    }
     if (body.threadId !== undefined && !isNonBlankString(body.threadId)) {
         return fail('Field "threadId" must be a non-empty string');
     }
@@ -53,9 +59,15 @@ export function parseRunRequest(body) {
         },
     };
 }
+function refusedContextKey(context, policy = false) {
+    if (policy === true)
+        return undefined;
+    const accepted = policy === false ? [] : policy;
+    return Object.keys(context).find((key) => !accepted.includes(key));
+}
 /** Validates the body of a swarm run or stream: a run body plus an optional `timeout` in ms */
-export function parseSwarmRunRequest(body) {
-    const parsed = parseRunRequest(body);
+export function parseSwarmRunRequest(body, options = {}) {
+    const parsed = parseRunRequest(body, options);
     if (!parsed.ok)
         return parsed;
     const timeout = isJsonObject(body) ? body.timeout : undefined;
@@ -64,6 +76,121 @@ export function parseSwarmRunRequest(body) {
     if (typeof timeout !== 'number' || !Number.isFinite(timeout) || timeout <= 0) {
         return fail('Field "timeout" must be a positive number');
     }
+    if (timeout > MAX_RUN_TIMEOUT_MS) {
+        return fail(`Field "timeout" must be at most ${MAX_RUN_TIMEOUT_MS} ms`);
+    }
     return { ok: true, value: { ...parsed.value, timeout } };
 }
+const DECISION_SHAPE = '{ approved: boolean, reason?: string }';
+function parseDecision(value) {
+    if (!isJsonObject(value) || typeof value.approved !== 'boolean')
+        return undefined;
+    if (value.reason !== undefined && typeof value.reason !== 'string')
+        return undefined;
+    if (value.approved)
+        return { approved: true };
+    return value.reason === undefined
+        ? { approved: false }
+        : { approved: false, reason: value.reason };
+}
+/** Validates the body of a resume: the thread of the paused run and the decisions for it */
+export function parseResumeRequest(body) {
+    if (!isJsonObject(body) || body.threadId === undefined || body.threadId === null) {
+        return fail('Missing required field: threadId');
+    }
+    if (!isNonBlankString(body.threadId)) {
+        return fail('Field "threadId" must be a non-empty string');
+    }
+    const request = { threadId: body.threadId };
+    if (body.decisions !== undefined) {
+        if (!isJsonObject(body.decisions))
+            return fail('Field "decisions" must be an object');
+        const decisions = {};
+        for (const [toolCallId, value] of Object.entries(body.decisions)) {
+            const decision = parseDecision(value);
+            if (!decision)
+                return fail(`Each entry of "decisions" must be ${DECISION_SHAPE}`);
+            decisions[toolCallId] = decision;
+        }
+        request.decisions = decisions;
+    }
+    if (body.defaultDecision !== undefined) {
+        const decision = parseDecision(body.defaultDecision);
+        if (!decision)
+            return fail(`Field "defaultDecision" must be ${DECISION_SHAPE}`);
+        request.defaultDecision = decision;
+    }
+    return { ok: true, value: request };
+}
+/**
+ * The roles a server accepts on `POST /threads/:id/messages` unless told otherwise. A
+ * `system` message in a thread is read by the model as the operator's instructions, so a
+ * client may add one only where the server allows it explicitly.
+ */
+export const DEFAULT_THREAD_MESSAGE_ROLES = ['user', 'assistant'];
+/** Validates a message added to a thread, refusing the roles the server does not accept */
+export function parseAddMessageRequest(body, options = {}) {
+    const roles = options.roles ?? DEFAULT_THREAD_MESSAGE_ROLES;
+    if (!isJsonObject(body) || body.role === undefined || body.content === undefined) {
+        return fail('Missing required fields: role, content');
+    }
+    const role = roles.find((accepted) => accepted === body.role);
+    if (role === undefined) {
+        return fail(`Field "role" must be one of: ${roles.join(', ')}`);
+    }
+    if (!isNonBlankString(body.content))
+        return fail('Field "content" must be a non-empty string');
+    if (body.metadata !== undefined && !isJsonObject(body.metadata)) {
+        return fail('Field "metadata" must be an object');
+    }
+    return {
+        ok: true,
+        value: {
+            role,
+            content: body.content,
+            ...(body.metadata !== undefined && { metadata: body.metadata }),
+        },
+    };
+}
+function isPositiveInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0;
+}
+/**
+ * Validates the body of a workflow run; no body at all runs the workflow from an empty state.
+ *
+ * `options.checkpoint: true` is refused: a server runs each workflow on a fresh executor and
+ * keeps no checkpoint store, so a checkpoint would be lost with the request. Run the
+ * workflow with `WorkflowExecutor` and a `CheckpointStore` to resume it later.
+ */
+export function parseWorkflowRunRequest(body) {
+    if (body === undefined || body === null)
+        return { ok: true, value: {} };
+    if (!isJsonObject(body))
+        return fail('Request body must be a JSON object');
+    if (body.input !== undefined && !isJsonObject(body.input)) {
+        return fail('Field "input" must be an object');
+    }
+    const request = {};
+    if (body.input !== undefined)
+        request.input = body.input;
+    if (body.options !== undefined) {
+        if (!isJsonObject(body.options))
+            return fail('Field "options" must be an object');
+        const { maxConcurrency, maxIterations, checkpoint } = body.options;
+        if (maxConcurrency !== undefined && !isPositiveInteger(maxConcurrency)) {
+            return fail('Field "options.maxConcurrency" must be a positive integer');
+        }
+        if (maxIterations !== undefined && !isPositiveInteger(maxIterations)) {
+            return fail('Field "options.maxIterations" must be a positive integer');
+        }
+        if (checkpoint !== undefined && checkpoint !== false) {
+            return fail('Field "options.checkpoint" is not supported: the server keeps no checkpoint store');
+        }
+        request.options = {
+            ...(maxConcurrency !== undefined && { maxConcurrency }),
+            ...(maxIterations !== undefined && { maxIterations }),
+        };
+    }
+    return { ok: true, value: request };
+}
 //# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@cogitator-ai/server-shared",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Shared streaming protocol and utilities for Cogitator server adapters",
   "type": "module",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
   },
   "main": "./dist/index.js",
@@ -17,6 +18,9 @@
   "engines": {
     "node": ">=22.12.0"
   },
+  "dependencies": {
+    "@cogitator-ai/types": "0.36.0"
+  },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^5.0.3"