smithers-orchestrator 0.23.0 → 0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smithers-orchestrator",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Public Smithers facade for durable coding-agent workflows and Gateway operation",
   "type": "module",
   "sideEffects": false,
@@ -35,15 +35,20 @@
       "import": "./src/control-plane.js",
       "default": "./src/control-plane.js"
     },
-    "./*": {
-      "types": "./src/index.d.ts",
-      "import": "./src/*.js",
-      "default": "./src/*.js"
+    "./jsx-runtime": {
+      "types": "./src/jsx-runtime.d.ts",
+      "import": "./src/jsx-runtime.js",
+      "default": "./src/jsx-runtime.js"
     },
     "./jsx-dev-runtime": {
-      "types": "./src/index.d.ts",
+      "types": "./src/jsx-runtime.d.ts",
       "import": "./src/jsx-runtime.js",
       "default": "./src/jsx-runtime.js"
+    },
+    "./*": {
+      "types": "./src/index.d.ts",
+      "import": "./src/*.js",
+      "default": "./src/*.js"
     }
   },
   "files": [
@@ -61,28 +66,28 @@
     "incur": "^0.4.1",
     "react": "^19.2.5",
     "zod": "^4.3.6",
-    "@smithers-orchestrator/components": "0.23.0",
-    "@smithers-orchestrator/cli": "0.23.0",
-    "@smithers-orchestrator/db": "0.23.0",
-    "@smithers-orchestrator/control-plane": "0.23.0",
-    "@smithers-orchestrator/driver": "0.23.0",
-    "@smithers-orchestrator/engine": "0.23.0",
-    "@smithers-orchestrator/errors": "0.23.0",
-    "@smithers-orchestrator/gateway-react": "0.23.0",
-    "@smithers-orchestrator/memory": "0.23.0",
-    "@smithers-orchestrator/graph": "0.23.0",
-    "@smithers-orchestrator/openapi": "0.23.0",
-    "@smithers-orchestrator/observability": "0.23.0",
-    "@smithers-orchestrator/react-reconciler": "0.23.0",
-    "@smithers-orchestrator/sandbox": "0.23.0",
-    "@smithers-orchestrator/scheduler": "0.23.0",
-    "@smithers-orchestrator/scorers": "0.23.0",
-    "@smithers-orchestrator/server": "0.23.0",
-    "@smithers-orchestrator/time-travel": "0.23.0",
-    "@smithers-orchestrator/tool-context": "0.23.0",
-    "@smithers-orchestrator/gateway-client": "0.23.0",
-    "@smithers-orchestrator/agents": "0.23.0",
-    "@smithers-orchestrator/vcs": "0.23.0"
+    "@smithers-orchestrator/agents": "0.24.0",
+    "@smithers-orchestrator/components": "0.24.0",
+    "@smithers-orchestrator/control-plane": "0.24.0",
+    "@smithers-orchestrator/driver": "0.24.0",
+    "@smithers-orchestrator/db": "0.24.0",
+    "@smithers-orchestrator/engine": "0.24.0",
+    "@smithers-orchestrator/errors": "0.24.0",
+    "@smithers-orchestrator/gateway-client": "0.24.0",
+    "@smithers-orchestrator/gateway-react": "0.24.0",
+    "@smithers-orchestrator/graph": "0.24.0",
+    "@smithers-orchestrator/memory": "0.24.0",
+    "@smithers-orchestrator/observability": "0.24.0",
+    "@smithers-orchestrator/openapi": "0.24.0",
+    "@smithers-orchestrator/react-reconciler": "0.24.0",
+    "@smithers-orchestrator/sandbox": "0.24.0",
+    "@smithers-orchestrator/scheduler": "0.24.0",
+    "@smithers-orchestrator/scorers": "0.24.0",
+    "@smithers-orchestrator/server": "0.24.0",
+    "@smithers-orchestrator/time-travel": "0.24.0",
+    "@smithers-orchestrator/vcs": "0.24.0",
+    "@smithers-orchestrator/tool-context": "0.24.0",
+    "@smithers-orchestrator/cli": "0.24.0"
   },
   "optionalDependencies": {
     "@electric-sql/pglite": "0.5.1",

package/src/create.js

@@ -16,8 +16,9 @@ import { zodToCreateTableSQL, syncZodTableSchema } from "@smithers-orchestrator/
 import { camelToSnake } from "@smithers-orchestrator/db/utils/camelToSnake";
 import { SmithersDb } from "@smithers-orchestrator/db/adapter";
 import { POSTGRES } from "@smithers-orchestrator/db/dialect";
-import { resolve } from "node:path";
+import { resolve, join } from "node:path";
 import { SmithersError } from "@smithers-orchestrator/errors/SmithersError";
+import { findSmithersAnchorDir } from "./findSmithersAnchorDir.js";
 /** @typedef {import("@smithers-orchestrator/components").ApprovalProps<any, any>} ApprovalProps */
 /** @typedef {import("@smithers-orchestrator/components").SandboxProps} SandboxProps */
 /** @typedef {import("@smithers-orchestrator/components").SignalProps<any>} SignalProps */
@@ -223,10 +224,11 @@ function prepareSmithersTables(schemas) {
  *   zodToKeyName: Map<unknown, string>;
  *   ambiguousZodSchemas: Set<unknown>;
  *   opts?: CreateSmithersOptions;
+ *   inputSchema?: unknown;
  * }} config
  */
 function buildSmithersApi(config) {
-    const { db, tables, schemaRegistry, outputs, zodToKeyName, ambiguousZodSchemas, opts } = config;
+    const { db, tables, schemaRegistry, outputs, zodToKeyName, ambiguousZodSchemas, opts, inputSchema } = config;
     const { SmithersContext: RuntimeSmithersContext, useCtx } = createSmithersContext();
     const ctxRef = { current: null };
     let moduleAlertPolicy = opts?.alertPolicy;
@@ -305,6 +307,7 @@ function buildSmithersApi(config) {
                 return React.createElement(RuntimeSmithersContext.Provider, { value: ctxRef.current }, React.createElement(GlobalSmithersContext.Provider, { value: ctxRef.current }, build(ctx)));
             },
             opts: workflowOpts,
+            inputSchema,
             schemaRegistry,
             zodToKeyName,
             ambiguousZodSchemas,
@@ -363,7 +366,12 @@ function buildSmithersApi(config) {
  * ```
  */
 export function createSmithers(schemas, opts) {
-    const dbPath = opts?.dbPath ?? "./smithers.db";
+    // Resolve the DB path from the nearest .smithers/ anchor so that running a
+    // workflow from a subdirectory always creates/uses the project-root DB, not
+    // a new one at CWD. An explicit opts.dbPath overrides this entirely.
+    const anchorDir = findSmithersAnchorDir(process.cwd());
+    const defaultDbPath = anchorDir ? join(anchorDir, "smithers.db") : "./smithers.db";
+    const dbPath = opts?.dbPath ?? defaultDbPath;
     const absDbPath = resolve(process.cwd(), dbPath);
     if (process.env.SMITHERS_HOT === "1") {
         const sig = computeSchemaSig(schemas, absDbPath);
@@ -444,6 +452,7 @@ export function createSmithers(schemas, opts) {
         zodToKeyName,
         ambiguousZodSchemas,
         opts,
+        inputSchema: schemas.input,
     });
     if (process.env.SMITHERS_HOT === "1") {
         const sig = computeSchemaSig(schemas, absDbPath);
@@ -532,6 +541,7 @@ export async function createSmithersPostgres(schemas, opts) {
             zodToKeyName,
             ambiguousZodSchemas,
             opts,
+            inputSchema: schemas.input,
         });
     }
     catch (e) {

package/src/findSmithersAnchorDir.js

@@ -0,0 +1,38 @@
+import { resolve, dirname, join } from "node:path";
+import { existsSync, statSync } from "node:fs";
+
+/**
+ * Walk upward from `from` and return the nearest directory that contains a
+ * `.smithers/` subdirectory, or `undefined` if none is found before the
+ * filesystem root.
+ *
+ * Directories at or above $HOME are excluded: a `~/.smithers` global pack
+ * must not be treated as a project anchor, so the DB would incorrectly land
+ * in the user's home directory.
+ *
+ * @param {string} from
+ * @returns {string | undefined}
+ */
+export function findSmithersAnchorDir(from) {
+    let dir = resolve(from);
+    const fsRoot = resolve("/");
+    const home = process.env.HOME ? resolve(process.env.HOME) : undefined;
+    while (true) {
+        // Stop at or above HOME — anchors must be proper project directories
+        // strictly below the user's home directory.
+        // Use startsWith rather than length comparison so that symlinks and
+        // unusual mount points (e.g. /home2) don't produce false positives.
+        if (home && (dir === home || !dir.startsWith(home + "/"))) {
+            return undefined;
+        }
+        // Guard: never scan the filesystem root itself.
+        if (dir === fsRoot) {
+            return undefined;
+        }
+        const candidate = join(dir, ".smithers");
+        if (existsSync(candidate) && statSync(candidate).isDirectory()) {
+            return dir;
+        }
+        dir = dirname(dir);
+    }
+}

package/src/index.d.ts

@@ -2,6 +2,7 @@ import * as ai from 'ai';
 import { Tool } from 'ai';
 import * as _smithers_graph_XmlNode from '@smithers-orchestrator/graph/XmlNode';
 import * as _smithers_time_travel_timetravel from '@smithers-orchestrator/time-travel/timetravel';
+export { timeTravel } from '@smithers-orchestrator/time-travel/timetravel';
 import * as _smithers_graph_TaskDescriptor from '@smithers-orchestrator/graph/TaskDescriptor';
 import * as _smithers_components_SmithersWorkflow from '@smithers-orchestrator/components/SmithersWorkflow';
 import { SmithersWorkflow as SmithersWorkflow$1 } from '@smithers-orchestrator/components/SmithersWorkflow';
@@ -24,6 +25,7 @@ import * as _smithers_driver_RunStatus from '@smithers-orchestrator/driver/RunSt
 import * as _smithers_driver_RunResult from '@smithers-orchestrator/driver/RunResult';
 import * as _smithers_driver_RunOptions from '@smithers-orchestrator/driver/RunOptions';
 import * as _smithers_time_travel_revert from '@smithers-orchestrator/time-travel/revert';
+export { revertToAttempt } from '@smithers-orchestrator/time-travel/revert';
 import * as _smithers_observability from '@smithers-orchestrator/observability';
 export { SmithersObservability, activeNodes, activeRuns, approvalsDenied, approvalsGranted, approvalsRequested, attemptDuration, cacheHits, cacheMisses, createSmithersObservabilityLayer, createSmithersOtelLayer, createSmithersRuntimeLayer, dbQueryDuration, dbRetries, dbTransactionDuration, dbTransactionRetries, dbTransactionRollbacks, externalWaitAsyncPending, hotReloadDuration, hotReloadFailures, hotReloads, httpRequestDuration, httpRequests, nodeDuration, nodesFailed, nodesFinished, nodesStarted, prometheusContentType, renderPrometheusMetrics, resolveSmithersObservabilityOptions, runsTotal, sandboxActive, sandboxBundleSizeBytes, sandboxCompletedTotal, sandboxCreatedTotal, sandboxDurationMs, sandboxPatchCount, sandboxTransportDurationMs, schedulerQueueDepth, smithersMetrics, timerDelayDuration, timersCancelled, timersCreated, timersFired, timersPending, toolCallsTotal, toolDuration, trackSmithersEvent, vcsDuration } from '@smithers-orchestrator/observability';
 import * as _smithers_driver_OutputKey from '@smithers-orchestrator/driver/OutputKey';
@@ -56,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 } from '@smithers-orchestrator/agents';
+export { AmpAgent, AnthropicAgent, AntigravityAgent, ClaudeCodeAgent, CodexAgent, ForgeAgent, GeminiAgent, HermesAgent, KimiAgent, OpenAIAgent, OpenCodeAgent, PiAgent, VibeAgent } 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';
@@ -70,6 +72,9 @@ export { isSmithersError } from '@smithers-orchestrator/errors/isSmithersError';
 export { knownSmithersErrorCodes } from '@smithers-orchestrator/errors/knownSmithersErrorCodes';
 export { signalRun } from '@smithers-orchestrator/engine/signals';
 export { usePatched } from '@smithers-orchestrator/engine/effect/versioning';
+import { SmithersDb } from '@smithers-orchestrator/db/adapter';
+export { SmithersDb } from '@smithers-orchestrator/db/adapter';
+export { loadOutputs, loadOutputsEffect } from '@smithers-orchestrator/db';
 export { ensureSmithersTables } from '@smithers-orchestrator/db/ensure';
 export { markdownComponents } from '@smithers-orchestrator/components/markdownComponents';
 export { renderMdx } from '@smithers-orchestrator/components/renderMdx';
@@ -78,8 +83,8 @@ export { syncZodTableSchema, zodSchemaColumns, zodToCreateTableSQL } from '@smit
 export { camelToSnake } from '@smithers-orchestrator/db/utils/camelToSnake';
 export { unwrapZodType } from '@smithers-orchestrator/db/unwrapZodType';
 export { zodSchemaToJsonExample } from '@smithers-orchestrator/components/zod-to-example';
-export { BuilderApi, BuiltSmithersWorkflow, Smithers, StepOptions, fragment, renderFrame, runWorkflow, workflow } from '@smithers-orchestrator/engine';
-import { SmithersDb } from '@smithers-orchestrator/db/adapter';
+export { BuilderApi, BuiltSmithersWorkflow, Smithers, StepOptions, approveNode, denyNode, fragment, getRun, listRuns, renderFrame, runWorkflow, workflow } from '@smithers-orchestrator/engine';
+export { resolveWorktreePath } from '@smithers-orchestrator/graph';
 
 type SerializedCtx$1 = {
     runId: string;
@@ -173,7 +178,20 @@ type CreateSmithersOptions$1 = {
  * ```
  */
 declare function createSmithers<Schemas extends Record<string, zod.ZodObject<any>>>(schemas: Schemas, opts?: CreateSmithersOptions): CreateSmithersApi$1<Schemas>;
-type CreateSmithersOptions = CreateSmithersOptions$1;
+type CreateSmithersPostgresOptions = CreateSmithersOptions & ({
+    provider?: "postgres";
+    connectionString?: string;
+    connection?: object;
+} | {
+    provider: "pglite";
+    dataDir?: string;
+});
+/**
+ * PostgreSQL/PGlite-backed equivalent of createSmithers.
+ */
+declare function createSmithersPostgres<Schemas extends Record<string, zod.ZodObject<any>>>(schemas: Schemas, opts?: CreateSmithersPostgresOptions): Promise<CreateSmithersApi$1<Schemas> & {
+    close: () => Promise<void>;
+}>;
 
 /**
  * Create a SmithersWorkflow from an external build function.
@@ -301,13 +319,20 @@ type ConnectRequest = _smithers_server_gateway.ConnectRequest;
 type ContinueAsNewProps = _smithers_components.ContinueAsNewProps;
 type CreateScorerConfig = _smithers_scorers.CreateScorerConfig;
 type CreateSmithersApi<Schema> = CreateSmithersApi$1<Schema>;
+type CreateSmithersOptions = CreateSmithersOptions$1;
 type DepsSpec = _smithers_components.DepsSpec;
 type EventFrame = _smithers_server_gateway.EventFrame;
 type ExternalSmithersConfig<S> = ExternalSmithersConfig$2<S>;
 type GatewayAuthConfig = _smithers_server_gateway.GatewayAuthConfig;
 type GatewayDefaults = _smithers_server_gateway.GatewayDefaults;
+type GatewayOperatorUiConfig = _smithers_server_gateway.GatewayOperatorUiConfig;
 type GatewayOptions = _smithers_server_gateway.GatewayOptions;
+type GatewayRegisterOptions = _smithers_server_gateway.GatewayRegisterOptions;
 type GatewayTokenGrant = _smithers_server_gateway.GatewayTokenGrant;
+type GatewayUiConfig = _smithers_server_gateway.GatewayUiConfig;
+type GatewayWebhookConfig = _smithers_server_gateway.GatewayWebhookConfig;
+type GatewayWebhookRunConfig = _smithers_server_gateway.GatewayWebhookRunConfig;
+type GatewayWebhookSignalConfig = _smithers_server_gateway.GatewayWebhookSignalConfig;
 type GraphSnapshot = _smithers_graph_GraphSnapshot.GraphSnapshot;
 type HelloResponse = _smithers_server_gateway.HelloResponse;
 type HostContainer = _smithers_react_reconciler_dom_renderer.HostContainer;
@@ -333,6 +358,7 @@ type MessageHistoryConfig = _smithers_memory.MessageHistoryConfig;
 type OpenAIAgentOptions<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = _smithers_agents.OpenAIAgentOptions<CALL_OPTIONS, TOOLS>;
 type HermesAgentOptions<CALL_OPTIONS = never, TOOLS = ai.ToolSet> = _smithers_agents.HermesAgentOptions<CALL_OPTIONS, TOOLS>;
 type OpenCodeAgentOptions = _smithers_agents.OpenCodeAgentOptions;
+type VibeAgentOptions = _smithers_agents.VibeAgentOptions;
 type OpenApiAuth = _smithers_openapi.OpenApiAuth;
 type OpenApiSpec = _smithers_openapi.OpenApiSpec;
 type OpenApiToolsOptions = _smithers_openapi.OpenApiToolsOptions;
@@ -408,4 +434,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 CreateScorerConfig, type CreateSmithersApi, type DepsSpec, type EventFrame, type ExternalSmithersConfig, type GatewayAuthConfig, type GatewayDefaults, type GatewayOptions, type GatewayTokenGrant, type GraphSnapshot, type HelloResponse, type HermesAgentOptions, type HostContainer, type HostNodeJson, 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 OpenAIAgentOptions, type OpenApiAuth, type OpenApiSpec, type OpenApiToolsOptions, type OpenCodeAgentOptions, 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 SmithersObservabilityOptions, type SmithersObservabilityService, type SmithersWorkflow, type SmithersWorkflowOptions, type TaskDescriptor, type TaskMemoryConfig, type TaskProps, type TimeTravelOptions, type TimeTravelResult, type TimerProps, type TryCatchFinallyProps, type WaitForEventProps, type WorkingMemoryConfig, type WorkspaceAddOptions, type WorkspaceInfo, type WorkspaceResult, type XmlElement, type XmlNode, type XmlText, bash, createExternalSmithers, createSmithers, defineTool, edit, getDefinedToolMetadata, grep, mdxPlugin, 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 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 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 OpenAIAgentOptions, type OpenApiAuth, type OpenApiSpec, type OpenApiToolsOptions, type OpenCodeAgentOptions, 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 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, read, tools, write };

package/src/index.js

@@ -25,6 +25,7 @@
  * @template Schema
  * @typedef {import("./CreateSmithersApi.ts").CreateSmithersApi<Schema>} CreateSmithersApi
  */
+/** @typedef {import("./CreateSmithersOptions.ts").CreateSmithersOptions} CreateSmithersOptions */
 /** @typedef {import("@smithers-orchestrator/components").DepsSpec} DepsSpec */
 /** @typedef {import("@smithers-orchestrator/server/gateway").EventFrame} EventFrame */
 /**
@@ -33,8 +34,14 @@
  */
 /** @typedef {import("@smithers-orchestrator/server/gateway").GatewayAuthConfig} GatewayAuthConfig */
 /** @typedef {import("@smithers-orchestrator/server/gateway").GatewayDefaults} GatewayDefaults */
+/** @typedef {import("@smithers-orchestrator/server/gateway").GatewayOperatorUiConfig} GatewayOperatorUiConfig */
 /** @typedef {import("@smithers-orchestrator/server/gateway").GatewayOptions} GatewayOptions */
+/** @typedef {import("@smithers-orchestrator/server/gateway").GatewayRegisterOptions} GatewayRegisterOptions */
 /** @typedef {import("@smithers-orchestrator/server/gateway").GatewayTokenGrant} GatewayTokenGrant */
+/** @typedef {import("@smithers-orchestrator/server/gateway").GatewayUiConfig} GatewayUiConfig */
+/** @typedef {import("@smithers-orchestrator/server/gateway").GatewayWebhookConfig} GatewayWebhookConfig */
+/** @typedef {import("@smithers-orchestrator/server/gateway").GatewayWebhookRunConfig} GatewayWebhookRunConfig */
+/** @typedef {import("@smithers-orchestrator/server/gateway").GatewayWebhookSignalConfig} GatewayWebhookSignalConfig */
 /** @typedef {import("@smithers-orchestrator/graph/GraphSnapshot").GraphSnapshot} GraphSnapshot */
 /** @typedef {import("@smithers-orchestrator/server/gateway").HelloResponse} HelloResponse */
 /** @typedef {import("@smithers-orchestrator/react-reconciler/dom/renderer").HostContainer} HostContainer */
@@ -86,6 +93,7 @@
 /** @typedef {import("@smithers-orchestrator/agents").PiExtensionUiRequest} PiExtensionUiRequest */
 /** @typedef {import("@smithers-orchestrator/agents").PiExtensionUiResponse} PiExtensionUiResponse */
 /** @typedef {import("@smithers-orchestrator/agents").OpenCodeAgentOptions} OpenCodeAgentOptions */
+/** @typedef {import("@smithers-orchestrator/agents").VibeAgentOptions} VibeAgentOptions */
 /** @typedef {import("@smithers-orchestrator/components").PollerProps} PollerProps */
 /** @typedef {import("@smithers-orchestrator/server/gateway").RequestFrame} RequestFrame */
 /** @typedef {import("@smithers-orchestrator/observability").ResolvedSmithersObservabilityOptions} ResolvedSmithersObservabilityOptions */
@@ -171,18 +179,23 @@ 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, Sandbox, ScanFixVerify, Sequence, Signal, Subflow, SuperSmithers, Supervisor, Task, Timer, TryCatchFinally, WaitForEvent, Workflow, Worktree, approvalDecisionSchema, approvalRankingSchema, approvalSelectionSchema, continueAsNew, } from "@smithers-orchestrator/components";
 // Agents
-export { AnthropicAgent, OpenAIAgent, HermesAgent, AmpAgent, AntigravityAgent, ClaudeCodeAgent, CodexAgent, GeminiAgent, PiAgent, KimiAgent, ForgeAgent, OpenCodeAgent, } from "@smithers-orchestrator/agents";
+export { AnthropicAgent, OpenAIAgent, HermesAgent, AmpAgent, AntigravityAgent, ClaudeCodeAgent, CodexAgent, GeminiAgent, PiAgent, KimiAgent, ForgeAgent, VibeAgent, OpenCodeAgent, } from "@smithers-orchestrator/agents";
 // VCS
 export { runJj, getJjPointer, revertToJjPointer, isJjRepo, workspaceAdd, workspaceList, workspaceClose, } from "@smithers-orchestrator/vcs/jj";
 // Core API
 export { createSmithers, createSmithersPostgres } from "./create.js";
 export {
+  approveNode,
+  denyNode,
   fragment,
+  getRun,
+  listRuns,
   renderFrame,
   runWorkflow,
   Smithers,
   workflow,
 } from "@smithers-orchestrator/engine";
+export { resolveWorktreePath } from "@smithers-orchestrator/graph";
 export { signalRun } from "@smithers-orchestrator/engine/signals";
 export { usePatched } from "@smithers-orchestrator/engine/effect/versioning";
 // Tools
@@ -204,7 +217,8 @@ export { createServeApp } from "@smithers-orchestrator/server/serve";
 // Observability
 export { SmithersObservability, createSmithersObservabilityLayer, createSmithersOtelLayer, createSmithersRuntimeLayer, smithersMetrics, trackSmithersEvent, activeNodes, activeRuns, externalWaitAsyncPending, approvalsDenied, approvalsGranted, approvalsRequested, timerDelayDuration, timersCancelled, timersCreated, timersFired, timersPending, attemptDuration, cacheHits, cacheMisses, dbQueryDuration, dbRetries, dbTransactionDuration, dbTransactionRetries, dbTransactionRollbacks, hotReloadDuration, hotReloadFailures, hotReloads, httpRequestDuration, httpRequests, nodeDuration, nodesFailed, nodesFinished, nodesStarted, prometheusContentType, renderPrometheusMetrics, resolveSmithersObservabilityOptions, runsTotal, sandboxActive, sandboxBundleSizeBytes, sandboxCompletedTotal, sandboxCreatedTotal, sandboxDurationMs, sandboxPatchCount, sandboxTransportDurationMs, schedulerQueueDepth, toolCallsTotal, toolDuration, vcsDuration, } from "@smithers-orchestrator/observability";
 // DB
-export { SmithersDb } from "@smithers-orchestrator/db/adapter";
+export { SmithersDb } from "@smithers-orchestrator/db";
+export { loadOutputs, loadOutputsEffect } from "@smithers-orchestrator/db";
 export { ensureSmithersTables } from "@smithers-orchestrator/db/ensure";
 // Renderer
 export { SmithersRenderer } from "@smithers-orchestrator/react-reconciler/dom/renderer";

package/src/jsx-runtime.d.ts

@@ -0,0 +1,25 @@
+import type { ReactElement } from "react";
+
+/** Element key accepted by the JSX runtime factories. */
+export type JsxRuntimeKey = string | number | undefined;
+
+/**
+ * Smithers JSX runtime factories — the target of
+ * `jsxImportSource: "smithers-orchestrator"` and what `<Workflow/>`, `<Task/>`,
+ * etc. compile to. They are deliberately typed wide (`type`/`props` as
+ * `unknown`): components validate their own props, and keeping these signatures
+ * loose avoids expanding Smithers' deep workflow types during type-checking,
+ * which is otherwise expensive. Callers that build trees programmatically can
+ * use these directly, e.g. `jsx(Task, { id, output, agent, children }, key)`.
+ */
+export function jsx(type: unknown, props: unknown, key?: JsxRuntimeKey): ReactElement;
+export function jsxs(type: unknown, props: unknown, key?: JsxRuntimeKey): ReactElement;
+export function jsxDEV(
+  type: unknown,
+  props: unknown,
+  key?: JsxRuntimeKey,
+  isStaticChildren?: boolean,
+  source?: unknown,
+  self?: unknown,
+): ReactElement;
+export const Fragment: unknown;

package/src/tools/bash.js

@@ -175,7 +175,7 @@ export async function bashTool(cmd, args = [], opts = undefined) {
 
 export const bash = defineTool({
   name: "bash",
-  description: "Execute a shell command",
+  description: "Run an executable with arguments",
   schema: z.object({
     cmd: z.string(),
     args: z.array(z.string()).optional(),