@zhivex-ai/harness 1.0.0 → 1.1.0-rc.2

package/dist/approval-diff.d.ts

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import type { AgentRunState } from "@zhivex-ai/core";
+import type { HarnessClientRun } from "./client-contract.js";
+import type { ApprovalDecisionView } from "./approval-history.js";
+export declare const APPROVAL_DIFFS_KEY = "clientApprovalDiffsV1";
+declare const file: z.ZodObject<{
+    path: z.ZodString;
+    expectedDigest: z.ZodNullable<z.ZodString>;
+    before: z.ZodNullable<z.ZodString>;
+    after: z.ZodNullable<z.ZodString>;
+    afterDigest: z.ZodNullable<z.ZodString>;
+    beforeMode: z.ZodOptional<z.ZodNumber>;
+    afterMode: z.ZodOptional<z.ZodNumber>;
+    operation: z.ZodOptional<z.ZodEnum<{
+        create: "create";
+        delete: "delete";
+        update: "update";
+    }>>;
+}, z.core.$strict>;
+export type AppliedDiff = {
+    status: "complete";
+    files: z.infer<typeof file>[];
+    redacted?: boolean;
+} | {
+    status: "unavailable";
+};
+/** Capture complete previews before admitting execution, bounded across the run. */
+export declare function captureApprovalDiffs(state: AgentRunState, run: HarnessClientRun, approved: ReadonlySet<string>): {
+    approvalId: string;
+    digest: string;
+    proposalId: string;
+    files: {
+        path: string;
+        expectedDigest: string | null;
+        before: string | null;
+        after: string | null;
+        afterDigest: string | null;
+        beforeMode?: number | undefined;
+        afterMode?: number | undefined;
+        operation?: "create" | "delete" | "update" | undefined;
+    }[];
+}[];
+/** Only expose saved content when exact journal effects certify every file. */
+export declare function attachAppliedDiffs(state: AgentRunState, decisions: ApprovalDecisionView[]): ApprovalDecisionView[];
+export {};

package/dist/approval-history.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import type { AgentRunState, AgentToolCallJournalEntry } from "@zhivex-ai/core";
+import type { AppliedDiff } from "./approval-diff.js";
+export declare const APPROVAL_HISTORY_KEY = "clientApprovalDecisionsV1";
+export declare const approvalInputDigest: (value: unknown) => string;
+declare const rowSchema: z.ZodObject<{
+    approvalId: z.ZodString;
+    digest: z.ZodString;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    inputDigest: z.ZodOptional<z.ZodString>;
+    approved: z.ZodBoolean;
+    decidedAt: z.ZodNumber;
+    reviewedRevision: z.ZodNumber;
+}, z.core.$strict>;
+export type ApprovalDecisionRecord = z.infer<typeof rowSchema>;
+export interface ApprovalDecisionView extends ApprovalDecisionRecord {
+    status: "rejected" | "approved" | "applied" | "succeeded" | "failed" | "unknown";
+    finalDiff?: AppliedDiff;
+    evidence?: {
+        journalRevision: number;
+        completedAt?: number;
+        exitCode?: number;
+        timedOut?: boolean;
+        proposalId?: string;
+        reviewedProposalId?: string;
+        verifiedPatchId?: string;
+        command?: string[];
+        effects?: Array<{
+            path: string;
+            beforeDigest: string | null;
+            afterDigest: string | null;
+        }>;
+    };
+}
+export declare function readApprovalDecisions(state: AgentRunState): ApprovalDecisionRecord[];
+export declare function approvalDecisionViews(state: AgentRunState, journal: readonly AgentToolCallJournalEntry[], offset?: number): ApprovalDecisionView[];
+export {};

package/dist/approval-preview.d.ts

@@ -0,0 +1,26 @@
+import type { HarnessOciExecutionEnvironment } from "./execution-environment.js";
+import type { AgentStoreScope } from "@zhivex-ai/core";
+import type { Workspace } from "./workspace.js";
+import type { HarnessClientRun } from "./client-contract.js";
+export interface ApprovalPreviewFile {
+    path: string;
+    expectedDigest: string | null;
+    before: string | null;
+    after: string | null;
+    afterDigest: string | null;
+    beforeMode?: number;
+    afterMode?: number;
+    operation?: "create" | "update" | "delete";
+}
+export type ApprovalFilePreview = {
+    status: "complete";
+    proposalId: string;
+    files: ApprovalPreviewFile[];
+} | {
+    status: "unavailable";
+};
+/** Explicitly requested read projection; never trusts renderer-supplied paths or changes. */
+export declare function attachApprovalPreviews(run: HarnessClientRun, workspace: Workspace, options?: {
+    environment?: HarnessOciExecutionEnvironment | undefined;
+    scope?: AgentStoreScope | undefined;
+}): Promise<HarnessClientRun>;

