@haven_ai/connect 0.1.22-alpha.0 → 0.1.23-alpha.0

package/dist/index.d.cts

@@ -1,3 +1,5 @@
+export { CliIo, runCli } from './cli.cjs';
+
 interface ConnectApiClient {
     resolveSetup(input: ResolveSetupInput): Promise<ResolvedSetup>;
     registerSetup(input: RegisterSetupInput): Promise<RegisterSetupResponse>;
@@ -133,6 +135,8 @@ interface RuntimeProfile {
     label: string;
     restartMode: RestartMode;
     canWriteRuntimeConfig: boolean;
+    /** Precise, runtime-owned instruction for loading a freshly written MCP entry. */
+    activationInstruction: string;
 }
 declare function runtimeProfile(runtime: string | undefined, env?: NodeJS.ProcessEnv): RuntimeProfile;
 declare function normalizeRuntime(runtime: string | undefined, env?: NodeJS.ProcessEnv): RuntimeId;
@@ -264,7 +268,7 @@ declare function runtimeInstallCapabilities(runtime: string | undefined, env?: N
     restartRequired: boolean;
 };
 
-declare const CONNECTOR_VERSION = "0.1.22-alpha.0";
+declare const CONNECTOR_VERSION = "0.1.23-alpha.0";
 interface ConnectOptions {
     setupToken: string;
     apiBaseUrl: string;
@@ -276,6 +280,42 @@ interface ConnectOptions {
     ackLocalTools?: boolean;
     localMcp?: boolean;
 }
+/** The stable machine-readable result emitted by `haven-connect --json`. */
+declare const CONNECT_OUTCOME_SCHEMA_VERSION: 1;
+type ConnectOutcomeStatus = 'complete' | 'action_required' | 'failed';
+interface ConnectOutcome {
+    schema_version: typeof CONNECT_OUTCOME_SCHEMA_VERSION;
+    outcome: ConnectOutcomeStatus;
+    runtime: string;
+    topology: string;
+    configuration: {
+        hosted_mcp: boolean;
+        local_signer: boolean;
+        local_mcp: boolean;
+    };
+    probe: {
+        result: string;
+    };
+    activation: {
+        restart_required: boolean;
+        instruction: string;
+    };
+    next_action: string;
+    approval: {
+        required: boolean;
+        expires_at: string | null;
+    };
+    verification: {
+        tools: readonly ['haven_get_agent', 'haven_get_allowances'];
+        instruction: string;
+    };
+    delegate_address?: string;
+    setup_challenge_expires_at?: string;
+    error?: {
+        code: string;
+        next_action: string;
+    };
+}
 interface ConnectDeps {
     api?: ConnectApiClient;
     generateKey?: () => LocalDelegateKey;
@@ -284,6 +324,8 @@ interface ConnectDeps {
     writeCredentials?: typeof writeCredentialFiles;
     installRuntime?: typeof installRuntime;
     log?: (message: string) => void;
+    /** JSON CLI mode must not expose owner-only credential file locations. */
+    redactPaths?: boolean;
     /** Overridable so the Node-floor refusal is testable without spawning a Node. */
     nodeVersion?: string;
 }
@@ -292,12 +334,26 @@ interface ConnectResult {
     agentId: string;
     delegateAddress: string;
     credentialPaths: StoredCredentialPaths;
+    /** Additive, secret-free completion contract shared by library callers and --json. */
+    outcome: ConnectOutcome;
 }
 declare function runConnect(options: ConnectOptions, deps?: ConnectDeps): Promise<ConnectResult>;
+declare function completionOutcome(input: {
+    runtimeInstall: RuntimeInstallResult;
+    delegateAddress: string;
+    setupChallengeExpiresAt?: string;
+    approvalRequired: boolean;
+}): ConnectOutcome;
+/**
+ * A deliberately terse failure record: error messages can contain server or
+ * filesystem detail, while this public contract must remain safe to serialize.
+ */
+declare function failedConnectOutcome(runtimeHint: string | undefined, error: unknown): ConnectOutcome;
 
 interface ParsedCli {
     options: ConnectOptions;
     help: boolean;
+    json: boolean;
 }
 declare function parseArgs(argv: string[], env?: NodeJS.ProcessEnv): ParsedCli;
 declare function helpText(): string;
@@ -307,12 +363,12 @@ declare function shortAddress(address: string): string;
 
 declare const MCP_RUNTIME_MANIFEST: {
     readonly mcpPackage: "@haven_ai/mcp";
-    readonly mcpVersion: "0.1.22-alpha.0";
+    readonly mcpVersion: "0.1.23-alpha.0";
     readonly sdkPackage: "@haven_ai/sdk";
-    readonly sdkVersion: "0.1.22-alpha.0";
+    readonly sdkVersion: "0.1.23-alpha.0";
     readonly signerPackage: "@haven_ai/signer";
-    readonly signerVersion: "0.1.22-alpha.0";
-    readonly minimumNodeVersion: "24.0.0";
+    readonly signerVersion: "0.1.23-alpha.0";
+    readonly minimumNodeVersion: "22.0.0";
     readonly supportedClients: readonly ["codex-cli", "codex-desktop", "claude-code"];
     readonly requiredTools: readonly string[];
 };
@@ -320,4 +376,4 @@ declare function mcpPackageSpec(): string;
 declare function sdkPackageSpec(): string;
 declare function signerPackageSpec(): string;
 
-export { CONNECTOR_VERSION, type ConnectApiClient, type ConnectDeps, type ConnectOptions, type ConnectResult, type LocalDelegateKey, MCP_RUNTIME_MANIFEST, type PrepareSignerRuntimeInput, type PreparedSignerRuntime, type RegisterSetupInput, type RegisterSetupResponse, type ResolveSetupInput, type ResolvedSetup, type RuntimeId, type RuntimeInstallInput, type RuntimeInstallResult, type RuntimeProfile, type StoredCredentialPaths, type UpdateInstallStatusInput, type WriteCredentialInput, createConnectApiClient, defaultAgentDirectory, delegateKeyFromPrivateKey, generateDelegateKey, helpText, installRuntime, mcpPackageSpec, normalizeRuntime, parseArgs, prepareSignerRuntime, redactSecrets, runConnect, runtimeInstallCapabilities, runtimeProfile, sdkPackageSpec, shortAddress, signerPackageSpec, writeCredentialFiles };
+export { CONNECTOR_VERSION, CONNECT_OUTCOME_SCHEMA_VERSION, type ConnectApiClient, type ConnectDeps, type ConnectOptions, type ConnectOutcome, type ConnectOutcomeStatus, type ConnectResult, type LocalDelegateKey, MCP_RUNTIME_MANIFEST, type ParsedCli, type PrepareSignerRuntimeInput, type PreparedSignerRuntime, type RegisterSetupInput, type RegisterSetupResponse, type ResolveSetupInput, type ResolvedSetup, type RuntimeId, type RuntimeInstallInput, type RuntimeInstallResult, type RuntimeProfile, type StoredCredentialPaths, type UpdateInstallStatusInput, type WriteCredentialInput, completionOutcome, createConnectApiClient, defaultAgentDirectory, delegateKeyFromPrivateKey, failedConnectOutcome, generateDelegateKey, helpText, installRuntime, mcpPackageSpec, normalizeRuntime, parseArgs, prepareSignerRuntime, redactSecrets, runConnect, runtimeInstallCapabilities, runtimeProfile, sdkPackageSpec, shortAddress, signerPackageSpec, writeCredentialFiles };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export { CliIo, runCli } from './cli.js';
+
 interface ConnectApiClient {
     resolveSetup(input: ResolveSetupInput): Promise<ResolvedSetup>;
     registerSetup(input: RegisterSetupInput): Promise<RegisterSetupResponse>;
@@ -133,6 +135,8 @@ interface RuntimeProfile {
     label: string;
     restartMode: RestartMode;
     canWriteRuntimeConfig: boolean;
+    /** Precise, runtime-owned instruction for loading a freshly written MCP entry. */
+    activationInstruction: string;
 }
 declare function runtimeProfile(runtime: string | undefined, env?: NodeJS.ProcessEnv): RuntimeProfile;
 declare function normalizeRuntime(runtime: string | undefined, env?: NodeJS.ProcessEnv): RuntimeId;
@@ -264,7 +268,7 @@ declare function runtimeInstallCapabilities(runtime: string | undefined, env?: N
     restartRequired: boolean;
 };
 
-declare const CONNECTOR_VERSION = "0.1.22-alpha.0";
+declare const CONNECTOR_VERSION = "0.1.23-alpha.0";
 interface ConnectOptions {
     setupToken: string;
     apiBaseUrl: string;
@@ -276,6 +280,42 @@ interface ConnectOptions {
     ackLocalTools?: boolean;
     localMcp?: boolean;
 }
+/** The stable machine-readable result emitted by `haven-connect --json`. */
+declare const CONNECT_OUTCOME_SCHEMA_VERSION: 1;
+type ConnectOutcomeStatus = 'complete' | 'action_required' | 'failed';
+interface ConnectOutcome {
+    schema_version: typeof CONNECT_OUTCOME_SCHEMA_VERSION;
+    outcome: ConnectOutcomeStatus;
+    runtime: string;
+    topology: string;
+    configuration: {
+        hosted_mcp: boolean;
+        local_signer: boolean;
+        local_mcp: boolean;
+    };
+    probe: {
+        result: string;
+    };
+    activation: {
+        restart_required: boolean;
+        instruction: string;
+    };
+    next_action: string;
+    approval: {
+        required: boolean;
+        expires_at: string | null;
+    };
+    verification: {
+        tools: readonly ['haven_get_agent', 'haven_get_allowances'];
+        instruction: string;
+    };
+    delegate_address?: string;
+    setup_challenge_expires_at?: string;
+    error?: {
+        code: string;
+        next_action: string;
+    };
+}
 interface ConnectDeps {
     api?: ConnectApiClient;
     generateKey?: () => LocalDelegateKey;
@@ -284,6 +324,8 @@ interface ConnectDeps {
     writeCredentials?: typeof writeCredentialFiles;
     installRuntime?: typeof installRuntime;
     log?: (message: string) => void;
+    /** JSON CLI mode must not expose owner-only credential file locations. */
+    redactPaths?: boolean;
     /** Overridable so the Node-floor refusal is testable without spawning a Node. */
     nodeVersion?: string;
 }
@@ -292,12 +334,26 @@ interface ConnectResult {
     agentId: string;
     delegateAddress: string;
     credentialPaths: StoredCredentialPaths;
+    /** Additive, secret-free completion contract shared by library callers and --json. */
+    outcome: ConnectOutcome;
 }
 declare function runConnect(options: ConnectOptions, deps?: ConnectDeps): Promise<ConnectResult>;
+declare function completionOutcome(input: {
+    runtimeInstall: RuntimeInstallResult;
+    delegateAddress: string;
+    setupChallengeExpiresAt?: string;
+    approvalRequired: boolean;
+}): ConnectOutcome;
+/**
+ * A deliberately terse failure record: error messages can contain server or
+ * filesystem detail, while this public contract must remain safe to serialize.
+ */
+declare function failedConnectOutcome(runtimeHint: string | undefined, error: unknown): ConnectOutcome;
 
 interface ParsedCli {
     options: ConnectOptions;
     help: boolean;
+    json: boolean;
 }
 declare function parseArgs(argv: string[], env?: NodeJS.ProcessEnv): ParsedCli;
 declare function helpText(): string;
@@ -307,12 +363,12 @@ declare function shortAddress(address: string): string;
 
 declare const MCP_RUNTIME_MANIFEST: {
     readonly mcpPackage: "@haven_ai/mcp";
-    readonly mcpVersion: "0.1.22-alpha.0";
+    readonly mcpVersion: "0.1.23-alpha.0";
     readonly sdkPackage: "@haven_ai/sdk";
-    readonly sdkVersion: "0.1.22-alpha.0";
+    readonly sdkVersion: "0.1.23-alpha.0";
     readonly signerPackage: "@haven_ai/signer";
-    readonly signerVersion: "0.1.22-alpha.0";
-    readonly minimumNodeVersion: "24.0.0";
+    readonly signerVersion: "0.1.23-alpha.0";
+    readonly minimumNodeVersion: "22.0.0";
     readonly supportedClients: readonly ["codex-cli", "codex-desktop", "claude-code"];
     readonly requiredTools: readonly string[];
 };
@@ -320,4 +376,4 @@ declare function mcpPackageSpec(): string;
 declare function sdkPackageSpec(): string;
 declare function signerPackageSpec(): string;
 
-export { CONNECTOR_VERSION, type ConnectApiClient, type ConnectDeps, type ConnectOptions, type ConnectResult, type LocalDelegateKey, MCP_RUNTIME_MANIFEST, type PrepareSignerRuntimeInput, type PreparedSignerRuntime, type RegisterSetupInput, type RegisterSetupResponse, type ResolveSetupInput, type ResolvedSetup, type RuntimeId, type RuntimeInstallInput, type RuntimeInstallResult, type RuntimeProfile, type StoredCredentialPaths, type UpdateInstallStatusInput, type WriteCredentialInput, createConnectApiClient, defaultAgentDirectory, delegateKeyFromPrivateKey, generateDelegateKey, helpText, installRuntime, mcpPackageSpec, normalizeRuntime, parseArgs, prepareSignerRuntime, redactSecrets, runConnect, runtimeInstallCapabilities, runtimeProfile, sdkPackageSpec, shortAddress, signerPackageSpec, writeCredentialFiles };
+export { CONNECTOR_VERSION, CONNECT_OUTCOME_SCHEMA_VERSION, type ConnectApiClient, type ConnectDeps, type ConnectOptions, type ConnectOutcome, type ConnectOutcomeStatus, type ConnectResult, type LocalDelegateKey, MCP_RUNTIME_MANIFEST, type ParsedCli, type PrepareSignerRuntimeInput, type PreparedSignerRuntime, type RegisterSetupInput, type RegisterSetupResponse, type ResolveSetupInput, type ResolvedSetup, type RuntimeId, type RuntimeInstallInput, type RuntimeInstallResult, type RuntimeProfile, type StoredCredentialPaths, type UpdateInstallStatusInput, type WriteCredentialInput, completionOutcome, createConnectApiClient, defaultAgentDirectory, delegateKeyFromPrivateKey, failedConnectOutcome, generateDelegateKey, helpText, installRuntime, mcpPackageSpec, normalizeRuntime, parseArgs, prepareSignerRuntime, redactSecrets, runConnect, runtimeInstallCapabilities, runtimeProfile, sdkPackageSpec, shortAddress, signerPackageSpec, writeCredentialFiles };