@cleocode/runtime 2026.10.13 → 2026.10.14-rc.ci.683

package/dist/{dispatch-BWjVeeMg.d.ts → dispatch-DOd44kC3.d.ts}

@@ -1,7 +1,140 @@
 import './gateway-handler-DCU6E0a2.js';
-import { SuggestedNextOp, OperationDef, Resolution } from '@cleocode/contracts';
-import '@cleocode/contracts/engine-result.js';
+import { EngineResult, ProblemDetails, SuggestedNextOp, OperationDef, Resolution } from '@cleocode/contracts';
 import { Source, DispatchResponse, DispatchResponseMeta, Middleware, Gateway, CanonicalDomain, Tier } from '@cleocode/contracts/gateway';
+import '@cleocode/contracts/engine-result.js';
+
+/**
+ * Centralized engine error helper for the transport-agnostic gateway.
+ *
+ * Every domain handler (and the engine barrel) imports `engineError()` /
+ * `engineSuccess()` from this module to produce consistently typed error
+ * results with correct exit codes and pino logging.
+ *
+ * The STRING_TO_EXIT map is the canonical mapping from string error codes
+ * to numeric exit codes. It mirrors ERROR_CODE_TO_EXIT in cli.ts.
+ *
+ * @remarks
+ * Relocated from `packages/cleo/src/dispatch/engines/_error.ts` into
+ * `@cleocode/runtime/gateway` (R3-K1 · T11455 · SG-RUNTIME-UNIFICATION) so the
+ * runtime owns the shared handler dependencies and can assemble the handler map
+ * without importing `@cleocode/cleo`. A thin re-export shim remains at the old
+ * `engines/_error.ts` path so in-package import sites compile unchanged.
+ *
+ * Error codes are organized into numeric ranges:
+ * - 1-9: General errors (invalid input, file, dependency, validation)
+ * - 10-19: Hierarchy errors (parent, depth, siblings, circular deps)
+ * - 20-29: Concurrency errors (checksum, modification, collision)
+ * - 30-39: Session errors (scope, claims, active task)
+ * - 40-47: Verification errors (gates, agents, rounds)
+ * - 50-54: Context safeguard (warning through emergency)
+ * - 60-67: Orchestrator / protocol errors
+ * - 70-79: Nexus errors
+ * - 80-94: Lifecycle, artifact, provenance errors
+ * - 95-99: Adapter errors
+ * - 100+: Special informational codes (not errors)
+ */
+
+/**
+ * Canonical mapping from string error codes to numeric exit codes.
+ *
+ * Source of truth: src/types/exit-codes.ts (ExitCode enum).
+ * Must stay in sync with ERROR_CODE_TO_EXIT in src/dispatch/adapters/cli.ts.
+ */
+declare const STRING_TO_EXIT: Record<string, number>;
+/**
+ * Create a typed engine error result with pino logging and correct exit code.
+ *
+ * @remarks
+ * The exit code is derived from the {@link STRING_TO_EXIT} mapping. If the
+ * code is not found in the map, exit code 1 (general error) is used.
+ * Pino logging is automatically triggered at the appropriate level
+ * (error for internal issues, warn for user/domain errors, debug for
+ * informational codes). Logging is suppressed under Vitest to keep
+ * test output clean.
+ *
+ * @param code - String error code (e.g., 'E_NOT_FOUND')
+ * @param message - Human-readable error message
+ * @param options - Optional details, fix command, and alternatives
+ * @returns EngineResult with success=false and properly structured error
+ *
+ * @example
+ * ```typescript
+ * import { engineError } from './_error.js';
+ *
+ * return engineError('E_NOT_FOUND', `Task ${id} not found`, {
+ *   fix: `cleo show ${id}`,
+ *   details: { taskId: id },
+ * });
+ * ```
+ */
+declare function engineError<T>(code: string, message: string, options?: {
+    exitCode?: number;
+    details?: Record<string, unknown>;
+    fix?: string;
+    alternatives?: Array<{
+        action: string;
+        command: string;
+    }>;
+    problemDetails?: ProblemDetails;
+}): EngineResult<T>;
+
+/**
+ * Minimal meta shape carrying the request ID for RFC 7807 `instance` population.
+ *
+ * Callers may pass the dispatch-layer `DispatchRequest.requestId` (or any
+ * other correlation identifier) so that the resulting `problemDetails.instance`
+ * URI uniquely identifies the specific error occurrence.
+ */
+interface ErrorMeta {
+    /** Unique request identifier (used as the RFC 7807 `instance` field). */
+    requestId?: string;
+}
+/**
+ * Convert any caught value into an {@link EngineResult}, forwarding the rich
+ * `fix`, `details`, and `alternatives` fields when the caught value is a
+ * `CleoError` (or structurally compatible object).
+ *
+ * @remarks
+ * This is the canonical catch-block helper for all dispatch engines. It
+ * replaces the previous pattern of:
+ * ```typescript
+ * const code = (err as { code?: number })?.code;
+ * if (code === 4) return engineError('E_NOT_FOUND', …);
+ * …
+ * ```
+ * with a single call that preserves every field the core layer attached.
+ *
+ * The `fallbackCode` is used when the numeric `err.code` is not present in
+ * the {@link STRING_TO_EXIT} mapping (e.g. unknown exit codes, plain `Error`
+ * instances, or values thrown by non-CLEO code).
+ *
+ * RFC 7807 `problemDetails` is always populated from the resolved code, message,
+ * and exit code. The optional `meta.requestId` is forwarded to the `instance`
+ * field so every error occurrence is uniquely identifiable.
+ *
+ * @param err - The caught value (unknown type)
+ * @param fallbackCode - String error code to use when mapping fails
+ * @param fallbackMessage - Human-readable message when `err.message` is absent
+ * @param meta - Optional dispatch meta carrying `requestId` for RFC 7807 `instance`
+ * @returns EngineResult with all available rich fields propagated
+ *
+ * @example
+ * ```typescript
+ * import { cleoErrorToEngineError } from './_error.js';
+ *
+ * } catch (err: unknown) {
+ *   return cleoErrorToEngineError(err, 'E_NOT_INITIALIZED', 'Task database not initialized');
+ * }
+ * ```
+ *
+ * @example With requestId for RFC 7807 instance field:
+ * ```typescript
+ * } catch (err: unknown) {
+ *   return cleoErrorToEngineError(err, 'E_NOT_FOUND', 'Not found', { requestId });
+ * }
+ * ```
+ */
+declare function cleoErrorToEngineError<T>(err: unknown, fallbackCode: string, fallbackMessage: string, meta?: ErrorMeta): EngineResult<T>;
 
 /**
  * Dispatch-local metadata factory.
@@ -287,4 +420,4 @@ declare function getCounts(): {
     total: number;
 };
 
-export { BRAIN_DB_FILENAME as B, CLEO_DIR_NAME as C, OPERATIONS as O, type StreamResolution as S, WORKFLOWS_SUBDIR as W, createDispatchMeta as a, buildNexusMetaExtensions as b, compose as c, deriveGatewayMatrix as d, getByDomain as e, formatSuggestedNext as f, getActiveDomains as g, getByGateway as h, getByTier as i, getCounts as j, getGatewayDomains as k, inferGateway as l, resolveStreamRoute as m, validateSuggestedNext as n, pickDecoratorMetaExtensions as p, resolve as r, stampNexusMeta as s, validateRequiredParams as v };
+export { BRAIN_DB_FILENAME as B, CLEO_DIR_NAME as C, type ErrorMeta as E, OPERATIONS as O, STRING_TO_EXIT as S, WORKFLOWS_SUBDIR as W, type StreamResolution as a, buildNexusMetaExtensions as b, cleoErrorToEngineError as c, compose as d, createDispatchMeta as e, deriveGatewayMatrix as f, engineError as g, formatSuggestedNext as h, getActiveDomains as i, getByDomain as j, getByGateway as k, getByTier as l, getCounts as m, getGatewayDomains as n, inferGateway as o, pickDecoratorMetaExtensions as p, resolveStreamRoute as q, resolve as r, stampNexusMeta as s, validateSuggestedNext as t, validateRequiredParams as v };

package/dist/gateway/dispatch.d.ts

@@ -1,5 +1,5 @@
 export { D as Dispatcher, a as DispatcherConfig, G as GatewayHandler, c as createGatewayHandler } from '../gateway-handler-DCU6E0a2.js';
+export { B as BRAIN_DB_FILENAME, C as CLEO_DIR_NAME, O as OPERATIONS, W as WORKFLOWS_SUBDIR, b as buildNexusMetaExtensions, c as cleoErrorToEngineError, d as compose, e as createDispatchMeta, f as deriveGatewayMatrix, h as formatSuggestedNext, i as getActiveDomains, j as getByDomain, k as getByGateway, l as getByTier, m as getCounts, n as getGatewayDomains, p as pickDecoratorMetaExtensions, r as resolve, s as stampNexusMeta, v as validateRequiredParams, t as validateSuggestedNext } from '../dispatch-DOd44kC3.js';
 export { OperationDef, Resolution } from '@cleocode/contracts';
 export { engineSuccess } from '@cleocode/contracts/engine-result.js';
-export { B as BRAIN_DB_FILENAME, C as CLEO_DIR_NAME, O as OPERATIONS, W as WORKFLOWS_SUBDIR, b as buildNexusMetaExtensions, c as compose, a as createDispatchMeta, d as deriveGatewayMatrix, f as formatSuggestedNext, g as getActiveDomains, e as getByDomain, h as getByGateway, i as getByTier, j as getCounts, k as getGatewayDomains, p as pickDecoratorMetaExtensions, r as resolve, s as stampNexusMeta, v as validateRequiredParams, n as validateSuggestedNext } from '../dispatch-BWjVeeMg.js';
 import '@cleocode/contracts/gateway';

package/dist/gateway/dispatch.js

@@ -4,6 +4,7 @@ import {
   Dispatcher,
   WORKFLOWS_SUBDIR,
   buildNexusMetaExtensions,
+  cleoErrorToEngineError,
   compose,
   createDispatchMeta,
   createGatewayHandler,
@@ -32,6 +33,7 @@ export {
   OPERATIONS,
   WORKFLOWS_SUBDIR,
   buildNexusMetaExtensions,
+  cleoErrorToEngineError,
   compose,
   createDispatchMeta,
   createGatewayHandler,

package/dist/gateway/index.d.ts

@@ -1,6 +1,6 @@
 import { BackgroundJobManager } from '@cleocode/core/store/background-jobs.js';
 export { BackgroundJob, BackgroundJobManager, BackgroundJobManagerConfig, BackgroundJobStatus, DurableJobStore } from '@cleocode/core/store/background-jobs.js';
-import { Subsystem, EngineResult, ProblemDetails } from '@cleocode/contracts';
+import { Subsystem } from '@cleocode/contracts';
 export { MinimalTaskRecord, OperationDef, Resolution, Session as SessionRecord, TaskRecord } from '@cleocode/contracts';
 import { HttpServerHandle, HttpServerOptions } from './http/index.js';
 export { GatewayStreamSource, HttpUnaryRequest, HttpUnaryResult, SSE_HEADERS, STUDIO_PREFIX, SseEmitter, SseFrame, SseSource, StreamSourceContext, StreamSourceTeardown, StudioStaticOptions, createSseStream, encodeSseFrame, encodeStreamEvent, isStudioPath, mimeType, parseHttpRoute, registerStreamSource, resolveStreamSource, resolveStudioAssetPath, resolveStudioStaticDir, routeUnary, serveStudioStatic, startHttpServer, statusForResponse, tickStreamSource, writeBundleAbsentError } from './http/index.js';
@@ -11,10 +11,10 @@ export { D as Dispatcher, a as DispatcherConfig, c as createGatewayHandler } fro
 export { OrchestratePlanResult } from '@cleocode/contracts/operations/orchestrate';
 import * as _cleocode_core_internal from '@cleocode/core/internal';
 export { ArchiveStatsResult as ArchiveStatsData, AuditResult as AuditData, BackupResult as BackupData, BackupEntry as BackupEntryData, CleanupResult as CleanupData, CompactTask, ComplianceData, ContextData, DashboardData, DecisionRecord, DiagnosticsResult as DiagnosticsData, FileRestoreResult, HealthResult as HealthData, HelpData, HookMatrixResult, InjectGenerateResult as InjectGenerateData, IssueTemplate, IvtrHistoryEntry, LabelsResult as LabelsData, LifecycleStageEntry, LogQueryData, SystemMetricsResult as MetricsData, MigrateResult as MigrateData, OrchestratePlanInput, PathsData, PlanWarning, PlanWave, PlanWorkerEntry, ProviderMatrixEntry, ManifestEntry as ResearchManifestEntry, RestoreResult as RestoreData, RuntimeDiagnostics as RuntimeData, SafestopResult as SafestopData, ScaffoldHubData, StatsData, SyncData, TemplateConfig, TemplateSection, UncancelResult as UncancelData, addTaskWithSessionScope, completeTaskStrict, configGet, configListPresets, configSet, configSetPreset, ensureInitialized, filterEntries as filterManifestEntries, getVersion, initProject, isAutoInitEnabled, lifecycleCheck, lifecycleGateFail, lifecycleGatePass, lifecycleGates, lifecycleHistory, lifecyclePrerequisites, lifecycleProgress, lifecycleReset, lifecycleSkip, lifecycleStatus, mapCodebase, memoryBrainStats, memoryContradictions, memoryDecisionFind, memoryDecisionStore, memoryFetch, memoryFind, memoryGraphAdd, memoryGraphContext, memoryGraphNeighbors, memoryGraphRelated, memoryGraphRemove, memoryGraphShow, memoryGraphStatsFull, memoryGraphTrace, memoryLearningFind, memoryLearningStats, memoryLearningStore, memoryLink, memoryObserve, memoryPatternFind, memoryPatternStats, memoryPatternStore, memoryQualityReport, memoryReasonSimilar, memoryReasonWhy, memorySearchHybrid, memoryShow, memorySuperseded, memoryTimeline, memoryUnlink, orchestrateAnalyze, orchestrateBootstrap, orchestrateCheck, orchestrateContext, orchestrateCriticalPath, orchestrateHandoff, orchestrateNext, orchestrateParallelEnd, orchestrateParallelStart, orchestratePlan, orchestrateReady, orchestrateReport, orchestrateSkillInject, orchestrateSpawn, orchestrateSpawnExecute, orchestrateStartup, orchestrateStatus, orchestrateUnblockOpportunities, orchestrateValidate, orchestrateWaves, phaseAdvance, phaseComplete, phaseDelete, phaseList, phaseRename, phaseSet, phaseShow, phaseStart, pipelineManifestAppend, pipelineManifestArchive, pipelineManifestFind, pipelineManifestList, pipelineManifestPending, pipelineManifestShow, pipelineManifestStats, queryCommonHooks, queryHookProviders, readManifestEntries, releaseCancel, releaseCommit, releaseGateCheck, releaseGatesRun, releaseIvtrAutoSuggest, releaseList, releaseOpen, releasePlan, releasePrStatus, releasePrepare, releasePush, releaseReconcileV2, releaseRollback, releaseRollbackFull, releaseShow, releaseTag, sessionAdopt, sessionArchive, sessionBriefing, sessionChainShow, sessionCleanup, sessionComputeDebrief, sessionComputeHandoff, sessionContextDrift, sessionContextInject, sessionDebriefShow, sessionDecisionLog, sessionEnd, sessionFind, sessionGc, sessionHandoff, sessionHistory, sessionList, sessionRecordAssumption, sessionRecordDecision, sessionResume, sessionShow, sessionStart, sessionStats, sessionStatus, sessionSuspend, sessionSwitch, systemHooksMatrix, taskAnalyze, taskArchive, taskAssignee, taskBatchValidate, taskBlockers, taskBulkMove, taskCancel, taskClaim, taskComplete, taskComplexityEstimate, taskCurrentGet, taskDecompose, taskDelete, taskDepends, taskDeps, taskDepsCycles, taskDepsOverview, taskDepsTree, taskDepsValidate, taskExists, taskExport, taskFind, taskHistory, taskImpact, taskImport, taskLabelList, taskLabelShow, taskLint, taskList, taskNext, taskPlan, taskPromote, taskRankingHistory, taskRankingRevert, taskReconcileScope, taskRelates, taskRelatesAdd, taskRelatesAddBatch, taskRelatesFind, taskRelatesRemove, taskReopen, taskReorder, taskReorderRank, taskReparent, taskRestore, taskShow, taskShowIvtrHistory, taskShowOperation, taskShowWithHistory, taskSlice, taskStart, taskStats, taskStop, taskSyncLinks, taskSyncLinksRemove, taskSyncReconcile, taskTree, taskUnarchive, taskUnclaim, taskUpdate, taskWorkHistory, tasksAddBatchOp, coreBatchValidate as validateBatchValidate, validateChangelog, coreCoherenceCheck as validateCoherenceCheck, coreComplianceRecord as validateComplianceRecord, coreComplianceSummary as validateComplianceSummary, coreComplianceViolations as validateComplianceViolations, validateGateVerify, coreValidateManifest as validateManifestOp, coreValidateOutput as validateOutput, coreValidateProtocol as validateProtocol, validateProtocolArchitectureDecision, validateProtocolArtifactPublish, validateProtocolConsensus, validateProtocolContribution, validateProtocolDecomposition, validateProtocolImplementation, validateProtocolProvenance, validateProtocolRelease, validateProtocolResearch, validateProtocolSpecification, validateProtocolTesting, validateProtocolValidation, coreValidateSchema as validateSchemaOp, coreValidateTask as validateTaskOp, coreTestCoverage as validateTestCoverage, coreTestRun as validateTestRun, coreTestStatus as validateTestStatus } from '@cleocode/core/internal';
-import { EngineResult as EngineResult$1 } from '@cleocode/core';
+import { EngineResult } from '@cleocode/core';
 export { EngineResult } from '@cleocode/core';
+export { B as BRAIN_DB_FILENAME, C as CLEO_DIR_NAME, E as ErrorMeta, O as OPERATIONS, S as STRING_TO_EXIT, a as StreamResolution, W as WORKFLOWS_SUBDIR, b as buildNexusMetaExtensions, c as cleoErrorToEngineError, d as compose, e as createDispatchMeta, f as deriveGatewayMatrix, g as engineError, h as formatSuggestedNext, i as getActiveDomains, j as getByDomain, k as getByGateway, l as getByTier, m as getCounts, n as getGatewayDomains, o as inferGateway, p as pickDecoratorMetaExtensions, r as resolve, q as resolveStreamRoute, s as stampNexusMeta, v as validateRequiredParams, t as validateSuggestedNext } from '../dispatch-DOd44kC3.js';
 export { GatewayOperationKey, MCP_TOOL_PREFIX, McpContent, McpInputProperty, McpServerOptions, McpTool, McpToolResult, buildToolsList, callTool, exposedOperations, operationToMcpTool, operationToToolName, startMcpServer, toolNameToOperationKey } from './mcp/index.js';
-export { B as BRAIN_DB_FILENAME, C as CLEO_DIR_NAME, O as OPERATIONS, S as StreamResolution, W as WORKFLOWS_SUBDIR, b as buildNexusMetaExtensions, c as compose, a as createDispatchMeta, d as deriveGatewayMatrix, f as formatSuggestedNext, g as getActiveDomains, e as getByDomain, h as getByGateway, i as getByTier, j as getCounts, k as getGatewayDomains, l as inferGateway, p as pickDecoratorMetaExtensions, r as resolve, m as resolveStreamRoute, s as stampNexusMeta, v as validateRequiredParams, n as validateSuggestedNext } from '../dispatch-BWjVeeMg.js';
 export { engineSuccess } from '@cleocode/contracts/engine-result.js';
 import 'node:http';
 import '@cleocode/contracts/gateway';
@@ -166,139 +166,6 @@ declare function gatewaySubsystemName(scope: GatewayScope): string;
  */
 declare function defineGatewaySubsystem(opts: GatewaySubsystemOptions): Subsystem<GatewaySubsystemContext>;
 
