@amodalai/core 0.1.0

package/dist/src/tools/store-write-tool.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { MessageBus } from '@google/gemini-cli-core';
+import type { ToolResult, ToolInvocation } from '@google/gemini-cli-core';
+import { BaseDeclarativeTool } from '@google/gemini-cli-core';
+import type { LoadedStore } from '../repo/store-types.js';
+import type { StoreBackend } from '../stores/store-backend.js';
+interface StoreWriteParams {
+    [key: string]: unknown;
+}
+/**
+ * Tool for writing a document to a specific store collection.
+ * One instance per store definition. The LLM fills in the entity fields
+ * and the tool resolves the key, validates, and persists.
+ */
+export declare class StoreWriteTool extends BaseDeclarativeTool<StoreWriteParams, ToolResult> {
+    private readonly store;
+    private readonly backend;
+    private readonly tenantId;
+    constructor(store: LoadedStore, backend: StoreBackend, tenantId: string, messageBus: MessageBus);
+    protected createInvocation(params: StoreWriteParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string): ToolInvocation<StoreWriteParams, ToolResult>;
+}
+export {};

package/dist/src/tools/store-write-tool.js

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind } from '@google/gemini-cli-core';
+import { ToolErrorType } from '@google/gemini-cli-core';
+import { storeToToolName, storeToJsonSchema } from '../repo/store-tool-schema.js';
+/**
+ * Resolve a key template (e.g., "{alert_id}") from payload values.
+ */
+function resolveKey(template, payload) {
+    return template.replace(/\{(\w+)\}/g, (_match, field) => {
+        const value = payload[field];
+        if (value === undefined || value === null) {
+            throw new Error(`Missing required field "${field}" for key template "${template}"`);
+        }
+        return String(value);
+    });
+}
+class StoreWriteInvocation extends BaseToolInvocation {
+    store;
+    backend;
+    tenantId;
+    constructor(params, messageBus, store, backend, tenantId, _toolName, _toolDisplayName) {
+        super(params, messageBus, _toolName, _toolDisplayName);
+        this.store = store;
+        this.backend = backend;
+        this.tenantId = tenantId;
+    }
+    getDescription() {
+        return `Store a ${this.store.entity.name} to ${this.store.name}`;
+    }
+    async execute(_signal) {
+        let key;
+        try {
+            key = resolveKey(this.store.entity.key, this.params);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                llmContent: `Error: ${message}`,
+                returnDisplay: `Error: ${message}`,
+                error: { message, type: ToolErrorType.INVALID_TOOL_PARAMS },
+            };
+        }
+        try {
+            const result = await this.backend.put(this.tenantId, this.store.name, key, this.params, {});
+            const output = JSON.stringify(result);
+            return {
+                llmContent: output,
+                returnDisplay: `Stored ${this.store.entity.name} with key "${key}" (v${String(result.version)})`,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                llmContent: `Error: ${message}`,
+                returnDisplay: `Error storing ${this.store.entity.name}`,
+                error: { message, type: ToolErrorType.EXECUTION_FAILED },
+            };
+        }
+    }
+}
+/**
+ * Tool for writing a document to a specific store collection.
+ * One instance per store definition. The LLM fills in the entity fields
+ * and the tool resolves the key, validates, and persists.
+ */
+export class StoreWriteTool extends BaseDeclarativeTool {
+    store;
+    backend;
+    tenantId;
+    constructor(store, backend, tenantId, messageBus) {
+        super(storeToToolName(store.name), `Store ${store.entity.name}`, `Store a ${store.entity.name} to the ${store.name} collection.`, Kind.Execute, storeToJsonSchema(store), messageBus, false, false);
+        this.store = store;
+        this.backend = backend;
+        this.tenantId = tenantId;
+    }
+    createInvocation(params, messageBus, _toolName, _toolDisplayName) {
+        return new StoreWriteInvocation(params, messageBus, this.store, this.backend, this.tenantId, _toolName, _toolDisplayName);
+    }
+}
+//# sourceMappingURL=store-write-tool.js.map

