@xopcai/xopc 0.0.410 → 0.0.412

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

@@ -1,22 +0,0 @@
-import type { DatabaseSync } from 'node:sqlite';
-import type { ApplyMigrationsOptions } from './types.js';
-/** Baseline schema version applied from schema.sql on first open. */
-export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 217;
-/** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 259;
-export declare function resolveMigrationsDir(override?: string): string;
-/**
- * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.
- * Each step runs in its own transaction and updates schema_meta on success.
- */
-export declare function applyPendingMigrations(db: DatabaseSync, options?: ApplyMigrationsOptions): number;
-export type SchemaMigrationStatus = {
-    dbVersion: number;
-    appVersion: number;
-    pendingVersions: number[];
-    isTooNew: boolean;
-    hasMigrationGap: boolean;
-    missingVersion: number | null;
-};
-/** Inspect schema version without mutating the database. */
-export declare function inspectSchemaMigrationStatus(db: DatabaseSync, options?: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'>): SchemaMigrationStatus;

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

@@ -1,112 +0,0 @@
-import { __esmMin } from "../../../../_virtual/_rolldown/runtime.js";
-import { init_sql_assets, resolveSqliteAssetPath } from "../sql-assets.js";
-import { init_search_text, memorySearchText } from "../../../knowledge-memory/search-text.js";
-import { createLogger } from "../../../utils/logger/index.js";
-import { init_logger } from "../../../utils/logger.js";
-import { currentOperationId, init_operation_context } from "../../../infra/operation-context.js";
-import { init_schema_version, readSchemaVersion, setSchemaVersion } from "../schema-version.js";
-import { discoverSqlMigrations, init_discover } from "./discover.js";
-import { DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, init_errors } from "./errors.js";
-//#region src/storage/sqlite/migrations/runner.ts
-function resolveMigrationsDir(override) {
-	if (override) return override;
-	return resolveSqliteAssetPath("migrations");
-}
-function migrationByTarget(migrations, targetVersion) {
-	return migrations.find((migration) => migration.targetVersion === targetVersion);
-}
-function applySingleMigration(db, migration) {
-	log.info({
-		targetVersion: migration.targetVersion,
-		file: migration.filename
-	}, "Applying SQLite migration");
-	const requiresForeignKeyPause = migration.targetVersion === 219 || migration.targetVersion === 220;
-	const foreignKeysEnabled = Number(db.prepare("PRAGMA foreign_keys").get()?.foreign_keys) === 1;
-	if (requiresForeignKeyPause) db.exec("PRAGMA foreign_keys = OFF");
-	let transactionStarted = false;
-	try {
-		db.exec("BEGIN IMMEDIATE");
-		transactionStarted = true;
-		db.exec(migration.sql);
-		if (requiresForeignKeyPause && db.prepare("PRAGMA foreign_key_check").all().length > 0) throw new Error("Schema migration would violate foreign key integrity");
-		setSchemaVersion(db, migration.targetVersion);
-		db.exec("COMMIT");
-	} catch (error) {
-		try {
-			if (transactionStarted) db.exec("ROLLBACK");
-		} catch {}
-		const em = error instanceof Error ? error.message : String(error);
-		throw new Error(`SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`, { cause: error });
-	} finally {
-		if (requiresForeignKeyPause && foreignKeysEnabled) db.exec("PRAGMA foreign_keys = ON");
-	}
-}
-/**
-* Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.
-* Each step runs in its own transaction and updates schema_meta on success.
-*/
-function applyPendingMigrations(db, options = {}) {
-	db.function("xopc_memory_search_text", { deterministic: true }, (value) => memorySearchText(String(value ?? "")));
-	db.function("xopc_operation_id", () => currentOperationId() ?? null);
-	const targetVersion = options.targetVersion ?? 259;
-	let currentVersion = readSchemaVersion(db);
-	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
-	if (!options.migrationsDir && currentVersion < 217) throw new DatabaseSchemaTooOldError(currentVersion, 217);
-	if (currentVersion >= targetVersion) return currentVersion;
-	const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));
-	while (currentVersion < targetVersion) {
-		const nextVersion = currentVersion + 1;
-		const migration = migrationByTarget(migrations, nextVersion);
-		if (!migration) throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);
-		applySingleMigration(db, migration);
-		currentVersion = nextVersion;
-	}
-	return currentVersion;
-}
-/** Inspect schema version without mutating the database. */
-function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 259;
-	const dbVersion = readSchemaVersion(db);
-	if (dbVersion > appVersion) return {
-		dbVersion,
-		appVersion,
-		pendingVersions: [],
-		isTooNew: true,
-		hasMigrationGap: false,
-		missingVersion: null
-	};
-	const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));
-	const pendingVersions = [];
-	let hasMigrationGap = false;
-	let missingVersion = null;
-	for (let version = dbVersion + 1; version <= appVersion; version++) if (migrationByTarget(migrations, version)) pendingVersions.push(version);
-	else {
-		hasMigrationGap = true;
-		missingVersion = version;
-		break;
-	}
-	return {
-		dbVersion,
-		appVersion,
-		pendingVersions,
-		isTooNew: false,
-		hasMigrationGap,
-		missingVersion
-	};
-}
-var log, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION;
-var init_runner = __esmMin((() => {
-	init_search_text();
-	init_logger();
-	init_operation_context();
-	init_schema_version();
-	init_sql_assets();
-	init_discover();
-	init_errors();
-	log = createLogger("Sqlite:Migrations");
-	XOPC_DB_BASELINE_SCHEMA_VERSION = 217;
-	XOPC_DB_SCHEMA_VERSION = 259;
-}));
-//#endregion
-init_runner();
-export { XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, applyPendingMigrations, init_runner, inspectSchemaMigrationStatus, resolveMigrationsDir };

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