-/**
- * Centralized engine error helper for the transport-agnostic gateway.
- *
- * Every domain handler (and the engine barrel) imports `engineError()` /
- * `engineSuccess()` from this module to produce consistently typed error
- * results with correct exit codes and pino logging.
- *
- * The STRING_TO_EXIT map is the canonical mapping from string error codes
- * to numeric exit codes. It mirrors ERROR_CODE_TO_EXIT in cli.ts.
- *
- * @remarks
- * Relocated from `packages/cleo/src/dispatch/engines/_error.ts` into
- * `@cleocode/runtime/gateway` (R3-K1 · T11455 · SG-RUNTIME-UNIFICATION) so the
- * runtime owns the shared handler dependencies and can assemble the handler map
- * without importing `@cleocode/cleo`. A thin re-export shim remains at the old
- * `engines/_error.ts` path so in-package import sites compile unchanged.
- *
- * Error codes are organized into numeric ranges:
- * - 1-9: General errors (invalid input, file, dependency, validation)
- * - 10-19: Hierarchy errors (parent, depth, siblings, circular deps)
- * - 20-29: Concurrency errors (checksum, modification, collision)
- * - 30-39: Session errors (scope, claims, active task)
- * - 40-47: Verification errors (gates, agents, rounds)
- * - 50-54: Context safeguard (warning through emergency)
- * - 60-67: Orchestrator / protocol errors
- * - 70-79: Nexus errors
- * - 80-94: Lifecycle, artifact, provenance errors
- * - 95-99: Adapter errors
- * - 100+: Special informational codes (not errors)
- */
-
-/**
- * Canonical mapping from string error codes to numeric exit codes.
- *
- * Source of truth: src/types/exit-codes.ts (ExitCode enum).
- * Must stay in sync with ERROR_CODE_TO_EXIT in src/dispatch/adapters/cli.ts.
- */
-declare const STRING_TO_EXIT: Record<string, number>;
-/**
- * Create a typed engine error result with pino logging and correct exit code.
- *
- * @remarks
- * The exit code is derived from the {@link STRING_TO_EXIT} mapping. If the
- * code is not found in the map, exit code 1 (general error) is used.
- * Pino logging is automatically triggered at the appropriate level
- * (error for internal issues, warn for user/domain errors, debug for
- * informational codes). Logging is suppressed under Vitest to keep
- * test output clean.
- *
- * @param code - String error code (e.g., 'E_NOT_FOUND')
- * @param message - Human-readable error message
- * @param options - Optional details, fix command, and alternatives
- * @returns EngineResult with success=false and properly structured error
- *
- * @example
- * ```typescript
- * import { engineError } from './_error.js';
- *
- * return engineError('E_NOT_FOUND', `Task ${id} not found`, {
- *   fix: `cleo show ${id}`,
- *   details: { taskId: id },
- * });
- * ```
- */
-declare function engineError<T>(code: string, message: string, options?: {
-    exitCode?: number;
-    details?: Record<string, unknown>;
-    fix?: string;
-    alternatives?: Array<{
-        action: string;
-        command: string;
-    }>;
-    problemDetails?: ProblemDetails;
-}): EngineResult<T>;
-
-/**
- * Minimal meta shape carrying the request ID for RFC 7807 `instance` population.
- *
- * Callers may pass the dispatch-layer `DispatchRequest.requestId` (or any
- * other correlation identifier) so that the resulting `problemDetails.instance`
- * URI uniquely identifies the specific error occurrence.
- */
-interface ErrorMeta {
-    /** Unique request identifier (used as the RFC 7807 `instance` field). */
-    requestId?: string;
-}
-/**
- * Convert any caught value into an {@link EngineResult}, forwarding the rich
- * `fix`, `details`, and `alternatives` fields when the caught value is a
- * `CleoError` (or structurally compatible object).
- *
- * @remarks
- * This is the canonical catch-block helper for all dispatch engines. It
- * replaces the previous pattern of:
- * ```typescript
- * const code = (err as { code?: number })?.code;
- * if (code === 4) return engineError('E_NOT_FOUND', …);
- * …
- * ```
- * with a single call that preserves every field the core layer attached.
- *
- * The `fallbackCode` is used when the numeric `err.code` is not present in
- * the {@link STRING_TO_EXIT} mapping (e.g. unknown exit codes, plain `Error`
- * instances, or values thrown by non-CLEO code).
- *
- * RFC 7807 `problemDetails` is always populated from the resolved code, message,
- * and exit code. The optional `meta.requestId` is forwarded to the `instance`
- * field so every error occurrence is uniquely identifiable.
- *
- * @param err - The caught value (unknown type)
- * @param fallbackCode - String error code to use when mapping fails
- * @param fallbackMessage - Human-readable message when `err.message` is absent
- * @param meta - Optional dispatch meta carrying `requestId` for RFC 7807 `instance`
- * @returns EngineResult with all available rich fields propagated
- *
- * @example
- * ```typescript
- * import { cleoErrorToEngineError } from './_error.js';
- *
- * } catch (err: unknown) {
- *   return cleoErrorToEngineError(err, 'E_NOT_INITIALIZED', 'Task database not initialized');
- * }
- * ```
- *
- * @example With requestId for RFC 7807 instance field:
- * ```typescript
- * } catch (err: unknown) {
- *   return cleoErrorToEngineError(err, 'E_NOT_FOUND', 'Not found', { requestId });
- * }
- * ```
- */
-declare function cleoErrorToEngineError<T>(err: unknown, fallbackCode: string, fallbackMessage: string, meta?: ErrorMeta): EngineResult<T>;
-
 /**
  * Parse all templates from the repo's .github/ISSUE_TEMPLATE/ directory.
  *
@@ -317,7 +184,7 @@ declare function cleoErrorToEngineError<T>(err: unknown, fallbackCode: string, f
  * }
  * ```
  */
