@automatalabs/workflows 0.47.1 → 0.47.2

package/dist/mcp-server.js

@@ -33712,7 +33712,7 @@ function registerReplTool(mcp, options) {
   mcp.registerTool(
     "repl",
     {
-      description: "One persistent QuickJS-in-WASM VM per projectDir, addressed by the same project model as the workflow tool. State (bindings, pending subagent calls, checkpoints) lives in the VM between calls and survives MCP-session churn and daemon restarts: every eval and every settlement drain that changed state persists the workspace to the daemon's per-project repl store, and the first touch of a stored workspace restores it and reconciles every outstanding call (settle from the store / re-attach via ACP session/load / re-issue). A stored snapshot that refuses (corrupt, a format upgrade, or a wasm-binary mismatch) is surfaced loudly and never silently discarded \u2014 reset drops it and starts fresh. Subagents are ACP sessions via acp-agents (6 concurrent per workspace); console output is captured and previewed. On last-client disconnect the workspace drains in-flight subagent turns to completion (each settlement boundary snapshots) and closes idle children; followUp re-attaches the subagent session lazily on the next connect. Every result carries the machine- readable shape (see the output schema) as structuredContent alongside the bounded text.",
+      description: "A persistent QuickJS-in-WASM JavaScript VM you drive interactively to orchestrate subagents \u2014 one VM per projectDir, addressed by the same project model as the workflow tool. Where workflow runs a deterministic script to completion, repl is the LIVE plane: you write JavaScript with action:\"eval\", and every binding, pending subagent call, raised checkpoint, and logged value PERSISTS in the VM between tool calls \u2014 a later eval sees the same variables and awaits the same promises; nothing lives in the transcript. Inside code (JavaScript; top-level await is allowed, top-level return is a syntax error; console output is captured) the host bridge provides: agent(modelSpec, task, opts?) \u2192 Promise \u2014 spawn an ACP subagent on a registry built-in (currently Claude, Codex, OpenCode, and pi) or a registered custom agent (opts: a structured-output JSON schema validated per call, cwd, backend config); checkpoint(question) \u2014 park a promise for a human answer, resolved by checkpoint.answer(id, value) in a later eval; and console, whose logged values are captured as addressable $1, $2, \u2026 references so you can slice deeper in a later eval (console.log($14.sections.map(s => s.title))) instead of re-running work. Agent handles carry followUp / steer / cancel, which resolve with what actually happened (live injection where the backend supports steering, queued-for-next-turn delivery where it does not). Everything else workflow authors know \u2014 parallel, pipeline, verify, judgePanel, gate, retry, loopUntilDry \u2014 is plain JavaScript layered on agent(), injected as the guest library. Start-and-don't-await is idiomatic: `const research = agent(...)` returns immediately with the eval and keeps running server-side; await it (or read $N) in a later call. No fs, no net, no timers, and no budget surface. Subagents (6 concurrent per workspace) take stable ids c1, c2, \u2026 used by interrupt and status. Actions: eval runs code, drains jobs, settles what it can, and returns immediately \u2014 a suspended eval (awaiting a subagent, a checkpoint, or any unsettled promise) lists its pending call ids and resumes its continuation at settlement with no fabricated result; a throw/reject/syntax-error/interrupt renders in output. wait blocks server-side (bounded; default 30 000 ms, max 120 000 ms) until the target calls settle, then returns the same shape. status is ls for the workspace: the binding manifest (name, type, size, provenance), live agents, pending ops, and the $N range \u2014 a named status is a first touch, a project-less status lists every open workspace without creating one. interrupt cancels one subagent call (with id) or breaks the running eval (no id). reset tears the workspace down. State survives MCP-session churn and daemon restarts: every eval and every settlement drain that changed state persists the workspace to the daemon's per-project repl store, and the first touch of a stored workspace restores it and reconciles every outstanding call (settle from the store / re-attach via ACP session/load / re-issue). A stored snapshot that refuses (corrupt, a format upgrade, or a wasm-binary mismatch) is surfaced loudly and never silently discarded \u2014 reset drops it and starts fresh. On last-client disconnect the workspace drains in-flight subagent turns to completion (each settlement boundary snapshots) and closes idle children; followUp re-attaches the subagent session lazily on the next connect. Every result carries the machine-readable shape (see the output schema) as structuredContent alongside the bounded text, with guest output kept in fields separate from the orchestration metadata.",
       inputSchema: replToolInputShape,
       outputSchema: replToolOutputShape
     },
@@ -34513,6 +34513,12 @@ var WorkflowScriptResources = class {
 var SERVER_NAME = "agentprism-workflow";
 var require2 = createRequire(import.meta.url);
 var SERVER_VERSION = require2("../package.json").version;
+var SERVER_INSTRUCTIONS = [
+  "This server exposes two model-facing tools for orchestrating multi-agent work. Both spawn subagents over the same ACP backends \u2014 the registry built-ins Claude, Codex, OpenCode, and pi, plus any registered custom agents \u2014 and key their durable state by an absolute projectDir (required on the shared daemon; defaults to the server's own project in single-project mode). Backend credentials come from each agent's own login (claude, codex, opencode, pi), so there is nothing auth-shaped to configure here.",
+  '\u2022 workflow \u2014 DETERMINISTIC BATCH orchestration. Supply a JavaScript workflow script (inline or by absolute scriptPath) that fans out agent() subagents and optional checkpoint() gates; it runs to completion in the foreground, or background:true returns a durable runId for bounded action:"await"/"inspect"/"stop" calls, with journaling, replay, and resumeFromRunId. Reach for it when the orchestration is known up front and you want it repeatable and resumable. The user-invocable author-workflow prompt helps write scripts.',
+  '\u2022 repl \u2014 INTERACTIVE STATEFUL orchestration. A persistent per-project JavaScript VM you drive incrementally with action:"eval"; bindings, pending subagents, checkpoints, and logged $N values persist in the VM between calls and survive daemon restarts. Reach for it when you want to inspect intermediate results and decide the next step adaptively, or keep a human in the loop via checkpoint().',
+  "Rule of thumb: use workflow when you can script the whole plan ahead of time; use repl when you want a live, stateful session that evolves call by call."
+].join("\n\n");
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["paused", "completed", "failed", "aborted"]);
 function createExecutionAdmissionLatch() {
   let decision;
@@ -35294,7 +35300,10 @@ function replEvalTimeoutMs() {
   return DEFAULT_REPL_EVAL_TIMEOUT_MS;
 }
 function createWorkflowServer(runner, options = {}) {
-  const mcp = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+  const mcp = new McpServer(
+    { name: SERVER_NAME, version: SERVER_VERSION },
+    { capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS }
+  );
   let acceptingWork = true;
   const ownsReplEvalBreakChannel = options.replEvalBreakChannel === void 0;
   const replEvalBreakChannel = options.replEvalBreakChannel ?? createEvalBreakChannel();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automatalabs/workflows",
-  "version": "0.47.1",
+  "version": "0.47.2",
   "license": "Apache-2.0",
   "engines": {
     "node": ">=22"
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "typebox": "1.3.2",
-    "@automatalabs/repl-engine": "0.1.8",
+    "@automatalabs/repl-engine": "0.2.0",
     "@automatalabs/shared-types": "0.29.1",
     "@automatalabs/workflow-engine": "0.35.2",
     "@automatalabs/acp-agents": "0.36.3"