@cursor/july 0.1.68 → 0.1.74

package/dist/internal/install-cursor-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-cursor-skills.d.ts","sourceRoot":"","sources":["../../src/internal/install-cursor-skills.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install-cursor-skills.d.ts","sourceRoot":"","sources":["../../src/internal/install-cursor-skills.ts"],"names":[],"mappings":"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"}

package/dist/internal/install-cursor-skills.js

@@ -1,10 +1,17 @@
 /**
  * Offer to install the package's coding-agent skills into the user's
- * personal Cursor skills dir under `~/.cursor/skills/agentkit/<skill>/`.
+ * personal Cursor skills dir under `~/.cursor/skills/agentsdk/<skill>/`.
  *
- * Cursor walks `~/.cursor/skills` recursively, so the `agentkit/` folder is
+ * Cursor walks `~/.cursor/skills` recursively, so the `agentsdk/` folder is
  * only organizational — identity comes from the leaf folder that holds
- * SKILL.md. Skipped for `--json` / non-TTY hosts.
+ * SKILL.md. Installed copies get `alwaysApply: true` so Cursor injects the
+ * skill body as a global rule instead of leaving it as an on-demand catalog
+ * entry. Skipped for `--json` / non-TTY hosts.
+ *
+ * Consumer installs (`npm install` / `npx` of `@cursor/july`) also copy
+ * these skills from a postinstall hook. That path never prompts and never
+ * fails the package install. The monorepo source checkout is not a consumer
+ * install, so `pnpm install` in everysphere does not overwrite `~/.cursor`.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -19,40 +26,67 @@ import { access, chmod, cp, mkdir, readdir, readFile, rm, stat, writeFile, } fro
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { CLI_COMMAND_NAME, packageRootDir } from "./distribution.js";
+import { parseFrontmatter } from "./frontmatter.js";
 import { stdoutPalette } from "./terminal-style.js";
 /** Monorepo-only skill; excluded from the published package. */
 const SKIP_SKILL_DIRS = new Set(["operate"]);
 /** Category folder under ~/.cursor/skills (Cursor discovers nested skills). */
-export const CURSOR_SKILLS_NAMESPACE = "agentkit";
+export const CURSOR_SKILLS_NAMESPACE = "agentsdk";
+/** Pre-rename install folder. Install deletes this so `/agentkit-*` rows disappear. */
+export const LEGACY_CURSOR_SKILLS_NAMESPACE = "agentkit";
 /** How long the `init` offer waits for an answer before skipping the install. */
 export const SKILL_PROMPT_TIMEOUT_MS = 45000;
+/**
+ * Override the resolved `~/.cursor/skills` directory (not the user home).
+ * Used by the postinstall hook in tests and publish smoke.
+ */
+export const CURSOR_JULY_SKILLS_HOME_ENV = "CURSOR_JULY_SKILLS_HOME";
+/** Set to `1` to skip the postinstall skill copy. */
+export const CURSOR_JULY_SKIP_SKILL_INSTALL_ENV = "CURSOR_JULY_SKIP_SKILL_INSTALL";
 export function cursorSkillsHome(home) {
     var _a;
-    if (home === void 0) { home = (_a = process.env.HOME) !== null && _a !== void 0 ? _a : homedir(); }
-    const resolved = home.trim() === "" ? homedir() : home;
-    return join(resolved, ".cursor", "skills");
+    if (home !== undefined) {
+        return join(home.trim() === "" ? homedir() : home, ".cursor", "skills");
+    }
+    const override = (_a = process.env[CURSOR_JULY_SKILLS_HOME_ENV]) === null || _a === void 0 ? void 0 : _a.trim();
+    if (override !== undefined && override !== "") {
+        return override;
+    }
+    return join(homedir(), ".cursor", "skills");
+}
+/**
+ * True when this package root is an installed copy under `node_modules`
+ * (npm, pnpm, yarn, npx, global), not the everysphere source checkout.
+ */
+export function isConsumerPackageInstall(packageRoot) {
+    // Segment check only — split on both separators so a Windows path still
+    // matches when this runs (or is tested) on POSIX. Do not rewrite the path.
+    return packageRoot.split(/[\\/]/).includes("node_modules");
 }
