@cursor/july 0.1.79 → 0.1.82

package/dist/internal/continuation-channel.js

@@ -0,0 +1,88 @@
+import { getGitHubChannelOptions } from "../channels/github/github-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";
+export function channelContinuationIdentity(definition) {
+    if (definition === undefined) {
+        return defaultContinuationSelector();
+    }
+    const github = getGitHubChannelOptions(definition);
+    if (github !== undefined) {
+        return normalizeIdentity(github.continuation, "github");
+    }
+    const slack = getSlackChannelOptions(definition);
+    if (slack !== undefined) {
+        return normalizeIdentity(slack.continuation, "slack");
+    }
+    const origin = getOriginChannelOptions(definition);
+    if (origin !== undefined) {
+        return normalizeIdentity(origin.continuation, "origin");
+    }
+    return defaultContinuationSelector();
+}
+export function httpContinuationIdentity(httpChannel) {
+    return normalizeIdentity(httpChannel === null || httpChannel === void 0 ? void 0 : httpChannel.continuation, "http");
+}
+/**
+ * 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. Explicit
+ * per-channel selectors are left alone. Idempotent.
+ */
+export function applyAgentContinuationDefaults(project) {
+    if (project.agent.architecture !== "v2") {
+        return;
+    }
+    for (const channel of project.channels) {
+        stampOmittedChannelContinuation(channel.definition, "v2");
+    }
+    if (project.httpChannel.continuation === undefined) {
+        project.httpChannel.continuation = defaultContinuationSelector("http", "v2");
+    }
+}
+function stampOmittedChannelContinuation(definition, version) {
+    const events = declaredChannelEventTypes(definition);
+    const github = getGitHubChannelOptions(definition);
+    if (github !== undefined) {
+        if (github.continuation === undefined) {
+            github.continuation = defaultContinuationSelector("github", version, events);
+        }
+        return;
+    }
+    const slack = getSlackChannelOptions(definition);
+    if (slack !== undefined) {
+        if (slack.continuation === undefined) {
+            slack.continuation = defaultContinuationSelector("slack", version);
+        }
+        return;
+    }
+    const origin = getOriginChannelOptions(definition);
+    if (origin !== undefined) {
+        if (origin.continuation === undefined) {
+            origin.continuation = defaultContinuationSelector("origin", version, events);
+        }
+    }
+}
+function declaredChannelEventTypes(definition) {
+    var _a;
+    const meta = definition.meta;
+    return (_a = meta === null || meta === void 0 ? void 0 : meta.githubWebhookEvents) !== null && _a !== void 0 ? _a : meta === null || meta === void 0 ? void 0 : meta.originWebhookEvents;
+}
+export function handshakeChannelContinuation(input) {
+    var _a, _b, _c;
+    var _d, _e;
+    const kind = (_a = input.definition.meta) === null || _a === void 0 ? void 0 : _a.kind;
+    const eventTypes = [
+        ...((_d = (_b = input.definition.meta) === null || _b === void 0 ? void 0 : _b.githubWebhookEvents) !== null && _d !== void 0 ? _d : []),
+        ...((_e = (_c = input.definition.meta) === null || _c === void 0 ? void 0 : _c.originWebhookEvents) !== null && _e !== void 0 ? _e : []),
+    ];
+    const result = handshakeContinuation({
+        kind,
+        eventTypes,
+        identity: channelContinuationIdentity(input.definition),
+    });
+    if (!result.ok) {
+        return { ok: false, error: `channel ${input.id}: ${result.error}` };
+    }
+    return result;
+}

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

