@agentdeck/shared 0.1.0

package/dist/adapter.d.ts

@@ -0,0 +1,127 @@
+import { EventEmitter } from 'events';
+import type { Server } from 'http';
+import type { PluginCommand } from './protocol.js';
+export type AgentType = 'claude-code' | 'openclaw';
+export interface AgentCapabilities {
+    type: AgentType;
+    displayName: string;
+    /** PTY terminal attachment (stdin/stdout proxy) */
+    hasTerminal: boolean;
+    /** Plan/AcceptEdits/Default mode switching */
+    hasModeSwitching: boolean;
+    /** Diff review UI (view/apply/deny) */
+    hasDiffReview: boolean;
+    /** Numbered option lists with arrow navigation */
+    hasOptionLists: boolean;
+    /** Arrow-key navigable prompts */
+    hasNavigablePrompts: boolean;
+    /** Ghost text suggested prompts */
+    hasSuggestedPrompts: boolean;
+    /** OAuth-based API usage tracking */
+    hasApiUsage: boolean;
+    /** CLI-based model catalog (openclaw models list) */
+    hasModelCatalog: boolean;
+}
+export interface AdapterStartOptions {
+    /** Bridge port (injected as env var for hook scripts) */
+    port: number;
+    /** Command to spawn (e.g. 'claude') — only relevant for PTY-based agents */
+    command?: string;
+    /** Gateway WebSocket URL — only relevant for gateway-based agents (OpenClaw) */
+    gatewayUrl?: string;
+}
+/** Hook-sourced event (Claude Code HTTP hooks / OpenClaw WS events) */
+export interface AdapterHookEvent {
+    source: 'hook';
+    event: string;
+    data: Record<string, unknown>;
+}
+/** Parser-sourced event (PTY regex parsing / OpenClaw structured events) */
+export interface AdapterParserEvent {
+    source: 'parser';
+    event: string;
+    data?: Record<string, unknown>;
+}
+/** Metadata update (cursor, usage, user prompt, model catalog — no state transition) */
+export interface AdapterMetadataEvent {
+    source: 'metadata';
+    event: 'cursor_update' | 'usage_info' | 'user_prompt' | 'model_catalog';
+    data: Record<string, unknown>;
+}
+/** Activity signal — resets stuck timer */
+export interface AdapterActivityEvent {
+    source: 'activity';
+}
+/** Connection status change */
+export interface AdapterConnectionEvent {
+    source: 'connection';
+    status: 'connected' | 'disconnected';
+}
+export type AdapterEvent = AdapterHookEvent | AdapterParserEvent | AdapterMetadataEvent | AdapterActivityEvent | AdapterConnectionEvent;
+/**
+ * Agent adapter interface.
+ *
+ * **Command handling split**:
+ * - `handleCommand()` handles transport-only commands (interrupt, escape, switch_mode, respond)
+ *   where the adapter owns the full logic.
+ * - Commands needing StateMachine context (select_option, navigate_option, send_prompt)
+ *   are handled by the bridge, which calls `writeInput()` for the transport layer.
+ * - Bridge-only commands (voice, query_usage) are never passed to the adapter.
+ *
+ * **Phase 2 note**: For non-PTY agents (OpenClaw), `select_option` and `navigate_option`
+ * will move into `handleCommand()` since they map to RPC calls, not PTY escape sequences.
+ * The bridge will check `capabilities.hasNavigablePrompts` to decide the routing.
+ */
+export interface AgentAdapter extends EventEmitter {
+    readonly capabilities: AgentCapabilities;
+    /**
+     * Start the agent process/connection.
+     * Emits 'event' with AdapterEvent payloads.
+     */
+    start(options: AdapterStartOptions): Promise<void>;
+    /**
+     * Handle a command from the plugin.
+     * Returns true if the command was handled, false if not applicable.
+     */
+    handleCommand(cmd: PluginCommand): boolean;
+    /**
+     * Send raw text/keystrokes to the agent's input stream.
+     *
+     * For PTY agents (Claude Code): writes directly to PTY (may include escape sequences).
+     * For non-PTY agents: this is a low-level fallback. Prefer handleCommand() for
+     * structured commands; Phase 2 adapters should handle select_option/navigate_option
+     * in handleCommand() via RPC rather than relying on writeInput() escape sequences.
+     */
+    writeInput(data: string): void;
+    /** Whether the agent process/connection is alive */
+    isAlive(): boolean;
+    /** Attach user terminal to agent process (no-op for non-PTY agents) */
+    attachTerminal(stdin: NodeJS.ReadableStream, stdout: NodeJS.WritableStream): void;
+    /** Get the PTY tty path (undefined for non-PTY agents) */
+    getTtyPath(): string | undefined;
+    /** Get project name detected by the adapter */
+    getProjectName(): string | null;
+    /**
+     * Get the underlying HTTP server.
+     * Every adapter provides an HTTP server for WebSocket (plugin) attachment.
+     * PTY adapters reuse the hook server; non-PTY adapters create a bare server.
+     */
+    getHttpServer(): Server;
+    /** Prepare parser for navigation — suppress false idle from PTY cursor-move echo */
+    prepareForNavigation?(): void;
+    /** Register a diagnostic dump handler */
+    onDiag(handler: (tail?: number) => unknown): void;
+    /** Register a callback for raw agent output data (for ring buffer / journal diagnostics) */
+    onRawData(callback: (data: string) => void): void;
+    /** Graceful shutdown */
+    shutdown(): Promise<void>;
+}
+export interface AgentAdapterEvents {
+    event: (evt: AdapterEvent) => void;
+    exit: (code: number, signal: number) => void;
+}
+export declare const CLAUDE_CODE_CAPABILITIES: AgentCapabilities;
+export declare const OPENCLAW_CAPABILITIES: AgentCapabilities;
+/** Default OpenClaw Gateway port */
+export declare const OPENCLAW_GATEWAY_PORT = 18789;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

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

