@elie-laloum/outpost 4.2.0 → 6.0.1

package/dist/domain/context.types.d.ts

@@ -0,0 +1,26 @@
+import type { AgentModel, ModelMessage } from "./model.types.ts";
+export interface HarnessContextInput {
+    readonly messages: readonly ModelMessage[];
+    readonly step: number;
+    readonly model: AgentModel;
+    readonly signal: AbortSignal;
+    summarize(messages: readonly ModelMessage[]): Promise<string>;
+}
+export type HarnessContextResult = readonly ModelMessage[] | undefined;
+export interface HarnessContextStrategyOptions {
+    readonly name: string;
+    compact(input: HarnessContextInput): HarnessContextResult | Promise<HarnessContextResult>;
+}
+export interface HarnessContextStrategy {
+    readonly kind: "context";
+    readonly name: string;
+    compact(input: HarnessContextInput): Promise<HarnessContextResult>;
+}
+export interface TruncateToolResultsOptions {
+    readonly keepRecent?: number;
+    readonly maxCharacters?: number;
+}
+export interface SummarizeHistoryOptions {
+    readonly triggerCharacters?: number;
+    readonly keepRecentMessages?: number;
+}

package/dist/domain/context.types.js

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

package/dist/domain/context.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.types.js","sourceRoot":"","sources":["../../src/domain/context.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentModel, ModelMessage } from \"./model.types.ts\";\n\nexport interface HarnessContextInput {\n  readonly messages: readonly ModelMessage[];\n  readonly step: number;\n  readonly model: AgentModel;\n  readonly signal: AbortSignal;\n  summarize(messages: readonly ModelMessage[]): Promise<string>;\n}\n\nexport type HarnessContextResult = readonly ModelMessage[] | undefined;\n\nexport interface HarnessContextStrategyOptions {\n  readonly name: string;\n  compact(\n    input: HarnessContextInput,\n  ): HarnessContextResult | Promise<HarnessContextResult>;\n}\n\nexport interface HarnessContextStrategy {\n  readonly kind: \"context\";\n  readonly name: string;\n  compact(input: HarnessContextInput): Promise<HarnessContextResult>;\n}\n\nexport interface TruncateToolResultsOptions {\n  readonly keepRecent?: number;\n  readonly maxCharacters?: number;\n}\n\nexport interface SummarizeHistoryOptions {\n  readonly triggerCharacters?: number;\n  readonly keepRecentMessages?: number;\n}\n"]}

package/dist/domain/dispatch-telemetry.types.d.ts

@@ -0,0 +1,12 @@
+import type { Usage } from "./agent.types.ts";
+export interface DispatchTelemetryOutcome {
+    readonly status: "done" | "failed" | "cancelled";
+    readonly usage: Usage;
+    readonly completed?: boolean;
+}
+export interface DispatchTelemetrySession {
+    finish(outcome: DispatchTelemetryOutcome): void;
+}
+export interface DispatchTelemetry {
+    startDispatch(): DispatchTelemetrySession;
+}

package/dist/domain/dispatch-telemetry.types.js

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

package/dist/domain/dispatch-telemetry.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-telemetry.types.js","sourceRoot":"","sources":["../../src/domain/dispatch-telemetry.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Usage } from \"./agent.types.ts\";\n\nexport interface DispatchTelemetryOutcome {\n  readonly status: \"done\" | \"failed\" | \"cancelled\";\n  readonly usage: Usage;\n  readonly completed?: boolean;\n}\n\nexport interface DispatchTelemetrySession {\n  finish(outcome: DispatchTelemetryOutcome): void;\n}\n\nexport interface DispatchTelemetry {\n  startDispatch(): DispatchTelemetrySession;\n}\n"]}

package/dist/domain/errors.types.d.ts

@@ -1 +1 @@
-export type FaultCode = "configuration" | "process" | "timeout" | "aborted" | "workspace" | "conflict" | "prompt" | "response" | "session" | "provider";
+export type FaultCode = "configuration" | "process" | "timeout" | "aborted" | "workspace" | "conflict" | "prompt" | "response" | "session" | "provider" | "limit";

package/dist/domain/errors.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.types.js","sourceRoot":"","sources":["../../src/domain/errors.types.ts"],"names":[],"mappings":"","sourcesContent":["export type FaultCode =\n  | \"configuration\"\n  | \"process\"\n  | \"timeout\"\n  | \"aborted\"\n  | \"workspace\"\n  | \"conflict\"\n  | \"prompt\"\n  | \"response\"\n  | \"session\"\n  | \"provider\";\n"]}
+{"version":3,"file":"errors.types.js","sourceRoot":"","sources":["../../src/domain/errors.types.ts"],"names":[],"mappings":"","sourcesContent":["export type FaultCode =\n  | \"configuration\"\n  | \"process\"\n  | \"timeout\"\n  | \"aborted\"\n  | \"workspace\"\n  | \"conflict\"\n  | \"prompt\"\n  | \"response\"\n  | \"session\"\n  | \"provider\"\n  | \"limit\";\n"]}

package/dist/domain/glob.d.ts

@@ -0,0 +1,2 @@
+import type { GlobMode } from "./glob.types.ts";
+export declare function glob(pattern: string, mode: GlobMode): RegExp;

package/dist/domain/glob.js

@@ -0,0 +1,25 @@
+const stars = {
+    path: "[^/]*",
+    text: "[^]*",
+};
+const tokens = {
+    "*": (mode) => stars[mode],
+    "?": () => "[^/]",
+};
+export function glob(pattern, mode) {
+    let source = "";
+    for (let index = 0; index < pattern.length; index++) {
+        const character = pattern[index];
+        if (character === "*" && pattern[index + 1] === "*") {
+            const directory = pattern[index + 2] === "/";
+            source += directory ? "(?:[^]*/)?" : "[^]*";
+            index += directory ? 2 : 1;
+            continue;
+        }
+        source +=
+            tokens[character]?.(mode) ??
+                character.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    }
+    return new RegExp(`^${source}$`);
+}
+//# sourceMappingURL=glob.js.map

