@cursor/bdk 0.2.10 → 0.2.12

package/dist/evals/judge.js

@@ -82,7 +82,7 @@ export function parseJudgeReply(reply, allowed) {
     throw new Error(`judge reply had no choice from [${allowed.join(", ")}]: ${JSON.stringify(text.slice(0, 160))}`);
 }
 function normalizeChoice(token, allowed) {
-    return allowed.find(choice => choice.toLowerCase() === token.toLowerCase());
+    return allowed.find((choice) => choice.toLowerCase() === token.toLowerCase());
 }
 function graderFromChoices(args) {
     const allowed = Object.keys(args.scores);

package/dist/evals/reporters.js

@@ -55,10 +55,10 @@ export function renderJUnitXml(summary, suiteName) {
             lines.push(`      <skipped message="${escapeXml(result.skipReason ?? "skipped")}"/>`);
         }
         else if (verdict === "failed" || (verdict === "scored" && summary.strict)) {
-            const failures = result.assertions.filter(a => !a.passed);
+            const failures = result.assertions.filter((a) => !a.passed);
             const message = result.error ??
                 failures
-                    .map(a => `${a.name}${a.detail === undefined ? "" : ` (${a.detail})`}`)
+                    .map((a) => `${a.name}${a.detail === undefined ? "" : ` (${a.detail})`}`)
                     .join("; ") ??
                 verdict;
             lines.push(`      <failure message="${escapeXml(message === "" ? verdict : message)}" type="${escapeXml(verdict)}"/>`);
@@ -156,7 +156,7 @@ export function Artifacts(options) {
                 ...totals,
                 caseCount: results.length,
                 target,
-                discovered: discovered.map(e => e.id),
+                discovered: discovered.map((e) => e.id),
             }, null, 2)}\n`, "utf8");
         },
     };
@@ -171,8 +171,8 @@ export function Artifacts(options) {
 export function sanitizeCaseId(id) {
     return id
         .split("/")
-        .map(segment => segment.replace(/[^A-Za-z0-9._-]/g, "_"))
-        .filter(segment => segment !== "" && segment !== "." && segment !== "..")
+        .map((segment) => segment.replace(/[^A-Za-z0-9._-]/g, "_"))
+        .filter((segment) => segment !== "" && segment !== "." && segment !== "..")
         .join("/");
 }
 /** Fan one lifecycle call out to several reporters, isolating failures. */
@@ -189,8 +189,8 @@ export function combineReporters(reporters, onError) {
         }
     };
     return {
-        onRunStart: (evals, target) => forEach(r => r.onRunStart?.(evals, target)),
-        onEvalComplete: result => forEach(r => r.onEvalComplete?.(result)),
-        onRunComplete: summary => forEach(r => r.onRunComplete?.(summary)),
+        onRunStart: (evals, target) => forEach((r) => r.onRunStart?.(evals, target)),
+        onEvalComplete: (result) => forEach((r) => r.onEvalComplete?.(result)),
+        onRunComplete: (summary) => forEach((r) => r.onRunComplete?.(summary)),
     };
 }

package/dist/evals/run-facts.js

@@ -192,7 +192,7 @@ export function deriveRunFacts(events) {
                 break;
         }
     }
-    const pendingInputRequests = inputRequests.filter(r => !r.resolved);
+    const pendingInputRequests = inputRequests.filter((r) => !r.resolved);
     // `turn.*` events all carry a turnId; session-scoped events do not, so the
     // turn count is the number of distinct turn ids seen.
     const turns = turnIds.size;
@@ -208,6 +208,6 @@ export function deriveRunFacts(events) {
         ok: failedTurnIds.size === 0 && !sessionFailed && turns > 0,
         assistantMessages,
         assistantText: assistantMessages.join("\n"),
-        failedToolCalls: toolCalls.filter(c => c.status === "failed"),
+        failedToolCalls: toolCalls.filter((c) => c.status === "failed"),
     };
 }

package/dist/evals.js

@@ -135,7 +135,7 @@ function validateDatapointId(id) {
  */
 export function expandEvalDefinition(fileId, definition) {
     if (definition.cases !== undefined) {
-        return definition.cases.flatMap(datapoint => {
+        return definition.cases.flatMap((datapoint) => {
             const description = datapoint.description ?? definition.description;
             const timeoutMs = datapoint.timeoutMs ?? definition.timeoutMs;
             const iterations = normalizeEvalIterations(datapoint.iterations ?? definition.iterations ?? 1);
@@ -231,17 +231,17 @@ export function isEvalSummaryCase(tags) {
  * Preserves discovery order from `all`.
  */
 export function expandSummarySuiteSelection(all, selected, isSummary) {
-    const fileIdsNeedingSuite = new Set(selected.filter(item => isSummary(item)).map(item => item.fileId));
+    const fileIdsNeedingSuite = new Set(selected.filter((item) => isSummary(item)).map((item) => item.fileId));
     if (fileIdsNeedingSuite.size === 0) {
         return [...selected];
     }
-    const selectedIds = new Set(selected.map(item => item.id));
-    const extras = all.filter(item => fileIdsNeedingSuite.has(item.fileId) && !selectedIds.has(item.id));
+    const selectedIds = new Set(selected.map((item) => item.id));
+    const extras = all.filter((item) => fileIdsNeedingSuite.has(item.fileId) && !selectedIds.has(item.id));
     if (extras.length === 0) {
         return [...selected];
     }
-    const want = new Set([...selectedIds, ...extras.map(item => item.id)]);
-    return all.filter(item => want.has(item.id));
+    const want = new Set([...selectedIds, ...extras.map((item) => item.id)]);
+    return all.filter((item) => want.has(item.id));
 }
 /**
  * Hard ceiling for concurrent eval cases.

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

@@ -28,6 +28,8 @@
  * agent; no model turn runs until the one wake.
  */
 import type { AgentCloudOptions, Extension, ModelSetting } from "../../types.js";
+export type { CloudAgentLaunch, CloudEnvironment } from "./lib/backend.js";
+export { type CloudAgentLaunchResult, getCloudEnvironment, launchCloudAgent, listCloudEnvironmentsNamed, } from "./lib/launch-agent.js";
 type CloudRepo = NonNullable<AgentCloudOptions["repos"]>[number];
 export type CursorCloudAgentsCloudOptions = Omit<AgentCloudOptions, "repos"> & {
     repos?: CloudRepo[] | (() => CloudRepo[]);

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

@@ -1 +1 @@
-{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/cursor-cloud-agents/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjF,KAAK,SAAS,GAAG,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG;IAC7E,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC;CAC3C,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,6BAA6B,CAAC;IACtC,mEAAmE;IACnE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,6BAA6B,CAAC;IACrC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAoDD,QAAA,MAAM,iBAAiB,EAAE,SAAS,CAAC,uBAAuB,EAAE,wBAAwB,GAAG,SAAS,CAK5F,CAAC;eAEU,iBAAiB"}
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/cursor-cloud-agents/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EACL,KAAK,sBAAsB,EAC3B,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,KAAK,SAAS,GAAG,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG;IAC7E,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC;CAC3C,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,6BAA6B,CAAC;IACtC,mEAAmE;IACnE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,6BAA6B,CAAC;IACrC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAoDD,QAAA,MAAM,iBAAiB,EAAE,SAAS,CAAC,uBAAuB,EAAE,wBAAwB,GAAG,SAAS,CAK5F,CAAC;eAEU,iBAAiB"}

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

@@ -29,6 +29,7 @@
  */
 import { z } from "zod";
 import { defineExtension } from "../../extensions.js";
+export { getCloudEnvironment, launchCloudAgent, listCloudEnvironmentsNamed, } from "./lib/launch-agent.js";
 const repo = z.object({
     url: z.string().url(),
     startingRef: z.string().optional(),
@@ -66,7 +67,7 @@ const config = z
     watchStops: z.boolean().default(true),
 })
     .default({})
-    .transform(options => ({
+    .transform((options) => ({
     ...options,
     needsApproval: options.needsApproval ?? options.cloud.repos === undefined,
 }));

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

@@ -47,6 +47,14 @@ export type CloudAgentLaunch = {
     status: string;
     url: string;
 };
+/** A saved cloud environment as the caller's API key can see it. */
+export type CloudEnvironment = {
+    publicId: string;
+    name: string;
+    repoUrls: string[];
+    /** False when the backend marks the environment unable to launch agents. */
+    eligible: boolean;
+};
 export type LaunchRequest = {
     prompt: string;
     name?: string;
@@ -60,6 +68,14 @@ export declare class CloudAgentsBackend {
     constructor(apiKey: () => string, fetchImpl?: typeof fetch);
     /** `POST /v1/agents`: create the agent and start its first run in one call. */
     launch(request: LaunchRequest): Promise<CloudAgentLaunch>;
+    /** `GetEnvironment`: one saved environment by public id, or undefined when not visible. */
+    environment(publicId: string): Promise<CloudEnvironment | undefined>;
+    /**
+     * `ListEnvironments`: the caller's visible environments whose display name
+     * is exactly `name`. The v1 launch API resolves `env.name` by name, so this
+     * is how a caller confirms the name picks one environment.
+     */
+    environmentsNamed(name: string): Promise<CloudEnvironment[]>;
     info(agentId: string): Promise<CloudAgentInfo>;
     conversation(agentId: string): Promise<CloudAgentMessage[]>;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAUzE,qBAAa,mBAAoB,SAAQ,KAAK;IAG1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAF1B,YACE,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,MAAM,YAAA,EAIzB;CACF;AAED,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,SAAS,GACT,UAAU,GACV,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AAGd,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9E,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,CAAC;AA6DF,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAEhD,YACmB,MAAM,EAAE,MAAM,MAAM,EACpB,SAAS,GAAE,OAAO,KAAa,EASjD;IAED,+EAA+E;IACzE,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8C9D;IAEK,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA8BnD;IAEK,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuBhE;IAED;;;OAGG;IACG,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAmBxC;IAEK,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1C;CACF;AAID,mEAAmE;AACnE,wBAAgB,kBAAkB,IAAI,kBAAkB,CAGvD;AAED,wBAAgB,MAAM,IAAI,MAAM,CAM/B"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/backend.ts"],"names":[],"mappings":"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"}

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

@@ -69,6 +69,31 @@ const conversationResponseSchema = z.object({
         .optional(),
 });
 const followupResponseSchema = z.object({ runId: z.string().optional() });
+const environmentSchema = z.object({
+    publicId: z.string(),
+    name: z.string().optional(),
+    repoConfig: z
+        .object({ repos: z.array(z.object({ repoUrl: z.string().optional() })).optional() })
+        .optional(),
+    ineligibilityReason: z.string().optional(),
+});
+const getEnvironmentResponseSchema = z.object({ environment: environmentSchema.optional() });
+const listEnvironmentsResponseSchema = z.object({
+    environments: z.array(environmentSchema).optional(),
+});
+function toCloudEnvironment(environment) {
+    const reason = environment.ineligibilityReason;
+    return {
+        publicId: environment.publicId,
+        name: environment.name ?? "",
+        repoUrls: (environment.repoConfig?.repos ?? [])
+            .map((repo) => repo.repoUrl ?? "")
+            .filter((url) => url !== ""),
+        eligible: reason === undefined ||
+            reason === "" ||
+            reason === "ENVIRONMENT_INELIGIBILITY_REASON_UNSPECIFIED",
+    };
+}
 const launchResponseSchema = z.object({
     agent: z.object({ id: z.string(), url: z.string().optional() }),
     run: z.object({ id: z.string(), status: z.string() }),
@@ -130,6 +155,22 @@ export class CloudAgentsBackend {
             url: parsed.agent.url ?? cloudAgentUrl(parsed.agent.id),
         };
     }
+    /** `GetEnvironment`: one saved environment by public id, or undefined when not visible. */
+    async environment(publicId) {
+        const { environment } = getEnvironmentResponseSchema.parse(await this.rpcClient.serviceRpc(SERVICE, "GetEnvironment", { publicId }, RPC_TIMEOUT_MS));
+        return environment === undefined ? undefined : toCloudEnvironment(environment);
+    }
+    /**
+     * `ListEnvironments`: the caller's visible environments whose display name
+     * is exactly `name`. The v1 launch API resolves `env.name` by name, so this
+     * is how a caller confirms the name picks one environment.
+     */
+    async environmentsNamed(name) {
+        const { environments } = listEnvironmentsResponseSchema.parse(await this.rpcClient.serviceRpc(SERVICE, "ListEnvironments", { searchQuery: name, limit: 100 }, RPC_TIMEOUT_MS));
+        return (environments ?? [])
+            .filter((environment) => environment.name === name)
+            .map(toCloudEnvironment);
+    }
     async info(agentId) {
         const { composer } = infoResponseSchema.parse(await this.rpcClient.serviceRpc(SERVICE, "GetBackgroundComposerInfo", { bcId: agentId }, RPC_TIMEOUT_MS));
         const { composer: summary } = composer;
@@ -155,8 +196,8 @@ export class CloudAgentsBackend {
     }
     async conversation(agentId) {
         const { conversation } = conversationResponseSchema.parse(await this.rpcClient.serviceRpc(SERVICE, "GetBackgroundComposerConversation", { bcId: agentId }, RPC_TIMEOUT_MS));
-        return (conversation ?? []).map(message => {
-            const toolCalls = (message.toolResults ?? []).map(result => ({
+        return (conversation ?? []).map((message) => {
+            const toolCalls = (message.toolResults ?? []).map((result) => ({
                 name: result.toolName ?? "",
                 args: parseArgs(result.args ?? result.rawArgs),
                 content: result.content,
@@ -243,7 +284,7 @@ function apiErrorMessage(text) {
         const parsed = JSON.parse(text);
         const code = parsed.error?.code ?? parsed.code;
         const message = parsed.error?.message ?? parsed.message;
-        return [code, message].filter(part => part !== undefined).join(": ") || text;
+        return [code, message].filter((part) => part !== undefined).join(": ") || text;
     }
     catch {
         return text;

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

@@ -58,7 +58,7 @@ export async function assertOwned(ctx, agentId) {
 export async function listFleet(ctx, scope = "all") {
     const fleet = fleetSchema.safeParse(await ctx.host.kv.get(fleetKey(principalOf(ctx))));
     const entries = fleet.success ? fleet.data : [];
-    return scope === "all" ? entries : entries.filter(entry => entry.sessionId === ctx.session.id);
+    return scope === "all" ? entries : entries.filter((entry) => entry.sessionId === ctx.session.id);
 }
 function fleetKey(principal) {
     return `${PREFIX}/principals/${encodeURIComponent(principal)}`;

package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The one launch path: channel gate, v1 launch with the mount's model,
+ * principal binding, and the stop watch. `cloud__launch` calls it with the
+ * mount's repositories; an authored tool can call it with its own
+ * `cloud` target (a named saved environment, say) after applying its own
+ * gates, and the launched agent is then steerable with the mount's
+ * `get` / `dump` / `reply` / `cancel` like any other.
+ */
+import type { AgentCloudOptions, ToolContext } from "../../../types.js";
+import { type CloudAgentLaunch, type CloudEnvironment } from "./backend.js";
+export type CloudAgentLaunchResult = CloudAgentLaunch & {
+    watching: boolean;
+};
+export declare function launchCloudAgent(ctx: ToolContext, request: {
+    prompt: string;
+    name?: string;
+    cloud: AgentCloudOptions;
+}): Promise<CloudAgentLaunchResult>;
+/** A saved environment by public id under the mount's API key; undefined when not visible. */
+export declare function getCloudEnvironment(publicId: string): Promise<CloudEnvironment | undefined>;
+/** Visible saved environments whose display name is exactly `name`. */
+export declare function listCloudEnvironmentsNamed(name: string): Promise<CloudEnvironment[]>;
+//# sourceMappingURL=launch-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launch-agent.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/launch-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAsB,MAAM,cAAc,CAAC;AAKhG,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9E,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACnE,OAAO,CAAC,sBAAsB,CAAC,CAUjC;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAE3F;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAEpF"}

package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js

@@ -0,0 +1,32 @@
+/**
+ * The one launch path: channel gate, v1 launch with the mount's model,
+ * principal binding, and the stop watch. `cloud__launch` calls it with the
+ * mount's repositories; an authored tool can call it with its own
+ * `cloud` target (a named saved environment, say) after applying its own
+ * gates, and the launched agent is then steerable with the mount's
+ * `get` / `dump` / `reply` / `cancel` like any other.
+ */
+import extension from "../extension.js";
+import { cloudAgentsBackend } from "./backend.js";
+import { assertWriteChannel } from "./channels.js";
+import { recordLaunch } from "./fleet.js";
+import { armWatch } from "./watch.js";
+export async function launchCloudAgent(ctx, request) {
+    assertWriteChannel(ctx);
+    const launched = await cloudAgentsBackend().launch({
+        prompt: request.prompt,
+        name: request.name,
+        model: extension.config.model,
+        cloud: request.cloud,
+    });
+    await recordLaunch(ctx, launched.agentId, request.name);
+    return { ...launched, watching: await armWatch(ctx, launched) };
+}
+/** A saved environment by public id under the mount's API key; undefined when not visible. */
+export function getCloudEnvironment(publicId) {
+    return cloudAgentsBackend().environment(publicId);
+}
+/** Visible saved environments whose display name is exactly `name`. */
+export function listCloudEnvironmentsNamed(name) {
+    return cloudAgentsBackend().environmentsNamed(name);
+}

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

@@ -35,7 +35,7 @@ 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 = allowlist?.some(configured => repoKey(configured.url) === repoKey(url));
+    const allowlisted = allowlist?.some((configured) => repoKey(configured.url) === repoKey(url));
     if (allowlisted !== true) {
         throw new Error(allowlist === undefined
             ? `Configure cloud.repos before launching against a model-chosen repository (${url}).`
@@ -44,7 +44,7 @@ export function launchRepos(target, cloud) {
     // Keep the matching allowlist entry's branch / PR defaults when the model
     // only names the repository (handoff always passes `repo`). An explicit
     // `ref` clears an inherited `prUrl` so branch and PR targets do not mix.
-    const match = configured.find(configuredRepo => repoKey(configuredRepo.url) === repoKey(url));
+    const match = configured.find((configuredRepo) => repoKey(configuredRepo.url) === repoKey(url));
     return [
         {
             url: match?.url ?? url,

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

@@ -4,11 +4,11 @@ export function transcriptPath(agentId) {
     return `cloud-agent-transcripts/${agentId}.jsonl`;
 }
 export function transcriptLines(messages) {
-    return messages.map(message => JSON.stringify(message));
+    return messages.map((message) => JSON.stringify(message));
 }
 /** The text of the last assistant message, the agent's report. */
 export function lastAssistantText(messages) {
     return messages
         .toReversed()
-        .find(message => message.role === "assistant" && message.text !== undefined)?.text;
+        .find((message) => message.role === "assistant" && message.text !== undefined)?.text;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/watch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAerD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAyC3F;AAED,sEAAsE;AACtE,wBAAsB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBpF"}
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/watch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAerD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CA2C3F;AAED,sEAAsE;AACtE,wBAAsB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBpF"}

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

@@ -39,7 +39,7 @@ export async function armWatch(ctx, launch) {
             purpose: WATCH_PURPOSE,
             continuationToken,
         });
-        if (armed.some(reminder => reminder.channelId === channelId && watched(reminder) === agentId)) {
+        if (armed.some((reminder) => reminder.channelId === channelId && watched(reminder) === agentId)) {
             return true;
         }
         const args = {

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;AAQxD,QAAA,MAAM,MAAM,EAAE,cAkDZ,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;AAMxD,QAAA,MAAM,MAAM,EAAE,cA+CZ,CAAC;eAEY,MAAM"}

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

@@ -1,11 +1,9 @@
 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 { launchCloudAgent } from "../lib/launch-agent.js";
 import { launchRepos } from "../lib/repos.js";
-import { armWatch } from "../lib/watch.js";
 const launch = defineTool({
     description: "Launch a Cursor cloud agent on a repository with a self-contained task. Returns the agent id and URL, and watching: true when this conversation will be woken once the agent stops; check on it with get, read what it did with dump.",
     effect: "write",
@@ -37,18 +35,15 @@ const launch = defineTool({
     }),
     async execute(input, ctx) {
         assertWriteChannel(ctx);
-        const { cloud, model } = extension.config;
-        const launched = await cloudAgentsBackend().launch({
+        const { cloud } = extension.config;
+        return launchCloudAgent(ctx, {
             prompt: input.prompt,
             name: input.name,
-            model,
             cloud: {
                 ...cloud,
                 repos: launchRepos({ repo: input.repo, ref: input.starting_ref, prUrl: input.pr_url }, cloud),
             },
         });
-        await recordLaunch(ctx, launched.agentId, input.name);
-        return { ...launched, watching: await armWatch(ctx, launched) };
     },
 });
 export default launch;

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

@@ -18,7 +18,7 @@ const list = defineTool({
             sessionId: ctx.session.id,
             agents: fleet
                 .slice(0, input.limit)
-                .map(entry => ({ ...entry, url: cloudAgentUrl(entry.agentId) })),
+                .map((entry) => ({ ...entry, url: cloudAgentUrl(entry.agentId) })),
         };
     },
 });

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

@@ -41,11 +41,11 @@ const agentName = z
     .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));
+    .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).");
+    .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(),
@@ -54,7 +54,7 @@ const config = z
     pollIntervalMs: z.number().int().min(1).default(DEFAULT_POLL_INTERVAL_MS),
 })
     .default({})
-    .transform(options => ({
+    .transform((options) => ({
     ...options,
     needsApproval: options.needsApproval ?? options.agents === undefined,
 }));

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

@@ -14,7 +14,7 @@ export function resolveAgentName(requested, configured) {
         }
         return name;
     }
-    const names = configured.map(agent => `"${agent.name}"`).join(", ");
+    const names = configured.map((agent) => `"${agent.name}"`).join(", ");
     if (name === undefined || name === "") {
         const only = configured.length === 1 ? configured[0] : undefined;
         if (only === undefined) {
@@ -22,8 +22,8 @@ export function resolveAgentName(requested, configured) {
         }
         return only.name;
     }
-    const match = configured.find(agent => agent.name === name) ??
-        configured.find(agent => agent.name.toLowerCase() === name.toLowerCase());
+    const match = configured.find((agent) => agent.name === name) ??
+        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}).`);
     }

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

