@cursor/july 0.1.114 → 0.2.1

package/src/types.ts

@@ -279,8 +279,8 @@ export interface AgentConfig {
    */
   tools?: ToolName[];
   /**
-   * Hosted architecture override. Leave this unset unless Cursor instructs
-   * you to select a specific architecture.
+   * Hosted architecture. Defaults to `"v2"`. Set `"v1"` to stay on the
+   * resident-engine architecture.
    */
   architecture?: AgentArchitecture;
   /**
@@ -2475,10 +2475,11 @@ export type ChannelEventHandlers<TState = JsonValue> = {
 export interface ChannelStartArgs {
   send: SendMessageFn;
   /**
-   * Hosted architecture from {@link AgentConfig.architecture}. Omitted
-   * means v1. Host pipelines that call `send()` themselves (instead of
-   * letting the channel adapter stamp continuation) branch on this so
-   * v1 `continuationToken` and v2 `claim` stay mutually exclusive.
+   * Hosted architecture from {@link AgentConfig.architecture}. Discovery
+   * fills `"v2"` when the author omits it. Host pipelines that call
+   * `send()` themselves (instead of letting the channel adapter stamp
+   * continuation) branch on this so v1 `continuationToken` and v2 `claim`
+   * stay mutually exclusive.
    */
   architecture?: AgentArchitecture;
   getSession(sessionId: string): Promise<ChannelSession | null>;
@@ -2999,6 +3000,34 @@ export interface ReminderUntilContext {
   mcp: HostMcpRegistry;
 }
 
+/**
+ * Send fields a reminder followup may carry onto the turn it starts, the
+ * subset of {@link SendMessageOptions} a host pipeline needs when the fire
+ * itself prepares the turn (channel state for a later `defineResult.commit`,
+ * a session title, a cloud-attach reset). Continuation addressing stays the
+ * reminder's stored binding and is not overridable here.
+ */
+export interface ReminderFollowupOptions {
+  /** Initial channel state when the followup creates the session. */
+  state?: JsonValue;
+  /** Shallow-merged into an existing session's channel state (see {@link SendMessageOptions.refreshState}). */
+  refreshState?: JsonValue;
+  /** Session display title (applied when creating a new session). */
+  title?: string;
+  /** See {@link SendMessageOptions.clearCloudOverride}. */
+  clearCloudOverride?: boolean;
+  /**
+   * Open a new session under this principal when the stored continuation
+   * has none anywhere (pod or durable storage) — the session an inbound
+   * delivery on that key would create, so later deliveries under the same
+   * principal keep joining it. A durable session that exists but cannot be
+   * materialized still throws, matching prompt fires: opening over it would
+   * shadow the record. Omitted, a missing session also keeps the existing
+   * behavior: the followup throws.
+   */
+  openAuth?: AuthContext;
+}
+
 export interface ReminderFireContext extends ReminderUntilContext {
   appAuth: AuthContext;
   /**
@@ -3006,8 +3035,15 @@ export interface ReminderFireContext extends ReminderUntilContext {
    * uses a named {@link ReminderCreateInput.handler}. Empty object otherwise.
    */
   args: JsonObject;
-  /** Wake the reminder's already-bound session (target is implicit). */
-  followup(args: { message: string }): Promise<ChannelSession>;
+  /**
+   * Wake the reminder's already-bound session (target is implicit). On a
+   * hosted architecture v2 deployment this resolves after the woken turn
+   * completes, because the pod may stop once the fire's outcome is applied;
+   * locally and on v1 it resolves as soon as the turn is admitted.
+   */
+  followup(
+    args: { message: string } & ReminderFollowupOptions
+  ): Promise<ChannelSession>;
   cancel(reason?: string): Promise<void>;
   /**
    * Durable artifacts (unbound — the reminder is bound to a continuation
@@ -3344,8 +3380,9 @@ export interface ResolvedAgent {
   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.
+   * Omitted authors resolve to `"v2"`. `"v2"` deploys onto the v2
+   * control plane and stamps kind `/v2` continuation defaults onto
+   * channels that omitted a selector.
    */
   architecture?: AgentArchitecture;
   persistent?: boolean;