@sema-agent/core 1.279.0

package/dist/core/runner/strict-output-schema.js

@@ -0,0 +1,304 @@
+const STRICT_KEYWORDS = new Set([
+    "$schema",
+    "type",
+    "description",
+    "title",
+    "properties",
+    "required",
+    "additionalProperties",
+    "items",
+    "enum",
+    "const",
+    "anyOf",
+]);
+const ANYOF_SIBLINGS = new Set(["$schema", "description", "title"]);
+const STRICT_TYPES = new Set(["object", "array", "string", "integer", "number", "boolean", "null"]);
+const STRICT_MAX_DEPTH = 32;
+const STRICT_NODE_BUDGET = 100_000;
+const GUARD_NODE_BUDGET = 100_000;
+const GUARD_MAX_DEPTH = 10_000;
+function isPlainObject(e) {
+    return typeof e === "object" && e !== null && !Array.isArray(e);
+}
+function isPrimitiveLiteral(e) {
+    return e === null || typeof e === "string" || (typeof e === "number" && Number.isFinite(e)) || typeof e === "boolean";
+}
+function deriveNode(e, depth, budget) {
+    if (depth <= 0)
+        return { reason: "max_depth" };
+    if (--budget.remaining < 0)
+        return { reason: "max_nodes" };
+    if (!isPlainObject(e))
+        return { reason: "not_object" };
+    for (const key of Object.keys(e))
+        if (!STRICT_KEYWORDS.has(key))
+            return { reason: "unsupported_keyword" };
+    const n = {};
+    if (e.description !== undefined) {
+        if (typeof e.description !== "string")
+            return { reason: "unsupported_keyword" };
+        n.description = e.description;
+    }
+    if (e.title !== undefined) {
+        if (typeof e.title !== "string")
+            return { reason: "unsupported_keyword" };
+        n.title = e.title;
+    }
+    if (e.anyOf !== undefined) {
+        for (const key of Object.keys(e))
+            if (key !== "anyOf" && !ANYOF_SIBLINGS.has(key))
+                return { reason: "unsupported_keyword" };
+        if (!Array.isArray(e.anyOf) || e.anyOf.length === 0)
+            return { reason: "unsupported_keyword" };
+        const branches = [];
+        for (const branch of e.anyOf) {
+            const r = deriveNode(branch, depth - 1, budget);
+            if ("reason" in r)
+                return r;
+            branches.push(r.node);
+        }
+        n.anyOf = branches;
+        return { node: n };
+    }
+    if (e.const !== undefined) {
+        if (!isPrimitiveLiteral(e.const))
+            return { reason: "unsupported_const" };
+        n.const = e.const;
+    }
+    if (e.enum !== undefined) {
+        if (!Array.isArray(e.enum) || e.enum.length === 0 || !e.enum.every(isPrimitiveLiteral) || new Set(e.enum).size !== e.enum.length) {
+            return { reason: "unsupported_enum" };
+        }
+        n.enum = e.enum.slice();
+    }
+    const type = e.type;
+    if (type !== undefined) {
+        if (typeof type === "string") {
+            if (!STRICT_TYPES.has(type))
+                return { reason: "unsupported_type" };
+            n.type = type;
+        }
+        else if (Array.isArray(type)) {
+            if (type.length === 0 ||
+                !type.every((t) => typeof t === "string" && STRICT_TYPES.has(t) && t !== "object" && t !== "array") ||
+                new Set(type).size !== type.length) {
+                return { reason: "unsupported_type" };
+            }
+            n.type = type.slice();
+        }
+        else {
+            return { reason: "unsupported_type" };
+        }
+    }
+    if (type !== "object" && (e.properties !== undefined || e.required !== undefined || e.additionalProperties !== undefined)) {
+        return { reason: "mismatched_keywords" };
+    }
+    if (type !== "array" && e.items !== undefined)
+        return { reason: "mismatched_keywords" };
+    if (type === "object") {
+        const props = e.properties;
+        if (!isPlainObject(props))
+            return { reason: "no_properties" };
+        if (e.additionalProperties !== undefined && e.additionalProperties !== false)
+            return { reason: "additional_properties" };
+        if (e.required !== undefined) {
+            if (!Array.isArray(e.required) ||
+                !e.required.every((r) => typeof r === "string" && Object.hasOwn(props, r)) ||
+                new Set(e.required).size !== e.required.length) {
+                return { reason: "invalid_required" };
+            }
+            n.required = e.required.slice();
+        }
+        const derived = [];
+        for (const [name, sub] of Object.entries(props)) {
+            const r = deriveNode(sub, depth - 1, budget);
+            if ("reason" in r)
+                return r;
+            derived.push([name, r.node]);
+        }
+        n.properties = Object.fromEntries(derived);
+        n.additionalProperties = false;
+    }
+    else if (type === "array") {
+        const items = e.items;
+        if (items === undefined || Array.isArray(items))
+            return { reason: "unsupported_items" };
+        const r = deriveNode(items, depth - 1, budget);
+        if ("reason" in r)
+            return r;
+        n.items = r.node;
+    }
+    else if (type === undefined && n.enum === undefined && !("const" in n)) {
+        return { reason: "missing_type" };
+    }
+    return { node: n };
+}
+export function deriveStrictSchema(schema) {
+    const r = deriveNode(schema, STRICT_MAX_DEPTH, { remaining: STRICT_NODE_BUDGET });
+    if ("reason" in r)
+        return { ok: false, reason: r.reason };
+    if (r.node.type !== "object")
+        return { ok: false, reason: "root_not_object" };
+    return { ok: true, schema: { ...r.node, type: "object" } };
+}
+function exceedsSizeGuard(root) {
+    let n = GUARD_NODE_BUDGET;
+    const stack = [{ value: root, depth: 0 }];
+    while (stack.length > 0) {
+        const { value, depth } = stack.pop();
+        if (--n < 0 || depth > GUARD_MAX_DEPTH)
+            return true;
+        if (typeof value !== "object" || value === null)
+            continue;
+        for (const v of Object.values(value))
+            stack.push({ value: v, depth: depth + 1 });
+    }
+    return false;
+}
+const NUMBER_KEYWORDS = ["minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum", "multipleOf"];
+const NON_NEGATIVE_INT_KEYWORDS = ["minLength", "maxLength", "minItems", "maxItems", "minProperties", "maxProperties"];
+const STRING_KEYWORDS = ["description", "title", "$comment", "$ref", "$id", "$schema", "format", "contentEncoding", "contentMediaType"];
+const SCHEMA_MAP_KEYWORDS = ["properties", "patternProperties", "definitions", "$defs"];
+const SUBSCHEMA_KEYWORDS = ["additionalProperties", "additionalItems", "not", "if", "then", "else", "contains", "propertyNames"];
+const SCHEMA_ARRAY_KEYWORDS = ["anyOf", "oneOf", "allOf"];
+function checkSchemaShape(node, path) {
+    if (typeof node === "boolean")
+        return null;
+    if (!isPlainObject(node))
+        return `${path}: schema must be an object or boolean`;
+    const e = node;
+    if (e.type !== undefined) {
+        if (typeof e.type === "string") {
+            if (!STRICT_TYPES.has(e.type))
+                return `${path}/type: "${String(e.type)}" is not a valid JSON Schema type`;
+        }
+        else if (Array.isArray(e.type)) {
+            if (e.type.length === 0 || !e.type.every((t) => typeof t === "string" && STRICT_TYPES.has(t))) {
+                return `${path}/type: must be a non-empty array of valid JSON Schema types`;
+            }
+            if (new Set(e.type).size !== e.type.length)
+                return `${path}/type: duplicate entries`;
+        }
+        else {
+            return `${path}/type: must be a string or an array of strings`;
+        }
+    }
+    if (e.enum !== undefined && !Array.isArray(e.enum))
+        return `${path}/enum: must be an array`;
+    if (e.required !== undefined) {
+        if (!Array.isArray(e.required) || !e.required.every((r) => typeof r === "string")) {
+            return `${path}/required: must be an array of strings`;
+        }
+        if (new Set(e.required).size !== e.required.length)
+            return `${path}/required: duplicate entries`;
+    }
+    if (e.uniqueItems !== undefined && typeof e.uniqueItems !== "boolean")
+        return `${path}/uniqueItems: must be a boolean`;
+    if (e.pattern !== undefined) {
+        if (typeof e.pattern !== "string")
+            return `${path}/pattern: must be a string`;
+        try {
+            new RegExp(e.pattern, "u");
+        }
+        catch {
+            try {
+                new RegExp(e.pattern);
+            }
+            catch {
+                return `${path}/pattern: invalid regular expression`;
+            }
+        }
+    }
+    for (const k of NUMBER_KEYWORDS) {
+        if (e[k] !== undefined && (typeof e[k] !== "number" || !Number.isFinite(e[k])))
+            return `${path}/${k}: must be a number`;
+    }
+    if (typeof e.multipleOf === "number" && e.multipleOf <= 0)
+        return `${path}/multipleOf: must be > 0`;
+    for (const k of NON_NEGATIVE_INT_KEYWORDS) {
+        const v = e[k];
+        if (v !== undefined && (typeof v !== "number" || !Number.isInteger(v) || v < 0)) {
+            return `${path}/${k}: must be a non-negative integer`;
+        }
+    }
+    for (const k of STRING_KEYWORDS) {
+        if (e[k] !== undefined && typeof e[k] !== "string")
+            return `${path}/${k}: must be a string`;
+    }
+    for (const k of SCHEMA_MAP_KEYWORDS) {
+        const v = e[k];
+        if (v === undefined)
+            continue;
+        if (!isPlainObject(v))
+            return `${path}/${k}: must be an object mapping names to schemas`;
+        for (const [name, sub] of Object.entries(v)) {
+            const err = checkSchemaShape(sub, `${path}/${k}/${name}`);
+            if (err)
+                return err;
+        }
+    }
+    if (e.items !== undefined) {
+        if (Array.isArray(e.items)) {
+            for (let i = 0; i < e.items.length; i++) {
+                const err = checkSchemaShape(e.items[i], `${path}/items/${i}`);
+                if (err)
+                    return err;
+            }
+        }
+        else {
+            const err = checkSchemaShape(e.items, `${path}/items`);
+            if (err)
+                return err;
+        }
+    }
+    for (const k of SUBSCHEMA_KEYWORDS) {
+        if (e[k] !== undefined) {
+            const err = checkSchemaShape(e[k], `${path}/${k}`);
+            if (err)
+                return err;
+        }
+    }
+    for (const k of SCHEMA_ARRAY_KEYWORDS) {
+        const v = e[k];
+        if (v === undefined)
+            continue;
+        if (!Array.isArray(v) || v.length === 0)
+            return `${path}/${k}: must be a non-empty array of schemas`;
+        for (let i = 0; i < v.length; i++) {
+            const err = checkSchemaShape(v[i], `${path}/${k}/${i}`);
+            if (err)
+                return err;
+        }
+    }
+    return null;
+}
+export function validateJsonSchemaShape(schema) {
+    if (exceedsSizeGuard(schema))
+        return "schema too large";
+    return checkSchemaShape(schema, "root");
+}
+const compileMemo = new WeakMap();
+export function compileOutputSchema(schema) {
+    const cached = typeof schema === "object" && schema !== null ? compileMemo.get(schema) : undefined;
+    if (cached)
+        return cached;
+    const result = compileUncached(schema);
+    if (typeof schema === "object" && schema !== null)
+        compileMemo.set(schema, result);
+    return result;
+}
+function compileUncached(schema) {
+    const invalid = validateJsonSchemaShape(schema);
+    if (invalid !== null)
+        return { error: invalid };
+    try {
+        const derived = deriveStrictSchema(schema);
+        if (derived.ok)
+            return { modelSchema: derived.schema, strict: true };
+        return { modelSchema: schema, strict: false, fallbackReason: derived.reason };
+    }
+    catch (err) {
+        return { modelSchema: schema, strict: false, fallbackReason: `derivation_error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+//# sourceMappingURL=strict-output-schema.js.map

package/dist/core/runner/strict-output-schema.js.map

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

package/dist/core/runner/synthetic-tools.d.ts

@@ -0,0 +1,30 @@
+import { type TSchema } from "typebox";
+import type { AgentTool } from "../../internal/harness.js";
+import type { SkillManifest } from "../types.js";
+import type { ActiveSkillScope } from "./active-skill-scope.js";
+export declare const OUTPUT_TOOL_NAME = "StructuredOutput";
+export declare const REPORT_BLOCKED_TOOL_NAME = "ReportBlocked";
+export declare const OUTPUT_DEFAULT_RETRIES = 2;
+export declare function resolveOutputRetries(outputRetries?: number): number;
+export interface BlockedRef {
+    reason?: string;
+}
+export interface OutputRef {
+    value?: unknown;
+    set?: boolean;
+}
+export declare function makeOutputTool(ref: OutputRef, schema: TSchema, strictSchema?: TSchema): AgentTool;
+export declare function makeReportBlockedTool(ref: BlockedRef): AgentTool;
+export declare const SKILL_TOOL_NAME = "Skill";
+export declare const SKILL_BODY_MAX_CHARS = 20000;
+interface SkillLike {
+    name: string;
+    description: string;
+    content: string;
+    manifest?: SkillManifest;
+}
+export declare function normalizeSkills(skills: SkillLike[] | undefined): SkillLike[];
+export declare function buildSkillsBlock(skills: SkillLike[]): string | undefined;
+export declare function makeSkillTool(skills: SkillLike[], scope?: ActiveSkillScope): AgentTool;
+export {};
+//# sourceMappingURL=synthetic-tools.d.ts.map

package/dist/core/runner/synthetic-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-tools.d.ts","sourceRoot":"","sources":["../../../src/core/runner/synthetic-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAExD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAQxC,wBAAgB,oBAAoB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAUD,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAkBjG;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,CAchE;AAeD,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAM3C,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAGhB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAID,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAU5E;AAGD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,GAAG,SAAS,CAmCxE;AAiBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAwDtF"}

package/dist/core/runner/synthetic-tools.js

@@ -0,0 +1,124 @@
+import { Type } from "typebox";
+import { defineTool } from "../tools.js";
+export const OUTPUT_TOOL_NAME = "StructuredOutput";
+export const REPORT_BLOCKED_TOOL_NAME = "ReportBlocked";
+export const OUTPUT_DEFAULT_RETRIES = 2;
+export function resolveOutputRetries(outputRetries) {
+    if (outputRetries === undefined)
+        return OUTPUT_DEFAULT_RETRIES;
+    if (!Number.isFinite(outputRetries) || outputRetries < 0)
+        return OUTPUT_DEFAULT_RETRIES;
+    return Math.floor(outputRetries);
+}
+export function makeOutputTool(ref, schema, strictSchema) {
+    return defineTool({
+        name: OUTPUT_TOOL_NAME,
+        description: "Call this to submit your FINAL result as a JSON object matching the required schema. The arguments " +
+            "ARE the result. Calling this ends the task. Do this once you have the answer (use other tools first if needed).",
+        effect: "read",
+        parameters: strictSchema ?? schema,
+        execute: (args) => {
+            ref.value = args;
+            ref.set = true;
+            return { content: "Output recorded. Task complete.", terminate: true };
+        },
+    });
+}
+export function makeReportBlockedTool(ref) {
+    return defineTool({
+        name: REPORT_BLOCKED_TOOL_NAME,
+        description: "Call this ONLY when you cannot complete the task — missing information, missing permission/credentials, or an ambiguous request you cannot resolve. Provide a concise reason that an external system or operator can act on. Calling this ends the task.",
+        effect: "read",
+        parameters: Type.Object({ reason: Type.String() }),
+        execute: (args) => {
+            ref.reason = String(args.reason ?? "").trim() || "blocked";
+            return { content: "Acknowledged. Task will end as blocked.", terminate: true };
+        },
+    });
+}
+export const SKILL_TOOL_NAME = "Skill";
+export const SKILL_BODY_MAX_CHARS = 20_000;
+const SKILL_DESC_MAX_CHARS = 1_000;
+const SKILLS_BLOCK_MAX_CHARS = 8_000;
+export function normalizeSkills(skills) {
+    const seen = new Set();
+    const out = [];
+    for (const s of skills ?? []) {
+        if (!seen.has(s.name)) {
+            seen.add(s.name);
+            out.push(s);
+        }
+    }
+    return out.toSorted((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+}
+export function buildSkillsBlock(skills) {
+    if (skills.length === 0)
+        return undefined;
+    const lines = [];
+    let used = 0;
+    let nameOnly = false;
+    for (const s of skills) {
+        if (nameOnly) {
+            lines.push(`- ${s.name}`);
+            continue;
+        }
+        const desc = s.description.length > SKILL_DESC_MAX_CHARS
+            ? `${s.description.slice(0, SKILL_DESC_MAX_CHARS)}…[description truncated]`
+            : s.description;
+        const line = `- ${s.name}: ${desc}`;
+        if (used + line.length > SKILLS_BLOCK_MAX_CHARS) {
+            nameOnly = true;
+            lines.push("(block size cap reached — remaining skills listed name-only; descriptions via the tool)");
+            lines.push(`- ${s.name}`);
+            continue;
+        }
+        used += line.length;
+        lines.push(line);
+    }
+    return [
+        "<skills>",
+        `The following skills are available for this task. A skill is a named package of instructions;`,
+        `only its name and description are shown here. BEFORE doing work a skill covers, load its full`,
+        `instructions by calling the \`${SKILL_TOOL_NAME}\` tool with \`skill: "<name>"\` (plus optional \`args\`).`,
+        "",
+        ...lines,
+        "</skills>",
+    ].join("\n");
+}
+export function makeSkillTool(skills, scope) {
+    const byName = new Map(skills.map((s) => [s.name, s]));
+    const names = skills.map((s) => s.name).join(", ");
+    return defineTool({
+        name: SKILL_TOOL_NAME,
+        description: `Load a skill's full instructions. Call this BEFORE doing work the skill covers. ` +
+            `Invoke with the skill name and optional arguments, e.g. \`skill: "commit", args: "-m 'Fix bug'"\`. ` +
+            `When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task. ` +
+            `NEVER mention a skill without actually calling this tool. ` +
+            `Available skills: ${names}.`,
+        parameters: Type.Object({
+            skill: Type.Optional(Type.String({ description: 'The skill name. E.g., "commit", "review-pr", or "pdf"' })),
+            args: Type.Optional(Type.String({ description: "Optional arguments for the skill" })),
+        }),
+        effect: "read",
+        execute: (rawArgs) => {
+            const a = (rawArgs ?? {});
+            const name = String(a.skill ?? a.name ?? "");
+            const skill = byName.get(name);
+            if (!skill) {
+                throw new Error(`Unknown skill "${name}". Available skills: ${names}.`);
+            }
+            if (scope && skill.manifest) {
+                scope.push({ kind: "manifest", manifest: skill.manifest });
+            }
+            let body = skill.content;
+            if (body.length > SKILL_BODY_MAX_CHARS) {
+                body =
+                    body.slice(0, SKILL_BODY_MAX_CHARS) +
+                        `\n\n[skill body truncated: showing the first ${SKILL_BODY_MAX_CHARS} of ${body.length} chars]`;
+            }
+            const skillArgs = typeof a.args === "string" && a.args.length > 0 ? a.args.slice(0, 10_000) : undefined;
+            return skillArgs ? `${body}\n\n## Input\n${skillArgs}` : body;
+        },
+    });
+}
+//# sourceMappingURL=synthetic-tools.js.map

package/dist/core/runner/synthetic-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-tools.js","sourceRoot":"","sources":["../../../src/core/runner/synthetic-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAEnD,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAQxC,MAAM,UAAU,oBAAoB,CAAC,aAAsB;IACzD,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC;QAAE,OAAO,sBAAsB,CAAC;IACxF,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC;AAqBD,MAAM,UAAU,cAAc,CAAC,GAAc,EAAE,MAAe,EAAE,YAAsB;IACpF,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,qGAAqG;YACrG,iHAAiH;QAGnH,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,YAAY,IAAI,MAAM;QAClC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAGhB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;YACjB,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,iCAAiC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACzE,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAe;IACnD,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,0PAA0P;QAG5P,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAClD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAE,IAA6B,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,yCAAyC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACjF,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAeD,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE3C,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAarC,MAAM,UAAU,eAAe,CAAC,MAA+B;IAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAGD,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GACR,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,oBAAoB;YACzC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,0BAA0B;YAC3E,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACpC,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;YAGhD,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;YACtG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO;QACL,UAAU;QACV,+FAA+F;QAC/F,+FAA+F;QAC/F,iCAAiC,eAAe,4DAA4D;QAC5G,EAAE;QACF,GAAG,KAAK;QACR,WAAW;KACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAiBD,MAAM,UAAU,aAAa,CAAC,MAAmB,EAAE,KAAwB;IACzE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,eAAe;QAIrB,WAAW,EACT,kFAAkF;YAClF,qGAAqG;YACrG,+JAA+J;YAC/J,4DAA4D;YAC5D,qBAAqB,KAAK,GAAG;QAM/B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;YACtB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,uDAAuD,EAAE,CAAC,CAAC;YAC3G,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC,CAAC;SACtF,CAAC;QACF,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAwD,CAAC;YAEjF,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;gBAEX,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,wBAAwB,KAAK,GAAG,CAAC,CAAC;YAC1E,CAAC;YAKD,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;gBACvC,IAAI;oBACF,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC;wBACnC,gDAAgD,oBAAoB,OAAO,IAAI,CAAC,MAAM,SAAS,CAAC;YACpG,CAAC;YAOD,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACxG,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,iBAAiB,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/core/runner/tool-disclosure.d.ts

@@ -0,0 +1,46 @@
+import type { AgentMessage, AgentTool } from "../../internal/harness.js";
+import type { Model } from "../../internal/llm.js";
+import type { ToolSpec } from "../types.js";
+export declare const TOOL_SEARCH_NAME = "ToolSearch";
+export declare const TOOL_SEARCH_DEFAULT_MAX_RESULTS = 5;
+export interface DeferredToolInfo {
+    name: string;
+    hint: string;
+    description: string;
+}
+export declare function deferHint(description: string, max?: number): string;
+export declare function safeName(name: string): string;
+export declare function classifyDeferred(opts: {
+    specs: ReadonlyArray<ToolSpec>;
+    mcpToolNames: ReadonlyArray<string>;
+    fullTools: ReadonlyArray<{
+        name: string;
+        description: string;
+        parameters: unknown;
+    }>;
+    deferMode?: "auto";
+    model: Model;
+}): Set<string>;
+export declare function buildDeferredRegistry(deferred: ReadonlySet<string>, tools: ReadonlyArray<{
+    name: string;
+    description: string;
+}>): Map<string, DeferredToolInfo>;
+export declare function makePlaceholderTool(info: DeferredToolInfo): AgentTool;
+export declare function scoreToolMatch(query: string, info: DeferredToolInfo): number;
+export interface ToolSearchArgs {
+    query?: string;
+    max_results?: number;
+    select?: string[];
+}
+export declare function resolveToolSearchDetailed(args: ToolSearchArgs, registry: ReadonlyMap<string, DeferredToolInfo>): {
+    matched: string[];
+    missing: string[];
+};
+export declare function resolveToolSearch(args: ToolSearchArgs, registry: ReadonlyMap<string, DeferredToolInfo>): string[];
+export declare function extractDiscoveredToolNames(messages: ReadonlyArray<AgentMessage>, registry: ReadonlyMap<string, DeferredToolInfo>): string[];
+export declare function makeToolSearchTool(opts: {
+    registry: ReadonlyMap<string, DeferredToolInfo>;
+    active: Set<string>;
+    rematerialize: (active: ReadonlySet<string>) => Promise<void>;
+}): AgentTool;
+//# sourceMappingURL=tool-disclosure.d.ts.map

package/dist/core/runner/tool-disclosure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-disclosure.d.ts","sourceRoot":"","sources":["../../../src/core/runner/tool-disclosure.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgB5C,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAO7C,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAKjD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,MAAM,CAGhE;AAYD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7C;AAoBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC/B,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,SAAS,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;CACd,GAAG,GAAG,CAAC,MAAM,CAAC,CAiBd;AAGD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAM/B;AAGD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAcrE;AAGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAW5E;AAMD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAuBD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC9C;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA0C1C;AAID,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC9C,MAAM,EAAE,CAEV;AAYD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EACrC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC9C,MAAM,EAAE,CAaV;AAQD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,aAAa,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,GAAG,SAAS,CAyFZ"}