@sema-agent/core 1.279.0

package/dist/core/runner/tool-disclosure.js

@@ -0,0 +1,220 @@
+import { Type } from "typebox";
+import { defineTool } from "../tools.js";
+export const TOOL_SEARCH_NAME = "ToolSearch";
+const DEFER_AUTO_FRACTION = 0.1;
+const CHARS_PER_TOKEN = 4;
+export const TOOL_SEARCH_DEFAULT_MAX_RESULTS = 5;
+const MAX_QUERY_RESULTS = 25;
+const EMPTY_PARAMS = Type.Object({});
+export function deferHint(description, max = 120) {
+    const first = (description.split("\n").find((l) => l.trim() !== "") ?? "").trim();
+    return first.length > max ? `${first.slice(0, max - 1)}…` : first;
+}
+export function safeName(name) {
+    return name.replace(/[\x00-\x1f<>"`]/g, "");
+}
+function inlinedChars(t) {
+    let schema = "";
+    try {
+        schema = JSON.stringify(t.parameters) ?? "";
+    }
+    catch {
+        schema = "";
+    }
+    return t.description.length + schema.length;
+}
+export function classifyDeferred(opts) {
+    const deferred = new Set();
+    for (const s of opts.specs) {
+        if (s.defer === true)
+            deferred.add(s.name);
+    }
+    for (const name of opts.mcpToolNames)
+        deferred.add(name);
+    if (opts.deferMode === "auto") {
+        const candidates = opts.fullTools.filter((t) => !deferred.has(t.name));
+        const total = candidates.reduce((n, t) => n + inlinedChars(t), 0);
+        const window = (opts.model.contextTokens ?? opts.model.contextWindow ?? 0) * CHARS_PER_TOKEN;
+        if (window > 0 && total > DEFER_AUTO_FRACTION * window) {
+            for (const t of candidates)
+                deferred.add(t.name);
+        }
+    }
+    return deferred;
+}
+export function buildDeferredRegistry(deferred, tools) {
+    const reg = new Map();
+    for (const t of tools) {
+        if (deferred.has(t.name))
+            reg.set(t.name, { name: t.name, hint: deferHint(t.description), description: t.description });
+    }
+    return reg;
+}
+export function makePlaceholderTool(info) {
+    const sn = safeName(info.name);
+    return defineTool({
+        name: info.name,
+        description: `${info.hint} — deferred: call ${TOOL_SEARCH_NAME}({"query":"select:${sn}"}) to load its parameters before use.`,
+        parameters: EMPTY_PARAMS,
+        effect: "read",
+        execute: () => `Tool "${sn}" is not active yet. Call ${TOOL_SEARCH_NAME} with {"query":"select:${sn}"} ` +
+            `(or a keyword \`query\`) to load its full schema, then call ${sn} with the proper arguments.`,
+    });
+}
+export function scoreToolMatch(query, info) {
+    const tokens = query.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length > 1);
+    if (tokens.length === 0)
+        return 0;
+    const name = info.name.toLowerCase();
+    const body = `${info.hint} ${info.description}`.toLowerCase();
+    let score = 0;
+    for (const tok of tokens) {
+        if (name.includes(tok))
+            score += 3;
+        if (body.includes(tok))
+            score += 1;
+    }
+    return score;
+}
+function clampMaxResults(n) {
+    if (n === undefined || typeof n !== "number" || !Number.isFinite(n))
+        return TOOL_SEARCH_DEFAULT_MAX_RESULTS;
+    const floored = Math.floor(n);
+    if (floored < 1)
+        return TOOL_SEARCH_DEFAULT_MAX_RESULTS;
+    return Math.min(floored, MAX_QUERY_RESULTS);
+}
+export function resolveToolSearchDetailed(args, registry) {
+    const out = [];
+    const seen = new Set();
+    const missing = [];
+    const add = (name) => {
+        if (!seen.has(name) && registry.has(name)) {
+            seen.add(name);
+            out.push(name);
+        }
+    };
+    for (const name of args.select ?? [])
+        add(name);
+    const q = typeof args.query === "string" ? args.query.trim() : "";
+    if (q !== "") {
+        const selectMatch = /^select:(.+)$/i.exec(q);
+        if (selectMatch) {
+            for (const raw of selectMatch[1].split(",")) {
+                const name = raw.trim();
+                if (name === "")
+                    continue;
+                if (registry.has(name))
+                    add(name);
+                else if (!missing.includes(name))
+                    missing.push(name);
+            }
+            return { matched: out, missing };
+        }
+        const qLower = q.toLowerCase();
+        for (const name of registry.keys()) {
+            if (name.toLowerCase() === qLower) {
+                add(name);
+                return { matched: out, missing };
+            }
+        }
+        const scored = [];
+        for (const info of registry.values()) {
+            const score = scoreToolMatch(q, info);
+            if (score > 0)
+                scored.push({ name: info.name, score });
+        }
+        scored.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
+        for (const { name } of scored.slice(0, clampMaxResults(args.max_results)))
+            add(name);
+    }
+    return { matched: out, missing };
+}
+export function resolveToolSearch(args, registry) {
+    return resolveToolSearchDetailed(args, registry).matched;
+}
+export function extractDiscoveredToolNames(messages, registry) {
+    const names = new Set();
+    for (const m of messages) {
+        if (m.role !== "assistant")
+            continue;
+        for (const part of m.content) {
+            if (part.type === "toolCall" && part.name === TOOL_SEARCH_NAME) {
+                for (const n of resolveToolSearch(part.arguments, registry)) {
+                    names.add(n);
+                }
+            }
+        }
+    }
+    return [...names];
+}
+export function makeToolSearchTool(opts) {
+    const { registry, active, rematerialize } = opts;
+    return defineTool({
+        name: TOOL_SEARCH_NAME,
+        description: "Discover and activate deferred tools. Most tools start as name-only placeholders to keep requests " +
+            "small; to USE one you must activate it here first. Query forms: " +
+            '"select:ToolA,ToolB" — activate these exact tools by name; ' +
+            '"notebook jupyter" — keyword search, up to max_results best matches; ' +
+            "a bare tool name — activates that tool directly. " +
+            "Activated tools become callable with their full parameters on your next turn.",
+        parameters: Type.Object({
+            query: Type.Optional(Type.String({
+                description: 'Query to find deferred tools. Use "select:<tool_name>" for direct selection, or keywords to search.',
+            })),
+            max_results: Type.Optional(Type.Number({ description: "Maximum number of results to return (default: 5)" })),
+        }),
+        effect: "read",
+        execute: async (raw) => {
+            const args = (raw ?? {});
+            const { matched, missing } = resolveToolSearchDetailed(args, registry);
+            const missingNote = missing.length > 0
+                ? `\nNot found: ${missing.map((n) => safeName(n)).join(", ")} — no deferred tool has this exact name. ` +
+                    "(Already-active and non-deferred tools are callable directly and don't appear here.)"
+                : "";
+            if (matched.length === 0) {
+                return {
+                    content: 'No deferred tools matched. Use query "select:<tool_name>" (comma-separate several names) for exact ' +
+                        "selection, or try different keywords. " +
+                        "(Already-active and non-deferred tools are callable directly and don't appear here.)" +
+                        missingNote,
+                    details: {
+                        type: "tool-search",
+                        matched: [],
+                        activated: [],
+                        matches: [],
+                        query: typeof args.query === "string" ? args.query : "",
+                        total_deferred_tools: registry.size,
+                        ...(missing.length > 0 ? { missing: missing.map(safeName) } : {}),
+                    },
+                };
+            }
+            const newly = matched.filter((n) => !active.has(n));
+            for (const n of newly)
+                active.add(n);
+            if (newly.length > 0)
+                await rematerialize(active);
+            const lines = matched.map((n) => {
+                const info = registry.get(n);
+                const tag = newly.includes(n) ? "activated" : "already active";
+                return `- ${safeName(n)} (${tag})${info ? ` — ${info.hint}` : ""}`;
+            });
+            const head = newly.length > 0
+                ? `Activated ${newly.length} tool(s); they are now available with full parameters — call them directly:`
+                : "These tools are already active — call them directly:";
+            return {
+                content: `${head}\n${lines.join("\n")}${missingNote}`,
+                details: {
+                    type: "tool-search",
+                    matched: matched.map(safeName),
+                    activated: newly.map(safeName),
+                    matches: matched.map(safeName),
+                    query: typeof args.query === "string" ? args.query : "",
+                    total_deferred_tools: registry.size,
+                    ...(missing.length > 0 ? { missing: missing.map(safeName) } : {}),
+                },
+            };
+        },
+    });
+}
+//# sourceMappingURL=tool-disclosure.js.map

package/dist/core/runner/tool-disclosure.js.map

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

package/dist/core/runner/turn-attachments.d.ts

@@ -0,0 +1,110 @@
+export declare const TODO_REMINDER_CONFIG: {
+    readonly TURNS_SINCE_WRITE: 10;
+    readonly TURNS_BETWEEN_REMINDERS: 10;
+};
+export declare const PLAN_MODE_ATTACHMENT_CONFIG: {
+    readonly TURNS_BETWEEN_ATTACHMENTS: 5;
+    readonly FULL_REMINDER_EVERY_N_ATTACHMENTS: 5;
+};
+export declare const CHANGED_FILES_MAX = 20;
+export declare const CHANGED_FILES_MTIME_EPS_MS = 2000;
+export declare const ATTACHMENT_BYTE_CAP: number;
+export type AttachmentSource = "todo_reminder" | "task_reminder" | "changed_files" | "plan_mode" | "budget_usd" | "background_tasks" | "tools_delta" | "agent_listing" | "mcp_instructions";
+export interface AgentListingEntry {
+    name: string;
+    description: string;
+    tools?: string;
+}
+export interface BackgroundTaskSnapshot {
+    id: string;
+    description?: string;
+    status: string;
+}
+export interface TurnAttachment {
+    source: AttachmentSource;
+    body: string;
+}
+export interface ListProjection {
+    statusCounts: Record<string, number>;
+    items: Array<{
+        content: string;
+        status: string;
+    }>;
+}
+export interface AttachmentState {
+    todo?: ListProjection;
+    taskItems?: Map<string, {
+        content: string;
+        status: string;
+    }>;
+    taskLastWriteTurn?: number;
+    todoLastWriteTurn?: number;
+    lastTodoReminderTurn: number;
+    lastTaskReminderTurn: number;
+    planAttachmentCount: number;
+    lastPlanReminderTurn: number;
+    surfacedMtime: Map<string, number>;
+    postCompactPending: boolean;
+    announcedAgentTypes?: Map<string, string>;
+}
+export declare function createAttachmentState(): AttachmentState;
+export declare function reduceToolEnd(state: AttachmentState, details: unknown): void;
+export type WriteFamily = "todo" | "task";
+export declare function stampWriteAnchor(state: AttachmentState, family: WriteFamily, clock: number): void;
+export declare function advanceCadenceClock(state: AttachmentState, clock: number, content: unknown, writeFamilyOf: (toolName: string) => WriteFamily | undefined): number;
+export declare function rebaseCadenceWindows(state: AttachmentState, clock: number): void;
+export interface AttachmentInputs {
+    turn: number;
+    cadenceTurn?: number;
+    todoMounted: boolean;
+    taskListMounted: boolean;
+    planActive: boolean;
+    budgetUsd?: {
+        used: number;
+        total: number;
+    };
+    config: {
+        todoReminder: boolean;
+        todoReminderMode?: "baseline" | "off";
+        changedFiles: boolean;
+        planModeReminder: boolean;
+        budgetUsd?: boolean;
+        backgroundTasks?: boolean;
+        toolsDelta?: boolean;
+        agentListing?: boolean;
+        mcpInstructions?: boolean;
+    };
+    changedFiles?: ReadonlyArray<{
+        path: string;
+        mtimeMs: number;
+    }>;
+    backgroundTasks?: ReadonlyArray<BackgroundTaskSnapshot>;
+    newTools?: readonly string[];
+    agentListing?: ReadonlyArray<AgentListingEntry>;
+    agentToolName?: string;
+    mcpInstructions?: {
+        added: ReadonlyArray<{
+            server: string;
+            text: string;
+        }>;
+        removed: readonly string[];
+    };
+}
+export declare function collectDueAttachments(state: AttachmentState, inp: AttachmentInputs): readonly TurnAttachment[];
+export declare function renderBudgetUsd(used: number, total: number): string;
+export declare function renderOrphanedBackgroundTasks(tasks: ReadonlyArray<{
+    id: string;
+    description?: string;
+}>): string;
+export declare function renderToolsDelta(names: readonly string[]): string;
+export declare const AGENT_CONCURRENCY_NOTE = "When you launch multiple agents for independent work, send them in a single message with multiple tool uses so they run concurrently.";
+export declare const AMBIENT_CONTEXT_NOTE = "This is ambient context \u2014 do not narrate it to the user unless they ask or it is directly relevant to their request.";
+export declare function agentListingInitialHeader(toolName: string): string;
+export declare function agentListingDeltaHeader(toolName: string): string;
+export declare function renderAgentListingDelta(state: AttachmentState, entries: ReadonlyArray<AgentListingEntry>, toolName: string): string | undefined;
+export declare function commitAgentListing(state: AttachmentState, entries: ReadonlyArray<AgentListingEntry>): void;
+export declare function renderMcpInstructionsDelta(added: ReadonlyArray<{
+    server: string;
+    text: string;
+}>, removed: readonly string[]): string | undefined;
+//# sourceMappingURL=turn-attachments.d.ts.map

package/dist/core/runner/turn-attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-attachments.d.ts","sourceRoot":"","sources":["../../../src/core/runner/turn-attachments.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AACX,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAGX,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAOpC,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAG/C,eAAO,MAAM,mBAAmB,QAAW,CAAC;AAO5C,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,eAAe,GACf,eAAe,GACf,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,aAAa,GACb,eAAe,GACf,kBAAkB,CAAC;AAIvB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IAKpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,MAAM,WAAW,cAAc;IAE7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAOD,MAAM,WAAW,eAAe;IAG9B,IAAI,CAAC,EAAE,cAAc,CAAC;IAGtB,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAO7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAG7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAG7B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAMnC,kBAAkB,EAAE,OAAO,CAAC;IAQ5B,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CASvD;AAsBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA0D5E;AAID,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAS1C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGjG;AA4BD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,GAC3D,MAAM,CAaR;AAcD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKhF;AAQD,MAAM,WAAW,gBAAgB;IAE/B,IAAI,EAAE,MAAM,CAAC;IAUb,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,WAAW,EAAE,OAAO,CAAC;IAErB,eAAe,EAAE,OAAO,CAAC;IAIzB,UAAU,EAAE,OAAO,CAAC;IAOpB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE;QACN,YAAY,EAAE,OAAO,CAAC;QAOtB,gBAAgB,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;QACtC,YAAY,EAAE,OAAO,CAAC;QACtB,gBAAgB,EAAE,OAAO,CAAC;QAQ1B,SAAS,CAAC,EAAE,OAAO,CAAC;QAEpB,eAAe,CAAC,EAAE,OAAO,CAAC;QAE1B,UAAU,CAAC,EAAE,OAAO,CAAC;QAErB,YAAY,CAAC,EAAE,OAAO,CAAC;QAEvB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IAGF,YAAY,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAGhE,eAAe,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAKxD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAI7B,YAAY,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAGhD,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,eAAe,CAAC,EAAE;QAAE,KAAK,EAAE,aAAa,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CAC1G;AAkBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,GAAG,SAAS,cAAc,EAAE,CAiH9G;AAmDD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAWD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAMhH;AAsDD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMjE;AAGD,eAAO,MAAM,sBAAsB,0IACsG,CAAC;AAM1I,eAAO,MAAM,oBAAoB,8HACuF,CAAC;AAIzH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElE;AAGD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE;AAmBD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,EACzC,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAwBpB;AASD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAE1G;AAcD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACtD,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,GAAG,SAAS,CAcpB"}