@@ -1,12 +0,0 @@
-/** One on-disk SQL migration file (target schema version after apply). */
-export type SqlMigration = {
-    targetVersion: number;
-    filename: string;
-    sql: string;
-};
-export type ApplyMigrationsOptions = {
-    /** Override migrations directory (tests). Defaults to `<schema-module>/migrations`. */
-    migrationsDir?: string;
-    /** Target schema version. Defaults to {@link XOPC_DB_SCHEMA_VERSION}. */
-    targetVersion?: number;
-};

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

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

package/dist/src/tasks/task-workflow-coordinator.d.ts

@@ -1,5 +0,0 @@
-import type { WorkflowRunView } from '../workflows/domain/index.js';
-export declare class TaskWorkflowCoordinator {
-    #private;
-    handleTerminalRun(view: WorkflowRunView): void;
-}

package/dist/src/tasks/task-workflow-coordinator.js

@@ -1,55 +0,0 @@
-import { TaskRunRepository, init_task_run_repository } from "./task-run-repository.js";
-import { TaskApplicationService } from "./task-application-service.js";
-//#region src/tasks/task-workflow-coordinator.ts
-init_task_run_repository();
-var TaskWorkflowCoordinator = class {
-	#runs = new TaskRunRepository();
-	#application = new TaskApplicationService();
-	handleTerminalRun(view) {
-		const taskRunId = view.run.metadata?.taskRunId?.trim();
-		if (!taskRunId) return;
-		const run = this.#runs.get(taskRunId);
-		if (!run || ![
-			"running",
-			"waiting",
-			"verifying"
-		].includes(run.status)) return;
-		const succeeded = view.run.status === "succeeded";
-		const summary = view.run.result?.summary || view.run.error?.message || `Workflow ${view.run.status}`;
-		const workflowId = typeof run.executorRef.workflowId === "string" ? run.executorRef.workflowId : view.run.definitionId;
-		this.#application.completeRun({
-			runId: run.id,
-			expectedRunVersion: run.version,
-			terminalCode: succeeded ? void 0 : "workflow_failed",
-			terminalMessage: succeeded ? void 0 : summary,
-			receipt: {
-				status: succeeded ? "succeeded" : "failed",
-				summary,
-				changes: [],
-				evidence: [{
-					kind: "artifact",
-					title: `Workflow ${view.run.definitionId} ${view.run.status}`,
-					summary,
-					uri: `workflow:${view.run.id}`,
-					provenance: "tool",
-					strength: "observed",
-					observedAt: Date.now()
-				}],
-				verification: {
-					status: "unverified",
-					checks: []
-				},
-				remainingWork: succeeded ? [] : [workflowId],
-				needsUser: false,
-				completionVerdict: succeeded ? "achieved" : "not_achieved",
-				...succeeded ? {} : { failure: {
-					code: "workflow_failed",
-					phase: "workflow",
-					recoveryAction: "Retry the TaskRun"
-				} }
-			}
-		});
-	}
-};
-//#endregion
-export { TaskWorkflowCoordinator };

package/dist/src/tui/tui-workflow-slash.d.ts

