@cursor/july 0.1.18 → 0.1.20

package/AGENTS.md

@@ -303,6 +303,16 @@ Fixtures still work for offline replay: `POST` a saved payload with an
   part of a code change. Docs are written intentionally, on explicit request
   only — never as a side effect of a feature or fix. If a change makes docs
   stale, say so in the PR description instead of editing them unprompted.
+- Grow an agent's deterministic path by default. Host code owns side-effect
+  gates and actuation, dedupe of external writes, auth, evidence seeding,
+  and hard API caps; formatting, summarizing, classification, and reply
+  composition stay with the model under an output contract in
+  `instructions.md` / skills (prose in `.md`, never TS string builders).
+  Speculative caches (prefetch, fingerprint dedupe, write coalescing) need
+  measured pressure first, and framework gaps (posting, chunking, retries)
+  get fixed or filed in the framework, not worked around in `agent/lib/`.
+  Budget + smells: `skills/create-agent/SKILL.md` § "The deterministic-path
+  budget".
 - Put durable `--state-root` inside a large monorepo if you care about
   ambient `AGENTS.md` / `.cursor` rules leaking into the agent workspace.
   Prefer `defineAgent({ local: { cwd } })` pointing outside the monorepo

package/dist/bin/agent-serve.js

@@ -66,6 +66,7 @@ Usage:
   ${CLI} call        <tool> [--input <json>] [--dir <path> | --url <baseUrl> | --prod]
                           [--session <id>] [--slug <slug>] [--team <id>]
   ${CLI} init        [dir] [--json]
+  ${CLI} install-skills [--print] [--json]
   ${CLI} mcp         --prod [--slug <slug>] [--team <id>] [--dir <path>]
                           | --url <baseUrl> [--bearer-token <t>]
   ${CLI} mcp install [--name <serverName>] [--print] [--json]
@@ -145,6 +146,12 @@ Commands:
               run login when unsigned, then print next steps. --json is
               machine-readable and never blocks on login. No directory:
               print the setup guide.
