@a5c-ai/agent-core 5.0.1-staging.ff407b73 → 5.0.1-staging.ffad3b46492e

package/README.md

@@ -5,16 +5,16 @@ Built-in programmatic session wrapper and agentic tool surface for Babysitter ru
 <!-- docs-status:start -->
 > Status: Public advanced/runtime package.
 > Canonical docs home: [Package and Plugin Docs Map](../../docs/package-and-plugin-map.md).
-> This README defines the package contract for runtime consumers and published dependents such as `@a5c-ai/babysitter-agent`.
+> This README defines the package contract for runtime consumers and published dependents such as `@a5c-ai/agent-platform`.
 <!-- docs-status:end -->
 
 ## Package role
 
-`@a5c-ai/agent-core` sits between `@a5c-ai/babysitter-agent`, `@a5c-ai/agent-mux`, and `@a5c-ai/babysitter-sdk`:
+`@a5c-ai/agent-core` sits between `@a5c-ai/agent-platform`, `@a5c-ai/agent-mux`, and `@a5c-ai/babysitter-sdk`:
 
 - `createAgentCoreSession()` wraps an `@a5c-ai/agent-mux` client for in-process prompt execution.
 - `createAgentCoreToolDefinitions()` assembles the built-in Babysitter-flavored tool surface that host runtimes can inject into planning, resume, or delegated-task flows.
-- `@a5c-ai/babysitter-agent` re-exports these APIs from `src/harness/index.ts`, uses `createAgentCoreSession()` for direct `agent-core` harness invocation in `src/harness/invoker.ts`, and injects tool definitions into plan-process and resume-run flows.
+- `@a5c-ai/agent-platform` re-exports these APIs from `src/harness/index.ts`, uses `createAgentCoreSession()` for direct `agent-core` harness invocation in `src/harness/invoker.ts`, and injects tool definitions into plan-process and resume-run flows.
 - `@a5c-ai/babysitter-sdk` still owns run directories, journals, task/effect lifecycle, and config defaults. `agent-core` does not replace the SDK orchestration layer.
 
 This package is published as a runtime dependency surface for higher-level Babysitter runtimes. It is still an advanced/operator-facing building block rather than the primary entrypoint for new users.
@@ -98,7 +98,7 @@ These fields remain on `AgentCoreSessionOptions` for compatibility, but the curr
 
 | Option | Status | Migration note |
 | --- | --- | --- |
-| `toolsMode` | Deprecated, ignored by agent-core | Use backend-native configuration, or the PI wrapper in `@a5c-ai/babysitter-agent`, if you still need tool-surface control. |
+| `toolsMode` | Deprecated, ignored by agent-core | Use backend-native configuration, or the PI wrapper in `@a5c-ai/agent-platform`, if you still need tool-surface control. |
 | `customTools` | Deprecated, ignored by agent-core | Register host-side tools with `createAgentCoreToolDefinitions()` or use the PI wrapper for runtime custom-tool injection. |
 | `isolated` | Deprecated, ignored by agent-core | Use the PI wrapper if you still need extension/skills isolation controls. |
 | `ephemeral` | Deprecated, ignored by agent-core | Session persistence is determined by the selected agent-mux backend. |
@@ -106,7 +106,7 @@ These fields remain on `AgentCoreSessionOptions` for compatibility, but the curr
 | `enableCompaction` | Deprecated, ignored by agent-core | Compaction behavior belongs to the selected backend/runtime. |
 | `agentDir` | Deprecated, ignored by agent-core | Configure agent directories through the target backend instead. |
 
-If you still need the PI-era controls above, use the PI wrapper exposed from `@a5c-ai/babysitter-agent` rather than `@a5c-ai/agent-core`.
+If you still need the PI-era controls above, use the PI wrapper exposed from `@a5c-ai/agent-platform` rather than `@a5c-ai/agent-core`.
 
 ## Tool-definition API
 
