@clinebot/core 0.0.35 → 0.0.37

package/dist/hooks/hook-bridge.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Bridges the flat `AgentRuntimeHooks` bag consumed by the
+ * new `AgentRuntime` and the legacy 15-stage `HookEngine` + `AgentHooks`
+ * + `AgentExtension[]` surface that `@clinebot/core` already speaks.
+ *
+ * @see PLAN.md §3.1   — replaces `packages/agents/src/runtime/lifecycle-orchestrator.ts`.
+ * @see PLAN.md §3.2.3 — public surface of `HookBridge`.
+ * @see PLAN.md §3.3.1 — OLD `HookStage` → NEW runtime primitive mapping.
+ * @see PLAN.md §3.3.3 — OLD `config.hooks.*` → NEW placement.
+ *
+ * -------------------------------------------------------------------------
+ * Responsibilities
+ * -------------------------------------------------------------------------
+ *
+ *  1. **Register** the legacy `AgentHooks` + `AgentExtension[]` on the
+ *     `HookEngine` once at construction (via `registerLifecycleHandlers`
+ *     — moved verbatim from the old agents package).
+ *  2. **Synthesize** an `AgentRuntimeHooks` bag via `toRuntimeHooks()`.
+ *     Each runtime hook dispatches to the `HookEngine`'s
+ *     corresponding stage (or stages, e.g. `beforeModel` fires both
+ *     `turn_start` **and** `before_agent_start` per §3.3.1).
+ *  3. **Forward** `AgentRuntimeEvent`s via `onEvent` (part of the
+ *     runtime-hooks bag) into the engine's `runtime_event` stage — and
+ *     synthesize the stages that have no direct new-runtime primitive
+ *     (`iteration_start`, `iteration_end`, `error`, per §3.3.2).
+ *  4. **Expose** imperative `dispatch(source, input)` for
+ *     `SessionRuntime` to fire the *non*-runtime stages that live on
+ *     the session boundary: `session_start`, `session_shutdown`,
+ *     `input`, `run_end`, and `stop_error` (the bridge synthesizes
+ *     these from session-level events, not from the new runtime's hooks).
+ *  5. **Apply** hook-returned `control.context` by invoking
+ *     `onHookContext(source, context)` so the caller (facade or
+ *     session-runtime) can append `<hook_context source="…">…` user
+ *     messages to the conversation (legacy behavior at
+ *     `packages/agents/src/agent.ts:1402-1421`).
+ *
+ * This is the **non-Step-8a** half of the core runtime port: it wires
+ * the existing hook ecosystem to the new runtime without changing
+ * either side's semantics.
+ */
+import type { AgentExtension, AgentHookControl, AgentHooks, AgentRuntimeEvent, AgentRuntimeHooks, HookDispatchInput, HookEngine } from "@clinebot/shared";
+export interface HookBridgeOptions {
+    readonly agentId: string;
+    readonly agentRole?: string;
+    readonly conversationId: string;
+    readonly parentAgentId: string | null;
+    readonly hookEngine: HookEngine;
+    /** Legacy flat `AgentHooks` bag — registered on the engine. */
+    readonly hooks?: AgentHooks;
+    /** Legacy `AgentExtension[]` — their `on*` callbacks are registered. */
+    readonly extensions?: readonly AgentExtension[];
+    /** Supplies the currently-active run id (stable for the duration of one run). */
+    readonly getRunId: () => string;
+    /** Called when any dispatched hook returns `control.context`. */
+    readonly onHookContext?: (source: string, context: string) => void;
+    /** Called when a dispatch throws. */
+    readonly onDispatchError?: (error: unknown) => void;
+}
+type ImperativeDispatchInput = Pick<HookDispatchInput, "stage" | "payload" | "iteration" | "parentEventId">;
+export declare class HookBridge {
+    private readonly options;
+    constructor(options: HookBridgeOptions);
+    /**
+     * Dispatch a lifecycle stage imperatively. `SessionRuntime` calls
+     * this at `session_start`, `session_shutdown`, `input`, `run_end`, and
+     * `stop_error` — stages that do not map cleanly onto the
+     * `AgentRuntime` hooks (§3.3.1).
+     *
+     * Returns the merged `AgentHookControl` from the dispatched
+     * handlers, or `undefined` if nothing ran. Context propagation
+     * (`control.context` → `onHookContext(source, …)`) is applied
+     * inline.
+     */
+    dispatch(source: string, input: ImperativeDispatchInput): Promise<AgentHookControl | undefined>;
+    /**
+     * Fire the `runtime_event` stage for a single `AgentRuntimeEvent`.
+     * Non-blocking: errors route through `onDispatchError`. Exposed
+     * for callers who already hold the event (e.g. the legacy facade's
+     * subscribeEvents adapter).
+     */
+    dispatchRuntimeEvent(event: AgentRuntimeEvent): void;
+    shutdown(timeoutMs?: number): Promise<void>;
+    /**
+     * Build the `AgentRuntimeHooks` bag consumed by
+     * `AgentRuntime`. Each synthesized callback:
+     *
+     *  - invokes `hookEngine.dispatch(stage, payload)` for the
+     *    corresponding legacy stage(s) (§3.3.1);
+     *  - merges the returned `AgentHookControl` into the runtime-hook's
+     *    return shape (`AgentStopControl` / `AgentBeforeModelResult` /
+     *    `AgentBeforeToolResult` / `AgentAfterToolResult`) per §3.3.3;
+     *  - applies `control.context` via `onHookContext(source, …)` so
+     *    the caller can append `<hook_context>` user messages.
+     *
+     * Legacy stages that have no direct new-runtime primitive
+     * (`iteration_start`, `iteration_end`, `error`) are synthesized
+     * inside `onEvent` from the corresponding `AgentRuntimeEvent`
+     * variants (§3.3.2).
+     */
+    toRuntimeHooks(): AgentRuntimeHooks;
+    /**
+     * Handle a single `AgentRuntimeEvent`. Always forwards it to the
+     * engine's `runtime_event` stage (§3.3.1 last row). Additionally
+     * synthesizes the three legacy stages that have no direct
+     * new-runtime primitive (§3.3.1):
+     *
+     *   turn-started  → also fires `iteration_start`
+     *   turn-finished → also fires `iteration_end`
+     *   run-failed    → also fires `error`
+     *
+     * This method is public so `SessionRuntime` can call it when it
+     * holds the event directly; the runtime-hooks bag's `onEvent` also
+     * routes through here.
+     */
+    onRuntimeEvent(event: AgentRuntimeEvent): Promise<void>;
+}
+export {};
+//# sourceMappingURL=hook-bridge.d.ts.map

package/dist/hooks/hook-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-bridge.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EAEjB,iBAAiB,EACjB,UAAU,EACV,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC;IAChC,iEAAiE;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,qCAAqC;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,KAAK,uBAAuB,GAAG,IAAI,CAClC,iBAAiB,EACjB,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,CACnD,CAAC;AAEF,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,OAAO,EAAE,iBAAiB;IAetC;;;;;;;;;;OAUG;IACG,QAAQ,CACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,GAC5B,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAmBxC;;;;;OAKG;IACH,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAY9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,IAAI,iBAAiB;IAuHnC;;;;;;;;;;;;;OAaG;IACG,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAgE7D"}

package/dist/hooks/hook-file-hooks.d.ts

@@ -1,15 +1,19 @@
-import type { AgentHooks } from "@clinebot/agents";
-import { type BasicLogger } from "@clinebot/shared";
+import type { AgentHooks } from "@clinebot/shared";
+import { type BasicLogger, type WorkspaceInfo } from "@clinebot/shared";
 type HookRuntimeOptions = {
     cwd: string;
     workspacePath: string;
     rootSessionId?: string;
     logger?: BasicLogger;
     toolCallTimeoutMs?: number;
+    /** Structured git + path metadata forwarded into every hook payload. */
+    workspaceInfo?: WorkspaceInfo;
 };
+export declare function getWindowsPythonFallbackCommand(command: string[], platform?: NodeJS.Platform, error?: unknown): string[] | undefined;
 export declare function createHookAuditHooks(options: {
     rootSessionId?: string;
     workspacePath: string;
+    workspaceInfo?: WorkspaceInfo;
 }): AgentHooks;
 export declare function createHookConfigFileHooks(options: HookRuntimeOptions): AgentHooks | undefined;
 export declare function mergeAgentHooks(layers: Array<AgentHooks | undefined>): AgentHooks | undefined;

package/dist/hooks/hook-file-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-file-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-file-hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAEN,KAAK,WAAW,EAGhB,MAAM,kBAAkB,CAAC;AAiC1B,KAAK,kBAAkB,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAmcF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACtB,GAAG,UAAU,CA+Gb;AAED,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,kBAAkB,GACzB,UAAU,GAAG,SAAS,CA6MxB;AAyBD,wBAAgB,eAAe,CAC9B,MAAM,EAAE,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC,GACnC,UAAU,GAAG,SAAS,CAuBxB"}
+{"version":3,"file":"hook-file-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-file-hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAEN,KAAK,WAAW,EAEhB,KAAK,aAAa,EAElB,MAAM,kBAAkB,CAAC;AAiC1B,KAAK,kBAAkB,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B,CAAC;AAyVF,wBAAgB,+BAA+B,CAC9C,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,kBAAmB,EAC3B,KAAK,CAAC,EAAE,OAAO,GACb,MAAM,EAAE,GAAG,SAAS,CAQtB;AAsJD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B,GAAG,UAAU,CAgHb;AAED,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,kBAAkB,GACzB,UAAU,GAAG,SAAS,CA6MxB;AAyBD,wBAAgB,eAAe,CAC9B,MAAM,EAAE,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC,GACnC,UAAU,GAAG,SAAS,CAuBxB"}

package/dist/hooks/hook-registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Lifecycle-hook registration wiring for the legacy `AgentHooks` and
+ * `AgentExtension` surfaces onto a `HookEngine`.
+ *
+ * @see PLAN.md §3.1 — moved from `packages/agents/src/runtime/hook-registry.ts`.
+ * @see PLAN.md §3.3.3 — OLD `config.hooks.*` → NEW placement.
+ *
+ * Verbatim port: pure wiring with no state. After the migration this is
+ * invoked by `HookBridge` and the legacy-agent facade's `addTools`
+ * pathway. Lives under `packages/core/src/hooks/` per §3.1.
+ */
+import type { AgentConfig, HookEngine } from "@clinebot/shared";
+type LifecycleConfig = Pick<AgentConfig, "hooks" | "extensions">;
+export declare function registerLifecycleHandlers(hookEngine: HookEngine, config: LifecycleConfig): void;
+export {};
+//# sourceMappingURL=hook-registry.d.ts.map

package/dist/hooks/hook-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-registry.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACX,WAAW,EAIX,UAAU,EAEV,MAAM,kBAAkB,CAAC;AAE1B,KAAK,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC;AAyHjE,wBAAgB,yBAAyB,CACxC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,eAAe,GACrB,IAAI,CA+GN"}

package/dist/hooks/index.d.ts

@@ -1,4 +1,3 @@
-export { createPersistentSubprocessHooks, PersistentHookClient, type PersistentHookClientOptions, type PersistentSubprocessHookControl, type PersistentSubprocessHooksOptions, } from "./persistent";
 export { createSubprocessHooks, type HookEventName, HookEventNameSchema, type HookEventPayload, HookEventPayloadSchema, parseHookEventPayload, type RunHookOptions, type RunHookResult, runHook, type SubprocessHookControl, type SubprocessHooksOptions, } from "./subprocess";
 export { type RunSubprocessEventOptions, type RunSubprocessEventResult, runSubprocessEvent, } from "./subprocess-runner";
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,+BAA+B,EAC/B,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,GACrC,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,qBAAqB,EACrB,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,kBAAkB,GAClB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,qBAAqB,EACrB,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,kBAAkB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/hooks/subprocess.d.ts

@@ -1,4 +1,4 @@
-import { type AgentAbortHookPayload, type AgentEndHookPayload, type AgentErrorHookPayload, type AgentHooks, type AgentResumeHookPayload, type AgentStartHookPayload, type HookEventName, HookEventNameSchema, type HookEventPayload, type HookEventPayloadBase, HookEventPayloadSchema, type HookSessionContextProvider, type PostToolUseData, type PreCompactData, type PreCompactHookPayload, type PreToolUseData, type PromptSubmitHookPayload, parseHookEventPayload, type SessionShutdownHookPayload, type TaskCancelData, type TaskCompleteData, type TaskResumeData, type TaskStartData, type ToolCallHookPayload, type ToolResultHookPayload, type UserPromptSubmitData } from "@clinebot/shared";
+import { type AgentAbortHookPayload, type AgentEndHookPayload, type AgentErrorHookPayload, type AgentHooks, type AgentResumeHookPayload, type AgentStartHookPayload, type HookEventName, HookEventNameSchema, type HookEventPayload, type HookEventPayloadBase, HookEventPayloadSchema, type HookSessionContextProvider, type PostToolUseData, type PreCompactData, type PreCompactHookPayload, type PreToolUseData, type PromptSubmitHookPayload, parseHookEventPayload, type SessionShutdownHookPayload, type TaskCancelData, type TaskCompleteData, type TaskResumeData, type TaskStartData, type ToolCallHookPayload, type ToolResultHookPayload, type UserPromptSubmitData, type WorkspaceInfo } from "@clinebot/shared";
 import { z } from "zod";
 import { type RunSubprocessEventResult } from "./subprocess-runner";
 export interface HookOutput {
@@ -34,6 +34,13 @@ export declare function runHook(payload: HookEventPayload, options?: RunHookOpti
 export interface SubprocessHooksOptions {
     command?: string[];
     cwd?: string;
+    /**
+     * Structured workspace and git metadata forwarded into every hook payload
+     * as `workspaceInfo`. Obtained from `generateWorkspaceInfo` at session
+     * startup and passed here so hook scripts can inspect branch, commit, and
+     * remote without running their own `git` commands.
+     */
+    workspaceInfo?: WorkspaceInfo;
     env?: NodeJS.ProcessEnv;
     timeoutMs?: number;
     onDispatchError?: (error: Error, payload: HookEventPayload) => void;

package/dist/hooks/subprocess.d.ts.map

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

package/dist/hub/browser-websocket.d.ts

@@ -0,0 +1,18 @@
+import type { HubCommandTransport } from "./transport";
+export interface BrowserHubSocketLike {
+    send(data: string): void;
+    addEventListener(type: "message", listener: (event: {
+        data: string;
+    }) => void): void;
+    addEventListener(type: "close", listener: () => void): void;
+    removeEventListener(type: "message", listener: (event: {
+        data: string;
+    }) => void): void;
+    removeEventListener(type: "close", listener: () => void): void;
+}
+export declare class BrowserWebSocketHubAdapter {
+    private readonly transport;
+    constructor(transport: HubCommandTransport);
+    attach(socket: BrowserHubSocketLike): () => void;
+}
+//# sourceMappingURL=browser-websocket.d.ts.map

package/dist/hub/browser-websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-websocket.d.ts","sourceRoot":"","sources":["../../src/hub/browser-websocket.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,CACf,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GACzC,IAAI,CAAC;IACR,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC5D,mBAAmB,CAClB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GACzC,IAAI,CAAC;IACR,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC/D;AAED,qBAAa,0BAA0B;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,mBAAmB;IAE3D,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,IAAI;CAoIhD"}

package/dist/hub/client.d.ts

@@ -0,0 +1,51 @@
+import { type HubCommandEnvelope, type HubEventEnvelope, type HubReplyEnvelope } from "@clinebot/shared";
+export interface HubClientOptions {
+    url: string;
+    clientId?: string;
+    clientType?: string;
+    displayName?: string;
+    workspaceRoot?: string;
+    cwd?: string;
+    authToken?: string;
+}
+export interface LocalHubResolutionOptions {
+    endpoint?: string;
+    strategy?: "prefer-hub" | "require-hub";
+    workspaceRoot?: string;
+    cwd?: string;
+}
+export declare class NodeHubClient {
+    private readonly options;
+    private socket;
+    private connectPromise;
+    private readonly clientId;
+    private readonly pendingReplies;
+    private readonly listeners;
+    private readonly subscriptionCounts;
+    private lastCloseMessage;
+    private registered;
+    constructor(options: HubClientOptions);
+    getClientId(): string;
+    connect(): Promise<void>;
+    subscribe(listener: (event: HubEventEnvelope) => void, options?: {
+        sessionId?: string;
+    }): () => void;
+    command(command: HubCommandEnvelope["command"], payload?: Record<string, unknown>, sessionId?: string, options?: {
+        timeoutMs?: number | null;
+    }): Promise<HubReplyEnvelope>;
+    close(): void;
+    dispose(): Promise<void>;
+    private sendFrame;
+    private sendSubscriptionFrame;
+    private adjustSubscriptionCount;
+    private subscriptionKeyForSessionId;
+    private subscriptionSessionIdFromKey;
+    private handleFrame;
+}
+export declare function normalizeHubWebSocketUrl(url: string): string;
+export declare function verifyHubConnection(url: string, options?: Pick<HubClientOptions, "workspaceRoot" | "cwd">): Promise<boolean>;
+export declare function resolveCompatibleLocalHubUrl(options?: LocalHubResolutionOptions): Promise<string | undefined>;
+export declare function ensureCompatibleLocalHubUrl(options?: LocalHubResolutionOptions): Promise<string | undefined>;
+export declare function requestHubShutdown(url: string): Promise<boolean>;
+export declare function stopLocalHubServerGracefully(): Promise<boolean>;
+//# sourceMappingURL=client.d.ts.map

package/dist/hub/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/hub/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAErB,MAAM,kBAAkB,CAAC;AAoH1B,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAQD,qBAAa,aAAa;IAUb,OAAO,CAAC,QAAQ,CAAC,OAAO;IATpC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAChE,OAAO,CAAC,gBAAgB,CAA2B;IACnD,OAAO,CAAC,UAAU,CAAS;gBAEE,OAAO,EAAE,gBAAgB;IAMtD,WAAW,IAAI,MAAM;IAIf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmG9B,SAAS,CACR,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,EAC3C,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9B,MAAM,IAAI;IAaP,OAAO,CACZ,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,EACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GACrC,OAAO,CAAC,gBAAgB,CAAC;IAqD5B,KAAK,IAAI,IAAI;IAoBP,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,uBAAuB;IAmB/B,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,4BAA4B;IAIpC,OAAO,CAAC,WAAW;CAgCnB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED,wBAAsB,mBAAmB,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,GAAG,KAAK,CAAC,GACvD,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAyED,wBAAsB,4BAA4B,CACjD,OAAO,GAAE,yBAA8B,GACrC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmB7B;AAED,wBAAsB,2BAA2B,CAChD,OAAO,GAAE,yBAA8B,GACrC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiB7B;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYtE;AAED,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,OAAO,CAAC,CAerE"}

package/dist/hub/connect.d.ts

@@ -0,0 +1,15 @@
+import type { HubCommandEnvelope, HubReplyEnvelope } from "@clinebot/shared";
+import { type HubEndpointOverrides } from "./defaults";
+export interface HubConnection {
+    send(envelope: HubCommandEnvelope): Promise<HubReplyEnvelope>;
+    close(): void;
+}
+export interface HubCommandRequest extends Omit<HubCommandEnvelope, "version" | "clientId"> {
+    version?: HubCommandEnvelope["version"];
+    clientId?: string;
+}
+export declare function resolveHubUrl(overrides?: HubEndpointOverrides): Promise<string>;
+export declare function connectToHub(url: string): Promise<HubConnection>;
+export declare function probeHubConnection(url: string): Promise<boolean>;
+export declare function sendHubCommand(overrides: HubEndpointOverrides, envelope: HubCommandRequest): Promise<HubReplyEnvelope>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/hub/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/hub/connect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,kBAAkB,EAClB,gBAAgB,EAEhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,KAAK,oBAAoB,EAEzB,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9D,KAAK,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,iBAChB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,UAAU,CAAC;IACxD,OAAO,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAqCD,wBAAsB,aAAa,CAClC,SAAS,GAAE,oBAAyB,GAClC,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAqDtE;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQtE;AAED,wBAAsB,cAAc,CACnC,SAAS,EAAE,oBAAoB,EAC/B,QAAQ,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAY3B"}

package/dist/hub/daemon-entry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=daemon-entry.d.ts.map

package/dist/hub/daemon-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-entry.d.ts","sourceRoot":"","sources":["../../src/hub/daemon-entry.ts"],"names":[],"mappings":""}