package/dist/domain/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/domain/glob.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAuC;IAChD,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,MAAM,GAAyD;IACnE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;IAC1B,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM;CAClB,CAAC;AAEF,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,IAAc;IAClD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAE,CAAC;QAClC,IAAI,SAAS,KAAK,GAAG,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACpD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;YAC7C,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;YAC5C,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,MAAM;YACJ,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC;gBACzB,SAAS,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import type { GlobMode } from \"./glob.types.ts\";\n\nconst stars: Readonly<Record<GlobMode, string>> = {\n  path: \"[^/]*\",\n  text: \"[^]*\",\n};\n\nconst tokens: Readonly<Record<string, (mode: GlobMode) => string>> = {\n  \"*\": (mode) => stars[mode],\n  \"?\": () => \"[^/]\",\n};\n\nexport function glob(pattern: string, mode: GlobMode): RegExp {\n  let source = \"\";\n  for (let index = 0; index < pattern.length; index++) {\n    const character = pattern[index]!;\n    if (character === \"*\" && pattern[index + 1] === \"*\") {\n      const directory = pattern[index + 2] === \"/\";\n      source += directory ? \"(?:[^]*/)?\" : \"[^]*\";\n      index += directory ? 2 : 1;\n      continue;\n    }\n    source +=\n      tokens[character]?.(mode) ??\n      character.replace(/[.+^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  }\n  return new RegExp(`^${source}$`);\n}\n"]}

package/dist/domain/glob.types.d.ts

@@ -0,0 +1 @@
+export type GlobMode = "path" | "text";

package/dist/domain/glob.types.js

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

package/dist/domain/glob.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.types.js","sourceRoot":"","sources":["../../src/domain/glob.types.ts"],"names":[],"mappings":"","sourcesContent":["export type GlobMode = \"path\" | \"text\";\n"]}

package/dist/domain/harness.constants.d.ts

@@ -0,0 +1,11 @@
+export declare const HARNESS_DEFAULTS: {
+    readonly maxSteps: 100;
+    readonly concurrency: 4;
+    readonly toolDeadlineMs: 300000;
+    readonly onError: "return-to-model";
+    readonly cache: true;
+};
+export declare const HARNESS_FIELDS: ReadonlySet<string>;
+export declare const TOOL_RESULT_CHARACTERS = 100000;
+export declare const TOOL_PREVIEW_CHARACTERS = 2000;
+export declare const USAGE_FIELDS: string[];

package/dist/domain/harness.constants.js

@@ -0,0 +1,24 @@
+export const HARNESS_DEFAULTS = {
+    maxSteps: 100,
+    concurrency: 4,
+    toolDeadlineMs: 300_000,
+    onError: "return-to-model",
+    cache: true,
+};
+export const HARNESS_FIELDS = new Set([
+    "modelProvider",
+    "instructions",
+    "tools",
+    "limits",
+    "toolExecution",
+    "hooks",
+    "permissions",
+    "context",
+    "conversations",
+    "skills",
+    "cache",
+]);
+export const TOOL_RESULT_CHARACTERS = 100_000;
+export const TOOL_PREVIEW_CHARACTERS = 2_000;
+export const USAGE_FIELDS = ["input", "cached", "cacheCreated", "output"];
+//# sourceMappingURL=harness.constants.js.map

package/dist/domain/harness.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.constants.js","sourceRoot":"","sources":["../../src/domain/harness.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,GAAG;IACb,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,OAAO;IACvB,OAAO,EAAE,iBAAiB;IAC1B,KAAK,EAAE,IAAI;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,eAAe;IACf,cAAc;IACd,OAAO;IACP,QAAQ;IACR,eAAe;IACf,OAAO;IACP,aAAa;IACb,SAAS;IACT,eAAe;IACf,QAAQ;IACR,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC","sourcesContent":["export const HARNESS_DEFAULTS = {\n  maxSteps: 100,\n  concurrency: 4,\n  toolDeadlineMs: 300_000,\n  onError: \"return-to-model\",\n  cache: true,\n} as const;\n\nexport const HARNESS_FIELDS: ReadonlySet<string> = new Set([\n  \"modelProvider\",\n  \"instructions\",\n  \"tools\",\n  \"limits\",\n  \"toolExecution\",\n  \"hooks\",\n  \"permissions\",\n  \"context\",\n  \"conversations\",\n  \"skills\",\n  \"cache\",\n]);\n\nexport const TOOL_RESULT_CHARACTERS = 100_000;\n\nexport const TOOL_PREVIEW_CHARACTERS = 2_000;\n\nexport const USAGE_FIELDS = [\"input\", \"cached\", \"cacheCreated\", \"output\"];\n"]}

package/dist/domain/harness.d.ts

@@ -0,0 +1,2 @@
+import type { Harness, HarnessOptions } from "./harness.types.ts";
+export declare function harness(options: HarnessOptions): Harness;

package/dist/domain/harness.js

