@cursor/july 0.1.1

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

@@ -0,0 +1,52 @@
+/**
+ * GitHub webhook channel pack for agent-serve (Eve-compatible dispatch).
+ *
+ * ```ts
+ * import { defaultGitHubAuth, githubChannel } from "@anysphere/agent-serve/channels/github";
+ *
+ * export default githubChannel({
+ *   botName: "my-agent",
+ *   // API auth: App installation (preferred) → GITHUB_TOKEN / GH_TOKEN → `gh auth`
+ *   credentials: { webhookSecret: () => process.env.GITHUB_WEBHOOK_SECRET },
+ *   onComment: (ctx, comment) => ({ auth: defaultGitHubAuth(ctx) }),
+ *   onPullRequest: (ctx, pr) =>
+ *     pr.action === "opened" ? { auth: defaultGitHubAuth(ctx) } : null,
+ *   onCheckSuite: (ctx, suite) =>
+ *     suite.conclusion === "failure" && suite.pullRequests.length > 0
+ *       ? { auth: defaultGitHubAuth(ctx) }
+ *       : null,
+ *   // Legacy commit statuses
+ *   onStatus: (ctx, status) =>
+ *     status.state === "failure"
+ *       ? {
+ *           task: () =>
+ *             ctx.github.createStatus({
+ *               sha: status.sha,
+ *               state: "pending",
+ *               context: "agent/triage",
+ *             }),
+ *         }
+ *       : null,
+ *   // Catch-all for other webhook events
+ *   onEvent: (ctx, event) =>
+ *     event.eventName === "label" ? { auth: defaultGitHubAuth(ctx) } : null,
+ * });
+ * ```
+ *
+ * Inbound hooks receive `ctx.github` (`getOctokit`, `request`, `createStatus`)
+ * and `ctx.thread` (`post`, `react`). Prefer typed Octokit methods via
+ * `await ctx.github.getOctokit()` for new code. Without `onPullRequest`,
+ * agent-serve keeps a backward-compatible default gate (opened / reopened /
+ * synchronize / ready_for_review). Eve itself is opt-in for that hook.
+ */
+export * from "./api.js";
+export * from "./auth.js";
+export * from "./binding.js";
+export * from "./defaults.js";
+export * from "./events.js";
+export * from "./forward.js";
+export * from "./github-channel.js";
+export * from "./replay.js";
+export * from "./state.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/github/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/channels/github/index.js

@@ -0,0 +1,51 @@
+/**
+ * GitHub webhook channel pack for agent-serve (Eve-compatible dispatch).
+ *
+ * ```ts
+ * import { defaultGitHubAuth, githubChannel } from "@anysphere/agent-serve/channels/github";
+ *
+ * export default githubChannel({
+ *   botName: "my-agent",
+ *   // API auth: App installation (preferred) → GITHUB_TOKEN / GH_TOKEN → `gh auth`
+ *   credentials: { webhookSecret: () => process.env.GITHUB_WEBHOOK_SECRET },
+ *   onComment: (ctx, comment) => ({ auth: defaultGitHubAuth(ctx) }),
+ *   onPullRequest: (ctx, pr) =>
+ *     pr.action === "opened" ? { auth: defaultGitHubAuth(ctx) } : null,
+ *   onCheckSuite: (ctx, suite) =>
+ *     suite.conclusion === "failure" && suite.pullRequests.length > 0
+ *       ? { auth: defaultGitHubAuth(ctx) }
+ *       : null,
+ *   // Legacy commit statuses
+ *   onStatus: (ctx, status) =>
+ *     status.state === "failure"
+ *       ? {
+ *           task: () =>
+ *             ctx.github.createStatus({
+ *               sha: status.sha,
+ *               state: "pending",
+ *               context: "agent/triage",
+ *             }),
+ *         }
+ *       : null,
+ *   // Catch-all for other webhook events
+ *   onEvent: (ctx, event) =>
+ *     event.eventName === "label" ? { auth: defaultGitHubAuth(ctx) } : null,
+ * });
+ * ```
+ *
+ * Inbound hooks receive `ctx.github` (`getOctokit`, `request`, `createStatus`)
+ * and `ctx.thread` (`post`, `react`). Prefer typed Octokit methods via
+ * `await ctx.github.getOctokit()` for new code. Without `onPullRequest`,
+ * agent-serve keeps a backward-compatible default gate (opened / reopened /
+ * synchronize / ready_for_review). Eve itself is opt-in for that hook.
+ */
+export * from "./api.js";
+export * from "./auth.js";
+export * from "./binding.js";
+export * from "./defaults.js";
+export * from "./events.js";
+export * from "./forward.js";
+export * from "./github-channel.js";
+export * from "./replay.js";
+export * from "./state.js";
+export * from "./types.js";

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

