@elie-laloum/outpost 4.2.0 → 5.0.0

package/dist/domain/skill.js

@@ -0,0 +1,79 @@
+import { invariant } from "./errors.js";
+import { defineHarnessInstructions } from "./instructions.js";
+import { TOOL_NAME_PATTERN } from "./model.constants.js";
+import { SKILL_FIELDS, SKILL_LOADER } from "./skill.constants.js";
+import { defineHarnessTool, harnessTools } from "./tool.js";
+export function defineHarnessSkill(options) {
+    invariant(options !== null &&
+        typeof options === "object" &&
+        Object.keys(options).every((key) => SKILL_FIELDS.has(key)), "Skills accept name, description, instructions and tools");
+    invariant(typeof options.name === "string" && TOOL_NAME_PATTERN.test(options.name), "Skill names use 1 to 64 letters, digits, underscores or hyphens");
+    invariant(typeof options.description === "string" && options.description.trim(), "Skill description must be nonempty text");
+    return Object.freeze({
+        kind: "skill",
+        name: options.name,
+        description: options.description,
+        instructions: defineHarnessInstructions(options.instructions),
+        tools: harnessTools(options.tools ?? []),
+    });
+}
+export function harnessSkills(skills) {
+    if (skills === undefined)
+        return [];
+    invariant(Array.isArray(skills), "Skills must be an array");
+    const names = new Set();
+    for (const skill of skills) {
+        invariant(skill?.kind === "skill", "Declare skills with defineHarnessSkill");
+        invariant(!names.has(skill.name), `Duplicate skill name: ${skill.name}`);
+        names.add(skill.name);
+    }
+    return Object.freeze([...skills]);
+}
+export function skillCatalog(skills) {
+    return [
+        `Skills are available on demand. Call ${SKILL_LOADER} with a skill name to read its instructions and enable its tools before using them:`,
+        ...skills.map((skill) => `- ${skill.name}: ${skill.description}`),
+    ].join("\n");
+}
+export function skillLoader(skills) {
+    const byName = new Map(skills.map((skill) => [skill.name, skill]));
+    return defineHarnessTool({
+        name: SKILL_LOADER,
+        description: "Load a skill listed in the instructions: returns its instructions and enables its tools for the following steps.",
+        readOnly: true,
+        input: {
+            type: "object",
+            properties: { name: { enum: skills.map((skill) => skill.name) } },
+            required: ["name"],
+            additionalProperties: false,
+        },
+        async execute(input, context) {
+            const skill = byName.get(input.name);
+            const text = await skill.instructions.resolve({
+                sandbox: context.sandbox,
+                signal: context.signal,
+                model: context.model,
+            });
+            const tools = skill.tools.map((tool) => tool.name);
+            return tools.length
+                ? `${text}\n\nTools now available: ${tools.join(", ")}.`
+                : text;
+        },
+    });
+}
+export function loadedSkills(messages) {
+    const requested = new Map();
+    const loaded = new Set();
+    for (const message of messages)
+        for (const block of message.content) {
+            if (block.type === "tool-call" && block.name === SKILL_LOADER)
+                requested.set(block.id, String(block.input?.name));
+            if (block.type !== "tool-result" || block.isError)
+                continue;
+            const name = requested.get(block.callId);
+            if (name !== undefined)
+                loaded.add(name);
+        }
+    return loaded;
+}
+//# sourceMappingURL=skill.js.map

package/dist/domain/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/domain/skill.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from \"./errors.ts\";\nimport { defineHarnessInstructions } from \"./instructions.ts\";\nimport { TOOL_NAME_PATTERN } from \"./model.constants.ts\";\nimport type { ModelMessage } from \"./model.types.ts\";\nimport { SKILL_FIELDS, SKILL_LOADER } from \"./skill.constants.ts\";\nimport type {\n  HarnessSkill,\n  HarnessSkillOptions,\n  SkillLoaderInput,\n} from \"./skill.types.ts\";\nimport { defineHarnessTool, harnessTools } from \"./tool.ts\";\nimport type { HarnessTool } from \"./tool.types.ts\";\n\nexport function defineHarnessSkill(options: HarnessSkillOptions): HarnessSkill {\n  invariant(\n    options !== null &&\n      typeof options === \"object\" &&\n      Object.keys(options).every((key) => SKILL_FIELDS.has(key)),\n    \"Skills accept name, description, instructions and tools\",\n  );\n  invariant(\n    typeof options.name === \"string\" && TOOL_NAME_PATTERN.test(options.name),\n    \"Skill names use 1 to 64 letters, digits, underscores or hyphens\",\n  );\n  invariant(\n    typeof options.description === \"string\" && options.description.trim(),\n    \"Skill description must be nonempty text\",\n  );\n  return Object.freeze({\n    kind: \"skill\",\n    name: options.name,\n    description: options.description,\n    instructions: defineHarnessInstructions(options.instructions),\n    tools: harnessTools(options.tools ?? []),\n  });\n}\n\nexport function harnessSkills(\n  skills: readonly HarnessSkill[] | undefined,\n): readonly HarnessSkill[] {\n  if (skills === undefined) return [];\n  invariant(Array.isArray(skills), \"Skills must be an array\");\n  const names = new Set<string>();\n  for (const skill of skills) {\n    invariant(\n      skill?.kind === \"skill\",\n      \"Declare skills with defineHarnessSkill\",\n    );\n    invariant(!names.has(skill.name), `Duplicate skill name: ${skill.name}`);\n    names.add(skill.name);\n  }\n  return Object.freeze([...skills]);\n}\n\nexport function skillCatalog(skills: readonly HarnessSkill[]): string {\n  return [\n    `Skills are available on demand. Call ${SKILL_LOADER} with a skill name to read its instructions and enable its tools before using them:`,\n    ...skills.map((skill) => `- ${skill.name}: ${skill.description}`),\n  ].join(\"\\n\");\n}\n\nexport function skillLoader(skills: readonly HarnessSkill[]): HarnessTool {\n  const byName = new Map(skills.map((skill) => [skill.name, skill]));\n  return defineHarnessTool({\n    name: SKILL_LOADER,\n    description:\n      \"Load a skill listed in the instructions: returns its instructions and enables its tools for the following steps.\",\n    readOnly: true,\n    input: {\n      type: \"object\",\n      properties: { name: { enum: skills.map((skill) => skill.name) } },\n      required: [\"name\"],\n      additionalProperties: false,\n    },\n    async execute(input: SkillLoaderInput, context) {\n      const skill = byName.get(input.name)!;\n      const text = await skill.instructions.resolve({\n        sandbox: context.sandbox,\n        signal: context.signal,\n        model: context.model,\n      });\n      const tools = skill.tools.map((tool) => tool.name);\n      return tools.length\n        ? `${text}\\n\\nTools now available: ${tools.join(\", \")}.`\n        : text;\n    },\n  });\n}\n\nexport function loadedSkills(\n  messages: readonly ModelMessage[],\n): ReadonlySet<string> {\n  const requested = new Map<string, string>();\n  const loaded = new Set<string>();\n  for (const message of messages)\n    for (const block of message.content) {\n      if (block.type === \"tool-call\" && block.name === SKILL_LOADER)\n        requested.set(\n          block.id,\n          String((block.input as SkillLoaderInput)?.name),\n        );\n      if (block.type !== \"tool-result\" || block.isError) continue;\n      const name = requested.get(block.callId);\n      if (name !== undefined) loaded.add(name);\n    }\n  return loaded;\n}\n"]}

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

