@amodalai/core 0.1.0

package/dist/src/mcp/mcp-manager.js.map

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

package/dist/src/packages/config-deps.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { PackageType } from './package-types.js';
+/**
+ * Read the dependencies map from amodal.json.
+ * Returns an empty record if no dependencies field exists.
+ */
+export declare function readConfigDeps(repoPath: string): Promise<Record<string, string>>;
+/**
+ * Add or update a dependency in amodal.json.
+ * Writes a caret range (^version) by default.
+ */
+export declare function addConfigDep(repoPath: string, type: PackageType, name: string, version: string): Promise<void>;
+/**
+ * Remove a dependency from amodal.json.
+ */
+export declare function removeConfigDep(repoPath: string, type: PackageType, name: string): Promise<void>;

package/dist/src/packages/config-deps.js

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { PackageError } from './package-error.js';
+import { packageKey } from './package-types.js';
+const CONFIG_FILENAME = 'amodal.json';
+/**
+ * Read the dependencies map from amodal.json.
+ * Returns an empty record if no dependencies field exists.
+ */
+export async function readConfigDeps(repoPath) {
+    const configPath = path.join(repoPath, CONFIG_FILENAME);
+    let raw;
+    try {
+        const content = await readFile(configPath, 'utf-8');
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        raw = JSON.parse(content);
+    }
+    catch (err) {
+        throw new PackageError('LOCK_READ_FAILED', `Failed to read ${CONFIG_FILENAME}`, err);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    return raw['dependencies'] ?? {};
+}
+/**
+ * Add or update a dependency in amodal.json.
+ * Writes a caret range (^version) by default.
+ */
+export async function addConfigDep(repoPath, type, name, version) {
+    const configPath = path.join(repoPath, CONFIG_FILENAME);
+    let raw;
+    try {
+        const content = await readFile(configPath, 'utf-8');
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        raw = JSON.parse(content);
+    }
+    catch (err) {
+        throw new PackageError('LOCK_WRITE_FAILED', `Failed to read ${CONFIG_FILENAME}`, err);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    const deps = raw['dependencies'] ?? {};
+    const key = packageKey(type, name);
+    deps[key] = `^${version}`;
+    raw['dependencies'] = deps;
+    await writeFile(configPath, JSON.stringify(raw, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Remove a dependency from amodal.json.
+ */
+export async function removeConfigDep(repoPath, type, name) {
+    const configPath = path.join(repoPath, CONFIG_FILENAME);
+    let raw;
+    try {
+        const content = await readFile(configPath, 'utf-8');
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        raw = JSON.parse(content);
+    }
+    catch (err) {
+        throw new PackageError('LOCK_WRITE_FAILED', `Failed to read ${CONFIG_FILENAME}`, err);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    const deps = raw['dependencies'] ?? {};
+    const key = packageKey(type, name);
+    delete deps[key];
+    if (Object.keys(deps).length > 0) {
+        raw['dependencies'] = deps;
+    }
+    else {
+        delete raw['dependencies'];
+    }
+    await writeFile(configPath, JSON.stringify(raw, null, 2) + '\n', 'utf-8');
+}
+//# sourceMappingURL=config-deps.js.map

package/dist/src/packages/config-deps.js.map

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

package/dist/src/packages/env-file.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Parse .env file content into a Map of key-value pairs.
+ * Handles KEY=value, quoted values, and comments.
+ */
+export declare function parseEnvContent(content: string): Map<string, string>;
+/**
+ * Serialize a Map of entries back to .env format.
+ */
+export declare function serializeEnvEntries(entries: Map<string, string>): string;
+/**
+ * Read and parse a .env file. Returns empty map if file doesn't exist.
+ */
+export declare function readEnvFile(filePath: string): Promise<Map<string, string>>;
+/**
+ * Upsert entries into a .env file.
+ * Preserves existing comments and blank lines.
+ * Updates values in-place for existing keys, appends new keys at end.
+ */
+export declare function upsertEnvEntries(filePath: string, entries: Record<string, string>): Promise<void>;
+/**
+ * Find which required env vars are missing from a .env file.
+ */
+export declare function findMissingEnvVars(envFilePath: string, required: string[]): Promise<string[]>;

package/dist/src/packages/env-file.js

@@ -0,0 +1,143 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { readFile, rename, writeFile } from 'node:fs/promises';
+import { PackageError } from './package-error.js';
+/**
+ * Parse .env file content into a Map of key-value pairs.
+ * Handles KEY=value, quoted values, and comments.
+ */
+export function parseEnvContent(content) {
+    const entries = new Map();
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip empty lines and comments
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx < 0)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        if (!key)
+            continue;
+        let value = trimmed.slice(eqIdx + 1).trim();
+        // Strip surrounding quotes
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        entries.set(key, value);
+    }
+    return entries;
+}
+/**
+ * Serialize a Map of entries back to .env format.
+ */
+export function serializeEnvEntries(entries) {
+    const lines = [];
+    for (const [key, value] of entries) {
+        // Quote values that contain spaces, #, or special chars
+        if (/[\s#"'\\]/.test(value)) {
+            lines.push(`${key}="${value}"`);
+        }
+        else {
+            lines.push(`${key}=${value}`);
+        }
+    }
+    return lines.length > 0 ? lines.join('\n') + '\n' : '';
+}
+/**
+ * Read and parse a .env file. Returns empty map if file doesn't exist.
+ */
+export async function readEnvFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return parseEnvContent(content);
+    }
+    catch (err) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        if (err.code === 'ENOENT') {
+            return new Map();
+        }
+        throw new PackageError('ENV_READ_FAILED', `Failed to read ${filePath}`, err);
+    }
+}
+/**
+ * Upsert entries into a .env file.
+ * Preserves existing comments and blank lines.
+ * Updates values in-place for existing keys, appends new keys at end.
+ */
+export async function upsertEnvEntries(filePath, entries) {
+    let existingContent = '';
+    try {
+        existingContent = await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        if (err.code !== 'ENOENT') {
+            throw new PackageError('ENV_READ_FAILED', `Failed to read ${filePath}`, err);
+        }
+    }
+    const remaining = new Map(Object.entries(entries));
+    const lines = existingContent ? existingContent.split('\n') : [];
+    const outputLines = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Check if this line is a key=value that we need to update
+        if (trimmed && !trimmed.startsWith('#')) {
+            const eqIdx = trimmed.indexOf('=');
+            if (eqIdx >= 0) {
+                const key = trimmed.slice(0, eqIdx).trim();
+                if (remaining.has(key)) {
+                    const newValue = remaining.get(key);
+                    remaining.delete(key);
+                    if (/[\s#"'\\]/.test(newValue)) {
+                        outputLines.push(`${key}="${newValue}"`);
+                    }
+                    else {
+                        outputLines.push(`${key}=${newValue}`);
+                    }
+                    continue;
+                }
+            }
+        }
+        outputLines.push(line);
+    }
+    // Append new entries
+    for (const [key, value] of remaining) {
+        if (/[\s#"'\\]/.test(value)) {
+            outputLines.push(`${key}="${value}"`);
+        }
+        else {
+            outputLines.push(`${key}=${value}`);
+        }
+    }
+    let content = outputLines.join('\n');
+    // Ensure trailing newline
+    if (!content.endsWith('\n')) {
+        content += '\n';
+    }
+    // Atomic write
+    const tmpPath = `${filePath}.tmp`;
+    try {
+        await writeFile(tmpPath, content, 'utf-8');
+        await rename(tmpPath, filePath);
+    }
+    catch (err) {
+        throw new PackageError('ENV_WRITE_FAILED', `Failed to write ${filePath}`, err);
+    }
+}
+/**
+ * Find which required env vars are missing from a .env file.
+ */
+export async function findMissingEnvVars(envFilePath, required) {
+    const entries = await readEnvFile(envFilePath);
+    return required.filter((key) => {
+        const value = entries.get(key);
+        return value === undefined || value === '';
+    });
+}
+//# sourceMappingURL=env-file.js.map

package/dist/src/packages/env-file.js.map

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

package/dist/src/packages/frontmatter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Result of parsing a markdown file with optional YAML frontmatter.
+ */
+export interface ParsedMarkdown {
+    frontmatter: Record<string, unknown> | null;
+    body: string;
+}
+/**
+ * Parse YAML frontmatter from a markdown string.
+ */
+export declare function parseMarkdownFrontmatter(content: string): ParsedMarkdown;
+/**
+ * Parse a JSON string that may contain an "import" key.
+ * Returns the import name (if present) and the data without the import key.
+ */
+export declare function parseJsonImport(jsonString: string): {
+    import?: string;
+    data: Record<string, unknown>;
+};
+/**
+ * Validate that surface frontmatter does not have both "only" and "exclude".
+ */
+export declare function validateSurfaceFrontmatter(fm: Record<string, unknown>): void;

package/dist/src/packages/frontmatter.js

@@ -0,0 +1,77 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import yaml from 'js-yaml';
+import { PackageError } from './package-error.js';
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---/;
+/**
+ * Parse YAML frontmatter from a markdown string.
+ */
+export function parseMarkdownFrontmatter(content) {
+    const match = FRONTMATTER_RE.exec(content);
+    if (!match) {
+        return { frontmatter: null, body: content };
+    }
+    const yamlStr = match[1];
+    const afterFrontmatter = content.slice(match[0].length);
+    // Strip leading newlines after the closing ---
+    const body = afterFrontmatter.replace(/^\r?\n/, '');
+    if (!yamlStr.trim()) {
+        return { frontmatter: {}, body };
+    }
+    let parsed;
+    try {
+        parsed = yaml.load(yamlStr);
+    }
+    catch (err) {
+        throw new PackageError('INVALID_FRONTMATTER', 'Failed to parse YAML frontmatter', err);
+    }
+    if (parsed === null || parsed === undefined) {
+        return { frontmatter: {}, body };
+    }
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new PackageError('INVALID_FRONTMATTER', 'Frontmatter must be a YAML mapping');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    return { frontmatter: parsed, body };
+}
+/**
+ * Parse a JSON string that may contain an "import" key.
+ * Returns the import name (if present) and the data without the import key.
+ */
+export function parseJsonImport(jsonString) {
+    let raw;
+    try {
+        raw = JSON.parse(jsonString);
+    }
+    catch (err) {
+        throw new PackageError('PARSE_FAILED', 'Invalid JSON', err);
+    }
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new PackageError('PARSE_FAILED', 'JSON must be an object');
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    const obj = raw;
+    const importName = typeof obj['import'] === 'string' ? obj['import'] : undefined;
+    // Return data without the import key
+    const data = {};
+    for (const key of Object.keys(obj)) {
+        if (key !== 'import') {
+            data[key] = obj[key];
+        }
+    }
+    return { import: importName, data };
+}
+/**
+ * Validate that surface frontmatter does not have both "only" and "exclude".
+ */
+export function validateSurfaceFrontmatter(fm) {
+    const hasOnly = Array.isArray(fm['only']) && fm['only'].length > 0;
+    const hasExclude = Array.isArray(fm['exclude']) && fm['exclude'].length > 0;
+    if (hasOnly && hasExclude) {
+        throw new PackageError('CONFLICTING_FILTER', 'surface.md frontmatter cannot have both "only" and "exclude" — use one or neither');
+    }
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/src/packages/frontmatter.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export * from './package-error.js';
+export * from './package-types.js';
+export * from './frontmatter.js';
+export * from './env-file.js';
+export * from './lock-file.js';
+export * from './npm-context.js';
+export * from './manifest-reader.js';
+export * from './merge-engine.js';
+export * from './resolver.js';
+export * from './npm-registry.js';
+export * from './config-deps.js';

package/dist/src/packages/index.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export * from './package-error.js';
+export * from './package-types.js';
+export * from './frontmatter.js';
+export * from './env-file.js';
+export * from './lock-file.js';
+export * from './npm-context.js';
+export * from './manifest-reader.js';
+export * from './merge-engine.js';
+export * from './resolver.js';
+export * from './npm-registry.js';
+export * from './config-deps.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packages/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/src/packages/lock-file.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { LockEntry, LockFile, PackageType } from './package-types.js';
+/**
+ * Read the lock file. Returns null if it doesn't exist (first install).
+ */
+export declare function readLockFile(repoPath: string): Promise<LockFile | null>;
+/**
+ * Write the lock file atomically.
+ */
+export declare function writeLockFile(repoPath: string, lock: LockFile): Promise<void>;
+/**
+ * Add or update a lock entry. Creates the lock file if needed.
+ */
+export declare function addLockEntry(repoPath: string, type: PackageType, name: string, entry: LockEntry): Promise<LockFile>;
+/**
+ * Remove a lock entry. Returns the updated lock file.
+ */
+export declare function removeLockEntry(repoPath: string, type: PackageType, name: string): Promise<LockFile>;
+/**
+ * Get a single lock entry. Returns null if not found.
+ */
+export declare function getLockEntry(repoPath: string, type: PackageType, name: string): Promise<LockEntry | null>;
+/**
+ * List lock entries, optionally filtered by type.
+ */
+export declare function listLockEntries(repoPath: string, type?: PackageType): Promise<Array<{
+    key: string;
+    type: PackageType;
+    name: string;
+    entry: LockEntry;
+}>>;

package/dist/src/packages/lock-file.js

@@ -0,0 +1,117 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { readFile, rename, writeFile, mkdir } from 'node:fs/promises';
+import * as path from 'node:path';
+import { PackageError } from './package-error.js';
+import { LockFileSchema, packageKey, parsePackageKey, } from './package-types.js';
+const LOCK_FILENAME = 'amodal.lock';
+/**
+ * Get the full path to the lock file for a repo.
+ */
+function lockFilePath(repoPath) {
+    return path.join(repoPath, LOCK_FILENAME);
+}
+/**
+ * Read the lock file. Returns null if it doesn't exist (first install).
+ */
+export async function readLockFile(repoPath) {
+    const filePath = lockFilePath(repoPath);
+    let content;
+    try {
+        content = 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 PackageError('LOCK_READ_FAILED', `Failed to read lock file: ${filePath}`, err);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(content);
+    }
+    catch (err) {
+        throw new PackageError('LOCK_READ_FAILED', `Invalid JSON in lock file: ${filePath}`, err);
+    }
+    const result = LockFileSchema.safeParse(raw);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `${i.path.join('.')}: ${i.message}`)
+            .join('; ');
+        throw new PackageError('LOCK_READ_FAILED', `Lock file validation failed: ${issues}`);
+    }
+    return result.data;
+}
+/**
+ * Write the lock file atomically.
+ */
+export async function writeLockFile(repoPath, lock) {
+    const filePath = lockFilePath(repoPath);
+    const dirPath = path.dirname(filePath);
+    try {
+        await mkdir(dirPath, { recursive: true });
+    }
+    catch {
+        // Directory may already exist
+    }
+    const content = JSON.stringify(lock, null, 2) + '\n';
+    const tmpPath = `${filePath}.tmp`;
+    try {
+        await writeFile(tmpPath, content, 'utf-8');
+        await rename(tmpPath, filePath);
+    }
+    catch (err) {
+        throw new PackageError('LOCK_WRITE_FAILED', `Failed to write lock file: ${filePath}`, err);
+    }
+}
+/**
+ * Add or update a lock entry. Creates the lock file if needed.
+ */
+export async function addLockEntry(repoPath, type, name, entry) {
+    const lock = (await readLockFile(repoPath)) ?? { lockVersion: 1, packages: {} };
+    const key = packageKey(type, name);
+    lock.packages[key] = entry;
+    await writeLockFile(repoPath, lock);
+    return lock;
+}
+/**
+ * Remove a lock entry. Returns the updated lock file.
+ */
+export async function removeLockEntry(repoPath, type, name) {
+    const lock = (await readLockFile(repoPath)) ?? { lockVersion: 1, packages: {} };
+    const key = packageKey(type, name);
+    delete lock.packages[key];
+    await writeLockFile(repoPath, lock);
+    return lock;
+}
+/**
+ * Get a single lock entry. Returns null if not found.
+ */
+export async function getLockEntry(repoPath, type, name) {
+    const lock = await readLockFile(repoPath);
+    if (!lock)
+        return null;
+    const key = packageKey(type, name);
+    return lock.packages[key] ?? null;
+}
+/**
+ * List lock entries, optionally filtered by type.
+ */
+export async function listLockEntries(repoPath, type) {
+    const lock = await readLockFile(repoPath);
+    if (!lock)
+        return [];
+    const results = [];
+    for (const [key, entry] of Object.entries(lock.packages)) {
+        const parsed = parsePackageKey(key);
+        if (type && parsed.type !== type)
+            continue;
+        results.push({ key, type: parsed.type, name: parsed.name, entry });
+    }
+    return results;
+}
+//# sourceMappingURL=lock-file.js.map

package/dist/src/packages/lock-file.js.map

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

package/dist/src/packages/manifest-reader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { PackageManifest } from './package-types.js';
+/**
+ * Read and validate the amodal manifest from an installed package directory.
+ */
+export declare function readPackageManifest(packageDir: string): Promise<PackageManifest>;
+/**
+ * Read a specific file from a package directory.
+ * Returns null if the file doesn't exist.
+ */
+export declare function readPackageFile(packageDir: string, filename: string): Promise<string | null>;
+/**
+ * List all files in a package directory.
+ */
+export declare function listPackageFiles(packageDir: string): Promise<string[]>;