@aicalas/loopy 0.1.0

package/dist/build/discover.js.map

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

package/dist/build/identity.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hash normalized inputs — workflow sources plus the loopy runtime version — rather than bundle
+ * bytes, so moving the checkout or upgrading a transitive dependency does not strand in-flight
+ * instances, and reverting a workflow edit reproduces the original control Task Queue.
+ */
+export declare function buildIdentity(directory: string, runtimeVersion: string): string;
+/** Every file under the workflows directory, sorted, so the digest is path-order independent. */
+export declare function sourceFiles(directory: string): string[];
+//# sourceMappingURL=identity.d.ts.map

package/dist/build/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/build/identity.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAO/E;AAED,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAQvD"}

package/dist/build/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/build/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,cAAsB;IACrE,MAAM,KAAK,GAAG,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;AAC5D,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;aACrD,IAAI,KAAK,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/channels/github.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import type { ChannelAdapterSpec, ChannelDeliverContext, ChannelPollContext } from "../adapters.js";
+import type { ChannelPollResult, DeliverQuestionResult } from "../core/wire.js";
+import { GitHubClient } from "../github/client.js";
+export declare const gitHubCommentsOptionsSchema: z.ZodObject<{
+    repository: z.ZodString;
+    issue: z.ZodNumber;
+    credentials: z.ZodDefault<z.ZodLiteral<"env">>;
+}, z.core.$strict>;
+export type GitHubCommentsClientFactory = (repository: string, credentials: "env") => GitHubClient;
+export declare function deliverGitHubComment(context: ChannelDeliverContext, clientFactory?: GitHubCommentsClientFactory): Promise<DeliverQuestionResult>;
+export declare function pollGitHubComment(context: ChannelPollContext, clientFactory?: GitHubCommentsClientFactory): Promise<ChannelPollResult>;
+export declare const gitHubCommentsChannel: ChannelAdapterSpec;
+//# sourceMappingURL=github.d.ts.map

package/dist/channels/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/channels/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAa,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAA4B,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAYjG,eAAO,MAAM,2BAA2B;;;;kBAQ7B,CAAC;AAUZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,KAAK,YAAY,CAAC;AAInG,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,qBAAqB,EAC9B,aAAa,GAAE,2BAAkD,GAChE,OAAO,CAAC,qBAAqB,CAAC,CAwBhC;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,aAAa,GAAE,2BAAkD,GAChE,OAAO,CAAC,iBAAiB,CAAC,CAmB5B;AAgDD,eAAO,MAAM,qBAAqB,EAAE,kBAMnC,CAAC"}

package/dist/channels/github.js

