@inixiative/foundry-core 0.2.0 → 0.3.0

package/src/adapters/http-memory.ts

@@ -1,6 +1,6 @@
-import type { ContextSource } from "../context-layer";
-import type { HydrationAdapter, ContextRef } from "../hydrator";
-import type { Signal } from "../signal";
+import type { ContextSource } from '../context-layer';
+import type { ContextRef, HydrationAdapter } from '../hydrator';
+import type { Signal } from '../signal';
 
 /**
  * HTTP/REST adapter.
@@ -23,9 +23,9 @@ export class HttpMemory {
     opts?: {
       headers?: Record<string, string>;
       timeout?: number;
-    }
+    },
   ) {
-    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.baseUrl = baseUrl.replace(/\/$/, '');
     this._headers = opts?.headers ?? {};
     this._timeout = opts?.timeout ?? 10_000;
   }
@@ -48,10 +48,10 @@ export class HttpMemory {
       throw new Error(`HTTP ${res.status}: ${res.statusText} (${url.pathname})`);
     }
 
-    const ct = res.headers.get("content-type") ?? "";
-    if (ct.includes("application/json")) {
+    const ct = res.headers.get('content-type') ?? '';
+    if (ct.includes('application/json')) {
       const json = await res.json();
-      return typeof json === "string" ? json : JSON.stringify(json, null, 2);
+      return typeof json === 'string' ? json : JSON.stringify(json, null, 2);
     }
 
     return res.text();
@@ -62,8 +62,8 @@ export class HttpMemory {
     const url = new URL(path, this.baseUrl);
 
     const res = await fetch(url.toString(), {
-      method: "POST",
-      headers: { ...this._headers, "Content-Type": "application/json" },
+      method: 'POST',
+      headers: { ...this._headers, 'Content-Type': 'application/json' },
       body: JSON.stringify(body),
       signal: AbortSignal.timeout(this._timeout),
     });
@@ -72,10 +72,10 @@ export class HttpMemory {
       throw new Error(`HTTP ${res.status}: ${res.statusText} (${url.pathname})`);
     }
 
-    const ct = res.headers.get("content-type") ?? "";
-    if (ct.includes("application/json")) {
+    const ct = res.headers.get('content-type') ?? '';
+    if (ct.includes('application/json')) {
       const json = await res.json();
-      return typeof json === "string" ? json : JSON.stringify(json, null, 2);
+      return typeof json === 'string' ? json : JSON.stringify(json, null, 2);
     }
 
     return res.text();
@@ -85,11 +85,7 @@ export class HttpMemory {
    * Create a ContextSource that fetches from a GET endpoint.
    * The response body becomes the context content.
    */