package/dist/adapter.js

@@ -0,0 +1,28 @@
+// ===== Agent Capabilities (constants) =====
+export const CLAUDE_CODE_CAPABILITIES = {
+    type: 'claude-code',
+    displayName: 'Claude Code',
+    hasTerminal: true,
+    hasModeSwitching: true,
+    hasDiffReview: true,
+    hasOptionLists: true,
+    hasNavigablePrompts: true,
+    hasSuggestedPrompts: true,
+    hasApiUsage: true,
+    hasModelCatalog: false,
+};
+export const OPENCLAW_CAPABILITIES = {
+    type: 'openclaw',
+    displayName: 'OpenClaw',
+    hasTerminal: false,
+    hasModeSwitching: false,
+    hasDiffReview: false,
+    hasOptionLists: true,
+    hasNavigablePrompts: false,
+    hasSuggestedPrompts: false,
+    hasApiUsage: false,
+    hasModelCatalog: true,
+};
+/** Default OpenClaw Gateway port */
+export const OPENCLAW_GATEWAY_PORT = 18789;
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAiKA,6CAA6C;AAE7C,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,IAAI;IACjB,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,IAAI;IACzB,mBAAmB,EAAE,IAAI;IACzB,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,UAAU;IACvB,WAAW,EAAE,KAAK;IAClB,gBAAgB,EAAE,KAAK;IACvB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,KAAK;IAC1B,mBAAmB,EAAE,KAAK;IAC1B,WAAW,EAAE,KAAK;IAClB,eAAe,EAAE,IAAI;CACtB,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './states.js';
+export * from './protocol.js';
+export * from './adapter.js';
+export * from './voice-paths.js';
+export * from './net-utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './states.js';
+export * from './protocol.js';
+export * from './adapter.js';
+export * from './voice-paths.js';
+export * from './net-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/net-utils.d.ts

@@ -0,0 +1,3 @@
+/** Return the first non-internal IPv4 LAN address, or '127.0.0.1' as fallback. */
+export declare function getLanIp(): string;
+//# sourceMappingURL=net-utils.d.ts.map

package/dist/net-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"net-utils.d.ts","sourceRoot":"","sources":["../src/net-utils.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,wBAAgB,QAAQ,IAAI,MAAM,CAQjC"}

