@cursor/july 0.1.42 → 0.1.45

package/AGENTS.md

@@ -29,6 +29,7 @@ Open them directly — there are no `.cursor/skills/` stubs for authoring.
 | `skills/create-agent/SKILL.md` | Scaffolding a new agent (interview → scaffold → verify) |
 | `skills/evals/SKILL.md` | Writing evals; fixture strategy; the regression ratchet |
 | `skills/ab/SKILL.md` | Live A/B metrics (`defineAB` under `agent/ab`); not a test runner |
+| `skills/otel/SKILL.md` | OpenTelemetry export (`defineOtel` / OTLP env / `ctx.host.otel`) |
 | `skills/hillclimb/SKILL.md` | Improving an existing agent measurably |
 | `skills/github/SKILL.md` | GitHub webhook agents; replay / forward / fixtures / cursor-events |
 | `skills/setup-slack/SKILL.md` | Slack wiring and Slack tool approvals |

package/dist/bin/agent-serve.js

@@ -70,7 +70,7 @@ Usage:
   ${CLI} trajectory  --events <file.ndjson> [--text]
   ${CLI} call        <tool> [--input <json>] [--dir <path> | --url <baseUrl> | --prod]
                           [--session <id>] [--slug <slug>] [--team <id>]
-  ${CLI} init        [dir] [--json]
+  ${CLI} init        [dir] [--template <name>] [--json]
   ${CLI} convert-automation <url> [--dir <path>] [--json]
   ${CLI} install-skills [--print] [--json]
   ${CLI} mcp         --prod [--slug <slug>] [--team <id>] [--dir <path>]
@@ -433,6 +433,7 @@ function main(argv) {
             allowPositionals: true,
             options: {
                 dir: { type: "string", default: "." },
+                template: { type: "string" },
                 port: { type: "string" },
                 host: { type: "string" },
                 mode: { type: "string" },
@@ -584,6 +585,7 @@ function main(argv) {
                 return cmdInit({
                     dir,
                     initTarget: positionals[0],
+                    template: values.template,
                     json: values.json,
                 });
             }

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

@@ -77,6 +77,11 @@ export declare function createGitHubIssueComment(input: GitHubResourceInput & {
     body: string;
     issueNumber: number;
 }): Promise<GitHubPostedComment>;
+/** Update an issue or PR timeline comment by id. */
+export declare function updateGitHubIssueComment(input: GitHubResourceInput & {
+    body: string;
+    commentId: number;
+}): Promise<GitHubPostedComment>;
 /** Reply to an inline pull-request review comment thread. */
 export declare function createGitHubReviewCommentReply(input: GitHubResourceInput & {
     body: string;

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

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/channels/github/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EACL,KAAK,oBAAoB,EAO1B,MAAM,WAAW,CAAC;AAMnB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE1E,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;CAAG;AAEjE,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,IAAI,EAAE,CAAC,CAAC;IACR,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,KAAK,EAAE;QACjB,IAAI,EAAE,OAAO,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,EASA;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB;AAED,MAAM,MAAM,qBAAqB,GAC7B,IAAI,GACJ,IAAI,GACJ,UAAU,GACV,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,CAAC;AAEb,UAAU,mBAAmB;IAC3B,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiEnB;AAaD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE;IACtD,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAAE,CAAC;CAC1E,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAchC;AAqCD,8CAA8C;AAC9C,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACjE,OAAO,CAAC,mBAAmB,CAAC,CAiB9B;AAED,6DAA6D;AAC7D,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,mBAAmB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GACA,OAAO,CAAC,mBAAmB,CAAC,CAkB9B;AAED,uDAAuD;AACvD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,eAAe,GAAG,6BAA6B,CAAC;CAC1D,GACA,OAAO,CAAC,iBAAiB,CAAC,CA+B5B;AAED,sDAAsD;AACtD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,mBAAmB,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,iBAAiB,CAAC,CA0B5B"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/channels/github/api.ts"],"names":[],"mappings":"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"}

package/dist/channels/github/api.js

@@ -154,6 +154,24 @@ export function createGitHubIssueComment(input) {
         }
     });
 }
