@amodalai/core 0.1.0

package/dist/src/repo/connection-schemas.d.ts

@@ -0,0 +1,449 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+/**
+ * Schema for spec.json — the structural layer of a connection.
+ */
+export declare const ConnectionSpecSchema: z.ZodObject<{
+    source: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    format: z.ZodEnum<["openapi", "graphql", "grpc", "rest", "aws-api"]>;
+    auth: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        token: z.ZodOptional<z.ZodString>;
+        header: z.ZodOptional<z.ZodString>;
+        prefix: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        token?: string | undefined;
+        header?: string | undefined;
+        prefix?: string | undefined;
+    }, {
+        type: string;
+        token?: string | undefined;
+        header?: string | undefined;
+        prefix?: string | undefined;
+    }>>;
+    sync: z.ZodOptional<z.ZodObject<{
+        auto: z.ZodDefault<z.ZodBoolean>;
+        frequency: z.ZodDefault<z.ZodEnum<["on_push", "manual", "daily", "weekly", "hourly"]>>;
+        notify_drift: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        auto: boolean;
+        frequency: "on_push" | "manual" | "daily" | "weekly" | "hourly";
+        notify_drift: boolean;
+    }, {
+        auto?: boolean | undefined;
+        frequency?: "on_push" | "manual" | "daily" | "weekly" | "hourly" | undefined;
+        notify_drift?: boolean | undefined;
+    }>>;
+    filter: z.ZodOptional<z.ZodObject<{
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        include_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        exclude_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        tags?: string[] | undefined;
+        include_paths?: string[] | undefined;
+        exclude_paths?: string[] | undefined;
+    }, {
+        tags?: string[] | undefined;
+        include_paths?: string[] | undefined;
+        exclude_paths?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    format: "openapi" | "graphql" | "grpc" | "rest" | "aws-api";
+    filter?: {
+        tags?: string[] | undefined;
+        include_paths?: string[] | undefined;
+        exclude_paths?: string[] | undefined;
+    } | undefined;
+    baseUrl?: string | undefined;
+    auth?: {
+        type: string;
+        token?: string | undefined;
+        header?: string | undefined;
+        prefix?: string | undefined;
+    } | undefined;
+    sync?: {
+        auto: boolean;
+        frequency: "on_push" | "manual" | "daily" | "weekly" | "hourly";
+        notify_drift: boolean;
+    } | undefined;
+}, {
+    source: string;
+    format: "openapi" | "graphql" | "grpc" | "rest" | "aws-api";
+    filter?: {
+        tags?: string[] | undefined;
+        include_paths?: string[] | undefined;
+        exclude_paths?: string[] | undefined;
+    } | undefined;
+    baseUrl?: string | undefined;
+    auth?: {
+        type: string;
+        token?: string | undefined;
+        header?: string | undefined;
+        prefix?: string | undefined;
+    } | undefined;
+    sync?: {
+        auto?: boolean | undefined;
+        frequency?: "on_push" | "manual" | "daily" | "weekly" | "hourly" | undefined;
+        notify_drift?: boolean | undefined;
+    } | undefined;
+}>;
+export type ConnectionSpec = z.infer<typeof ConnectionSpecSchema>;
+/**
+ * Schema for a threshold escalation rule.
+ */
+export declare const ThresholdSchema: z.ZodObject<{
+    field: z.ZodString;
+    above: z.ZodNumber;
+    escalate: z.ZodEnum<["review", "never"]>;
+}, "strip", z.ZodTypeAny, {
+    field: string;
+    above: number;
+    escalate: "never" | "review";
+}, {
+    field: string;
+    above: number;
+    escalate: "never" | "review";
+}>;
+export type Threshold = z.infer<typeof ThresholdSchema>;
+/**
+ * Schema for an endpoint access entry.
+ */
+export declare const EndpointAccessSchema: z.ZodObject<{
+    returns: z.ZodArray<z.ZodString, "many">;
+    confirm: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<true>, z.ZodLiteral<"review">, z.ZodLiteral<"never">]>>;
+    reason: z.ZodOptional<z.ZodString>;
+    thresholds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        above: z.ZodNumber;
+        escalate: z.ZodEnum<["review", "never"]>;
+    }, "strip", z.ZodTypeAny, {
+        field: string;
+        above: number;
+        escalate: "never" | "review";
+    }, {
+        field: string;
+        above: number;
+        escalate: "never" | "review";
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    returns: string[];
+    confirm?: true | "never" | "review" | undefined;
+    reason?: string | undefined;
+    thresholds?: {
+        field: string;
+        above: number;
+        escalate: "never" | "review";
+    }[] | undefined;
+}, {
+    returns: string[];
+    confirm?: true | "never" | "review" | undefined;
+    reason?: string | undefined;
+    thresholds?: {
+        field: string;
+        above: number;
+        escalate: "never" | "review";
+    }[] | undefined;
+}>;
+export type EndpointAccess = z.infer<typeof EndpointAccessSchema>;
+/**
+ * Schema for a field restriction.
+ */
+export declare const FieldRestrictionSchema: z.ZodObject<{
+    entity: z.ZodString;
+    field: z.ZodString;
+    policy: z.ZodEnum<["never_retrieve", "retrieve_but_redact", "role_gated"]>;
+    sensitivity: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+    allowedRoles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    group: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    field: string;
+    entity: string;
+    policy: "never_retrieve" | "retrieve_but_redact" | "role_gated";
+    sensitivity: string;
+    reason?: string | undefined;
+    allowedRoles?: string[] | undefined;
+    group?: string | undefined;
+}, {
+    field: string;
+    entity: string;
+    policy: "never_retrieve" | "retrieve_but_redact" | "role_gated";
+    sensitivity: string;
+    reason?: string | undefined;
+    allowedRoles?: string[] | undefined;
+    group?: string | undefined;
+}>;
+export type FieldRestriction = z.infer<typeof FieldRestrictionSchema>;
+/**
+ * Schema for row-level scoping rules.
+ */
+export declare const ScopingRuleSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"field_match">;
+    userContextField: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "field_match";
+    userContextField: string;
+    label?: string | undefined;
+}, {
+    type: "field_match";
+    userContextField: string;
+    label?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"all">;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "all";
+    label?: string | undefined;
+}, {
+    type: "all";
+    label?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"through_relation">;
+    throughEntity: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "through_relation";
+    throughEntity: string;
+    label?: string | undefined;
+}, {
+    type: "through_relation";
+    throughEntity: string;
+    label?: string | undefined;
+}>]>;
+export type ScopingRule = z.infer<typeof ScopingRuleSchema>;
+/**
+ * Schema for an alternative lookup.
+ */
+export declare const AlternativeLookupSchema: z.ZodObject<{
+    restrictedField: z.ZodString;
+    alternativeEndpoint: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    restrictedField: string;
+    alternativeEndpoint: string;
+    description?: string | undefined;
+}, {
+    restrictedField: string;
+    alternativeEndpoint: string;
+    description?: string | undefined;
+}>;
+export type AlternativeLookup = z.infer<typeof AlternativeLookupSchema>;
+/**
+ * Schema for access.json — the permission layer of a connection.
+ */
+export declare const AccessConfigSchema: z.ZodObject<{
+    endpoints: z.ZodRecord<z.ZodString, z.ZodObject<{
+        returns: z.ZodArray<z.ZodString, "many">;
+        confirm: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<true>, z.ZodLiteral<"review">, z.ZodLiteral<"never">]>>;
+        reason: z.ZodOptional<z.ZodString>;
+        thresholds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            above: z.ZodNumber;
+            escalate: z.ZodEnum<["review", "never"]>;
+        }, "strip", z.ZodTypeAny, {
+            field: string;
+            above: number;
+            escalate: "never" | "review";
+        }, {
+            field: string;
+            above: number;
+            escalate: "never" | "review";
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        returns: string[];
+        confirm?: true | "never" | "review" | undefined;
+        reason?: string | undefined;
+        thresholds?: {
+            field: string;
+            above: number;
+            escalate: "never" | "review";
+        }[] | undefined;
+    }, {
+        returns: string[];
+        confirm?: true | "never" | "review" | undefined;
+        reason?: string | undefined;
+        thresholds?: {
+            field: string;
+            above: number;
+            escalate: "never" | "review";
+        }[] | undefined;
+    }>>;
+    fieldRestrictions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        entity: z.ZodString;
+        field: z.ZodString;
+        policy: z.ZodEnum<["never_retrieve", "retrieve_but_redact", "role_gated"]>;
+        sensitivity: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+        allowedRoles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        group: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        field: string;
+        entity: string;
+        policy: "never_retrieve" | "retrieve_but_redact" | "role_gated";
+        sensitivity: string;
+        reason?: string | undefined;
+        allowedRoles?: string[] | undefined;
+        group?: string | undefined;
+    }, {
+        field: string;
+        entity: string;
+        policy: "never_retrieve" | "retrieve_but_redact" | "role_gated";
+        sensitivity: string;
+        reason?: string | undefined;
+        allowedRoles?: string[] | undefined;
+        group?: string | undefined;
+    }>, "many">>;
+    rowScoping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"field_match">;
+        userContextField: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "field_match";
+        userContextField: string;
+        label?: string | undefined;
+    }, {
+        type: "field_match";
+        userContextField: string;
+        label?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"all">;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "all";
+        label?: string | undefined;
+    }, {
+        type: "all";
+        label?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"through_relation">;
+        throughEntity: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "through_relation";
+        throughEntity: string;
+        label?: string | undefined;
+    }, {
+        type: "through_relation";
+        throughEntity: string;
+        label?: string | undefined;
+    }>]>>>>;
+    delegations: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        maxDurationDays: z.ZodOptional<z.ZodNumber>;
+        escalateConfirm: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        escalateConfirm: boolean;
+        maxDurationDays?: number | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        maxDurationDays?: number | undefined;
+        escalateConfirm?: boolean | undefined;
+    }>>;
+    alternativeLookups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        restrictedField: z.ZodString;
+        alternativeEndpoint: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        restrictedField: string;
+        alternativeEndpoint: string;
+        description?: string | undefined;
+    }, {
+        restrictedField: string;
+        alternativeEndpoint: string;
+        description?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    endpoints: Record<string, {
+        returns: string[];
+        confirm?: true | "never" | "review" | undefined;
+        reason?: string | undefined;
+        thresholds?: {
+            field: string;
+            above: number;
+            escalate: "never" | "review";
+        }[] | undefined;
+    }>;
+    fieldRestrictions?: {
+        field: string;
+        entity: string;
+        policy: "never_retrieve" | "retrieve_but_redact" | "role_gated";
+        sensitivity: string;
+        reason?: string | undefined;
+        allowedRoles?: string[] | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    rowScoping?: Record<string, Record<string, {
+        type: "field_match";
+        userContextField: string;
+        label?: string | undefined;
+    } | {
+        type: "all";
+        label?: string | undefined;
+    } | {
+        type: "through_relation";
+        throughEntity: string;
+        label?: string | undefined;
+    }>> | undefined;
+    delegations?: {
+        enabled: boolean;
+        escalateConfirm: boolean;
+        maxDurationDays?: number | undefined;
+    } | undefined;
+    alternativeLookups?: {
+        restrictedField: string;
+        alternativeEndpoint: string;
+        description?: string | undefined;
+    }[] | undefined;
+}, {
+    endpoints: Record<string, {
+        returns: string[];
+        confirm?: true | "never" | "review" | undefined;
+        reason?: string | undefined;
+        thresholds?: {
+            field: string;
+            above: number;
+            escalate: "never" | "review";
+        }[] | undefined;
+    }>;
+    fieldRestrictions?: {
+        field: string;
+        entity: string;
+        policy: "never_retrieve" | "retrieve_but_redact" | "role_gated";
+        sensitivity: string;
+        reason?: string | undefined;
+        allowedRoles?: string[] | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    rowScoping?: Record<string, Record<string, {
+        type: "field_match";
+        userContextField: string;
+        label?: string | undefined;
+    } | {
+        type: "all";
+        label?: string | undefined;
+    } | {
+        type: "through_relation";
+        throughEntity: string;
+        label?: string | undefined;
+    }>> | undefined;
+    delegations?: {
+        enabled?: boolean | undefined;
+        maxDurationDays?: number | undefined;
+        escalateConfirm?: boolean | undefined;
+    } | undefined;
+    alternativeLookups?: {
+        restrictedField: string;
+        alternativeEndpoint: string;
+        description?: string | undefined;
+    }[] | undefined;
+}>;
+export type AccessConfig = z.infer<typeof AccessConfigSchema>;

package/dist/src/repo/connection-schemas.js

@@ -0,0 +1,109 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { z } from 'zod';
+/**
+ * Schema for spec.json — the structural layer of a connection.
+ */
+export const ConnectionSpecSchema = z.object({
+    source: z.string().min(1),
+    baseUrl: z.string().optional(),
+    format: z.enum(['openapi', 'graphql', 'grpc', 'rest', 'aws-api']),
+    auth: z
+        .object({
+        type: z.string().min(1),
+        token: z.string().optional(),
+        header: z.string().optional(),
+        prefix: z.string().optional(),
+    })
+        .optional(),
+    sync: z
+        .object({
+        auto: z.boolean().default(true),
+        frequency: z.enum(['on_push', 'manual', 'daily', 'weekly', 'hourly']).default('on_push'),
+        notify_drift: z.boolean().default(true),
+    })
+        .optional(),
+    filter: z
+        .object({
+        tags: z.array(z.string()).optional(),
+        include_paths: z.array(z.string()).optional(),
+        exclude_paths: z.array(z.string()).optional(),
+    })
+        .optional(),
+});
+/**
+ * Schema for a threshold escalation rule.
+ */
+export const ThresholdSchema = z.object({
+    field: z.string().min(1),
+    above: z.number(),
+    escalate: z.enum(['review', 'never']),
+});
+/**
+ * Schema for an endpoint access entry.
+ */
+export const EndpointAccessSchema = z.object({
+    returns: z.array(z.string().min(1)),
+    confirm: z.union([z.literal(true), z.literal('review'), z.literal('never')]).optional(),
+    reason: z.string().optional(),
+    thresholds: z.array(ThresholdSchema).optional(),
+});
+/**
+ * Schema for a field restriction.
+ */
+export const FieldRestrictionSchema = z.object({
+    entity: z.string().min(1),
+    field: z.string().min(1),
+    policy: z.enum(['never_retrieve', 'retrieve_but_redact', 'role_gated']),
+    sensitivity: z.string().min(1),
+    reason: z.string().optional(),
+    allowedRoles: z.array(z.string().min(1)).optional(),
+    group: z.string().optional(),
+});
+/**
+ * Schema for row-level scoping rules.
+ */
+export const ScopingRuleSchema = z.discriminatedUnion('type', [
+    z.object({
+        type: z.literal('field_match'),
+        userContextField: z.string().min(1),
+        label: z.string().optional(),
+    }),
+    z.object({
+        type: z.literal('all'),
+        label: z.string().optional(),
+    }),
+    z.object({
+        type: z.literal('through_relation'),
+        throughEntity: z.string().min(1),
+        label: z.string().optional(),
+    }),
+]);
+/**
+ * Schema for an alternative lookup.
+ */
+export const AlternativeLookupSchema = z.object({
+    restrictedField: z.string().min(1),
+    alternativeEndpoint: z.string().min(1),
+    description: z.string().optional(),
+});
+/**
+ * Schema for access.json — the permission layer of a connection.
+ */
+export const AccessConfigSchema = z.object({
+    endpoints: z.record(z.string(), EndpointAccessSchema),
+    fieldRestrictions: z.array(FieldRestrictionSchema).optional(),
+    rowScoping: z.record(z.string(), z.record(z.string(), ScopingRuleSchema)).optional(),
+    delegations: z
+        .object({
+        enabled: z.boolean().default(false),
+        maxDurationDays: z.number().optional(),
+        escalateConfirm: z.boolean().default(false),
+    })
+        .optional(),
+    alternativeLookups: z.array(AlternativeLookupSchema).optional(),
+});
+//# sourceMappingURL=connection-schemas.js.map

package/dist/src/repo/connection-schemas.js.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AccessConfig, ConnectionSpec } from './connection-schemas.js';
+/**
+ * A parsed endpoint from surface.md.
+ */
+export interface SurfaceEndpoint {
+    method: string;
+    path: string;
+    description: string;
+    included: boolean;
+    /** For GraphQL connections: 'query' | 'mutation' | 'subscription' */
+    operationType?: 'query' | 'mutation' | 'subscription';
+}
+/**
+ * A fully loaded connection with all parsed components.
+ */
+export interface LoadedConnection {
+    name: string;
+    spec: ConnectionSpec;
+    access: AccessConfig;
+    surface: SurfaceEndpoint[];
+    entities?: string;
+    rules?: string;
+    location: string;
+}

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};
+//# sourceMappingURL=connection-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection-types.js","sourceRoot":"","sources":["../../../src/repo/connection-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

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

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { ParsedEndpoint } from './openapi-parser.js';
+import type { SurfaceEndpoint } from './connection-types.js';
+export interface EndpointChange {
+    endpoint: string;
+    changes: string[];
+}
+export interface DriftResult {
+    /** Endpoints in the spec but not in the surface */
+    added: ParsedEndpoint[];
+    /** Endpoints in the surface but not in the spec */
+    removed: SurfaceEndpoint[];
+    /** Endpoints in both but with differences */
+    changed: EndpointChange[];
+    /** Endpoint keys that match and have no drift */
+    unchanged: string[];
+}
+/**
+ * Compare parsed OpenAPI spec endpoints against surface endpoint definitions.
+ * Returns a drift result showing added, removed, changed, and unchanged endpoints.
+ */
+export declare function detectDrift(specEndpoints: ParsedEndpoint[], surfaceEndpoints: SurfaceEndpoint[]): DriftResult;