@haven_ai/connect 0.9.0-alpha.0 → 0.10.0-alpha.0

package/dist/index.d.cts

@@ -17,6 +17,21 @@ interface ConnectApiClient {
      * of the dashboard hand-off — see {@link AgentIdentity}.
      */
     getAgentIdentity(apiKey: string): Promise<AgentIdentity>;
+    /**
+     * #3772: tell Haven which agents this run's `--replace` retired locally, so
+     * their own reads can warn a still-running session. Authenticated with the
+     * NEW agent's key. `null` when the backend predates the route (404); any
+     * other failure throws for the caller to log. Warning-only on the backend:
+     * nothing is paused or revoked.
+     */
+    reportRetiredAgents?(input: ReportRetiredAgentsInput): Promise<{
+        recordedAgentIds: string[];
+    } | null>;
+}
+interface ReportRetiredAgentsInput {
+    setupId: string;
+    apiKey: string;
+    retiredAgentIds: readonly string[];
 }
 interface ConnectorStatusResponse {
     status: string;
@@ -86,8 +101,9 @@ interface UpdateInstallStatusInput {
     errorCode?: string | null;
     environmentLabel?: string;
     /**
-     * The other agent directories this machine holds, so the DASHBOARD can offer
-     * the owner a one-click revoke of what this setup superseded (#2561).
+     * The other agent directories this machine holds, so the DASHBOARD can list
+     * them for the owner (#2561). Every other directory, not a replace set: the
+     * dashboard calls none of them replaced and offers no revoke (#3830).
      *
      * A tri-state, and the middle case is why it is not a plain array:
      *
@@ -237,6 +253,19 @@ interface PreflightCredentialStorageInput {
 }
 declare function preflightCredentialStorage(input?: PreflightCredentialStorageInput): Promise<string>;
 declare function writeCredentialFiles(input: WriteCredentialInput): Promise<StoredCredentialPaths>;
+interface ResolveAgentDirectoryOptions {
+    /** The credential ROOT to scan. Default: ~/.haven/agents. */
+    root?: string;
+    /**
+     * Retired (tombstoned) directories may claim a slug. Only --unwire wants
+     * this: it must reach a retired agent to release its name. Selection for
+     * --doctor/--repair/--rekey never matches a tombstoned directory.
+     */
+    allowRetired?: boolean;
+}
+/** Does THIS directory record the pair for `slug`? Shared agree-check for `--name` + `--credentials-dir`. */
+declare function assertDirectoryRecordsSlug(directory: string, slug: string): Promise<void>;
+declare function resolveAgentDirectoryBySlug(slug: string, opts?: ResolveAgentDirectoryOptions): Promise<string>;
 declare function defaultAgentDirectory(agentId: string, baseDir?: string): string;
 /**
  * Where the terminal `ConnectOutcome` is parked so a caller that lost the
@@ -753,7 +782,7 @@ type WiringCollisionResolution = {
     action: 'abort';
 };
 
-declare const CONNECTOR_VERSION = "0.9.0-alpha.0";
+declare const CONNECTOR_VERSION = "0.10.0-alpha.0";
 interface ConnectOptions {
     setupToken: string;
     apiBaseUrl: string;
@@ -1242,11 +1271,11 @@ declare function isConnectError(err: unknown): err is ConnectError;
 
 declare const MCP_RUNTIME_MANIFEST: {
     readonly mcpPackage: "@haven_ai/mcp";
-    readonly mcpVersion: "0.9.0-alpha.0";
+    readonly mcpVersion: "0.10.0-alpha.0";
     readonly sdkPackage: "@haven_ai/sdk";
-    readonly sdkVersion: "0.9.0-alpha.0";
+    readonly sdkVersion: "0.10.0-alpha.0";
     readonly signerPackage: "@haven_ai/signer";
-    readonly signerVersion: "0.9.0-alpha.0";
+    readonly signerVersion: "0.10.0-alpha.0";
     readonly minimumNodeVersion: "22.0.0";
     readonly supportedClients: readonly ["codex-cli", "codex-desktop", "claude-code"];
     readonly requiredTools: readonly string[];
@@ -1262,4 +1291,4 @@ declare function mcpPackageSpec(): string;
 declare function sdkPackageSpec(): string;
 declare function signerPackageSpec(): string;
 
-export { CONNECTOR_VERSION, CONNECT_OUTCOME_FILENAME, CONNECT_OUTCOME_SCHEMA_VERSION, type ConnectApiClient, type ConnectDeps, ConnectError, type ConnectOptions, type ConnectOutcome, type ConnectOutcomeStatus, type ConnectResult, type InstalledClientCandidate, type InstalledClientHint, type LocalDelegateKey, MCP_RUNTIME_MANIFEST, type ParsedCli, type PrepareSignerRuntimeInput, type PreparedSignerRuntime, type PromptIo, RUNTIME_FLAG_VALUES, type RegisterSetupInput, type RegisterSetupResponse, type ResolveSetupInput, type ResolvedSetup, type RuntimeId, type RuntimeInstallInput, type RuntimeInstallResult, type RuntimeProfile, type RuntimeResolutionOptions, type RuntimeSelection, type ScanInstalledClientsOptions, type StoredCredentialPaths, type UpdateInstallStatusInput, type WriteCredentialInput, completionOutcome, createConnectApiClient, defaultAgentDirectory, delegateKeyFromPrivateKey, failedConnectOutcome, failureOutcomeFor, generateDelegateKey, helpText, installRuntime, installedClientHint, isConnectError, mcpPackageSpec, normalizeRuntime, parseArgs, prepareSignerRuntime, promptForInstalledClient, redactSecrets, resolveRuntimeByInstalledClientPrompt, resolveRuntimeSelection, runConnect, runtimeInstallCapabilities, runtimeProfile, scanInstalledClients, sdkPackageSpec, shortAddress, signerPackageSpec, writeConnectOutcomeRecord, writeCredentialFiles };
+export { CONNECTOR_VERSION, CONNECT_OUTCOME_FILENAME, CONNECT_OUTCOME_SCHEMA_VERSION, type ConnectApiClient, type ConnectDeps, ConnectError, type ConnectOptions, type ConnectOutcome, type ConnectOutcomeStatus, type ConnectResult, type InstalledClientCandidate, type InstalledClientHint, type LocalDelegateKey, MCP_RUNTIME_MANIFEST, type ParsedCli, type PrepareSignerRuntimeInput, type PreparedSignerRuntime, type PromptIo, RUNTIME_FLAG_VALUES, type RegisterSetupInput, type RegisterSetupResponse, type ResolveAgentDirectoryOptions, type ResolveSetupInput, type ResolvedSetup, type RuntimeId, type RuntimeInstallInput, type RuntimeInstallResult, type RuntimeProfile, type RuntimeResolutionOptions, type RuntimeSelection, type ScanInstalledClientsOptions, type StoredCredentialPaths, type UpdateInstallStatusInput, type WriteCredentialInput, assertDirectoryRecordsSlug, completionOutcome, createConnectApiClient, defaultAgentDirectory, delegateKeyFromPrivateKey, failedConnectOutcome, failureOutcomeFor, generateDelegateKey, helpText, installRuntime, installedClientHint, isConnectError, mcpPackageSpec, normalizeRuntime, parseArgs, prepareSignerRuntime, promptForInstalledClient, redactSecrets, resolveAgentDirectoryBySlug, resolveRuntimeByInstalledClientPrompt, resolveRuntimeSelection, runConnect, runtimeInstallCapabilities, runtimeProfile, scanInstalledClients, sdkPackageSpec, shortAddress, signerPackageSpec, writeConnectOutcomeRecord, writeCredentialFiles };

package/dist/index.d.ts

@@ -17,6 +17,21 @@ interface ConnectApiClient {
      * of the dashboard hand-off — see {@link AgentIdentity}.
      */
     getAgentIdentity(apiKey: string): Promise<AgentIdentity>;
+    /**
+     * #3772: tell Haven which agents this run's `--replace` retired locally, so
+     * their own reads can warn a still-running session. Authenticated with the
+     * NEW agent's key. `null` when the backend predates the route (404); any
+     * other failure throws for the caller to log. Warning-only on the backend:
+     * nothing is paused or revoked.
+     */
+    reportRetiredAgents?(input: ReportRetiredAgentsInput): Promise<{
+        recordedAgentIds: string[];
+    } | null>;
+}
+interface ReportRetiredAgentsInput {
+    setupId: string;
+    apiKey: string;
+    retiredAgentIds: readonly string[];
 }
 interface ConnectorStatusResponse {
     status: string;
@@ -86,8 +101,9 @@ interface UpdateInstallStatusInput {
     errorCode?: string | null;
     environmentLabel?: string;
     /**
-     * The other agent directories this machine holds, so the DASHBOARD can offer
-     * the owner a one-click revoke of what this setup superseded (#2561).
+     * The other agent directories this machine holds, so the DASHBOARD can list
+     * them for the owner (#2561). Every other directory, not a replace set: the
+     * dashboard calls none of them replaced and offers no revoke (#3830).
      *
      * A tri-state, and the middle case is why it is not a plain array:
      *
@@ -237,6 +253,19 @@ interface PreflightCredentialStorageInput {
 }
 declare function preflightCredentialStorage(input?: PreflightCredentialStorageInput): Promise<string>;
 declare function writeCredentialFiles(input: WriteCredentialInput): Promise<StoredCredentialPaths>;
+interface ResolveAgentDirectoryOptions {
+    /** The credential ROOT to scan. Default: ~/.haven/agents. */
+    root?: string;
+    /**
+     * Retired (tombstoned) directories may claim a slug. Only --unwire wants
+     * this: it must reach a retired agent to release its name. Selection for
+     * --doctor/--repair/--rekey never matches a tombstoned directory.
+     */
+    allowRetired?: boolean;
+}
+/** Does THIS directory record the pair for `slug`? Shared agree-check for `--name` + `--credentials-dir`. */
+declare function assertDirectoryRecordsSlug(directory: string, slug: string): Promise<void>;
+declare function resolveAgentDirectoryBySlug(slug: string, opts?: ResolveAgentDirectoryOptions): Promise<string>;
 declare function defaultAgentDirectory(agentId: string, baseDir?: string): string;
 /**
  * Where the terminal `ConnectOutcome` is parked so a caller that lost the
@@ -753,7 +782,7 @@ type WiringCollisionResolution = {
     action: 'abort';
 };
 
-declare const CONNECTOR_VERSION = "0.9.0-alpha.0";
+declare const CONNECTOR_VERSION = "0.10.0-alpha.0";
 interface ConnectOptions {
     setupToken: string;
     apiBaseUrl: string;
@@ -1242,11 +1271,11 @@ declare function isConnectError(err: unknown): err is ConnectError;
 
 declare const MCP_RUNTIME_MANIFEST: {
     readonly mcpPackage: "@haven_ai/mcp";
-    readonly mcpVersion: "0.9.0-alpha.0";
+    readonly mcpVersion: "0.10.0-alpha.0";
     readonly sdkPackage: "@haven_ai/sdk";
-    readonly sdkVersion: "0.9.0-alpha.0";
+    readonly sdkVersion: "0.10.0-alpha.0";
     readonly signerPackage: "@haven_ai/signer";
-    readonly signerVersion: "0.9.0-alpha.0";
+    readonly signerVersion: "0.10.0-alpha.0";
     readonly minimumNodeVersion: "22.0.0";
     readonly supportedClients: readonly ["codex-cli", "codex-desktop", "claude-code"];
     readonly requiredTools: readonly string[];
@@ -1262,4 +1291,4 @@ declare function mcpPackageSpec(): string;
 declare function sdkPackageSpec(): string;
 declare function signerPackageSpec(): string;
 
-export { CONNECTOR_VERSION, CONNECT_OUTCOME_FILENAME, CONNECT_OUTCOME_SCHEMA_VERSION, type ConnectApiClient, type ConnectDeps, ConnectError, type ConnectOptions, type ConnectOutcome, type ConnectOutcomeStatus, type ConnectResult, type InstalledClientCandidate, type InstalledClientHint, type LocalDelegateKey, MCP_RUNTIME_MANIFEST, type ParsedCli, type PrepareSignerRuntimeInput, type PreparedSignerRuntime, type PromptIo, RUNTIME_FLAG_VALUES, type RegisterSetupInput, type RegisterSetupResponse, type ResolveSetupInput, type ResolvedSetup, type RuntimeId, type RuntimeInstallInput, type RuntimeInstallResult, type RuntimeProfile, type RuntimeResolutionOptions, type RuntimeSelection, type ScanInstalledClientsOptions, type StoredCredentialPaths, type UpdateInstallStatusInput, type WriteCredentialInput, completionOutcome, createConnectApiClient, defaultAgentDirectory, delegateKeyFromPrivateKey, failedConnectOutcome, failureOutcomeFor, generateDelegateKey, helpText, installRuntime, installedClientHint, isConnectError, mcpPackageSpec, normalizeRuntime, parseArgs, prepareSignerRuntime, promptForInstalledClient, redactSecrets, resolveRuntimeByInstalledClientPrompt, resolveRuntimeSelection, runConnect, runtimeInstallCapabilities, runtimeProfile, scanInstalledClients, sdkPackageSpec, shortAddress, signerPackageSpec, writeConnectOutcomeRecord, writeCredentialFiles };
+export { CONNECTOR_VERSION, CONNECT_OUTCOME_FILENAME, CONNECT_OUTCOME_SCHEMA_VERSION, type ConnectApiClient, type ConnectDeps, ConnectError, type ConnectOptions, type ConnectOutcome, type ConnectOutcomeStatus, type ConnectResult, type InstalledClientCandidate, type InstalledClientHint, type LocalDelegateKey, MCP_RUNTIME_MANIFEST, type ParsedCli, type PrepareSignerRuntimeInput, type PreparedSignerRuntime, type PromptIo, RUNTIME_FLAG_VALUES, type RegisterSetupInput, type RegisterSetupResponse, type ResolveAgentDirectoryOptions, type ResolveSetupInput, type ResolvedSetup, type RuntimeId, type RuntimeInstallInput, type RuntimeInstallResult, type RuntimeProfile, type RuntimeResolutionOptions, type RuntimeSelection, type ScanInstalledClientsOptions, type StoredCredentialPaths, type UpdateInstallStatusInput, type WriteCredentialInput, assertDirectoryRecordsSlug, completionOutcome, createConnectApiClient, defaultAgentDirectory, delegateKeyFromPrivateKey, failedConnectOutcome, failureOutcomeFor, generateDelegateKey, helpText, installRuntime, installedClientHint, isConnectError, mcpPackageSpec, normalizeRuntime, parseArgs, prepareSignerRuntime, promptForInstalledClient, redactSecrets, resolveAgentDirectoryBySlug, resolveRuntimeByInstalledClientPrompt, resolveRuntimeSelection, runConnect, runtimeInstallCapabilities, runtimeProfile, scanInstalledClients, sdkPackageSpec, shortAddress, signerPackageSpec, writeConnectOutcomeRecord, writeCredentialFiles };