@@ -0,0 +1,18 @@
+import type { HarnessInstructions, HarnessInstructionSource } from "./harness.types.ts";
+import type { HarnessTool, HarnessToolset } from "./tool.types.ts";
+export interface HarnessSkillOptions {
+    readonly name: string;
+    readonly description: string;
+    readonly instructions: HarnessInstructionSource;
+    readonly tools?: readonly (HarnessTool | HarnessToolset)[];
+}
+export interface HarnessSkill {
+    readonly kind: "skill";
+    readonly name: string;
+    readonly description: string;
+    readonly instructions: HarnessInstructions;
+    readonly tools: readonly HarnessTool[];
+}
+export interface SkillLoaderInput {
+    readonly name: string;
+}

package/dist/domain/skill.types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.types.js","sourceRoot":"","sources":["../../src/domain/skill.types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  HarnessInstructions,\n  HarnessInstructionSource,\n} from \"./harness.types.ts\";\nimport type { HarnessTool, HarnessToolset } from \"./tool.types.ts\";\n\nexport interface HarnessSkillOptions {\n  readonly name: string;\n  readonly description: string;\n  readonly instructions: HarnessInstructionSource;\n  readonly tools?: readonly (HarnessTool | HarnessToolset)[];\n}\n\nexport interface HarnessSkill {\n  readonly kind: \"skill\";\n  readonly name: string;\n  readonly description: string;\n  readonly instructions: HarnessInstructions;\n  readonly tools: readonly HarnessTool[];\n}\n\nexport interface SkillLoaderInput {\n  readonly name: string;\n}\n"]}

package/dist/domain/standard-schema.d.ts

@@ -0,0 +1,6 @@
+import type { StandardResult, StandardValidator } from "./response.types.ts";
+import type { JsonSchema, StandardJsonSchema } from "./tool.types.ts";
+export declare function validateStandard<T>(schema: StandardValidator<T>, value: unknown): Promise<StandardResult<T>>;
+export declare function isStandardJsonSchema(value: unknown): value is StandardJsonSchema<unknown>;
+export declare function standardInputSchema(schema: StandardJsonSchema<unknown>): JsonSchema;
+export declare function formatIssues(issues: readonly unknown[]): string;

package/dist/domain/standard-schema.js

@@ -0,0 +1,45 @@
+import { invariant } from "./errors.js";
+import { STANDARD_JSON_SCHEMA_TARGET } from "./tool.constants.js";
+export async function validateStandard(schema, value) {
+    const result = await schema["~standard"].validate(value);
+    if (result.issues)
+        return { issues: result.issues };
+    return { value: result.value };
+}
+export function isStandardJsonSchema(value) {
+    if (value === null || typeof value !== "object" || !("~standard" in value))
+        return false;
+    const standard = value["~standard"];
+    return (typeof standard?.validate === "function" &&
+        typeof standard.jsonSchema
+            ?.input === "function");
+}
+export function standardInputSchema(schema) {
+    const converted = schema["~standard"].jsonSchema.input({
+        target: STANDARD_JSON_SCHEMA_TARGET,
+    });
+    invariant(converted !== null &&
+        typeof converted === "object" &&
+        !Array.isArray(converted) &&
+        converted.type === "object", "Standard schema must convert to a JSON Schema object");
+    const { $schema: _dialect, ...portable } = converted;
+    return Object.freeze(portable);
+}
+export function formatIssues(issues) {
+    return issues
+        .map((issue) => {
+        if (issue === null || typeof issue !== "object")
+            return String(issue);
+        const { message, path } = issue;
+        const location = Array.isArray(path)
+            ? path
+                .map((segment) => segment !== null && typeof segment === "object"
+                ? String(segment.key)
+                : String(segment))
+                .join(".")
+            : "";
+        return `${location ? `${location}: ` : ""}${String(message ?? JSON.stringify(issue))}`;
+    })
+        .join("; ");
+}
+//# sourceMappingURL=standard-schema.js.map