@@ -0,0 +1,89 @@
+import { invariant, positive } from "./errors.js";
+import { HARNESS_DEFAULTS, HARNESS_FIELDS, USAGE_FIELDS, } from "./harness.constants.js";
+import { harnessHooks } from "./hook.js";
+import { defineHarnessInstructions, harnessInstructions, } from "./instructions.js";
+import { harnessSkills, skillCatalog, skillLoader } from "./skill.js";
+import { harnessTools } from "./tool.js";
+export function harness(options) {
+    invariant(options !== null && typeof options === "object", "Harness options must be an object");
+    invariant(!("run" in options), "harness() no longer accepts run; declare tools, instructions and limits");
+    const unsupported = Object.keys(options).filter((key) => !HARNESS_FIELDS.has(key));
+    invariant(unsupported.length === 0, `Unsupported harness option: ${unsupported.join(", ")}`);
+    invariant(typeof options.modelProvider?.request === "function", "Custom harness requires a model provider");
+    invariant(options.modelProvider.validate === undefined ||
+        typeof options.modelProvider.validate === "function", "Model provider validate must be a function");
+    invariant(options.cache === undefined || typeof options.cache === "boolean", "Harness cache must be boolean");
+    invariant(options.permissions === undefined ||
+        options.permissions?.kind === "permissions", "Declare permissions with defineHarnessPermissions");
+    invariant(options.context === undefined || options.context?.kind === "context", "Declare context strategies with defineHarnessContextStrategy");
+    invariant(options.conversations === undefined ||
+        options.conversations === false ||
+        conversationStore(options.conversations), "Harness conversations must be a conversation store or false");
+    const skills = harnessSkills(options.skills);
+    return Object.freeze({
+        kind: "custom",
+        modelProvider: options.modelProvider,
+        instructions: Object.freeze([
+            ...harnessInstructions(options.instructions),
+            ...(skills.length
+                ? [defineHarnessInstructions(skillCatalog(skills))]
+                : []),
+        ]),
+        tools: harnessTools([
+            ...(options.tools ?? []),
+            ...skills.flatMap((skill) => skill.tools),
+            ...(skills.length ? [skillLoader(skills)] : []),
+        ]),
+        skills,
+        limits: limits(options.limits ?? {}),
+        toolExecution: toolExecution(options.toolExecution ?? {}),
+        hooks: harnessHooks(options.hooks),
+        ...(options.permissions ? { permissions: options.permissions } : {}),
+        ...(options.context ? { context: options.context } : {}),
+        ...(options.conversations === undefined
+            ? {}
+            : { conversations: options.conversations }),
+        cache: options.cache ?? HARNESS_DEFAULTS.cache,
+    });
+}
+function limits(value) {
+    invariant(value !== null && typeof value === "object", "Harness limits must be an object");
+    const maxSteps = positive(value.maxSteps ?? HARNESS_DEFAULTS.maxSteps, "Harness maxSteps");
+    if (value.maxToolCalls !== undefined)
+        positive(value.maxToolCalls, "Harness maxToolCalls");
+    if (value.usage !== undefined) {
+        invariant(value.usage !== null &&
+            typeof value.usage === "object" &&
+            Object.keys(value.usage).every((key) => USAGE_FIELDS.includes(key)), "Harness usage limits accept input, cached, cacheCreated and output");
+        for (const limit of Object.values(value.usage))
+            invariant(Number.isSafeInteger(limit) && limit >= 0, "Harness usage limits must be nonnegative integers");
+    }
+    return Object.freeze({
+        maxSteps,
+        ...(value.maxToolCalls === undefined
+            ? {}
+            : { maxToolCalls: value.maxToolCalls }),
+        ...(value.usage === undefined
+            ? {}
+            : { usage: Object.freeze({ ...value.usage }) }),
+    });
+}
+function toolExecution(value) {
+    invariant(value !== null && typeof value === "object", "Harness toolExecution must be an object");
+    invariant(value.onError === undefined ||
+        value.onError === "return-to-model" ||
+        value.onError === "fail", 'Tool onError must be "return-to-model" or "fail"');
+    return Object.freeze({
+        concurrency: positive(value.concurrency ?? HARNESS_DEFAULTS.concurrency, "Tool concurrency"),
+        deadlineMs: positive(value.deadlineMs ?? HARNESS_DEFAULTS.toolDeadlineMs, "Tool deadlineMs"),
+        onError: value.onError ?? HARNESS_DEFAULTS.onError,
+    });
+}
+function conversationStore(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        typeof value.locate === "function" &&
+        typeof value.capture === "function" &&
+        typeof value.restore === "function");
+}
+//# sourceMappingURL=harness.js.map

