@tessar/core 0.1.0-alpha.0 → 0.1.0

package/dist/events/{catalog.d.ts → type.d.ts}

@@ -4,11 +4,25 @@ import type { MessageData } from "../messages/message.js";
 import type { ModelRef, ModelRequest, ModelResponse, ToolDescription } from "../models/contract.js";
 import type { ErrorInfo } from "../errors.js";
 import type { ModelUsage, UsageSummary } from "../trace/usage.js";
-import type { ToolResult as ToolResultData } from "../tools/tool.js";
 import type { InterruptRecord, ThreadInfo } from "../state/schema.js";
 import type { CreateThreadOptions } from "../state/threads.js";
 import type { DecisionHookContext } from "../engine/interrupt.js";
 import type { ExecutionHookContext } from "../engine/tracked-effects.js";
+import type { SessionHookContext, ThreadHookContext } from "../plugins/context.js";
+import type { ForkOptions } from "../state/fork.js";
+export type OperationDecision = {
+    decision: "allow" | "deny";
+    reason?: string;
+};
+export type OperationEvent = "session.model.before-change" | "session.thread.before-switch" | "thread.before-fork" | "thread.before-rename" | "thread.before-delete";
+export interface QueuedInputReceipt {
+    id: string;
+    threadId: string;
+}
+export interface ExecutionReceipt {
+    streamId: string;
+    threadId: string;
+}
 export type ControlDecision = {
     decision: "allow" | "deny" | "continue" | "stop" | "retry" | "fail";
     reason?: string;
@@ -43,55 +57,164 @@ export interface StreamOutcome {
     error: ErrorInfo | null;
     interrupt: InterruptRecord | null;
 }
-export declare const AgentEvents: {
-    readonly Diagnostic: "diagnostic";
-    readonly Ready: "ready";
-    readonly Shutdown: "shutdown";
-    readonly ThreadPrepare: "thread.prepare";
-    readonly ThreadStarted: "thread.started";
-    readonly ThreadBeforeShutdown: "thread.before-shutdown";
-    readonly ThreadShutdown: "thread.shutdown";
-    readonly ThreadUpdated: "thread.updated";
-    readonly InputPrepare: "input.prepare";
-    readonly InputReceived: "input.received";
-    readonly BeforeStream: "stream.before";
-    readonly StreamStarted: "stream.started";
-    readonly StreamBeforeEnd: "stream.before-end";
-    readonly StreamEnd: "stream.end";
-    readonly StreamError: "stream.error";
-    readonly StreamSuspended: "stream.suspended";
-    readonly StreamResumed: "stream.resumed";
-    readonly TurnStart: "turn.start";
-    readonly TurnEnd: "turn.end";
-    readonly TurnDecision: "turn.decision";
-    readonly ContextPrepare: "context.prepare";
-    readonly ToolsSelect: "tools.select";
-    readonly ModelSelect: "model.select";
-    readonly ModelRequest: "model.request";
-    readonly ModelStart: "model.start";
-    readonly ModelEnd: "model.end";
-    readonly ModelResponse: "model.response";
-    readonly ModelUsage: "model.usage";
-    readonly ModelError: "model.error";
-    readonly ModelRecover: "model.recover";
-    readonly MessagePrepare: "message.prepare";
-    readonly MessageBeforeCommit: "message.before-commit";
-    readonly MessageDelta: "message.delta";
-    readonly MessageCommitted: "message.committed";
-    readonly ToolPrepare: "tool.prepare";
-    readonly BeforeTool: "tool.before";
-    readonly ToolStart: "tool.start";
-    readonly ToolUpdate: "tool.update";
-    readonly ToolEnd: "tool.end";
-    readonly ToolError: "tool.error";
-    readonly ToolResult: "tool.result";
-    readonly StreamCancel: "stream.cancel";
-    readonly CheckpointCommitted: "checkpoint.committed";
+export declare const ready = "ready";
+export declare const shutdown = "shutdown";
+export declare const diagnostic = "diagnostic";
+export declare const thread: {
+    readonly prepare: "thread.prepare";
+    readonly started: "thread.started";
+    readonly beforeShutdown: "thread.before-shutdown";
+    readonly shutdown: "thread.shutdown";
+    readonly updated: "thread.updated";
+    readonly beforeFork: "thread.before-fork";
+    readonly forked: "thread.forked";
+    readonly beforeRename: "thread.before-rename";
+    readonly renamed: "thread.renamed";
+    readonly beforeDelete: "thread.before-delete";
+    readonly deleted: "thread.deleted";
+};
+export declare const session: {
+    readonly created: "session.created";
+    readonly modelChanged: "session.model-changed";
+    readonly threadCreated: "session.thread-created";
+    readonly threadSwitched: "session.thread-switched";
+    readonly threadRenamed: "session.thread-renamed";
+    readonly threadForked: "session.thread-forked";
+    readonly threadDeleted: "session.thread-deleted";
+    readonly inputQueued: "session.input-queued";
+    readonly inputDiscarded: "session.input-discarded";
+    readonly beforeClose: "session.before-close";
+    readonly closed: "session.closed";
+    readonly model: {
+        readonly beforeChange: "session.model.before-change";
+    };
+    readonly thread: {
+        readonly beforeSwitch: "session.thread.before-switch";
+    };
+};
+export declare const input: {
+    readonly prepare: "input.prepare";
+    readonly received: "input.received";
+};
+export declare const stream: {
+    readonly before: "stream.before";
+    readonly started: "stream.started";
+    readonly beforeEnd: "stream.before-end";
+    readonly end: "stream.end";
+    readonly error: "stream.error";
+    readonly suspended: "stream.suspended";
+    readonly resumed: "stream.resumed";
+    readonly cancel: "stream.cancel";
+};
+export declare const turn: {
+    readonly start: "turn.start";
+    readonly end: "turn.end";
+    readonly decision: "turn.decision";
+};
+export declare const context: {
+    readonly prepare: "context.prepare";
+};
+export declare const tools: {
+    readonly select: "tools.select";
+};
+export declare const model: {
+    readonly select: "model.select";
+    readonly request: "model.request";
+    readonly start: "model.start";
+    readonly end: "model.end";
+    readonly response: "model.response";
+    readonly usage: "model.usage";
+    readonly error: "model.error";
+    readonly recover: "model.recover";
+};
+export declare const message: {
+    readonly prepare: "message.prepare";
+    readonly beforeCommit: "message.before-commit";
+    readonly delta: "message.delta";
+    readonly committed: "message.committed";
+};
+export declare const tool: {
+    readonly prepare: "tool.prepare";
+    readonly before: "tool.before";
+    readonly start: "tool.start";
+    readonly update: "tool.update";
+    readonly end: "tool.end";
+    readonly error: "tool.error";
+    readonly result: "tool.result";
+};
+export declare const checkpoint: {
+    readonly committed: "checkpoint.committed";
 };
 type Transform<P> = HookSpec<P, P, ExecutionHookContext>;
 type Decision<P> = HookSpec<P, ControlDecision, DecisionHookContext>;
 declare module "./definition.js" {
     interface EventMap {
+        "session.model.before-change": HookSpec<{
+            previous: ModelRef;
+            model: ModelRef;
+        }, OperationDecision, SessionHookContext>;
+        "session.thread.before-switch": HookSpec<{
+            previousThreadId: string | null;
+            threadId: string;
+        }, OperationDecision, SessionHookContext>;
+        "thread.before-fork": HookSpec<{
+            threadId: string;
+            options: ForkOptions;
+        }, OperationDecision, ThreadHookContext>;
+        "thread.before-rename": HookSpec<{
+            threadId: string;
+            title: string;
+        }, OperationDecision, ThreadHookContext>;
+        "thread.before-delete": HookSpec<{
+            threadId: string;
+            permanent?: boolean;
+        }, OperationDecision, ThreadHookContext>;
+        "thread.forked": HookSpec<{
+            threadId: string;
+            forkedThreadId: string;
+        }, void, ThreadHookContext>;
+        "thread.renamed": HookSpec<{
+            threadId: string;
+            title: string;
+        }, void, ThreadHookContext>;
+        "thread.deleted": HookSpec<{
+            threadId: string;
+            permanent?: boolean;
+        }, void, ThreadHookContext>;
+        "session.created": HookSpec<{
+            model: ModelRef;
+        }, void, SessionHookContext>;
+        "session.model-changed": HookSpec<{
+            previous: ModelRef;
+            model: ModelRef;
+        }, void, SessionHookContext>;
+        "session.thread-created": HookSpec<{
+            threadId: string;
+        }, void, SessionHookContext>;
+        "session.thread-switched": HookSpec<{
+            previousThreadId: string | null;
+            threadId: string;
+        }, void, SessionHookContext>;
+        "session.thread-renamed": HookSpec<{
+            threadId: string;
+            title: string;
+        }, void, SessionHookContext>;
+        "session.thread-forked": HookSpec<{
+            sourceThreadId: string;
+            threadId: string;
+        }, void, SessionHookContext>;
+        "session.thread-deleted": HookSpec<{
+            threadId: string;
+        }, void, SessionHookContext>;
+        "session.input-queued": HookSpec<{
+            receipt: QueuedInputReceipt;
+        }, void, SessionHookContext>;
+        "session.input-discarded": HookSpec<{
+            receipt: QueuedInputReceipt;
+            cause: string;
+        }, void, SessionHookContext>;
+        "session.before-close": HookSpec<{}, void, SessionHookContext>;
+        "session.closed": HookSpec<{}, void, SessionHookContext>;
         diagnostic: HookSpec<{
             error: ErrorInfo;
         }>;
@@ -205,14 +328,14 @@ declare module "./definition.js" {
         "tool.end": HookSpec<{
             toolExecutionId: string;
             toolCallId: string;
-            result: ToolResultData;
+            result: MessageData;
             status: string;
         }>;
         "tool.error": HookSpec<{
             toolExecutionId: string;
             error: ErrorInfo;
         }>;
-        "tool.result": Transform<ToolResultData>;
+        "tool.result": Transform<MessageData>;
         "stream.cancel": HookSpec<{
             reason: string;
         }>;

package/dist/events/type.js

@@ -0,0 +1,175 @@
+export const ready = "ready";
+export const shutdown = "shutdown";
+export const diagnostic = "diagnostic";
+export const thread = {
+    prepare: "thread.prepare",
+    started: "thread.started",
+    beforeShutdown: "thread.before-shutdown",
+    shutdown: "thread.shutdown",
+    updated: "thread.updated",
+    beforeFork: "thread.before-fork",
+    forked: "thread.forked",
+    beforeRename: "thread.before-rename",
+    renamed: "thread.renamed",
+    beforeDelete: "thread.before-delete",
+    deleted: "thread.deleted",
+};
+export const session = {
+    created: "session.created",
+    modelChanged: "session.model-changed",
+    threadCreated: "session.thread-created",
+    threadSwitched: "session.thread-switched",
+    threadRenamed: "session.thread-renamed",
+    threadForked: "session.thread-forked",
+    threadDeleted: "session.thread-deleted",
+    inputQueued: "session.input-queued",
+    inputDiscarded: "session.input-discarded",
+    beforeClose: "session.before-close",
+    closed: "session.closed",
+    model: {
+        beforeChange: "session.model.before-change",
+    },
+    thread: {
+        beforeSwitch: "session.thread.before-switch",
+    },
+};
+export const input = {
+    prepare: "input.prepare",
+    received: "input.received",
+};
+export const stream = {
+    before: "stream.before",
+    started: "stream.started",
+    beforeEnd: "stream.before-end",
+    end: "stream.end",
+    error: "stream.error",
+    suspended: "stream.suspended",
+    resumed: "stream.resumed",
+    cancel: "stream.cancel",
+};
+export const turn = {
+    start: "turn.start",
+    end: "turn.end",
+    decision: "turn.decision",
+};
+export const context = {
+    prepare: "context.prepare",
+};
+export const tools = {
+    select: "tools.select",
+};
+export const model = {
+    select: "model.select",
+    request: "model.request",
+    start: "model.start",
+    end: "model.end",
+    response: "model.response",
+    usage: "model.usage",
+    error: "model.error",
+    recover: "model.recover",
+};
+export const message = {
+    prepare: "message.prepare",
+    beforeCommit: "message.before-commit",
+    delta: "message.delta",
+    committed: "message.committed",
+};
+export const tool = {
+    prepare: "tool.prepare",
+    before: "tool.before",
+    start: "tool.start",
+    update: "tool.update",
+    end: "tool.end",
+    error: "tool.error",
+    result: "tool.result",
+};
+export const checkpoint = {
+    committed: "checkpoint.committed",
+};
+/** Dispatch behavior is internal metadata; public event identifiers are strings. */
+export const hookKinds = Object.freeze({
+    ready: "notification",
+    shutdown: "barrier",
+    diagnostic: "notification",
+    "thread.prepare": "transformation",
+    "thread.started": "notification",
+    "thread.before-shutdown": "barrier",
+    "thread.shutdown": "notification",
+    "thread.updated": "notification",
+    "thread.before-fork": "decision",
+    "thread.forked": "notification",
+    "thread.before-rename": "decision",
+    "thread.renamed": "notification",
+    "thread.before-delete": "decision",
+    "thread.deleted": "notification",
+    "session.created": "notification",
+    "session.model-changed": "notification",
+    "session.thread-created": "notification",
+    "session.thread-switched": "notification",
+    "session.thread-renamed": "notification",
+    "session.thread-forked": "notification",
+    "session.thread-deleted": "notification",
+    "session.input-queued": "notification",
+    "session.input-discarded": "notification",
+    "session.before-close": "barrier",
+    "session.closed": "notification",
+    "session.model.before-change": "decision",
+    "session.thread.before-switch": "decision",
+    "input.prepare": "transformation",
+    "input.received": "notification",
+    "stream.before": "decision",
+    "stream.started": "notification",
+    "stream.before-end": "barrier",
+    "stream.end": "notification",
+    "stream.error": "notification",
+    "stream.suspended": "notification",
+    "stream.resumed": "notification",
+    "stream.cancel": "notification",
+    "turn.start": "notification",
+    "turn.end": "notification",
+    "turn.decision": "decision",
+    "context.prepare": "transformation",
+    "tools.select": "transformation",
+    "model.select": "decision",
+    "model.request": "transformation",
+    "model.start": "notification",
+    "model.end": "notification",
+    "model.response": "transformation",
+    "model.usage": "notification",
+    "model.error": "notification",
+    "model.recover": "decision",
+    "message.prepare": "transformation",
+    "message.before-commit": "barrier",
+    "message.delta": "notification",
+    "message.committed": "notification",
+    "tool.prepare": "transformation",
+    "tool.before": "decision",
+    "tool.start": "notification",
+    "tool.update": "notification",
+    "tool.end": "notification",
+    "tool.error": "notification",
+    "tool.result": "transformation",
+    "checkpoint.committed": "notification",
+});
+export const ToolDecision = {
+    allow: () => ({ decision: "allow" }),
+    deny: (reason) => ({ decision: "deny", reason }),
+};
+export const TurnDecision = {
+    continue: () => ({ decision: "continue" }),
+    stop: (reason) => ({ decision: "stop", reason }),
+};
+export const InputDecision = {
+    continue: (messages) => ({
+        messages,
+    }),
+    handled: (outcome) => ({
+        messages: [],
+        handled: outcome,
+    }),
+    reject: (error) => ({
+        messages: [],
+        rejected: error,
+    }),
+};
+//# sourceMappingURL=type.js.map

package/dist/events/type.js.map

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

package/dist/identity.d.ts

@@ -0,0 +1 @@
+export declare function reserveId(kind: "Agent" | "Controller", id: string, instance: object): () => void;

package/dist/identity.js

@@ -0,0 +1,23 @@
+import { fail } from "./errors.js";
+const agents = new Map();
+const controllers = new Map();
+function release({ entries, id, reference }) {
+    if (entries.get(id) === reference)
+        entries.delete(id);
+}
+// Track identity without keeping otherwise-unused SDK instances alive.
+const collected = new FinalizationRegistry(release);
+export function reserveId(kind, id, instance) {
+    const entries = kind === "Agent" ? agents : controllers;
+    if (entries.get(id)?.deref())
+        fail("RegistrationConflict", `${kind} ID already in use: ${id}`);
+    const reference = new WeakRef(instance);
+    const reservation = { entries, id, reference };
+    entries.set(id, reference);
+    collected.register(instance, reservation, reference);
+    return () => {
+        release(reservation);
+        collected.unregister(reference);
+    };
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAOnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;AAClD,MAAM,WAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;AACvD,SAAS,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAe;IACtD,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACxD,CAAC;AACD,uEAAuE;AACvE,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAc,OAAO,CAAC,CAAC;AAEjE,MAAM,UAAU,SAAS,CACvB,IAA4B,EAC5B,EAAU,EACV,QAAgB;IAEhB,MAAM,OAAO,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;IACxD,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE;QAC1B,IAAI,CAAC,sBAAsB,EAAE,GAAG,IAAI,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3B,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACrD,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,WAAW,CAAC,CAAC;QACrB,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export * from "./messages/message.js";
 export * from "./messages/codec.js";
 export * from "./instructions/instruction.js";
 export * from "./events/definition.js";
-export * from "./events/catalog.js";
+export * from "./events/type.js";
 export * from "./plugins/context.js";
 export * from "./plugins/host.js";
 export * from "./plugins/registry.js";
@@ -30,5 +30,7 @@ export * from "./agent.js";
 export * from "./controller.js";
 export * from "./thread.js";
 export * from "./models/registry.js";
+export { ProfileResolver } from "./models/resolver.js";
+export { snapshotModelOptions } from "./models/options.js";
 export * from "./session.js";
-export * from "./session-events.js";
+export * from "./state/sessions.js";

package/dist/index.js

@@ -5,7 +5,7 @@ export * from "./messages/message.js";
 export * from "./messages/codec.js";
 export * from "./instructions/instruction.js";
 export * from "./events/definition.js";
-export * from "./events/catalog.js";
+export * from "./events/type.js";
 export * from "./plugins/context.js";
 export * from "./plugins/host.js";
 export * from "./plugins/registry.js";
@@ -30,6 +30,8 @@ export * from "./agent.js";
 export * from "./controller.js";
 export * from "./thread.js";
 export * from "./models/registry.js";
+export { ProfileResolver } from "./models/resolver.js";
+export { snapshotModelOptions } from "./models/options.js";
 export * from "./session.js";
-export * from "./session-events.js";
+export * from "./state/sessions.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,cAAc,cAAc,CAAC;AAE7B,cAAc,qBAAqB,CAAC"}

package/dist/instructions/instruction.d.ts

@@ -1,6 +1,8 @@
 export interface InstructionSection {
     readonly id: string;
     readonly content: string;
+    /** Lower values come first; omitted values compare as zero. IDs break ties. */
+    readonly order?: number;
 }
 export interface Instruction {
     readonly sections: readonly InstructionSection[];

package/dist/instructions/instruction.js

@@ -4,11 +4,18 @@ export function buildInstruction(sections) {
     const ids = new Set();
     for (const section of sections) {
         requireId(section.id, "section id");
-        if (typeof section.content !== "string" || ids.has(section.id))
-            fail("InvalidConfiguration", "Instruction sections need unique ids and string content");
+        if (typeof section.content !== "string" ||
+            ids.has(section.id) ||
+            (section.order !== undefined && !Number.isFinite(section.order)))
+            fail("InvalidConfiguration", "Instruction sections need unique ids, string content and finite numeric order");
         ids.add(section.id);
     }
-    return immutable({ sections });
+    return immutable({
+        sections: sections
+            .map(({ order, ...section }) => order === undefined ? section : { ...section, order })
+            .sort((a, b) => (a.order ?? 0) - (b.order ?? 0) ||
+            (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)),
+    });
 }
 export function normalizeInstruction(value = "") {
     return buildInstruction(typeof value === "string"

package/dist/instructions/instruction.js.map

@@ -1 +1 @@
-{"version":3,"file":"instruction.js","sourceRoot":"","sources":["../../src/instructions/instruction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQvC,MAAM,UAAU,gBAAgB,CAC9B,QAAuC;IAEvC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QACpC,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,IAAI,CACF,sBAAsB,EACtB,yDAAyD,CAC1D,CAAC;QACJ,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;AACjC,CAAC;AACD,MAAM,UAAU,oBAAoB,CAClC,KAAK,GAAyB,EAAE;IAEhC,OAAO,gBAAgB,CACrB,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrC,CAAC,CAAC,KAAK,CAAC,QAAQ,CACnB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"instruction.js","sourceRoot":"","sources":["../../src/instructions/instruction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAUvC,MAAM,UAAU,gBAAgB,CAC9B,QAAuC;IAEvC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QACpC,IACE,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;YACnC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACnB,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAEhE,IAAI,CACF,sBAAsB,EACtB,+EAA+E,CAChF,CAAC;QACJ,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;QACf,QAAQ,EAAE,QAAQ;aACf,GAAG,CAAqB,CAAC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CACjD,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CACtD;aACA,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3C;KACJ,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,oBAAoB,CAClC,KAAK,GAAyB,EAAE;IAEhC,OAAO,gBAAgB,CACrB,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrC,CAAC,CAAC,KAAK,CAAC,QAAQ,CACnB,CAAC;AACJ,CAAC"}

package/dist/loop.d.ts

@@ -1,13 +1,14 @@
-import type { ExecutionFrame } from "./agent.js";
+import type { ExecutionFrame } from "./engine/frame.js";
 import { type Clock, type IdGenerator } from "./json.js";
 import type { AnyEvent, PayloadOf, ResultOf } from "./events/definition.js";
-import { type MessageData } from "./messages/message.js";
+import type { MessageData } from "./messages/message.js";
 import type { CheckpointCause, RecordEntry } from "./state/schema.js";
 import type { TrackedServices } from "./engine/tracked-effects.js";
-type LoopContext = {
+export type LoopContext = {
+    toolConcurrency: number;
     ids: IdGenerator;
     clock: Clock;
-    hook<D extends AnyEvent>(frame: ExecutionFrame, definition: D, payload: PayloadOf<D>): Promise<ResultOf<D>>;
+    hook<D extends AnyEvent>(frame: ExecutionFrame, definition: D, payload: PayloadOf<D>, toolExecutionId?: string): Promise<ResultOf<D>>;
     put(frame: ExecutionFrame, kind: RecordEntry["kind"], data: RecordEntry["data"]): void;
     rows<T>(frame: ExecutionFrame, kind: RecordEntry["kind"]): T[];
     commit(frame: ExecutionFrame, cause: CheckpointCause): Promise<void>;
@@ -17,4 +18,3 @@ type LoopContext = {
     finish(frame: ExecutionFrame, status: "completed" | "stopped", reason: string | null): Promise<void>;
 };
 export declare function loop(frame: ExecutionFrame, context: LoopContext): Promise<void>;
-export {};