@@ -0,0 +1,95 @@
+/**
+ * Continuation identity is a closed selector string. Omitted `continuation`
+ * on a channel constructor stays `/v1` (engine pack minting) so existing
+ * agents do not change: `githubChannel()` → `github.pr/v1`, `slackChannel()`
+ * → `slack.thread/v1`, `originChannel()` → `origin.pr/v1`, `httpChannel()`
+ * → `none/v1`.
+ *
+ * Opt the whole agent into the v2 control plane with
+ * `defineAgent({ architecture: "v2" })`. That stamps `/v2` defaults from
+ * the channel kind and declared events (`github.pr/v2`, `github.issue/v2`,
+ * `github.none/v2`, `slack.thread/v2`, …) onto every channel that omitted
+ * a selector. An explicit per-channel selector still overrides. JSONPath
+ * and per-agent format strings are rejected.
+ */
+export type ConversationType = "pr" | "issue" | "thread" | "origin-pr";
+export declare const CONTINUATION_SELECTORS: readonly ["github.pr/v1", "github.pr/v2", "github.issue/v1", "github.issue/v2", "github.none/v2", "slack.thread/v1", "slack.thread/v2", "slack.none/v2", "origin.pr/v1", "origin.pr/v2", "origin.none/v2", "none/v1", "none/v2"];
+export type ContinuationSelector = (typeof CONTINUATION_SELECTORS)[number];
+export type ContinuationIdentity = ContinuationSelector;
+/** Agent-root protocol version. Omit / `"v1"` keeps engine minting. */
+export type ContinuationProtocolVersion = "v1" | "v2";
+export type ParsedContinuation = {
+    selector: ContinuationSelector;
+    version: 1 | 2;
+    type: ConversationType | "none";
+    kind: "github" | "slack" | "origin" | "http";
+};
+export type ContinuationClaim = {
+    type: ConversationType;
+    resource: {
+        owner: string;
+        repo: string;
+        number: number;
+    } | {
+        channelId: string;
+        threadTs: string;
+    } | {
+        fullName: string;
+        number: number;
+    };
+};
+export type MailboxContinuation = {
+    key: string;
+};
+export type ContinuationBuiltin = {
+    type: ConversationType;
+    kind: "github" | "slack" | "origin";
+    events: readonly string[];
+    format: string;
+};
+export declare const BUILTINS: readonly ContinuationBuiltin[];
+export declare class V2EngineError extends Error {
+    constructor(message: string);
+}
+export declare function isContinuationSelector(value: string): value is ContinuationSelector;
+export declare function defaultContinuationSelector(kind?: string, version?: ContinuationProtocolVersion, eventTypes?: readonly string[]): ContinuationSelector;
+export declare function parseContinuationSelector(selector: string): ParsedContinuation | undefined;
+export declare function resolveContinuation(raw?: ContinuationIdentity, kind?: string): ParsedContinuation;
+export declare function normalizeIdentity(raw?: ContinuationIdentity, kind?: string): ContinuationIdentity;
+export declare function continuationSource(identity?: ContinuationIdentity, kind?: string): "engine" | "control-plane";
+export declare function isV2DurableContinuationKey(key: string): boolean;
+export declare function newEvtKey(): string;
+export declare function builtinForType(type: ConversationType): ContinuationBuiltin | undefined;
+export declare function formatConversationKey(type: ConversationType, fields: {
+    fullName?: string;
+    number?: number;
+    channelId?: string;
+    threadTs?: string;
+}): string;
+export declare function mintClaim(claim: ContinuationClaim): string;
+export declare function handshakeContinuation(input: {
+    kind?: string;
+    eventTypes?: readonly string[];
+    identity?: ContinuationIdentity;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * CP/pack extract. Returns a `cont:` key when the payload binds the
+ * identity type; undefined on membership miss or missing number (caller
+ * stamps `evt:` and does not join the conversation index).
+ */
+export declare function extractContinuation(type: ConversationType, eventName: string, payload: unknown): string | undefined;
+export declare function stampMailboxContinuation(identity: ContinuationIdentity, eventName: string, payload: unknown, kind?: string): MailboxContinuation;
+export declare function resolveV2Key(identity: ContinuationIdentity, options: {
+    claim?: ContinuationClaim;
+    continuationToken?: string;
+    mailboxContinuation?: MailboxContinuation;
+}, kind?: string): string;
+export declare function bindMailboxContinuationSend<TSession, TOptions extends {
+    mailboxContinuation?: MailboxContinuation;
+}>(send: (message: string, options?: TOptions) => Promise<TSession>, mailbox: MailboxContinuation | undefined): (message: string, options?: TOptions) => Promise<TSession>;
+//# sourceMappingURL=continuation-identity.d.ts.map

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

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

package/dist/internal/continuation-identity.js

@@ -0,0 +1,445 @@
+/**
+ * Continuation identity is a closed selector string. Omitted `continuation`
+ * on a channel constructor stays `/v1` (engine pack minting) so existing
+ * agents do not change: `githubChannel()` → `github.pr/v1`, `slackChannel()`
+ * → `slack.thread/v1`, `originChannel()` → `origin.pr/v1`, `httpChannel()`
+ * → `none/v1`.
+ *
+ * Opt the whole agent into the v2 control plane with
+ * `defineAgent({ architecture: "v2" })`. That stamps `/v2` defaults from
+ * the channel kind and declared events (`github.pr/v2`, `github.issue/v2`,
+ * `github.none/v2`, `slack.thread/v2`, …) onto every channel that omitted
+ * a selector. An explicit per-channel selector still overrides. JSONPath
+ * and per-agent format strings are rejected.
+ */
+import { randomBytes } from "node:crypto";
+export const CONTINUATION_SELECTORS = [
+    "github.pr/v1",
+    "github.pr/v2",
+    "github.issue/v1",
+    "github.issue/v2",
+    "github.none/v2",
+    "slack.thread/v1",
+    "slack.thread/v2",
+    "slack.none/v2",
+    "origin.pr/v1",
+    "origin.pr/v2",
+    "origin.none/v2",
+    "none/v1",
+    "none/v2",
+];
+export const BUILTINS = [
+    {
+        type: "pr",
+        kind: "github",
+        events: [
+            "pull_request",
+            "issue_comment",
+            "pull_request_review",
+            "pull_request_review_comment",
+            "check_suite",
+            "check_run",
+        ],
+        format: "github-pr:{fullName}#{number}",
+    },
+    {
+        type: "issue",
+        kind: "github",
+        events: ["issues", "issue_comment"],
+        format: "github-issue:{fullName}#{number}",
+    },
+    {
+        type: "thread",
+        kind: "slack",
+        events: ["message", "app_mention"],
+        format: "{channelId}:{threadTs}",
+    },
+    {
+        type: "origin-pr",
+        kind: "origin",
+        events: [
+            "pull_request.created",
+            "pull_request.published",
+            "pull_request.head_ref.pushed",
+            "pull_request.base_ref.updated",
+            "pull_request.closed",
+            "pull_request.merged",
+            "pull_request.comment.created",
+            "pull_request.review.submitted",
+        ],
+        format: "origin-pr:{fullName}#{number}",
+    },
+];
+export class V2EngineError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "V2EngineError";
+    }
+}
+const SELECTOR_FIELDS = {
+    "github.pr/v1": { version: 1, type: "pr", kind: "github" },
+    "github.pr/v2": { version: 2, type: "pr", kind: "github" },
+    "github.issue/v1": { version: 1, type: "issue", kind: "github" },
+    "github.issue/v2": { version: 2, type: "issue", kind: "github" },
+    "github.none/v2": { version: 2, type: "none", kind: "github" },
+    "slack.thread/v1": { version: 1, type: "thread", kind: "slack" },
+    "slack.thread/v2": { version: 2, type: "thread", kind: "slack" },
+    "slack.none/v2": { version: 2, type: "none", kind: "slack" },
+    "origin.pr/v1": { version: 1, type: "origin-pr", kind: "origin" },
+    "origin.pr/v2": { version: 2, type: "origin-pr", kind: "origin" },
+    "origin.none/v2": { version: 2, type: "none", kind: "origin" },
+    "none/v1": { version: 1, type: "none", kind: "http" },
+    "none/v2": { version: 2, type: "none", kind: "http" },
+};
+export function isContinuationSelector(value) {
+    return Object.hasOwn(SELECTOR_FIELDS, value);
+}
+export function defaultContinuationSelector(kind, version = "v1", eventTypes) {
+    if (version !== "v2") {
+        switch (kind) {
+            case "github":
+                return "github.pr/v1";
+            case "slack":
+                return "slack.thread/v1";
+            case "origin":
+                return "origin.pr/v1";
+            default:
+                return "none/v1";
+        }
+    }
+    switch (kind) {
+        case "github":
+            return githubV2Default(eventTypes);
+        case "slack":
+            return "slack.thread/v2";
+        case "origin":
+            return originV2Default(eventTypes);
+        default:
+            return "none/v2";
+    }
+}
+function githubV2Default(eventTypes) {
+    var _a, _b;
+    var _c, _d;
+    const events = eventTypes !== null && eventTypes !== void 0 ? eventTypes : [];
+    const issueEvents = new Set((_c = (_a = builtinForType("issue")) === null || _a === void 0 ? void 0 : _a.events) !== null && _c !== void 0 ? _c : []);
+    const prEvents = new Set((_d = (_b = builtinForType("pr")) === null || _b === void 0 ? void 0 : _b.events) !== null && _d !== void 0 ? _d : []);
+    if (events.length > 0 && events.every((event) => issueEvents.has(event))) {
+        return "github.issue/v2";
+    }
+    if (events.some((event) => !prEvents.has(event))) {
+        return "github.none/v2";
+    }
+    return "github.pr/v2";
+}
+function originV2Default(eventTypes) {
+    var _a;
+    var _b;
+    const events = eventTypes !== null && eventTypes !== void 0 ? eventTypes : [];
+    const prEvents = new Set((_b = (_a = builtinForType("origin-pr")) === null || _a === void 0 ? void 0 : _a.events) !== null && _b !== void 0 ? _b : []);
+    if (events.some((event) => !prEvents.has(event))) {
+        return "origin.none/v2";
+    }
+    return "origin.pr/v2";
+}
+export function parseContinuationSelector(selector) {
+    if (!isContinuationSelector(selector)) {
+        return undefined;
+    }
+    return Object.assign({ selector }, SELECTOR_FIELDS[selector]);
+}
+export function resolveContinuation(raw, kind) {
+    const selector = raw !== null && raw !== void 0 ? raw : defaultContinuationSelector(kind);
+    const parsed = parseContinuationSelector(selector);
+    if (parsed === undefined) {
+        throw new V2EngineError(`v2: invalid continuation selector ${JSON.stringify(selector)}`);
+    }
+    return parsed;
+}
+export function normalizeIdentity(raw, kind) {
+    return resolveContinuation(raw, kind).selector;
+}
+export function continuationSource(identity, kind) {
+    return resolveContinuation(identity, kind).version === 2
+        ? "control-plane"
+        : "engine";
+}
+export function isV2DurableContinuationKey(key) {
+    return key.startsWith("cont:") || key.startsWith("evt:");
+}
+export function newEvtKey() {
+    return `evt:${randomBytes(16).toString("hex")}`;
+}
+export function builtinForType(type) {
+    return BUILTINS.find((builtin) => builtin.type === type);
+}
+export function formatConversationKey(type, fields) {
+    switch (type) {
+        case "pr":
+            return `github-pr:${fields.fullName}#${fields.number}`;
+        case "issue":
+            return `github-issue:${fields.fullName}#${fields.number}`;
+        case "origin-pr":
+            return `origin-pr:${fields.fullName}#${fields.number}`;
+        case "thread":
+            return `${fields.channelId}:${fields.threadTs}`;
+    }
+}
+export function mintClaim(claim) {
+    const resource = claim.resource;
+    if ("channelId" in resource && "threadTs" in resource) {
+        if (claim.type !== "thread") {
+            throw new V2EngineError(`v2: claim type ${claim.type} does not match thread resource`);
+        }
+        return `cont:${formatConversationKey("thread", resource)}`;
+    }
+    const fullName = "fullName" in resource
+        ? resource.fullName
+        : `${resource.owner}/${resource.repo}`;
+    if (claim.type === "thread") {
+        throw new V2EngineError("v2: thread claim requires channelId and threadTs");
+    }
+    return `cont:${formatConversationKey(claim.type, {
+        fullName,
+        number: resource.number,
+    })}`;
+}
+export function handshakeContinuation(input) {
+    var _a;
+    if (input.identity === undefined) {
+        return { ok: true };
+    }
+    const parsed = parseContinuationSelector(input.identity);
+    if (parsed === undefined) {
+        return {
+            ok: false,
+            error: `v2: invalid continuation selector ${JSON.stringify(input.identity)}`,
+        };
+    }
+    if (parsed.version !== 2 || parsed.type === "none") {
+        return { ok: true };
+    }
+    if (input.kind !== undefined &&
+        parsed.kind !== "http" &&
+        input.kind !== parsed.kind) {
+        return {
+            ok: false,
+            error: `v2: continuation ${parsed.selector} does not match channel kind ${input.kind}`,
+        };
+    }
+    const builtin = builtinForType(parsed.type);
+    if (builtin === undefined) {
+        return {
+            ok: false,
+            error: `v2: unknown continuation type ${parsed.type}`,
+        };
+    }
+    const eventTypes = (_a = input.eventTypes) !== null && _a !== void 0 ? _a : [];
+    const allowed = new Set(builtin.events);
+    const unexpected = eventTypes.filter((event) => !allowed.has(event));
+    if (unexpected.length > 0) {
+        return {
+            ok: false,
+            error: `v2: eventTypes ${unexpected.join(", ")} are not in the ${parsed.type} membership`,
+        };
+    }
+    return { ok: true };
+}
+/**
+ * CP/pack extract. Returns a `cont:` key when the payload binds the
+ * identity type; undefined on membership miss or missing number (caller
+ * stamps `evt:` and does not join the conversation index).
+ */
+export function extractContinuation(type, eventName, payload) {
+    const builtin = builtinForType(type);
+    if (builtin === undefined) {
+        return undefined;
+    }
+    if (!builtin.events.includes(eventName)) {
+        return undefined;
+    }
+    switch (type) {
+        case "pr":
+        case "issue":
+            return extractGitHub(type, eventName, payload);
+        case "thread":
+            return extractSlack(payload);
+        case "origin-pr":
+            return extractOrigin(payload);
+    }
+}
+export function stampMailboxContinuation(identity, eventName, payload, kind) {
+    const parsed = resolveContinuation(identity, kind);
+    if (parsed.version !== 2) {
+        throw new V2EngineError("v2: refusing to stamp a mailbox key for v1");
+    }
+    if (parsed.type === "none") {
+        return { key: newEvtKey() };
+    }
+    const extracted = extractContinuation(parsed.type, eventName, payload);
+    if (extracted === undefined) {
+        return { key: newEvtKey() };
+    }
+    return { key: extracted };
+}
+export function resolveV2Key(identity, options, kind) {
+    const parsed = resolveContinuation(identity, kind);
+    if (parsed.version !== 2) {
+        throw new V2EngineError("v2: resolveV2Key requires a /v2 selector");
+    }
+    if (options.continuationToken !== undefined) {
+        throw new V2EngineError("v2: do not pass continuationToken; use mailboxContinuation or claim");
+    }
+    if (options.claim !== undefined) {
+        if (parsed.type === "none") {
+            throw new V2EngineError("v2: type none cannot take a claim");
+        }
+        if (options.claim.type !== parsed.type) {
+            throw new V2EngineError(`v2: claim type ${options.claim.type} does not match identity type ${parsed.type}`);
+        }
+        return mintClaim(options.claim);
+    }
+    if (options.mailboxContinuation !== undefined) {
+        return options.mailboxContinuation.key;
+    }
+    if (parsed.type === "none") {
+        return newEvtKey();
+    }
+    throw new V2EngineError("v2: no CP key on mailbox and no claim; refusing to mint in the engine");
+}
+export function bindMailboxContinuationSend(send, mailbox) {
+    if (mailbox === undefined) {
+        return send;
+    }
+    return (message, options) => { var _a; return send(message, Object.assign(Object.assign({}, options), { mailboxContinuation: (_a = options === null || options === void 0 ? void 0 : options.mailboxContinuation) !== null && _a !== void 0 ? _a : mailbox })); };
+}
+function extractGitHub(type, eventName, payload) {
+    const record = asRecord(payload);
+    if (record === undefined) {
+        return undefined;
+    }
+    const fullName = githubFullName(record);
+    if (fullName === undefined) {
+        return undefined;
+    }
+    const bound = githubBoundConversation(eventName, record);
+    if (bound === undefined || bound.type !== type) {
+        return undefined;
+    }
+    return `cont:${formatConversationKey(type, {
+        fullName,
+        number: bound.number,
+    })}`;
+}
+function githubBoundConversation(eventName, payload) {
+    var _a, _b;
+    var _c;
+    switch (eventName) {
+        case "pull_request":
+        case "pull_request_review":
+        case "pull_request_review_comment":
+        case "pull_request_review_thread": {
+            const number = positiveInt((_a = asRecord(payload.pull_request)) === null || _a === void 0 ? void 0 : _a.number);
+            return number === undefined ? undefined : { type: "pr", number };
+        }
+        case "issues": {
+            const number = positiveInt((_b = asRecord(payload.issue)) === null || _b === void 0 ? void 0 : _b.number);
+            return number === undefined ? undefined : { type: "issue", number };
+        }
+        case "issue_comment": {
+            const issue = asRecord(payload.issue);
+            const number = positiveInt(issue === null || issue === void 0 ? void 0 : issue.number);
+            if (number === undefined) {
+                return undefined;
+            }
+            return (issue === null || issue === void 0 ? void 0 : issue.pull_request) !== undefined && issue.pull_request !== null
+                ? { type: "pr", number }
+                : { type: "issue", number };
+        }
+        case "check_suite": {
+            const number = firstPullRequestNumber(asRecord(payload.check_suite));
+            return number === undefined ? undefined : { type: "pr", number };
+        }
+        case "check_run": {
+            const checkRun = asRecord(payload.check_run);
+            const number = (_c = firstPullRequestNumber(checkRun)) !== null && _c !== void 0 ? _c : firstPullRequestNumber(asRecord(checkRun === null || checkRun === void 0 ? void 0 : checkRun.check_suite));
+            return number === undefined ? undefined : { type: "pr", number };
+        }
+        default:
+            return undefined;
+    }
+}
+function extractSlack(payload) {
+    var _a, _b, _c, _d;
+    const record = asRecord(payload);
+    if (record === undefined) {
+        return undefined;
+    }
+    const channelId = (_b = (_a = nonEmpty(record.channelId)) !== null && _a !== void 0 ? _a : nonEmpty(record.channel_id)) !== null && _b !== void 0 ? _b : nonEmpty(record.channel);
+    const threadTs = (_d = (_c = nonEmpty(record.threadTs)) !== null && _c !== void 0 ? _c : nonEmpty(record.thread_ts)) !== null && _d !== void 0 ? _d : nonEmpty(record.ts);
+    if (channelId === undefined || threadTs === undefined) {
+        return undefined;
+    }
+    return `cont:${formatConversationKey("thread", { channelId, threadTs })}`;
+}
+function extractOrigin(payload) {
+    var _a, _b, _c, _d;
+    var _e, _f, _g, _h;
+    const record = asRecord(payload);
+    if (record === undefined) {
+        return undefined;
+    }
+    const inner = (_e = asRecord(record.pullRequest)) !== null && _e !== void 0 ? _e : asRecord(record.pull_request);
+    const number = positiveInt(inner === null || inner === void 0 ? void 0 : inner.number);
+    const repository = (_f = asRecord(record.repository)) !== null && _f !== void 0 ? _f : asRecord((_b = asRecord((_a = asRecord(record.event)) === null || _a === void 0 ? void 0 : _a.payload)) === null || _b === void 0 ? void 0 : _b.repository);
+    const fullName = (_h = (_g = nonEmpty((_c = asRecord(repository)) === null || _c === void 0 ? void 0 : _c.fullName)) !== null && _g !== void 0 ? _g : nonEmpty((_d = asRecord(repository)) === null || _d === void 0 ? void 0 : _d.full_name)) !== null && _h !== void 0 ? _h : originFullName(repository);
+    if (number === undefined || fullName === undefined) {
+        return undefined;
+    }
+    return `cont:${formatConversationKey("origin-pr", { fullName, number })}`;
+}
+function githubFullName(payload) {
+    var _a;
+    const repository = asRecord(payload.repository);
+    return (_a = nonEmpty(repository === null || repository === void 0 ? void 0 : repository.full_name)) !== null && _a !== void 0 ? _a : originFullName(repository);
+}
+function originFullName(repository) {
+    var _a, _b;
+    var _c, _d;
+    if (repository === undefined) {
+        return undefined;
+    }
+    const owner = (_d = (_c = nonEmpty(repository.owner)) !== null && _c !== void 0 ? _c : nonEmpty((_a = asRecord(repository.owner)) === null || _a === void 0 ? void 0 : _a.login)) !== null && _d !== void 0 ? _d : nonEmpty((_b = asRecord(repository.owner)) === null || _b === void 0 ? void 0 : _b.name);
+    const name = nonEmpty(repository.name);
+    if (owner === undefined || name === undefined) {
+        return undefined;
+    }
+    return `${owner}/${name}`;
+}
+function firstPullRequestNumber(record) {
+    var _a;
+    const pullRequests = record === null || record === void 0 ? void 0 : record.pull_requests;
+    if (!Array.isArray(pullRequests) || pullRequests.length === 0) {
+        return undefined;
+    }
+    return positiveInt((_a = asRecord(pullRequests[0])) === null || _a === void 0 ? void 0 : _a.number);
+}
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function nonEmpty(value) {
+    return typeof value === "string" && value.trim() !== ""
+        ? value.trim()
+        : undefined;
+}
+function positiveInt(value) {
+    if (typeof value === "number" && Number.isInteger(value) && value > 0) {
+        return value;
+    }
+    if (typeof value === "string" && /^[1-9]\d*$/.test(value)) {
+        return Number(value);
+    }
+    return undefined;
+}