@@ -0,0 +1,115 @@
+/**
+ * Synthesize GitHub webhook payloads from data you can *read* about a PR, so
+ * `agent-serve github replay` can exercise a `githubChannel()` without repo
+ * admin, without the `gh webhook forward` relay, and deterministically (great
+ * for hillclimbing).
+ *
+ * Payloads are shaped to satisfy the channel's parsers (see `github-channel.ts`);
+ * `undefined` fields are dropped by `JSON.stringify` before delivery.
+ */
+/** A parsed PR reference. */
+export interface GitHubPrRef {
+    owner: string;
+    repo: string;
+    number: number;
+    /** `https://github.com/owner/repo/pull/N`. */
+    url: string;
+    /** `owner/repo#N`. */
+    label: string;
+}
+/** Parse a PR URL or `owner/repo#N`. Returns undefined when neither matches. */
+export declare function parseGitHubPrRef(raw: string): GitHubPrRef | undefined;
+export interface ReplayRepo {
+    id?: number;
+    name?: string;
+    full_name: string;
+    html_url: string;
+    default_branch?: string;
+    owner?: {
+        login?: string;
+    };
+}
+export interface ReplayUser {
+    login: string;
+    id?: number;
+    type?: string;
+}
+export interface ReplayPull {
+    number: number;
+    html_url: string;
+    title: string;
+    body?: string | null;
+    draft?: boolean;
+    merged?: boolean;
+    user?: ReplayUser | null;
+    head: {
+        ref: string;
+        sha: string;
+        repo?: {
+            id?: number;
+            name?: string;
+        };
+    };
+    base: {
+        ref: string;
+        sha?: string;
+    };
+}
+/** Optional real CI check to mirror (app slug / name / conclusion). */
+export interface ReplayCheck {
+    id?: number;
+    name?: string;
+    conclusion?: string | null;
+    app?: {
+        slug?: string;
+        name?: string;
+    } | null;
+}
+/** Webhook events replay knows how to synthesize. */
+export declare const SYNTHESIZABLE_EVENTS: readonly ["pull_request", "issue_comment", "pull_request_review_comment", "check_run", "check_suite", "workflow_run", "status"];
+export type SynthesizableEvent = (typeof SYNTHESIZABLE_EVENTS)[number];
+export declare function isSynthesizableEvent(event: string): event is SynthesizableEvent;
+export interface SynthesizeInput {
+    event: string;
+    repo: ReplayRepo;
+    pull: ReplayPull;
+    /** Actor on the delivery (defaults to the PR author for PR/comment events). */
+    sender?: ReplayUser;
+    /** Override the event action (e.g. `opened`, `synchronize`). */
+    action?: string;
+    /** CI conclusion for check_run/check_suite/workflow_run (default `failure`). */
+    conclusion?: string;
+    /** Commit-status state (default derived from conclusion, else `failure`). */
+    state?: string;
+    /** Commit-status context (default `buildkite/build`). */
+    context?: string;
+    /** Comment body for issue_comment / review comment (required for those). */
+    comment?: string;
+    /** Real check to mirror (app slug / conclusion) for CI events. */
+    check?: ReplayCheck;
+}
+export interface SynthesizedEvent {
+    eventName: string;
+    action?: string;
+    payload: Record<string, unknown>;
+}
+export type SynthesizeResult = SynthesizedEvent | {
+    error: string;
+};
+/** Build a webhook payload for `input.event` from the PR data. */
+export declare function synthesizeGitHubEvent(input: SynthesizeInput): SynthesizeResult;
+/** Hex HMAC-SHA256 for the `X-Hub-Signature-256` header (`sha256=<hex>`). */
+export declare function signGitHubWebhookBody(options: {
+    secret: string;
+    body: string | Buffer;
+}): string;
+/**
+ * Resolve the events to replay: explicit list (validated), `*` → the channel's
+ * declared events intersected with what replay can synthesize, or the default
+ * (`pull_request`).
+ */
+export declare function selectReplayEvents(requested: readonly string[] | undefined, channelEvents: readonly string[]): {
+    events: string[];
+    unsupported: string[];
+};
+//# sourceMappingURL=replay.d.ts.map

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

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

