@amodalai/core 0.1.0

package/dist/src/repo/platform-reader.js

@@ -0,0 +1,206 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { ToolJsonSchema } from './tool-types.js';
+import { RepoError } from './repo-types.js';
+import { parseConfig, parseConnection, parseSkill, parseKnowledge, parseAutomation, parseEval, } from './parsers.js';
+/**
+ * Fetch a text resource from the platform API.
+ * Returns null on 404, throws on other errors.
+ */
+async function fetchText(baseUrl, path, apiKey, timeout = 30000) {
+    const url = `${baseUrl}${path}`;
+    let response;
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+        response = await fetch(url, {
+            signal: controller.signal,
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                Accept: 'text/plain, application/json',
+            },
+        });
+        clearTimeout(timer);
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === 'AbortError') {
+            throw new RepoError('PLATFORM_FETCH_FAILED', `Request timed out: ${url}`, err);
+        }
+        throw new RepoError('PLATFORM_FETCH_FAILED', `Failed to fetch ${url}`, err);
+    }
+    if (response.status === 404) {
+        return null;
+    }
+    if (!response.ok) {
+        throw new RepoError('PLATFORM_FETCH_FAILED', `HTTP ${String(response.status)} fetching ${url}`);
+    }
+    return response.text();
+}
+/**
+ * Fetch and parse JSON from the platform API.
+ */
+async function fetchJson(baseUrl, path, apiKey, timeout = 30000) {
+    const text = await fetchText(baseUrl, path, apiKey, timeout);
+    if (text === null) {
+        throw new RepoError('PLATFORM_FETCH_FAILED', `Resource not found: ${path}`);
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        return JSON.parse(text);
+    }
+    catch (err) {
+        throw new RepoError('CONFIG_PARSE_FAILED', `Invalid JSON from ${path}`, err);
+    }
+}
+/**
+ * Load a single connection from the platform API.
+ */
+async function loadPlatformConnection(baseUrl, apiKey, name) {
+    const basePath = `/api/repo/connections/${name}`;
+    const [specJson, accessJson, surfaceMd, entitiesMd, rulesMd] = await Promise.all([
+        fetchText(baseUrl, `${basePath}/spec`, apiKey),
+        fetchText(baseUrl, `${basePath}/access`, apiKey),
+        fetchText(baseUrl, `${basePath}/surface`, apiKey),
+        fetchText(baseUrl, `${basePath}/entities`, apiKey),
+        fetchText(baseUrl, `${basePath}/rules`, apiKey),
+    ]);
+    if (!specJson) {
+        throw new RepoError('READ_FAILED', `Missing spec.json for connection "${name}"`);
+    }
+    if (!accessJson) {
+        throw new RepoError('READ_FAILED', `Missing access.json for connection "${name}"`);
+    }
+    return parseConnection(name, {
+        specJson,
+        accessJson,
+        surfaceMd: surfaceMd ?? undefined,
+        entitiesMd: entitiesMd ?? undefined,
+        rulesMd: rulesMd ?? undefined,
+    }, `${baseUrl}${basePath}`);
+}
+/**
+ * Load the full amodal repo from the platform API.
+ */
+export async function loadRepoFromPlatform(apiUrl, apiKey) {
+    // Normalize URL — strip trailing slash
+    const baseUrl = apiUrl.replace(/\/+$/, '');
+    // Fetch config
+    const configText = await fetchText(baseUrl, '/api/repo/config', apiKey);
+    if (configText === null) {
+        throw new RepoError('CONFIG_NOT_FOUND', 'Config not found on platform');
+    }
+    const config = parseConfig(configText);
+    // Fetch directory tree
+    const tree = await fetchJson(baseUrl, '/api/repo/tree', apiKey);
+    // Load all sections in parallel
+    const [connections, skills, agents, knowledge, automations, evals, tools] = await Promise.all([
+        // Connections
+        (async () => {
+            const map = new Map();
+            const loaded = await Promise.all(tree.connections.map(async (name) => {
+                const conn = await loadPlatformConnection(baseUrl, apiKey, name);
+                return [name, conn];
+            }));
+            for (const [name, conn] of loaded) {
+                map.set(name, conn);
+            }
+            return map;
+        })(),
+        // Skills
+        Promise.all(tree.skills.map(async (name) => {
+            const content = await fetchText(baseUrl, `/api/repo/skills/${name}`, apiKey);
+            if (!content)
+                return null;
+            return parseSkill(content, `${baseUrl}/api/repo/skills/${name}`);
+        })).then((results) => results.filter((s) => s !== null)),
+        // Agents
+        (async () => {
+            const [main, explore] = await Promise.all([
+                fetchText(baseUrl, '/api/repo/agents/main', apiKey),
+                fetchText(baseUrl, '/api/repo/agents/explore', apiKey),
+            ]);
+            return {
+                main: main ?? undefined,
+                explore: explore ?? undefined,
+                subagents: [],
+            };
+        })(),
+        // Knowledge
+        Promise.all(tree.knowledge.map(async (name) => {
+            const content = await fetchText(baseUrl, `/api/repo/knowledge/${name}`, apiKey);
+            if (!content) {
+                return parseKnowledge('', name, `${baseUrl}/api/repo/knowledge/${name}`);
+            }
+            return parseKnowledge(content, name, `${baseUrl}/api/repo/knowledge/${name}`);
+        })),
+        // Automations
+        Promise.all(tree.automations.map(async (name) => {
+            const content = await fetchText(baseUrl, `/api/repo/automations/${name}`, apiKey);
+            if (!content) {
+                return parseAutomation('', name, `${baseUrl}/api/repo/automations/${name}`);
+            }
+            return parseAutomation(content, name, `${baseUrl}/api/repo/automations/${name}`);
+        })),
+        // Evals
+        Promise.all(tree.evals.map(async (name) => {
+            const content = await fetchText(baseUrl, `/api/repo/evals/${name}`, apiKey);
+            if (!content) {
+                return parseEval('', name, `${baseUrl}/api/repo/evals/${name}`);
+            }
+            return parseEval(content, name, `${baseUrl}/api/repo/evals/${name}`);
+        })),
+        // Tools
+        Promise.all((tree.tools ?? []).map(async (name) => {
+            const content = await fetchText(baseUrl, `/api/repo/tools/${name}/tool.json`, apiKey);
+            if (!content)
+                return null;
+            let raw;
+            try {
+                raw = JSON.parse(content);
+            }
+            catch {
+                return null;
+            }
+            const parsed = ToolJsonSchema.safeParse(raw);
+            if (!parsed.success)
+                return null;
+            const toolJson = parsed.data;
+            const tool = {
+                name: toolJson.name ?? name,
+                description: toolJson.description,
+                parameters: toolJson.parameters,
+                confirm: toolJson.confirm,
+                timeout: toolJson.timeout,
+                env: toolJson.env,
+                handlerPath: `${baseUrl}/api/repo/tools/${name}/handler`,
+                location: `${baseUrl}/api/repo/tools/${name}`,
+                hasPackageJson: false,
+                hasSetupScript: false,
+                hasRequirementsTxt: false,
+                hasDockerfile: false,
+                sandboxLanguage: toolJson.sandbox?.language ?? 'typescript',
+            };
+            if (toolJson.responseShaping) {
+                tool.responseShaping = toolJson.responseShaping;
+            }
+            return tool;
+        })).then((results) => results.filter((t) => t !== null)),
+    ]);
+    return {
+        source: 'platform',
+        origin: baseUrl,
+        config,
+        connections,
+        skills,
+        agents,
+        knowledge,
+        automations,
+        evals,
+        tools,
+        stores: [],
+    };
+}
+//# sourceMappingURL=platform-reader.js.map

