@cursor/july 0.1.80 → 0.1.82

package/src/types.ts

@@ -11,9 +11,21 @@
 import type { InteractionUpdate, SDKCustomTool, ToolName } from "@cursor/sdk";
 import type { z } from "zod";
 import type { ABConfigFile } from "./ab.js";
+import type {
+  ContinuationClaim,
+  ContinuationIdentity,
+  MailboxContinuation,
+} from "./continuation.js";
 import type { OtelConfig, OtelDefinition } from "./otel.js";
 import type { StorageDefinition } from "./storage.js";
 
+export type {
+  ContinuationClaim,
+  ContinuationIdentity,
+  ConversationType,
+  MailboxContinuation,
+} from "./continuation.js";
+
 // ============================================================================
 // JSON
 // ============================================================================
@@ -240,8 +252,26 @@ export interface AgentConfig {
    * it only shapes what the model can call.
    */
   tools?: ToolName[];
+  /**
+   * Hosted architecture this agent deploys onto. Omit or `"v1"` keeps the
+   * current control plane and engine-minted conversation keys. `"v2"`
+   * deploys onto the v2 control plane (v2 APIs and schemas). Omitted
+   * channel `continuation` then inherits from declared events (`github.pr/v2`,
+   * `github.issue/v2`, `github.none/v2`, `slack.thread/v2`, `origin.pr/v2`,
+   * `none/v2`). An explicit per-channel selector still overrides.
+   *
+   * ```ts
+   * export default defineAgent({
+   *   architecture: "v2",
+   * });
+   * ```
+   */
+  architecture?: AgentArchitecture;
 }
 
+/** Hosted architecture on {@link AgentConfig.architecture}. */
+export type AgentArchitecture = "v1" | "v2";
+
 /**
  * Built-in tools on {@link AgentConfig.builtinTools}. Each enabled
  * capability materializes as ordinary server tools at discovery time, so
@@ -1595,8 +1625,21 @@ export interface SendMessageOptions {
    * Channel-local continuation token. When it addresses an existing session
    * the message is a follow-up; otherwise a new session is created keyed by
    * this token. Omit to always create a fresh session.
+   *
+   * `/v2` selectors refuse this field — pass {@link mailboxContinuation} or
+   * a structured {@link claim} instead.
    */
   continuationToken?: string;
+  /**
+   * v2 mailbox stamp from the control plane (or the pack's builtin extract
+   * on local serve). Ignored on v1.
+   */
+  mailboxContinuation?: MailboxContinuation;
+  /**
+   * v2 host join. Never a concatenated `pr:owner/repo#N` string — the
+   * registry mints `cont:` bytes from this claim.
+   */
+  claim?: ContinuationClaim;
   /** Initial channel state for newly created sessions. */
   state?: JsonValue;
   /**
@@ -2057,6 +2100,12 @@ export type ChannelDefinition<TState = JsonValue> = ChannelConfig<TState> &
 export interface HttpChannelConfig {
   /** Route auth chain. Defaults to `[localDevStrict()]`. */
   auth?: AuthPolicy[];
+  /**
+   * Continuation selector. Omitted inherits {@link AgentConfig.architecture}:
+   * `"none/v1"` unless the agent set `architecture: "v2"` (then `"none/v2"`
+   * → `evt:`). Override with an explicit `"none/v1"` or `"none/v2"`.
+   */
+  continuation?: ContinuationIdentity;
   /**
    * Transform the inbound message before the agent sees it (e.g. prepend
    * request-specific context).
@@ -2549,6 +2598,12 @@ export interface ResolvedAgent {
   hosting?: AgentHostingOptions;
   /** Validated turn admission limits from {@link AgentConfig.concurrency}. */
   concurrency?: AgentConcurrencyOptions;
+  /**
+   * Validated architecture from {@link AgentConfig.architecture}.
+   * `"v2"` deploys onto the v2 control plane and stamps kind `/v2`
+   * continuation defaults onto channels that omitted a selector.
+   */
+  architecture?: AgentArchitecture;
   tools: DiscoveredTool[];
   skills: DiscoveredSkill[];
   connections: DiscoveredConnection[];