smithers-orchestrator 0.25.3 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smithers-orchestrator",
-  "version": "0.25.3",
+  "version": "0.26.0",
   "description": "Public Smithers facade for durable coding-agent workflows and Gateway operation",
   "license": "MIT",
   "homepage": "https://smithers.sh",
@@ -92,28 +92,28 @@
     "incur": "^0.4.1",
     "react": "^19.2.5",
     "zod": "^4.3.6",
-    "@smithers-orchestrator/agents": "0.25.3",
-    "@smithers-orchestrator/components": "0.25.3",
-    "@smithers-orchestrator/cli": "0.25.3",
-    "@smithers-orchestrator/driver": "0.25.3",
-    "@smithers-orchestrator/control-plane": "0.25.3",
-    "@smithers-orchestrator/engine": "0.25.3",
-    "@smithers-orchestrator/gateway-client": "0.25.3",
-    "@smithers-orchestrator/gateway-react": "0.25.3",
-    "@smithers-orchestrator/errors": "0.25.3",
-    "@smithers-orchestrator/db": "0.25.3",
-    "@smithers-orchestrator/memory": "0.25.3",
-    "@smithers-orchestrator/graph": "0.25.3",
-    "@smithers-orchestrator/observability": "0.25.3",
-    "@smithers-orchestrator/sandbox": "0.25.3",
-    "@smithers-orchestrator/openapi": "0.25.3",
-    "@smithers-orchestrator/react-reconciler": "0.25.3",
-    "@smithers-orchestrator/scheduler": "0.25.3",
-    "@smithers-orchestrator/scorers": "0.25.3",
-    "@smithers-orchestrator/server": "0.25.3",
-    "@smithers-orchestrator/time-travel": "0.25.3",
-    "@smithers-orchestrator/tool-context": "0.25.3",
-    "@smithers-orchestrator/vcs": "0.25.3"
+    "@smithers-orchestrator/agents": "0.26.0",
+    "@smithers-orchestrator/components": "0.26.0",
+    "@smithers-orchestrator/control-plane": "0.26.0",
+    "@smithers-orchestrator/db": "0.26.0",
+    "@smithers-orchestrator/cli": "0.26.0",
+    "@smithers-orchestrator/driver": "0.26.0",
+    "@smithers-orchestrator/errors": "0.26.0",
+    "@smithers-orchestrator/engine": "0.26.0",
+    "@smithers-orchestrator/gateway-client": "0.26.0",
+    "@smithers-orchestrator/gateway-react": "0.26.0",
+    "@smithers-orchestrator/graph": "0.26.0",
+    "@smithers-orchestrator/openapi": "0.26.0",
+    "@smithers-orchestrator/memory": "0.26.0",
+    "@smithers-orchestrator/observability": "0.26.0",
+    "@smithers-orchestrator/react-reconciler": "0.26.0",
+    "@smithers-orchestrator/sandbox": "0.26.0",
+    "@smithers-orchestrator/scheduler": "0.26.0",
+    "@smithers-orchestrator/scorers": "0.26.0",
+    "@smithers-orchestrator/server": "0.26.0",
+    "@smithers-orchestrator/time-travel": "0.26.0",
+    "@smithers-orchestrator/vcs": "0.26.0",
+    "@smithers-orchestrator/tool-context": "0.26.0"
   },
   "optionalDependencies": {
     "@electric-sql/pglite": "0.5.1",

package/src/index.d.ts

@@ -58,7 +58,7 @@ import { WorkflowProps } from '@smithers-orchestrator/components/components/Work
 import * as _smithers_server_gateway from '@smithers-orchestrator/server/gateway';
 export { Gateway } from '@smithers-orchestrator/server/gateway';
 import * as _smithers_agents from '@smithers-orchestrator/agents';
-export { AmpAgent, AnthropicAgent, AntigravityAgent, ClaudeCodeAgent, CodexAgent, ForgeAgent, GeminiAgent, HermesAgent, KimiAgent, OpenAIAgent, OpenCodeAgent, PiAgent, VibeAgent, createHttpTool } from '@smithers-orchestrator/agents';
+export { AmpAgent, AnthropicAgent, AntigravityAgent, ClaudeCodeAgent, CodexAgent, ForgeAgent, GeminiAgent, HermesAgent, HermesCliAgent, KimiAgent, OpenAIAgent, OpenCodeAgent, PiAgent, VibeAgent, createHttpTool } from '@smithers-orchestrator/agents';
 import * as _smithers_scorers from '@smithers-orchestrator/scorers';
 export { aggregateScores, createScorer, faithfulnessScorer, latencyScorer, llmJudge, relevancyScorer, runScorersAsync, runScorersBatch, schemaAdherenceScorer, smithersScorers, toxicityScorer } from '@smithers-orchestrator/scorers';
 import * as _smithers_agents_capability_registry from '@smithers-orchestrator/agents/capability-registry';
@@ -428,6 +428,7 @@ type SmithersMigrationResult = SmithersMigrationResult$1;
 type OpenAIAgentOptions<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = _smithers_agents.OpenAIAgentOptions<CALL_OPTIONS, TOOLS>;
 type OpenSmithersBackendOptions = OpenSmithersBackendOptions$1;
 type HermesAgentOptions<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = _smithers_agents.HermesAgentOptions<CALL_OPTIONS, TOOLS>;
+type HermesCliAgentOptions = _smithers_agents.HermesCliAgentOptions;
 type HttpToolAuth = _smithers_agents.HttpToolAuth;
 type HttpToolInput = _smithers_agents.HttpToolInput;
 type HttpToolOutput = _smithers_agents.HttpToolOutput;
@@ -508,4 +509,4 @@ type XmlElement = _smithers_graph_XmlNode.XmlElement;
 type XmlNode = _smithers_graph_XmlNode.XmlNode;
 type XmlText = _smithers_graph_XmlNode.XmlText;
 
-export { type AgentCapabilityRegistry, type AgentLike, type AgentToolDescriptor, type AggregateOptions, type AggregateScore, type AnthropicAgentOptions, type ApprovalAutoApprove, type ApprovalDecision, type ApprovalMode, type ApprovalOption, type ApprovalProps, type ApprovalRanking, type ApprovalRequest, type ApprovalSelection, type ColumnDef, type ConnectRequest, type ContinueAsNewProps, type CreateHttpToolOptions, type CreateScorerConfig, type CreateSmithersApi, type CreateSmithersOptions, type DepsSpec, type EventFrame, type ExternalSmithersConfig, type GatewayAuthConfig, type GatewayDefaults, type GatewayOperatorUiConfig, type GatewayOptions, type GatewayRegisterOptions, type GatewayTokenGrant, type GatewayUiConfig, type GatewayWebhookConfig, type GatewayWebhookRunConfig, type GatewayWebhookSignalConfig, type GraphSnapshot, type HelloResponse, type HermesAgentOptions, type HostContainer, type HostNodeJson, type HttpToolAuth, type HttpToolInput, type HttpToolOutput, type InferDeps, type InferOutputEntry, type InferRow, type JjRevertResult, type KanbanProps, type KnownSmithersErrorCode, type LlmJudgeConfig, type MemoryFact, type MemoryLayerConfig, type MemoryMessage, type MemoryNamespace, type MemoryNamespaceKind, type MemoryProcessor, type MemoryProcessorConfig, type MemoryServiceApi, type MemoryStore, type MemoryThread, type MessageHistoryConfig, type MigrateSmithersStoreOptions, type OpenAIAgentOptions, type OpenApiAuth, type OpenApiSpec, type OpenApiToolsOptions, type OpenCodeAgentOptions, type OpenSmithersBackendOptions, type OutputAccessor, type OutputKey, type OutputTarget, type PiAgentOptions, type PiExtensionUiRequest, type PiExtensionUiResponse, type PollerProps, type RequestFrame, type ResolvedSmithersObservabilityOptions, type ResponseFrame, type RevertOptions, type RevertResult, type RunJjOptions, type RunJjResult, type RunOptions, type RunResult, type RunStatus, type SagaProps, type SagaStepDef, type SagaStepProps, type SamplingConfig, type SandboxProps, type SandboxRuntime, type SandboxVolumeMount, type SandboxWorkspaceSpec, type SchemaRegistryEntry, type ScoreResult, type ScoreRow, type Scorer, type ScorerBinding, type ScorerContext, type ScorerFn, type ScorerInput, type ScorersMap, type SemanticRecallConfig, type SerializedCtx, type ServeOptions, type ServerOptions, type SignalProps, type SmithersAlertLabels, type SmithersAlertPolicy, type SmithersAlertPolicyDefaults, type SmithersAlertPolicyRule, type SmithersAlertReaction, type SmithersAlertReactionKind, type SmithersAlertReactionRef, type SmithersAlertSeverity, type SmithersCtx, type SmithersError, type SmithersErrorCode, type SmithersEvent, type SmithersLogFormat, type SmithersMigrationResult, type SmithersObservabilityOptions, type SmithersObservabilityService, type SmithersWorkflow, type SmithersWorkflowOptions, type TaskDescriptor, type TaskMemoryConfig, type TaskProps, type TimeTravelOptions, type TimeTravelResult, type TimerProps, type TryCatchFinallyProps, type VibeAgentOptions, type WaitForEventProps, type WorkingMemoryConfig, type WorkspaceAddOptions, type WorkspaceInfo, type WorkspaceResult, type XmlElement, type XmlNode, type XmlText, bash, createExternalSmithers, createSmithers, createSmithersPostgres, defineTool, edit, getDefinedToolMetadata, grep, mdxPlugin, migrateSmithersStore, openSmithersBackend, read, tools, write };
+export { type AgentCapabilityRegistry, type AgentLike, type AgentToolDescriptor, type AggregateOptions, type AggregateScore, type AnthropicAgentOptions, type ApprovalAutoApprove, type ApprovalDecision, type ApprovalMode, type ApprovalOption, type ApprovalProps, type ApprovalRanking, type ApprovalRequest, type ApprovalSelection, type ColumnDef, type ConnectRequest, type ContinueAsNewProps, type CreateHttpToolOptions, type CreateScorerConfig, type CreateSmithersApi, type CreateSmithersOptions, type DepsSpec, type EventFrame, type ExternalSmithersConfig, type GatewayAuthConfig, type GatewayDefaults, type GatewayOperatorUiConfig, type GatewayOptions, type GatewayRegisterOptions, type GatewayTokenGrant, type GatewayUiConfig, type GatewayWebhookConfig, type GatewayWebhookRunConfig, type GatewayWebhookSignalConfig, type GraphSnapshot, type HelloResponse, type HermesAgentOptions, type HermesCliAgentOptions, type HostContainer, type HostNodeJson, type HttpToolAuth, type HttpToolInput, type HttpToolOutput, type InferDeps, type InferOutputEntry, type InferRow, type JjRevertResult, type KanbanProps, type KnownSmithersErrorCode, type LlmJudgeConfig, type MemoryFact, type MemoryLayerConfig, type MemoryMessage, type MemoryNamespace, type MemoryNamespaceKind, type MemoryProcessor, type MemoryProcessorConfig, type MemoryServiceApi, type MemoryStore, type MemoryThread, type MessageHistoryConfig, type MigrateSmithersStoreOptions, type OpenAIAgentOptions, type OpenApiAuth, type OpenApiSpec, type OpenApiToolsOptions, type OpenCodeAgentOptions, type OpenSmithersBackendOptions, type OutputAccessor, type OutputKey, type OutputTarget, type PiAgentOptions, type PiExtensionUiRequest, type PiExtensionUiResponse, type PollerProps, type RequestFrame, type ResolvedSmithersObservabilityOptions, type ResponseFrame, type RevertOptions, type RevertResult, type RunJjOptions, type RunJjResult, type RunOptions, type RunResult, type RunStatus, type SagaProps, type SagaStepDef, type SagaStepProps, type SamplingConfig, type SandboxProps, type SandboxRuntime, type SandboxVolumeMount, type SandboxWorkspaceSpec, type SchemaRegistryEntry, type ScoreResult, type ScoreRow, type Scorer, type ScorerBinding, type ScorerContext, type ScorerFn, type ScorerInput, type ScorersMap, type SemanticRecallConfig, type SerializedCtx, type ServeOptions, type ServerOptions, type SignalProps, type SmithersAlertLabels, type SmithersAlertPolicy, type SmithersAlertPolicyDefaults, type SmithersAlertPolicyRule, type SmithersAlertReaction, type SmithersAlertReactionKind, type SmithersAlertReactionRef, type SmithersAlertSeverity, type SmithersCtx, type SmithersError, type SmithersErrorCode, type SmithersEvent, type SmithersLogFormat, type SmithersMigrationResult, type SmithersObservabilityOptions, type SmithersObservabilityService, type SmithersWorkflow, type SmithersWorkflowOptions, type TaskDescriptor, type TaskMemoryConfig, type TaskProps, type TimeTravelOptions, type TimeTravelResult, type TimerProps, type TryCatchFinallyProps, type VibeAgentOptions, type WaitForEventProps, type WorkingMemoryConfig, type WorkspaceAddOptions, type WorkspaceInfo, type WorkspaceResult, type XmlElement, type XmlNode, type XmlText, bash, createExternalSmithers, createSmithers, createSmithersPostgres, defineTool, edit, getDefinedToolMetadata, grep, mdxPlugin, migrateSmithersStore, openSmithersBackend, read, tools, write };

package/src/index.js

@@ -83,6 +83,7 @@
  * @template [TOOLS=import("ai").ToolSet]
  * @typedef {import("@smithers-orchestrator/agents").HermesAgentOptions<CALL_OPTIONS, TOOLS>} HermesAgentOptions
  */
+/** @typedef {import("@smithers-orchestrator/agents").HermesCliAgentOptions} HermesCliAgentOptions */
 /** @typedef {import("@smithers-orchestrator/openapi").OpenApiAuth} OpenApiAuth */
 /** @typedef {import("@smithers-orchestrator/openapi").OpenApiSpec} OpenApiSpec */
 /** @typedef {import("@smithers-orchestrator/openapi").OpenApiToolsOptions} OpenApiToolsOptions */
@@ -182,7 +183,7 @@ export { knownSmithersErrorCodes } from "@smithers-orchestrator/errors/knownSmit
 // Components
 export { Approval, ApprovalGate, Aspects, Branch, CheckSuite, ClassifyAndRoute, ContentPipeline, ContinueAsNew, Debate, DecisionTable, DriftDetector, EscalationChain, GatherAndSynthesize, HumanTask, Kanban, Loop, MergeQueue, Optimizer, Panel, Parallel, Poller, Ralph, ReviewLoop, Runbook, Saga, SagaStep, Sandbox, ScanFixVerify, Sequence, Sidecar, Signal, Subflow, SuperSmithers, Supervisor, Task, Timer, TryCatchFinally, WaitForEvent, Workflow, Worktree, approvalDecisionSchema, approvalRankingSchema, approvalSelectionSchema, computeSidecarDelta, continueAsNew, } from "@smithers-orchestrator/components";
 // Agents
-export { AnthropicAgent, OpenAIAgent, HermesAgent, AmpAgent, AntigravityAgent, ClaudeCodeAgent, CodexAgent, GeminiAgent, PiAgent, KimiAgent, ForgeAgent, VibeAgent, OpenCodeAgent, createHttpTool, } from "@smithers-orchestrator/agents";
+export { AnthropicAgent, OpenAIAgent, HermesAgent, HermesCliAgent, AmpAgent, AntigravityAgent, ClaudeCodeAgent, CodexAgent, GeminiAgent, PiAgent, KimiAgent, ForgeAgent, VibeAgent, OpenCodeAgent, createHttpTool, } from "@smithers-orchestrator/agents";
 // VCS
 export { runJj, getJjPointer, revertToJjPointer, isJjRepo, workspaceAdd, workspaceList, workspaceClose, } from "@smithers-orchestrator/vcs/jj";
 // Core API

package/src/resolveSmithersBackendChoice.js

@@ -153,6 +153,10 @@ function readMigratedMarker(workspaceRoot) {
         return {
             exists: true,
             backend: normalizeBackend(parsed?.target?.backend ?? parsed?.target ?? parsed?.backend, markerPath),
+            // The migration SOURCE backend, recorded by `migrate` for every
+            // direction. A reverse (target sqlite) receipt uses it to tolerate the
+            // kept source store (pglite/postgres) without hiding an unrelated one.
+            sourceBackend: normalizeBackend(parsed?.source?.backend ?? (typeof parsed?.source === "string" ? parsed.source : undefined), markerPath),
         };
     }
     catch {
@@ -376,14 +380,32 @@ export async function resolveSmithersBackendChoice(opts = {}) {
     // otherwise an explicit pglite/postgres open beside a populated SQLite store
     // would hide the SQLite history.
     const marker = migratedMarker.exists && (migratedMarker.backend === "pglite" || migratedMarker.backend === "postgres");
+    // A REVERSE migration receipt (target sqlite) is authoritative the same way a
+    // forward one is — but the only leftover store it authorizes keeping is the
+    // recorded migration SOURCE (pglite/postgres). It must NOT silently hide an
+    // unrelated populated store, so it requires a recorded source backend (a bare
+    // or sourceless receipt does not suppress) and resolves only when we actually
+    // land on sqlite. Symmetric to the forward path's sqlite-source tolerance.
+    const reverseMarker = migratedMarker.exists
+        && migratedMarker.backend === "sqlite"
+        && backend === "sqlite"
+        && (migratedMarker.sourceBackend === "pglite" || migratedMarker.sourceBackend === "postgres");
     const populated = [
         ...(sqliteStore.runCount > 0 ? [{ backend: /** @type {"sqlite"} */ ("sqlite"), location: sqliteStore.dbPath, runCount: sqliteStore.runCount, schemaVersion: sqliteStore.schemaVersion }] : []),
         ...(pgliteStore.runCount > 0 ? [{ backend: /** @type {"pglite"} */ ("pglite"), location: pgliteStore.dataDir, runCount: pgliteStore.runCount, schemaVersion: pgliteStore.schemaVersion }] : []),
         ...(postgresStore.runCount > 0 ? [{ backend: /** @type {"postgres"} */ ("postgres"), location: postgresStore.connectionString === "set" ? "postgres connection" : "postgres", runCount: postgresStore.runCount, schemaVersion: postgresStore.schemaVersion }] : []),
     ];
-    if (!marker && populated.length > 1) {
+    if (!marker && !reverseMarker && populated.length > 1) {
         throw backendConflictError({ populated });
     }
+    if (reverseMarker) {
+        // Tolerate sqlite (the migration target) and the recorded source only;
+        // any other populated store would be hidden, so refuse to choose.
+        const unexpectedPopulated = populated.filter((store) => store.backend !== "sqlite" && store.backend !== migratedMarker.sourceBackend);
+        if (unexpectedPopulated.length > 0) {
+            throw backendConflictError({ populated });
+        }
+    }
     const migratedTargetBackend = marker && (migratedMarker.backend ?? markerBackend) !== "sqlite"
         ? /** @type {"pglite" | "postgres" | undefined} */ (migratedMarker.backend ?? markerBackend)
         : undefined;
@@ -452,6 +474,6 @@ export async function resolveSmithersBackendChoice(opts = {}) {
         sqlite: sqliteStore,
         pglite: pgliteStore,
         postgres: postgresStore,
-        migratedMarker: marker,
+        migratedMarker: marker || reverseMarker,
     };
 }