@amodalai/core 0.1.0

package/dist/src/snapshot/snapshot-types.js

@@ -0,0 +1,145 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+import { AmodalConfigSchema } from '../repo/config-schema.js';
+import { ConnectionSpecSchema, AccessConfigSchema } from '../repo/connection-schemas.js';
+/**
+ * A serialized connection in a deploy snapshot.
+ * Surface is stored as the original markdown string.
+ */
+export const SnapshotConnectionSchema = z.object({
+    spec: ConnectionSpecSchema,
+    surface: z.string(),
+    access: AccessConfigSchema,
+    entities: z.string().optional(),
+    rules: z.string().optional(),
+});
+/**
+ * A serialized skill in a deploy snapshot.
+ */
+export const SnapshotSkillSchema = z.object({
+    name: z.string().min(1),
+    description: z.string(),
+    trigger: z.string().optional(),
+    body: z.string(),
+});
+/**
+ * A serialized automation in a deploy snapshot.
+ */
+export const SnapshotAutomationSchema = z.object({
+    name: z.string().min(1),
+    title: z.string(),
+    schedule: z.string().optional(),
+    trigger: z.enum(['cron', 'webhook', 'manual']).default('manual'),
+    prompt: z.string(),
+});
+/**
+ * A serialized knowledge document in a deploy snapshot.
+ */
+export const SnapshotKnowledgeSchema = z.object({
+    name: z.string().min(1),
+    title: z.string(),
+    body: z.string(),
+});
+/**
+ * A serialized custom tool in a deploy snapshot.
+ * Contains metadata only — handler code lives in Daytona snapshots.
+ */
+export const SnapshotToolSchema = z.object({
+    name: z.string().min(1),
+    description: z.string(),
+    parameters: z.record(z.unknown()).default({}),
+    confirm: z.union([z.literal(false), z.literal(true), z.literal('review'), z.literal('never')]).default(false),
+    timeout: z.number().int().positive().default(30000),
+    env: z.array(z.string()).default([]),
+});
+/**
+ * A serialized subagent definition in a deploy snapshot.
+ */
+export const SnapshotSubagentSchema = z.object({
+    name: z.string().min(1),
+    displayName: z.string().min(1),
+    description: z.string(),
+    prompt: z.string(),
+    tools: z.array(z.string()).default([]),
+    maxDepth: z.number().int().default(1),
+    maxToolCalls: z.number().int().default(10),
+    timeout: z.number().int().default(20),
+});
+/**
+ * Build manifest entry mapping a tool to its Daytona sandbox snapshot.
+ */
+export const SnapshotToolManifestEntrySchema = z.object({
+    snapshotId: z.string().min(1),
+    imageHash: z.string().min(1),
+    sandboxLanguage: z.string().default('typescript'),
+    hasDockerfile: z.boolean().default(false),
+    hasSetupScript: z.boolean().default(false),
+});
+/**
+ * Build manifest: maps tool names to Daytona snapshot IDs.
+ * Created by `amodal build --tools`, stored in the deploy snapshot.
+ */
+export const SnapshotBuildManifestSchema = z.object({
+    version: z.literal(1),
+    builtAt: z.string(),
+    tools: z.record(z.string(), SnapshotToolManifestEntrySchema),
+});
+/**
+ * A serialized eval case in a deploy snapshot.
+ */
+export const SnapshotEvalAssertionSchema = z.object({
+    text: z.string(),
+    negated: z.boolean().default(false),
+});
+export const SnapshotEvalSchema = z.object({
+    name: z.string().min(1),
+    title: z.string(),
+    description: z.string().default(''),
+    query: z.string(),
+    assertions: z.array(SnapshotEvalAssertionSchema),
+});
+/**
+ * The complete deploy snapshot — an immutable, fully-resolved JSON blob
+ * that captures the entire agent configuration at a point in time.
+ */
+export const DeploySnapshotSchema = z.object({
+    deployId: z.string().regex(/^deploy-[0-9a-f]{7}$/),
+    createdAt: z.string().datetime(),
+    createdBy: z.string(),
+    source: z.enum(['cli', 'github', 'admin-ui']),
+    commitSha: z.string().optional(),
+    branch: z.string().optional(),
+    message: z.string().optional(),
+    config: AmodalConfigSchema,
+    connections: z.record(z.string(), SnapshotConnectionSchema),
+    skills: z.array(SnapshotSkillSchema),
+    automations: z.array(SnapshotAutomationSchema),
+    knowledge: z.array(SnapshotKnowledgeSchema),
+    agents: z.object({
+        main: z.string().optional(),
+        simple: z.string().optional(),
+        subagents: z.array(SnapshotSubagentSchema).optional(),
+    }).optional(),
+    /** Custom tool metadata (handler code lives in Daytona snapshots) */
+    tools: z.array(SnapshotToolSchema).optional(),
+    /** Store definitions */
+    stores: z.array(z.record(z.unknown())).optional(),
+    /** Build manifest mapping tool names to Daytona snapshot IDs */
+    buildManifest: SnapshotBuildManifestSchema.optional(),
+    /** Eval definitions for model evaluation */
+    evals: z.array(SnapshotEvalSchema).optional(),
+    /** MCP servers to connect to */
+    mcpServers: z.record(z.string(), z.object({
+        transport: z.enum(['stdio', 'sse', 'http']),
+        command: z.string().optional(),
+        args: z.array(z.string()).optional(),
+        env: z.record(z.string()).optional(),
+        url: z.string().optional(),
+        trust: z.boolean().optional(),
+    })).optional(),
+});
+//# sourceMappingURL=snapshot-types.js.map