+  install-skills
+              Install (or refresh) the agentkit skills for coding agents in
+              ~/.cursor/skills/agentkit and print where they landed. \`init\`
+              offers this once, interactively, and skips it when the prompt
+              goes unanswered; this command never asks. --print previews
+              without writing.
   mcp         Serve this agent's MCP endpoint over stdio for MCP clients
               that spawn local servers (e.g. Cursor). Proxies
               newline-delimited JSON-RPC to <target>/v1/mcp. --prod resolves
@@ -263,6 +270,8 @@ Options:
   --once             logs: print current progress / log buffer once and exit
                      (default is to follow).
   --print            playground: print the URL only; do not open a browser.
+                     install-skills: list the skills and the install path
+                     without writing them.
   --no-wait          deploy/stop/eval: return right after the request is
                      accepted instead of polling until a terminal status.
                      For eval, prints the runId (deployment / --url only).
@@ -304,9 +313,10 @@ Options:
   --no-artifacts     eval: do not write run artifacts.
   --skip-report      eval: ignore reporters from evals.config.ts / eval files.
   --no-stream        run/eval: silence live progress on stderr (JSON still prints).
-  --json             JSON output (init/info/chat/eval/logs/sessions/session/
-                     github; run defaults to JSON). logs: NDJSON progress/log
-                     events. session: trajectory JSON (not raw events).
+  --json             JSON output (init/install-skills/info/chat/eval/logs/
+                     sessions/session/github; run defaults to JSON). logs:
+                     NDJSON progress/log events. session: trajectory JSON
+                     (not raw events).
   --no-color         chat: force plain output.
   --cursor-events    serve: pull SCM webhook events from /v0/scm-events. The
                      stream is read as your Cursor user, so serve requires
@@ -520,6 +530,13 @@ function main(argv) {
                     json: values.json,
                 });
             }
+            case "install-skills": {
+                const { cmdInstallSkills } = yield import("../internal/cli-skills.js");
+                return cmdInstallSkills({
+                    json: values.json,
+                    print: values.print,
+                });
+            }
             case "mcp": {
                 const { cmdMcp } = yield import("../internal/cli-mcp.js");
                 const mcpSub = positionals[0];

package/dist/docs/404.html

@@ -9,7 +9,7 @@
     <link rel="preload stylesheet" href="/docs/assets/style.Bj-IXa5W.css" as="style">
     <link rel="preload stylesheet" href="/docs/vp-icons.css" as="style">
     
-    <script type="module" src="/docs/assets/app.BR5EdVSq.js"></script>
+    <script type="module" src="/docs/assets/app.T-5ImnM3.js"></script>
     <link rel="preload" href="/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
     <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
     <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>

package/dist/docs/ab.html

@@ -9,9 +9,9 @@
     <link rel="preload stylesheet" href="/docs/assets/style.Bj-IXa5W.css" as="style">
     <link rel="preload stylesheet" href="/docs/vp-icons.css" as="style">
     
-    <script type="module" src="/docs/assets/app.BR5EdVSq.js"></script>
+    <script type="module" src="/docs/assets/app.T-5ImnM3.js"></script>
     <link rel="preload" href="/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
-    <link rel="modulepreload" href="/docs/assets/chunks/theme.CwKvMSWv.js">
+    <link rel="modulepreload" href="/docs/assets/chunks/theme.DLg4yB4D.js">
     <link rel="modulepreload" href="/docs/assets/chunks/framework.CAZyNGu9.js">
     <link rel="modulepreload" href="/docs/assets/ab.md.BMCZ6Hd7.lean.js">
     <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>

package/dist/docs/assets/{app.BR5EdVSq.js → app.T-5ImnM3.js}

@@ -1 +1 @@
-import{t as p}from"./chunks/theme.CwKvMSWv.js";import{R as s,a2 as i,a3 as u,a4 as c,a5 as l,a6 as f,a7 as d,a8 as m,a9 as h,aa as g,ab as A,d as v,u as y,v as C,s as P,ac as b,ad as w,ae as R,af as E}from"./chunks/framework.CAZyNGu9.js";function r(e){if(e.extends){const a=r(e.extends);return{...a,...e,async enhanceApp(t){a.enhanceApp&&await a.enhanceApp(t),e.enhanceApp&&await e.enhanceApp(t)}}}return e}const n=r(p),S=v({name:"VitePressApp",setup(){const{site:e,lang:a,dir:t}=y();return C(()=>{P(()=>{document.documentElement.lang=a.value,document.documentElement.dir=t.value})}),e.value.router.prefetchLinks&&b(),w(),R(),n.setup&&n.setup(),()=>E(n.Layout)}});async function T(){globalThis.__VITEPRESS__=!0;const e=_(),a=D();a.provide(u,e);const t=c(e.route);return a.provide(l,t),a.component("Content",f),a.component("ClientOnly",d),Object.defineProperties(a.config.globalProperties,{$frontmatter:{get(){return t.frontmatter.value}},$params:{get(){return t.page.value.params}}}),n.enhanceApp&&await n.enhanceApp({app:a,router:e,siteData:m}),{app:a,router:e,data:t}}function D(){return A(S)}function _(){let e=s;return h(a=>{let t=g(a),o=null;return t&&(e&&(t=t.replace(/\.js$/,".lean.js")),o=import(t)),s&&(e=!1),o},n.NotFound)}s&&T().then(({app:e,router:a,data:t})=>{a.go().then(()=>{i(a.route,t.site),e.mount("#app")})});export{T as createApp};
+import{t as p}from"./chunks/theme.DLg4yB4D.js";import{R as s,a2 as i,a3 as u,a4 as c,a5 as l,a6 as f,a7 as d,a8 as m,a9 as h,aa as g,ab as A,d as v,u as y,v as C,s as P,ac as b,ad as w,ae as R,af as E}from"./chunks/framework.CAZyNGu9.js";function r(e){if(e.extends){const a=r(e.extends);return{...a,...e,async enhanceApp(t){a.enhanceApp&&await a.enhanceApp(t),e.enhanceApp&&await e.enhanceApp(t)}}}return e}const n=r(p),S=v({name:"VitePressApp",setup(){const{site:e,lang:a,dir:t}=y();return C(()=>{P(()=>{document.documentElement.lang=a.value,document.documentElement.dir=t.value})}),e.value.router.prefetchLinks&&b(),w(),R(),n.setup&&n.setup(),()=>E(n.Layout)}});async function T(){globalThis.__VITEPRESS__=!0;const e=_(),a=D();a.provide(u,e);const t=c(e.route);return a.provide(l,t),a.component("Content",f),a.component("ClientOnly",d),Object.defineProperties(a.config.globalProperties,{$frontmatter:{get(){return t.frontmatter.value}},$params:{get(){return t.page.value.params}}}),n.enhanceApp&&await n.enhanceApp({app:a,router:e,siteData:m}),{app:a,router:e,data:t}}function D(){return A(S)}function _(){let e=s;return h(a=>{let t=g(a),o=null;return t&&(e&&(t=t.replace(/\.js$/,".lean.js")),o=import(t)),s&&(e=!1),o},n.NotFound)}s&&T().then(({app:e,router:a,data:t})=>{a.go().then(()=>{i(a.route,t.site),e.mount("#app")})});export{T as createApp};