@happyvertical/smrt-ingestion 0.55.5 → 0.55.7

package/dist/proposal-contracts.d.ts

@@ -0,0 +1,89 @@
+import type { DecisionClient } from '@happyvertical/smrt-core';
+import type { HandlerContext } from './execution-contracts.js';
+import type { IntakeValues } from './execution-dto.js';
+import type { EvidenceLocation, ProviderIdentity } from './extraction-types.js';
+import type { ProposalCandidate, ProposalCatalogEntry, ProposalReferenceField } from './proposal-dto.js';
+/** Optional discovery capability on the existing application execution handler. */
+export interface HandlerDiscovery {
+    mediaTypes: readonly string[];
+    /** Every existing-record argument exposed to generation must be declared here. */
+    references: Readonly<Record<string, ProposalReferenceField>>;
+    /** Database reads only; filter in the query before ranking/summarizing. */
+    candidates?(query: string, context: HandlerContext, page: {
+        limit: number;
+    }): Promise<{
+        items: Array<Omit<ProposalCandidate, 'key'>>;
+        hasMore: boolean;
+    }>;
+}
+export interface GenerationLimits {
+    maxHandlers: number;
+    maxCandidates: number;
+    maxSuggestions: number;
+    maxInputBytes: number;
+    maxOutputBytes: number;
+    maxQueryLength: number;
+    timeoutMs: number;
+}
+export interface GenerativeProposalInput {
+    evidence: Array<{
+        evidenceId: string;
+        partId: string;
+        parentEvidenceId: string | null;
+        mediaType: string;
+        contentHash: string;
+        segments: Array<{
+            text: string;
+            location: EvidenceLocation;
+        }>;
+    }>;
+    offered: Array<{
+        handler: ProposalCatalogEntry;
+        candidates: ProposalCandidate[];
+    }>;
+    instructions: string;
+    /** Bounded, currently eligible examples; neither evidence nor authority. */
+    examples?: import('./feedback-dto.js').FeedbackSelection;
+    /** Authenticated human correction carried through fresh extraction; never model authority. */
+    humanCorrection?: IntakeValues;
+}
+/** Inject only trusted SDK-bound adapters. Generative output is always untrusted. */
+export interface ProposalGenerator {
+    identity: ProviderIdentity;
+    generate(input: GenerativeProposalInput, options: {
+        signal: AbortSignal;
+        maxOutputBytes: number;
+    }): Promise<{
+        output: unknown;
+        completion: 'complete' | 'unknown';
+        usage?: Record<string, number>;
+    }>;
+}
+export interface ProposalConfiguration {
+    version: string;
+    promptVersion: string;
+    generator: ProposalGenerator;
+    /** Absent means the normal unconfigured decision path, never fake probability. */
+    decision?: {
+        client: DecisionClient;
+        identity: ProviderIdentity;
+    };
+    minimumDecisionProbability?: number;
+    tieMargin?: number;
+    limits: GenerationLimits;
+}
+export interface GenerationStageConfiguration extends IntakeValues {
+    stage: 'interpret';
+    proposals: {
+        source: import('./proposal-dto.js').GenerationSourcePin;
+        configurationVersion: string;
+        promptVersion: string;
+        catalogDigest: string;
+        generator: ProviderIdentity;
+        decision: ProviderIdentity | null;
+        limits: GenerationLimits;
+        minimumDecisionProbability: number;
+        tieMargin: number;
+    };
+}
+//# sourceMappingURL=proposal-contracts.d.ts.map

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

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

package/dist/proposal-dto.d.ts

