@aicalas/loopy 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shyam-sadeesh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# 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.
+
+Design: [`ARCHITECTURE.md`](ARCHITECTURE.md). Operating it: `loopy guide`.
+
+## Install
+
+Needs Node.js 24 and `git`.
+
+```bash
+npm install --global @aicalas/loopy
+```
+
+That installs the `loopy` command on your PATH.
+
+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.
+
+## Run
+
+```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.
+
+## Workflows
+
+One file under `workflows/` is one workflow. No spec language, no register step: discovery is registration. Abridged from [`workflows/review.ts`](workflows/review.ts):
+
+```ts
+export default defineWorkflow({
+  name: "review",
+  watcher: githubPullRequests({
+    repository: "owner/repo",
+    label: "agent:review",
+    onStart: { add: ["agent:reviewing"] },
+  }),
+  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}`],
+    });
+    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],
+      });
+    }
+    await ctx.effect(
+      "mark-reviewed",
+      githubLabels({
+        repository: ctx.trigger.repository,
+        issue: triggerIssue(ctx.trigger),
+        remove: ["agent:reviewing"],
+        add: ["agent:reviewed"],
+      }),
+    );
+    return { summary: outcome.summary };
+  },
+});
+```
+
+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.
+
+## 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"`.
+
+```ts
+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 };
+  },
+});
+```
+
+`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.
+
+## 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.
+
+| 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.

package/dist/adapters.d.ts

@@ -0,0 +1,111 @@
+import type { ZodType } from "zod";
+import type { AttentionEmitResult, AttentionEvent, ChannelPollResult, DeliverQuestionResult, EffectResult, JsonObject, JsonValue, TriggerCandidate } from "./core/wire.js";
+export interface HarnessContext {
+    agentId: string;
+    prompt: string;
+    workspace: string;
+    schema: JsonObject;
+    /** Continue this provider session instead of starting a new one. */
+    resumeSessionId?: string;
+}
+export interface HarnessResult {
+    value: JsonValue;
+    sessionId?: string;
+    usage?: JsonObject;
+}
+export interface Harness {
+    run(context: HarnessContext, signal?: AbortSignal): Promise<HarnessResult>;
+}
+export interface HarnessSpec {
+    readonly name: string;
+    readonly optionsSchema: ZodType;
+    create(options: unknown): Harness;
+    checkStartup?(): string | undefined | Promise<string | undefined>;
+}
+export interface FetchContext {
+    /** The watcher reads its target repository from its own `options`, not from ambient context. */
+    options: unknown;
+}
+/** A source-local match; the Activity stamps the registered source and identity digest before persistence. */
+export type WatcherCandidate = Omit<TriggerCandidate, "source" | "digest">;
+export interface WatcherSpec {
+    readonly name: string;
+    readonly source: string;
+    readonly optionsSchema: ZodType;
+    fetch(context: FetchContext): Promise<WatcherCandidate[]>;
+    checkStartup?(): string | undefined | Promise<string | undefined>;
+}
+export interface EmitterContext {
+    /** Every input the emitter needs - repository, target, credential-source, and payload - is declared here. */
+    action: unknown;
+}
+/**
+ * A failure no retry can fix: the target is gone or the request is invalid as issued. An emitter
+ * throws this to fail its Activity Execution non-retryably; any other exception is retried under
+ * the Activity's policy, because a human can usually make it succeed.
+ */
+export declare class EmitterPermanentError extends Error {
+}
+export interface EmitterSpec {
+    readonly name: string;
+    readonly actionSchema: ZodType;
+    emit(context: EmitterContext): Promise<EffectResult>;
+    checkStartup?(): string | undefined | Promise<string | undefined>;
+}
+export interface AttentionEmitterContext {
+    /** The adapter's declared route and credentials; the adapter validates and resolves them. */
+    options: unknown;
+    trigger: TriggerCandidate;
+    event: AttentionEvent;
+}
+/**
+ * Surfaces engine-owned attention events - human-actionable workflow states - to an external
+ * channel. Separate from `EmitterSpec` because attention emission is operational reporting the
+ * engine decides on, not a workflow-authored effect: it takes a normalized event, must be safe to
+ * re-emit (`skipped` says the event is already surfaced), and is never addressed by user code.
+ *
+ * The engine selects the adapter and passes its declaration, trigger, and normalized event once.
+ * The adapter owns validation and destination resolution, so the engine never handles an
+ * adapter-specific target or relies on paired adapter methods.
+ */
+export interface AttentionEmitterSpec {
+    readonly name: string;
+    readonly optionsSchema: ZodType;
+    emit(context: AttentionEmitterContext): Promise<AttentionEmitResult>;
+    checkStartup?(): string | undefined | Promise<string | undefined>;
+}
+export interface ChannelDeliverContext {
+    /** The adapter's declared inputs (repository, issue, credentials); the adapter validates them. */
+    options: unknown;
+    /** Identity of the asking instance and call; the adapter derives its reply token and dedup marker from these. */
+    workflowId: string;
+    callId: string;
+    /** The rendered prompt text; the adapter composes the human-facing question around it. */
+    question: string;
+}
+export interface ChannelPollContext {
+    /** The adapter-owned correlation `deliver` returned; only the adapter decodes it. */
+    correlation: JsonValue;
+}
+/**
+ * One channel a workflow can ask a human over. The adapter owns both outbound operations - `deliver`
+ * sends the question and returns opaque correlation, `poll` reads a reply back - so no channel needs
+ * an inbound route into loopy. It is configured explicitly (its repository, target, and credentials
+ * are its own declared inputs, populated by the author from `ctx`) and reads nothing ambient.
+ */
+export interface ChannelAdapterSpec {
+    readonly name: string;
+    readonly optionsSchema: ZodType;
+    deliver(context: ChannelDeliverContext): Promise<DeliverQuestionResult>;
+    poll(context: ChannelPollContext): Promise<ChannelPollResult>;
+    checkStartup?(): string | undefined | Promise<string | undefined>;
+}
+export interface AdapterRegistries {
+    readonly harnesses: ReadonlyMap<string, HarnessSpec>;
+    readonly watchers: ReadonlyMap<string, WatcherSpec>;
+    readonly emitters: ReadonlyMap<string, EmitterSpec>;
+    readonly attentionEmitters: ReadonlyMap<string, AttentionEmitterSpec>;
+    readonly channels: ReadonlyMap<string, ChannelAdapterSpec>;
+}
+export declare function createAdapterRegistries(): AdapterRegistries;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

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

package/dist/adapters.js

@@ -0,0 +1,27 @@
+import { gitHubAttentionEmitter } from "./attention/github.js";
+import { gitHubCommentsChannel } from "./channels/index.js";
+import { gitHubLabelsEmitter } from "./emitters/github.js";
+import { claudeHarnessSpec } from "./harnesses/claude.js";
+import { codexHarnessSpec } from "./harnesses/codex.js";
+import { openCodeHarnessSpec } from "./harnesses/opencode.js";
+import { gitHubIssueWatcher, gitHubPullRequestWatcher } from "./watchers/github/index.js";
+/**
+ * A failure no retry can fix: the target is gone or the request is invalid as issued. An emitter
+ * throws this to fail its Activity Execution non-retryably; any other exception is retried under
+ * the Activity's policy, because a human can usually make it succeed.
+ */
+export class EmitterPermanentError extends Error {
+}
+export function createAdapterRegistries() {
+    return {
+        harnesses: byName([claudeHarnessSpec, codexHarnessSpec, openCodeHarnessSpec]),
+        watchers: byName([gitHubPullRequestWatcher, gitHubIssueWatcher]),
+        emitters: byName([gitHubLabelsEmitter]),
+        attentionEmitters: byName([gitHubAttentionEmitter]),
+        channels: byName([gitHubCommentsChannel]),
+    };
+}
+function byName(values) {
+    return new Map(values.map((value) => [value.name, value]));
+}
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

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

package/dist/attention/github.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import type { AttentionEmitterContext, AttentionEmitterSpec } from "../adapters.js";
+import type { AttentionEmitResult, AttentionEvent, AttentionKind, TriggerCandidate } from "../core/wire.js";
+import { GitHubClient } from "../github/client.js";
+/**
+ * The kinds this adapter renders an artifact for. `awaiting_answer` is deliberately excluded: the
+ * ask's own question comment is the human-facing surface, so no label and no attention comment go on
+ * the target. The attention *event* still fires, so an off-GitHub route can still ping on it.
+ */
+type SurfacedAttentionKind = Exclude<AttentionKind, "awaiting_answer">;
+/** The label family this adapter owns when a destination opts into state labels. */
+export declare const ATTENTION_LABELS: Readonly<Record<SurfacedAttentionKind, string>>;
+/**
+ * The concrete destination an emit writes to, resolved from the declared route. `labels` is true
+ * only when this is the trigger's own surface, which a fixed aggregation sink never is.
+ */
+export interface ResolvedAttentionTarget {
+    repository: string;
+    issue: number;
+    labels: boolean;
+    credentials: "env";
+}
+export type GitHubAttentionClientFactory = (repository: string, credentials: "env") => GitHubClient;
+/**
+ * The declared route: `trigger` follows the instance's own trigger, `fixed` names an aggregation
+ * issue. `labels` applies only to the trigger route, so the union rejects it on the fixed one, and
+ * the credential source is declared rather than inherited from the process.
+ */
+export declare const gitHubAttentionOptionsSchema: z.ZodUnion<readonly [z.ZodObject<{
+    target: z.ZodLiteral<"trigger">;
+    labels: z.ZodDefault<z.ZodBoolean>;
+    credentials: z.ZodDefault<z.ZodLiteral<"env">>;
+}, z.core.$strict>, z.ZodObject<{
+    target: z.ZodLiteral<"fixed">;
+    repository: z.ZodString;
+    issue: z.ZodNumber;
+    credentials: z.ZodDefault<z.ZodLiteral<"env">>;
+}, z.core.$strict>]>;
+/**
+ * Resolve the declared route against the instance's trigger: the trigger is passed in explicitly
+ * and only its repository and issue number survive into the concrete target, which is all `emit`
+ * ever sees.
+ */
+export declare function resolveGitHubAttentionTarget(options: unknown, trigger: TriggerCandidate): ResolvedAttentionTarget;
+export declare function emitGitHubAttention(context: AttentionEmitterContext, clientFactory?: GitHubAttentionClientFactory): Promise<AttentionEmitResult>;
+/**
+ * Deduplication key rendered as an invisible HTML comment: a matching marker on any existing
+ * comment means this event is already surfaced. `stuck` is level-triggered - the observer
+ * re-reports the same condition every poll tick with a fresh timestamp - so its key drops
+ * `occurredAt` and one stuck Run gets one comment. The other kinds are edge-triggered, emitted once
+ * per event with a timestamp that is stable across Activity retries, so `occurredAt` stays in the
+ * key and each re-park of one call is surfaced as the new event it is.
+ */
+export declare function attentionMarker(event: AttentionEvent): string;
+export declare const gitHubAttentionEmitter: AttentionEmitterSpec;
+export {};
+//# sourceMappingURL=github.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/attention/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAA4B,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAKjG;;;;GAIG;AACH,KAAK,qBAAqB,GAAG,OAAO,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;AAEvE,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAI5E,CAAC;AAuBF;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,KAAK,CAAC;CACpB;AAED,MAAM,MAAM,4BAA4B,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,KAAK,YAAY,CAAC;AAIpG;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;oBAgBvC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,GACxB,uBAAuB,CAsBzB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,uBAAuB,EAChC,aAAa,GAAE,4BAAmD,GACjE,OAAO,CAAC,mBAAmB,CAAC,CA6B9B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAU7D;AA6BD,eAAO,MAAM,sBAAsB,EAAE,oBAKpC,CAAC"}

package/dist/attention/github.js

@@ -0,0 +1,162 @@
+import { z } from "zod";
+import { authenticationDiagnostic, GitHubClient, REPOSITORY_PATTERN } from "../github/client.js";
+import { triggerNumber } from "../github/trigger.js";
+import { classifyGitHubWriteError, sameLabels } from "../github/writes.js";
+import { sha256 } from "../identifiers.js";
+/** The label family this adapter owns when a destination opts into state labels. */
+export const ATTENTION_LABELS = {
+    halted: "loopy:halted",
+    awaiting_reconciliation: "loopy:awaiting-reconciliation",
+    stuck: "loopy:stuck",
+};
+/** Repository-level label definitions, provisioned on first use rather than expected as setup. */
+const LABEL_STYLES = {
+    halted: { color: "b60205", description: "loopy: an expected failure closed this instance" },
+    awaiting_reconciliation: {
+        color: "fbca04",
+        description: "loopy: parked on an ambiguous agent call; operator resolution needed",
+    },
+    stuck: { color: "d93f0b", description: "loopy: workflow code is failing Workflow Tasks" },
+};
+const KIND_EXPLANATIONS = {
+    halted: "An expected operation failure closed this instance and cleanup ran. Read the reason, fix the cause, and start it again from its source trigger.",
+    awaiting_reconciliation: "An agent call ended ambiguously (worker loss, heartbeat timeout). The instance is parked and healthy. Retry only once the prior call can no longer mutate external state, or halt to close the instance.",
+    stuck: "The workflow code is failing every Workflow Task, so the instance cannot report itself. Fix the workflow code and restart `loopy loop`; the instance resumes against its intact history.",
+};
+const defaultClientFactory = (repository) => GitHubClient.fromEnvironment(repository);
+/**
+ * The declared route: `trigger` follows the instance's own trigger, `fixed` names an aggregation
+ * issue. `labels` applies only to the trigger route, so the union rejects it on the fixed one, and
+ * the credential source is declared rather than inherited from the process.
+ */
+export const gitHubAttentionOptionsSchema = z.union([
+    z
+        .object({
+        target: z.literal("trigger"),
+        labels: z.boolean().default(true),
+        credentials: z.literal("env").default("env"),
+    })
+        .strict(),
+    z
+        .object({
+        target: z.literal("fixed"),
+        repository: z.string().regex(REPOSITORY_PATTERN),
+        issue: z.number().int().positive(),
+        credentials: z.literal("env").default("env"),
+    })
+        .strict(),
+]);
+/**
+ * Resolve the declared route against the instance's trigger: the trigger is passed in explicitly
+ * and only its repository and issue number survive into the concrete target, which is all `emit`
+ * ever sees.
+ */
+export function resolveGitHubAttentionTarget(options, trigger) {
+    const parsed = gitHubAttentionOptionsSchema.parse(options);
+    if (parsed.target === "fixed") {
+        return {
+            repository: parsed.repository,
+            issue: parsed.issue,
+            labels: false,
+            credentials: parsed.credentials,
+        };
+    }
+    try {
+        return {
+            repository: trigger.repository,
+            issue: triggerNumber(trigger),
+            labels: parsed.labels,
+            credentials: parsed.credentials,
+        };
+    }
+    catch (error) {
+        // A trigger-following route on a non-GitHub trigger is a deterministic misconfiguration, so it
+        // fails the same permanent way a vanished target does rather than retrying identically forever.
+        throw classifyGitHubWriteError(error);
+    }
+}
+export async function emitGitHubAttention(context, clientFactory = defaultClientFactory) {
+    const kind = context.event.kind;
+    // The ask's question comment is its surface; loopy adds no artifact of its own on the target.
+    if (kind === "awaiting_answer")
+        return { status: "skipped" };
+    const target = resolveGitHubAttentionTarget(context.options, context.trigger);
+    try {
+        const client = clientFactory(target.repository, target.credentials);
+        const marker = attentionMarker(context.event);
+        const comments = await client.commentBodies(target.issue);
+        if (comments.some((body) => body.includes(marker)))
+            return { status: "skipped" };
+        if (target.labels) {
+            const current = await client.labels(target.issue);
+            const desired = new Set(current);
+            for (const label of Object.values(ATTENTION_LABELS))
+                desired.delete(label);
+            const kindLabel = ATTENTION_LABELS[kind];
+            desired.add(kindLabel);
+            const labels = [...desired].sort();
+            if (!sameLabels(current, labels)) {
+                // setLabels only attaches labels that already exist in the repository, so provision first.
+                const style = LABEL_STYLES[kind];
+                await client.ensureLabel(kindLabel, style.color, style.description);
+                await client.setLabels(target.issue, labels);
+            }
+        }
+        await client.createComment(target.issue, renderComment(marker, context.event, kind));
+        return { status: "emitted" };
+    }
+    catch (error) {
+        throw classifyGitHubWriteError(error);
+    }
+}
+/**
+ * Deduplication key rendered as an invisible HTML comment: a matching marker on any existing
+ * comment means this event is already surfaced. `stuck` is level-triggered - the observer
+ * re-reports the same condition every poll tick with a fresh timestamp - so its key drops
+ * `occurredAt` and one stuck Run gets one comment. The other kinds are edge-triggered, emitted once
+ * per event with a timestamp that is stable across Activity retries, so `occurredAt` stays in the
+ * key and each re-park of one call is surfaced as the new event it is.
+ */
+export function attentionMarker(event) {
+    const occurrence = event.kind === "stuck" ? "" : event.occurredAt;
+    const key = [
+        event.kind,
+        event.workflowId,
+        event.runId ?? "",
+        event.callAddress ?? "",
+        occurrence,
+    ].join("\0");
+    return `<!-- loopy:attention:${sha256(key)} -->`;
+}
+function renderComment(marker, event, kind) {
+    const lines = [
+        marker,
+        `### loopy needs attention: \`${kind}\``,
+        "",
+        KIND_EXPLANATIONS[kind],
+        "",
+        `**Workflow:** \`${event.workflowName}\``,
+        `**Instance:** \`${event.workflowId}\`${event.runId === undefined ? "" : ` (run \`${event.runId}\`)`}`,
+        `**Trigger:** \`${event.triggerRef}\``,
+    ];
+    if (event.callAddress !== undefined)
+        lines.push(`**Call:** \`${event.callAddress}\``);
+    lines.push("**Reason:**", "```text", event.reason, "```");
+    if (event.cleanup !== undefined) {
+        lines.push(event.cleanup.status === "completed"
+            ? `**Cleanup:** completed (${event.cleanup.removed.length} path(s) removed)`
+            : `**Cleanup:** failed - ${event.cleanup.reason}`);
+    }
+    if (event.suggestedCommands.length > 0) {
+        lines.push("**Next steps:**", "```bash", ...event.suggestedCommands, "```");
+    }
+    lines.push("", `<sub>reported at ${event.occurredAt}</sub>`);
+    return lines.join("\n");
+}
+export const gitHubAttentionEmitter = {
+    name: "github",
+    optionsSchema: gitHubAttentionOptionsSchema,
+    emit: emitGitHubAttention,
+    checkStartup: authenticationDiagnostic,
+};
+//# sourceMappingURL=github.js.map