+/** Update an issue or PR timeline comment by id. */
+export function updateGitHubIssueComment(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const octokit = yield createGitHubOctokit(input);
+        try {
+            const response = yield octokit.rest.issues.updateComment({
+                owner: input.owner,
+                repo: input.repo,
+                comment_id: input.commentId,
+                body: input.body,
+            });
+            return toPostedComment(response.data);
+        }
+        catch (error) {
+            throw wrapOctokitError(error, "PATCH", `/repos/${input.owner}/${input.repo}/issues/comments/${input.commentId}`);
+        }
+    });
+}
 /** Reply to an inline pull-request review comment thread. */
 export function createGitHubReviewCommentReply(input) {
     return __awaiter(this, void 0, void 0, function* () {

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

@@ -3,12 +3,10 @@
  */
 import type { ChannelEventHandlers } from "../../types.js";
 import type { GitHubBindingConfig } from "./binding.js";
+import { type GitHubProgressConfig } from "./progress.js";
 import type { GitHubChannelState } from "./state.js";
-export interface GitHubProgressConfig {
-    /** When false, skip the eyes reaction on turn.started. Defaults to true. */
-    reactions?: boolean;
-}
 export interface BuildDefaultGitHubEventsOptions extends GitHubBindingConfig {
+    botName?: string;
     progress?: GitHubProgressConfig;
     /**
      * When false, skip posting completed assistant messages back to GitHub.
@@ -17,7 +15,8 @@ export interface BuildDefaultGitHubEventsOptions extends GitHubBindingConfig {
     deliverReplies?: boolean;
 }
 /**
- * Built-in delivery: eyes reaction on turn start, post assistant text on
+ * Built-in delivery: eyes reaction on turn start, optional commit status /
+ * sticky banner via {@link GitHubProgressConfig}, post assistant text on
  * `message.completed`, and a short error comment on turn/session failure.
  */
 export declare function buildDefaultGitHubEvents(options?: BuildDefaultGitHubEventsOptions): ChannelEventHandlers<GitHubChannelState>;

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

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/channels/github/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,+BAAgC,SAAQ,mBAAmB;IAC1E,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,oBAAoB,CAAC,kBAAkB,CAAC,CAmD1C"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/channels/github/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,+BAAgC,SAAQ,mBAAmB;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,oBAAoB,CAAC,kBAAkB,CAAC,CA0E1C"}

package/dist/channels/github/defaults.js

@@ -11,8 +11,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { buildGitHubBinding, formatGitHubOutboundComment } from "./binding.js";
+import { applyGitHubProgress } from "./progress.js";
 /**
- * Built-in delivery: eyes reaction on turn start, post assistant text on
+ * Built-in delivery: eyes reaction on turn start, optional commit status /
+ * sticky banner via {@link GitHubProgressConfig}, post assistant text on
  * `message.completed`, and a short error comment on turn/session failure.
  */
 export function buildDefaultGitHubEvents(options = {}) {
@@ -21,6 +23,11 @@ export function buildDefaultGitHubEvents(options = {}) {
         "turn.started"(_event, channel) {
             return __awaiter(this, void 0, void 0, function* () {
                 var _a;
+                yield applyGitHubProgress({
+                    phase: "pending",
+                    channel,
+                    options,
+                });
                 if (((_a = options.progress) === null || _a === void 0 ? void 0 : _a.reactions) === false) {
                     return;
                 }
@@ -39,6 +46,15 @@ export function buildDefaultGitHubEvents(options = {}) {
                 }
             });
         },
+        "turn.completed"(_event, channel) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield applyGitHubProgress({
+                    phase: "success",
+                    channel,
+                    options,
+                });
+            });
+        },
         "message.completed"(event, channel) {
             return __awaiter(this, void 0, void 0, function* () {
                 if (!deliverReplies) {
@@ -64,11 +80,21 @@ export function buildDefaultGitHubEvents(options = {}) {
         },
         "turn.failed"(event, channel) {
             return __awaiter(this, void 0, void 0, function* () {
+                yield applyGitHubProgress({
+                    phase: "failure",
+                    channel,
+                    options,
+                });
                 yield postFailure(channel, options, event.data.message);
             });
         },
         "session.failed"(event, channel) {
             return __awaiter(this, void 0, void 0, function* () {
+                yield applyGitHubProgress({
+                    phase: "failure",
+                    channel,
+                    options,
+                });
                 yield postFailure(channel, options, event.data.message);
             });
         },

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

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

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

@@ -77,6 +77,12 @@ const githubPullRequestPayloadSchema = z.object({
     }),
     sender: senderSchema,
     installation: installationSchema,
+    label: z
+        .object({
+        name: z.string().min(1),
+    })
+        .nullable()
+        .optional(),
 });
 /**
  * Derive the turn's auth from the actor that triggered the delivery — the
@@ -189,8 +195,8 @@ export function extractGitHubCommentTrigger(args) {
     return { message: stripped };
 }
 export function parseGitHubPullRequestEvent(args) {
-    var _a, _b;
-    var _c;
+    var _a, _b, _c;
+    var _d;
     const parsed = githubPullRequestPayloadSchema.safeParse(args.payload);
     if (!parsed.success) {
         return null;
@@ -204,14 +210,16 @@ export function parseGitHubPullRequestEvent(args) {
             number: payload.pull_request.number,
             url: payload.pull_request.html_url,
         } }), (sender === undefined ? {} : { sender, senderLogin: sender.login })), (installationId === undefined ? {} : { installationId }));
-    const pullRequest = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ action: payload.action, number: payload.pull_request.number, url: payload.pull_request.html_url, title: payload.pull_request.title }, (payload.pull_request.body === undefined ||
+    const pullRequest = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ action: payload.action, number: payload.pull_request.number, url: payload.pull_request.html_url, title: payload.pull_request.title }, (payload.pull_request.body === undefined ||
         payload.pull_request.body === null
         ? {}
         : { body: payload.pull_request.body })), { headRef: payload.pull_request.head.ref, headSha: payload.pull_request.head.sha, baseRef: payload.pull_request.base.ref }), (payload.pull_request.base.sha === undefined
         ? {}
-        : { baseSha: payload.pull_request.base.sha })), { draft: (_c = payload.pull_request.draft) !== null && _c !== void 0 ? _c : false, merged: payload.pull_request.merged === true }), (((_b = payload.pull_request.user) === null || _b === void 0 ? void 0 : _b.login) === undefined
+        : { baseSha: payload.pull_request.base.sha })), { draft: (_d = payload.pull_request.draft) !== null && _d !== void 0 ? _d : false, merged: payload.pull_request.merged === true }), (((_b = payload.pull_request.user) === null || _b === void 0 ? void 0 : _b.login) === undefined
+        ? {}
+        : { authorLogin: payload.pull_request.user.login })), (((_c = payload.label) === null || _c === void 0 ? void 0 : _c.name) === undefined
         ? {}
-        : { authorLogin: payload.pull_request.user.login }));
+        : { label: { name: payload.label.name } }));
     return { ctx, pullRequest };
 }
 export function verifyGitHubWebhookSignature(args) {
@@ -709,6 +717,9 @@ function handleReviewComment(input) {
                 binding,
                 deliveryId: ctx.deliveryId,
                 eventName: ctx.eventName,
+                headSha: parsed.headSha,
+                headRef: parsed.headRef,
+                baseRef: parsed.baseRef,
             }),
         });
     });
@@ -1128,7 +1139,9 @@ function handleGenericEvent(input) {
 function startTurn(input) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
-        const session = yield input.args.send(input.message, Object.assign(Object.assign({ auth: input.dispatch.auth, continuationToken: githubContinuationKey(input.ctx), title: (_a = input.dispatch.title) !== null && _a !== void 0 ? _a : defaultGitHubTitle(input.ctx) }, (input.cloud === undefined ? {} : { cloud: input.cloud })), { state: input.state }));
+        const session = yield input.args.send(input.message, Object.assign(Object.assign({ auth: input.dispatch.auth, continuationToken: githubContinuationKey(input.ctx), title: (_a = input.dispatch.title) !== null && _a !== void 0 ? _a : defaultGitHubTitle(input.ctx) }, (input.cloud === undefined ? {} : { cloud: input.cloud })), { state: input.state, 
+            // Resume must refresh headSha / refs without wiping sticky banner id.
+            refreshState: input.state }));
         return Response.json({
             ok: true,
             sessionId: session.id,
@@ -1226,14 +1239,25 @@ function parseIssueCommentEvent(args) {
     return { action: payload.action, ctx, comment };
 }
 function parseReviewCommentEvent(args) {
-    var _a;
-    var _b;
+    var _a, _b, _c, _d;
+    var _e;
     const schema = z.object({
         action: z.string().min(1),
         repository: repositorySchema,
         pull_request: z.object({
             number: z.number().int().positive(),
             html_url: z.string().url(),
+            head: z
+                .object({
+                sha: z.string().min(1).optional(),
+                ref: z.string().min(1).optional(),
+            })
+                .optional(),
+            base: z
+                .object({
+                ref: z.string().min(1).optional(),
+            })
+                .optional(),
         }),
         comment: z.object({
             id: z.number(),
@@ -1269,7 +1293,7 @@ function parseReviewCommentEvent(args) {
             number: payload.pull_request.number,
             url: payload.pull_request.html_url,
         } }), (sender === undefined ? {} : { sender, senderLogin: sender.login })), (installationId === undefined ? {} : { installationId }));
-    const comment = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ id: payload.comment.id, body: payload.comment.body, htmlUrl: payload.comment.html_url, url: (_b = payload.comment.url) !== null && _b !== void 0 ? _b : payload.comment.html_url }, (author === undefined ? {} : { author })), (payload.comment.path === undefined
+    const comment = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ id: payload.comment.id, body: payload.comment.body, htmlUrl: payload.comment.html_url, url: (_e = payload.comment.url) !== null && _e !== void 0 ? _e : payload.comment.html_url }, (author === undefined ? {} : { author })), (payload.comment.path === undefined
         ? {}
         : { path: payload.comment.path })), (payload.comment.line === undefined
         ? {}
@@ -1278,7 +1302,14 @@ function parseReviewCommentEvent(args) {
         : { pullRequestReviewId: payload.comment.pull_request_review_id })), (payload.comment.in_reply_to_id === undefined
         ? {}
         : { inReplyToId: payload.comment.in_reply_to_id }));
-    return { action: payload.action, ctx, comment };
+    return {
+        action: payload.action,
+        ctx,
+        comment,
+        headSha: (_b = payload.pull_request.head) === null || _b === void 0 ? void 0 : _b.sha,
+        headRef: (_c = payload.pull_request.head) === null || _c === void 0 ? void 0 : _c.ref,
+        baseRef: (_d = payload.pull_request.base) === null || _d === void 0 ? void 0 : _d.ref,
+    };
 }
 function parseIssueEvent(args) {
     var _a, _b;

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

@@ -46,6 +46,7 @@ export * from "./defaults.js";
 export * from "./events.js";
 export * from "./forward.js";
 export * from "./github-channel.js";
+export * from "./progress.js";
 export * from "./replay.js";
 export * from "./state.js";
 export * from "./types.js";

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

@@ -1 +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"}
+{"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,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/channels/github/index.js

@@ -46,6 +46,7 @@ export * from "./defaults.js";
 export * from "./events.js";
 export * from "./forward.js";
 export * from "./github-channel.js";
+export * from "./progress.js";
 export * from "./replay.js";
 export * from "./state.js";
 export * from "./types.js";

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

@@ -0,0 +1,54 @@
+/**
+ * Opt-in PR progress surfaces: commit status + sticky banner comment.
+ */
+import type { GitHubBindingConfig } from "./binding.js";
+import type { GitHubChannelState } from "./state.js";
+export type GitHubProgressPhase = "pending" | "success" | "failure";
+export interface GitHubProgressPhaseCopy {
+    pending?: string;
+    success?: string;
+    failure?: string;
+}
+export interface GitHubCommitStatusProgress extends GitHubProgressPhaseCopy {
+    /** Commit status context (unique per check in the merge box). */
+    context: string;
+}
+export type GitHubBannerProgress = GitHubProgressPhaseCopy;
+export interface GitHubProgressConfig {
+    /** When false, skip the eyes reaction on turn.started. Defaults to true. */
+    reactions?: boolean;
+    /**
+     * Opt-in commit status on the PR head. Omit or `false` keeps today's
+     * behavior (no statuses from default events). With `cursorAccount`,
+     * needs `permissions: "contents-write"` (push-equivalent).
+     */
+    commitStatus?: false | GitHubCommitStatusProgress;
+    /**
+     * Opt-in sticky PR/issue timeline comment. Created on first pending,
+     * PATCHed on later phases. Omit or `false` disables.
+     */
+    banner?: false | GitHubBannerProgress;
+}
+export interface GitHubProgressOptions extends GitHubBindingConfig {
+    botName?: string;
+    progress?: GitHubProgressConfig;
+}
+export declare function resolveCommitStatusProgress(progress: GitHubProgressConfig | undefined): GitHubCommitStatusProgress | null;
+export declare function resolveBannerProgress(progress: GitHubProgressConfig | undefined): GitHubBannerProgress | null;
+export declare function progressPhaseCopy(input: {
+    copy: GitHubProgressPhaseCopy | undefined;
+    phase: GitHubProgressPhase;
+    label: string;
+}): string;
+/**
+ * Post or update opt-in progress surfaces for a turn phase.
+ * Soft-fails on API errors (same posture as eyes / reply delivery).
+ */
+export declare function applyGitHubProgress(input: {
+    phase: GitHubProgressPhase;
+    channel: {
+        state: GitHubChannelState;
+    };
+    options: GitHubProgressOptions;
+}): Promise<void>;
+//# sourceMappingURL=progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/channels/github/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,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,iEAAiE;IACjE,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;;;;OAIG;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"}

package/dist/channels/github/progress.js

@@ -0,0 +1,168 @@
+/**
+ * Opt-in PR progress surfaces: commit status + sticky banner comment.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { createGitHubCommitStatus, createGitHubIssueComment, GitHubApiError, updateGitHubIssueComment, } from "./api.js";
+import { formatGitHubOutboundComment } from "./binding.js";
+/** GitHub commit-status descriptions are capped at 140 characters. */
+const STATUS_DESCRIPTION_MAX = 140;
+export function resolveCommitStatusProgress(progress) {
+    if ((progress === null || progress === void 0 ? void 0 : progress.commitStatus) === undefined || progress.commitStatus === false) {
+        return null;
+    }
+    return progress.commitStatus;
+}
+export function resolveBannerProgress(progress) {
+    if ((progress === null || progress === void 0 ? void 0 : progress.banner) === undefined || progress.banner === false) {
+        return null;
+    }
+    return progress.banner;
+}
+export function progressPhaseCopy(input) {
+    var _a;
+    const custom = (_a = input.copy) === null || _a === void 0 ? void 0 : _a[input.phase];
+    if (custom !== undefined && custom.trim() !== "") {
+        return custom;
+    }
+    switch (input.phase) {
+        case "pending":
+            return `${input.label} running`;
+        case "success":
+            return `${input.label} finished`;
+        case "failure":
+            return `${input.label} failed`;
+    }
+}
+function clipStatusDescription(text) {
+    if (text.length <= STATUS_DESCRIPTION_MAX) {
+        return text;
+    }
+    return `${text.slice(0, STATUS_DESCRIPTION_MAX - 1)}…`;
+}
+function progressLabel(options, context) {
+    var _a;
+    const bot = (_a = options.botName) === null || _a === void 0 ? void 0 : _a.trim();
+    if (bot !== undefined && bot !== "") {
+        return bot;
+    }
+    if (context !== undefined && context.trim() !== "") {
+        return context;
+    }
+    return "Agent";
+}
+/**
+ * Post or update opt-in progress surfaces for a turn phase.
+ * Soft-fails on API errors (same posture as eyes / reply delivery).
+ */
+export function applyGitHubProgress(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const commitStatus = resolveCommitStatusProgress(input.options.progress);
+        const banner = resolveBannerProgress(input.options.progress);
+        if (commitStatus === null && banner === null) {
+            return;
+        }
+        const tasks = [];
+        if (commitStatus !== null) {
+            tasks.push(postCommitStatus({
+                phase: input.phase,
+                channel: input.channel,
+                options: input.options,
+                commitStatus,
+            }));
+        }
+        if (banner !== null) {
+            tasks.push(upsertBanner({
+                phase: input.phase,
+                channel: input.channel,
+                options: input.options,
+                banner,
+                context: commitStatus === null || commitStatus === void 0 ? void 0 : commitStatus.context,
+            }));
+        }
+        yield Promise.all(tasks);
+    });
+}
+function postCommitStatus(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const state = input.channel.state;
+        if (state.owner === "" ||
+            state.repo === "" ||
+            state.headSha === null ||
+            state.headSha === "") {
+            return;
+        }
+        const description = clipStatusDescription(progressPhaseCopy({
+            copy: input.commitStatus,
+            phase: input.phase,
+            label: progressLabel(input.options, input.commitStatus.context),
+        }));
+        try {
+            yield createGitHubCommitStatus({
+                api: input.options.api,
+                credentials: input.options.credentials,
+                installationId: (_a = state.installationId) !== null && _a !== void 0 ? _a : undefined,
+                owner: state.owner,
+                repo: state.repo,
+                sha: state.headSha,
+                state: input.phase,
+                context: input.commitStatus.context,
+                description,
+            });
+        }
+        catch (_b) {
+            // Soft-fail: missing token / permission is fine.
+        }
+    });
+}
+function upsertBanner(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const state = input.channel.state;
+        const issueNumber = (_a = state.issueNumber) !== null && _a !== void 0 ? _a : state.pullRequestNumber;
+        if (state.owner === "" || state.repo === "" || issueNumber === null) {
+            return;
+        }
+        const body = formatGitHubOutboundComment(progressPhaseCopy({
+            copy: input.banner,
+            phase: input.phase,
+            label: progressLabel(input.options, input.context),
+        }));
+        const resource = {
+            api: input.options.api,
+            credentials: input.options.credentials,
+            installationId: (_b = state.installationId) !== null && _b !== void 0 ? _b : undefined,
+            owner: state.owner,
+            repo: state.repo,
+        };
+        try {
+            if (state.progressBannerCommentId !== null) {
+                try {
+                    yield updateGitHubIssueComment(Object.assign(Object.assign({}, resource), { body, commentId: state.progressBannerCommentId }));
+                    return;
+                }
+                catch (error) {
+                    if (!(error instanceof GitHubApiError) || error.status !== 404) {
+                        return;
+                    }
+                    // Comment gone; clear sticky id and recreate below.
+                    state.progressBannerCommentId = null;
+                }
+            }
+            const posted = yield createGitHubIssueComment(Object.assign(Object.assign({}, resource), { body,
+                issueNumber }));
+            state.progressBannerCommentId = posted.id;
+        }
+        catch (_c) {
+            // Soft-fail.
+        }
+    });
+}

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