package/dist/src/snapshot/snapshot-types.js.map

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

package/dist/src/stores/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export type { StoreDocument, StoreDocumentMeta, StorePutResult, StoreListOptions, StoreListResult, StoreBackend, } from './store-backend.js';

package/dist/src/stores/index.js

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

package/dist/src/stores/index.js.map

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

package/dist/src/stores/store-backend.d.ts

@@ -0,0 +1,135 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { LoadedStore } from '../repo/store-types.js';
+/**
+ * Metadata stored alongside each document in a store.
+ */
+export interface StoreDocumentMeta {
+    /** When the document was computed/written */
+    computedAt: string;
+    /** TTL in seconds (resolved at write time) */
+    ttl?: number;
+    /** Whether the document is past its TTL */
+    stale: boolean;
+    /** ID of the automation that produced this document */
+    automationId?: string;
+    /** ID of the skill that produced this document */
+    skillId?: string;
+    /** Model used for computation */
+    modelUsed?: string;
+    /** Token cost of computation */
+    tokenCost?: number;
+    /** Estimated cost in USD */
+    estimatedCostUsd?: number;
+    /** Duration of computation in ms */
+    durationMs?: number;
+    /** Reasoning trace (if store has trace: true) */
+    trace?: string;
+}
+/**
+ * A document stored in a store collection.
+ */
+export interface StoreDocument {
+    /** Document key (resolved from key template) */
+    key: string;
+    /** Tenant that owns this document */
+    tenantId: string;
+    /** Store name this document belongs to */
+    store: string;
+    /** Version number (increments on each update) */
+    version: number;
+    /** The entity payload (validated against store schema) */
+    payload: Record<string, unknown>;
+    /** Document metadata */
+    meta: StoreDocumentMeta;
+}
+/**
+ * Result of a store put (upsert) operation.
+ */
+export interface StorePutResult {
+    /** Whether the document was stored successfully */
+    stored: boolean;
+    /** The document key */
+    key: string;
+    /** The new version number */
+    version: number;
+    /** The previous version number (if updating) */
+    previousVersion?: number;
+    /** Error message if stored is false */
+    error?: string;
+}
+/**
+ * Options for listing documents from a store.
+ */
+export interface StoreListOptions {
+    /** Filter by field values (equality match on payload fields) */
+    filter?: Record<string, unknown>;
+    /** Sort field. Prefix with "-" for descending (e.g., "-severity") */
+    sort?: string;
+    /** Maximum number of documents to return */
+    limit?: number;
+    /** Number of documents to skip */
+    offset?: number;
+    /** Whether to include stale (expired) documents */
+    includeStale?: boolean;
+}
+/**
+ * Result of a store list operation.
+ */
+export interface StoreListResult {
+    /** The matching documents */
+    documents: StoreDocument[];
+    /** Total count of matching documents (before limit/offset) */
+    total: number;
+    /** Whether there are more documents beyond the current page */
+    hasMore: boolean;
+}
+/**
+ * Interface for store persistence backends.
+ *
+ * Implementations: PGLite (default), remote Postgres, MongoDB, etc.
+ * The interface lives in core so BYODB backends only need to depend on core.
+ */
+export interface StoreBackend {
+    /**
+     * Initialize the backend — create tables, indexes, etc.
+     * Called once at startup with the full list of store definitions.
+     */
+    initialize(stores: LoadedStore[]): Promise<void>;
+    /**
+     * Get a single document by key.
+     * Returns null if the document doesn't exist.
+     */
+    get(tenantId: string, store: string, key: string): Promise<StoreDocument | null>;
+    /**
+     * Upsert a document. If it exists, increments version and optionally
+     * saves the previous version to history.
+     */
+    put(tenantId: string, store: string, key: string, payload: Record<string, unknown>, meta: Partial<StoreDocumentMeta>): Promise<StorePutResult>;
+    /**
+     * List documents from a store with optional filtering, sorting, and pagination.
+     */
+    list(tenantId: string, store: string, options?: StoreListOptions): Promise<StoreListResult>;
+    /**
+     * Delete a document by key.
+     * Returns true if the document existed and was deleted.
+     */
+    delete(tenantId: string, store: string, key: string): Promise<boolean>;
+    /**
+     * Get version history for a document (most recent first).
+     * Returns empty array if no history exists.
+     */
+    history(tenantId: string, store: string, key: string): Promise<StoreDocument[]>;
+    /**
+     * Delete all documents past their TTL.
+     * Returns the number of documents purged.
+     */
+    purgeExpired(tenantId: string, store?: string): Promise<number>;
+    /**
+     * Shut down the backend (close connections, release resources).
+     */
+    close(): Promise<void>;
+}

