@zhivex-ai/harness 0.8.0 → 0.10.0

package/dist/change-envelope.d.ts

@@ -0,0 +1,271 @@
+import { z } from "zod";
+import { type FileDigest } from "./edit-contracts.js";
+export declare const CHANGE_ENVELOPE_SCHEMA_VERSION: 1;
+export declare const CHANGE_ENVELOPE_DIGEST_ALGORITHM: "sha256";
+export declare const MAX_CHANGE_ENVELOPE_CHECKS = 100;
+export declare const MAX_CHANGE_ENVELOPE_APPROVALS = 100;
+export declare const MAX_CHANGE_ENVELOPE_APPROVAL_SCOPES = 32;
+export declare const MAX_CHANGE_ENVELOPE_ATTESTATIONS = 32;
+export declare const changeEnvelopeCheckSchema: z.ZodObject<{
+    checkId: z.ZodString;
+    status: z.ZodEnum<{
+        passed: "passed";
+        failed: "failed";
+        skipped: "skipped";
+    }>;
+    redacted: z.ZodLiteral<true>;
+    startedAt: z.ZodISODateTime;
+    completedAt: z.ZodISODateTime;
+    durationMs: z.ZodNumber;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    redactedOutputDigest: z.ZodOptional<z.ZodString>;
+    runnerFingerprint: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ChangeEnvelopeCheck = z.infer<typeof changeEnvelopeCheckSchema>;
+export declare const changeEnvelopeApprovalSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"approval-reference">;
+    approvalId: z.ZodString;
+    approvalDigest: z.ZodString;
+    approverDigest: z.ZodString;
+    scopes: z.ZodArray<z.ZodString>;
+    approvedAt: z.ZodISODateTime;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strict>;
+export type ChangeEnvelopeApproval = z.infer<typeof changeEnvelopeApprovalSchema>;
+export declare const externalAttestationReferenceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"external-attestation-reference">;
+    attestationId: z.ZodString;
+    format: z.ZodString;
+    mediaType: z.ZodString;
+    bundleDigest: z.ZodString;
+}, z.core.$strict>;
+export type ExternalAttestationReference = z.infer<typeof externalAttestationReferenceSchema>;
+export declare const changeEnvelopeBaseSchema: z.ZodObject<{
+    workspaceDigest: z.ZodString;
+    treeDigest: z.ZodString;
+}, z.core.$strict>;
+export declare const changeEnvelopePatchSchema: z.ZodObject<{
+    patchId: z.ZodString;
+    patchDigest: z.ZodString;
+}, z.core.$strict>;
+export declare const changeEnvelopeFingerprintsSchema: z.ZodObject<{
+    harness: z.ZodString;
+    policy: z.ZodString;
+    environment: z.ZodString;
+}, z.core.$strict>;
+export declare const changeEnvelopeEvidenceSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"check-evidence-summary">;
+    digestAlgorithm: z.ZodLiteral<"sha256">;
+    evidenceDigest: z.ZodString;
+    checks: z.ZodArray<z.ZodObject<{
+        checkId: z.ZodString;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        redacted: z.ZodLiteral<true>;
+        startedAt: z.ZodISODateTime;
+        completedAt: z.ZodISODateTime;
+        durationMs: z.ZodNumber;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        redactedOutputDigest: z.ZodOptional<z.ZodString>;
+        runnerFingerprint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ChangeEnvelopeEvidence = z.infer<typeof changeEnvelopeEvidenceSchema>;
+export declare const changeEnvelopeInputSchema: z.ZodObject<{
+    createdAt: z.ZodISODateTime;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+    base: z.ZodObject<{
+        workspaceDigest: z.ZodString;
+        treeDigest: z.ZodString;
+    }, z.core.$strict>;
+    patch: z.ZodObject<{
+        patchId: z.ZodString;
+        patchDigest: z.ZodString;
+    }, z.core.$strict>;
+    fingerprints: z.ZodObject<{
+        harness: z.ZodString;
+        policy: z.ZodString;
+        environment: z.ZodString;
+    }, z.core.$strict>;
+    checks: z.ZodArray<z.ZodObject<{
+        checkId: z.ZodString;
+        status: z.ZodEnum<{
+            passed: "passed";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        redacted: z.ZodLiteral<true>;
+        startedAt: z.ZodISODateTime;
+        completedAt: z.ZodISODateTime;
+        durationMs: z.ZodNumber;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        redactedOutputDigest: z.ZodOptional<z.ZodString>;
+        runnerFingerprint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    approvals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodLiteral<"approval-reference">;
+        approvalId: z.ZodString;
+        approvalDigest: z.ZodString;
+        approverDigest: z.ZodString;
+        scopes: z.ZodArray<z.ZodString>;
+        approvedAt: z.ZodISODateTime;
+        expiresAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>>;
+    externalAttestations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodLiteral<"external-attestation-reference">;
+        attestationId: z.ZodString;
+        format: z.ZodString;
+        mediaType: z.ZodString;
+        bundleDigest: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type CreateChangeEnvelopeInput = z.infer<typeof changeEnvelopeInputSchema>;
+export declare const changeEnvelopeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"change-envelope">;
+    digestAlgorithm: z.ZodLiteral<"sha256">;
+    envelopeId: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+    base: z.ZodObject<{
+        workspaceDigest: z.ZodString;
+        treeDigest: z.ZodString;
+    }, z.core.$strict>;
+    patch: z.ZodObject<{
+        patchId: z.ZodString;
+        patchDigest: z.ZodString;
+    }, z.core.$strict>;
+    fingerprints: z.ZodObject<{
+        harness: z.ZodString;
+        policy: z.ZodString;
+        environment: z.ZodString;
+    }, z.core.$strict>;
+    evidence: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        kind: z.ZodLiteral<"check-evidence-summary">;
+        digestAlgorithm: z.ZodLiteral<"sha256">;
+        evidenceDigest: z.ZodString;
+        checks: z.ZodArray<z.ZodObject<{
+            checkId: z.ZodString;
+            status: z.ZodEnum<{
+                passed: "passed";
+                failed: "failed";
+                skipped: "skipped";
+            }>;
+            redacted: z.ZodLiteral<true>;
+            startedAt: z.ZodISODateTime;
+            completedAt: z.ZodISODateTime;
+            durationMs: z.ZodNumber;
+            exitCode: z.ZodOptional<z.ZodNumber>;
+            redactedOutputDigest: z.ZodOptional<z.ZodString>;
+            runnerFingerprint: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    approvals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodLiteral<"approval-reference">;
+        approvalId: z.ZodString;
+        approvalDigest: z.ZodString;
+        approverDigest: z.ZodString;
+        scopes: z.ZodArray<z.ZodString>;
+        approvedAt: z.ZodISODateTime;
+        expiresAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>>;
+    externalAttestations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodLiteral<"external-attestation-reference">;
+        attestationId: z.ZodString;
+        format: z.ZodString;
+        mediaType: z.ZodString;
+        bundleDigest: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ChangeEnvelope = z.infer<typeof changeEnvelopeSchema>;
+/** Content-addresses exact artifact bytes for patch/base inputs without parsing them. */
+export declare const digestChangeEnvelopeArtifact: (value: string | Uint8Array) => FileDigest;
+/**
+ * Creates a content-addressed envelope. The caller supplies all timestamps, so
+ * repeated calls with semantically identical input return the same envelope.
+ * Raw command output, prompts, reasons, and credentials are intentionally not
+ * representable by this contract.
+ */
+export declare const createChangeEnvelope: (input: unknown) => ChangeEnvelope;
+/** Returns the canonical, whitespace-free JSON representation of a valid envelope. */
+export declare const canonicalizeChangeEnvelope: (input: unknown) => string;
+/** Recomputes the envelope identifier without trusting its embedded envelopeId. */
+export declare const computeChangeEnvelopeDigest: (input: unknown) => FileDigest;
+/** Recomputes the independently addressable digest of the redacted check summary. */
+export declare const computeChangeEnvelopeEvidenceDigest: (input: unknown) => FileDigest;
+export declare const changeEnvelopePreconditionsSchema: z.ZodObject<{
+    envelopeId: z.ZodOptional<z.ZodString>;
+    baseWorkspaceDigest: z.ZodOptional<z.ZodString>;
+    baseTreeDigest: z.ZodOptional<z.ZodString>;
+    patchId: z.ZodOptional<z.ZodString>;
+    patchDigest: z.ZodOptional<z.ZodString>;
+    harnessFingerprint: z.ZodOptional<z.ZodString>;
+    policyFingerprint: z.ZodOptional<z.ZodString>;
+    environmentFingerprint: z.ZodOptional<z.ZodString>;
+    evidenceDigest: z.ZodOptional<z.ZodString>;
+    requiredPassedChecks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredApprovalDigests: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredApprovalScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredAttestationDigests: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type ChangeEnvelopePreconditions = z.infer<typeof changeEnvelopePreconditionsSchema>;
+export interface ChangeEnvelopeVerificationOptions {
+    now?: Date | string | number;
+    preconditions?: ChangeEnvelopePreconditions;
+}
+export type ChangeEnvelopeVerificationIssueCode = "invalid-schema" | "envelope-digest-mismatch" | "evidence-digest-mismatch" | "envelope-not-yet-valid" | "envelope-expired" | "approval-expired" | "precondition-mismatch" | "missing-passed-check" | "missing-approval-digest" | "missing-approval-scope" | "missing-attestation-digest";
+export interface ChangeEnvelopeVerificationIssue {
+    code: ChangeEnvelopeVerificationIssueCode;
+    path: readonly (string | number)[];
+    message: string;
+    expected?: string;
+    actual?: string;
+}
+export interface ChangeEnvelopeVerificationResult {
+    valid: boolean;
+    verificationScope: "integrity-expiration-and-preconditions-only";
+    envelope?: ChangeEnvelope;
+    issues: ChangeEnvelopeVerificationIssue[];
+    integrity: {
+        envelopeDigestValid: boolean;
+        evidenceDigestValid: boolean;
+    };
+    expiration: {
+        checkedAt: string;
+        envelopeNotYetValid: boolean;
+        envelopeExpired: boolean;
+        expiredApprovalIds: string[];
+    };
+    checks: {
+        recorded: number;
+        passed: string[];
+        failed: string[];
+        skipped: string[];
+        requiredPassed: string[];
+        missingPassed: string[];
+    };
+    approvals: {
+        recorded: number;
+        requiredScopes: string[];
+        missingScopes: string[];
+        authenticity: "not-verified";
+    };
+    externalAttestations: {
+        referenced: number;
+        requiredDigests: FileDigest[];
+        missingDigests: FileDigest[];
+        authenticity: "not-verified";
+    };
+}
+/**
+ * Verifies schema, content digests, expiry, and caller-supplied preconditions
+ * without network access. Approval and attestation references are integrity
+ * bound only: their issuer/signature authenticity must be checked by an
+ * external Sigstore/in-toto (or equivalent) verifier.
+ */
+export declare const verifyChangeEnvelope: (input: unknown, options?: ChangeEnvelopeVerificationOptions) => ChangeEnvelopeVerificationResult;

package/dist/cli-stream.d.ts

@@ -34,14 +34,14 @@ export declare const streamEventDocument: (event: AgentStreamEvent, sequence?: n
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     toolCallId: string;
     toolName: string;
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     toolCallId: string;
     toolName: string;
@@ -49,7 +49,7 @@ export declare const streamEventDocument: (event: AgentStreamEvent, sequence?: n
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     approvalRequestId: string;
     approvalKind: "provider" | "local-tool" | "subagent";
@@ -57,20 +57,20 @@ export declare const streamEventDocument: (event: AgentStreamEvent, sequence?: n
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     approvalRequestId: string;
     approved: boolean;
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     provider: string;
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     index?: number;
     id?: string;
@@ -79,33 +79,33 @@ export declare const streamEventDocument: (event: AgentStreamEvent, sequence?: n
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     usage?: import("@zhivex-ai/core").TokenUsage;
     finishReason?: import("@zhivex-ai/core").FinishReason;
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     error: string;
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     currentStep: number;
     maxSteps: number;
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     stepIndex: number;
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     stepIndex: number;
     status: import("@zhivex-ai/core").AgentStepStatus;
@@ -113,7 +113,7 @@ export declare const streamEventDocument: (event: AgentStreamEvent, sequence?: n
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     compactionId: string;
     reasons: import("@zhivex-ai/core").AgentCompactionReason[];
@@ -122,7 +122,7 @@ export declare const streamEventDocument: (event: AgentStreamEvent, sequence?: n
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 } | {
     runId: string;
     status: import("@zhivex-ai/core").AgentStatus;
@@ -131,7 +131,7 @@ export declare const streamEventDocument: (event: AgentStreamEvent, sequence?: n
     schemaVersion: 1;
     kind: "run-event";
     sequence: number;
-    type: "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "error" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
+    type: "error" | "text-delta" | "tool-call" | "tool-result" | "tool-approval-request" | "provider-data" | "image-generation" | "finish" | "agent-run-start" | "agent-step-start" | "agent-step-finish" | "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish";
 };
 export declare const serializeStreamEvent: (event: AgentStreamEvent, sequence?: number) => string;
 /**

package/dist/cli.d.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun
+#!/usr/bin/env node
 import { type AgentApprovalRequest, type AgentRunInput, type AgentRunOutput, type AgentRunState, type AgentStatus } from "@zhivex-ai/agents";
 import { providerAvailability, resolveHarnessConfig, type HarnessConfig, type HarnessConfigInput, type HarnessProvider, type HarnessSubagentProfile } from "./config.js";
 import { type ZhivexHarness } from "./harness.js";
@@ -14,9 +14,10 @@ export declare const CLI_EXIT_CODES: {
     readonly usageError: 2;
     readonly doctorFailed: 3;
 };
-type Command = "run" | "review" | "chat" | "providers" | "doctor" | "resume" | "runs" | "sessions" | "help" | "version";
+type Command = "run" | "review" | "chat" | "providers" | "doctor" | "resume" | "runs" | "sessions" | "changes" | "help" | "version";
 type RunsCommand = "list" | "inspect" | "cancel" | "cleanup" | "export";
 type SessionsCommand = "list" | "inspect" | "rename" | "fork" | "archive";
+type ChangesCommand = "create" | "verify";
 export interface CliOptions {
     command: Command;
     provider?: string;
@@ -68,6 +69,11 @@ export interface CliOptions {
     idempotencyKey?: string;
     runsCommand?: RunsCommand;
     sessionsCommand?: SessionsCommand;
+    changesCommand?: ChangesCommand;
+    artifactPath?: string;
+    patchPath?: string;
+    preconditionsPath?: string;
+    verificationTime?: string;
     sessionId?: string;
     sessionTitle?: string;
     continueSession: boolean;
@@ -202,6 +208,8 @@ export interface DoctorReport {
 }
 export interface DoctorContext {
     env?: NodeJS.ProcessEnv;
+    nodeVersion?: string;
+    /** @deprecated Test-only compatibility injection for the secondary Bun runtime. */
     bunVersion?: string;
     ociRuntimeAdapter?: HarnessOciRuntimeAdapter;
 }