package/dist/attention/github.js.map

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

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

@@ -0,0 +1,16 @@
+import type { AttentionDeclaration } from "./types.js";
+export type GitHubAttentionOptions = {
+    /** Follow the instance's own trigger: surface on the issue or PR that started it. */
+    target: "trigger";
+    /** Whether to converge the trigger's attention label; defaults to true. */
+    labels?: boolean;
+    credentials?: "env";
+} | {
+    /** A fixed aggregation issue; comments-only, so unrelated instance states never share a label. */
+    repository: string;
+    /** GitHub uses the Issues API for both issues and pull requests. */
+    issue: number;
+    credentials?: "env";
+};
+export declare function githubAttention(options: GitHubAttentionOptions): AttentionDeclaration;
+//# sourceMappingURL=attention-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attention-config.d.ts","sourceRoot":"","sources":["../../src/authoring/attention-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,MAAM,sBAAsB,GAC9B;IACE,qFAAqF;IACrF,MAAM,EAAE,SAAS,CAAC;IAClB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,GACD;IACE,kGAAkG;IAClG,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,CAAC;AAEN,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,oBAAoB,CAiBrF"}

package/dist/authoring/attention-config.js

@@ -0,0 +1,19 @@
+export function githubAttention(options) {
+    const credentials = options.credentials ?? "env";
+    if ("target" in options) {
+        return {
+            emitter: "github",
+            options: { target: "trigger", labels: options.labels ?? true, credentials },
+        };
+    }
+    return {
+        emitter: "github",
+        options: {
+            target: "fixed",
+            repository: options.repository,
+            issue: options.issue,
+            credentials,
+        },
+    };
+}
+//# sourceMappingURL=attention-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attention-config.js","sourceRoot":"","sources":["../../src/authoring/attention-config.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;IACjD,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE,WAAW,EAAE;SAC5E,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE;YACP,MAAM,EAAE,OAAO;YACf,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW;SACZ;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { ChannelDeclaration } from "./types.js";
+export interface GitHubCommentsOptions {
+    /** The repository whose issue/PR the question is posted on; use `ctx.repository` or a fixed one. */
+    repository: string;
+    /** The issue or pull-request number to ask on; `triggerIssue(ctx.trigger)` for the trigger's own thread. */
+    issue: number;
+    /** Credential source; `"env"` is the only one today and the default, declared rather than inherited. */
+    credentials?: "env";
+}
+/**
+ * Ask over GitHub issue comments. The port reads nothing ambient - its repository and issue are its
+ * own declared inputs, populated by the author from `ctx` (e.g. `issue: triggerIssue(ctx.trigger)`)
+ * - so several asks can share one issue and each is bound to its own reply by a run-scoped token.
+ */
+export declare function githubComments(options: GitHubCommentsOptions): ChannelDeclaration;
+//# sourceMappingURL=channel-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-config.d.ts","sourceRoot":"","sources":["../../src/authoring/channel-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,oGAAoG;IACpG,UAAU,EAAE,MAAM,CAAC;IACnB,4GAA4G;IAC5G,KAAK,EAAE,MAAM,CAAC;IACd,wGAAwG;IACxG,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,kBAAkB,CASjF"}