package/dist/src/stores/store-backend.js

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

package/dist/src/stores/store-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-backend.js","sourceRoot":"","sources":["../../../src/stores/store-backend.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/templates/connections.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * A single connection's configuration (e.g., base_url, api_key).
+ */
+export type ConnectionConfig = Record<string, unknown>;
+/**
+ * Map of connection names to their configurations.
+ * Example: { device_api: { base_url: "https://...", api_key: "sk-..." } }
+ */
+export type ConnectionsMap = Record<string, ConnectionConfig>;

package/dist/src/templates/connections.js

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

package/dist/src/templates/connections.js.map

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

package/dist/src/templates/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export { resolveTemplate, resolveTemplateObject, type TemplateContext, type TemplateError, type TemplateResult, } from './template-resolver.js';
+export { type ConnectionConfig, type ConnectionsMap } from './connections.js';

package/dist/src/templates/index.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export { resolveTemplate, resolveTemplateObject, } from './template-resolver.js';
+export {} from './connections.js';
+//# sourceMappingURL=index.js.map

package/dist/src/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,GAItB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAA8C,MAAM,kBAAkB,CAAC"}

package/dist/src/templates/template-resolver.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Context for template resolution. Contains namespaced data sources.
+ */
+export interface TemplateContext {
+    connections: Record<string, Record<string, unknown>>;
+    params: Record<string, unknown>;
+}
+/**
+ * An error encountered during template resolution.
+ */
+export interface TemplateError {
+    expression: string;
+    message: string;
+}
+/**
+ * Result of resolving a single template string.
+ */
+export interface TemplateResult {
+    value: string;
+    errors: TemplateError[];
+}
+/**
+ * Resolve all `{{namespace.path}}` expressions in a template string.
+ *
+ * - `{{connections.x.y}}` resolves from context.connections
+ * - `{{params.x}}` resolves from context.params
+ * - Missing variables produce errors (never silently empty)
+ * - Escaped `\{{literal}}` is converted to `{{literal}}` without resolution
+ * - Invalid namespaces produce errors
+ */
+export declare function resolveTemplate(template: string, context: TemplateContext): TemplateResult;
+/**
+ * Recursively resolve all string values in an object.
+ * Non-string values are passed through unchanged.
+ * Collects all errors from all resolved strings.
+ */
+export declare function resolveTemplateObject<T>(obj: T, context: TemplateContext): {
+    value: T;
+    errors: TemplateError[];
+};

package/dist/src/templates/template-resolver.js