-declare function parseIssueTemplates(projectRoot: string): EngineResult$1<_cleocode_core_internal.TemplateConfig>;
+declare function parseIssueTemplates(projectRoot: string): EngineResult<_cleocode_core_internal.TemplateConfig>;
 /**
  * Get template config for a specific subcommand (bug/feature/help).
  *
@@ -334,7 +201,7 @@ declare function parseIssueTemplates(projectRoot: string): EngineResult$1<_cleoc
  * const result = getTemplateForSubcommand('/path/to/project', 'bug');
  * ```
  */
-declare function getTemplateForSubcommand(projectRoot: string, subcommand: string): EngineResult$1<_cleocode_core_internal.IssueTemplate>;
+declare function getTemplateForSubcommand(projectRoot: string, subcommand: string): EngineResult<_cleocode_core_internal.IssueTemplate>;
 /**
  * Generate and cache the config as .cleo/issue-templates.json.
  *
@@ -349,7 +216,7 @@ declare function getTemplateForSubcommand(projectRoot: string, subcommand: strin
  * const result = await generateTemplateConfig('/path/to/project');
  * ```
  */
-declare function generateTemplateConfig(projectRoot: string): Promise<EngineResult$1<_cleocode_core_internal.TemplateConfig>>;
+declare function generateTemplateConfig(projectRoot: string): Promise<EngineResult<_cleocode_core_internal.TemplateConfig>>;
 /**
  * Validate that labels exist on a GitHub repo.
  *
@@ -365,7 +232,7 @@ declare function generateTemplateConfig(projectRoot: string): Promise<EngineResu
  * const result = validateLabels(['bug', 'enhancement'], repoLabels);
  * ```
  */