package/dist/cli-credentials.d.ts

@@ -0,0 +1,38 @@
+import { type HarnessProvider } from "./config.js";
+export interface SecretEntry {
+    getPassword(): Promise<string | null | undefined>;
+    setPassword(value: string): Promise<void>;
+    deleteCredential(): Promise<boolean>;
+}
+export interface CredentialInput {
+    select<T>(title: string, items: readonly {
+        value: T;
+        label: string;
+        detail?: string;
+    }[]): Promise<T | undefined>;
+    secret(prompt: string): Promise<string>;
+}
+export type EntryFactory = (provider: string) => Promise<SecretEntry>;
+export declare const credentialService = "ai.zhivex.harness.cli";
+export declare const validCredential: (value: string) => boolean;
+export declare const nativeCredentialEntry: EntryFactory;
+/** CLI session only. Never put this object or its secrets in run metadata or process.env. */
+export declare class CliCredentials {
+    private readonly entry;
+    private readonly environment;
+    private readonly write;
+    private readonly temporary;
+    revision: number;
+    constructor(entry?: EntryFactory, environment?: NodeJS.ProcessEnv, write?: (text: string) => void);
+    private environmentKey;
+    private validate;
+    private saved;
+    configure(provider: HarnessProvider, input: CredentialInput): Promise<boolean>;
+    providerEnvironment(provider: HarnessProvider, input: CredentialInput): Promise<NodeJS.ProcessEnv>;
+    clear(): void;
+}
+/** Keep provider error payloads out of durable runs when they can contain a key. */
+export declare function credentialModel(config: {
+    provider: HarnessProvider;
+    model: string;
+}, env: NodeJS.ProcessEnv, modelFactory?: typeof import("./config.js").createProviderModel): Promise<import("@zhivex-ai/core").LanguageModel<import("@zhivex-ai/core").ProviderOptions>>;

package/dist/cli-help.d.ts

@@ -0,0 +1,3 @@
+export declare const shortCliHelp: (version: string) => string;
+export declare function resolveHelpTopic(parts: string[], explicit: boolean): string | undefined;
+export declare function formatCliHelp(topic: string | undefined, version: string, full: string): string;

package/dist/cli-options.d.ts

@@ -8,7 +8,7 @@ export interface CliCommandOptionContract {
     repeatable: readonly string[];
     conflicts: Readonly<Record<string, readonly string[]>>;
 }
