@amodalai/core 0.1.0

package/dist/src/packages/manifest-reader.js

@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import * as path from 'node:path';
+import { ZodError } from 'zod';
+import { PackageError } from './package-error.js';
+import { PackageManifestSchema } from './package-types.js';
+/**
+ * Read and validate the amodal manifest from an installed package directory.
+ */
+export async function readPackageManifest(packageDir) {
+    const pkgJsonPath = path.join(packageDir, 'package.json');
+    let content;
+    try {
+        content = await readFile(pkgJsonPath, 'utf-8');
+    }
+    catch (err) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        if (err.code === 'ENOENT') {
+            throw new PackageError('NOT_FOUND', `Missing package.json in ${packageDir}`);
+        }
+        throw new PackageError('PARSE_FAILED', `Failed to read ${pkgJsonPath}`, err);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(content);
+    }
+    catch (err) {
+        throw new PackageError('PARSE_FAILED', `Invalid JSON in ${pkgJsonPath}`, err);
+    }
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new PackageError('PARSE_FAILED', `package.json is not an object in ${packageDir}`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    const pkg = raw;
+    const amodal = pkg['amodal'];
+    if (!amodal || typeof amodal !== 'object') {
+        throw new PackageError('VALIDATION_FAILED', `Missing or invalid "amodal" block in ${pkgJsonPath}`);
+    }
+    try {
+        return PackageManifestSchema.parse(amodal);
+    }
+    catch (err) {
+        if (err instanceof ZodError) {
+            const issues = err.issues
+                .map((i) => `${i.path.join('.')}: ${i.message}`)
+                .join('; ');
+            throw new PackageError('VALIDATION_FAILED', `Invalid amodal manifest in ${pkgJsonPath}: ${issues}`, err);
+        }
+        throw new PackageError('VALIDATION_FAILED', `Manifest validation failed in ${packageDir}`, err);
+    }
+}
+/**
+ * Read a specific file from a package directory.
+ * Returns null if the file doesn't exist.
+ */
+export async function readPackageFile(packageDir, filename) {
+    const filePath = path.join(packageDir, filename);
+    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 PackageError('NOT_FOUND', `Failed to read ${filePath}`, err);
+    }
+}
+/**
+ * List all files in a package directory.
+ */
+export async function listPackageFiles(packageDir) {
+    try {
+        const entries = await readdir(packageDir, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isFile())
+            .map((e) => e.name);
+    }
+    catch (err) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        if (err.code === 'ENOENT') {
+            return [];
+        }
+        throw new PackageError('NOT_FOUND', `Failed to list files in ${packageDir}`, err);
+    }
+}
+//# sourceMappingURL=manifest-reader.js.map

package/dist/src/packages/manifest-reader.js.map

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

