@xopcai/xopc 0.0.110 → 0.0.111

package/dist/src/goals/index.js

@@ -0,0 +1,7 @@
+import { GoalStore } from "./goal-store.js";
+import { GoalService, normalizeGoalUiLocale } from "./goal-service.js";
+import { GoalQueueStore } from "./goal-queue-store.js";
+import { GoalRunner } from "./goal-runner.js";
+import { GoalNotificationService } from "./goal-notifications.js";
+import { GoalWorkflowJudge } from "./goal-workflow-judge.js";
+export { GoalNotificationService, GoalQueueStore, GoalRunner, GoalService, GoalStore, GoalWorkflowJudge, normalizeGoalUiLocale };

package/dist/src/goals/types.d.ts

@@ -0,0 +1,119 @@
+export type GoalStatus = 'active' | 'paused' | 'blocked' | 'needs_input' | 'done' | 'archived';
+export type GoalPriority = 'low' | 'normal' | 'high';
+export type GoalSource = 'chat' | 'cli' | 'cron' | 'workflow' | 'channel' | 'api';
+export type GoalUiLocale = 'en' | 'zh';
+export type GoalChecklistStatus = 'pending' | 'completed' | 'impossible';
+export type GoalChecklistAddedBy = 'user' | 'judge';
+export type GoalRunStatus = 'running' | 'succeeded' | 'failed' | 'aborted';
+export type GoalRunVerdict = 'continue' | 'done' | 'blocked' | 'needs_input' | 'decompose';
+export interface Goal {
+    id: string;
+    title: string;
+    description?: string;
+    status: GoalStatus;
+    agentId: string;
+    priority: GoalPriority;
+    deadlineAt?: number;
+    createdAt: number;
+    updatedAt: number;
+    completedAt?: number;
+    archivedAt?: number;
+    activeSessionKey?: string;
+    currentRunId?: string;
+    nextAction?: string;
+    blockedReason?: string;
+    judgeModelRef?: string;
+    maxTurns: number;
+    turnsUsed: number;
+    uiLocale?: GoalUiLocale;
+    source: GoalSource;
+}
+export interface GoalChecklistItem {
+    id: string;
+    goalId: string;
+    text: string;
+    status: GoalChecklistStatus;
+    addedBy: GoalChecklistAddedBy;
+    addedAt: number;
+    completedAt?: number;
+    evidenceSummary?: string;
+    sortOrder: number;
+}
+export interface GoalRun {
+    id: string;
+    goalId: string;
+    sessionKey: string;
+    source: GoalSource;
+    status: GoalRunStatus;
+    startedAt: number;
+    finishedAt?: number;
+    verdict?: GoalRunVerdict;
+    reason?: string;
+    nextAction?: string;
+    assistantPreview?: string;
+    checklistProgress?: {
+        done: number;
+        total: number;
+    };
+    confidence?: number;
+    missingEvidence?: string[];
+    userQuestion?: string;
+    completedChecklistItemIds?: string[];
+}
+export interface GoalEvent {
+    id: string;
+    goalId: string;
+    runId?: string;
+    kind: string;
+    message: string;
+    data?: unknown;
+    createdAt: number;
+}
+export interface GoalEvidence {
+    id: string;
+    goalId: string;
+    runId?: string;
+    kind: 'file' | 'diff' | 'command' | 'test' | 'link' | 'message' | 'artifact';
+    title: string;
+    summary?: string;
+    uri?: string;
+    data?: unknown;
+    createdAt: number;
+}
+export interface GoalWithDetails extends Goal {
+    checklist: GoalChecklistItem[];
+    latestRun?: GoalRun;
+}
+export interface GoalListQuery {
+    status?: GoalStatus | GoalStatus[];
+    agentId?: string;
+    sessionKey?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface CreateGoalInput {
+    title: string;
+    description?: string;
+    agentId: string;
+    sessionKey?: string;
+    priority?: GoalPriority;
+    deadlineAt?: number;
+    judgeModelRef?: string;
+    maxTurns: number;
+    uiLocale?: GoalUiLocale;
+    source?: GoalSource;
+}
+export interface GoalJudgeDecision {
+    verdict: GoalRunVerdict;
+    reason: string;
+    nextAction?: string;
+    assistantPreview?: string;
+    checklistProgress?: {
+        done: number;
+        total: number;
+    };
+    confidence?: number;
+    missingEvidence?: string[];
+    userQuestion?: string;
+    completedChecklistItemIds?: string[];
+}

package/dist/src/goals/types.js

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

package/dist/src/storage/sqlite/migrations/006_add_goals.sql

@@ -0,0 +1,108 @@
+CREATE TABLE IF NOT EXISTS goals (
+  goal_id              TEXT PRIMARY KEY,
+  title                TEXT NOT NULL,
+  description          TEXT,
+  status               TEXT NOT NULL,
+  agent_id             TEXT NOT NULL,
+  priority             TEXT NOT NULL DEFAULT 'normal',
+  deadline_at          INTEGER,
+  created_at           INTEGER NOT NULL,
+  updated_at           INTEGER NOT NULL,
+  completed_at         INTEGER,
+  archived_at          INTEGER,
+  active_session_key   TEXT,
+  current_run_id       TEXT,
+  next_action          TEXT,
+  blocked_reason       TEXT,
+  judge_model_ref      TEXT,
+  max_turns            INTEGER NOT NULL,
+  turns_used           INTEGER NOT NULL DEFAULT 0,
+  ui_locale            TEXT,
+  source               TEXT NOT NULL DEFAULT 'chat'
+);
+
+CREATE INDEX IF NOT EXISTS idx_goals_status_updated
+  ON goals(status, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_goals_agent_updated
+  ON goals(agent_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_goals_active_session
+  ON goals(active_session_key);
+
+CREATE TABLE IF NOT EXISTS goal_checklist_items (
+  item_id            TEXT PRIMARY KEY,
+  goal_id            TEXT NOT NULL,
+  text               TEXT NOT NULL,
+  status             TEXT NOT NULL,
+  added_by           TEXT NOT NULL,
+  added_at           INTEGER NOT NULL,
+  completed_at       INTEGER,
+  evidence_summary   TEXT,
+  sort_order         INTEGER NOT NULL,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_checklist_goal_order
+  ON goal_checklist_items(goal_id, sort_order);
+
+CREATE TABLE IF NOT EXISTS goal_runs (
+  run_id              TEXT PRIMARY KEY,
+  goal_id             TEXT NOT NULL,
+  session_key         TEXT NOT NULL,
+  source              TEXT NOT NULL,
+  status              TEXT NOT NULL,
+  started_at          INTEGER NOT NULL,
+  finished_at         INTEGER,
+  verdict             TEXT,
+  reason              TEXT,
+  next_action         TEXT,
+  assistant_preview   TEXT,
+  checklist_done      INTEGER,
+  checklist_total     INTEGER,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_runs_goal_started
+  ON goal_runs(goal_id, started_at DESC);
+CREATE INDEX IF NOT EXISTS idx_goal_runs_session_started
+  ON goal_runs(session_key, started_at DESC);
+
+CREATE TABLE IF NOT EXISTS goal_events (
+  event_id       TEXT PRIMARY KEY,
+  goal_id        TEXT NOT NULL,
+  run_id         TEXT,
+  kind           TEXT NOT NULL,
+  message        TEXT NOT NULL,
+  data_json      TEXT,
+  created_at     INTEGER NOT NULL,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_events_goal_created
+  ON goal_events(goal_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS goal_evidence (
+  evidence_id   TEXT PRIMARY KEY,
+  goal_id       TEXT NOT NULL,
+  run_id        TEXT,
+  kind          TEXT NOT NULL,
+  title         TEXT NOT NULL,
+  summary       TEXT,
+  uri           TEXT,
+  data_json     TEXT,
+  created_at    INTEGER NOT NULL,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_evidence_goal_created
+  ON goal_evidence(goal_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS goal_session_links (
+  goal_id       TEXT NOT NULL,
+  session_key   TEXT NOT NULL,
+  linked_at     INTEGER NOT NULL,
+  PRIMARY KEY (goal_id, session_key),
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_session_links_session
+  ON goal_session_links(session_key, linked_at DESC);

package/dist/src/storage/sqlite/migrations/007_goal_run_judge_schema.sql

@@ -0,0 +1,4 @@
+ALTER TABLE goal_runs ADD COLUMN confidence REAL;
+ALTER TABLE goal_runs ADD COLUMN missing_evidence_json TEXT;
+ALTER TABLE goal_runs ADD COLUMN user_question TEXT;
+ALTER TABLE goal_runs ADD COLUMN completed_checklist_item_ids_json TEXT;

package/dist/src/storage/sqlite/migrations/008_goal_queue_workflow_runs.sql

@@ -0,0 +1,53 @@
+CREATE TABLE IF NOT EXISTS goal_queue (
+  queue_id       TEXT PRIMARY KEY,
+  goal_id        TEXT NOT NULL,
+  status         TEXT NOT NULL,
+  payload_json   TEXT NOT NULL,
+  attempts       INTEGER NOT NULL,
+  max_retries    INTEGER NOT NULL,
+  enqueued_at    INTEGER NOT NULL,
+  started_at     INTEGER,
+  finished_at    INTEGER,
+  next_run_at    INTEGER,
+  session_key    TEXT,
+  last_error     TEXT,
+  source         TEXT NOT NULL,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_queue_status_next
+  ON goal_queue(status, next_run_at, enqueued_at);
+CREATE INDEX IF NOT EXISTS idx_goal_queue_goal_status
+  ON goal_queue(goal_id, status);
+CREATE INDEX IF NOT EXISTS idx_goal_queue_enqueued
+  ON goal_queue(enqueued_at DESC);
+
+CREATE TABLE IF NOT EXISTS workflow_runs (
+  run_id              TEXT PRIMARY KEY,
+  agent_id            TEXT NOT NULL,
+  definition_id       TEXT NOT NULL,
+  definition_version  TEXT NOT NULL,
+  goal_id             TEXT,
+  session_key         TEXT NOT NULL,
+  parent_session_key  TEXT,
+  status              TEXT NOT NULL,
+  source_kind         TEXT NOT NULL,
+  source_json         TEXT NOT NULL,
+  metadata_json       TEXT,
+  title               TEXT NOT NULL,
+  created_at_ms       INTEGER NOT NULL,
+  started_at_ms       INTEGER,
+  completed_at_ms     INTEGER,
+  metrics_json        TEXT NOT NULL,
+  result_preview      TEXT,
+  error_message       TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_workflow_runs_goal_created
+  ON workflow_runs(goal_id, created_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_workflow_runs_status_created
+  ON workflow_runs(agent_id, status, created_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_workflow_runs_definition_created
+  ON workflow_runs(definition_id, created_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_workflow_runs_created
+  ON workflow_runs(agent_id, created_at_ms DESC);

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 = 3;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 5;
+export declare const XOPC_DB_SCHEMA_VERSION = 8;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

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

@@ -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 = 3;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 5;
+const XOPC_DB_SCHEMA_VERSION = 8;
 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 ?? 5;
+	const targetVersion = options.targetVersion ?? 8;
 	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 ?? 5;
+	const appVersion = options.targetVersion ?? 8;
 	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 = 3;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 5;\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 = 3;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 8;\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 = 3;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 5;
+export const XOPC_DB_SCHEMA_VERSION = 8;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

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

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 3;
 	}
-	applyPendingMigrations(db, { targetVersion: 5 });
+	applyPendingMigrations(db, { targetVersion: 8 });
 }
 //#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

@@ -131,6 +131,36 @@ CREATE INDEX IF NOT EXISTS idx_cron_runs_job_started
 CREATE INDEX IF NOT EXISTS idx_cron_runs_started
   ON cron_runs(started_at DESC);
 
+CREATE TABLE IF NOT EXISTS workflow_runs (
+  run_id              TEXT PRIMARY KEY,
+  agent_id            TEXT NOT NULL,
+  definition_id       TEXT NOT NULL,
+  definition_version  TEXT NOT NULL,
+  goal_id             TEXT,
+  session_key         TEXT NOT NULL,
+  parent_session_key  TEXT,
+  status              TEXT NOT NULL,
+  source_kind         TEXT NOT NULL,
+  source_json         TEXT NOT NULL,
+  metadata_json       TEXT,
+  title               TEXT NOT NULL,
+  created_at_ms       INTEGER NOT NULL,
+  started_at_ms       INTEGER,
+  completed_at_ms     INTEGER,
+  metrics_json        TEXT NOT NULL,
+  result_preview      TEXT,
+  error_message       TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_workflow_runs_goal_created
+  ON workflow_runs(goal_id, created_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_workflow_runs_status_created
+  ON workflow_runs(agent_id, status, created_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_workflow_runs_definition_created
+  ON workflow_runs(definition_id, created_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_workflow_runs_created
+  ON workflow_runs(agent_id, created_at_ms DESC);
+
 CREATE TABLE IF NOT EXISTS notes (
   note_id               TEXT PRIMARY KEY,
   title                 TEXT,
@@ -199,3 +229,136 @@ CREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(
   end_line UNINDEXED,
   tokenize='unicode61'
 );
+
+CREATE TABLE IF NOT EXISTS goals (
+  goal_id              TEXT PRIMARY KEY,
+  title                TEXT NOT NULL,
+  description          TEXT,
+  status               TEXT NOT NULL,
+  agent_id             TEXT NOT NULL,
+  priority             TEXT NOT NULL DEFAULT 'normal',
+  deadline_at          INTEGER,
+  created_at           INTEGER NOT NULL,
+  updated_at           INTEGER NOT NULL,
+  completed_at         INTEGER,
+  archived_at          INTEGER,
+  active_session_key   TEXT,
+  current_run_id       TEXT,
+  next_action          TEXT,
+  blocked_reason       TEXT,
+  judge_model_ref      TEXT,
+  max_turns            INTEGER NOT NULL,
+  turns_used           INTEGER NOT NULL DEFAULT 0,
+  ui_locale            TEXT,
+  source               TEXT NOT NULL DEFAULT 'chat'
+);
+
+CREATE INDEX IF NOT EXISTS idx_goals_status_updated
+  ON goals(status, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_goals_agent_updated
+  ON goals(agent_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_goals_active_session
+  ON goals(active_session_key);
+
+CREATE TABLE IF NOT EXISTS goal_queue (
+  queue_id       TEXT PRIMARY KEY,
+  goal_id        TEXT NOT NULL,
+  status         TEXT NOT NULL,
+  payload_json   TEXT NOT NULL,
+  attempts       INTEGER NOT NULL,
+  max_retries    INTEGER NOT NULL,
+  enqueued_at    INTEGER NOT NULL,
+  started_at     INTEGER,
+  finished_at    INTEGER,
+  next_run_at    INTEGER,
+  session_key    TEXT,
+  last_error     TEXT,
+  source         TEXT NOT NULL,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_queue_status_next
+  ON goal_queue(status, next_run_at, enqueued_at);
+CREATE INDEX IF NOT EXISTS idx_goal_queue_goal_status
+  ON goal_queue(goal_id, status);
+CREATE INDEX IF NOT EXISTS idx_goal_queue_enqueued
+  ON goal_queue(enqueued_at DESC);
+
+CREATE TABLE IF NOT EXISTS goal_checklist_items (
+  item_id            TEXT PRIMARY KEY,
+  goal_id            TEXT NOT NULL,
+  text               TEXT NOT NULL,
+  status             TEXT NOT NULL,
+  added_by           TEXT NOT NULL,
+  added_at           INTEGER NOT NULL,
+  completed_at       INTEGER,
+  evidence_summary   TEXT,
+  sort_order         INTEGER NOT NULL,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_checklist_goal_order
+  ON goal_checklist_items(goal_id, sort_order);
+
+CREATE TABLE IF NOT EXISTS goal_runs (
+  run_id              TEXT PRIMARY KEY,
+  goal_id             TEXT NOT NULL,
+  session_key         TEXT NOT NULL,
+  source              TEXT NOT NULL,
+  status              TEXT NOT NULL,
+  started_at          INTEGER NOT NULL,
+  finished_at         INTEGER,
+  verdict             TEXT,
+  reason              TEXT,
+  next_action         TEXT,
+  assistant_preview   TEXT,
+  checklist_done      INTEGER,
+  checklist_total     INTEGER,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_runs_goal_started
+  ON goal_runs(goal_id, started_at DESC);
+CREATE INDEX IF NOT EXISTS idx_goal_runs_session_started
+  ON goal_runs(session_key, started_at DESC);
+
+CREATE TABLE IF NOT EXISTS goal_events (
+  event_id       TEXT PRIMARY KEY,
+  goal_id        TEXT NOT NULL,
+  run_id         TEXT,
+  kind           TEXT NOT NULL,
+  message        TEXT NOT NULL,
+  data_json      TEXT,
+  created_at     INTEGER NOT NULL,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_events_goal_created
+  ON goal_events(goal_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS goal_evidence (
+  evidence_id   TEXT PRIMARY KEY,
+  goal_id       TEXT NOT NULL,
+  run_id        TEXT,
+  kind          TEXT NOT NULL,
+  title         TEXT NOT NULL,
+  summary       TEXT,
+  uri           TEXT,
+  data_json     TEXT,
+  created_at    INTEGER NOT NULL,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_evidence_goal_created
+  ON goal_evidence(goal_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS goal_session_links (
+  goal_id       TEXT NOT NULL,
+  session_key   TEXT NOT NULL,
+  linked_at     INTEGER NOT NULL,
+  PRIMARY KEY (goal_id, session_key),
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_session_links_session
+  ON goal_session_links(session_key, linked_at DESC);

package/dist/src/utils/logger/stats.d.ts

@@ -14,11 +14,11 @@ export declare function getRuntimeLogStats(): {
     byLevel: {
         error: number;
         debug: number;
+        silent: number;
         trace: number;
         info: number;
         warn: number;
         fatal: number;
-        silent: number;
     };
     byModule: {
         [k: string]: number;

package/dist/src/workflows/domain/run.d.ts

@@ -30,6 +30,7 @@ export interface WorkflowRunMetadata {
     correlation?: WorkflowRunCorrelation;
     origin?: WorkflowRunOrigin;
     schedule?: WorkflowRunScheduleMetadata;
+    goalId?: string;
 }
 export type WorkflowRunReplayScope = 'failed_agents' | 'failed_phases';
 export interface WorkflowRunReplayMetadata {

package/dist/src/workflows/domain/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","names":[],"sources":["../../../../src/workflows/domain/run.ts"],"sourcesContent":["import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, WorkflowPermissionPolicy, WorkflowResourceRefs } from './definition.js';\nimport type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';\n\nexport type WorkflowRunStatus =\n  | 'queued'\n  | 'running'\n  | 'succeeded'\n  | 'failed'\n  | 'cancelled'\n  | 'timeout';\n\nconst TERMINAL_WORKFLOW_RUN_STATUSES = new Set<WorkflowRunStatus>([\n  'succeeded',\n  'failed',\n  'cancelled',\n  'timeout',\n]);\n\nexport function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean {\n  return TERMINAL_WORKFLOW_RUN_STATUSES.has(status);\n}\n\nexport interface WorkflowRun {\n  id: string;\n  definitionId: string;\n  definitionVersion: string;\n  title: string;\n  goal: string;\n  input: unknown;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  result?: WorkflowResultEnvelope;\n  error?: WorkflowRunError;\n  metrics: WorkflowRunMetrics;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowRunMetadata {\n  sessionKey: string;\n  triggerSource: WorkflowRunSource['kind'];\n  agentId?: string;\n  retryOfRunId?: string;\n  replay?: WorkflowRunReplayMetadata;\n  definition: WorkflowRunDefinitionSnapshot;\n  input?: WorkflowRunInputEnvelope;\n  correlation?: WorkflowRunCorrelation;\n  origin?: WorkflowRunOrigin;\n  schedule?: WorkflowRunScheduleMetadata;\n}\n\nexport type WorkflowRunReplayScope = 'failed_agents' | 'failed_phases';\n\nexport interface WorkflowRunReplayMetadata {\n  sourceRunId: string;\n  scope: WorkflowRunReplayScope;\n  phaseIds?: string[];\n  agentIds: string[];\n  targetCount: number;\n  createdAtMs: number;\n}\n\nexport interface WorkflowRunInputEnvelope {\n  payload: unknown;\n  goal?: string;\n  variables?: Record<string, unknown>;\n  context?: Record<string, unknown>;\n}\n\nexport interface WorkflowRunCorrelation {\n  idempotencyKey?: string;\n  requestId?: string;\n  traceId?: string;\n  parentRunId?: string;\n}\n\nexport interface WorkflowRunOrigin {\n  channel: string;\n  sessionKey?: string;\n  chatId?: string;\n  messageId?: string;\n  scheduleId?: string;\n  fireId?: string;\n  requestId?: string;\n}\n\nexport interface WorkflowRunScheduleMetadata {\n  scheduleId: string;\n  fireId?: string;\n  scheduledAtMs?: number;\n}\n\nexport interface WorkflowRunDefinitionSnapshot {\n  id: string;\n  name: string;\n  title: string;\n  version: string;\n  contentHash?: string;\n  runtimeHash?: string;\n  source: 'builtin' | 'user';\n  tags: string[];\n  phaseCount: number;\n  defaults?: WorkflowDefinitionDefaults;\n  permissions?: WorkflowPermissionPolicy;\n  resources?: WorkflowResourceRefs;\n  estimatedAgents?: WorkflowDefinitionEstimatedAgents;\n}\n\nexport type WorkflowRunSource =\n  | { kind: 'chat'; sessionKey: string; messageId?: string }\n  | { kind: 'webui'; sessionKey?: string; requestId?: string }\n  | { kind: 'cron'; scheduleId: string; fireId?: string; scheduledAtMs?: number }\n  | { kind: 'api'; requestId?: string; idempotencyKey?: string }\n  | { kind: 'im'; channel: string; chatId: string; messageId?: string; userId?: string };\n\nexport interface WorkflowRunMetrics {\n  agentCount: number;\n  doneAgentCount: number;\n  errorAgentCount: number;\n  skippedAgentCount: number;\n  artifactCount: number;\n  durationMs?: number;\n}\n\nexport interface WorkflowRunError {\n  code: WorkflowRunErrorCode;\n  message: string;\n  detail?: string;\n  recoverable: boolean;\n}\n\nexport type WorkflowRunErrorCode =\n  | 'definition_not_found'\n  | 'invalid_input'\n  | 'runtime_error'\n  | 'timeout'\n  | 'cancelled'\n  | 'result_validation_failed'\n  | 'agent_quota_exceeded';\n\nexport interface WorkflowRunControls {\n  canCancel: boolean;\n  canRetry: boolean;\n  canArchive: boolean;\n}\n\nexport interface WorkflowRunSummary {\n  id: string;\n  definitionId: string;\n  title: string;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  metrics: WorkflowRunMetrics;\n}\n\nexport interface WorkflowRunView {\n  run: WorkflowRun;\n  phases: WorkflowPhaseView[];\n  agents: WorkflowAgentView[];\n  logs: WorkflowLogEntry[];\n  artifacts: WorkflowArtifactRef[];\n  timeline: WorkflowTimelineItem[];\n  controls: WorkflowRunControls;\n}\n\nexport type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';\n\nexport interface WorkflowPhaseView {\n  id: string;\n  title: string;\n  status: WorkflowPhaseStatus;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  agentIds: string[];\n}\n\nexport type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';\n\nexport interface WorkflowAgentView {\n  id: string;\n  label: string;\n  phaseId?: string;\n  status: WorkflowAgentStatus;\n  prompt?: string;\n  invocation?: WorkflowAgentInvocationSnapshot;\n  sessionKey: string;\n  transcriptMessageCount: number;\n  currentStep?: string;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  steps: WorkflowAgentStepView[];\n}\n\nexport interface WorkflowAgentInvocationSnapshot {\n  prompt: string;\n  label: string;\n  phase?: string;\n  modelRef?: string;\n  resolvedModelRef?: string;\n  schema?: unknown;\n  toolset?: string[];\n  maxIterations?: number;\n}\n\nexport type WorkflowAgentStepStatus = 'running' | 'done' | 'error';\n\nexport interface WorkflowAgentStepView {\n  id: string;\n  label: string;\n  kind: 'tool' | 'llm' | 'thinking';\n  toolName?: string;\n  detail?: string;\n  status: WorkflowAgentStepStatus;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowLogEntry {\n  sequence: number;\n  message: string;\n  createdAtMs: number;\n}\n\nexport interface WorkflowTimelineItem {\n  sequence: number;\n  type: string;\n  title: string;\n  createdAtMs: number;\n}\n"],"mappings":";AAWA,MAAM,iCAAiC,IAAI,IAAuB;CAChE;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,4BAA4B,QAAoC;AAC9E,QAAO,+BAA+B,IAAI,OAAO"}
+{"version":3,"file":"run.js","names":[],"sources":["../../../../src/workflows/domain/run.ts"],"sourcesContent":["import type { WorkflowDefinitionDefaults, WorkflowDefinitionEstimatedAgents, WorkflowPermissionPolicy, WorkflowResourceRefs } from './definition.js';\nimport type { WorkflowArtifactRef, WorkflowResultEnvelope } from './result.js';\n\nexport type WorkflowRunStatus =\n  | 'queued'\n  | 'running'\n  | 'succeeded'\n  | 'failed'\n  | 'cancelled'\n  | 'timeout';\n\nconst TERMINAL_WORKFLOW_RUN_STATUSES = new Set<WorkflowRunStatus>([\n  'succeeded',\n  'failed',\n  'cancelled',\n  'timeout',\n]);\n\nexport function isTerminalWorkflowRunStatus(status: WorkflowRunStatus): boolean {\n  return TERMINAL_WORKFLOW_RUN_STATUSES.has(status);\n}\n\nexport interface WorkflowRun {\n  id: string;\n  definitionId: string;\n  definitionVersion: string;\n  title: string;\n  goal: string;\n  input: unknown;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  result?: WorkflowResultEnvelope;\n  error?: WorkflowRunError;\n  metrics: WorkflowRunMetrics;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowRunMetadata {\n  sessionKey: string;\n  triggerSource: WorkflowRunSource['kind'];\n  agentId?: string;\n  retryOfRunId?: string;\n  replay?: WorkflowRunReplayMetadata;\n  definition: WorkflowRunDefinitionSnapshot;\n  input?: WorkflowRunInputEnvelope;\n  correlation?: WorkflowRunCorrelation;\n  origin?: WorkflowRunOrigin;\n  schedule?: WorkflowRunScheduleMetadata;\n  goalId?: string;\n}\n\nexport type WorkflowRunReplayScope = 'failed_agents' | 'failed_phases';\n\nexport interface WorkflowRunReplayMetadata {\n  sourceRunId: string;\n  scope: WorkflowRunReplayScope;\n  phaseIds?: string[];\n  agentIds: string[];\n  targetCount: number;\n  createdAtMs: number;\n}\n\nexport interface WorkflowRunInputEnvelope {\n  payload: unknown;\n  goal?: string;\n  variables?: Record<string, unknown>;\n  context?: Record<string, unknown>;\n}\n\nexport interface WorkflowRunCorrelation {\n  idempotencyKey?: string;\n  requestId?: string;\n  traceId?: string;\n  parentRunId?: string;\n}\n\nexport interface WorkflowRunOrigin {\n  channel: string;\n  sessionKey?: string;\n  chatId?: string;\n  messageId?: string;\n  scheduleId?: string;\n  fireId?: string;\n  requestId?: string;\n}\n\nexport interface WorkflowRunScheduleMetadata {\n  scheduleId: string;\n  fireId?: string;\n  scheduledAtMs?: number;\n}\n\nexport interface WorkflowRunDefinitionSnapshot {\n  id: string;\n  name: string;\n  title: string;\n  version: string;\n  contentHash?: string;\n  runtimeHash?: string;\n  source: 'builtin' | 'user';\n  tags: string[];\n  phaseCount: number;\n  defaults?: WorkflowDefinitionDefaults;\n  permissions?: WorkflowPermissionPolicy;\n  resources?: WorkflowResourceRefs;\n  estimatedAgents?: WorkflowDefinitionEstimatedAgents;\n}\n\nexport type WorkflowRunSource =\n  | { kind: 'chat'; sessionKey: string; messageId?: string }\n  | { kind: 'webui'; sessionKey?: string; requestId?: string }\n  | { kind: 'cron'; scheduleId: string; fireId?: string; scheduledAtMs?: number }\n  | { kind: 'api'; requestId?: string; idempotencyKey?: string }\n  | { kind: 'im'; channel: string; chatId: string; messageId?: string; userId?: string };\n\nexport interface WorkflowRunMetrics {\n  agentCount: number;\n  doneAgentCount: number;\n  errorAgentCount: number;\n  skippedAgentCount: number;\n  artifactCount: number;\n  durationMs?: number;\n}\n\nexport interface WorkflowRunError {\n  code: WorkflowRunErrorCode;\n  message: string;\n  detail?: string;\n  recoverable: boolean;\n}\n\nexport type WorkflowRunErrorCode =\n  | 'definition_not_found'\n  | 'invalid_input'\n  | 'runtime_error'\n  | 'timeout'\n  | 'cancelled'\n  | 'result_validation_failed'\n  | 'agent_quota_exceeded';\n\nexport interface WorkflowRunControls {\n  canCancel: boolean;\n  canRetry: boolean;\n  canArchive: boolean;\n}\n\nexport interface WorkflowRunSummary {\n  id: string;\n  definitionId: string;\n  title: string;\n  status: WorkflowRunStatus;\n  source: WorkflowRunSource;\n  metadata?: WorkflowRunMetadata;\n  createdAtMs: number;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  metrics: WorkflowRunMetrics;\n}\n\nexport interface WorkflowRunView {\n  run: WorkflowRun;\n  phases: WorkflowPhaseView[];\n  agents: WorkflowAgentView[];\n  logs: WorkflowLogEntry[];\n  artifacts: WorkflowArtifactRef[];\n  timeline: WorkflowTimelineItem[];\n  controls: WorkflowRunControls;\n}\n\nexport type WorkflowPhaseStatus = 'pending' | 'running' | 'completed' | 'failed';\n\nexport interface WorkflowPhaseView {\n  id: string;\n  title: string;\n  status: WorkflowPhaseStatus;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  agentIds: string[];\n}\n\nexport type WorkflowAgentStatus = 'queued' | 'running' | 'done' | 'error' | 'skipped';\n\nexport interface WorkflowAgentView {\n  id: string;\n  label: string;\n  phaseId?: string;\n  status: WorkflowAgentStatus;\n  prompt?: string;\n  invocation?: WorkflowAgentInvocationSnapshot;\n  sessionKey: string;\n  transcriptMessageCount: number;\n  currentStep?: string;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n  steps: WorkflowAgentStepView[];\n}\n\nexport interface WorkflowAgentInvocationSnapshot {\n  prompt: string;\n  label: string;\n  phase?: string;\n  modelRef?: string;\n  resolvedModelRef?: string;\n  schema?: unknown;\n  toolset?: string[];\n  maxIterations?: number;\n}\n\nexport type WorkflowAgentStepStatus = 'running' | 'done' | 'error';\n\nexport interface WorkflowAgentStepView {\n  id: string;\n  label: string;\n  kind: 'tool' | 'llm' | 'thinking';\n  toolName?: string;\n  detail?: string;\n  status: WorkflowAgentStepStatus;\n  resultPreview?: string;\n  error?: string;\n  startedAtMs?: number;\n  completedAtMs?: number;\n}\n\nexport interface WorkflowLogEntry {\n  sequence: number;\n  message: string;\n  createdAtMs: number;\n}\n\nexport interface WorkflowTimelineItem {\n  sequence: number;\n  type: string;\n  title: string;\n  createdAtMs: number;\n}\n"],"mappings":";AAWA,MAAM,iCAAiC,IAAI,IAAuB;CAChE;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAgB,4BAA4B,QAAoC;AAC9E,QAAO,+BAA+B,IAAI,OAAO"}

package/dist/src/workflows/service/workflow-run-service.d.ts

@@ -36,6 +36,7 @@ export declare function buildWorkflowRunInputEnvelope(input: unknown, goal?: str
 export declare function buildWorkflowRunMetadata(params: {
     definition: WorkflowDefinition;
     agentId: string;
+    goalId?: string;
     sessionKey: string;
     source: WorkflowRunSource;
     input: WorkflowRunInputEnvelope;

package/dist/src/workflows/service/workflow-run-service.js

@@ -81,6 +81,7 @@ var WorkflowRunService = class {
 			metadata: buildWorkflowRunMetadata({
 				definition,
 				agentId: params.agentId,
+				goalId: params.goalId,
 				sessionKey,
 				source,
 				input: inputEnvelope,
@@ -188,6 +189,7 @@ var WorkflowRunService = class {
 			metadata: buildWorkflowRunMetadata({
 				definition,
 				agentId: params.agentId,
+				goalId: existing.run.metadata?.goalId,
 				sessionKey,
 				source,
 				input: inputEnvelope,
@@ -374,6 +376,7 @@ function buildWorkflowRunInputEnvelope(input, goal) {
 	};
 }
 function buildWorkflowRunMetadata(params) {
+	const goalId = params.goalId?.trim() || void 0;
 	return {
 		sessionKey: params.sessionKey,
 		triggerSource: params.source.kind,
@@ -387,7 +390,8 @@ function buildWorkflowRunMetadata(params) {
 		schedule: params.source.kind === "cron" ? {
 			scheduleId: params.source.scheduleId,
 			fireId: params.source.fireId
-		} : void 0
+		} : void 0,
+		goalId
 	};
 }
 function resolveWorkflowReplayTargets(view, scope) {