@aicalas/loopy 0.2.0 → 0.2.1

package/README.md

@@ -1,101 +1,276 @@
 # loopy
 
-Label a GitHub issue or PR, get a coding agent run against it. You write the workflow as a TypeScript function; loopy polls for the trigger, claims the label, provisions a git worktree, runs the agent, validates its structured output, and keeps the whole orchestration durable in Temporal.
+Loopy runs durable local agent workflows on Temporal. You author each workflow as a TypeScript function; Loopy discovers it, receives external or scheduled input, provisions isolated git worktrees, runs coding agents, validates structured output, and records orchestration state in Temporal.
 
-Design: [`ARCHITECTURE.md`](ARCHITECTURE.md). Operating it: `loopy guide`.
+Loopy is built for one developer running a local worker against a Temporal Service. Temporal owns workflow state, retries, schedules, histories, and generic execution operations. Loopy owns the workflow authoring API, agent sessions and worktrees, idempotent effects, human questions, and recovery of parked agent calls.
+
+Loopy currently only supports receiving signals from GH. The long term goal is to provide a plugin system for users to build their own integrations.
 
 ## Install
 
-Needs Node.js 24 and `git`.
+Loopy requires Node.js 24 and git.
 
 ```bash
 npm install --global @aicalas/loopy
 ```
 
-That installs the `loopy` command on your PATH.
+Add Loopy and a Standard JSON Schema validator such as Zod to the project that contains your workflow modules:
+
+```bash
+npm install @aicalas/loopy zod
+```
+
+## Start
+
+The complete setup, configuration, authoring, storage, and recovery guide ships with the package and works offline without configuration or a Temporal connection:
 
-Workflows can live in your own project: add loopy there (`pnpm add @aicalas/loopy`) so they can import `@aicalas/loopy/workflow`, and point `project_directory` at it.
+```bash
+loopy guide
+loopy guide setup
+loopy guide workflows
+loopy guide recovery
+```
 
-## Run
+After configuring the repository, workflow directory, working directory, and Temporal connection, start the local runtime:
 
 ```bash
-cp config.example.toml ~/.config/loopy/config.toml   # set repository and both task queue names
-export GITHUB_TOKEN=…
-make temporal-dev                                    # or point [temporal] at your own Service
 loopy loop
 ```
 