package/dist/src/tools/store-write-tool.js.map

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

package/dist/src/tools/tool-definition-types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Tool definition shape used by amodal tools.
+ * Mirrors the upstream ToolDefinition interface without importing it
+ * (since it's not exported from @google/gemini-cli-core's public API).
+ */
+export interface ToolDefinition {
+    base: {
+        name: string;
+        description?: string;
+        parametersJsonSchema?: Record<string, unknown>;
+    };
+    overrides?: Record<string, {
+        description?: string;
+        parametersJsonSchema?: Record<string, unknown>;
+    }>;
+}

package/dist/src/tools/tool-definition-types.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};
+//# sourceMappingURL=tool-definition-types.js.map

package/dist/src/tools/tool-definition-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-definition-types.js","sourceRoot":"","sources":["../../../src/tools/tool-definition-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/tools/tool-utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { TemplateError } from '../templates/template-resolver.js';
+import type { ResponseShaping } from './http-tool-types.js';
+/**
+ * Make an HTTP request with abort-signal-based timeout.
+ */
+export declare function httpFetch(url: string, options: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+    timeout: number;
+    signal?: AbortSignal;
+}): Promise<Response>;
+/**
+ * Extract a value at a dot-separated path from a parsed JSON object.
+ */
+export declare function extractPath(obj: unknown, path: string): unknown;
+/**
+ * Shape a response according to the responseShaping config.
+ */
+export declare function shapeResponse(data: unknown, shaping: ResponseShaping | undefined): string;
+/**
+ * Format template resolution errors into a human-readable string.
+ */
+export declare function formatTemplateErrors(errors: TemplateError[]): string;

package/dist/src/tools/tool-utils.js

@@ -0,0 +1,66 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Make an HTTP request with abort-signal-based timeout.
+ */
+export async function httpFetch(url, options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), options.timeout);
+    // If an external signal is provided, listen for it
+    if (options.signal) {
+        options.signal.addEventListener('abort', () => controller.abort(), {
+            once: true,
+        });
+    }
+    try {
+        return await fetch(url, {
+            method: options.method,
+            headers: options.headers,
+            body: options.body,
+            signal: controller.signal,
+        });
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+/**
+ * Extract a value at a dot-separated path from a parsed JSON object.
+ */
+export function extractPath(obj, path) {
+    const segments = path.split('.');
+    let current = obj;
+    for (const segment of segments) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[segment]; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
+    }
+    return current;
+}
+/**
+ * Shape a response according to the responseShaping config.
+ */
+export function shapeResponse(data, shaping) {
+    let result = data;
+    if (shaping?.path) {
+        const extracted = extractPath(data, shaping.path);
+        result = extracted !== undefined ? extracted : data;
+    }
+    const str = typeof result === 'string' ? result : JSON.stringify(result);
+    const maxLength = shaping?.maxLength ?? 50000;
+    if (str.length > maxLength) {
+        return str.slice(0, maxLength) + '\n... [truncated]';
+    }
+    return str;
+}
+/**
+ * Format template resolution errors into a human-readable string.
+ */
+export function formatTemplateErrors(errors) {
+    return errors.map((e) => `  - {{${e.expression}}}: ${e.message}`).join('\n');
+}
+//# sourceMappingURL=tool-utils.js.map

package/dist/src/tools/tool-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-utils.js","sourceRoot":"","sources":["../../../src/tools/tool-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,OAMC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAExE,mDAAmD;IACnD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE;YACjE,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAAC,GAAG,EAAE;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAY,EAAE,IAAY;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,GAAY,GAAG,CAAC;IAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7E,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,OAAO,CAAC,CAAC,CAAC,kEAAkE;IAC7H,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAa,EACb,OAAoC;IAEpC,IAAI,MAAM,GAAG,IAAI,CAAC;IAElB,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,KAAK,CAAC;IAE9C,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,mBAAmB,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,UAAU,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/E,CAAC"}

