@agentdeck/bridge 0.1.0 → 0.2.1

package/dist/adapters/pty-adapter.js

@@ -0,0 +1,143 @@
+import { EventEmitter } from 'events';
+import { PtyManager } from '../pty-manager.js';
+import { HookServer } from '../hook-server.js';
+import { debug } from '../logger.js';
+/**
+ * Abstract base class for PTY-based agent adapters.
+ *
+ * Provides common infrastructure: PtyManager, HookServer, PTY lifecycle,
+ * input/output wiring, and standard command handling (respond, interrupt, escape).
+ *
+ * Subclasses implement:
+ * - capabilities — agent-specific feature flags
+ * - getDefaultCommand() — CLI command to spawn (e.g. 'claude', 'codex')
+ * - wireOutputParser() — connect output parser events → AdapterEvents
+ * - feedParser(data) — feed PTY data to the output parser
+ * - handleAgentCommand(cmd) — agent-specific commands (e.g. switch_mode)
+ */
+export class PtyAdapter extends EventEmitter {
+    ptyManager;
+    hookServer;
+    port = 0;
+    /** Callback for raw PTY data (diagnostics) */
+    rawDataCallback = null;
+    constructor() {
+        super();
+        this.ptyManager = new PtyManager();
+        this.hookServer = new HookServer();
+    }
+    /** Whether this agent uses HTTP hook server. Override to false for hook-less agents. */
+    useHookServer() { return true; }
+    /**
+     * Handle agent-specific commands (e.g. switch_mode for Claude).
+     * Return true if handled, false to fall through to common handlers.
+     */
+    handleAgentCommand(_cmd) { return false; }
+    /** Get the hook server instance (for external wiring like SSE broadcast) */
+    getHookServer() { return this.hookServer; }
+    async start(options) {
+        this.port = options.port;
+        // 1. Start HTTP hook server (optional per agent)
+        if (this.useHookServer()) {
+            await this.hookServer.listen(this.port);
+            // Wire HookServer events → AdapterEvents
+            this.hookServer.on('hook', ({ event, data }) => {
+                if (event === 'shutdown') {
+                    this.emitAdapterEvent({ source: 'hook', event: 'shutdown', data });
+                    return;
+                }
+                this.emitAdapterEvent({ source: 'hook', event, data });
+            });
+        }
+        // 2. Wire output parser (subclass-specific)
+        this.wireOutputParser();
+        // 3. Spawn PTY
+        const command = options.command || this.getDefaultCommand();
+        await this.ptyManager.spawn(command, { AGENTDECK_PORT: String(this.port) });
+        // 4. Feed PTY output → parser + activity
+        this.ptyManager.on('data', (data) => {
+            if (this.rawDataCallback) {
+                this.rawDataCallback(data);
+            }
+            this.feedParser(data);
+            this.emitAdapterEvent({ source: 'activity' });
+        });
+        // 5. Handle PTY exit
+        this.ptyManager.on('exit', (code, signal) => {
+            debug('adapter:pty', `PTY exited (code=${code}, signal=${signal})`);
+            this.emitAdapterEvent({ source: 'hook', event: 'SessionEnd', data: {} });
+            this.emitAdapterEvent({ source: 'connection', status: 'disconnected' });
+            this.emit('exit', code, signal);
+        });
+        // 6. Emit initial events
+        this.emitAdapterEvent({ source: 'hook', event: 'SessionStart', data: {} });
+        this.emitAdapterEvent({ source: 'connection', status: 'connected' });
+    }
+    handleCommand(cmd) {
+        // Let subclass handle agent-specific commands first
+        if (this.handleAgentCommand(cmd))
+            return true;
+        // Common PTY commands
+        switch (cmd.type) {
+            case 'respond':
+                debug('adapter:pty', `respond: "${cmd.value}"`);
+                this.ptyManager.write(cmd.value + '\r');
+                return true;
+            case 'interrupt':
+                this.ptyManager.interrupt();
+                return true;
+            case 'escape':
+                debug('adapter:pty', 'escape: sending Esc');
+                this.ptyManager.write('\x1b');
+                return true;
+            // These require StateMachine context — handled by bridge
+            case 'select_option':
+            case 'navigate_option':
+            case 'send_prompt':
+                return false;
+            // Bridge-only commands
+            case 'voice':
+            case 'query_usage':
+                return false;
+            default:
+                return false;
+        }
+    }
+    writeInput(data) {
+        this.ptyManager.write(data);
+    }
+    isAlive() {
+        return this.ptyManager.isAlive();
+    }
+    attachTerminal(stdin, stdout) {
+        this.ptyManager.attachTerminal(stdin, stdout);
+    }
+    getTtyPath() {
+        return this.ptyManager.getTtyPath();
+    }
+    getProjectName() {
+        return null; // Override in subclasses with output parsers
+    }
+    getHttpServer() {
+        return this.hookServer.getServer();
+    }
+    prepareForNavigation() {
+        // Override in subclasses
+    }
+    onDiag(handler) {
+        this.hookServer.onDiag(handler);
+    }
+    onRawData(callback) {
+        this.rawDataCallback = callback;
+    }
+    async shutdown() {
+        if (this.ptyManager.isAlive()) {
+            this.ptyManager.kill();
+        }
+        await this.hookServer.close();
+    }
+    emitAdapterEvent(evt) {
+        this.emit('event', evt);
+    }
+}
+//# sourceMappingURL=pty-adapter.js.map

