@cursor/july 0.1.10 → 0.1.12

package/src/types.ts

@@ -194,8 +194,45 @@ export interface AgentConfig {
    * it and sends it with the deployment request. Ignored by local serving.
    */
   hosting?: AgentHostingOptions;
+  /**
+   * Engine-wide turn admission limits. See {@link AgentConcurrencyOptions}.
+   */
+  concurrency?: AgentConcurrencyOptions;
 }
 
+/**
+ * Turn admission limits on {@link AgentConfig.concurrency}.
+ *
+ * ```ts
+ * export default defineAgent({
+ *   // At most 3 sessions run a model turn at once; the rest queue FIFO.
+ *   concurrency: { maxRunningTurns: 3 },
+ * });
+ * ```
+ */
+export interface AgentConcurrencyOptions {
+  /**
+   * Max model turns running at once across **all** of this agent's
+   * sessions. When every slot is busy, newly admitted turns queue FIFO
+   * (surfaced as a durable `turn.queued` event and `queued: true` on
+   * `GET /v1/sessions`) instead of failing; each queued turn starts as
+   * soon as a slot frees. Positive integer, hard-capped at
+   * {@link MAX_RUNNING_TURNS_LIMIT}. Omit for unlimited.
+   *
+   * A queued turn still counts as `running` for busy semantics
+   * (follow-ups preempt it; direct tool calls get `SessionBusyError`),
+   * and a follow-up that preempts a queued turn re-queues at the back.
+   */
+  maxRunningTurns?: number;
+}
+
+/**
+ * Hard ceiling for {@link AgentConcurrencyOptions.maxRunningTurns}.
+ * Matches the eval harness ceiling: each running turn issues model
+ * provider requests, so unbounded parallelism is never meaningful.
+ */
+export const MAX_RUNNING_TURNS_LIMIT = 200;
+
 /**
  * Managed-hosting block on {@link AgentConfig.hosting}.
  */