package/dist/domain/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../src/domain/harness.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ConversationStore } from \"./conversation.types.ts\";\nimport { invariant, positive } from \"./errors.ts\";\nimport {\n  HARNESS_DEFAULTS,\n  HARNESS_FIELDS,\n  USAGE_FIELDS,\n} from \"./harness.constants.ts\";\nimport type {\n  Harness,\n  HarnessOptions,\n  HarnessLimits,\n  HarnessToolExecution,\n  ResolvedHarnessLimits,\n} from \"./harness.types.ts\";\nimport { harnessHooks } from \"./hook.ts\";\nimport {\n  defineHarnessInstructions,\n  harnessInstructions,\n} from \"./instructions.ts\";\nimport { harnessSkills, skillCatalog, skillLoader } from \"./skill.ts\";\nimport { harnessTools } from \"./tool.ts\";\n\nexport function harness(options: HarnessOptions): Harness {\n  invariant(\n    options !== null && typeof options === \"object\",\n    \"Harness options must be an object\",\n  );\n  invariant(\n    !(\"run\" in options),\n    \"harness() no longer accepts run; declare tools, instructions and limits\",\n  );\n  const unsupported = Object.keys(options).filter(\n    (key) => !HARNESS_FIELDS.has(key),\n  );\n  invariant(\n    unsupported.length === 0,\n    `Unsupported harness option: ${unsupported.join(\", \")}`,\n  );\n  invariant(\n    typeof options.modelProvider?.request === \"function\",\n    \"Custom harness requires a model provider\",\n  );\n  invariant(\n    options.modelProvider.validate === undefined ||\n      typeof options.modelProvider.validate === \"function\",\n    \"Model provider validate must be a function\",\n  );\n  invariant(\n    options.cache === undefined || typeof options.cache === \"boolean\",\n    \"Harness cache must be boolean\",\n  );\n  invariant(\n    options.permissions === undefined ||\n      options.permissions?.kind === \"permissions\",\n    \"Declare permissions with defineHarnessPermissions\",\n  );\n  invariant(\n    options.context === undefined || options.context?.kind === \"context\",\n    \"Declare context strategies with defineHarnessContextStrategy\",\n  );\n  invariant(\n    options.conversations === undefined ||\n      options.conversations === false ||\n      conversationStore(options.conversations),\n    \"Harness conversations must be a conversation store or false\",\n  );\n  const skills = harnessSkills(options.skills);\n  return Object.freeze({\n    kind: \"custom\",\n    modelProvider: options.modelProvider,\n    instructions: Object.freeze([\n      ...harnessInstructions(options.instructions),\n      ...(skills.length\n        ? [defineHarnessInstructions(skillCatalog(skills))]\n        : []),\n    ]),\n    tools: harnessTools([\n      ...(options.tools ?? []),\n      ...skills.flatMap((skill) => skill.tools),\n      ...(skills.length ? [skillLoader(skills)] : []),\n    ]),\n    skills,\n    limits: limits(options.limits ?? {}),\n    toolExecution: toolExecution(options.toolExecution ?? {}),\n    hooks: harnessHooks(options.hooks),\n    ...(options.permissions ? { permissions: options.permissions } : {}),\n    ...(options.context ? { context: options.context } : {}),\n    ...(options.conversations === undefined\n      ? {}\n      : { conversations: options.conversations }),\n    cache: options.cache ?? HARNESS_DEFAULTS.cache,\n  });\n}\n\nfunction limits(value: HarnessLimits): ResolvedHarnessLimits {\n  invariant(\n    value !== null && typeof value === \"object\",\n    \"Harness limits must be an object\",\n  );\n  const maxSteps = positive(\n    value.maxSteps ?? HARNESS_DEFAULTS.maxSteps,\n    \"Harness maxSteps\",\n  );\n  if (value.maxToolCalls !== undefined)\n    positive(value.maxToolCalls, \"Harness maxToolCalls\");\n  if (value.usage !== undefined) {\n    invariant(\n      value.usage !== null &&\n        typeof value.usage === \"object\" &&\n        Object.keys(value.usage).every((key) => USAGE_FIELDS.includes(key)),\n      \"Harness usage limits accept input, cached, cacheCreated and output\",\n    );\n    for (const limit of Object.values(value.usage))\n      invariant(\n        Number.isSafeInteger(limit) && limit >= 0,\n        \"Harness usage limits must be nonnegative integers\",\n      );\n  }\n  return Object.freeze({\n    maxSteps,\n    ...(value.maxToolCalls === undefined\n      ? {}\n      : { maxToolCalls: value.maxToolCalls }),\n    ...(value.usage === undefined\n      ? {}\n      : { usage: Object.freeze({ ...value.usage }) }),\n  });\n}\n\nfunction toolExecution(\n  value: HarnessToolExecution,\n): Required<HarnessToolExecution> {\n  invariant(\n    value !== null && typeof value === \"object\",\n    \"Harness toolExecution must be an object\",\n  );\n  invariant(\n    value.onError === undefined ||\n      value.onError === \"return-to-model\" ||\n      value.onError === \"fail\",\n    'Tool onError must be \"return-to-model\" or \"fail\"',\n  );\n  return Object.freeze({\n    concurrency: positive(\n      value.concurrency ?? HARNESS_DEFAULTS.concurrency,\n      \"Tool concurrency\",\n    ),\n    deadlineMs: positive(\n      value.deadlineMs ?? HARNESS_DEFAULTS.toolDeadlineMs,\n      \"Tool deadlineMs\",\n    ),\n    onError: value.onError ?? HARNESS_DEFAULTS.onError,\n  });\n}\n\nfunction conversationStore(value: ConversationStore): boolean {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    typeof value.locate === \"function\" &&\n    typeof value.capture === \"function\" &&\n    typeof value.restore === \"function\"\n  );\n}\n"]}

package/dist/domain/harness.types.d.ts

@@ -0,0 +1,60 @@
+import type { Usage } from "./agent.types.ts";
+import type { HarnessContextStrategy } from "./context.types.ts";
+import type { ConversationStore } from "./conversation.types.ts";
+import type { HarnessHook } from "./hook.types.ts";
+import type { AgentModel, ModelProvider } from "./model.types.ts";
+import type { HarnessPermissions } from "./permissions.types.ts";
+import type { HarnessSkill } from "./skill.types.ts";
+import type { SandboxLease } from "./sandbox.types.ts";
+import type { HarnessTool, HarnessToolset } from "./tool.types.ts";
+export interface HarnessInstructionContext {
+    readonly sandbox: SandboxLease;
+    readonly signal: AbortSignal;
+    readonly model: AgentModel;
+}
+export type HarnessInstructionSource = string | ((context: HarnessInstructionContext) => string | Promise<string>);
+export interface HarnessInstructions {
+    readonly kind: "instructions";
+    resolve(context: HarnessInstructionContext): Promise<string>;
+}
+export type HarnessInstructionsOption = string | HarnessInstructions | readonly (string | HarnessInstructions)[];
+export interface HarnessLimits {
+    readonly maxSteps?: number;
+    readonly maxToolCalls?: number;
+    readonly usage?: Partial<Usage>;
+}
+export interface ResolvedHarnessLimits extends HarnessLimits {
+    readonly maxSteps: number;
+}
+export interface HarnessToolExecution {
+    readonly concurrency?: number;
+    readonly deadlineMs?: number;
+    readonly onError?: "return-to-model" | "fail";
+}
+export interface HarnessOptions {
+    readonly modelProvider: ModelProvider;
+    readonly instructions?: HarnessInstructionsOption;
+    readonly tools?: readonly (HarnessTool | HarnessToolset)[];
+    readonly limits?: HarnessLimits;
+    readonly toolExecution?: HarnessToolExecution;
+    readonly hooks?: readonly HarnessHook[];
+    readonly permissions?: HarnessPermissions;
+    readonly context?: HarnessContextStrategy;
+    readonly conversations?: ConversationStore | false;
+    readonly skills?: readonly HarnessSkill[];
+    readonly cache?: boolean;
+}
+export interface Harness {
+    readonly kind: "custom";
+    readonly modelProvider: ModelProvider;
+    readonly instructions: readonly HarnessInstructions[];
+    readonly tools: readonly HarnessTool[];
+    readonly limits: ResolvedHarnessLimits;
+    readonly toolExecution: Required<HarnessToolExecution>;
+    readonly hooks: readonly HarnessHook[];
+    readonly permissions?: HarnessPermissions;
+    readonly context?: HarnessContextStrategy;
+    readonly conversations?: ConversationStore | false;
+    readonly skills: readonly HarnessSkill[];
+    readonly cache: boolean;
+}

