@cursor/july 0.1.102 → 0.1.104

package/dist/channels/github/github-channel.js

@@ -10,8 +10,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { createHmac, timingSafeEqual } from "node:crypto";
 import { z } from "zod";
 import { allowAll, defineChannel, localDevStrict, loopbackGitHubDev, POST, } from "../../channels.js";
+import { acknowledgeTask, acknowledgeTurn, isTaskDispatch, scheduleAfterAck, skipped, turnStarted, withPropagatingBackgroundErrors, } from "../../internal/channel-dispatch.js";
 import { continuationSource, normalizeIdentity, } from "../../internal/continuation-identity.js";
-import { isDeferredChannelSession } from "../../internal/deferred-channel-session.js";
 import { isDevMode } from "../../internal/dev-mode.js";
 import { attachHostedAdmissionAdapter } from "../../internal/hosted-admission-adapter.js";
 import { bindLocalIngressSend } from "../../internal/local-ingress.js";
@@ -142,17 +142,9 @@ export function parseGitHubPrContinuationKey(key) {
         number: Number(match[3]),
     };
 }
-/** @deprecated Prefer {@link githubContinuationKey}. */
-export function githubPullRequestContinuationKey(ctx) {
-    return githubContinuationKey(ctx);
-}
 export function defaultGitHubTitle(ctx) {
     return `GitHub ${ctx.repository.fullName}#${ctx.conversation.number}`;
 }
-/** @deprecated Prefer {@link defaultGitHubTitle}. */
-export function defaultGitHubPullRequestTitle(ctx) {
-    return defaultGitHubTitle(ctx);
-}
 export function defaultGitHubPullRequestMessage(ctx, pullRequest) {
     return [
         `GitHub pull request trigger: ${ctx.repository.fullName}#${pullRequest.number}`,
@@ -196,9 +188,6 @@ export function defaultOnComment(ctx, comment, options) {
     }
     return { auth: defaultGitHubAuth(ctx) };
 }
-function isTaskDispatch(dispatch) {
-    return "task" in dispatch;
-}
 export function shouldDispatchGitHubComment(args) {
     var _a;
     const botName = (_a = args.botName) === null || _a === void 0 ? void 0 : _a.trim();
@@ -285,24 +274,13 @@ function verifyWebhookSha256Signature(args) {
     const received = Buffer.from(receivedHex, "hex");
     return (received.length === expected.length && timingSafeEqual(received, expected));
 }
-const dispatchOutcomeByResponse = new WeakMap();
-function withDispatchOutcome(response, outcome) {
-    dispatchOutcomeByResponse.set(response, outcome);
-    return response;
-}
-export function getGitHubDispatchOutcome(response) {
-    return dispatchOutcomeByResponse.get(response);
-}
-const PROPAGATE_BACKGROUND_ERRORS = Symbol("propagateBackgroundErrors");
-export function withPropagatingGitHubBackgroundErrors(args) {
-    return Object.assign(args, { [PROPAGATE_BACKGROUND_ERRORS]: true });
-}
+/**
+ * Run the authored hooks for one GitHub delivery and `send()` the turn.
+ * Callers own delivery auth: the HTTP route verifies the HMAC; trigger
+ * fan-out and hosted admission arrive verified. The v2 mailbox is stamped
+ * upstream (local CP or hosted ingress), never here.
+ */
 export function dispatchGitHubWebhook(input) {
-    return __awaiter(this, void 0, void 0, function* () {
-        return dispatchGitHubWebhookInner(input);
-    });
-}
-function dispatchGitHubWebhookInner(input) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         const { options, eventName, payload, deliveryId, args } = input;
@@ -392,12 +370,7 @@ function dispatchGitHubWebhookInner(input) {
                         args,
                     });
                 }
-                return Response.json({
-                    ok: true,
-                    skipped: true,
-                    reason: "unsupported_event",
-                    event: eventName,
-                });
+                return skipped("unsupported_event", { event: eventName });
         }
     });
 }
@@ -455,6 +428,41 @@ const githubChannelOptionsByDefinition = new WeakMap();
 export function getGitHubChannelOptions(definition) {
     return githubChannelOptionsByDefinition.get(definition);
 }
