@happyvertical/smrt-ingestion 0.0.0-stage → 0.55.6

package/dist/execution-contracts.d.ts

@@ -0,0 +1,131 @@
+import type { PrincipalRun } from '@happyvertical/smrt-agents';
+import type { CapabilityDeclaration } from '@happyvertical/smrt-types';
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { ExecutionCeiling, IntakeValues } from './execution-dto.js';
+import type { IntakePolicy, IntakePolicyLayer } from './policy.js';
+import type { HandlerDiscovery } from './proposal-contracts.js';
+import type { IngestionScope } from './server.js';
+export type * from './execution-dto.js';
+export interface HandlerContext {
+    db: DatabaseInterface;
+    scope: Readonly<IngestionScope>;
+    itemId: string;
+    principal?: PrincipalRun;
+    policy: Readonly<IntakePolicy>;
+    /** Must check current tenant/confidential ownership and optionally CAS revision. */
+    assertTarget(model: string, id: string, revision?: string): Promise<void>;
+}
+export interface HandlerPreview {
+    display: IntakeValues;
+    normalizedArgs: IntakeValues;
+    targetPreconditions: Array<{
+        model: string;
+        id: string;
+        revision: string;
+    }>;
+}
+interface HandlerBase {
+    /** Optional proposal discovery on this same authoritative execution catalog. */
+    discovery?: HandlerDiscovery;
+    id: string;
+    version: string;
+    description: string;
+    argsSchema: IntakeValues;
+    resultSchema: IntakeValues;
+    /** Schema-allowlisted record-ID fields, never arbitrary expression values. */
+    resultModels: Record<string, string>;
+    preview(args: IntakeValues, context: HandlerContext): Promise<HandlerPreview>;
+    validate(args: IntakeValues, context: HandlerContext): Promise<{
+        ok: boolean;
+    }>;
+}
+export interface OperationHandler extends HandlerBase {
+    operation: {
+        model: string;
+        action: string;
+        version: string;
+    };
+    /** Explicit application adapter declaration; checked against registered model. */
+    capability: CapabilityDeclaration;
+    execution: {
+        kind: 'database';
+        apply(args: IntakeValues, context: HandlerContext): Promise<IntakeValues>;
+    } | {
+        kind: 'external';
+        submit(args: IntakeValues, context: HandlerContext, idempotencyKey: string): Promise<IntakeValues>;
+        reconcile(context: HandlerContext, idempotencyKey: string): Promise<{
+            kind: 'succeeded';
+            result: IntakeValues;
+        } | {
+            kind: 'not_applied';
+        } | {
+            kind: 'unknown';
+        }>;
+    };
+}
+export interface PlanHandler extends HandlerBase {
+    operation: {
+        playbookKey: string;
+        definitionHash: string;
+    };
+    expand(args: IntakeValues, definition: unknown): Promise<Array<{
+        stepIndex: number;
+        handlerId: string;
+        handlerVersion: string;
+        args: IntakeValues;
+        resultBindings: Record<string, {
+            stepIndex: number;
+            resultField: string;
+            expectedModel: string;
+        }>;
+    }>>;
+}
+export type IntakeHandler = OperationHandler | PlanHandler;
+export interface ExecutionAccessInput {
+    db: DatabaseInterface;
+    scope: Readonly<IngestionScope>;
+    itemId: string;
+    capturedCeiling: Readonly<ExecutionCeiling>;
+    operation: 'preview' | 'review' | 'execute' | 'read' | 'reconcile';
+    handlerId: string;
+}
+/** Every callback is server configuration. It must never be deserialized from input. */
+export interface IntakeExecutionOptions {
+    handlers: readonly IntakeHandler[];
+    /** Resolve current policy and grants using this exact executor. */
+    authorize(input: ExecutionAccessInput): Promise<{
+        allowed: boolean;
+        reviewer: boolean;
+        principalId: string;
+        permissions: string[];
+        policy: [
+            IntakePolicyLayer,
+            IntakePolicyLayer,
+            IntakePolicyLayer,
+            ...IntakePolicyLayer[]
+        ];
+        /** Host serializes/revalidates grant changes within this mutation boundary. */
+        mutationBoundary: 'serialized';
+    }>;
+    evaluateAutomatic?(input: {
+        bindingHash: string;
+        handlerId: string;
+        context: HandlerContext;
+    }): Promise<{
+        eligible: boolean;
+        evaluationVersion: string;
+        certainty: number;
+    }>;
+    /** Lock/serialize target ownership and revision checks with writers on this executor. */
+    assertTarget(input: {
+        db: DatabaseInterface;
+        scope: Readonly<IngestionScope>;
+        itemId: string;
+        model: string;
+        id: string;
+        revision?: string;
+    }): Promise<{
+        revision: string;
+    }>;
+}
+//# sourceMappingURL=execution-contracts.d.ts.map