package/dist/domain/standard-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.js","sourceRoot":"","sources":["../../src/domain/standard-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AASlE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA4B,EAC5B,KAAc;IAEd,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACpD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAc;IAEd,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAwC,CAAC;IAC3E,OAAO,CACL,OAAO,QAAQ,EAAE,QAAQ,KAAK,UAAU;QACxC,OAAQ,QAAQ,CAAC,UAAkD;YACjE,EAAE,KAAK,KAAK,UAAU,CACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAmC;IAEnC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;QACrD,MAAM,EAAE,2BAA2B;KACpC,CAAC,CAAC;IACH,SAAS,CACP,SAAS,KAAK,IAAI;QAChB,OAAO,SAAS,KAAK,QAAQ;QAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QACzB,SAAS,CAAC,IAAI,KAAK,QAAQ,EAC7B,sDAAsD,CACvD,CAAC;IACF,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC;IACrD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAsB,CAAC;QACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAClC,CAAC,CAAC,IAAI;iBACD,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACf,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAC7C,CAAC,CAAC,MAAM,CAAE,OAA+B,CAAC,GAAG,CAAC;gBAC9C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CACpB;iBACA,IAAI,CAAC,GAAG,CAAC;YACd,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACzF,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC","sourcesContent":["import { invariant } from \"./errors.ts\";\nimport { STANDARD_JSON_SCHEMA_TARGET } from \"./tool.constants.ts\";\nimport type {\n  StandardIssue,\n  StandardPathSegment,\n  StandardResult,\n  StandardValidator,\n} from \"./response.types.ts\";\nimport type { JsonSchema, StandardJsonSchema } from \"./tool.types.ts\";\n\nexport async function validateStandard<T>(\n  schema: StandardValidator<T>,\n  value: unknown,\n): Promise<StandardResult<T>> {\n  const result = await schema[\"~standard\"].validate(value);\n  if (result.issues) return { issues: result.issues };\n  return { value: result.value };\n}\n\nexport function isStandardJsonSchema(\n  value: unknown,\n): value is StandardJsonSchema<unknown> {\n  if (value === null || typeof value !== \"object\" || !(\"~standard\" in value))\n    return false;\n  const standard = value[\"~standard\"] as Record<string, unknown> | undefined;\n  return (\n    typeof standard?.validate === \"function\" &&\n    typeof (standard.jsonSchema as Record<string, unknown> | undefined)\n      ?.input === \"function\"\n  );\n}\n\nexport function standardInputSchema(\n  schema: StandardJsonSchema<unknown>,\n): JsonSchema {\n  const converted = schema[\"~standard\"].jsonSchema.input({\n    target: STANDARD_JSON_SCHEMA_TARGET,\n  });\n  invariant(\n    converted !== null &&\n      typeof converted === \"object\" &&\n      !Array.isArray(converted) &&\n      converted.type === \"object\",\n    \"Standard schema must convert to a JSON Schema object\",\n  );\n  const { $schema: _dialect, ...portable } = converted;\n  return Object.freeze(portable);\n}\n\nexport function formatIssues(issues: readonly unknown[]): string {\n  return issues\n    .map((issue) => {\n      if (issue === null || typeof issue !== \"object\") return String(issue);\n      const { message, path } = issue as StandardIssue;\n      const location = Array.isArray(path)\n        ? path\n            .map((segment) =>\n              segment !== null && typeof segment === \"object\"\n                ? String((segment as StandardPathSegment).key)\n                : String(segment),\n            )\n            .join(\".\")\n        : \"\";\n      return `${location ? `${location}: ` : \"\"}${String(message ?? JSON.stringify(issue))}`;\n    })\n    .join(\"; \");\n}\n"]}

package/dist/domain/tool-schema.d.ts

@@ -0,0 +1,3 @@
+import type { JsonSchema } from "./tool.types.ts";
+export declare function validateSchemaDefinition(schema: unknown, root?: boolean): void;
+export declare function schemaIssues(schema: JsonSchema, value: unknown, path?: string): readonly string[];

package/dist/domain/tool-schema.js

@@ -0,0 +1,109 @@
+import { invariant } from "./errors.js";
+import { JSON_SCHEMA_KEYWORDS, JSON_SCHEMA_TYPES } from "./tool.constants.js";
+const plain = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const same = (left, right) => JSON.stringify(left) === JSON.stringify(right);
+const typeChecks = {
+    object: plain,
+    array: Array.isArray,
+    string: (value) => typeof value === "string",
+    number: (value) => typeof value === "number" && Number.isFinite(value),
+    integer: (value) => Number.isInteger(value),
+    boolean: (value) => typeof value === "boolean",
+    null: (value) => value === null,
+};
+const keywordChecks = {
+    enum: (schema, value, path) => schema.enum.some((option) => same(option, value))
+        ? []
+        : [`${path} must be one of ${JSON.stringify(schema.enum)}`],
+    const: (schema, value, path) => same(schema.const, value)
+        ? []
+        : [`${path} must equal ${JSON.stringify(schema.const)}`],
+    minLength: bound((value) => typeof value === "string" ? [...value].length : undefined)("minLength", (size, limit) => size >= limit, "at least", "characters"),
+    maxLength: bound((value) => typeof value === "string" ? [...value].length : undefined)("maxLength", (size, limit) => size <= limit, "at most", "characters"),
+    minimum: bound((value) => (typeof value === "number" ? value : undefined))("minimum", (size, limit) => size >= limit, "at least", ""),
+    maximum: bound((value) => (typeof value === "number" ? value : undefined))("maximum", (size, limit) => size <= limit, "at most", ""),
+    minItems: bound((value) => (Array.isArray(value) ? value.length : undefined))("minItems", (size, limit) => size >= limit, "at least", "items"),
+    maxItems: bound((value) => (Array.isArray(value) ? value.length : undefined))("maxItems", (size, limit) => size <= limit, "at most", "items"),
+    items: (schema, value, path) => Array.isArray(value)
+        ? value.flatMap((item, index) => schemaIssues(schema.items, item, `${path}[${index}]`))
+        : [],
+    required: (schema, value, path) => plain(value)
+        ? schema.required.flatMap((key) => Object.hasOwn(value, key) ? [] : [`${path}.${key} is required`])
+        : [],
+    properties: (schema, value, path) => plain(value)
+        ? Object.entries(schema.properties)
+            .filter(([key]) => Object.hasOwn(value, key))
+            .flatMap(([key, property]) => schemaIssues(property, value[key], `${path}.${key}`))
+        : [],
+    additionalProperties: (schema, value, path) => {
+        if (!plain(value))
+            return [];
+        const declared = plain(schema.properties) ? schema.properties : {};
+        const extra = Object.keys(value).filter((key) => !Object.hasOwn(declared, key));
+        if (schema.additionalProperties === false)
+            return extra.map((key) => `${path}.${key} is not allowed`);
+        if (!plain(schema.additionalProperties))
+            return [];
+        const additional = schema.additionalProperties;
+        return extra.flatMap((key) => schemaIssues(additional, value[key], `${path}.${key}`));
+    },
+};
+export function validateSchemaDefinition(schema, root = true) {
+    invariant(plain(schema), "Tool input schema must be a JSON Schema object");
+    invariant(Object.keys(schema).every((key) => JSON_SCHEMA_KEYWORDS.has(key)), `Unsupported JSON Schema keyword; use ${[...JSON_SCHEMA_KEYWORDS].join(", ")}`);
+    const types = schemaTypes(schema);
+    invariant(types.every((type) => JSON_SCHEMA_TYPES.has(type)), "Unsupported JSON Schema type");
+    invariant(!root || (types.length === 1 && types[0] === "object"), "Tool input schema must describe an object");
+    invariant(schema.required === undefined ||
+        (Array.isArray(schema.required) &&
+            schema.required.every((key) => typeof key === "string")), "JSON Schema required must list property names");
+    invariant(schema.enum === undefined || Array.isArray(schema.enum), "JSON Schema enum must be an array");
+    for (const keyword of [
+        "minLength",
+        "maxLength",
+        "minimum",
+        "maximum",
+        "minItems",
+        "maxItems",
+    ])
+        invariant(schema[keyword] === undefined ||
+            (typeof schema[keyword] === "number" &&
+                Number.isFinite(schema[keyword])), `JSON Schema ${keyword} must be a number`);
+    if (schema.properties !== undefined) {
+        invariant(plain(schema.properties), "JSON Schema properties must be an object");
+        for (const property of Object.values(schema.properties))
+            validateSchemaDefinition(property, false);
+    }
+    if (schema.items !== undefined)
+        validateSchemaDefinition(schema.items, false);
+    if (plain(schema.additionalProperties))
+        validateSchemaDefinition(schema.additionalProperties, false);
+    invariant(schema.additionalProperties === undefined ||
+        typeof schema.additionalProperties === "boolean" ||
+        plain(schema.additionalProperties), "JSON Schema additionalProperties must be a boolean or a schema");
+}
+export function schemaIssues(schema, value, path = "input") {
+    const types = schemaTypes(schema);
+    if (types.length && !types.some((type) => typeChecks[type](value)))
+        return [`${path} must be ${types.join(" or ")}`];
+    return Object.keys(schema)
+        .filter((keyword) => Object.hasOwn(keywordChecks, keyword))
+        .flatMap((keyword) => keywordChecks[keyword](schema, value, path));
+}
+function schemaTypes(schema) {
+    if (schema.type === undefined)
+        return [];
+    const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+    invariant(types.every((type) => typeof type === "string"), "JSON Schema type must be a name or a list of names");
+    return types;
+}
+function bound(measure) {
+    return (keyword, accept, relation, unit) => (schema, value, path) => {
+        const size = measure(value);
+        const limit = typeof schema[keyword] === "number" ? schema[keyword] : undefined;
+        if (size === undefined || limit === undefined || accept(size, limit))
+            return [];
+        return [`${path} must be ${relation} ${limit}${unit ? ` ${unit}` : ""}`];
+    };
+}
+//# sourceMappingURL=tool-schema.js.map

