@kontourai/survey 0.4.23 → 0.5.0

package/dist/src/to-flow-artifact.d.ts

@@ -0,0 +1,41 @@
+import type { ReviewOutcome, ReviewStatus } from "./types.js";
+/**
+ * The neutral trust-artifact shape Kontour Flow consumes through
+ * `flow attach-evidence --trust-artifact`. Flow evaluates only these fields
+ * plus its own definition and project config; Survey stays the producer-side
+ * authority for what the review actually decided.
+ */
+export interface FlowTrustArtifact {
+    schema_version: "0.1";
+    artifact_type: "trust-report";
+    subject: string;
+    producer: string;
+    status: string;
+    issued_at: string;
+    authority_traces: string[];
+    claims: Array<{
+        type: string;
+        subject: string;
+        status: string;
+    }>;
+}
+export interface FlowTrustArtifactOptions {
+    /** Flow claim type the gate expects, e.g. "adversarial.review". */
+    claimType: string;
+    /** Flow claim subject the gate expects, e.g. "adversarial-pass.review". */
+    subject: string;
+    /** Producer identity recorded on the artifact, e.g. "survey/adversarial-workbench". */
+    producer: string;
+    /** Defaults to the review outcome's reviewedAt, then the current time. */
+    issuedAt?: string;
+    /** Defaults to ["survey:review-outcome/<outcome id>"]. */
+    authorityTraces?: string[];
+    /** Override the ReviewStatus -> artifact status projection per entry. */
+    statusMap?: Partial<Record<ReviewStatus, string>>;
+}
+/**
+ * Projects a Survey ReviewOutcome into the neutral trust artifact Flow
+ * consumes, so a per-round review (including an adversarial pass) can satisfy
+ * or fail a Flow gate without Flow learning Survey vocabulary.
+ */
+export declare function flowTrustArtifactFromReviewOutcome(outcome: ReviewOutcome, options: FlowTrustArtifactOptions): FlowTrustArtifact;

package/dist/src/to-flow-artifact.js

@@ -0,0 +1,31 @@
+const defaultStatusMap = {
+    verified: "trusted",
+    assumed: "assumed",
+    proposed: "proposed",
+    rejected: "rejected",
+};
+/**
+ * Projects a Survey ReviewOutcome into the neutral trust artifact Flow
+ * consumes, so a per-round review (including an adversarial pass) can satisfy
+ * or fail a Flow gate without Flow learning Survey vocabulary.
+ */
+export function flowTrustArtifactFromReviewOutcome(outcome, options) {
+    if (!outcome.id) {
+        throw new Error("flowTrustArtifactFromReviewOutcome requires a review outcome id");
+    }
+    const statusMap = { ...defaultStatusMap, ...options.statusMap };
+    const status = statusMap[outcome.status];
+    if (!status) {
+        throw new Error(`flowTrustArtifactFromReviewOutcome: unmapped review status '${outcome.status}'`);
+    }
+    return {
+        schema_version: "0.1",
+        artifact_type: "trust-report",
+        subject: options.subject,
+        producer: options.producer,
+        status,
+        issued_at: options.issuedAt ?? outcome.reviewedAt ?? new Date().toISOString(),
+        authority_traces: options.authorityTraces ?? [`survey:review-outcome/${outcome.id}`],
+        claims: [{ type: options.claimType, subject: options.subject, status }],
+    };
+}

package/dist/src/to-surface.d.ts

@@ -1,6 +1,6 @@
-import type { TrustInput } from "@kontourai/surface";
+import type { TrustBundle } from "@kontourai/surface";
 import type { SurveyInput } from "./types.js";
