@xopcai/xopc 0.0.116 → 0.0.118

package/dist/src/storage/sqlite/migrations/012_memory_records.sql

@@ -0,0 +1,63 @@
+CREATE TABLE IF NOT EXISTS memory_records (
+  record_id       TEXT PRIMARY KEY,
+  provider_id     TEXT NOT NULL,
+  kind            TEXT NOT NULL,
+  agent_id        TEXT NOT NULL,
+  workspace_id    TEXT,
+  session_key     TEXT,
+  content         TEXT NOT NULL,
+  source_json     TEXT NOT NULL,
+  confidence      REAL,
+  tags_json       TEXT NOT NULL DEFAULT '[]',
+  created_at      INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL,
+  last_recalled_at INTEGER,
+  recall_count    INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_records_scope_updated
+  ON memory_records(agent_id, workspace_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_records_kind_updated
+  ON memory_records(kind, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_records_provider
+  ON memory_records(provider_id, updated_at DESC);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_records_fts USING fts5(
+  content,
+  record_id UNINDEXED,
+  provider_id UNINDEXED,
+  kind UNINDEXED,
+  agent_id UNINDEXED,
+  workspace_id UNINDEXED,
+  tokenize='unicode61'
+);
+
+CREATE TABLE IF NOT EXISTS memory_signals (
+  signal_id     TEXT PRIMARY KEY,
+  source        TEXT NOT NULL,
+  record_id     TEXT,
+  provider_id   TEXT,
+  agent_id      TEXT,
+  workspace_id  TEXT,
+  session_key   TEXT,
+  score         REAL,
+  content       TEXT,
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at    INTEGER NOT NULL,
+  FOREIGN KEY (record_id) REFERENCES memory_records(record_id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_signals_created
+  ON memory_signals(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_signals_record_created
+  ON memory_signals(record_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_signals_scope_created
+  ON memory_signals(agent_id, workspace_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS memory_provider_state (
+  provider_id TEXT NOT NULL,
+  scope_key   TEXT NOT NULL,
+  state_json  TEXT NOT NULL,
+  updated_at  INTEGER NOT NULL,
+  PRIMARY KEY (provider_id, scope_key)
+);

package/dist/src/storage/sqlite/migrations/013_memory_trace_events.sql

@@ -0,0 +1,21 @@
+CREATE TABLE IF NOT EXISTS memory_trace_events (
+  trace_id              TEXT PRIMARY KEY,
+  session_key           TEXT,
+  turn_id               TEXT,
+  phase                 TEXT NOT NULL,
+  provider_id           TEXT NOT NULL,
+  request_json          TEXT NOT NULL DEFAULT '{}',
+  result_count          INTEGER,
+  selected_record_ids_json TEXT NOT NULL DEFAULT '[]',
+  skipped_reason        TEXT,
+  error                 TEXT,
+  duration_ms           INTEGER NOT NULL DEFAULT 0,
+  created_at            INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_trace_created
+  ON memory_trace_events(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_trace_provider_created
+  ON memory_trace_events(provider_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_trace_session_created
+  ON memory_trace_events(session_key, created_at DESC);

package/dist/src/storage/sqlite/migrations/014_memory_record_governance.sql

@@ -0,0 +1,10 @@
+ALTER TABLE memory_records ADD COLUMN status TEXT NOT NULL DEFAULT 'active';
+ALTER TABLE memory_records ADD COLUMN sensitivity TEXT NOT NULL DEFAULT 'normal';
+ALTER TABLE memory_records ADD COLUMN evidence_json TEXT NOT NULL DEFAULT '[]';
+ALTER TABLE memory_records ADD COLUMN review_after INTEGER;
+ALTER TABLE memory_records ADD COLUMN expires_at INTEGER;
+
+CREATE INDEX IF NOT EXISTS idx_memory_records_status_updated
+  ON memory_records(status, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_records_status_scope_updated
+  ON memory_records(status, agent_id, workspace_id, updated_at DESC);

package/dist/src/storage/sqlite/migrations/015_memory_trace_feedback.sql

@@ -0,0 +1,4 @@
+ALTER TABLE memory_trace_events ADD COLUMN feedback_json TEXT NOT NULL DEFAULT '{}';
+
+CREATE INDEX IF NOT EXISTS idx_memory_trace_phase_created
+  ON memory_trace_events(phase, created_at DESC);

package/dist/src/storage/sqlite/migrations/discover.js

@@ -1,5 +1,5 @@
-import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
 //#region src/storage/sqlite/migrations/discover.ts
 /** Matches `002_add_notes_index.sql` → target version 2. */
 const MIGRATION_FILENAME = /^(\d{3})_[\w-]+\.sql$/;

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 11;
+export declare const XOPC_DB_SCHEMA_VERSION = 15;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -3,8 +3,8 @@ import { init_logger } from "../../../utils/logger.js";
 import { readSchemaVersion, setSchemaVersion } from "../schema-version.js";
 import { discoverSqlMigrations } from "./discover.js";
 import { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError } from "./errors.js";
-import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { existsSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 //#region src/storage/sqlite/migrations/runner.ts
 init_logger();
@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 11;
+const XOPC_DB_SCHEMA_VERSION = 15;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function resolveMigrationsDir(override) {
 	if (override) return override;
@@ -46,7 +46,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 11;
+	const targetVersion = options.targetVersion ?? 15;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -62,7 +62,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 11;
+	const appVersion = options.targetVersion ?? 15;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

package/dist/src/storage/sqlite/migrations/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 11;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}
+{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 15;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 11;
+export const XOPC_DB_SCHEMA_VERSION = 15;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/schema.js

@@ -1,7 +1,7 @@
 import { SCHEMA_META_SCHEMA_VERSION_KEY, ensureSchemaMetaTable, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion } from "./schema-version.js";
 import { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMigrations } from "./migrations/runner.js";
-import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 //#region src/storage/sqlite/schema.ts
 const SCHEMA_DIR = dirname(fileURLToPath(import.meta.url));
@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 11;
 	}
-	applyPendingMigrations(db, { targetVersion: 11 });
+	applyPendingMigrations(db, { targetVersion: 15 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };

package/dist/src/storage/sqlite/schema.sql

@@ -278,6 +278,92 @@ CREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(
   tokenize='unicode61'
 );
 
+CREATE TABLE IF NOT EXISTS memory_records (
+  record_id       TEXT PRIMARY KEY,
+  provider_id     TEXT NOT NULL,
+  kind            TEXT NOT NULL,
+  agent_id        TEXT NOT NULL,
+  workspace_id    TEXT,
+  session_key     TEXT,
+  content         TEXT NOT NULL,
+  source_json     TEXT NOT NULL,
+  confidence      REAL,
+  tags_json       TEXT NOT NULL DEFAULT '[]',
+  created_at      INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL,
+  last_recalled_at INTEGER,
+  recall_count    INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_records_scope_updated
+  ON memory_records(agent_id, workspace_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_records_kind_updated
+  ON memory_records(kind, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_records_provider
+  ON memory_records(provider_id, updated_at DESC);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_records_fts USING fts5(
+  content,
+  record_id UNINDEXED,
+  provider_id UNINDEXED,
+  kind UNINDEXED,
+  agent_id UNINDEXED,
+  workspace_id UNINDEXED,
+  tokenize='unicode61'
+);
+
+CREATE TABLE IF NOT EXISTS memory_signals (
+  signal_id     TEXT PRIMARY KEY,
+  source        TEXT NOT NULL,
+  record_id     TEXT,
+  provider_id   TEXT,
+  agent_id      TEXT,
+  workspace_id  TEXT,
+  session_key   TEXT,
+  score         REAL,
+  content       TEXT,
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at    INTEGER NOT NULL,
+  FOREIGN KEY (record_id) REFERENCES memory_records(record_id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_signals_created
+  ON memory_signals(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_signals_record_created
+  ON memory_signals(record_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_signals_scope_created
+  ON memory_signals(agent_id, workspace_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS memory_provider_state (
+  provider_id TEXT NOT NULL,
+  scope_key   TEXT NOT NULL,
+  state_json  TEXT NOT NULL,
+  updated_at  INTEGER NOT NULL,
+  PRIMARY KEY (provider_id, scope_key)
+);
+
+CREATE TABLE IF NOT EXISTS memory_trace_events (
+  trace_id              TEXT PRIMARY KEY,
+  session_key           TEXT,
+  turn_id               TEXT,
+  phase                 TEXT NOT NULL,
+  provider_id           TEXT NOT NULL,
+  request_json          TEXT NOT NULL DEFAULT '{}',
+  result_count          INTEGER,
+  selected_record_ids_json TEXT NOT NULL DEFAULT '[]',
+  skipped_reason        TEXT,
+  error                 TEXT,
+  duration_ms           INTEGER NOT NULL DEFAULT 0,
+  created_at            INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_trace_created
+  ON memory_trace_events(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_trace_provider_created
+  ON memory_trace_events(provider_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_memory_trace_session_created
+  ON memory_trace_events(session_key, created_at DESC);
+
 CREATE TABLE IF NOT EXISTS goals (
   goal_id              TEXT PRIMARY KEY,
   title                TEXT NOT NULL,

package/dist/src/tui/backends/embedded-backend.d.ts

@@ -17,6 +17,7 @@ export declare class EmbeddedBackend implements TuiBackend {
     private readonly opts?;
     private bus;
     private agent;
+    private agentLoading;
     private config;
     private workspace;
     private sessionIndex;
@@ -30,6 +31,8 @@ export declare class EmbeddedBackend implements TuiBackend {
     constructor(opts?: EmbeddedBackendOptions);
     get connectionLabel(): string;
     start(): void;
+    private ensureAgent;
+    private createAgent;
     stop(): void;
     getActiveSignal(): AbortSignal | undefined;
     private getWorkflowRunService;

package/dist/src/tui/backends/embedded-backend.js

@@ -1,12 +1,12 @@
+import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId } from "../../agent/agent-scope.js";
+import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../../routing/agent-session-key.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { loadConfig } from "../../config/loader.js";
-import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../../routing/agent-session-key.js";
-import { getAvailableModels, init_providers } from "../../providers/index.js";
+import { createCreateShareTool, isShareToolAvailable } from "../../agent/tools/create-share-tool.js";
 import { openXopcDatabase } from "../../storage/sqlite/connection.js";
 import "../../storage/sqlite/index.js";
-import { createCreateShareTool, isShareToolAvailable } from "../../agent/tools/create-share-tool.js";
 import { evictEmbeddedSessionRunner } from "../../agent/embedded/session-runner.js";
 import { prependEnvelopeTimestamp } from "../../channels/envelope-timestamp.js";
 import { SessionIndex } from "../../session/manager.js";
@@ -15,8 +15,6 @@ import "../../session/index.js";
 import { parseModelRef } from "../../agent/models/selection.js";
 import { MessageBus, MessageBusShutdownError } from "../../infra/bus/queue.js";
 import "../../infra/bus/index.js";
-import { AgentService } from "../../agent/service.js";
-import "../../agent/index.js";
 import { getWorkspacePath } from "../../config/workspace-path-helpers.js";
 import "../../config/index.js";
 import { buildWorkflowChildTools } from "../../agent/workflow/workflow-child-tools.js";
@@ -32,7 +30,7 @@ import { isAbsolute, relative, resolve } from "node:path";
 //#region src/tui/backends/embedded-backend.ts
 init_agent_scope();
 init_agent_session_key();
-init_providers();
+init_schema();
 init_logger();
 const log = createLogger("TUI:Embedded");
 function isPathSameOrInside(parentDir, childDir) {
@@ -48,6 +46,7 @@ function isPathSameOrInside(parentDir, childDir) {
 var EmbeddedBackend = class {
 	bus;
 	agent = null;
+	agentLoading = null;
 	config = null;
 	workspace = "";
 	sessionIndex = null;
@@ -72,7 +71,6 @@ var EmbeddedBackend = class {
 		this.config = config;
 		const workspace = getWorkspacePath(config);
 		this.workspace = workspace;
-		const modelId = config.agents?.defaults?.models?.chat?.primary;
 		openXopcDatabase();
 		this.sessionIndex = new SessionIndex({ config });
 		this.sessionIndexReady = this.sessionIndex.initialize().catch((err) => {
@@ -83,11 +81,39 @@ var EmbeddedBackend = class {
 			}, `Embedded session index initialization failed: ${errorMessage}`);
 			throw err;
 		});
-		this.agent = new AgentService(this.bus, {
+		this.onConnected?.();
+		setTimeout(() => {
+			this.ensureAgent().catch((err) => {
+				const errorMessage = err instanceof Error ? err.message : String(err);
+				log.error({
+					err,
+					errorMessage
+				}, `Embedded agent failed: ${errorMessage}`);
+				this.onDisconnected?.(errorMessage);
+			});
+		}, 750);
+		this.processOutbound();
+	}
+	async ensureAgent() {
+		if (this.agent) return this.agent;
+		if (this.agentLoading) return this.agentLoading;
+		if (!this.config || !this.sessionIndex) throw new Error("Embedded backend not started");
+		this.agentLoading = this.createAgent(this.config, this.sessionIndex);
+		try {
+			return await this.agentLoading;
+		} finally {
+			this.agentLoading = null;
+		}
+	}
+	async createAgent(config, sessionIndex) {
+		const { AgentService } = await import("../../agent/service.js");
+		const workspace = this.workspace || getWorkspacePath(config);
+		const modelId = getAgentDefaultModelRef(config);
+		const agent = new AgentService(this.bus, {
 			workspace,
 			model: modelId,
 			config,
-			sessionStore: this.sessionIndex.getStore(),
+			sessionStore: sessionIndex.getStore(),
 			getWorkflowRunService: () => this.getWorkflowRunService(),
 			extensionRegistry: this.opts?.extensionRegistry,
 			isWorkspaceTrusted: (workspaceDir) => {
@@ -97,17 +123,9 @@ var EmbeddedBackend = class {
 				if (implicit && isPathSameOrInside(implicit, workspaceDir)) return true;
 			}
 		});
-		this.agent.start().then(() => {
-			this.onConnected?.();
-		}).catch((err) => {
-			const errorMessage = err instanceof Error ? err.message : String(err);
-			log.error({
-				err,
-				errorMessage
-			}, `Embedded agent failed: ${errorMessage}`);
-			this.onDisconnected?.(errorMessage);
-		});
-		this.processOutbound();
+		this.agent = agent;
+		await agent.start();
+		return agent;
 	}
 	stop() {
 		this.running = false;
@@ -184,7 +202,7 @@ var EmbeddedBackend = class {
 		}
 	}
 	async sendChat(opts) {
-		if (!this.agent) throw new Error("Agent not started");
+		const agent = await this.ensureAgent();
 		const runId = crypto.randomUUID();
 		this.chatAbort?.abort();
 		this.chatAbort = new AbortController();
@@ -202,7 +220,7 @@ var EmbeddedBackend = class {
 		(async () => {
 			try {
 				const messageForAgent = opts.message.trimStart().startsWith("/") ? opts.message : prependEnvelopeTimestamp(opts.message);
-				const stream = this.agent.turnDispatcher.processDirectStreaming(messageForAgent, opts.sessionKey, opts.attachments, opts.thinking, {
+				const stream = agent.turnDispatcher.processDirectStreaming(messageForAgent, opts.sessionKey, opts.attachments, opts.thinking, {
 					signal,
 					runId
 				});
@@ -349,7 +367,7 @@ var EmbeddedBackend = class {
 		}
 	}
 	async getSessionInfo(sessionKey) {
-		if (!this.agent) return { model: loadConfig().agents?.defaults?.models?.chat?.primary ?? void 0 };
+		if (!this.agent) return { model: getAgentDefaultModelRef(loadConfig()) ?? void 0 };
 		try {
 			const cfg = await this.agent.sessionInspector.agentConfig(sessionKey);
 			const parsed = parseModelRef(cfg.model);
@@ -373,10 +391,11 @@ var EmbeddedBackend = class {
 				sessionKey,
 				errorMessage
 			}, `getSessionInfo failed: ${errorMessage}`);
-			return { model: loadConfig().agents?.defaults?.models?.chat?.primary ?? void 0 };
+			return { model: getAgentDefaultModelRef(loadConfig()) ?? void 0 };
 		}
 	}
 	async listModels() {
+		const { getAvailableModels } = await import("../../providers/index.js");
 		return (await getAvailableModels()).map((model) => ({
 			id: model.id,
 			name: model.name ?? model.id,