@aicalas/loopy 0.2.0 → 0.2.1

package/dist/cli-help.js

@@ -1,168 +1,222 @@
-/**
- * Operator-facing guidance printed by the CLI. It must stand alone: loopy runs on a machine whose
- * agent operator is not expected to open repo docs or reach the network, so everything an operator
- * needs is emitted here. Two standing rules shape the copy - loopy never explains how Temporal
- * itself works (it names the temporal-developer skill and stops), and it never teaches authoring a
- * new adapter (there is no plugin API yet; the built-ins are configured, not defined).
- */
-/** Named so an operator can find generic Temporal help; loopy-specific guidance never depends on it. */
-export const TEMPORAL_SKILL_POINTER = "Temporal itself (server, CLI, non-determinism, Event History) is out of loopy's scope.\n" +
-    "For that, use the temporal-developer skill: https://github.com/temporalio/skill-temporal-developer";
+/** Operator-facing guidance bundled with the CLI so it works without configuration, a Temporal connection, or network access. */
+export const TEMPORAL_SKILL_POINTER = "Use Temporal UI or CLI for execution inspection, Event History, cancellation, termination, and Schedule administration.\n" +
+    "For Temporal operations, use the temporal-developer skill: https://github.com/temporalio/skill-temporal-developer";
 const SETUP = {
     name: "setup",
-    summary: "config.toml and pointing loopy at a Temporal Service (local, self-hosted, or Cloud)",
+    summary: "install loopy, configure the local runtime, and preserve its state",
     body: [
         "loopy guide setup",
         "",
-        "Configure loopy with a TOML file, then point it at a Temporal Service.",
-        "",
-        "Config file",
-        "  Default path: ~/.config/loopy/config.toml ($XDG_CONFIG_HOME/loopy/config.toml).",
-        "  Override with -c/--config <path>.",
-        "",
-        "  Minimal example:",
-        "",
-        '    repository = "owner/name"          # required; the workspace repo agents clone',
-        '    default_branch = "main"',
-        "    poll_interval_seconds = 300",
-        '    workflows = "workflows"            # directory of workflow modules',
-        "",
-        "    [temporal]",
-        '    address = "localhost:7233"',
-        '    namespace = "default"',
-        '    control_task_queue = "loopy-control"   # required',
-        '    agent_task_queue = "loopy-agent"       # required',
-        "    tls = false",
-        "",
-        "  Other keys: project_directory, working_directory, drain_timeout_seconds,",
-        "  shutdown_grace_seconds, agent_worker.max_concurrent_activities, log_level.",
-        "",
-        "Temporal connection - three setups, differing only in [temporal]:",
-        "  Local dev    address=localhost:7233, tls=false. Start one with your Temporal",
-        "               dev server (temporal server start-dev).",
-        "  Self-hosted  point address/namespace at it; set tls as deployed.",
-        "  Cloud        address=<ns>.<acct>.tmprl.cloud:7233, tls=true, and an API key via",
-        "               api_key or the TEMPORAL_API_KEY environment variable (env wins and is",
-        "               reported at startup). loopy selects a Namespace but never creates one.",
-        "",
-        "First run",
-        "  loopy loop  starts the Worker Process. A worker.lock in the working directory",
-        "  prevents a second process for the same directory.",
+        "Loopy is a local runtime for one developer. It needs Node.js 24, git, and a",
+        "reachable Temporal Service. Install the CLI globally and add the package to the",
+        "project that owns your workflows:",
+        "",
+        "  npm install --global @aicalas/loopy",
+        "  npm install @aicalas/loopy",
+        "",
+        "Configuration",
+        "  The default file is ~/.config/loopy/config.toml",
+        "  ($XDG_CONFIG_HOME/loopy/config.toml). Pass -c/--config <path> to use another file.",
+        "",
+        "  log_level                      debug, info, warning, or error. Defaults to info.",
+        "  repository                      Workspace repository cloned for agents. Required.",
+        "  default_branch                  Defaults to main.",
+        "  workflows                       Workflow-module directory. Defaults to workflows.",
+        "  project_directory               Base for workflows and prompt files. Defaults to .",
+        "  working_directory               Clone, worktree, and bundle root. Defaults to .loopy.",
+        "  poll_interval_seconds           Watcher and control cadence. Defaults to 300.",
+        "  drain_timeout_seconds           Shutdown drain deadline. Defaults to 900.",
+        "  shutdown_grace_seconds          Activity shutdown grace. Defaults to 30.",
+        "  agent_worker.max_concurrent_activities",
+        "                                  Local agent concurrency. Defaults to 5.",
+        "  temporal.address                Defaults to localhost:7233.",
+        "  temporal.namespace              Defaults to default.",
+        "  temporal.control_task_queue     Required and unique to this runtime.",
+        "  temporal.agent_task_queue       Required and unique to this runtime.",
+        "  temporal.tls                    Defaults to false.",
+        "",
+        "  TEMPORAL_ADDRESS, TEMPORAL_NAMESPACE, TEMPORAL_CONTROL_TASK_QUEUE,",
+        "  TEMPORAL_AGENT_TASK_QUEUE, TEMPORAL_TLS, and TEMPORAL_API_KEY override their",
+        "  matching Temporal fields. Loopy does not create or store secrets; provide GitHub,",
+        "  Temporal, and agent-provider credentials through the environment available to loopy.",
+        "",
+        "Typical Docker Compose deployment",
+        "  Run the Temporal development server and loopy as separate services. Point",
+        "  TEMPORAL_ADDRESS at the Temporal service name. Mount the config, workflows, and",
+        "  prompt files into loopy, and preserve three independent volumes: Temporal's database,",
+        "  loopy's working_directory, and the container user's provider home. The package README",
+        "  contains a complete Compose, config.toml, and Dockerfile example.",
+        "",
+        "Credentials and git authentication",
+        "  GITHUB_TOKEN or GH_TOKEN authenticates GitHub watchers, effects, attention, and",
+        "  questions. Git clone, fetch, and agent pushes use git's own credential mechanism;",
+        "  configure an HTTPS credential helper or SSH credentials in the same environment.",
+        "  Authenticate each enabled agent provider with its supported environment variables or",
+        "  login flow. Never commit secret files or provider authentication state.",
+        "",
+        "Agent environment",
+        "  Agents run inside the loopy process environment. A container image must therefore be a",
+        "  complete development environment for the target repository: language runtimes, package",
+        "  managers, build and unit-test tools, system libraries, provider CLIs, MCP server",
+        "  executables, repository instructions, and network access. Initialize and authenticate",
+        "  MCP servers before unattended use. Verify the repository's real test commands from an",
+        "  interactive shell in that image. OpenCode additionally requires an opencode executable",
+        "  at version 1.18.3 or newer on PATH.",
+        "",
+        "State that must survive restart",
+        "  Temporal state       The Service's persistence contains Workflow Executions, Event",
+        "                       Histories, Schedules, and durable call state.",
+        "  Loopy config         Preserve the selected config file so the same repository,",
+        "                       Namespace, Task Queues, and directories are used after restart.",
+        "  Working directory    Preserve working_directory while any execution is open. It holds",
+        "                       the managed clone, worktrees, bundles, and worker lock.",
+        "  Provider state       Preserve each provider's own session data in the same configured",
+        "                       home/data location. A session ID in Temporal is not the transcript.",
+        "",
+        "Run",
+        "  loopy loop starts the local runtime. One process owns a working directory; worker.lock",
+        "  prevents a second process from racing the same worktrees.",
     ].join("\n"),
 };
 const WORKFLOWS = {
     name: "workflows",
-    summary: "create, register, and change workflows",
+    summary: "author workflows, inputs, agents, effects, and human questions",
     body: [
         "loopy guide workflows",
         "",
-        "A workflow is a TypeScript module; there is no separate spec language and no register",
-        "command. Registration is discovery: loopy loop finds the modules and schedules them.",
+        "A workflow is a TypeScript module. There is no specification language or registration",
+        "command: loopy loop discovers the modules in the configured workflows directory.",
         "",
-        "Create",
-        "  One file under the workflows/ directory defines one workflow:",
+        "Built-in input",
+        "  One module default-exports one workflow definition:",
         "",
         "    import { claude, defineWorkflow, githubAttention, githubPullRequests }",
         '      from "@aicalas/loopy/workflow";',
         "",
+        "    const outcome = {",
+        '      type: "object",',
+        '      properties: { summary: { type: "string" } },',
+        '      required: ["summary"],',
+        "      additionalProperties: false,",
+        "    } as const;",
+        "",
         "    export default defineWorkflow({",
         '      name: "review",',
         '      watcher: githubPullRequests({ repository: "owner/repo", label: "agent:review" }),',
         '      attention: githubAttention({ target: "trigger" }),',
         "      async run(ctx) {",
-        '        const agent = ctx.agent("reviewer", claude({ model: "claude-opus-4-8" }));',
-        '        return await agent.run({ prompt: ["Review this PR."] });',
+        '        const agent = ctx.agent("reviewer",',
+        '          claude({ model: "claude-opus-4-8", effort: "high" }));',
+        '        ctx.progress("Reviewing the pull request");',
+        '        return await agent.run({ output: outcome, prompt: ["Review this pull request."] });',
         "      },",
         "    });",
         "",
-        "  The module must have no top-level side effects: it is imported both under Node (for",
-        "  metadata) and inside the Temporal isolate bundle, and a side effect breaks one or both.",
-        "  A workflow configures the built-in adapters (watcher, attention, and any effects/asks);",
-        "  it cannot define new ones.",
-        "",
-        "Schedule instead of watching",
-        "  A workflow declares exactly one intake: watcher or schedule. A schedule starts the user",
-        "  workflow directly; it needs no watcher and attention is optional:",
-        "",
-        "    export default defineWorkflow({",
-        '      name: "nightly-maintenance",',
-        '      schedule: { cron: "0 2 * * *", timezone: "UTC" },',
-        "      async run(ctx) {",
-        "        return { source: ctx.trigger.source }; // schedule",
-        "      },",
-        "    });",
-        "",
-        "  Use intervalSeconds instead of cron for a fixed cadence. overlap defaults to SKIP;",
-        "  BUFFER_ONE, BUFFER_ALL, CANCEL_OTHER, TERMINATE_OTHER, and ALLOW_ALL are available.",
-        "  A scheduled workflow with GitHub attention must target a fixed issue, not target: trigger.",
-        "",
-        "Register",
-        "  Drop the module in the workflows directory and run loopy loop. On startup loopy",
-        "  discovers every module, bundles them, and reconciles their Temporal Schedules.",
-        "  Watchers poll for labelled issues or PRs; declared schedules start their workflows on time.",
-        "",
-        "Add or change",
-        "  Edits reach a running Worker only on restart. The safe loop:",
-        "    1. Edit, add, or delete workflow files.",
-        "    2. Drain: send SIGINT/SIGTERM to loopy loop. It pauses this repo's Schedules and",
-        "       keeps serving open instances until drain_timeout_seconds; a second signal skips",
-        "       the wait. loopy has no workflow versioning, so draining is how you deploy an",
-        "       edit without an in-flight instance resuming under changed code.",
-        "    3. Restart loopy loop. Schedules reconcile: new file adds a Schedule, a deleted",
-        "       file removes one, an existing one is updated in place (an operator pause is kept).",
+        "  A GitHub watcher claims each labelled object before run(ctx) starts. A workflow may",
+        "  instead declare a Temporal schedule with cron or intervalSeconds. A workflow declares",
+        "  exactly one intake; watcher and schedule are the built-in choices. Attention is optional",
+        "  for scheduled workflows.",
+        "",
+        "Authoring boundaries",
+        "  Workflow code runs in Temporal's deterministic isolate. Keep top-level module evaluation",
+        "  free of side effects; loopy imports modules under Node for discovery and again when it",
+        "  builds the isolate bundle. Filesystem, network, provider, and git work belong behind",
+        "  Activities such as inputs, agent harnesses, effects, attention, and channels.",
+        "",
+        "  ctx.agent(id, harness) keeps one worktree and provider session across calls.",
+        "  ctx.effect(id, effect) performs a declared idempotent external mutation once per id.",
+        "  ctx.ask(id, channel, request) parks without occupying an agent slot until answered.",
+        "  ctx.progress(details) replaces Temporal Current Details with the latest message.",
+        "  Agent output accepts a Standard JSON Schema validator or literal JSON Schema.",
+        "",
+        "Built-in adapters",
+        "  githubIssues / githubPullRequests  Poll labelled GitHub objects. Edge mode consumes the",
+        "                                      intake label; level mode repeats while it remains.",
+        "  claude / codex / opencode          Run a named resumable provider session in a worktree.",
+        "  githubAttention                    Report halted, parked, stuck, and awaiting-answer runs.",
+        "  githubLabels                       Apply an idempotent label change through ctx.effect.",
+        "  githubComments                     Ask through ctx.ask and resume from a matching reply.",
+        "  promptFile                         Read and interpolate a prompt outside the isolate.",
+        "",
+        "  Harness configuration controls permissions and sandboxing. By default provider settings",
+        "  and repository instructions remain available, including their tools and MCP servers.",
+        "  Treat those settings as part of the workflow's effective capability and credential scope.",
+        "",
+        "Prompt files",
+        "  promptFile(path, values?) works in agent prompts and ctx.ask human questions. Paths",
+        "  resolve against project_directory outside the isolate. Files use named double-brace",
+        "  placeholders such as {{ repository }}; names begin with a letter or underscore and may",
+        "  continue with letters, digits, or underscores. Whitespace inside the braces is ignored.",
+        "",
+        '  promptFile("prompts/review.md", { repository: ctx.trigger.repository, issue: 42 })',
+        "",
+        "  The values map is the template's only input. Strings are inserted verbatim; finite",
+        "  numbers, booleans, and null use JSON scalar text. Unused values are allowed, but every",
+        "  placeholder needs a value. Missing values, malformed placeholders, non-finite numbers,",
+        "  and objects or arrays halt without retry before an agent or question channel is called.",
+        "",
+        "Deploy an edit",
+        "  Workflow modules are bundled once when loopy loop starts. Send SIGINT or SIGTERM to pause",
+        "  intake and drain open executions, then restart. A second signal skips the drain. Loopy has",
+        "  no workflow versioning, so do not put an open execution under incompatible workflow code.",
     ].join("\n"),
 };
