@xopcai/xopc 0.0.114 → 0.0.115

package/dist/src/infra/update-runner.js

@@ -8,8 +8,8 @@ import { runGlobalPackageUpdateSteps } from "./package-update-steps.js";
 import { resolveStableNodePath } from "./stable-node-path.js";
 import { trimLogTail } from "./update-log.js";
 import { maybeRestartGatewayAfterUpdate } from "./update-restart.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 //#region src/infra/update-runner.ts
 const DEFAULT_TIMEOUT_MS = 2700 * 1e3;
 const MAX_LOG_CHARS = 8e3;

package/dist/src/infra/update-startup.js

@@ -1,8 +1,8 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
-import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
 import { init_paths_state, resolveUpdateCheckStatePath } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_write_file_atomic, writeTextAtomic } from "./write-file-atomic.js";
 import { acquireUpdateLock } from "./update-lock.js";
 import { normalizeUpdateChannel } from "./update-channels.js";
 import { compareSemver, detectInstallKind, resolveNpmChannelTag, resolvePackageRoot } from "./update-check.js";

package/dist/src/infra/write-file-atomic.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { randomUUID } from "node:crypto";
+import path from "node:path";
 import { chmodSync, closeSync, copyFileSync, fsyncSync, mkdirSync, openSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
 import { chmod, copyFile, mkdir, open, rename, rm } from "node:fs/promises";
-import path from "node:path";
 //#region src/infra/write-file-atomic.ts
 /**
 * Durable single-file writes: temp file → fsync → rename to target.

package/dist/src/media/store.js

@@ -1,8 +1,8 @@
 import { getMediaBucketDir, getMediaDir, isPathInside } from "./paths.js";
 import { buildMediaUri } from "./uri.js";
+import { extname, join, parse } from "node:path";
 import { randomUUID } from "node:crypto";
 import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
-import { extname, join, parse } from "node:path";
 //#region src/media/store.ts
 /** Default per-file cap for inbound staging (5 MiB). */
 const MEDIA_MAX_BYTES = 5 * 1024 * 1024;

package/dist/src/notes/agent-context.js

@@ -7,8 +7,8 @@ import { isSTTAvailable } from "../voice/stt/availability.js";
 import "../voice/stt/index.js";
 import { mergeSttConfigFromAppConfig } from "../channels/attachments/voice-stt-webchat.js";
 import { extractDocumentText } from "../document-understanding/extract.js";
-import { readFile } from "node:fs/promises";
 import { extname } from "node:path";
+import { readFile } from "node:fs/promises";
 //#region src/notes/agent-context.ts
 const MAX_NOTE_MARKDOWN_CHARS = 4e4;
 const MAX_TEXT_ATTACHMENT_CHARS = 2e4;

package/dist/src/notes/service.js

@@ -6,8 +6,8 @@ import { parseNoteMarkdown } from "./note-markdown.js";
 import { NotesStore } from "./store.js";
 import { partitionAttachmentsByReference } from "./note-attachment-sync.js";
 import { buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact } from "./agent-context.js";
-import { complete } from "@earendil-works/pi-ai";
 import { randomUUID } from "node:crypto";
+import { complete } from "@earendil-works/pi-ai";
 //#region src/notes/service.ts
 init_providers();
 init_logger();

package/dist/src/notes/store.js

@@ -1,15 +1,15 @@
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { buildNoteIndexMeta } from "./note-index-meta.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "../storage/sqlite/notes-repository.js";
 import { deleteNoteAgentContextRecord } from "../storage/sqlite/note-agent-context-repository.js";
 import "../storage/sqlite/index.js";
 import { resolveNoteHistoryDir, resolveNoteMediaDir } from "./paths.js";
+import { join } from "node:path";
 import { randomUUID } from "node:crypto";
 import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
-import { join } from "node:path";
 //#region src/notes/store.ts
 init_write_file_atomic();
 init_logger();

package/dist/src/project-trust/trust-store.js

@@ -1,8 +1,8 @@
 import { resolveStateDir } from "../config/paths-state.js";
 import { init_paths } from "../config/paths.js";
-import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
 import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
 import lockfile from "proper-lockfile";
 //#region src/project-trust/trust-store.ts
 init_paths();

package/dist/src/providers/auth-runtime/auth-profile-store.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 //#region src/providers/auth-runtime/auth-profile-store.ts
 /**
 * {@link AuthProfileStore} implementations.

package/dist/src/providers/index.js

@@ -1,8 +1,8 @@
 import { __esmMin, __exportAll } from "../../_virtual/_rolldown/runtime.js";
+import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { ModelRegistry, getModelRegistry, init_model_registry, prewarmModelRegistry, resetModelRegistry } from "./model-registry.js";
 import { CredentialResolver, hasCredentials, init_credentials, resolveApiKey } from "../auth/credentials.js";
-import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";
 import { getModel, getModels, getProviders } from "@earendil-works/pi-ai";
 //#region src/providers/index.ts

package/dist/src/providers/model-registry.js

@@ -1,12 +1,12 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
-import { resolveModelsJsonPath } from "../config/paths.js";
-import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { resolveModelsJsonPath } from "../config/paths.js";
+import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
+import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
 import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
-import { getModels, getProviders } from "@earendil-works/pi-ai";
 import { existsSync, readFileSync } from "fs";
+import { getModels, getProviders } from "@earendil-works/pi-ai";
 //#region src/providers/model-registry.ts
 /**
 * Model Registry - manages built-in and custom models from models.json

package/dist/src/session/init-session-turn.js

@@ -1,6 +1,6 @@
+import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import "../storage/sqlite/index.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";

package/dist/src/session/resolve-session.js

@@ -1,6 +1,6 @@
+import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { findSessionKeyBySessionId, getSessionMetadata, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";

package/dist/src/session/session-title.js

@@ -1,7 +1,7 @@
-import { createLogger } from "../utils/logger/index.js";
-import { init_logger } from "../utils/logger.js";
 import { isCronSessionKey } from "../routing/session-key-utils.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
 import { stripSessionStartupContextFromUserText } from "../agent/reply/startup-context.js";

package/dist/src/session/store.js

@@ -1,7 +1,7 @@
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import "./types.js";
 import { buildSessionContextForLlm, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";

package/dist/src/share/share-auto.js

@@ -1,8 +1,8 @@
 import { resolveMimeType } from "./share-store.js";
-import { randomUUID } from "node:crypto";
+import { basename, join, resolve } from "node:path";
 import { readdirSync } from "node:fs";
+import { randomUUID } from "node:crypto";
 import { copyFile, mkdir, rm, stat } from "node:fs/promises";
-import { basename, join, resolve } from "node:path";
 //#region src/share/share-auto.ts
 /**
 * Smart-share decision layer.

package/dist/src/share/share-store.js

@@ -1,14 +1,14 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { init_paths } from "../config/paths.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_paths } from "../config/paths.js";
 import { SHARE_CONFIG_DEFAULTS } from "./share-types.js";
 import { isPathUnderWorkspace } from "../gateway/workspace-editor-path.js";
 import { logShareAudit } from "./share-audit.js";
-import { randomBytes, randomUUID } from "node:crypto";
+import { join, relative, resolve } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { randomBytes, randomUUID } from "node:crypto";
 import { lstat, readdir, realpath, stat } from "node:fs/promises";
-import { join, relative, resolve } from "node:path";
 //#region src/share/share-store.ts
 init_paths();
 init_logger();

package/dist/src/share/share-thumbnail.js

@@ -1,12 +1,12 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { init_paths } from "../config/paths.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_paths } from "../config/paths.js";
 import { getShareStore } from "./share-store.js";
 import { getSiteShareStore } from "./site-share-store.js";
 import { loadPlaywrightCoreModule } from "../browser/providers/playwright-doctor.js";
-import { mkdir, readFile, stat, unlink, writeFile } from "node:fs/promises";
 import { join } from "node:path";
+import { mkdir, readFile, stat, unlink, writeFile } from "node:fs/promises";
 //#region src/share/share-thumbnail.ts
 /**
 * Thumbnail generator for shares.

package/dist/src/share/share-zip.js

@@ -1,7 +1,7 @@
 import { isPathUnderWorkspace } from "../gateway/workspace-editor-path.js";
+import { relative, resolve } from "node:path";
 import { createReadStream } from "node:fs";
 import { lstat, readdir, realpath, stat } from "node:fs/promises";
-import { relative, resolve } from "node:path";
 import { Readable, Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { crc32, createDeflateRaw } from "node:zlib";

package/dist/src/share/site-share-store.js

@@ -1,13 +1,13 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { init_paths } from "../config/paths.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_paths } from "../config/paths.js";
 import { SITE_SHARE_CONFIG_DEFAULTS } from "./site-share-types.js";
 import { isPathUnderWorkspace } from "../gateway/workspace-editor-path.js";
-import { randomBytes, randomUUID } from "node:crypto";
+import { join, relative, resolve } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { randomBytes, randomUUID } from "node:crypto";
 import { lstat, readdir, realpath, stat } from "node:fs/promises";
-import { join, relative, resolve } from "node:path";
 //#region src/share/site-share-store.ts
 init_paths();
 init_logger();

package/dist/src/share/site-static-serve.js

@@ -1,8 +1,8 @@
 import { isPathUnderWorkspace } from "../gateway/workspace-editor-path.js";
 import { resolveMimeType, shareResponseContentType } from "./share-store.js";
+import { join, relative, resolve } from "node:path";
 import { createReadStream } from "node:fs";
 import { readFile, stat } from "node:fs/promises";
-import { join, relative, resolve } from "node:path";
 import { Readable } from "node:stream";
 //#region src/share/site-static-serve.ts
 const HASHED_ASSET_RE = /\.[a-f0-9]{8,}\.(?:js|mjs|css|woff2?|ttf|otf|svg|png|jpg|jpeg|gif|webp|avif|ico)$/i;

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

@@ -4,8 +4,8 @@ import { init_logger } from "../../utils/logger.js";
 import { ensureXopcDatabaseSchema } from "./schema.js";
 import { requireNodeSqlite } from "../../infra/node-sqlite.js";
 import { installSqliteTransientRejectionHandler } from "../../infra/unhandled-rejections.js";
-import fs from "node:fs";
 import path from "node:path";
+import fs from "node:fs";
 import childProcess from "node:child_process";
 //#region src/storage/sqlite/connection.ts
 init_logger();

package/dist/src/storage/sqlite/memory-index-repository.js

@@ -1,8 +1,8 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "./transaction.js";
 import { escapeFts5Query } from "./fts.js";
-import { createHash } from "node:crypto";
-import { existsSync, readFileSync, statSync } from "node:fs";
 import { join, relative } from "node:path";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { createHash } from "node:crypto";
 //#region src/storage/sqlite/memory-index-repository.ts
 const CURATED_MEMORY_FILENAMES = new Set(["MEMORY.md", "USER.md"]);
 const MEMORY_SYNC_CACHE_TTL_MS = 3e4;

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.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();

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));

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

@@ -1,6 +1,6 @@
 import type { ExtensionRegistryImpl } from '../../extensions/loader.js';
 import type { ExportFormat } from '../../session/types.js';
-import type { ChatSendOptions, HistoryMessage, TuiBackend, TuiCompactionResult, TuiEvent, TuiModelChoice, TuiShareRequest, TuiShareResult, TuiSessionStats, TuiSessionItem, TuiTranscriptTreeEntry, TuiAgentInfo, TuiWorkspaceFileSearchEntry } from '../tui-backend.js';
+import type { ChatSendOptions, HistoryMessage, TuiBackend, TuiCompactionResult, TuiEvent, TuiModelChoice, TuiShareRequest, TuiShareResult, TuiSessionStats, TuiSessionItem, TuiTranscriptTreeEntry, TuiAgentInfo, TuiWorkspaceFileSearchEntry, TuiWorkflowRunStartRequest, TuiWorkflowRunStartResult } from '../tui-backend.js';
 import type { SessionInfo } from '../tui-types.js';
 interface EmbeddedBackendOptions {
     extensionRegistry?: ExtensionRegistryImpl;
@@ -17,6 +17,11 @@ export declare class EmbeddedBackend implements TuiBackend {
     private readonly opts?;
     private bus;
     private agent;
+    private config;
+    private workspace;
+    private sessionIndex;
+    private sessionIndexReady;
+    private workflowRunService;
     private running;
     private chatAbort;
     onEvent?: (evt: TuiEvent) => void;
@@ -27,7 +32,9 @@ export declare class EmbeddedBackend implements TuiBackend {
     start(): void;
     stop(): void;
     getActiveSignal(): AbortSignal | undefined;
+    private getWorkflowRunService;
     getStartupResources(sessionKey: string): Promise<import("../tui-backend.js").TuiStartupResources>;
+    startWorkflowRun(opts: TuiWorkflowRunStartRequest): Promise<TuiWorkflowRunStartResult>;
     searchWorkspaceFiles(sessionKey: string, query: string, options?: {
         limit?: number;
     }): Promise<TuiWorkspaceFileSearchEntry[]>;

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

@@ -1,12 +1,17 @@
 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 { getAvailableModels, init_providers } from "../../providers/index.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";
 import { transcriptRowsToClientHistory } from "../../session/client-history.js";
+import "../../session/index.js";
 import { parseModelRef } from "../../agent/models/selection.js";
 import { MessageBus, MessageBusShutdownError } from "../../infra/bus/queue.js";
 import "../../infra/bus/index.js";
@@ -14,6 +19,9 @@ 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";
+import { WorkflowRunService } from "../../workflows/service/workflow-run-service.js";
+import { WorkflowSessionBridge } from "../../workflows/service/workflow-session-bridge.js";
 import { ChatStreamMapper } from "../../gateway/chat-stream/mapper.js";
 import { fuzzySearchWorkspaceFiles } from "../../gateway/workspace-file-search.js";
 import { sessionMetadataToTuiItem } from "../tui-session-format.js";
@@ -23,6 +31,7 @@ import { collectTuiStartupResources } from "../tui-startup-resources.js";
 import { isAbsolute, relative, resolve } from "node:path";
 //#region src/tui/backends/embedded-backend.ts
 init_agent_scope();
+init_agent_session_key();
 init_providers();
 init_logger();
 const log = createLogger("TUI:Embedded");
@@ -39,6 +48,11 @@ function isPathSameOrInside(parentDir, childDir) {
 var EmbeddedBackend = class {
 	bus;
 	agent = null;
+	config = null;
+	workspace = "";
+	sessionIndex = null;
+	sessionIndexReady = null;
+	workflowRunService = null;
 	running = false;
 	chatAbort = null;
 	onEvent;
@@ -55,12 +69,26 @@ var EmbeddedBackend = class {
 		if (this.running) return;
 		this.running = true;
 		const config = loadConfig();
+		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) => {
+			const errorMessage = err instanceof Error ? err.message : String(err);
+			log.warn({
+				err,
+				errorMessage
+			}, `Embedded session index initialization failed: ${errorMessage}`);
+			throw err;
+		});
 		this.agent = new AgentService(this.bus, {
 			workspace,
 			model: modelId,
 			config,
+			sessionStore: this.sessionIndex.getStore(),
+			getWorkflowRunService: () => this.getWorkflowRunService(),
 			extensionRegistry: this.opts?.extensionRegistry,
 			isWorkspaceTrusted: (workspaceDir) => {
 				const explicit = this.opts?.isWorkspaceTrusted?.(workspaceDir);
@@ -93,9 +121,54 @@ var EmbeddedBackend = class {
 		const signal = this.chatAbort?.signal;
 		return signal && !signal.aborted ? signal : void 0;
 	}
+	getWorkflowRunService() {
+		if (this.workflowRunService) return this.workflowRunService;
+		if (!this.config || !this.sessionIndex || !this.agent) throw new Error("Embedded workflow runtime is not ready.");
+		const host = {
+			currentConfig: this.config,
+			currentWorkspacePath: this.workspace,
+			messageBusInstance: this.bus,
+			agentService: { getModelForSession: (sessionKey) => this.agent.getModelForSession(sessionKey) },
+			sessionIndexInstance: this.sessionIndex,
+			emit: (event, payload) => {
+				this.onEvent?.({
+					event,
+					data: payload,
+					source: "broadcast"
+				});
+			}
+		};
+		this.workflowRunService = new WorkflowRunService({
+			service: host,
+			sessionBridge: new WorkflowSessionBridge(host),
+			buildChildTools: buildWorkflowChildTools
+		});
+		return this.workflowRunService;
+	}
 	async getStartupResources(sessionKey) {
 		return collectTuiStartupResources(loadConfig(), sessionKey);
 	}
+	async startWorkflowRun(opts) {
+		await this.sessionIndexReady;
+		const agentId = opts.agentId?.trim() || resolveAgentIdFromSessionKey(opts.sessionKey);
+		const result = await this.getWorkflowRunService().startWorkflowRun({
+			agentId,
+			definitionId: opts.definitionId,
+			parentSessionKey: opts.sessionKey,
+			source: {
+				kind: "chat",
+				sessionKey: opts.sessionKey
+			},
+			goal: opts.goal,
+			input: opts.input
+		});
+		if (result.ok === false) throw new Error(result.message);
+		return {
+			runId: result.runId,
+			sessionKey: result.sessionKey,
+			definitionId: opts.definitionId
+		};
+	}
 	async searchWorkspaceFiles(sessionKey, query, options) {
 		if (!this.agent) return [];
 		try {