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

package/dist/cli/run-document.d.ts

@@ -0,0 +1,91 @@
+import { type AgentRunOutput } from "@zhivex-ai/agents";
+import type { ZhivexHarness } from "../runtime/harness.js";
+export declare const runResultDocument: (result: AgentRunOutput, harness: ZhivexHarness) => {
+    schemaVersion: 1;
+    kind: "run-result";
+    runId: string;
+    status: import("@zhivex-ai/agents").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: import("@zhivex-ai/agents").AgentStatus;
+        steps: number;
+        toolCalls: number;
+        toolErrors: number;
+        usage: import("@zhivex-ai/core").TokenUsage | undefined;
+    }[];
+    usage: import("@zhivex-ai/core").TokenUsage | undefined;
+    usageLedger?: {
+        calls: number;
+        inputTokens: number;
+        outputTokens: number;
+        usageComplete: boolean;
+        estimatedUsd: number | null;
+        limitUsd: number | null;
+        schemaVersion: 1;
+        runId: string;
+        historicalUsageUnknown?: boolean | undefined;
+        costKind: "estimate-not-invoice";
+        routes: {
+            provider: string;
+            model: string;
+            calls: number;
+            inputTokens: number;
+            outputTokens: number;
+            unknownCalls: number;
+            estimatedUsd: number | null;
+            priceStatuses: ("estimate" | "missing" | "stale")[];
+        }[];
+    } | null;
+    budget: import("@zhivex-ai/agents").AgentBudgetStatus;
+    costBudget?: {
+        limitUsd: number;
+        estimate: import("@zhivex-ai/core").CostEstimate;
+    };
+    scope: import("@zhivex-ai/core").AgentStoreScope | undefined;
+    capabilities: import("../index.js").HarnessModelCapabilityReport;
+    orchestration: {
+        profiles: readonly ("explorer" | "implementer" | "reviewer" | "tester")[];
+        childBudget: import("../index.js").HarnessBudget;
+        mcpServers: string[];
+    };
+    execution: {
+        backend: "oci";
+        binding: import("@zhivex-ai/agents").AgentExecutionEnvironmentBinding | undefined;
+        image: import("../index.js").OciImageInspection;
+    } | {
+        binding?: never;
+        image?: never;
+        backend: "none";
+    };
+    store: {
+        backend: "file" | "sqlite";
+        stateDirectory: string;
+        migration: import("../index.js").HarnessMigrationResult | undefined;
+    };
+    stateDirectory: string;
+};

package/dist/cli/run-management.d.ts

@@ -0,0 +1,2 @@
+import { type CliOptions } from "./arguments.js";
+export declare const manageRuns: (options: CliOptions) => Promise<void>;

package/dist/cli/service-client-cli.d.ts

@@ -0,0 +1,2 @@
+import type { CliOptions } from "./arguments.js";
+export declare const runServiceCli: (options: CliOptions, annotate: (error: unknown, sequence: number) => Error) => Promise<void>;

package/dist/cli/session-management.d.ts

@@ -0,0 +1,8 @@
+import { type AgentStatus } from "@zhivex-ai/agents";
+import { type HarnessConfig } from "../runtime/config.js";
+import { type SessionRunStatus } from "../persistence/sessions.js";
+import { type CliOptions } from "./arguments.js";
+export declare const openSessionStoreForConfig: (config: HarnessConfig) => Promise<import("../index.js").CliSessionStore>;
+export declare const manageSessions: (options: CliOptions) => Promise<void>;
+export declare const sessionStatus: (status: AgentStatus) => SessionRunStatus;
+export declare const updateIndexedSessionRun: (config: HarnessConfig, runId: string, status: AgentStatus) => Promise<void>;

package/dist/cli/setup.d.ts

@@ -0,0 +1,16 @@
+import { type HarnessProvider } from "../runtime/config.js";
+import { type CliOptions } from "./arguments.js";
+export declare const providersDocument: (env?: NodeJS.ProcessEnv) => {
+    schemaVersion: 1;
+    kind: "providers";
+    providers: readonly import("../index.js").ProviderAvailability[];
+};
+export declare const confirmDefaultProfileSelection: (profile: {
+    provider: HarnessProvider;
+    model: string;
+}, ask: (prompt: string) => Promise<string>) => Promise<{
+    provider: HarnessProvider;
+    model: string;
+} | undefined>;
+export declare const initializeCli: (options: CliOptions) => Promise<void>;
+export declare const listProviders: (json: boolean) => void;

package/dist/cli/state.d.ts

