@oscharko-dev/keiko-contracts 0.2.0

package/dist/evidence.d.ts

@@ -0,0 +1,297 @@
+import type { CostClass } from "./gateway.js";
+import type { HarnessCode, HarnessStateName, RunManifest, RunOutcome, RunResult, TaskType } from "./harness.js";
+import type { AuditSummary } from "./workspace.js";
+import type { VerificationAuditSummary } from "./verification-summary.js";
+export declare const EVIDENCE_SCHEMA_VERSION: "1";
+export interface EvidenceRunIdentity {
+    readonly runId: string;
+    readonly fingerprint: string;
+    readonly harnessVersion: string;
+    readonly taskType: EvidenceTaskType;
+    readonly outcome: RunOutcome;
+    readonly startedAt: number;
+    readonly finishedAt: number;
+    readonly durationMs: number;
+}
+export interface EvidenceModel {
+    readonly modelId: string;
+    readonly costClass: CostClass | "unknown";
+}
+export interface EvidenceUsageTotals {
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly requestCount: number;
+    readonly totalLatencyMs: number;
+}
+export interface EvidenceStateTransition {
+    readonly seq: number;
+    readonly ts: number;
+    readonly from: HarnessStateName;
+    readonly to: HarnessStateName;
+    readonly reason: string;
+}
+export interface EvidenceToolCall {
+    readonly seq: number;
+    readonly ts: number;
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly outcome: "completed" | "failed";
+    readonly durationMs?: number | undefined;
+    readonly errorCode?: string | undefined;
+}
+export interface EvidenceCommandExecution {
+    readonly seq: number;
+    readonly ts: number;
+    readonly executable: string;
+    readonly argCount: number;
+    readonly exitCode: number | null;
+    readonly timedOut: boolean;
+    readonly durationMs: number;
+}
+export interface EvidenceSandboxConfiguration {
+    readonly seq: number;
+    readonly ts: number;
+    readonly envAllowlist: readonly string[];
+    readonly network: "inherit" | "none";
+    readonly maxOutputBytes: number;
+    readonly timeoutMs: number;
+    readonly terminationGraceMs: number;
+    readonly cwdRequested: boolean;
+}
+export interface EvidenceVerificationResult {
+    readonly seq: number;
+    readonly ts: number;
+    readonly passed: boolean;
+    readonly detail: string;
+}
+export interface EvidencePatch {
+    readonly proposed: boolean;
+    readonly applied: boolean;
+    readonly targetFileCount: number;
+    readonly patchBytes: number;
+    readonly changedFiles: number;
+    readonly created: number;
+    readonly deleted: number;
+    readonly redactedDiff?: string | undefined;
+}
+export interface EvidenceReasoningEntry {
+    readonly seq: number;
+    readonly ts: number;
+    readonly phase: HarnessStateName;
+    readonly rationale: string;
+    readonly modelResponse?: string | undefined;
+}
+export interface EvidenceFailure {
+    readonly category: HarnessCode;
+    readonly message: string;
+}
+export type EvidenceTaskType = TaskType | "browser-capture" | "terminal-execution" | "connected-context";
+export interface EvidenceBrowserViewportPx {
+    readonly width: number;
+    readonly height: number;
+}
+export type EvidenceBrowserEventType = "browser:session-opened" | "browser:navigated" | "browser:screenshot-captured" | "browser:page-content-captured" | "browser:session-closed" | "browser:trust-warning" | "browser:error";
+export interface EvidenceBrowserEvent {
+    readonly schemaVersion: "1";
+    readonly type: EvidenceBrowserEventType;
+    readonly sessionId: string;
+    readonly seq: number;
+    readonly ts: number;
+    readonly originOnly?: string | undefined;
+    readonly httpStatus?: number | null | undefined;
+    readonly captureSeq?: number | undefined;
+    readonly persisted?: boolean | undefined;
+    readonly viewportPx?: EvidenceBrowserViewportPx | undefined;
+    readonly path?: string | undefined;
+    readonly sha256?: string | undefined;
+    readonly bytes?: number | undefined;
+    readonly byteLength?: number | undefined;
+    readonly reason?: string | undefined;
+    readonly warning?: string | undefined;
+    readonly code?: string | undefined;
+    readonly message?: string | undefined;
+}
+export interface EvidenceBrowserScreenshot {
+    readonly seq: number;
+    readonly path: string;
+    readonly sha256: string;
+    readonly bytes: number;
+    readonly capturedAt: number;
+    readonly viewportPx: EvidenceBrowserViewportPx;
+}
+export interface EvidenceBrowserContentCapture {
+    readonly seq: number;
+    readonly byteLength: number;
+    readonly capturedAt: number;
+    readonly redactedHtml: string;
+}
+export interface EvidenceBrowserCapture {
+    readonly sessionId: string;
+    readonly cdpPort: number;
+    readonly targetId: string;
+    readonly status: "open" | "closed";
+    readonly startedAt: number;
+    readonly closedAt?: number | undefined;
+    readonly closeReason?: string | undefined;
+    readonly lastOriginOnly?: string | undefined;
+    readonly events: readonly EvidenceBrowserEvent[];
+    readonly screenshots?: readonly EvidenceBrowserScreenshot[] | undefined;
+    readonly contentCaptures?: readonly EvidenceBrowserContentCapture[] | undefined;
+}
+export interface EvidenceConnectedContextScope {
+    readonly schemaVersion: "1";
+    readonly scopeIdHash: string;
+    readonly scopeKind: string;
+    readonly selectedPathCount: number;
+    readonly selectedPaths: readonly string[];
+}
+export interface EvidenceConnectedContextQuery {
+    readonly kind: string;
+    readonly queryTextHash: string;
+    readonly queryTextBytes: number;
+    readonly maxResults: number;
+    readonly caseSensitive: boolean;
+}
+export interface EvidenceConnectedContextExcerpt {
+    readonly atomStableId: string;
+    readonly scopePath: string;
+    readonly lineRange?: {
+        readonly startLine: number;
+        readonly endLine: number;
+    } | undefined;
+    readonly score: number;
+    readonly provenanceKind: string;
+    readonly tool: string;
+    readonly queryFingerprint: string;
+    readonly redactionState: string;
+    readonly contentBytes: number;
+    readonly contentSha256: string;
+}
+export interface EvidenceConnectedContextFile {
+    readonly scopePath: string;
+    readonly role: string;
+    readonly selectionReason: string;
+    readonly excerptCount: number;
+    readonly excerptBytes: number;
+    readonly excerpts: readonly EvidenceConnectedContextExcerpt[];
+}
+export interface EvidenceConnectedContextOmitted {
+    readonly scopePath: string;
+    readonly reason: string;
+}
+export interface EvidenceConnectedContextUncertainty {
+    readonly kind: string;
+    readonly impactedAtomCount: number;
+}
+export interface EvidenceConnectedContextPlan {
+    readonly planIdHash: string;
+    readonly state: string;
+    readonly createdAtMs: number | undefined;
+    readonly anchorCount: number;
+    readonly anchorKinds: Record<string, number>;
+    readonly anchorTermHashes: readonly string[];
+    readonly ringKinds: readonly string[];
+    readonly clarificationReason: string | undefined;
+}
+export interface EvidenceConnectedContextAudit {
+    readonly packSchemaVersion: "1";
+    readonly packStableIdHash: string;
+    readonly chatIdHash: string | undefined;
+    readonly modelRequest: {
+        readonly sentToModel: true;
+        readonly excerptContentPersisted: false;
+    };
+    readonly scope: EvidenceConnectedContextScope;
+    readonly query: EvidenceConnectedContextQuery;
+    readonly plan: EvidenceConnectedContextPlan | undefined;
+    readonly budget: {
+        readonly usage: Record<string, number>;
+        readonly limits: Record<string, number>;
+    };
+    readonly files: readonly EvidenceConnectedContextFile[];
+    readonly omitted: readonly EvidenceConnectedContextOmitted[];
+    readonly uncertainty: readonly EvidenceConnectedContextUncertainty[];
+    readonly toolsUsed: readonly string[];
+    readonly summary: {
+        readonly fileCount: number;
+        readonly citationCount: number;
+        readonly omittedCount: number;
+        readonly uncertaintyCount: number;
+        readonly elapsedMs: number;
+    };
+}
+export interface EvidenceGovernedWorkflowHandoff {
+    readonly sourceGroundedRunId: string;
+    readonly contextPackStableIdHash: string;
+    readonly workflowKind: string;
+    readonly editablePathCount: number;
+    readonly readOnlyPathCount: number;
+    readonly evidenceAtomCount: number;
+    readonly expectedChecks: readonly string[];
+    readonly approvalTokenHash: string;
+}
+export interface EvidenceManifest {
+    readonly evidenceSchemaVersion: "1";
+    readonly run: EvidenceRunIdentity;
+    readonly model: EvidenceModel;
+    readonly usageTotals: EvidenceUsageTotals;
+    readonly context?: AuditSummary | undefined;
+    readonly stateTransitions: readonly EvidenceStateTransition[];
+    readonly toolCalls: readonly EvidenceToolCall[];
+    readonly commandExecutions: readonly EvidenceCommandExecution[];
+    readonly sandboxConfigurations?: readonly EvidenceSandboxConfiguration[] | undefined;
+    readonly verificationResults?: readonly EvidenceVerificationResult[] | undefined;
+    readonly patch?: EvidencePatch | undefined;
+    readonly verification?: VerificationAuditSummary | undefined;
+    readonly failure?: EvidenceFailure | undefined;
+    readonly reasoning?: readonly EvidenceReasoningEntry[] | undefined;
+    readonly browser?: EvidenceBrowserCapture | undefined;
+    readonly connectedContext?: EvidenceConnectedContextAudit | undefined;
+    readonly governedHandoff?: EvidenceGovernedWorkflowHandoff | undefined;
+}
+export interface AuditRedactionConfig {
+    readonly additionalSecrets?: readonly string[] | undefined;
+    readonly redactEnvValues?: readonly string[] | undefined;
+    readonly sensitiveLiterals?: readonly string[] | undefined;
+}
+export interface RetentionPolicy {
+    readonly maxRuns?: number | undefined;
+    readonly maxAgeMs?: number | undefined;
+    readonly maxTotalBytes?: number | undefined;
+    readonly disabled?: boolean | undefined;
+}
+export declare const DEFAULT_RETENTION: RetentionPolicy;
+export interface BuildOptions {
+    readonly includeReasoning?: boolean | undefined;
+    readonly includeDiff?: boolean | undefined;
+}
+export interface EvidenceBuildInput {
+    readonly result: RunResult;
+    readonly manifest: RunManifest;
+    readonly context?: AuditSummary | undefined;
+    readonly verification?: VerificationAuditSummary | undefined;
+    readonly redaction?: AuditRedactionConfig | undefined;
+    readonly options?: BuildOptions | undefined;
+}
+export interface EvidenceDeps {
+    readonly env?: Readonly<Record<string, string | undefined>> | undefined;
+    readonly store?: EvidenceStore | undefined;
+    readonly randomSuffix?: (() => string) | undefined;
+    readonly now?: (() => number) | undefined;
+    readonly costClassResolver?: ((modelId: string) => CostClass | "unknown") | undefined;
+}
+export interface EvidenceStore {
+    readonly put: (runId: string, json: string) => string;
+    readonly update?: ((runId: string, update: (existingJson: string | undefined) => string) => string) | undefined;
+    readonly list: () => readonly string[];
+    readonly get: (runId: string) => string | undefined;
+    readonly location?: ((runId: string) => string) | undefined;
+    readonly delete: (runId: string) => void;
+}
+export interface SideFileWriteResult {
+    readonly relativePath: string;
+    readonly sha256: string;
+    readonly bytes: number;
+    readonly absolutePath: string;
+}
+//# sourceMappingURL=evidence.d.ts.map