@@ -30,14 +30,14 @@ export async function listContacts(ctx) {
 /** The contact of that name, exact spelling first, then case-insensitively. */
 export function findContact(contacts, name) {
     const wanted = name.trim();
-    return (contacts.find(contact => contact.name === wanted) ??
-        contacts.find(contact => contact.name.toLowerCase() === wanted.toLowerCase()));
+    return (contacts.find((contact) => contact.name === wanted) ??
+        contacts.find((contact) => contact.name.toLowerCase() === wanted.toLowerCase()));
 }
 /** Insert or replace the caller's record of one agent, newest first. */
 export async function saveContact(ctx, contact) {
     const key = contactsKey(principalOf(ctx));
     await locks.run(key, async () => {
-        const others = (await listContacts(ctx)).filter(existing => existing.sessionId !== contact.sessionId);
+        const others = (await listContacts(ctx)).filter((existing) => existing.sessionId !== contact.sessionId);
         await ctx.host.kv.put(key, [contact, ...others]);
     });
 }

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

@@ -39,7 +39,7 @@ export async function ask(ctx, input) {
     const startedAt = Date.now();
     const session = await backend.session(name);
     return agentLocks.run(session.sessionId, async () => {
-        const contact = (await listContacts(ctx)).find(candidate => candidate.sessionId === session.sessionId);
+        const contact = (await listContacts(ctx)).find((candidate) => candidate.sessionId === session.sessionId);
         const created = contact === undefined &&
             session.latestUpdatedSeq === EMPTY_TRANSCRIPT_TAIL &&
             session.createdAtMs >= startedAt - CREATED_WINDOW_MS;
@@ -75,7 +75,7 @@ export async function ask(ctx, input) {
                 ? `No Grok Bot agent named "${session.name}" existed on this account, so an empty one was created. Check the name if that is unexpected.`
                 : undefined,
             runningNote(session.name, replies.status),
-        ].filter(note => note !== undefined);
+        ].filter((note) => note !== undefined);
         return {
             agent: session.name,
             sessionId: session.sessionId,
@@ -92,7 +92,7 @@ export async function check(ctx, input) {
     const backend = grokBotAgentsBackend();
     return agentLocks.run(contact.sessionId, async () => {
         // Re-read under the lock: a parallel call may have moved the cursor.
-        const current = (await listContacts(ctx)).find(candidate => candidate.sessionId === contact.sessionId) ??
+        const current = (await listContacts(ctx)).find((candidate) => candidate.sessionId === contact.sessionId) ??
             contact;
         const replies = await collectReplies(backend, current.sessionId, {
             cursor: current.cursor,
@@ -180,7 +180,7 @@ function runningNote(name, status) {
         : undefined;
 }
 function sleep(ms) {
-    return new Promise(resolve => {
+    return new Promise((resolve) => {
         setTimeout(resolve, ms);
     });
 }

package/dist/extensions/cursor-grokbot-agents/tools/list.js

@@ -10,7 +10,7 @@ const list = defineTool({
         const contacts = await listContacts(ctx);
         return {
             configured: extension.config.agents ?? [],
-            contacted: contacts.map(contact => ({
+            contacted: contacts.map((contact) => ({
                 name: contact.name,
                 sessionId: contact.sessionId,
                 firstContactAt: contact.firstContactAt,

package/dist/extensions/improve/skills/yourself.js

@@ -3,7 +3,7 @@ import extension from "../extension.js";
 const { repo, path, ref, notes, deploy } = extension.config;
 const treeNotes = notes.length === 0
     ? ""
-    : `\nAbout this tree in particular; copy these into the brief verbatim:\n\n${notes.map(note => `- ${note}`).join("\n")}\n`;
+    : `\nAbout this tree in particular; copy these into the brief verbatim:\n\n${notes.map((note) => `- ${note}`).join("\n")}\n`;
 const yourself = defineSkill({
     description: "Change your own source (instructions, skills, tools, channels, connections, model, deployment) through a one-off Cursor cloud agent and a pull request. Use whenever the ask is about how you yourself behave, including adding or editing a skill, so the change lands in the repository instead of the tree you happen to be running from.",
     markdown: `# Improve yourself

package/dist/extensions/jev/extension.js

@@ -31,7 +31,7 @@ const config = z
     skills: z.boolean().default(true),
 })
     .default({})
-    .transform(options => ({
+    .transform((options) => ({
     apiKey: options.apiKey,
     model: options.model ?? DEFAULT_EVALUATION_MODEL,
     harnessTools: options.harnessTools,
@@ -41,7 +41,7 @@ const jev = defineExtension({
     root: import.meta.dirname,
     description: "Ask Jev for typed choice, score, and boolean answers.",
     config,
-    contributions: options => ({
+    contributions: (options) => ({
         tools: options.harnessTools,
         skills: options.skills,
     }),

package/dist/extensions/jev/tools/evaluate.js

@@ -59,7 +59,7 @@ const evaluateTool = defineTool({
             .min(1)
             .describe("One or more typed questions over the same state."),
     })
-        .refine(input => new Set(input.questions.map(item => item.id)).size === input.questions.length, "questions must not repeat an id"),
+        .refine((input) => new Set(input.questions.map((item) => item.id)).size === input.questions.length, "questions must not repeat an id"),
     async execute(input) {
         return evaluate({
             state: input.state,

package/dist/extensions/slack-communication/tools/react.js

@@ -13,7 +13,7 @@ const react = defineTool({
             .string()
             .trim()
             .min(1)
-            .refine(value => emojiName(value) !== undefined, "emoji must be a Slack reaction name"),
+            .refine((value) => emojiName(value) !== undefined, "emoji must be a Slack reaction name"),
         ts: z.string().trim().min(1).optional(),
     }),
     execute: ({ emoji, ts }) => {