package/dist/src/versions/bundle-loader.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { VersionBundle } from './version-bundle-types.js';
+/**
+ * Error codes for bundle loading failures.
+ */
+export type VersionBundleErrorCode = 'FETCH_FAILED' | 'PARSE_FAILED' | 'VALIDATION_FAILED';
+/**
+ * Error thrown when a version bundle cannot be loaded.
+ */
+export declare class VersionBundleError extends Error {
+    readonly code: VersionBundleErrorCode;
+    constructor(code: VersionBundleErrorCode, message: string, cause?: unknown);
+}
+/**
+ * Source for loading a bundle — either a URL or a local file path.
+ */
+export interface BundleSource {
+    url?: string;
+    path?: string;
+}
+/**
+ * Load a version bundle from a remote URL.
+ */
+export declare function loadBundleFromUrl(url: string, timeout?: number): Promise<VersionBundle>;
+/**
+ * Load a version bundle from a local file.
+ */
+export declare function loadBundleFromFile(filePath: string): Promise<VersionBundle>;
+/**
+ * Load a bundle from either a URL or file path.
+ * Exactly one of `url` or `path` must be provided.
+ */
+export declare function loadBundle(source: BundleSource): Promise<VersionBundle>;

package/dist/src/versions/bundle-loader.js

@@ -0,0 +1,99 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { readFile } from 'node:fs/promises';
+import { ZodError } from 'zod';
+import { VersionBundleSchema } from './version-bundle-types.js';
+/**
+ * Error thrown when a version bundle cannot be loaded.
+ */
+export class VersionBundleError extends Error {
+    code;
+    constructor(code, message, cause) {
+        super(message, { cause });
+        this.name = 'VersionBundleError';
+        this.code = code;
+    }
+}
+/**
+ * Load a version bundle from a remote URL.
+ */
+export async function loadBundleFromUrl(url, timeout = 30000) {
+    let response;
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+        response = await fetch(url, { signal: controller.signal });
+        clearTimeout(timer);
+    }
+    catch (err) {
+        throw new VersionBundleError('FETCH_FAILED', `Failed to fetch bundle from ${url}`, err);
+    }
+    if (!response.ok) {
+        throw new VersionBundleError('FETCH_FAILED', `HTTP ${String(response.status)} fetching bundle from ${url}`);
+    }
+    let data;
+    try {
+        data = await response.json();
+    }
+    catch (err) {
+        throw new VersionBundleError('PARSE_FAILED', `Invalid JSON in bundle from ${url}`, err);
+    }
+    return validateBundle(data);
+}
+/**
+ * Load a version bundle from a local file.
+ */
+export async function loadBundleFromFile(filePath) {
+    let raw;
+    try {
+        raw = await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        throw new VersionBundleError('FETCH_FAILED', `Failed to read bundle file: ${filePath}`, err);
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new VersionBundleError('PARSE_FAILED', `Invalid JSON in bundle file: ${filePath}`, err);
+    }
+    return validateBundle(data);
+}
+/**
+ * Load a bundle from either a URL or file path.
+ * Exactly one of `url` or `path` must be provided.
+ */
+export async function loadBundle(source) {
+    if (source.url && source.path) {
+        throw new VersionBundleError('VALIDATION_FAILED', 'Provide either url or path, not both');
+    }
+    if (source.url) {
+        return loadBundleFromUrl(source.url);
+    }
+    if (source.path) {
+        return loadBundleFromFile(source.path);
+    }
+    throw new VersionBundleError('VALIDATION_FAILED', 'Either url or path must be provided');
+}
+/**
+ * Validate raw data against the VersionBundle schema.
+ */
+function validateBundle(data) {
+    try {
+        return VersionBundleSchema.parse(data);
+    }
+    catch (err) {
+        if (err instanceof ZodError) {
+            const issues = err.issues
+                .map((i) => `${i.path.join('.')}: ${i.message}`)
+                .join('; ');
+            throw new VersionBundleError('VALIDATION_FAILED', `Bundle validation failed: ${issues}`, err);
+        }
+        throw new VersionBundleError('VALIDATION_FAILED', 'Bundle validation failed', err);
+    }
+}
+//# sourceMappingURL=bundle-loader.js.map