package/dist/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../src/evidence.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,SAAS,EACT,QAAQ,EACT,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAI1E,eAAO,MAAM,uBAAuB,EAAG,GAAY,CAAC;AAGpD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAGD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;CAC3C;AAGD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAGD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAGD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAID,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAKD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAGD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,iBAAiB,GACjB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,wBAAwB,GAChC,wBAAwB,GACxB,mBAAmB,GACnB,6BAA6B,GAC7B,+BAA+B,GAC/B,wBAAwB,GACxB,uBAAuB,GACvB,eAAe,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAChD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,6BAA6B,EAAE,GAAG,SAAS,CAAC;CACjF;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC1F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAC/D;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,GAAG,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;QAC3B,QAAQ,CAAC,uBAAuB,EAAE,KAAK,CAAC;KACzC,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE,6BAA6B,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,6BAA6B,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,4BAA4B,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzC,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAC7D,QAAQ,CAAC,WAAW,EAAE,SAAS,mCAAmC,EAAE,CAAC;IACrE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,GAAG,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC9D,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAChE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,4BAA4B,EAAE,GAAG,SAAS,CAAC;IACrF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,0BAA0B,EAAE,GAAG,SAAS,CAAC;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,CAAC;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,6BAA6B,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,+BAA+B,GAAG,SAAS,CAAC;CACxE;AAID,MAAM,WAAW,oBAAoB;IAEnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAE3D,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAEzD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC5D;AAID,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,eAAO,MAAM,iBAAiB,EAAE,eAA0C,CAAC;AAI3E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5C;AAKD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CAC7C;AAGD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAE3C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;IAGnD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;IAK1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACvF;AAID,MAAM,WAAW,aAAa;IAE5B,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAItD,QAAQ,CAAC,MAAM,CAAC,EACZ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,KAAK,MAAM,CAAC,GACjF,SAAS,CAAC;IAEd,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IAEvC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAGpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;IAE5D,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAOD,MAAM,WAAW,mBAAmB;IAElC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B"}

