@amodalai/core 0.1.0

package/dist/src/repo/drift-detector.js

@@ -0,0 +1,66 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Compare parsed OpenAPI spec endpoints against surface endpoint definitions.
+ * Returns a drift result showing added, removed, changed, and unchanged endpoints.
+ */
+export function detectDrift(specEndpoints, surfaceEndpoints) {
+    // Build lookup maps
+    const specMap = new Map();
+    for (const ep of specEndpoints) {
+        specMap.set(endpointKey(ep.method, ep.path), ep);
+    }
+    const surfaceMap = new Map();
+    for (const ep of surfaceEndpoints) {
+        surfaceMap.set(endpointKey(ep.method, ep.path), ep);
+    }
+    const added = [];
+    const removed = [];
+    const changed = [];
+    const unchanged = [];
+    // Check for added/changed endpoints (in spec but not in surface, or different)
+    for (const [key, specEp] of specMap) {
+        const surfaceEp = surfaceMap.get(key);
+        if (!surfaceEp) {
+            added.push(specEp);
+            continue;
+        }
+        // Compare
+        const changes = compareEndpoints(specEp, surfaceEp);
+        if (changes.length > 0) {
+            changed.push({ endpoint: key, changes });
+        }
+        else {
+            unchanged.push(key);
+        }
+    }
+    // Check for removed endpoints (in surface but not in spec)
+    for (const [key, surfaceEp] of surfaceMap) {
+        if (!specMap.has(key)) {
+            removed.push(surfaceEp);
+        }
+    }
+    return { added, removed, changed, unchanged };
+}
+function endpointKey(method, path) {
+    return `${method.toUpperCase()} ${path}`;
+}
+/**
+ * Compare a spec endpoint with a surface endpoint and return a list of changes.
+ */
+function compareEndpoints(spec, surface) {
+    const changes = [];
+    // Check deprecation
+    if (spec.deprecated) {
+        changes.push('deprecated in spec');
+    }
+    // Check description/summary changes
+    if (spec.summary && surface.description && spec.summary !== surface.description) {
+        changes.push('description updated');
+    }
+    return changes;
+}
+//# sourceMappingURL=drift-detector.js.map

package/dist/src/repo/drift-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-detector.js","sourceRoot":"","sources":["../../../src/repo/drift-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,aAA+B,EAC/B,gBAAmC;IAEnC,oBAAoB;IACpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;IACtD,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,+EAA+E;IAC/E,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QAED,UAAU;QACV,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,EAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAC,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,UAAU,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,EAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAC,CAAC;AAC9C,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,IAAY;IAC/C,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAoB,EAAE,OAAwB;IACtE,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,oBAAoB;IACpB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrC,CAAC;IAED,oCAAoC;IACpC,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/repo/graphql-drift-detector.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { ParsedGraphQLOperation } from './graphql-parser.js';
+import type { SurfaceEndpoint } from './connection-types.js';
+export interface GraphQLDriftResult {
+    added: ParsedGraphQLOperation[];
+    removed: SurfaceEndpoint[];
+    changed: GraphQLOperationChange[];
+    unchanged: string[];
+}
+export interface GraphQLOperationChange {
+    name: string;
+    operationType: string;
+    changes: string[];
+}
+/**
+ * Detect drift between a parsed GraphQL schema and a surface definition.
+ *
+ * - Added: in schema but not in surface
+ * - Removed: in surface but not in schema
+ * - Changed: in both but with differences (e.g., description changed)
+ * - Unchanged: in both with no differences
+ */
+export declare function detectGraphQLDrift(schemaOps: ParsedGraphQLOperation[], surfaceEndpoints: SurfaceEndpoint[]): GraphQLDriftResult;

package/dist/src/repo/graphql-drift-detector.js

