agentera 3.0.0-dev.4 → 3.0.0-dev.46

package/dist/analytics/extractCorpus/copilotSessions.js

@@ -0,0 +1,275 @@
+import fs from "node:fs";
+import { resolvePath } from "../../core/paths.js";
+import { isoFromMtime, record, signalType, textFromContent, } from "./core.js";
+import { isPlainObject, rglob, isFilePath } from "./core.js";
+import { resolveSqliteCaps, } from "./sqliteCaps.js";
+import { PermissionDeniedError, openSqlite, sqliteTimestamp, tableColumns, firstColumn, qualified, } from "./sqliteSessions.js";
+function copilotDbCandidates(storePath) {
+    if (isFilePath(storePath))
+        return [storePath];
+    return rglob(storePath, "session-store.db");
+}
+function copilotRows(conn, caps) {
+    const tables = new Set(conn.prepare("SELECT name FROM sqlite_master WHERE type = 'table'").all().map((r) => String(r.name)));
+    for (const t of ["sessions", "turns"]) {
+        if (!tables.has(t)) {
+            const missing = ["sessions", "turns"].filter((x) => !tables.has(x)).sort().join(",");
+            throw new Error(`missing copilot tables: ${missing}`);
+        }
+    }
+    const sessionCols = tableColumns(conn, "sessions");
+    const turnCols = tableColumns(conn, "turns");
+    const sessionId = firstColumn(sessionCols, ["id", "session_id", "sessionID"]);
+    const turnId = firstColumn(turnCols, ["id", "turn_id", "turnID"]);
+    const turnSession = firstColumn(turnCols, ["session_id", "sessionID", "session", "sessionId"]);
+    if (!(sessionId && turnSession))
+        throw new Error("missing copilot join columns");
+    const roleCol = firstColumn(turnCols, ["role", "actor", "author"]);
+    const textCol = firstColumn(turnCols, ["content", "text", "message", "prompt", "response"]);
+    if (roleCol === null)
+        throw new Error("missing copilot turn role column");
+    if (textCol === null)
+        throw new Error("missing copilot turn text column");
+    const sessionTime = firstColumn(sessionCols, ["time", "timestamp", "created_at", "createdAt"]);
+    const turnTime = firstColumn(turnCols, ["time", "timestamp", "created_at", "createdAt"]);
+    const turnOrder = firstColumn(turnCols, ["turn_index", "turnIndex", "idx", "position", "sequence"]);
+    const projectCol = firstColumn(sessionCols, ["cwd", "project_path", "projectPath", "directory", "path"]);
+    const turnData = firstColumn(turnCols, ["data", "payload", "json"]);
+    const turnType = firstColumn(turnCols, ["type", "kind"]);
+    const toolNameCol = firstColumn(turnCols, ["tool_name", "toolName", "tool", "name", "command_name", "commandName"]);
+    const toolArgs = firstColumn(turnCols, [
+        "arguments", "args", "input", "tool_input", "toolInput", "command", "command_line", "commandLine",
+    ]);
+    const orderExpr = turnOrder ? `t."${turnOrder}"` : `t."${turnTime || turnSession}"`;
+    const idExpr = turnId ? `t."${turnId}"` : "t.rowid";
+    const query = `
+        SELECT
+            ${qualified("s", sessionId, "session_id")},
+            ${qualified("s", projectCol, "project_path")},
+            ${qualified("t", turnId, "turn_id")},
+            ${qualified("t", roleCol, "role")},
+            ${qualified("t", turnTime, "turn_time")},
+            ${qualified("s", sessionTime, "session_time")},
+            ${qualified("t", textCol, "turn_text")},
+            ${qualified("t", turnData, "turn_data")},
+            ${qualified("t", turnType, "turn_type")},
+            ${qualified("t", toolNameCol, "tool_name")},
+            ${qualified("t", toolArgs, "tool_args")}
+        FROM turns t
+        JOIN sessions s ON t."${turnSession}" = s."${sessionId}"
+        ORDER BY COALESCE(${orderExpr}, t."${turnSession}"),
+                 CASE LOWER(t."${roleCol}") WHEN 'user' THEN 0 WHEN 'assistant' THEN 1 ELSE 2 END,
+                 ${idExpr}
+        LIMIT ?
+    `;
+    return conn.prepare(query).all(caps.maxRows);
+}
+export function probeCopilotTruncation(conn, caps, fallback) {
+    const tables = new Set(conn.prepare("SELECT name FROM sqlite_master WHERE type = 'table'").all().map((r) => String(r.name)));
+    if (!tables.has("sessions") || !tables.has("turns"))
+        return null;
+    const sessionCols = tableColumns(conn, "sessions");
+    const turnCols = tableColumns(conn, "turns");
+    const sessionId = firstColumn(sessionCols, ["id", "session_id", "sessionID"]);
+    const turnSession = firstColumn(turnCols, ["session_id", "sessionID", "session", "sessionId"]);
+    const roleCol = firstColumn(turnCols, ["role", "actor", "author"]);
+    if (!(sessionId && turnSession && roleCol))
+        return null;
+    const turnId = firstColumn(turnCols, ["id", "turn_id", "turnID"]);
+    const sessionTime = firstColumn(sessionCols, ["time", "timestamp", "created_at", "createdAt"]);
+    const turnTime = firstColumn(turnCols, ["time", "timestamp", "created_at", "createdAt"]);
+    const turnOrder = firstColumn(turnCols, ["turn_index", "turnIndex", "idx", "position", "sequence"]);
+    const orderExpr = turnOrder ? `t."${turnOrder}"` : `t."${turnTime || turnSession}"`;
+    const idExpr = turnId ? `t."${turnId}"` : "t.rowid";
+    const turnCount = Number(conn.prepare("SELECT COUNT(*) AS c FROM turns t JOIN sessions s ON t.\"" + turnSession + "\" = s.\"" + sessionId + "\"").get()?.c ?? 0);
+    if (turnCount <= caps.maxRows)
+        return null;
+    const timeExpr = `COALESCE(t."${turnTime || turnSession}", s."${sessionTime || sessionId}")`;
+    const query = `
+    SELECT MIN(turn_ts) AS truncated_at
+    FROM (
+      SELECT ${timeExpr} AS turn_ts
+      FROM turns t
+      JOIN sessions s ON t."${turnSession}" = s."${sessionId}"
+      ORDER BY COALESCE(${orderExpr}, t."${turnSession}"),
+               CASE LOWER(t."${roleCol}") WHEN 'user' THEN 0 WHEN 'assistant' THEN 1 ELSE 2 END,
+               ${idExpr}
+      LIMIT -1 OFFSET ?
+    )
+  `;
+    const row = conn.prepare(query).get(caps.maxRows);
+    const truncatedAt = sqliteTimestamp(row?.truncated_at, fallback);
+    return { truncatedAt, cap: "rows", limit: caps.maxRows };
+}
+function copilotArgumentDict(value) {
+    if (isPlainObject(value)) {
+        const stateInput = value.input;
+        if (isPlainObject(stateInput) && !("command" in value))
+            return stateInput;
+        return value;
+    }
+    if (typeof value === "string" && value) {
+        try {
+            const parsed = JSON.parse(value);
+            return isPlainObject(parsed) ? parsed : { value: parsed };
+        }
+        catch {
+            return { command: value };
+        }
+    }
+    return {};
+}
+function copilotJsonTools(value, errors, malformedLabel) {
+    if (typeof value === "string" && value) {
+        const raw = value;
+        try {
+            value = JSON.parse(value);
+        }
+        catch {
+            if (errors && malformedLabel && /^\s*[{[]/.test(raw))
+                errors.push(malformedLabel);
+            return [];
+        }
+    }
+    if (Array.isArray(value)) {
+        const tools = [];
+        for (const item of value)
+            tools.push(...copilotJsonTools(item, errors, malformedLabel));
+        return tools;
+    }
+    if (!isPlainObject(value))
+        return [];
+    const toolName = value.tool_name || value.toolName || value.tool || value.name;
+    const valueType = String(value.type || value.kind || "").toLowerCase();
+    if (typeof toolName === "string" &&
+        toolName &&
+        ["", "tool", "tool_call", "function_call", "tool_use", "command"].includes(valueType)) {
+        return [
+            {
+                tool_name: toolName,
+                arguments: copilotArgumentDict(value.arguments || value.args || value.input || value.state || {}),
+            },
+        ];
+    }
+    const tools = [];
+    for (const key of ["tool_calls", "toolCalls", "tools", "content", "parts", "items"]) {
+        const nested = value[key];
+        if (isPlainObject(nested) || Array.isArray(nested))
+            tools.push(...copilotJsonTools(nested, errors, malformedLabel));
+    }
+    return tools;
+}
+function copilotRowTools(row, errors) {
+    const tools = copilotJsonTools(row.turn_data, errors, "copilot malformed json tool payload");
+    tools.push(...copilotJsonTools(row.turn_text));
+    const toolName = row.tool_name;
+    if (typeof toolName === "string" && toolName) {
+        tools.push({ tool_name: toolName, arguments: copilotArgumentDict(row.tool_args) });
+    }
+    else if (String(row.turn_type || "").toLowerCase() === "command") {
+        const command = row.tool_args || row.turn_text;
+        if (typeof command === "string" && command)
+            tools.push({ tool_name: "bash", arguments: { command } });
+    }
+    return tools.filter((t) => typeof t.tool_name === "string" && t.tool_name);
+}
+export function extractCopilotSessions(storePath, errors, ctx) {
+    if (storePath === null || !fs.existsSync(storePath))
+        return [];
+    const caps = ctx?.sqliteCaps ?? resolveSqliteCaps();
+    const records = [];
+    for (const dbPath of copilotDbCandidates(storePath).slice(0, 1)) {
+        const fallbackTimestamp = isoFromMtime(dbPath);
+        let rows;
+        let conn = null;
+        try {
+            conn = openSqlite(dbPath);
+            const truncation = probeCopilotTruncation(conn, caps, fallbackTimestamp);
+            if (truncation && ctx)
+                ctx.truncation = truncation;
+            rows = copilotRows(conn, caps);
+        }
+        catch (exc) {
+            const msg = exc.message || "";
+            if (/lock|busy/i.test(msg))
+                throw new PermissionDeniedError(msg);
+            errors.push(`${dbPath}: copilot sqlite read failed: ${exc.name || "Error"}`);
+            continue;
+        }
+        finally {
+            try {
+                conn?.close();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        let previousAssistant = "";
+        let index = 0;
+        for (const row of rows) {
+            index += 1;
+            const role = String(row.role).toLowerCase();
+            if (role !== "user" && role !== "assistant")
+                continue;
+            const content = textFromContent(row.turn_text);
+            const toolItems = copilotRowTools(row, errors);
+            if (!content && toolItems.length === 0)
+                continue;
+            const projectPath = row.project_path ? String(row.project_path) : null;
+            const timestamp = sqliteTimestamp(row.turn_time || row.session_time, fallbackTimestamp);
+            if (content) {
+                const data = { actor: role, content };
+                if (role === "user") {
+                    if (previousAssistant)
+                        data.preceding_context = previousAssistant.slice(-2000);
+                    const sig = signalType(content);
+                    if (sig)
+                        data.signal_type = sig;
+                }
+                else {
+                    previousAssistant = content;
+                }
+                records.push(record({
+                    sourceKind: "conversation_turn",
+                    timestamp,
+                    projectPath,
+                    runtime: "copilot",
+                    sourceProduct: "github-copilot",
+                    sourceParts: [resolvePath(dbPath), index, role, content.slice(0, 80)],
+                    sessionId: String(row.session_id),
+                    data,
+                }));
+            }
+            let toolIndex = 0;
+            for (const toolItem of toolItems) {
+                toolIndex += 1;
+                records.push(record({
+                    sourceKind: "tool_call",
+                    timestamp,
+                    projectPath,
+                    runtime: "copilot",
+                    sourceProduct: "github-copilot",
+                    sourceParts: [resolvePath(dbPath), index, toolIndex, "tool", toolItem.tool_name, row.turn_id],
+                    sessionId: String(row.session_id),
+                    data: { tool_name: String(toolItem.tool_name), arguments: toolItem.arguments || {} },
+                }));
+            }
+            if (role === "user") {
+                const sig = signalType(content);
+                if (sig) {
+                    records.push(record({
+                        sourceKind: "history_prompt",
+                        timestamp,
+                        projectPath,
+                        runtime: "copilot",
+                        sourceProduct: "github-copilot",
+                        sourceParts: [resolvePath(dbPath), index, "history", content.slice(0, 120)],
+                        sessionId: String(row.session_id),
+                        data: { prompt: content, signal_type: sig },
+                    }));
+                }
+            }
+        }
+    }
+    return records;
+}

package/dist/analytics/extractCorpus/core.js

@@ -0,0 +1,392 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { resolveProfileDirOverride, resolveXdgDataHome } from "../../core/envPaths.js";
+import { expanduser } from "../../core/paths.js";
+import crypto from "node:crypto";
+import { resolvePath } from "../../core/paths.js";
+export const ADAPTER_VERSION = "agentera-v3-corpus-2";
+export const FAMILIES = [
+    "instruction_document",
+    "history_prompt",
+    "conversation_turn",
+    "tool_call",
+    "project_config_signal",
+];
+export const RUNTIME_STORE_GLOBS = {
+    codex: "*.jsonl",
+    cursor: "*.jsonl",
+    opencode: "opencode.db",
+    copilot: "session-store.db",
+};
+export const HISTORICAL_IMPORT_STORE_GLOBS = {
+    "claude-code": "*.jsonl",
+};
+const ACTIVE_ANALYTICS_RUNTIMES = new Set(["opencode", "codex", "cursor", "copilot"]);
+export const MAX_TOOL_ARG_TEXT = 500;
+export const MAX_SQLITE_ROWS = 100_000;
+export const MAX_SQLITE_SESSIONS = 60;
+export const COPILOT_SPARSE_REMEDIATION = "/chronicle reindex";
+const DECISION_RE = /\b(decide|decision|prefer|preference|instead|avoid|don't|do not|should|trade[- ]?off|scope|plan|commit|review|fix|why|question|blocked|stuck|approve|reject|change|keep|remove)\b/i;
+const CORRECTION_RE = /\b(no|not quite|actually|rather|instead|wrong|correction|that's not|that is not|don't|do not)\b/i;
+const QUESTION_RE = /\?|^\s*(why|what|how|should|can|could|would)\b/i;
+export function isoNow() {
+    // Python datetime.now(utc).isoformat() -> microseconds + "+00:00" -> "Z".
+    // JS gives milliseconds; corpus extracted_at is a wall-clock stamp, not a
+    // parity-critical record value.
+    return new Date().toISOString().replace(/Z$/, "Z");
+}
+export function isoFromMtime(p) {
+    const ms = fs.statSync(p).mtimeMs;
+    return new Date(ms).toISOString().replace(/Z$/, "Z");
+}
+export function stableId(...parts) {
+    const raw = parts.map((p) => pyStr(p)).join("\0");
+    return crypto.createHash("sha256").update(raw, "utf-8").digest("hex").slice(0, 24);
+}
+/** Python str() for the scalar/None values stable_id receives. */
+function pyStr(value) {
+    if (value === null || value === undefined)
+        return "None";
+    if (value === true)
+        return "True";
+    if (value === false)
+        return "False";
+    return String(value);
+}
+export function projectIdFromPath(p) {
+    if (p === null)
+        return "global";
+    const name = path.basename(p) || p;
+    const slug = name
+        .replace(/[^A-Za-z0-9._-]+/g, "-")
+        .replace(/^-+/, "")
+        .replace(/-+$/, "")
+        .toLowerCase();
+    return slug || "global";
+}
+export function defaultAgenteraHome(env = process.env, platform = process.platform) {
+    const override = env.AGENTERA_HOME;
+    if (override)
+        return expanduser(override);
+    if (platform === "darwin")
+        return path.join(os.homedir(), "Library", "Application Support", "agentera");
+    if (platform === "win32") {
+        const appdata = env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
+        return path.join(expanduser(appdata), "agentera");
+    }
+    return path.join(resolveXdgDataHome(env), "agentera");
+}
+export function defaultProfileDir(env = process.env, platform = process.platform) {
+    const override = resolveProfileDirOverride(env);
+    if (override)
+        return expanduser(override);
+    return defaultAgenteraHome(env, platform);
+}
+export function defaultOutputPath(env = process.env, platform = process.platform) {
+    return path.join(defaultProfileDir(env, platform), "intermediate", "corpus.json");
+}
+export function runtimeStatus(runtime, opts) {
+    const activeRuntime = opts.activeRuntime ?? (runtime !== null && ACTIVE_ANALYTICS_RUNTIMES.has(runtime));
+    const item = {
+        runtime,
+        source_class: opts.sourceClass ?? (activeRuntime ? "active_runtime" : "historical_import"),
+        source_product: opts.sourceProduct ?? runtime ?? "unknown",
+        active_runtime: activeRuntime,
+        status: opts.status,
+        reason: opts.reason,
+    };
+    if (opts.storePath !== null && opts.storePath !== undefined)
+        item.store_path = opts.storePath;
+    if (opts.fileCount !== null && opts.fileCount !== undefined)
+        item.file_count = opts.fileCount;
+    if (opts.recordCount !== null && opts.recordCount !== undefined)
+        item.record_count = opts.recordCount;
+    if (opts.errorCount !== null && opts.errorCount !== undefined)
+        item.error_count = opts.errorCount;
+    if (opts.remediationLabels && opts.remediationLabels.length > 0)
+        item.remediation_labels = opts.remediationLabels;
+    if (opts.truncatedAt)
+        item.truncated_at = opts.truncatedAt;
+    if (opts.truncationCap)
+        item.truncation_cap = opts.truncationCap;
+    if (opts.truncationLimit !== null && opts.truncationLimit !== undefined)
+        item.truncation_limit = opts.truncationLimit;
+    return item;
+}
+function isDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function isFilePath(p) {
+    try {
+        return fs.statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** Recursive glob for a simple pattern ("*.jsonl" or an exact filename). */
+function rglob(root, pattern) {
+    const out = [];
+    const matchesExt = pattern.startsWith("*.") ? pattern.slice(1) : null; // ".jsonl"
+    const exact = matchesExt ? null : pattern;
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory())
+                walk(full);
+            else if (e.isFile()) {
+                if (matchesExt ? e.name.endsWith(matchesExt) : e.name === exact)
+                    out.push(full);
+            }
+        }
+    };
+    walk(root);
+    return out.sort();
+}
+export function discoverRuntimeStore(runtime, storePath, opts = {}) {
+    const statusOpts = {
+        sourceProduct: opts.sourceProduct,
+        sourceClass: opts.sourceClass,
+        activeRuntime: opts.activeRuntime,
+    };
+    if (storePath === null) {
+        return runtimeStatus(runtime, { status: "skipped", reason: "disabled", storePath: null, ...statusOpts });
+    }
+    if (!fs.existsSync(storePath)) {
+        return runtimeStatus(runtime, {
+            status: "missing",
+            reason: "store_absent",
+            storePath,
+            remediationLabels: runtime === "copilot" ? [COPILOT_SPARSE_REMEDIATION] : null,
+            ...statusOpts,
+        });
+    }
+    if (isFilePath(storePath)) {
+        return runtimeStatus(runtime, {
+            status: "available",
+            reason: "candidate_files_found",
+            storePath,
+            fileCount: 1,
+            ...statusOpts,
+        });
+    }
+    if (!isDir(storePath)) {
+        return runtimeStatus(runtime, { status: "degraded", reason: "store_not_directory", storePath });
+    }
+    let candidates;
+    try {
+        const pattern = opts.pattern ?? (runtime === null ? undefined : RUNTIME_STORE_GLOBS[runtime]);
+        if (!pattern)
+            throw new Error("no declared store pattern");
+        candidates = rglob(storePath, pattern);
+    }
+    catch {
+        return runtimeStatus(runtime, { status: "degraded", reason: "store_unreadable", storePath });
+    }
+    if (candidates.length === 0) {
+        return runtimeStatus(runtime, {
+            status: "sparse",
+            reason: "no_candidate_files",
+            storePath,
+            fileCount: 0,
+            remediationLabels: runtime === "copilot" ? [COPILOT_SPARSE_REMEDIATION] : null,
+            ...statusOpts,
+        });
+    }
+    return runtimeStatus(runtime, {
+        status: "available",
+        reason: "candidate_files_found",
+        storePath,
+        fileCount: candidates.length,
+        ...statusOpts,
+    });
+}
+// ── record builders + content helpers ──────────────────────────────
+export function splitLines(text) {
+    const parts = text.split(/\r\n|\r|\n/);
+    if (parts.length > 0 && parts[parts.length - 1] === "")
+        parts.pop();
+    return parts;
+}
+export function record(opts) {
+    const activeRuntime = opts.activeRuntime ?? (opts.runtime !== null && ACTIVE_ANALYTICS_RUNTIMES.has(opts.runtime));
+    const item = {
+        source_id: stableId(opts.sourceKind, ...opts.sourceParts),
+        timestamp: opts.timestamp,
+        project_id: projectIdFromPath(opts.projectPath),
+        source_kind: opts.sourceKind,
+        runtime: opts.runtime,
+        source_class: opts.sourceClass ?? (activeRuntime ? "active_runtime" : "project"),
+        source_product: opts.sourceProduct ?? opts.runtime ?? "unknown",
+        active_runtime: activeRuntime,
+        adapter_version: ADAPTER_VERSION,
+        data: opts.data,
+    };
+    if (opts.projectPath !== null && opts.projectPath !== undefined)
+        item.project_path = opts.projectPath;
+    if (opts.sessionId) {
+        item.session_id = opts.sessionId;
+        item.conversation_key = opts.sessionId;
+    }
+    return item;
+}
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+export function payloadItem(event) {
+    const payload = event.payload;
+    if (isPlainObject(payload)) {
+        const nested = payload.item;
+        if (isPlainObject(nested))
+            return nested;
+        return payload;
+    }
+    return event;
+}
+export function eventKind(event) {
+    for (const key of ["type", "event", "name"]) {
+        const value = event[key];
+        if (typeof value === "string")
+            return value;
+    }
+    return "";
+}
+export function eventTimestamp(item, fallback) {
+    const payload = isPlainObject(item.payload) ? item.payload : {};
+    const nested = isPlainObject(payload.item) ? payload.item : {};
+    for (const source of [item, payload, nested]) {
+        for (const key of ["timestamp", "created_at", "createdAt", "time"]) {
+            const value = source[key];
+            if (typeof value === "string" && value)
+                return value;
+            if (typeof value === "number") {
+                return new Date(value * 1000).toISOString();
+            }
+        }
+    }
+    return fallback;
+}
+export function textFromContent(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "string")
+        return value;
+    if (Array.isArray(value)) {
+        const parts = value.map((it) => textFromContent(it));
+        return parts.filter((p) => p).join("\n");
+    }
+    if (isPlainObject(value)) {
+        for (const key of ["text", "input_text", "output_text", "message", "content"]) {
+            const text = textFromContent(value[key]);
+            if (text)
+                return text;
+        }
+        return "";
+    }
+    return pyStr(value);
+}
+export function claudeContentItems(event) {
+    const items = [];
+    const msg = isPlainObject(event.message) ? event.message : null;
+    for (const source of [event, msg]) {
+        if (!isPlainObject(source))
+            continue;
+        const content = source.content;
+        if (Array.isArray(content)) {
+            for (const it of content)
+                if (isPlainObject(it))
+                    items.push(it);
+        }
+        else if (isPlainObject(content)) {
+            items.push(content);
+        }
+    }
+    return items;
+}
+export function* iterJsonl(p, errors) {
+    let text;
+    try {
+        text = fs.readFileSync(p, "utf-8");
+    }
+    catch (exc) {
+        errors.push(`${p}: cannot read: ${exc.message}`);
+        return;
+    }
+    const lines = text.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const stripped = lines[i].trim();
+        if (!stripped)
+            continue;
+        let item;
+        try {
+            item = JSON.parse(stripped);
+        }
+        catch (exc) {
+            errors.push(`${p}:${i + 1}: invalid jsonl: ${exc.message}`);
+            continue;
+        }
+        if (isPlainObject(item))
+            yield item;
+    }
+}
+export function signalType(text) {
+    if (!text || !DECISION_RE.test(text))
+        return null;
+    if (CORRECTION_RE.test(text))
+        return "correction";
+    if (QUESTION_RE.test(text))
+        return "question";
+    return "decision";
+}
+export function toolCallRecordFromItem(args) {
+    const { item, event } = args;
+    const kind = eventKind(event);
+    const itemType = item.type;
+    if (!["tool_call", "function_call"].includes(kind) &&
+        !["tool_call", "function_call", "tool_use"].includes(itemType)) {
+        return null;
+    }
+    const toolName = item.tool_name || item.name || item.tool;
+    if (typeof toolName !== "string" || !toolName)
+        return null;
+    let argumentsVal = item.arguments || item.input || item.args || {};
+    if (typeof argumentsVal === "string") {
+        try {
+            argumentsVal = JSON.parse(argumentsVal);
+        }
+        catch {
+            argumentsVal = { raw: argumentsVal };
+        }
+    }
+    if (!isPlainObject(argumentsVal))
+        argumentsVal = { value: argumentsVal };
+    return record({
+        sourceKind: "tool_call",
+        timestamp: eventTimestamp(event, args.fallbackTimestamp),
+        projectPath: args.projectPath,
+        runtime: args.runtime,
+        sourceClass: args.sourceClass,
+        sourceProduct: args.sourceProduct,
+        activeRuntime: args.activeRuntime,
+        sourceParts: [resolvePath(args.sourcePath), args.index, "tool", toolName],
+        sessionId: args.sessionId,
+        data: { tool_name: toolName, arguments: argumentsVal }, // cast: parsed JSON IO boundary
+    });
+}
+export function toolCallRecord(args) {
+    return toolCallRecordFromItem({ ...args, item: payloadItem(args.event) });
+}
+export { isPlainObject, rglob, isDir, isFilePath };