@owlmeans/viable-sdk 0.1.18-rc.8 → 0.1.18

package/build/session/tasks.js

@@ -1,89 +1,29 @@
+import { OpQueue } from './queue.js';
+/** When the platform stops waiting for a task; one without a readable time waits behind every other. */
+const expiryOf = (task) => {
+    const at = Date.parse(task.expiresAt);
+    return Number.isNaN(at) ? Number.POSITIVE_INFINITY : at;
+};
 /**
  * Model tasks waiting for the parent agent.
  *
- * A queue rather than a callback because of who drains it: the parent agent asks for work when it
- * is ready, through a tool call, and may take minutes to answer. Nothing here pushes — the whole
- * point of the local-LLM mode is that the platform waits on somebody else's schedule.
- *
- * The operation id is kept beside each task and never shown to the parent. It is what an answer is
- * routed back on, and a parent that could name one could answer an operation it was never given.
+ * Everything about how they queue, redeliver and settle is {@link OpQueue}'s; what is left here is
+ * the name the rest of the SDK reads them under. A task is a model CALL — the parent runs it in a
+ * clean subagent and submits the answer back — which is a different thing from a question, and the
+ * two must never drain into one another's tools.
  */
-export class TaskQueue {
-    queue = [];
-    ops = new Map();
+export class TaskQueue extends OpQueue {
     /**
-     * Every task this session has ever been handed.
-     *
-     * The platform redelivers an operation on every poll until it is answered — that is what makes a
-     * connector restart cost a round trip instead of a run. A model task takes a parent agent tens of
-     * seconds to answer, so without this the queue grew one copy per poll for the whole time it was
-     * being answered, and the parent then ran the same task over and over: real model calls, paid
-     * for, thrown away. Kept after settling too, so a redelivery that raced the platform's deletion
-     * is ignored rather than answered a second time.
+     * The task that expires first goes first. The platform gives up on a task at its `expiresAt` —
+     * a synchronous check inside a blocked call within seconds, a run's call within minutes — so the
+     * one with the least time left is the one a parent must not find behind the others.
      */
-    seen = new Set();
-    /** Handed out and not yet answered. An answer is checked against the task that asked for it. */
-    outstanding = new Map();
-    waiting = [];
-    /** @returns whether the task was accepted — `false` for a redelivery of one already handed over. */
-    push(task, opId) {
-        // The op id is refreshed even for a known task: a redelivery carries the same id today, and
-        // answering the wrong operation is worse than answering none.
-        this.ops.set(task.id, opId);
-        if (this.seen.has(task.id))
-            return false;
-        this.seen.add(task.id);
-        const next = this.waiting.shift();
-        if (next != null) {
-            clearTimeout(next.timer);
-            next.resolve(task);
-            return true;
-        }
-        this.queue.push(task);
-        return true;
-    }
-    /** The next task, or null once `waitMs` elapses. Never rejects: nothing to do is not a failure. */
-    async take(waitMs) {
-        const ready = this.queue.shift();
-        if (ready != null) {
-            this.outstanding.set(ready.id, ready);
-            return ready;
-        }
-        if (waitMs <= 0)
-            return null;
-        return await new Promise(resolve => {
-            const entry = {
-                resolve: task => {
-                    if (task != null)
-                        this.outstanding.set(task.id, task);
-                    resolve(task);
-                },
-                timer: setTimeout(() => {
-                    const at = this.waiting.indexOf(entry);
-                    if (at >= 0)
-                        this.waiting.splice(at, 1);
-                    resolve(null);
-                }, waitMs),
-            };
-            this.waiting.push(entry);
-        });
-    }
-    opIdOf(taskId) {
-        return this.ops.get(taskId) ?? null;
+    constructor() {
+        super((a, b) => expiryOf(a) - expiryOf(b));
     }
-    outstandingById(taskId) {
-        return this.outstanding.get(taskId) ?? null;
-    }
-    /** Handed out and still unanswered, oldest first. */
+    /** Handed to the parent and still unanswered, oldest first. */
     outstandingTasks() {
-        return [...this.outstanding.values()];
-    }
-    settle(taskId) {
-        this.ops.delete(taskId);
-        this.outstanding.delete(taskId);
-    }
-    size() {
-        return this.queue.length;
+        return this.outstanding();
     }
 }
 //# sourceMappingURL=tasks.js.map

package/build/session/tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/session/tasks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/session/tasks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpC,wGAAwG;AACxG,MAAM,QAAQ,GAAG,CAAC,IAAe,EAAU,EAAE;IAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAErC,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAA;AACzD,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,SAAU,SAAQ,OAAkB;IAC/C;;;;OAIG;IACH;QACE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5C,CAAC;IAED,+DAA+D;IAC/D,gBAAgB;QACd,OAAO,IAAI,CAAC,WAAW,EAAE,CAAA;IAC3B,CAAC;CACF"}

package/build/session/types.d.ts

@@ -0,0 +1,20 @@
+import type { ConnectorApi, LocalExecutor, OpenSessionArgs } from '../types.js';
+export interface SessionOptions {
+    api: ConnectorApi;
+    open: OpenSessionArgs;
+    /** Absent for a cloud target: the platform's own pod executes its commands. */
+    executor?: LocalExecutor;
+    /** Which deployment this is, recorded in the project's marker so a later connector finds it. */
+    apiUrl?: string;
+    log?: (line: string) => void;
+}
+export interface Waiting<T> {
+    resolve: (item: T | null) => void;
+    timer: ReturnType<typeof setTimeout>;
+}
+/** A caller told when an item is queued, without taking it. */
+export interface Watching {
+    resolve: (ready: boolean) => void;
+    timer: ReturnType<typeof setTimeout>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE/E,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,YAAY,CAAA;IACjB,IAAI,EAAE,eAAe,CAAA;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;IACjC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA;CACrC;AAED,+DAA+D;AAC/D,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACjC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA;CACrC"}

package/build/session/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":""}

package/build/task/consts.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The two values a confirmed and a refused question answer with.
+ *
+ * Mirrors `CONFIRM_YES` / `CONFIRM_NO` in `@owlmeans/llm-common` — the package that reads the
+ * answer — value for value, and is deliberately a copy rather than an import: this package is
+ * installed by developers to drive their own machine and must not carry the model runtime, which
+ * is the same reason {@link ConnectInquiryKind} mirrors `InquiryKind`. The two must stay equal, or
+ * a person's "yes" reaches the asker as a value it has never heard of.
+ */
+export declare const CONFIRM_YES = "yes";
+export declare const CONFIRM_NO = "no";
+//# sourceMappingURL=consts.d.ts.map

package/build/task/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../src/task/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,QAAQ,CAAA;AAEhC,eAAO,MAAM,UAAU,OAAO,CAAA"}

package/build/task/consts.js

@@ -0,0 +1,12 @@
+/**
+ * The two values a confirmed and a refused question answer with.
+ *
+ * Mirrors `CONFIRM_YES` / `CONFIRM_NO` in `@owlmeans/llm-common` — the package that reads the
+ * answer — value for value, and is deliberately a copy rather than an import: this package is
+ * installed by developers to drive their own machine and must not carry the model runtime, which
+ * is the same reason {@link ConnectInquiryKind} mirrors `InquiryKind`. The two must stay equal, or
+ * a person's "yes" reaches the asker as a value it has never heard of.
+ */
+export const CONFIRM_YES = 'yes';
+export const CONFIRM_NO = 'no';
+//# sourceMappingURL=consts.js.map

package/build/task/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../src/task/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAA;AAEhC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAA"}

package/build/task/consts.local.d.ts

@@ -0,0 +1,19 @@
+import { ModelTaskRole, ConnectHarness, ModelTaskMode } from '@owlmeans/viable-common';
+export declare const ROLE_TO_LC: Record<ModelTaskRole, string>;
+/**
+ * How each parent agent is told to run a task in a CLEAN subagent.
+ *
+ * The instruction differs per harness only in the mechanism — which tool spawns a subagent, what
+ * the effort knob is called — never in what is being asked. A harness with no subagent mechanism
+ * Every one of them carries the inline fallback, which is the same request with the isolation
+ * stated rather than enforced. None may assert that the worker EXISTS: `install_harness` is what
+ * writes it, nothing in the flow requires that to have been run, and a block that names a file as
+ * a fact sends a literal agent to a subagent type it does not have — on the first task, before it
+ * has done anything.
+ */
+export declare const HOW_TO_RUN: Record<ConnectHarness, string>;
+export declare const SHAPE: Record<ModelTaskMode, string>;
+export declare const ROLE_LABEL: Record<ModelTaskRole, string>;
+/** What a parent may send for a confirm question, beyond the two values themselves. */
+export declare const CONFIRM_WORDS: Record<string, string>;
+//# sourceMappingURL=consts.local.d.ts.map

package/build/task/consts.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../../src/task/consts.local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAGtF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAOpD,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CA6BrD,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAU/C,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAKpD,CAAA;AAED,uFAAuF;AACvF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQhD,CAAA"}

package/build/task/consts.local.js

@@ -0,0 +1,72 @@
+import { ModelTaskRole, ConnectHarness, ModelTaskMode } from '@owlmeans/viable-common';
+import { CONFIRM_NO, CONFIRM_YES } from './consts.js';
+export const ROLE_TO_LC = {
+    [ModelTaskRole.System]: 'system',
+    [ModelTaskRole.User]: 'user',
+    [ModelTaskRole.Assistant]: 'assistant',
+    // A chat model called without the tool definitions cannot receive a tool turn; the content is
+    // what mattered anyway, and presenting it as a user turn keeps the conversation readable.
+    [ModelTaskRole.Tool]: 'user',
+};
+/**
+ * How each parent agent is told to run a task in a CLEAN subagent.
+ *
+ * The instruction differs per harness only in the mechanism — which tool spawns a subagent, what
+ * the effort knob is called — never in what is being asked. A harness with no subagent mechanism
+ * Every one of them carries the inline fallback, which is the same request with the isolation
+ * stated rather than enforced. None may assert that the worker EXISTS: `install_harness` is what
+ * writes it, nothing in the flow requires that to have been run, and a block that names a file as
+ * a fact sends a literal agent to a subagent type it does not have — on the first task, before it
+ * has done anything.
+ */
+export const HOW_TO_RUN = {
+    [ConnectHarness.ClaudeCode]: 'Use the Agent tool with subagent_type "viable-worker", which install_harness writes to\n'
+        + '.claude/agents/viable-worker.md with effort: low. If that subagent is not installed, either\n'
+        + 'call install_harness now or answer INLINE: reason minimally and produce only the answer.\n'
+        + 'Give the worker the SYSTEM PROMPT as its opening instruction, then the CONVERSATION in\n'
+        + 'order, then the shape rule below. Take its final message verbatim.',
+    [ConnectHarness.Codex]: 'Spawn a subagent with the "viable-worker" role, which install_harness writes to config.toml\n'
+        + 'as `[agents.viable-worker]` with a low model_reasoning_effort. If it is not installed or\n'
+        + 'your session has no subagents, answer the task INLINE in a single reply: reason minimally,\n'
+        + 'produce only the answer in the required shape, and nothing else. Give the worker the SYSTEM\n'
+        + 'PROMPT first, then the CONVERSATION in order, then the shape rule below. Do not pass this\n'
+        + 'outer HOW TO RUN or submit_task_result instruction to the worker: only the parent submits its\n'
+        + 'final answer. A text task returns the requested text or source, never a JSON tool-call array;\n'
+        + 'that array is only valid in tools mode. Take the worker\'s final message verbatim.',
+    [ConnectHarness.Copilot]: 'Delegate to the "viable-worker" custom agent, which install_harness writes to\n'
+        + '.github/agents/viable-worker.agent.md. If it is not installed or delegation is\n'
+        + 'unavailable, answer the task INLINE in a single reply: reason minimally and produce only\n'
+        + 'the answer in the required shape.',
+    [ConnectHarness.OpenCode]: 'Invoke the `viable-worker` subagent (@viable-worker, or the Task tool), which install_harness\n'
+        + 'writes to .opencode/agent/viable-worker.md. If it is not installed, answer INLINE instead:\n'
+        + 'reason minimally and produce only the answer. Give the worker the SYSTEM PROMPT, then the\n'
+        + 'CONVERSATION, then the shape rule below.',
+    [ConnectHarness.Other]: 'Run this in a fresh, isolated context — not in this conversation. Reason minimally. Produce\n'
+        + 'only the answer in the required shape.',
+};
+export const SHAPE = {
+    [ModelTaskMode.Text]: 'The answer is plain text. Send it as the `result` string, verbatim.',
+    [ModelTaskMode.Json]: 'The answer must be ONE JSON object matching the OUTPUT SCHEMA below — no prose, no code fence,\n'
+        + 'no explanation. Send it as `result`.',
+    [ModelTaskMode.Tools]: 'Answer with a JSON array of tool calls chosen from the TOOLS below, each\n'
+        + '{"name": "...", "args": {...}} — nothing else around it. If no tool call is needed and the\n'
+        + 'work is done, answer in plain text instead: that is how the caller learns the turn is over.\n'
+        + 'Send whichever it is as `result`.',
+};
+export const ROLE_LABEL = {
+    [ModelTaskRole.System]: 'system',
+    [ModelTaskRole.User]: 'user',
+    [ModelTaskRole.Assistant]: 'assistant',
+    [ModelTaskRole.Tool]: 'tool',
+};
+/** What a parent may send for a confirm question, beyond the two values themselves. */
+export const CONFIRM_WORDS = {
+    yes: CONFIRM_YES,
+    y: CONFIRM_YES,
+    true: CONFIRM_YES,
+    ok: CONFIRM_YES,
+    no: CONFIRM_NO,
+    n: CONFIRM_NO,
+    false: CONFIRM_NO,
+};
+//# sourceMappingURL=consts.local.js.map

package/build/task/consts.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../../src/task/consts.local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACtF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,CAAC,MAAM,UAAU,GAAkC;IACvD,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ;IAChC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM;IAC5B,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,WAAW;IACtC,8FAA8F;IAC9F,0FAA0F;IAC1F,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM;CAC7B,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAmC;IACxD,CAAC,cAAc,CAAC,UAAU,CAAC,EACzB,0FAA0F;UACxF,+FAA+F;UAC/F,4FAA4F;UAC5F,0FAA0F;UAC1F,oEAAoE;IACxE,CAAC,cAAc,CAAC,KAAK,CAAC,EACpB,+FAA+F;UAC7F,4FAA4F;UAC5F,8FAA8F;UAC9F,+FAA+F;UAC/F,6FAA6F;UAC7F,iGAAiG;UACjG,iGAAiG;UACjG,oFAAoF;IACxF,CAAC,cAAc,CAAC,OAAO,CAAC,EACtB,iFAAiF;UAC/E,kFAAkF;UAClF,4FAA4F;UAC5F,mCAAmC;IACvC,CAAC,cAAc,CAAC,QAAQ,CAAC,EACvB,iGAAiG;UAC/F,8FAA8F;UAC9F,6FAA6F;UAC7F,0CAA0C;IAC9C,CAAC,cAAc,CAAC,KAAK,CAAC,EACpB,+FAA+F;UAC7F,wCAAwC;CAC7C,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAkC;IAClD,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,qEAAqE;IAC3F,CAAC,aAAa,CAAC,IAAI,CAAC,EAClB,kGAAkG;UAChG,sCAAsC;IAC1C,CAAC,aAAa,CAAC,KAAK,CAAC,EACnB,4EAA4E;UAC1E,8FAA8F;UAC9F,+FAA+F;UAC/F,mCAAmC;CACxC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAkC;IACvD,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ;IAChC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM;IAC5B,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,WAAW;IACtC,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM;CAC7B,CAAA;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,GAAG,EAAE,WAAW;IAChB,CAAC,EAAE,WAAW;IACd,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,WAAW;IACf,EAAE,EAAE,UAAU;IACd,CAAC,EAAE,UAAU;IACb,KAAK,EAAE,UAAU;CAClB,CAAA"}

package/build/task/driver.d.ts

@@ -1,30 +1,3 @@
-import type { ModelTask, ModelTaskResult } from '@owlmeans/viable-common';
-/**
- * Something that can answer a model task without a coding agent in front of it.
- *
- * Two consumers, and both are the reason it is an interface rather than a function on the session:
- * the end-to-end tests, which have to play the parent agent deterministically, and the CLI this
- * SDK exists to make possible, where the "parent agent" is the CLI's own model.
- */
-export interface TaskDriver {
-    answer: (task: ModelTask) => Promise<ModelTaskResult>;
-}
-/** The minimum a chat model must offer to stand in for a parent agent. */
-export interface DriverModel {
-    invoke: (messages: Array<{
-        role: string;
-        content: string;
-    }>) => Promise<string>;
-}
-export interface LangchainLikeModel {
-    invoke: (messages: unknown) => Promise<{
-        content: unknown;
-    }>;
-    bindTools?: (tools: unknown[], kwargs?: unknown) => LangchainLikeModel;
-}
-export interface ModelDriverOptions {
-    /** One model per tier. A tier with no model falls back to the first one given. */
-    models: Partial<Record<string, LangchainLikeModel>>;
-}
+import type { ModelDriverOptions, TaskDriver } from './types.js';
 export declare const makeModelTaskDriver: (opts: ModelDriverOptions) => TaskDriver;
 //# sourceMappingURL=driver.d.ts.map

package/build/task/driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/task/driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;CACtD;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAChF;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC5D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,kBAAkB,CAAA;CACvE;AAED,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAA;CACpD;AA8DD,eAAO,MAAM,mBAAmB,SAAU,kBAAkB,KAAG,UAwE9D,CAAA"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/task/driver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAqDpF,eAAO,MAAM,mBAAmB,SAAU,kBAAkB,KAAG,UAwE9D,CAAA"}

package/build/task/driver.js

@@ -1,17 +1,10 @@
-import { ModelTaskMode, ModelTaskResultKind, ModelTaskRole } from '@owlmeans/viable-common';
+import { ModelTaskMode, ModelTaskResultKind } from '@owlmeans/viable-common';
+import { ROLE_TO_LC } from './consts.local.js';
 const textOf = (content) => typeof content === 'string'
     ? content
     : Array.isArray(content)
         ? content.map(part => part.text ?? '').join('')
         : String(content ?? '');
-const ROLE_TO_LC = {
-    [ModelTaskRole.System]: 'system',
-    [ModelTaskRole.User]: 'user',
-    [ModelTaskRole.Assistant]: 'assistant',
-    // A chat model called without the tool definitions cannot receive a tool turn; the content is
-    // what mattered anyway, and presenting it as a user turn keeps the conversation readable.
-    [ModelTaskRole.Tool]: 'user',
-};
 /**
  * A reference parent agent, backed by a chat model.
  *

package/build/task/driver.js.map

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

package/build/task/envelope/types.d.ts

@@ -0,0 +1,29 @@
+import type { ModelTask } from '@owlmeans/viable-common';
+import type { EnvelopeOptions, ParsedTaskResult } from '../types.js';
+/** One model task handed to a parent agent, and the answer it sends back checked against it. */
+export interface TaskEnvelopeModel {
+    readonly task: ModelTask;
+    /**
+     * What `next_task` hands the parent agent.
+     *
+     * Text rather than a structure, because the reader is a language model working from a tool result:
+     * it has to be able to act on this without a schema in front of it. Everything it must do is
+     * stated in order — how to run it, what to call afterwards, what shape the answer takes — before
+     * the material itself, so a model that stops reading early has still read the instruction.
+     *
+     * The task id appears at the top and in the follow-up call on purpose. It is the only thing that
+     * routes an answer back, and a parent that paraphrases the rest but copies the id still works.
+     */
+    renderTaskEnvelope: (opts: EnvelopeOptions) => string;
+    /**
+     * Check a parent's answer against what the task asked for, before the platform ever sees it.
+     *
+     * The refusal is worth more than the parse. A malformed answer that reaches the platform costs a
+     * whole retry — another task, another subagent, another wait — while one caught here is a sentence
+     * the parent can act on immediately, with the subagent's context still open. So a failure comes
+     * back as a `problem`, not as a thrown error, and the caller renders it as a tool error the model
+     * reads and corrects.
+     */
+    parseTaskResult: (raw: unknown) => ParsedTaskResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/task/envelope/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/task/envelope/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEpE,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB;;;;;;;;;;OAUG;IACH,kBAAkB,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,MAAM,CAAA;IACrD;;;;;;;;OAQG;IACH,eAAe,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,gBAAgB,CAAA;CACpD"}

package/build/task/envelope/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/task/envelope/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/task/envelope/types.ts"],"names":[],"mappings":""}

package/build/task/envelope.d.ts

@@ -1,35 +1,5 @@
-import { ConnectHarness } from '@owlmeans/viable-common';
-import type { ModelTask, ModelTaskResult } from '@owlmeans/viable-common';
-export interface EnvelopeOptions {
-    harness: ConnectHarness;
-    /** What the parent said it would run each tier on. Display only. */
-    tiers?: Partial<Record<string, string>>;
-}
-/**
- * What `next_task` hands the parent agent.
- *
- * Text rather than a structure, because the reader is a language model working from a tool result:
- * it has to be able to act on this without a schema in front of it. Everything it must do is
- * stated in order — how to run it, what to call afterwards, what shape the answer takes — before
- * the material itself, so a model that stops reading early has still read the instruction.
- *
- * The task id appears at the top and in the follow-up call on purpose. It is the only thing that
- * routes an answer back, and a parent that paraphrases the rest but copies the id still works.
- */
-export declare const renderTaskEnvelope: (task: ModelTask, opts: EnvelopeOptions) => string;
-export interface ParsedTaskResult {
-    result?: ModelTaskResult;
-    /** Present when the answer did not match what was asked. Quoted back to the parent verbatim. */
-    problem?: string;
-}
-/**
- * Check a parent's answer against what the task asked for, before the platform ever sees it.
- *
- * The refusal is worth more than the parse. A malformed answer that reaches the platform costs a
- * whole retry — another task, another subagent, another wait — while one caught here is a sentence
- * the parent can act on immediately, with the subagent's context still open. So a failure comes
- * back as a `problem`, not as a thrown error, and the caller renders it as a tool error the model
- * reads and corrects.
- */
-export declare const parseTaskResult: (task: ModelTask, raw: unknown) => ParsedTaskResult;
+import { type ModelTask } from '@owlmeans/viable-common';
+import type { TaskEnvelopeModel } from './envelope/types.js';
+/** One model task handed to a parent agent, and the answer it sends back checked against it. */
+export declare const makeTaskEnvelopeModel: (task: ModelTask) => TaskEnvelopeModel;
 //# sourceMappingURL=envelope.d.ts.map

package/build/task/envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/task/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqD,MAAM,yBAAyB,CAAA;AAC3G,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AA4DzE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,cAAc,CAAA;IACvB,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACxC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,SAAU,SAAS,QAAQ,eAAe,KAAG,MAgD3E,CAAA;AAWD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAiDD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,SACpB,SAAS,OAAO,OAAO,KAC5B,gBAqEF,CAAA"}
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/task/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAI5G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AA0D5D,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,SAAU,SAAS,KAAG,iBA2HvD,CAAA"}