@@ -0,0 +1,66 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Detect drift between a parsed GraphQL schema and a surface definition.
+ *
+ * - Added: in schema but not in surface
+ * - Removed: in surface but not in schema
+ * - Changed: in both but with differences (e.g., description changed)
+ * - Unchanged: in both with no differences
+ */
+export function detectGraphQLDrift(schemaOps, surfaceEndpoints) {
+    const schemaMap = new Map();
+    for (const op of schemaOps) {
+        schemaMap.set(operationKey(op.operationType, op.name), op);
+    }
+    const surfaceMap = new Map();
+    for (const ep of surfaceEndpoints) {
+        surfaceMap.set(operationKey(ep.method, ep.path), ep);
+    }
+    const added = [];
+    const changed = [];
+    const unchanged = [];
+    for (const [key, op] of schemaMap) {
+        const surface = surfaceMap.get(key);
+        if (!surface) {
+            added.push(op);
+        }
+        else {
+            const changes = compareOperation(op, surface);
+            if (changes.length > 0) {
+                changed.push({
+                    name: op.name,
+                    operationType: op.operationType,
+                    changes,
+                });
+            }
+            else {
+                unchanged.push(key);
+            }
+        }
+    }
+    const removed = [];
+    for (const [key, ep] of surfaceMap) {
+        if (!schemaMap.has(key)) {
+            removed.push(ep);
+        }
+    }
+    return { added, removed, changed, unchanged };
+}
+function operationKey(operationType, name) {
+    return `${operationType.toUpperCase()} ${name}`;
+}
+function compareOperation(schemaOp, surfaceEp) {
+    const changes = [];
+    // Compare descriptions (if both present)
+    if (schemaOp.description &&
+        surfaceEp.description &&
+        schemaOp.description !== surfaceEp.description) {
+        changes.push('description changed');
+    }
+    return changes;
+}
+//# sourceMappingURL=graphql-drift-detector.js.map

package/dist/src/repo/graphql-drift-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-drift-detector.js","sourceRoot":"","sources":["../../../src/repo/graphql-drift-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAmC,EACnC,gBAAmC;IAEnC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC5D,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;IACtD,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,MAAM,OAAO,GAA6B,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC9C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,EAAE,CAAC,IAAI;oBACb,aAAa,EAAE,EAAE,CAAC,aAAa;oBAC/B,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,EAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAC,CAAC;AAC9C,CAAC;AAED,SAAS,YAAY,CAAC,aAAqB,EAAE,IAAY;IACvD,OAAO,GAAG,aAAa,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,gBAAgB,CACvB,QAAgC,EAChC,SAA0B;IAE1B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,yCAAyC;IACzC,IACE,QAAQ,CAAC,WAAW;QACpB,SAAS,CAAC,WAAW;QACrB,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW,EAC9C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Parsed GraphQL operation from an introspection result.
+ */
+export interface ParsedGraphQLOperation {
+    name: string;
+    operationType: 'query' | 'mutation' | 'subscription';
+    args: Array<{
+        name: string;
+        type: string;
+        required: boolean;
+    }>;
+    returnType: string;
+    description?: string;
+}
+/**
+ * Parse a GraphQL introspection result into a flat list of operations.
+ */
+export declare function parseGraphQLIntrospection(introspection: unknown): ParsedGraphQLOperation[];
+/**
+ * Fetch an introspection result from a GraphQL endpoint and parse it.
+ */
+export declare function fetchAndParseGraphQLSchema(url: string, auth?: {
+    header: string;
+    value: string;
+}): Promise<ParsedGraphQLOperation[]>;

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

