agentacta 2026.3.27 → 2026.4.10

package/README.md

@@ -22,9 +22,9 @@ npx agentacta
 
 ## Why this exists
 
-Agents move fast. Your memory of what happened doesn’t.
+Agents move fast. Your memory of what happened doesn't.
 
-When you need to answer “what changed, when, and why,” you’re usually scraping logs, scrolling transcripts, or asking the same assistant that forgot 20 minutes ago.
+When you need to answer "what changed, when, and why," you're usually scraping logs, scrolling transcripts, or asking the same assistant that forgot 20 minutes ago.
 
 AgentActa gives you one place to inspect the full trail.
 
@@ -40,7 +40,7 @@ AgentActa gives you one place to inspect the full trail.
 - 📊 Stats for sessions, messages, tools, and tokens
 - ⚡ Live indexing via file watching
 - 📱 Mobile-optimized UI with floating navigation
-- 🏥 Session health scoring — reliability scores, issue detection, and per-signal breakdowns
+- 🏥 Session health scoring - reliability scores, issue detection, and per-signal breakdowns
 - 💡 Search suggestions based on real data
 - ⌨️ Command palette (⌘K / Ctrl+K) for quick navigation
 - 🎨 Theme settings (system, light, dark, OLED)
@@ -95,9 +95,9 @@ Pick a date, see everything that happened, newest first. Today's view updates li
 
 The Insights tab surfaces session health across your entire history.
 
-It tracks five issue signals — repeated tool loops, sessions that produced no output, high error rates, vague instructions, and incomplete sessions. Each signal is severity-scaled so scores reflect how bad the problem actually was, not just whether it occurred.
+It tracks five issue signals - repeated tool loops, sessions that produced no output, high error rates, vague instructions, and incomplete sessions. Each signal is severity-scaled so scores reflect how bad the problem actually was, not just whether it occurred.
 
-The reliability score (0–100) is the inverse of the confusion score: higher means the agent completed work cleanly. The issue rate shows what percentage of possible signal types were detected in a session.
+The reliability score (0-100) is the inverse of the confusion score: higher means the agent completed work cleanly. The issue rate shows what percentage of possible signal types were detected in a session.
 
 ### File Activity
 
@@ -131,7 +131,7 @@ On first run, AgentActa creates:
 - `~/.config/agentacta/config.json`
 - or `agentacta.config.json` in current directory (if present)
 
-Default config (auto-generated on first run — session directories are detected automatically):
+Default config (auto-generated on first run - session directories are detected automatically):
 
 ```json
 {
@@ -176,7 +176,7 @@ Default config (auto-generated on first run — session directories are detected
 | `GET /api/timeline/stream?after=<ts>` | SSE stream for live timeline updates |
 | `POST /api/maintenance` | VACUUM + WAL checkpoint (returns size before/after) |
 | `GET /api/health` | Server status, version, uptime, session count |
-| `GET /api/insights` | Session health summary — reliability scores, issue counts, top flagged sessions |
+| `GET /api/insights` | Session health summary - reliability scores, issue counts, top flagged sessions |
 | `GET /api/export/search?q=<query>&format=md` | Export search results |
 
 ### Context API
@@ -189,7 +189,7 @@ The Context API gives agents historical context before they start working. Inste
 | `GET /api/context/repo?path=<repo-path>` | Aggregates for a repo/project |
 | `GET /api/context/agent?name=<agent-name>` | Stats for a specific agent |
 
-**File context** — how many sessions touched this file, when it was last modified, recent change summaries, operation breakdown (reads vs edits), related files, and recent errors:
+**File context** - how many sessions touched this file, when it was last modified, recent change summaries, operation breakdown (reads vs edits), related files, and recent errors:
 
 ```bash
 curl http://localhost:4003/api/context/file?path=/home/user/project/server.js
@@ -206,7 +206,7 @@ curl http://localhost:4003/api/context/file?path=/home/user/project/server.js
 }
 ```
 
-**Agent context** — total sessions, cost, average duration, most-used tools, recent work:
+**Agent context** - total sessions, cost, average duration, most-used tools, recent work:
 
 ```bash
 curl http://localhost:4003/api/context/agent?name=claude-code