package/dist/domain/tool-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema.js","sourceRoot":"","sources":["../../src/domain/tool-schema.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from \"./errors.ts\";\nimport { JSON_SCHEMA_KEYWORDS, JSON_SCHEMA_TYPES } from \"./tool.constants.ts\";\nimport type { JsonSchema, SchemaKeywordCheck } from \"./tool.types.ts\";\n\nconst plain = (value: unknown): value is Readonly<Record<string, unknown>> =>\n  value !== null && typeof value === \"object\" && !Array.isArray(value);\nconst same = (left: unknown, right: unknown) =>\n  JSON.stringify(left) === JSON.stringify(right);\n\nconst typeChecks: Readonly<Record<string, (value: unknown) => boolean>> = {\n  object: plain,\n  array: Array.isArray,\n  string: (value) => typeof value === \"string\",\n  number: (value) => typeof value === \"number\" && Number.isFinite(value),\n  integer: (value) => Number.isInteger(value),\n  boolean: (value) => typeof value === \"boolean\",\n  null: (value) => value === null,\n};\n\nconst keywordChecks: Readonly<Record<string, SchemaKeywordCheck>> = {\n  enum: (schema, value, path) =>\n    (schema.enum as readonly unknown[]).some((option) => same(option, value))\n      ? []\n      : [`${path} must be one of ${JSON.stringify(schema.enum)}`],\n  const: (schema, value, path) =>\n    same(schema.const, value)\n      ? []\n      : [`${path} must equal ${JSON.stringify(schema.const)}`],\n  minLength: bound((value) =>\n    typeof value === \"string\" ? [...value].length : undefined,\n  )(\"minLength\", (size, limit) => size >= limit, \"at least\", \"characters\"),\n  maxLength: bound((value) =>\n    typeof value === \"string\" ? [...value].length : undefined,\n  )(\"maxLength\", (size, limit) => size <= limit, \"at most\", \"characters\"),\n  minimum: bound((value) => (typeof value === \"number\" ? value : undefined))(\n    \"minimum\",\n    (size, limit) => size >= limit,\n    \"at least\",\n    \"\",\n  ),\n  maximum: bound((value) => (typeof value === \"number\" ? value : undefined))(\n    \"maximum\",\n    (size, limit) => size <= limit,\n    \"at most\",\n    \"\",\n  ),\n  minItems: bound((value) => (Array.isArray(value) ? value.length : undefined))(\n    \"minItems\",\n    (size, limit) => size >= limit,\n    \"at least\",\n    \"items\",\n  ),\n  maxItems: bound((value) => (Array.isArray(value) ? value.length : undefined))(\n    \"maxItems\",\n    (size, limit) => size <= limit,\n    \"at most\",\n    \"items\",\n  ),\n  items: (schema, value, path) =>\n    Array.isArray(value)\n      ? value.flatMap((item, index) =>\n          schemaIssues(schema.items as JsonSchema, item, `${path}[${index}]`),\n        )\n      : [],\n  required: (schema, value, path) =>\n    plain(value)\n      ? (schema.required as readonly string[]).flatMap((key) =>\n          Object.hasOwn(value, key) ? [] : [`${path}.${key} is required`],\n        )\n      : [],\n  properties: (schema, value, path) =>\n    plain(value)\n      ? Object.entries(schema.properties as Record<string, JsonSchema>)\n          .filter(([key]) => Object.hasOwn(value, key))\n          .flatMap(([key, property]) =>\n            schemaIssues(property, value[key], `${path}.${key}`),\n          )\n      : [],\n  additionalProperties: (schema, value, path) => {\n    if (!plain(value)) return [];\n    const declared = plain(schema.properties) ? schema.properties : {};\n    const extra = Object.keys(value).filter(\n      (key) => !Object.hasOwn(declared, key),\n    );\n    if (schema.additionalProperties === false)\n      return extra.map((key) => `${path}.${key} is not allowed`);\n    if (!plain(schema.additionalProperties)) return [];\n    const additional = schema.additionalProperties;\n    return extra.flatMap((key) =>\n      schemaIssues(additional, value[key], `${path}.${key}`),\n    );\n  },\n};\n\nexport function validateSchemaDefinition(schema: unknown, root = true): void {\n  invariant(plain(schema), \"Tool input schema must be a JSON Schema object\");\n  invariant(\n    Object.keys(schema).every((key) => JSON_SCHEMA_KEYWORDS.has(key)),\n    `Unsupported JSON Schema keyword; use ${[...JSON_SCHEMA_KEYWORDS].join(\", \")}`,\n  );\n  const types = schemaTypes(schema);\n  invariant(\n    types.every((type) => JSON_SCHEMA_TYPES.has(type)),\n    \"Unsupported JSON Schema type\",\n  );\n  invariant(\n    !root || (types.length === 1 && types[0] === \"object\"),\n    \"Tool input schema must describe an object\",\n  );\n  invariant(\n    schema.required === undefined ||\n      (Array.isArray(schema.required) &&\n        schema.required.every((key) => typeof key === \"string\")),\n    \"JSON Schema required must list property names\",\n  );\n  invariant(\n    schema.enum === undefined || Array.isArray(schema.enum),\n    \"JSON Schema enum must be an array\",\n  );\n  for (const keyword of [\n    \"minLength\",\n    \"maxLength\",\n    \"minimum\",\n    \"maximum\",\n    \"minItems\",\n    \"maxItems\",\n  ])\n    invariant(\n      schema[keyword] === undefined ||\n        (typeof schema[keyword] === \"number\" &&\n          Number.isFinite(schema[keyword])),\n      `JSON Schema ${keyword} must be a number`,\n    );\n  if (schema.properties !== undefined) {\n    invariant(\n      plain(schema.properties),\n      \"JSON Schema properties must be an object\",\n    );\n    for (const property of Object.values(schema.properties))\n      validateSchemaDefinition(property, false);\n  }\n  if (schema.items !== undefined) validateSchemaDefinition(schema.items, false);\n  if (plain(schema.additionalProperties))\n    validateSchemaDefinition(schema.additionalProperties, false);\n  invariant(\n    schema.additionalProperties === undefined ||\n      typeof schema.additionalProperties === \"boolean\" ||\n      plain(schema.additionalProperties),\n    \"JSON Schema additionalProperties must be a boolean or a schema\",\n  );\n}\n\nexport function schemaIssues(\n  schema: JsonSchema,\n  value: unknown,\n  path = \"input\",\n): readonly string[] {\n  const types = schemaTypes(schema);\n  if (types.length && !types.some((type) => typeChecks[type]!(value)))\n    return [`${path} must be ${types.join(\" or \")}`];\n  return Object.keys(schema)\n    .filter((keyword) => Object.hasOwn(keywordChecks, keyword))\n    .flatMap((keyword) => keywordChecks[keyword]!(schema, value, path));\n}\n\nfunction schemaTypes(schema: JsonSchema): readonly string[] {\n  if (schema.type === undefined) return [];\n  const types = Array.isArray(schema.type) ? schema.type : [schema.type];\n  invariant(\n    types.every((type) => typeof type === \"string\"),\n    \"JSON Schema type must be a name or a list of names\",\n  );\n  return types;\n}\n\nfunction bound(measure: (value: unknown) => number | undefined) {\n  return (\n      keyword: string,\n      accept: (size: number, limit: number) => boolean,\n      relation: string,\n      unit: string,\n    ): SchemaKeywordCheck =>\n    (schema, value, path) => {\n      const size = measure(value);\n      const limit =\n        typeof schema[keyword] === \"number\" ? schema[keyword] : undefined;\n      if (size === undefined || limit === undefined || accept(size, limit))\n        return [];\n      return [`${path} must be ${relation} ${limit}${unit ? ` ${unit}` : \"\"}`];\n    };\n}\n"]}

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

