@amodalai/core 0.1.0

package/dist/src/providers/runtime/provider-errors.js

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Base error for provider failures.
+ */
+export class ProviderError extends Error {
+    provider;
+    statusCode;
+    retryable;
+    constructor(message, options) {
+        super(message, { cause: options.cause });
+        this.name = 'ProviderError';
+        this.provider = options.provider;
+        this.statusCode = options.statusCode;
+        this.retryable = options.retryable ?? false;
+    }
+}
+/**
+ * Thrown on 429 rate limit responses.
+ */
+export class RateLimitError extends ProviderError {
+    retryAfterMs;
+    constructor(message, options) {
+        super(message, {
+            provider: options.provider,
+            statusCode: 429,
+            retryable: true,
+            cause: options.cause,
+        });
+        this.name = 'RateLimitError';
+        this.retryAfterMs = options.retryAfterMs;
+    }
+}
+/**
+ * Thrown when a request times out.
+ */
+export class ProviderTimeoutError extends ProviderError {
+    constructor(message, options) {
+        super(message, {
+            provider: options.provider,
+            retryable: true,
+            cause: options.cause,
+        });
+        this.name = 'ProviderTimeoutError';
+    }
+}
+//# sourceMappingURL=provider-errors.js.map

package/dist/src/providers/runtime/provider-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-errors.js","sourceRoot":"","sources":["../../../../src/providers/runtime/provider-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,QAAQ,CAAS;IACjB,UAAU,CAAU;IACpB,SAAS,CAAU;IAE5B,YACE,OAAe,EACf,OAKC;QAED,KAAK,CAAC,OAAO,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAC,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC9C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IACtC,YAAY,CAAU;IAE/B,YACE,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,EAAE;YACb,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD,YACE,OAAe,EACf,OAGC;QAED,KAAK,CAAC,OAAO,EAAE;YACb,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/src/providers/runtime/provider-factory.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { ModelConfig } from '../../repo/config-schema.js';
+import type { RuntimeProvider } from './runtime-provider-types.js';
+/**
+ * Creates a RuntimeProvider for the given model config.
+ *
+ * - `anthropic` → AnthropicRuntimeProvider
+ * - `openai` → OpenAIRuntimeProvider
+ * - `google` → GoogleRuntimeProvider
+ * - `bedrock` → BedrockRuntimeProvider
+ * - `azure` → AzureOpenAIRuntimeProvider
+ * - Unknown provider with `baseUrl` → OpenAIRuntimeProvider (OpenAI-compatible)
+ * - Unknown provider without `baseUrl` → throws
+ */
+export declare function createRuntimeProvider(modelConfig: ModelConfig): RuntimeProvider;

package/dist/src/providers/runtime/provider-factory.js

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { ProviderError } from './provider-errors.js';
+import { AnthropicRuntimeProvider } from './anthropic-provider.js';
+import { OpenAIRuntimeProvider } from './openai-provider.js';
+import { GoogleRuntimeProvider } from './google-provider.js';
+import { BedrockRuntimeProvider } from './bedrock-provider.js';
+import { AzureOpenAIRuntimeProvider } from './azure-provider.js';
+/**
+ * Creates a RuntimeProvider for the given model config.
+ *
+ * - `anthropic` → AnthropicRuntimeProvider
+ * - `openai` → OpenAIRuntimeProvider
+ * - `google` → GoogleRuntimeProvider
+ * - `bedrock` → BedrockRuntimeProvider
+ * - `azure` → AzureOpenAIRuntimeProvider
+ * - Unknown provider with `baseUrl` → OpenAIRuntimeProvider (OpenAI-compatible)
+ * - Unknown provider without `baseUrl` → throws
+ */
+export function createRuntimeProvider(modelConfig) {
+    switch (modelConfig.provider) {
+        case 'anthropic':
+            return new AnthropicRuntimeProvider(modelConfig);
+        case 'openai':
+            return new OpenAIRuntimeProvider(modelConfig);
+        case 'google':
+            return new GoogleRuntimeProvider(modelConfig);
+        case 'bedrock':
+            return new BedrockRuntimeProvider(modelConfig);
+        case 'azure':
+            return new AzureOpenAIRuntimeProvider(modelConfig);
+        default:
+            if (modelConfig.baseUrl) {
+                // OpenAI-compatible endpoint
+                return new OpenAIRuntimeProvider(modelConfig);
+            }
+            throw new ProviderError(`Unsupported provider: ${modelConfig.provider}`, {
+                provider: modelConfig.provider,
+            });
+    }
+}
+//# sourceMappingURL=provider-factory.js.map