@@ -0,0 +1,121 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+const VALID_NAMESPACES = new Set(['connections', 'params']);
+// Matches {{expression}} but not \{{expression}}
+const TEMPLATE_REGEX = /(?<!\\)\{\{([^}]+)\}\}/g;
+// Matches escaped \{{ to un-escape
+const ESCAPED_TEMPLATE_REGEX = /\\\{\{([^}]*)\}\}/g;
+/**
+ * Resolve a dot-separated path on a nested object.
+ * Returns undefined if any segment is missing.
+ */
+function resolvePath(obj, dotPath) {
+    const segments = dotPath.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;
+}
+/**
+ * Convert a resolved value to a string suitable for template substitution.
+ */
+function valueToString(value) {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    if (typeof value === 'object') {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+/**
+ * Resolve all `{{namespace.path}}` expressions in a template string.
+ *
+ * - `{{connections.x.y}}` resolves from context.connections
+ * - `{{params.x}}` resolves from context.params
+ * - Missing variables produce errors (never silently empty)
+ * - Escaped `\{{literal}}` is converted to `{{literal}}` without resolution
+ * - Invalid namespaces produce errors
+ */
+export function resolveTemplate(template, context) {
+    const errors = [];
+    // Replace unescaped {{expressions}}
+    let value = template.replace(TEMPLATE_REGEX, (_match, expression) => {
+        const trimmed = expression.trim();
+        const dotIndex = trimmed.indexOf('.');
+        if (dotIndex === -1) {
+            errors.push({
+                expression: trimmed,
+                message: `Invalid template expression "${trimmed}": must be in format "namespace.path"`,
+            });
+            return `{{${trimmed}}}`;
+        }
+        const namespace = trimmed.slice(0, dotIndex);
+        const path = trimmed.slice(dotIndex + 1);
+        if (!VALID_NAMESPACES.has(namespace)) {
+            errors.push({
+                expression: trimmed,
+                message: `Unknown namespace "${namespace}". Valid namespaces: ${[...VALID_NAMESPACES].join(', ')}`,
+            });
+            return `{{${trimmed}}}`;
+        }
+        const source = namespace === 'connections' ? context.connections :
+            namespace === 'params' ? context.params :
+                undefined;
+        if (!source || typeof source !== 'object') {
+            errors.push({
+                expression: trimmed,
+                message: `Namespace "${namespace}" is empty or not configured`,
+            });
+            return `{{${trimmed}}}`;
+        }
+        const resolved = resolvePath(source, path);
+        if (resolved === undefined) {
+            errors.push({
+                expression: trimmed,
+                message: `Variable "${trimmed}" not found`,
+            });
+            return `{{${trimmed}}}`;
+        }
+        return valueToString(resolved);
+    });
+    // Un-escape \{{ → {{
+    value = value.replace(ESCAPED_TEMPLATE_REGEX, '{{$1}}');
+    return { value, errors };
+}
+/**
+ * Recursively resolve all string values in an object.
+ * Non-string values are passed through unchanged.
+ * Collects all errors from all resolved strings.
+ */
+export function resolveTemplateObject(obj, context) {
+    const errors = [];
+    function resolve(val) {
+        if (typeof val === 'string') {
+            const result = resolveTemplate(val, context);
+            errors.push(...result.errors);
+            return result.value;
+        }
+        if (Array.isArray(val)) {
+            return val.map(resolve);
+        }
+        if (val !== null && typeof val === 'object') {
+            const resolved = {};
+            for (const key of Object.keys(val)) {
+                resolved[key] = resolve(val[key]); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
+            }
+            return resolved;
+        }
+        return val;
+    }
+    const value = resolve(obj); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
+    return { value, errors };
+}
+//# sourceMappingURL=template-resolver.js.map

package/dist/src/templates/template-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-resolver.js","sourceRoot":"","sources":["../../../src/templates/template-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE5D,iDAAiD;AACjD,MAAM,cAAc,GAAG,yBAAyB,CAAC;AAEjD,mCAAmC;AACnC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAEpD;;;GAGG;AACH,SAAS,WAAW,CAClB,GAA4B,EAC5B,OAAe;IAEf,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,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,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,OAAwB;IAExB,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,oCAAoC;IACpC,IAAI,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,UAAkB,EAAE,EAAE;QAC1E,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC;gBACV,UAAU,EAAE,OAAO;gBACnB,OAAO,EAAE,gCAAgC,OAAO,uCAAuC;aACxF,CAAC,CAAC;YACH,OAAO,KAAK,OAAO,IAAI,CAAC;QAC1B,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAEzC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC;gBACV,UAAU,EAAE,OAAO;gBACnB,OAAO,EAAE,sBAAsB,SAAS,wBAAwB,CAAC,GAAG,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACnG,CAAC,CAAC;YACH,OAAO,KAAK,OAAO,IAAI,CAAC;QAC1B,CAAC;QAED,MAAM,MAAM,GACV,SAAS,KAAK,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACnD,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACzC,SAAS,CAAC;QACZ,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC;gBACV,UAAU,EAAE,OAAO;gBACnB,OAAO,EAAE,cAAc,SAAS,8BAA8B;aAC/D,CAAC,CAAC;YACH,OAAO,KAAK,OAAO,IAAI,CAAC;QAC1B,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC;gBACV,UAAU,EAAE,OAAO;gBACnB,OAAO,EAAE,aAAa,OAAO,aAAa;aAC3C,CAAC,CAAC;YACH,OAAO,KAAK,OAAO,IAAI,CAAC;QAC1B,CAAC;QAED,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,qBAAqB;IACrB,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IAExD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAM,EACN,OAAwB;IAExB,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,SAAS,OAAO,CAAC,GAAY;QAC3B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAA4B,EAAE,CAAC;YAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,kEAAkE;YACpI,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAM,CAAC,CAAC,kEAAkE;IACnG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/src/tool-context.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AuditLogger } from './audit/index.js';
+import type { ConnectionsMap } from './templates/index.js';
+import type { KnowledgeStore } from './knowledge/knowledge-store.js';
+import type { ConnectionInfo } from './platform/platform-types.js';
+import type { LoadedStore } from './repo/store-types.js';
+import type { StoreBackend } from './stores/store-backend.js';
+/**
+ * Narrow interface exposing only the config surface that amodal tools need.
+ * AmodalConfig implements this. Tool classes depend on ToolContext rather than
+ * the full Config or AmodalConfig, keeping them decoupled from the composition
+ * wrapper.
+ */
+export interface ToolContext {
+    getSessionId(): string;
+    getPlatformApiUrl(): string | undefined;
+    getPlatformApiKey(): string | undefined;
+    getApplicationId(): string | undefined;
+    getTenantId(): string | undefined;
+    getAuditLogger(): AuditLogger | undefined;
+    getConnections(): ConnectionsMap;
+    getKnowledgeStore(): KnowledgeStore;
+    getConnectionInfos(): ConnectionInfo[];
+    getAgentContext(): string | undefined;
+    getStores(): LoadedStore[];
+    getStoreBackend(): StoreBackend | undefined;
+    /** Session-scoped environment variables (tenant secrets). */
+    getSessionEnv(): Record<string, string>;
+}

package/dist/src/tool-context.js

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

package/dist/src/tool-context.js.map

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

package/dist/src/tool-registration.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { Config } from '@google/gemini-cli-core';
+import type { ToolContext } from './tool-context.js';
+import { registerHttpTools, registerChainTools, registerFunctionTools } from './tools/custom-tool-registrar.js';
+/**
+ * Register all amodal-specific tools on the upstream Config's ToolRegistry.
+ * Called after Config.initialize() so the registry already exists.
+ */
+export declare function registerAmodalTools(ctx: ToolContext, config: Config): Promise<void>;
+export { registerHttpTools, registerChainTools, registerFunctionTools };

package/dist/src/tool-registration.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { ProposeKnowledgeTool } from './knowledge/propose-knowledge.js';
+import { LoadKnowledgeTool } from './knowledge/load-knowledge.js';
+import { PresentTool } from './widgets/present-tool.js';
+import { RequestTool } from './tools/request-tool.js';
+import { StoreWriteTool } from './tools/store-write-tool.js';
+import { StoreQueryTool } from './tools/store-query-tool.js';
+import { registerHttpTools, registerChainTools, registerFunctionTools, } from './tools/custom-tool-registrar.js';
+/**
+ * Register all amodal-specific tools on the upstream Config's ToolRegistry.
+ * Called after Config.initialize() so the registry already exists.
+ */
+export async function registerAmodalTools(ctx, config) {
+    const registry = config.getToolRegistry();
+    const messageBus = config.getMessageBus();
+    // Register propose_knowledge (when platform API is configured)
+    const platformApiUrl = ctx.getPlatformApiUrl();
+    const platformApiKey = ctx.getPlatformApiKey();
+    if (platformApiUrl && platformApiKey) {
+        registry.registerTool(new ProposeKnowledgeTool(ctx, messageBus));
+    }
+    // Register load_knowledge (when KB docs exist)
+    const store = ctx.getKnowledgeStore();
+    const allDocs = store.getAllDocuments();
+    if (allDocs.length > 0) {
+        registry.registerTool(new LoadKnowledgeTool(store, messageBus));
+    }
+    // Register present tool (always available)
+    registry.registerTool(new PresentTool(ctx, messageBus));
+    // Register request tool (when connections exist)
+    const connections = ctx.getConnections();
+    if (Object.keys(connections).length > 0) {
+        registry.registerTool(new RequestTool(connections, messageBus, false, ctx.getSessionEnv()));
+    }
+    // Register store tools (when stores + backend exist)
+    const stores = ctx.getStores();
+    const storeBackend = ctx.getStoreBackend();
+    if (stores.length > 0 && storeBackend) {
+        const tenantId = ctx.getTenantId() ?? 'default';
+        for (const store of stores) {
+            registry.registerTool(new StoreWriteTool(store, storeBackend, tenantId, messageBus));
+        }
+        registry.registerTool(new StoreQueryTool(stores, storeBackend, tenantId, messageBus));
+    }
+}
+export { registerHttpTools, registerChainTools, registerFunctionTools };
+//# sourceMappingURL=tool-registration.js.map