-const MONITOR = {
-    name: "monitor",
-    summary: "inspect instances with loopy status and act on the ones needing a human",
+const RECOVERY = {
+    name: "recovery",
+    summary: "resume the local runtime and recover parked or interrupted work",
     body: [
-        "loopy guide monitor",
-        "",
-        "loopy status [workflow-id]",
-        "  Prints one NDJSON row per instance (per Workflow ID), or one row for a single",
-        "  instance. Each row carries a domainStatus - loopy's own view, separate from",
-        "  Temporal's status.",
-        "",
-        "Domain statuses",
-        "  running                  Executing or waiting on an agent. Nothing to do.",
-        "  awaiting_recovery        An agent call failed safely; the instance, workspace, and session",
-        "                           are retained. Resolve: loopy resolve <id> --retry (or --halt).",
-        "  awaiting_reconciliation  An agent call ended ambiguously and the instance parked.",
-        "                           Resolve: loopy resolve <id> --retry (once the prior call can",
-        "                           no longer mutate external state) or --halt to close it.",
-        "  awaiting_answer          Parked on ctx.ask for a human answer. Reply on the channel,",
-        '                           or: loopy answer <id> "<text>". Unanswered, it halts in 2 days.',
-        "  completed                Closed with a result. Re-label the trigger to run again.",
-        "  halted                   An expected failure closed it; cleanup ran. Read the reason,",
-        "                           fix the cause, re-label to run again.",
-        "  stuck                    Open but its own code fails every attempt. Fix the workflow",
-        "                           and restart loopy loop; it resumes automatically.",
-        "  unavailable              The row could not be read (usually transient). Retry status.",
-        "",
-        "Push, not just polling",
-        "  Every state that needs a human also reaches the workflow's declared attention route",
-        "  (by default, a label and comment on the trigger issue/PR), so you are notified there",
-        "  without polling loopy status.",
-        "",
-        "When --call is required",
-        "  If more than one call is parked or awaiting an answer, pass --call <handle>/call/<n>;",
-        "  the error from resolve/answer lists the available call addresses.",
+        "loopy guide recovery",
+        "",
+        "Temporal preserves orchestration state; the local filesystem preserves the material an",
+        "agent needs to continue. Recovery requires the same Temporal Namespace and Task Queues,",
+        "the same loopy config, the same working_directory, and the provider's session data.",
+        "",
+        "Runtime restart",
+        "  A graceful signal drains before exit. After an ordinary process or machine restart, run",
+        "  loopy loop with the same config and storage. Temporal schedules new tasks for the restored",
+        "  worker, and open executions continue. Closed executions need no local workspace.",
+        "",
+        "Agent-call outcomes",
+        "  Explicit provider, validation, deadline, or session-resume failure parks the call for",
+        "  recovery and retains its known session. Fix the cause, then run:",
+        "",
+        "    loopy resolve <workflow-id> --retry",
+        "",
+        "  Worker loss, heartbeat timeout, or a lost result is ambiguous because the old provider",
+        "  invocation may have changed the worktree or remote repository. Confirm that it can no",
+        "  longer mutate state before retrying. Loopy reuses the last session ID checkpointed in",
+        "  Temporal when available; otherwise it retains an earlier known session or starts fresh.",
+        "  The resolve result shows sessionId on the parked call. Use --halt when retry is unsafe.",
+        "",
+        "  If several calls are parked, add --call <handle>/call/<n>. If ctx.ask is waiting and its",
+        "  configured channel is unavailable, use loopy answer <workflow-id> <text>, with --call when",
+        "  needed.",
+        "",
+        "Lost storage",
+        "  A retained Temporal history cannot reconstruct an absent worktree or provider transcript.",
+        "  Do not retry a session against a different path or empty provider state and assume it is",
+        "  continuous. Inspect the execution and workspace, preserve any recoverable git work, then",
+        "  terminate or reset through Temporal and start fresh. Remove orphaned worktrees manually",
+        "  only after no open execution owns them.",
+        "",
+        "Temporal operations",
+        "  Use Temporal UI or CLI to inspect executions and Event Histories, diagnose Workflow Task",
+        "  failures, administer Schedules, and cancel, reset, or terminate executions. Loopy's",
+        "  resolve and answer commands exist only for Loopy's parked-call and human-input contracts.",
     ].join("\n"),
 };
-/** Ordered so `loopy guide` (no topic) lists them in the sequence an operator meets them. */
-export const GUIDE_TOPICS = [SETUP, WORKFLOWS, MONITOR];
+export const GUIDE_TOPICS = [SETUP, WORKFLOWS, RECOVERY];
 export function guideTopicNames() {
     return GUIDE_TOPICS.map((topic) => topic.name);
 }
 export function findGuideTopic(name) {
     return GUIDE_TOPICS.find((topic) => topic.name === name);
 }
-/** `loopy guide` with no topic: the topic list plus the one external pointer loopy makes. */
 export function renderGuideIndex() {
     const width = Math.max(...GUIDE_TOPICS.map((topic) => topic.name.length));
     const rows = GUIDE_TOPICS.map((topic) => `  ${topic.name.padEnd(width)}  ${topic.summary}`).join("\n");
     return [
-        "loopy guide <topic> - operator guidance, printed offline with no config needed.",
+        "loopy guide <topic> - offline guidance with no config or Temporal connection required.",
         "",
         "Topics:",
         rows,
@@ -170,19 +224,15 @@ export function renderGuideIndex() {
         TEMPORAL_SKILL_POINTER,
     ].join("\n");
 }
-/** Appended after `loopy --help`: the playbook that points at the guide topics. */
 export function helpPlaybook() {
     return [
         "Playbook:",
-        "  loopy loop                     Run the Worker Process (poll, run, drain on signal).",
-        "  loopy status [id]              List instances, or describe one.",
-        "  loopy resolve <id> --retry     Resume a recoverable call or reconcile an ambiguous one.",
-        '  loopy answer <id> "<text>"      Answer an instance parked on ctx.ask.',
-        "",
-        "  To deploy a workflow change: edit files, then restart loopy loop.",
+        "  loopy loop                     Run workflows and drain safely when interrupted.",
+        "  loopy resolve <id> --retry     Resume or reconcile a parked agent call.",
+        '  loopy answer <id> "<text>"     Answer a workflow waiting for human input.',
+        "  loopy guide                    Read setup, authoring, and recovery guidance.",
         "",
-        "Guidance (offline, no config): loopy guide <" + guideTopicNames().join("|") + ">",
-        "  or run  loopy guide  for the topic list.",
+        "For inspection, histories, cancellation, and termination, use Temporal UI or CLI.",
     ].join("\n");
 }
 //# sourceMappingURL=cli-help.js.map

package/dist/cli-help.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wGAAwG;AACxG,MAAM,CAAC,MAAM,sBAAsB,GACjC,0FAA0F;IAC1F,oGAAoG,CAAC;AAQvG,MAAM,KAAK,GAAe;IACxB,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,qFAAqF;IAC9F,IAAI,EAAE;QACJ,mBAAmB;QACnB,EAAE;QACF,wEAAwE;QACxE,EAAE;QACF,aAAa;QACb,mFAAmF;QACnF,qCAAqC;QACrC,EAAE;QACF,oBAAoB;QACpB,EAAE;QACF,oFAAoF;QACpF,6BAA6B;QAC7B,iCAAiC;QACjC,wEAAwE;QACxE,EAAE;QACF,gBAAgB;QAChB,gCAAgC;QAChC,2BAA2B;QAC3B,uDAAuD;QACvD,uDAAuD;QACvD,iBAAiB;QACjB,EAAE;QACF,4EAA4E;QAC5E,8EAA8E;QAC9E,EAAE;QACF,mEAAmE;QACnE,gFAAgF;QAChF,wDAAwD;QACxD,oEAAoE;QACpE,mFAAmF;QACnF,sFAAsF;QACtF,uFAAuF;QACvF,EAAE;QACF,WAAW;QACX,iFAAiF;QACjF,qDAAqD;KACtD,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC;AAEF,MAAM,SAAS,GAAe;IAC5B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,wCAAwC;IACjD,IAAI,EAAE;QACJ,uBAAuB;QACvB,EAAE;QACF,uFAAuF;QACvF,sFAAsF;QACtF,EAAE;QACF,QAAQ;QACR,iEAAiE;QACjE,EAAE;QACF,4EAA4E;QAC5E,uCAAuC;QACvC,EAAE;QACF,qCAAqC;QACrC,uBAAuB;QACvB,yFAAyF;QACzF,0DAA0D;QAC1D,wBAAwB;QACxB,oFAAoF;QACpF,kEAAkE;QAClE,UAAU;QACV,SAAS;QACT,EAAE;QACF,uFAAuF;QACvF,2FAA2F;QAC3F,2FAA2F;QAC3F,8BAA8B;QAC9B,EAAE;QACF,8BAA8B;QAC9B,2FAA2F;QAC3F,qEAAqE;QACrE,EAAE;QACF,qCAAqC;QACrC,oCAAoC;QACpC,yDAAyD;QACzD,wBAAwB;QACxB,4DAA4D;QAC5D,UAAU;QACV,SAAS;QACT,EAAE;QACF,sFAAsF;QACtF,uFAAuF;QACvF,8FAA8F;QAC9F,EAAE;QACF,UAAU;QACV,mFAAmF;QACnF,kFAAkF;QAClF,+FAA+F;QAC/F,EAAE;QACF,eAAe;QACf,gEAAgE;QAChE,6CAA6C;QAC7C,sFAAsF;QACtF,wFAAwF;QACxF,qFAAqF;QACrF,wEAAwE;QACxE,qFAAqF;QACrF,2FAA2F;KAC5F,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC;AAEF,MAAM,OAAO,GAAe;IAC1B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,yEAAyE;IAClF,IAAI,EAAE;QACJ,qBAAqB;QACrB,EAAE;QACF,4BAA4B;QAC5B,iFAAiF;QACjF,+EAA+E;QAC/E,sBAAsB;QACtB,EAAE;QACF,iBAAiB;QACjB,6EAA6E;QAC7E,8FAA8F;QAC9F,2FAA2F;QAC3F,qFAAqF;QACrF,yFAAyF;QACzF,oFAAoF;QACpF,wFAAwF;QACxF,4FAA4F;QAC5F,qFAAqF;QACrF,yFAAyF;QACzF,kEAAkE;QAClE,wFAAwF;QACxF,8EAA8E;QAC9E,yFAAyF;QACzF,EAAE;QACF,wBAAwB;QACxB,uFAAuF;QACvF,wFAAwF;QACxF,iCAAiC;QACjC,EAAE;QACF,yBAAyB;QACzB,yFAAyF;QACzF,qEAAqE;KACtE,CAAC,IAAI,CAAC,IAAI,CAAC;CACb,CAAC;AAEF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,YAAY,GAA0B,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAE/E,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAC9F,IAAI,CACL,CAAC;IACF,OAAO;QACL,iFAAiF;QACjF,EAAE;QACF,SAAS;QACT,IAAI;QACJ,EAAE;QACF,sBAAsB;KACvB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,WAAW;QACX,uFAAuF;QACvF,mEAAmE;QACnE,2FAA2F;QAC3F,yEAAyE;QACzE,EAAE;QACF,qEAAqE;QACrE,EAAE;QACF,8CAA8C,GAAG,eAAe,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG;QAClF,4CAA4C;KAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -1,17 +1,16 @@
 #!/usr/bin/env node
+import { Command } from "commander";
 import type { AdapterRegistries } from "./adapters.js";
 import { buildWorkflowBundle, discoverWorkflows } from "./build/discover.js";
 import { type InstanceState, type ResolveRequest } from "./core/wire.js";
 import { ensureRepo } from "./git.js";
 import { type Settings } from "./settings.js";
 import { connectClient } from "./temporal/client.js";
-import { type InstanceView } from "./temporal/status.js";
 import { createWorkerRuntime } from "./temporal/worker.js";
 export interface CliServices {
     serve(settings: Settings, registries: AdapterRegistries): Promise<void>;
     resolve(workflowId: string, request: ResolveOptions, settings: Settings): Promise<InstanceState>;
     answer(workflowId: string, request: AnswerOptions, settings: Settings): Promise<InstanceState>;
-    status(settings: Settings, workflowId: string | undefined): Promise<InstanceView[]>;
 }
 export interface ServeServices {
     ensureRepo: typeof ensureRepo;
@@ -28,10 +27,10 @@ export interface AnswerOptions {
     answer: string;
     callId?: string;
 }
+export declare function createCli(services: CliServices): Command;
 export declare function main(argv: readonly string[], services: CliServices): Promise<void>;
 export declare function serve(settings: Settings, registries: AdapterRegistries, services: ServeServices): Promise<void>;
 export declare function resolveInstance(workflowId: string, request: ResolveOptions, settings: Settings, connect?: typeof connectClient): Promise<InstanceState>;
 export declare function answerInstance(workflowId: string, request: AnswerOptions, settings: Settings, connect?: typeof connectClient): Promise<InstanceState>;
-export declare function statusInstances(settings: Settings, workflowId: string | undefined, connect?: typeof connectClient): Promise<InstanceView[]>;
 export declare function runExecutable(argv: readonly string[], services: CliServices): Promise<void>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EACL,mBAAmB,EAEnB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAY,UAAU,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AASrD,OAAO,EAEL,KAAK,YAAY,EAGlB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM3D,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/F,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;CACjD;AAqBD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoGxF;AAED,wBAAsB,KAAK,CACzB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAkEf;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,OAAO,aAA6B,GAC5C,OAAO,CAAC,aAAa,CAAC,CAcxB;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,OAAO,aAA6B,GAC5C,OAAO,CAAC,aAAa,CAAC,CAcxB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE,OAAO,aAA6B,GAC5C,OAAO,CAAC,YAAY,EAAE,CAAC,CAqBzB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAWjG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EACL,mBAAmB,EAEnB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAY,UAAU,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AASrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM3D,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAChG;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;CACjD;AAoBD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAwFxD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;AAED,wBAAsB,KAAK,CACzB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAkEf;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,OAAO,aAA6B,GAC5C,OAAO,CAAC,aAAa,CAAC,CAcxB;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,OAAO,aAA6B,GAC5C,OAAO,CAAC,aAAa,CAAC,CAcxB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAWjG"}

package/dist/cli.js

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 import { join, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
-import { WorkflowNotFoundError } from "@temporalio/client";
 import { Runtime } from "@temporalio/worker";
 import { Command, Option } from "commander";
 import { createAdapterRegistries } from "./adapters.js";
@@ -17,7 +16,6 @@ import { ANSWER_INSTANCE_UPDATE, INSTANCE_STATE_QUERY, RESOLVE_INSTANCE_UPDATE,
 import { drainOnSignal } from "./temporal/drain.js";
 import { countOpenExecutions } from "./temporal/executions.js";
 import { resumeDrainedSchedules, syncSchedules } from "./temporal/schedules.js";
-import { describeInstance, listInstances, } from "./temporal/status.js";
 import { createWorkerRuntime } from "./temporal/worker.js";
 import { LOOPY_VERSION } from "./version.js";
 import { WorkerLockError, WorkerProcessLock } from "./worker-lock.js";
@@ -34,12 +32,11 @@ const DEFAULT_CLI_SERVICES = {
     serve: (settings, registries) => serve(settings, registries, DEFAULT_SERVE_SERVICES),
     resolve: resolveInstance,
     answer: answerInstance,
-    status: statusInstances,
 };
-export async function main(argv, services) {
+export function createCli(services) {
     const program = new Command()
         .name("loopy")
-        .description("Host the loopy Temporal Worker Process.")
+        .description("Run durable local agent workflows on Temporal.")
         .version(LOOPY_VERSION)
         .option("-c, --config <path>", "loopy config TOML (default: ~/.config/loopy/config.toml)")
         .addOption(new Option("--log-level <level>", "override the configured log level").choices([
@@ -48,7 +45,7 @@ export async function main(argv, services) {
     program.addHelpText("after", `\n${helpPlaybook()}`);
     program
         .command("guide")
-        .description("Print operator guidance for a topic (offline; no config or Temporal needed).")
+        .description("Learn how to configure, author, run, and recover workflows.")
         .argument("[topic]", `one of: ${guideTopicNames().join(", ")}`)
         .action((topic) => {
         if (topic === undefined) {
@@ -63,7 +60,7 @@ export async function main(argv, services) {
     });
     program
         .command("loop")
-        .description("Run the control and agent Worker Entities until interrupted.")
+        .description("Run workflows until interrupted.")
         .option("-w, --workflows <path>", "directory of workflow modules (overrides the config)")
         .action(async (loopOptions) => {
         const options = program.opts();
@@ -73,7 +70,7 @@ export async function main(argv, services) {
     });
     program
         .command("resolve")
-        .description("Resume a recoverable call or reconcile an ambiguous external operation.")
+        .description("Resume or reconcile a parked agent call.")
         .argument("<workflow-id>", "instance Workflow ID")
         .option("--call <address>", "call address, for example reviewer/call/2")
         .option("--retry", "retry the call (an ambiguous prior call must no longer mutate state)")
@@ -94,7 +91,7 @@ export async function main(argv, services) {
     });
     program
         .command("answer")
-        .description("Answer an instance call parked on ctx.ask, over any channel.")
+        .description("Answer a workflow waiting for human input.")
         .argument("<workflow-id>", "instance Workflow ID")
         .argument("<text>", "the answer text delivered to the waiting ask")
         .option("--call <address>", "call address, for example confirm-drop/call/1")
@@ -109,19 +106,10 @@ export async function main(argv, services) {
         const state = await services.answer(workflowId, request, settings);
         process.stdout.write(`${JSON.stringify(state)}\n`);
     });
-    program
-        .command("status")
-        .description("Report loopy instance Executions from Temporal as NDJSON.")
-        .argument("[workflow-id]", "describe one instance instead of listing all")
-        .action(async (workflowId) => {
-        const options = program.opts();
-        const settings = loadSettings(options.config);
-        startLogging(settings, options.logLevel);
-        const views = await services.status(settings, workflowId);
-        for (const view of views)
-            process.stdout.write(`${JSON.stringify(view)}\n`);
-    });
-    await program.parseAsync([...argv]);
+    return program;
+}
+export async function main(argv, services) {
+    await createCli(services).parseAsync([...argv]);
 }
 export async function serve(settings, registries, services) {
     const processLock = new WorkerProcessLock(join(settings.workingDirectory, "worker.lock"));
@@ -218,30 +206,6 @@ export async function answerInstance(workflowId, request, settings, connect = co
         await connection.close();
     }
 }
-export async function statusInstances(settings, workflowId, connect = connectClient) {
-    const connection = await connect(settings.temporal);
-    try {
-        const client = connection.client.workflow;
-        if (workflowId !== undefined) {
-            try {
-                return [await describeInstance(client, workflowId)];
-            }
-            catch (error) {
-                // A listing only describes IDs Visibility just returned, but an explicit ID comes from an
-                // operator and may be stale or mistyped. Report that as a clean CLI error rather than
-                // letting the raw WorkflowNotFoundError escape as an unhandled stack trace.
-                if (error instanceof WorkflowNotFoundError) {
-                    throw new CliError(`no loopy instance found with ID ${JSON.stringify(workflowId)}`);
-                }
-                throw error;
-            }
-        }
-        return await listInstances(client);
-    }
-    finally {
-        await connection.close();
-    }
-}
 export async function runExecutable(argv, services) {
     try {
         await main(argv, services);