@cursor/bdk 0.2.1 → 0.2.3

package/dist/extensions/cursor-cloud-agents/lib/repos.js

@@ -3,14 +3,23 @@
  * `prUrl` per call, but the author's `cloud.repos` are the allowlist.
  * Model-chosen targets always require that allowlist: an unbound mount
  * (no `cloud.repos`) must not accept an arbitrary URL under the host API
- * key, with or without `envVars`.
+ * key, with or without `envVars`. A function allowlist is resolved on every
+ * call and always narrows the launch to one of its repositories.
  */
 import { parsePrUrl } from "../../../internal/scm/pr-url.js";
 export function launchRepos(target, cloud) {
-    var _a, _b;
-    var _c, _d, _e, _f, _g, _h;
-    if (target.repo === undefined && target.ref === undefined && target.prUrl === undefined) {
-        return cloud.repos;
+    var _a;
+    var _b, _c, _d, _e, _f;
+    const resolved = typeof cloud.repos === "function";
+    const allowlist = typeof cloud.repos === "function" ? cloud.repos() : cloud.repos;
+    if (resolved && (allowlist === null || allowlist === void 0 ? void 0 : allowlist.length) === 0) {
+        throw new Error("No repositories are available to cloud agents for this deployment.");
+    }
+    if (!resolved &&
+        target.repo === undefined &&
+        target.ref === undefined &&
+        target.prUrl === undefined) {
+        return allowlist;
     }
     const pr = target.prUrl === undefined ? undefined : parsePrUrl(target.prUrl);
     if (target.prUrl !== undefined && (pr === null || pr === void 0 ? void 0 : pr.provider) !== "github") {
@@ -18,8 +27,8 @@ export function launchRepos(target, cloud) {
     }
     const prRepo = pr === undefined ? undefined : `https://github.com/${pr.owner}/${pr.repo}`;
     // A lone `ref` needs exactly one configured repository to apply to.
-    const configured = (_c = cloud.repos) !== null && _c !== void 0 ? _c : [];
-    const url = (_e = (_d = target.repo) !== null && _d !== void 0 ? _d : prRepo) !== null && _e !== void 0 ? _e : (configured.length === 1 ? (_a = configured[0]) === null || _a === void 0 ? void 0 : _a.url : undefined);
+    const configured = allowlist !== null && allowlist !== void 0 ? allowlist : [];
+    const url = (_c = (_b = target.repo) !== null && _b !== void 0 ? _b : prRepo) !== null && _c !== void 0 ? _c : (configured.length === 1 ? (_a = configured[0]) === null || _a === void 0 ? void 0 : _a.url : undefined);
     if (url === undefined) {
         throw new Error(configured.length > 1
             ? "`repo` is required: this extension configures several repositories."
@@ -28,9 +37,9 @@ export function launchRepos(target, cloud) {
     if (prRepo !== undefined && repoKey(prRepo) !== repoKey(url)) {
         throw new Error(`prUrl ${target.prUrl} is not a pull request of ${url}.`);
     }
-    const allowlisted = (_b = cloud.repos) === null || _b === void 0 ? void 0 : _b.some(configured => repoKey(configured.url) === repoKey(url));
+    const allowlisted = allowlist === null || allowlist === void 0 ? void 0 : allowlist.some(configured => repoKey(configured.url) === repoKey(url));
     if (allowlisted !== true) {
-        throw new Error(cloud.repos === undefined
+        throw new Error(allowlist === undefined
             ? `Configure cloud.repos before launching against a model-chosen repository (${url}).`
             : `${url} is not one of this extension's configured repositories.`);
     }
@@ -40,9 +49,9 @@ export function launchRepos(target, cloud) {
     const match = configured.find(configuredRepo => repoKey(configuredRepo.url) === repoKey(url));
     return [
         {
-            url: (_f = match === null || match === void 0 ? void 0 : match.url) !== null && _f !== void 0 ? _f : url,
-            startingRef: (_g = target.ref) !== null && _g !== void 0 ? _g : match === null || match === void 0 ? void 0 : match.startingRef,
-            prUrl: (_h = target.prUrl) !== null && _h !== void 0 ? _h : (target.ref !== undefined ? undefined : match === null || match === void 0 ? void 0 : match.prUrl),
+            url: (_d = match === null || match === void 0 ? void 0 : match.url) !== null && _d !== void 0 ? _d : url,
+            startingRef: (_e = target.ref) !== null && _e !== void 0 ? _e : match === null || match === void 0 ? void 0 : match.startingRef,
+            prUrl: (_f = target.prUrl) !== null && _f !== void 0 ? _f : (target.ref !== undefined ? undefined : match === null || match === void 0 ? void 0 : match.prUrl),
         },
     ];
 }

package/dist/extensions/cursor-cloud-agents/tools/cancel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/cancel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD,QAAA,MAAM,MAAM,EAAE,cAUZ,CAAC;eAEY,MAAM"}
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/cancel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,QAAA,MAAM,MAAM,EAAE,cAWZ,CAAC;eAEY,MAAM"}

package/dist/extensions/cursor-cloud-agents/tools/cancel.js

@@ -9,6 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { defineTool } from "../../../tools.js";
 import { cloudAgentsBackend } from "../lib/backend.js";
+import { assertWriteChannel } from "../lib/channels.js";
 import { assertOwned } from "../lib/fleet.js";
 import { agentRef } from "../lib/inputs.js";
 const cancel = defineTool({
@@ -17,6 +18,7 @@ const cancel = defineTool({
     inputSchema: agentRef,
     execute(input, ctx) {
         return __awaiter(this, void 0, void 0, function* () {
+            assertWriteChannel(ctx);
             yield assertOwned(ctx, input.agent_id);
             yield cloudAgentsBackend().pause(input.agent_id);
             return { agentId: input.agent_id, cancelled: true };

package/dist/extensions/cursor-cloud-agents/tools/launch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/launch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,QAAA,MAAM,MAAM,EAAE,cAiDZ,CAAC;eAEY,MAAM"}
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/launch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,QAAA,MAAM,MAAM,EAAE,cAkDZ,CAAC;eAEY,MAAM"}

package/dist/extensions/cursor-cloud-agents/tools/launch.js

@@ -11,6 +11,7 @@ import { z } from "zod";
 import { defineTool } from "../../../tools.js";
 import extension from "../extension.js";
 import { cloudAgentsBackend } from "../lib/backend.js";
+import { assertWriteChannel } from "../lib/channels.js";
 import { recordLaunch } from "../lib/fleet.js";
 import { launchRepos } from "../lib/repos.js";
 const launch = defineTool({
@@ -26,7 +27,7 @@ const launch = defineTool({
             .string()
             .url()
             .optional()
-            .describe("GitHub repository URL, one of the configured repositories. Defaults to the configured repository."),
+            .describe("Repository clone URL (GitHub or Origin), one of the configured repositories. Defaults to the configured repository when there is exactly one."),
         starting_ref: z
             .string()
             .optional()
@@ -44,6 +45,7 @@ const launch = defineTool({
     }),
     execute(input, ctx) {
         return __awaiter(this, void 0, void 0, function* () {
+            assertWriteChannel(ctx);
             const { cloud, model } = extension.config;
             const launched = yield cloudAgentsBackend().launch({
                 prompt: input.prompt,

package/dist/extensions/cursor-cloud-agents/tools/reply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/reply.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,QAAA,MAAM,KAAK,EAAE,cAuBX,CAAC;eAEY,KAAK"}
+{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/tools/reply.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,QAAA,MAAM,KAAK,EAAE,cAwBX,CAAC;eAEY,KAAK"}

package/dist/extensions/cursor-cloud-agents/tools/reply.js

@@ -11,6 +11,7 @@ import { z } from "zod";
 import { defineTool } from "../../../tools.js";
 import extension from "../extension.js";
 import { cloudAgentsBackend } from "../lib/backend.js";
+import { assertWriteChannel } from "../lib/channels.js";
 import { assertOwned } from "../lib/fleet.js";
 import { agentRef } from "../lib/inputs.js";
 const reply = defineTool({
@@ -26,6 +27,7 @@ const reply = defineTool({
     }),
     execute(input, ctx) {
         return __awaiter(this, void 0, void 0, function* () {
+            assertWriteChannel(ctx);
             yield assertOwned(ctx, input.agent_id);
             const { runId } = yield cloudAgentsBackend().followUp(input.agent_id, input.prompt, input.interrupt);
             return { agentId: input.agent_id, runId, queued: !input.interrupt };

package/dist/extensions/cursor-grokbot-agents/extension.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Your Grok Bot agents as an extension. Mount it and the agent can talk to
+ * the Grok Bot agents of the host's account: send a message, read the
+ * reply, keep waiting on a long turn, interrupt one.
+ *
+ * ```ts
+ * // agent/extensions/grokbot.ts
+ * import cursorGrokBotAgents from "@cursor/bdk/extensions/cursor-grokbot-agents";
+ *
+ * export default cursorGrokBotAgents({
+ *   agents: [
+ *     { name: "Plan Keeper", description: "Keeps or moves outdoor plans." },
+ *   ],
+ * });
+ * ```
+ *
+ * Contributes `grokbot__ask`, `grokbot__check`, `grokbot__interrupt`,
+ * `grokbot__list` and the `grokbot__consult` skill (the namespace is the
+ * mount filename), over the same public `/v0/grokbot` session API the
+ * grokbot runtime uses, under the serve host's Cursor API key
+ * (`CURSOR_API_KEY`, key file, or `login`). Agents are addressed by name and
+ * resolved on the account the key belongs to; a message lands in that
+ * account's own conversation with the agent, and the reply is what the agent
+ * sends back during that turn. The tools run on the serve host, so they
+ * need the local runtime.
+ *
+ * This is the other direction from `defineAgent({ runtime: "grokbot" })`:
+ * the runtime runs *this* agent's turns on the hosted Grok Bot harness; the
+ * extension keeps the agent where it is and lets it talk to *other* Grok
+ * Bot agents.
+ */
+import type { Extension } from "../../types.js";
+/**
+ * A Grok Bot agent the model may address, by the name shown in the app.
+ * Type alias, not an interface: `list` returns these.
+ */
+export type ConfiguredGrokBotAgent = {
+    name: string;
+    /** What the agent is for; shown to the model by `list`. */
+    description?: string;
+};
+/** Mount options; every field is optional. */
+export interface CursorGrokBotAgentsOptions {
+    /**
+     * The Grok Bot agents the model may talk to, by name. This is the
+     * allowlist for a call's own `agent`: names outside it are refused, and a
+     * lone configured agent is the default when a call names none. Without
+     * it, any name goes through and `needsApproval` defaults to true, since
+     * an unknown name creates an agent of that name on the account.
+     */
+    agents?: Array<string | ConfiguredGrokBotAgent>;
+    /**
+     * Park messages for a human approval. Defaults to `true` when no `agents`
+     * are configured; `false` once they are. Pass an explicit boolean to
+     * override. Configured names still bound the model's choice regardless.
+     */
+    needsApproval?: boolean;
+    /** Cursor API key. Defaults to the serve host's own key. */
+    apiKey?: string;
+    /**
+     * How often to read the agent's transcript while waiting for a reply, in
+     * milliseconds. Defaults to 750.
+     */
+    pollIntervalMs?: number;
+}
+/** {@link CursorGrokBotAgentsOptions} with defaults applied. */
+export interface CursorGrokBotAgentsConfig {
+    agents?: ConfiguredGrokBotAgent[];
+    needsApproval: boolean;
+    apiKey?: string;
+    pollIntervalMs: number;
+}
+/** The backend's session name limit. */
+export declare const AGENT_NAME_MAX_LENGTH = 255;
+declare const cursorGrokBotAgents: Extension<CursorGrokBotAgentsConfig, CursorGrokBotAgentsOptions | undefined>;
+export default cursorGrokBotAgents;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/cursor-grokbot-agents/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,sBAAsB,CAAC,CAAC;IAChD;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AA0CzC,QAAA,MAAM,mBAAmB,EAAE,SAAS,CAClC,yBAAyB,EACzB,0BAA0B,GAAG,SAAS,CAKtC,CAAC;eAEY,mBAAmB"}

package/dist/extensions/cursor-grokbot-agents/extension.js

@@ -0,0 +1,63 @@
+/**
+ * Your Grok Bot agents as an extension. Mount it and the agent can talk to
+ * the Grok Bot agents of the host's account: send a message, read the
+ * reply, keep waiting on a long turn, interrupt one.
+ *
+ * ```ts
+ * // agent/extensions/grokbot.ts
+ * import cursorGrokBotAgents from "@cursor/bdk/extensions/cursor-grokbot-agents";
+ *
+ * export default cursorGrokBotAgents({
+ *   agents: [
+ *     { name: "Plan Keeper", description: "Keeps or moves outdoor plans." },
+ *   ],
+ * });
+ * ```
+ *
+ * Contributes `grokbot__ask`, `grokbot__check`, `grokbot__interrupt`,
+ * `grokbot__list` and the `grokbot__consult` skill (the namespace is the
+ * mount filename), over the same public `/v0/grokbot` session API the
+ * grokbot runtime uses, under the serve host's Cursor API key
+ * (`CURSOR_API_KEY`, key file, or `login`). Agents are addressed by name and
+ * resolved on the account the key belongs to; a message lands in that
+ * account's own conversation with the agent, and the reply is what the agent
+ * sends back during that turn. The tools run on the serve host, so they
+ * need the local runtime.
+ *
+ * This is the other direction from `defineAgent({ runtime: "grokbot" })`:
+ * the runtime runs *this* agent's turns on the hosted Grok Bot harness; the
+ * extension keeps the agent where it is and lets it talk to *other* Grok
+ * Bot agents.
+ */
+import { z } from "zod";
+import { defineExtension } from "../../extensions.js";
+/** The backend's session name limit. */
+export const AGENT_NAME_MAX_LENGTH = 255;
+const DEFAULT_POLL_INTERVAL_MS = 750;
+const agentName = z
+    .string()
+    .trim()
+    .min(1, "Grok Bot agent names must not be empty.")
+    .max(AGENT_NAME_MAX_LENGTH);
+const configuredAgent = z
+    .union([agentName, z.object({ name: agentName, description: z.string().optional() })])
+    .transform(agent => (typeof agent === "string" ? { name: agent } : agent));
+const agents = z
+    .array(configuredAgent)
+    .min(1, "agents must name at least one Grok Bot agent; omit it to allow any.")
+    .refine(list => new Set(list.map(agent => agent.name.toLowerCase())).size === list.length, "agents must not repeat a name (names match case-insensitively).");
+const config = z
+    .object({
+    agents: agents.optional(),
+    needsApproval: z.boolean().optional(),
+    apiKey: z.string().optional(),
+    pollIntervalMs: z.number().int().min(1).default(DEFAULT_POLL_INTERVAL_MS),
+})
+    .default({})
+    .transform(options => { var _a; return (Object.assign(Object.assign({}, options), { needsApproval: (_a = options.needsApproval) !== null && _a !== void 0 ? _a : options.agents === undefined })); });
+const cursorGrokBotAgents = defineExtension({
+    root: import.meta.dirname,
+    description: "Talk to your Grok Bot agents and read their replies.",
+    config,
+});
+export default cursorGrokBotAgents;

package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Which Grok Bot agent a call addresses. The model names one per call, but
+ * the author's `agents` are the allowlist: with them configured, a name
+ * outside the list is refused (the backend would create an agent of that
+ * name), and a lone configured agent stands in when the call names none.
+ * Matching is case-insensitive and resolves to the configured spelling,
+ * since the backend looks names up exactly.
+ */
+import type { ConfiguredGrokBotAgent } from "../extension.js";
+export declare function resolveAgentName(requested: string | undefined, configured: ConfiguredGrokBotAgent[] | undefined): string;
+//# sourceMappingURL=agents.d.ts.map

package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,sBAAsB,EAAE,GAAG,SAAS,GAC/C,MAAM,CA2BR"}

package/dist/extensions/cursor-grokbot-agents/lib/agents.js

@@ -0,0 +1,31 @@
+/**
+ * Which Grok Bot agent a call addresses. The model names one per call, but
+ * the author's `agents` are the allowlist: with them configured, a name
+ * outside the list is refused (the backend would create an agent of that
+ * name), and a lone configured agent stands in when the call names none.
+ * Matching is case-insensitive and resolves to the configured spelling,
+ * since the backend looks names up exactly.
+ */
+export function resolveAgentName(requested, configured) {
+    var _a;
+    const name = requested === null || requested === void 0 ? void 0 : requested.trim();
+    if (configured === undefined) {
+        if (name === undefined || name === "") {
+            throw new Error("`agent` is required: this extension has no configured Grok Bot agents.");
+        }
+        return name;
+    }
+    const names = configured.map(agent => `"${agent.name}"`).join(", ");
+    if (name === undefined || name === "") {
+        const only = configured.length === 1 ? configured[0] : undefined;
+        if (only === undefined) {
+            throw new Error(`\`agent\` is required: this extension configures several Grok Bot agents (${names}).`);
+        }
+        return only.name;
+    }
+    const match = (_a = configured.find(agent => agent.name === name)) !== null && _a !== void 0 ? _a : configured.find(agent => agent.name.toLowerCase() === name.toLowerCase());
+    if (match === undefined) {
+        throw new Error(`"${name}" is not one of this extension's configured Grok Bot agents (${names}).`);
+    }
+    return match.name;
+}

package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The `/v0/grokbot` session API as the tools use it: the same four routes
+ * the grokbot runtime drives, on the external API host (`api.cursor.com`;
+ * they 404 on api2), under the host's Cursor API key. A session is a hosted
+ * Grok Bot agent of the key's account, get-or-created by name; messages go
+ * into its one conversation, and the transcript is read back as entries
+ * after a cursor, with the turn's status alongside.
+ */
+export declare class GrokBotApiError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+export type GrokBotSession = {
+    /** The hosted agent's durable id; every other route addresses it. */
+    sessionId: string;
+    /** The name as the backend stores it (trimmed). */
+    name: string;
+    createdAtMs: number;
+    /** Transcript tail: reading after it skips the conversation's history. */
+    latestUpdatedSeq: string;
+};
+export type GrokBotEntry = {
+    seq: string;
+    updatedSeq: string;
+    kind: string;
+    role?: string;
+    text?: string;
+    createdAtMs: number;
+};
+export type GrokBotTurnStatus = {
+    idle: boolean;
+    inFlight: boolean;
+    queued: number;
+};
+export type GrokBotEntriesPage = {
+    entries: GrokBotEntry[];
+    latestUpdatedSeq: string;
+    turn: GrokBotTurnStatus;
+};
+export declare class GrokBotAgentsBackend {
+    private readonly apiKey;
+    private readonly fetchImpl;
+    constructor(apiKey: () => string, fetchImpl?: typeof fetch);
+    /** `POST /v0/grokbot/sessions`: the account's agent of that name, created when missing. */
+    session(name: string): Promise<GrokBotSession>;
+    /** Deliver one user message to the agent's conversation. */
+    send(sessionId: string, text: string): Promise<void>;
+    /** Transcript entries after `afterUpdatedSeq`, oldest first, with the turn's status. */
+    entries(sessionId: string, afterUpdatedSeq: string): Promise<GrokBotEntriesPage>;
+    interrupt(sessionId: string, reason: string): Promise<void>;
+    private request;
+}
+/** The process-wide backend for this mount, built on first use. */
+export declare function grokBotAgentsBackend(): GrokBotAgentsBackend;
+export declare function apiKey(): string;
+//# sourceMappingURL=backend.d.ts.map

package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,qBAAa,eAAgB,SAAQ,KAAK;IAGtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAF1B,YACE,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,MAAM,YAAA,EAIzB;CACF;AAGD,MAAM,MAAM,cAAc,GAAG;IAC3B,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAiCF,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAF5B,YACmB,MAAM,EAAE,MAAM,MAAM,EACpB,SAAS,GAAE,OAAO,KAAa,EAC9C;IAEJ,2FAA2F;IACrF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAYnD;IAED,4DAA4D;IACtD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzD;IAED,wFAAwF;IAClF,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAOrF;IAEK,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE;YAEa,OAAO;CA+BtB;AAID,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI,oBAAoB,CAG3D;AAED,wBAAgB,MAAM,IAAI,MAAM,CAO/B"}

package/dist/extensions/cursor-grokbot-agents/lib/backend.js

@@ -0,0 +1,158 @@
+/**
+ * The `/v0/grokbot` session API as the tools use it: the same four routes
+ * the grokbot runtime drives, on the external API host (`api.cursor.com`;
+ * they 404 on api2), under the host's Cursor API key. A session is a hosted
+ * Grok Bot agent of the key's account, get-or-created by name; messages go
+ * into its one conversation, and the transcript is read back as entries
+ * after a cursor, with the turn's status alongside.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { cursorExternalApiUrl, resolveApiKeySync, SIGN_IN_HINT, } from "../../../internal/cursor/credentials.js";
+import extension from "../extension.js";
+const REQUEST_TIMEOUT_MS = 60000;
+export class GrokBotApiError extends Error {
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "GrokBotApiError";
+    }
+}
+const sessionSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    createdAtMs: z.number(),
+    latestUpdatedSeq: z.string(),
+});
+const sendSchema = z.object({
+    messageId: z.string(),
+    delivery: z.string(),
+});
+const entriesSchema = z.object({
+    entries: z.array(z.object({
+        seq: z.string(),
+        updatedSeq: z.string(),
+        kind: z.string(),
+        role: z.string().optional(),
+        text: z.string().optional(),
+        createdAtMs: z.number(),
+    })),
+    latestUpdatedSeq: z.string(),
+    turn: z.object({
+        idle: z.boolean(),
+        inFlight: z.boolean(),
+        queued: z.number(),
+    }),
+});
+export class GrokBotAgentsBackend {
+    constructor(apiKey, fetchImpl = fetch) {
+        this.apiKey = apiKey;
+        this.fetchImpl = fetchImpl;
+    }
+    /** `POST /v0/grokbot/sessions`: the account's agent of that name, created when missing. */
+    session(name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // No `instructions`: the agent is somebody's, configured in the app, and
+            // an omitted field never touches its stored profile.
+            const parsed = sessionSchema.parse(yield this.request("POST", "/v0/grokbot/sessions", { name }));
+            return {
+                sessionId: parsed.id,
+                name: parsed.name,
+                createdAtMs: parsed.createdAtMs,
+                latestUpdatedSeq: parsed.latestUpdatedSeq,
+            };
+        });
+    }
+    /** Deliver one user message to the agent's conversation. */
+    send(sessionId, text) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { delivery } = sendSchema.parse(yield this.request("POST", `/v0/grokbot/sessions/${sessionId}/messages`, {
+                text,
+                messageId: randomUUID(),
+            }));
+            if (delivery !== "accepted_temporal" && delivery !== "duplicate") {
+                throw new GrokBotApiError(`The Grok Bot agent's harness did not accept the message (delivery: ${delivery}).`);
+            }
+        });
+    }
+    /** Transcript entries after `afterUpdatedSeq`, oldest first, with the turn's status. */
+    entries(sessionId, afterUpdatedSeq) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return entriesSchema.parse(yield this.request("GET", `/v0/grokbot/sessions/${sessionId}/entries?afterUpdatedSeq=${encodeURIComponent(afterUpdatedSeq)}`));
+        });
+    }
+    interrupt(sessionId, reason) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.request("POST", `/v0/grokbot/sessions/${sessionId}/interrupt`, {
+                reason,
+            });
+        });
+    }
+    request(method, path, body) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const headers = {
+                authorization: `Bearer ${this.apiKey()}`,
+                "x-cursor-client-type": "agent-serve",
+                "x-request-id": randomUUID(),
+            };
+            if (body !== undefined) {
+                headers["content-type"] = "application/json";
+            }
+            let response;
+            try {
+                response = yield this.fetchImpl(`${cursorExternalApiUrl()}${path}`, {
+                    method,
+                    headers,
+                    body: body === undefined ? undefined : JSON.stringify(body),
+                    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+                });
+            }
+            catch (error) {
+                throw new GrokBotApiError(`Grok Bot API ${method} ${path} failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            const text = yield response.text();
+            if (!response.ok) {
+                throw new GrokBotApiError(`Grok Bot API ${method} ${path} failed (${response.status}): ${apiErrorMessage(text)}`, response.status);
+            }
+            return JSON.parse(text);
+        });
+    }
+}
+let backend;
+/** The process-wide backend for this mount, built on first use. */
+export function grokBotAgentsBackend() {
+    backend !== null && backend !== void 0 ? backend : (backend = new GrokBotAgentsBackend(apiKey));
+    return backend;
+}
+export function apiKey() {
+    // Read per call: the host can sign in after the mount.
+    const key = resolveApiKeySync({ apiKey: extension.config.apiKey });
+    if (key === undefined) {
+        throw new Error(`Grok Bot agents need a Cursor API key. ${SIGN_IN_HINT}`);
+    }
+    return key.apiKey;
+}
+/** The route's `{ error }` envelope when it is one, the raw body otherwise. */
+function apiErrorMessage(text) {
+    var _a;
+    try {
+        const parsed = JSON.parse(text);
+        const message = (_a = parsed.error) !== null && _a !== void 0 ? _a : parsed.message;
+        if (typeof message === "string" && message !== "") {
+            return message;
+        }
+    }
+    catch (_b) {
+        // Not JSON; fall through to the raw body.
+    }
+    return text.slice(0, 300);
+}

package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Who has talked to which Grok Bot agent, and how far into its transcript
+ * they have read. The tools authenticate with the serve host's one Cursor
+ * API key, so every agent is that account's; what the host keeps per
+ * principal is the read cursor, so `check` returns what the agent said
+ * since that caller last read, and a lookup by name for `check` and
+ * `interrupt`, which never create an agent the caller has not spoken to.
+ */
+import type { ToolContext } from "../../../types.js";
+export type Contact = {
+    /** The agent's name as the backend stores it. */
+    name: string;
+    /** The hosted agent's `/v0/grokbot` session id. */
+    sessionId: string;
+    /** Newest transcript `updatedSeq` this principal has read. */
+    cursor: string;
+    firstContactAt: string;
+    lastContactAt: string;
+};
+/** Unauthenticated sessions (local dev, direct calls) share one principal. */
+export declare function principalOf(ctx: ToolContext): string;
+/** The caller's contacts, most recently spoken to first. */
+export declare function listContacts(ctx: ToolContext): Promise<Contact[]>;
+/** The contact of that name, exact spelling first, then case-insensitively. */
+export declare function findContact(contacts: Contact[], name: string): Contact | undefined;
+/** Insert or replace the caller's record of one agent, newest first. */
+export declare function saveContact(ctx: ToolContext, contact: Contact): Promise<void>;
+//# sourceMappingURL=contacts.d.ts.map

package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/contacts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,MAAM,MAAM,OAAO,GAAG;IACpB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAcF,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAGpD;AAED,4DAA4D;AAC5D,wBAAsB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAGvE;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAMlF;AAED,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnF"}

package/dist/extensions/cursor-grokbot-agents/lib/contacts.js

@@ -0,0 +1,59 @@
+/**
+ * Who has talked to which Grok Bot agent, and how far into its transcript
+ * they have read. The tools authenticate with the serve host's one Cursor
+ * API key, so every agent is that account's; what the host keeps per
+ * principal is the read cursor, so `check` returns what the agent said
+ * since that caller last read, and a lookup by name for `check` and
+ * `interrupt`, which never create an agent the caller has not spoken to.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { z } from "zod";
+import { KeyedLock } from "./lock.js";
+const PREFIX = "grokbot-agents";
+const contactsSchema = z.array(z.object({
+    name: z.string(),
+    sessionId: z.string(),
+    cursor: z.string(),
+    firstContactAt: z.string(),
+    lastContactAt: z.string(),
+}));
+const locks = new KeyedLock();
+/** Unauthenticated sessions (local dev, direct calls) share one principal. */
+export function principalOf(ctx) {
+    const auth = ctx.session.auth;
+    return auth === null ? "anonymous" : `${auth.principalType}:${auth.principalId}`;
+}
+/** The caller's contacts, most recently spoken to first. */
+export function listContacts(ctx) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const contacts = contactsSchema.safeParse(yield ctx.host.kv.get(contactsKey(principalOf(ctx))));
+        return contacts.success ? contacts.data : [];
+    });
+}
+/** The contact of that name, exact spelling first, then case-insensitively. */
+export function findContact(contacts, name) {
+    var _a;
+    const wanted = name.trim();
+    return ((_a = contacts.find(contact => contact.name === wanted)) !== null && _a !== void 0 ? _a : contacts.find(contact => contact.name.toLowerCase() === wanted.toLowerCase()));
+}
+/** Insert or replace the caller's record of one agent, newest first. */
+export function saveContact(ctx, contact) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const key = contactsKey(principalOf(ctx));
+        yield locks.run(key, () => __awaiter(this, void 0, void 0, function* () {
+            const others = (yield listContacts(ctx)).filter(existing => existing.sessionId !== contact.sessionId);
+            yield ctx.host.kv.put(key, [contact, ...others]);
+        }));
+    });
+}
+function contactsKey(principal) {
+    return `${PREFIX}/principals/${encodeURIComponent(principal)}`;
+}