@@ -118,6 +118,7 @@ If you still need the PI-era controls above, use the PI wrapper exposed from `@a
 - delegation tools: `AskUserQuestion`, `task`, `skill`
 - code tools: `calc`, `ast_grep`, `ast_edit`, `render_mermaid`, `notebook`
 - background/discovery/web tools: `background_status`, `background_list`, `tool_search`, `tool_fetch`, `web_search`, `fetch_process`
+- optional programmatic tool calling: `code_executor` when `programmaticToolCalling` is enabled
 
 `AgentCoreToolOptions` controls how those definitions are wired into a host runtime:
 
@@ -127,6 +128,18 @@ If you still need the PI-era controls above, use the PI wrapper exposed from `@a
 - `onToolUse`: observer callback fired after tool wrapping.
 - `onBackgroundComplete`, `maxBackgroundProcesses`, `backgroundRegistry`: background-process lifecycle hooks and limits.
 - `deferredToolRegistry`: enables `tool_search` and `tool_fetch`.
+- `programmaticToolCalling`: opt-in Code Mode / Programmatic Tool Calling surface. When enabled, `code_executor` runs a bounded JavaScript async body with `tools.<name>(params)` and `callTool(name, params)` helpers for batching existing agent-core tools behind one model-level tool call.
+
+Example:
+
+```ts
+const tools = createAgentCoreToolDefinitions({
+  workspace: process.cwd(),
+  interactive: false,
+  deferredToolRegistry,
+  programmaticToolCalling: { maxToolCalls: 10, timeout: 60_000 },
+});
+```
 
 ### Interactive and cancellation contract
 
@@ -179,7 +192,7 @@ Source disambiguation uses `(source, sourceQualifier, name)`, so duplicate tool
 
 Current downstream integration boundaries in this repo:
 
-- `@a5c-ai/babysitter-agent`
+- `@a5c-ai/agent-platform`
   - re-exports the session/tool APIs from `src/harness/index.ts`
   - uses `createAgentCoreSession()` for the direct `agent-core` harness path in `src/harness/invoker.ts`
   - injects `createAgentCoreToolDefinitions()` into plan-process and delegated-task flows in `src/harness/internal/createRun/planProcess/*`
@@ -189,7 +202,7 @@ Current downstream integration boundaries in this repo:
 - `@a5c-ai/babysitter-sdk`
   - provides config defaults/env wiring used by the `config` tool and remains the owner of orchestration/run-state semantics outside this package
 
-In practice, use `agent-core` when you need an in-process runtime wrapper or bundled tool surface. Use `babysitter-agent` when you need the higher-level harness CLI/runtime entrypoints.
+In practice, use `agent-core` when you need an in-process runtime wrapper or bundled tool surface. Use `agent-platform` when you need the higher-level harness CLI/runtime entrypoints.
 
 ## Build, test, and CI
 

package/dist/agenticTools/background/state.d.ts

@@ -1,5 +1,7 @@
-import { BackgroundProcessRegistry } from "../../backgroundProcessRegistry";
-import type { AgenticToolOptions } from "../types";
-export declare function getBackgroundRegistry(options: AgenticToolOptions): BackgroundProcessRegistry;
-export declare function disposeBackgroundRegistry(options: AgenticToolOptions): void;
+/**
+ * Backwards-compatibility shim -- the canonical implementation now lives in
+ * `@a5c-ai/agent-runtime`.  This re-export keeps internal agent-core consumers
+ * working without changes.
+ */
+export { getBackgroundRegistry, disposeBackgroundRegistry, } from "@a5c-ai/agent-runtime";
 //# sourceMappingURL=state.d.ts.map

package/dist/agenticTools/background/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/agenticTools/background/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAInD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,yBAAyB,CAW5F;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAO3E"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/agenticTools/background/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC"}

package/dist/agenticTools/background/state.js

