@cursor/july 0.1.102 → 0.1.104

package/dist/internal/cli-gitlab.js

@@ -0,0 +1,380 @@
+/**
+ * `agent-sdk gitlab …` — replay a merge request into a local `gitlabChannel()`
+ * and list the discovered GitLab channels.
+ *
+ * There is no `gh webhook forward` analogue for GitLab: project hooks POST to
+ * a public URL, so live forwarding needs a tunnel (see `gitlab forward`,
+ * which prints the recipe rather than running one). Replay covers the local
+ * loop without either: it reads the MR over REST (`GITLAB_TOKEN`) and POSTs
+ * GitLab-shaped payloads with `X-Gitlab-Token` set from `--secret` /
+ * `GITLAB_WEBHOOK_SECRET`.
+ */
+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 { randomUUID } from "node:crypto";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve as resolvePath } from "node:path";
+import { channelForwardUrl } from "../channels/github/forward.js";
+import { createGitLabClient, gitlabProjectPathSegment, } from "../channels/gitlab/api.js";
+import { findGitLabChannelTargets, } from "../channels/gitlab/gitlab-channel.js";
+import { GITLAB_SYNTHESIZABLE_EVENTS, parseGitLabMrRef, selectGitLabReplayEvents, synthesizeGitLabEvent, } from "../channels/gitlab/replay.js";
+import { resolveAgentMounts } from "./discovery.js";
+import { CLI_COMMAND_NAME as CLI } from "./distribution.js";
+const DEFAULT_HOST = "127.0.0.1";
+const DEFAULT_PORT = 3000;
+const GITLAB_HELP = `${CLI} gitlab — replay GitLab merge-request webhooks into a local agent
+
+Usage:
+  ${CLI} gitlab replay   <mr_url|group/project!N> [--events a,b,c | *]
+                              [--action A] [--conclusion STATUS] [--comment "…"]
+                              [--dir .] [--slug S] [--channel C]
+                              [--host H] [--port N] [--url URL] [--secret S]
+                              [--dry-run] [--out DIR] [--json]
+  ${CLI} gitlab events   [--dir .] [--host H] [--port N] [--json]
+  ${CLI} gitlab forward  [--dir .] [--host H] [--port N]
+
+Commands:
+  replay    Synthesize webhook payloads from a merge request you can *read*
+            (Reporter access is enough) and POST them to the discovered
+            gitlabChannel()s. Reads the MR over the REST API with GITLAB_TOKEN,
+            builds GitLab-shaped payloads for --events (default merge_request;
+            \`*\` = the channel's declared events: ${GITLAB_SYNTHESIZABLE_EVENTS.join(", ")}),
+            and sets X-Gitlab-Token from --secret / GITLAB_WEBHOOK_SECRET.
+            --dry-run prints them; --out writes them as fixtures.
+  events    List discovered GitLab channels and the object_kinds each accepts.
+  forward   Print the project-hook + tunnel recipe for live deliveries. GitLab
+            has no \`gh webhook forward\` analogue: hooks need a reachable URL.
+
+Prerequisites:
+  - GITLAB_TOKEN with read_api on the project (self-managed: also set
+    GITLAB_API_BASE_URL=https://<host>/api/v4, or pass a full MR URL).
+  - The agent already serving (\`${CLI} serve --dir . --dev\`).
+
+See also: docs/guides/gitlab.md
+`;
+export function cmdGitlab(subcommand, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        switch (subcommand) {
+            case undefined:
+            case "help":
+            case "--help":
+            case "-h":
+                process.stdout.write(GITLAB_HELP);
+                return subcommand === undefined ? 1 : 0;
+            case "replay":
+                return cmdGitlabReplay(options);
+            case "events":
+                return cmdGitlabEvents(options);
+            case "forward":
+                return cmdGitlabForward(options);
+            default:
+                process.stderr.write(`Unknown gitlab subcommand: ${subcommand}\n`);
+                process.stdout.write(GITLAB_HELP);
+                return 1;
+        }
+    });
+}
+function resolveTargets(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c;
+        var _d, _e, _f, _g, _h;
+        const dir = resolvePath(options.dir);
+        const channels = findGitLabChannelTargets(yield resolveAgentMounts(dir));
+        const host = (_d = options.host) !== null && _d !== void 0 ? _d : DEFAULT_HOST;
+        const port = (_e = options.port) !== null && _e !== void 0 ? _e : DEFAULT_PORT;
+        let candidates = channels;
+        if (options.slug !== undefined) {
+            candidates = candidates.filter((c) => c.slug === options.slug);
+        }
+        if (options.channel !== undefined) {
+            candidates = candidates.filter((c) => c.channelId === options.channel);
+        }
+        if (options.url !== undefined && candidates.length > 1) {
+            process.stderr.write("--url targets a single channel; narrow with --slug/--channel\n");
+            return undefined;
+        }
+        if (candidates.length === 0 && options.url === undefined) {
+            process.stderr.write("no GitLab channel found. Author agent/channels/gitlab.ts with gitlabChannel(), or pass --url.\n");
+            return undefined;
+        }
+        if (options.url !== undefined) {
+            return [
+                {
+                    slug: (_f = (_a = candidates[0]) === null || _a === void 0 ? void 0 : _a.slug) !== null && _f !== void 0 ? _f : "",
+                    channelId: (_g = (_b = candidates[0]) === null || _b === void 0 ? void 0 : _b.channelId) !== null && _g !== void 0 ? _g : "",
+                    url: options.url,
+                    events: (_h = (_c = candidates[0]) === null || _c === void 0 ? void 0 : _c.events) !== null && _h !== void 0 ? _h : [],
+                },
+            ];
+        }
+        return candidates.map((c) => ({
+            slug: c.slug,
+            channelId: c.channelId,
+            url: channelForwardUrl({
+                host,
+                port,
+                slug: c.slug,
+                channelId: c.channelId,
+                routePath: c.routePath,
+            }),
+            events: c.events,
+        }));
+    });
+}
+function cmdGitlabReplay(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        var _b;
+        const mrUrl = options.mrUrl;
+        if (mrUrl === undefined || mrUrl === "") {
+            process.stderr.write("gitlab replay needs an MR URL or group/project!N\n");
+            return 1;
+        }
+        const ref = parseGitLabMrRef(mrUrl);
+        if (ref === undefined) {
+            process.stderr.write(`could not parse merge request ref: ${mrUrl}\n`);
+            return 1;
+        }
+        const targets = yield resolveTargets(options);
+        if (targets === undefined) {
+            return 1;
+        }
+        const requested = parseEventList(options.events);
+        const declared = [...new Set(targets.flatMap((target) => target.events))];
+        const { events, unsupported } = selectGitLabReplayEvents(requested, declared);
+        if (unsupported.length > 0) {
+            process.stderr.write(`[agent-sdk] cannot synthesize (skipped): ${unsupported.join(", ")}\n`);
+        }
+        if (events.length === 0) {
+            process.stderr.write("no synthesizable events selected\n");
+            return 1;
+        }
+        // Read the MR — Reporter access is enough.
+        const gitlab = createGitLabClient({
+            apiBaseUrl: ((_a = process.env.GITLAB_API_BASE_URL) === null || _a === void 0 ? void 0 : _a.trim()) || `${ref.origin}/api/v4`,
+        });
+        const projectSegment = gitlabProjectPathSegment(ref.projectPath);
+        let project;
+        let mergeRequest;
+        try {
+            project = yield gitlab.request({
+                method: "GET",
+                path: `/projects/${projectSegment}`,
+            });
+            mergeRequest = yield gitlab.request({
+                method: "GET",
+                path: `/projects/${projectSegment}/merge_requests/${ref.iid}`,
+            });
+        }
+        catch (error) {
+            process.stderr.write(`failed to read ${ref.label} via ${gitlab.apiBaseUrl}: ${error instanceof Error ? error.message : String(error)}\n`);
+            return 1;
+        }
+        let pipeline;
+        if (events.includes("pipeline")) {
+            pipeline = yield gitlab
+                .request({
+                method: "GET",
+                path: `/projects/${projectSegment}/merge_requests/${ref.iid}/pipelines`,
+            })
+                .then((list) => list[0])
+                .catch(() => undefined);
+        }
+        const synthesized = [];
+        for (const event of events) {
+            const result = synthesizeGitLabEvent({
+                event,
+                project,
+                mergeRequest,
+                action: options.action,
+                comment: options.comment,
+                status: options.conclusion,
+                pipeline,
+            });
+            if ("error" in result) {
+                process.stderr.write(`[agent-sdk] skipping ${event}: ${result.error}\n`);
+                continue;
+            }
+            synthesized.push(result);
+        }
+        if (synthesized.length === 0) {
+            process.stderr.write("nothing to replay after synthesis\n");
+            return 1;
+        }
+        const secret = (_b = options.secret) !== null && _b !== void 0 ? _b : process.env.GITLAB_WEBHOOK_SECRET;
+        process.stderr.write(`[agent-sdk] replaying ${ref.label} (${synthesized
+            .map(eventLabel)
+            .join(", ")}) → ${targets.length} channel${targets.length === 1 ? "" : "s"}\n`);
+        const report = [];
+        let anyRejected = false;
+        for (const event of synthesized) {
+            const body = JSON.stringify(event.payload);
+            const headers = {
+                "content-type": "application/json",
+                "x-gitlab-event": event.header,
+                "x-gitlab-event-uuid": randomUUID(),
+            };
+            if (secret !== undefined && secret !== "") {
+                headers["x-gitlab-token"] = secret;
+            }
+            if (options.out !== undefined) {
+                const file = yield writeReplayFixture(options.out, event);
+                process.stderr.write(`[agent-sdk] wrote ${file}\n`);
+            }
+            const label = eventLabel(event);
+            if (options.dryRun === true) {
+                report.push(Object.assign(Object.assign({}, eventReport(event)), { payload: event.payload }));
+                if (options.json !== true) {
+                    process.stdout.write(`--- ${label} ---\n${JSON.stringify(event.payload, null, 2)}\n`);
+                }
+                continue;
+            }
+            const deliveries = yield deliverReplayEvent(body, headers, event.eventName, targets);
+            if (deliveries.length === 0 || deliveries.some((d) => !d.ok)) {
+                anyRejected = true;
+            }
+            report.push(Object.assign(Object.assign({}, eventReport(event)), { deliveries }));
+            if (options.json !== true) {
+                const summary = deliveries
+                    .map((d) => `${d.label} ${d.status || "ERR"}${d.ok ? "" : " (rejected)"}`)
+                    .join(", ") || "(no matching channel)";
+                process.stderr.write(`[agent-sdk]   ${label} → ${summary}\n`);
+            }
+        }
+        if (options.json === true) {
+            process.stdout.write(`${JSON.stringify({ mr: ref.label, dryRun: options.dryRun === true, events: report }, null, 2)}\n`);
+        }
+        return anyRejected ? 1 : 0;
+    });
+}
+function deliverReplayEvent(body, headers, eventName, targets) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const recipients = targets.filter((target) => target.events.length === 0 || target.events.includes(eventName));
+        return Promise.all(recipients.map((target) => __awaiter(this, void 0, void 0, function* () {
+            const label = target.slug === ""
+                ? target.channelId
+                : `${target.slug}/${target.channelId}`;
+            try {
+                const response = yield fetch(target.url, {
+                    method: "POST",
+                    headers,
+                    body,
+                });
+                yield response.text().catch(() => undefined);
+                return { label, status: response.status, ok: response.ok };
+            }
+            catch (error) {
+                return {
+                    label,
+                    status: 0,
+                    ok: false,
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+        })));
+    });
+}
+function eventLabel(event) {
+    return event.action === undefined
+        ? event.eventName
+        : `${event.eventName}.${event.action}`;
+}
+function eventReport(event) {
+    return { event: event.eventName, action: event.action };
+}
+function writeReplayFixture(outDir, event) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const dir = resolvePath(outDir);
+        yield mkdir(dir, { recursive: true });
+        const file = join(dir, `gitlab-${eventLabel(event)}.json`);
+        yield writeFile(file, `${JSON.stringify(event.payload, null, 2)}\n`);
+        return file;
+    });
+}
+function cmdGitlabEvents(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const dir = resolvePath(options.dir);
+        const channels = findGitLabChannelTargets(yield resolveAgentMounts(dir));
+        const host = (_a = options.host) !== null && _a !== void 0 ? _a : DEFAULT_HOST;
+        const port = (_b = options.port) !== null && _b !== void 0 ? _b : DEFAULT_PORT;
+        const rows = channels.map((c) => ({
+            slug: c.slug,
+            channelId: c.channelId,
+            url: channelForwardUrl({
+                host,
+                port,
+                slug: c.slug,
+                channelId: c.channelId,
+                routePath: c.routePath,
+            }),
+            events: c.events,
+        }));
+        if (options.json === true) {
+            process.stdout.write(`${JSON.stringify({ channels: rows }, null, 2)}\n`);
+            return 0;
+        }
+        if (rows.length === 0) {
+            process.stdout.write("no GitLab channels found\n");
+            return 0;
+        }
+        for (const row of rows) {
+            const label = row.slug === "" ? row.channelId : `${row.slug}/${row.channelId}`;
+            process.stdout.write(`${label}\n  ${row.url}\n  ${row.events.join(", ")}\n`);
+        }
+        return 0;
+    });
+}
+function cmdGitlabForward(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const dir = resolvePath(options.dir);
+        const channels = findGitLabChannelTargets(yield resolveAgentMounts(dir));
+        const host = (_a = options.host) !== null && _a !== void 0 ? _a : DEFAULT_HOST;
+        const port = (_b = options.port) !== null && _b !== void 0 ? _b : DEFAULT_PORT;
+        if (channels.length === 0) {
+            process.stderr.write("no GitLab channel found. Author agent/channels/gitlab.ts with gitlabChannel().\n");
+            return 1;
+        }
+        const lines = [
+            "GitLab project hooks deliver to a public URL; there is no local relay.",
+            "To receive live deliveries:",
+            "",
+            `  1. Expose the agent: e.g. \`cloudflared tunnel --url http://${host}:${port}\``,
+            "     (or ngrok / any HTTPS tunnel) and note the public base URL.",
+            "  2. In GitLab → Project → Settings → Webhooks, add one hook per channel:",
+        ];
+        for (const c of channels) {
+            const path = channelForwardUrl({
+                host,
+                port,
+                slug: c.slug,
+                channelId: c.channelId,
+                routePath: c.routePath,
+            }).replace(`http://${host}:${port}`, "<tunnel>");
+            lines.push(`       URL:     ${path}`);
+            lines.push(`       Trigger: ${c.events.join(", ")}`);
+            lines.push("       Secret token: the value of GITLAB_WEBHOOK_SECRET (or webhookSecret)");
+        }
+        lines.push("", `  3. Serve with the secret set so X-Gitlab-Token is verified:`, `     GITLAB_WEBHOOK_SECRET=… ${CLI} serve --dir . --dev`, "", `Without a tunnel, \`${CLI} gitlab replay <mr_url>\` exercises the same channel locally.`, "");
+        process.stdout.write(lines.join("\n"));
+        return 0;
+    });
+}
+function parseEventList(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const events = value
+        .split(/[\s,]+/)
+        .map((event) => event.trim())
+        .filter(Boolean);
+    return events.length === 0 ? undefined : events;
+}