package/dist/execution-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-contracts.d.ts","sourceRoot":"","sources":["../src/execution-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,mBAAmB,oBAAoB,CAAC;AACxC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,iBAAiB,CAAC;IACtB,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC/B,oFAAoF;IACpF,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AACD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,cAAc,EAAE,YAAY,CAAC;IAC7B,mBAAmB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E;AACD,UAAU,WAAW;IACnB,gFAAgF;IAChF,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,YAAY,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9E,QAAQ,CACN,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC7B;AACD,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,kFAAkF;IAClF,UAAU,EAAE,qBAAqB,CAAC;IAClC,SAAS,EACL;QACE,IAAI,EAAE,UAAU,CAAC;QACjB,KAAK,CACH,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CAAC;KAC1B,GACD;QACE,IAAI,EAAE,UAAU,CAAC;QACjB,MAAM,CACJ,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,YAAY,CAAC,CAAC;QACzB,SAAS,CACP,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CACN;YAAE,IAAI,EAAE,WAAW,CAAC;YAAC,MAAM,EAAE,YAAY,CAAA;SAAE,GAC3C;YAAE,IAAI,EAAE,aAAa,CAAA;SAAE,GACvB;YAAE,IAAI,EAAE,SAAS,CAAA;SAAE,CACtB,CAAC;KACH,CAAC;CACP;AACD,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,SAAS,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,MAAM,CACJ,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,OAAO,GAClB,OAAO,CACR,KAAK,CAAC;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,YAAY,CAAC;QACnB,cAAc,EAAE,MAAM,CACpB,MAAM,EACN;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,CAClE,CAAC;KACH,CAAC,CACH,CAAC;CACH;AACD,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAC3D,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,iBAAiB,CAAC;IACtB,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC5C,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IACnE,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,wFAAwF;AACxF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,mEAAmE;IACnE,SAAS,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAC9C,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE;YACN,iBAAiB;YACjB,iBAAiB;YACjB,iBAAiB;YACjB,GAAG,iBAAiB,EAAE;SACvB,CAAC;QACF,+EAA+E;QAC/E,gBAAgB,EAAE,YAAY,CAAC;KAChC,CAAC,CAAC;IACH,iBAAiB,CAAC,CAAC,KAAK,EAAE;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,OAAO,CAAC;QACV,QAAQ,EAAE,OAAO,CAAC;QAClB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,yFAAyF;IACzF,YAAY,CAAC,KAAK,EAAE;QAClB,EAAE,EAAE,iBAAiB,CAAC;QACtB,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnC"}

package/dist/execution-dto.d.ts

@@ -0,0 +1,70 @@
+/** Browser-safe execution messages. Authority and handler callbacks live on the server. */
+export type IntakeValues = Record<string, unknown>;
+/** Captured by the authenticated source host, not by extracted content. */
+export interface ExecutionCeiling {
+    principalId: string;
+    permissions: string[];
+    handlers: string[];
+    operations: string[];
+}
+export interface ResultReference {
+    actionId: string;
+    proposalRevision: number;
+    resultField: string;
+    expectedModel: string;
+}
+export interface PreviewProposalInput {
+    itemId: string;
+    actionId: string;
+    attemptId: string;
+    expectedRevision: number;
+    requestId: string;
+    handlerId: string;
+    handlerVersion: string;
+    args: IntakeValues;
+    dependencies?: Record<string, ResultReference>;
+}
+export interface ProposalReview {
+    actionId: string;
+    proposalId: string;
+    revision: number;
+    reviewVersion: number;
+    bindingHash: string;
+    display: IntakeValues;
+    state: string;
+}
+export interface ReviewInput {
+    actionId: string;
+    expectedRevision: number;
+    expectedReviewVersion: number;
+    bindingHash: string;
+    requestId: string;
+    decision: 'approve' | 'reject' | 'defer' | 'correct';
+    reason?: string;
+    correctedArgs?: IntakeValues;
+}
+export interface ActionResult {
+    state: 'succeeded' | 'failed' | 'outcome_unknown' | 'executing' | 'waiting_review';
+    actionId: string;
+    result?: IntakeValues;
+    resultDigest?: string;
+    tombstone?: boolean;
+}
+export interface PreviewPlanInput {
+    itemId: string;
+    attemptId: string;
+    planKey: string;
+    expectedRevision: number;
+    requestId: string;
+    handlerId: string;
+    handlerVersion: string;
+    args: IntakeValues;
+}
+export interface PlanReview {
+    id: string;
+    key: string;
+    revision: number;
+    digest: string;
+    steps: ProposalReview[];
+}
+//# sourceMappingURL=execution-dto.d.ts.map