@@ -0,0 +1,4 @@
+export declare const JSON_SCHEMA_KEYWORDS: ReadonlySet<string>;
+export declare const JSON_SCHEMA_TYPES: ReadonlySet<string>;
+export declare const STANDARD_JSON_SCHEMA_TARGET = "draft-2020-12";
+export declare const HARNESS_TOOL_FIELDS: ReadonlySet<string>;

package/dist/domain/tool.constants.js

@@ -0,0 +1,36 @@
+export const JSON_SCHEMA_KEYWORDS = new Set([
+    "type",
+    "title",
+    "description",
+    "properties",
+    "required",
+    "additionalProperties",
+    "items",
+    "enum",
+    "const",
+    "minLength",
+    "maxLength",
+    "minimum",
+    "maximum",
+    "minItems",
+    "maxItems",
+]);
+export const JSON_SCHEMA_TYPES = new Set([
+    "object",
+    "array",
+    "string",
+    "number",
+    "integer",
+    "boolean",
+    "null",
+]);
+export const STANDARD_JSON_SCHEMA_TARGET = "draft-2020-12";
+export const HARNESS_TOOL_FIELDS = new Set([
+    "name",
+    "description",
+    "input",
+    "readOnly",
+    "resources",
+    "execute",
+]);
+//# sourceMappingURL=tool.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.constants.js","sourceRoot":"","sources":["../../src/domain/tool.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IAC/D,MAAM;IACN,OAAO;IACP,aAAa;IACb,YAAY;IACZ,UAAU;IACV,sBAAsB;IACtB,OAAO;IACP,MAAM;IACN,OAAO;IACP,WAAW;IACX,WAAW;IACX,SAAS;IACT,SAAS;IACT,UAAU;IACV,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC;IAC5D,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,SAAS;IACT,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAE3D,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IAC9D,MAAM;IACN,aAAa;IACb,OAAO;IACP,UAAU;IACV,WAAW;IACX,SAAS;CACV,CAAC,CAAC","sourcesContent":["export const JSON_SCHEMA_KEYWORDS: ReadonlySet<string> = new Set([\n  \"type\",\n  \"title\",\n  \"description\",\n  \"properties\",\n  \"required\",\n  \"additionalProperties\",\n  \"items\",\n  \"enum\",\n  \"const\",\n  \"minLength\",\n  \"maxLength\",\n  \"minimum\",\n  \"maximum\",\n  \"minItems\",\n  \"maxItems\",\n]);\n\nexport const JSON_SCHEMA_TYPES: ReadonlySet<string> = new Set([\n  \"object\",\n  \"array\",\n  \"string\",\n  \"number\",\n  \"integer\",\n  \"boolean\",\n  \"null\",\n]);\n\nexport const STANDARD_JSON_SCHEMA_TARGET = \"draft-2020-12\";\n\nexport const HARNESS_TOOL_FIELDS: ReadonlySet<string> = new Set([\n  \"name\",\n  \"description\",\n  \"input\",\n  \"readOnly\",\n  \"resources\",\n  \"execute\",\n]);\n"]}

