agent-afk 5.296.7 → 5.296.9

package/dist/agent/daemon/handoff-consume.dead-letter.d.ts

@@ -0,0 +1,4 @@
+export declare const DEAD_LETTER_SUBDIR = "dead-letter";
+export declare const MAX_CLAIM_REREAD_FAILURES = 3;
+export declare const claimRereadFailures: Map<string, number>;
+export declare function deadLetterHandoffFile(handoffsDir: string, srcPath: string, displayName: string, reason: string): Promise<void>;

package/dist/agent/journal/reader.async.d.ts

@@ -1,9 +1,3 @@
-import type { JournalBlock } from './types.js';
-type ToolResultBlock = Extract<JournalBlock, {
-    type: 'tool_result';
-}>;
-export declare function findToolResultAsync(sessionId: string, toolUseId: string): Promise<{
-    block: ToolResultBlock;
-    subagentId?: string;
-} | null>;
-export {};
+import type { ToolResultLookup } from './types.js';
+export type { ToolResultLookup } from './types.js';
+export declare function findToolResultAsync(sessionId: string, toolUseId: string): Promise<ToolResultLookup | null>;

package/dist/agent/journal/reader.d.ts

@@ -1,4 +1,4 @@
-import type { JournalBlock, JournalMessage, JournalRecord } from './types.js';
+import type { JournalMessage, JournalRecord, ToolResultLookup } from './types.js';
 export interface JournalLocator {
     subagentId?: string;
 }
@@ -15,10 +15,5 @@ export declare function foldJournal(records: readonly JournalRecord[]): FoldResu
 export declare function loadJournalFold(sessionId: string, loc?: JournalLocator): FoldResult | null;
 export declare function hydrateMessages(messages: readonly JournalMessage[]): JournalMessage[];
 export declare function loadJournalMessages(sessionId: string, loc?: JournalLocator): JournalMessage[] | null;
-export declare function findToolResult(sessionId: string, toolUseId: string): {
-    block: Extract<JournalBlock, {
-        type: 'tool_result';
-    }>;
-    subagentId?: string;
-} | null;
+export declare function findToolResult(sessionId: string, toolUseId: string): ToolResultLookup | null;
 export declare function listSubagentJournals(sessionId: string): string[];

package/dist/agent/journal/types.d.ts

@@ -66,6 +66,12 @@ export type JournalBlock = {
     source: JournalBinary;
     title?: string;
 };