@@ -1,29 +0,0 @@
-/**
- * Helper for {@link createTuiCommandHandler}: when the user types an unknown
- * slash command in the TUI, check whether the name matches a saved workflow
- * and, if so, rewrite the input into a natural-language prompt that
- * deterministically triggers the `workflow` tool.
- *
- * Why a rewrite and not a direct execution?
- *   Slash commands in xopc are handled by the chat-commands framework whose
- *   handlers return text shown back to the user — there is no hook to "inject
- *   the result as the next user message and start an agent turn". So the
- *   shortest reliable path is to turn `/audit_repo` into the same plain-text
- *   request the model already knows how to handle.
- *
- * The lookup only runs for inputs that started with `/` and did not match a
- * built-in or extension command. A short cache keeps repeated dispatch cheap.
- *
- * Built-in TUI command names that overlap with a workflow file name keep their
- * existing TUI behaviour — the slash dispatcher matches the built-in switch
- * cases before this helper is consulted.
- */
-/** Reset the cache after workflow changes and in tests. */
-export declare function resetWorkflowSlashCache(): void;
-/**
- * Returns a rewritten user message when `name` matches a known workflow,
- * otherwise `null`. Args after the slash are passed along as a hint to the
- * model — most workflows expect free-form context, not strict JSON, and the
- * model can shape the call.
- */
-export declare function rewriteUnknownSlashAsWorkflow(name: string, args: string, resolver?: () => Set<string>): string | null;

package/dist/src/tui/tui-workflow-slash.js

@@ -1,58 +0,0 @@
-import { createWorkflowCatalog } from "../agent/workflow/catalog.js";
-//#region src/tui/tui-workflow-slash.ts
-/**
-* Helper for {@link createTuiCommandHandler}: when the user types an unknown
-* slash command in the TUI, check whether the name matches a saved workflow
-* and, if so, rewrite the input into a natural-language prompt that
-* deterministically triggers the `workflow` tool.
-*
-* Why a rewrite and not a direct execution?
-*   Slash commands in xopc are handled by the chat-commands framework whose
-*   handlers return text shown back to the user — there is no hook to "inject
-*   the result as the next user message and start an agent turn". So the
-*   shortest reliable path is to turn `/audit_repo` into the same plain-text
-*   request the model already knows how to handle.
-*
-* The lookup only runs for inputs that started with `/` and did not match a
-* built-in or extension command. A short cache keeps repeated dispatch cheap.
-*
-* Built-in TUI command names that overlap with a workflow file name keep their
-* existing TUI behaviour — the slash dispatcher matches the built-in switch
-* cases before this helper is consulted.
-*/
-let cachedNames = null;
-let cachedAt = 0;
-const CACHE_TTL_MS = 5e3;
-/** Reset the cache after workflow changes and in tests. */
-function resetWorkflowSlashCache() {
-	cachedNames = null;
-	cachedAt = 0;
-}
-function knownWorkflowNames() {
-	const now = Date.now();
-	if (cachedNames && now - cachedAt < CACHE_TTL_MS) return cachedNames;
-	try {
-		const catalog = createWorkflowCatalog();
-		cachedNames = new Set(catalog.list().map((e) => e.name));
-	} catch {
-		cachedNames = /* @__PURE__ */ new Set();
-	}
-	cachedAt = now;
-	return cachedNames;
-}
-/**
-* Returns a rewritten user message when `name` matches a known workflow,
-* otherwise `null`. Args after the slash are passed along as a hint to the
-* model — most workflows expect free-form context, not strict JSON, and the
-* model can shape the call.
-*/
-function rewriteUnknownSlashAsWorkflow(name, args, resolver = knownWorkflowNames) {
-	const normalized = name.trim();
-	if (!normalized) return null;
-	if (!resolver().has(normalized)) return null;
-	const tail = args.trim();
-	if (!tail) return `Run the ${normalized} workflow (call workflow tool with name="${normalized}").`;
-	return `Run the ${normalized} workflow (call workflow tool with name="${normalized}").\nUse this argument: ${tail}`;
-}
-//#endregion
-export { resetWorkflowSlashCache, rewriteUnknownSlashAsWorkflow };

package/dist/src/workflows/authoring/index.d.ts

@@ -1,2 +0,0 @@
-export * from './workflow-draft-store.js';
-export * from './workflow-draft-defaults.js';

package/dist/src/workflows/authoring/index.js

@@ -1,3 +0,0 @@
-import { WorkflowDraftConflictError, WorkflowDraftStore } from "./workflow-draft-store.js";
-import { createStarterWorkflowGraph, createStarterWorkflowManifest } from "./workflow-draft-defaults.js";
-export { WorkflowDraftConflictError, WorkflowDraftStore, createStarterWorkflowGraph, createStarterWorkflowManifest };

package/dist/src/workflows/authoring/workflow-draft-defaults.d.ts