package/dist/domain/harness.types.js

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

package/dist/domain/harness.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.types.js","sourceRoot":"","sources":["../../src/domain/harness.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Usage } from \"./agent.types.ts\";\nimport type { HarnessContextStrategy } from \"./context.types.ts\";\nimport type { ConversationStore } from \"./conversation.types.ts\";\nimport type { HarnessHook } from \"./hook.types.ts\";\nimport type { AgentModel, ModelProvider } from \"./model.types.ts\";\nimport type { HarnessPermissions } from \"./permissions.types.ts\";\nimport type { HarnessSkill } from \"./skill.types.ts\";\nimport type { SandboxLease } from \"./sandbox.types.ts\";\nimport type { HarnessTool, HarnessToolset } from \"./tool.types.ts\";\n\nexport interface HarnessInstructionContext {\n  readonly sandbox: SandboxLease;\n  readonly signal: AbortSignal;\n  readonly model: AgentModel;\n}\n\nexport type HarnessInstructionSource =\n  string | ((context: HarnessInstructionContext) => string | Promise<string>);\n\nexport interface HarnessInstructions {\n  readonly kind: \"instructions\";\n  resolve(context: HarnessInstructionContext): Promise<string>;\n}\n\nexport type HarnessInstructionsOption =\n  string | HarnessInstructions | readonly (string | HarnessInstructions)[];\n\nexport interface HarnessLimits {\n  readonly maxSteps?: number;\n  readonly maxToolCalls?: number;\n  readonly usage?: Partial<Usage>;\n}\n\nexport interface ResolvedHarnessLimits extends HarnessLimits {\n  readonly maxSteps: number;\n}\n\nexport interface HarnessToolExecution {\n  readonly concurrency?: number;\n  readonly deadlineMs?: number;\n  readonly onError?: \"return-to-model\" | \"fail\";\n}\n\nexport interface HarnessOptions {\n  readonly modelProvider: ModelProvider;\n  readonly instructions?: HarnessInstructionsOption;\n  readonly tools?: readonly (HarnessTool | HarnessToolset)[];\n  readonly limits?: HarnessLimits;\n  readonly toolExecution?: HarnessToolExecution;\n  readonly hooks?: readonly HarnessHook[];\n  readonly permissions?: HarnessPermissions;\n  readonly context?: HarnessContextStrategy;\n  readonly conversations?: ConversationStore | false;\n  readonly skills?: readonly HarnessSkill[];\n  readonly cache?: boolean;\n}\n\nexport interface Harness {\n  readonly kind: \"custom\";\n  readonly modelProvider: ModelProvider;\n  readonly instructions: readonly HarnessInstructions[];\n  readonly tools: readonly HarnessTool[];\n  readonly limits: ResolvedHarnessLimits;\n  readonly toolExecution: Required<HarnessToolExecution>;\n  readonly hooks: readonly HarnessHook[];\n  readonly permissions?: HarnessPermissions;\n  readonly context?: HarnessContextStrategy;\n  readonly conversations?: ConversationStore | false;\n  readonly skills: readonly HarnessSkill[];\n  readonly cache: boolean;\n}\n"]}

package/dist/domain/hook.constants.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessHookPhase } from "./hook.types.ts";
+export declare const HOOK_PHASES: ReadonlySet<HarnessHookPhase>;
+export declare const HOOK_FIELDS: ReadonlySet<string>;

package/dist/domain/hook.constants.js

@@ -0,0 +1,10 @@
+export const HOOK_PHASES = new Set([
+    "session-start",
+    "before-model",
+    "after-model",
+    "before-tool",
+    "after-tool",
+    "stop",
+]);
+export const HOOK_FIELDS = new Set(["on", "name", "run"]);
+//# sourceMappingURL=hook.constants.js.map

package/dist/domain/hook.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.constants.js","sourceRoot":"","sources":["../../src/domain/hook.constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAkC,IAAI,GAAG,CAAC;IAChE,eAAe;IACf,cAAc;IACd,aAAa;IACb,aAAa;IACb,YAAY;IACZ,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC","sourcesContent":["import type { HarnessHookPhase } from \"./hook.types.ts\";\n\nexport const HOOK_PHASES: ReadonlySet<HarnessHookPhase> = new Set([\n  \"session-start\",\n  \"before-model\",\n  \"after-model\",\n  \"before-tool\",\n  \"after-tool\",\n  \"stop\",\n]);\n\nexport const HOOK_FIELDS: ReadonlySet<string> = new Set([\"on\", \"name\", \"run\"]);\n"]}

package/dist/domain/hook.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessHook, HarnessHookOptions, HarnessHookPhase } from "./hook.types.ts";
+export declare function defineHarnessHook<Phase extends HarnessHookPhase>(options: HarnessHookOptions<Phase>): HarnessHook<Phase>;
+export declare function harnessHooks(hooks: readonly HarnessHook[] | undefined): readonly HarnessHook[];