package/dist/domain/tool.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessTool, HarnessToolOptions, HarnessToolset, HarnessToolsetOptions } from "./tool.types.ts";
+export declare function defineHarnessTool<Input>(options: HarnessToolOptions<Input>): HarnessTool<Input>;
+export declare function defineHarnessToolset(options: HarnessToolsetOptions): HarnessToolset;
+export declare function harnessTools(entries: readonly (HarnessTool | HarnessToolset)[]): readonly HarnessTool[];

package/dist/domain/tool.js

@@ -0,0 +1,66 @@
+import { invariant } from "./errors.js";
+import { TOOL_NAME_PATTERN } from "./model.constants.js";
+import { formatIssues, isStandardJsonSchema, standardInputSchema, validateStandard, } from "./standard-schema.js";
+import { HARNESS_TOOL_FIELDS } from "./tool.constants.js";
+import { schemaIssues, validateSchemaDefinition } from "./tool-schema.js";
+export function defineHarnessTool(options) {
+    invariant(options !== null && typeof options === "object", "Tool options must be an object");
+    invariant(Object.keys(options).every((key) => HARNESS_TOOL_FIELDS.has(key)), "Unsupported tool option");
+    invariant(typeof options.name === "string" && TOOL_NAME_PATTERN.test(options.name), "Tool names use 1 to 64 letters, digits, underscores or hyphens");
+    invariant(typeof options.description === "string" && options.description.trim(), "Tool description must be nonempty text");
+    invariant(typeof options.execute === "function", "Tool execute must be a function");
+    invariant(options.readOnly === undefined || typeof options.readOnly === "boolean", "Tool readOnly must be boolean");
+    invariant(options.resources === undefined || typeof options.resources === "function", "Tool resources must be a function");
+    const standard = isStandardJsonSchema(options.input)
+        ? options.input
+        : undefined;
+    if (!standard)
+        validateSchemaDefinition(options.input);
+    const inputSchema = standard
+        ? standardInputSchema(standard)
+        : Object.freeze(structuredClone(options.input));
+    return Object.freeze({
+        kind: "tool",
+        name: options.name,
+        description: options.description,
+        readOnly: options.readOnly ?? false,
+        inputSchema,
+        async validate(value) {
+            if (standard) {
+                const result = await validateStandard(standard, value);
+                return "issues" in result
+                    ? { issues: formatIssues(result.issues) }
+                    : { value: result.value };
+            }
+            const issues = schemaIssues(inputSchema, value);
+            return issues.length
+                ? { issues: issues.join("; ") }
+                : { value: value };
+        },
+        resources: (value) => options.resources?.(value) ?? {},
+        execute: (value, context) => options.execute(value, context),
+    });
+}
+export function defineHarnessToolset(options) {
+    invariant(options !== null && typeof options === "object", "Toolset options must be an object");
+    invariant(typeof options.name === "string" && options.name.trim(), "Toolset name must be nonempty text");
+    return Object.freeze({
+        kind: "toolset",
+        name: options.name,
+        tools: harnessTools(options.tools),
+    });
+}
+export function harnessTools(entries) {
+    invariant(Array.isArray(entries), "Tools must be an array");
+    const tools = entries.flatMap((entry) => {
+        invariant(entry?.kind === "tool" || entry?.kind === "toolset", "Declare tools with defineHarnessTool or defineHarnessToolset");
+        return entry.kind === "tool" ? [entry] : entry.tools;
+    });
+    const names = new Set();
+    for (const tool of tools) {
+        invariant(!names.has(tool.name), `Duplicate tool name: ${tool.name}`);
+        names.add(tool.name);
+    }
+    return Object.freeze(tools);
+}
+//# sourceMappingURL=tool.js.map