-`loopy loop` discovers every module under `workflows/`, bundles them, and schedules one poller each. Bundling happens once per process - restart to deploy a workflow edit. `loopy status` shows what each instance is waiting on.
+## Typical Docker Compose setup
+
+A typical local deployment runs the Temporal development server and Loopy as separate Compose services. This single-developer setup uses Temporal's embedded development server; deploy Temporal separately for production.
+
+Create `config.toml` beside your `workflows/` and `prompts/` directories:
+
+```toml
+repository = "owner/repo"
+default_branch = "main"
+project_directory = "/opt/loopy"
+workflows = "workflows"
+working_directory = "/var/lib/loopy"
+poll_interval_seconds = 60
+
+[temporal]
+control_task_queue = "loopy-control"
+agent_task_queue = "loopy-agent"
+
+[agent_worker]
+max_concurrent_activities = 2
+```
+
+Build Loopy into the same development environment that its agents need. Workflow modules are imported under Node before they are bundled, so the image installs the workflow project's locked dependencies under `/opt/loopy` rather than relying on globally installed packages. This minimal `Dockerfile.loopy` includes the three supported provider CLIs, but a real image must also install the target repository's language runtimes, package managers, build tools, test dependencies, MCP server executables, and system libraries:
+
+```dockerfile
+FROM node:24-bookworm
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends ca-certificates gh git make openssh-client python3 g++ \
+    && rm -rf /var/lib/apt/lists/*
+RUN npm install --global @anthropic-ai/claude-code @openai/codex opencode-ai@^1.18.3
+RUN mkdir -p /opt/loopy /var/lib/loopy && chown -R node:node /opt/loopy /var/lib/loopy
+
+WORKDIR /opt/loopy
+COPY --chown=node:node package.json package-lock.json ./
+USER node
+RUN npm ci --omit=dev
+ENTRYPOINT ["/opt/loopy/node_modules/.bin/loopy"]
+CMD ["--config", "/opt/loopy/config.toml", "loop"]
+```
+
+Use the official [Temporal CLI image](https://hub.docker.com/r/temporalio/temporal) for a persistent local development service:
+
+```yaml
+services:
+  temporal:
+    image: temporalio/temporal:1.8.1
+    command:
+      - server
+      - start-dev
+      - --ip
+      - 0.0.0.0
+      - --db-filename
+      - /home/temporal/temporal.db
+    ports:
+      - "7233:7233"
+      - "8233:8233"
+    volumes:
+      - temporal-data:/home/temporal
+    restart: unless-stopped
+
+  loopy:
+    build:
+      context: .
+      dockerfile: Dockerfile.loopy
+    depends_on:
+      - temporal
+    env_file:
+      - .env
+    environment:
+      TEMPORAL_ADDRESS: temporal:7233
+    init: true
+    volumes:
+      - ./config.toml:/opt/loopy/config.toml:ro
+      - ./workflows:/opt/loopy/workflows:ro
+      - ./prompts:/opt/loopy/prompts:ro
+      - loopy-work:/var/lib/loopy
+      - agent-home:/home/node
+    restart: unless-stopped
+
+volumes:
+  temporal-data:
+  loopy-work:
+  agent-home:
+```
+
+The three volumes provide durability: `temporal-data` holds Workflow histories and schedules, `loopy-work` holds the managed clone and open worktrees, and `agent-home` holds provider authentication, configuration, MCP definitions, and session transcripts.
+
+## Credentials and agent environment
+
+Loopy does not create, broker, or store credentials. Supply only the credentials needed by the workflows and harnesses you use. For a local Compose deployment, put secret environment variables in an uncommitted `.env` file or inject them with your secret manager:
+
+```dotenv
+GITHUB_TOKEN=github-token
+ANTHROPIC_API_KEY=anthropic-key
+CODEX_API_KEY=openai-key
+# Add the provider-specific variables referenced by your OpenCode configuration.
+```
+
+Start the stack and open Temporal UI at `http://localhost:8233`:
 
-## Workflows
+```bash
+docker compose up --build -d
+docker compose logs -f loopy
+```
+
+## Functionality
 
-One file under `workflows/` is one workflow. No spec language, no register step: discovery is registration. Abridged from [`workflows/review.ts`](workflows/review.ts):
+| Capability | Built-in behavior |
+| --- | --- |
+| Intake | Poll labelled GitHub issues or pull requests, or start from a Temporal cron/interval schedule. Edge-mode watchers consume the intake label before user code runs; level mode repeats while it remains attached. |
+| Agents | Run Claude, Codex, or OpenCode in isolated git worktrees and resume the same provider session across calls. |
+| Control flow | Use ordinary TypeScript branches, loops, sequential calls, and `Promise.all` fan-out inside the Temporal Workflow. |
+| Results | Require every agent call to return a value validated by a Standard JSON Schema validator or literal JSON Schema. |
+| Effects | Apply idempotent GitHub label changes once per effect ID. |
+| Human input | Post a GitHub question, park without holding an agent slot, and resume from the reply or `loopy answer`. |
+| Prompts and progress | Read prompt files with explicit scalar interpolation and publish the latest progress to Temporal Current Details. |
+| Recovery | Drain safely on shutdown and reconcile or retry parked agent calls with `loopy resolve`. |
+
+## Workflow example
+
+Each TypeScript module default-exports a workflow created with `defineWorkflow` from `@aicalas/loopy/workflow`. This example covers structured agent output, a prompt file, progress, human input, and an idempotent effect:
 
 ```ts
+import {
+  claude,
+  defineWorkflow,
+  githubAttention,
+  githubComments,
+  githubLabels,
+  githubPullRequests,
+  promptFile,
+  triggerIssue,
+} from "@aicalas/loopy/workflow";
+import { z } from "zod";
+
+const Review = z.object({
+  summary: z.string(),
+  question: z.string().nullable(),
+});
+
 export default defineWorkflow({
   name: "review",
   watcher: githubPullRequests({
     repository: "owner/repo",
     label: "agent:review",
-    onStart: { add: ["agent:reviewing"] },
+    onStart: { add: ["agent:running"] },
   }),
   attention: githubAttention({ target: "trigger" }),
   async run(ctx) {
-    const reviewer = ctx.agent("reviewer", claude({ model: "claude-opus-4-8", effort: "high" }));
-    let outcome = await reviewer.run({
-      output: review, // Zod schema: { summary, blockers, done }
-      prompt: [promptFile("prompts/review.md"), `Pull request #${ctx.trigger.id}`],
+    const issue = triggerIssue(ctx.trigger);
+    const reviewer = ctx.agent(
+      "reviewer",
+      claude({ model: "claude-opus-4-8", effort: "high", permissionMode: "acceptEdits" }),
+    );
+    ctx.progress("Reviewing the pull request");
+    let review = await reviewer.run({
+      output: Review,
+      prompt: [promptFile("prompts/review.md", { repository: ctx.trigger.repository, issue })],
     });
-    for (let round = 0; round < 2 && !outcome.done; round += 1) {
-      outcome = await reviewer.run({
-        output: review,
-        prompt: ["Resolve the blockers you reported, then report again.", ...outcome.blockers],
+    if (review.question !== null) {
+      const answer = await ctx.ask(
+        "review-question",
+        githubComments({ repository: ctx.trigger.repository, issue }),
+        { prompt: [review.question] },
+      );
+      review = await reviewer.run({
+        output: Review,
+        prompt: [`The human answered: ${answer}`],
       });
     }
     await ctx.effect(
       "mark-reviewed",
       githubLabels({
         repository: ctx.trigger.repository,
-        issue: triggerIssue(ctx.trigger),
-        remove: ["agent:reviewing"],
+        issue,
         add: ["agent:reviewed"],
+        remove: ["agent:running"],
       }),
     );
-    return { summary: outcome.summary };
+    return review;
   },
 });
 ```
 
-Per matching PR, once: claim `agent:review` before `run` starts, review, loop until the agent reports `done`, relabel, return. The agent handle holds one session and one worktree, so later calls resume where the first stopped. `ctx.effect` runs at most once per id. Halts, parks, and stalls go to the attention adapter.
+The GitHub watcher claims each matching pull request, then Temporal runs the workflow. The named agent keeps its provider session and worktree across calls.
 
 ## Scheduled workflows
 
-A workflow declares exactly one intake: a GitHub `watcher`, or a Temporal `schedule`. Scheduled workflows start directly at their configured cron or interval and may omit `attention`; when they do declare GitHub attention, use a fixed issue rather than `target: "trigger"`.
+A workflow declares one input. Use a Temporal schedule instead of a watcher for time-based work:
 
 ```ts
+import { defineWorkflow } from "@aicalas/loopy/workflow";
+
 export default defineWorkflow({
   name: "nightly-maintenance",
   schedule: { cron: "0 2 * * *", timezone: "UTC" },
   async run(ctx) {
-    // ctx.trigger identifies this as source: "schedule".
-    return { complete: true };
+    return { source: ctx.trigger.source };
   },
 });
 ```
 
-`overlap` defaults to `"SKIP"`; `BUFFER_ONE`, `BUFFER_ALL`, `CANCEL_OTHER`, `TERMINATE_OTHER`, and `ALLOW_ALL` are also available. Loopy retains a lightweight control tick for scheduled workflows so status inspection, stuck detection, and `ctx.ask` reply delivery continue to work.
+Schedules also accept `intervalSeconds` and an overlap policy. Attention is optional for scheduled workflows; GitHub attention must target a fixed issue because there is no source issue or pull request.
+
+## Agent harnesses
+
+| Factory | Provider | Required options | Session behavior |
+| --- | --- | --- | --- |
+| `claude` | Anthropic Claude Agent SDK | `model`, `effort` | Resumes a Claude session in the same worktree path. |
+| `codex` | OpenAI Codex SDK | `model`, `effort` | Resumes a Codex thread in the same worktree. |
+| `opencode` | OpenCode SDK v2 and OpenCode 1.18.3 or newer on `PATH` | `model` as `provider/model`, `effort` | Resumes an OpenCode session in the same worktree. |
+
+Harness options also control provider isolation, permissions, approvals, and filesystem sandboxing. See `loopy guide workflows` for the authoring boundaries and remember that provider configuration and repository instructions can grant tools and credentials beyond Loopy's declared adapters.
 
 ## Adapters
 
-Factories from `@aicalas/loopy/workflow`. Each takes its own repository, target, and credentials rather than inheriting them, so a workflow can poll one repository and work in another.
+Import adapter factories from `@aicalas/loopy/workflow`. Each adapter declares its own repository, target, and credential source.
 
 | Kind | Factories | Role |
 | --- | --- | --- |
-| Watcher | `githubIssues`, `githubPullRequests` | Poll a repository for a label; claim each match. |
-| Harness | `claude`, `codex`, `opencode` | The agent behind `ctx.agent(id, harness)`. |
-| Attention | `githubAttention` | Report halted, parked, stuck, and awaiting-answer instances. |
-| Effect | `githubLabels` | Idempotent writes via `ctx.effect(id, effect)`. |
-| Channel | `githubComments` | Where `ctx.ask(id, channel, request)` waits for a human. |
-| Prompt | `promptFile` | A prompt segment read from disk. |
-
-`output` takes any Standard JSON Schema validator (Zod 4, Valibot, ArkType) or a literal JSON Schema.
+| Watcher | `githubIssues`, `githubPullRequests` | Poll a repository for a label and claim each match. |
+| Harness | `claude`, `codex`, `opencode` | Run the agent behind `ctx.agent(id, harness)`. |
+| Attention | `githubAttention` | Report halted, parked, stuck, and awaiting-answer workflows. |
+| Effect | `githubLabels` | Apply idempotent writes through `ctx.effect(id, effect)`. |
+| Channel | `githubComments` | Ask a human through `ctx.ask(id, channel, request)`. |
+| Prompt | `promptFile` | Read a prompt segment from disk outside the Workflow isolate. |
+
+The GitHub adapters make label changes idempotent by converging on the desired label set. Before changing an issue or pull request, Loopy reads its current labels, applies the requested additions and removals, and writes the result only if it changed. Retrying the operation reaches the same state: adding a label that is already present or removing one that is already absent does nothing.
+
+Agent `output` accepts a Standard JSON Schema validator such as Zod, Valibot, or ArkType, or a literal JSON Schema.
+
+Prompt files interpolate explicitly supplied scalar values. Use named placeholders such as `{{ repository }}` in the file. Names must be identifiers; strings are inserted verbatim, while finite numbers, booleans, and `null` use their normal JSON scalar text. Every placeholder needs a supplied value, unused values are allowed, and malformed placeholders or unsupported values halt the workflow before Loopy contacts an agent or posts a question.
+
+Preserve the Temporal Service state, Loopy config, configured working directory, and each agent provider's session data while executions are open. A session ID stored in Temporal cannot reconstruct a deleted provider transcript or worktree.
+
+Use Temporal UI or CLI for execution inspection, Event History, cancellation, reset, termination, and Schedule administration. Use `loopy resolve` for a parked agent call and `loopy answer` for a workflow waiting on human input.

package/dist/adapters.d.ts

@@ -7,6 +7,8 @@ export interface HarnessContext {
     schema: JsonObject;
     /** Continue this provider session instead of starting a new one. */
     resumeSessionId?: string;
+    /** Persist a provider session as soon as it can outlive the current Activity. */
+    checkpointSession?(sessionId: string): void;
 }
 export interface HarnessResult {
     value: JsonValue;

package/dist/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"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"}

package/dist/adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAW5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAiD1F;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;CAAG;AAsEnD,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;QAC7E,QAAQ,EAAE,MAAM,CAAC,CAAC,wBAAwB,EAAE,kBAAkB,CAAC,CAAC;QAChE,QAAQ,EAAE,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;QACvC,iBAAiB,EAAE,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC;QACnD,QAAQ,EAAE,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAsC,MAAoB;IACvE,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAW5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAmD1F;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;CAAG;AAsEnD,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;QAC7E,QAAQ,EAAE,MAAM,CAAC,CAAC,wBAAwB,EAAE,kBAAkB,CAAC,CAAC;QAChE,QAAQ,EAAE,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;QACvC,iBAAiB,EAAE,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC;QACnD,QAAQ,EAAE,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAsC,MAAoB;IACvE,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/authoring/effect-config.d.ts

@@ -1,5 +1,5 @@
 import type { EffectConfig } from "../core/wire.js";
-import type { PromptFileRef } from "./types.js";
+import type { PromptFileRef, PromptTemplateValue } from "./types.js";
 export interface GitHubLabelsAction {
     /** The repository whose issue/PR labels change; use `ctx.trigger.repository` for the trigger. */
     repository: string;
@@ -12,5 +12,5 @@ export interface GitHubLabelsAction {
 }
 export declare function githubLabels(action: GitHubLabelsAction): EffectConfig;
 /** Reference a prompt file by a path relative to the configured project directory. */
-export declare function promptFile(path: string): PromptFileRef;
+export declare function promptFile(path: string, values?: Readonly<Record<string, PromptTemplateValue>>): PromptFileRef;
 //# sourceMappingURL=effect-config.d.ts.map

package/dist/authoring/effect-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effect-config.d.ts","sourceRoot":"","sources":["../../src/authoring/effect-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,iGAAiG;IACjG,UAAU,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,wGAAwG;IACxG,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAWrE;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAEtD"}
+{"version":3,"file":"effect-config.d.ts","sourceRoot":"","sources":["../../src/authoring/effect-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,iGAAiG;IACjG,UAAU,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,wGAAwG;IACxG,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAWrE;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,GACrD,aAAa,CAEf"}

package/dist/authoring/effect-config.js

@@ -11,7 +11,7 @@ export function githubLabels(action) {
     };
 }
 /** Reference a prompt file by a path relative to the configured project directory. */
-export function promptFile(path) {
-    return { file: path };
+export function promptFile(path, values) {
+    return values === undefined ? { file: path } : { file: path, values };
 }
 //# sourceMappingURL=effect-config.js.map

package/dist/authoring/effect-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"effect-config.js","sourceRoot":"","sources":["../../src/authoring/effect-config.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE;YACN,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;YAC5B,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YAClC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,KAAK;SACzC;KACF,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}
+{"version":3,"file":"effect-config.js","sourceRoot":"","sources":["../../src/authoring/effect-config.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE;YACN,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;YAC5B,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YAClC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,KAAK;SACzC;KACF,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,MAAsD;IAEtD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACxE,CAAC"}

package/dist/authoring/types.d.ts

@@ -1,6 +1,8 @@
 import type { Duration } from "@temporalio/common";
 import type { AttentionConfig, ChannelConfig, EffectConfig, HarnessConfig, JsonObject, JsonValue, ReadonlyJsonObject, TriggerCandidate } from "../core/wire.js";
+import type { PromptTemplateValues } from "../core/prompts.js";
 export type { AttentionConfig, ChannelConfig, EffectConfig, HarnessConfig } from "../core/wire.js";
+export type { PromptTemplateValue } from "../core/prompts.js";
 /** A watcher selector plus its match configuration, as produced by `src/authoring/watcher-config.ts`. */
 export interface WatcherDeclaration {
     name: string;
@@ -31,6 +33,7 @@ export type ChannelDeclaration = ChannelConfig;
 /** A prompt segment the agent Activity reads from disk; the isolate cannot touch the filesystem. */
 export interface PromptFileRef {
     readonly file: string;
+    readonly values?: PromptTemplateValues;
 }
 /**
  * The Standard JSON Schema surface loopy consumes: a validator that can render itself as a plain
@@ -93,6 +96,8 @@ export interface WorkflowContext {
     readonly workflowRunId: string;
     agent(id: string, harness: HarnessConfig): AgentHandle;
     effect(id: string, effect: EffectConfig): Promise<void>;
+    /** Replace the human-readable progress shown for this execution in Temporal UI and CLI. */
+    progress(details: string): void;
     /**
      * Ask a human a question over a configured channel and park until a reply arrives, returning the
      * answer as a string. The instance parks on a durable wait - no agent slot is held - and resumes

package/dist/authoring/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/authoring/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/authoring/types.ts"],"names":[],"mappings":"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"}

package/dist/cli-help.d.ts

@@ -1,23 +1,13 @@
-/**
- * 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. */
+/** Operator-facing guidance bundled with the CLI so it works without configuration, a Temporal connection, or network access. */
 export declare const TEMPORAL_SKILL_POINTER: string;
 export interface GuideTopic {
     readonly name: string;
     readonly summary: string;
     readonly body: string;
 }
-/** Ordered so `loopy guide` (no topic) lists them in the sequence an operator meets them. */
 export declare const GUIDE_TOPICS: readonly GuideTopic[];
 export declare function guideTopicNames(): string[];
 export declare function findGuideTopic(name: string): GuideTopic | undefined;
-/** `loopy guide` with no topic: the topic list plus the one external pointer loopy makes. */
 export declare function renderGuideIndex(): string;
-/** Appended after `loopy --help`: the playbook that points at the guide topics. */
 export declare function helpPlaybook(): string;
 //# sourceMappingURL=cli-help.d.ts.map

package/dist/cli-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wGAAwG;AACxG,eAAO,MAAM,sBAAsB,QAEmE,CAAC;AAEvG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAkJD,6FAA6F;AAC7F,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAAgC,CAAC;AAE/E,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEnE;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,IAAI,MAAM,CAazC;AAED,mFAAmF;AACnF,wBAAgB,YAAY,IAAI,MAAM,CAarC"}
+{"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAAA,iIAAiI;AAEjI,eAAO,MAAM,sBAAsB,QAEkF,CAAC;AAEtH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAiND,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAAiC,CAAC;AAEhF,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEnE;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAazC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAUrC"}