package/dist/domain/hook.js

@@ -0,0 +1,25 @@
+import { invariant } from "./errors.js";
+import { HOOK_FIELDS, HOOK_PHASES } from "./hook.constants.js";
+export function defineHarnessHook(options) {
+    invariant(options !== null && typeof options === "object", "Hook options must be an object");
+    invariant(Object.keys(options).every((key) => HOOK_FIELDS.has(key)), "Unsupported hook option");
+    invariant(HOOK_PHASES.has(options.on), `Hook phase must be one of ${[...HOOK_PHASES].join(", ")}`);
+    invariant(typeof options.run === "function", "Hook run must be a function");
+    invariant(options.name === undefined ||
+        (typeof options.name === "string" && options.name.trim()), "Hook name must be nonempty text");
+    return Object.freeze({
+        kind: "hook",
+        on: options.on,
+        name: options.name ?? options.on,
+        run: (input) => options.run(input),
+    });
+}
+export function harnessHooks(hooks) {
+    if (hooks === undefined)
+        return [];
+    invariant(Array.isArray(hooks), "Hooks must be an array");
+    for (const hook of hooks)
+        invariant(hook?.kind === "hook", "Declare hooks with defineHarnessHook");
+    return Object.freeze([...hooks]);
+}
+//# sourceMappingURL=hook.js.map

package/dist/domain/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/domain/hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAQ/D,MAAM,UAAU,iBAAiB,CAC/B,OAAkC;IAElC,SAAS,CACP,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAC/C,gCAAgC,CACjC,CAAC;IACF,SAAS,CACP,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EACzD,yBAAyB,CAC1B,CAAC;IACF,SAAS,CACP,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAC3B,6BAA6B,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3D,CAAC;IACF,SAAS,CAAC,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU,EAAE,6BAA6B,CAAC,CAAC;IAC5E,SAAS,CACP,OAAO,CAAC,IAAI,KAAK,SAAS;QACxB,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAC3D,iCAAiC,CAClC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE;QAChC,GAAG,EAAE,CAAC,KAA8B,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,KAAyC;IAEzC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,KAAK;QACtB,SAAS,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,EAAE,sCAAsC,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import { invariant } from \"./errors.ts\";\nimport { HOOK_FIELDS, HOOK_PHASES } from \"./hook.constants.ts\";\nimport type {\n  HarnessHook,\n  HarnessHookInput,\n  HarnessHookOptions,\n  HarnessHookPhase,\n} from \"./hook.types.ts\";\n\nexport function defineHarnessHook<Phase extends HarnessHookPhase>(\n  options: HarnessHookOptions<Phase>,\n): HarnessHook<Phase> {\n  invariant(\n    options !== null && typeof options === \"object\",\n    \"Hook options must be an object\",\n  );\n  invariant(\n    Object.keys(options).every((key) => HOOK_FIELDS.has(key)),\n    \"Unsupported hook option\",\n  );\n  invariant(\n    HOOK_PHASES.has(options.on),\n    `Hook phase must be one of ${[...HOOK_PHASES].join(\", \")}`,\n  );\n  invariant(typeof options.run === \"function\", \"Hook run must be a function\");\n  invariant(\n    options.name === undefined ||\n      (typeof options.name === \"string\" && options.name.trim()),\n    \"Hook name must be nonempty text\",\n  );\n  return Object.freeze({\n    kind: \"hook\",\n    on: options.on,\n    name: options.name ?? options.on,\n    run: (input: HarnessHookInput<Phase>) => options.run(input),\n  });\n}\n\nexport function harnessHooks(\n  hooks: readonly HarnessHook[] | undefined,\n): readonly HarnessHook[] {\n  if (hooks === undefined) return [];\n  invariant(Array.isArray(hooks), \"Hooks must be an array\");\n  for (const hook of hooks)\n    invariant(hook?.kind === \"hook\", \"Declare hooks with defineHarnessHook\");\n  return Object.freeze([...hooks]);\n}\n"]}

package/dist/domain/hook.types.d.ts

@@ -0,0 +1,66 @@
+import type { AgentModel, ModelMessage, ModelResult, ModelToolCallBlock } from "./model.types.ts";
+import type { SandboxLease } from "./sandbox.types.ts";
+import type { ToolOutput } from "./tool.types.ts";
+export type HarnessHookPhase = "session-start" | "before-model" | "after-model" | "before-tool" | "after-tool" | "stop";
+export interface HarnessHookContext {
+    readonly sandbox: SandboxLease;
+    readonly signal: AbortSignal;
+    readonly model: AgentModel;
+    readonly step: number;
+}
+export interface HarnessToolResultView {
+    readonly content: string;
+    readonly isError: boolean;
+}
+export interface HarnessHookEvents {
+    readonly "session-start": {
+        readonly prompt: string;
+    };
+    readonly "before-model": {
+        readonly messages: readonly ModelMessage[];
+    };
+    readonly "after-model": {
+        readonly result: ModelResult;
+    };
+    readonly "before-tool": {
+        readonly call: ModelToolCallBlock;
+    };
+    readonly "after-tool": {
+        readonly call: ModelToolCallBlock;
+        readonly result: HarnessToolResultView;
+    };
+    readonly stop: {
+        readonly text: string;
+    };
+}
+export interface HarnessHookDecisions {
+    readonly "session-start": {
+        readonly instructions: string;
+    };
+    readonly "before-model": never;
+    readonly "after-model": never;
+    readonly "before-tool": {
+        readonly deny: string;
+    } | {
+        readonly input: unknown;
+    };
+    readonly "after-tool": {
+        readonly result: ToolOutput;
+    };
+    readonly stop: {
+        readonly continue: string;
+    };
+}
+export type HarnessHookInput<Phase extends HarnessHookPhase> = HarnessHookEvents[Phase] & HarnessHookContext;
+export type HarnessHookResult<Phase extends HarnessHookPhase> = HarnessHookDecisions[Phase] | undefined | void;
+export interface HarnessHookOptions<Phase extends HarnessHookPhase> {
+    readonly on: Phase;
+    readonly name?: string;
+    run(input: HarnessHookInput<Phase>): HarnessHookResult<Phase> | Promise<HarnessHookResult<Phase>>;
+}
+export interface HarnessHook<Phase extends HarnessHookPhase = HarnessHookPhase> {
+    readonly kind: "hook";
+    readonly on: Phase;
+    readonly name: string;
+    run(input: HarnessHookInput<Phase>): HarnessHookResult<Phase> | Promise<HarnessHookResult<Phase>>;
+}