@@ -1,25 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBackgroundRegistry = getBackgroundRegistry;
-exports.disposeBackgroundRegistry = disposeBackgroundRegistry;
-const backgroundProcessRegistry_1 = require("../../backgroundProcessRegistry");
-const scopedRegistries = new WeakMap();
-function getBackgroundRegistry(options) {
-    if (options.backgroundRegistry) {
-        return options.backgroundRegistry;
-    }
-    let registry = scopedRegistries.get(options);
-    if (!registry) {
-        registry = new backgroundProcessRegistry_1.BackgroundProcessRegistry({ maxConcurrent: options.maxBackgroundProcesses });
-        scopedRegistries.set(options, registry);
-    }
-    return registry;
-}
-function disposeBackgroundRegistry(options) {
-    const registry = scopedRegistries.get(options);
-    if (!registry) {
-        return;
-    }
-    registry.dispose();
-    scopedRegistries.delete(options);
-}
+exports.disposeBackgroundRegistry = exports.getBackgroundRegistry = void 0;
+/**
+ * Backwards-compatibility shim -- the canonical implementation now lives in
+ * `@a5c-ai/agent-runtime`.  This re-export keeps internal agent-core consumers
+ * working without changes.
+ */
+var agent_runtime_1 = require("@a5c-ai/agent-runtime");
+Object.defineProperty(exports, "getBackgroundRegistry", { enumerable: true, get: function () { return agent_runtime_1.getBackgroundRegistry; } });
+Object.defineProperty(exports, "disposeBackgroundRegistry", { enumerable: true, get: function () { return agent_runtime_1.disposeBackgroundRegistry; } });

package/dist/agenticTools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agenticTools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAexE,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,kBAAkB,GAAG,oBAAoB,EAAE,CAelG;AAED,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAOzF;AAED,eAAO,MAAM,4BAA4B,uCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agenticTools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAmBxE,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,kBAAkB,GAAG,oBAAoB,EAAE,CAsBlG;AAED,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAOzF;AAED,eAAO,MAAM,4BAA4B,uCAAiC,CAAC"}

package/dist/agenticTools/index.js

@@ -14,9 +14,10 @@ const code_1 = require("./tools/code");
 const delegation_1 = require("./tools/delegation");
 const execution_1 = require("./tools/execution");
 const fileSystem_1 = require("./tools/fileSystem");