-  asSource(
-    id: string,
-    path: string,
-    params?: Record<string, string>
-  ): ContextSource {
+  asSource(id: string, path: string, params?: Record<string, string>): ContextSource {
     const http = this;
     return {
       id,
@@ -98,7 +94,7 @@ export class HttpMemory {
           return await http.get(path, params);
         } catch (err) {
           console.warn(`[HttpMemory] source load failed for "${id}":`, (err as Error).message);
-          return "";
+          return '';
         }
       },
     };
@@ -108,7 +104,7 @@ export class HttpMemory {
    * Create a HydrationAdapter.
    * Refs use paths as locators, fetched via GET.
    */
-  asAdapter(system: string = "http"): HydrationAdapter {
+  asAdapter(system: string = 'http'): HydrationAdapter {
     const http = this;
     return {
       system,
@@ -118,7 +114,7 @@ export class HttpMemory {
           return await http.get(ref.locator, params);
         } catch (err) {
           console.warn(`[HttpMemory] hydrate failed for "${ref.locator}":`, (err as Error).message);
-          return "";
+          return '';
         }
       },
     };
@@ -128,11 +124,10 @@ export class HttpMemory {
    * Create a signal writer that POSTs signals to an endpoint.
    * Use this to forward signals to an external system.
    */
-  signalWriter(path: string = "/signals") {
-    const http = this;
+  signalWriter(path: string = '/signals') {
     return async (signal: Signal): Promise<void> => {
       try {
-        await http.post(path, signal);
+        await this.post(path, signal);
       } catch (err) {
         console.warn(`[HttpMemory] signal forwarding failed:`, (err as Error).message);
       }

package/src/adapters/index.ts

@@ -1,4 +1,4 @@
-export { FileMemory, inlineSource, fileSource, type MemoryEntry } from "./file-memory";
-export { SqliteMemory, type SqliteEntry } from "./sqlite-memory";
-export { HttpMemory } from "./http-memory";
-export { MarkdownDocs, claudemdSource } from "./markdown-docs";
+export { FileMemory, fileSource, inlineSource, type MemoryEntry } from './file-memory';
+export { HttpMemory } from './http-memory';
+export { claudemdSource, MarkdownDocs } from './markdown-docs';
+export { type SqliteEntry, SqliteMemory } from './sqlite-memory';

package/src/adapters/markdown-docs.ts

@@ -1,6 +1,6 @@
-import { join, relative, basename, extname } from "node:path";
-import type { ContextSource } from "../context-layer";
-import type { HydrationAdapter, ContextRef } from "../hydrator";
+import { basename, extname, join, relative } from 'node:path';
+import type { ContextSource } from '../context-layer';
+import type { ContextRef, HydrationAdapter } from '../hydrator';
 
 /**
  * Markdown directory adapter.
@@ -22,7 +22,7 @@ export class MarkdownDocs {
    * @param dir — root directory to scan
    * @param glob — file pattern (default: all .md files recursively)
    */
-  constructor(dir: string, glob: string = "**/*.md") {
+  constructor(dir: string, glob: string = '**/*.md') {
     this.dir = dir;
     this.glob = glob;
   }
@@ -55,7 +55,7 @@ export class MarkdownDocs {
   async readFile(relPath: string): Promise<string> {
     const absPath = join(this.dir, relPath);
     const file = Bun.file(absPath);
-    if (!(await file.exists())) return "";
+    if (!(await file.exists())) return '';
     return file.text();
   }
 
@@ -79,13 +79,13 @@ export class MarkdownDocs {
       id,
       async load() {
         const files = await docs.load();
-        if (files.size === 0) return "";
+        if (files.size === 0) return '';
 
         const parts: string[] = [];
         for (const [path, content] of files) {
           parts.push(`## ${path}\n\n${content}`);
         }
-        return parts.join("\n\n---\n\n");
+        return parts.join('\n\n---\n\n');
       },
     };
   }
@@ -130,25 +130,25 @@ export class MarkdownDocs {
       id,
       async load() {
         const files = await docs.load();
-        if (files.size === 0) return "";
+        if (files.size === 0) return '';
 
         const lines: string[] = [];
         const paths = [...files.keys()].sort();
 
         for (const path of paths) {
-          const content = files.get(path) ?? "";
+          const content = files.get(path) ?? '';
           if (!content.trim()) continue;
 
           const { title, headings } = extractHeadings(content, maxHeadings);
           const displayTitle = title ?? basename(path, extname(path));
           lines.push(`${path} — ${displayTitle}`);
           if (headings.length > 0) {
-            lines.push(`  H2: ${headings.join(", ")}`);
+            lines.push(`  H2: ${headings.join(', ')}`);
           }
-          lines.push("");
+          lines.push('');
         }
 
-        return lines.join("\n").trimEnd();
+        return lines.join('\n').trimEnd();
       },
     };
   }
@@ -157,7 +157,7 @@ export class MarkdownDocs {
   asAdapter(): HydrationAdapter {
     const docs = this;
     return {
-      system: "markdown",
+      system: 'markdown',
       async hydrate(ref: ContextRef): Promise<string> {
         return docs.readFile(ref.locator);
       },
@@ -178,7 +178,7 @@ function extractHeadings(
 ): { title: string | null; headings: string[] } {
   let title: string | null = null;
   const headings: string[] = [];
-  const lines = content.split("\n");
+  const lines = content.split('\n');
 
   for (const line of lines) {
     if (title === null) {
@@ -206,7 +206,7 @@ export function claudemdSource(id: string, path: string): ContextSource {
     id,
     async load() {
       const file = Bun.file(path);
-      if (!(await file.exists())) return "";
+      if (!(await file.exists())) return '';
       return file.text();
     },
   };

package/src/adapters/sqlite-memory.ts

@@ -1,7 +1,7 @@
-import { Database } from "bun:sqlite";
-import type { ContextSource } from "../context-layer";
-import type { HydrationAdapter, ContextRef } from "../hydrator";
-import type { Signal } from "../signal";
+import { Database } from 'bun:sqlite';
+import type { ContextSource } from '../context-layer';
+import type { ContextRef, HydrationAdapter } from '../hydrator';
+import type { Signal } from '../signal';
 
 /**
  * SQLite-backed memory system.
@@ -12,7 +12,7 @@ import type { Signal } from "../signal";
 export class SqliteMemory {
   readonly db: Database;
 
-  constructor(path: string = ":memory:") {
+  constructor(path: string = ':memory:') {
     this.db = new Database(path, { create: true });
     this._init();
   }
@@ -58,21 +58,28 @@ export class SqliteMemory {
   write(entry: SqliteEntry): void {
     this.db.run(
       `INSERT OR REPLACE INTO entries (id, kind, content, source, timestamp, meta) VALUES (?, ?, ?, ?, ?, ?)`,
-      [entry.id, entry.kind, entry.content, entry.source ?? null, entry.timestamp, entry.meta ? JSON.stringify(entry.meta) : null]
+      [
+        entry.id,
+        entry.kind,
+        entry.content,
+        entry.source ?? null,
+        entry.timestamp,
+        entry.meta ? JSON.stringify(entry.meta) : null,
+      ],
     );
   }
 
   /** Read by id. */
   get(id: string): SqliteEntry | undefined {
-    const row = this.db.query("SELECT * FROM entries WHERE id = ?").get(id) as any;
+    const row = this.db.query('SELECT * FROM entries WHERE id = ?').get(id) as any;
     return row ? this._rowToEntry(row) : undefined;
   }
 
   /** Get all entries, optionally filtered by kind. */
   all(kind?: string): SqliteEntry[] {
     const query = kind
-      ? this.db.query("SELECT * FROM entries WHERE kind = ? ORDER BY timestamp DESC")
-      : this.db.query("SELECT * FROM entries ORDER BY timestamp DESC");
+      ? this.db.query('SELECT * FROM entries WHERE kind = ? ORDER BY timestamp DESC')
+      : this.db.query('SELECT * FROM entries ORDER BY timestamp DESC');
     const rows = kind ? query.all(kind) : query.all();
     return (rows as any[]).map(this._rowToEntry);
   }
@@ -81,7 +88,7 @@ export class SqliteMemory {
   search(query: string, limit: number = 20): SqliteEntry[] {
     const rows = this.db
       .query(
-        `SELECT entries.* FROM entries_fts JOIN entries ON entries_fts.id = entries.id WHERE entries_fts MATCH ? ORDER BY rank LIMIT ?`
+        `SELECT entries.* FROM entries_fts JOIN entries ON entries_fts.id = entries.id WHERE entries_fts MATCH ? ORDER BY rank LIMIT ?`,
       )
       .all(query, limit);
     return (rows as any[]).map(this._rowToEntry);
@@ -89,15 +96,15 @@ export class SqliteMemory {
 
   /** Delete by id. */
   delete(id: string): boolean {
-    const result = this.db.run("DELETE FROM entries WHERE id = ?", [id]);
+    const result = this.db.run('DELETE FROM entries WHERE id = ?', [id]);
     return result.changes > 0;
   }
 
   /** Count entries, optionally by kind. */
   count(kind?: string): number {
     const query = kind
-      ? this.db.query("SELECT COUNT(*) as c FROM entries WHERE kind = ?")
-      : this.db.query("SELECT COUNT(*) as c FROM entries");
+      ? this.db.query('SELECT COUNT(*) as c FROM entries WHERE kind = ?')
+      : this.db.query('SELECT COUNT(*) as c FROM entries');
     const row = (kind ? query.get(kind) : query.get()) as any;
     return row.c;
   }
@@ -105,8 +112,8 @@ export class SqliteMemory {
   /** Recent entries. */
   recent(limit: number = 50, kind?: string): SqliteEntry[] {
     const query = kind
-      ? this.db.query("SELECT * FROM entries WHERE kind = ? ORDER BY timestamp DESC LIMIT ?")
-      : this.db.query("SELECT * FROM entries ORDER BY timestamp DESC LIMIT ?");
+      ? this.db.query('SELECT * FROM entries WHERE kind = ? ORDER BY timestamp DESC LIMIT ?')
+      : this.db.query('SELECT * FROM entries ORDER BY timestamp DESC LIMIT ?');
     const rows = kind ? query.all(kind, limit) : query.all(limit);
     return (rows as any[]).map(this._rowToEntry);
   }
@@ -118,10 +125,8 @@ export class SqliteMemory {
       id,
       async load() {
         const entries = mem.recent(limit, kind);
-        if (entries.length === 0) return "";
-        return entries
-          .map((e) => `[${e.kind}] ${e.id}: ${e.content}`)
-          .join("\n");
+        if (entries.length === 0) return '';
+        return entries.map((e) => `[${e.kind}] ${e.id}: ${e.content}`).join('\n');
       },
     };
   }
@@ -130,15 +135,15 @@ export class SqliteMemory {
   asAdapter(): HydrationAdapter {
     const mem = this;
     return {
-      system: "sqlite",
+      system: 'sqlite',
       async hydrate(ref: ContextRef): Promise<string> {
         const entry = mem.get(ref.locator);
-        return entry ? entry.content : "";
+        return entry ? entry.content : '';
       },
       async hydrateBatch(refs: ContextRef[]): Promise<string[]> {
         return refs.map((r) => {
           const entry = mem.get(r.locator);
-          return entry ? entry.content : "";
+          return entry ? entry.content : '';
         });
       },
     };
@@ -146,15 +151,12 @@ export class SqliteMemory {
 
   /** Signal handler that writes signals to SQLite. */
   signalWriter() {
-    const mem = this;
     return async (signal: Signal): Promise<void> => {
-      mem.write({
+      this.write({
         id: signal.id,
         kind: signal.kind,
         content:
-          typeof signal.content === "string"
-            ? signal.content
-            : JSON.stringify(signal.content),
+          typeof signal.content === 'string' ? signal.content : JSON.stringify(signal.content),
         source: signal.source,
         timestamp: signal.timestamp,
         meta: { confidence: signal.confidence, refs: signal.refs },

package/src/base-agent.ts

@@ -1,6 +1,6 @@
-import type { TokenCounts } from "./token-counts";
-import { computeHash } from "./context-layer";
-import { ContextStack, type LayerFilter, type AssembledContext } from "./context-stack";
+import { computeHash } from './context-layer';
+import type { AssembledContext, ContextStack, LayerFilter } from './context-stack';
+import type { TokenCounts } from './token-counts';
 
 export interface ExecutionResult<T = unknown> {
   readonly output: T;
@@ -72,9 +72,7 @@ export abstract class BaseAgent<TPayload = unknown, TResult = unknown> {
   }
 
   getContext(): string {
-    return this._layerFilter
-      ? this._stack.slice(this._layerFilter)
-      : this._stack.merge();
+    return this._layerFilter ? this._stack.slice(this._layerFilter) : this._stack.merge();
   }
 
   /**
@@ -99,7 +97,7 @@ export abstract class BaseAgent<TPayload = unknown, TResult = unknown> {
   abstract run(
     payload: TPayload,
     filterOverride?: LayerFilter,
-    meta?: Record<string, unknown>
+    meta?: Record<string, unknown>,
   ): Promise<ExecutionResult<TResult>>;
 
   /**

package/src/cache-lifecycle.ts

@@ -1,5 +1,5 @@
-import { ContextLayer, type LayerState } from "./context-layer";
-import { ContextStack } from "./context-stack";
+import type { ContextLayer, LayerState } from './context-layer';
+import type { ContextStack } from './context-stack';
 
 export interface LifecycleEvent {
   readonly type: string;
@@ -8,19 +8,13 @@ export interface LifecycleEvent {
   readonly meta?: Record<string, unknown>;
 }
 
-export type LifecycleHandler = (
-  event: LifecycleEvent
-) => void | false | Promise<void | false>;
+export type LifecycleHandler = (event: LifecycleEvent) => void | false | Promise<void | false>;
 
 export interface LifecycleRule {
   readonly id: string;
   readonly triggers: LayerState[];
   readonly layerIds?: string[];
-  action(
-    layer: ContextLayer,
-    state: LayerState,
-    stack: ContextStack
-  ): Promise<void>;
+  action(layer: ContextLayer, state: LayerState, stack: ContextStack): Promise<void>;
 }
 
 /**
@@ -156,26 +150,32 @@ export class CacheLifecycle {
                 // Best-effort error event — if this also throws, outer catch handles it
                 try {
                   await this.emit({
-                    type: "rule:error",
+                    type: 'rule:error',
                     layerId: layer.id,
                     timestamp: Date.now(),
                     meta: { ruleId: rule.id, error: err },
                   });
                 } catch (emitErr) {
-                  console.warn(`[CacheLifecycle] failed to emit rule:error for ${layer.id}:`, (emitErr as Error).message);
+                  console.warn(
+                    `[CacheLifecycle] failed to emit rule:error for ${layer.id}:`,
+                    (emitErr as Error).message,
+                  );
                 }
               }
             }
           } catch (err) {
             try {
               await this.emit({
-                type: "lifecycle:error",
+                type: 'lifecycle:error',
                 layerId: layer.id,
                 timestamp: Date.now(),
                 meta: { error: err },
               });
             } catch (emitErr) {
-              console.warn(`[CacheLifecycle] failed to emit lifecycle:error for ${layer.id}:`, (emitErr as Error).message);
+              console.warn(
+                `[CacheLifecycle] failed to emit lifecycle:error for ${layer.id}:`,
+                (emitErr as Error).message,
+              );
             }
           }
         }