package/dist/domain/hook.types.js

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

package/dist/domain/hook.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.types.js","sourceRoot":"","sources":["../../src/domain/hook.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  AgentModel,\n  ModelMessage,\n  ModelResult,\n  ModelToolCallBlock,\n} from \"./model.types.ts\";\nimport type { SandboxLease } from \"./sandbox.types.ts\";\nimport type { ToolOutput } from \"./tool.types.ts\";\n\nexport type HarnessHookPhase =\n  | \"session-start\"\n  | \"before-model\"\n  | \"after-model\"\n  | \"before-tool\"\n  | \"after-tool\"\n  | \"stop\";\n\nexport interface HarnessHookContext {\n  readonly sandbox: SandboxLease;\n  readonly signal: AbortSignal;\n  readonly model: AgentModel;\n  readonly step: number;\n}\n\nexport interface HarnessToolResultView {\n  readonly content: string;\n  readonly isError: boolean;\n}\n\nexport interface HarnessHookEvents {\n  readonly \"session-start\": { readonly prompt: string };\n  readonly \"before-model\": { readonly messages: readonly ModelMessage[] };\n  readonly \"after-model\": { readonly result: ModelResult };\n  readonly \"before-tool\": { readonly call: ModelToolCallBlock };\n  readonly \"after-tool\": {\n    readonly call: ModelToolCallBlock;\n    readonly result: HarnessToolResultView;\n  };\n  readonly stop: { readonly text: string };\n}\n\nexport interface HarnessHookDecisions {\n  readonly \"session-start\": { readonly instructions: string };\n  readonly \"before-model\": never;\n  readonly \"after-model\": never;\n  readonly \"before-tool\":\n    { readonly deny: string } | { readonly input: unknown };\n  readonly \"after-tool\": { readonly result: ToolOutput };\n  readonly stop: { readonly continue: string };\n}\n\nexport type HarnessHookInput<Phase extends HarnessHookPhase> =\n  HarnessHookEvents[Phase] & HarnessHookContext;\n\nexport type HarnessHookResult<Phase extends HarnessHookPhase> =\n  HarnessHookDecisions[Phase] | undefined | void;\n\nexport interface HarnessHookOptions<Phase extends HarnessHookPhase> {\n  readonly on: Phase;\n  readonly name?: string;\n  run(\n    input: HarnessHookInput<Phase>,\n  ): HarnessHookResult<Phase> | Promise<HarnessHookResult<Phase>>;\n}\n\nexport interface HarnessHook<\n  Phase extends HarnessHookPhase = HarnessHookPhase,\n> {\n  readonly kind: \"hook\";\n  readonly on: Phase;\n  readonly name: string;\n  run(\n    input: HarnessHookInput<Phase>,\n  ): HarnessHookResult<Phase> | Promise<HarnessHookResult<Phase>>;\n}\n"]}

package/dist/domain/instructions.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessInstructions, HarnessInstructionSource, HarnessInstructionsOption } from "./harness.types.ts";
+export declare function defineHarnessInstructions(source: HarnessInstructionSource): HarnessInstructions;
+export declare function harnessInstructions(option: HarnessInstructionsOption | undefined): readonly HarnessInstructions[];

package/dist/domain/instructions.js

@@ -0,0 +1,25 @@
+import { invariant } from "./errors.js";
+export function defineHarnessInstructions(source) {
+    invariant(typeof source === "function" ||
+        (typeof source === "string" && source.trim()), "Instructions must be nonempty text or a function");
+    return Object.freeze({
+        kind: "instructions",
+        async resolve(context) {
+            const text = typeof source === "string" ? source : await source(context);
+            invariant(typeof text === "string", "Instructions must resolve to text");
+            return text;
+        },
+    });
+}
+export function harnessInstructions(option) {
+    if (option === undefined)
+        return [];
+    const entries = Array.isArray(option) ? option : [option];
+    return Object.freeze(entries.map((entry) => {
+        if (typeof entry === "string")
+            return defineHarnessInstructions(entry);
+        invariant(entry?.kind === "instructions", "Declare instructions as text or with defineHarnessInstructions");
+        return entry;
+    }));
+}
+//# sourceMappingURL=instructions.js.map

