@cursor/july 0.1.91 → 0.1.92

package/skills/create-agent/SKILL.md

@@ -11,6 +11,9 @@ paths:
 
 # Create an Agent SDK agent
 
+Public docs index: `node_modules/@cursor/july/dist/docs/llms.txt`. A running
+host serves the same index at `/docs/llms.txt`.
+
 Stand up one new agent project via a short interview, scaffold it, get
 channels working
 with the user, prove a turn runs end-to-end, and set up the improvement loop.

package/skills/debug/SKILL.md

@@ -10,6 +10,9 @@ description: >-
 
 # Debugging the Agent SDK locally
 
+Public docs index: `node_modules/@cursor/july/dist/docs/llms.txt`. A running
+host serves the same index at `/docs/llms.txt`.
+
 This skill is **local** `agent-sdk serve` / playground. A **hosted**
 deployment that is stopped, slow to start, or failing `/v1/health` is
 `.cursor/skills/debugging/debug-agent-serve-deployment/SKILL.md`.

package/skills/evals/SKILL.md

@@ -9,6 +9,9 @@ description: >-
 
 # Agent SDK evals
 
+Public docs index: `node_modules/@cursor/july/dist/docs/llms.txt`. A running
+host serves the same index at `/docs/llms.txt`.
+
 Evals are the ratchet that makes iteration trustworthy: a fixed input, a
 model turn, and gates over the recorded trajectory. They live at the
 **project root** `evals/**/*.eval.ts` (never `agent/evals/` — that slot is

package/skills/framework-map/SKILL.md

@@ -16,6 +16,9 @@ over HTTP/Slack/GitHub channels, with the Cursor SDK + harness as the
 execution engine. Ground truth is the package `README.md` (full reference)
 and `AGENTS.md` (coding-agent loop) — this skill is the map, not the spec.
 
+Public docs index: `node_modules/@cursor/july/dist/docs/llms.txt`. A running
+host serves the same index at `/docs/llms.txt`.
+
 Run the CLI as `agent-sdk <cmd>`. In the everysphere monorepo there is no
 installed bin — use:
 

package/skills/github/SKILL.md

@@ -9,6 +9,9 @@ description: >-
 
 # GitHub channels in the Agent SDK
 
+Public docs index: `node_modules/@cursor/july/dist/docs/llms.txt`. A running
+host serves the same index at `/docs/llms.txt`.
+
 Author `agent/channels/github.ts` with `githubChannel()` from
 `@cursor/july/channels/github`. It mounts
 `POST /<slug>/v1/channels/github` and publishes the events it dispatches on

package/skills/hillclimb/SKILL.md

@@ -11,6 +11,9 @@ paths:
 
 # Agent SDK hillclimb
 
+Public docs index: `node_modules/@cursor/july/dist/docs/llms.txt`. A running
+host serves the same index at `/docs/llms.txt`.
+
 Optimize one Agent SDK agent project
 with a tight measure → change → remeasure loop. Do not redesign the
 whole framework; climb one concrete failure mode at a time. Sibling skills:

package/skills/mcp-auth/SKILL.md

@@ -8,6 +8,9 @@ description: >-
 
 # Host MCP OAuth (mcp auth)
 
+Public docs index: `node_modules/@cursor/july/dist/docs/llms.txt`. A running
+host serves the same index at `/docs/llms.txt`.
+
 Use this skill when a human asks to authorize a remote MCP server on an
 Agent SDK host, store credentials for Cursor-managed hosting, or debug
 `host.mcp` auth failures for `oauth: true` connections.

package/skills/otel/SKILL.md

@@ -8,6 +8,9 @@ description: >-
 
 # Agent SDK OpenTelemetry (`defineOtel`)
 
+Public docs index: `node_modules/@cursor/july/dist/docs/llms.txt`. A running
+host serves the same index at `/docs/llms.txt`.
+
 Push session, turn, tool, and subagent traces, plus token and cost
 metrics, from the serve process to an OTLP collector. Logs are off
 until you opt in.

package/skills/setup-slack/SKILL.md

@@ -9,6 +9,9 @@ description: >-
 
 # Setup Slack for the Agent SDK
 
+Public docs index: `node_modules/@cursor/july/dist/docs/llms.txt`. A running
+host serves the same index at `/docs/llms.txt`.
+
 Use this skill when a human asks to wire Slack to an Agent SDK agent.
 
 There are **two ways to connect**:

package/src/internal/init-scaffold.ts

@@ -103,6 +103,7 @@ Run the CLI under Node, never Bun.
 - Package loop: \`node_modules/${PACKAGE_NAME}/AGENTS.md\`
 - Skills: \`node_modules/${PACKAGE_NAME}/skills/\` (\`create-agent\`, \`evals\`, \`hillclimb\`, \`debug\`)
 - Docs: \`npx ${PACKAGE_NAME} docs\`
+- LLM docs index: \`node_modules/${PACKAGE_NAME}/dist/docs/llms.txt\`
 `;
 }
 

package/src/internal/playground/static.ts

@@ -27,6 +27,7 @@ const ASSETS_DIR = join(DIST_DIR, "assets");
 export const STATIC_CONTENT_TYPES: Record<string, string> = {
   ".html": "text/html; charset=utf-8",
   ".js": "text/javascript; charset=utf-8",
+  ".md": "text/markdown; charset=utf-8",
   ".mjs": "text/javascript; charset=utf-8",
   ".css": "text/css; charset=utf-8",
   ".map": "application/json; charset=utf-8",
@@ -41,6 +42,7 @@ export const STATIC_CONTENT_TYPES: Record<string, string> = {
   ".woff": "font/woff",
   ".woff2": "font/woff2",
   ".ttf": "font/ttf",
+  ".txt": "text/plain; charset=utf-8",
 };
 
 /** Whether `pnpm run build:playground` has produced the SPA bundle. */

package/src/internal/session-engine.ts

@@ -2384,14 +2384,12 @@ export class SessionEngine {
       tools[tool.name] = {
         description: tool.description,
         inputSchema: tool.inputSchema as SDKCustomTool["inputSchema"],
-        // `SDKCustomTool.outputSchema` ships in the next published
-        // @cursor/sdk; the conditional spread carries the field through the
-        // pinned SDK's type until the dependency bumps, at which point local
-        // runs start advertising it.
         ...(tool.outputSchema === undefined
           ? {}
-          : { outputSchema: tool.outputSchema }),
-        // Same pinned-SDK carry for `SDKCustomTool.annotations`: an advertised
+          : {
+              outputSchema: tool.outputSchema as SDKCustomTool["outputSchema"],
+            }),
+        // Pinned-SDK carry for `SDKCustomTool.annotations`: an advertised
         // MCP passthrough's server-declared hints (bounded at listing time)
         // ride into the harness listing once the dependency bumps.
         ...(tool.annotations === undefined