@cursor/july 0.1.80 → 0.1.82

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"}

package/dist/internal/deploy-manifest.js

@@ -31,6 +31,8 @@
 import { z } from "zod";
 import { isPublicEndpointPolicy } from "../channels.js";
 import { isCursorHostedStorage } from "../storage-backends/cursor-hosted.js";
+import { applyAgentContinuationDefaults, channelContinuationIdentity, handshakeChannelContinuation, } from "./continuation-channel.js";
+import { CONTINUATION_SELECTORS } from "./continuation-identity.js";
 import { projectInfo } from "./discovery.js";
 import { packageVersion } from "./distribution.js";
 export const DEPLOY_MANIFEST_VERSION = 1;
@@ -39,6 +41,7 @@ export const DEPLOY_MANIFEST_VERSION = 1;
  * module-private (the package builds with isolated declarations); consumers
  * use {@link parseAgentDeployManifest} and the explicit interfaces below.
  */
+const continuationIdentitySchema = z.enum(CONTINUATION_SELECTORS);
 const agentDeployManifestV1Schema = z.object({
     manifestVersion: z.literal(DEPLOY_MANIFEST_VERSION),
     generatedAtMs: z.number().int().nonnegative(),
@@ -47,11 +50,13 @@ const agentDeployManifestV1Schema = z.object({
         egressDomains: z.array(z.string().min(1)).max(64),
         publicRoutePaths: z.array(z.string().min(1)).max(64),
         frameworkStorage: z.enum(["cursor-hosted", "other", "none"]).optional(),
+        architecture: z.enum(["v1", "v2"]).optional(),
         channels: z
             .array(z.object({
             id: z.string().min(1).max(128),
             kind: z.string().min(1).max(32).optional(),
             eventTypes: z.array(z.string().min(1).max(64)).max(64).optional(),
+            continuation: continuationIdentitySchema,
         }))
             .max(64),
     }),
@@ -65,8 +70,13 @@ const agentDeployManifestV1Schema = z.object({
 export function buildAgentDeployManifest(project, options) {
     var _a;
     var _b, _c, _d;
+    applyAgentContinuationDefaults(project);
     const channels = project.channels.map((channel) => {
         var _a, _b, _c;
+        const handshake = handshakeChannelContinuation(channel);
+        if (!handshake.ok) {
+            throw new Error(handshake.error);
+        }
         const kind = (_a = channel.definition.meta) === null || _a === void 0 ? void 0 : _a.kind;
         const githubEvents = (_b = channel.definition.meta) === null || _b === void 0 ? void 0 : _b.githubWebhookEvents;
         const originEvents = (_c = channel.definition.meta) === null || _c === void 0 ? void 0 : _c.originWebhookEvents;
@@ -79,6 +89,7 @@ export function buildAgentDeployManifest(project, options) {
             id: channel.id,
             kind,
             eventTypes,
+            continuation: channelContinuationIdentity(channel.definition),
         };
     });
     // Same mapping as `july deploy` (cli-deploy.ts): channels declared public
@@ -90,16 +101,13 @@ export function buildAgentDeployManifest(project, options) {
         manifestVersion: DEPLOY_MANIFEST_VERSION,
         generatedAtMs: (_b = options === null || options === void 0 ? void 0 : options.nowMs) !== null && _b !== void 0 ? _b : Date.now(),
         cliVersion: (_c = options === null || options === void 0 ? void 0 : options.cliVersion) !== null && _c !== void 0 ? _c : packageVersion(),
-        declarations: {
-            egressDomains: [...((_d = (_a = project.agent.hosting) === null || _a === void 0 ? void 0 : _a.egressDomains) !== null && _d !== void 0 ? _d : [])],
-            publicRoutePaths,
-            frameworkStorage: project.storage === undefined
+        declarations: Object.assign(Object.assign({ egressDomains: [...((_d = (_a = project.agent.hosting) === null || _a === void 0 ? void 0 : _a.egressDomains) !== null && _d !== void 0 ? _d : [])], publicRoutePaths, frameworkStorage: project.storage === undefined
                 ? "none"
                 : isCursorHostedStorage(project.storage)
                     ? "cursor-hosted"
-                    : "other",
-            channels,
-        },
+                    : "other" }, (project.agent.architecture === undefined
+            ? {}
+            : { architecture: project.agent.architecture })), { channels }),
         info: projectInfo(project),
     };
 }

package/dist/internal/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/internal/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EASrB,KAAK,UAAU,EAuBhB,MAAM,aAAa,CAAC;AA+BrB,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3E;AAmBD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,EAAE,CAAC,CA2B1B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CA6BzD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAAuB,GAAG;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAgBzD;AAWD,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,CAIrC,CAAC;AAEH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CAmEvB;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAElE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAOnE;AAowBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB3E;AAo2BD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CA4JnE"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/internal/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EASrB,KAAK,UAAU,EAuBhB,MAAM,aAAa,CAAC;AAgCrB,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3E;AAmBD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASrE;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,EAAE,CAAC,CA2B1B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CA6BzD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAAuB,GAAG;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC,CAgBzD;AAWD,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,GAAG,CAAC,MAAM,CAIrC,CAAC;AAEH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CA0EvB;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAElE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAOnE;AAiyBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB3E;AAo2BD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,CA4JnE"}

package/dist/internal/discovery.js

@@ -36,6 +36,7 @@ import { registerAuthoredModuleLoaders } from "./authored-loaders.js";
 import { normalizePositiveInt } from "./bounded-int.js";
 import { getDefinitionKind } from "./brand.js";
 import { artifactBuiltinTool, builtinTools, TAG_ARTIFACT_TOOL_NAME, } from "./builtin-tools/index.js";
+import { applyAgentContinuationDefaults } from "./continuation-channel.js";
 import { isValidCron } from "./cron.js";
 import { parseFrontmatter } from "./frontmatter.js";
 import { isReservedSecretName, MAX_EGRESS_DOMAINS, validateEgressDomain, validateSecretName, } from "./hosting.js";
@@ -218,12 +219,18 @@ export function loadAgentProject(dir_1) {
         if (agentDir !== rootDir) {
             yield warnUnknownSlots(ctx, agentDir);
         }
+        const resolvedHttpChannel = httpChannelDefinition !== null && httpChannelDefinition !== void 0 ? httpChannelDefinition : httpChannel();
+        applyAgentContinuationDefaults({
+            agent,
+            channels,
+            httpChannel: resolvedHttpChannel,
+        });
         return {
             rootDir,
             agentDir,
             name: agent.name,
             agent,
-            httpChannel: httpChannelDefinition !== null && httpChannelDefinition !== void 0 ? httpChannelDefinition : httpChannel(),
+            httpChannel: resolvedHttpChannel,
             channels,
             schedules,
             hooks,
@@ -282,6 +289,13 @@ function loadAgent(ctx, agentDir, options) {
                     message: "tools is not supported on subagents (they keep the harness task-tool toolset); ignoring.",
                 });
             }
+            if ((config === null || config === void 0 ? void 0 : config.architecture) !== undefined) {
+                ctx.diagnostics.push({
+                    severity: "warning",
+                    path: displayPath(ctx, join(agentDir, "agent.ts")),
+                    message: "architecture is not supported on subagents; ignoring.",
+                });
+            }
             const artifactsPath = yield findModuleFile(agentDir, "artifacts");
             if (artifactsPath !== undefined) {
                 ctx.diagnostics.push({
@@ -371,6 +385,7 @@ function loadAgent(ctx, agentDir, options) {
             };
         const hosting = resolveHosting(ctx, agentDir, config === null || config === void 0 ? void 0 : config.hosting);
         const concurrency = resolveConcurrency(ctx, agentDir, config === null || config === void 0 ? void 0 : config.concurrency);
+        const architecture = resolveArchitecture(ctx, agentDir, config === null || config === void 0 ? void 0 : config.architecture);
         if (runtime === "cloud") {
             warnCloudRuntimeLimitations(ctx, agentDir, {
                 agentTools: tools.filter((tool) => tool.execution === "agent").length,
@@ -380,20 +395,32 @@ function loadAgent(ctx, agentDir, options) {
             });
         }
         appendBuiltinTools(ctx, agentDir, tools, config === null || config === void 0 ? void 0 : config.builtinTools);
-        return Object.assign(Object.assign({ name, description: config === null || config === void 0 ? void 0 : config.description, 
+        return Object.assign(Object.assign(Object.assign(Object.assign({ name, description: config === null || config === void 0 ? void 0 : config.description, 
             // Root agents always get a concrete model: authored value or DEFAULT_MODEL.
             model: isValidModelSetting(config === null || config === void 0 ? void 0 : config.model) ? config.model : DEFAULT_MODEL, instructions,
             runtime,
             cloud,
             local }, (allowedTools === undefined ? {} : { allowedTools })), { hosting,
-            concurrency,
-            tools,
+            concurrency }), (architecture === undefined ? {} : { architecture })), { tools,
             skills,
             connections,
             subagents,
             seedFiles });
     });
 }
+function resolveArchitecture(ctx, agentDir, architecture) {
+    if (architecture === undefined ||
+        architecture === "v1" ||
+        architecture === "v2") {
+        return architecture;
+    }
+    ctx.diagnostics.push({
+        severity: "error",
+        path: displayPath(ctx, join(agentDir, "agent.ts")),
+        message: `architecture must be "v1" or "v2"; got ${JSON.stringify(architecture)}.`,
+    });
+    return undefined;
+}
 /** Absolute harness cwd parent, or undefined when unset / blank. */
 function resolveAgentCwd(ctx, authored) {
     if (authored === undefined) {
@@ -1241,7 +1268,7 @@ function warnCloudRuntimeLimitations(ctx, agentDir, counts) {
         ctx.diagnostics.push({
             severity: "warning",
             path: displayPath(ctx, join(agentDir, "skills")),
-            message: "Authored skills are materialized into the local session workspace only; cloud agents see skills that already exist in the cloud repo.",
+            message: "Authored skills reach cloud agents on hosted deployments via the deployment store's skills/ directory (native skill discovery). Cloud turns started outside hosting (dev serve/run) see only skills already in the cloud repo.",
         });
     }
     if (counts.seedFiles > 0) {

package/dist/internal/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwCH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAwHrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAwBpE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAaD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAwzB3B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0CH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAwHrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAwBpE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAaD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAo0B3B"}