@agentdeck/bridge 0.1.0 → 0.2.1

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

@@ -0,0 +1,88 @@
+/**
+ * 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 { randomUUID } from 'crypto';
+import { spanNameForKind } from '@agentdeck/shared';
+const PARSER_TO_KIND = {
+    tool_start: 'tool_call',
+    tool_end: 'tool_result',
+    spinner_start: 'raw_step',
+    spinner_stop: 'raw_step',
+    idle: 'raw_step',
+};
+export function claudePtyParserEventToSpans(ctx, event, data = {}) {
+    const kind = PARSER_TO_KIND[event];
+    if (!kind)
+        return [];
+    const ts = Date.now();
+    const toolName = typeof data.tool_name === 'string' ? data.tool_name : undefined;
+    const base = {
+        'agentdeck.agent_type': ctx.agentType,
+        ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+    };
+    let attributes;
+    if (kind === 'tool_call' || kind === 'tool_result') {
+        attributes = {
+            ...base,
+            ...(toolName ? { 'gen_ai.tool.name': toolName, 'agentdeck.tool_name': toolName } : {}),
+            'agentdeck.raw_payload': data,
+            // Map the parser event back to the legacy hook event name so the
+            // collector's existing dispatch (PreToolUse/PostToolUse) keeps firing.
+            'agentdeck.raw_event': event === 'tool_start' ? 'PreToolUse' : 'PostToolUse',
+        };
+    }
+    else {
+        attributes = {
+            ...base,
+            'agentdeck.raw_event': event === 'spinner_start' ? 'processing' : event,
+            'agentdeck.raw_payload': data,
+        };
+    }
+    return [{
+            traceId: ctx.traceId,
+            spanId: randomUUID(),
+            parentSpanId: ctx.activeTurnId,
+            name: spanNameForKind(kind),
+            kind,
+            ts,
+            attributes,
+        }];
+}
+/** 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 function claudePtyResponseToSpan(ctx, response, options = {}) {
+    if (!response || response.trim().length < 2)
+        return null;
+    return {
+        traceId: ctx.traceId,
+        spanId: randomUUID(),
+        parentSpanId: ctx.activeTurnId,
+        name: spanNameForKind('turn_response'),
+        kind: 'turn_response',
+        ts: Date.now(),
+        attributes: {
+            'agentdeck.agent_type': ctx.agentType,
+            ...(ctx.cwd ? { 'agentdeck.cwd': ctx.cwd } : {}),
+            'agentdeck.response_text': response,
+            ...(options.fallbackToLastClosed ? { 'agentdeck.fallback_to_last_closed': true } : {}),
+        },
+    };
+}
+//# sourceMappingURL=claude-pty.js.map

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

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

package/dist/apme/adapters/timeline.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Timeline event → TelemetrySpan adapter.
+ *
+ * Used by OpenClaw and OpenCode adapters which emit `chat_start` /
+ * `chat_response` / `chat_end` / `tool_request` / `tool_resolved` timeline
+ * entries (`shared/src/timeline.ts`). Translates each into the canonical
+ * AgentDeck span set so the collector sees one consistent ingestion stream.
+ *
+ * `chat_end` carries the assistant response in `entry.detail` only as a
+ * fallback path for sources that didn't emit `chat_response` mid-stream.
+ * That case maps to `turn_response` with `fallbackToLastClosed: true` so the
+ * collector applies it via `setLastClosedTurnResponse`.
+ */
+import type { AdapterContext, TelemetrySpan, TimelineEntry } from '@agentdeck/shared';
+export declare function timelineEntryToSpans(ctx: AdapterContext, entry: TimelineEntry): TelemetrySpan[];
+//# sourceMappingURL=timeline.d.ts.map

package/dist/apme/adapters/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../src/apme/adapters/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEb,aAAa,EACd,MAAM,mBAAmB,CAAC;AAG3B,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,aAAa,GACnB,aAAa,EAAE,CAmDjB"}