package/dist/execution-dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-dto.d.ts","sourceRoot":"","sources":["../src/execution-dto.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnD,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AACD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAChD;AACD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,YAAY,CAAC;CAC9B;AACD,MAAM,WAAW,YAAY;IAC3B,KAAK,EACD,WAAW,GACX,QAAQ,GACR,iBAAiB,GACjB,WAAW,GACX,gBAAgB,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;CACpB;AACD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB"}

package/dist/execution-internal.d.ts

@@ -0,0 +1,7 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { HandlerContext } from './execution-contracts.js';
+export declare const discoveryTransaction: unique symbol;
+export declare const generationSnapshotRead: unique symbol;
+export type TransactionRunner<T> = (work: (db: DatabaseInterface) => Promise<T>) => Promise<T>;
+export type DiscoveryGate = <T>(handlerId: string, handlerVersion: string, work: (context: HandlerContext) => Promise<T>) => Promise<T>;
+//# sourceMappingURL=execution-internal.d.ts.map

package/dist/execution-internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-internal.d.ts","sourceRoot":"","sources":["../src/execution-internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,eAAO,MAAM,oBAAoB,eAA2C,CAAC;AAC7E,eAAO,MAAM,sBAAsB,eAElC,CAAC;AACF,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CACjC,IAAI,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,KACxC,OAAO,CAAC,CAAC,CAAC,CAAC;AAChB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,EAC5B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,KAC1C,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/execution.d.ts

@@ -0,0 +1,64 @@
+import type { JobExecutionContext } from '@happyvertical/smrt-jobs';
+import type { DatabaseInterface } from '@happyvertical/sql';
+import type { ActionResult, HandlerContext, IntakeExecutionOptions, PlanReview, PreviewPlanInput, PreviewProposalInput, ProposalReview, ReviewInput } from './execution-contracts.js';
+import { type DiscoveryGate, discoveryTransaction, type TransactionRunner } from './execution-internal.js';
+import type { IngestionOptions } from './server.js';
+export type * from './execution-contracts.js';
+export type { IntakePolicy, IntakePolicyLayer } from './policy.js';
+export { resolveIntakePolicy } from './policy.js';
+export declare function intakeBindingDigest(value: unknown): string;
+/** Server-only authoritative review/apply. Construct only from authenticated host options. */
+export declare class IntakeExecutionService {
+    private readonly options;
+    private readonly retentionIntents;
+    private readonly db;
+    private readonly config;
+    private readonly scope;
+    private readonly ajv;
+    constructor(options: IngestionOptions, config: IntakeExecutionOptions);
+    private now;
+    private tx;
+    private withRetention;
+    private restoreRetention;
+    private redactExecution;
+    private narrowRetention;
+    private rows;
+    private insert;
+    private item;
+    private ceiling;
+    private handler;
+    private operation;
+    private validate;
+    private access;
+    private principal;
+    /** Current discovery authority. Trusted callbacks use context.db for bounded reads. */
+    withDiscoveryContext<T>(itemId: string, handlerId: string, handlerVersion: string, work: (context: HandlerContext) => Promise<T>): Promise<T>;
+    /** Keep retention restoration outside the supplied foundation transaction. */
+    [discoveryTransaction]<T>(run: TransactionRunner<T>, itemId: string, work: (db: DatabaseInterface, authorize: DiscoveryGate) => Promise<T>): Promise<T>;
+    private discoveryContext;
+    private bound;
+    private review;
+    getAction(actionId: string): Promise<ProposalReview>;
+    private buildBinding;
+    private publish;
+    previewProposal(input: PreviewProposalInput): Promise<ProposalReview>;
+    submitDecision(input: ReviewInput): Promise<ProposalReview>;
+    private verifyEvidence;
+    private approved;
+    private arguments;
+    private retained;
+    private successful;
+    private finish;
+    applyAction(actionId: string): Promise<ActionResult>;
+    reconcileAction(actionId: string): Promise<ActionResult>;
+    /** Machine authorization is separate provenance, never a fabricated human decision. */
+    authorizeAutomatic(actionId: string): Promise<ProposalReview>;
+    previewPlan(input: PreviewPlanInput): Promise<PlanReview>;
+    applyPlan(planId: string): Promise<ActionResult[]>;
+}
+/** A jobs answer only wakes execution; the ledger's authoritative decision still gates apply. */
+export declare function continueIntakeReview(service: {
+    getAction(id: string): Promise<ProposalReview>;
+    applyAction(id: string): Promise<ActionResult>;
+}, actionId: string, task: NonNullable<JobExecutionContext['task']>): Promise<ActionResult>;
+//# sourceMappingURL=execution.d.ts.map