package/dist/domain/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/domain/tool.ts"],"names":[],"mappings":"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","sourcesContent":["import { invariant } from \"./errors.ts\";\nimport { TOOL_NAME_PATTERN } from \"./model.constants.ts\";\nimport {\n  formatIssues,\n  isStandardJsonSchema,\n  standardInputSchema,\n  validateStandard,\n} from \"./standard-schema.ts\";\nimport { HARNESS_TOOL_FIELDS } from \"./tool.constants.ts\";\nimport { schemaIssues, validateSchemaDefinition } from \"./tool-schema.ts\";\nimport type {\n  HarnessTool,\n  HarnessToolContext,\n  HarnessToolOptions,\n  HarnessToolset,\n  HarnessToolsetOptions,\n  JsonSchema,\n  StandardJsonSchema,\n  ToolValidation,\n} from \"./tool.types.ts\";\n\nexport function defineHarnessTool<Input>(\n  options: HarnessToolOptions<Input>,\n): HarnessTool<Input> {\n  invariant(\n    options !== null && typeof options === \"object\",\n    \"Tool options must be an object\",\n  );\n  invariant(\n    Object.keys(options).every((key) => HARNESS_TOOL_FIELDS.has(key)),\n    \"Unsupported tool option\",\n  );\n  invariant(\n    typeof options.name === \"string\" && TOOL_NAME_PATTERN.test(options.name),\n    \"Tool names use 1 to 64 letters, digits, underscores or hyphens\",\n  );\n  invariant(\n    typeof options.description === \"string\" && options.description.trim(),\n    \"Tool description must be nonempty text\",\n  );\n  invariant(\n    typeof options.execute === \"function\",\n    \"Tool execute must be a function\",\n  );\n  invariant(\n    options.readOnly === undefined || typeof options.readOnly === \"boolean\",\n    \"Tool readOnly must be boolean\",\n  );\n  invariant(\n    options.resources === undefined || typeof options.resources === \"function\",\n    \"Tool resources must be a function\",\n  );\n  const standard = isStandardJsonSchema(options.input)\n    ? (options.input as StandardJsonSchema<Input>)\n    : undefined;\n  if (!standard) validateSchemaDefinition(options.input);\n  const inputSchema: JsonSchema = standard\n    ? standardInputSchema(standard)\n    : Object.freeze(structuredClone(options.input as JsonSchema));\n  return Object.freeze({\n    kind: \"tool\",\n    name: options.name,\n    description: options.description,\n    readOnly: options.readOnly ?? false,\n    inputSchema,\n    async validate(value: unknown): Promise<ToolValidation<Input>> {\n      if (standard) {\n        const result = await validateStandard(standard, value);\n        return \"issues\" in result\n          ? { issues: formatIssues(result.issues) }\n          : { value: result.value };\n      }\n      const issues = schemaIssues(inputSchema, value);\n      return issues.length\n        ? { issues: issues.join(\"; \") }\n        : { value: value as Input };\n    },\n    resources: (value: Input) => options.resources?.(value) ?? {},\n    execute: (value: Input, context: HarnessToolContext) =>\n      options.execute(value, context),\n  });\n}\n\nexport function defineHarnessToolset(\n  options: HarnessToolsetOptions,\n): HarnessToolset {\n  invariant(\n    options !== null && typeof options === \"object\",\n    \"Toolset options must be an object\",\n  );\n  invariant(\n    typeof options.name === \"string\" && options.name.trim(),\n    \"Toolset name must be nonempty text\",\n  );\n  return Object.freeze({\n    kind: \"toolset\",\n    name: options.name,\n    tools: harnessTools(options.tools),\n  });\n}\n\nexport function harnessTools(\n  entries: readonly (HarnessTool | HarnessToolset)[],\n): readonly HarnessTool[] {\n  invariant(Array.isArray(entries), \"Tools must be an array\");\n  const tools = entries.flatMap((entry) => {\n    invariant(\n      entry?.kind === \"tool\" || entry?.kind === \"toolset\",\n      \"Declare tools with defineHarnessTool or defineHarnessToolset\",\n    );\n    return entry.kind === \"tool\" ? [entry] : entry.tools;\n  });\n  const names = new Set<string>();\n  for (const tool of tools) {\n    invariant(!names.has(tool.name), `Duplicate tool name: ${tool.name}`);\n    names.add(tool.name);\n  }\n  return Object.freeze(tools);\n}\n"]}

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

@@ -0,0 +1,62 @@
+import type { AgentEvent } from "./agent.types.ts";
+import type { AgentModel } from "./model.types.ts";
+import type { ToolResources } from "./permissions.types.ts";
+import type { StandardValidator } from "./response.types.ts";
+import type { SandboxLease } from "./sandbox.types.ts";
+export type JsonSchema = Readonly<Record<string, unknown>>;
+export interface StandardJsonSchema<Input> {
+    readonly "~standard": StandardValidator<Input>["~standard"] & {
+        readonly jsonSchema: {
+            input(options: {
+                readonly target: string;
+            }): Record<string, unknown>;
+        };
+    };
+}
+export type HarnessToolEvent = Extract<AgentEvent, {
+    readonly kind: "text" | "warning" | "raw";
+}>;
+export interface HarnessToolContext {
+    readonly sandbox: SandboxLease;
+    readonly signal: AbortSignal;
+    readonly callId: string;
+    readonly model: AgentModel;
+    observe(event: HarnessToolEvent): void;
+}
+export type ToolOutput = string | {
+    readonly content: string;
+    readonly isError?: boolean;
+};
+export interface HarnessToolOptions<Input> {
+    readonly name: string;
+    readonly description: string;
+    readonly input: StandardJsonSchema<Input> | JsonSchema;
+    readonly readOnly?: boolean;
+    resources?(input: Input): ToolResources;
+    execute(input: Input, context: HarnessToolContext): ToolOutput | Promise<ToolOutput>;
+}
+export type ToolValidation<Input> = {
+    readonly value: Input;
+} | {
+    readonly issues: string;
+};
+export interface HarnessTool<Input = unknown> {
+    readonly kind: "tool";
+    readonly name: string;
+    readonly description: string;
+    readonly readOnly: boolean;
+    readonly inputSchema: JsonSchema;
+    validate(value: unknown): Promise<ToolValidation<Input>>;
+    resources(input: Input): ToolResources;
+    execute(input: Input, context: HarnessToolContext): ToolOutput | Promise<ToolOutput>;
+}
+export interface HarnessToolsetOptions {
+    readonly name: string;
+    readonly tools: readonly (HarnessTool | HarnessToolset)[];
+}
+export interface HarnessToolset {
+    readonly kind: "toolset";
+    readonly name: string;
+    readonly tools: readonly HarnessTool[];
+}
+export type SchemaKeywordCheck = (schema: JsonSchema, value: unknown, path: string) => readonly string[];

package/dist/domain/tool.types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.types.js","sourceRoot":"","sources":["../../src/domain/tool.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentEvent } from \"./agent.types.ts\";\nimport type { AgentModel } from \"./model.types.ts\";\nimport type { ToolResources } from \"./permissions.types.ts\";\nimport type { StandardValidator } from \"./response.types.ts\";\nimport type { SandboxLease } from \"./sandbox.types.ts\";\n\nexport type JsonSchema = Readonly<Record<string, unknown>>;\n\nexport interface StandardJsonSchema<Input> {\n  readonly \"~standard\": StandardValidator<Input>[\"~standard\"] & {\n    readonly jsonSchema: {\n      input(options: { readonly target: string }): Record<string, unknown>;\n    };\n  };\n}\n\nexport type HarnessToolEvent = Extract<\n  AgentEvent,\n  { readonly kind: \"text\" | \"warning\" | \"raw\" }\n>;\n\nexport interface HarnessToolContext {\n  readonly sandbox: SandboxLease;\n  readonly signal: AbortSignal;\n  readonly callId: string;\n  readonly model: AgentModel;\n  observe(event: HarnessToolEvent): void;\n}\n\nexport type ToolOutput =\n  string | { readonly content: string; readonly isError?: boolean };\n\nexport interface HarnessToolOptions<Input> {\n  readonly name: string;\n  readonly description: string;\n  readonly input: StandardJsonSchema<Input> | JsonSchema;\n  readonly readOnly?: boolean;\n  resources?(input: Input): ToolResources;\n  execute(\n    input: Input,\n    context: HarnessToolContext,\n  ): ToolOutput | Promise<ToolOutput>;\n}\n\nexport type ToolValidation<Input> =\n  { readonly value: Input } | { readonly issues: string };\n\nexport interface HarnessTool<Input = unknown> {\n  readonly kind: \"tool\";\n  readonly name: string;\n  readonly description: string;\n  readonly readOnly: boolean;\n  readonly inputSchema: JsonSchema;\n  validate(value: unknown): Promise<ToolValidation<Input>>;\n  resources(input: Input): ToolResources;\n  execute(\n    input: Input,\n    context: HarnessToolContext,\n  ): ToolOutput | Promise<ToolOutput>;\n}\n\nexport interface HarnessToolsetOptions {\n  readonly name: string;\n  readonly tools: readonly (HarnessTool | HarnessToolset)[];\n}\n\nexport interface HarnessToolset {\n  readonly kind: \"toolset\";\n  readonly name: string;\n  readonly tools: readonly HarnessTool[];\n}\n\nexport type SchemaKeywordCheck = (\n  schema: JsonSchema,\n  value: unknown,\n  path: string,\n) => readonly string[];\n"]}