package/dist/apme/adapters/timeline.js

@@ -0,0 +1,66 @@
+/**
+ * Timeline event → TelemetrySpan adapter.
+ *
+ * Used by OpenClaw and OpenCode adapters which emit `chat_start` /
+ * `chat_response` / `chat_end` / `tool_request` / `tool_resolved` timeline
+ * entries (`shared/src/timeline.ts`). Translates each into the canonical
+ * AgentDeck span set so the collector sees one consistent ingestion stream.
+ *
+ * `chat_end` carries the assistant response in `entry.detail` only as a
+ * fallback path for sources that didn't emit `chat_response` mid-stream.
+ * That case maps to `turn_response` with `fallbackToLastClosed: true` so the
+ * collector applies it via `setLastClosedTurnResponse`.
+ */
+import { randomUUID } from 'crypto';
+import { spanNameForKind } from '@agentdeck/shared';
+export function timelineEntryToSpans(ctx, entry) {
+    const ts = entry.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 },
+    });
+    switch (entry.type) {
+        case 'chat_start': {
+            const prompt = entry.detail || entry.raw || '';
+            return [make('turn_start', { 'agentdeck.prompt_text': prompt })];
+        }
+        case 'chat_response': {
+            const response = entry.detail || entry.raw || '';
+            if (response.length <= 2)
+                return [];
+            return [make('turn_response', { 'agentdeck.response_text': response })];
+        }
+        case 'chat_end': {
+            const response = entry.detail || '';
+            if (response.length <= 2)
+                return [];
+            return [make('turn_response', {
+                    'agentdeck.response_text': response,
+                    'agentdeck.fallback_to_last_closed': true,
+                })];
+        }
+        case 'tool_request': {
+            // Some sources pack the tool name as the first whitespace-delimited token
+            // in `raw`; when missing, the collector falls back to the literal 'tool'.
+            const toolName = entry.raw?.split(' ')[0] ?? 'tool';
+            return [make('tool_call', {
+                    'gen_ai.tool.name': toolName,
+                    'agentdeck.tool_name': toolName,
+                })];
+        }
+        case 'tool_resolved':
+            return [make('tool_result', {})];
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=timeline.js.map

package/dist/apme/adapters/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../src/apme/adapters/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAOpC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAClC,GAAmB,EACnB,KAAoB;IAEpB,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,SAAS,GAAwB;QACrC,sBAAsB,EAAE,GAAG,CAAC,SAAS;QACrC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC;IACF,MAAM,IAAI,GAAG,CACX,IAA2B,EAC3B,UAA+B,EAChB,EAAE,CAAC,CAAC;QACnB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,UAAU,EAAE;QACpB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;QAC3B,IAAI;QACJ,EAAE;QACF,UAAU,EAAE,EAAE,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE;KAC5C,CAAC,CAAC;IAEH,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,uBAAuB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;YACjD,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC;gBAAE,OAAO,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,yBAAyB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;YACpC,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC;gBAAE,OAAO,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE;oBAC5B,yBAAyB,EAAE,QAAQ;oBACnC,mCAAmC,EAAE,IAAI;iBAC1C,CAAC,CAAC,CAAC;QACN,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,0EAA0E;YAC1E,0EAA0E;YAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;oBACxB,kBAAkB,EAAE,QAAQ;oBAC5B,qBAAqB,EAAE,QAAQ;iBAChC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,KAAK,eAAe;YAClB,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;QACnC;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/apme/classifier.d.ts

@@ -0,0 +1,53 @@
+/**
+ * APME Task Classifier — 2-layer: signal vector + derived label.
+ *
+ * Layer 1: `computeSignals()` aggregates steps into a fixed-shape TaskSignals
+ * object that is stored as JSON on `runs.task_signals`. The signals are
+ * agent-agnostic so the same shape works for Claude Code, Codex, OpenCode,
+ * and OpenClaw runs alike.
+ *
+ * Layer 2: `classify()` maps a TaskSignals object to a task_category label
+ * via a priority-ordered rule table. Users can override with `agentdeck apme
+ * tag <id> <category>`. The taxonomy is intentionally simple — the raw
+ * signals are always available for re-classification with a smarter model.
+ */
+import type { ApmeStore } from './store.js';
+export interface TaskSignals {
+    toolCounts: Record<string, number>;
+    dominantTool: string | null;
+    totalToolCalls: number;
+    turnCount: number;
+    sessionDurationSec: number;
+    promptLengthChars: number;
+    planModeUsed: boolean;
+    permissionRequests: number;
+    diffReviews: number;
+    filesCreated: number;
+    filesModified: number;
+    testCommandsRun: number;
+    webSearches: number;
+    agentDelegations: number;
+    isAutomated?: boolean;
+    ocToolNames?: string[];
+}
+export type TaskCategory = 'planning' | 'research' | 'coding' | 'debugging' | 'refactoring' | 'review' | 'ops' | 'conversation' | 'multi_agent' | 'unknown';
+export declare const TASK_CATEGORIES: readonly TaskCategory[];
+export declare function computeSignals(store: ApmeStore, runId: string): TaskSignals;
+export declare function classify(signals: TaskSignals): TaskCategory;
+/** Compute signals + classify in one call, return both. */
+export declare function classifyRun(store: ApmeStore, runId: string): {
+    signals: TaskSignals;
+    category: TaskCategory;
+};
+/**
+ * Classify a run using the local MLX server. Falls back to rule-based
+ * classification if MLX is unavailable. Cost: $0 (local inference).
+ */
+export declare function classifyWithLlm(taskPrompt: string, signals: TaskSignals): Promise<TaskCategory>;
+/** Classify with LLM if rule-based gives unknown, otherwise use rules. */
+export declare function classifyRunSmart(store: ApmeStore, runId: string): Promise<{
+    signals: TaskSignals;
+    category: TaskCategory;
+    source: 'rule' | 'llm';
+}>;
+//# sourceMappingURL=classifier.d.ts.map

package/dist/apme/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/apme/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IAEvB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAID,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,UAAU,GACV,QAAQ,GACR,WAAW,GACX,aAAa,GACb,QAAQ,GACR,KAAK,GACL,cAAc,GACd,aAAa,GACb,SAAS,CAAC;AAEd,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAGlD,CAAC;AAMF,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAmF3E;AAwDD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAK3D;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CAI7G;AAoBD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAsDvB;AAED,0EAA0E;AAC1E,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,CAAC,CAenF"}

package/dist/apme/classifier.js

@@ -0,0 +1,266 @@
+/**
+ * APME Task Classifier — 2-layer: signal vector + derived label.
+ *
+ * Layer 1: `computeSignals()` aggregates steps into a fixed-shape TaskSignals
+ * object that is stored as JSON on `runs.task_signals`. The signals are
+ * agent-agnostic so the same shape works for Claude Code, Codex, OpenCode,
+ * and OpenClaw runs alike.
+ *
+ * Layer 2: `classify()` maps a TaskSignals object to a task_category label
+ * via a priority-ordered rule table. Users can override with `agentdeck apme
+ * tag <id> <category>`. The taxonomy is intentionally simple — the raw
+ * signals are always available for re-classification with a smarter model.
+ */
+export const TASK_CATEGORIES = [
+    'planning', 'research', 'coding', 'debugging', 'refactoring',
+    'review', 'ops', 'conversation', 'multi_agent', 'unknown',
+];
+// ─── Signal computation ─────────────────────────────────────────────────────
+const TEST_PATTERNS = /\b(test|vitest|jest|pytest|cargo\s+test|go\s+test|xcodebuild\s+test|gradlew\s+test|pnpm\s+test|npm\s+test)\b/i;
+export function computeSignals(store, runId) {
+    const run = store.getRun(runId);
+    const steps = store.listSteps(runId);
+    const toolCounts = {};
+    let turnCount = 0;
+    let planModeUsed = false;
+    let permissionRequests = 0;
+    let diffReviews = 0;
+    let filesCreated = 0;
+    let filesModified = 0;
+    let testCommandsRun = 0;
+    let webSearches = 0;
+    let agentDelegations = 0;
+    let isAutomated;
+    const ocToolNames = new Set();
+    for (const step of steps) {
+        if (step.kind === 'PreToolUse' && step.toolName) {
+            toolCounts[step.toolName] = (toolCounts[step.toolName] ?? 0) + 1;
+            if (step.toolName === 'Write')
+                filesCreated++;
+            if (step.toolName === 'Edit')
+                filesModified++;
+            if (step.toolName === 'WebSearch' || step.toolName === 'WebFetch')
+                webSearches++;
+            if (step.toolName === 'Agent')
+                agentDelegations++;
+            if (step.toolName === 'Bash') {
+                try {
+                    const payload = JSON.parse(step.payload);
+                    const cmd = typeof payload.command === 'string' ? payload.command : '';
+                    if (TEST_PATTERNS.test(cmd))
+                        testCommandsRun++;
+                }
+                catch { /* ignore */ }
+            }
+        }
+        if (step.kind === 'UserPromptSubmit')
+            turnCount++;
+        // State-based signals from step payloads
+        try {
+            const payload = JSON.parse(step.payload);
+            if (payload.mode === 'plan' || step.kind === 'mode_change') {
+                if (typeof payload.mode === 'string' && payload.mode === 'plan')
+                    planModeUsed = true;
+            }
+            if (step.kind === 'permission_prompt')
+                permissionRequests++;
+            if (step.kind === 'diff_prompt')
+                diffReviews++;
+            // OpenClaw signals
+            if (typeof payload.chatIsAutomated === 'boolean')
+                isAutomated = payload.chatIsAutomated;
+            if (Array.isArray(payload.chatToolNames)) {
+                for (const t of payload.chatToolNames) {
+                    if (typeof t === 'string')
+                        ocToolNames.add(t);
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+    const totalToolCalls = Object.values(toolCounts).reduce((a, b) => a + b, 0);
+    let dominantTool = null;
+    let maxCount = 0;
+    for (const [tool, count] of Object.entries(toolCounts)) {
+        if (count > maxCount) {
+            maxCount = count;
+            dominantTool = tool;
+        }
+    }
+    const sessionDurationSec = run?.endedAt && run?.startedAt
+        ? Math.round((run.endedAt - run.startedAt) / 1000)
+        : 0;
+    return {
+        toolCounts,
+        dominantTool,
+        totalToolCalls,
+        turnCount,
+        sessionDurationSec,
+        promptLengthChars: run?.taskPrompt?.length ?? 0,
+        planModeUsed,
+        permissionRequests,
+        diffReviews,
+        filesCreated,
+        filesModified,
+        testCommandsRun,
+        webSearches,
+        agentDelegations,
+        isAutomated: isAutomated ?? undefined,
+        ocToolNames: ocToolNames.size > 0 ? [...ocToolNames] : undefined,
+    };
+}
+// ─── Rule-based classifier ──────────────────────────────────────────────────
+function toolPct(signals, ...tools) {
+    if (signals.totalToolCalls === 0)
+        return 0;
+    const sum = tools.reduce((a, t) => a + (signals.toolCounts[t] ?? 0), 0);
+    return sum / signals.totalToolCalls;
+}
+const RULES = [
+    // Highest-signal categories first — these have unambiguous markers.
+    {
+        category: 'multi_agent',
+        test: (s) => s.agentDelegations >= 2,
+    },
+    {
+        category: 'planning',
+        test: (s) => s.planModeUsed,
+    },
+    {
+        category: 'conversation',
+        test: (s) => s.totalToolCalls <= 2 && s.sessionDurationSec < 120,
+    },
+    {
+        category: 'planning',
+        test: (s) => s.turnCount >= 1 && s.turnCount <= 3 && s.totalToolCalls <= 5 && s.filesModified === 0 && s.filesCreated === 0,
+    },
+    {
+        category: 'research',
+        test: (s) => s.webSearches > 0 || (toolPct(s, 'Grep', 'Glob') > 0.4 && s.filesModified === 0 && s.filesCreated === 0),
+    },
+    {
+        category: 'debugging',
+        test: (s) => s.testCommandsRun >= 1 && (s.filesModified > 0 || s.filesCreated > 0) && toolPct(s, 'Bash') > 0.2,
+    },
+    {
+        category: 'refactoring',
+        test: (s) => toolPct(s, 'Edit') > 0.5 && s.filesCreated === 0 && s.filesModified >= 3,
+    },
+    {
+        category: 'coding',
+        test: (s) => toolPct(s, 'Edit', 'Write') > 0.3 && (s.filesModified >= 1 || s.filesCreated >= 1),
+    },
+    {
+        category: 'review',
+        test: (s) => toolPct(s, 'Read') > 0.5 && s.totalToolCalls >= 5 && s.filesModified <= 1 && s.filesCreated === 0,
+    },
+    {
+        category: 'ops',
+        test: (s) => toolPct(s, 'Bash') > 0.5 && toolPct(s, 'Edit', 'Write') < 0.2,
+    },
+];
+export function classify(signals) {
+    for (const rule of RULES) {
+        if (rule.test(signals))
+            return rule.category;
+    }
+    return 'unknown';
+}
+/** Compute signals + classify in one call, return both. */
+export function classifyRun(store, runId) {
+    const signals = computeSignals(store, runId);
+    const category = classify(signals);
+    return { signals, category };
+}
+// ──�� LLM-based classification (local MLX, cost-free) ──────────────────────
+const LLM_CLASSIFY_PROMPT = `You are a task classifier for coding agent sessions.
+Given the user's prompt and tool usage summary, classify this task into exactly ONE category.
+
+Categories:
+- planning: architecture design, plan mode, thinking about approach
+- research: searching code, reading docs, web search, investigating
+- coding: writing/editing code, creating files, implementing features
+- debugging: fixing bugs, running tests, investigating failures
+- refactoring: restructuring existing code without changing behavior
+- review: reading code for understanding, code review
+- ops: git operations, deployments, config changes, CI/CD
+- conversation: quick question, chat, no tools used
+- multi_agent: delegating to sub-agents
+
+Respond with ONLY the category name, nothing else.`;
+/**
+ * Classify a run using the local MLX server. Falls back to rule-based
+ * classification if MLX is unavailable. Cost: $0 (local inference).
+ */
+export async function classifyWithLlm(taskPrompt, signals) {
+    if (!taskPrompt || taskPrompt.trim().length < 5)
+        return classify(signals);
+    const toolSummary = Object.entries(signals.toolCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([t, c]) => `${t}×${c}`)
+        .join(', ');
+    const userMsg = `Prompt: "${taskPrompt.slice(0, 500)}"
+Tools used: ${toolSummary || 'none'} (${signals.totalToolCalls} total)
+Files modified: ${signals.filesModified}, created: ${signals.filesCreated}
+Duration: ${signals.sessionDurationSec}s, turns: ${signals.turnCount}`;
+    try {
+        // Auto-detect MLX endpoint + model (same logic as runner.ts callMlx)
+        let model = 'default';
+        const base = 'http://127.0.0.1:8800';
+        for (const path of ['/v1/models', '/models']) {
+            const mResp = await fetch(`${base}${path}`, { signal: AbortSignal.timeout(2000) }).catch(() => null);
+            if (mResp?.ok) {
+                const mJson = await mResp.json();
+                const first = mJson.data?.find(m => m.id && !m.id.toLowerCase().includes('nanollava'))?.id;
+                if (first) {
+                    model = first;
+                    break;
+                }
+            }
+        }
+        const resp = await fetch(`${base}/chat/completions`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model,
+                messages: [
+                    { role: 'system', content: LLM_CLASSIFY_PROMPT },
+                    { role: 'user', content: userMsg },
+                ],
+                temperature: 0,
+                max_tokens: 20,
+            }),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!resp.ok)
+            return classify(signals);
+        const json = await resp.json();
+        const raw = json.choices?.[0]?.message?.content?.trim().toLowerCase().replace(/[^a-z_]/g, '') ?? '';
+        if (TASK_CATEGORIES.includes(raw))
+            return raw;
+        // Partial match
+        const match = TASK_CATEGORIES.find(c => raw.includes(c));
+        return match ?? classify(signals);
+    }
+    catch {
+        // MLX not available — fall back to rules
+        return classify(signals);
+    }
+}
+/** Classify with LLM if rule-based gives unknown, otherwise use rules. */
+export async function classifyRunSmart(store, runId) {
+    const signals = computeSignals(store, runId);
+    const ruleCategory = classify(signals);
+    if (ruleCategory !== 'unknown') {
+        return { signals, category: ruleCategory, source: 'rule' };
+    }
+    // Rule-based gave unknown — try LLM
+    const run = store.getRun(runId);
+    const prompt = run?.taskPrompt;
+    if (!prompt)
+        return { signals, category: 'unknown', source: 'rule' };
+    const llmCategory = await classifyWithLlm(prompt, signals);
+    return { signals, category: llmCategory, source: llmCategory !== 'unknown' ? 'llm' : 'rule' };
+}
+//# sourceMappingURL=classifier.js.map

package/dist/apme/classifier.js.map

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

package/dist/apme/claude-transcript-reader.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Read the most recent turn's assistant text from a Claude Code transcript
+ * JSONL file (path comes from the Stop hook's `transcript_path` field).
+ *
+ * Why this exists: the `last_assistant_message` field on the Stop hook payload
+ * is only ~18% reliable (see DEVELOPMENT_LOG.md note). Pure-tool turns often
+ * emit no assistant text, and text-bearing turns sometimes drop the field on
+ * the hook boundary. The transcript JSONL is the authoritative source Claude
+ * Code itself writes, with one JSON object per line capturing every user /
+ * assistant / tool_use / tool_result event.
+ *
+ * Scope: CLI bridge only. The App Store Swift daemon runs under a sandbox
+ * that only grants security-scoped access to `~/.claude/settings.json` — not
+ * the per-session `~/.claude/projects/<proj>/<session>.jsonl` files. For that
+ * build, Task 2's `response_kind` heuristic (empty text + tool_calls > 0 →
+ * `tool_only`) is the fallback.
+ */
+export interface LastTurnExcerpt {
+    userPrompt: string;
+    assistantText: string;
+    toolUseCount: number;
+    /** Whether the last assistant block(s) contained any `text` content. */
+    hasAssistantText: boolean;
+}
+/**
+ * Parse the last user→assistant turn from a Claude Code transcript JSONL.
+ *
+ * Returns `null` on any parse failure (file missing, no user/assistant
+ * entries, malformed JSON). Callers treat `null` as "use the other source"
+ * — this function never throws.
+ *
+ * Implementation: read the full file (capped size), walk lines in reverse
+ * to find the last `user` role entry, then scan forward collecting the
+ * `assistant` entries that follow. `content` on each message is either a
+ * string (legacy shape) or an array of blocks with `type: 'text' | 'tool_use'`.
+ */
+export declare function readLastTurn(transcriptPath: string): LastTurnExcerpt | null;
+//# sourceMappingURL=claude-transcript-reader.d.ts.map

package/dist/apme/claude-transcript-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-transcript-reader.d.ts","sourceRoot":"","sources":["../../src/apme/claude-transcript-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAUD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAsD3E"}