package/dist/domain/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/domain/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQxC,MAAM,UAAU,yBAAyB,CACvC,MAAgC;IAEhC,SAAS,CACP,OAAO,MAAM,KAAK,UAAU;QAC1B,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,EAC/C,kDAAkD,CACnD,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,cAAc;QACpB,KAAK,CAAC,OAAO,CAAC,OAAkC;YAC9C,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACzE,SAAS,CAAC,OAAO,IAAI,KAAK,QAAQ,EAAE,mCAAmC,CAAC,CAAC;YACzE,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAA6C;IAE7C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAClB,OAAO,CAAC,GAAG,CAAC,CAAC,KAAmC,EAAE,EAAE;QAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,yBAAyB,CAAC,KAAK,CAAC,CAAC;QACvE,SAAS,CACP,KAAK,EAAE,IAAI,KAAK,cAAc,EAC9B,gEAAgE,CACjE,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CACH,CAAC;AACJ,CAAC","sourcesContent":["import { invariant } from \"./errors.ts\";\nimport type {\n  HarnessInstructionContext,\n  HarnessInstructions,\n  HarnessInstructionSource,\n  HarnessInstructionsOption,\n} from \"./harness.types.ts\";\n\nexport function defineHarnessInstructions(\n  source: HarnessInstructionSource,\n): HarnessInstructions {\n  invariant(\n    typeof source === \"function\" ||\n      (typeof source === \"string\" && source.trim()),\n    \"Instructions must be nonempty text or a function\",\n  );\n  return Object.freeze({\n    kind: \"instructions\",\n    async resolve(context: HarnessInstructionContext) {\n      const text = typeof source === \"string\" ? source : await source(context);\n      invariant(typeof text === \"string\", \"Instructions must resolve to text\");\n      return text;\n    },\n  });\n}\n\nexport function harnessInstructions(\n  option: HarnessInstructionsOption | undefined,\n): readonly HarnessInstructions[] {\n  if (option === undefined) return [];\n  const entries = Array.isArray(option) ? option : [option];\n  return Object.freeze(\n    entries.map((entry: string | HarnessInstructions) => {\n      if (typeof entry === \"string\") return defineHarnessInstructions(entry);\n      invariant(\n        entry?.kind === \"instructions\",\n        \"Declare instructions as text or with defineHarnessInstructions\",\n      );\n      return entry;\n    }),\n  );\n}\n"]}

package/dist/domain/model-messages.d.ts

@@ -0,0 +1,5 @@
+import type { ModelContentBlock, ModelMessage, ModelRequest, ModelToolSpec } from "./model.types.ts";
+export declare function requestMessages(request: ModelRequest): readonly ModelMessage[];
+export declare function validateMessages(messages: readonly ModelMessage[]): void;
+export declare function validateTools(tools: readonly ModelToolSpec[]): void;
+export declare function replayable(block: ModelContentBlock, identity: string, model: string): boolean;

package/dist/domain/model-messages.js

@@ -0,0 +1,81 @@
+import { invariant } from "./errors.js";
+import { TOOL_NAME_PATTERN } from "./model.constants.js";
+const text = (value) => typeof value === "string";
+const identifier = (value) => typeof value === "string" && value.trim() !== "";
+const blockRules = {
+    text: { role: "any", valid: (block) => text(block.text) },
+    "tool-call": {
+        role: "assistant",
+        valid: (block) => identifier(block.id) &&
+            typeof block.name === "string" &&
+            TOOL_NAME_PATTERN.test(block.name),
+    },
+    "tool-result": {
+        role: "user",
+        valid: (block) => identifier(block.callId) &&
+            text(block.content) &&
+            (block.isError === undefined || typeof block.isError === "boolean"),
+    },
+    reasoning: {
+        role: "assistant",
+        valid: (block) => identifier(block.provider) && identifier(block.model),
+    },
+};
+export function requestMessages(request) {
+    invariant((request.prompt === undefined) !== (request.messages === undefined), "Model request requires exactly one of prompt or messages");
+    if (request.messages !== undefined) {
+        validateMessages(request.messages);
+        return request.messages;
+    }
+    invariant(typeof request.prompt === "string" && request.prompt.trim(), "Model prompt must be nonempty text");
+    return [{ role: "user", content: [{ type: "text", text: request.prompt }] }];
+}
+export function validateMessages(messages) {
+    invariant(Array.isArray(messages) && messages.length > 0, "Model messages must be a nonempty array");
+    let pending = new Set();
+    for (const message of messages) {
+        invariant(message !== null &&
+            typeof message === "object" &&
+            (message.role === "user" || message.role === "assistant") &&
+            Array.isArray(message.content) &&
+            message.content.length > 0, "Model messages need a user or assistant role and content blocks");
+        const content = message.content;
+        for (const block of content)
+            validateBlock(block, message.role);
+        const results = content.flatMap((block) => block.type === "tool-result" ? [block.callId] : []);
+        invariant(results.length === pending.size &&
+            results.every((id) => pending.has(id)) &&
+            new Set(results).size === results.length, "Each tool call needs exactly one result in the next user message");
+        pending = new Set(content.flatMap((block) => block.type === "tool-call" ? [block.id] : []));
+    }
+    invariant(messages[0].role === "user" && messages.at(-1).role === "user", "Model messages must start and end with a user message");
+}
+export function validateTools(tools) {
+    invariant(Array.isArray(tools), "Model tools must be an array");
+    const names = new Set();
+    for (const tool of tools) {
+        invariant(tool !== null &&
+            typeof tool === "object" &&
+            typeof tool.name === "string" &&
+            TOOL_NAME_PATTERN.test(tool.name) &&
+            !names.has(tool.name), "Model tools need unique names of letters, digits, underscores or hyphens");
+        names.add(tool.name);
+        invariant(typeof tool.description === "string" &&
+            tool.inputSchema !== null &&
+            typeof tool.inputSchema === "object" &&
+            !Array.isArray(tool.inputSchema), "Model tools need a description and a JSON Schema object");
+    }
+}
+export function replayable(block, identity, model) {
+    return (block.type !== "reasoning" ||
+        (block.provider === identity && block.model === model));
+}
+function validateBlock(block, role) {
+    invariant(block !== null &&
+        typeof block === "object" &&
+        Object.hasOwn(blockRules, block.type), "Unsupported model content block");
+    const rule = blockRules[block.type];
+    invariant((rule.role === "any" || rule.role === role) &&
+        rule.valid(block), `Invalid ${block.type} block in a ${role} message`);
+}
+//# sourceMappingURL=model-messages.js.map