@@ -9,6 +9,8 @@ export interface GitHubChannelState extends GitHubBindingState {
     headSha: string | null;
     baseRef: string | null;
     headRef: string | null;
+    /** Sticky progress banner comment id (issue/PR timeline). */
+    progressBannerCommentId: number | null;
 }
 export declare function emptyGitHubChannelState(overrides?: Partial<GitHubChannelState>): GitHubChannelState;
 /** Build binding fields for an inbound conversation. */

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;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"}
+{"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;CACxC;AAED,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAC1C,kBAAkB,CAoBpB;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

@@ -2,7 +2,7 @@
  * 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);
+    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 }, overrides);
 }
 /** Build binding fields for an inbound conversation. */
 export function githubBindingStateForEvent(input) {

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

@@ -1,7 +1,7 @@
 import type { AgentCloudOptions, ArtifactsApi, AuthContext, AuthPolicy, ChannelEventHandlers, ChannelStartArgs, HostContext } from "../../types.js";
 import type { GitHubApiOptions } from "./api.js";
 import type { GitHubHandle, GitHubThread } from "./binding.js";
-import type { GitHubProgressConfig } from "./defaults.js";
+import type { GitHubProgressConfig } from "./progress.js";
 import type { GitHubChannelState } from "./state.js";
 /** A credential value: a literal or a lazy resolver fetched on demand. */
 export type GitHubCredentialValue = string | (() => string | undefined | Promise<string | undefined>);
@@ -112,6 +112,10 @@ export type GitHubPullRequestPayload = {
     installation?: {
         id?: number;
     } | null;
+    /** Present on `labeled` / `unlabeled` pull_request deliveries. */
+    label?: {
+        name: string;
+    } | null;
 };
 /** Normalized `pull_request` event handed to {@link GitHubPullRequestHook}. */
 export interface GitHubPullRequestEvent {
@@ -128,6 +132,10 @@ export interface GitHubPullRequestEvent {
     /** True when the PR was merged (from the webhook payload). */
     merged: boolean;
     authorLogin?: string;
+    /** Label added/removed on `labeled` / `unlabeled` actions. */
+    label?: {
+        name: string;
+    };
 }
 /** Normalized `issues` event. */
 export interface GitHubIssueEvent {
@@ -339,7 +347,7 @@ export interface GitHubChannelOptions {
          * Token capability tier:
          * - `"read"` — PR/issue/status read
          * - `"pr-write"` (default) — comments / PR+issue write, no `contents:write`
-         * - `"contents-write"` — also push code (host-held; prefer only when needed)
+         * - `"contents-write"` — push code and create commit statuses (host-held)
          */
         permissions?: "read" | "pr-write" | "contents-write";
     };
@@ -391,10 +399,14 @@ export interface GitHubChannelOptions {
     onEvent?: GitHubEventHook;
     /**
      * Override / extend default stream-event handlers (eyes reaction, reply
-     * posting). Handlers you provide replace the matching defaults.
+     * posting, opt-in commit status / banner). Handlers you provide replace
+     * the matching defaults.
      */
     events?: ChannelEventHandlers<GitHubChannelState>;
-    /** Acknowledgement progress surfaces (reactions). */
+    /**
+     * Acknowledgement progress surfaces. Reactions default on; commit status
+     * and sticky banner are opt-in via `commitStatus` / `banner`.
+     */
     progress?: GitHubProgressConfig;
     /**
      * When false, skip posting assistant / error comments back to GitHub.