@xenosystem/agent-interface-client 0.1.0

package/dist/index.js

@@ -0,0 +1,523 @@
+import { AgentHostProtocolError, XENO_AGENT_HOST_MIN_PROTOCOL_VERSION, XENO_AGENT_HOST_PROTOCOL_VERSION, assertCompatibleHandshake, isAgentHostHandshake, isAgentProviderListResult, isAgentRuntimeEventListResult, isAgentTurnCancelResult, isAgentTurnStartResult, } from '@xenosystem/agent-interface-contract';
+export class AgentHostClient {
+    transport;
+    identity;
+    supportedProtocol;
+    handshake = null;
+    constructor(options) {
+        this.transport = options.transport;
+        this.identity = { ...options.identity };
+        this.supportedProtocol = options.supportedProtocol
+            ? { ...options.supportedProtocol }
+            : {
+                min: XENO_AGENT_HOST_MIN_PROTOCOL_VERSION,
+                max: XENO_AGENT_HOST_PROTOCOL_VERSION,
+            };
+    }
+    get surface() {
+        return this.identity.surface;
+    }
+    get instanceId() {
+        return this.identity.instanceId;
+    }
+    /**
+     * A copy of who this client is — for building an `AgentHostCommandContext`.
+     *
+     * Exposed so a bridge can mint the command itself rather than making every
+     * surface carry an identity it does not otherwise need. A copy, because a
+     * caller that could mutate this would be rewriting who it is between calls.
+     */
+    get clientIdentity() {
+        return { ...this.identity };
+    }
+    get connection() {
+        return this.handshake ? structuredClone(this.handshake) : null;
+    }
+    async connect() {
+        const response = await this.transport.request('host.handshake', {
+            identity: { ...this.identity },
+            supportedProtocol: { ...this.supportedProtocol },
+        });
+        if (!isAgentHostHandshake(response)) {
+            throw new AgentHostProtocolError('invalid_handshake', 'Agent host returned an invalid handshake.');
+        }
+        assertCompatibleHandshake(response, this.identity, this.supportedProtocol);
+        this.handshake = structuredClone(response);
+        return structuredClone(response);
+    }
+    async listProviders(options = {}) {
+        this.requireConnection();
+        const response = await this.transport.request('providers.list', {
+            ...(options.includeUnavailable === undefined
+                ? {}
+                : { includeUnavailable: options.includeUnavailable }),
+        });
+        if (!isAgentProviderListResult(response)) {
+            throw new AgentHostProtocolError('invalid_response', 'Agent host returned an invalid provider catalog.');
+        }
+        return structuredClone(response);
+    }
+    async refreshProviders(options = {}) {
+        this.requireConnection();
+        const response = await this.transport.request('providers.refresh', {
+            ...(options.includeUnavailable === undefined
+                ? {}
+                : { includeUnavailable: options.includeUnavailable }),
+        });
+        if (!isAgentProviderListResult(response)) {
+            throw new AgentHostProtocolError('invalid_response', 'Agent host returned an invalid refreshed provider catalog.');
+        }
+        return structuredClone(response);
+    }
+    async listRuntimeEvents(request) {
+        this.requireConnection();
+        const response = await this.transport.request('runtime.events.list', structuredClone(request));
+        if (!isAgentRuntimeEventListResult(response)) {
+            throw new AgentHostProtocolError('invalid_response', 'Agent host returned an invalid runtime-event page.');
+        }
+        return structuredClone(response);
+    }
+    /**
+     * Delivers a correction to a turn that is ALREADY RUNNING.
+     *
+     * ⚠️ `delivered` means the agent has it, never that the agent has stopped.
+     * Measured against real Claude Code: a correction lands at the agent's next
+     * decision point, not inside the tool call already in flight. `cancelTurn` is
+     * the mechanism for stop; this is for redirect.
+     *
+     * An adapter that cannot steer refuses by name (`steer_unsupported`) rather
+     * than silently accepting — a user who believes they corrected an agent that
+     * never heard them is the worst outcome here.
+     */
+    async steerTurn(request, options = {}) {
+        this.requireConnection();
+        const response = await this.transport.request('turn.steer', {
+            ...structuredClone(request),
+            command: this.createCommandContext(options, `turn:steer:${request.conversationId}:${request.requestId}`),
+        });
+        return response;
+    }
+    /**
+     * Holds an instruction for a running turn without requiring the agent to
+     * accept it mid-flight. Host-owned, so it works at every structure tier —
+     * unlike steering, which needs a protocol the agent listens on.
+     */
+    async queueTurnInstruction(request, options = {}) {
+        this.requireConnection();
+        const response = await this.transport.request('turn.queue', {
+            ...structuredClone(request),
+            command: this.createCommandContext(options, 
+            // The queue is per CONVERSATION, not per turn — an instruction outlives
+            // the turn that was running when it was written.
+            `turn:queue:${request.conversationId}`),
+        });
+        return response;
+    }
+    /**
+     * Messages a run is not being told yet — coordination §6 `hold`.
+     *
+     * Plain read, no command context: listing changes nothing.
+     */
+    async listHeldMessages(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('coordination.held.list', structuredClone(request)));
+    }
+    /**
+     * A human approves one held message.
+     *
+     * 🔴 A wrapper is REQUIRED, not a convenience: the request carries a
+     * `command: AgentHostCommandContext`, which the host owns. Without one, a
+     * surface approving a message would have to forge the command id, the
+     * idempotency key and the client identity — and approving another agent's
+     * message is exactly the act that should be attributable.
+     */
+    async releaseHeldMessage(request, options = {}) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('coordination.held.release', {
+            ...structuredClone(request),
+            command: this.createCommandContext(options, 
+            // Keyed by the MESSAGE: approving the same one twice is one approval,
+            // and approving a different one is a different act.
+            `coordination:held:release:${request.runId}:${request.messageId}`),
+        }));
+    }
+    /**
+     * Pins or clears a run's inbound-message policy — §6's override.
+     *
+     * `policy: null` returns the run to the derived default; it is NOT the same as
+     * `'accept'`, which pins the permissive answer.
+     */
+    async setInboundPolicy(request, options = {}) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('coordination.policy.set', {
+            ...structuredClone(request),
+            command: this.createCommandContext(options, 
+            // Keyed by the run AND the value: pinning `hold` twice is one act, but
+            // changing it to `refuse` is a different decision and must not be
+            // collapsed into the first by a run-only key.
+            `coordination:policy:set:${request.runId}:${request.policy ?? 'derived'}`),
+        }));
+    }
+    /**
+     * What is waiting to run for this conversation.
+     *
+     * 🔴 A surface that can ENQUEUE and cannot LIST has given the user a
+     * write with no read: an instruction disappears into the host and the only
+     * evidence it exists is that it eventually runs. Both halves of the queue
+     * were implemented in the host and forwarded by the transport; only the
+     * enqueue had a client wrapper, so no surface could show a queue at all.
+     *
+     * Takes no command context because it changes nothing — see `dropQueued`
+     * below, which does.
+     */
+    async listQueuedInstructions(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('turn.queue.list', structuredClone(request)));
+    }
+    /**
+     * Removes a queued instruction, or clears the queue when none is named.
+     *
+     * 🔴 This wrapper is REQUIRED, not a convenience. The request carries a
+     * `command: AgentHostCommandContext`, which is host-owned — a caller must
+     * never mint one. Without a wrapper, a surface wanting to drop an
+     * instruction had to forge the command id, the idempotency key and the
+     * client identity itself, which is exactly the fact-forging the context
+     * exists to prevent.
+     */
+    async dropQueuedInstruction(request, options = {}) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('turn.queue.drop', {
+            ...structuredClone(request),
+            command: this.createCommandContext(options, 
+            // Keyed per instruction, falling back to the conversation when the
+            // whole queue is cleared: a retried "clear everything" must not be
+            // mistaken for a retried "drop this one".
+            request.instructionId
+                ? `turn:queue:drop:${request.conversationId}:${request.instructionId}`
+                : `turn:queue:clear:${request.conversationId}`),
+        }));
+    }
+    /**
+     * Re-issues a turn that process death interrupted.
+     *
+     * Reported as `restarted`, never `resumed` — the request runs again rather
+     * than continuing from where it stopped.
+     */
+    async resumeTurn(request, options = {}) {
+        this.requireConnection();
+        const response = await this.transport.request('turn.resume', {
+            ...structuredClone(request),
+            command: this.createCommandContext(options, `turn:resume:${request.conversationId}:${request.requestId}`),
+        });
+        return response;
+    }
+    /**
+     * The permission rules the user chose to remember. Surfaced so they can be
+     * seen and revoked — they persist and accumulate, and a rule that cannot be
+     * taken back is a one-way door.
+     */
+    async listPermissionRules() {
+        this.requireConnection();
+        const response = await this.transport.request('permissions.rules.list', {});
+        return response;
+    }
+    async revokePermissionRule(ruleId) {
+        this.requireConnection();
+        const response = await this.transport.request('permissions.rules.revoke', { ruleId });
+        return response;
+    }
+    async loadWorkspaces() {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('state.workspaces.load', {}));
+    }
+    async saveWorkspaces(workspaces) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('state.workspaces.save', {
+            workspaces: structuredClone(workspaces),
+        }));
+    }
+    async loadConversations() {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('state.conversations.load', {}));
+    }
+    async saveConversation(conversation) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('state.conversations.save', {
+            conversation: structuredClone(conversation),
+        }));
+    }
+    async deleteConversation(conversationId) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('state.conversations.delete', { conversationId }));
+    }
+    async listWorkspaceDirectory(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.directory.list', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async readWorkspaceFile(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.file.read', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async writeWorkspaceFile(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.file.write', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async runWorkspaceCommand(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.command.run', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async startWorkspaceTerminal(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.terminal.start', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async stopWorkspaceTerminal(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.terminal.stop', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async startWorkspacePty(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.pty.start', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async snapshotWorkspacePty(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.pty.snapshot', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async inputWorkspacePty(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.pty.input', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async resizeWorkspacePty(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.pty.resize', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async clearWorkspacePty(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.pty.clear', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async stopWorkspacePty(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('workspace.pty.stop', {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async startTurn(request, options = {}) {
+        this.requireConnection();
+        const response = await this.transport.request('turn.start', {
+            ...structuredClone(request),
+            command: this.createCommandContext(options, `turn:start:${request.conversationId}:${request.requestId}`),
+        });
+        if (!isAgentTurnStartResult(response)) {
+            throw new AgentHostProtocolError('invalid_response', 'Agent host returned an invalid turn-start result.');
+        }
+        return structuredClone(response);
+    }
+    async cancelTurn(request, options = {}) {
+        this.requireConnection();
+        const response = await this.transport.request('turn.cancel', {
+            ...structuredClone(request),
+            command: this.createCommandContext(options, `turn:cancel:${request.conversationId}:${request.requestId}`),
+        });
+        if (!isAgentTurnCancelResult(response)) {
+            throw new AgentHostProtocolError('invalid_response', 'Agent host returned an invalid turn-cancel result.');
+        }
+        return structuredClone(response);
+    }
+    async answerChooseDirectory(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('elicitation.choose-directory.answer', structuredClone(request)));
+    }
+    async answerWorkspacePlacement(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('elicitation.workspace-placement.answer', structuredClone(request)));
+    }
+    async answerPermission(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('elicitation.permission.answer', structuredClone(request)));
+    }
+    async answerAskUser(request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request('elicitation.ask-user.answer', structuredClone(request)));
+    }
+    async listSdkSessions(request = {}) {
+        return this.requestSdkControl('sdk.sessions.list', request);
+    }
+    async showSdkSession(request) {
+        return this.requestSdkControl('sdk.sessions.show', request);
+    }
+    async attachSdkSession(request) {
+        return this.requestSdkControl('sdk.sessions.attach', request);
+    }
+    async detachSdkSession(request) {
+        return this.requestSdkControl('sdk.sessions.detach', request);
+    }
+    async deleteSdkSession(request) {
+        return this.requestSdkControl('sdk.sessions.delete', request);
+    }
+    async cleanSdkSessions(request) {
+        return this.requestSdkControl('sdk.sessions.clean', request);
+    }
+    async listSdkCheckpoints(request) {
+        return this.requestSdkControl('sdk.checkpoints.list', request);
+    }
+    async restoreSdkCheckpoint(request) {
+        return this.requestSdkControl('sdk.checkpoints.restore', request);
+    }
+    async deleteSdkCheckpoint(request) {
+        return this.requestSdkControl('sdk.checkpoints.delete', request);
+    }
+    async readSdkTaskOutput(request) {
+        return this.requestSdkControl('sdk.tasks.output', request);
+    }
+    async stopSdkTask(request) {
+        return this.requestSdkControl('sdk.tasks.stop', request);
+    }
+    /**
+     * ACP registry operations that run under the host's authority.
+     *
+     * Mirrors `requestEngineering`. Grouped by prefix so the next `acp.*` method
+     * needs no new helper here.
+     */
+    async requestAcp(method, request) {
+        // Written out rather than delegating to `requestEngineering` through a cast:
+        // the generics genuinely differ, and `as never` would have silenced that
+        // rather than resolved it. Four lines is cheaper than a lie.
+        this.requireConnection();
+        return structuredClone(await this.transport.request(method, {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    /**
+     * Reading a run's observed diff — the READ half of §2.9.
+     *
+     * Separate from `requestEngineering` for the same reason `requestAcp` is: the
+     * generics genuinely differ, and one helper covering both would need a cast
+     * that silences the difference rather than resolving it.
+     */
+    /** The fleet surface — ADE §9 step 6. Its own helper for the same reason
+     *  `requestAcp` has one: the generics differ, and one helper covering both
+     *  would need a cast that silences the difference rather than resolving it. */
+    /** Sessions — ADE §5.5. Its own helper for the same reason its siblings have
+     *  one: the generics differ, and a shared helper would need a cast that
+     *  silences the difference rather than resolving it. */
+    /** Intake — ADE §5.1. Its own helper for the same reason its siblings have
+     *  one: the generics differ, and a shared helper would need a cast. */
+    /** Workspace knowledge — ADE §5.8. Its own helper like its siblings. */
+    async requestKnowledge(method, request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request(method, {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async requestIntake(method, request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request(method, {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async requestSession(method, request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request(method, {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async requestFleet(method, request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request(method, {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async requestRunObservation(method, request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request(method, {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    async requestEngineering(method, request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request(method, {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    subscribe(listener) {
+        return this.transport.subscribe(listener);
+    }
+    disconnect() {
+        this.handshake = null;
+    }
+    requireConnection() {
+        if (!this.handshake) {
+            throw new AgentHostProtocolError('not_connected', 'Connect to the XENO Agent host before making this request.');
+        }
+    }
+    async requestSdkControl(method, request) {
+        this.requireConnection();
+        return structuredClone(await this.transport.request(method, {
+            ...structuredClone(request),
+            client: { ...this.identity },
+        }));
+    }
+    createCommandContext(options, fallbackIdempotencyKey) {
+        return {
+            schemaVersion: 1,
+            commandId: options.commandId || createClientCommandId(),
+            idempotencyKey: options.idempotencyKey || fallbackIdempotencyKey,
+            client: { ...this.identity },
+        };
+    }
+}
+function createClientCommandId() {
+    return globalThis.crypto?.randomUUID?.()
+        || `agent-command-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+}
+// 🔴 The local-IPC half (transport, lease reading, attach) is NOT re-exported here. It lives
+// behind the Node-only subpath `@xenosystem/agent-interface-client/local`.
+//
+// It was re-exported from this entry when it was first extracted, and that was a real defect:
+// `packages/ui` value-imports this module, so `node:net` and `node:fs/promises` were reaching
+// the Electron RENDERER BUNDLE — breaking the secure-renderer invariant in `AGENTS.md`. The
+// architecture guard caught it. See `src/local/index.ts` for the full reasoning, and
+// `@xenosystem/agent-interface-host/node` for the same pattern applied to the host.
+//
+// A SURFACE that attaches over local IPC (the CLI, ADE §2.7) imports the subpath.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/local/attach.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Attaching to a per-user Agent host — the SURFACE side of ADE §2.7.
+ *
+ * 🔴 `attachToLocalAgentHost` attaches or refuses; it can never become the host. There is no
+ * `createHostTransport` parameter, so there is nothing it could construct even if asked — the
+ * dangerous shape (a CLI started while no app is running WINS the lease and is then expected to
+ * *be* the host) is unrepresentable rather than merely forbidden.
+ *
+ * That property is why this file can live in a publishable package at all: everything here is
+ * what a thin client legitimately needs, and nothing here can take ownership. Acquisition and the
+ * host authority stay in the private `packages/host`.
+ */
+import { type LocalAgentHostLeaseDescriptor } from './lease.js';
+import { LocalAgentHostRpcClientTransport } from './transport.js';
+/**
+ * 🔴 STRUCTURAL, not the concrete server/lease classes.
+ *
+ * The session only ever closes the server and releases or heartbeats the lease — three calls.
+ * Typing those fields as the host's concrete `LocalAgentHostRpcServer` and `LocalAgentHostLease`
+ * dragged the whole server implementation into this file, which is what kept the session
+ * unpublishable. Naming the three calls it actually makes decouples it, and the host's real
+ * classes satisfy these by shape with no adapter.
+ */
+export interface ClosableAuthorityServer {
+    close(): Promise<void>;
+}
+export interface RenewableAuthorityLease {
+    release(): Promise<unknown>;
+    heartbeat(): Promise<unknown>;
+}
+export type LocalAgentHostAuthorityRole = 'owner' | 'attached-client';
+export declare class LocalAgentHostAuthoritySession {
+    readonly role: LocalAgentHostAuthorityRole;
+    readonly descriptor: LocalAgentHostLeaseDescriptor;
+    readonly transport: LocalAgentHostRpcClientTransport;
+    private readonly server;
+    private readonly lease;
+    private readonly onAuthorityLost;
+    private heartbeatTimer;
+    private heartbeatPending;
+    private closed;
+    constructor(options: {
+        role: LocalAgentHostAuthorityRole;
+        descriptor: LocalAgentHostLeaseDescriptor;
+        transport: LocalAgentHostRpcClientTransport;
+        server?: ClosableAuthorityServer;
+        lease?: RenewableAuthorityLease;
+        heartbeatIntervalMs?: number;
+        onAuthorityLost?: (error: Error) => void;
+    });
+    close(): Promise<void>;
+    private heartbeat;
+}
+/**
+ * Elects the one local authority. Only the elected owner invokes
+ * createHostTransport; every other process attaches to its authenticated RPC
+ * endpoint, which prevents duplicate provider processes and split-brain state.
+ */
+/**
+ * Why a surface could not attach. The REASON, not a boolean.
+ *
+ * 🔴 A CLI needs to tell its user what to do next, and "could not connect"
+ * does not. "No host is running" means start the app; "protocol mismatch" means
+ * the two builds disagree and one needs updating; "unreachable" means a host
+ * claims to be there and is not answering, which is a different problem again.
+ * Collapsing them sends a person to fix the wrong thing.
+ */
+export type AttachLocalAgentHostRefusal = {
+    reason: 'no-host';
+    detail: string;
+} | {
+    reason: 'host-gone';
+    detail: string;
+} | {
+    reason: 'protocol-mismatch';
+    detail: string;
+    hostProtocol: number;
+    clientProtocol: number;
+} | {
+    reason: 'unreachable';
+    detail: string;
+};
+export type AttachLocalAgentHostResult = {
+    attached: true;
+    session: LocalAgentHostAuthoritySession;
+} | ({
+    attached: false;
+} & AttachLocalAgentHostRefusal);
+export interface AttachToLocalAgentHostOptions {
+    rootDirectory: string;
+    protocolVersion?: number;
+    connectTimeoutMs?: number;
+    requestTimeoutMs?: number;
+    /** Injected for tests; production reads the real clock and process table. */
+    now?: () => number;
+    staleAfterMs?: number;
+    isProcessAlive?: (pid: number) => boolean;
+}
+/**
+ * Attach to a host someone else owns — and NEVER become one.
+ *
+ * 🔴 This exists because `startLocalAgentHostAuthority` is acquire-or-attach,
+ * and for a surface that is the wrong shape in the most dangerous way: a CLI
+ * started while no app is running would WIN the lease and then be asked to
+ * build a host, which a thin client has no business owning. ADE §2.7 is
+ * explicit that `xeno-agent-cli` "becomes a client of the same per-user host";
+ * a client that can silently become the server is not that.
+ *
+ * 🔴 The defect is made UNREPRESENTABLE rather than documented: there is no
+ * `createHostTransport` parameter here, so there is nothing this function could
+ * construct even if it wanted to. It inspects, it connects, or it refuses with
+ * a reason.
+ */
+export declare function attachToLocalAgentHost(options: AttachToLocalAgentHostOptions): Promise<AttachLocalAgentHostResult>;
+export declare function connectBeforeDeadline(transport: LocalAgentHostRpcClientTransport, timeoutMs: number): Promise<void>;
+//# sourceMappingURL=attach.d.ts.map

package/dist/local/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../src/local/attach.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAIL,KAAK,6BAA6B,EACnC,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,gCAAgC,EAGjC,MAAM,gBAAgB,CAAA;AAEvB;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,uBAAuB;IAItC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9B;AAGD,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,iBAAiB,CAAA;AAErE,qBAAa,8BAA8B;IACzC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAA;IAC1C,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAA;IAClD,QAAQ,CAAC,SAAS,EAAE,gCAAgC,CAAA;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IACtE,OAAO,CAAC,cAAc,CAA4C;IAClE,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,MAAM,CAAQ;gBAEV,OAAO,EAAE;QACnB,IAAI,EAAE,2BAA2B,CAAA;QACjC,UAAU,EAAE,6BAA6B,CAAA;QACzC,SAAS,EAAE,gCAAgC,CAAA;QAC3C,MAAM,CAAC,EAAE,uBAAuB,CAAA;QAChC,KAAK,CAAC,EAAE,uBAAuB,CAAA;QAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAA;QAC5B,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;KACzC;IAaK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAYd,SAAS;CAaxB;AAED;;;;GAIG;AACH;;;;;;;;GAQG;AACH,MAAM,MAAM,2BAA2B,GACnC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC7F;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7C,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,8BAA8B,CAAA;CAAE,GAC3D,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAA;CAAE,GAAG,2BAA2B,CAAC,CAAA;AAEvD,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CAC1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,0BAA0B,CAAC,CAgFrC;AAGD,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,gCAAgC,EAC3C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAcf"}