@aicalas/loopy 0.1.0

package/dist/emitters/index.js

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

package/dist/emitters/index.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,17 @@
+import { type SimpleGit } from "simple-git";
+export declare const REMOTE = "origin";
+export declare function cloneUrl(repository: string): string;
+export declare function ensureRepo(workingDirectory: string, url: string): Promise<RepoOps>;
+export declare class RepoOps {
+    readonly root: string;
+    readonly remote: string;
+    private readonly git;
+    private provisionTail;
+    constructor(root: string, remote?: string, git?: SimpleGit);
+    fetchBranch(branch: string): Promise<boolean>;
+    provisionWorkspace(path: string, localBranch: string, targetBranch: string, baseBranch: string): Promise<void>;
+    cleanupWorkspaces(path: string): Promise<string[]>;
+    private provisionWorkspaceUnlocked;
+    private cleanupWorkspacesUnlocked;
+}
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,YAAY,CAAC;AAIvD,eAAO,MAAM,MAAM,WAAW,CAAC;AAE/B,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAsB,UAAU,CAAC,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQxF;AAED,qBAAa,OAAO;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,aAAa,CAAoC;IAEzD,YAAY,IAAI,EAAE,MAAM,EAAE,MAAM,SAAS,EAAE,GAAG,CAAC,EAAE,SAAS,EAIzD;IAEK,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAclD;IAED,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAMf;IAED,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASjD;YAEa,0BAA0B;YAuB1B,yBAAyB;CAgBxC"}

package/dist/git.js

