@cursor/july 0.1.109 → 0.1.112

package/src/internal/advertise-tools.ts

@@ -117,7 +117,7 @@ export async function resolveAdvertisedTools(args: {
   ) => Promise<AdvertisedToolSource>;
 }): Promise<DiscoveredTool[]> {
   const advertising = args.agent.connections.filter(
-    (connection) => connection.advertiseTools === true
+    connection => connection.advertiseTools === true
   );
   if (advertising.length === 0) {
     return [];
@@ -145,7 +145,7 @@ export async function resolveAdvertisedTools(args: {
           connection,
           ok: true,
           source,
-          listed: listed.filter((info) =>
+          listed: listed.filter(info =>
             connectionAllowsTool(connection, info.name)
           ),
         };
@@ -154,7 +154,7 @@ export async function resolveAdvertisedTools(args: {
       }
     })
   );
-  const claimed = new Set(args.agent.tools.map((tool) => tool.name));
+  const claimed = new Set(args.agent.tools.map(tool => tool.name));
   const resolved: DiscoveredTool[] = [];
   for (const listing of listings) {
     const { connection } = listing;
@@ -184,7 +184,7 @@ export async function resolveAdvertisedTools(args: {
       throw error;
     }
     const intended = listed.filter(
-      (info) =>
+      info =>
         !isDoNotCallTool(info.annotations) &&
         matchesIntendedEffects(info.annotations, connection.effects)
     );
@@ -277,7 +277,7 @@ function exposeListedTools(
       exposedNameByInfo.set(info, exposedName);
     });
   }
-  return listed.map((info) => ({
+  return listed.map(info => ({
     info,
     exposedName: exposedNameByInfo.get(info)!,
   }));
@@ -362,7 +362,7 @@ export function formatMcpToolResult(
   toolName: string,
   result: HostMcpCallResult
 ): string {
-  const parts = result.content.map((item) =>
+  const parts = result.content.map(item =>
     item.type === "text" && typeof item.text === "string"
       ? item.text
       : `[${item.type} content omitted]`

package/src/internal/approval-gate.ts

@@ -36,7 +36,7 @@ export class ApprovalGate<T extends { callId: string } = PendingApproval> {
         `Approval already pending for session ${sessionId} call ${meta.callId}`
       );
     }
-    return new Promise<ApprovalResolution>((resolveDecision) => {
+    return new Promise<ApprovalResolution>(resolveDecision => {
       this.waiters.set(key, {
         meta,
         resolve: resolveDecision,

package/src/internal/artifacts-store.ts

@@ -158,7 +158,7 @@ export class ArtifactsStore {
     const records = await this.rows.list();
     return records
       .filter(
-        (record) =>
+        record =>
           (filter?.kind === undefined || record.kind === filter.kind) &&
           (filter?.sessionId === undefined ||
             record.sessionId === filter.sessionId)
@@ -312,7 +312,7 @@ function createSinkRowStore(
         agentStoreKeys.artifactRowPrefix(agentName)
       );
       const bodies = await Promise.all(
-        entries.map((entry) => sink.get(entry.key))
+        entries.map(entry => sink.get(entry.key))
       );
       const records: ArtifactRecord[] = [];
       for (const body of bodies) {
@@ -414,7 +414,7 @@ function createFilesystemRowStore(stateRoot: string): ArtifactRowStore {
       try {
         const names = await readdir(dir);
         return names.filter(
-          (name) => !name.startsWith(".") && name.endsWith(".json")
+          name => !name.startsWith(".") && name.endsWith(".json")
         ).length;
       } catch (error) {
         if ((error as NodeJS.ErrnoException).code === "ENOENT") {

package/src/internal/as-of.ts

@@ -67,7 +67,7 @@ export function assertTimeArgs(
       continue;
     }
     const properties = tool.inputSchema?.properties ?? {};
-    const missing = declared.filter((name) => !(name in properties));
+    const missing = declared.filter(name => !(name in properties));
     if (missing.length > 0) {
       throw new VacuousTimeArgsError(tool.name, missing);
     }
@@ -257,7 +257,7 @@ export function missingTimeWindow(
     typeof input === "object" && input !== null
       ? (input as Record<string, unknown>)
       : {};
-  const missing = windowKeys.filter((key) => record[key] === undefined);
+  const missing = windowKeys.filter(key => record[key] === undefined);
   if (missing.length === 0) {
     return undefined;
   }

package/src/internal/authored-alias-hooks.ts

@@ -48,7 +48,7 @@ export function initialize(data: AuthoredAliasHookData): void {
   directAliases = toNullProtoMap(data.directAliases);
   sourceFallbackAliases = toNullProtoMap(
     Object.fromEntries(
-      (data.sourceFallbackAliases ?? []).map((specifier) => [specifier, "1"])
+      (data.sourceFallbackAliases ?? []).map(specifier => [specifier, "1"])
     )
   );
   const parent = data.sourceTreeFallbackParentURL;

package/src/internal/authored-loaders.ts

@@ -182,9 +182,8 @@ function registerFrameworkAliases(): void {
     return;
   }
   const hooksUrl = new URL("./authored-alias-hooks.js", import.meta.url);
-  const { directAliases, sourceFallbackAliases } = partitionFrameworkAliases(
-    frameworkAliases()
-  );
+  const { directAliases, sourceFallbackAliases } =
+    partitionFrameworkAliases(frameworkAliases());
   const data: AuthoredAliasHookData = {
     directAliases,
     // Internal-only exports stay out of the public package. When one is

package/src/internal/builtin-tools/reminders.ts

@@ -49,7 +49,7 @@ async function listMine(
     status,
     continuationToken: conv.continuationToken,
   });
-  return all.filter((r) => r.channelId === conv.channelId);
+  return all.filter(r => r.channelId === conv.channelId);
 }
 
 function toResult(r: ReminderInfo) {
@@ -142,7 +142,7 @@ const cancel = defineTool({
       .describe("Reminder id from reminders_create or reminders_list."),
   }),
   async execute(input, ctx) {
-    const mine = (await listMine(ctx)).find((r) => r.id === input.id);
+    const mine = (await listMine(ctx)).find(r => r.id === input.id);
     if (mine === undefined) {
       throw new Error(`No reminder "${input.id}" in this conversation.`);
     }

package/src/internal/chat-client.ts

@@ -187,13 +187,13 @@ export async function runChat(options: ChatClientOptions): Promise<void> {
 
   write(c.dim("Type a message and press Enter. Ctrl-D or /quit to exit.\n\n"));
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  await new Promise<void>((resolve) => {
+  await new Promise<void>(resolve => {
     const prompt = (): void => {
       rl.setPrompt(c.cyan("› "));
       rl.prompt();
     };
     prompt();
-    rl.on("line", (line) => {
+    rl.on("line", line => {
       const text = line.trim();
       if (text === "") {
         prompt();
@@ -205,7 +205,7 @@ export async function runChat(options: ChatClientOptions): Promise<void> {
       }
       rl.pause();
       runTurn(text, { echoUser: false })
-        .catch((err) => {
+        .catch(err => {
           write(`${c.red("error")} ${describe(err)}\n\n`);
         })
         .finally(() => {
@@ -233,7 +233,7 @@ export async function lookupSessionContinuation(args: {
     baseUrl: args.baseUrl,
     auth: args.auth,
   });
-  const match = sessions.find((s) => s.sessionId === args.sessionId);
+  const match = sessions.find(s => s.sessionId === args.sessionId);
   if (match === undefined) {
     throw new Error(
       `Session ${args.sessionId} not found in /v1/sessions (wrong id, or not owned by this caller). ` +
@@ -295,7 +295,7 @@ async function attachSession(args: {
     events.length === 0
       ? -1
       : Math.max(
-          ...events.map((e) => (typeof e.index === "number" ? e.index : -1))
+          ...events.map(e => (typeof e.index === "number" ? e.index : -1))
         );
 
   return {

package/src/internal/cli-ax.ts

@@ -22,7 +22,7 @@ import { lookupSessionContinuation, runChat } from "./chat-client.js";
 import { ensureCursorLogin } from "./cli-cursor.js";
 import { resolveDeployAuth } from "./cli-deploy.js";
 import { resolveApiKey } from "./cursor/credentials.js";
-import { DeployApiError } from "./deploy-client.js";
+import { type AgentkitSessionRuns, DeployApiError } from "./deploy-client.js";
 import { CLI_COMMAND_NAME, PACKAGE_NAME } from "./distribution.js";
 import {
   discoverEvals,
@@ -197,6 +197,7 @@ export interface AxCliOptions {
    */
   dryRun?: boolean;
   asOf?: string;
+  componentKey?: string;
 }
 
 export interface ResolvedAgentTarget {
@@ -225,17 +226,17 @@ function pickAgentUrl(handle: AgentServeHandle, slug?: string): string {
     die("No agents discovered.");
   }
   if (slug !== undefined && slug !== "") {
-    const match = handle.agents.find((a) => a.slug === slug);
+    const match = handle.agents.find(a => a.slug === slug);
     if (match === undefined) {
       die(
         `Unknown agent slug "${slug}". Available: ${handle.agents
-          .map((a) => a.slug || "(root)")
+          .map(a => a.slug || "(root)")
           .join(", ")}`
       );
     }
     return match.url;
   }
-  const root = handle.agents.find((a) => a.slug === "");
+  const root = handle.agents.find(a => a.slug === "");
   return (root ?? handle.agents[0]!).url;
 }
 
@@ -267,7 +268,7 @@ async function startEphemeral(
       // engine.close() can hang on open SDK streams; don't block the CLI.
       await Promise.race([
         handle.close(),
-        new Promise<void>((resolve) => setTimeout(resolve, 2_000)),
+        new Promise<void>(resolve => setTimeout(resolve, 2_000)),
       ]);
     },
   };
@@ -632,7 +633,7 @@ export async function cmdRun(options: AxCliOptions): Promise<number> {
       bearerToken: options.bearerToken,
       headers: target.headers,
       timeoutMs: options.timeoutMs,
-      onEvent: progress === undefined ? undefined : (e) => progress.onEvent(e),
+      onEvent: progress === undefined ? undefined : e => progress.onEvent(e),
     });
 
     let eventsPath: string | undefined;
@@ -648,7 +649,7 @@ export async function cmdRun(options: AxCliOptions): Promise<number> {
       }
       await writeFile(
         eventsPath,
-        `${result.events.map((e) => JSON.stringify(e)).join("\n")}\n`,
+        `${result.events.map(e => JSON.stringify(e)).join("\n")}\n`,
         "utf8"
       );
     }
@@ -774,6 +775,7 @@ async function cmdHostedSession(
       sessionId,
       dryRun: options.dryRun,
       asOf: options.asOf,
+      componentKey: trimNonEmpty(options.componentKey),
     });
     console.log(JSON.stringify(accepted, null, 2));
     return 0;
@@ -788,6 +790,41 @@ async function cmdHostedSession(
   }
 }
 
+/**
+ * Shared deterministic-route fetch (`call`, `skill`): engine headers,
+ * bearer auth, and JSON. The payload is `undefined` when the body does
+ * not decode; callers print `invalid_response` and fail.
+ */
+async function fetchAgentJson(
+  target: ResolvedAgentTarget,
+  path: string,
+  args: { method?: string; body?: string; bearerToken?: string } = {}
+): Promise<{ response: Response; payload: unknown }> {
+  const headers: Record<string, string> = {};
+  if (target.headers !== undefined) {
+    Object.assign(headers, target.headers);
+  }
+  if (args.body !== undefined) {
+    headers["content-type"] = "application/json";
+  }
+  if (args.bearerToken !== undefined) {
+    headers.authorization = `Bearer ${args.bearerToken}`;
+  }
+  const response = await fetch(`${target.agentUrl}${path}`, {
+    method: args.method,
+    headers,
+    body: args.body,
+  });
+  const payload: unknown = await response.json().catch(() => undefined);
+  return { response, payload };
+}
+
+function printInvalidResponse(): void {
+  console.log(
+    JSON.stringify({ ok: false, error: "invalid_response" }, null, 2)
+  );
+}
+
 /**
  * `agent-sdk call <tool>` — deterministic tool invocation over
  * `POST /v1/tools/:toolName` (ephemeral local server unless --url).
@@ -814,30 +851,23 @@ export async function cmdCall(options: AxCliOptions): Promise<number> {
 
   const target = await resolveTarget(options);
   try {
-    const headers: Record<string, string> = {
-      "content-type": "application/json",
-    };
-    if (target.headers !== undefined) {
-      Object.assign(headers, target.headers);
-    }
-    if (options.bearerToken !== undefined) {
-      headers.authorization = `Bearer ${options.bearerToken}`;
-    }
     const body: { input: unknown; sessionId?: string } = { input };
     if (options.sessionId !== undefined) {
       body.sessionId = options.sessionId;
     }
-    const response = await fetch(
-      `${target.agentUrl}/v1/tools/${encodeURIComponent(toolName)}`,
+    const { response, payload } = await fetchAgentJson(
+      target,
+      `/v1/tools/${encodeURIComponent(toolName)}`,
       {
         method: "POST",
-        headers,
         body: JSON.stringify(body),
+        bearerToken: options.bearerToken,
       }
     );
-    const payload: unknown = await response
-      .json()
-      .catch(() => ({ ok: false, error: "invalid_response" }));
+    if (payload === undefined) {
+      printInvalidResponse();
+      return 1;
+    }
     console.log(JSON.stringify(payload, null, 2));
     const ok =
       response.ok &&
@@ -852,6 +882,51 @@ export async function cmdCall(options: AxCliOptions): Promise<number> {
   }
 }
 
+/**
+ * `agent-sdk skill <name>` — deterministic skill read over
+ * `GET /v1/skills/:skillName` (ephemeral local server unless --url).
+ * `--text` prints the rendered SKILL.md instead of JSON.
+ */
+export async function cmdSkill(
+  skillName: string | undefined,
+  options: AxCliOptions
+): Promise<number> {
+  if (skillName === undefined || skillName === "") {
+    process.stderr.write(
+      `Usage: ${CLI_COMMAND_NAME} skill <name> [--dir <path> | --url <baseUrl> | --prod]\n`
+    );
+    return 2;
+  }
+
+  const target = await resolveTarget(options);
+  try {
+    const { response, payload } = await fetchAgentJson(
+      target,
+      `/v1/skills/${encodeURIComponent(skillName)}`,
+      { bearerToken: options.bearerToken }
+    );
+    if (payload === undefined) {
+      printInvalidResponse();
+      return 1;
+    }
+    if (options.text === true && response.ok) {
+      const skillMd = (payload as { skillMd?: unknown }).skillMd;
+      if (typeof skillMd !== "string") {
+        printInvalidResponse();
+        return 1;
+      }
+      process.stdout.write(skillMd.endsWith("\n") ? skillMd : `${skillMd}\n`);
+      return 0;
+    }
+    console.log(JSON.stringify(payload, null, 2));
+    return response.ok ? 0 : 1;
+  } finally {
+    if (target.close !== undefined) {
+      await target.close();
+    }
+  }
+}
+
 export async function cmdTrajectory(options: AxCliOptions): Promise<number> {
   if (typeof options.events !== "string") {
     die(
@@ -880,7 +955,7 @@ export function resolveEvalTargetMode(
   const flags = [
     options.prod === true ? "--prod" : undefined,
     options.url !== undefined ? "--url" : undefined,
-  ].filter((flag) => flag !== undefined);
+  ].filter(flag => flag !== undefined);
   if (flags.length > 1) {
     return { error: `${flags.join(" and ")} are mutually exclusive` };
   }
@@ -1003,7 +1078,7 @@ export async function cmdEval(options: AxCliOptions): Promise<number> {
         tags,
       });
       return printListedEvals(
-        listed.map((e) => ({
+        listed.map(e => ({
           id: e.id,
           fileId: e.fileId,
           description: e.description,
@@ -1059,7 +1134,7 @@ export async function cmdEval(options: AxCliOptions): Promise<number> {
           headers: target.headers,
           verbose: Boolean(options.verbose) || stream,
           onEvent:
-            progress === undefined ? undefined : (e) => progress.onEvent(e),
+            progress === undefined ? undefined : e => progress.onEvent(e),
         });
         if (results.length === 0) {
           process.stderr.write("No matching evals found.\n");
@@ -1476,7 +1551,7 @@ export async function cmdEvalStatus(
     const failed =
       snap.status === "failed" ||
       snap.status === "cancelled" ||
-      snap.cases.some((c) => c.ok !== true);
+      snap.cases.some(c => c.ok !== true);
     return failed ? 1 : 0;
   } catch (error) {
     process.stderr.write(
@@ -1507,7 +1582,7 @@ async function listLocalEvals(
   const { evals } = await discoverEvals(projectRoot);
   const listed = filterDiscoveredEvals(evals, { filterIds, tags });
   return printListedEvals(
-    listed.map((e) => ({
+    listed.map(e => ({
       id: e.id,
       fileId: e.fileId,
       path: e.path,
@@ -1944,6 +2019,67 @@ export async function cmdSessions(options: AxCliOptions): Promise<number> {
   }
 }
 
+function formatHostedSessionRuns(
+  sessionId: string,
+  runs: AgentkitSessionRuns
+): string {
+  const lines = [
+    `Session ${sessionId}`,
+    `Hosted executions: ${runs.executions.length}`,
+  ];
+  for (const run of runs.executions) {
+    const failure = run.error?.message ?? run.message ?? "";
+    lines.push(
+      "",
+      `${run.executionId}  ${run.turnStatus}  ${run.durationMs}ms  ${run.writtenAt}  ${failure}`.trimEnd(),
+      ...run.logs.map(log => `  ${log.line}`)
+    );
+  }
+  return `${lines.join("\n")}\n`;
+}
+
+/** Read the v2 runs surface; only its 404 falls through to the v1 engine. */
+async function readHostedSessionRuns(
+  sessionId: string,
+  options: AxCliOptions
+): Promise<number | "v1"> {
+  const auth = await resolveDeployAuth({
+    team: options.team,
+    apiKey: options.apiKey,
+    fetchImpl: options.fetchImpl,
+  });
+  if (typeof auth === "number") {
+    return auth;
+  }
+  try {
+    const runs = await auth.client.getAgentkitSessionRuns({
+      teamId: auth.teamId,
+      slug: resolveProdSlug(options),
+      sessionId,
+    });
+    if (options.rawEvents === true || trimNonEmpty(options.out) !== undefined) {
+      process.stderr.write("--events and --out need an engine trajectory.\n");
+      return 2;
+    }
+    process.stdout.write(
+      options.json === true
+        ? `${JSON.stringify({ sessionId, ...runs }, null, 2)}\n`
+        : formatHostedSessionRuns(sessionId, runs)
+    );
+    return 0;
+  } catch (error) {
+    if (error instanceof DeployApiError && error.status === 404) {
+      return "v1";
+    }
+    process.stderr.write(
+      `${sanitizeCustomerError(
+        error instanceof Error ? error.message : String(error)
+      )}\n`
+    );
+    return 1;
+  }
+}
+
 /**
  * `session <id>` — view a full session (trajectory text by default).
  * `--json` → trajectory JSON; `--events` (`rawEvents`) → raw event list.
@@ -1983,6 +2119,13 @@ export async function cmdSession(
     return 2;
   }
 
+  if (options.prod === true && options.url === undefined) {
+    const hosted = await readHostedSessionRuns(sessionId, options);
+    if (hosted !== "v1") {
+      return hosted;
+    }
+  }
+
   const target = await resolveSessionTarget(options);
   if (typeof target === "number") {
     return target;
@@ -2005,7 +2148,7 @@ export async function cmdSession(
       await mkdir(dirname(targetPath), { recursive: true });
       await writeFile(
         targetPath,
-        `${events.map((e) => JSON.stringify(e)).join("\n")}\n`,
+        `${events.map(e => JSON.stringify(e)).join("\n")}\n`,
         "utf8"
       );
       process.stdout.write(`trace: ${targetPath} (${events.length} events)\n`);
@@ -2248,7 +2391,7 @@ async function runPlaygroundProxySession(args: {
   }
 
   try {
-    await new Promise<void>((resolve) => {
+    await new Promise<void>(resolve => {
       if (controller.signal.aborted) {
         resolve();
         return;

package/src/internal/cli-bitbucket.ts

@@ -129,10 +129,10 @@ async function resolveTargets(
   const port = options.port ?? DEFAULT_PORT;
   let candidates: BitbucketChannelTarget[] = channels;
   if (options.slug !== undefined) {
-    candidates = candidates.filter((c) => c.slug === options.slug);
+    candidates = candidates.filter(c => c.slug === options.slug);
   }
   if (options.channel !== undefined) {
-    candidates = candidates.filter((c) => c.channelId === options.channel);
+    candidates = candidates.filter(c => c.channelId === options.channel);
   }
   if (options.url !== undefined && candidates.length > 1) {
     process.stderr.write(
@@ -156,7 +156,7 @@ async function resolveTargets(
       },
     ];
   }
-  return candidates.map((c) => ({
+  return candidates.map(c => ({
     slug: c.slug,
     channelId: c.channelId,
     url: channelForwardUrl({
@@ -191,7 +191,7 @@ async function cmdBitbucketReplay(
   }
 
   const requested = parseEventList(options.events);
-  const declared = [...new Set(targets.flatMap((target) => target.events))];
+  const declared = [...new Set(targets.flatMap(target => target.events))];
   const { events, unsupported } = selectBitbucketReplayEvents(
     requested,
     declared
@@ -249,7 +249,7 @@ async function cmdBitbucketReplay(
   const secret = options.secret ?? process.env.BITBUCKET_WEBHOOK_SECRET;
   process.stderr.write(
     `[agent-sdk] replaying ${ref.label} (${ref.dialect}; ${synthesized
-      .map((event) => event.eventType)
+      .map(event => event.eventType)
       .join(
         ", "
       )}) → ${targets.length} channel${targets.length === 1 ? "" : "s"}\n`
@@ -286,7 +286,7 @@ async function cmdBitbucketReplay(
       event.eventType,
       targets
     );
-    if (deliveries.length === 0 || deliveries.some((d) => !d.ok)) {
+    if (deliveries.length === 0 || deliveries.some(d => !d.ok)) {
       anyRejected = true;
     }
     report.push({ ...eventReport(event), deliveries });
@@ -294,7 +294,7 @@ async function cmdBitbucketReplay(
       const summary =
         deliveries
           .map(
-            (d) => `${d.label} ${d.status || "ERR"}${d.ok ? "" : " (rejected)"}`
+            d => `${d.label} ${d.status || "ERR"}${d.ok ? "" : " (rejected)"}`
           )
           .join(", ") || "(no matching channel)";
       process.stderr.write(`[agent-sdk]   ${event.header} → ${summary}\n`);
@@ -332,10 +332,10 @@ async function deliverReplayEvent(
   targets: readonly ReplayTarget[]
 ): Promise<ReplayDelivery[]> {
   const recipients = targets.filter(
-    (target) => target.events.length === 0 || target.events.includes(eventType)
+    target => target.events.length === 0 || target.events.includes(eventType)
   );
   return Promise.all(
-    recipients.map(async (target) => {
+    recipients.map(async target => {
       const label =
         target.slug === ""
           ? target.channelId
@@ -387,7 +387,7 @@ async function cmdBitbucketEvents(
   const channels = findBitbucketChannelTargets(await resolveAgentMounts(dir));
   const host = options.host ?? DEFAULT_HOST;
   const port = options.port ?? DEFAULT_PORT;
-  const rows = channels.map((c) => ({
+  const rows = channels.map(c => ({
     slug: c.slug,
     channelId: c.channelId,
     url: channelForwardUrl({
@@ -471,7 +471,7 @@ function parseEventList(value: string | undefined): string[] | undefined {
   }
   const events = value
     .split(/[\s,]+/)
-    .map((event) => event.trim())
+    .map(event => event.trim())
     .filter(Boolean);
   return events.length === 0 ? undefined : events;
 }

package/src/internal/cli-convert-automation.ts

@@ -81,7 +81,7 @@ export function parseAutomationRef(input: string): string | undefined {
   if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
     return undefined;
   }
-  const segments = parsed.pathname.split("/").filter((s) => s !== "");
+  const segments = parsed.pathname.split("/").filter(s => s !== "");
   if (segments.length !== 2) {
     return undefined;
   }
@@ -200,7 +200,7 @@ export async function cmdConvertAutomation(
             ? null
             : installed.stderr.trim() ||
               `npm install exited ${installed.exitCode}`,
-          mcpConnections: result.mcpConnections.map((connection) => ({
+          mcpConnections: result.mcpConnections.map(connection => ({
             name: connection.name,
             kind: connection.kind,
           })),