-export interface BuildSurveyTrustInputOptions {
+export interface BuildSurveyTrustBundleOptions {
     reviewProofs?: boolean;
 }
-export declare function buildSurveyTrustInput(input: SurveyInput, options?: BuildSurveyTrustInputOptions): TrustInput;
+export declare function buildSurveyTrustBundle(input: SurveyInput, options?: BuildSurveyTrustBundleOptions): TrustBundle;

package/dist/src/to-surface.js

@@ -1,5 +1,5 @@
 import { buildReviewProofAnchor } from "./review-proof.js";
-export function buildSurveyTrustInput(input, options = {}) {
+export function buildSurveyTrustBundle(input, options = {}) {
     const rawSources = indexById(input.rawSources, "raw source");
     const extractions = indexById(input.extractions, "extraction");
     const candidateSets = indexById(input.candidateSets, "candidate set");

package/dist/src/types.d.ts

@@ -1,6 +1,6 @@
 import type { ConfidenceBasis, DerivationEdge, EvidenceMethod, EvidenceType, ImpactLevel, TrustStatus } from "@kontourai/surface";
-export type RawSourceKind = "uploaded-document" | "web-page" | "api-record" | "manual-entry" | "policy-standard";
-export type LocatorScheme = "pdf" | "text" | "html" | "structured-field";
+export type RawSourceKind = "uploaded-document" | "web-page" | "api-record" | "manual-entry" | "policy-standard" | "inquiry-question" | "agent-utterance" | "system-schema";
+export type LocatorScheme = "pdf" | "text" | "html" | "structured-field" | "text-span";
 export interface RawSource {
     id: string;
     kind: RawSourceKind;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontourai/survey",
-  "version": "0.4.23",
+  "version": "0.5.0",
   "description": "Producer-side source, extraction, candidate, and review contracts for projecting verified claims into Surface.",
   "license": "Apache-2.0",
   "type": "module",
@@ -9,7 +9,7 @@
     "type": "git",
     "url": "git+https://github.com/kontourai/survey.git"
   },
-  "homepage": "https://kontourai.io/survey",
+  "homepage": "https://kontourai.github.io/survey/",
   "bugs": {
     "url": "https://github.com/kontourai/survey/issues"
   },
@@ -18,6 +18,10 @@
   },
   "exports": {
     ".": "./dist/src/index.js",
+    "./anthropic": {
+      "types": "./dist/src/anthropic.d.ts",
+      "default": "./dist/src/anthropic.js"
+    },
     "./review-workbench": {
       "types": "./dist/src/review-workbench/review-workbench.d.ts",
       "default": "./dist/src/review-workbench/review-workbench.js"
@@ -28,14 +32,14 @@
     },
     "./review-workbench.css": "./dist/src/review-workbench/review-workbench.css",
     "./review-workbench/standalone.css": "./dist/src/review-workbench/review-workbench.standalone.css",
-    "./fixtures/public-field-review": "./dist/fixtures/public-field-review.js",
-    "./fixtures/corrected-document-candidates": "./dist/fixtures/corrected-document-candidates.js",
-    "./fixtures/public-directory-review-resource": "./dist/fixtures/public-directory-review-resource.js",
-    "./fixtures/regulated-document-review-resource": "./dist/fixtures/regulated-document-review-resource.js"
+    "./example-data/public-field-review": "./dist/example-data/public-field-review.js",
+    "./example-data/corrected-document-candidates": "./dist/example-data/corrected-document-candidates.js",
+    "./example-data/public-directory-review-resource": "./dist/example-data/public-directory-review-resource.js",
+    "./example-data/regulated-document-review-resource": "./dist/example-data/regulated-document-review-resource.js"
   },
   "files": [
     "dist/examples/",
-    "dist/fixtures/",
+    "dist/example-data/",
     "dist/src/",
     "README.md"
   ],
@@ -52,15 +56,27 @@
     "check:review-workbench": "npm run check:review-workbench:static",
     "check:review-workbench:static": "npm run build && node scripts/check-review-workbench.cjs",
     "setup:repo-hooks": "node scripts/setup-repo-hooks.cjs",
-    "validate:repo-hooks": "node scripts/validate-repo-hooks.cjs"
+    "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"
   },
   "dependencies": {
-    "@kontourai/surface": "^0.5.1"
+    "@kontourai/surface": "^0.9.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.20.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "@anthropic-ai/sdk": "^0.54.0",
     "@kontourai/console-kit": "^0.1.0",
     "@playwright/test": "^1.60.0",
     "@types/node": "^25.6.0",
+    "marked": "^16.4.2",
     "typescript": "^5.8.0"
   },
   "engines": {

package/dist/fixtures/corrected-document-candidates.d.ts

@@ -1,2 +0,0 @@
-import type { SurveyInput } from "../src/index.js";
-export declare const correctedDocumentCandidatesFixture: SurveyInput;

package/dist/fixtures/public-field-review.d.ts

@@ -1,2 +0,0 @@
-import type { SurveyInput } from "../src/index.js";
-export declare const publicFieldReviewFixture: SurveyInput;