-/** `~/.cursor/skills/agentkit` — where package skills are installed. */
-export function agentkitCursorSkillsDir(skillsHome = cursorSkillsHome()) {
+/** `~/.cursor/skills/agentsdk` — where package skills are installed. */
+export function agentsdkCursorSkillsDir(skillsHome = cursorSkillsHome()) {
     return join(skillsHome, CURSOR_SKILLS_NAMESPACE);
 }
-/** Absolute install path for one skill: `…/agentkit/<leafDir>`. */
+/** Pre-rename `~/.cursor/skills/agentkit`. */
+export function legacyAgentkitCursorSkillsDir(skillsHome = cursorSkillsHome()) {
+    return join(skillsHome, LEGACY_CURSOR_SKILLS_NAMESPACE);
+}
+/** Absolute install path for one skill: `…/agentsdk/<leafDir>`. */
 export function skillInstallPath(skill, skillsHome = cursorSkillsHome()) {
-    return join(agentkitCursorSkillsDir(skillsHome), skill.leafDir);
+    return join(agentsdkCursorSkillsDir(skillsHome), skill.leafDir);
 }
 /**
  * Skills shipped next to the running package. Uses the frontmatter `name`
- * when present, otherwise `agentkit-<dir>`.
+ * when present, otherwise `agentsdk-<dir>`.
  */
 export function listShippedPackageSkills() {
     return __awaiter(this, arguments, void 0, function* (packageRoot = packageRootDir()) {
-        var _a;
         const skillsRoot = join(packageRoot, "skills");
         let entries;
         try {
             entries = yield readdir(skillsRoot, { withFileTypes: true });
         }
-        catch (_b) {
+        catch (_a) {
             return [];
         }
         const skills = [];
@@ -65,11 +99,12 @@ export function listShippedPackageSkills() {
             try {
                 yield access(skillMd);
             }
-            catch (_c) {
+            catch (_b) {
                 continue;
             }
             const raw = yield readFile(skillMd, "utf8");
-            const name = (_a = parseSkillName(raw)) !== null && _a !== void 0 ? _a : `agentkit-${entry.name}`;
+            const name = parseFrontmatter(raw).data.name ||
+                `${CURSOR_SKILLS_NAMESPACE}-${entry.name}`;
             skills.push({ name, leafDir: entry.name, sourceDir });
         }
         skills.sort((a, b) => a.leafDir.localeCompare(b.leafDir));
@@ -77,7 +112,7 @@ export function listShippedPackageSkills() {
     });
 }
 /**
- * Skills that do not yet have a SKILL.md under ~/.cursor/skills/agentkit/.
+ * Skills that do not yet have a SKILL.md under ~/.cursor/skills/agentsdk/.
  * Install still overwrites every shipped skill when the user confirms — this
  * helper is for messaging (fresh install vs update).
  */
@@ -99,13 +134,15 @@ export function findMissingCursorSkills(options) {
     });
 }
 /**
- * Copy each skill directory into `skillsHome/agentkit/<leafDir>/`.
+ * Copy each skill directory into `skillsHome/agentsdk/<leafDir>/`.
  * Always overwrites so a package upgrade refreshes local Cursor skills.
- * Strips monorepo-only frontmatter and removes leaf dirs no longer shipped.
+ * Strips monorepo-only frontmatter, sets `alwaysApply: true` so Cursor
+ * loads the body into context, and removes leaf dirs no longer shipped.
+ * Also deletes leftover `skillsHome/agentkit/` from the previous namespace.
  */
 export function installCursorSkills(skills_1) {
     return __awaiter(this, arguments, void 0, function* (skills, skillsHome = cursorSkillsHome()) {
-        const namespaceDir = agentkitCursorSkillsDir(skillsHome);
+        const namespaceDir = agentsdkCursorSkillsDir(skillsHome);
         yield mkdir(namespaceDir, { recursive: true });
         const removed = yield orphanLeaves(namespaceDir, skills);
         for (const leaf of removed) {
@@ -128,7 +165,8 @@ export function installCursorSkills(skills_1) {
             }
             installed.push(skill.leafDir);
         }
-        return { installed, removed };
+        const removedLegacyNamespace = yield removeLegacyCursorSkillsNamespace(skillsHome);
+        return { installed, removed, removedLegacyNamespace };
     });
 }
 function makeTreeWritable(root) {
@@ -171,14 +209,42 @@ function orphanLeaves(namespaceDir, skills) {
             .map((entry) => entry.name);
     });
 }
-/** Drop monorepo `paths` globs and fix package doc links for ~/.cursor installs. */
+/** Drop leftover `skillsHome/agentkit` from the previous install namespace. */
+function removeLegacyCursorSkillsNamespace(skillsHome) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const legacyDir = legacyAgentkitCursorSkillsDir(skillsHome);
+        try {
+            yield stat(legacyDir);
+        }
+        catch (_a) {
+            return false;
+        }
+        yield rm(legacyDir, { recursive: true, force: true });
+        return true;
+    });
+}
+function hasLegacyCursorSkillsNamespace(skillsHome) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield stat(legacyAgentkitCursorSkillsDir(skillsHome));
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    });
+}
+/**
+ * Drop monorepo `paths` globs, set `alwaysApply: true` so Cursor injects the
+ * body as a global rule, and fix package doc links for ~/.cursor installs.
+ */
 export function prepareSkillMarkdownForCursorInstall(content) {
     var _a;
     const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
     if (match === null) {
         return content;
     }
-    const frontmatter = stripPathsFromFrontmatter((_a = match[1]) !== null && _a !== void 0 ? _a : "");
+    const frontmatter = withAlwaysApply(stripPathsFromFrontmatter((_a = match[1]) !== null && _a !== void 0 ? _a : ""));
     const body = content.slice(match[0].length);
     const adjustedBody = body.replace(/\[`docs\/([^`]+)`\]\(\.\.\/\.\.\/docs\/[^)]+\)/g, "docs/$1 in the @cursor/july package");
     return `---\n${frontmatter.trimEnd()}\n---${adjustedBody}`;
@@ -201,24 +267,42 @@ function stripPathsFromFrontmatter(frontmatter) {
     }
     return out.join("\n");
 }
+/** Cursor loads `alwaysApply: true` skills as global rules, not catalog rows. */
+function withAlwaysApply(frontmatter) {
+    const without = frontmatter
+        .split(/\r?\n/)
+        .filter((line) => !/^\s*alwaysApply\s*:/.test(line))
+        .join("\n")
+        .replace(/\n+$/, "");
+    if (without === "") {
+        return "alwaysApply: true";
+    }
+    return `${without}\nalwaysApply: true`;
+}
 /** What an install would do, for the offer and for `install-skills`. */
 export function planSkillInstall(options) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         const skillsHome = (_a = options === null || options === void 0 ? void 0 : options.skillsHome) !== null && _a !== void 0 ? _a : cursorSkillsHome();
-        const directory = agentkitCursorSkillsDir(skillsHome);
+        const directory = agentsdkCursorSkillsDir(skillsHome);
         const shipped = yield listShippedPackageSkills(options === null || options === void 0 ? void 0 : options.packageRoot);
-        const missing = yield findMissingCursorSkills({
-            packageRoot: options === null || options === void 0 ? void 0 : options.packageRoot,
-            skillsHome,
-        });
+        const present = yield Promise.all(shipped.map((skill) => __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield access(join(skillInstallPath(skill, skillsHome), "SKILL.md"));
+                return true;
+            }
+            catch (_a) {
+                return false;
+            }
+        })));
         return {
             shipped,
             skillsHome,
             directory,
             leaves: shipped.map((skill) => skill.leafDir),
-            firstInstall: missing.length === shipped.length,
+            firstInstall: present.every((isPresent) => !isPresent),
             orphans: yield orphanLeaves(directory, shipped),
+            hasLegacyNamespace: yield hasLegacyCursorSkillsNamespace(skillsHome),
         };
     });
 }
@@ -230,12 +314,55 @@ export function formatSkillInstall(plan, result) {
     if (result.removed.length > 0) {
         lines.push(`  removed:  ${result.removed.join(", ")}`);
     }
+    if (result.removedLegacyNamespace) {
+        lines.push(`  removed:  ${legacyAgentkitCursorSkillsDir(plan.skillsHome)} (legacy namespace)`);
+    }
     lines.push(`  location: ${plan.directory}`);
     return `${lines.join("\n")}\n`;
 }
+/**
+ * Copy shipped coding-agent skills into ~/.cursor/skills/agentsdk during a
+ * consumer `npm install` / `npx`. Never throws: a failed copy must not fail
+ * the package install. No-op in the monorepo source tree and when
+ * `CURSOR_JULY_SKIP_SKILL_INSTALL=1`.
+ */
+export function syncCursorSkillsOnPackageInstall() {
+    return __awaiter(this, arguments, void 0, function* (options = {}) {
+        var _a, _b, _c, _d;
+        try {
+            const env = (_a = options.env) !== null && _a !== void 0 ? _a : process.env;
+            if (env[CURSOR_JULY_SKIP_SKILL_INSTALL_ENV] === "1") {
+                return { status: "skipped", reason: "opt-out" };
+            }
+            const packageRoot = (_b = options.packageRoot) !== null && _b !== void 0 ? _b : packageRootDir();
+            const consumer = (_c = options.consumer) !== null && _c !== void 0 ? _c : isConsumerPackageInstall(packageRoot);
+            if (!consumer) {
+                return { status: "skipped", reason: "not-consumer" };
+            }
+            const plan = yield planSkillInstall({
+                packageRoot,
+                skillsHome: options.skillsHome,
+            });
+            if (plan.shipped.length === 0) {
+                return { status: "skipped", reason: "no-skills" };
+            }
+            const result = yield installCursorSkills(plan.shipped, plan.skillsHome);
+            const out = (_d = options.out) !== null && _d !== void 0 ? _d : ((text) => process.stderr.write(text));
+            out(formatSkillInstall(plan, result));
+            return {
+                status: "installed",
+                installed: result.installed,
+                removed: result.removed,
+            };
+        }
+        catch (_e) {
+            return { status: "skipped", reason: "error" };
+        }
+    });
+}
 /**
  * On a TTY, offer to install/update every shipped package skill into
- * ~/.cursor/skills/agentkit (always overwriting). No-op when non-interactive
+ * ~/.cursor/skills/agentsdk (always overwriting). No-op when non-interactive
  * or the package ships no skills. An unanswered prompt skips the install
  * rather than blocking the caller — see `SKILL_PROMPT_TIMEOUT_MS`.
  */
@@ -265,6 +392,9 @@ export function offerInstallCursorSkills() {
         if (plan.orphans.length > 0) {
             out(c.dim(`  (deletes ${plan.orphans.join(", ")})\n`));
         }
+        if (plan.hasLegacyNamespace) {
+            out(c.dim(`  (deletes leftover ${legacyAgentkitCursorSkillsDir(plan.skillsHome)})\n`));
+        }
         const confirm = (_c = options.confirm) !== null && _c !== void 0 ? _c : ((q) => promptYesNo(q, {
             defaultYes: true,
             out,
@@ -285,24 +415,6 @@ export function offerInstallCursorSkills() {
         return { installed: result.installed, skipped: false };
     });
 }
-function parseSkillName(skillMd) {
-    var _a;
-    var _b;
-    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(skillMd);
-    if (match === null) {
-        return undefined;
-    }
-    const nameLine = /^name:\s*(.+)\s*$/m.exec((_b = match[1]) !== null && _b !== void 0 ? _b : "");
-    if (nameLine === null) {
-        return undefined;
-    }
-    const raw = (_a = nameLine[1]) === null || _a === void 0 ? void 0 : _a.trim();
-    if (raw === undefined || raw === "") {
-        return undefined;
-    }
-    // Strip optional quotes around the YAML scalar.
-    return raw.replace(/^["']|["']$/g, "");
-}
 /**
  * Ask a yes/no question. Resolves `undefined` when the answer never comes —
  * the prompt timed out, or stdin closed on an empty line.

package/dist/internal/json-schema.d.ts

@@ -3,6 +3,13 @@ import type { JsonSchemaObject } from "../types.js";
 export declare function isZodSchema(value: unknown): value is z.ZodTypeAny;
 /** Convert an authored input schema into the JSON Schema shown to the model. */
 export declare function toolInputJsonSchema(inputSchema: z.ZodTypeAny | JsonSchemaObject | undefined): JsonSchemaObject;
+/**
+ * Convert an authored output schema into the JSON Schema advertised on the
+ * tool. Unlike {@link toolInputJsonSchema} there is no fallback: an
+ * undeclared output schema stays undeclared (the MCP field is optional), and
+ * outputs are never validated against it.
+ */
+export declare function toolOutputJsonSchema(outputSchema: z.ZodTypeAny | JsonSchemaObject | undefined): JsonSchemaObject | undefined;
 export type ToolInputValidation = {
     ok: true;
     value: unknown;

package/dist/internal/json-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/internal/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,UAAU,CAYjE;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,CAAC,CAAC,UAAU,GAAG,gBAAgB,GAAG,SAAS,GACvD,gBAAgB,CAalB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,CAAC,CAAC,UAAU,GAAG,gBAAgB,GAAG,SAAS,EACxD,IAAI,EAAE,OAAO,GACZ,mBAAmB,CAerB"}
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/internal/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,UAAU,CAYjE;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,CAAC,CAAC,UAAU,GAAG,gBAAgB,GAAG,SAAS,GACvD,gBAAgB,CAKlB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,CAAC,CAAC,UAAU,GAAG,gBAAgB,GAAG,SAAS,GACxD,gBAAgB,GAAG,SAAS,CAK9B;AAgBD,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,CAAC,CAAC,UAAU,GAAG,gBAAgB,GAAG,SAAS,EACxD,IAAI,EAAE,OAAO,GACZ,mBAAmB,CAerB"}

package/dist/internal/json-schema.js

@@ -21,15 +21,30 @@ export function toolInputJsonSchema(inputSchema) {
     if (inputSchema === undefined) {
         return ANY_OBJECT_SCHEMA;
     }
-    if (isZodSchema(inputSchema)) {
-        const converted = zodToJsonSchema(inputSchema, {
+    return authoredSchemaToJsonSchema(inputSchema);
+}
+/**
+ * Convert an authored output schema into the JSON Schema advertised on the
+ * tool. Unlike {@link toolInputJsonSchema} there is no fallback: an
+ * undeclared output schema stays undeclared (the MCP field is optional), and
+ * outputs are never validated against it.
+ */
+export function toolOutputJsonSchema(outputSchema) {
+    if (outputSchema === undefined) {
+        return undefined;
+    }
+    return authoredSchemaToJsonSchema(outputSchema);
+}
+function authoredSchemaToJsonSchema(schema) {
+    if (isZodSchema(schema)) {
+        const converted = zodToJsonSchema(schema, {
             $refStrategy: "none",
             target: "jsonSchema7",
         });
         delete converted.$schema;
         return converted;
     }
-    return inputSchema;
+    return schema;
 }
 /**
  * Validate tool-call args before `execute` runs. Zod schemas validate (and

package/dist/internal/mcp-endpoint.js

@@ -140,11 +140,9 @@ function buildToolMcpServer(engine, sessionId) {
     });
     const tools = engine.project.agent.tools.filter((tool) => tool.execution === "server");
     server.setRequestHandler(ListToolsRequestSchema, () => Promise.resolve({
-        tools: tools.map((tool) => ({
-            name: tool.name,
-            description: tool.description,
-            inputSchema: tool.inputSchema,
-        })),
+        tools: tools.map((tool) => (Object.assign({ name: tool.name, description: tool.description, inputSchema: tool.inputSchema }, (tool.outputSchema === undefined
+            ? {}
+            : { outputSchema: tool.outputSchema })))),
     }));
     server.setRequestHandler(CallToolRequestSchema, (request) => __awaiter(this, void 0, void 0, function* () {
         var _a;
@@ -204,9 +202,11 @@ function buildConnectionBridgeMcpServer(engine, sessionId, connectionName) {
         }
         const tools = yield engine.host.mcp.listTools(connectionName);
         return {
-            tools: tools.map((tool) => { var _a; return (Object.assign(Object.assign({ name: tool.name }, (tool.description === undefined
+            tools: tools.map((tool) => { var _a; return (Object.assign(Object.assign(Object.assign({ name: tool.name }, (tool.description === undefined
+                ? {}
+                : { description: tool.description })), { inputSchema: (_a = tool.inputSchema) !== null && _a !== void 0 ? _a : { type: "object" } }), (tool.outputSchema === undefined
                 ? {}
-                : { description: tool.description })), { inputSchema: (_a = tool.inputSchema) !== null && _a !== void 0 ? _a : { type: "object" } })); }),
+                : { outputSchema: tool.outputSchema }))); }),
         };
     }));
     server.setRequestHandler(CallToolRequestSchema, (request) => __awaiter(this, void 0, void 0, function* () {

package/dist/internal/mcp-host.js

@@ -181,11 +181,13 @@ export function isStaleMcpSessionError(error) {
     return code === 404;
 }
 function toToolInfo(tool) {
-    return Object.assign(Object.assign({ name: tool.name }, (tool.description === undefined
+    return Object.assign(Object.assign(Object.assign({ name: tool.name }, (tool.description === undefined
         ? {}
         : { description: tool.description })), (tool.inputSchema === undefined
         ? {}
-        : { inputSchema: tool.inputSchema }));
+        : { inputSchema: tool.inputSchema })), (tool.outputSchema === undefined
+        ? {}
+        : { outputSchema: tool.outputSchema }));
 }
 function openConnection(connection) {
     return __awaiter(this, void 0, void 0, function* () {

package/dist/internal/mcp-oauth.d.ts

@@ -46,7 +46,24 @@ type ProviderArgs = {
     onRedirect?: (url: URL) => void;
     tokens?: OAuthTokens;
     clientInformation?: OAuthClientInformationFull;
+    /**
+     * True when authorize/token requests must NOT carry the RFC 8707
+     * `resource` indicator, read off the server's protected-resource
+     * metadata (`cursor_omit_resource_indicator`). Entra rejects the
+     * indicator with AADSTS9010010, so Microsoft 365 flows through Cursor's
+     * REST-as-MCP translator fail pre-auth without this.
+     */
+    omitResourceIndicator?: boolean;
 };
+/**
+ * Reads the Cursor REST-as-MCP translator's OAuth quirk off the resource's
+ * RFC 9728 protected-resource metadata. Deliberately self-contained
+ * (`@cursor/july` publishes to public npm with no private workspace
+ * dependencies — see `waitForMcpOAuthCallback`): matches the translator
+ * path shape on any origin so local translators work, and fails to the
+ * default behavior (indicator kept) when the PRM is unreachable.
+ */
+export declare function fetchOmitResourceIndicatorFromPrm(resourceUrl: string, fetchImpl?: typeof fetch): Promise<boolean>;
 export declare class HostMcpOAuthProvider implements OAuthClientProvider {
     private tokensValue;
     private clientInfo;
@@ -54,6 +71,11 @@ export declare class HostMcpOAuthProvider implements OAuthClientProvider {
     private redirect;
     private readonly meta;
     private readonly args;
+    /**
+     * Assigned only when the PRM sets `cursor_omit_resource_indicator`; left
+     * absent otherwise so the SDK's default resource validation applies.
+     */
+    readonly validateResourceURL: (() => Promise<URL | undefined>) | undefined;
     constructor(args: ProviderArgs);
     get redirectUrl(): string;
     get clientMetadata(): OAuthClientMetadata;

package/dist/internal/mcp-oauth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-oauth.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-oauth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-oauth.d.ts","sourceRoot":"","sources":["../../src/internal/mcp-oauth.ts"],"names":[],"mappings":"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"}

package/dist/internal/mcp-oauth.js

@@ -210,12 +210,49 @@ export class FileMcpOAuthStore {
         });
     }
 }
+/**
+ * Reads the Cursor REST-as-MCP translator's OAuth quirk off the resource's
+ * RFC 9728 protected-resource metadata. Deliberately self-contained
+ * (`@cursor/july` publishes to public npm with no private workspace
+ * dependencies — see `waitForMcpOAuthCallback`): matches the translator
+ * path shape on any origin so local translators work, and fails to the
+ * default behavior (indicator kept) when the PRM is unreachable.
+ */
+export function fetchOmitResourceIndicatorFromPrm(resourceUrl_1) {
+    return __awaiter(this, arguments, void 0, function* (resourceUrl, fetchImpl = fetch) {
+        let url;
+        try {
+            url = new URL(resourceUrl);
+        }
+        catch (_a) {
+            return false;
+        }
+        if (!/^\/rest-mcp\/[^/]+\/mcp\/?$/.test(url.pathname)) {
+            return false;
+        }
+        const prmUrl = `${url.origin}/.well-known/oauth-protected-resource${url.pathname.replace(/\/+$/, "")}`;
+        try {
+            const response = yield fetchImpl(prmUrl);
+            if (!response.ok) {
+                return false;
+            }
+            const document = (yield response.json());
+            return document.cursor_omit_resource_indicator === true;
+        }
+        catch (_b) {
+            return false;
+        }
+    });
+}
 export class HostMcpOAuthProvider {
     constructor(args) {
         var _a;
         this.args = args;
         this.tokensValue = args.tokens;
         this.clientInfo = args.clientInformation;
+        if (args.omitResourceIndicator === true) {
+            this.validateResourceURL = () => __awaiter(this, void 0, void 0, function* () { return undefined; });
+        }
         this.meta = {
             redirect_uris: [(_a = args.redirectUrl) !== null && _a !== void 0 ? _a : MCP_OAUTH_CALLBACK_URL],
             token_endpoint_auth_method: "none",
@@ -293,9 +330,10 @@ export function createHostMcpOAuthProvider(args) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         const store = (_a = args.store) !== null && _a !== void 0 ? _a : new FileMcpOAuthStore();
-        const [fileTokens, fileClient] = yield Promise.all([
+        const [fileTokens, fileClient, omitResourceIndicator] = yield Promise.all([
             store.loadTokens(args.identifier, args.resourceUrl),
             store.loadClientInformation(args.identifier, args.resourceUrl),
+            fetchOmitResourceIndicatorFromPrm(args.resourceUrl),
         ]);
         return new HostMcpOAuthProvider({
             identifier: args.identifier,
@@ -304,6 +342,7 @@ export function createHostMcpOAuthProvider(args) {
             tokens: fileTokens !== null && fileTokens !== void 0 ? fileTokens : tokensFromEnv(args.identifier),
             clientInformation: fileClient !== null && fileClient !== void 0 ? fileClient : clientIdFromEnv(args.identifier),
             onRedirect: args.onRedirect,
+            omitResourceIndicator,
         });
     });
 }

package/dist/internal/package-inline-stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-inline-stdio.d.ts","sourceRoot":"","sources":["../../src/internal/package-inline-stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAE5B,MAAM,aAAa,CAAC;AA+BrB,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsE/B"}
+{"version":3,"file":"package-inline-stdio.d.ts","sourceRoot":"","sources":["../../src/internal/package-inline-stdio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAE5B,MAAM,aAAa,CAAC;AAmCrB,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsE/B"}

package/dist/internal/package-inline-stdio.js

@@ -16,7 +16,7 @@ import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import * as esbuild from "esbuild";
-import { toolInputJsonSchema } from "./json-schema.js";
+import { toolInputJsonSchema, toolOutputJsonSchema } from "./json-schema.js";
 const require = createRequire(import.meta.url);
 const CONNECTION_SPECIFIERS = new Set([
     "@anysphere/agent-serve/connections",
@@ -31,10 +31,10 @@ function sibling(basename) {
 function jsonSchemaCatalog(tools) {
     const catalog = {};
     for (const [name, tool] of Object.entries(tools)) {
-        catalog[name] = {
-            description: tool.description,
-            inputSchema: toolInputJsonSchema(tool.inputSchema),
-        };
+        const outputSchema = toolOutputJsonSchema(tool.outputSchema);
+        catalog[name] = Object.assign({ description: tool.description, inputSchema: toolInputJsonSchema(tool.inputSchema) }, (outputSchema === undefined
+            ? {}
+            : { outputSchema: outputSchema }));
     }
     return catalog;
 }