@@ -1,3 +0,0 @@
-import type { WorkflowDefinitionManifest, WorkflowGraph } from '../domain/definition.js';
-export declare function createStarterWorkflowGraph(): WorkflowGraph;
-export declare function createStarterWorkflowManifest(title?: string): WorkflowDefinitionManifest;

package/dist/src/workflows/authoring/workflow-draft-defaults.js

@@ -1,63 +0,0 @@
-//#region src/workflows/authoring/workflow-draft-defaults.ts
-function createStarterWorkflowGraph() {
-	return {
-		schemaVersion: 1,
-		nodes: [
-			{
-				id: "input",
-				kind: "input",
-				title: "Input",
-				description: "What the user provides",
-				position: {
-					x: 0,
-					y: 120
-				},
-				config: {}
-			},
-			{
-				id: "agent-1",
-				kind: "agent",
-				title: "Do the work",
-				description: "Understand and complete the request",
-				phaseId: "work",
-				position: {
-					x: 300,
-					y: 120
-				},
-				config: {
-					prompt: "Complete this goal: {{goal}}\n\nUser input:\n{{input}}",
-					maxIterations: 12
-				}
-			},
-			{
-				id: "output",
-				kind: "output",
-				title: "Result",
-				description: "A clear answer for the user",
-				position: {
-					x: 620,
-					y: 120
-				},
-				config: {}
-			}
-		],
-		edges: [{
-			id: "input-agent",
-			source: "input",
-			target: "agent-1"
-		}, {
-			id: "agent-output",
-			source: "agent-1",
-			target: "output"
-		}]
-	};
-}
-function createStarterWorkflowManifest(title = "Untitled workflow") {
-	return {
-		title,
-		description: "",
-		tags: ["custom"]
-	};
-}
-//#endregion
-export { createStarterWorkflowGraph, createStarterWorkflowManifest };

package/dist/src/workflows/authoring/workflow-draft-store.d.ts

@@ -1,29 +0,0 @@
-import type { WorkflowDefinitionManifest, WorkflowGraph } from '../domain/definition.js';
-export interface WorkflowAuthoringDraft {
-    id: string;
-    workflowName: string;
-    graph: WorkflowGraph;
-    manifest: WorkflowDefinitionManifest;
-    baseRevision: number;
-    createdAtMs: number;
-    updatedAtMs: number;
-}
-export interface SaveWorkflowAuthoringDraftInput {
-    id?: string;
-    workflowName: string;
-    graph: WorkflowGraph;
-    manifest?: WorkflowDefinitionManifest;
-    baseRevision?: number;
-    expectedUpdatedAtMs?: number;
-}
-export declare class WorkflowDraftStore {
-    private readonly state;
-    list(workflowName?: string): WorkflowAuthoringDraft[];
-    get(id: string): WorkflowAuthoringDraft | null;
-    save(input: SaveWorkflowAuthoringDraftInput): WorkflowAuthoringDraft;
-    remove(id: string): boolean;
-}
-export declare class WorkflowDraftConflictError extends Error {
-    readonly currentUpdatedAtMs?: number;
-    constructor(currentUpdatedAtMs?: number);
-}

package/dist/src/workflows/authoring/workflow-draft-store.js

@@ -1,52 +0,0 @@
-import { DurableState } from "../../storage/sqlite/durable-state.js";
-import { randomUUID } from "node:crypto";
-//#region src/workflows/authoring/workflow-draft-store.ts
-var WorkflowDraftStore = class {
-	state = new DurableState("workflow-drafts");
-	list(workflowName) {
-		return this.state.values().filter((draft) => !workflowName || draft.workflowName === workflowName).sort((a, b) => b.updatedAtMs - a.updatedAtMs);
-	}
-	get(id) {
-		requireDraftId(id);
-		return this.state.get(id) ?? null;
-	}
-	save(input) {
-		if (!input.graph || input.graph.schemaVersion !== 1 || !Array.isArray(input.graph.nodes) || !Array.isArray(input.graph.edges)) throw new Error("workflow draft graph is invalid");
-		const id = input.id ?? randomUUID();
-		requireDraftId(id);
-		return this.state.update(id, (existing) => {
-			if (input.expectedUpdatedAtMs !== void 0 && input.expectedUpdatedAtMs !== existing?.updatedAtMs) throw new WorkflowDraftConflictError(existing?.updatedAtMs);
-			const now = Math.max(Date.now(), (existing?.updatedAtMs ?? 0) + 1);
-			const draft = {
-				id,
-				workflowName: input.workflowName.trim(),
-				graph: structuredClone(input.graph),
-				manifest: structuredClone(input.manifest ?? {}),
-				baseRevision: input.baseRevision ?? existing?.baseRevision ?? 0,
-				createdAtMs: existing?.createdAtMs ?? now,
-				updatedAtMs: now
-			};
-			if (!draft.workflowName) throw new Error("workflowName is required");
-			return {
-				value: draft,
-				result: draft
-			};
-		});
-	}
-	remove(id) {
-		requireDraftId(id);
-		return this.state.delete(id);
-	}
-};
-var WorkflowDraftConflictError = class extends Error {
-	constructor(currentUpdatedAtMs) {
-		super("workflow draft was changed by another editor");
-		this.currentUpdatedAtMs = currentUpdatedAtMs;
-		this.name = "WorkflowDraftConflictError";
-	}
-};
-function requireDraftId(id) {
-	if (!/^[a-zA-Z0-9_-]+$/.test(id)) throw new Error("invalid workflow draft id");
-}
-//#endregion
-export { WorkflowDraftConflictError, WorkflowDraftStore };