@@ -367,6 +404,12 @@ export interface HostContext {
    * Slack follow-ups coalesce and drain at turn boundaries.
    */
   slackNudges?: SlackNudgeHostApi;
+  /**
+   * Playground eval batches (`/v1/dev/evals*`). Present once the serve host
+   * has attached an {@link import("./evals.js").HostEvalsApi}. Used by the
+   * built-in Slack `eval` directive and available to tools/handlers.
+   */
+  evals?: import("./evals.js").HostEvalsApi;
   /**
    * Author-facing durable JSON KV (`agentkit/v1/{agent}/kv/…`). Backed by
    * `agent/storage.ts` (`defineStorage`) when authored; otherwise files
@@ -531,6 +574,8 @@ export type ConnectionTransport =
       type?: "http" | "sse";
       url: string;
       headers?: Record<string, string>;
+      /** Host PKCE OAuth; `agentkit mcp oauth <name>`. No Authorization header. */
+      oauth?: true;
     }
   | {
       /** Slug of a peer agent mounted on the same serve host. */
@@ -578,13 +623,18 @@ export function isSymbolicConnectionTransport(
 export type ConnectionConfig = ConnectionTransport & {
   /** Documentation only; shown in `info` output. */
   description?: string;
+  /**
+   * Omit from SDK `mcpServers` (model never sees it). Still available on
+   * `host.mcp` for server tools / channel handlers. Does not affect
+   * cloud-native account connectors provisioned by the platform.
+   */
+  hostOnly?: boolean;
 };
 
 /**
- * An MCP connection is always available in three places:
- * - the Cursor agent (SDK `mcpServers`, local or cloud)
- * - the agent-serve host (`ctx.host.mcp` on in-process tools)
- * - channel / schedule handlers (`args.host.mcp`)
+ * An MCP connection is available to the agent (SDK `mcpServers`), host
+ * (`ctx.host.mcp`), and channel/schedule handlers — unless `hostOnly`,
+ * which keeps it off the model surface only.
  */
 export type ConnectionDefinition = ConnectionConfig &
   BrandedDefinition<"connection">;
@@ -671,6 +721,15 @@ export type SessionEventPayload =
       data: { sdkAgentId: string; url?: string };
     }
   | { type: "message.received"; data: { text: string } }
+  | {
+      /**
+       * The turn was admitted while every {@link AgentConcurrencyOptions.maxRunningTurns}
+       * slot was busy; it waits FIFO and `turn.started` follows once a slot
+       * frees. `position` is 1-based among waiting turns at enqueue time.
+       */
+      type: "turn.queued";
+      data: { position: number; maxRunningTurns: number };
+    }
   | { type: "turn.started"; data: Record<string, never> }
   | { type: "step.started"; data: { stepId: number } }
   | { type: "step.completed"; data: { stepId: number; durationMs: number } }
@@ -872,8 +931,14 @@ export interface SessionSummary {
   mode: SessionMode;
   title?: string;
   turnCount: number;
-  /** True while a turn is executing right now. */
+  /** True while a turn is executing right now (including queued turns). */
   running: boolean;
+  /**
+   * True while the session's admitted turn is waiting for a
+   * {@link AgentConcurrencyOptions.maxRunningTurns} slot (subset of
+   * {@link running}). Omitted when the agent has no turn limit.
+   */
+  queued?: boolean;
   createdAt: string;
   updatedAt: string;
   /** `<channelId>:<key>` wire token, or null when not addressable. */
@@ -1629,6 +1694,7 @@ export interface DiscoveredConnection {
   name: string;
   transport: ConnectionTransport;
   description?: string;
+  hostOnly?: boolean;
 }
 
 export interface DiscoveredChannel {
@@ -1683,6 +1749,8 @@ export interface ResolvedAgent {
   local?: AgentLocalOptions;
   /** Managed-hosting declarations from {@link AgentConfig.hosting}. */
   hosting?: AgentHostingOptions;
+  /** Validated turn admission limits from {@link AgentConfig.concurrency}. */
+  concurrency?: AgentConcurrencyOptions;
   tools: DiscoveredTool[];
   skills: DiscoveredSkill[];
   connections: DiscoveredConnection[];
@@ -1734,6 +1802,8 @@ export interface AgentProjectInfo {
   local?: { cwd?: string };
   /** Managed-hosting declarations when authored (egress allowlist, expected secrets). */
   hosting?: { egressDomains?: string[]; secretNames?: string[] };
+  /** Turn admission limits when authored (`concurrency` on `agent.ts`). */
+  concurrency?: { maxRunningTurns?: number };
   /**
    * The agent's own MCP surface (mounted at `<base>/v1/mcp`): other agents
    * and MCP clients delegate to this agent through these tools.
@@ -1748,7 +1818,7 @@ export interface AgentProjectInfo {
     inputSchema: JsonSchemaObject;
   }>;
   skills: Array<{ name: string; description: string }>;
-  connections: Array<{ name: string; transport: string }>;
+  connections: Array<{ name: string; transport: string; hostOnly?: boolean }>;
   subagents: Array<{
     name: string;
     description?: string;

package/dist/channels/slack/post-update-delivery.d.ts

@@ -1,85 +0,0 @@
-/**
- * Live-reply delivery strategies for the Slack default handlers.
- *
- * A single strategy owns how an in-progress reply is opened, updated,
- * finalized, and cleaned up so the handlers in `defaults.ts` don't fork on the
- * delivery mode at every event:
- *
- * - `stream`: Slack chat.startStream / appendStream / stopStream.
- * - `post-update`: a chat.postMessage skeleton edited with chat.update. This is
- *   the only path that preserves Cursor-account identity pinning (which only
- *   covers postMessage).
- *
- * `buildDefaultEvents` selects one via {@link selectLiveDeliveryStrategy} up
- * front and calls into it. All calls keep the same soft-fail / log behavior as
- * the inlined logic they replaced.
- */
-import type { ChannelEventContext } from "../../types.js";
-import type { SlackLog } from "./log.js";
-import type { SlackBotToken, SlackChannelState } from "./types.js";
-type SlackChannel = ChannelEventContext<SlackChannelState>;
-export interface LiveDeliveryDeps {
-    botToken: SlackBotToken | undefined;
-    getLog: () => SlackLog;
-}
-/**
- * How the default handlers deliver an in-progress reply. Methods write live
- * delivery state (`streamTs`, `streamChannelId`, `lastPostedText`,
- * `lastPostUpdateAtMs`, `streamingUnavailable`) on `channel.state` directly.
- */
-export interface LiveDeliveryStrategy {
-    /** True when tool-call thinking steps can be appended to the live message. */
-    readonly inlineToolSteps: boolean;
-    /** Open the live message (skeleton post / stream start). */
-    start(args: {
-        channel: SlackChannel;
-        channelId: string;
-        threadTs: string;
-        sessionId: string;
-    }): Promise<void>;
-    /** Push the latest cumulative text to the live message (throttled). */
-    append(args: {
-        channel: SlackChannel;
-        channelId: string;
-        streamTs: string;
-        text: string;
-        sessionId: string;
-    }): Promise<void>;
-    /**
-     * Flush the final reply text. `delivered` is false only when the caller must
-     * post the full reply as a fresh message (finalize failed on partial text).
-     */
-    finalize(args: {
-        channel: SlackChannel;
-        channelId: string;
-        streamTs: string;
-        text: string;
-        sessionId: string;
-    }): Promise<{
-        delivered: boolean;
-    }>;
-    /** Close the live message when the turn produced no final text. */
-    finalizeEmpty(args: {
-        channel: SlackChannel;
-        channelId: string;
-        streamTs: string;
-    }): Promise<void>;
-    /** Best-effort remove a live message left open after the turn ended. */
-    cleanupOrphan(args: {
-        channel: SlackChannel;
-    }): Promise<void>;
-    /** Deliver the error text into the live message; `delivered` gates a fallback post. */
-    fail(args: {
-        channel: SlackChannel;
-        channelId: string;
-        streamTs: string;
-        errorText: string;
-        sessionId: string;
-    }): Promise<{
-        delivered: boolean;
-    }>;
-}
-/** Pick the live-reply delivery strategy for a `buildDefaultEvents` instance. */
-export declare function selectLiveDeliveryStrategy(deps: LiveDeliveryDeps, usePostUpdate: boolean): LiveDeliveryStrategy;
-export {};
-//# sourceMappingURL=post-update-delivery.d.ts.map

package/dist/channels/slack/post-update-delivery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"post-update-delivery.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/post-update-delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAW1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,KAAK,YAAY,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,MAAM,EAAE,MAAM,QAAQ,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,4DAA4D;IAC5D,KAAK,CAAC,IAAI,EAAE;QACV,OAAO,EAAE,YAAY,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,uEAAuE;IACvE,MAAM,CAAC,IAAI,EAAE;QACX,OAAO,EAAE,YAAY,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE;QACb,OAAO,EAAE,YAAY,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpC,mEAAmE;IACnE,aAAa,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,YAAY,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,wEAAwE;IACxE,aAAa,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,uFAAuF;IACvF,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,EAAE,YAAY,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACrC;AA6RD,iFAAiF;AACjF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,gBAAgB,EACtB,aAAa,EAAE,OAAO,GACrB,oBAAoB,CAItB"}