Core exposes buildIndex/searchText/executeQuery/executeAttune as the single shared implementation for all transports. First TypeScript module, run via Node type stripping in dev. Adds typescript-eslint. lint/typecheck green, test 107/107.
65 lines
2.3 KiB
TypeScript
65 lines
2.3 KiB
TypeScript
// Obelisk Core (see docs/adr/0003-core-typescript-esm-precompiled.md).
|
|
//
|
|
// The single shared implementation behind every transport. runtime.mjs (skill),
|
|
// and later the CLI and MCP server, are thin shells over these four functions;
|
|
// none of them re-implement retrieval or own the DB lifecycle.
|
|
//
|
|
// Authored in TypeScript with erasable-only syntax so Node can run it directly
|
|
// via type stripping in development, while the skill artifact ships the tsc
|
|
// output (Phase 6). The heavy internals (db/indexer/query) remain .mjs for now
|
|
// and are migrated in later phases; Core is the typed seam over them.
|
|
|
|
import { createContext, runInNewContext } from 'node:vm';
|
|
|
|
import { DB_PATH, openDb } from './db.mjs';
|
|
import { buildIndex } from './indexer.mjs';
|
|
import { createQueryApi, createAttuneApi } from './query.mjs';
|
|
|
|
export { buildIndex, DB_PATH };
|
|
|
|
type SandboxApi = Record<string, unknown>;
|
|
|
|
// Run a user-supplied CodeAct script inside the query/attune sandbox. The script
|
|
// body runs as an async IIFE with a 30s timeout; its `return` value is resolved.
|
|
function runInSandbox(api: SandboxApi, scriptContent: string): Promise<unknown> {
|
|
const sandbox = {
|
|
...api, JSON, Math, Array, Object, Set, Map, Date, RegExp,
|
|
parseInt, parseFloat, String, Number, Boolean, Error, Promise, console, setTimeout,
|
|
};
|
|
const ctx = createContext(sandbox);
|
|
return runInNewContext(`(async()=>{${scriptContent}})()`, ctx, { timeout: 30000 });
|
|
}
|
|
|
|
// FTS search over indexed message text. Refreshes the index, then queries.
|
|
export function searchText(text: string, opts?: Record<string, unknown>): unknown {
|
|
buildIndex();
|
|
const db = openDb();
|
|
try {
|
|
return createQueryApi(db).search(text, opts);
|
|
} finally {
|
|
db.close();
|
|
}
|
|
}
|
|
|
|
// Execute a read-only CodeAct query script and resolve its returned value.
|
|
export async function executeQuery(scriptContent: string): Promise<unknown> {
|
|
buildIndex();
|
|
const db = openDb();
|
|
try {
|
|
return await runInSandbox(createQueryApi(db), scriptContent);
|
|
} finally {
|
|
db.close();
|
|
}
|
|
}
|
|
|
|
// Execute a memory-mutation CodeAct script (remember/forget only).
|
|
export async function executeAttune(scriptContent: string): Promise<unknown> {
|
|
buildIndex();
|
|
const db = openDb();
|
|
try {
|
|
return await runInSandbox(createAttuneApi(db), scriptContent);
|
|
} finally {
|
|
db.close();
|
|
}
|
|
}
|