package/dist/evidence.js

@@ -0,0 +1,9 @@
+// All Evidence* interfaces, the retention/redaction config, the injectable deps, the frozen
+// EVIDENCE_SCHEMA_VERSION / DEFAULT_RETENTION tables, and the EvidenceStore port interface
+// (ADR-0010 D2/D4/D6/D10). No runtime logic beyond the two frozen tables. Everything here is
+// plain-JSON, deeply readonly, and JSON-serializable: timestamps are epoch-ms numbers sourced
+// from events/RunResult, never Date objects.
+// The schema discriminant — distinct from the harness event `schemaVersion`. A breaking change
+// produces "2" as a NEW union member rather than mutating "1" (ADR-0010 D2).
+export const EVIDENCE_SCHEMA_VERSION = "1";
+export const DEFAULT_RETENTION = { maxRuns: 50 };

package/dist/gateway.d.ts

@@ -0,0 +1,129 @@
+export declare const CONVERSATION_CAPABILITY_CONTRACT_VERSION: 2;
+export type ModelKind = "chat" | "embedding" | "ocr-vision";
+export type CostClass = "low" | "medium" | "high";
+export type LatencyClass = "fast" | "standard" | "slow";
+export type InfillingAlignment = "base" | "instruct" | "edit-tuned";
+export declare const INFILLING_ALIGNMENTS: readonly InfillingAlignment[];
+export interface ModelCapability {
+    readonly id: string;
+    readonly kind: ModelKind;
+    readonly contextWindow: number;
+    readonly maxOutputTokens: number;
+    readonly toolCalling: boolean;
+    readonly structuredOutput: boolean;
+    readonly streaming: boolean;
+    readonly supportsImageInput: boolean;
+    readonly supportsDocumentInput: boolean;
+    readonly workflowEligible: boolean;
+    readonly costClass: CostClass;
+    readonly latencyClass: LatencyClass;
+    readonly throughputHint: string;
+    readonly preferredUseCases: readonly string[];
+    readonly knownLimitations: readonly string[];
+    /** Whether the model supports a `seed` parameter for deterministic sampling (Epic #761). */
+    readonly supportsSeeding?: boolean | undefined;
+    /** Whether the model supports a `responseFormat` parameter for JSON output (Epic #761). */
+    readonly supportsResponseFormat?: boolean | undefined;
+    /**
+     * Whether the model supports suffix-aware (fill-in-the-middle / FIM) completion (Issue #1210).
+     * Required for Keiko editor inline completion; a prefix-only model is a documented anti-pattern
+     * for in-editor ghost text. Only meaningful for `kind: "chat"` models.
+     */
+    readonly supportsInfilling?: boolean | undefined;
+    /**
+     * Alignment posture of the model's infilling endpoint (Issue #1210). Only meaningful when
+     * `supportsInfilling` is true. Editor ghost text requires an aligned ("instruct") or edit-tuned
+     * ("edit-tuned") variant; a raw "base" FIM endpoint — or an undeclared alignment — is rejected
+     * for governed completion because base-FIM re-opens a prompt-injection surface (ADR-0042 D5).
+     */
+    readonly infillingAlignment?: InfillingAlignment | undefined;
+}
+export declare function modelSupportsInfilling(capability: ModelCapability): boolean;
+export declare function isAlignedInfillingModel(capability: ModelCapability): boolean;
+export declare function isAsYouTypeCompletionModel(capability: ModelCapability): boolean;
+export type CompletionInteractionMode = "as-you-type" | "manual" | "deterministic";
+export type CompletionDegradeReason = "no-infilling-model" | "only-base-infilling-model" | "over-cost-ceiling";
+export interface CompletionModelSelection {
+    readonly mode: CompletionInteractionMode;
+    readonly modelId?: string | undefined;
+    readonly latencyClass?: LatencyClass | undefined;
+    readonly degradeReason?: CompletionDegradeReason | undefined;
+}
+export interface ChatMessageTextContentPart {
+    readonly type: "text";
+    readonly text: string;
+}
+export interface ChatMessageImageUrlContentPart {
+    readonly type: "image_url";
+    readonly image_url: {
+        readonly url: string;
+    };
+}
+export type ChatMessageContentPart = ChatMessageTextContentPart | ChatMessageImageUrlContentPart;
+export interface ChatMessage {
+    readonly role: "system" | "user" | "assistant" | "tool";
+    readonly content: string;
+    readonly contentParts?: readonly ChatMessageContentPart[] | undefined;
+    readonly toolCallId?: string | undefined;
+    readonly toolCalls?: readonly NormalizedToolCall[] | undefined;
+}
+export interface ToolDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: Record<string, unknown>;
+}
+export type ResponseFormat = {
+    readonly type: "text";
+} | {
+    readonly type: "json_schema";
+    readonly schema: Record<string, unknown>;
+};
+export interface GatewayRequest {
+    readonly modelId: string;
+    readonly messages: readonly ChatMessage[];
+    readonly tools?: readonly ToolDefinition[] | undefined;
+    readonly responseFormat?: ResponseFormat | undefined;
+    readonly stream?: boolean | undefined;
+    readonly cancellationSignal?: AbortSignal | undefined;
+    /** Optional seed for deterministic sampling when the model supports it (Epic #761). */
+    readonly seed?: number | undefined;
+}
+export interface NormalizedToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly arguments: Record<string, unknown>;
+}
+export interface UsageMetadata {
+    readonly requestId: string;
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly latencyMs: number;
+    readonly costClass: CostClass;
+}
+export type FinishReason = "stop" | "tool_calls" | "length" | "content_filter" | "error" | "cancelled";
+export interface NormalizedResponse {
+    readonly modelId: string;
+    readonly content: string;
+    readonly finishReason: FinishReason;
+    readonly toolCalls: readonly NormalizedToolCall[];
+    readonly structuredOutput: Record<string, unknown> | null;
+    readonly usage: UsageMetadata;
+}
+export interface StreamDelta {
+    readonly role?: "assistant" | undefined;
+    readonly contentDelta?: string | undefined;
+    readonly toolCallDelta?: Partial<NormalizedToolCall> | undefined;
+    readonly finishReason?: FinishReason | undefined;
+    readonly usage?: UsageMetadata | undefined;
+}
+export type StreamEvent = {
+    readonly type: "delta";
+    readonly delta: StreamDelta;
+} | {
+    readonly type: "done";
+    readonly response: NormalizedResponse;
+};
+export type ConversationIneligibilityReason = "embedding-only" | "ocr-vision-only" | "non-chat";
+export declare function isConversationEligibleModel(capability: ModelCapability): boolean;
+export declare function explainConversationIneligibility(capability: ModelCapability): ConversationIneligibilityReason | undefined;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

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