@@ -223,7 +223,7 @@ curl http://localhost:4003/api/context/agent?name=claude-code
 }
 ```
 
-**Repo context** — aggregate cost, tokens, distinct agents, most-touched files, common tools:
+**Repo context** - aggregate cost, tokens, distinct agents, most-touched files, common tools:
 
 ```bash
 curl http://localhost:4003/api/context/repo?path=agentacta
@@ -292,13 +292,13 @@ Your session history stays local.
 
 PRs welcome.
 
-See [CONTRIBUTING.md](CONTRIBUTING.md). If you’re adding a new agent format, start in `indexer.js`.
+See [CONTRIBUTING.md](CONTRIBUTING.md). If you're adding a new agent format, start in `src/indexer.ts`.
 
 ## Name
 
-*Acta* is Latin for “things done.”
+*Acta* is Latin for "things done."
 
-That’s the job here: keep a readable record of what your agents actually did.
+That's the job here: keep a readable record of what your agents actually did.
 
 ## License
 

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { AgentActaConfig } from './types.js';
+declare const CONFIG_FILE: string;
+declare function loadConfig(): AgentActaConfig;
+export { loadConfig, CONFIG_FILE };

package/dist/config.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_FILE = void 0;
+exports.loadConfig = loadConfig;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const CWD_CONFIG_FILE = node_path_1.default.join(process.cwd(), 'agentacta.config.json');
+const XDG_CONFIG_DIR = node_path_1.default.join(process.env.XDG_CONFIG_HOME || node_path_1.default.join(node_os_1.default.homedir(), '.config'), 'agentacta');
+const XDG_CONFIG_FILE = node_path_1.default.join(XDG_CONFIG_DIR, 'config.json');
+// Resolve config file: CWD first (backward compat), then XDG default
+function resolveConfigFile() {
+    if (node_fs_1.default.existsSync(CWD_CONFIG_FILE))
+        return CWD_CONFIG_FILE;
+    return XDG_CONFIG_FILE;
+}
+const CONFIG_FILE = resolveConfigFile();
+exports.CONFIG_FILE = CONFIG_FILE;
+const KNOWN_SESSION_DIRS = [
+    node_path_1.default.join(node_os_1.default.homedir(), '.claude', 'projects'), // Claude Code
+    node_path_1.default.join(node_os_1.default.homedir(), '.codex', 'sessions'), // Codex CLI
+    node_path_1.default.join(node_os_1.default.homedir(), '.openclaw', 'sessions'), // OpenClaw
+];
+const DEFAULTS = {
+    port: 4003,
+    storage: 'reference',
+    sessionsPath: null,
+    dbPath: './agentacta.db',
+    projectAliases: {}
+};
+function detectSessionDirs() {
+    const found = KNOWN_SESSION_DIRS.filter((d) => node_fs_1.default.existsSync(d));
+    return found.length > 0 ? found : null;
+}
+function loadConfig() {
+    let fileConfig = {};
+    if (node_fs_1.default.existsSync(CONFIG_FILE)) {
+        try {
+            fileConfig = JSON.parse(node_fs_1.default.readFileSync(CONFIG_FILE, 'utf8'));
+        }
+        catch (err) {
+            console.error(`Warning: Could not parse ${CONFIG_FILE}:`, err.message);
+        }
+    }
+    else {
+        // First-run: create default config with auto-detected session dirs
+        const detected = detectSessionDirs();
+        const firstRunDefaults = { ...DEFAULTS, sessionsPath: detected };
+        const dir = node_path_1.default.dirname(CONFIG_FILE);
+        if (!node_fs_1.default.existsSync(dir))
+            node_fs_1.default.mkdirSync(dir, { recursive: true });
+        node_fs_1.default.writeFileSync(CONFIG_FILE, JSON.stringify(firstRunDefaults, null, 2) + '\n');
+        // Apply to in-memory config so this run also benefits
+        fileConfig = firstRunDefaults;
+        console.log(`Created default config: ${CONFIG_FILE}`);
+        if (detected) {
+            console.log(`Auto-detected session directories:\n${detected.map((d) => `  - ${d}`).join('\n')}`);
+        }
+    }
+    // In demo mode, ignore file-based sessionsPath so live data doesn't bleed in
+    if (process.env.AGENTACTA_DEMO_MODE)
+        delete fileConfig.sessionsPath;
+    const config = { ...DEFAULTS, ...fileConfig };
+    // Env var overrides (highest priority)
+    if (process.env.PORT)
+        config.port = parseInt(process.env.PORT);
+    if (process.env.AGENTACTA_STORAGE)
+        config.storage = process.env.AGENTACTA_STORAGE;
+    if (process.env.AGENTACTA_SESSIONS_PATH)
+        config.sessionsPath = process.env.AGENTACTA_SESSIONS_PATH;
+    if (process.env.AGENTACTA_DB_PATH)
+        config.dbPath = process.env.AGENTACTA_DB_PATH;
+    if (process.env.AGENTACTA_PROJECT_ALIASES_JSON) {
+        try {
+            config.projectAliases = JSON.parse(process.env.AGENTACTA_PROJECT_ALIASES_JSON);
+        }
+        catch (err) {
+            console.error('Warning: Could not parse AGENTACTA_PROJECT_ALIASES_JSON:', err.message);
+        }
+    }
+    // Resolve dbPath relative to cwd
+    config.dbPath = node_path_1.default.resolve(config.dbPath);
+    if (!config.projectAliases || typeof config.projectAliases !== 'object')
+        config.projectAliases = {};
+    return config;
+}
+// v1.1.3
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/db.d.ts