@@ -0,0 +1,122 @@
+import { existsSync } from "node:fs";
+import { mkdir, rm } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { simpleGit } from "simple-git";
+import { log } from "./log.js";
+export const REMOTE = "origin";
+export function cloneUrl(repository) {
+    return `https://github.com/${repository}.git`;
+}
+export async function ensureRepo(workingDirectory, url) {
+    const repoDirectory = join(workingDirectory, "repo");
+    if (!existsSync(join(repoDirectory, ".git"))) {
+        await mkdir(workingDirectory, { recursive: true });
+        log.info(`cloning ${url} into ${repoDirectory}`);
+        await simpleGit().clone(url, repoDirectory);
+    }
+    return new RepoOps(repoDirectory, REMOTE);
+}
+export class RepoOps {
+    root;
+    remote;
+    git;
+    provisionTail = Promise.resolve();
+    constructor(root, remote = REMOTE, git) {
+        this.root = root;
+        this.remote = remote;
+        this.git = git ?? simpleGit(root);
+    }
+    async fetchBranch(branch) {
+        try {
+            await this.git.raw([
+                "fetch",
+                "--force",
+                "--quiet",
+                this.remote,
+                `refs/heads/${branch}:refs/remotes/${this.remote}/${branch}`,
+            ]);
+            return true;
+        }
+        catch (error) {
+            if (errorText(error).toLowerCase().includes("couldn't find remote ref"))
+                return false;
+            throw error;
+        }
+    }
+    provisionWorkspace(path, localBranch, targetBranch, baseBranch) {
+        const operation = this.provisionTail
+            .catch(() => undefined)
+            .then(() => this.provisionWorkspaceUnlocked(path, localBranch, targetBranch, baseBranch));
+        this.provisionTail = operation.catch(() => undefined);
+        return operation;
+    }
+    cleanupWorkspaces(path) {
+        let removed = [];
+        const operation = this.provisionTail
+            .catch(() => undefined)
+            .then(async () => {
+            removed = await this.cleanupWorkspacesUnlocked(path);
+        });
+        this.provisionTail = operation.catch(() => undefined);
+        return operation.then(() => removed);
+    }
+    async provisionWorkspaceUnlocked(path, localBranch, targetBranch, baseBranch) {
+        if (existsSync(join(path, ".git")))
+            return;
+        const targetExists = await this.fetchBranch(targetBranch);
+        if (!targetExists && !(await this.fetchBranch(baseBranch))) {
+            throw new Error(`neither target branch ${JSON.stringify(targetBranch)} nor base branch ${JSON.stringify(baseBranch)} exists`);
+        }
+        const startBranch = targetExists ? targetBranch : baseBranch;
+        const start = `refs/remotes/${this.remote}/${startBranch}`;
+        await mkdir(dirname(path), { recursive: true });
+        const branches = await this.git.branchLocal();
+        if (branches.all.includes(localBranch)) {
+            await this.git.raw(["branch", "-D", localBranch]);
+        }
+        await this.git.raw(["worktree", "add", "--quiet", "-b", localBranch, path, start]);
+    }
+    async cleanupWorkspacesUnlocked(path) {
+        const root = resolve(path);
+        const records = parseWorktrees(await this.git.raw(["worktree", "list", "--porcelain"]));
+        const selected = records.filter(({ path: candidate }) => {
+            const offset = relative(root, resolve(candidate));
+            return offset === "" || (!offset.startsWith("..") && !offset.startsWith("/"));
+        });
+        for (const worktree of selected) {
+            await this.git.raw(["worktree", "remove", "--force", worktree.path]);
+            if (worktree.branch !== undefined) {
+                await this.git.raw(["branch", "-D", worktree.branch]);
+            }
+        }
+        await rm(root, { recursive: true, force: true });
+        return selected.map((worktree) => worktree.path).sort();
+    }
+}
+function parseWorktrees(value) {
+    return value
+        .trim()
+        .split("\n\n")
+        .filter(Boolean)
+        .map((block) => {
+        const fields = new Map(block.split("\n").map((line) => {
+            const separator = line.indexOf(" ");
+            return separator < 0 ? [line, ""] : [line.slice(0, separator), line.slice(separator + 1)];
+        }));
+        const path = fields.get("worktree");
+        if (path === undefined)
+            throw new Error("git worktree record lacks a path");
+        const rawBranch = fields.get("branch");
+        const record = { path };
+        if (rawBranch?.startsWith("refs/heads/"))
+            record.branch = rawBranch.slice("refs/heads/".length);
+        return record;
+    });
+}
+function errorText(error) {
+    if (!(error instanceof Error))
+        return String(error);
+    const details = error;
+    return `${error.message}\n${details.stderr ?? ""}\n${details.stdout ?? ""}`;
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/github/client.d.ts

@@ -0,0 +1,53 @@
+import { Octokit } from "octokit";
+import type { JsonObject, JsonValue } from "../core/wire.js";
+export interface PullInfo extends JsonObject {
+    number: number;
+    head_ref: string;
+    head_sha: string;
+    base_ref: string;
+    html_url: string;
+    labels: string[];
+    title: string;
+    body: string;
+}
+export interface IssueInfo extends JsonObject {
+    number: number;
+    title: string;
+    body: string;
+    html_url: string;
+    labels: string[];
+}
+/** `owner/name`: the shape every GitHub port validates a declared repository against. */
+export declare const REPOSITORY_PATTERN: RegExp;
+export declare class GitHubAuthenticationError extends Error {
+}
+/** Named so a wrapped provider failure identifies itself in logs and retry classification. */
+export declare class GitHubUnavailableError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare function authenticationDiagnostic(environment?: NodeJS.ProcessEnv): string | undefined;
+export declare class GitHubClient {
+    private readonly octokit;
+    private readonly owner;
+    private readonly repo;
+    readonly repository: string;
+    constructor(token: string, repository: string, octokit?: Octokit);
+    static fromEnvironment(repository: string, environment?: NodeJS.ProcessEnv): GitHubClient;
+    openPullsWithLabel(label: string): Promise<PullInfo[]>;
+    openIssuesWithLabel(label: string): Promise<IssueInfo[]>;
+    getPull(number: number): Promise<PullInfo>;
+    labels(number: number): Promise<string[]>;
+    commentBodies(number: number): Promise<string[]>;
+    createComment(number: number, body: string): Promise<void>;
+    setLabels(number: number, labels: readonly string[]): Promise<void>;
+    /**
+     * Create the repository-level label if it is absent. Issue-label writes require the label to
+     * exist in the repository first; creation answers 422 `already_exists` for a label that does,
+     * which is this method's success case. The inputs are fixed application constants, so no other
+     * validation failure shares that status here.
+     */
+    ensureLabel(name: string, color: string, description: string): Promise<void>;
+    private request;
+}
+export declare function asJsonValue(value: unknown): JsonValue;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/github/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,QAAuB,CAAC;AAEvD,qBAAa,yBAA0B,SAAQ,KAAK;CAAG;AAEvD,8FAA8F;AAC9F,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,wBAAgB,wBAAwB,CAEtC,WAAW,GAAE,MAAM,CAAC,UAAwB,GAC3C,MAAM,GAAG,SAAS,CAIpB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,YAAY,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAS/D;IAED,MAAM,CAAC,eAAe,CACpB,UAAU,EAAE,MAAM,EAElB,WAAW,GAAE,MAAM,CAAC,UAAwB,GAC3C,YAAY,CAQd;IAEK,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAe3D;IAEK,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAmB7D;IAEK,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAe/C;IAEK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAU9C;IAEK,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUrD;IAEK,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS/D;IAEK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CASxE;IAED;;;;;OAKG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAejF;YAEa,OAAO;CAOtB;AAeD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAErD"}

package/dist/github/client.js

@@ -0,0 +1,169 @@
+import { Octokit } from "octokit";
+/** `owner/name`: the shape every GitHub port validates a declared repository against. */
+export const REPOSITORY_PATTERN = /^[^/\s]+\/[^/\s]+$/;
+export class GitHubAuthenticationError extends Error {
+}
+/** Named so a wrapped provider failure identifies itself in logs and retry classification. */
+export class GitHubUnavailableError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+export function authenticationDiagnostic(
+/* istanbul ignore next -- production environment boundary */
+environment = process.env) {
+    return environment.GITHUB_TOKEN || environment.GH_TOKEN
+        ? undefined
+        : "set GITHUB_TOKEN or GH_TOKEN to authenticate with GitHub";
+}
+export class GitHubClient {
+    octokit;
+    owner;
+    repo;
+    repository;
+    constructor(token, repository, octokit) {
+        this.repository = repository;
+        this.octokit = octokit ?? new Octokit({ auth: token });
+        const separator = repository.indexOf("/");
+        if (separator <= 0 || separator === repository.length - 1) {
+            throw new Error(`invalid GitHub repository: ${repository}`);
+        }
+        this.owner = repository.slice(0, separator);
+        this.repo = repository.slice(separator + 1);
+    }
+    static fromEnvironment(repository, 
+    /* istanbul ignore next -- production environment boundary */
+    environment = process.env) {
+        const token = environment.GITHUB_TOKEN || environment.GH_TOKEN;
+        if (!token) {
+            throw new GitHubAuthenticationError("set GITHUB_TOKEN or GH_TOKEN to authenticate with GitHub");
+        }
+        return new GitHubClient(token, repository);
+    }
+    async openPullsWithLabel(label) {
+        const issues = await this.request(`list pulls labelled ${JSON.stringify(label)}`, () => this.octokit.paginate(this.octokit.rest.issues.listForRepo, {
+            owner: this.owner,
+            repo: this.repo,
+            labels: label,
+            state: "open",
+            per_page: 100,
+        }));
+        const pulls = [];
+        for (const issue of issues) {
+            if (issue.pull_request !== undefined)
+                pulls.push(await this.getPull(issue.number));
+        }
+        return pulls;
+    }
+    async openIssuesWithLabel(label) {
+        const issues = await this.request(`list issues labelled ${JSON.stringify(label)}`, () => this.octokit.paginate(this.octokit.rest.issues.listForRepo, {
+            owner: this.owner,
+            repo: this.repo,
+            labels: label,
+            state: "open",
+            per_page: 100,
+        }));
+        return issues
+            .filter((issue) => issue.pull_request === undefined)
+            .map((issue) => ({
+            number: issue.number,
+            title: issue.title ?? "",
+            body: issue.body ?? "",
+            html_url: issue.html_url,
+            labels: issue.labels.map(labelName),
+        }));
+    }
+    async getPull(number) {
+        const response = await this.request(`get pull #${number}`, () => this.octokit.rest.pulls.get({ owner: this.owner, repo: this.repo, pull_number: number }));
+        const pull = response.data;
+        return {
+            number: pull.number,
+            head_ref: pull.head.ref,
+            head_sha: pull.head.sha,
+            base_ref: pull.base.ref,
+            html_url: pull.html_url,
+            labels: pull.labels.map(labelName),
+            title: pull.title ?? "",
+            body: pull.body ?? "",
+        };
+    }
+    async labels(number) {
+        const response = await this.request(`get labels for #${number}`, () => this.octokit.rest.issues.listLabelsOnIssue({
+            owner: this.owner,
+            repo: this.repo,
+            issue_number: number,
+            per_page: 100,
+        }));
+        return response.data.map(labelName);
+    }
+    async commentBodies(number) {
+        const comments = await this.request(`list comments for #${number}`, () => this.octokit.paginate(this.octokit.rest.issues.listComments, {
+            owner: this.owner,
+            repo: this.repo,
+            issue_number: number,
+            per_page: 100,
+        }));
+        return comments.map((comment) => comment.body ?? "");
+    }
+    async createComment(number, body) {
+        await this.request(`comment on #${number}`, () => this.octokit.rest.issues.createComment({
+            owner: this.owner,
+            repo: this.repo,
+            issue_number: number,
+            body,
+        }));
+    }
+    async setLabels(number, labels) {
+        await this.request(`set labels for #${number}`, () => this.octokit.rest.issues.setLabels({
+            owner: this.owner,
+            repo: this.repo,
+            issue_number: number,
+            labels: [...labels],
+        }));
+    }
+    /**
+     * Create the repository-level label if it is absent. Issue-label writes require the label to
+     * exist in the repository first; creation answers 422 `already_exists` for a label that does,
+     * which is this method's success case. The inputs are fixed application constants, so no other
+     * validation failure shares that status here.
+     */
+    async ensureLabel(name, color, description) {
+        try {
+            await this.request(`create label ${JSON.stringify(name)}`, () => this.octokit.rest.issues.createLabel({
+                owner: this.owner,
+                repo: this.repo,
+                name,
+                color,
+                description,
+            }));
+        }
+        catch (error) {
+            if (error instanceof GitHubUnavailableError && causeStatus(error) === 422)
+                return;
+            throw error;
+        }
+    }
+    async request(what, operation) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            throw new GitHubUnavailableError(`${what}: ${errorMessage(error)}`, { cause: error });
+        }
+    }
+}
+function causeStatus(error) {
+    const status = error.cause?.status;
+    return typeof status === "number" ? status : undefined;
+}
+function labelName(label) {
+    return typeof label === "string" ? label : (label.name ?? "");
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function asJsonValue(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+//# sourceMappingURL=client.js.map

package/dist/github/client.js.map

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

package/dist/github/trigger.d.ts

@@ -0,0 +1,12 @@
+import type { TriggerCandidate } from "../core/wire.js";
+/**
+ * The issue/PR number a GitHub trigger identifies. `data.number` is the authoritative form the
+ * GitHub watchers record; the string id is the fallback. Throws on a trigger that names no positive
+ * integer, so a misconfiguration fails loudly rather than shipping `NaN` into a port's `issue`
+ * input. Pure and isolate-safe: the GitHub authoring configs and the Node-side GitHub adapters
+ * share it, and the engine core never learns the convention.
+ */
+export declare function gitHubTriggerNumber(trigger: TriggerCandidate): number;
+/** Ensure a trigger is GitHub-shaped before extracting its issue or pull-request number. */
+export declare function triggerNumber(trigger: TriggerCandidate): number;
+//# sourceMappingURL=trigger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../src/github/trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAMrE;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAG/D"}

package/dist/github/trigger.js

@@ -0,0 +1,21 @@
+/**
+ * The issue/PR number a GitHub trigger identifies. `data.number` is the authoritative form the
+ * GitHub watchers record; the string id is the fallback. Throws on a trigger that names no positive
+ * integer, so a misconfiguration fails loudly rather than shipping `NaN` into a port's `issue`
+ * input. Pure and isolate-safe: the GitHub authoring configs and the Node-side GitHub adapters
+ * share it, and the engine core never learns the convention.
+ */
+export function gitHubTriggerNumber(trigger) {
+    const value = trigger.data.number ?? Number(trigger.id);
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
+        throw new Error(`trigger names no issue number: ${JSON.stringify(trigger.id)}`);
+    }
+    return value;
+}
+/** Ensure a trigger is GitHub-shaped before extracting its issue or pull-request number. */
+export function triggerNumber(trigger) {
+    if (trigger.source !== "github")
+        throw new Error("GitHub adapter requires a GitHub trigger");
+    return gitHubTriggerNumber(trigger);
+}
+//# sourceMappingURL=trigger.js.map

package/dist/github/trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.js","sourceRoot":"","sources":["../../src/github/trigger.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAyB;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,aAAa,CAAC,OAAyB;IACrD,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC7F,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/github/writes.d.ts

@@ -0,0 +1,4 @@
+/** Classify GitHub adapter write failures into retryable and permanent outcomes. */
+export declare function classifyGitHubWriteError(error: unknown): unknown;
+export declare function sameLabels(current: readonly string[], desired: readonly string[]): boolean;
+//# sourceMappingURL=writes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../src/github/writes.ts"],"names":[],"mappings":"AAMA,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYhE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAK1F"}

package/dist/github/writes.js

@@ -0,0 +1,21 @@
+import { EmitterPermanentError } from "../adapters.js";
+import { GitHubAuthenticationError, GitHubUnavailableError } from "./client.js";
+/** HTTP statuses that say the write can never succeed as issued: the target is gone or invalid. */
+const PERMANENT_STATUSES = new Set([404, 410, 422]);
+/** Classify GitHub adapter write failures into retryable and permanent outcomes. */
+export function classifyGitHubWriteError(error) {
+    if (error instanceof GitHubAuthenticationError)
+        return error;
+    if (error instanceof GitHubUnavailableError) {
+        const status = error.cause?.status;
+        return typeof status === "number" && PERMANENT_STATUSES.has(status)
+            ? new EmitterPermanentError(error.message, { cause: error })
+            : error;
+    }
+    return new EmitterPermanentError(error instanceof Error ? error.message : String(error), error instanceof Error ? { cause: error } : {});
+}
+export function sameLabels(current, desired) {
+    return (current.length === desired.length &&
+        [...current].sort().every((label, index) => label === desired[index]));
+}
+//# sourceMappingURL=writes.js.map

package/dist/github/writes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes.js","sourceRoot":"","sources":["../../src/github/writes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEhF,mGAAmG;AACnG,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAEzE,oFAAoF;AACpF,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,KAAK,YAAY,yBAAyB;QAAE,OAAO,KAAK,CAAC;IAC7D,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAI,KAAK,CAAC,KAA0C,EAAE,MAAM,CAAC;QACzE,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC;YACjE,CAAC,CAAC,IAAI,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC5D,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,qBAAqB,CAC9B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACtD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA0B,EAAE,OAA0B;IAC/E,OAAO,CACL,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;QACjC,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC"}

package/dist/harnesses/base.d.ts

@@ -0,0 +1,41 @@
+import type { Harness, HarnessContext, HarnessResult } from "../adapters.js";
+import { type JsonObject, type JsonValue } from "../core/wire.js";
+export declare const CLEANUP_TIMEOUT_MS = 10000;
+export interface AdapterTurn {
+    text?: string;
+    payload?: unknown;
+    sessionId?: string;
+    usage?: JsonObject;
+}
+export interface Adapter {
+    /** The provider session this adapter is speaking to, once the provider has minted one. */
+    readonly sessionId: string | undefined;
+    start(prompt: string, schema: JsonObject, signal?: AbortSignal): Promise<AdapterTurn>;
+    continue(prompt: string, schema: JsonObject, signal?: AbortSignal): Promise<AdapterTurn>;
+    interrupt(): Promise<void>;
+    close(): Promise<void>;
+}
+export declare class HarnessError extends Error {
+    readonly diagnostic: string;
+    usage: JsonObject | undefined;
+    sessionId: string | undefined;
+    constructor(diagnostic: string, options?: {
+        usage?: JsonObject;
+        sessionId?: string;
+        cause?: unknown;
+    });
+}
+export declare class ProviderError extends HarnessError {
+}
+export declare class OutcomeError extends HarnessError {
+}
+export declare abstract class ValidatingHarness implements Harness {
+    protected abstract createAdapter(context: HarnessContext): Adapter;
+    run(context: HarnessContext, signal?: AbortSignal): Promise<HarnessResult>;
+}
+export declare function validateTurn(turn: AdapterTurn, schema: JsonObject): JsonValue;
+export declare function mergeUsage(left: JsonObject | undefined, right: JsonObject | undefined): JsonObject | undefined;
+export declare function jsonObject(value: unknown, label: string): JsonObject | undefined;
+export declare function isAbortError(error: unknown): error is DOMException;
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=base.d.ts.map

package/dist/harnesses/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/harnesses/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAe,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG/E,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzF,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9B,YACE,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,UAAU,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,EAO1E;CACF;AAED,qBAAa,aAAc,SAAQ,YAAY;CAAG;AAClD,qBAAa,YAAa,SAAQ,YAAY;CAAG;AAEjD,8BAAsB,iBAAkB,YAAW,OAAO;IACxD,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IAE7D,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAsC/E;CACF;AAWD,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CA0B7E;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,KAAK,EAAE,UAAU,GAAG,SAAS,GAC5B,UAAU,GAAG,SAAS,CAexB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAYhF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAElE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD"}