@ai-studio-3d/vyasa 0.1.0

package/dist/core/schema/index.d.ts

@@ -0,0 +1,514 @@
+export type RecordType = 'user' | 'assistant' | 'system' | 'queue-operation' | 'attachment' | 'last-prompt';
+export interface Usage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens: number;
+    cache_read_input_tokens: number;
+    cache_creation?: {
+        ephemeral_1h_input_tokens?: number;
+        ephemeral_5m_input_tokens?: number;
+    };
+    server_tool_use?: {
+        web_search_requests: number;
+        web_fetch_requests: number;
+    };
+}
+export type ContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'thinking';
+    thinking: string;
+    signature?: string;
+} | {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+} | {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string | ContentBlock[];
+    is_error?: boolean;
+};
+export interface UserRecord {
+    type: 'user';
+    uuid: string;
+    parentUuid: string | null;
+    sessionId: string;
+    timestamp: string;
+    isSidechain: boolean;
+    message: {
+        role: 'user';
+        content: string | ContentBlock[];
+    };
+    cwd?: string;
+    gitBranch?: string;
+    version?: string;
+    /** Top-level tool-result metadata sibling to `message`. String for rejections/plain text,
+     *  or an object (e.g. {durationMs, stdout, ...}) for richer results. Carries `durationMs`
+     *  for some tool types (WebFetch). is_error lives on the tool_result content block, not here. */
+    toolUseResult?: string | Record<string, unknown>;
+    /** Per-record permission mode (auto | acceptEdits | default | plan) — drives F3 permission_change. */
+    permissionMode?: string;
+}
+export interface AssistantRecord {
+    type: 'assistant';
+    uuid: string;
+    parentUuid: string | null;
+    sessionId: string;
+    timestamp: string;
+    isSidechain: boolean;
+    message: {
+        role: 'assistant';
+        model: string;
+        id: string;
+        content: ContentBlock[];
+        usage?: Usage;
+    };
+}
+export interface SystemRecord {
+    type: 'system';
+    subtype: string;
+    uuid: string;
+    sessionId: string;
+    timestamp: string;
+    content: string;
+    isMeta: boolean;
+    compactMetadata?: {
+        trigger: string;
+        preTokens: number;
+        postTokens: number;
+        durationMs: number;
+    };
+}
+export type ParsedRecord = UserRecord | AssistantRecord | SystemRecord;
+export type WasteCategory = 'cache-miss' | 'wrong-model' | 'abandoned';
+export interface WasteAttribution {
+    sessionId: string;
+    category: WasteCategory;
+    amountCents: number;
+    anchorMsgIdx: number | null;
+    evidenceJson: string;
+}
+export interface FoundationData {
+    totalCostCentsThisWeek: number;
+    cacheHitRateLast30Days: number;
+    modelMix: Array<{
+        model: string;
+        pct: number;
+    }>;
+}
+export interface WasteSession {
+    sessionId: string;
+    project: string;
+    startedAt: string | null;
+    amountCents: number;
+    anchorMsgIdx: number | null;
+    evidenceJson: string;
+}
+export interface WasteCategoryData {
+    category: 'cache-miss' | 'wrong-model' | 'abandoned';
+    totalCents: number;
+    sessionCount: number;
+    sessions: WasteSession[];
+}
+export interface WasteData {
+    totalCents: number;
+    categories: WasteCategoryData[];
+}
+export interface SearchResult {
+    sessionId: string;
+    messageId: string;
+    msgIdx: number;
+    snippet: string;
+    session: {
+        project: string;
+        startedAt: string | null;
+        model: string | null;
+    };
+}
+export type SearchHitKind = 'text' | 'tool_input' | 'tool_output';
+export interface SearchHit {
+    msgIdx: number;
+    /** server-built, escaped, with <mark> tags */
+    snippet: string;
+    kind: SearchHitKind;
+}
+export interface SearchSessionGroup {
+    sessionId: string;
+    project: string;
+    name: string;
+    platform: string;
+    startedAt: string | null;
+    model: string | null;
+    lastOutcome: string | null;
+    hitCount: number;
+    /** top few per session (cap 4) */
+    hits: SearchHit[];
+}
+export interface SearchData {
+    total: number;
+    results: SearchResult[];
+    sessionTotal: number;
+    groups: SearchSessionGroup[];
+}
+export interface MessageDetail {
+    id: string;
+    idx: number;
+    role: string;
+    ts: string;
+    model: string | null;
+    contentJson: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheCreationTokens?: number;
+    cacheReadTokens?: number;
+}
+export interface TimelinePoint {
+    msgIdx: number;
+    ts: string;
+    cumulativeCostCents: number;
+}
+export interface SessionDetailData {
+    session: {
+        id: string;
+        project: string;
+        platform: string;
+        startedAt: string | null;
+        endedAt: string | null;
+        messageCount: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        totalCacheCreation: number;
+        totalCacheRead: number;
+        totalCostCents: number;
+        lastOutcome: string | null;
+        /** Resolved display name (override → /rename → ai-title → project → short id). */
+        name: string;
+        /** Raw vyasa override (null if unset) — drives the edit field. */
+        customName: string | null;
+        tags: string[];
+    };
+    messages: MessageDetail[];
+    timeline: TimelinePoint[];
+    /** Plan/decision events derived at query time (F3). Empty for most sessions. */
+    decisions: PlanEvent[];
+}
+export interface SessionListRow {
+    id: string;
+    project: string;
+    platform: string;
+    startedAt: string | null;
+    endedAt: string | null;
+    messageCount: number;
+    totalCostCents: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCacheRead: number;
+    lastOutcome: string | null;
+    durationMs: number | null;
+    /** Raw count of tool calls that errored (F4). Classification is health module's job. */
+    errorCount: number;
+    /** Resolved display name (precedence-applied). */
+    name: string;
+    tags: string[];
+}
+export type PlanEventKind = 'plan_finalized' | 'plan_reopened' | 'model_change' | 'permission_change';
+export interface PlanEvent {
+    msgIdx: number;
+    ts: string;
+    kind: PlanEventKind;
+    /** e.g. "opus-4-7 → sonnet-4-6", "plan accepted" */
+    detail: string;
+    /** tokens consumed from this event until the next (or session end); null when unknown */
+    tokensInSpan: number | null;
+}
+export interface SessionHealth {
+    status: 'clean' | 'warn' | 'error';
+    errorCount: number;
+    reasons: string[];
+}
+export interface SetSessionNameRequest {
+    name: string | null;
+}
+export interface SetSessionTagsRequest {
+    tags: string[];
+}
+export interface SessionMetaResponse {
+    name: string;
+    customName: string | null;
+    tags: string[];
+}
+export interface TagListResponse {
+    tags: Array<{
+        tag: string;
+        count: number;
+    }>;
+}
+export interface SessionsListData {
+    total: number;
+    /** Count of zero-value "empty" sessions hidden by default (0 tokens, $0). */
+    hiddenEmptyCount: number;
+    sessions: SessionListRow[];
+}
+/** Sessions whose last message landed inside the live window — the "Live" view.
+ *  `now` is the server clock so the client can render accurate "active Xs ago". */
+export interface LiveData {
+    now: number;
+    windowMinutes: number;
+    sessions: SessionListRow[];
+}
+export type AnalyticsRange = '7d' | '30d' | '90d' | 'all';
+export interface AnalyticsData {
+    range: AnalyticsRange;
+    dailyCost: {
+        date: string;
+        costCents: number;
+        sessionCount: number;
+    }[];
+    projectCost: {
+        project: string;
+        costCents: number;
+        sessionCount: number;
+    }[];
+    modelCost: {
+        model: string;
+        costCents: number;
+        outputTokens: number;
+    }[];
+    /** Per-day token totals, aligned to dailyCost dates (tokens read better than $ since most sessions show $0). */
+    dailyTokens: {
+        date: string;
+        tokens: number;
+    }[];
+    /** Headline stats for the selected range. */
+    summary: AnalyticsSummary;
+    /** Day-of-week × hour activity grid — the work-rhythm "flow map". */
+    activityClock: ActivityClock;
+}
+export interface AnalyticsSummary {
+    totalSessions: number;
+    totalTokens: number;
+    /** Distinct calendar days with at least one session. */
+    activeDays: number;
+    /** Local hour 0–23 with the most sessions, or null if no data. */
+    busiestHour: number | null;
+}
+export interface ActivityClock {
+    /**
+     * 7×24 grid of buckets (index = dayOfWeek*24 + hour). dayOfWeek: 0=Sun..6=Sat,
+     * hour: 0–23, both in the server's local timezone (where sessions were recorded).
+     */
+    cells: ActivityCell[];
+    /** Max sessionCount across all cells (for color-ramp normalization on the client). */
+    maxSessions: number;
+    /** Max tokens across all cells. */
+    maxTokens: number;
+}
+export interface ActivityCell {
+    dayOfWeek: number;
+    hour: number;
+    sessionCount: number;
+    tokens: number;
+    /** Error tool-calls in this bucket — drives "depth"/run-health tint. */
+    errorCount: number;
+}
+export interface ScrubReport {
+    /** Dropped meta/internal records, keyed by record type (plus 'isMeta' for isMeta-flagged drops). */
+    metaRecordsDropped: Record<string, number>;
+    /** <system-reminder> spans removed from kept records (sensitive markers only — plan echoes survive). */
+    systemReminderSpansStripped: number;
+    /** Records dropped because they were empty after stripping (pure injection). */
+    recordsEmptiedAndDropped: number;
+    /** Records whose content was redacted in place (preview-driven). */
+    redactedRecords: number;
+    bytesBefore: number;
+    bytesAfter: number;
+}
+export interface ResidualFlag {
+    /** Record uuid to redact. Empty for the plan-file flag (excluded via includePlanFile instead). */
+    uuid: string;
+    kind: 'tool_dump' | 'secret' | 'pii' | 'plan_file';
+    reason: string;
+    /** First ~200 chars of the flagged content, for the user to eyeball. */
+    snippet: string;
+    sizeBytes: number;
+    /** Pre-checked for exclusion in the UI (sensitive-path dumps + the plan file). */
+    defaultExclude: boolean;
+}
+export interface SharePreview {
+    platform: string;
+    /** null for Codex (scrubbing not yet supported — review manually). */
+    scrubReport: ScrubReport | null;
+    residualFlags: ResidualFlag[];
+    /** False for Codex/Cursor — caller should warn the user to review manually before sharing. */
+    canScrub: boolean;
+}
+export type KitPlatform = 'claude-code' | 'codex' | 'cursor';
+export type KitItemKind = 'skill' | 'mcp';
+export type KitScope = 'global' | 'project';
+export interface SkillState {
+    /** Canonical id: '<plugin>:<name>' for plugin-installed skills, '<name>' for loose ones */
+    id: string;
+    /** Filesystem directory name */
+    name: string;
+    /** Source plugin slug (e.g. 'superpowers'), or null for loose skills */
+    plugin: string | null;
+    platform: KitPlatform;
+    scope: KitScope;
+    /** When scope='project', the absolute project path the skill lives under */
+    projectPath: string | null;
+    /** Absolute path to the SKILL.md file */
+    sourcePath: string;
+    description: string | null;
+    /** ms-epoch — when SKILL.md was last modified */
+    installedAtMs: number;
+    /** ms-epoch of the most recent tool_call matching this skill, or null if never invoked */
+    lastUsedMs: number | null;
+    /** Count of tool_calls in the lookback window */
+    usageCount: number;
+}
+export interface McpState {
+    /** Server name as it appears between the two `__` in `mcp__<server>__<method>` */
+    id: string;
+    platform: KitPlatform;
+    scope: KitScope;
+    /** When scope='project', the absolute project path whose config declares the server */
+    projectPath: string | null;
+    /** Absolute path to the config file (e.g. ~/.claude.json, ~/.cursor/mcp.json) */
+    sourcePath: string;
+    /** ms-epoch — config file's last modified time */
+    installedAtMs: number;
+    lastUsedMs: number | null;
+    usageCount: number;
+}
+export interface GapItem {
+    kind: KitItemKind;
+    id: string;
+    purpose: string;
+    installCommand: string;
+    /** Estimated cents saveable over the lookback window if the user adopts this. 0 when no heuristic fires. */
+    potentialSavingsCents: number;
+    /** Total tool_calls matched by `replaces` patterns over the lookback window */
+    matchingCallCount: number;
+}
+export interface ZombieItem {
+    kind: KitItemKind;
+    id: string;
+    /** SkillState.name for skills, McpState.id for MCP servers */
+    displayName: string;
+    platform: KitPlatform;
+    scope: KitScope;
+    projectPath: string | null;
+    installedAtMs: number;
+    lastUsedMs: number | null;
+    usageCount: number;
+    removeCommand: string;
+}
+export interface ProjectInventory {
+    project: string;
+    skills: SkillState[];
+    mcp: McpState[];
+}
+export interface KitData {
+    lookbackDays: number;
+    gaps: GapItem[];
+    zombies: ZombieItem[];
+    globalInstalled: {
+        skills: SkillState[];
+        mcp: McpState[];
+    };
+    projectInstalled: ProjectInventory[];
+}
+export interface DlpFinding {
+    sessionId: string;
+    name: string;
+    msgIdx: number;
+    kind: 'secret' | 'pii';
+    reason: string;
+    preview: string;
+}
+export interface RepetitionCluster {
+    representative: string;
+    count: number;
+    sessionCount: number;
+    examples: {
+        sessionId: string;
+        msgIdx: number;
+        text: string;
+    }[];
+    suggestion: string;
+}
+export interface RecapData {
+    weekStart: string;
+    sessionCount: number;
+    burn: {
+        used: number;
+        cap: number | null;
+        pct: number | null;
+        projectedWeekEnd: number;
+        daysToExhaust: number | null;
+    };
+    wasteCents: number;
+    thrash: {
+        sessionId: string;
+        name: string;
+        errorCount: number;
+    }[];
+    drift: {
+        sessionId: string;
+        name: string;
+        reopens: number;
+        tokensInReopens: number;
+    }[];
+    repetition: RepetitionCluster[];
+    secrets: DlpFinding[];
+}
+export interface BillingRow {
+    tag: string;
+    sessionCount: number;
+    tokens: number;
+    costCents: number;
+}
+export interface BillingData {
+    rangeLabel: string;
+    rows: BillingRow[];
+    untaggedSessions: number;
+}
+export interface ImportResultResponse {
+    ok: boolean;
+    sessionId?: string;
+    error?: string;
+}
+export interface ParseError {
+    lineNum: number;
+    recordType: string | null;
+    error: string;
+    /** First 200 chars of the raw JSON line */
+    sampleJson: string;
+}
+export interface ParsedSession {
+    sessionId: string | null;
+    filePath: string;
+    /** Project path — set by Codex parser from session_meta.payload.cwd; null for Claude (ingest derives it from file path) */
+    project: string | null;
+    records: ParsedRecord[];
+    /** All assistant records that have usage data */
+    usageRecords: AssistantRecord[];
+    /** Timestamp of the first user record */
+    startedAt: string | null;
+    /** Timestamp of the last non-skipped record of any type, including system records (e.g. compact_boundary) */
+    endedAt: string | null;
+    /** Latest `custom-title` record's customTitle (user's /rename), or null. Ingest-derived; recomputed each parse. */
+    claudeCustomTitle: string | null;
+    /** Latest `ai-title` record's aiTitle (auto-generated), or null. */
+    claudeAiTitle: string | null;
+    /** Records that failed validation; empty array means clean parse */
+    parseErrors: ParseError[];
+    /** Structural fingerprints observed in this file; key = fingerprint, value = first occurrence info */
+    fingerprints: Map<string, {
+        firstSeenLine: number;
+    }>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/schema/index.d.ts.map

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

package/dist/core/schema/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/core/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/schema/index.ts"],"names":[],"mappings":""}

package/dist/core/schema-watch/index.d.ts

@@ -0,0 +1,34 @@
+import Database from 'better-sqlite3';
+export interface FingerprintMeta {
+    firstSeenFile: string;
+    firstSeenLine: number;
+    count: number;
+    lastSeen: string;
+}
+/**
+ * Produce a deterministic structural fingerprint for one raw JSONL record.
+ * Shape: "type=<top-level type>|payload.type=<payload type>|payload.keys=<sorted comma list>"
+ * - top-level `type` comes from raw['type'] (string or '?')
+ * - payload.type from raw['payload']?.['type'] (string or '?')
+ * - payload.keys: sorted top-level keys of raw['payload'] object joined by ','
+ *   (if payload is not an object, use empty string)
+ * Depth is intentionally shallow (1 level into payload) so the fingerprint
+ * stays stable as nested fields evolve.
+ */
+export declare function recordFingerprint(rec: unknown): string;
+/**
+ * Compare a map of observed fingerprints against the golden set on disk.
+ * goldenPath: absolute path to data/schema-fingerprints.json
+ * Returns lists of fingerprints that are unknown (in observed, not in golden)
+ * and missing (in golden, not in observed — informational only, not an error).
+ */
+export declare function compareToGolden(observed: Map<string, FingerprintMeta>, goldenPath: string): {
+    unknown: string[];
+    missing: string[];
+};
+/**
+ * Read current _schema_observations from DB and rewrite goldenPath with them.
+ * Called by --schema-bless CLI flag.
+ */
+export declare function blessGolden(db: Database.Database, goldenPath: string): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/schema-watch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/schema-watch/index.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AAErC,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAmBtD;AAOD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACtC,UAAU,EAAE,MAAM,GACjB;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA8B1C;AAOD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAuB3E"}

package/dist/core/schema-watch/index.js

@@ -0,0 +1,87 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+/**
+ * Produce a deterministic structural fingerprint for one raw JSONL record.
+ * Shape: "type=<top-level type>|payload.type=<payload type>|payload.keys=<sorted comma list>"
+ * - top-level `type` comes from raw['type'] (string or '?')
+ * - payload.type from raw['payload']?.['type'] (string or '?')
+ * - payload.keys: sorted top-level keys of raw['payload'] object joined by ','
+ *   (if payload is not an object, use empty string)
+ * Depth is intentionally shallow (1 level into payload) so the fingerprint
+ * stays stable as nested fields evolve.
+ */
+export function recordFingerprint(rec) {
+    if (rec === null || typeof rec !== 'object' || Array.isArray(rec)) {
+        return 'type=?|payload.type=?|payload.keys=';
+    }
+    const obj = rec;
+    const topType = typeof obj['type'] === 'string' ? obj['type'] : '?';
+    const payload = obj['payload'];
+    let payloadType = '?';
+    let payloadKeys = '';
+    if (payload !== null && payload !== undefined && typeof payload === 'object' && !Array.isArray(payload)) {
+        const payloadObj = payload;
+        payloadType = typeof payloadObj['type'] === 'string' ? payloadObj['type'] : '?';
+        payloadKeys = Object.keys(payloadObj).sort().join(',');
+    }
+    return `type=${topType}|payload.type=${payloadType}|payload.keys=${payloadKeys}`;
+}
+/**
+ * Compare a map of observed fingerprints against the golden set on disk.
+ * goldenPath: absolute path to data/schema-fingerprints.json
+ * Returns lists of fingerprints that are unknown (in observed, not in golden)
+ * and missing (in golden, not in observed — informational only, not an error).
+ */
+export function compareToGolden(observed, goldenPath) {
+    let golden;
+    try {
+        const raw = readFileSync(goldenPath, 'utf8');
+        golden = JSON.parse(raw);
+    }
+    catch {
+        // File doesn't exist — treat first run as clean
+        return { unknown: [], missing: [] };
+    }
+    const goldenSet = new Set([
+        ...(golden['claude-code'] ?? []),
+        ...(golden['codex'] ?? []),
+    ]);
+    const unknown = [];
+    for (const fp of observed.keys()) {
+        if (!goldenSet.has(fp)) {
+            unknown.push(fp);
+        }
+    }
+    const missing = [];
+    for (const fp of goldenSet) {
+        if (!observed.has(fp)) {
+            missing.push(fp);
+        }
+    }
+    return { unknown, missing };
+}
+/**
+ * Read current _schema_observations from DB and rewrite goldenPath with them.
+ * Called by --schema-bless CLI flag.
+ */
+export function blessGolden(db, goldenPath) {
+    const rows = db
+        .prepare('SELECT DISTINCT platform, fingerprint FROM _schema_observations')
+        .all();
+    const grouped = {
+        'claude-code': [],
+        'codex': [],
+    };
+    for (const row of rows) {
+        if (row.platform === 'claude-code') {
+            grouped['claude-code'].push(row.fingerprint);
+        }
+        else if (row.platform === 'codex') {
+            grouped['codex'].push(row.fingerprint);
+        }
+    }
+    // Sort for deterministic output
+    grouped['claude-code'].sort();
+    grouped['codex'].sort();
+    writeFileSync(goldenPath, JSON.stringify(grouped, null, 2) + '\n', 'utf8');
+}
+//# sourceMappingURL=index.js.map

package/dist/core/schema-watch/index.js.map

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