package/dist/channels/github/replay.js

@@ -0,0 +1,282 @@
+/**
+ * Synthesize GitHub webhook payloads from data you can *read* about a PR, so
+ * `agent-serve github replay` can exercise a `githubChannel()` without repo
+ * admin, without the `gh webhook forward` relay, and deterministically (great
+ * for hillclimbing).
+ *
+ * Payloads are shaped to satisfy the channel's parsers (see `github-channel.ts`);
+ * `undefined` fields are dropped by `JSON.stringify` before delivery.
+ */
+import { createHmac } from "node:crypto";
+/** Parse a PR URL or `owner/repo#N`. Returns undefined when neither matches. */
+export function parseGitHubPrRef(raw) {
+    const text = raw.trim();
+    const url = text.match(/https?:\/\/(?:www\.)?github\.com\/([\w.-]+)\/([\w.-]+)\/pull\/(\d+)/i);
+    const hash = url !== null && url !== void 0 ? url : text.match(/^([\w.-]+)\/([\w.-]+)#(\d+)$/);
+    if (hash === null) {
+        return undefined;
+    }
+    const owner = hash[1];
+    const repo = hash[2];
+    const number = Number(hash[3]);
+    return {
+        owner,
+        repo,
+        number,
+        url: `https://github.com/${owner}/${repo}/pull/${number}`,
+        label: `${owner}/${repo}#${number}`,
+    };
+}
+/** Webhook events replay knows how to synthesize. */
+export const SYNTHESIZABLE_EVENTS = [
+    "pull_request",
+    "issue_comment",
+    "pull_request_review_comment",
+    "check_run",
+    "check_suite",
+    "workflow_run",
+    "status",
+];
+export function isSynthesizableEvent(event) {
+    return SYNTHESIZABLE_EVENTS.includes(event);
+}
+/** Build a webhook payload for `input.event` from the PR data. */
+export function synthesizeGitHubEvent(input) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    var _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6;
+    const { repo, pull } = input;
+    const author = (_h = pull.user) !== null && _h !== void 0 ? _h : undefined;
+    const actor = (_k = (_j = input.sender) !== null && _j !== void 0 ? _j : author) !== null && _k !== void 0 ? _k : { login: "agent-serve-replay" };
+    const repository = repoPayload(repo);
+    const apiPrUrl = `https://api.github.com/repos/${repo.full_name}/pulls/${pull.number}`;
+    const prRefs = [
+        { number: pull.number, url: apiPrUrl, html_url: pull.html_url },
+    ];
+    switch (input.event) {
+        case "pull_request":
+            return {
+                eventName: "pull_request",
+                action: (_l = input.action) !== null && _l !== void 0 ? _l : "synchronize",
+                payload: {
+                    action: (_m = input.action) !== null && _m !== void 0 ? _m : "synchronize",
+                    number: pull.number,
+                    repository,
+                    sender: userPayload(actor),
+                    pull_request: pullRequestPayload(pull, author),
+                },
+            };
+        case "issue_comment": {
+            if (input.comment === undefined || input.comment === "") {
+                return { error: "issue_comment needs --comment" };
+            }
+            const id = commentId(pull.number, 1);
+            return {
+                eventName: "issue_comment",
+                action: "created",
+                payload: {
+                    action: "created",
+                    repository,
+                    sender: userPayload(actor),
+                    issue: {
+                        number: pull.number,
+                        html_url: pull.html_url,
+                        pull_request: { url: apiPrUrl, html_url: pull.html_url },
+                    },
+                    comment: {
+                        id,
+                        body: input.comment,
+                        html_url: `${pull.html_url}#issuecomment-${id}`,
+                        user: userPayload(actor),
+                    },
+                },
+            };
+        }
+        case "pull_request_review_comment": {
+            if (input.comment === undefined || input.comment === "") {
+                return { error: "pull_request_review_comment needs --comment" };
+            }
+            const id = commentId(pull.number, 2);
+            return {
+                eventName: "pull_request_review_comment",
+                action: "created",
+                payload: {
+                    action: "created",
+                    repository,
+                    sender: userPayload(actor),
+                    pull_request: { number: pull.number, html_url: pull.html_url },
+                    comment: {
+                        id,
+                        body: input.comment,
+                        html_url: `${pull.html_url}#discussion_r${id}`,
+                        path: "README.md",
+                        line: 1,
+                        user: userPayload(actor),
+                    },
+                },
+            };
+        }
+        case "check_run":
+            return {
+                eventName: "check_run",
+                action: (_o = input.action) !== null && _o !== void 0 ? _o : "completed",
+                payload: {
+                    action: (_p = input.action) !== null && _p !== void 0 ? _p : "completed",
+                    repository,
+                    sender: ciSender(input.check),
+                    check_run: {
+                        id: (_q = (_a = input.check) === null || _a === void 0 ? void 0 : _a.id) !== null && _q !== void 0 ? _q : commentId(pull.number, 3),
+                        name: (_r = (_b = input.check) === null || _b === void 0 ? void 0 : _b.name) !== null && _r !== void 0 ? _r : "ci",
+                        head_sha: pull.head.sha,
+                        status: "completed",
+                        conclusion: (_t = (_s = input.conclusion) !== null && _s !== void 0 ? _s : (_c = input.check) === null || _c === void 0 ? void 0 : _c.conclusion) !== null && _t !== void 0 ? _t : "failure",
+                        app: ciApp(input.check),
+                        check_suite: { id: commentId(pull.number, 4) },
+                        pull_requests: prRefs,
+                    },
+                },
+            };
+        case "check_suite":
+            return {
+                eventName: "check_suite",
+                action: (_u = input.action) !== null && _u !== void 0 ? _u : "completed",
+                payload: {
+                    action: (_v = input.action) !== null && _v !== void 0 ? _v : "completed",
+                    repository,
+                    sender: ciSender(input.check),
+                    check_suite: {
+                        id: (_w = (_d = input.check) === null || _d === void 0 ? void 0 : _d.id) !== null && _w !== void 0 ? _w : commentId(pull.number, 4),
+                        head_sha: pull.head.sha,
+                        status: "completed",
+                        conclusion: (_y = (_x = input.conclusion) !== null && _x !== void 0 ? _x : (_e = input.check) === null || _e === void 0 ? void 0 : _e.conclusion) !== null && _y !== void 0 ? _y : "failure",
+                        app: ciApp(input.check),
+                        pull_requests: prRefs,
+                    },
+                },
+            };
+        case "workflow_run":
+            return {
+                eventName: "workflow_run",
+                action: (_z = input.action) !== null && _z !== void 0 ? _z : "completed",
+                payload: {
+                    action: (_0 = input.action) !== null && _0 !== void 0 ? _0 : "completed",
+                    repository,
+                    sender: ciSender(input.check),
+                    workflow_run: {
+                        id: (_1 = (_f = input.check) === null || _f === void 0 ? void 0 : _f.id) !== null && _1 !== void 0 ? _1 : commentId(pull.number, 5),
+                        name: (_2 = (_g = input.check) === null || _g === void 0 ? void 0 : _g.name) !== null && _2 !== void 0 ? _2 : "CI",
+                        head_sha: pull.head.sha,
+                        status: "completed",
+                        conclusion: (_3 = input.conclusion) !== null && _3 !== void 0 ? _3 : "failure",
+                        pull_requests: prRefs,
+                    },
+                },
+            };
+        case "status": {
+            const state = (_5 = (_4 = input.state) !== null && _4 !== void 0 ? _4 : input.conclusion) !== null && _5 !== void 0 ? _5 : "failure";
+            return {
+                eventName: "status",
+                payload: {
+                    state,
+                    sha: pull.head.sha,
+                    context: (_6 = input.context) !== null && _6 !== void 0 ? _6 : "buildkite/build",
+                    description: `Replayed ${state} status`,
+                    target_url: null,
+                    repository,
+                    sender: ciSender(input.check),
+                    branches: [{ name: pull.head.ref, commit: { sha: pull.head.sha } }],
+                    commit: { sha: pull.head.sha, html_url: pull.html_url },
+                    pull_requests: prRefs,
+                },
+            };
+        }
+        default:
+            return { error: `cannot synthesize unsupported event: ${input.event}` };
+    }
+}
+/** Hex HMAC-SHA256 for the `X-Hub-Signature-256` header (`sha256=<hex>`). */
+export function signGitHubWebhookBody(options) {
+    return createHmac("sha256", options.secret)
+        .update(options.body)
+        .digest("hex");
+}
+/**
+ * Resolve the events to replay: explicit list (validated), `*` → the channel's
+ * declared events intersected with what replay can synthesize, or the default
+ * (`pull_request`).
+ */
+export function selectReplayEvents(requested, channelEvents) {
+    if (requested === undefined || requested.length === 0) {
+        return { events: ["pull_request"], unsupported: [] };
+    }
+    if (requested.length === 1 && requested[0] === "*") {
+        const events = channelEvents.filter(isSynthesizableEvent);
+        return {
+            events: events.length > 0 ? events : ["pull_request"],
+            unsupported: [],
+        };
+    }
+    const events = [];
+    const unsupported = [];
+    for (const event of requested) {
+        if (isSynthesizableEvent(event)) {
+            events.push(event);
+        }
+        else {
+            unsupported.push(event);
+        }
+    }
+    return { events, unsupported };
+}
+function repoPayload(repo) {
+    var _a;
+    var _b, _c;
+    const [ownerFromName, nameFromFull] = repo.full_name.split("/");
+    return {
+        id: repo.id,
+        name: (_b = repo.name) !== null && _b !== void 0 ? _b : nameFromFull,
+        full_name: repo.full_name,
+        html_url: repo.html_url,
+        default_branch: repo.default_branch,
+        owner: { login: (_c = (_a = repo.owner) === null || _a === void 0 ? void 0 : _a.login) !== null && _c !== void 0 ? _c : ownerFromName },
+    };
+}
+function pullRequestPayload(pull, author) {
+    var _a, _b, _c;
+    return {
+        number: pull.number,
+        html_url: pull.html_url,
+        title: pull.title,
+        body: (_a = pull.body) !== null && _a !== void 0 ? _a : null,
+        draft: (_b = pull.draft) !== null && _b !== void 0 ? _b : false,
+        merged: (_c = pull.merged) !== null && _c !== void 0 ? _c : false,
+        user: author === undefined ? undefined : userPayload(author),
+        head: {
+            ref: pull.head.ref,
+            sha: pull.head.sha,
+            repo: pull.head.repo,
+        },
+        base: { ref: pull.base.ref, sha: pull.base.sha },
+    };
+}
+function userPayload(user) {
+    var _a;
+    return { login: user.login, id: user.id, type: (_a = user.type) !== null && _a !== void 0 ? _a : "User" };
+}
+function ciSender(check) {
+    var _a;
+    const slug = (_a = check === null || check === void 0 ? void 0 : check.app) === null || _a === void 0 ? void 0 : _a.slug;
+    const login = slug === undefined ? "github-actions[bot]" : `${slug}[bot]`;
+    return { login, type: "Bot" };
+}
+function ciApp(check) {
+    var _a, _b;
+    var _c, _d;
+    return {
+        slug: (_c = (_a = check === null || check === void 0 ? void 0 : check.app) === null || _a === void 0 ? void 0 : _a.slug) !== null && _c !== void 0 ? _c : "github-actions",
+        name: (_d = (_b = check === null || check === void 0 ? void 0 : check.app) === null || _b === void 0 ? void 0 : _b.name) !== null && _d !== void 0 ? _d : "GitHub Actions",
+    };
+}
+/** Stable, PR-scoped synthetic id so re-runs are reproducible. */
+function commentId(prNumber, kind) {
+    return prNumber * 100 + kind;
+}

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