package/dist/adapters/pty-adapter.js.map

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

package/dist/adb-reverse.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ADB reverse tunnel management for Android dashboard clients.
+ * D200H Deck Dock is now handled by D200hModule (HID protocol) — no ADB needed.
+ */
+export declare function hasAdb(): boolean;
+export declare function getConnectedAdbDevices(): string[];
+/**
+ * Set up `adb reverse` for all connected Android devices.
+ * Non-blocking, best-effort — bridge starts fine without adb.
+ */
+export declare function setupAdbReverse(port: number): void;
+/**
+ * Periodically re-check adb reverse (handles USB re-plug).
+ * Returns a cleanup function to stop polling.
+ */
+export declare function startAdbReversePolling(port: number, intervalMs?: number): () => void;
+/**
+ * Get number of currently connected ADB devices (best-effort).
+ */
+export declare function getAdbDeviceCount(): number;
+/**
+ * Remove `adb reverse` mappings on shutdown.
+ */
+export declare function cleanupAdbReverse(port: number): void;
+//# sourceMappingURL=adb-reverse.d.ts.map

package/dist/adb-reverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb-reverse.d.ts","sourceRoot":"","sources":["../src/adb-reverse.ts"],"names":[],"mappings":"AAMA;;;GAGG;AAEH,wBAAgB,MAAM,IAAI,OAAO,CAOhC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAmBjD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAuBlD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,SAAS,GAAG,MAAM,IAAI,CA4BpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAepD"}

package/dist/adb-reverse.js