@@ -0,0 +1,5 @@
+import Database from 'better-sqlite3';
+import type { PreparedStatements } from './types.js';
+export declare function open(dbPath?: string): Database.Database;
+export declare function init(dbPath?: string): void;
+export declare function createStmts(db: Database.Database): PreparedStatements;

package/dist/db.js

@@ -0,0 +1,163 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.open = open;
+exports.init = init;
+exports.createStmts = createStmts;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const config_js_1 = require("./config.js");
+let _config = null;
+function getConfig() {
+    if (!_config)
+        _config = (0, config_js_1.loadConfig)();
+    return _config;
+}
+function open(dbPath) {
+    const p = dbPath || getConfig().dbPath;
+    const db = new better_sqlite3_1.default(p);
+    db.pragma('journal_mode = WAL');
+    db.pragma('foreign_keys = ON');
+    return db;
+}
+function init(dbPath) {
+    const db = open(dbPath);
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS sessions (
+      id TEXT PRIMARY KEY,
+      start_time TEXT NOT NULL,
+      end_time TEXT,
+      message_count INTEGER DEFAULT 0,
+      tool_count INTEGER DEFAULT 0,
+      model TEXT,
+      summary TEXT,
+      agent TEXT,
+      session_type TEXT,
+      total_cost REAL DEFAULT 0,
+      total_tokens INTEGER DEFAULT 0,
+      input_tokens INTEGER DEFAULT 0,
+      output_tokens INTEGER DEFAULT 0,
+      cache_read_tokens INTEGER DEFAULT 0,
+      cache_write_tokens INTEGER DEFAULT 0,
+      initial_prompt TEXT,
+      first_message_id TEXT,
+      first_message_timestamp TEXT
+    );
+
+    CREATE TABLE IF NOT EXISTS events (
+      id TEXT PRIMARY KEY,
+      session_id TEXT NOT NULL,
+      timestamp TEXT NOT NULL,
+      type TEXT NOT NULL,
+      role TEXT,
+      content TEXT,
+      tool_name TEXT,
+      tool_args TEXT,
+      tool_result TEXT,
+      FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_sessions_start_time ON sessions(start_time DESC);
+    CREATE INDEX IF NOT EXISTS idx_events_session ON events(session_id);
+    CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp);
+    CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
+    CREATE INDEX IF NOT EXISTS idx_events_tool_name ON events(tool_name);
+
+    CREATE VIRTUAL TABLE IF NOT EXISTS events_fts USING fts5(
+      content, tool_name, tool_args,
+      content='events',
+      content_rowid='rowid'
+    );
+
+    CREATE TRIGGER IF NOT EXISTS events_ai AFTER INSERT ON events BEGIN
+      INSERT INTO events_fts(rowid, content, tool_name, tool_args)
+      VALUES (new.rowid, new.content, new.tool_name, new.tool_args);
+    END;
+
+    CREATE TRIGGER IF NOT EXISTS events_ad AFTER DELETE ON events BEGIN
+      INSERT INTO events_fts(events_fts, rowid, content, tool_name, tool_args)
+      VALUES ('delete', old.rowid, old.content, old.tool_name, old.tool_args);
+    END;
+
+    CREATE TABLE IF NOT EXISTS index_state (
+      file_path TEXT PRIMARY KEY,
+      last_offset INTEGER DEFAULT 0,
+      last_modified TEXT
+    );
+
+    CREATE TABLE IF NOT EXISTS file_activity (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      session_id TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      operation TEXT NOT NULL,
+      timestamp TEXT,
+      FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_file_activity_path ON file_activity(file_path);
+    CREATE INDEX IF NOT EXISTS idx_file_activity_session ON file_activity(session_id);
+
+    CREATE TABLE IF NOT EXISTS archive (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      session_id TEXT NOT NULL,
+      line_number INTEGER NOT NULL,
+      raw_json TEXT NOT NULL,
+      FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_archive_session ON archive(session_id);
+
+    CREATE TABLE IF NOT EXISTS session_insights (
+      session_id TEXT PRIMARY KEY,
+      signals TEXT,
+      confusion_score INTEGER DEFAULT 0,
+      flagged INTEGER DEFAULT 0,
+      computed_at TEXT,
+      FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_insights_flagged ON session_insights(flagged);
+    CREATE INDEX IF NOT EXISTS idx_insights_score ON session_insights(confusion_score DESC);
+  `);
+    // Add columns if missing (migration)
+    const cols = db.prepare("PRAGMA table_info(sessions)").all();
+    const colNames = cols.map((c) => c.name);
+    if (!colNames.includes('agent'))
+        db.exec("ALTER TABLE sessions ADD COLUMN agent TEXT");
+    if (!colNames.includes('session_type'))
+        db.exec("ALTER TABLE sessions ADD COLUMN session_type TEXT");
+    if (!colNames.includes('total_cost'))
+        db.exec("ALTER TABLE sessions ADD COLUMN total_cost REAL DEFAULT 0");
+    if (!colNames.includes('total_tokens'))
+        db.exec("ALTER TABLE sessions ADD COLUMN total_tokens INTEGER DEFAULT 0");
+    if (!colNames.includes('input_tokens'))
+        db.exec("ALTER TABLE sessions ADD COLUMN input_tokens INTEGER DEFAULT 0");
+    if (!colNames.includes('output_tokens'))
+        db.exec("ALTER TABLE sessions ADD COLUMN output_tokens INTEGER DEFAULT 0");
+    if (!colNames.includes('cache_read_tokens'))
+        db.exec("ALTER TABLE sessions ADD COLUMN cache_read_tokens INTEGER DEFAULT 0");
+    if (!colNames.includes('cache_write_tokens'))
+        db.exec("ALTER TABLE sessions ADD COLUMN cache_write_tokens INTEGER DEFAULT 0");
+    if (!colNames.includes('models'))
+        db.exec("ALTER TABLE sessions ADD COLUMN models TEXT");
+    if (!colNames.includes('projects'))
+        db.exec("ALTER TABLE sessions ADD COLUMN projects TEXT");
+    db.close();
+}
+function createStmts(db) {
+    return {
+        getState: db.prepare('SELECT * FROM index_state WHERE file_path = ?'),
+        getSession: db.prepare('SELECT id FROM sessions WHERE id = ?'),
+        deleteEvents: db.prepare('DELETE FROM events WHERE session_id = ?'),
+        deleteSession: db.prepare('DELETE FROM sessions WHERE id = ?'),
+        deleteFileActivity: db.prepare('DELETE FROM file_activity WHERE session_id = ?'),
+        insertEvent: db.prepare(`INSERT OR REPLACE INTO events (id, session_id, timestamp, type, role, content, tool_name, tool_args, tool_result) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`),
+        upsertSession: db.prepare(`INSERT OR REPLACE INTO sessions (id, start_time, end_time, message_count, tool_count, model, summary, agent, session_type, total_cost, total_tokens, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, initial_prompt, first_message_id, first_message_timestamp, models, projects) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`),
+        upsertState: db.prepare(`INSERT OR REPLACE INTO index_state (file_path, last_offset, last_modified) VALUES (?, ?, ?)`),
+        insertFileActivity: db.prepare(`INSERT INTO file_activity (session_id, file_path, operation, timestamp) VALUES (?, ?, ?, ?)`),
+        deleteArchive: db.prepare('DELETE FROM archive WHERE session_id = ?'),
+        insertArchive: db.prepare('INSERT INTO archive (session_id, line_number, raw_json) VALUES (?, ?, ?)')
+    };
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/delta-attribution-context.d.ts

@@ -0,0 +1,4 @@
+import type Database from 'better-sqlite3';
+import type { EventRow } from './types.js';
+export declare function extractCallBaseId(id: string | null | undefined): string;
+export declare function loadDeltaAttributionContext(db: Database.Database, sessionId: string, rows: EventRow[]): EventRow[];

package/dist/delta-attribution-context.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractCallBaseId = extractCallBaseId;
+exports.loadDeltaAttributionContext = loadDeltaAttributionContext;
+function extractCallBaseId(id) {
+    if (!id)
+        return '';
+    return String(id).replace(/:(call|result)$/, '');
+}
+function loadDeltaAttributionContext(db, sessionId, rows) {
+    if (!db || !Array.isArray(rows) || !rows.length)
+        return [];
+    const ordered = [...rows].sort((a, b) => {
+        const ta = Date.parse(a?.timestamp || '0') || 0;
+        const tb = Date.parse(b?.timestamp || '0') || 0;
+        if (ta !== tb)
+            return ta - tb;
+        return String(a?.id || '').localeCompare(String(b?.id || ''));
+    });
+    const first = ordered[0];
+    const firstTs = first?.timestamp || '1970-01-01T00:00:00.000Z';
+    const firstId = first?.id || '';
+    const neighborhoodRows = db.prepare(`SELECT * FROM events
+     WHERE session_id = ?
+       AND (timestamp < ? OR (timestamp = ? AND id < ?))
+     ORDER BY timestamp DESC, id DESC
+     LIMIT 12`).all(sessionId, firstTs, firstTs, firstId).reverse();
+    const callIds = [...new Set(rows
+            .filter((row) => row != null && row.type === 'tool_result')
+            .map((row) => extractCallBaseId(row.id))
+            .filter(Boolean)
+            .map((base) => `${base}:call`))];
+    if (!callIds.length)
+        return neighborhoodRows;
+    const placeholders = callIds.map(() => '?').join(',');
+    const linkedCallRows = db.prepare(`SELECT * FROM events
+     WHERE session_id = ?
+       AND type = 'tool_call'
+       AND id IN (${placeholders})`).all(sessionId, ...callIds);
+    const merged = [];
+    const seen = new Set();
+    for (const row of [...neighborhoodRows, ...linkedCallRows]) {
+        if (!row || !row.id || seen.has(row.id))
+            continue;
+        seen.add(row.id);
+        merged.push(row);
+    }
+    return merged;
+}
+//# sourceMappingURL=delta-attribution-context.js.map

package/dist/delta-attribution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-attribution-context.js","sourceRoot":"","sources":["../src/delta-attribution-context.ts"],"names":[],"mappings":";;AAGA,8CAGC;AAED,kEAmDC;AAxDD,SAAgB,iBAAiB,CAAC,EAA6B;IAC7D,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,SAAgB,2BAA2B,CACzC,EAAqB,EACrB,SAAiB,EACjB,IAAgB;IAEhB,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAE3D,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,CAAW,EAAU,EAAE;QAClE,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAa,OAAO,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAW,KAAK,EAAE,SAAS,IAAI,0BAA0B,CAAC;IACvE,MAAM,OAAO,GAAW,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC;IACxC,MAAM,gBAAgB,GAAe,EAAE,CAAC,OAAO,CAC7C;;;;cAIU,CACX,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,EAAgB,CAAC;IAEpE,MAAM,OAAO,GAAa,CAAC,GAAG,IAAI,GAAG,CACnC,IAAI;aACD,MAAM,CAAC,CAAC,GAAa,EAAW,EAAE,CAAC,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,CAAC;aAC7E,GAAG,CAAC,CAAC,GAAa,EAAU,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aACzD,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,IAAY,EAAU,EAAE,CAAC,GAAG,IAAI,OAAO,CAAC,CACjD,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,gBAAgB,CAAC;IAE7C,MAAM,YAAY,GAAW,OAAO,CAAC,GAAG,CAAC,GAAW,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtE,MAAM,cAAc,GAAe,EAAE,CAAC,OAAO,CAC3C;;;oBAGgB,YAAY,GAAG,CAChC,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,OAAO,CAAe,CAAC;IAE3C,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAgB,IAAI,GAAG,EAAE,CAAC;IACpC,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,gBAAgB,EAAE,GAAG,cAAc,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAClD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};