package/dist/src/versions/bundle-loader.js.map

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

package/dist/src/versions/dependency-manager.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { BundleDependencies } from './version-bundle-types.js';
+export interface DependencyDiff {
+    npm: {
+        added: Record<string, string>;
+        removed: string[];
+        changed: Record<string, string>;
+    };
+    pip: {
+        added: Record<string, string>;
+        removed: string[];
+        changed: Record<string, string>;
+    };
+    system: {
+        added: string[];
+        removed: string[];
+    };
+}
+/**
+ * Compute the difference between old and new dependencies.
+ * Pure function — no side effects.
+ */
+export declare function diffDependencies(oldDeps: BundleDependencies, newDeps: BundleDependencies): DependencyDiff;
+/**
+ * Install npm dependencies into a version directory.
+ * Creates a package.json and runs `pnpm install --prod`.
+ */
+export declare function installNpmDependencies(deps: Record<string, string>, versionDir: string): Promise<void>;
+/**
+ * Install pip dependencies into a version directory.
+ * Uses `pip install --target <dir>/python_modules`.
+ */
+export declare function installPipDependencies(deps: Record<string, string>, versionDir: string): Promise<void>;
+/**
+ * Verify that required system binaries are available.
+ * Returns the list of missing binaries.
+ */
+export declare function verifySystemBinaries(binaries: string[]): Promise<{
+    missing: string[];
+}>;
+export interface DependencyInstallResult {
+    npmInstalled: boolean;
+    pipInstalled: boolean;
+    missingBinaries: string[];
+}
+/**
+ * Install all dependencies from a diff into a version directory.
+ * Returns the installation result. Throws if system binaries are missing.
+ */
+export declare function installDependencies(diff: DependencyDiff, versionDir: string): Promise<DependencyInstallResult>;

package/dist/src/versions/dependency-manager.js

