@amodalai/core 0.1.0

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

@@ -0,0 +1,299 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { readFile, readdir, stat } from 'node:fs/promises';
+import * as path from 'node:path';
+import { RepoError } from './repo-types.js';
+import { parseAgent, parseConfig, parseConnection, parseSkill, parseKnowledge, parseAutomation, parseEval, } from './parsers.js';
+import { readLockFile } from '../packages/lock-file.js';
+import { resolveAllPackages } from '../packages/resolver.js';
+import { loadStores } from './store-loader.js';
+import { loadTools } from './tool-loader.js';
+/**
+ * Read a file from disk, returning null if it doesn't exist.
+ */
+async function readOptionalFile(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        if (err.code === 'ENOENT') {
+            return null;
+        }
+        throw new RepoError('READ_FAILED', `Failed to read ${filePath}`, err);
+    }
+}
+/**
+ * Read a required file from disk.
+ */
+async function readRequiredFile(filePath, errorMsg) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        if (err.code === 'ENOENT') {
+            throw new RepoError('CONFIG_NOT_FOUND', errorMsg, err);
+        }
+        throw new RepoError('READ_FAILED', `Failed to read ${filePath}`, err);
+    }
+}
+/**
+ * List subdirectories in a directory. Returns [] if dir doesn't exist.
+ */
+async function listSubdirs(dirPath) {
+    try {
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * List .md files in a directory. Returns [] if dir doesn't exist.
+ */
+async function listMdFiles(dirPath) {
+    try {
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isFile() && e.name.endsWith('.md'))
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Load a single connection from its directory.
+ */
+async function loadConnection(connDir, name) {
+    const specJson = await readRequiredFile(path.join(connDir, 'spec.json'), `Missing spec.json for connection "${name}"`);
+    const accessJson = await readRequiredFile(path.join(connDir, 'access.json'), `Missing access.json for connection "${name}"`);
+    const surfaceMd = await readOptionalFile(path.join(connDir, 'surface.md'));
+    const entitiesMd = await readOptionalFile(path.join(connDir, 'entities.md'));
+    const rulesMd = await readOptionalFile(path.join(connDir, 'rules.md'));
+    return parseConnection(name, {
+        specJson,
+        accessJson,
+        surfaceMd: surfaceMd ?? undefined,
+        entitiesMd: entitiesMd ?? undefined,
+        rulesMd: rulesMd ?? undefined,
+    }, connDir);
+}
+/**
+ * Load all connections from the connections/ directory.
+ */
+async function loadConnections(repoPath) {
+    const connectionsDir = path.join(repoPath, 'connections');
+    const dirs = await listSubdirs(connectionsDir);
+    const connections = new Map();
+    const loaded = await Promise.all(dirs.map(async (name) => {
+        const conn = await loadConnection(path.join(connectionsDir, name), name);
+        return [name, conn];
+    }));
+    for (const [name, conn] of loaded) {
+        connections.set(name, conn);
+    }
+    return connections;
+}
+/**
+ * Load all skills from the skills/ directory.
+ */
+async function loadSkills(repoPath) {
+    const skillsDir = path.join(repoPath, 'skills');
+    const dirs = await listSubdirs(skillsDir);
+    const skills = [];
+    const results = await Promise.all(dirs.map(async (name) => {
+        const skillPath = path.join(skillsDir, name, 'SKILL.md');
+        const content = await readOptionalFile(skillPath);
+        if (!content)
+            return null;
+        return parseSkill(content, skillPath);
+    }));
+    for (const result of results) {
+        if (result)
+            skills.push(result);
+    }
+    return skills;
+}
+/**
+ * Load agents from the agents/ directory.
+ *
+ * - agents/main/AGENT.md → overrides the primary agent prompt
+ * - agents/explore/AGENT.md → overrides the explore sub-agent prompt
+ * - agents/plan/AGENT.md → overrides the plan agent prompt
+ * - agents/<anything-else>/AGENT.md → defines a custom subagent
+ *
+ * Flat files agents/main.md and agents/simple.md are also supported.
+ */
+async function loadAgents(repoPath) {
+    const agentsDir = path.join(repoPath, 'agents');
+    const dirs = await listSubdirs(agentsDir);
+    // Check for flat files (main.md, simple.md)
+    const [mainFlat, simpleFlat] = await Promise.all([
+        readOptionalFile(path.join(agentsDir, 'main.md')),
+        readOptionalFile(path.join(agentsDir, 'simple.md')),
+    ]);
+    let main = mainFlat ?? undefined;
+    let simple = simpleFlat ?? undefined;
+    const subagents = [];
+    // Process subdirectories
+    const results = await Promise.all(dirs.map(async (name) => {
+        const agentPath = path.join(agentsDir, name, 'AGENT.md');
+        const content = await readOptionalFile(agentPath);
+        if (!content)
+            return null;
+        return { name, content, location: agentPath };
+    }));
+    for (const result of results) {
+        if (!result)
+            continue;
+        if (result.name === 'main') {
+            main = result.content;
+        }
+        else if (result.name === 'simple') {
+            simple = result.content;
+        }
+        else if (result.name === 'plan') {
+            const parsed = parseAgent(result.content, result.name, result.location);
+            if (parsed)
+                subagents.push(parsed);
+        }
+        else {
+            const parsed = parseAgent(result.content, result.name, result.location);
+            if (parsed)
+                subagents.push(parsed);
+        }
+    }
+    return { main, simple, subagents };
+}
+/**
+ * Load all knowledge files.
+ */
+async function loadKnowledgeFiles(repoPath) {
+    const knowledgeDir = path.join(repoPath, 'knowledge');
+    const files = await listMdFiles(knowledgeDir);
+    const results = await Promise.all(files.map(async (filename) => {
+        const filePath = path.join(knowledgeDir, filename);
+        const content = await readFile(filePath, 'utf-8');
+        const name = filename.replace(/\.md$/, '');
+        return parseKnowledge(content, name, filePath);
+    }));
+    return results;
+}
+/**
+ * Load all automation files.
+ */
+async function loadAutomations(repoPath) {
+    const autoDir = path.join(repoPath, 'automations');
+    // Support both .json (new) and .md (legacy) automation files
+    let files;
+    try {
+        const entries = await readdir(autoDir, { withFileTypes: true });
+        files = entries
+            .filter((e) => e.isFile() && (e.name.endsWith('.json') || e.name.endsWith('.md')))
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+    const results = await Promise.all(files.map(async (filename) => {
+        const filePath = path.join(autoDir, filename);
+        const content = await readFile(filePath, 'utf-8');
+        const name = filename.replace(/\.(json|md)$/, '');
+        return parseAutomation(content, name, filePath);
+    }));
+    return results;
+}
+/**
+ * Load all eval files.
+ */
+async function loadEvals(repoPath) {
+    const evalsDir = path.join(repoPath, 'evals');
+    const files = await listMdFiles(evalsDir);
+    const results = await Promise.all(files.map(async (filename) => {
+        const filePath = path.join(evalsDir, filename);
+        const content = await readFile(filePath, 'utf-8');
+        const name = filename.replace(/\.md$/, '');
+        return parseEval(content, name, filePath);
+    }));
+    return results;
+}
+/**
+ * Load the full amodal repo from disk.
+ */
+export async function loadRepoFromDisk(repoPath) {
+    const absolutePath = path.resolve(repoPath);
+    // Verify the path exists
+    try {
+        await stat(absolutePath);
+    }
+    catch {
+        throw new RepoError('CONFIG_NOT_FOUND', `Repo path does not exist: ${absolutePath}`);
+    }
+    // Read config (required)
+    const configPath = path.join(absolutePath, 'amodal.json');
+    const configJson = await readRequiredFile(configPath, `Missing amodal.json in ${absolutePath}`);
+    const config = parseConfig(configJson);
+    // Check for lock file to decide resolution strategy
+    let lockFile;
+    try {
+        lockFile = await readLockFile(absolutePath);
+    }
+    catch {
+        // Lock file read failed — fall through to direct load
+        lockFile = null;
+    }
+    let connections;
+    let skills;
+    let knowledge;
+    let automations;
+    let warnings;
+    if (lockFile && Object.keys(lockFile.packages).length > 0) {
+        // Package-aware resolution (merges npm packages + repo overrides)
+        const resolved = await resolveAllPackages({ repoPath: absolutePath, lockFile });
+        connections = resolved.connections;
+        skills = resolved.skills;
+        knowledge = resolved.knowledge;
+        automations = resolved.automations;
+        warnings = resolved.warnings.length > 0 ? resolved.warnings : undefined;
+    }
+    else {
+        // Direct load (no packages installed)
+        [connections, skills, knowledge, automations] = await Promise.all([
+            loadConnections(absolutePath),
+            loadSkills(absolutePath),
+            loadKnowledgeFiles(absolutePath),
+            loadAutomations(absolutePath),
+        ]);
+    }
+    // Agents, evals, tools, and stores always from disk (not package types)
+    const [agents, evals, tools, stores] = await Promise.all([
+        loadAgents(absolutePath),
+        loadEvals(absolutePath),
+        loadTools(absolutePath),
+        loadStores(absolutePath),
+    ]);
+    return {
+        source: 'local',
+        origin: absolutePath,
+        config,
+        connections,
+        skills,
+        agents,
+        knowledge,
+        automations,
+        evals,
+        tools,
+        stores,
+        mcpServers: config.mcp?.servers,
+        warnings,
+    };
+}
+//# sourceMappingURL=local-reader.js.map

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

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

package/dist/src/repo/openapi-parser.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * A parsed endpoint from an OpenAPI spec.
+ */
+export interface ParsedEndpoint {
+    method: string;
+    path: string;
+    summary?: string;
+    description?: string;
+    tags: string[];
+    parameters: ParsedParameter[];
+    deprecated: boolean;
+}
+export interface ParsedParameter {
+    name: string;
+    in: 'query' | 'path' | 'header' | 'cookie';
+    required: boolean;
+    type?: string;
+    description?: string;
+}
+/**
+ * Parse an OpenAPI 3.0/3.1 spec object into a flat list of endpoints.
+ */
+export declare function parseOpenAPISpec(spec: unknown): ParsedEndpoint[];
+/**
+ * Fetch an OpenAPI spec from a URL and parse it.
+ */
+export declare function fetchAndParseSpec(url: string, auth?: {
+    header: string;
+    value: string;
+}): Promise<ParsedEndpoint[]>;

package/dist/src/repo/openapi-parser.js

@@ -0,0 +1,93 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+const HTTP_METHODS = new Set(['get', 'post', 'put', 'patch', 'delete', 'head', 'options']);
+/**
+ * Parse an OpenAPI 3.0/3.1 spec object into a flat list of endpoints.
+ */
+export function parseOpenAPISpec(spec) {
+    if (!spec || typeof spec !== 'object') {
+        return [];
+    }
+    const apiSpec = spec;
+    if (!apiSpec.paths) {
+        return [];
+    }
+    const version = apiSpec.openapi ?? '';
+    if (!version.startsWith('3.')) {
+        // Only support OpenAPI 3.x
+        return [];
+    }
+    const endpoints = [];
+    for (const [path, pathItem] of Object.entries(apiSpec.paths)) {
+        if (!pathItem || typeof pathItem !== 'object')
+            continue;
+        for (const [method, operation] of Object.entries(pathItem)) {
+            if (!HTTP_METHODS.has(method.toLowerCase()))
+                continue;
+            if (!operation || typeof operation !== 'object')
+                continue;
+            const op = operation;
+            const parameters = [];
+            if (Array.isArray(op.parameters)) {
+                for (const param of op.parameters) {
+                    if (param.name && param.in) {
+                        parameters.push({
+                            name: param.name,
+                            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- SDK boundary
+                            in: param.in,
+                            required: param.required ?? false,
+                            type: param.schema?.type,
+                            description: param.description,
+                        });
+                    }
+                }
+            }
+            endpoints.push({
+                method: method.toUpperCase(),
+                path,
+                summary: op.summary,
+                description: op.description,
+                tags: op.tags ?? [],
+                parameters,
+                deprecated: op.deprecated ?? false,
+            });
+        }
+    }
+    return endpoints;
+}
+/**
+ * Fetch an OpenAPI spec from a URL and parse it.
+ */
+export async function fetchAndParseSpec(url, auth) {
+    const headers = {
+        'Accept': 'application/json, application/yaml',
+    };
+    if (auth) {
+        headers[auth.header] = auth.value;
+    }
+    const response = await fetch(url, { headers });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch spec from ${url}: HTTP ${response.status}`);
+    }
+    const contentType = response.headers.get('content-type') ?? '';
+    const text = await response.text();
+    let parsed;
+    if (contentType.includes('yaml') || url.endsWith('.yaml') || url.endsWith('.yml')) {
+        // Dynamic import for YAML support
+        try {
+            const yaml = await import('js-yaml');
+            parsed = yaml.load(text);
+        }
+        catch {
+            throw new Error('js-yaml is required for YAML spec parsing. Install it with: pnpm add js-yaml');
+        }
+    }
+    else {
+        parsed = JSON.parse(text);
+    }
+    return parseOpenAPISpec(parsed);
+}
+//# sourceMappingURL=openapi-parser.js.map

package/dist/src/repo/openapi-parser.js.map

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

package/dist/src/repo/parsers.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { parseConfigJson } from './config-schema.js';
+import type { AccessConfig, ConnectionSpec } from './connection-schemas.js';
+import type { LoadedConnection } from './connection-types.js';
+import type { LoadedAgent, LoadedAutomation, LoadedEval, LoadedKnowledge, LoadedSkill } from './repo-types.js';
+export { parseConfigJson as parseConfig };
+/**
+ * Parse spec.json content into a validated ConnectionSpec.
+ */
+export declare function parseSpecJson(jsonString: string): ConnectionSpec;
+/**
+ * Parse access.json content into a validated AccessConfig.
+ */
+export declare function parseAccessJson(jsonString: string): AccessConfig;
+/**
+ * Parse a full connection from raw file contents.
+ */
+export declare function parseConnection(name: string, files: {
+    specJson: string;
+    accessJson: string;
+    surfaceMd?: string;
+    entitiesMd?: string;
+    rulesMd?: string;
+}, location: string): LoadedConnection;
+/**
+ * Parse SKILL.md content. Supports both heading-based and frontmatter formats.
+ * Returns null if neither format matches.
+ */
+export declare function parseSkill(content: string, location: string): LoadedSkill | null;
+/**
+ * Parse a knowledge markdown file.
+ */
+export declare function parseKnowledge(content: string, name: string, location: string): LoadedKnowledge;
+/**
+ * Parse an automation JSON file.
+ *
+ * Expected format:
+ * ```json
+ * {
+ *   "title": "Daily Revenue Digest",
+ *   "schedule": "0 9 * * 1-5",
+ *   "prompt": "Pull yesterday's revenue data..."
+ * }
+ * ```
+ *
+ * - If `schedule` is present, trigger defaults to `"cron"`.
+ * - If `trigger` is `"webhook"`, no schedule is needed.
+ * - If neither, trigger defaults to `"manual"`.
+ */
+export declare function parseAutomation(content: string, name: string, location: string): LoadedAutomation;
+/**
+ * Parse an eval markdown file.
+ */
+export declare function parseEval(content: string, name: string, location: string): LoadedEval;
+/**
+ * Parse AGENT.md content into a LoadedAgent.
+ *
+ * Supports heading-based and frontmatter formats (same patterns as skills).
+ *
+ * Heading-based:
+ * ```
+ * # Agent: Compliance Checker
+ *
+ * Checks regulatory compliance across transactions.
+ *
+ * ## Prompt
+ *
+ * Load compliance KB docs and check the requested entities...
+ * ```
+ *
+ * Frontmatter:
+ * ```
+ * ---
+ * name: compliance-checker
+ * displayName: Compliance Checker
+ * description: Checks regulatory compliance
+ * tools: [shell_exec, load_knowledge]
+ * maxDepth: 1
+ * maxToolCalls: 10
+ * timeout: 30
+ * modelTier: simple
+ * ---
+ *
+ * Load compliance KB docs and check...
+ * ```
+ */
+export declare function parseAgent(content: string, dirName: string, location: string): LoadedAgent | null;