package/dist/execution.d.ts.map

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

package/dist/execution.js

@@ -0,0 +1,2 @@
+import { i as resolveIntakePolicy, n as continueIntakeReview, r as intakeBindingDigest, t as IntakeExecutionService } from "./chunks/execution-C6HJvl9e.js";
+export { IntakeExecutionService, continueIntakeReview, intakeBindingDigest, resolveIntakePolicy };

package/dist/extraction-providers.d.ts

@@ -0,0 +1,35 @@
+import type { AIInterface } from '@happyvertical/ai';
+import type { OCRCapabilities, OCRImage, OCROptions, OCRResult } from '@happyvertical/ocr';
+import type { PDFReader } from '@happyvertical/pdf';
+import type { Transcriber } from '@happyvertical/speech';
+import type { IntakeFailure } from './dto.js';
+import type { ExtractionRequest, ExtractionResult, ProviderIdentity } from './extraction-types.js';
+export interface ExtractionProviders {
+    pdf?: {
+        client: Pick<PDFReader, 'checkCapabilities' | 'extractMetadata' | 'extractText' | 'renderPages'>;
+        identity: ProviderIdentity;
+    };
+    ocr?: {
+        performOCR(images: OCRImage[], options?: OCROptions): Promise<OCRResult>;
+        capabilities(): Promise<OCRCapabilities>;
+        identity: ProviderIdentity;
+    };
+    speech?: {
+        client: Transcriber;
+        identity: ProviderIdentity;
+    };
+    vision?: {
+        client: Pick<AIInterface, 'chat' | 'getCapabilities'>;
+        identity: ProviderIdentity;
+    };
+    imageMode?: 'ocr' | 'vision';
+}
+export declare class ExtractionFailure extends Error {
+    readonly category: IntakeFailure;
+    constructor(category: IntakeFailure);
+}
+export declare function emptyExtraction(request: ExtractionRequest): ExtractionResult;
+export declare function validateExtractionRequest(request: ExtractionRequest): void;
+/** SDK-boundary normalization. Production calls this only inside a disposable worker. */
+export declare function extractWithProviders(request: ExtractionRequest, providers: ExtractionProviders, progress?: (result: ExtractionResult) => void): Promise<ExtractionResult>;
+//# sourceMappingURL=extraction-providers.d.ts.map

package/dist/extraction-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-providers.d.ts","sourceRoot":"","sources":["../src/extraction-providers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,UAAU,EACV,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAEV,iBAAiB,EACjB,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE;QACJ,MAAM,EAAE,IAAI,CACV,SAAS,EACT,mBAAmB,GAAG,iBAAiB,GAAG,aAAa,GAAG,aAAa,CACxE,CAAC;QACF,QAAQ,EAAE,gBAAgB,CAAC;KAC5B,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QACzE,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;QACzC,QAAQ,EAAE,gBAAgB,CAAC;KAC5B,CAAC;IACF,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAC7D,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC;QACtD,QAAQ,EAAE,gBAAgB,CAAC;KAC5B,CAAC;IACF,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC9B;AACD,qBAAa,iBAAkB,SAAQ,KAAK;IAC9B,QAAQ,CAAC,QAAQ,EAAE,aAAa;gBAAvB,QAAQ,EAAE,aAAa;CAG7C;AAYD,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAmB5E;AACD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAU1E;AACD,yFAAyF;AACzF,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,mBAAmB,EAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAC5C,OAAO,CAAC,gBAAgB,CAAC,CAkc3B"}

package/dist/extraction-types.d.ts