-declare function validateLabels(labels: string[], repoLabels: string[]): EngineResult$1<{
+declare function validateLabels(labels: string[], repoLabels: string[]): EngineResult<{
     existing: string[];
     missing: string[];
 }>;
@@ -553,4 +420,4 @@ interface ServeGatewayHandle {
  */
 declare function serveGateway(opts: ServeGatewayOptions): Promise<ServeGatewayHandle>;
 
-export { type ErrorMeta, GatewayHandler, type GatewayScope, type GatewaySubsystemContext, type GatewaySubsystemOptions, HttpServerHandle, HttpServerOptions, RpcServerHandle, RpcServerOptions, STRING_TO_EXIT, type ServeGatewayHandle, type ServeGatewayOptions, cleoErrorToEngineError, defineGatewaySubsystem, engineError, gatewaySubsystemName, generateTemplateConfig, getJobManager, getTemplateForSubcommand, mapNumericExitCodeToString, parseIssueTemplates, serveGateway, setJobManager, validateLabels };
+export { GatewayHandler, type GatewayScope, type GatewaySubsystemContext, type GatewaySubsystemOptions, HttpServerHandle, HttpServerOptions, RpcServerHandle, RpcServerOptions, type ServeGatewayHandle, type ServeGatewayOptions, defineGatewaySubsystem, gatewaySubsystemName, generateTemplateConfig, getJobManager, getTemplateForSubcommand, mapNumericExitCodeToString, parseIssueTemplates, serveGateway, setJobManager, validateLabels };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/runtime",
-  "version": "2026.10.13",
+  "version": "2026.10.14-rc.ci.683",
   "description": "Long-running process layer for CLEO — agent polling, SSE connections, heartbeat, key rotation",
   "type": "module",
   "main": "dist/index.js",
@@ -37,8 +37,8 @@
   },
   "dependencies": {
     "node-cron": "^4.2.1",
-    "@cleocode/contracts": "2026.10.13",
-    "@cleocode/core": "2026.10.13"
+    "@cleocode/contracts": "2026.10.14-rc.ci.683",
+    "@cleocode/core": "2026.10.14-rc.ci.683"
   },
   "devDependencies": {
     "tsup": "^8.0.0",