+const programmaticToolCalling_1 = require("./tools/programmaticToolCalling");
 const toolDefinitionScopes = new WeakMap();
 function createAgentCoreToolDefinitions(options) {
-    const tools = [
+    const baseTools = [
         ...(0, fileSystem_1.createFileSystemTools)(options),
         ...(0, execution_1.createExecutionTools)(options),
         (0, tool_1.createBrowserTool)(),
@@ -27,6 +28,12 @@ function createAgentCoreToolDefinitions(options) {
         ...(0, tools_2.createDiscoveryTools)(options),
         ...(0, tools_3.createWebTools)(),
     ].map((tool) => (0, results_1.wrapToolDefinition)(tool, options.onToolUse));
+    const tools = (0, programmaticToolCalling_1.shouldEnableProgrammaticToolCalling)(options)
+        ? [
+            ...baseTools,
+            (0, results_1.wrapToolDefinition)((0, programmaticToolCalling_1.createProgrammaticToolCallingTool)(options, baseTools), options.onToolUse),
+        ]
+        : baseTools;
     toolDefinitionScopes.set(tools, options);
     return tools;
 }

package/dist/agenticTools/tools/programmaticToolCalling.d.ts

@@ -0,0 +1,4 @@
+import type { AgenticToolOptions, CustomToolDefinition } from "../types";
+export declare function shouldEnableProgrammaticToolCalling(options: AgenticToolOptions): boolean;
+export declare function createProgrammaticToolCallingTool(options: AgenticToolOptions, availableTools: CustomToolDefinition[]): CustomToolDefinition;
+//# sourceMappingURL=programmaticToolCalling.d.ts.map

package/dist/agenticTools/tools/programmaticToolCalling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programmaticToolCalling.d.ts","sourceRoot":"","sources":["../../../src/agenticTools/tools/programmaticToolCalling.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAc,MAAM,UAAU,CAAC;AAgBrF,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAExF;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,cAAc,EAAE,oBAAoB,EAAE,GACrC,oBAAoB,CAwEtB"}

package/dist/agenticTools/tools/programmaticToolCalling.js

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldEnableProgrammaticToolCalling = shouldEnableProgrammaticToolCalling;
+exports.createProgrammaticToolCallingTool = createProgrammaticToolCallingTool;
+const node_vm_1 = __importDefault(require("node:vm"));
+const typebox_1 = require("@sinclair/typebox");
+const results_1 = require("../shared/results");
+const DEFAULT_TIMEOUT_MS = 120_000;
+const DEFAULT_MAX_TOOL_CALLS = 25;
+function shouldEnableProgrammaticToolCalling(options) {
+    return Boolean(options.programmaticToolCalling);
+}
+function createProgrammaticToolCallingTool(options, availableTools) {
+    const config = resolveExecutorConfig(options);
+    const callableTools = availableTools.filter((tool) => tool.name !== "code_executor");
+    return {
+        name: "code_executor",
+        label: "Programmatic Tool Calling",
+        description: [
+            "Execute a JavaScript tool chain against the agent-core tool surface.",
+            "Use tools.<name>(params) or callTool(name, params) to batch discovery,",
+            "fetch, filesystem, shell, web, and other enabled tools in one request.",
+        ].join(" "),
+        promptSnippet: [
+            "Programmatic Tool Calling is available through code_executor.",
+            "Write JavaScript inside an async function body and return the final value.",
+            "Call agent-core tools with await tools.read({ path: 'README.md' }) or await callTool('tool_search', { query: 'git' }).",
+        ].join("\n"),
+        parameters: typebox_1.Type.Object({
+            code: typebox_1.Type.String({
+                description: "JavaScript async function body. Use return <value> for the final result.",
+            }),
+            timeout: typebox_1.Type.Optional(typebox_1.Type.Number({ description: `Timeout in ms (default: ${config.timeout})` })),
+            max_tool_calls: typebox_1.Type.Optional(typebox_1.Type.Number({
+                description: `Maximum nested tool calls (default: ${config.maxToolCalls})`,
+            })),
+        }),
+        execute: async (_toolCallId, params) => {
+            const calls = [];
+            const timeout = resolveInvocationLimit(params.timeout, config.timeout);
+            const maxToolCalls = resolveInvocationLimit(params.max_tool_calls, config.maxToolCalls);
+            const logs = [];
+            const toolMap = new Map(callableTools.map((tool) => [tool.name, tool]));
+            const callTool = async (name, toolParams = {}) => {
+                if (calls.length >= maxToolCalls) {
+                    throw new Error(`code_executor exceeded max_tool_calls (${maxToolCalls})`);
+                }
+                const tool = toolMap.get(name);
+                if (!tool) {
+                    throw new Error(`Tool "${name}" is not available to code_executor.`);
+                }
+                calls.push({ tool: name, params: toolParams });
+                return unwrapToolResult(await tool.execute(`code-executor:${calls.length}:${name}`, toolParams));
+            };
+            const tools = Object.create(null);
+            for (const tool of callableTools) {
+                tools[tool.name] = (toolParams = {}) => callTool(tool.name, toolParams);
+            }
+            const context = node_vm_1.default.createContext({
+                callTool,
+                tools,
+                console: {
+                    log: (...items) => logs.push(items.map(stringifyLogItem).join(" ")),
+                    error: (...items) => logs.push(items.map(stringifyLogItem).join(" ")),
+                    warn: (...items) => logs.push(items.map(stringifyLogItem).join(" ")),
+                },
+            });
+            const script = new node_vm_1.default.Script(`(async () => {\n${String(params.code ?? "")}\n})()`);
+            const startedAt = Date.now();
+            const result = await withTimeout(Promise.resolve(script.runInContext(context, { timeout })), timeout);
+            return (0, results_1.jsonResult)({
+                result,
+                logs,
+                toolCalls: calls,
+                duration: Date.now() - startedAt,
+            });
+        },
+    };
+}
+function resolveInvocationLimit(value, configuredLimit) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return configuredLimit;
+    }
+    return Math.min(Math.floor(value), configuredLimit);
+}
+function resolveExecutorConfig(options) {
+    const configured = options.programmaticToolCalling;
+    if (configured && typeof configured === "object") {
+        return {
+            timeout: configured.timeout ?? DEFAULT_TIMEOUT_MS,
+            maxToolCalls: configured.maxToolCalls ?? DEFAULT_MAX_TOOL_CALLS,
+        };
+    }
+    return {
+        timeout: DEFAULT_TIMEOUT_MS,
+        maxToolCalls: DEFAULT_MAX_TOOL_CALLS,
+    };
+}
+async function withTimeout(promise, timeout) {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_resolve, reject) => {
+                timer = setTimeout(() => reject(new Error(`code_executor timed out after ${timeout}ms`)), timeout);
+            }),
+        ]);
+    }
+    finally {
+        if (timer) {
+            clearTimeout(timer);
+        }
+    }
+}
+function unwrapToolResult(result) {
+    const text = result.content.map((item) => item.text).join("\n");
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function stringifyLogItem(item) {
+    if (typeof item === "string") {
+        return item;
+    }
+    try {
+        return JSON.stringify(item);
+    }
+    catch {
+        return String(item);
+    }
+}

package/dist/backgroundProcessRegistry.d.ts

@@ -1,63 +1,7 @@
 /**
- * Background process lifecycle management for the bash agentic tool (GAP-TOOLS-036).
- *
- * Tracks child processes spawned with `run_in_background: true`, collects
- * stdout/stderr, fires completion callbacks, and enforces a concurrency limit.
+ * Backwards-compatibility shim -- the canonical implementation now lives in
+ * `@a5c-ai/agent-runtime`.  This re-export keeps internal agent-core consumers
+ * (and any external code that deep-imported this path) working without changes.
  */
-/** Snapshot of a tracked background process. */
-export interface BackgroundTaskRecord {
-    backgroundTaskId: string;
-    pid: number;
-    command: string;
-    description?: string;
-    startedAt: string;
-    status: "running" | "completed" | "exited" | "cancelled" | "killed";
-    exitCode: number | null;
-    stdout: string;
-    stderr: string;
-    durationMs: number | null;
-}
-/** Payload delivered to `onComplete` callbacks. */
-export interface BackgroundCompletionEvent {
-    backgroundTaskId: string;
-    pid: number;
-    command: string;
-    description?: string;
-    status: "completed" | "exited";
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-    durationMs: number;
-}
-/** Options for spawning a background process. */
-export interface SpawnOptions {
-    command: string;
-    cwd: string;
-    env?: Record<string, string>;
-    description?: string;
-    onComplete?: (event: BackgroundCompletionEvent) => void;
-}
-export declare class BackgroundProcessRegistry {
-    private readonly processes;
-    private readonly maxConcurrent;
-    constructor(options?: {
-        maxConcurrent?: number;
-    });
-    /**
-     * Spawn a command in the background and begin tracking it.
-     * Returns a snapshot of the initial record.
-     */
-    spawn(opts: SpawnOptions): BackgroundTaskRecord;
-    /** Get a snapshot of a tracked process by ID, or undefined. */
-    get(backgroundTaskId: string): BackgroundTaskRecord | undefined;
-    /** List snapshots of all tracked processes. */
-    list(): BackgroundTaskRecord[];
-    /** Cancel (SIGTERM) a running process. Returns true if found and killed. */
-    cancel(backgroundTaskId: string): boolean;
-    /** Kill all running processes. */
-    killAll(): void;
-    /** Kill all processes and clear tracking state. */
-    dispose(): void;
-    private snapshot;
-}
+export { BackgroundProcessRegistry, type BackgroundTaskRecord, type BackgroundCompletionEvent, type SpawnOptions, } from "@a5c-ai/agent-runtime";
 //# sourceMappingURL=backgroundProcessRegistry.d.ts.map

package/dist/backgroundProcessRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backgroundProcessRegistry.d.ts","sourceRoot":"","sources":["../src/backgroundProcessRegistry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;CACzD;AA4BD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;IAIhD;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,oBAAoB;IAuF/C,+DAA+D;IAC/D,GAAG,CAAC,gBAAgB,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAM/D,+CAA+C;IAC/C,IAAI,IAAI,oBAAoB,EAAE;IAI9B,4EAA4E;IAC5E,MAAM,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO;IAczC,kCAAkC;IAClC,OAAO,IAAI,IAAI;IAcf,mDAAmD;IACnD,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,QAAQ;CAcjB"}
+{"version":3,"file":"backgroundProcessRegistry.d.ts","sourceRoot":"","sources":["../src/backgroundProcessRegistry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC"}

package/dist/backgroundProcessRegistry.js

@@ -1,200 +1,10 @@
 "use strict";
-/**
- * Background process lifecycle management for the bash agentic tool (GAP-TOOLS-036).
- *
- * Tracks child processes spawned with `run_in_background: true`, collects
- * stdout/stderr, fires completion callbacks, and enforces a concurrency limit.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackgroundProcessRegistry = void 0;
-const childProcess = __importStar(require("node:child_process"));
-const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
-// ---------------------------------------------------------------------------
-// Registry
-// ---------------------------------------------------------------------------
-const DEFAULT_MAX_CONCURRENT = 16;
-class BackgroundProcessRegistry {
-    processes = new Map();
-    maxConcurrent;
-    constructor(options) {
-        this.maxConcurrent = options?.maxConcurrent ?? DEFAULT_MAX_CONCURRENT;
-    }
-    /**
-     * Spawn a command in the background and begin tracking it.
-     * Returns a snapshot of the initial record.
-     */
-    spawn(opts) {
-        const runningCount = [...this.processes.values()].filter((p) => p.status === "running").length;
-        if (runningCount >= this.maxConcurrent) {
-            throw new Error(`Max concurrent background processes limit reached (${this.maxConcurrent}). ` +
-                `Cancel or wait for existing processes before spawning new ones.`);
-        }
-        const backgroundTaskId = (0, babysitter_sdk_1.nextUlid)();
-        const startMs = Date.now();
-        const shell = process.platform === "win32" ? "cmd.exe" : "/bin/bash";
-        const shellArgs = process.platform === "win32"
-            ? ["/c", opts.command]
-            : ["-c", opts.command];
-        const child = childProcess.spawn(shell, shellArgs, {
-            cwd: opts.cwd,
-            env: { ...process.env, ...opts.env },
-            shell: false,
-            windowsHide: true,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        const tracked = {
-            backgroundTaskId,
-            pid: child.pid ?? -1,
-            command: opts.command,
-            description: opts.description,
-            startedAt: new Date(startMs).toISOString(),
-            startMs,
-            status: "running",
-            exitCode: null,
-            stdoutChunks: [],
-            stderrChunks: [],
-            durationMs: null,
-            child,
-            onComplete: opts.onComplete,
-        };
-        child.stdout?.on("data", (chunk) => {
-            tracked.stdoutChunks.push(chunk);
-        });
-        child.stderr?.on("data", (chunk) => {
-            tracked.stderrChunks.push(chunk);
-        });
-        child.on("close", (code) => {
-            if (tracked.status === "running") {
-                tracked.status = code === 0 ? "completed" : "exited";
-            }
-            tracked.exitCode = code ?? 1;
-            tracked.durationMs = Date.now() - tracked.startMs;
-            if (tracked.onComplete) {
-                try {
-                    tracked.onComplete({
-                        backgroundTaskId: tracked.backgroundTaskId,
-                        pid: tracked.pid,
-                        command: tracked.command,
-                        description: tracked.description,
-                        status: tracked.status,
-                        exitCode: tracked.exitCode,
-                        stdout: Buffer.concat(tracked.stdoutChunks).toString("utf8"),
-                        stderr: Buffer.concat(tracked.stderrChunks).toString("utf8"),
-                        durationMs: tracked.durationMs,
-                    });
-                }
-                catch {
-                    // Fire-and-forget — callback errors must not crash.
-                }
-            }
-        });
-        child.on("error", () => {
-            if (tracked.status === "running") {
-                tracked.status = "exited";
-            }
-            tracked.exitCode = 1;
-            tracked.durationMs = Date.now() - tracked.startMs;
-        });
-        this.processes.set(backgroundTaskId, tracked);
-        return this.snapshot(tracked);
-    }
-    /** Get a snapshot of a tracked process by ID, or undefined. */
-    get(backgroundTaskId) {
-        const tracked = this.processes.get(backgroundTaskId);
-        if (!tracked)
-            return undefined;
-        return this.snapshot(tracked);
-    }
-    /** List snapshots of all tracked processes. */
-    list() {
-        return [...this.processes.values()].map((t) => this.snapshot(t));
-    }
-    /** Cancel (SIGTERM) a running process. Returns true if found and killed. */
-    cancel(backgroundTaskId) {
-        const tracked = this.processes.get(backgroundTaskId);
-        if (!tracked)
-            return false;
-        if (tracked.status !== "running")
-            return true;
-        tracked.status = "cancelled";
-        tracked.durationMs = Date.now() - tracked.startMs;
-        try {
-            tracked.child.kill("SIGTERM");
-        }
-        catch {
-            // Already dead — fine.
-        }
-        return true;
-    }
-    /** Kill all running processes. */
-    killAll() {
-        for (const tracked of this.processes.values()) {
-            if (tracked.status === "running") {
-                tracked.status = "killed";
-                tracked.durationMs = Date.now() - tracked.startMs;
-                try {
-                    tracked.child.kill("SIGTERM");
-                }
-                catch {
-                    // Already dead.
-                }
-            }
-        }
-    }
-    /** Kill all processes and clear tracking state. */
-    dispose() {
-        this.killAll();
-        this.processes.clear();
-    }
-    // -------------------------------------------------------------------------
-    // Internals
-    // -------------------------------------------------------------------------
-    snapshot(t) {
-        return {
-            backgroundTaskId: t.backgroundTaskId,
-            pid: t.pid,
-            command: t.command,
-            description: t.description,
-            startedAt: t.startedAt,
-            status: t.status,
-            exitCode: t.exitCode,
-            stdout: Buffer.concat(t.stdoutChunks).toString("utf8"),
-            stderr: Buffer.concat(t.stderrChunks).toString("utf8"),
-            durationMs: t.durationMs,
-        };
-    }
-}
-exports.BackgroundProcessRegistry = BackgroundProcessRegistry;
+/**
+ * Backwards-compatibility shim -- the canonical implementation now lives in
+ * `@a5c-ai/agent-runtime`.  This re-export keeps internal agent-core consumers
+ * (and any external code that deep-imported this path) working without changes.
+ */
+var agent_runtime_1 = require("@a5c-ai/agent-runtime");
+Object.defineProperty(exports, "BackgroundProcessRegistry", { enumerable: true, get: function () { return agent_runtime_1.BackgroundProcessRegistry; } });

package/dist/context/index.d.ts

@@ -0,0 +1,5 @@
+export type { CompactionStrategyKind, PriorityCompactionStrategy, SlidingCompactionStrategy, SummaryCompactionStrategy, CompactionStrategy, ContextEntry, ContextManagerConfig, ContextManager, } from "./types";
+export { ContextManagerImpl, type ContextManagerImplOptions, } from "./manager";
+export { estimateTokens, estimateEntryTokens } from "./token-estimator";
+export { applyPriorityCompaction, applySlidingCompaction, applySummaryCompaction, type PriorityCompactionResult, type SlidingCompactionResult, type SummaryCompactionResult, type SummarizeFn, } from "./strategies";
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applySummaryCompaction = exports.applySlidingCompaction = exports.applyPriorityCompaction = exports.estimateEntryTokens = exports.estimateTokens = exports.ContextManagerImpl = void 0;
+var manager_1 = require("./manager");
+Object.defineProperty(exports, "ContextManagerImpl", { enumerable: true, get: function () { return manager_1.ContextManagerImpl; } });
+var token_estimator_1 = require("./token-estimator");
+Object.defineProperty(exports, "estimateTokens", { enumerable: true, get: function () { return token_estimator_1.estimateTokens; } });
+Object.defineProperty(exports, "estimateEntryTokens", { enumerable: true, get: function () { return token_estimator_1.estimateEntryTokens; } });
+var strategies_1 = require("./strategies");
+Object.defineProperty(exports, "applyPriorityCompaction", { enumerable: true, get: function () { return strategies_1.applyPriorityCompaction; } });
+Object.defineProperty(exports, "applySlidingCompaction", { enumerable: true, get: function () { return strategies_1.applySlidingCompaction; } });
+Object.defineProperty(exports, "applySummaryCompaction", { enumerable: true, get: function () { return strategies_1.applySummaryCompaction; } });