@@ -0,0 +1,94 @@
+import type { IntakeEvidenceDTO, IntakeFailure } from './dto.js';
+export interface ExtractionLimits {
+    maxBytes: number;
+    maxPages: number;
+    maxPixels: number;
+    maxOutputBytes: number;
+    timeoutMs: number;
+    maxTokens: number;
+    workerHeapMb: number;
+}
+export interface ProviderIdentity {
+    provider: string;
+    model: string;
+    version: string;
+}
+/** Project host/provider objects onto the only persistable identity fields. */
+export declare function providerIdentity(value: unknown): ProviderIdentity;
+export type EvidenceLocation = {
+    kind: 'source';
+} | {
+    kind: 'page';
+    page: number;
+} | {
+    kind: 'pages';
+    startPage: number;
+    endPage: number;
+} | {
+    kind: 'time';
+    startMs: number;
+    endMs: number;
+};
+export interface ExtractionSegment {
+    text: string;
+    location: EvidenceLocation;
+    confidence: {
+        value: number;
+        scale: '0-1';
+        calibration: 'unknown';
+    } | null;
+    boxes: Array<{
+        text: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }> | null;
+    provenance: ProviderIdentity;
+    kind: 'text' | 'transcript' | 'observation';
+}
+export interface ExtractionResult {
+    status: 'complete' | 'partial' | 'failed' | 'unsupported';
+    evidence: IntakeEvidenceDTO;
+    configurationRevision: string;
+    options: {
+        imageMode: 'ocr' | 'vision';
+        pdfOCRFallback: 'empty-page';
+        ocrOutputFormat: 'json';
+    };
+    limits: ExtractionLimits;
+    segments: ExtractionSegment[];
+    /** Full provider transcript when timed segments are also returned. */
+    transcriptText?: string;
+    capabilities: Array<ProviderIdentity & {
+        confidence: boolean;
+        boxes: boolean;
+        location: 'source' | 'page' | 'time';
+        /** Whether the SDK exposed upstream completion/usage metadata. */
+        truncation: 'unknown' | 'reported';
+        usage: 'unknown' | 'reported';
+    }>;
+    errors: Array<{
+        category: IntakeFailure;
+        location: EvidenceLocation;
+    }>;
+    omitted: EvidenceLocation[];
+    truncated: boolean;
+    usage: Record<string, number>;
+    /** Extraction is evidence, never an approval or automatic-action grant. */
+    automaticActionEligible: false;
+}
+export interface ExtractionRequest {
+    evidence: IntakeEvidenceDTO;
+    bytes: Uint8Array;
+    limits: ExtractionLimits;
+    configurationRevision: string;
+    signal?: AbortSignal;
+    /** Trusted parent authorization; adapters must await before every provider call. */
+    beforeProviderCall?: () => Promise<void>;
+}
+export interface ExtractionAdapter {
+    extract(request: ExtractionRequest): Promise<ExtractionResult>;
+}
+export declare function validLimits(limits: ExtractionLimits): boolean;
+//# sourceMappingURL=extraction-types.d.ts.map

package/dist/extraction-types.d.ts.map

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

package/dist/extraction-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extraction-worker.d.ts.map

package/dist/extraction-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-worker.d.ts","sourceRoot":"","sources":["../src/extraction-worker.ts"],"names":[],"mappings":""}

package/dist/extraction-worker.js

@@ -0,0 +1,81 @@
+import { r as extractWithProviders } from "./chunks/extraction-providers-C66ADDVe.js";
+import { getAI } from "@happyvertical/ai";
+import { UnlimitedOCRProvider, getOCR } from "@happyvertical/ocr";
+import { getPDFReader } from "@happyvertical/pdf";
+import { getTranscriber } from "@happyvertical/speech";
+//#region src/extraction-worker.ts
+process.once("message", async (message) => {
+	try {
+		const { request, configuration } = message;
+		let sequence = 0;
+		const beforeProviderCall = () => new Promise((resolve) => {
+			const id = ++sequence;
+			const receive = (reply) => {
+				if (reply.kind === "authorized" && reply.id === id) {
+					process.off("message", receive);
+					resolve();
+				}
+			};
+			process.on("message", receive);
+			process.send?.({
+				kind: "authorize",
+				id
+			});
+		});
+		const providers = { imageMode: configuration.imageMode };
+		const mime = request.evidence.mediaType.split(";")[0].trim().toLowerCase();
+		const needsImages = mime === "application/pdf" || mime.startsWith("image/");
+		if (configuration.pdf && mime === "application/pdf") providers.pdf = {
+			identity: configuration.pdf.identity,
+			client: await getPDFReader({
+				provider: configuration.pdf.provider,
+				enableOCR: false,
+				maxFileSize: request.limits.maxBytes,
+				timeout: request.limits.timeoutMs
+			})
+		};
+		if (configuration.ocr && needsImages && (mime === "application/pdf" || configuration.imageMode !== "vision")) {
+			const config = configuration.ocr;
+			const unlimited = config.identity.provider === "unlimited-ocr" ? new UnlimitedOCRProvider(config.options) : void 0;
+			const factory = getOCR({
+				provider: config.identity.provider,
+				fallbackProviders: [],
+				providerConfig: { [config.identity.provider]: config.options ?? {} }
+			});
+			providers.ocr = {
+				identity: config.identity,
+				performOCR: (images, options) => unlimited ? unlimited.performOCR(images, options) : factory.performOCR(images, options),
+				capabilities: async () => {
+					if (unlimited) return unlimited.checkCapabilities();
+					const info = (await factory.getProvidersInfo()).find((candidate) => candidate.name === config.identity.provider);
+					if (!info?.available || !info.capabilities) throw new Error("Provider unavailable");
+					return info.capabilities;
+				}
+			};
+		}
+		if (configuration.speech && mime.startsWith("audio/")) providers.speech = {
+			identity: configuration.speech.identity,
+			client: await getTranscriber(configuration.speech.options)
+		};
+		if (configuration.vision && needsImages && configuration.imageMode === "vision") providers.vision = {
+			identity: configuration.vision.identity,
+			client: await getAI(configuration.vision.options)
+		};
+		const result = await extractWithProviders({
+			...request,
+			beforeProviderCall
+		}, providers, (partial) => process.send?.({
+			kind: "progress",
+			result: partial
+		}));
+		process.send?.({
+			kind: "result",
+			result
+		}, () => process.exit(0));
+	} catch {
+		process.send?.({ kind: "failure" }, () => process.exit(1));
+	}
+});
+//#endregion
+
+//# sourceMappingURL=extraction-worker.js.map