package/dist/src/packages/merge-engine.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AccessConfig } from '../repo/connection-schemas.js';
+import type { ConnectionSpec } from '../repo/connection-schemas.js';
+import type { SurfaceEndpoint } from '../repo/connection-types.js';
+/**
+ * Deep merge two objects. Local values win. Arrays are replaced entirely.
+ */
+export declare function deepMergeLocalWins(base: Record<string, unknown>, local: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Merge a local spec.json override on top of a package base.
+ */
+export declare function mergeSpecJson(baseJson: string, localJson: string): ConnectionSpec;
+type ConfirmTier = undefined | true | 'review' | 'never';
+/**
+ * Filter endpoints by only/exclude lists from frontmatter.
+ */
+export declare function filterEndpoints(endpoints: SurfaceEndpoint[], frontmatter: Record<string, unknown>): SurfaceEndpoint[];
+/**
+ * Merge a local surface.md override on top of a package base.
+ */
+export declare function mergeSurface(baseMd: string, localMd: string): string;
+/**
+ * Return the tighter of two confirmation tiers.
+ */
+export declare function tighterConfirm(base: ConfirmTier, local: ConfirmTier): ConfirmTier;
+type FieldPolicy = 'role_gated' | 'retrieve_but_redact' | 'never_retrieve';
+/**
+ * Return the tighter of two field restriction policies.
+ */
+export declare function tighterPolicy(base: FieldPolicy, local: FieldPolicy): FieldPolicy;
+/**
+ * Narrow roles by intersection. undefined means "no restriction" (all roles).
+ */
+export declare function narrowRoles(base?: string[], local?: string[]): string[] | undefined;
+/**
+ * Merge a local access.json override on top of a package base.
+ * Local overrides take precedence — the user's repo is the final word.
+ */
+export declare function mergeAccessJson(baseJson: string, localJson: string): AccessConfig;
+/**
+ * Extract ### heading sections from markdown content.
+ * Returns a Map of heading text → section content (without the heading line).
+ * Also returns the preamble (content before the first ### heading).
+ */
+export declare function extractHeadingSections(content: string): {
+    preamble: string;
+    sections: Map<string, string>;
+};
+/**
+ * Merge entities.md: local ### sections replace matching base sections.
+ * Unmatched base sections pass through.
+ */
+export declare function mergeEntities(baseMd: string, localMd: string): string;
+/**
+ * Concatenate package base with local additions.
+ * Package content first, blank line separator, local body (frontmatter stripped).
+ */
+export declare function mergeConcatenation(baseMd: string, localMd: string): string;
+export {};

package/dist/src/packages/merge-engine.js

@@ -0,0 +1,357 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { AccessConfigSchema, ConnectionSpecSchema } from '../repo/connection-schemas.js';
+import { parseSurface } from '../repo/surface-parser.js';
+import { parseJsonImport, parseMarkdownFrontmatter, validateSurfaceFrontmatter } from './frontmatter.js';
+import { PackageError } from './package-error.js';
+// --- spec.json merge: deep merge, local wins, arrays replaced ---
+/**
+ * Deep merge two objects. Local values win. Arrays are replaced entirely.
+ */
+export function deepMergeLocalWins(base, local) {
+    const result = { ...base };
+    for (const key of Object.keys(local)) {
+        const baseVal = base[key];
+        const localVal = local[key];
+        if (localVal !== null &&
+            typeof localVal === 'object' &&
+            !Array.isArray(localVal) &&
+            baseVal !== null &&
+            typeof baseVal === 'object' &&
+            !Array.isArray(baseVal)) {
+            // Recurse for nested objects
+            result[key] = deepMergeLocalWins(
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            baseVal, 
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            localVal);
+        }
+        else {
+            // Local wins (arrays replaced entirely)
+            result[key] = localVal;
+        }
+    }
+    return result;
+}
+/**
+ * Merge a local spec.json override on top of a package base.
+ */
+export function mergeSpecJson(baseJson, localJson) {
+    const { data: localData } = parseJsonImport(localJson);
+    let baseRaw;
+    try {
+        baseRaw = JSON.parse(baseJson);
+    }
+    catch (err) {
+        throw new PackageError('PARSE_FAILED', 'Invalid JSON in base spec.json', err);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    const merged = deepMergeLocalWins(baseRaw, localData);
+    return ConnectionSpecSchema.parse(merged);
+}
+const CONFIRM_RANK = {
+    undefined: 0,
+    true: 1,
+    review: 2,
+    never: 3,
+};
+/**
+ * Filter endpoints by only/exclude lists from frontmatter.
+ */
+export function filterEndpoints(endpoints, frontmatter) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    const only = frontmatter['only'];
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    const exclude = frontmatter['exclude'];
+    if (Array.isArray(only) && only.length > 0) {
+        const set = new Set(only);
+        return endpoints.filter((ep) => set.has(`${ep.method} ${ep.path}`));
+    }
+    if (Array.isArray(exclude) && exclude.length > 0) {
+        const set = new Set(exclude);
+        return endpoints.filter((ep) => !set.has(`${ep.method} ${ep.path}`));
+    }
+    return endpoints;
+}
+const ENDPOINT_HEADING_RE = /^###\s+(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s+(\S+)/;
+/**
+ * Merge a local surface.md override on top of a package base.
+ */
+export function mergeSurface(baseMd, localMd) {
+    const { frontmatter, body } = parseMarkdownFrontmatter(localMd);
+    if (frontmatter) {
+        validateSurfaceFrontmatter(frontmatter);
+    }
+    // Parse and filter base endpoints
+    let baseEndpoints = parseSurface(baseMd);
+    if (frontmatter) {
+        baseEndpoints = filterEndpoints(baseEndpoints, frontmatter);
+    }
+    // Build local endpoint sections
+    const localSections = new Map();
+    let currentKey = null;
+    const currentLines = [];
+    const nonEndpointLines = [];
+    let foundEndpoint = false;
+    for (const line of body.split('\n')) {
+        const match = ENDPOINT_HEADING_RE.exec(line);
+        if (match) {
+            if (currentKey) {
+                localSections.set(currentKey, currentLines.join('\n').trim());
+                currentLines.length = 0;
+            }
+            currentKey = `${match[1]} ${match[2]}`;
+            foundEndpoint = true;
+        }
+        else if (currentKey) {
+            currentLines.push(line);
+        }
+        else if (!foundEndpoint) {
+            // Lines before any ### endpoint heading
+            nonEndpointLines.push(line);
+        }
+    }
+    if (currentKey) {
+        localSections.set(currentKey, currentLines.join('\n').trim());
+    }
+    // Build output
+    const outputParts = [];
+    // Render base endpoints, appending local additions if they match
+    for (const ep of baseEndpoints) {
+        const key = `${ep.method} ${ep.path}`;
+        let section = `### ${ep.method} ${ep.path}`;
+        if (ep.description) {
+            section += `\n${ep.description}`;
+        }
+        const localAddition = localSections.get(key);
+        if (localAddition) {
+            section += `\n${localAddition}`;
+            localSections.delete(key);
+        }
+        outputParts.push(section);
+    }
+    // Append remaining local sections that didn't match base endpoints
+    for (const [key, content] of localSections) {
+        let section = `### ${key}`;
+        if (content) {
+            section += `\n${content}`;
+        }
+        outputParts.push(section);
+    }
+    let result = outputParts.join('\n\n');
+    // Prepend non-endpoint content from local body
+    const preamble = nonEndpointLines.join('\n').trim();
+    if (preamble) {
+        result = preamble + '\n\n' + result;
+    }
+    return result.trim();
+}
+// --- access.json merge: additive, restrictions only tighten ---
+function confirmRank(tier) {
+    return CONFIRM_RANK[String(tier)] ?? 0;
+}
+/**
+ * Return the tighter of two confirmation tiers.
+ */
+export function tighterConfirm(base, local) {
+    if (confirmRank(local) > confirmRank(base))
+        return local;
+    return base;
+}
+const POLICY_RANK = {
+    role_gated: 0,
+    retrieve_but_redact: 1,
+    never_retrieve: 2,
+};
+/**
+ * Return the tighter of two field restriction policies.
+ */
+export function tighterPolicy(base, local) {
+    const baseRank = POLICY_RANK[base] ?? 0;
+    const localRank = POLICY_RANK[local] ?? 0;
+    return localRank > baseRank ? local : base;
+}
+/**
+ * Narrow roles by intersection. undefined means "no restriction" (all roles).
+ */
+export function narrowRoles(base, local) {
+    if (!base)
+        return local;
+    if (!local)
+        return base;
+    // Intersection
+    const baseSet = new Set(base);
+    return local.filter((r) => baseSet.has(r));
+}
+/**
+ * Merge a local access.json override on top of a package base.
+ * Local overrides take precedence — the user's repo is the final word.
+ */
+export function mergeAccessJson(baseJson, localJson) {
+    const { data: localData } = parseJsonImport(localJson);
+    let baseRaw;
+    try {
+        baseRaw = JSON.parse(baseJson);
+    }
+    catch (err) {
+        throw new PackageError('PARSE_FAILED', 'Invalid JSON in base access.json', err);
+    }
+    const base = AccessConfigSchema.parse(baseRaw);
+    // Merge endpoints
+    const mergedEndpoints = { ...base.endpoints };
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    const localEndpoints = localData['endpoints'];
+    if (localEndpoints) {
+        for (const [ep, localAccess] of Object.entries(localEndpoints)) {
+            const baseAccess = mergedEndpoints[ep];
+            if (!baseAccess) {
+                // New endpoint — add it directly (local defines new restrictions)
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+                mergedEndpoints[ep] = localAccess;
+            }
+            else {
+                // Local override wins — merge base fields, then apply local on top
+                mergedEndpoints[ep] = {
+                    ...baseAccess,
+                    ...localAccess,
+                };
+                // If local explicitly omits confirm (undefined), remove it from merged
+                if (localAccess.confirm === undefined && 'confirm' in localAccess) {
+                    delete mergedEndpoints[ep].confirm;
+                }
+                else if (localAccess.confirm !== undefined) {
+                    mergedEndpoints[ep].confirm = localAccess.confirm;
+                }
+                if (localAccess.thresholds) {
+                    mergedEndpoints[ep].thresholds = [
+                        ...(baseAccess.thresholds ?? []),
+                        ...localAccess.thresholds,
+                    ];
+                }
+            }
+        }
+    }
+    // Merge field restrictions
+    const baseRestrictions = base.fieldRestrictions ?? [];
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    const localRestrictions = (localData['fieldRestrictions'] ?? []);
+    const mergedRestrictions = [...baseRestrictions];
+    for (const localRestr of localRestrictions) {
+        const entity = String(localRestr['entity'] ?? '');
+        const field = String(localRestr['field'] ?? '');
+        // Find matching base restriction
+        const existingIdx = mergedRestrictions.findIndex((r) => r.entity === entity && r.field === field);
+        if (existingIdx >= 0) {
+            const existing = mergedRestrictions[existingIdx];
+            // Local override wins for policy and roles
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            const newPolicy = localRestr['policy'] ?? existing.policy;
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            const newRoles = localRestr['allowedRoles'] ?? existing.allowedRoles;
+            mergedRestrictions[existingIdx] = {
+                ...existing,
+                policy: newPolicy,
+                allowedRoles: newRoles,
+            };
+        }
+        else {
+            // New restriction — add it
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            mergedRestrictions.push(localRestr);
+        }
+    }
+    const result = {
+        ...base,
+        endpoints: mergedEndpoints,
+        fieldRestrictions: mergedRestrictions.length > 0 ? mergedRestrictions : undefined,
+    };
+    // Merge delegations if local provides them
+    if (localData['delegations']) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        result.delegations = localData['delegations'];
+    }
+    // Merge alternativeLookups additively
+    if (localData['alternativeLookups']) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        const localLookups = localData['alternativeLookups'];
+        result.alternativeLookups = [
+            ...(base.alternativeLookups ?? []),
+            ...(localLookups ?? []),
+        ];
+    }
+    return result;
+}
+// --- entities.md merge: section-level by ### heading ---
+/**
+ * Extract ### heading sections from markdown content.
+ * Returns a Map of heading text → section content (without the heading line).
+ * Also returns the preamble (content before the first ### heading).
+ */
+export function extractHeadingSections(content) {
+    const lines = content.split('\n');
+    const sections = new Map();
+    const preambleLines = [];
+    let currentHeading = null;
+    const currentLines = [];
+    for (const line of lines) {
+        const headingMatch = /^###\s+(.+)/.exec(line);
+        if (headingMatch) {
+            if (currentHeading) {
+                sections.set(currentHeading, currentLines.join('\n').trim());
+                currentLines.length = 0;
+            }
+            currentHeading = headingMatch[1].trim();
+        }
+        else if (currentHeading) {
+            currentLines.push(line);
+        }
+        else {
+            preambleLines.push(line);
+        }
+    }
+    if (currentHeading) {
+        sections.set(currentHeading, currentLines.join('\n').trim());
+    }
+    return { preamble: preambleLines.join('\n').trim(), sections };
+}
+/**
+ * Merge entities.md: local ### sections replace matching base sections.
+ * Unmatched base sections pass through.
+ */
+export function mergeEntities(baseMd, localMd) {
+    const { body } = parseMarkdownFrontmatter(localMd);
+    const baseParsed = extractHeadingSections(baseMd);
+    const localParsed = extractHeadingSections(body);
+    // Start with base sections, replace with local where present
+    const mergedSections = new Map(baseParsed.sections);
+    for (const [heading, content] of localParsed.sections) {
+        mergedSections.set(heading, content);
+    }
+    const parts = [];
+    if (baseParsed.preamble) {
+        parts.push(baseParsed.preamble);
+    }
+    for (const [heading, content] of mergedSections) {
+        parts.push(`### ${heading}\n${content}`);
+    }
+    return parts.join('\n\n').trim();
+}
+// --- Concatenation merge (rules, skills, automations, knowledge) ---
+/**
+ * Concatenate package base with local additions.
+ * Package content first, blank line separator, local body (frontmatter stripped).
+ */
+export function mergeConcatenation(baseMd, localMd) {
+    const { body } = parseMarkdownFrontmatter(localMd);
+    const baseContent = baseMd.trim();
+    const localContent = body.trim();
+    if (!localContent)
+        return baseContent;
+    if (!baseContent)
+        return localContent;
+    return `${baseContent}\n\n${localContent}`;
+}
+//# sourceMappingURL=merge-engine.js.map