@@ -0,0 +1,124 @@
+/** Browser-safe proposal messages. No callbacks or authority-bearing context. */
+import type { CapabilityDeclaration } from '@happyvertical/smrt-types';
+import type { AnalysisOutput, IntakeEvidenceDTO } from './dto.js';
+import type { IntakeValues, PlanReview, ProposalReview } from './execution-dto.js';
+import type { EvidenceLocation, ProviderIdentity } from './extraction-types.js';
+export interface GenerationSourcePin {
+    attemptId: string;
+    revision: number;
+    inputDigest: string;
+    outputDigest: string;
+    evidenceDigest: string;
+}
+export interface CompletedAnalysisSnapshot extends GenerationSourcePin {
+    itemId: string;
+    configuration: IntakeValues;
+    evidence: IntakeEvidenceDTO[];
+    result: AnalysisOutput;
+}
+export interface ProposalCandidate {
+    key: string;
+    model: string;
+    id: string;
+    revision: string;
+    label: string;
+}
+export interface CandidatePage {
+    items: ProposalCandidate[];
+    truncated: boolean;
+}
+export type ProposalReferenceField = {
+    kind: 'candidate';
+    model: string;
+} | {
+    kind: 'evidence';
+};
+export interface ProposalCatalogEntry {
+    id: string;
+    version: string;
+    description: string;
+    kind: 'operation' | 'plan';
+    /** A plan has no invented aggregate classification; its ordered definition is pinned. */
+    capability: CapabilityDeclaration | null;
+    argsSchema: IntakeValues;
+    references: Record<string, ProposalReferenceField>;
+    operation: {
+        model: string;
+        action: string;
+        version: string;
+    } | {
+        playbookKey: string;
+        definitionHash: string;
+    };
+}
+export interface ProposalEvidenceReference {
+    evidenceId: string;
+    location: EvidenceLocation;
+}
+export interface GeneratedSuggestion {
+    handlerId: string;
+    handlerVersion: string;
+    args: IntakeValues;
+    evidence: ProposalEvidenceReference[];
+    alternatives: string[];
+    missingFields: string[];
+    explanation: string;
+    disposition: 'ready_for_review' | 'needs_review';
+}
+export interface GenerationOutput {
+    version: 1;
+    outcome: 'proposals' | 'unknown' | 'ambiguous' | 'no_action' | 'needs_review' | 'provider_error';
+    suggestions: GeneratedSuggestion[];
+    splits: Array<{
+        evidenceId: string;
+        groups: number[][];
+        digest: string;
+    }>;
+    warnings: string[];
+    omittedSuggestions: number;
+    source: GenerationSourcePin;
+    offered: Array<{
+        handler: ProposalCatalogEntry;
+        candidates: ProposalCandidate[];
+    }>;
+    provenance: {
+        feedback?: {
+            query: string;
+            selection: import('./feedback-dto.js').FeedbackReferences;
+        };
+        configurationVersion: string;
+        promptVersion: string;
+        catalogDigest: string;
+        policyVersions: string[];
+        generative: ProviderIdentity;
+        decision: {
+            configured: boolean;
+            provider?: string;
+            model?: string;
+            version?: string;
+            answers?: IntakeValues;
+            usage?: Record<string, number>;
+        };
+        usage: Record<string, number>;
+    };
+    automaticActionEligible: false;
+}
+export interface PreviewGeneratedInput {
+    itemId: string;
+    attemptId: string;
+    /** Explicit stable business intentions supplied by the host, never the model. */
+    selections: Array<{
+        index: number;
+        intentionKey: string;
+        expectedRevision: number;
+        requestId: string;
+    }>;
+}
+export type GeneratedPreview = {
+    kind: 'operation';
+    review: ProposalReview;
+} | {
+    kind: 'plan';
+    review: PlanReview;
+};
+//# sourceMappingURL=proposal-dto.d.ts.map

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

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

package/dist/proposal-errors.d.ts

@@ -0,0 +1,5 @@
+/** Current generation is authorized, but its immutable candidate revisions are stale. */
+export declare class GenerationSnapshotStaleError extends Error {
+    constructor();
+}
+//# sourceMappingURL=proposal-errors.d.ts.map

package/dist/proposal-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-errors.d.ts","sourceRoot":"","sources":["../src/proposal-errors.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,qBAAa,4BAA6B,SAAQ,KAAK;;CAKtD"}

package/dist/proposal-sdk.d.ts

@@ -0,0 +1,12 @@
+import type { AIInterface } from '@happyvertical/ai';
+import type { DecisionClient } from '@happyvertical/smrt-core';
+import { type ProviderIdentity } from './extraction-types.js';
+import type { ProposalGenerator } from './proposal-contracts.js';
+/** Use an existing SDK client; credentials/configuration never enter persisted provenance. */
+export declare function createSDKProposalGenerator(client: Pick<AIInterface, 'chat'>, configuredIdentity: ProviderIdentity, limits: {
+    maxTokens: number;
+    timeoutMs: number;
+}): ProposalGenerator;
+/** Adapt the SDK's optional capability to core's injected decision boundary. */
+export declare function createSDKProposalDecisionClient(client: Pick<AIInterface, 'getCapabilities' | 'decide'>): DecisionClient;
+//# sourceMappingURL=proposal-sdk.d.ts.map

package/dist/proposal-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-sdk.d.ts","sourceRoot":"","sources":["../src/proposal-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,8FAA8F;AAC9F,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EACjC,kBAAkB,EAAE,gBAAgB,EACpC,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/C,iBAAiB,CAqDnB;AAED,gFAAgF;AAChF,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,iBAAiB,GAAG,QAAQ,CAAC,GACtD,cAAc,CAYhB"}