package/dist/internal/deploy-manifest.d.ts

@@ -28,6 +28,7 @@
  * Keep that capability per-channel: do not reintroduce a provider-wide event
  * union for control-plane consumers.
  */
+import type { ContinuationIdentity } from "../continuation.js";
 import type { AgentProject, AgentProjectInfo } from "../types.js";
 export declare const DEPLOY_MANIFEST_VERSION: 1;
 export interface AgentDeployManifestDeclarations {
@@ -35,16 +36,25 @@ export interface AgentDeployManifestDeclarations {
     publicRoutePaths: string[];
     /** Where this runtime mirrors framework-owned sessions and event chunks. */
     frameworkStorage?: "cursor-hosted" | "other" | "none";
+    /**
+     * Hosted architecture this release deploys onto. `"v2"` selects the v2
+     * control plane; omitted channel constructors inherit kind `/v2`
+     * continuation defaults. Omit or `"v1"` keeps engine minting.
+     */
+    architecture?: "v1" | "v2";
     /**
      * Mounted channels with their kinds and per-channel event capability.
      * Scope keys are installation config and are never extracted here.
-     * Continuation is opt-in: without a deterministic selector key, every
-     * inbound event starts a fresh session. Selector encoding remains open.
+     * Omitted channel `continuation` is `/v1` (engine minting) unless the
+     * agent set `architecture: "v2"`, which stamps kind `/v2` defaults
+     * (`github.pr/v2`, `slack.thread/v2`, `origin.pr/v2`). Per-channel
+     * selectors still override type.
      */
     channels: Array<{
         id: string;
         kind?: string;
         eventTypes?: string[];
+        continuation: ContinuationIdentity;
     }>;
 }
 export interface AgentDeployManifestV1 {

package/dist/internal/deploy-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIlE,eAAO,MAAM,uBAAuB,EAAE,CAAK,CAAC;AA6B5C,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD;;;;;OAKG;IACH,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,CAAC,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,+BAA+B,CAAC;IAC9C;;;OAGG;IACH,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,qBAAqB,CA2CvB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,GACX,qBAAqB,GAAG,SAAS,CAOnC"}
+{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUlE,eAAO,MAAM,uBAAuB,EAAE,CAAK,CAAC;AAiC5C,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD;;;;OAIG;IACH,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,EAAE,oBAAoB,CAAC;KACpC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,CAAC,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,+BAA+B,CAAC;IAC9C;;;OAGG;IACH,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,qBAAqB,CAoDvB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,GACX,qBAAqB,GAAG,SAAS,CAOnC"}