+export interface ToolResultLookup {
+    block: Extract<JournalBlock, {
+        type: 'tool_result';
+    }>;
+    subagentId?: string;
+}
 export interface JournalMessage {
     role: 'user' | 'assistant';
     content: JournalBlock[];

package/dist/agent/memory/memory-store.d.ts

@@ -12,7 +12,6 @@ export declare class MemoryStore {
     private readonly dir;
     private readonly db;
     constructor(memoryDir?: string);
-    private enableWalMode;
     loadHot(): string | null;
     saveHot(content: string): HotUsage;
     hotUsage(): HotUsage;
@@ -34,5 +33,4 @@ export declare class MemoryStore {
     search(query: string, opts?: SearchOpts): MemorySearchResult[];
     replayWAL(): number;
     close(): void;
-    private appendWAL;
 }

package/dist/agent/memory/memory-store.facts.d.ts

@@ -0,0 +1,2 @@
+import type BetterSqlite3 from 'better-sqlite3';
+export declare function supersedeFact(db: BetterSqlite3.Database, dir: string, factId: number, newContent: string, category?: string, evidence?: string | null): number;

package/dist/agent/memory/memory-store.procedures.d.ts

@@ -0,0 +1,6 @@
+import type { Procedure } from './types.js';
+export declare const PROCEDURES_DIR = "procedures";
+export declare function validateProcedureName(name: string): string;
+export declare function writeProcedure(dir: string, name: string, content: string, sessionId?: string): void;
+export declare function loadProcedure(dir: string, name: string): Procedure | null;
+export declare function searchProcedures(dir: string, query: string): Procedure[];

package/dist/agent/memory/memory-store.schema.d.ts

@@ -0,0 +1,6 @@
+import type BetterSqlite3 from 'better-sqlite3';
+export declare const SCHEMA_VERSION = 4;
+export declare const SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS sessions (\n  session_id TEXT PRIMARY KEY,\n  surface TEXT NOT NULL,\n  started_at TEXT NOT NULL,\n  ended_at TEXT,\n  summary TEXT,\n  tools_used TEXT NOT NULL DEFAULT '[]',\n  outcome TEXT,\n  token_count INTEGER,\n  cost_usd REAL,\n  -- v3: execution role 'main' | 'subagent'. Nullable (NULL on pre-v3 rows).\n  -- Listed last to match the position ALTER TABLE ADD COLUMN appends it on\n  -- migrated databases, so fresh and migrated DBs share one column order.\n  actor TEXT\n);\n\nCREATE TABLE IF NOT EXISTS facts (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT,\n  created_at TEXT NOT NULL,\n  category TEXT NOT NULL CHECK(category IN ('preference', 'convention', 'decision', 'learning')),\n  content TEXT NOT NULL,\n  source_surface TEXT NOT NULL DEFAULT 'cli',\n  superseded_by INTEGER REFERENCES facts(id),\n  confidence REAL NOT NULL DEFAULT 1.0,\n  access_count INTEGER NOT NULL DEFAULT 0,\n  last_accessed TEXT,\n  -- v4: provenance citation backing a codebase fact (file:line, commit SHA,\n  -- trace-event id). Nullable (NULL on pre-v4 rows and uncited writes).\n  -- Listed last to match the position ALTER TABLE ADD COLUMN appends it on\n  -- migrated databases, so fresh and migrated DBs share one column order.\n  evidence TEXT\n);\n\nCREATE VIRTUAL TABLE IF NOT EXISTS facts_fts USING fts5(\n  content,\n  category,\n  content=facts,\n  content_rowid=id,\n  tokenize='porter'\n);\n\nCREATE TRIGGER IF NOT EXISTS facts_ai AFTER INSERT ON facts BEGIN\n  INSERT INTO facts_fts(rowid, content, category) VALUES (new.id, new.content, new.category);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS facts_ad AFTER DELETE ON facts BEGIN\n  INSERT INTO facts_fts(facts_fts, rowid, content, category) VALUES ('delete', old.id, old.content, old.category);\nEND;\n\nCREATE TRIGGER IF NOT EXISTS facts_au AFTER UPDATE ON facts BEGIN\n  INSERT INTO facts_fts(facts_fts, rowid, content, category) VALUES ('delete', old.id, old.content, old.category);\n  INSERT INTO facts_fts(rowid, content, category) VALUES (new.id, new.content, new.category);\nEND;\n\nCREATE INDEX IF NOT EXISTS idx_sessions_started_at ON sessions(started_at DESC);\nCREATE INDEX IF NOT EXISTS idx_facts_session_id ON facts(session_id);\n\n-- v2: Fingerprint uniqueness for WAL replay. The four-field key (content,\n-- created_at, session_id, category) is the stable identity used by supersede\n-- WAL entries to locate rows across crash+restart cycles. Without a UNIQUE\n-- constraint, same-ms duplicate inserts make .get() return an arbitrary row.\n-- NULL session_id is coerced to the empty string so it participates in the\n-- uniqueness check (SQLite treats NULLs as distinct in UNIQUE indexes).\nCREATE UNIQUE INDEX IF NOT EXISTS idx_facts_fingerprint\n  ON facts(content, created_at, COALESCE(session_id, ''), category);\n";
+export declare function runMigrations(db: BetterSqlite3.Database, existingVersion: number): void;
+export declare function enableWalMode(db: BetterSqlite3.Database): void;
+export declare function sleepSync(ms: number): void;

package/dist/agent/memory/memory-store.wal.d.ts

@@ -0,0 +1,5 @@
+import type BetterSqlite3 from 'better-sqlite3';
+import type { WALEntry } from './types.js';
+export declare function isValidWALEntry(entry: unknown): entry is WALEntry;
+export declare function appendWAL(dir: string, entry: WALEntry): void;
+export declare function replayWAL(db: BetterSqlite3.Database, dir: string): number;

package/dist/agent/memory/memory-tools.input.d.ts

@@ -0,0 +1,23 @@
+import type { FactCategory, MemoryUpdateAction, MemoryUpdateTarget } from './types.js';
+export interface MemorySearchInput {
+    query: string;
+    category?: FactCategory;
+    since?: string;
+    limit?: number;
+}
+export declare function parseMemorySearchInput(input: unknown): MemorySearchInput;
+export interface MemoryUpdateInput {
+    target: MemoryUpdateTarget;
+    action: MemoryUpdateAction;
+    content?: string;
+    category?: FactCategory;
+    evidence?: string;
+    supersedes?: number;
+    id?: number;
+}
+export declare function parseMemoryUpdateInput(input: unknown): MemoryUpdateInput;
+export interface ProcedureWriteInput {
+    name: string;
+    content: string;
+}
+export declare function parseProcedureWriteInput(input: unknown): ProcedureWriteInput;