+/**
+ * GitHub webhook channel (Eve-compatible dispatch surface). Point a GitHub App
+ * or repository webhook at `/<agent>/v1/channels/github` and declare inbound
+ * hooks:
+ *
+ * ```ts
+ * import { defaultGitHubAuth, githubChannel } from "@cursor/july/channels/github";
+ *
+ * export default githubChannel({
+ *   botName: "my-agent",
+ *   credentials: { webhookSecret: () => process.env.GITHUB_WEBHOOK_SECRET },
+ *   // Replaces the @mention gate. Prefer typed Octokit via getOctokit().
+ *   onComment: (ctx, comment) => ({ auth: defaultGitHubAuth(ctx) }),
+ *   onPullRequest: (ctx, pr) =>
+ *     pr.action === "opened" ? { auth: defaultGitHubAuth(ctx) } : null,
+ *   onStatus: (ctx, status) =>
+ *     status.state === "failure"
+ *       ? {
+ *           task: async () => {
+ *             const octokit = await ctx.github.getOctokit();
+ *             await octokit.rest.repos.createCommitStatus({
+ *               owner: ctx.repository.owner,
+ *               repo: ctx.repository.name,
+ *               sha: status.sha,
+ *               state: "pending",
+ *               context: "agent/triage",
+ *             });
+ *           },
+ *         }
+ *       : null,
+ *   onEvent: (ctx, event) =>
+ *     event.eventName === "label" ? { auth: defaultGitHubAuth(ctx) } : null,
+ * });
+ * ```
+ */
 export function githubChannel(options = {}) {
     var _a, _b, _c;
     const usesCursorAccount = options.cursorAccount === true || typeof options.cursorAccount === "object";
@@ -526,7 +534,7 @@ export function githubChannel(options = {}) {
     githubChannelOptionsByDefinition.set(definition, channelOptions);
     attachHostedAdmissionAdapter(definition, {
         kind: GITHUB_CHANNEL_KIND,
-        prepareArgs: withPropagatingGitHubBackgroundErrors,
+        prepareArgs: withPropagatingBackgroundErrors,
         dispatch: ({ eventType, payload, deliveryId, args }) => dispatchGitHubWebhook({
             options: channelOptions,
             eventName: eventType,
@@ -534,10 +542,6 @@ export function githubChannel(options = {}) {
             deliveryId,
             args,
         }),
-        getOutcome: (response) => {
-            const outcome = getGitHubDispatchOutcome(response);
-            return outcome === "skip" || outcome === "task" ? outcome : undefined;
-        },
     });
     if (cursorCredentials !== undefined) {
         registerGithubCursorAccountRuntime(definition, {
@@ -573,6 +577,7 @@ function handlePullRequest(input) {
             repo: parsed.ctx.repository.name,
             number: parsed.ctx.conversation.number,
             repositoryId: parsed.ctx.repository.id,
+            repositoryUrl: parsed.ctx.repository.url,
             installationId,
         });
         const ctx = enrichEventContext({
@@ -591,7 +596,7 @@ function handlePullRequest(input) {
             return skipped("not_dispatched", { action: pullRequest.action });
         }
         if (isTaskDispatch(dispatch)) {
-            return acknowledgeTask(input.args, dispatch, {
+            return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                 action: pullRequest.action,
                 prUrl: pullRequest.url,
                 headSha: pullRequest.headSha,
@@ -643,6 +648,7 @@ function handleIssueComment(input) {
             repo: parsed.ctx.repository.name,
             number: parsed.ctx.conversation.number,
             repositoryId: parsed.ctx.repository.id,
+            repositoryUrl: parsed.ctx.repository.url,
             installationId,
             triggeringCommentId: parsed.comment.id,
         });
@@ -664,7 +670,7 @@ function handleIssueComment(input) {
             return skipped("not_dispatched");
         }
         if (isTaskDispatch(dispatch)) {
-            return acknowledgeTask(input.args, dispatch, {
+            return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                 event: "issue_comment",
                 action: parsed.action,
             });
@@ -714,6 +720,7 @@ function handleReviewComment(input) {
             repo: parsed.ctx.repository.name,
             number: parsed.ctx.conversation.number,
             repositoryId: parsed.ctx.repository.id,
+            repositoryUrl: parsed.ctx.repository.url,
             installationId,
             triggeringCommentId: parsed.comment.id,
             reviewCommentId: parsed.comment.id,
@@ -737,7 +744,7 @@ function handleReviewComment(input) {
             return skipped("not_dispatched");
         }
         if (isTaskDispatch(dispatch)) {
-            return acknowledgeTask(input.args, dispatch, {
+            return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                 event: "pull_request_review_comment",
                 action: parsed.action,
             });
@@ -787,6 +794,7 @@ function handleIssue(input) {
             repo: parsed.ctx.repository.name,
             number: parsed.ctx.conversation.number,
             repositoryId: parsed.ctx.repository.id,
+            repositoryUrl: parsed.ctx.repository.url,
             installationId,
         });
         const ctx = enrichEventContext({
@@ -803,7 +811,7 @@ function handleIssue(input) {
             return skipped("not_dispatched", { action: parsed.issue.action });
         }
         if (isTaskDispatch(dispatch)) {
-            return acknowledgeTask(input.args, dispatch, {
+            return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                 event: "issues",
                 action: parsed.issue.action,
                 issueNumber: parsed.issue.number,
@@ -851,7 +859,7 @@ function handleCheckSuite(input) {
                 artifacts: input.args.artifacts,
             }), parsed.checkSuite);
             if (dispatch !== null && isTaskDispatch(dispatch)) {
-                return acknowledgeTask(input.args, dispatch, {
+                return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                     event: "check_suite",
                     action: parsed.checkSuite.action,
                     checkSuiteId: parsed.checkSuite.checkSuiteId,
@@ -865,6 +873,7 @@ function handleCheckSuite(input) {
             repo: parsed.ctx.repository.name,
             number: parsed.ctx.conversation.number,
             repositoryId: parsed.ctx.repository.id,
+            repositoryUrl: parsed.ctx.repository.url,
             installationId,
         });
         const ctx = enrichEventContext({
@@ -881,7 +890,7 @@ function handleCheckSuite(input) {
             return skipped("not_dispatched", { action: parsed.checkSuite.action });
         }
         if (isTaskDispatch(dispatch)) {
-            return acknowledgeTask(input.args, dispatch, {
+            return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                 event: "check_suite",
                 action: parsed.checkSuite.action,
                 checkSuiteId: parsed.checkSuite.checkSuiteId,
@@ -930,7 +939,7 @@ function handleCheckRun(input) {
                 artifacts: input.args.artifacts,
             }), parsed.checkRun);
             if (dispatch !== null && isTaskDispatch(dispatch)) {
-                return acknowledgeTask(input.args, dispatch, {
+                return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                     event: "check_run",
                     action: parsed.checkRun.action,
                     checkRunId: parsed.checkRun.checkRunId,
@@ -944,6 +953,7 @@ function handleCheckRun(input) {
             repo: parsed.ctx.repository.name,
             number: parsed.ctx.conversation.number,
             repositoryId: parsed.ctx.repository.id,
+            repositoryUrl: parsed.ctx.repository.url,
             installationId,
         });
         const ctx = enrichEventContext({
@@ -960,7 +970,7 @@ function handleCheckRun(input) {
             return skipped("not_dispatched", { action: parsed.checkRun.action });
         }
         if (isTaskDispatch(dispatch)) {
-            return acknowledgeTask(input.args, dispatch, {
+            return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                 event: "check_run",
                 action: parsed.checkRun.action,
                 checkRunId: parsed.checkRun.checkRunId,
@@ -1009,7 +1019,7 @@ function handleWorkflowRun(input) {
                 artifacts: input.args.artifacts,
             }), parsed.workflowRun);
             if (dispatch !== null && isTaskDispatch(dispatch)) {
-                return acknowledgeTask(input.args, dispatch, {
+                return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                     event: "workflow_run",
                     action: parsed.workflowRun.action,
                     workflowRunId: parsed.workflowRun.workflowRunId,
@@ -1023,6 +1033,7 @@ function handleWorkflowRun(input) {
             repo: parsed.ctx.repository.name,
             number: parsed.ctx.conversation.number,
             repositoryId: parsed.ctx.repository.id,
+            repositoryUrl: parsed.ctx.repository.url,
             installationId,
         });
         const ctx = enrichEventContext({
@@ -1039,7 +1050,7 @@ function handleWorkflowRun(input) {
             return skipped("not_dispatched", { action: parsed.workflowRun.action });
         }
         if (isTaskDispatch(dispatch)) {
-            return acknowledgeTask(input.args, dispatch, {
+            return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                 event: "workflow_run",
                 action: parsed.workflowRun.action,
                 workflowRunId: parsed.workflowRun.workflowRunId,
@@ -1084,6 +1095,7 @@ function handleStatus(input) {
             repo: parsed.ctx.repository.name,
             number: parsed.ctx.conversation.number,
             repositoryId: parsed.ctx.repository.id,
+            repositoryUrl: parsed.ctx.repository.url,
             installationId,
         });
         const ctx = enrichEventContext({
@@ -1103,7 +1115,7 @@ function handleStatus(input) {
             });
         }
         if (isTaskDispatch(dispatch)) {
-            return acknowledgeTask(input.args, dispatch, {
+            return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, {
                 event: "status",
                 state: parsed.status.state,
                 sha: parsed.status.sha,
@@ -1153,6 +1165,7 @@ function handleGenericEvent(input) {
             repo: parsed.ctx.repository.name,
             number: parsed.ctx.conversation.number,
             repositoryId: parsed.ctx.repository.id,
+            repositoryUrl: parsed.ctx.repository.url,
             installationId,
         });
         const ctx = enrichEventContext({
@@ -1169,7 +1182,7 @@ function handleGenericEvent(input) {
             return skipped("not_dispatched", { event: input.eventName });
         }
         if (isTaskDispatch(dispatch)) {
-            return acknowledgeTask(input.args, dispatch, Object.assign({ event: input.eventName }, (parsed.event.action === undefined
+            return acknowledgeTask(input.args, GITHUB_CHANNEL_KIND, dispatch, Object.assign({ event: input.eventName }, (parsed.event.action === undefined
                 ? {}
                 : { action: parsed.event.action })));
         }
@@ -1209,61 +1222,14 @@ function startTurn(input) {
                 refreshState: input.state }));
         });
         if (lazy) {
-            scheduleAfterAck(input.args, () => __awaiter(this, void 0, void 0, function* () {
+            scheduleAfterAck(input.args, GITHUB_CHANNEL_KIND, () => __awaiter(this, void 0, void 0, function* () {
                 yield sendTurn();
             }));
             return acknowledgeTurn();
         }
-        const session = yield sendTurn();
-        if (isDeferredChannelSession(session)) {
-            // Hosted admission captured the send; the control plane allocates the
-            // session after acknowledgement, so there is nothing to report yet.
-            return acknowledgeTurn();
-        }
-        return withDispatchOutcome(Response.json({
-            ok: true,
-            sessionId: session.id,
-            isNew: session.isNew,
-            continuationToken: session.continuationToken,
-        }), "send");
+        return turnStarted(yield sendTurn());
     });
 }
-function scheduleAfterAck(args, work) {
-    // Defer past the current turn so the 202 can flush before work starts
-    // (and so tests can assert scheduling without racing microtasks).
-    args.waitUntil(new Promise((resolve, reject) => {
-        setImmediate(() => {
-            Promise.resolve()
-                .then(work)
-                .then(() => resolve(), (error) => {
-                var _a;
-                if (args[PROPAGATE_BACKGROUND_ERRORS] ===
-                    true) {
-                    reject(error);
-                    return;
-                }
-                const detail = error instanceof Error
-                    ? ((_a = error.stack) !== null && _a !== void 0 ? _a : error.message)
-                    : String(error);
-                console.error(`[github] background dispatch failed: ${detail}`);
-                resolve();
-            });
-        });
-    }));
-}
-/** 202 ack for a turn whose send completes after the response flushes. */
-function acknowledgeTurn() {
-    return withDispatchOutcome(Response.json({ ok: true, dispatched: true, mode: "turn" }, { status: 202 }), "send");
-}
-function acknowledgeTask(args, dispatch, extra) {
-    // Hand the task the per-delivery send/waitUntil so hosted admission can
-    // capture task-initiated sends; startup-captured sends bypass capture.
-    scheduleAfterAck(args, () => dispatch.task({ send: args.send, waitUntil: args.waitUntil }));
-    return withDispatchOutcome(Response.json(Object.assign({ ok: true, dispatched: true, mode: "task" }, extra), { status: 202 }), "task");
-}
-function skipped(reason, extra = {}) {
-    return withDispatchOutcome(Response.json(Object.assign({ ok: true, skipped: true, reason }, extra)), "skip");
-}
 function formatCiMessage(label, id, event) {
     var _a;
     const outcome = (_a = event.conclusion) !== null && _a !== void 0 ? _a : event.status;
@@ -1814,6 +1780,7 @@ function enrichCiContext(input) {
         repo: input.ctx.repository.name,
         number: input.ctx.conversation.number,
         repositoryId: input.ctx.repository.id,
+        repositoryUrl: input.ctx.repository.url,
         installationId: input.installationId,
     });
     return enrichEventContext({

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

@@ -12,6 +12,27 @@ export interface GitHubProgressPhaseCopy {
 export interface GitHubCommitStatusProgress extends GitHubProgressPhaseCopy {
     /** Check run name (unique per check in the merge box). */
     context: string;
+    /**
+     * Check Details URL for this session. When it resolves, it is written as
+     * `details_url` and (with {@link summaryLinkText}) appended to the summary.
+     */
+    detailsUrl?: (sessionId: string) => string | undefined;
+    /**
+     * `output.title` source. `"phase"` (default) uses the pending/success/
+     * failure copy. `"context"` uses the check name — the dashboard automation
+     * shape (`Cursor Security Agent: …`).
+     */
+    outputTitle?: "phase" | "context";
+    /**
+     * Markdown link label appended to the summary when {@link detailsUrl}
+     * resolves, e.g. `"View agent"`.
+     */
+    summaryLinkText?: string;
+    /**
+     * Conclusion for the failure phase. Default `"failure"`. Use `"neutral"`
+     * when a red merge-box check must not gate merge (findings live on the PR).
+     */
+    failureConclusion?: "failure" | "neutral";
 }
 export type GitHubBannerProgress = GitHubProgressPhaseCopy;
 export interface GitHubProgressConfig {
@@ -54,6 +75,7 @@ export declare function progressPhaseCopy(input: {
  */
 export declare function applyGitHubProgress(input: {
     phase: GitHubProgressPhase;
+    sessionId?: string;
     channel: {
         state: GitHubChannelState;
     };

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

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/channels/github/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKrD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA2B,SAAQ,uBAAuB;IACzE,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;;;OAKG;IACH,YAAY,CAAC,EAAE,KAAK,GAAG,0BAA0B,CAAC;IAClD;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GACzC,0BAA0B,GAAG,IAAI,CAKnC;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GACzC,oBAAoB,GAAG,IAAI,CAK7B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,IAAI,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC1C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAaT;AAuBD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE;QAAE,KAAK,EAAE,kBAAkB,CAAA;KAAE,CAAC;IACvC,OAAO,EAAE,qBAAqB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhB"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/channels/github/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKrD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA2B,SAAQ,uBAAuB;IACzE,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;;;OAKG;IACH,YAAY,CAAC,EAAE,KAAK,GAAG,0BAA0B,CAAC;IAClD;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GACzC,0BAA0B,GAAG,IAAI,CAKnC;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GACzC,oBAAoB,GAAG,IAAI,CAK7B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,IAAI,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC1C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAaT;AAuBD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QAAE,KAAK,EAAE,kBAAkB,CAAA;KAAE,CAAC;IACvC,OAAO,EAAE,qBAAqB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB"}

package/dist/channels/github/progress.js

@@ -73,6 +73,7 @@ export function applyGitHubProgress(input) {
         if (commitStatus !== null) {
             tasks.push(postProgressCheckRun({
                 phase: input.phase,
+                sessionId: input.sessionId,
                 channel: input.channel,
                 options: input.options,
                 commitStatus,
@@ -90,6 +91,22 @@ export function applyGitHubProgress(input) {
         yield Promise.all(tasks);
     });
 }
+function resolveProgressDetailsUrl(input) {
+    var _a;
+    if (input.sessionId === undefined ||
+        input.commitStatus.detailsUrl === undefined) {
+        return undefined;
+    }
+    const url = (_a = input.commitStatus.detailsUrl(input.sessionId)) === null || _a === void 0 ? void 0 : _a.trim();
+    return url === "" ? undefined : url;
+}
+function appendSummaryLink(summary, detailsUrl, linkText) {
+    const label = linkText === null || linkText === void 0 ? void 0 : linkText.trim();
+    if (detailsUrl === undefined || label === undefined || label === "") {
+        return summary;
+    }
+    return `${summary}\n\n[${label}](${detailsUrl})`;
+}
 function postProgressCheckRun(input) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
@@ -101,12 +118,22 @@ function postProgressCheckRun(input) {
             return;
         }
         const sha = state.headSha;
-        const description = clipStatusDescription(progressPhaseCopy({
+        const phaseCopy = progressPhaseCopy({
             copy: input.commitStatus,
             phase: input.phase,
             label: progressLabel(input.options, input.commitStatus.context),
-        }));
-        const write = Object.assign(Object.assign({ name: input.commitStatus.context }, checkRunPhaseFields(input.phase)), { output: { title: description, summary: description } });
+        });
+        const title = clipStatusDescription(input.commitStatus.outputTitle === "context"
+            ? input.commitStatus.context
+            : phaseCopy);
+        const detailsUrl = resolveProgressDetailsUrl({
+            sessionId: input.sessionId,
+            commitStatus: input.commitStatus,
+        });
+        const write = Object.assign(Object.assign(Object.assign({ name: input.commitStatus.context }, checkRunPhaseFields(input.phase, input.commitStatus.failureConclusion)), (detailsUrl === undefined ? {} : { detailsUrl })), { output: {
+                title,
+                summary: appendSummaryLink(phaseCopy, detailsUrl, input.commitStatus.summaryLinkText),
+            } });
         const resource = {
             api: input.options.api,
             credentials: input.options.credentials,
@@ -156,13 +183,13 @@ function shouldRecreateCheckRun(error, status) {
     }
     return error.status === 422 && status === "in_progress";
 }
-function checkRunPhaseFields(phase) {
+function checkRunPhaseFields(phase, failureConclusion = "failure") {
     if (phase === "pending") {
         return { status: "in_progress" };
     }
     return {
         status: "completed",
-        conclusion: phase === "success" ? "success" : "failure",
+        conclusion: phase === "success" ? "success" : failureConclusion,
     };
 }
 function upsertBanner(input) {

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

@@ -1,6 +1,6 @@
 /**
  * Synthesize GitHub webhook payloads from data you can *read* about a PR, so
- * `agent-serve github replay` can exercise a `githubChannel()` without repo
+ * `agent-sdk github replay` can exercise a `githubChannel()` without repo
  * admin, without the `gh webhook forward` relay, and deterministically (great
  * for hillclimbing).
  *

package/dist/channels/github/replay.js

@@ -1,6 +1,6 @@
 /**
  * Synthesize GitHub webhook payloads from data you can *read* about a PR, so
- * `agent-serve github replay` can exercise a `githubChannel()` without repo
+ * `agent-sdk github replay` can exercise a `githubChannel()` without repo
  * admin, without the `gh webhook forward` relay, and deterministically (great
  * for hillclimbing).
  *

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

@@ -31,6 +31,8 @@ export declare function githubBindingStateForEvent(input: {
     repo: string;
     number: number;
     repositoryId?: number;
+    /** `repository.html_url` (GHES host lives here). */
+    repositoryUrl?: string;
     installationId?: number;
     triggeringCommentId?: number;
     reviewCommentId?: number;

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

@@ -1 +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;IACvB,6DAA6D;IAC7D,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,4DAA4D;IAC5D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;;OAKG;IACH,yBAAyB,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAC1C,kBAAkB,CAuBpB;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"}
+{"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;IACvB,6DAA6D;IAC7D,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,4DAA4D;IAC5D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;;OAKG;IACH,yBAAyB,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAC1C,kBAAkB,CAwBpB;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,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,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,CAgDrB"}

package/dist/channels/github/state.js

@@ -2,11 +2,11 @@
  * 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, progressBannerCommentId: null, progressCheckRunId: null, progressCheckRunSha: null, progressCheckRunCompleted: null }, overrides);
+    return Object.assign({ conversationKind: "pull_request", installationId: null, issueNumber: null, owner: "", pullRequestNumber: null, repo: "", repositoryId: null, repositoryUrl: null, reviewCommentId: null, reviewThreadRootCommentId: null, triggeringCommentId: null, deliveryId: null, eventName: null, headSha: null, baseRef: null, headRef: null, progressBannerCommentId: null, progressCheckRunId: null, progressCheckRunSha: null, progressCheckRunCompleted: 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;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
     if (input.kind === "issue") {
         return {
             conversationKind: "issue",
@@ -16,35 +16,38 @@ export function githubBindingStateForEvent(input) {
             pullRequestNumber: null,
             repo: input.repo,
             repositoryId: (_b = input.repositoryId) !== null && _b !== void 0 ? _b : null,
+            repositoryUrl: (_c = input.repositoryUrl) !== null && _c !== void 0 ? _c : null,
             reviewCommentId: null,
             reviewThreadRootCommentId: null,
-            triggeringCommentId: (_c = input.triggeringCommentId) !== null && _c !== void 0 ? _c : null,
+            triggeringCommentId: (_d = input.triggeringCommentId) !== null && _d !== void 0 ? _d : null,
         };
     }
     if (input.kind === "review_thread") {
         return {
             conversationKind: "review_thread",
-            installationId: (_d = input.installationId) !== null && _d !== void 0 ? _d : null,
+            installationId: (_e = input.installationId) !== null && _e !== void 0 ? _e : 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,
+            repositoryId: (_f = input.repositoryId) !== null && _f !== void 0 ? _f : null,
+            repositoryUrl: (_g = input.repositoryUrl) !== null && _g !== void 0 ? _g : null,
+            reviewCommentId: (_h = input.reviewCommentId) !== null && _h !== void 0 ? _h : null,
+            reviewThreadRootCommentId: (_l = (_k = (_j = input.reviewThreadRootCommentId) !== null && _j !== void 0 ? _j : input.reviewCommentId) !== null && _k !== void 0 ? _k : input.triggeringCommentId) !== null && _l !== void 0 ? _l : null,
+            triggeringCommentId: (_m = input.triggeringCommentId) !== null && _m !== void 0 ? _m : null,
         };
     }
     return {
         conversationKind: "pull_request",
-        installationId: (_l = input.installationId) !== null && _l !== void 0 ? _l : null,
+        installationId: (_o = input.installationId) !== null && _o !== void 0 ? _o : null,
         issueNumber: null,
         owner: input.owner,
         pullRequestNumber: input.number,
         repo: input.repo,
-        repositoryId: (_m = input.repositoryId) !== null && _m !== void 0 ? _m : null,
+        repositoryId: (_p = input.repositoryId) !== null && _p !== void 0 ? _p : null,
+        repositoryUrl: (_q = input.repositoryUrl) !== null && _q !== void 0 ? _q : null,
         reviewCommentId: null,
         reviewThreadRootCommentId: null,
-        triggeringCommentId: (_o = input.triggeringCommentId) !== null && _o !== void 0 ? _o : null,
+        triggeringCommentId: (_r = input.triggeringCommentId) !== null && _r !== void 0 ? _r : null,
     };
 }

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

@@ -1,4 +1,4 @@
-import type { ContinuationIdentity } from "../../continuation.js";
+import type { ContinuationIdentity } from "../../internal/continuation-identity.js";
 import type { AgentCloudOptions, ArtifactsApi, AuthContext, AuthPolicy, ChannelEventHandlers, ChannelStartArgs, HostContext, SendMessageFn, SendMessageOptions } from "../../types.js";
 import type { GitHubApiOptions } from "./api.js";
 import type { GitHubHandle, GitHubThread } from "./binding.js";
@@ -46,8 +46,6 @@ export interface GitHubChannelCredentials {
     /** GitHub App private key (PEM). Falls back to `GITHUB_APP_PRIVATE_KEY`. */
     privateKey?: GitHubCredentialValue;
 }
-/** @deprecated Prefer {@link GitHubChannelCredentials}. */
-export type GitHubCredentials = GitHubChannelCredentials;
 export type GitHubPullRequestAction = "opened" | "reopened" | "synchronize" | "ready_for_review" | "edited" | "closed" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "review_requested" | "review_request_removed" | "converted_to_draft";
 export type GitHubIssueAction = "opened" | "edited" | "closed" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned";
 export type GitHubConversationKind = "issue" | "pull_request" | "review_thread";
@@ -413,7 +411,7 @@ export interface GitHubChannelOptions {
     /** Route path under `/v1/channels/<name>`. Defaults to `/`. */
     path?: string;
     /**
-     * Webhook events advertised to `agent-serve github forward` (published as
+     * Webhook events advertised to `agent-sdk github forward` (published as
      * `meta.githubWebhookEvents`). Defaults to the set derived from the declared
      * hooks. Set this to pin an exact list — e.g. to include events only handled
      * through {@link onEvent} such as `pull_request_review`.