smithers-orchestrator 0.25.4 → 0.26.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smithers-orchestrator",
-  "version": "0.25.4",
+  "version": "0.26.1",
   "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.4",
-    "@smithers-orchestrator/cli": "0.25.4",
-    "@smithers-orchestrator/components": "0.25.4",
-    "@smithers-orchestrator/control-plane": "0.25.4",
-    "@smithers-orchestrator/db": "0.25.4",
-    "@smithers-orchestrator/driver": "0.25.4",
-    "@smithers-orchestrator/errors": "0.25.4",
-    "@smithers-orchestrator/engine": "0.25.4",
-    "@smithers-orchestrator/gateway-client": "0.25.4",
-    "@smithers-orchestrator/gateway-react": "0.25.4",
-    "@smithers-orchestrator/graph": "0.25.4",
-    "@smithers-orchestrator/memory": "0.25.4",
-    "@smithers-orchestrator/observability": "0.25.4",
-    "@smithers-orchestrator/sandbox": "0.25.4",
-    "@smithers-orchestrator/openapi": "0.25.4",
-    "@smithers-orchestrator/react-reconciler": "0.25.4",
-    "@smithers-orchestrator/server": "0.25.4",
-    "@smithers-orchestrator/scorers": "0.25.4",
-    "@smithers-orchestrator/scheduler": "0.25.4",
-    "@smithers-orchestrator/time-travel": "0.25.4",
-    "@smithers-orchestrator/tool-context": "0.25.4",
-    "@smithers-orchestrator/vcs": "0.25.4"
+    "@smithers-orchestrator/agents": "0.26.1",
+    "@smithers-orchestrator/components": "0.26.1",
+    "@smithers-orchestrator/cli": "0.26.1",
+    "@smithers-orchestrator/control-plane": "0.26.1",
+    "@smithers-orchestrator/db": "0.26.1",
+    "@smithers-orchestrator/driver": "0.26.1",
+    "@smithers-orchestrator/engine": "0.26.1",
+    "@smithers-orchestrator/errors": "0.26.1",
+    "@smithers-orchestrator/gateway-client": "0.26.1",
+    "@smithers-orchestrator/gateway-react": "0.26.1",
+    "@smithers-orchestrator/graph": "0.26.1",
+    "@smithers-orchestrator/memory": "0.26.1",
+    "@smithers-orchestrator/observability": "0.26.1",
+    "@smithers-orchestrator/react-reconciler": "0.26.1",
+    "@smithers-orchestrator/openapi": "0.26.1",
+    "@smithers-orchestrator/sandbox": "0.26.1",
+    "@smithers-orchestrator/scheduler": "0.26.1",
+    "@smithers-orchestrator/scorers": "0.26.1",
+    "@smithers-orchestrator/server": "0.26.1",
+    "@smithers-orchestrator/time-travel": "0.26.1",
+    "@smithers-orchestrator/tool-context": "0.26.1",
+    "@smithers-orchestrator/vcs": "0.26.1"
   },
   "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/migrateSmithersStore.js

@@ -1,7 +1,7 @@
 import { Database } from "bun:sqlite";
 import { Effect } from "effect";
 import { drizzle } from "drizzle-orm/bun-sqlite";
-import { existsSync, mkdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { ensureSmithersTables } from "@smithers-orchestrator/db/ensure";
 import { POSTGRES, quoteIdentifier, translateDdl } from "@smithers-orchestrator/db/dialect";
@@ -875,8 +875,44 @@ async function pgliteRunCountAt(cwd, workspaceRoot, opts) {
     }
 }
 
+/**
+ * Read the migration receipt (migrated.json) at the workspace root and return
+ * the CURRENT backend it records. After a prior migration this receipt is the
+ * AUTHORITY on which backend now holds the run store: earlier-backend stores
+ * (e.g. a leftover smithers.db after sqlite->pglite) can still sit on disk, so
+ * a run-count heuristic alone would misread the source. Returns undefined when
+ * there is no usable receipt so callers can fall back to the heuristic.
+ * @param {string} workspaceRoot
+ * @returns {MigrateSmithersBackend | undefined}
+ */
+function readReceiptCurrentBackend(workspaceRoot) {
+    const receiptPath = join(workspaceRoot, ".smithers", MIGRATION_MARKER_NAME);
+    if (!existsSync(receiptPath)) return undefined;
+    try {
+        const receipt = JSON.parse(readFileSync(receiptPath, "utf8"));
+        // migrated.json records the destination of the last migration under
+        // `target.backend`; a top-level `backend` (backend.json shape) is also
+        // honored defensively. Either is the current authoritative backend.
+        const current = receipt?.target?.backend ?? receipt?.backend;
+        if (current === undefined || current === null || current === "") {
+            return undefined;
+        }
+        return normalizeBackend(current);
+    }
+    catch {
+        return undefined;
+    }
+}
+
 async function inferSourceBackend(opts, cwd, workspaceRoot, dbPath, target) {
     if (opts.from) return normalizeBackend(opts.from);
+    // The migration receipt is authoritative after a prior migration: trust the
+    // backend it records over any leftover stores on disk. When the receipt's
+    // current backend equals the requested target, the caller's clear
+    // "source and target are both X" guard fires; only fall back to the
+    // run-count heuristic (and SMITHERS_BACKEND_CONFLICT) when no receipt exists.
+    const receiptBackend = readReceiptCurrentBackend(workspaceRoot);
+    if (receiptBackend) return receiptBackend;
     const counts = [
         { backend: "sqlite", runCount: sqliteRunCountAt(inferSqliteSourceDbPath(dbPath, workspaceRoot, Boolean(opts.dbPath))) },
         { backend: "pglite", runCount: await pgliteRunCountAt(cwd, workspaceRoot, opts) },