package/dist/src/providers/runtime/provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.js","sourceRoot":"","sources":["../../../../src/providers/runtime/provider-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAC,wBAAwB,EAAC,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAC,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAC,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAC,sBAAsB,EAAC,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAC,0BAA0B,EAAC,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAwB;IAC5D,QAAQ,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC7B,KAAK,WAAW;YACd,OAAO,IAAI,wBAAwB,CAAC,WAAW,CAAC,CAAC;QACnD,KAAK,QAAQ;YACX,OAAO,IAAI,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAChD,KAAK,QAAQ;YACX,OAAO,IAAI,qBAAqB,CAAC,WAAW,CAAC,CAAC;QAChD,KAAK,SAAS;YACZ,OAAO,IAAI,sBAAsB,CAAC,WAAW,CAAC,CAAC;QACjD,KAAK,OAAO;YACV,OAAO,IAAI,0BAA0B,CAAC,WAAW,CAAC,CAAC;QACrD;YACE,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,6BAA6B;gBAC7B,OAAO,IAAI,qBAAqB,CAAC,WAAW,CAAC,CAAC;YAChD,CAAC;YACD,MAAM,IAAI,aAAa,CAAC,yBAAyB,WAAW,CAAC,QAAQ,EAAE,EAAE;gBACvE,QAAQ,EAAE,WAAW,CAAC,QAAQ;aAC/B,CAAC,CAAC;IACP,CAAC;AACH,CAAC"}