package/dist/src/repo/platform-reader.js.map

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

package/dist/src/repo/repo-loader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AmodalRepo, RepoLoadOptions } from './repo-types.js';
+/**
+ * Load an amodal repo from either local disk or the platform API.
+ *
+ * - If `localPath` is set, reads from disk.
+ * - Else if `platformUrl` + `platformApiKey` are set, fetches from the platform.
+ * - Otherwise throws CONFIG_NOT_FOUND.
+ */
+export declare function loadRepo(options: RepoLoadOptions): Promise<AmodalRepo>;

package/dist/src/repo/repo-loader.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { RepoError } from './repo-types.js';
+import { loadRepoFromDisk } from './local-reader.js';
+import { loadRepoFromPlatform } from './platform-reader.js';
+/**
+ * Load an amodal repo from either local disk or the platform API.
+ *
+ * - If `localPath` is set, reads from disk.
+ * - Else if `platformUrl` + `platformApiKey` are set, fetches from the platform.
+ * - Otherwise throws CONFIG_NOT_FOUND.
+ */
+export async function loadRepo(options) {
+    if (options.localPath) {
+        return loadRepoFromDisk(options.localPath);
+    }
+    if (options.platformUrl && options.platformApiKey) {
+        return loadRepoFromPlatform(options.platformUrl, options.platformApiKey);
+    }
+    throw new RepoError('CONFIG_NOT_FOUND', 'No repo source configured. Provide either localPath or platformUrl + platformApiKey.');
+}
+//# sourceMappingURL=repo-loader.js.map