@@ -0,0 +1,129 @@
+import { execSync } from 'child_process';
+import { debug } from './logger.js';
+const TAG = 'adb';
+const ANDROID_PORT = 9120;
+/**
+ * ADB reverse tunnel management for Android dashboard clients.
+ * D200H Deck Dock is now handled by D200hModule (HID protocol) — no ADB needed.
+ */
+export function hasAdb() {
+    try {
+        execSync('which adb', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function getConnectedAdbDevices() {
+    try {
+        const output = execSync('adb devices', { stdio: 'pipe', timeout: 5000 }).toString();
+        const lines = output.split('\n').slice(1).filter((l) => l.trim().length > 0);
+        const connected = [];
+        for (const line of lines) {
+            const [serial, state] = line.split('\t');
+            if (state === 'device') {
+                connected.push(serial);
+            }
+            else if (state === 'unauthorized') {
+                debug(TAG, `Device ${serial} is unauthorized — accept USB debugging prompt on device`);
+            }
+            else if (state === 'offline') {
+                debug(TAG, `Device ${serial} is offline`);
+            }
+        }
+        return connected;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Set up `adb reverse` for all connected Android devices.
+ * Non-blocking, best-effort — bridge starts fine without adb.
+ */
+export function setupAdbReverse(port) {
+    if (!hasAdb()) {
+        debug(TAG, 'adb not found, skipping reverse setup');
+        return;
+    }
+    const devices = getConnectedAdbDevices();
+    if (devices.length === 0) {
+        debug(TAG, 'no connected devices');
+        return;
+    }
+    for (const serial of devices) {
+        try {
+            execSync(`adb -s ${serial} reverse tcp:${ANDROID_PORT} tcp:${port}`, {
+                stdio: 'pipe',
+                timeout: 5000,
+            });
+            debug(TAG, `adb reverse ${serial}: android:${ANDROID_PORT} → daemon:${port}`);
+        }
+        catch (err) {
+            debug(TAG, `adb reverse failed for ${serial}: ${err}`);
+        }
+    }
+}
+/**
+ * Periodically re-check adb reverse (handles USB re-plug).
+ * Returns a cleanup function to stop polling.
+ */
+export function startAdbReversePolling(port, intervalMs = 30_000) {
+    if (!hasAdb())
+        return () => { };
+    const timer = setInterval(() => {
+        const devices = getConnectedAdbDevices();
+        if (devices.length === 0)
+            return;
+        for (const serial of devices) {
+            try {
+                // Check if reverse already exists — if not, set it up
+                const existing = execSync(`adb -s ${serial} reverse --list`, {
+                    stdio: 'pipe',
+                    timeout: 5000,
+                }).toString();
+                if (!existing.includes(`tcp:${ANDROID_PORT}`)) {
+                    execSync(`adb -s ${serial} reverse tcp:${ANDROID_PORT} tcp:${port}`, {
+                        stdio: 'pipe',
+                        timeout: 5000,
+                    });
+                    debug(TAG, `adb reverse re-established ${serial}: android:${ANDROID_PORT} → daemon:${port}`);
+                }
+            }
+            catch (err) {
+                debug(TAG, `adb reverse poll failed for ${serial}: ${err?.message ?? err}`);
+            }
+        }
+    }, intervalMs);
+    return () => clearInterval(timer);
+}
+/**
+ * Get number of currently connected ADB devices (best-effort).
+ */
+export function getAdbDeviceCount() {
+    if (!hasAdb())
+        return 0;
+    return getConnectedAdbDevices().length;
+}
+/**
+ * Remove `adb reverse` mappings on shutdown.
+ */
+export function cleanupAdbReverse(port) {
+    if (!hasAdb())
+        return;
+    const devices = getConnectedAdbDevices();
+    for (const serial of devices) {
+        try {
+            execSync(`adb -s ${serial} reverse --remove tcp:${ANDROID_PORT}`, {
+                stdio: 'pipe',
+                timeout: 3000,
+            });
+            debug(TAG, `removed reverse for ${serial}`);
+        }
+        catch {
+            // ignore — device may already be disconnected
+        }
+    }
+}
+//# sourceMappingURL=adb-reverse.js.map

package/dist/adb-reverse.js.map

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

package/dist/antigravity-local.d.ts

@@ -0,0 +1,7 @@
+export interface AntigravityStatusInfo {
+    planName?: string;
+    availableCredits?: number;
+    minimumCreditAmountForUsage?: number;
+}
+export declare function readAntigravityLocalStatus(): AntigravityStatusInfo | undefined;
+//# sourceMappingURL=antigravity-local.d.ts.map

package/dist/antigravity-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antigravity-local.d.ts","sourceRoot":"","sources":["../src/antigravity-local.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B,CAAC,EAAE,MAAM,CAAC;CACtC;AA2ID,wBAAgB,0BAA0B,IAAI,qBAAqB,GAAG,SAAS,CAO9E"}

package/dist/antigravity-local.js

@@ -0,0 +1,153 @@
+import { execFileSync } from 'child_process';
+import { existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+const DB_PATH = join(homedir(), 'Library/Application Support/Antigravity/User/globalStorage/state.vscdb');
+function sqliteValue(key) {
+    if (!existsSync(DB_PATH))
+        return null;
+    try {
+        const hex = execFileSync('/usr/bin/sqlite3', [DB_PATH, `select hex(value) from ItemTable where key = '${key.replace(/'/g, "''")}' limit 1;`], { encoding: 'utf8', timeout: 3000 }).trim();
+        if (!hex)
+            return null;
+        return Buffer.from(hex, 'hex').toString('utf8');
+    }
+    catch {
+        return null;
+    }
+}
+function readVarint(buf, offset) {
+    let result = 0;
+    let shift = 0;
+    let index = offset;
+    while (index < buf.length) {
+        const byte = buf[index++];
+        result |= (byte & 0x7f) << shift;
+        if ((byte & 0x80) === 0)
+            return { value: result, next: index };
+        shift += 7;
+        if (shift > 49)
+            return null;
+    }
+    return null;
+}
+function parseProto(buf) {
+    const out = [];
+    let index = 0;
+    while (index < buf.length) {
+        const key = readVarint(buf, index);
+        if (!key)
+            break;
+        index = key.next;
+        const field = key.value >> 3;
+        const wire = key.value & 0x07;
+        if (wire === 0) {
+            const value = readVarint(buf, index);
+            if (!value)
+                break;
+            out.push({ field, wire, value: value.value });
+            index = value.next;
+        }
+        else if (wire === 2) {
+            const length = readVarint(buf, index);
+            if (!length)
+                break;
+            index = length.next;
+            out.push({ field, wire, value: buf.subarray(index, index + length.value) });
+            index += length.value;
+        }
+        else {
+            break;
+        }
+    }
+    return out;
+}
+function firstString(fields, field) {
+    const hit = fields.find((entry) => entry.field === field && entry.wire === 2);
+    return hit && Buffer.isBuffer(hit.value) ? hit.value.toString('utf8') : undefined;
+}
+function firstBytes(fields, field) {
+    const hit = fields.find((entry) => entry.field === field && entry.wire === 2);
+    return hit && Buffer.isBuffer(hit.value) ? hit.value : undefined;
+}
+function firstVarint(fields, field) {
+    const hit = fields.find((entry) => entry.field === field && entry.wire === 0);
+    return hit && typeof hit.value === 'number' ? hit.value : undefined;
+}
+function extractAsciiStrings(buf, minimumLength = 6) {
+    const out = [];
+    let current = '';
+    for (const byte of buf.values()) {
+        if (byte >= 32 && byte <= 126) {
+            current += String.fromCharCode(byte);
+        }
+        else {
+            if (current.length >= minimumLength)
+                out.push(current.trim());
+            current = '';
+        }
+    }
+    if (current.length >= minimumLength)
+        out.push(current.trim());
+    return out.filter(Boolean);
+}
+function parsePlanName(authStatusText) {
+    if (!authStatusText)
+        return undefined;
+    try {
+        const auth = JSON.parse(authStatusText);
+        if (!auth.userStatusProtoBinaryBase64)
+            return undefined;
+        const proto = Buffer.from(auth.userStatusProtoBinaryBase64, 'base64');
+        const strings = extractAsciiStrings(proto);
+        return (['Google AI Ultra', 'Google AI Pro', 'Google AI Standard', 'Google AI Free']
+            .find((candidate) => strings.includes(candidate)) ??
+            strings.find((value) => value.startsWith('Google AI ')));
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseModelCredits(text) {
+    if (!text)
+        return {};
+    try {
+        const outer = Buffer.from(text, 'base64');
+        const fields = parseProto(outer);
+        let availableCredits;
+        let minimumCreditAmountForUsage;
+        for (const entry of fields) {
+            if (entry.field !== 1 || entry.wire !== 2 || !Buffer.isBuffer(entry.value))
+                continue;
+            const pair = parseProto(entry.value);
+            const key = firstString(pair, 1);
+            const wrapped = firstBytes(pair, 2);
+            if (!key || !wrapped)
+                continue;
+            const wrappedB64 = firstString(parseProto(wrapped), 1);
+            if (!wrappedB64)
+                continue;
+            const wrappedFields = parseProto(Buffer.from(wrappedB64, 'base64'));
+            const value = firstVarint(wrappedFields, 1) ?? firstVarint(wrappedFields, 2);
+            if (value == null)
+                continue;
+            if (key === 'availableCreditsSentinelKey')
+                availableCredits = value;
+            if (key === 'minimumCreditAmountForUsageKey')
+                minimumCreditAmountForUsage = value;
+        }
+        return { availableCredits, minimumCreditAmountForUsage };
+    }
+    catch {
+        return {};
+    }
+}
+export function readAntigravityLocalStatus() {
+    const planName = parsePlanName(sqliteValue('antigravityAuthStatus'));
+    if (!planName)
+        return undefined;
+    return {
+        planName,
+    };
+}
+//# sourceMappingURL=antigravity-local.js.map

package/dist/antigravity-local.js.map

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

package/dist/apme/adapters/claude-hook.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Claude Code hook → TelemetrySpan adapter.
+ *
+ * Translates the per-event hook payload (UserPromptSubmit / PreToolUse /
+ * PostToolUse / Stop / SessionStart / SessionEnd / shutdown / …) emitted by
+ * Claude Code 2.1+ into AgentDeck telemetry spans.
+ *
+ * `/clear` is detected here and emitted as a `task_boundary` span so the
+ * collector can run `splitRun` before processing it as a normal prompt —
+ * preserving the legacy behavior where the slash-command never becomes a
+ * real task prompt.
+ */
+import type { AdapterContext, TelemetrySpan } from '@agentdeck/shared';
+export declare function claudeHookToSpans(ctx: AdapterContext, event: string, data: Record<string, unknown>): TelemetrySpan[];
+//# sourceMappingURL=claude-hook.d.ts.map

package/dist/apme/adapters/claude-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-hook.d.ts","sourceRoot":"","sources":["../../../src/apme/adapters/claude-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAG3B,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,aAAa,EAAE,CA6DjB"}

package/dist/apme/adapters/claude-hook.js

@@ -0,0 +1,85 @@
+/**
+ * Claude Code hook → TelemetrySpan adapter.
+ *
+ * Translates the per-event hook payload (UserPromptSubmit / PreToolUse /
+ * PostToolUse / Stop / SessionStart / SessionEnd / shutdown / …) emitted by
+ * Claude Code 2.1+ into AgentDeck telemetry spans.
+ *
+ * `/clear` is detected here and emitted as a `task_boundary` span so the
+ * collector can run `splitRun` before processing it as a normal prompt —
+ * preserving the legacy behavior where the slash-command never becomes a
+ * real task prompt.
+ */
+import { randomUUID } from 'crypto';
+import { spanNameForKind } from '@agentdeck/shared';
+export function claudeHookToSpans(ctx, event, data) {
+    const ts = Date.now();
+    const baseAttrs = {
+        'agentdeck.agent_type': ctx.agentType,
+        ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+    };
+    const make = (kind, attributes) => ({
+        traceId: ctx.traceId,
+        spanId: randomUUID(),
+        parentSpanId: ctx.activeTurnId,
+        name: spanNameForKind(kind),
+        kind,
+        ts,
+        attributes: { ...baseAttrs, ...attributes },
+    });
+    if (event === 'UserPromptSubmit') {
+        const prompt = extractPrompt(data);
+        if (/^\s*\/clear\s*$/i.test(prompt)) {
+            return [make('task_boundary', { 'agentdeck.boundary_signal': 'clear' })];
+        }
+        return [
+            make('turn_start', {
+                'agentdeck.prompt_text': prompt,
+                'agentdeck.raw_payload': data,
+            }),
+        ];
+    }
+    if (event === 'PreToolUse') {
+        const toolName = typeof data.tool_name === 'string' ? data.tool_name : undefined;
+        return [
+            make('tool_call', {
+                ...(toolName ? { 'gen_ai.tool.name': toolName, 'agentdeck.tool_name': toolName } : {}),
+                'agentdeck.raw_payload': data,
+            }),
+        ];
+    }
+    if (event === 'PostToolUse') {
+        const toolName = typeof data.tool_name === 'string' ? data.tool_name : undefined;
+        return [
+            make('tool_result', {
+                ...(toolName ? { 'gen_ai.tool.name': toolName, 'agentdeck.tool_name': toolName } : {}),
+                'agentdeck.raw_payload': data,
+            }),
+        ];
+    }
+    // Everything else (Stop, SessionStart, SessionEnd, Notification, shutdown, …)
+    // is recorded verbatim. The collector still inserts a `steps` row so timeline
+    // and tuner queries see them.
+    return [
+        make('raw_step', {
+            'agentdeck.raw_event': event,
+            'agentdeck.raw_payload': data,
+        }),
+    ];
+}
+/** Claude Code sends `{ message: { content: "..." } }`. Some legacy clients send
+ *  `{ prompt: "..." }`. Returns `''` if no recognizable shape — caller handles. */
+function extractPrompt(data) {
+    const fromMessage = (() => {
+        const msg = data.message;
+        if (msg && typeof msg === 'object') {
+            const content = msg.content;
+            return typeof content === 'string' ? content : '';
+        }
+        return '';
+    })();
+    if (fromMessage)
+        return fromMessage;
+    return typeof data.prompt === 'string' ? data.prompt : '';
+}
+//# sourceMappingURL=claude-hook.js.map

package/dist/apme/adapters/claude-hook.js.map

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

package/dist/apme/adapters/claude-pty.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Claude Code PTY parser → TelemetrySpan adapter.
+ *
+ * Two distinct emission points:
+ *
+ *  1. **Parser events** (`tool_start` / `tool_end` / `spinner_start` / `idle` /
+ *     `spinner_stop`) — fired by the BridgeCore output parser as terminal text
+ *     scrolls. We map these to lifecycle spans (`tool_call` / `tool_result`)
+ *     plus generic `raw_step` for state transitions. This is the **fallback**
+ *     when Claude Code 2.1+ hooks are flaky (memory: feedback_apme_stop_hook).
+ *
+ *  2. **Extracted response text** — `spinner_stop` triggers a 500 ms timeout
+ *     in the bridge, the PTY ringbuffer tail is scanned for the `⏺` marker,
+ *     and the cleaned text is fed to `claudePtyResponseToSpan` to emit a
+ *     `turn_response` span.
+ *
+ * Splitting these into two functions keeps each call site free to do its own
+ * timing / extraction work without smuggling sentinels through `data`.
+ */
+import type { AdapterContext, TelemetrySpan } from '@agentdeck/shared';
+export declare function claudePtyParserEventToSpans(ctx: AdapterContext, event: string, data?: Record<string, unknown>): TelemetrySpan[];
+/** Extracted PTY response text → `turn_response` span. The caller is responsible
+ *  for the actual extraction (PTY ringbuffer + `⏺` marker + cleaning) since
+ *  that logic is intertwined with `BridgeCore` timing. */
+export declare function claudePtyResponseToSpan(ctx: AdapterContext, response: string, options?: {
+    fallbackToLastClosed?: boolean;
+}): TelemetrySpan | null;
+//# sourceMappingURL=claude-pty.d.ts.map

package/dist/apme/adapters/claude-pty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-pty.d.ts","sourceRoot":"","sources":["../../../src/apme/adapters/claude-pty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAW3B,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,aAAa,EAAE,CAmCjB;AAED;;0DAE0D;AAC1D,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,aAAa,GAAG,IAAI,CAgBtB"}