@@ -0,0 +1,26 @@
+/**
+ * Durable per-session GitHub channel state.
+ */
+import type { GitHubBindingState } from "./binding.js";
+import type { GitHubConversationKind } from "./types.js";
+export interface GitHubChannelState extends GitHubBindingState {
+    deliveryId: string | null;
+    eventName: string | null;
+    headSha: string | null;
+    baseRef: string | null;
+    headRef: string | null;
+}
+export declare function emptyGitHubChannelState(overrides?: Partial<GitHubChannelState>): GitHubChannelState;
+/** Build binding fields for an inbound conversation. */
+export declare function githubBindingStateForEvent(input: {
+    kind: GitHubConversationKind;
+    owner: string;
+    repo: string;
+    number: number;
+    repositoryId?: number;
+    installationId?: number;
+    triggeringCommentId?: number;
+    reviewCommentId?: number;
+    reviewThreadRootCommentId?: number;
+}): GitHubBindingState;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/channels/github/state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAC1C,kBAAkB,CAmBpB;AAED,wDAAwD;AACxD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,GAAG,kBAAkB,CA6CrB"}

package/dist/channels/github/state.js

@@ -0,0 +1,50 @@
+/**
+ * Durable per-session GitHub channel state.
+ */
+export function emptyGitHubChannelState(overrides = {}) {
+    return Object.assign({ conversationKind: "pull_request", installationId: null, issueNumber: null, owner: "", pullRequestNumber: null, repo: "", repositoryId: null, reviewCommentId: null, reviewThreadRootCommentId: null, triggeringCommentId: null, deliveryId: null, eventName: null, headSha: null, baseRef: null, headRef: null }, overrides);
+}
+/** Build binding fields for an inbound conversation. */
+export function githubBindingStateForEvent(input) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+    if (input.kind === "issue") {
+        return {
+            conversationKind: "issue",
+            installationId: (_a = input.installationId) !== null && _a !== void 0 ? _a : null,
+            issueNumber: input.number,
+            owner: input.owner,
+            pullRequestNumber: null,
+            repo: input.repo,
+            repositoryId: (_b = input.repositoryId) !== null && _b !== void 0 ? _b : null,
+            reviewCommentId: null,
+            reviewThreadRootCommentId: null,
+            triggeringCommentId: (_c = input.triggeringCommentId) !== null && _c !== void 0 ? _c : null,
+        };
+    }
+    if (input.kind === "review_thread") {
+        return {
+            conversationKind: "review_thread",
+            installationId: (_d = input.installationId) !== null && _d !== void 0 ? _d : null,
+            issueNumber: null,
+            owner: input.owner,
+            pullRequestNumber: input.number,
+            repo: input.repo,
+            repositoryId: (_e = input.repositoryId) !== null && _e !== void 0 ? _e : null,
+            reviewCommentId: (_f = input.reviewCommentId) !== null && _f !== void 0 ? _f : null,
+            reviewThreadRootCommentId: (_j = (_h = (_g = input.reviewThreadRootCommentId) !== null && _g !== void 0 ? _g : input.reviewCommentId) !== null && _h !== void 0 ? _h : input.triggeringCommentId) !== null && _j !== void 0 ? _j : null,
+            triggeringCommentId: (_k = input.triggeringCommentId) !== null && _k !== void 0 ? _k : null,
+        };
+    }
+    return {
+        conversationKind: "pull_request",
+        installationId: (_l = input.installationId) !== null && _l !== void 0 ? _l : null,
+        issueNumber: null,
+        owner: input.owner,
+        pullRequestNumber: input.number,
+        repo: input.repo,
+        repositoryId: (_m = input.repositoryId) !== null && _m !== void 0 ? _m : null,
+        reviewCommentId: null,
+        reviewThreadRootCommentId: null,
+        triggeringCommentId: (_o = input.triggeringCommentId) !== null && _o !== void 0 ? _o : null,
+    };
+}