@@ -0,0 +1,125 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Parse a GraphQL introspection result into a flat list of operations.
+ */
+export function parseGraphQLIntrospection(introspection) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- parsing unknown introspection shape
+    const schema = introspection;
+    const root = schema.__schema ?? schema.data?.__schema;
+    if (!root) {
+        return [];
+    }
+    const types = root.types ?? [];
+    const operations = [];
+    const rootTypeNames = new Map();
+    if (root.queryType?.name) {
+        rootTypeNames.set(root.queryType.name, 'query');
+    }
+    if (root.mutationType?.name) {
+        rootTypeNames.set(root.mutationType.name, 'mutation');
+    }
+    if (root.subscriptionType?.name) {
+        rootTypeNames.set(root.subscriptionType.name, 'subscription');
+    }
+    for (const type of types) {
+        if (!type.name)
+            continue;
+        const operationType = rootTypeNames.get(type.name);
+        if (!operationType)
+            continue;
+        for (const field of type.fields ?? []) {
+            if (!field.name)
+                continue;
+            // Skip internal fields
+            if (field.name.startsWith('__'))
+                continue;
+            operations.push({
+                name: field.name,
+                operationType,
+                args: (field.args ?? []).map((arg) => ({
+                    name: arg.name ?? '',
+                    type: formatTypeRef(arg.type),
+                    required: isRequired(arg.type),
+                })),
+                returnType: formatTypeRef(field.type),
+                description: field.description ?? undefined,
+            });
+        }
+    }
+    return operations;
+}
+/**
+ * Format a type reference into a human-readable string.
+ */
+function formatTypeRef(ref) {
+    if (!ref)
+        return 'Unknown';
+    switch (ref.kind) {
+        case 'NON_NULL':
+            return `${formatTypeRef(ref.ofType)}!`;
+        case 'LIST':
+            return `[${formatTypeRef(ref.ofType)}]`;
+        case 'SCALAR':
+        case 'OBJECT':
+        case 'ENUM':
+        case 'INPUT_OBJECT':
+        case 'INTERFACE':
+        case 'UNION':
+            return ref.name ?? 'Unknown';
+        default:
+            return ref.name ?? 'Unknown';
+    }
+}
+/**
+ * Check if a type reference is non-null (required).
+ */
+function isRequired(ref) {
+    return ref?.kind === 'NON_NULL';
+}
+/**
+ * Fetch an introspection result from a GraphQL endpoint and parse it.
+ */
+export async function fetchAndParseGraphQLSchema(url, auth) {
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (auth) {
+        headers[auth.header] = auth.value;
+    }
+    const query = `{
+    __schema {
+      queryType { name }
+      mutationType { name }
+      subscriptionType { name }
+      types {
+        name
+        kind
+        description
+        fields {
+          name
+          description
+          args {
+            name
+            type { kind name ofType { kind name ofType { kind name ofType { kind name } } } }
+          }
+          type { kind name ofType { kind name ofType { kind name ofType { kind name } } } }
+        }
+      }
+    }
+  }`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({ query }),
+    });
+    if (!response.ok) {
+        throw new Error(`GraphQL introspection failed: HTTP ${response.status}`);
+    }
+    const data = await response.json();
+    return parseGraphQLIntrospection(data);
+}
+//# sourceMappingURL=graphql-parser.js.map

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

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

package/dist/src/repo/graphql-surface-parser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { SurfaceEndpoint } from './connection-types.js';
+/**
+ * Parse a GraphQL surface.md content into SurfaceEndpoint[].
+ *
+ * GraphQL operations use ### QUERY, ### MUTATION, ### SUBSCRIPTION headings
+ * instead of HTTP method + path headings.
+ *
+ * The method field stores the operation type (QUERY, MUTATION, SUBSCRIPTION).
+ * The path field stores the operation name.
+ */
+export declare function parseGraphQLSurface(content: string): SurfaceEndpoint[];
+/**
+ * Detect whether content is a GraphQL surface (uses QUERY/MUTATION/SUBSCRIPTION headings).
+ */
+export declare function isGraphQLSurface(content: string): boolean;

package/dist/src/repo/graphql-surface-parser.js