-export declare const CLI_OPTION_NAMES: readonly ["--provider", "--model", "--profile", "--route", "--workspace", "--state-dir", "--mcp-config", "--context-config", "--no-project-context", "--patch", "--preconditions", "--now", "--agent-profile", "--execution", "--oci-runtime", "--oci-image", "--oci-allow-command", "--oci-shell", "--oci-max-process-runtime-ms", "--oci-max-process-output-bytes", "--oci-max-memory-mb", "--oci-max-pids", "--oci-max-cpus", "--oci-max-workspace-bytes", "--oci-max-file-write-bytes", "--oci-tmpfs-mb", "--store", "--tenant", "--user", "--namespace", "--idempotency-key", "--max-steps", "--timeout-ms", "--max-tool-calls", "--max-tool-errors", "--max-input-tokens", "--max-output-tokens", "--max-total-tokens", "--subagent-max-steps", "--subagent-max-tool-calls", "--subagent-max-tool-errors", "--subagent-max-input-tokens", "--subagent-max-output-tokens", "--subagent-max-total-tokens", "--subagent-timeout-ms", "--max-parallel-reviews", "--max-cost-usd", "--input-cost-per-million", "--output-cost-per-million", "--allow-check", "--require-capability", "--subagent", "--reviewer", "--yes", "--approve", "--deny", "--json", "--jsonl", "--session", "--continue", "--status", "--limit", "--cursor", "--before", "--reason", "--cascade", "--final", "--apply", "--help", "--version"];
+export declare const CLI_OPTION_NAMES: readonly ["--provider", "--model", "--profile", "--route", "--workspace", "--state-dir", "--mcp-config", "--context-config", "--no-project-context", "--patch", "--preconditions", "--now", "--agent-profile", "--execution", "--oci-runtime", "--oci-image", "--oci-allow-command", "--oci-shell", "--oci-max-process-runtime-ms", "--oci-max-process-output-bytes", "--oci-max-memory-mb", "--oci-max-pids", "--oci-max-cpus", "--oci-max-workspace-bytes", "--oci-max-file-write-bytes", "--oci-tmpfs-mb", "--store", "--tenant", "--user", "--namespace", "--idempotency-key", "--max-steps", "--timeout-ms", "--max-tool-calls", "--max-tool-errors", "--max-input-tokens", "--max-output-tokens", "--max-total-tokens", "--subagent-max-steps", "--subagent-max-tool-calls", "--subagent-max-tool-errors", "--subagent-max-input-tokens", "--subagent-max-output-tokens", "--subagent-max-total-tokens", "--subagent-timeout-ms", "--max-parallel-reviews", "--max-cost-usd", "--input-cost-per-million", "--output-cost-per-million", "--allow-check", "--require-capability", "--subagent", "--reviewer", "--yes", "--approve", "--deny", "--json", "--jsonl", "--session", "--continue", "--status", "--limit", "--cursor", "--before", "--reason", "--cascade", "--final", "--service", "--apply", "--help", "--version", "--search", "--pricing-file", "--usage-limit-usd"];
 export type CliOptionName = (typeof CLI_OPTION_NAMES)[number];
 export declare const CLI_OPTION_DEFINITIONS: Readonly<Record<CliOptionName, CliOptionDefinition>>;
 export declare const CLI_COMMAND_OPTION_CONTRACTS: {

package/dist/cli-stream.d.ts

@@ -112,7 +112,7 @@ export declare const streamEventDocument: (event: AgentStreamEvent, sequence?: n
     sequence: number;
     type: "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish" | "agent-run-start" | "agent-run-update" | "agent-step-finish" | "agent-step-start" | "error" | "finish" | "image-generation" | "provider-data" | "text-delta" | "tool-approval-request" | "tool-call" | "tool-result";
     stepIndex: number;
-    status: import("@zhivex-ai/agents").AgentStepStatus;
+    status: import("@zhivex-ai/core").AgentStepStatus;
     toolCalls: number;
 } | {
     schemaVersion: 1;
@@ -120,7 +120,7 @@ export declare const streamEventDocument: (event: AgentStreamEvent, sequence?: n
     sequence: number;
     type: "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish" | "agent-run-start" | "agent-run-update" | "agent-step-finish" | "agent-step-start" | "error" | "finish" | "image-generation" | "provider-data" | "text-delta" | "tool-approval-request" | "tool-call" | "tool-result";
     compactionId: string;
-    reasons: import("@zhivex-ai/agents").AgentCompactionReason[];
+    reasons: import("@zhivex-ai/core").AgentCompactionReason[];
     messageCountBefore: number;
     messageCountAfter: number;
 } | {
@@ -129,7 +129,7 @@ export declare const streamEventDocument: (event: AgentStreamEvent, sequence?: n
     sequence: number;
     type: "agent-approval-request" | "agent-approval-resolved" | "agent-compaction" | "agent-run-finish" | "agent-run-start" | "agent-run-update" | "agent-step-finish" | "agent-step-start" | "error" | "finish" | "image-generation" | "provider-data" | "text-delta" | "tool-approval-request" | "tool-call" | "tool-result";
     runId: string;
-    status: import("@zhivex-ai/agents").AgentStatus;
+    status: import("@zhivex-ai/core").AgentStatus;
     provider: string;
     model: string;
 } | undefined;

package/dist/cli.d.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { type AgentApprovalRequest, type AgentRunInput, type AgentRunOutput, type AgentRunState, type AgentStatus } from "@zhivex-ai/agents";
+export { runResultDocument } from "./run-document.js";
+import { type AgentApprovalRequest, type AgentRunInput, 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";
 import { type HarnessOciRuntimeAdapter } from "./execution-environment.js";
 import { type HarnessModelRoute } from "./routing.js";
 import { CLI_JSON_SCHEMA_VERSION } from "./cli-stream.js";
@@ -29,7 +29,9 @@ type SessionsCommand = (typeof CLI_SESSIONS_COMMANDS)[number];
 type ChangesCommand = (typeof CLI_CHANGES_COMMANDS)[number];
 type StateCommand = (typeof CLI_STATE_COMMANDS)[number];
 export interface CliOptions {
+    serviceFile?: string;
     command: Command;
+    helpTopic?: string;
     profile?: string;
     provider?: string;
     model?: string;
@@ -93,6 +95,9 @@ export interface CliOptions {
     backupPath?: string;
     sessionId?: string;
     sessionTitle?: string;
+    sessionSearch?: string;
+    pricingFile?: string;
+    usageLimitUsd?: number;
     continueSession: boolean;
     implicitCommand: boolean;
     statuses?: AgentStatus[];
@@ -117,80 +122,21 @@ export declare const readHarnessResumeRoutes: (state: Pick<AgentRunState, "metad
 export declare const resumeCommand: (runId: string, config: HarnessConfig, approve?: boolean) => string;
 export declare const parseCliArgs: (argv: string[]) => CliOptions;
 export declare const CLI_HELP_TEXT: string;
+export declare const CLI_FULL_HELP_TEXT: string;
 export declare const summarizeApproval: (approval: AgentApprovalRequest) => string;
-export declare const runResultDocument: (result: AgentRunOutput, harness: ZhivexHarness) => {
-    schemaVersion: 1;
-    kind: "run-result";
-    runId: string;
-    status: AgentStatus;
-    provider: string;
-    model: string;
-    output: string;
-    steps: number;
-    toolCalls: number;
-    mutations: readonly {
-        id: string;
-        operation: "create" | "move" | "quarantine" | "restore" | "update";
-        path: string;
-        destination?: string | undefined;
-        beforeDigest?: string | undefined;
-        afterDigest?: string | undefined;
-        timestamp: string;
-        quarantineId?: string | undefined;
-    }[];
-    pendingApprovals: {
-        id: string;
-        kind: "local-tool" | "provider" | "subagent";
-        name: string;
-        arguments: string;
-        childRunId?: string;
-        childAgentId?: string;
-    }[];
-    children: {
-        runId: string;
-        agentId: string | undefined;
-        toolName: string | undefined;
-        status: AgentStatus;
-        steps: number;
-        toolCalls: number;
-        toolErrors: number;
-        usage: import("@zhivex-ai/core").TokenUsage | undefined;
-    }[];
-    usage: import("@zhivex-ai/core").TokenUsage | undefined;
-    budget: import("@zhivex-ai/agents").AgentBudgetStatus;
-    costBudget?: {
-        limitUsd: number;
-        estimate: import("@zhivex-ai/core").CostEstimate;
-    };
-    scope: import("@zhivex-ai/core").AgentStoreScope | undefined;
-    capabilities: import("./capabilities.js").HarnessModelCapabilityReport;
-    orchestration: {
-        profiles: readonly ("explorer" | "implementer" | "reviewer" | "tester")[];
-        childBudget: import("./config.js").HarnessBudget;
-        mcpServers: string[];
-    };
-    execution: {
-        backend: "oci";
-        binding: import("@zhivex-ai/agents").AgentExecutionEnvironmentBinding | undefined;
-        image: import("./execution-environment.js").OciImageInspection;
-    } | {
-        binding?: never;
-        image?: never;
-        backend: "none";
-    };
-    store: {
-        backend: "file" | "sqlite";
-        stateDirectory: string;
-        migration: import("./operations.js").HarnessMigrationResult | undefined;
-    };
-    stateDirectory: string;
-};
 export declare const withTemporaryHarnessProfiles: <T>(profiles: readonly HarnessSubagentProfile[], configure: (profiles: readonly HarnessSubagentProfile[]) => Promise<void>, operation: () => Promise<T>) => Promise<T>;
 export declare const providersDocument: (env?: NodeJS.ProcessEnv) => {
     schemaVersion: 1;
     kind: "providers";
     providers: readonly import("./providers.js").ProviderAvailability[];
 };
+export declare const confirmDefaultProfileSelection: (profile: {
+    provider: HarnessProvider;
+    model: string;
+}, ask: (prompt: string) => Promise<string>) => Promise<{
+    provider: HarnessProvider;
+    model: string;
+} | undefined>;
 export type DoctorCheckStatus = "pass" | "warn" | "fail";
 export interface DoctorCheck {
     id: string;