package/dist/src/providers/runtime/runtime-provider-types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Provider-neutral LLM interface for the agent runtime.
+ *
+ * Separate from the existing ContentGenerator (which uses @google/genai types)
+ * to keep a clean, minimal abstraction for the ReAct loop.
+ */
+export interface LLMChatRequest {
+    model: string;
+    systemPrompt: string;
+    messages: LLMMessage[];
+    tools: LLMToolDefinition[];
+    maxTokens?: number;
+    signal?: AbortSignal;
+}
+export type LLMMessage = LLMUserMessage | LLMAssistantMessage | LLMToolResultMessage;
+export interface LLMUserMessage {
+    role: 'user';
+    content: string;
+}
+export interface LLMAssistantMessage {
+    role: 'assistant';
+    content: LLMResponseBlock[];
+}
+export interface LLMToolResultMessage {
+    role: 'tool_result';
+    toolCallId: string;
+    content: string;
+    isError?: boolean;
+}
+export interface LLMChatResponse {
+    content: LLMResponseBlock[];
+    stopReason: 'end_turn' | 'tool_use' | 'max_tokens' | 'error';
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+export type LLMResponseBlock = LLMTextBlock | LLMToolUseBlock;
+export interface LLMTextBlock {
+    type: 'text';
+    text: string;
+}
+export interface LLMToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface LLMToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+import type { LLMStreamEvent } from './streaming-types.js';
+export interface RuntimeProvider {
+    chat(request: LLMChatRequest): Promise<LLMChatResponse>;
+    chatStream?(request: LLMChatRequest): AsyncGenerator<LLMStreamEvent>;
+}

package/dist/src/providers/runtime/runtime-provider-types.js

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

package/dist/src/providers/runtime/runtime-provider-types.js.map

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

package/dist/src/providers/runtime/streaming-types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { LLMChatResponse } from './runtime-provider-types.js';
+/**
+ * Events emitted during streamed LLM responses.
+ *
+ * Consumers accumulate tool_use events (start + deltas + end) into complete
+ * tool calls. Text deltas can be forwarded immediately for real-time UX.
+ */
+export type LLMStreamEvent = LLMStreamTextDelta | LLMStreamToolUseStart | LLMStreamToolUseDelta | LLMStreamToolUseEnd | LLMStreamMessageEnd;
+export interface LLMStreamTextDelta {
+    type: 'text_delta';
+    text: string;
+}
+export interface LLMStreamToolUseStart {
+    type: 'tool_use_start';
+    id: string;
+    name: string;
+}
+export interface LLMStreamToolUseDelta {
+    type: 'tool_use_delta';
+    id: string;
+    inputDelta: string;
+}
+export interface LLMStreamToolUseEnd {
+    type: 'tool_use_end';
+    id: string;
+    input: Record<string, unknown>;
+}
+export interface LLMStreamMessageEnd {
+    type: 'message_end';
+    stopReason: LLMChatResponse['stopReason'];
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}

package/dist/src/providers/runtime/streaming-types.js

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

package/dist/src/providers/runtime/streaming-types.js.map

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

package/dist/src/repo/config-schema.d.ts

@@ -0,0 +1,238 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+/**
+ * Resolves a single value that may use the `env:VAR_NAME` pattern.
+ * Returns the environment variable value if the pattern matches,
+ * or the original value otherwise.
+ */
+export declare function resolveEnvValue(value: string): string;
+/**
+ * Recursively resolves all `env:VAR_NAME` patterns in an object.
+ */
+export declare function resolveEnvValues(obj: unknown): unknown;
+/**
+ * Schema for a model configuration entry.
+ */
+export declare const ModelConfigSchema: z.ZodType<ModelConfig>;
+export interface ModelConfig {
+    provider: string;
+    model: string;
+    region?: string;
+    baseUrl?: string;
+    fallback?: ModelConfig;
+    /**
+     * Explicit credentials for the provider.
+     * When set, providers use these instead of reading from process.env.
+     * This avoids shared mutable state (process.env) in multi-tenant hosted mode.
+     */
+    credentials?: Record<string, string>;
+}
+/**
+ * Schema for amodal.json.
+ */
+export declare const AmodalConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    userContext: z.ZodOptional<z.ZodString>;
+    /** Custom base system prompt. When omitted, the platform default is used. */
+    basePrompt: z.ZodOptional<z.ZodString>;
+    /** Subagent names to disable (e.g., ['explore', 'plan'] to turn off platform defaults) */
+    disabledSubagents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    models: z.ZodObject<{
+        main: z.ZodType<ModelConfig, z.ZodTypeDef, ModelConfig>;
+        simple: z.ZodOptional<z.ZodType<ModelConfig, z.ZodTypeDef, ModelConfig>>;
+        advanced: z.ZodOptional<z.ZodType<ModelConfig, z.ZodTypeDef, ModelConfig>>;
+    }, "strip", z.ZodTypeAny, {
+        main: ModelConfig;
+        simple?: ModelConfig | undefined;
+        advanced?: ModelConfig | undefined;
+    }, {
+        main: ModelConfig;
+        simple?: ModelConfig | undefined;
+        advanced?: ModelConfig | undefined;
+    }>;
+    proactive: z.ZodOptional<z.ZodObject<{
+        webhook: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        webhook: string;
+    }, {
+        webhook: string;
+    }>>;
+    platform: z.ZodOptional<z.ZodObject<{
+        projectId: z.ZodString;
+        apiKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        apiKey: string;
+        projectId: string;
+    }, {
+        apiKey: string;
+        projectId: string;
+    }>>;
+    sandbox: z.ZodOptional<z.ZodObject<{
+        /** Enable shell_exec tool for LLM code execution */
+        shellExec: z.ZodDefault<z.ZodBoolean>;
+        /** Daytona workspace template ID for hosted mode */
+        template: z.ZodOptional<z.ZodString>;
+        /** Maximum shell command execution timeout in ms */
+        maxTimeout: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        shellExec: boolean;
+        maxTimeout: number;
+        template?: string | undefined;
+    }, {
+        shellExec?: boolean | undefined;
+        template?: string | undefined;
+        maxTimeout?: number | undefined;
+    }>>;
+    stores: z.ZodOptional<z.ZodObject<{
+        /** Directory for PGLite data (default: .amodal/store-data) */
+        dataDir: z.ZodOptional<z.ZodString>;
+        /** Storage backend type */
+        backend: z.ZodDefault<z.ZodEnum<["pglite", "postgres"]>>;
+        /** PostgreSQL connection string (required when backend is 'postgres') */
+        postgresUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        backend: "pglite" | "postgres";
+        dataDir?: string | undefined;
+        postgresUrl?: string | undefined;
+    }, {
+        dataDir?: string | undefined;
+        backend?: "pglite" | "postgres" | undefined;
+        postgresUrl?: string | undefined;
+    }>>;
+    /** Installed packages — maps "type/name" to semver range (like package.json dependencies) */
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    mcp: z.ZodOptional<z.ZodObject<{
+        /** MCP servers to connect to as a client */
+        servers: z.ZodRecord<z.ZodString, z.ZodObject<{
+            transport: z.ZodEnum<["stdio", "sse", "http"]>;
+            command: z.ZodOptional<z.ZodString>;
+            args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            url: z.ZodOptional<z.ZodString>;
+            trust: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            transport: "stdio" | "sse" | "http";
+            env?: Record<string, string> | undefined;
+            url?: string | undefined;
+            command?: string | undefined;
+            args?: string[] | undefined;
+            trust?: boolean | undefined;
+        }, {
+            transport: "stdio" | "sse" | "http";
+            env?: Record<string, string> | undefined;
+            url?: string | undefined;
+            command?: string | undefined;
+            args?: string[] | undefined;
+            trust?: boolean | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        servers: Record<string, {
+            transport: "stdio" | "sse" | "http";
+            env?: Record<string, string> | undefined;
+            url?: string | undefined;
+            command?: string | undefined;
+            args?: string[] | undefined;
+            trust?: boolean | undefined;
+        }>;
+    }, {
+        servers: Record<string, {
+            transport: "stdio" | "sse" | "http";
+            env?: Record<string, string> | undefined;
+            url?: string | undefined;
+            command?: string | undefined;
+            args?: string[] | undefined;
+            trust?: boolean | undefined;
+        }>;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    name: string;
+    models: {
+        main: ModelConfig;
+        simple?: ModelConfig | undefined;
+        advanced?: ModelConfig | undefined;
+    };
+    description?: string | undefined;
+    sandbox?: {
+        shellExec: boolean;
+        maxTimeout: number;
+        template?: string | undefined;
+    } | undefined;
+    platform?: {
+        apiKey: string;
+        projectId: string;
+    } | undefined;
+    userContext?: string | undefined;
+    basePrompt?: string | undefined;
+    disabledSubagents?: string[] | undefined;
+    proactive?: {
+        webhook: string;
+    } | undefined;
+    stores?: {
+        backend: "pglite" | "postgres";
+        dataDir?: string | undefined;
+        postgresUrl?: string | undefined;
+    } | undefined;
+    dependencies?: Record<string, string> | undefined;
+    mcp?: {
+        servers: Record<string, {
+            transport: "stdio" | "sse" | "http";
+            env?: Record<string, string> | undefined;
+            url?: string | undefined;
+            command?: string | undefined;
+            args?: string[] | undefined;
+            trust?: boolean | undefined;
+        }>;
+    } | undefined;
+}, {
+    version: string;
+    name: string;
+    models: {
+        main: ModelConfig;
+        simple?: ModelConfig | undefined;
+        advanced?: ModelConfig | undefined;
+    };
+    description?: string | undefined;
+    sandbox?: {
+        shellExec?: boolean | undefined;
+        template?: string | undefined;
+        maxTimeout?: number | undefined;
+    } | undefined;
+    platform?: {
+        apiKey: string;
+        projectId: string;
+    } | undefined;
+    userContext?: string | undefined;
+    basePrompt?: string | undefined;
+    disabledSubagents?: string[] | undefined;
+    proactive?: {
+        webhook: string;
+    } | undefined;
+    stores?: {
+        dataDir?: string | undefined;
+        backend?: "pglite" | "postgres" | undefined;
+        postgresUrl?: string | undefined;
+    } | undefined;
+    dependencies?: Record<string, string> | undefined;
+    mcp?: {
+        servers: Record<string, {
+            transport: "stdio" | "sse" | "http";
+            env?: Record<string, string> | undefined;
+            url?: string | undefined;
+            command?: string | undefined;
+            args?: string[] | undefined;
+            trust?: boolean | undefined;
+        }>;
+    } | undefined;
+}>;
+export type AmodalConfig = z.infer<typeof AmodalConfigSchema>;
+/**
+ * Parse and validate a config JSON string. Resolves env: references.
+ */
+export declare function parseConfigJson(jsonString: string): AmodalConfig;

package/dist/src/repo/config-schema.js

@@ -0,0 +1,155 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z, ZodError } from 'zod';
+import { RepoError } from './repo-types.js';
+/**
+ * Resolves a single value that may use the `env:VAR_NAME` pattern.
+ * Returns the environment variable value if the pattern matches,
+ * or the original value otherwise.
+ */
+export function resolveEnvValue(value) {
+    if (!value.startsWith('env:')) {
+        return value;
+    }
+    const varName = value.slice(4);
+    if (!varName) {
+        throw new RepoError('ENV_NOT_SET', 'Empty environment variable name in "env:" reference');
+    }
+    const envValue = process.env[varName];
+    if (envValue === undefined) {
+        throw new RepoError('ENV_NOT_SET', `Environment variable "${varName}" is not set`);
+    }
+    return envValue;
+}
+/**
+ * Recursively resolves all `env:VAR_NAME` patterns in an object.
+ */
+export function resolveEnvValues(obj) {
+    if (typeof obj === 'string') {
+        return resolveEnvValue(obj);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => resolveEnvValues(item));
+    }
+    if (obj !== null && typeof obj === 'object') {
+        const result = {};
+        for (const [key, val] of Object.entries(obj)) {
+            result[key] = resolveEnvValues(val);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Schema for a model configuration entry.
+ */
+export const ModelConfigSchema = z.lazy(() => z.object({
+    provider: z.string().min(1),
+    model: z.string().min(1),
+    region: z.string().optional(),
+    baseUrl: z.string().optional(),
+    fallback: ModelConfigSchema.optional(),
+    credentials: z.record(z.string()).optional(),
+}));
+/**
+ * Schema for amodal.json.
+ */
+export const AmodalConfigSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().min(1),
+    description: z.string().optional(),
+    userContext: z.string().optional(),
+    /** Custom base system prompt. When omitted, the platform default is used. */
+    basePrompt: z.string().optional(),
+    /** Subagent names to disable (e.g., ['explore', 'plan'] to turn off platform defaults) */
+    disabledSubagents: z.array(z.string()).optional(),
+    models: z.object({
+        main: ModelConfigSchema,
+        simple: ModelConfigSchema.optional(),
+        advanced: ModelConfigSchema.optional(),
+    }),
+    proactive: z
+        .object({
+        webhook: z.string().min(1),
+    })
+        .optional(),
+    platform: z
+        .object({
+        projectId: z.string().min(1),
+        apiKey: z.string().min(1),
+    })
+        .optional(),
+    sandbox: z
+        .object({
+        /** Enable shell_exec tool for LLM code execution */
+        shellExec: z.boolean().default(false),
+        /** Daytona workspace template ID for hosted mode */
+        template: z.string().optional(),
+        /** Maximum shell command execution timeout in ms */
+        maxTimeout: z.number().int().positive().default(30000),
+    })
+        .optional(),
+    stores: z
+        .object({
+        /** Directory for PGLite data (default: .amodal/store-data) */
+        dataDir: z.string().optional(),
+        /** Storage backend type */
+        backend: z.enum(['pglite', 'postgres']).default('pglite'),
+        /** PostgreSQL connection string (required when backend is 'postgres') */
+        postgresUrl: z.string().optional(),
+    })
+        .optional(),
+    /** Installed packages — maps "type/name" to semver range (like package.json dependencies) */
+    dependencies: z.record(z.string(), z.string()).optional(),
+    mcp: z
+        .object({
+        /** MCP servers to connect to as a client */
+        servers: 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(),
+});
+/**
+ * Parse and validate a config JSON string. Resolves env: references.
+ */
+export function parseConfigJson(jsonString) {
+    let raw;
+    try {
+        raw = JSON.parse(jsonString);
+    }
+    catch (err) {
+        throw new RepoError('CONFIG_PARSE_FAILED', 'Invalid JSON in config file', err);
+    }
+    let resolved;
+    try {
+        resolved = resolveEnvValues(raw);
+    }
+    catch (err) {
+        if (err instanceof RepoError) {
+            throw err;
+        }
+        throw new RepoError('CONFIG_PARSE_FAILED', 'Failed to resolve env values', err);
+    }
+    try {
+        return AmodalConfigSchema.parse(resolved);
+    }
+    catch (err) {
+        if (err instanceof ZodError) {
+            const issues = err.issues
+                .map((i) => `${i.path.join('.')}: ${i.message}`)
+                .join('; ');
+            throw new RepoError('CONFIG_VALIDATION_FAILED', `Config validation failed: ${issues}`, err);
+        }
+        throw new RepoError('CONFIG_VALIDATION_FAILED', 'Config validation failed', err);
+    }
+}
+//# sourceMappingURL=config-schema.js.map

package/dist/src/repo/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../../src/repo/config-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,CAAC,EAAE,QAAQ,EAAC,MAAM,KAAK,CAAC;AAEhC,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CAAC,aAAa,EAAE,qDAAqD,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,SAAS,CAAC,aAAa,EAAE,yBAAyB,OAAO,cAAc,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CACnE,CAAC,CAAC,MAAM,CAAC;IACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CACH,CAAC;AAgBF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,6EAA6E;IAC7E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,0FAA0F;IAC1F,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,iBAAiB,CAAC,QAAQ,EAAE;QACpC,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE;KACvC,CAAC;IACF,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC3B,CAAC;SACD,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC1B,CAAC;SACD,QAAQ,EAAE;IACb,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,oDAAoD;QACpD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACrC,oDAAoD;QACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,oDAAoD;QACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KACvD,CAAC;SACD,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,8DAA8D;QAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,2BAA2B;QAC3B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACzD,yEAAyE;QACzE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACnC,CAAC;SACD,QAAQ,EAAE;IACb,6FAA6F;IAC7F,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzD,GAAG,EAAE,CAAC;SACH,MAAM,CAAC;QACN,4CAA4C;QAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC;YACrC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACpC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC1B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC9B,CAAC,CAAC;KACJ,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACjF,CAAC;IAED,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE,8BAA8B,EAAE,GAAG,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM;iBACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,SAAS,CACjB,0BAA0B,EAC1B,6BAA6B,MAAM,EAAE,EACrC,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,0BAA0B,EAAE,0BAA0B,EAAE,GAAG,CAAC,CAAC;IACnF,CAAC;AACH,CAAC"}