@@ -0,0 +1,74 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+const GRAPHQL_HEADING_RE = /^###\s+(QUERY|MUTATION|SUBSCRIPTION)\s+(\S+)/;
+const INCLUDED_HEADING_RE = /^##\s+Included/i;
+const EXCLUDED_HEADING_RE = /^##\s+Excluded/i;
+/**
+ * Parse a GraphQL surface.md content into SurfaceEndpoint[].
+ *
+ * GraphQL operations use ### QUERY, ### MUTATION, ### SUBSCRIPTION headings
+ * instead of HTTP method + path headings.
+ *
+ * The method field stores the operation type (QUERY, MUTATION, SUBSCRIPTION).
+ * The path field stores the operation name.
+ */
+export function parseGraphQLSurface(content) {
+    const lines = content.split('\n');
+    const endpoints = [];
+    let state = 'scanning';
+    let hasIncludedSection = false;
+    let currentEndpoint = null;
+    const descriptionLines = [];
+    function flushEndpoint() {
+        if (currentEndpoint) {
+            currentEndpoint.description = descriptionLines.join('\n').trim();
+            endpoints.push(currentEndpoint);
+            descriptionLines.length = 0;
+            currentEndpoint = null;
+        }
+    }
+    for (const line of lines) {
+        if (INCLUDED_HEADING_RE.test(line)) {
+            flushEndpoint();
+            state = 'included';
+            hasIncludedSection = true;
+            continue;
+        }
+        if (EXCLUDED_HEADING_RE.test(line)) {
+            flushEndpoint();
+            state = 'excluded';
+            continue;
+        }
+        const gqlMatch = GRAPHQL_HEADING_RE.exec(line);
+        if (gqlMatch) {
+            flushEndpoint();
+            const included = state !== 'excluded';
+            currentEndpoint = {
+                method: gqlMatch[1],
+                path: gqlMatch[2],
+                description: '',
+                included,
+            };
+            continue;
+        }
+        if (currentEndpoint) {
+            descriptionLines.push(line);
+        }
+    }
+    flushEndpoint();
+    // Same convention as REST: if no explicit Included section, all are included
+    if (!hasIncludedSection) {
+        // All endpoints already default to included
+    }
+    return endpoints;
+}
+/**
+ * Detect whether content is a GraphQL surface (uses QUERY/MUTATION/SUBSCRIPTION headings).
+ */
+export function isGraphQLSurface(content) {
+    return GRAPHQL_HEADING_RE.test(content);
+}
+//# sourceMappingURL=graphql-surface-parser.js.map

package/dist/src/repo/graphql-surface-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-surface-parser.js","sourceRoot":"","sources":["../../../src/repo/graphql-surface-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,kBAAkB,GAAG,8CAA8C,CAAC;AAC1E,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAC9C,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,SAAS,GAAsB,EAAE,CAAC;IACxC,IAAI,KAAK,GAAgB,UAAU,CAAC;IACpC,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,eAAe,GAA2B,IAAI,CAAC;IACnD,MAAM,gBAAgB,GAAa,EAAE,CAAC;IAEtC,SAAS,aAAa;QACpB,IAAI,eAAe,EAAE,CAAC;YACpB,eAAe,CAAC,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACjE,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAChC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5B,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,aAAa,EAAE,CAAC;YAChB,KAAK,GAAG,UAAU,CAAC;YACnB,kBAAkB,GAAG,IAAI,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,aAAa,EAAE,CAAC;YAChB,KAAK,GAAG,UAAU,CAAC;YACnB,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,CAAC;YACb,aAAa,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,KAAK,KAAK,UAAU,CAAC;YACtC,eAAe,GAAG;gBAChB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;gBACnB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;gBACjB,WAAW,EAAE,EAAE;gBACf,QAAQ;aACT,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,aAAa,EAAE,CAAC;IAEhB,6EAA6E;IAC7E,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,4CAA4C;IAC9C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export * from './repo-types.js';
+export * from './connection-types.js';
+export { AmodalConfigSchema, ModelConfigSchema, parseConfigJson, resolveEnvValue, resolveEnvValues, } from './config-schema.js';
+export type { AmodalConfig, ModelConfig } from './config-schema.js';
+export { AccessConfigSchema, AlternativeLookupSchema, ConnectionSpecSchema, EndpointAccessSchema, FieldRestrictionSchema, ScopingRuleSchema, ThresholdSchema, } from './connection-schemas.js';
+export type { AccessConfig, AlternativeLookup, ConnectionSpec, EndpointAccess, FieldRestriction, ScopingRule, Threshold, } from './connection-schemas.js';
+export { parseAgent, parseConfig, parseAccessJson, parseSpecJson, parseConnection, parseSkill, parseKnowledge, parseAutomation, parseEval, } from './parsers.js';
+export { parseSurface } from './surface-parser.js';
+export type { StoreFieldType, StoreFieldDefinition, StoreEntityDefinition, StoreTtlConfig, StoreFailureConfig, StoreHistoryConfig, LoadedStore, } from './store-types.js';
+export { StoreJsonSchema, StoreFieldDefinitionSchema, StoreEntitySchema, StoreTtlConfigSchema, StoreFailureConfigSchema, StoreHistoryConfigSchema, STORE_NAME_REGEX, } from './store-schemas.js';
+export type { StoreJson } from './store-schemas.js';
+export { loadStores, parseStoreJson } from './store-loader.js';
+export { storeToJsonSchema, storeToToolName, findStoreByToolName, fieldToJsonSchema } from './store-tool-schema.js';
+export { ToolJsonSchema, TOOL_NAME_REGEX, defineToolHandler } from './tool-types.js';
+export type { ToolJson, LoadedTool, CustomToolContext, CustomToolExecutor, CustomShellExecutor, ToolHandlerDefinition } from './tool-types.js';
+export { loadTools, isToolHandlerDefinition } from './tool-loader.js';
+export { loadRepoFromDisk } from './local-reader.js';
+export { loadRepoFromPlatform } from './platform-reader.js';
+export { loadRepo } from './repo-loader.js';
+export { parseOpenAPISpec, fetchAndParseSpec } from './openapi-parser.js';
+export type { ParsedEndpoint, ParsedParameter } from './openapi-parser.js';
+export { detectDrift } from './drift-detector.js';
+export type { DriftResult, EndpointChange } from './drift-detector.js';
+export { buildSyncPlan } from './spec-syncer.js';
+export type { SyncPlan } from './spec-syncer.js';