package/dist/domain/transcript.d.ts

@@ -0,0 +1,4 @@
+import type { ModelMessage } from "./model.types.ts";
+import type { TranscriptRecord } from "./transcript.types.ts";
+export declare function parseTranscript(text: string): readonly TranscriptRecord[];
+export declare function transcriptMessages(records: readonly TranscriptRecord[]): ModelMessage[];

package/dist/domain/transcript.js

@@ -0,0 +1,48 @@
+import { OutpostError } from "./errors.js";
+const folds = {
+    session: (messages) => messages,
+    message: (messages, record) => record.type === "message" ? [...messages, record.message] : messages,
+    compaction: (_messages, record) => record.type === "compaction" ? [...record.messages] : [],
+};
+export function parseTranscript(text) {
+    const records = text
+        .split("\n")
+        .filter((line) => line.trim())
+        .map((line) => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            throw new OutpostError("session", "Harness transcript is not valid JSONL");
+        }
+    });
+    const first = records[0];
+    if (first?.type !== "session" || first.version !== 1)
+        throw new OutpostError("session", "Unsupported harness transcript");
+    for (const record of records)
+        if (!Object.hasOwn(folds, record?.type))
+            throw new OutpostError("session", "Unsupported harness transcript record");
+    return records;
+}
+export function transcriptMessages(records) {
+    const messages = records.reduce((current, record) => folds[record.type](current, record), []);
+    const last = messages.at(-1);
+    const pending = last?.role === "assistant"
+        ? last.content.flatMap((block) => block.type === "tool-call" ? [block.id] : [])
+        : [];
+    if (!pending.length)
+        return messages;
+    return [
+        ...messages,
+        {
+            role: "user",
+            content: pending.map((callId) => ({
+                type: "tool-result",
+                callId,
+                content: "The tool call was interrupted before it produced a result.",
+                isError: true,
+            })),
+        },
+    ];
+}
+//# sourceMappingURL=transcript.js.map

package/dist/domain/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../src/domain/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,KAAK,GAKP;IACF,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ;IAC/B,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAC5B,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ;IACtE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAChC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;CAC3D,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,IAAI;SACjB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC7B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,YAAY,CACpB,SAAS,EACT,uCAAuC,CACxC,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IACL,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,KAAK,EAAE,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC;QAClD,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;IACtE,KAAK,MAAM,MAAM,IAAI,OAAO;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC;YACrC,MAAM,IAAI,YAAY,CACpB,SAAS,EACT,uCAAuC,CACxC,CAAC;IACN,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAoC;IAEpC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAC7B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EACxD,EAAE,CACH,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,OAAO,GACX,IAAI,EAAE,IAAI,KAAK,WAAW;QACxB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7B,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAC7C;QACH,CAAC,CAAC,EAAE,CAAC;IACT,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IACrC,OAAO;QACL,GAAG,QAAQ;QACX;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAChC,IAAI,EAAE,aAAsB;gBAC5B,MAAM;gBACN,OAAO,EAAE,4DAA4D;gBACrE,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;SACJ;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { OutpostError } from \"./errors.ts\";\nimport type { ModelMessage } from \"./model.types.ts\";\nimport type { TranscriptRecord } from \"./transcript.types.ts\";\n\nconst folds: Readonly<\n  Record<\n    TranscriptRecord[\"type\"],\n    (messages: ModelMessage[], record: TranscriptRecord) => ModelMessage[]\n  >\n> = {\n  session: (messages) => messages,\n  message: (messages, record) =>\n    record.type === \"message\" ? [...messages, record.message] : messages,\n  compaction: (_messages, record) =>\n    record.type === \"compaction\" ? [...record.messages] : [],\n};\n\nexport function parseTranscript(text: string): readonly TranscriptRecord[] {\n  const records = text\n    .split(\"\\n\")\n    .filter((line) => line.trim())\n    .map((line) => {\n      try {\n        return JSON.parse(line) as TranscriptRecord;\n      } catch {\n        throw new OutpostError(\n          \"session\",\n          \"Harness transcript is not valid JSONL\",\n        );\n      }\n    });\n  const first = records[0];\n  if (first?.type !== \"session\" || first.version !== 1)\n    throw new OutpostError(\"session\", \"Unsupported harness transcript\");\n  for (const record of records)\n    if (!Object.hasOwn(folds, record?.type))\n      throw new OutpostError(\n        \"session\",\n        \"Unsupported harness transcript record\",\n      );\n  return records;\n}\n\nexport function transcriptMessages(\n  records: readonly TranscriptRecord[],\n): ModelMessage[] {\n  const messages = records.reduce<ModelMessage[]>(\n    (current, record) => folds[record.type](current, record),\n    [],\n  );\n  const last = messages.at(-1);\n  const pending =\n    last?.role === \"assistant\"\n      ? last.content.flatMap((block) =>\n          block.type === \"tool-call\" ? [block.id] : [],\n        )\n      : [];\n  if (!pending.length) return messages;\n  return [\n    ...messages,\n    {\n      role: \"user\",\n      content: pending.map((callId) => ({\n        type: \"tool-result\" as const,\n        callId,\n        content: \"The tool call was interrupted before it produced a result.\",\n        isError: true,\n      })),\n    },\n  ];\n}\n"]}