package/dist/extraction-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-worker.js","names":[],"sources":["../src/extraction-worker.ts"],"sourcesContent":["import { getAI } from '@happyvertical/ai';\nimport { getOCR, UnlimitedOCRProvider } from '@happyvertical/ocr';\nimport { getPDFReader } from '@happyvertical/pdf';\nimport { getTranscriber } from '@happyvertical/speech';\nimport type { ExtractionSDKConfiguration } from './extraction.js';\nimport {\n  type ExtractionProviders,\n  extractWithProviders,\n} from './extraction-providers.js';\nimport type { ExtractionRequest } from './extraction-types.js';\n\n// A separate entry, never imported by browser or normal server initialization.\nprocess.once(\n  'message',\n  async (message: {\n    request: Omit<ExtractionRequest, 'signal' | 'beforeProviderCall'>;\n    configuration: ExtractionSDKConfiguration;\n  }) => {\n    try {\n      const { request, configuration } = message;\n      let sequence = 0;\n      const beforeProviderCall = () =>\n        new Promise<void>((resolve) => {\n          const id = ++sequence;\n          const receive = (reply: { kind: string; id?: number }) => {\n            if (reply.kind === 'authorized' && reply.id === id) {\n              process.off('message', receive);\n              resolve();\n            }\n          };\n          process.on('message', receive);\n          process.send?.({ kind: 'authorize', id });\n        });\n      const providers: ExtractionProviders = {\n        imageMode: configuration.imageMode,\n      };\n      const mime = request.evidence.mediaType\n        .split(';')[0]\n        .trim()\n        .toLowerCase();\n      const needsImages =\n        mime === 'application/pdf' || mime.startsWith('image/');\n      if (configuration.pdf && mime === 'application/pdf')\n        providers.pdf = {\n          identity: configuration.pdf.identity,\n          client: await getPDFReader({\n            provider: configuration.pdf.provider,\n            enableOCR: false,\n            maxFileSize: request.limits.maxBytes,\n            timeout: request.limits.timeoutMs,\n          }),\n        };\n      if (\n        configuration.ocr &&\n        needsImages &&\n        (mime === 'application/pdf' || configuration.imageMode !== 'vision')\n      ) {\n        const config = configuration.ocr;\n        const unlimited =\n          config.identity.provider === 'unlimited-ocr'\n            ? new UnlimitedOCRProvider(config.options)\n            : undefined;\n        const factory = getOCR({\n          provider: config.identity.provider,\n          fallbackProviders: [],\n          providerConfig: { [config.identity.provider]: config.options ?? {} },\n        });\n        providers.ocr = {\n          identity: config.identity,\n          performOCR: (images, options) =>\n            unlimited\n              ? unlimited.performOCR(images, options)\n              : factory.performOCR(images, options),\n          capabilities: async () => {\n            if (unlimited) return unlimited.checkCapabilities();\n            const infos = await factory.getProvidersInfo();\n            const info = infos.find(\n              (candidate) => candidate.name === config.identity.provider,\n            );\n            if (!info?.available || !info.capabilities)\n              throw new Error('Provider unavailable');\n            return info.capabilities;\n          },\n        };\n      }\n      if (configuration.speech && mime.startsWith('audio/'))\n        providers.speech = {\n          identity: configuration.speech.identity,\n          client: await getTranscriber(configuration.speech.options),\n        };\n      if (\n        configuration.vision &&\n        needsImages &&\n        configuration.imageMode === 'vision'\n      )\n        providers.vision = {\n          identity: configuration.vision.identity,\n          client: await getAI(configuration.vision.options),\n        };\n      const result = await extractWithProviders(\n        { ...request, beforeProviderCall },\n        providers,\n        (partial) => process.send?.({ kind: 'progress', result: partial }),\n      );\n      process.send?.({ kind: 'result', result }, () => process.exit(0));\n    } catch {\n      process.send?.({ kind: 'failure' }, () => process.exit(1));\n    }\n  },\n);\n"],"mappings":";;;;;;AAYA,QAAQ,KACN,WACA,OAAO,YAGD;CACJ,IAAI;EACF,MAAM,EAAE,SAAS,kBAAkB;EACnC,IAAI,WAAW;EACf,MAAM,2BACJ,IAAI,SAAe,YAAY;GAC7B,MAAM,KAAK,EAAE;GACb,MAAM,WAAW,UAAyC;IACxD,IAAI,MAAM,SAAS,gBAAgB,MAAM,OAAO,IAAI;KAClD,QAAQ,IAAI,WAAW,OAAO;KAC9B,QAAQ;IACV;GACF;GACA,QAAQ,GAAG,WAAW,OAAO;GAC7B,QAAQ,OAAO;IAAE,MAAM;IAAa;GAAG,CAAC;EAC1C,CAAC;EACH,MAAM,YAAiC,EACrC,WAAW,cAAc,UAC3B;EACA,MAAM,OAAO,QAAQ,SAAS,UAC3B,MAAM,GAAG,CAAA,CAAE,EAAC,CACZ,KAAK,CAAA,CACL,YAAY;EACf,MAAM,cACJ,SAAS,qBAAqB,KAAK,WAAW,QAAQ;EACxD,IAAI,cAAc,OAAO,SAAS,mBAChC,UAAU,MAAM;GACd,UAAU,cAAc,IAAI;GAC5B,QAAQ,MAAM,aAAa;IACzB,UAAU,cAAc,IAAI;IAC5B,WAAW;IACX,aAAa,QAAQ,OAAO;IAC5B,SAAS,QAAQ,OAAO;GAC1B,CAAC;EACH;EACF,IACE,cAAc,OACd,gBACC,SAAS,qBAAqB,cAAc,cAAc,WAC3D;GACA,MAAM,SAAS,cAAc;GAC7B,MAAM,YACJ,OAAO,SAAS,aAAa,kBACzB,IAAI,qBAAqB,OAAO,OAAO,IACvC,KAAA;GACN,MAAM,UAAU,OAAO;IACrB,UAAU,OAAO,SAAS;IAC1B,mBAAmB,CAAC;IACpB,gBAAgB,GAAG,OAAO,SAAS,WAAW,OAAO,WAAW,CAAC,EAAE;GACrE,CAAC;GACD,UAAU,MAAM;IACd,UAAU,OAAO;IACjB,aAAa,QAAQ,YACnB,YACI,UAAU,WAAW,QAAQ,OAAO,IACpC,QAAQ,WAAW,QAAQ,OAAO;IACxC,cAAc,YAAY;KACxB,IAAI,WAAW,OAAO,UAAU,kBAAkB;KAElD,MAAM,QAAO,MADO,QAAQ,iBAAiB,EAAA,CAC1B,MAChB,cAAc,UAAU,SAAS,OAAO,SAAS,QACpD;KACA,IAAI,CAAC,MAAM,aAAa,CAAC,KAAK,cAC5B,MAAM,IAAI,MAAM,sBAAsB;KACxC,OAAO,KAAK;IACd;GACF;EACF;EACA,IAAI,cAAc,UAAU,KAAK,WAAW,QAAQ,GAClD,UAAU,SAAS;GACjB,UAAU,cAAc,OAAO;GAC/B,QAAQ,MAAM,eAAe,cAAc,OAAO,OAAO;EAC3D;EACF,IACE,cAAc,UACd,eACA,cAAc,cAAc,UAE5B,UAAU,SAAS;GACjB,UAAU,cAAc,OAAO;GAC/B,QAAQ,MAAM,MAAM,cAAc,OAAO,OAAO;EAClD;EACF,MAAM,SAAS,MAAM,qBACnB;GAAE,GAAG;GAAS;EAAmB,GACjC,YACC,YAAY,QAAQ,OAAO;GAAE,MAAM;GAAY,QAAQ;EAAQ,CAAC,CACnE;EACA,QAAQ,OAAO;GAAE,MAAM;GAAU;EAAO,SAAS,QAAQ,KAAK,CAAC,CAAC;CAClE,QAAQ;EACN,QAAQ,OAAO,EAAE,MAAM,UAAU,SAAS,QAAQ,KAAK,CAAC,CAAC;CAC3D;AACF,CACF"}

