@kontourai/survey 2.4.2 → 2.5.0

package/dist/src/extraction-envelope.d.ts

@@ -70,7 +70,7 @@ export interface PortableExtractionResultEnvelope {
             status: "success";
         } | {
             status: "partial";
-            reason: "cancelled" | "max-provider-calls" | "max-total-tokens";
+            reason: "cancelled" | "max-provider-calls" | "max-total-tokens" | "max-chunks";
         } | {
             status: "failure";
             category: "invalid-config" | "invalid-task" | "preparation" | "provider" | "unexpected";
@@ -84,7 +84,7 @@ export interface PortableExtractionResultEnvelope {
         providerCalls: number;
         totalTokensUsed: number;
         partial?: {
-            reason: "cancelled" | "max-provider-calls" | "max-total-tokens";
+            reason: "cancelled" | "max-provider-calls" | "max-total-tokens" | "max-chunks";
             completedChunks: number;
             remainingChunks: number;
             tokenOvershoot?: number;

package/dist/src/extraction-envelope.js

@@ -429,7 +429,7 @@ function isWellFormedUnicode(value) { for (let index = 0; index < value.length;
 } return true; }
 const RAW_SOURCE_KINDS = new Set(["uploaded-document", "web-page", "api-record", "manual-entry", "policy-standard", "inquiry-question", "agent-utterance", "system-schema"]);
 const VALUE_TYPES = new Set(["string", "number", "boolean", "date", "enum", "array", "object"]);
-const PARTIAL = new Set(["cancelled", "max-provider-calls", "max-total-tokens"]);
+const PARTIAL = new Set(["cancelled", "max-provider-calls", "max-total-tokens", "max-chunks"]);
 const FAILURE_CATEGORIES = new Set(["invalid-config", "invalid-task", "preparation", "provider", "unexpected"]);
 const WARNING_CATEGORIES = new Set(["provider", "normalization", "preparation", "limit", "storage", "content", "other"]);
 const FAILURE_KINDS = new Set(["authentication", "rate-limit", "timeout", "invalid-request", "unavailable", "unknown"]);

package/dist/src/index.d.ts

@@ -10,6 +10,7 @@ export type { PortablePdfBoundingBox, PortablePdfLayout, PortablePdfPageGeometry
 export type { ExtractionAlignmentState, ArtifactUnavailableCode, BuiltExtractionInspectorCandidate, BuiltExtractionInspectorModel, ExtractionInspectorCandidate, ExtractionInspectorEntry, ExtractionInspectorExportOptions, ExtractionInspectorFilters, ExtractionInspectorInput, ExtractionInspectorModel, ExtractionInspectorSource, ResolvedExtractionArtifact, } from "./review-workbench/extraction-inspector.js";
 export type { ExtractionEnvelopeImport, ExtractionEnvelopeImportDiagnostic, ExtractionEnvelopeImportOptions, ExtractionEnvelopeImportResult, ExtractionEnvelopeResolutionIdentity, PortableExtractionOccurrence, PortableExtractionProposal, PortableExtractionResultEnvelope, PortablePreparedArtifactState, } from "./extraction-envelope.js";
 export type { CandidateRole, ClaimTargetHint, ProducerPolicy, ExtractionReference, ResourceEnvelope, ResourceMetadata, ReviewActor, ReviewCandidate, ReviewDecision, ReviewDecisionMode, ReviewDecisionSpec, ReviewDecisionStatus, ReviewItem, ReviewItemSpec, ReviewItemStatus, ReviewLocator, ReviewResource, ReviewResourceApiVersion, ReviewResourceKind, ReviewSession, ReviewSessionEvent, ReviewSessionEventSpec, ReviewSessionEventStatus, ReviewSessionEventType, ReviewSessionSpec, ReviewSessionStatus, ReviewValueDescriptor, ReviewValueType, SourceReference, SurveyRecordProjectionHint, } from "./review-resource.js";
+export { toSurfaceReviewedExtractionDecision, toSurfaceReviewedExtractionImport, toSurfaceReviewedExtractionItem, } from "./surface-reviewed-extraction.js";
 export { candidateReviewRecord, candidateSetStatusFor, SurveyInputBuilder } from "./builder.js";
 export type { CandidateReviewRecordInput, SurveyClaimRecord, SurveyInputBuilderArgs, SurveyObservationInput, } from "./builder.js";
 export { reviewedCandidateResolution } from "./reviewed-candidate-resolution.js";

package/dist/src/index.js

@@ -4,6 +4,7 @@ export { buildReviewItemsFromExtractionEnvelopeImport, createExtractionEnvelopeR
 export { buildExtractionInspectorModel, exportExtractionInspector, filterExtractionInspectorCandidates, } from "./review-workbench/extraction-inspector.js";
 export { assertReviewQueueAgainstExtractionImport, assertReviewQueueBinding, bindReviewQueue, hashReviewQueueSnapshot, UnattestedExtractionQueueError, UnattestedReviewQueueError, validateReviewQueueAgainstExtractionImport, validateReviewQueueBinding, } from "./review-workbench/queue-binding.js";
 export { resolvePortablePdfRegion } from "./pdf-layout.js";
+export { toSurfaceReviewedExtractionDecision, toSurfaceReviewedExtractionImport, toSurfaceReviewedExtractionItem, } from "./surface-reviewed-extraction.js";
 export { candidateReviewRecord, candidateSetStatusFor, SurveyInputBuilder } from "./builder.js";
 export { reviewedCandidateResolution } from "./reviewed-candidate-resolution.js";
 export { reviewedCurrentProposedResolution } from "./reviewed-current-proposed-resolution.js";

package/dist/src/surface-reviewed-extraction.d.ts

@@ -0,0 +1,6 @@
+import type { SurveyExtractionEnvelopeImport, SurveyExtractionReviewDecision, SurveyExtractionReviewItem } from "@kontourai/surface";
+import type { ExtractionEnvelopeImport } from "./extraction-envelope.js";
+import type { ReviewDecision, ReviewItem } from "./review-resource.js";
+export declare function toSurfaceReviewedExtractionImport(record: ExtractionEnvelopeImport): SurveyExtractionEnvelopeImport;
+export declare function toSurfaceReviewedExtractionItem(item: ReviewItem): SurveyExtractionReviewItem;
+export declare function toSurfaceReviewedExtractionDecision(decision: ReviewDecision): SurveyExtractionReviewDecision;

package/dist/src/surface-reviewed-extraction.js

@@ -0,0 +1,9 @@
+export function toSurfaceReviewedExtractionImport(record) {
+    return record;
+}
+export function toSurfaceReviewedExtractionItem(item) {
+    return item;
+}
+export function toSurfaceReviewedExtractionDecision(decision) {
+    return decision;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontourai/survey",
-  "version": "2.4.2",
+  "version": "2.5.0",
   "description": "Producer-side source, extraction, candidate, and review contracts for projecting verified claims into Surface.",
   "license": "Apache-2.0",
   "type": "module",
@@ -66,10 +66,12 @@
     "validate:repo-hooks": "node scripts/validate-repo-hooks.cjs",
     "docs:build": "npm run build --silent && node scripts/docs-site/build.ts",
     "docs:check": "npm run docs:build && node scripts/docs-site/check-links.ts",
-    "check:generated-css": "node scripts/copy-review-workbench-package-assets.cjs --check"
+    "check:generated-css": "node scripts/copy-review-workbench-package-assets.cjs --check",
+    "workflow:sidecar": "flow-agents-workflow-sidecar",
+    "workflow:validate-artifacts": "flow-agents-validate-artifacts"
   },
   "dependencies": {
-    "@kontourai/surface": "^2.9.0"
+    "@kontourai/surface": "^2.13.0"
   },
   "peerDependencies": {
     "typescript": ">=5.0.0"
@@ -80,6 +82,7 @@
     }
   },
   "devDependencies": {
+    "@kontourai/flow-agents": "5.5.0",
     "@kontourai/traverse": "^0.25.0",
     "@kontourai/ui": "^1.1.0",
     "@playwright/test": "^1.62.0",