@@ -0,0 +1,132 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { execFile } from 'node:child_process';
+import { writeFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/** Maximum time (ms) for dependency installation commands. */
+const INSTALL_TIMEOUT = 120_000;
+/** Maximum time (ms) for `which` binary check. */
+const WHICH_TIMEOUT = 5_000;
+/**
+ * Compute the difference between old and new dependencies.
+ * Pure function — no side effects.
+ */
+export function diffDependencies(oldDeps, newDeps) {
+    return {
+        npm: diffPackages(oldDeps.npm ?? {}, newDeps.npm ?? {}),
+        pip: diffPackages(oldDeps.pip ?? {}, newDeps.pip ?? {}),
+        system: diffArrays(oldDeps.system ?? [], newDeps.system ?? []),
+    };
+}
+function diffPackages(oldPkgs, newPkgs) {
+    const added = {};
+    const removed = [];
+    const changed = {};
+    for (const [name, version] of Object.entries(newPkgs)) {
+        if (!(name in oldPkgs)) {
+            added[name] = version;
+        }
+        else if (oldPkgs[name] !== version) {
+            changed[name] = version;
+        }
+    }
+    for (const name of Object.keys(oldPkgs)) {
+        if (!(name in newPkgs)) {
+            removed.push(name);
+        }
+    }
+    return { added, removed, changed };
+}
+function diffArrays(oldArr, newArr) {
+    const oldSet = new Set(oldArr);
+    const newSet = new Set(newArr);
+    return {
+        added: newArr.filter((s) => !oldSet.has(s)),
+        removed: oldArr.filter((s) => !newSet.has(s)),
+    };
+}
+// ---------------------------------------------------------------------------
+// npm dependency installation
+// ---------------------------------------------------------------------------
+/**
+ * Install npm dependencies into a version directory.
+ * Creates a package.json and runs `pnpm install --prod`.
+ */
+export async function installNpmDependencies(deps, versionDir) {
+    if (Object.keys(deps).length === 0)
+        return;
+    const pkgJson = {
+        name: 'version-bundle-deps',
+        version: '0.0.0',
+        private: true,
+        dependencies: deps,
+    };
+    await mkdir(versionDir, { recursive: true });
+    await writeFile(path.join(versionDir, 'package.json'), JSON.stringify(pkgJson, null, 2));
+    await execFileAsync('pnpm', ['install', '--prod'], {
+        cwd: versionDir,
+        timeout: INSTALL_TIMEOUT,
+    });
+}
+// ---------------------------------------------------------------------------
+// pip dependency installation
+// ---------------------------------------------------------------------------
+/**
+ * Install pip dependencies into a version directory.
+ * Uses `pip install --target <dir>/python_modules`.
+ */
+export async function installPipDependencies(deps, versionDir) {
+    if (Object.keys(deps).length === 0)
+        return;
+    const targetDir = path.join(versionDir, 'python_modules');
+    await mkdir(targetDir, { recursive: true });
+    const packages = Object.entries(deps).map(([name, version]) => `${name}==${version}`);
+    await execFileAsync('pip', ['install', '--target', targetDir, ...packages], { cwd: versionDir, timeout: INSTALL_TIMEOUT });
+}
+// ---------------------------------------------------------------------------
+// System binary verification
+// ---------------------------------------------------------------------------
+/**
+ * Verify that required system binaries are available.
+ * Returns the list of missing binaries.
+ */
+export async function verifySystemBinaries(binaries) {
+    if (binaries.length === 0)
+        return { missing: [] };
+    const missing = [];
+    for (const binary of binaries) {
+        try {
+            await execFileAsync('which', [binary], { timeout: WHICH_TIMEOUT });
+        }
+        catch {
+            missing.push(binary);
+        }
+    }
+    return { missing };
+}
+/**
+ * Install all dependencies from a diff into a version directory.
+ * Returns the installation result. Throws if system binaries are missing.
+ */
+export async function installDependencies(diff, versionDir) {
+    // Merge added + changed into a single set to install
+    const npmToInstall = { ...diff.npm.added, ...diff.npm.changed };
+    const pipToInstall = { ...diff.pip.added, ...diff.pip.changed };
+    // Install npm and pip in parallel
+    const [, , systemResult] = await Promise.all([
+        installNpmDependencies(npmToInstall, versionDir),
+        installPipDependencies(pipToInstall, versionDir),
+        verifySystemBinaries(diff.system.added),
+    ]);
+    return {
+        npmInstalled: Object.keys(npmToInstall).length > 0,
+        pipInstalled: Object.keys(pipToInstall).length > 0,
+        missingBinaries: systemResult.missing,
+    };
+}
+//# sourceMappingURL=dependency-manager.js.map

package/dist/src/versions/dependency-manager.js.map

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

package/dist/src/versions/handler-loader.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { BundleHandler } from './version-bundle-types.js';
+import type { FunctionHandlerMap } from '../tools/function-tool-types.js';
+/**
+ * Convert a .ts entry filename to .mjs for Node ESM dynamic import.
+ */
+export declare function toMjsFilename(filename: string): string;
+/**
+ * Write handler source files to disk.
+ * Each handler's files are written to `<versionDir>/handlers/<handlerName>/`.
+ * Entry .ts files are written as .mjs for ESM compatibility.
+ */
+export declare function writeHandlerFiles(handlers: Record<string, BundleHandler>, versionDir: string): Promise<void>;
+/**
+ * Dynamically import handler entry files and extract default exports.
+ * Each handler must export a default function matching FunctionToolHandler.
+ */
+export declare function importHandlers(handlers: Record<string, BundleHandler>, versionDir: string): Promise<FunctionHandlerMap>;
+/**
+ * Write handler files to disk and import them.
+ * Combined convenience function.
+ */
+export declare function loadHandlers(handlers: Record<string, BundleHandler>, versionDir: string): Promise<FunctionHandlerMap>;