package/dist/src/repo/repo-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-loader.js","sourceRoot":"","sources":["../../../src/repo/repo-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACrD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAClD,OAAO,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,IAAI,SAAS,CACjB,kBAAkB,EAClB,sFAAsF,CACvF,CAAC;AACJ,CAAC"}

package/dist/src/repo/repo-types.d.ts

@@ -0,0 +1,159 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AmodalConfig } from './config-schema.js';
+import type { LoadedConnection } from './connection-types.js';
+import type { LoadedStore } from './store-types.js';
+import type { LoadedTool } from './tool-types.js';
+/**
+ * Error codes for repo loading failures.
+ */
+export type RepoErrorCode = 'CONFIG_NOT_FOUND' | 'CONFIG_PARSE_FAILED' | 'CONFIG_VALIDATION_FAILED' | 'ENV_NOT_SET' | 'READ_FAILED' | 'PLATFORM_FETCH_FAILED';
+/**
+ * Error thrown during repo loading.
+ */
+export declare class RepoError extends Error {
+    readonly code: RepoErrorCode;
+    constructor(code: RepoErrorCode, message: string, cause?: unknown);
+}
+/**
+ * A loaded skill definition.
+ */
+export interface LoadedSkill {
+    name: string;
+    description: string;
+    trigger?: string;
+    body: string;
+    location: string;
+}
+/**
+ * A loaded knowledge document.
+ */
+export interface LoadedKnowledge {
+    name: string;
+    title: string;
+    body: string;
+    location: string;
+}
+/**
+ * A loaded automation definition.
+ */
+export interface LoadedAutomation {
+    name: string;
+    title: string;
+    /** Cron schedule (e.g., "0 9 * * 1-5"). Omit for webhook or manual trigger. */
+    schedule?: string;
+    /** Trigger type: cron (scheduled), webhook (external POST), or manual (API/CLI). */
+    trigger: 'cron' | 'webhook' | 'manual';
+    /** The prompt sent to the agent when the automation fires. */
+    prompt: string;
+    location: string;
+}
+/**
+ * A loaded agent (subagent) definition from agents/ directory.
+ * Each subdirectory in agents/ defines a subagent. The reserved names
+ * "explore" and "plan" override the default explore and plan agents.
+ */
+export interface LoadedAgent {
+    /** Agent name (directory name, used for dispatch) */
+    name: string;
+    /** Display name for admin UI */
+    displayName: string;
+    /** Short description */
+    description: string;
+    /** Prompt template (from AGENT.md body) */
+    prompt: string;
+    /** Tools this agent can use */
+    tools: string[];
+    /** Max dispatch depth (1 = no sub-agents) */
+    maxDepth: number;
+    /** Max tool calls per execution */
+    maxToolCalls: number;
+    /** Timeout in seconds */
+    timeout: number;
+    /** Target output token range */
+    targetOutputMin: number;
+    targetOutputMax: number;
+    /** Model tier: 'simple' for data gathering, 'advanced' for reasoning */
+    modelTier?: 'default' | 'simple' | 'advanced';
+    /** File path */
+    location: string;
+}
+/**
+ * A loaded eval definition.
+ */
+export interface LoadedEval {
+    name: string;
+    title: string;
+    description: string;
+    setup: {
+        tenant?: string;
+        context?: string;
+    };
+    query: string;
+    assertions: Array<{
+        text: string;
+        negated: boolean;
+    }>;
+    raw: string;
+    location: string;
+}
+/**
+ * The fully loaded amodal repo — the complete runtime configuration.
+ */
+export interface AmodalRepo {
+    /** Where the repo was loaded from */
+    source: 'local' | 'platform';
+    /** Absolute path (local) or platform API URL */
+    origin: string;
+    /** Parsed config */
+    config: AmodalConfig;
+    /** Loaded connections keyed by name */
+    connections: Map<string, LoadedConnection>;
+    /** Loaded skills */
+    skills: LoadedSkill[];
+    /** Agent overrides (simple, plan) and custom subagent definitions */
+    agents: {
+        main?: string;
+        simple?: string;
+        subagents: LoadedAgent[];
+    };
+    /** Loaded automations */
+    automations: LoadedAutomation[];
+    /** Knowledge documents */
+    knowledge: LoadedKnowledge[];
+    /** Eval definitions */
+    evals: LoadedEval[];
+    /** Custom tools from tools/ directory */
+    tools: LoadedTool[];
+    /** Store definitions from stores/ directory */
+    stores: LoadedStore[];
+    /** MCP servers to connect to */
+    mcpServers?: Record<string, RepoMcpServerConfig>;
+    /** Warnings from package resolution */
+    warnings?: string[];
+}
+/**
+ * MCP server configuration as stored in the repo.
+ */
+export interface RepoMcpServerConfig {
+    transport: 'stdio' | 'sse' | 'http';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    trust?: boolean;
+}
+/**
+ * Options for loading an amodal repo.
+ */
+export interface RepoLoadOptions {
+    /** Path to local amodal repo on disk */
+    localPath?: string;
+    /** Platform API URL for remote repo access */
+    platformUrl?: string;
+    /** Platform API key */
+    platformApiKey?: string;
+}

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Error thrown during repo loading.
+ */
+export class RepoError extends Error {
+    code;
+    constructor(code, message, cause) {
+        super(message, { cause });
+        this.name = 'RepoError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=repo-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo-types.js","sourceRoot":"","sources":["../../../src/repo/repo-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAgB;IAE7B,YAAY,IAAmB,EAAE,OAAe,EAAE,KAAe;QAC/D,KAAK,CAAC,OAAO,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/src/repo/spec-syncer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { LoadedConnection } from './connection-types.js';
+import type { ParsedEndpoint } from './openapi-parser.js';
+import type { SurfaceEndpoint } from './connection-types.js';
+import type { EndpointChange } from './drift-detector.js';
+export interface SyncPlan {
+    connectionName: string;
+    added: Array<ParsedEndpoint | {
+        name: string;
+        operationType: string;
+    }>;
+    removed: SurfaceEndpoint[];
+    changed: Array<EndpointChange | {
+        name: string;
+        operationType: string;
+        changes: string[];
+    }>;
+    unchanged: string[];
+}
+/**
+ * Build a sync plan for a connection by fetching its spec
+ * and comparing against the current surface endpoints.
+ *
+ * Supports OpenAPI and GraphQL connections.
+ */
+export declare function buildSyncPlan(connection: LoadedConnection): Promise<SyncPlan>;

package/dist/src/repo/spec-syncer.js

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { fetchAndParseSpec } from './openapi-parser.js';
+import { detectDrift } from './drift-detector.js';
+import { fetchAndParseGraphQLSchema } from './graphql-parser.js';
+import { detectGraphQLDrift } from './graphql-drift-detector.js';
+/**
+ * Build a sync plan for a connection by fetching its spec
+ * and comparing against the current surface endpoints.
+ *
+ * Supports OpenAPI and GraphQL connections.
+ */
+export async function buildSyncPlan(connection) {
+    if (connection.spec.format === 'graphql') {
+        return buildGraphQLSyncPlan(connection);
+    }
+    // Only sync OpenAPI connections
+    if (connection.spec.format !== 'openapi') {
+        return {
+            connectionName: connection.name,
+            added: [],
+            removed: [],
+            changed: [],
+            unchanged: connection.surface.map((ep) => `${ep.method} ${ep.path}`),
+        };
+    }
+    // Derive spec URL from the source base URL
+    const baseUrl = connection.spec.source.replace(/\/$/, '');
+    const specUrl = `${baseUrl}/openapi.json`;
+    // Build auth for the spec fetch
+    let auth;
+    if (connection.spec.auth) {
+        const token = connection.spec.auth.token ?? '';
+        if (connection.spec.auth.type === 'bearer') {
+            auth = {
+                header: connection.spec.auth.header ?? 'Authorization',
+                value: `${connection.spec.auth.prefix ?? 'Bearer'} ${token}`,
+            };
+        }
+        else if (connection.spec.auth.type === 'api-key') {
+            auth = {
+                header: connection.spec.auth.header ?? 'X-API-Key',
+                value: token,
+            };
+        }
+    }
+    const specEndpoints = await fetchAndParseSpec(specUrl, auth);
+    // Only compare included surface endpoints
+    const includedSurface = connection.surface.filter((ep) => ep.included);
+    const drift = detectDrift(specEndpoints, includedSurface);
+    return {
+        connectionName: connection.name,
+        ...drift,
+    };
+}
+async function buildGraphQLSyncPlan(connection) {
+    const baseUrl = connection.spec.source.replace(/\/$/, '');
+    let auth;
+    if (connection.spec.auth) {
+        const token = connection.spec.auth.token ?? '';
+        if (connection.spec.auth.type === 'bearer') {
+            auth = {
+                header: connection.spec.auth.header ?? 'Authorization',
+                value: `${connection.spec.auth.prefix ?? 'Bearer'} ${token}`,
+            };
+        }
+        else if (connection.spec.auth.type === 'api-key') {
+            auth = {
+                header: connection.spec.auth.header ?? 'X-API-Key',
+                value: token,
+            };
+        }
+    }
+    const schemaOps = await fetchAndParseGraphQLSchema(baseUrl, auth);
+    const includedSurface = connection.surface.filter((ep) => ep.included);
+    const drift = detectGraphQLDrift(schemaOps, includedSurface);
+    return {
+        connectionName: connection.name,
+        ...drift,
+    };
+}
+//# sourceMappingURL=spec-syncer.js.map

package/dist/src/repo/spec-syncer.js.map

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

package/dist/src/repo/store-loader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { LoadedStore } from './store-types.js';
+/**
+ * Parse a store JSON string into a LoadedStore.
+ */
+export declare function parseStoreJson(jsonString: string, fileName: string, location: string): LoadedStore;
+/**
+ * Load all store definitions from the stores/ directory.
+ *
+ * Each .json file in stores/ defines a store. The filename (without extension)
+ * becomes the store name unless overridden by a "name" field in the JSON.
+ *
+ * Missing stores/ directory returns [].
+ */
+export declare function loadStores(repoPath: string): Promise<LoadedStore[]>;