package/dist/net-utils.js

@@ -0,0 +1,13 @@
+import { networkInterfaces } from 'os';
+/** Return the first non-internal IPv4 LAN address, or '127.0.0.1' as fallback. */
+export function getLanIp() {
+    const nets = networkInterfaces();
+    for (const name of Object.keys(nets)) {
+        for (const net of nets[name] ?? []) {
+            if (net.family === 'IPv4' && !net.internal)
+                return net.address;
+        }
+    }
+    return '127.0.0.1';
+}
+//# sourceMappingURL=net-utils.js.map

package/dist/net-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"net-utils.js","sourceRoot":"","sources":["../src/net-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAC;AAEvC,kFAAkF;AAClF,MAAM,UAAU,QAAQ;IACtB,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAAE,OAAO,GAAG,CAAC,OAAO,CAAC;QACjE,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,130 @@
+import { State, PermissionMode, PromptOption } from './states.js';
+import type { AgentType, AgentCapabilities } from './adapter.js';
+export type BillingType = 'subscription' | 'api' | 'unknown';
+export interface ModelCatalogEntry {
+    name: string;
+    role: 'default' | `fallback-${number}` | 'configured';
+    available: boolean;
+}
+export interface OcSessionStatus {
+    model?: string;
+    contextTokens?: number;
+    messageCount?: number;
+    uptime?: string;
+    sessionId?: string;
+    [key: string]: unknown;
+}
+export interface StateUpdateEvent {
+    type: 'state_update';
+    state: State;
+    permissionMode: PermissionMode;
+    agentType?: AgentType;
+    agentCapabilities?: AgentCapabilities;
+    currentTool?: string;
+    toolInput?: string;
+    toolProgress?: string;
+    projectName?: string;
+    modelName?: string;
+    billingType?: BillingType;
+    options?: PromptOption[];
+    promptType?: 'yes_no' | 'yes_no_always' | 'multi_select' | 'diff_review';
+    question?: string;
+    navigable?: boolean;
+    cursorIndex?: number;
+    suggestedPrompt?: string;
+    modelCatalog?: ModelCatalogEntry[];
+    sessionStatus?: OcSessionStatus;
+    remoteUrl?: string;
+    /** Authenticated WS URL for remote pairing (ws://ip:port?token=hex) */
+    pairingUrl?: string;
+}
+export interface PromptOptionsEvent {
+    type: 'prompt_options';
+    promptType: 'yes_no' | 'yes_no_always' | 'multi_select' | 'diff_review';
+    question?: string;
+    options: PromptOption[];
+}
+export interface UsageEvent {
+    type: 'usage_update';
+    sessionDurationSec: number;
+    inputTokens: number;
+    outputTokens: number;
+    toolCalls: number;
+    estimatedCostUsd?: number;
+    sessionPercent?: number;
+    costSpent?: number;
+    costLimit?: number;
+    resetTime?: string;
+    resetDate?: string;
+    fiveHourPercent?: number;
+    fiveHourResetsAt?: string;
+    sevenDayPercent?: number;
+    sevenDayResetsAt?: string;
+    extraUsageEnabled?: boolean;
+    extraUsageMonthlyLimit?: number;
+    extraUsageUsedCredits?: number;
+    extraUsageUtilization?: number;
+}
+export interface ConnectionEvent {
+    type: 'connection';
+    status: 'connected' | 'reconnecting' | 'disconnected';
+    sessionId?: string;
+}
+export interface UserPromptEvent {
+    type: 'user_prompt';
+    text: string;
+}
+export interface VoiceStateEvent {
+    type: 'voice_state';
+    state: 'idle' | 'recording' | 'transcribing' | 'error';
+    text?: string;
+    error?: string;
+}
+export type BridgeEvent = StateUpdateEvent | PromptOptionsEvent | UsageEvent | ConnectionEvent | UserPromptEvent | VoiceStateEvent;
+export interface ResponseCommand {
+    type: 'respond';
+    value: string;
+}
+export interface SelectOptionCommand {
+    type: 'select_option';
+    index: number;
+}
+export interface NavigateOptionCommand {
+    type: 'navigate_option';
+    direction: 'up' | 'down';
+}
+export interface SendPromptCommand {
+    type: 'send_prompt';
+    text: string;
+}
+export interface SwitchModeCommand {
+    type: 'switch_mode';
+    mode?: 'plan' | 'acceptEdits' | 'default';
+}
+export interface InterruptCommand {
+    type: 'interrupt';
+}
+export interface EscapeCommand {
+    type: 'escape';
+}
+export interface VoiceCommand {
+    type: 'voice';
+    action: 'start' | 'stop' | 'cancel';
+}
+export interface QueryUsageCommand {
+    type: 'query_usage';
+}
+export interface DiagCommand {
+    type: 'diag';
+    action: 'dump' | 'analyze';
+}
+export type PluginCommand = ResponseCommand | SelectOptionCommand | NavigateOptionCommand | SendPromptCommand | SwitchModeCommand | InterruptCommand | EscapeCommand | VoiceCommand | QueryUsageCommand | DiagCommand;
+export interface HookEvent {
+    event: string;
+    data: Record<string, unknown>;
+}
+export declare const BRIDGE_WS_PORT = 9120;
+export declare const BRIDGE_HTTP_PORT = 9120;
+export declare const RECONNECT_INTERVAL_MS = 3000;
+export declare const STUCK_TIMEOUT_MS: number;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,6 @@
+// ===== Constants =====
+export const BRIDGE_WS_PORT = 9120;
+export const BRIDGE_HTTP_PORT = 9120; // Same port, different path
+export const RECONNECT_INTERVAL_MS = 3000;
+export const STUCK_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAmLA,wBAAwB;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,CAAC,4BAA4B;AAClE,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY"}

package/dist/states.d.ts

@@ -0,0 +1,57 @@
+export declare enum State {
+    DISCONNECTED = "disconnected",
+    IDLE = "idle",
+    PROCESSING = "processing",
+    AWAITING_PERMISSION = "awaiting_permission",
+    AWAITING_OPTION = "awaiting_option",
+    AWAITING_DIFF = "awaiting_diff"
+}
+export declare enum PermissionMode {
+    DEFAULT = "default",
+    PLAN = "plan",
+    ACCEPT_EDITS = "acceptEdits",
+    DONT_ASK = "dontAsk",
+    BYPASS_PERMISSIONS = "bypassPermissions"
+}
+export type TransitionSource = 'hook' | 'pty' | 'user' | 'internal';
+export interface StateTransition {
+    from: State | '*';
+    to: State;
+    trigger: string;
+    source: TransitionSource;
+}
+export declare const transitions: StateTransition[];
+export interface PromptOption {
+    index: number;
+    label: string;
+    shortcut?: string;
+    recommended?: boolean;
+    selected?: boolean;
+}
+export interface StateSnapshot {
+    state: State;
+    permissionMode: PermissionMode;
+    currentTool: string | null;
+    toolInput: string | null;
+    toolProgress: string | null;
+    options: PromptOption[];
+    question: string | null;
+    navigable: boolean;
+    cursorIndex: number;
+    projectName: string | null;
+    modelName: string | null;
+    billingType: import('./protocol.js').BillingType;
+    sessionDurationSec: number;
+    inputTokens: number;
+    outputTokens: number;
+    toolCalls: number;
+    estimatedCostUsd: number | null;
+    sessionPercent: number | null;
+    costSpent: number | null;
+    costLimit: number | null;
+    resetTime: string | null;
+    resetDate: string | null;
+    suggestedPrompt: string | null;
+    remoteUrl: string | null;
+}
+//# sourceMappingURL=states.d.ts.map

package/dist/states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../src/states.ts"],"names":[],"mappings":"AAAA,oBAAY,KAAK;IACf,YAAY,iBAAiB;IAC7B,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,mBAAmB,wBAAwB;IAC3C,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;CAChC;AAED,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,YAAY,gBAAgB;IAC5B,QAAQ,YAAY;IACpB,kBAAkB,sBAAsB;CACzC;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,GAAG,GAAG,CAAC;IAClB,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,eAAO,MAAM,WAAW,EAAE,eAAe,EA4BxC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,OAAO,eAAe,EAAE,WAAW,CAAC;IACjD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/states.js

@@ -0,0 +1,47 @@
+export var State;
+(function (State) {
+    State["DISCONNECTED"] = "disconnected";
+    State["IDLE"] = "idle";
+    State["PROCESSING"] = "processing";
+    State["AWAITING_PERMISSION"] = "awaiting_permission";
+    State["AWAITING_OPTION"] = "awaiting_option";
+    State["AWAITING_DIFF"] = "awaiting_diff";
+})(State || (State = {}));
+export var PermissionMode;
+(function (PermissionMode) {
+    PermissionMode["DEFAULT"] = "default";
+    PermissionMode["PLAN"] = "plan";
+    PermissionMode["ACCEPT_EDITS"] = "acceptEdits";
+    PermissionMode["DONT_ASK"] = "dontAsk";
+    PermissionMode["BYPASS_PERMISSIONS"] = "bypassPermissions";
+})(PermissionMode || (PermissionMode = {}));
+export const transitions = [
+    { from: State.DISCONNECTED, to: State.IDLE, trigger: 'session_start', source: 'hook' },
+    { from: State.IDLE, to: State.PROCESSING, trigger: 'user_prompt_submit', source: 'hook' },
+    { from: State.IDLE, to: State.PROCESSING, trigger: 'spinner_start', source: 'pty' },
+    { from: State.PROCESSING, to: State.IDLE, trigger: 'stop', source: 'hook' },
+    { from: State.PROCESSING, to: State.IDLE, trigger: 'idle_detected', source: 'pty' },
+    { from: State.AWAITING_PERMISSION, to: State.IDLE, trigger: 'idle_detected', source: 'pty' },
+    { from: State.AWAITING_OPTION, to: State.IDLE, trigger: 'idle_detected', source: 'pty' },
+    { from: State.AWAITING_DIFF, to: State.IDLE, trigger: 'idle_detected', source: 'pty' },
+    { from: State.PROCESSING, to: State.AWAITING_PERMISSION, trigger: 'permission_prompt', source: 'pty' },
+    { from: State.IDLE, to: State.AWAITING_PERMISSION, trigger: 'permission_prompt', source: 'pty' },
+    { from: State.PROCESSING, to: State.AWAITING_OPTION, trigger: 'option_ui_detected', source: 'pty' },
+    { from: State.IDLE, to: State.AWAITING_OPTION, trigger: 'option_ui_detected', source: 'pty' },
+    { from: State.PROCESSING, to: State.AWAITING_DIFF, trigger: 'diff_ui_detected', source: 'pty' },
+    { from: State.IDLE, to: State.AWAITING_DIFF, trigger: 'diff_ui_detected', source: 'pty' },
+    { from: State.AWAITING_PERMISSION, to: State.PROCESSING, trigger: 'user_response', source: 'user' },
+    { from: State.AWAITING_PERMISSION, to: State.PROCESSING, trigger: 'user_selection', source: 'user' },
+    { from: State.AWAITING_OPTION, to: State.PROCESSING, trigger: 'user_selection', source: 'user' },
+    { from: State.AWAITING_DIFF, to: State.PROCESSING, trigger: 'user_response', source: 'user' },
+    { from: State.AWAITING_DIFF, to: State.PROCESSING, trigger: 'user_selection', source: 'user' },
+    // Recovery: spinner_start from awaiting states (user responded via keyboard, not Stream Deck)
+    { from: State.AWAITING_PERMISSION, to: State.PROCESSING, trigger: 'spinner_start', source: 'pty' },
+    { from: State.AWAITING_OPTION, to: State.PROCESSING, trigger: 'spinner_start', source: 'pty' },
+    { from: State.AWAITING_DIFF, to: State.PROCESSING, trigger: 'spinner_start', source: 'pty' },
+    // stuck_timeout only for PROCESSING — AWAITING_* wait indefinitely for user response
+    { from: State.PROCESSING, to: State.IDLE, trigger: 'stuck_timeout', source: 'internal' },
+    { from: '*', to: State.DISCONNECTED, trigger: 'session_end', source: 'hook' },
+    { from: '*', to: State.IDLE, trigger: 'interrupt', source: 'user' },
+];
+//# sourceMappingURL=states.js.map

package/dist/states.js.map

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

package/dist/voice-paths.d.ts

@@ -0,0 +1,20 @@
+export declare const MODEL_SEARCH_DIRS: string[];
+export declare const MODELS_WITH_METAL: string[];
+export declare const MODELS_WITHOUT_METAL: string[];
+export declare const WHISPER_CANDIDATES: string[];
+export declare const REC_CANDIDATES: string[];
+export declare const SOX_CANDIDATES: string[];
+export declare const WHISPER_SERVER_CANDIDATES: string[];
+/** Whisper-server discovery info file path */
+export declare const WHISPER_SERVER_INFO_FILE: string;
+/** OpenClaw binary candidates */
+export declare const OPENCLAW_CANDIDATES: string[];
+/** Resolve `openclaw` binary: try known candidate paths, fallback to bare name on PATH. */
+export declare function resolveOpenClawBin(): string;
+/**
+ * Augmented PATH for CLI child processes — ensures binaries installed via
+ * Homebrew, pip --user, etc. are discoverable even when the parent process
+ * (e.g. Stream Deck SDK) has a minimal PATH.
+ */
+export declare function augmentedPath(): string;
+//# sourceMappingURL=voice-paths.d.ts.map

package/dist/voice-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-paths.d.ts","sourceRoot":"","sources":["../src/voice-paths.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,iBAAiB,UAK7B,CAAC;AAGF,eAAO,MAAM,iBAAiB,UAI7B,CAAC;AACF,eAAO,MAAM,oBAAoB,UAGhC,CAAC;AAGF,eAAO,MAAM,kBAAkB,UAG9B,CAAC;AACF,eAAO,MAAM,cAAc,UAG1B,CAAC;AACF,eAAO,MAAM,cAAc,UAG1B,CAAC;AACF,eAAO,MAAM,yBAAyB,UAGrC,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,QAAuD,CAAC;AAE7F,iCAAiC;AACjC,eAAO,MAAM,mBAAmB,UAU/B,CAAC;AAEF,2FAA2F;AAC3F,wBAAgB,kBAAkB,IAAI,MAAM,CAK3C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAatC"}

package/dist/voice-paths.js

@@ -0,0 +1,81 @@
+/**
+ * Voice binary/model path constants shared between bridge and plugin.
+ */
+import { join } from 'path';
+import { homedir } from 'os';
+import { existsSync } from 'fs';
+export const MODEL_SEARCH_DIRS = [
+    join(homedir(), '.local/share/whisper-cpp'),
+    '/opt/homebrew/share/whisper-cpp', // arm64 Homebrew
+    '/usr/local/share/whisper-cpp', // x86 Homebrew
+    join(homedir(), 'models'),
+];
+// Model tiers: Metal-accelerated GPU can handle large models; CPU/Rosetta cannot
+export const MODELS_WITH_METAL = [
+    'ggml-large-v3-turbo.bin',
+    'ggml-small.bin',
+    'ggml-base.bin',
+];
+export const MODELS_WITHOUT_METAL = [
+    'ggml-base.bin',
+    'ggml-small.bin',
+];
+// Preferred binary paths: arm64 Homebrew first, then system PATH
+export const WHISPER_CANDIDATES = [
+    '/opt/homebrew/bin/whisper-cli',
+    '/usr/local/bin/whisper-cli',
+];
+export const REC_CANDIDATES = [
+    '/opt/homebrew/bin/rec',
+    '/usr/local/bin/rec',
+];
+export const SOX_CANDIDATES = [
+    '/opt/homebrew/bin/sox',
+    '/usr/local/bin/sox',
+];
+export const WHISPER_SERVER_CANDIDATES = [
+    '/opt/homebrew/bin/whisper-server',
+    '/usr/local/bin/whisper-server',
+];
+/** Whisper-server discovery info file path */
+export const WHISPER_SERVER_INFO_FILE = join(homedir(), '.agentdeck', 'whisper-server.json');
+/** OpenClaw binary candidates */
+export const OPENCLAW_CANDIDATES = [
+    '/opt/homebrew/bin/openclaw',
+    '/usr/local/bin/openclaw',
+    join(homedir(), 'Library', 'pnpm', 'openclaw'), // macOS pnpm global bin
+    join(homedir(), 'Library', 'pnpm', 'nodejs_current', 'bin', 'openclaw'), // pnpm node bin
+    join(homedir(), '.local/bin/openclaw'),
+    join(homedir(), '.cargo/bin/openclaw'),
+    join(homedir(), 'go/bin/openclaw'),
+    join(homedir(), '.openclaw/bin/openclaw'),
+    join(homedir(), '.bun/bin/openclaw'),
+];
+/** Resolve `openclaw` binary: try known candidate paths, fallback to bare name on PATH. */
+export function resolveOpenClawBin() {
+    for (const candidate of OPENCLAW_CANDIDATES) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return 'openclaw';
+}
+/**
+ * Augmented PATH for CLI child processes — ensures binaries installed via
+ * Homebrew, pip --user, etc. are discoverable even when the parent process
+ * (e.g. Stream Deck SDK) has a minimal PATH.
+ */
+export function augmentedPath() {
+    const extra = [
+        '/opt/homebrew/bin',
+        '/usr/local/bin',
+        join(homedir(), 'Library', 'pnpm'), // macOS pnpm global bin
+        join(homedir(), '.local/bin'),
+        join(homedir(), '.cargo/bin'),
+        join(homedir(), 'go/bin'),
+        join(homedir(), '.openclaw/bin'),
+        join(homedir(), '.bun/bin'),
+    ];
+    const existing = process.env.PATH ?? '/usr/bin:/bin';
+    return [...extra, existing].join(':');
+}
+//# sourceMappingURL=voice-paths.js.map

package/dist/voice-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-paths.js","sourceRoot":"","sources":["../src/voice-paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,CAAC,OAAO,EAAE,EAAE,0BAA0B,CAAC;IAC3C,iCAAiC,EAAI,iBAAiB;IACtD,8BAA8B,EAAO,eAAe;IACpD,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC;CAC1B,CAAC;AAEF,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,yBAAyB;IACzB,gBAAgB;IAChB,eAAe;CAChB,CAAC;AACF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,eAAe;IACf,gBAAgB;CACjB,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,+BAA+B;IAC/B,4BAA4B;CAC7B,CAAC;AACF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,uBAAuB;IACvB,oBAAoB;CACrB,CAAC;AACF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,uBAAuB;IACvB,oBAAoB;CACrB,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,kCAAkC;IAClC,+BAA+B;CAChC,CAAC;AAEF,8CAA8C;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,qBAAqB,CAAC,CAAC;AAE7F,iCAAiC;AACjC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,4BAA4B;IAC5B,yBAAyB;IACzB,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAyB,wBAAwB;IAC/F,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,gBAAgB;IACzF,IAAI,CAAC,OAAO,EAAE,EAAE,qBAAqB,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,EAAE,qBAAqB,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC;IAClC,IAAI,CAAC,OAAO,EAAE,EAAE,wBAAwB,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,EAAE,mBAAmB,CAAC;CACrC,CAAC;AAEF,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB;IAChC,KAAK,MAAM,SAAS,IAAI,mBAAmB,EAAE,CAAC;QAC5C,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAC9C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAG;QACZ,mBAAmB;QACnB,gBAAgB;QAChB,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAG,wBAAwB;QAC7D,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC;KAC5B,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,eAAe,CAAC;IACrD,OAAO,CAAC,GAAG,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@agentdeck/shared",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/puritysb/AgentDeck.git",
+    "directory": "shared"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js"
+    },
+    "./states": {
+      "types": "./dist/states.d.ts",
+      "import": "./dist/states.js"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc --noEmit"
+  }
+}