package/dist/internal/cli-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-mcp.d.ts","sourceRoot":"","sources":["../../src/internal/cli-mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAGL,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AA0BlC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,qBAAqB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACjD,qBAAqB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC3C,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,wBAAsB,MAAM,CAC1B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,aAAa,GAAG;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAMD,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFzE;AAwRD,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA4G3E;AAoGD,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE,MAAsC,GAC3C,MAAM,CAGR;AAqED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQnD"}
+{"version":3,"file":"cli-mcp.d.ts","sourceRoot":"","sources":["../../src/internal/cli-mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAGL,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AA2BlC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,qBAAqB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACjD,qBAAqB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC3C,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,wBAAsB,MAAM,CAC1B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,aAAa,GAAG;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACA,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAMD,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFzE;AAwRD,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA4G3E;AAoGD,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE,MAAsC,GAC3C,MAAM,CAGR;AAqED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQnD"}

package/dist/internal/cli-mcp.js

@@ -41,6 +41,7 @@ import { resolveDeployAuth } from "./cli-deploy.js";
 import { DeployApiError } from "./deploy-client.js";
 import { CLI_COMMAND_NAME as CLI, LOG_PREFIX } from "./distribution.js";
 import { ProdTargetError, resolveProdSlug, resolveProdTarget, } from "./resolve-prod-target.js";
+import { sleep as defaultSleep } from "./sleep.js";
 /** Mount path of the MCP surface relative to an agent base URL. */
 const MCP_PATH = "/v1/mcp";
 /** Re-mint engineAccess when within this window of `expiresAt`. */
@@ -119,7 +120,7 @@ export function cmdMcpServe(options) {
         const stdin = (_b = options.stdin) !== null && _b !== void 0 ? _b : process.stdin;
         const stdout = (_c = options.stdout) !== null && _c !== void 0 ? _c : process.stdout;
         const fetchImpl = (_d = options.fetchImpl) !== null && _d !== void 0 ? _d : fetch;
-        const sleep = (_e = options.sleep) !== null && _e !== void 0 ? _e : sleepMs;
+        const sleep = (_e = options.sleep) !== null && _e !== void 0 ? _e : defaultSleep;
         const pending = new Set();
         const handleLine = (line) => __awaiter(this, void 0, void 0, function* () {
             const outcome = yield forwardMessage({ source, fetchImpl, sleep, line });
@@ -679,8 +680,3 @@ function describeError(error) {
 function defaultErr(text) {
     process.stderr.write(text);
 }
-function sleepMs(ms) {
-    return new Promise((resolve) => {
-        setTimeout(resolve, ms);
-    });
-}

package/dist/internal/cli-slack.d.ts

@@ -1,5 +1,5 @@
 /**
- * `agent-serve slack …` CLI — doctor, destroy/icon, `create` as a
+ * `agent-sdk slack …` CLI — doctor, destroy/icon, `create` as a
  * dashboard-wizard launcher (`slack-provision-client.ts`), and
  * `init --manual` for Slack CLI / paste-at-api.slack.com manifests.
  */

package/dist/internal/cli-slack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-slack.d.ts","sourceRoot":"","sources":["../../src/internal/cli-slack.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAIL,cAAc,EAGf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAoB/B,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,cAAc,CAAC;IACnC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAmDD,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CA2CjB;AA6RD,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAoLjB;AAiDD,wBAAsB,eAAe,CACnC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsD5E"}
+{"version":3,"file":"cli-slack.d.ts","sourceRoot":"","sources":["../../src/internal/cli-slack.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAIL,cAAc,EAGf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAqB/B,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,cAAc,CAAC;IACnC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAmDD,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CA2CjB;AA6RD,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAoLjB;AAiDD,wBAAsB,eAAe,CACnC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsD5E"}

package/dist/internal/cli-slack.js

@@ -1,5 +1,5 @@
 /**
- * `agent-serve slack …` CLI — doctor, destroy/icon, `create` as a
+ * `agent-sdk slack …` CLI — doctor, destroy/icon, `create` as a
  * dashboard-wizard launcher (`slack-provision-client.ts`), and
  * `init --manual` for Slack CLI / paste-at-api.slack.com manifests.
  */
@@ -26,6 +26,7 @@ import { ensureEnvLocalGitignored, upsertEnvFile } from "./env-file.js";
 import { loadAgentLocalEnv } from "./local-env.js";
 import { openBrowser } from "./open-browser.js";
 import { AgentServeSlackClient, SlackProvisionApiError, } from "./slack-provision-client.js";
+import { sleep } from "./sleep.js";
 import { stderrPalette } from "./terminal-style.js";
 const SLACK_HELP = `${CLI} slack — Slack channel pack helpers (Socket Mode)
 
@@ -664,6 +665,3 @@ function fileExists(path) {
 function isErrnoException(error) {
     return error instanceof Error && "code" in error;
 }
-function sleep(ms) {
-    return new Promise((resolvePromise) => setTimeout(resolvePromise, ms));
-}

package/dist/internal/continuation-channel.d.ts

@@ -6,8 +6,10 @@ export declare function httpContinuationIdentity(httpChannel: HttpChannelDefinit
  * Stamp `/v2` continuation defaults onto channel constructors that omitted
  * `continuation` when the agent deploys onto v2 architecture. GitHub/Origin
  * type (`pr` / `issue` / `none`) follows declared webhook events.
- * Deployments default to `deployments.deployment/v2`. Explicit per-channel
- * selectors are left alone. Idempotent.
+ * Deployments default to `deployments.deployment/v2`. Change Monitors
+ * and issues default to `change_monitors.checkpoint/v2` and
+ * `issues.issue/v2`.
+ * Explicit per-channel selectors are left alone. Idempotent.
  */
 export declare function applyAgentContinuationDefaults(project: {
     agent: {
@@ -18,6 +20,20 @@ export declare function applyAgentContinuationDefaults(project: {
     }>;
     httpChannel: HttpChannelDefinition;
 }): void;
+/**
+ * Warn when an omitted `/v2` selector became type `none` because one
+ * declared event sits outside the kind membership. Call before
+ * {@link applyAgentContinuationDefaults} so the omitted field is still
+ * visible. An explicit `*.none/v2` pin stays silent.
+ */
+export declare function warnOmittedContinuationDowngrades(input: {
+    architecture?: AgentArchitecture;
+    channels: ReadonlyArray<{
+        id: string;
+        definition: object;
+    }>;
+    warn: (id: string, message: string) => void;
+}): void;
 /** Kind-specific event lists on `ChannelMeta`; a definition sets at most one. */
 export declare function channelDeclaredEventTypes(meta: ChannelMeta | undefined): readonly string[] | undefined;
 export declare function handshakeChannelContinuation(input: {

package/dist/internal/continuation-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"continuation-channel.d.ts","sourceRoot":"","sources":["../../src/internal/continuation-channel.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,oBAAoB,EAK1B,MAAM,4BAA4B,CAAC;AAiCpC,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,oBAAoB,CAWtB;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,qBAAqB,GAAG,SAAS,GAC7C,oBAAoB,CAEtB;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,KAAK,EAAE;QAAE,YAAY,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE,aAAa,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,WAAW,EAAE,qBAAqB,CAAC;CACpC,GAAG,IAAI,CAaP;AAyBD,iFAAiF;AACjF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,WAAW,GAAG,SAAS,GAC5B,SAAS,MAAM,EAAE,GAAG,SAAS,CAM/B;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,iBAAiB,CAAC;CAC/B,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAY9C"}
+{"version":3,"file":"continuation-channel.d.ts","sourceRoot":"","sources":["../../src/internal/continuation-channel.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,oBAAoB,EAO1B,MAAM,4BAA4B,CAAC;AA6DpC,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,oBAAoB,CAWtB;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,qBAAqB,GAAG,SAAS,GAC7C,oBAAoB,CAEtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,KAAK,EAAE;QAAE,YAAY,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE,aAAa,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,WAAW,EAAE,qBAAqB,CAAC;CACpC,GAAG,IAAI,CAaP;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,QAAQ,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C,GAAG,IAAI,CA6BP;AA2CD,iFAAiF;AACjF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,WAAW,GAAG,SAAS,GAC5B,SAAS,MAAM,EAAE,GAAG,SAAS,CAS/B;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,iBAAiB,CAAC;CAC/B,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAY9C"}

package/dist/internal/continuation-channel.js

@@ -1,9 +1,23 @@
+import { getBitbucketChannelOptions } from "../channels/bitbucket/bitbucket-channel.js";
+import { getChangeMonitorsChannelOptions } from "../channels/change-monitors/change-monitors-channel.js";
 import { getDeploymentsChannelOptions } from "../channels/deployments/deployments-channel.js";
 import { getGitHubChannelOptions } from "../channels/github/github-channel.js";
+import { getGitLabChannelOptions } from "../channels/gitlab/gitlab-channel.js";
+import { getIssuesChannelOptions } from "../channels/issues/issues-channel.js";
 import { getOriginChannelOptions } from "../channels/origin/origin-channel.js";
 import { getSlackChannelOptions } from "../channels/slack/slack-channel.js";
-import { defaultContinuationSelector, handshakeContinuation, normalizeIdentity, } from "./continuation-identity.js";
+import { defaultContinuationSelector, handshakeContinuation, normalizeIdentity, omittedV2MembershipDowngrade, omittedV2TypedType, } from "./continuation-identity.js";
 const CONTINUATION_CHANNEL_PACKS = [
+    {
+        kind: "gitlab",
+        getOptions: getGitLabChannelOptions,
+        usesDeclaredEvents: true,
+    },
+    {
+        kind: "bitbucket",
+        getOptions: getBitbucketChannelOptions,
+        usesDeclaredEvents: true,
+    },
     {
         kind: "github",
         getOptions: getGitHubChannelOptions,
@@ -24,6 +38,16 @@ const CONTINUATION_CHANNEL_PACKS = [
         getOptions: getDeploymentsChannelOptions,
         usesDeclaredEvents: true,
     },
+    {
+        kind: "change_monitors",
+        getOptions: getChangeMonitorsChannelOptions,
+        usesDeclaredEvents: true,
+    },
+    {
+        kind: "issues",
+        getOptions: getIssuesChannelOptions,
+        usesDeclaredEvents: true,
+    },
 ];
 export function channelContinuationIdentity(definition) {
     if (definition === undefined) {
@@ -44,8 +68,10 @@ export function httpContinuationIdentity(httpChannel) {
  * Stamp `/v2` continuation defaults onto channel constructors that omitted
  * `continuation` when the agent deploys onto v2 architecture. GitHub/Origin
  * type (`pr` / `issue` / `none`) follows declared webhook events.
- * Deployments default to `deployments.deployment/v2`. Explicit per-channel
- * selectors are left alone. Idempotent.
+ * Deployments default to `deployments.deployment/v2`. Change Monitors
+ * and issues default to `change_monitors.checkpoint/v2` and
+ * `issues.issue/v2`.
+ * Explicit per-channel selectors are left alone. Idempotent.
  */
 export function applyAgentContinuationDefaults(project) {
     if (project.agent.architecture !== "v2") {
@@ -58,6 +84,42 @@ export function applyAgentContinuationDefaults(project) {
         project.httpChannel.continuation = defaultContinuationSelector("http", "v2");
     }
 }
+/**
+ * Warn when an omitted `/v2` selector became type `none` because one
+ * declared event sits outside the kind membership. Call before
+ * {@link applyAgentContinuationDefaults} so the omitted field is still
+ * visible. An explicit `*.none/v2` pin stays silent.
+ */
+export function warnOmittedContinuationDowngrades(input) {
+    if (input.architecture !== "v2") {
+        return;
+    }
+    for (const channel of input.channels) {
+        const events = channelDeclaredEventTypes(channel.definition.meta);
+        for (const pack of CONTINUATION_CHANNEL_PACKS) {
+            const options = pack.getOptions(channel.definition);
+            if (options === undefined) {
+                continue;
+            }
+            if (options.continuation !== undefined) {
+                break;
+            }
+            const downgrade = omittedV2MembershipDowngrade(pack.kind, pack.usesDeclaredEvents ? events : undefined);
+            if (downgrade !== undefined) {
+                input.warn(channel.id, omittedContinuationDowngradeMessage(pack.kind, downgrade));
+            }
+            break;
+        }
+    }
+}
+function omittedContinuationDowngradeMessage(kind, downgrade) {
+    var _a;
+    const membership = (_a = omittedV2TypedType(kind)) !== null && _a !== void 0 ? _a : kind;
+    return (`omitted continuation stamped ${downgrade.selector} because ` +
+        `${downgrade.unexpected.join(", ")} ${downgrade.unexpected.length === 1 ? "is" : "are"} not in the ${membership} membership; every delivery on this ` +
+        `channel starts a fresh session. Pin continuation: "${downgrade.selector}" ` +
+        `if that is intended, or drop the event.`);
+}
 function stampOmittedChannelContinuation(definition, version) {
     const events = channelDeclaredEventTypes(definition.meta);
     for (const pack of CONTINUATION_CHANNEL_PACKS) {
@@ -73,8 +135,8 @@ function stampOmittedChannelContinuation(definition, version) {
 }
 /** Kind-specific event lists on `ChannelMeta`; a definition sets at most one. */
 export function channelDeclaredEventTypes(meta) {
-    var _a, _b;
-    return ((_b = (_a = meta === null || meta === void 0 ? void 0 : meta.githubWebhookEvents) !== null && _a !== void 0 ? _a : meta === null || meta === void 0 ? void 0 : meta.originWebhookEvents) !== null && _b !== void 0 ? _b : meta === null || meta === void 0 ? void 0 : meta.deploymentEventTypes);
+    var _a, _b, _c, _d, _e;
+    return ((_e = (_d = (_c = (_b = (_a = meta === null || meta === void 0 ? void 0 : meta.githubWebhookEvents) !== null && _a !== void 0 ? _a : meta === null || meta === void 0 ? void 0 : meta.originWebhookEvents) !== null && _b !== void 0 ? _b : meta === null || meta === void 0 ? void 0 : meta.gitlabWebhookEvents) !== null && _c !== void 0 ? _c : meta === null || meta === void 0 ? void 0 : meta.bitbucketWebhookEvents) !== null && _d !== void 0 ? _d : meta === null || meta === void 0 ? void 0 : meta.deploymentEventTypes) !== null && _e !== void 0 ? _e : meta === null || meta === void 0 ? void 0 : meta.factoryEventTypes);
 }
 export function handshakeChannelContinuation(input) {
     var _a;