package/dist/gateway.js

@@ -0,0 +1,66 @@
+// Gateway-layer WIRE contract types: model identity, request/response shapes, streaming envelope,
+// and tool-call normalisation. Credential-bearing or runtime-port shapes (ModelProviderConfig,
+// GatewayConfig, CircuitBreakerConfig, ProviderAdapter, Clock, CircuitBreakerStatus) STAY in
+// packages/keiko-model-gateway/src/types.ts so contracts never carries an apiKey-shaped surface. No runtime code lives
+// here. `readonly` everywhere; optional props are `| undefined` because exactOptionalPropertyTypes
+// is on.
+// Bumped to 2 by issue #143 (Epic #142 Conversation Center): ModelCapability now carries
+// supportsImageInput / supportsDocumentInput / workflowEligible. A future structural break
+// adds a new literal member rather than mutating this constant.
+export const CONVERSATION_CAPABILITY_CONTRACT_VERSION = 2;
+export const INFILLING_ALIGNMENTS = [
+    "base",
+    "instruct",
+    "edit-tuned",
+];
+// ─── Completion / infilling capability helpers (Issue #1210, ADR-0042 D5) ──────
+// These are additive, optional fields: a future capability flag (e.g. `edit-prediction` for
+// next-edit prediction) is another optional member, never a structural break, so
+// CONVERSATION_CAPABILITY_CONTRACT_VERSION is intentionally NOT bumped (same precedent as the
+// Epic #761 determinism flags). The single source of truth for "does a model satisfy the editor
+// completion requirement?" lives in these pure, total predicates so the completion-model selection
+// (keiko-model-gateway) and any consuming route can never disagree on what the capability means.
+// Pure helpers live in contracts (not keiko-model-gateway) so the browser-tier `keiko-ui`/editor
+// host can value-import them without crossing ADR-0019 trust rule 3 (UI → model-gateway/src is
+// forbidden at error severity), mirroring `isConversationEligibleModel`.
+// Whether the model advertises suffix-aware (FIM) completion at all. Total: a non-chat model can
+// never infill, and an absent flag is treated as "no" (conservative default).
+export function modelSupportsInfilling(capability) {
+    return capability.kind === "chat" && capability.supportsInfilling === true;
+}
+// Whether the model is an aligned/instruct or edit-tuned infilling variant — the only postures
+// eligible for GOVERNED editor completion. Fail-closed: a base endpoint or an undeclared alignment
+// is rejected (the prompt-injection guardrail, ADR-0042 D5).
+export function isAlignedInfillingModel(capability) {
+    if (!modelSupportsInfilling(capability))
+        return false;
+    return (capability.infillingAlignment === "instruct" || capability.infillingAlignment === "edit-tuned");
+}
+// Whether the model is eligible for AS-YOU-TYPE ghost text: an aligned infilling variant AND a
+// `fast` latency class. A `standard`/`slow` model is never elected for per-keystroke completion
+// (ADR-0042 D5: the as-you-type query requires BOTH the FIM capability AND `latencyClass: "fast"`).
+export function isAsYouTypeCompletionModel(capability) {
+    return isAlignedInfillingModel(capability) && capability.latencyClass === "fast";
+}
+// Why: see header — only `kind === "chat"` is conversation-eligible by
+// construction. Pure, total, no side effects.
+export function isConversationEligibleModel(capability) {
+    return capability.kind === "chat";
+}
+// Why: returns a typed reason the UI can map to a localisable explanation
+// without leaking provider URLs or credentials. Returns `undefined` for
+// chat-eligible capabilities so callers can branch on presence. The lookup
+// is total over `Exclude<ModelKind, "chat">` by construction — if a future
+// `ModelKind` member is added in a CONVERSATION_CAPABILITY_CONTRACT_VERSION
+// bump, this map will fail to typecheck (mandatory key missing), forcing the
+// new member to be classified explicitly rather than silently leaking
+// through as conversation-eligible.
+const INELIGIBILITY_REASON_BY_KIND = {
+    embedding: "embedding-only",
+    "ocr-vision": "ocr-vision-only",
+};
+export function explainConversationIneligibility(capability) {
+    if (capability.kind === "chat")
+        return undefined;
+    return INELIGIBILITY_REASON_BY_KIND[capability.kind];
+}