@@ -0,0 +1,118 @@
+import { z } from "zod";
+import { authenticationDiagnostic, GitHubClient, REPOSITORY_PATTERN } from "../github/client.js";
+import { classifyGitHubWriteError } from "../github/writes.js";
+import { askMarker, askToken } from "../identifiers.js";
+/**
+ * The invisible marker family every comment loopy writes carries. `poll` treats a comment that
+ * carries no such marker as a human reply, so loopy's own question - and any attention comment - is
+ * excluded. GitHub's Quote reply strips HTML comments but keeps the visible token, so a quoted reply
+ * carries the token and drops the marker, and correlates as a human answer.
+ */
+const LOOPY_MARKER_PREFIX = "<!-- loopy:";
+export const gitHubCommentsOptionsSchema = z
+    .object({
+    repository: z.string().regex(REPOSITORY_PATTERN),
+    /** GitHub uses the Issues API for both issues and pull requests. */
+    issue: z.number().int().positive(),
+    // The one credential source today, declared by the port rather than inherited from the process.
+    credentials: z.literal("env").default("env"),
+})
+    .strict();
+const defaultClientFactory = (repository) => GitHubClient.fromEnvironment(repository);
+export async function deliverGitHubComment(context, clientFactory = defaultClientFactory) {
+    const options = gitHubCommentsOptionsSchema.parse(context.options);
+    const token = askToken(context.workflowId, context.callId);
+    const marker = askMarker(context.workflowId, context.callId);
+    const body = renderQuestion(marker, token, context.question);
+    try {
+        const client = clientFactory(options.repository, options.credentials);
+        // Timestamp-free marker: a retry recomputes the same marker, so read-before-write skips a
+        // re-post. GitHub createComment has no idempotency key, so a timed-out attempt and its retry can
+        // still both post - a documented residual window, not one claimed away.
+        const comments = await client.commentBodies(options.issue);
+        if (!comments.some((existing) => existing.includes(marker))) {
+            await client.createComment(options.issue, body);
+        }
+        const correlation = {
+            repository: options.repository,
+            issue: options.issue,
+            token,
+            credentials: options.credentials,
+        };
+        return { correlation: correlation, renderedQuestion: body };
+    }
+    catch (error) {
+        throw classifyGitHubWriteError(error);
+    }
+}
+export async function pollGitHubComment(context, clientFactory = defaultClientFactory) {
+    const correlation = parseCorrelation(context.correlation);
+    try {
+        const client = clientFactory(correlation.repository, correlation.credentials);
+        // `listComments` returns comments oldest-first (the API default), so the earliest match wins: the
+        // first comment that carries the token and no loopy marker is the human's reply. Once the call
+        // settles it leaves `awaiting_answer` and a later reply is never read - the first answer is final.
+        const comments = await client.commentBodies(correlation.issue);
+        const match = comments.find((body) => body.includes(correlation.token) && !body.includes(LOOPY_MARKER_PREFIX));
+        if (match === undefined)
+            return { status: "waiting" };
+        const answer = stripCorrelationFooter(match, correlation.token);
+        // A comment that is only the quoted footer, with no reply text of the human's own, is not yet an
+        // answer; keep waiting so the empty-answer rejection never fires against a token-only comment.
+        return answer.length === 0 ? { status: "waiting" } : { status: "answered", answer };
+    }
+    catch (error) {
+        throw classifyGitHubWriteError(error);
+    }
+}
+/**
+ * Drop loopy's correlation token from a reply before it reaches the agent, keeping the human's own
+ * markdown for the agent to interpret on resume. Only the `loopy: <token>` phrase (and any bare
+ * token) is removed, never the whole line - a human who keeps the token inline with their prose, as
+ * the footer instructs, would otherwise lose their answer. A reply that is nothing but the token
+ * strips to empty, which the caller treats as still-waiting rather than an answer.
+ */
+function stripCorrelationFooter(body, token) {
+    const phrase = new RegExp("`?\\s*loopy:\\s*" + token + "\\s*`?", "gi");
+    return body
+        .replace(phrase, "")
+        .replaceAll(token, "")
+        .split("\n")
+        .map((line) => line.replace(/[ \t]+$/, ""))
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+function renderQuestion(marker, token, question) {
+    return [
+        marker,
+        question,
+        "",
+        "---",
+        `<sub>loopy is waiting for an answer. Reply on this thread, or quote-reply, keeping \`loopy: ${token}\` in your comment so loopy can match it.</sub>`,
+    ].join("\n");
+}
+function parseCorrelation(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error("github comments correlation must be an object");
+    }
+    const { repository, issue, token, credentials } = value;
+    if (typeof repository !== "string" || typeof token !== "string") {
+        throw new Error("github comments correlation is missing repository or token");
+    }
+    if (typeof issue !== "number" || !Number.isInteger(issue)) {
+        throw new Error("github comments correlation is missing a numeric issue");
+    }
+    if (credentials !== "env") {
+        throw new Error("github comments correlation names an unsupported credential source");
+    }
+    return { repository, issue, token, credentials };
+}
+export const gitHubCommentsChannel = {
+    name: "github_comments",
+    optionsSchema: gitHubCommentsOptionsSchema,
+    deliver: (context) => deliverGitHubComment(context),
+    poll: (context) => pollGitHubComment(context),
+    checkStartup: authenticationDiagnostic,
+};
+//# sourceMappingURL=github.js.map

package/dist/channels/github.js.map

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

package/dist/channels/index.d.ts

@@ -0,0 +1,2 @@
+export { gitHubCommentsChannel } from "./github.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/channels/index.js

@@ -0,0 +1,2 @@
+export { gitHubCommentsChannel } from "./github.js";
+//# sourceMappingURL=index.js.map

package/dist/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/cli-help.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 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

@@ -0,0 +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;AAgJD,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"}

package/dist/cli-help.js

@@ -0,0 +1,186 @@
+/**
+ * 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";
+const SETUP = {
+    name: "setup",
+    summary: "config.toml and pointing loopy at a Temporal Service (local, self-hosted, or Cloud)",
+    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.",
+    ].join("\n"),
+};
+const WORKFLOWS = {
+    name: "workflows",
+    summary: "create, register, and change workflows",
+    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.",
+        "",
+        "Create",
+        "  One file under the workflows/ directory defines one workflow:",
+        "",
+        "    import { claude, defineWorkflow, githubAttention, githubPullRequests }",
+        '      from "@aicalas/loopy/workflow";',
+        "",
+        "    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."] });',
+        "      },",
+        "    });",
+        "",
+        "  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).",
+    ].join("\n"),
+};
+const MONITOR = {
+    name: "monitor",
+    summary: "inspect instances with loopy status and act on the ones needing a human",
+    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_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.",
+    ].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 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.",
+        "",
+        "Topics:",
+        rows,
+        "",
+        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     Reconcile a call that ended ambiguously (or --halt).",
+        '  loopy answer <id> "<text>"      Answer an instance parked on ctx.ask.',
+        "",
+        "  To deploy a workflow change: edit files, then restart loopy loop.",
+        "",
+        "Guidance (offline, no config): loopy guide <" + guideTopicNames().join("|") + ">",
+        "  or run  loopy guide  for the topic list.",
+    ].join("\n");
+}
+//# sourceMappingURL=cli-help.js.map

package/dist/cli-help.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+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;
+    connectClient: typeof connectClient;
+    createWorkerRuntime: typeof createWorkerRuntime;
+    discoverWorkflows: typeof discoverWorkflows;
+    buildWorkflowBundle: typeof buildWorkflowBundle;
+}
+export interface ResolveOptions {
+    action: ResolveRequest["action"];
+    callId?: string;
+}
+export interface AnswerOptions {
+    answer: string;
+    callId?: string;
+}
+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

@@ -0,0 +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"}