package/dist/authoring/channel-config.js

@@ -0,0 +1,16 @@
+/**
+ * Ask over GitHub issue comments. The port reads nothing ambient - its repository and issue are its
+ * own declared inputs, populated by the author from `ctx` (e.g. `issue: triggerIssue(ctx.trigger)`)
+ * - so several asks can share one issue and each is bound to its own reply by a run-scoped token.
+ */
+export function githubComments(options) {
+    return {
+        channel: "github_comments",
+        options: {
+            repository: options.repository,
+            issue: options.issue,
+            credentials: options.credentials ?? "env",
+        },
+    };
+}
+//# sourceMappingURL=channel-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-config.js","sourceRoot":"","sources":["../../src/authoring/channel-config.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,OAAO;QACL,OAAO,EAAE,iBAAiB;QAC1B,OAAO,EAAE;YACP,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK;SAC1C;KACF,CAAC;AACJ,CAAC"}

package/dist/authoring/define.d.ts

@@ -0,0 +1,13 @@
+import type { InstanceResult, JsonValue } from "../core/wire.js";
+import type { WorkflowDefinition } from "./types.js";
+export interface WorkflowFunction {
+    (input: unknown): Promise<InstanceResult>;
+    readonly definition: WorkflowDefinition<JsonValue>;
+}
+/**
+ * Wrap a user `run` function as a supervised Temporal Workflow Definition. Discovery reads
+ * `definition` under plain Node to synchronize Schedules; the bundled copy is what the isolate
+ * executes, so the module must be safe to import twice.
+ */
+export declare function defineWorkflow<R extends JsonValue>(definition: WorkflowDefinition<R>): WorkflowFunction;
+//# sourceMappingURL=define.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/authoring/define.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;CACpD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAChD,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAChC,gBAAgB,CAIlB"}

package/dist/authoring/define.js

@@ -0,0 +1,13 @@
+import { assertIdentifier } from "../core/calls.js";
+import { runSupervised } from "../temporal/supervisor.js";
+/**
+ * Wrap a user `run` function as a supervised Temporal Workflow Definition. Discovery reads
+ * `definition` under plain Node to synchronize Schedules; the bundled copy is what the isolate
+ * executes, so the module must be safe to import twice.
+ */
+export function defineWorkflow(definition) {
+    assertIdentifier("workflow", definition.name);
+    const workflow = (input) => runSupervised(definition, input);
+    return Object.assign(workflow, { definition: definition });
+}
+//# sourceMappingURL=define.js.map

package/dist/authoring/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/authoring/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ1D;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAiC;IAEjC,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,CAAC,KAAc,EAA2B,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC/F,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,UAA2C,EAAE,CAAC,CAAC;AAC9F,CAAC"}