package/dist/proposal-validation.d.ts

@@ -0,0 +1,188 @@
+import type { IntakeValues } from './execution-dto.js';
+import type { ExtractionResult } from './extraction-types.js';
+import type { GenerationLimits } from './proposal-contracts.js';
+import type { GenerationOutput } from './proposal-dto.js';
+export declare function record(value: unknown): IntakeValues;
+export declare function text(value: unknown, max?: number): string;
+export declare function safeUsage(value: unknown): Record<string, number>;
+export declare function suggestionSchema(limits: GenerationLimits): {
+    type: string;
+    additionalProperties: boolean;
+    required: string[];
+    properties: {
+        outcome: {
+            enum: string[];
+        };
+        suggestions: {
+            type: string;
+            maxItems: number;
+            items: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    handlerId: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    handlerVersion: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    args: {
+                        type: string;
+                    };
+                    evidence: {
+                        type: string;
+                        minItems: number;
+                        maxItems: number;
+                        items: {
+                            type: string;
+                            additionalProperties: boolean;
+                            required: string[];
+                            properties: {
+                                evidenceId: {
+                                    type: string;
+                                    minLength: number;
+                                    maxLength: number;
+                                };
+                                location: {
+                                    oneOf: ({
+                                        type: string;
+                                        additionalProperties: boolean;
+                                        required: string[];
+                                        properties: {
+                                            kind: {
+                                                const: string;
+                                            };
+                                            page?: undefined;
+                                            startPage?: undefined;
+                                            endPage?: undefined;
+                                            startMs?: undefined;
+                                            endMs?: undefined;
+                                        };
+                                    } | {
+                                        type: string;
+                                        additionalProperties: boolean;
+                                        required: string[];
+                                        properties: {
+                                            kind: {
+                                                const: string;
+                                            };
+                                            page: {
+                                                type: string;
+                                                minimum: number;
+                                            };
+                                            startPage?: undefined;
+                                            endPage?: undefined;
+                                            startMs?: undefined;
+                                            endMs?: undefined;
+                                        };
+                                    } | {
+                                        type: string;
+                                        additionalProperties: boolean;
+                                        required: string[];
+                                        properties: {
+                                            kind: {
+                                                const: string;
+                                            };
+                                            startPage: {
+                                                type: string;
+                                                minimum: number;
+                                            };
+                                            endPage: {
+                                                type: string;
+                                                minimum: number;
+                                            };
+                                            page?: undefined;
+                                            startMs?: undefined;
+                                            endMs?: undefined;
+                                        };
+                                    } | {
+                                        type: string;
+                                        additionalProperties: boolean;
+                                        required: string[];
+                                        properties: {
+                                            kind: {
+                                                const: string;
+                                            };
+                                            startMs: {
+                                                type: string;
+                                                minimum: number;
+                                            };
+                                            endMs: {
+                                                type: string;
+                                                minimum: number;
+                                            };
+                                            page?: undefined;
+                                            startPage?: undefined;
+                                            endPage?: undefined;
+                                        };
+                                    })[];
+                                };
+                            };
+                        };
+                    };
+                    alternatives: {
+                        type: string;
+                        uniqueItems: boolean;
+                        maxItems: number;
+                        items: {
+                            type: string;
+                            minLength: number;
+                            maxLength: number;
+                        };
+                    };
+                    missingFields: {
+                        type: string;
+                        uniqueItems: boolean;
+                        maxItems: number;
+                        items: {
+                            type: string;
+                            minLength: number;
+                            maxLength: number;
+                        };
+                    };
+                    explanation: {
+                        type: string;
+                        maxLength: number;
+                    };
+                };
+            };
+        };
+        splits: {
+            type: string;
+            maxItems: number;
+            items: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    evidenceId: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    groups: {
+                        type: string;
+                        minItems: number;
+                        maxItems: number;
+                        items: {
+                            type: string;
+                            minItems: number;
+                            maxItems: number;
+                            items: {
+                                type: string;
+                                minimum: number;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+};
+export declare function validateSuggestions(raw: unknown, offered: GenerationOutput['offered'], extraction: ExtractionResult[], limits: GenerationLimits, revision: number): Pick<GenerationOutput, 'outcome' | 'suggestions' | 'splits'>;
+//# sourceMappingURL=proposal-validation.d.ts.map

package/dist/proposal-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-validation.d.ts","sourceRoot":"","sources":["../src/proposal-validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAInD;AACD,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAM,GAAG,MAAM,CAItD;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAehE;AAwCD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuFxD;AACD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EACpC,UAAU,EAAE,gBAAgB,EAAE,EAC9B,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,GACf,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC,CAkG9D"}

package/dist/proposals.d.ts

@@ -0,0 +1,44 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { generationSnapshotRead, type TransactionRunner } from './execution-internal.js';
+import type { GenerationStageConfiguration, ProposalConfiguration } from './proposal-contracts.js';
+import type { CandidatePage, CompletedAnalysisSnapshot, GeneratedPreview, PreviewGeneratedInput, ProposalCatalogEntry } from './proposal-dto.js';
+import type { AnalysisLease, IngestionOptions, IngestionService } from './server.js';
+export type * from './proposal-contracts.js';
+export type * from './proposal-dto.js';
+export { createSDKProposalDecisionClient, createSDKProposalGenerator, } from './proposal-sdk.js';
+/** Server-only interpretation. This service cannot approve or execute an action. */
+export declare class IngestionProposalService {
+    private readonly service;
+    private readonly options;
+    private readonly config;
+    private readonly execution;
+    private readonly identity;
+    private readonly decisionIdentity;
+    constructor(service: IngestionService, options: IngestionOptions, config: ProposalConfiguration);
+    private handler;
+    private entry;
+    private allowedProviders;
+    private catalog;
+    listHandlers(itemId: string): Promise<ProposalCatalogEntry[]>;
+    /** Public retrieval derives catalog/candidates and compatibility on the server. */
+    retrieveFeedback(input: import('./feedback-dto.js').RetrieveFeedbackInput): Promise<import('./feedback-dto.js').FeedbackSelection>;
+    findCandidates(input: {
+        itemId: string;
+        handlerId: string;
+        handlerVersion: string;
+        query: string;
+        limit?: number;
+    }): Promise<CandidatePage>;
+    prepareGeneration(itemId: string, attemptId: string): Promise<GenerationStageConfiguration>;
+    private extraction;
+    private live;
+    private feedbackGate;
+    private deadline;
+    generate(lease: AnalysisLease): Promise<boolean>;
+    private decide;
+    [generationSnapshotRead](itemId: string, run: TransactionRunner<CompletedAnalysisSnapshot>, read: (db: DatabaseInterface) => Promise<CompletedAnalysisSnapshot>, afterRead?: (db: DatabaseInterface, snapshot: CompletedAnalysisSnapshot) => Promise<void>, requireReview?: boolean): Promise<CompletedAnalysisSnapshot>;
+    /** Internal stage read gate; the foundation owns current snapshot/digest checks. */
+    private authorizeCompletedSnapshot;
+    preview(input: PreviewGeneratedInput): Promise<GeneratedPreview[]>;
+}
+//# sourceMappingURL=proposals.d.ts.map

package/dist/proposals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../src/proposals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAW5D,OAAO,EAGL,sBAAsB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EACV,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,aAAa,EACb,yBAAyB,EACzB,gBAAgB,EAGhB,qBAAqB,EAErB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,mBAAmB,CAAC;AACvC,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAiB3B,oFAAoF;AACpF,qBAAa,wBAAwB;IAKjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAEf,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,qBAAqB;IAuDhD,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,KAAK;IAoDb,OAAO,CAAC,gBAAgB;YAOV,OAAO;IAyDf,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAGnE,mFAAmF;IAC7E,gBAAgB,CACpB,KAAK,EAAE,OAAO,mBAAmB,EAAE,qBAAqB,GACvD,OAAO,CAAC,OAAO,mBAAmB,EAAE,iBAAiB,CAAC;IA+BnD,cAAc,CAAC,KAAK,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,aAAa,CAAC;IA4EpB,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,4BAA4B,CAAC;IA2BxC,OAAO,CAAC,UAAU;YAmCJ,IAAI;YAmCJ,YAAY;YA6BZ,QAAQ;IAmBhB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;YAwQxC,MAAM;IAyNpB,CAAC,sBAAsB,CAAC,CACtB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,CAAC,yBAAyB,CAAC,EACjD,IAAI,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,yBAAyB,CAAC,EACnE,SAAS,CAAC,EAAE,CACV,EAAE,EAAE,iBAAiB,EACrB,QAAQ,EAAE,yBAAyB,KAChC,OAAO,CAAC,IAAI,CAAC,EAClB,aAAa,UAAQ,GACpB,OAAO,CAAC,yBAAyB,CAAC;IAoCrC,oFAAoF;YACtE,0BAA0B;IA8ClC,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA0HzE"}