package/dist/extraction.d.ts

@@ -0,0 +1,49 @@
+import type { GetAIOptions } from '@happyvertical/ai';
+import type { PDFReaderOptions } from '@happyvertical/pdf';
+import type { GetTranscriberOptions } from '@happyvertical/speech';
+import type { ExtractionAdapter, ExtractionRequest, ExtractionResult, ProviderIdentity } from './extraction-types.js';
+import type { AnalysisLease, IngestionService } from './server.js';
+export type * from './extraction-types.js';
+/** Trusted server configuration. Credentials never enter analysis provenance. */
+export interface ExtractionSDKConfiguration {
+    pdf?: {
+        provider: NonNullable<PDFReaderOptions['provider']>;
+        identity: ProviderIdentity;
+    };
+    ocr?: {
+        identity: ProviderIdentity;
+        options?: Record<string, unknown>;
+    };
+    speech?: {
+        identity: ProviderIdentity;
+        options: GetTranscriberOptions;
+    };
+    vision?: {
+        identity: ProviderIdentity;
+        options: GetAIOptions;
+    };
+    imageMode?: 'ocr' | 'vision';
+    /** Maximum concurrent child processes for this adapter instance (default 1). */
+    maxConcurrentProcesses?: number;
+    /** The deployment enforces a native-memory ceiling outside Node (e.g. container).
+     * Required for native decoders: Node's heap cap does not bound native allocation. */
+    nativeMemoryIsolation: 'host-enforced';
+}
+/** Production adapter: bounded per-evidence child, terminated on deadline/abort. */
+export declare function createSDKExtractionAdapter(configuration: ExtractionSDKConfiguration): ExtractionAdapter;
+/** Current access is rechecked on read and fenced publication by the foundation.
+ * The host already allocated the immutable input/config revision and lease. */
+export declare function extractAnalysis(service: IngestionService, lease: AnalysisLease, adapter: ExtractionAdapter, options: Pick<ExtractionRequest, 'limits' | 'configurationRevision' | 'signal'>): Promise<boolean>;
+/** Side-effect-free, versioned split proposal. Original evidence is not replaced. */
+export declare function proposeDocumentSplits(result: ExtractionResult, revision: number, groups: number[][]): {
+    digest: string;
+    revision: number;
+    evidenceId: string;
+    inputHash: string;
+    configurationRevision: string;
+    groups: {
+        pages: number[];
+    }[];
+    status: "proposed";
+};
+//# sourceMappingURL=extraction.d.ts.map