@@ -0,0 +1,2 @@
+import { type CliOptions } from "./arguments.js";
+export declare const manageState: (options: CliOptions) => Promise<void>;

package/dist/cli/terminal/terminal-continuation.d.ts

@@ -0,0 +1,3 @@
+import type { ModelMessage } from "@zhivex-ai/core";
+/** Close transcript gaps from a terminal run; never replay an unrecorded tool effect. */
+export declare function terminalContinuationMessages(messages: readonly ModelMessage[]): ModelMessage[];

package/dist/{terminal-markdown.d.ts → cli/terminal/terminal-markdown.d.ts}

@@ -4,6 +4,7 @@ export declare class TerminalMarkdown {
     private readonly color;
     private pending;
     private code;
+    private timer;
     constructor(output: (text: string) => void, color: boolean);
     private style;
     private line;

package/dist/{terminal-ui.d.ts → cli/terminal/terminal-ui.d.ts}

@@ -33,10 +33,17 @@ export interface TerminalAppearanceOptions {
     color?: boolean;
 }
 export declare const terminalSupportsColor: (isTTY: boolean, env?: Readonly<Record<string, string | undefined>>) => boolean;
+export declare const formatVerificationSummary: (results: readonly {
+    toolName: string;
+    output?: unknown;
+    isError?: boolean;
+}[]) => string;
 /**
  * Produce a compact activity line from a redacted event subset. Tool inputs,
  * outputs, provider payloads, repository text, and raw errors are never read.
  */
+/** Only known runtime diagnostics are projected; provider payloads remain private. */
+export declare const terminalRunFailure: (error: unknown) => string;
 export declare const formatTerminalEvent: (event: AgentStreamEvent, options?: TerminalAppearanceOptions) => string | undefined;
 export interface TerminalHeaderInput {
     version: string;

package/dist/cli/terminal/tool-activity.d.ts

@@ -0,0 +1,19 @@
+/** A bounded activity line; transcript entries are committed only at message boundaries. */
+export declare class ToolActivity {
+    private write;
+    private tty;
+    private columns;
+    private completed;
+    private active;
+    private visible;
+    private dirty;
+    private reads;
+    private searches;
+    private other;
+    constructor(write: (text: string) => void, tty: boolean, columns?: () => number);
+    start(): void;
+    finish(name: string): void;
+    private line;
+    private render;
+    flush(): void;
+}

package/dist/cli.d.ts

@@ -1,240 +1,35 @@
 #!/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";
-import { type HarnessOciRuntimeAdapter } from "./execution-environment.js";
-import { type HarnessModelRoute } from "./routing.js";
-import { CLI_JSON_SCHEMA_VERSION } from "./cli-stream.js";
-import { HarnessError } from "./errors.js";
-export { CLI_JSON_SCHEMA_VERSION } from "./cli-stream.js";
-export declare const HARNESS_RESUME_METADATA_KEY: "zhivexHarnessResume";
-export declare const HARNESS_RESUME_METADATA_SCHEMA_VERSION: 1;
-export declare const CLI_EXIT_CODES: {
-    readonly success: 0;
-    readonly runtimeError: 1;
-    readonly usageError: 2;
-    readonly doctorFailed: 3;
-};
-export declare const annotateCliStreamError: (error: unknown, lastSequence: number | undefined) => Error;
-export declare const cliStreamErrorSequence: (error: unknown) => number;
-export declare const terminalErrorMessage: (error: unknown) => string;
-export declare const CLI_COMMANDS: readonly ["init", "run", "review", "chat", "providers", "doctor", "resume", "runs", "sessions", "changes", "state", "help", "version"];
-export declare const CLI_RUNS_COMMANDS: readonly ["list", "inspect", "cancel", "cleanup", "export"];
-export declare const CLI_SESSIONS_COMMANDS: readonly ["list", "inspect", "rename", "fork", "archive"];
-export declare const CLI_CHANGES_COMMANDS: readonly ["create", "verify"];
-export declare const CLI_STATE_COMMANDS: readonly ["status", "export", "import"];
-type Command = (typeof CLI_COMMANDS)[number];
-type RunsCommand = (typeof CLI_RUNS_COMMANDS)[number];
-type SessionsCommand = (typeof CLI_SESSIONS_COMMANDS)[number];
-type ChangesCommand = (typeof CLI_CHANGES_COMMANDS)[number];
-type StateCommand = (typeof CLI_STATE_COMMANDS)[number];
-export interface CliOptions {
-    command: Command;
-    profile?: string;
-    provider?: string;
-    model?: string;
-    workspace?: string;
-    stateDirectory?: string;
-    storeBackend?: string;
-    tenantId?: string;
-    userId?: string;
-    namespace?: string;
-    maxSteps?: number;
-    timeoutMs?: number;
-    maxToolCalls?: number;
-    maxToolErrors?: number;
-    maxInputTokens?: number;
-    maxOutputTokens?: number;
-    maxTotalTokens?: number;
-    maxCostUsd?: number;
-    inputCostPerMillion?: number;
-    outputCostPerMillion?: number;
-    allowedChecks?: string[];
-    requiredCapabilities?: string[];
-    subagentProfiles?: HarnessSubagentProfile[];
-    reviewers?: HarnessSubagentProfile[];
-    routes?: string[];
-    subagentMaxSteps?: number;
-    subagentMaxToolCalls?: number;
-    subagentMaxToolErrors?: number;
-    subagentMaxInputTokens?: number;
-    subagentMaxOutputTokens?: number;
-    subagentMaxTotalTokens?: number;
-    subagentTimeoutMs?: number;
-    maxParallelReviews?: number;
-    executionBackend?: string;
-    agentProfile?: string;
-    ociRuntime?: string;
-    ociImage?: string;
-    ociAllowedCommands?: string[];
-    ociShellMode?: string;
-    ociMaxProcessRuntimeMs?: number;
-    ociMaxProcessOutputBytes?: number;
-    ociMaxMemoryMb?: number;
-    ociMaxPids?: number;
-    ociMaxCpus?: number;
-    ociMaxWorkspaceBytes?: number;
-    ociMaxFileWriteBytes?: number;
-    ociTmpfsMb?: number;
-    mcpConfigPath?: string;
-    contextConfigPath?: string;
-    projectContext?: boolean;
-    prompt?: string;
-    runId?: string;
-    idempotencyKey?: string;
-    runsCommand?: RunsCommand;
-    sessionsCommand?: SessionsCommand;
-    changesCommand?: ChangesCommand;
-    stateCommand?: StateCommand;
-    artifactPath?: string;
-    patchPath?: string;
-    preconditionsPath?: string;
-    verificationTime?: string;
-    backupPath?: string;
-    sessionId?: string;
-    sessionTitle?: string;
-    continueSession: boolean;
-    implicitCommand: boolean;
-    statuses?: AgentStatus[];
-    limit?: number;
-    cursor?: string;
-    before?: number;
-    reason?: string;
-    cascade: boolean;
-    final: boolean;
-    apply: boolean;
-    yes: boolean;
-    approve?: boolean;
-    json: boolean;
-    jsonl: boolean;
-}
-export declare class CliUsageError extends HarnessError {
-    constructor(message: string);
-}
-export declare const createHarnessResumeMetadata: (config: HarnessConfig, routes?: ReadonlyMap<HarnessSubagentProfile, HarnessModelRoute>) => NonNullable<AgentRunInput["metadata"]>;
-export declare const readHarnessResumeConfig: (state: Pick<AgentRunState, "metadata">) => HarnessConfigInput | undefined;
-export declare const readHarnessResumeRoutes: (state: Pick<AgentRunState, "metadata">) => Map<"explorer" | "implementer" | "reviewer" | "tester", HarnessModelRoute>;
-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 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 type DoctorCheckStatus = "pass" | "warn" | "fail";
-export interface DoctorCheck {
-    id: string;
-    status: DoctorCheckStatus;
-    message: string;
-    details: Record<string, boolean | number | string | readonly string[]>;
-}
-export interface DoctorReport {
-    schemaVersion: typeof CLI_JSON_SCHEMA_VERSION;
-    kind: "doctor";
-    ok: boolean;
-    harnessVersion: string;
-    configSchemaVersion: number;
-    configuration: {
-        provider: HarnessProvider;
-        model: string;
-        workspace: string;
-        stateDirectory: string;
-        storeBackend: string;
-        scope: ReturnType<typeof resolveHarnessConfig>["scope"];
-        maxSteps: number;
-        timeoutMs: number;
-        agentProfile: "strict" | "repair";
-        budget: ReturnType<typeof resolveHarnessConfig>["budget"];
-        costBudget?: ReturnType<typeof resolveHarnessConfig>["costBudget"];
-        compaction: ReturnType<typeof resolveHarnessConfig>["compaction"];
-        allowedChecks: readonly string[];
-        requiredCapabilities: ReturnType<typeof resolveHarnessConfig>["requiredCapabilities"];
-        orchestration: ReturnType<typeof resolveHarnessConfig>["orchestration"];
-        context: ReturnType<typeof resolveHarnessConfig>["context"];
-        execution: ReturnType<typeof resolveHarnessConfig>["execution"];
-        mcpConfigPath?: string;
-    };
-    checks: DoctorCheck[];
-    providers: ReturnType<typeof providerAvailability>;
-}
-export interface DoctorContext {
-    env?: NodeJS.ProcessEnv;
-    nodeVersion?: string;
-    /** @deprecated Test-only compatibility injection for the secondary Bun runtime. */
-    bunVersion?: string;
-    ociRuntimeAdapter?: HarnessOciRuntimeAdapter;
-}
-export declare const createDoctorReport: (options?: Pick<CliOptions, "provider" | "model" | "workspace" | "stateDirectory" | "storeBackend" | "tenantId" | "userId" | "namespace" | "maxSteps" | "agentProfile" | "timeoutMs" | "maxToolCalls" | "maxToolErrors" | "maxInputTokens" | "maxOutputTokens" | "maxTotalTokens" | "maxCostUsd" | "inputCostPerMillion" | "outputCostPerMillion" | "allowedChecks" | "requiredCapabilities" | "subagentProfiles" | "subagentMaxSteps" | "subagentMaxToolCalls" | "subagentMaxToolErrors" | "subagentMaxInputTokens" | "subagentMaxOutputTokens" | "subagentMaxTotalTokens" | "subagentTimeoutMs" | "maxParallelReviews" | "executionBackend" | "ociRuntime" | "ociImage" | "ociAllowedCommands" | "ociShellMode" | "ociMaxProcessRuntimeMs" | "ociMaxProcessOutputBytes" | "ociMaxMemoryMb" | "ociMaxPids" | "ociMaxCpus" | "ociMaxWorkspaceBytes" | "ociMaxFileWriteBytes" | "ociTmpfsMb" | "mcpConfigPath" | "contextConfigPath" | "projectContext">, context?: DoctorContext) => Promise<DoctorReport>;
-export declare const formatDoctorReport: (report: DoctorReport) => string;
-export declare const cliExitCodeForError: (error: unknown) => 1 | 2;
+export { runResultDocument } from "./cli/run-document.js";
+export { CLI_JSON_SCHEMA_VERSION } from "./cli/cli-stream.js";
 export declare const main: (argv?: string[]) => Promise<void>;
+export { HARNESS_RESUME_METADATA_KEY } from "./cli/resume-metadata.js";
+export { HARNESS_RESUME_METADATA_SCHEMA_VERSION } from "./cli/resume-metadata.js";
+export { CLI_EXIT_CODES } from "./cli/errors.js";
+export { annotateCliStreamError } from "./cli/presentation.js";
+export { cliStreamErrorSequence } from "./cli/presentation.js";
+export { terminalErrorMessage } from "./cli/presentation.js";
+export { CLI_COMMANDS } from "./cli/arguments.js";
+export { CLI_RUNS_COMMANDS } from "./cli/arguments.js";
+export { CLI_SESSIONS_COMMANDS } from "./cli/arguments.js";
+export { CLI_CHANGES_COMMANDS } from "./cli/arguments.js";
+export { CLI_STATE_COMMANDS } from "./cli/arguments.js";
+export type { CliOptions } from "./cli/arguments.js";
+export { CliUsageError } from "./cli/arguments.js";
+export { createHarnessResumeMetadata } from "./cli/resume-metadata.js";
+export { readHarnessResumeConfig } from "./cli/resume-metadata.js";
+export { readHarnessResumeRoutes } from "./cli/resume-metadata.js";
+export { resumeCommand } from "./cli/resume-metadata.js";
+export { parseCliArgs } from "./cli/arguments.js";
+export { CLI_HELP_TEXT } from "./cli/help-text.js";
+export { CLI_FULL_HELP_TEXT } from "./cli/help-text.js";
+export { summarizeApproval } from "./cli/presentation.js";
+export { withTemporaryHarnessProfiles } from "./cli/routing.js";
+export { providersDocument } from "./cli/setup.js";
+export { confirmDefaultProfileSelection } from "./cli/setup.js";
+export type { DoctorCheckStatus } from "./cli/doctor.js";
+export type { DoctorCheck } from "./cli/doctor.js";
+export type { DoctorReport } from "./cli/doctor.js";
+export type { DoctorContext } from "./cli/doctor.js";
+export { createDoctorReport } from "./cli/doctor.js";
+export { formatDoctorReport } from "./cli/doctor.js";
+export { cliExitCodeForError } from "./cli/errors.js";