@zhivex-ai/harness 0.5.0

package/dist/capabilities.d.ts

@@ -0,0 +1,22 @@
+import type { LanguageModel } from "@zhivex-ai/agents";
+import type { HarnessRequiredCapability } from "./config.js";
+export interface HarnessModelCapabilityReport {
+    provider: string;
+    model: string;
+    supportTier?: string;
+    capabilities: Record<HarnessRequiredCapability, boolean>;
+}
+export interface HarnessModelCandidate {
+    id?: string;
+    model: LanguageModel;
+    priority?: number;
+}
+export interface HarnessModelSelection {
+    id?: string;
+    model: LanguageModel;
+    report: HarnessModelCapabilityReport;
+    score: number;
+}
+export declare const inspectHarnessModelCapabilities: (model: LanguageModel) => HarnessModelCapabilityReport;
+export declare const assertHarnessModelCapabilities: (model: LanguageModel, required: readonly HarnessRequiredCapability[], context?: string) => HarnessModelCapabilityReport;
+export declare const selectHarnessModel: (candidates: readonly HarnessModelCandidate[], required: readonly HarnessRequiredCapability[]) => HarnessModelSelection;

package/dist/cli.d.ts

@@ -0,0 +1,191 @@
+#!/usr/bin/env bun
+import { type AgentApprovalRequest, type AgentRunOutput, type AgentStatus } from "@zhivex-ai/agents";
+import { providerAvailability, resolveHarnessConfig, type HarnessProvider, type HarnessSubagentProfile } from "./config.js";
+import { type ZhivexHarness } from "./harness.js";
+export declare const CLI_JSON_SCHEMA_VERSION: 1;
+export declare const CLI_EXIT_CODES: {
+    readonly success: 0;
+    readonly runtimeError: 1;
+    readonly usageError: 2;
+    readonly doctorFailed: 3;
+};
+type Command = "run" | "review" | "chat" | "providers" | "doctor" | "resume" | "runs" | "help" | "version";
+type RunsCommand = "list" | "inspect" | "cancel" | "cleanup" | "export";
+export interface CliOptions {
+    command: Command;
+    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?: string[];
+    reviewers?: HarnessSubagentProfile[];
+    subagentMaxSteps?: number;
+    subagentMaxToolCalls?: number;
+    subagentMaxToolErrors?: number;
+    subagentMaxInputTokens?: number;
+    subagentMaxOutputTokens?: number;
+    subagentMaxTotalTokens?: number;
+    subagentTimeoutMs?: number;
+    maxParallelReviews?: number;
+    mcpConfigPath?: string;
+    prompt?: string;
+    runId?: string;
+    idempotencyKey?: string;
+    runsCommand?: RunsCommand;
+    statuses?: AgentStatus[];
+    limit?: number;
+    cursor?: string;
+    before?: number;
+    reason?: string;
+    cascade: boolean;
+    final: boolean;
+    yes: boolean;
+    approve?: boolean;
+    json: boolean;
+}
+export declare class CliUsageError extends Error {
+    constructor(message: string);
+}
+export declare const parseCliArgs: (argv: string[]) => CliOptions;
+export declare const summarizeApproval: (approval: AgentApprovalRequest) => string;
+export declare const runResultDocument: (result: AgentRunOutput, harness: ZhivexHarness) => {
+    scope: import("@zhivex-ai/core").AgentStoreScope | undefined;
+    capabilities: import("./capabilities.js").HarnessModelCapabilityReport;
+    orchestration: {
+        profiles: readonly ("explorer" | "implementer" | "tester" | "reviewer")[];
+        childBudget: import("./config.js").HarnessBudget;
+        mcpServers: string[];
+    };
+    store: {
+        backend: "sqlite" | "file";
+        stateDirectory: string;
+        migration: import("./operations.js").HarnessMigrationResult | undefined;
+    };
+    stateDirectory: string;
+    costBudget?: {
+        limitUsd: number;
+        estimate: import("@zhivex-ai/core").CostEstimate;
+    };
+    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" | "update" | "move" | "quarantine" | "restore";
+        path: string;
+        timestamp: string;
+        destination?: string | undefined;
+        beforeDigest?: string | undefined;
+        afterDigest?: string | undefined;
+        quarantineId?: string | undefined;
+    }[];
+    pendingApprovals: {
+        childAgentId?: string;
+        childRunId?: string;
+        id: string;
+        kind: "provider" | "local-tool" | "subagent";
+        name: string;
+        arguments: 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/core").AgentBudgetStatus;
+};
+export declare const providersDocument: (env?: NodeJS.ProcessEnv) => {
+    schemaVersion: 1;
+    kind: "providers";
+    providers: {
+        configured: boolean;
+        credentials: {
+            name: string;
+            present: boolean;
+        }[];
+        configuration: {
+            workspaceIdConfigured?: boolean;
+            regionConfigured?: boolean;
+            regionValid?: boolean;
+            customEndpoint: boolean;
+            endpointValid: boolean;
+            endpointSecure: boolean;
+        };
+        id: HarnessProvider;
+        name: string;
+        defaultModel: string;
+        credentialNames: readonly string[];
+        capabilities: readonly import("./config.js").ProviderCapability[];
+        support: import("./config.js").ProviderSupport;
+    }[];
+};
+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;
+        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"];
+        mcpConfigPath?: string;
+    };
+    checks: DoctorCheck[];
+    providers: ReturnType<typeof providerAvailability>;
+}
+export interface DoctorContext {
+    env?: NodeJS.ProcessEnv;
+    bunVersion?: string;
+}
+export declare const createDoctorReport: (options?: Pick<CliOptions, "provider" | "model" | "workspace" | "stateDirectory" | "storeBackend" | "tenantId" | "userId" | "namespace" | "maxSteps" | "timeoutMs" | "maxToolCalls" | "maxToolErrors" | "maxInputTokens" | "maxOutputTokens" | "maxTotalTokens" | "maxCostUsd" | "inputCostPerMillion" | "outputCostPerMillion" | "allowedChecks" | "requiredCapabilities" | "subagentProfiles" | "subagentMaxSteps" | "subagentMaxToolCalls" | "subagentMaxToolErrors" | "subagentMaxInputTokens" | "subagentMaxOutputTokens" | "subagentMaxTotalTokens" | "subagentTimeoutMs" | "maxParallelReviews" | "mcpConfigPath">, context?: DoctorContext) => Promise<DoctorReport>;
+export declare const formatDoctorReport: (report: DoctorReport) => string;
+export declare const cliExitCodeForError: (error: unknown) => 2 | 1;
+export declare const main: (argv?: string[]) => Promise<void>;
+export {};