package/dist/extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["../src/extraction.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAOnE,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnE,mBAAmB,uBAAuB,CAAC;AAE3C,iFAAiF;AACjF,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE;QACJ,QAAQ,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;QACpD,QAAQ,EAAE,gBAAgB,CAAC;KAC5B,CAAC;IACF,GAAG,CAAC,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACxE,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,qBAAqB,CAAA;KAAE,CAAC;IACxE,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC;IAC/D,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC7B,gFAAgF;IAChF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;yFACqF;IACrF,qBAAqB,EAAE,eAAe,CAAC;CACxC;AAED,oFAAoF;AACpF,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,0BAA0B,GACxC,iBAAiB,CAiKnB;AAuHD;+EAC+E;AAC/E,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,IAAI,CACX,iBAAiB,EACjB,QAAQ,GAAG,uBAAuB,GAAG,QAAQ,CAC9C,GACA,OAAO,CAAC,OAAO,CAAC,CAuGlB;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,EAAE;;;;;;;;;;EAgCnB"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import './__smrt-register__.js';
+export * from './dto.js';
+export * from './models.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,CAAC;AAEhC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+import "./dto.js";
+import { IntakeAction, IntakeAnalysis, IntakeAnalysisAttempt, IntakeDeletion, IntakeDispatch, IntakeEvidence, IntakeExecution, IntakeFeedback, IntakeItem, IntakePlan, IntakeProposal, IntakeReviewDecision } from "./models.js";
+export { IntakeAction, IntakeAnalysis, IntakeAnalysisAttempt, IntakeDeletion, IntakeDispatch, IntakeEvidence, IntakeExecution, IntakeFeedback, IntakeItem, IntakePlan, IntakeProposal, IntakeReviewDecision };