package/dist/src/workflows/context/workflow-context-snapshot-repository.d.ts

@@ -1,21 +0,0 @@
-export interface WorkflowContextSnapshot<T> {
-    id: string;
-    traceId: string;
-    runId: string;
-    projectId?: string;
-    selectedItems: T[];
-    estimatedTokens: number;
-    contentHash: string;
-    createdAt: number;
-}
-export declare class WorkflowContextSnapshotRepository {
-    capture<T>(input: {
-        runId: string;
-        projectId?: string;
-        selectedItems: T[];
-        estimatedTokens: number;
-        contentHash: string;
-        now?: number;
-    }): WorkflowContextSnapshot<T>;
-    get<T>(id: string): WorkflowContextSnapshot<T> | undefined;
-}

package/dist/src/workflows/context/workflow-context-snapshot-repository.js

@@ -1,41 +0,0 @@
-import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
-import { randomUUID } from "node:crypto";
-//#region src/workflows/context/workflow-context-snapshot-repository.ts
-init_transaction();
-var WorkflowContextSnapshotRepository = class {
-	capture(input) {
-		const snapshot = {
-			id: randomUUID(),
-			traceId: randomUUID(),
-			runId: input.runId,
-			...input.projectId ? { projectId: input.projectId } : {},
-			selectedItems: input.selectedItems,
-			estimatedTokens: input.estimatedTokens,
-			contentHash: input.contentHash,
-			createdAt: input.now ?? Date.now()
-		};
-		getSqliteDatabase().prepare(`INSERT INTO workflow_context_snapshots (
-        snapshot_id, trace_id, run_id, project_id, selected_items_json,
-        estimated_tokens, content_hash, created_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(snapshot.id, snapshot.traceId, snapshot.runId, snapshot.projectId ?? null, JSON.stringify(snapshot.selectedItems), snapshot.estimatedTokens, snapshot.contentHash, snapshot.createdAt);
-		return snapshot;
-	}
-	get(id) {
-		const row = getSqliteDatabase().prepare(`SELECT snapshot_id, trace_id, run_id, project_id, selected_items_json,
-       estimated_tokens, content_hash, created_at
-       FROM workflow_context_snapshots WHERE snapshot_id = ?`).get(id);
-		if (!row) return void 0;
-		return {
-			id: row.snapshot_id,
-			traceId: row.trace_id,
-			runId: row.run_id,
-			...row.project_id ? { projectId: row.project_id } : {},
-			selectedItems: JSON.parse(row.selected_items_json),
-			estimatedTokens: row.estimated_tokens,
-			contentHash: row.content_hash,
-			createdAt: row.created_at
-		};
-	}
-};
-//#endregion
-export { WorkflowContextSnapshotRepository };

package/dist/src/workflows/context/workflow-context.d.ts

@@ -1,18 +0,0 @@
-import type { Config } from '../../config/schema.js';
-import type { WorkflowRunContextRef, WorkflowRunContextSnapshotRef } from '../domain/index.js';
-export interface ResolvedWorkflowContextItem extends WorkflowRunContextRef {
-    text: string;
-}
-export interface ResolvedWorkflowContext {
-    projectId?: string;
-    refs: WorkflowRunContextRef[];
-    snapshot: WorkflowRunContextSnapshotRef;
-    instructions: string;
-}
-export declare function resolveWorkflowContext(input: {
-    runId: string;
-    projectId?: string;
-    refs: WorkflowRunContextRef[];
-    config: Config;
-    reuseSnapshotId?: string;
-}): Promise<ResolvedWorkflowContext | undefined>;