package/dist/src/repo/index.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+// Types
+export * from './repo-types.js';
+export * from './connection-types.js';
+// Schemas
+export { AmodalConfigSchema, ModelConfigSchema, parseConfigJson, resolveEnvValue, resolveEnvValues, } from './config-schema.js';
+export { AccessConfigSchema, AlternativeLookupSchema, ConnectionSpecSchema, EndpointAccessSchema, FieldRestrictionSchema, ScopingRuleSchema, ThresholdSchema, } from './connection-schemas.js';
+// Parsers
+export { parseAgent, parseConfig, parseAccessJson, parseSpecJson, parseConnection, parseSkill, parseKnowledge, parseAutomation, parseEval, } from './parsers.js';
+export { parseSurface } from './surface-parser.js';
+export { StoreJsonSchema, StoreFieldDefinitionSchema, StoreEntitySchema, StoreTtlConfigSchema, StoreFailureConfigSchema, StoreHistoryConfigSchema, STORE_NAME_REGEX, } from './store-schemas.js';
+export { loadStores, parseStoreJson } from './store-loader.js';
+export { storeToJsonSchema, storeToToolName, findStoreByToolName, fieldToJsonSchema } from './store-tool-schema.js';
+// Tool types
+export { ToolJsonSchema, TOOL_NAME_REGEX, defineToolHandler } from './tool-types.js';
+export { loadTools, isToolHandlerDefinition } from './tool-loader.js';
+// Readers
+export { loadRepoFromDisk } from './local-reader.js';
+export { loadRepoFromPlatform } from './platform-reader.js';
+export { loadRepo } from './repo-loader.js';
+// Sync utilities
+export { parseOpenAPISpec, fetchAndParseSpec } from './openapi-parser.js';
+export { detectDrift } from './drift-detector.js';
+export { buildSyncPlan } from './spec-syncer.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/repo/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAEtC,UAAU;AACV,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAWjC,UAAU;AACV,OAAO,EACL,UAAU,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,eAAe,EACf,UAAU,EACV,cAAc,EACd,eAAe,EACf,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAYjD,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAC,UAAU,EAAE,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAC,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AAElH,aAAa;AACb,OAAO,EAAC,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAC,SAAS,EAAE,uBAAuB,EAAC,MAAM,kBAAkB,CAAC;AAEpE,UAAU;AACV,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAE1C,iBAAiB;AACjB,OAAO,EAAC,gBAAgB,EAAE,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AAExE,OAAO,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC"}

package/dist/src/repo/local-reader.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AmodalRepo } from './repo-types.js';
+/**
+ * Load the full amodal repo from disk.
+ */
+export declare function loadRepoFromDisk(repoPath: string): Promise<AmodalRepo>;