package/dist/src/packages/merge-engine.js.map

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

package/dist/src/packages/npm-context.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { LockFile, PackageRef } from './package-types.js';
+/**
+ * Paths for the hidden npm context.
+ */
+export interface NpmContextPaths {
+    root: string;
+    npmDir: string;
+    npmrc: string;
+    packageJson: string;
+    nodeModules: string;
+}
+/**
+ * Get the standard paths for the hidden npm context.
+ */
+export declare function getNpmContextPaths(repoPath: string): NpmContextPaths;
+/**
+ * Ensure the hidden npm context exists. Idempotent.
+ */
+export declare function ensureNpmContext(repoPath: string, registryUrl?: string): Promise<NpmContextPaths>;
+/**
+ * Run `npm install` for a specific package.
+ */
+export declare function npmInstall(paths: NpmContextPaths, npmName: string, version?: string, timeout?: number): Promise<{
+    version: string;
+    integrity: string;
+}>;
+/**
+ * Run `npm install` to restore all packages from package.json.
+ */
+export declare function npmInstallAll(paths: NpmContextPaths, timeout?: number): Promise<void>;
+/**
+ * Run `npm uninstall` for a specific package.
+ */
+export declare function npmUninstall(paths: NpmContextPaths, npmName: string, timeout?: number): Promise<void>;
+/**
+ * Generate package.json dependencies from a lock file.
+ */
+export declare function generatePackageJson(lockFile: LockFile): Record<string, unknown>;
+/**
+ * Create or repair a symlink from the clean path to the npm node_modules path.
+ */
+export declare function ensureSymlink(paths: NpmContextPaths, ref: PackageRef): Promise<string>;
+/**
+ * Create symlinks for all packages in a lock file.
+ */
+export declare function ensureAllSymlinks(paths: NpmContextPaths, lockFile: LockFile): Promise<void>;
+/**
+ * Get the resolved package directory for an installed package.
+ * Returns null if the package is not installed or the symlink is broken.
+ */
+export declare function getPackageDir(repoPath: string, ref: PackageRef): Promise<string | null>;