agentera 3.0.0-dev.4 → 3.0.0-dev.41

package/dist/analytics/extractCorpus/sqliteSessions.js

@@ -0,0 +1,368 @@
+import fs from "node:fs";
+import { createRequire } from "node:module";
+import { resolvePath } from "../../core/paths.js";
+import { isoFromMtime, record, signalType, textFromContent, } from "./core.js";
+import { isPlainObject, isFilePath, rglob } from "./core.js";
+import { resolveSqliteCaps, } from "./sqliteCaps.js";
+const requireCjs = createRequire(import.meta.url);
+/** Mirrors Python raising PermissionError on a locked/busy store. */
+export class PermissionDeniedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PermissionDeniedError";
+    }
+}
+/** Lazy open a read-only SQLite db via node:sqlite (warning only fires here). */
+export function openSqlite(p) {
+    const { DatabaseSync } = requireCjs("node:sqlite");
+    return new DatabaseSync(resolvePath(p), { readOnly: true });
+}
+export function sqliteTimestamp(value, fallback) {
+    if (typeof value === "string" && value)
+        return value;
+    if (typeof value === "number") {
+        let numeric = value;
+        if (numeric > 10_000_000_000)
+            numeric /= 1000;
+        return new Date(numeric * 1000).toISOString();
+    }
+    return fallback;
+}
+export function jsonDict(value) {
+    if (isPlainObject(value))
+        return value;
+    if (typeof value === "string" && value) {
+        try {
+            const parsed = JSON.parse(value);
+            return isPlainObject(parsed) ? parsed : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    return {};
+}
+function nestedTimeCreated(data) {
+    const timeData = data.time;
+    if (isPlainObject(timeData))
+        return timeData.created || timeData.start;
+    return data.time_created || data.timestamp;
+}
+export function tableColumns(conn, table) {
+    const rows = conn.prepare(`PRAGMA table_info(${table})`).all();
+    return new Set(rows.map((r) => String(r.name)));
+}
+export function firstColumn(columns, candidates) {
+    for (const c of candidates)
+        if (columns.has(c))
+            return c;
+    return null;
+}
+export function qualified(alias, column, label) {
+    if (column === null)
+        return `NULL AS ${label}`;
+    const escaped = column.replace(/"/g, '""');
+    return `${alias}."${escaped}" AS ${label}`;
+}
+function resolveOpencodeSchema(conn) {
+    const tables = new Set(conn.prepare("SELECT name FROM sqlite_master WHERE type = 'table'").all().map((r) => String(r.name)));
+    for (const t of ["session", "message", "part"]) {
+        if (!tables.has(t)) {
+            const missing = ["session", "message", "part"].filter((x) => !tables.has(x)).sort().join(",");
+            throw new Error(`missing opencode tables: ${missing}`);
+        }
+    }
+    const sessionCols = tableColumns(conn, "session");
+    const messageCols = tableColumns(conn, "message");
+    const partCols = tableColumns(conn, "part");
+    const sessionId = firstColumn(sessionCols, ["id", "session_id", "sessionID"]);
+    const messageId = firstColumn(messageCols, ["id", "message_id", "messageID"]);
+    const messageSession = firstColumn(messageCols, ["sessionID", "session_id", "session", "sessionId"]);
+    const partMessage = firstColumn(partCols, ["messageID", "message_id", "message", "messageId"]);
+    if (!(sessionId && messageId && messageSession && partMessage))
+        throw new Error("missing opencode join columns");
+    const messageData = firstColumn(messageCols, ["data"]);
+    const partData = firstColumn(partCols, ["data"]);
+    const roleCol = firstColumn(messageCols, ["role", "actor", "author"]);
+    if (roleCol === null && messageData === null)
+        throw new Error("missing opencode message role column");
+    const messageTime = firstColumn(messageCols, ["time_created", "time", "timestamp", "created_at", "createdAt"]);
+    const partTime = firstColumn(partCols, ["time_created", "time", "timestamp", "created_at", "createdAt"]);
+    const sessionTime = firstColumn(sessionCols, ["time_created", "time", "timestamp", "created_at", "createdAt"]);
+    const sessionUpdated = firstColumn(sessionCols, ["time_updated", "updated_at", "updatedAt", "time_created", "time"]);
+    const projectCol = firstColumn(sessionCols, ["cwd", "project_path", "projectPath", "directory", "path"]);
+    const messageText = firstColumn(messageCols, ["content", "text", "message"]);
+    const partText = firstColumn(partCols, ["text", "content", "input", "output"]);
+    const partType = firstColumn(partCols, ["type", "kind"]);
+    const partId = firstColumn(partCols, ["id", "part_id", "partID"]);
+    const sortExpr = `COALESCE(m."${messageTime || messageId}", p."${partTime || partMessage}", s."${sessionTime || sessionId}")`;
+    const recentSessionExpr = `s."${sessionUpdated || sessionTime || sessionId}"`;
+    return {
+        sessionId,
+        messageId,
+        messageSession,
+        partMessage,
+        messageData,
+        partData,
+        roleCol,
+        messageTime,
+        partTime,
+        sessionTime,
+        sessionUpdated,
+        projectCol,
+        messageText,
+        partText,
+        partType,
+        partId,
+        sortExpr,
+        recentSessionExpr,
+    };
+}
+function opencodeRows(conn, caps, schema) {
+    const { sessionId, messageId, messageSession, partMessage, messageData, partData, roleCol, messageTime, partTime, sessionTime, projectCol, messageText, partText, partType, partId, sortExpr, recentSessionExpr, } = schema;
+    const query = `
+        WITH recent_sessions AS (
+            SELECT s."${sessionId}" AS recent_session_id
+            FROM session s
+            ORDER BY ${recentSessionExpr} DESC,
+                     s."${sessionId}" DESC
+            LIMIT ?
+        ),
+        recent AS (
+            SELECT
+                ${qualified("s", sessionId, "session_id")},
+                ${qualified("s", projectCol, "project_path")},
+                ${qualified("m", messageId, "message_id")},
+                ${qualified("m", roleCol, "role")},
+                ${qualified("m", messageTime, "message_time")},
+                ${qualified("m", messageText, "message_text")},
+                ${qualified("m", messageData, "message_data")},
+                ${qualified("p", partId, "part_id")},
+                ${qualified("p", partTime, "part_time")},
+                ${qualified("p", partType, "part_type")},
+                ${qualified("p", partText, "part_text")},
+                ${qualified("p", partData, "part_data")},
+                ${sortExpr} AS sort_time
+            FROM message m
+            JOIN session s ON m."${messageSession}" = s."${sessionId}"
+            JOIN recent_sessions rs ON rs.recent_session_id = s."${sessionId}"
+            LEFT JOIN part p ON p."${partMessage}" = m."${messageId}"
+            ORDER BY sort_time DESC,
+                     m."${messageId}" DESC,
+                     p."${partId || partMessage}" DESC
+            LIMIT ?
+        )
+        SELECT
+            session_id, project_path, message_id, role, message_time,
+            message_text, message_data, part_id, part_time, part_type,
+            part_text, part_data
+        FROM recent
+        ORDER BY sort_time, message_id, part_id
+    `;
+    return conn.prepare(query).all(caps.maxSessions, caps.maxRows);
+}
+export function probeOpencodeTruncation(conn, caps, fallback) {
+    const schema = resolveOpencodeSchema(conn);
+    const { sessionId, sessionTime, sessionUpdated, recentSessionExpr } = schema;
+    const sessionTimeCol = sessionTime || sessionId;
+    const sessionCount = Number(conn.prepare("SELECT COUNT(*) AS c FROM session").get()?.c ?? 0);
+    if (sessionCount > caps.maxSessions) {
+        const query = `
+      SELECT MIN(session_ts) AS truncated_at
+      FROM (
+        SELECT s."${sessionTimeCol}" AS session_ts
+        FROM session s
+        ORDER BY ${recentSessionExpr} DESC,
+                 s."${sessionId}" DESC
+        LIMIT -1 OFFSET ?
+      )
+    `;
+        const row = conn.prepare(query).get(caps.maxSessions);
+        const truncatedAt = sqliteTimestamp(row?.truncated_at, fallback);
+        return { truncatedAt, cap: "sessions", limit: caps.maxSessions };
+    }
+    const { messageId, messageSession, partMessage, roleCol, messageTime, partTime, messageData, partData, messageText, partText, partType, partId, sortExpr, } = schema;
+    const rowCountQuery = `
+    WITH recent_sessions AS (
+      SELECT s."${sessionId}" AS recent_session_id
+      FROM session s
+      ORDER BY ${recentSessionExpr} DESC,
+               s."${sessionId}" DESC
+      LIMIT ?
+    )
+    SELECT COUNT(*) AS c
+    FROM message m
+    JOIN session s ON m."${messageSession}" = s."${sessionId}"
+    JOIN recent_sessions rs ON rs.recent_session_id = s."${sessionId}"
+    LEFT JOIN part p ON p."${partMessage}" = m."${messageId}"
+  `;
+    const rowCount = Number(conn.prepare(rowCountQuery).get(caps.maxSessions)?.c ?? 0);
+    if (rowCount > caps.maxRows) {
+        const query = `
+      WITH recent_sessions AS (
+        SELECT s."${sessionId}" AS recent_session_id
+        FROM session s
+        ORDER BY ${recentSessionExpr} DESC,
+                 s."${sessionId}" DESC
+        LIMIT ?
+      ),
+      ranked AS (
+        SELECT ${sortExpr} AS sort_time
+        FROM message m
+        JOIN session s ON m."${messageSession}" = s."${sessionId}"
+        JOIN recent_sessions rs ON rs.recent_session_id = s."${sessionId}"
+        LEFT JOIN part p ON p."${partMessage}" = m."${messageId}"
+        ORDER BY sort_time DESC,
+                 m."${messageId}" DESC,
+                 p."${partId || partMessage}" DESC
+        LIMIT -1 OFFSET ?
+      )
+      SELECT MIN(sort_time) AS truncated_at FROM ranked
+    `;
+        const row = conn.prepare(query).get(caps.maxSessions, caps.maxRows);
+        const truncatedAt = sqliteTimestamp(row?.truncated_at, fallback);
+        return { truncatedAt, cap: "rows", limit: caps.maxRows };
+    }
+    return null;
+}
+function opencodeDbCandidates(storePath) {
+    if (isFilePath(storePath))
+        return [storePath];
+    return rglob(storePath, "opencode.db");
+}
+export function extractOpencodeSessions(storePath, errors, ctx) {
+    if (storePath === null || !fs.existsSync(storePath))
+        return [];
+    const caps = ctx?.sqliteCaps ?? resolveSqliteCaps();
+    const records = [];
+    for (const dbPath of opencodeDbCandidates(storePath).slice(0, 1)) {
+        const fallbackTimestamp = isoFromMtime(dbPath);
+        let rows;
+        let conn = null;
+        try {
+            conn = openSqlite(dbPath);
+            const truncation = probeOpencodeTruncation(conn, caps, fallbackTimestamp);
+            if (truncation && ctx)
+                ctx.truncation = truncation;
+            const schema = resolveOpencodeSchema(conn);
+            rows = opencodeRows(conn, caps, schema);
+        }
+        catch (exc) {
+            const msg = exc.message || "";
+            if (/lock|busy/i.test(msg))
+                throw new PermissionDeniedError(msg);
+            errors.push(`${dbPath}: opencode sqlite read failed: ${exc.name || "Error"}`);
+            continue;
+        }
+        finally {
+            try {
+                conn?.close();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        const messages = new Map();
+        for (const row of rows) {
+            const messageData = jsonDict(row.message_data);
+            const partData = jsonDict(row.part_data);
+            const messageId = String(row.message_id);
+            const role = row.role || messageData.role;
+            const messageTime = row.message_time || nestedTimeCreated(messageData);
+            let item = messages.get(messageId);
+            if (item === undefined) {
+                item = {
+                    role,
+                    session_id: String(row.session_id),
+                    project_path: row.project_path,
+                    timestamp: sqliteTimestamp(messageTime, fallbackTimestamp),
+                    parts: [],
+                    tools: [],
+                };
+                messages.set(messageId, item);
+            }
+            const partType = row.part_type || partData.type;
+            const partText = textFromContent(row.part_text || partData.text);
+            if (partText)
+                item.parts.push(partText);
+            else if (row.message_text)
+                item.parts.push(textFromContent(row.message_text));
+            if (partType === "tool" || partData.tool) {
+                const state = isPlainObject(partData.state) ? partData.state : {};
+                const argumentsVal = isPlainObject(state.input) ? state.input : {};
+                const toolName = partData.tool || partData.name;
+                if (typeof toolName === "string" && toolName) {
+                    item.tools.push({
+                        part_id: row.part_id,
+                        tool_name: toolName,
+                        arguments: argumentsVal,
+                        timestamp: sqliteTimestamp(row.part_time || nestedTimeCreated(partData), item.timestamp),
+                    });
+                }
+            }
+        }
+        let previousAssistant = "";
+        let index = 0;
+        for (const item of messages.values()) {
+            index += 1;
+            const role = String(item.role).toLowerCase();
+            if (role !== "user" && role !== "assistant")
+                continue;
+            const content = item.parts.filter((p) => p).join("\n");
+            if (!content && item.tools.length === 0)
+                continue;
+            const projectPath = item.project_path ? String(item.project_path) : null;
+            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: item.timestamp,
+                    projectPath,
+                    runtime: "opencode",
+                    sourceParts: [resolvePath(dbPath), index, role, content.slice(0, 80)],
+                    sessionId: item.session_id,
+                    data,
+                }));
+            }
+            let toolIndex = 0;
+            for (const toolItem of item.tools) {
+                toolIndex += 1;
+                records.push(record({
+                    sourceKind: "tool_call",
+                    timestamp: toolItem.timestamp,
+                    projectPath,
+                    runtime: "opencode",
+                    sourceParts: [resolvePath(dbPath), index, toolIndex, "tool", toolItem.tool_name, toolItem.part_id],
+                    sessionId: item.session_id,
+                    data: { tool_name: toolItem.tool_name, arguments: toolItem.arguments },
+                }));
+            }
+            if (role === "user" && content) {
+                const sig = signalType(content);
+                if (sig) {
+                    records.push(record({
+                        sourceKind: "history_prompt",
+                        timestamp: item.timestamp,
+                        projectPath,
+                        runtime: "opencode",
+                        sourceParts: [resolvePath(dbPath), index, "history", content.slice(0, 120)],
+                        sessionId: item.session_id,
+                        data: { prompt: content, signal_type: sig },
+                    }));
+                }
+            }
+        }
+    }
+    return records;
+}
+//# sourceMappingURL=sqliteSessions.js.map

package/dist/analytics/extractCorpus/sqliteSessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteSessions.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/analytics/extractCorpus/sqliteSessions.ts"],"names":[],"mappings":"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"}

package/dist/analytics/extractCorpus/tierReader.js

@@ -0,0 +1,109 @@
+import fs from "node:fs";
+import path from "node:path";
+import { compatibilityStates, evidenceTierBounds, } from "../../registries/evidenceTierContract.js";
+import { defaultTiersDir, evidenceTierCompatibility, iterTierRecords, readSignalTier, readTierCorpusMetadata, } from "./evidenceTiers.js";
+/**
+ * Bounded tier reader for analytics consumers (plan Task 3).
+ *
+ * Task 2 publishes bounded full-evidence shards and a bounded signal tier with
+ * an atomic generation pointer. This module is the consumer-side surface that
+ * projects the contract's compatibility states and recovery guidance, resolves
+ * the tiers directory from a corpus path, and exposes bounded reads (full-evidence
+ * records one shard at a time; metadata/signal reads without full records). It does
+ * not duplicate the tier map, source families, bounds, or compatibility outcomes —
+ * those are projected from `evidenceTierContract` and `evidenceTiers`.
+ *
+ * Consumers preserve their JSON output shape and exit codes. A non-current tier
+ * degrades with actionable, contract-projected recovery rather than indefinitely
+ * loading an oversized monolithic corpus envelope. `incomplete` is a degrade
+ * outcome: consumers analyze available sources and surface the coverage gap, so a
+ * host missing some runtimes still gets useful analysis instead of a hard failure.
+ */
+/** A corpus path's co-located tiers directory (`<intermediate>/tiers`). */
+export function tiersDirForCorpusPath(corpusPath) {
+    return path.join(path.dirname(corpusPath), "tiers");
+}
+/** Canonical tiers directory for the stats profile. */
+export function resolveTiersDir(env = process.env, platform = process.platform) {
+    return defaultTiersDir(env, platform);
+}
+/** Whether a compatibility state still permits analysis of available sources. */
+export function isAnalyzable(state) {
+    return state === "current" || state === "incomplete";
+}
+/**
+ * Actionable recovery guidance projected from the authority contract for a
+ * compatibility state. The contract owns the recovery text; this never
+ * duplicates it. Returns `null` for states that proceed (current/incomplete).
+ */
+export function recoveryForState(state) {
+    if (state === "current" || state === "incomplete")
+        return null;
+    const states = compatibilityStates();
+    const def = states.find((s) => s.state_id === state);
+    return def?.recovery ?? null;
+}
+/**
+ * Assess the tiers directory against the contract's compatibility states. When a
+ * legacy corpus envelope is supplied, a missing tier with an existing envelope
+ * surfaces as `legacy` (refresh guidance) rather than a bare missing state.
+ */
+export function assessTiers(tiersDir, corpusPath) {
+    const compat = evidenceTierCompatibility(tiersDir, corpusPath);
+    const assessment = {
+        state: compat.state,
+        analyzable: isAnalyzable(compat.state),
+        tiersDir,
+        corpusPath,
+        recovery: recoveryForState(compat.state) ?? undefined,
+    };
+    if (compat.state === "incomplete")
+        assessment.coverageGaps = compat.detail;
+    if (compat.state === "oversized")
+        assessment.artifact = compat.artifact;
+    if (compat.state === "current")
+        assessment.generation = compat.generation;
+    return assessment;
+}
+/**
+ * Read bounded metadata for signal-tier consumers (report status, prime
+ * coverage). Reads the manifest and the bounded signal tier only — never the
+ * full-evidence shards — so metadata consumers stay bounded at real scale. The
+ * signal tier is bounded by construction; a defensively oversized signal tier is
+ * reported as null so the caller degrades with the assessment's recovery.
+ */
+export function readBoundedMetadata(tiersDir) {
+    const signal = readSignalTier(tiersDir);
+    const corpusMetadata = readTierCorpusMetadata(tiersDir);
+    const bounds = evidenceTierBounds();
+    if (signal && (signal.bytes > bounds.signalByteCap || signal.manifest.signal.bytes > bounds.signalByteCap)) {
+        return { corpusMetadata: null, signal: null, manifest: signal.manifest };
+    }
+    return { corpusMetadata, signal, manifest: signal?.manifest ?? null };
+}
+/**
+ * Iterate full-evidence records for the current generation, one bounded shard at
+ * a time. Full-record consumers (usage analytics, startup analysis) use this so
+ * they never materialize the monolithic corpus envelope. Returns `null` when no
+ * current generation exists; callers report the assessment instead.
+ */
+export function iterBoundedRecords(tiersDir) {
+    return iterTierRecords(tiersDir);
+}
+/**
+ * Legacy fallback: a small monolithic corpus envelope may still be read for
+ * backward compatibility when no tiers were published. Oversized legacy state
+ * is never loaded whole — it returns `false` so the caller emits refresh guidance.
+ */
+export function legacyCorpusReadable(corpusPath) {
+    if (!corpusPath || !fs.existsSync(corpusPath))
+        return false;
+    const bounds = evidenceTierBounds();
+    try {
+        return fs.statSync(corpusPath).size <= bounds.readerByteCap;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=tierReader.js.map

package/dist/analytics/extractCorpus/tierReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tierReader.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/analytics/extractCorpus/tierReader.ts"],"names":[],"mappings":"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"}