@cursor/july 0.1.35 → 0.1.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (198) hide show
  1. package/AGENTS.md +5 -9
  2. package/README.md +5 -9
  3. package/dist/channels/github/github-channel.d.ts +1 -1
  4. package/dist/channels/github/github-channel.js +1 -1
  5. package/dist/channels/github/index.d.ts +1 -1
  6. package/dist/channels/github/index.js +1 -1
  7. package/dist/channels/slack/api.js +1 -1
  8. package/dist/channels/slack/index.d.ts +1 -1
  9. package/dist/channels/slack/index.js +1 -1
  10. package/dist/channels/slack/init.d.ts.map +1 -1
  11. package/dist/channels/slack/init.js +2 -1
  12. package/dist/docs/404.html +2 -2
  13. package/dist/docs/ab.html +8 -17
  14. package/dist/docs/assets/{ab.md.DAQoJ-up.js → ab.md.6cLOW7--.js} +4 -13
  15. package/dist/docs/assets/{ab.md.DAQoJ-up.lean.js → ab.md.6cLOW7--.lean.js} +1 -1
  16. package/dist/docs/assets/{app.D5Mv1T0U.js → app.Bu9SRvZ9.js} +1 -1
  17. package/dist/docs/assets/{building-with-agents.md.CnHqvYDd.js → building-with-agents.md.txrcGU2B.js} +2 -2
  18. package/dist/docs/assets/chunks/@localSearchIndexroot.pVFW7oJd.js +1 -0
  19. package/dist/docs/assets/chunks/{VPLocalSearchBox.CMq_BQce.js → VPLocalSearchBox.D9u9czHO.js} +1 -1
  20. package/dist/docs/assets/chunks/{theme.C6D9UPLK.js → theme.Bc61GzOf.js} +2 -2
  21. package/dist/docs/assets/{concepts.md.DFaQEFkA.js → concepts.md.CqOsxbMU.js} +1 -1
  22. package/dist/docs/assets/{deployment.md.9MYBuKM1.js → deployment.md.CuK5SNjN.js} +1 -1
  23. package/dist/docs/assets/{evals.md.BIUoVZ6X.js → evals.md.BQXI3rXy.js} +9 -15
  24. package/dist/docs/assets/{evals.md.BIUoVZ6X.lean.js → evals.md.BQXI3rXy.lean.js} +1 -1
  25. package/dist/docs/assets/{example-agents_approval-buddy.md.BhEfleVx.js → example-agents_approval-buddy.md.CIiZ9coo.js} +1 -1
  26. package/dist/docs/assets/{example-agents_benny.md.2Et1qa8f.js → example-agents_benny.md.l7JTmm8X.js} +1 -1
  27. package/dist/docs/assets/{example-agents_bugbot.md.ByUexi5i.js → example-agents_bugbot.md.Dp5JqHSQ.js} +2 -2
  28. package/dist/docs/assets/{example-agents_bugbot.md.ByUexi5i.lean.js → example-agents_bugbot.md.Dp5JqHSQ.lean.js} +1 -1
  29. package/dist/docs/assets/{example-agents_codebase-wiki.md.B4y-7ZVW.js → example-agents_codebase-wiki.md.D-lteFf0.js} +1 -1
  30. package/dist/docs/assets/{example-agents_codebase-wiki.md.B4y-7ZVW.lean.js → example-agents_codebase-wiki.md.D-lteFf0.lean.js} +1 -1
  31. package/dist/docs/assets/{example-agents_codeowners-review.md.D6ay4nvf.js → example-agents_codeowners-review.md.BU2ZXLf-.js} +1 -1
  32. package/dist/docs/assets/{example-agents_codeowners-review.md.D6ay4nvf.lean.js → example-agents_codeowners-review.md.BU2ZXLf-.lean.js} +1 -1
  33. package/dist/docs/assets/{example-agents_concierge.md.lL8rhYlj.js → example-agents_concierge.md.DA2al_NK.js} +2 -2
  34. package/dist/docs/assets/{example-agents_concierge.md.lL8rhYlj.lean.js → example-agents_concierge.md.DA2al_NK.lean.js} +1 -1
  35. package/dist/docs/assets/{example-agents_fsd.md.DfNKQTHz.js → example-agents_fsd.md.DPz9ezO4.js} +1 -1
  36. package/dist/docs/assets/{example-agents_knowledge-base.md.CzyZ2DCr.js → example-agents_knowledge-base.md.IneynQSR.js} +1 -1
  37. package/dist/docs/assets/{example-agents_oncall.md.wFFXXEyW.js → example-agents_oncall.md.ZE0n6ZFN.js} +1 -1
  38. package/dist/docs/assets/{example-agents_slack-agent.md.DvgvT4nn.js → example-agents_slack-agent.md.06jQXTAI.js} +1 -1
  39. package/dist/docs/assets/{example-agents_weather-agent.md.BADkPqxQ.js → example-agents_weather-agent.md.CrGZ0SqR.js} +3 -3
  40. package/dist/docs/assets/{example-agents_weather-agent.md.BADkPqxQ.lean.js → example-agents_weather-agent.md.CrGZ0SqR.lean.js} +1 -1
  41. package/dist/docs/assets/guides_cloud-runtime.md.V5igN4Sq.js +9 -0
  42. package/dist/docs/assets/guides_cloud-runtime.md.V5igN4Sq.lean.js +1 -0
  43. package/dist/docs/assets/{guides_webhooks.md.DiAwSR42.js → guides_webhooks.md.BERuBSJW.js} +1 -1
  44. package/dist/docs/assets/{hillclimbing.md.D9Y1_bYh.js → hillclimbing.md.yXqdlv2R.js} +1 -1
  45. package/dist/docs/assets/index.md.CmhptOmN.js +24 -0
  46. package/dist/docs/assets/{index.md.CZqbBJPB.lean.js → index.md.CmhptOmN.lean.js} +1 -1
  47. package/dist/docs/assets/{quickstart.md.TnEXYgYW.js → quickstart.md.C_b6ESpD.js} +7 -4
  48. package/dist/docs/assets/{quickstart.md.TnEXYgYW.lean.js → quickstart.md.C_b6ESpD.lean.js} +1 -1
  49. package/dist/docs/assets/{reference_agent-config.md.kuN6-OxK.js → reference_agent-config.md.CRmkoxd6.js} +6 -4
  50. package/dist/docs/assets/{reference_agent-config.md.kuN6-OxK.lean.js → reference_agent-config.md.CRmkoxd6.lean.js} +1 -1
  51. package/dist/docs/assets/reference_artifacts.md.BGG4bZo-.js +19 -0
  52. package/dist/docs/assets/reference_artifacts.md.BGG4bZo-.lean.js +1 -0
  53. package/dist/docs/assets/{reference_channels.md.CDhTRfUz.js → reference_channels.md.BIabFUAI.js} +2 -2
  54. package/dist/docs/assets/{reference_channels.md.CDhTRfUz.lean.js → reference_channels.md.BIabFUAI.lean.js} +1 -1
  55. package/dist/docs/assets/{reference_cli.md.sD-IUWjg.js → reference_cli.md.Byvrg8eu.js} +15 -9
  56. package/dist/docs/assets/{reference_cli.md.sD-IUWjg.lean.js → reference_cli.md.Byvrg8eu.lean.js} +1 -1
  57. package/dist/docs/assets/{reference_hooks.md.DyLVfE1O.js → reference_hooks.md.BGDw4VLm.js} +2 -2
  58. package/dist/docs/assets/{reference_hooks.md.DyLVfE1O.lean.js → reference_hooks.md.BGDw4VLm.lean.js} +1 -1
  59. package/dist/docs/assets/reference_http-api.md.DGrw_wOu.js +11 -0
  60. package/dist/docs/assets/reference_http-api.md.DGrw_wOu.lean.js +1 -0
  61. package/dist/docs/assets/{reference_project-layout.md.D8E6ZmHJ.js → reference_project-layout.md._XdeMahr.js} +2 -2
  62. package/dist/docs/assets/{reference_project-layout.md.D8E6ZmHJ.lean.js → reference_project-layout.md._XdeMahr.lean.js} +1 -1
  63. package/dist/docs/assets/{reference_sessions.md.C_ouF_uf.js → reference_sessions.md.DBVFi2Sx.js} +2 -2
  64. package/dist/docs/assets/{reference_subagents.md.zWAMNfi1.js → reference_subagents.md.DSrGLIuB.js} +2 -2
  65. package/dist/docs/assets/{reference_subagents.md.zWAMNfi1.lean.js → reference_subagents.md.DSrGLIuB.lean.js} +1 -1
  66. package/dist/docs/assets/{reference_tools.md.BswAQM41.js → reference_tools.md.lSrsTxYJ.js} +4 -4
  67. package/dist/docs/assets/{reference_tools.md.BswAQM41.lean.js → reference_tools.md.lSrsTxYJ.lean.js} +1 -1
  68. package/dist/docs/assets/scaffolding-agents.md.mkc3B_ZW.js +1 -0
  69. package/dist/docs/assets/{scaffolding-agents.md.Bsr9Pwzu.lean.js → scaffolding-agents.md.mkc3B_ZW.lean.js} +1 -1
  70. package/dist/docs/assets/{storage.md.xZoiGM58.js → storage.md.mQDtIULc.js} +3 -3
  71. package/dist/docs/assets/{storage.md.xZoiGM58.lean.js → storage.md.mQDtIULc.lean.js} +1 -1
  72. package/dist/docs/building-with-agents.html +6 -6
  73. package/dist/docs/concepts.html +5 -5
  74. package/dist/docs/deployment.html +6 -6
  75. package/dist/docs/evals.html +13 -19
  76. package/dist/docs/example-agents/approval-buddy.html +5 -5
  77. package/dist/docs/example-agents/benny.html +5 -5
  78. package/dist/docs/example-agents/bugbot.html +5 -5
  79. package/dist/docs/example-agents/codebase-wiki.html +5 -5
  80. package/dist/docs/example-agents/codeowners-review.html +5 -5
  81. package/dist/docs/example-agents/concierge.html +6 -6
  82. package/dist/docs/example-agents/fsd.html +5 -5
  83. package/dist/docs/example-agents/index.html +4 -4
  84. package/dist/docs/example-agents/knowledge-base.html +5 -5
  85. package/dist/docs/example-agents/oncall.html +5 -5
  86. package/dist/docs/example-agents/security-reviewer.html +4 -4
  87. package/dist/docs/example-agents/slack-agent.html +5 -5
  88. package/dist/docs/example-agents/weather-agent.html +6 -6
  89. package/dist/docs/guides/agent-to-agent.html +5 -5
  90. package/dist/docs/guides/cloud-runtime.html +6 -6
  91. package/dist/docs/guides/github.html +4 -4
  92. package/dist/docs/guides/human-in-the-loop.html +4 -4
  93. package/dist/docs/guides/mcp-oauth.html +5 -5
  94. package/dist/docs/guides/slack.html +4 -4
  95. package/dist/docs/guides/webhooks.html +6 -6
  96. package/dist/docs/hashmap.json +1 -1
  97. package/dist/docs/hillclimbing.html +6 -6
  98. package/dist/docs/index.html +11 -7
  99. package/dist/docs/quickstart.html +10 -7
  100. package/dist/docs/reference/agent-config.html +10 -8
  101. package/dist/docs/reference/artifacts.html +43 -0
  102. package/dist/docs/reference/channels.html +6 -6
  103. package/dist/docs/reference/cli.html +18 -12
  104. package/dist/docs/reference/connections.html +4 -4
  105. package/dist/docs/reference/hooks.html +6 -6
  106. package/dist/docs/reference/http-api.html +7 -7
  107. package/dist/docs/reference/instructions.html +4 -4
  108. package/dist/docs/reference/playground.html +4 -4
  109. package/dist/docs/reference/project-layout.html +6 -6
  110. package/dist/docs/reference/prompt.html +4 -4
  111. package/dist/docs/reference/schedules.html +4 -4
  112. package/dist/docs/reference/sessions.html +7 -7
  113. package/dist/docs/reference/skills.html +4 -4
  114. package/dist/docs/reference/subagents.html +6 -6
  115. package/dist/docs/reference/tools.html +7 -7
  116. package/dist/docs/scaffolding-agents.html +5 -5
  117. package/dist/docs/storage.html +6 -6
  118. package/dist/docs/troubleshooting.html +4 -4
  119. package/dist/files-backends/agent-store-presigned-url.d.ts.map +1 -1
  120. package/dist/files-backends/agent-store-presigned-url.js +15 -22
  121. package/dist/internal/cli-github.d.ts.map +1 -1
  122. package/dist/internal/cli-github.js +8 -7
  123. package/dist/internal/cli-slack.js +9 -9
  124. package/dist/internal/event-mapper.d.ts +3 -3
  125. package/dist/internal/event-mapper.d.ts.map +1 -1
  126. package/dist/internal/event-mapper.js +7 -4
  127. package/dist/internal/session-engine.js +3 -3
  128. package/dist/internal/workspace.d.ts +8 -6
  129. package/dist/internal/workspace.d.ts.map +1 -1
  130. package/dist/internal/workspace.js +15 -11
  131. package/dist/playground/assets/{index-D7OV8B_H.js → index-DRtusTV1.js} +38 -38
  132. package/dist/playground/assets/index-DZp6n4bv.css +1 -0
  133. package/dist/playground/index.html +2 -2
  134. package/docs/README.md +32 -13
  135. package/docs/ab.md +23 -36
  136. package/docs/building-with-agents.md +2 -2
  137. package/docs/concepts.md +3 -2
  138. package/docs/deployment.md +1 -1
  139. package/docs/evals.md +102 -33
  140. package/docs/example-agents/approval-buddy.md +2 -1
  141. package/docs/example-agents/benny.md +2 -0
  142. package/docs/example-agents/bugbot.md +3 -0
  143. package/docs/example-agents/codebase-wiki.md +2 -0
  144. package/docs/example-agents/codeowners-review.md +2 -0
  145. package/docs/example-agents/concierge.md +1 -0
  146. package/docs/example-agents/fsd.md +1 -0
  147. package/docs/example-agents/knowledge-base.md +2 -0
  148. package/docs/example-agents/oncall.md +2 -0
  149. package/docs/example-agents/slack-agent.md +1 -0
  150. package/docs/example-agents/weather-agent.md +9 -4
  151. package/docs/guides/cloud-runtime.md +11 -4
  152. package/docs/guides/webhooks.md +1 -1
  153. package/docs/hillclimbing.md +1 -1
  154. package/docs/quickstart.md +39 -7
  155. package/docs/reference/agent-config.md +74 -14
  156. package/docs/reference/artifacts.md +117 -0
  157. package/docs/reference/channels.md +45 -15
  158. package/docs/reference/cli.md +141 -20
  159. package/docs/reference/hooks.md +11 -4
  160. package/docs/reference/http-api.md +50 -4
  161. package/docs/reference/project-layout.md +6 -0
  162. package/docs/reference/sessions.md +5 -4
  163. package/docs/reference/subagents.md +5 -3
  164. package/docs/reference/tools.md +23 -7
  165. package/docs/scaffolding-agents.md +11 -2
  166. package/docs/storage.md +27 -2
  167. package/package.json +1 -1
  168. package/src/channels/github/github-channel.ts +1 -1
  169. package/src/channels/github/index.ts +1 -1
  170. package/src/channels/slack/api.ts +1 -1
  171. package/src/channels/slack/index.ts +1 -1
  172. package/src/channels/slack/init.ts +2 -1
  173. package/src/files-backends/agent-store-presigned-url.ts +2 -1
  174. package/src/internal/cli-github.ts +8 -7
  175. package/src/internal/cli-slack.ts +9 -9
  176. package/src/internal/event-mapper.ts +9 -4
  177. package/src/internal/session-engine.ts +3 -3
  178. package/src/internal/workspace.ts +15 -11
  179. package/dist/docs/assets/chunks/@localSearchIndexroot.Cu7b6o1D.js +0 -1
  180. package/dist/docs/assets/guides_cloud-runtime.md.CDJGvVC4.js +0 -9
  181. package/dist/docs/assets/guides_cloud-runtime.md.CDJGvVC4.lean.js +0 -1
  182. package/dist/docs/assets/index.md.CZqbBJPB.js +0 -20
  183. package/dist/docs/assets/reference_http-api.md.CfVM_ICa.js +0 -11
  184. package/dist/docs/assets/reference_http-api.md.CfVM_ICa.lean.js +0 -1
  185. package/dist/docs/assets/scaffolding-agents.md.Bsr9Pwzu.js +0 -1
  186. package/dist/playground/assets/index-DOb96C0M.css +0 -1
  187. /package/dist/docs/assets/{building-with-agents.md.CnHqvYDd.lean.js → building-with-agents.md.txrcGU2B.lean.js} +0 -0
  188. /package/dist/docs/assets/{concepts.md.DFaQEFkA.lean.js → concepts.md.CqOsxbMU.lean.js} +0 -0
  189. /package/dist/docs/assets/{deployment.md.9MYBuKM1.lean.js → deployment.md.CuK5SNjN.lean.js} +0 -0
  190. /package/dist/docs/assets/{example-agents_approval-buddy.md.BhEfleVx.lean.js → example-agents_approval-buddy.md.CIiZ9coo.lean.js} +0 -0
  191. /package/dist/docs/assets/{example-agents_benny.md.2Et1qa8f.lean.js → example-agents_benny.md.l7JTmm8X.lean.js} +0 -0
  192. /package/dist/docs/assets/{example-agents_fsd.md.DfNKQTHz.lean.js → example-agents_fsd.md.DPz9ezO4.lean.js} +0 -0
  193. /package/dist/docs/assets/{example-agents_knowledge-base.md.CzyZ2DCr.lean.js → example-agents_knowledge-base.md.IneynQSR.lean.js} +0 -0
  194. /package/dist/docs/assets/{example-agents_oncall.md.wFFXXEyW.lean.js → example-agents_oncall.md.ZE0n6ZFN.lean.js} +0 -0
  195. /package/dist/docs/assets/{example-agents_slack-agent.md.DvgvT4nn.lean.js → example-agents_slack-agent.md.06jQXTAI.lean.js} +0 -0
  196. /package/dist/docs/assets/{guides_webhooks.md.DiAwSR42.lean.js → guides_webhooks.md.BERuBSJW.lean.js} +0 -0
  197. /package/dist/docs/assets/{hillclimbing.md.D9Y1_bYh.lean.js → hillclimbing.md.yXqdlv2R.lean.js} +0 -0
  198. /package/dist/docs/assets/{reference_sessions.md.C_ouF_uf.lean.js → reference_sessions.md.DBVFi2Sx.lean.js} +0 -0
@@ -91,6 +91,7 @@ export function buildAgentToolsCatalog(tools, options = { includeScripts: false
91
91
  "",
92
92
  "These tools run in the agent environment (not on the agent-serve host).",
93
93
  "Pass a JSON object on stdin matching the input schema; read the result from stdout.",
94
+ "Only the tools in this section are scripts. Do not create, edit, or run a script for any other tool name.",
94
95
  "",
95
96
  ];
96
97
  for (const tool of agentTools) {
@@ -129,10 +130,10 @@ export function buildAgentToolsCatalog(tools, options = { includeScripts: false
129
130
  *
130
131
  * Server tools execute on the serve host and reach cloud turns only as MCP
131
132
  * tools on {@link SERVER_TOOLS_MCP_SERVER_NAME}. Instructions reference them
132
- * by bare name, and the agent-tool catalog teaches a "recreate the script if
133
- * missing" pattern without this section a cloud model that cannot find a
134
- * script for a server tool improvises a local substitute instead of calling
135
- * the real tool, so its host-side effects silently never happen.
133
+ * by bare name. The agent-tool catalog still teaches "write the script if
134
+ * missing" for *agent* tools; this section must come first on cloud and
135
+ * say that server tools are MCP-only, or the model copies that recipe onto
136
+ * a host tool and the host-side marker never appears.
136
137
  */
137
138
  export function buildServerToolsCatalog(tools, options) {
138
139
  const serverTools = tools.filter((tool) => tool.execution === "server");
@@ -142,8 +143,9 @@ export function buildServerToolsCatalog(tools, options) {
142
143
  const parts = [
143
144
  "## Server tools",
144
145
  "",
145
- `These tools execute on the agent-serve host, not in this environment. They are available ONLY as MCP tools on the \`${options.mcpServerName}\` MCP server — list that server's tools and call them by name through your MCP tooling.`,
146
- "There are no local scripts for these tools. NEVER create, edit, or run a local script or other substitute for them: a local re-implementation cannot produce their real effects on the host.",
146
+ `These tools execute on the agent-serve host, not in this environment. They are available ONLY as MCP tools on the \`${options.mcpServerName}\` MCP server.`,
147
+ "Call them through your MCP tooling: list that server's tools, then invoke the tool by its exact name (GetMcpTools / CallMcpTool, or the equivalent). There is no `.agent-serve/tools/<name>.sh` for any tool in this section.",
148
+ `If the \`${options.mcpServerName}\` server is not in your MCP server list, stop and report that. Do not write, edit, or run a local script or other substitute. A local re-implementation cannot produce the host-side marker, logs, or session events.`,
147
149
  "",
148
150
  ];
149
151
  for (const tool of serverTools) {
@@ -169,8 +171,10 @@ export function buildServerToolsCatalog(tools, options) {
169
171
  *
170
172
  * `serverToolsMcpName` is cloud-only: when the turn's MCP config carries the
171
173
  * session-bound server-tool endpoint, the catalog names that server so the
172
- * model calls the real tools instead of inventing local stand-ins. Local
173
- * runtimes omit it there the harness exposes server tools natively.
174
+ * model calls the real tools instead of inventing local stand-ins. It is
175
+ * emitted *before* the agent-tool catalog so "write the script if missing"
176
+ * cannot be read as applying to server-tool names. Local runtimes omit it —
177
+ * there the harness exposes server tools natively.
174
178
  */
175
179
  export function buildAgentsMdContent(agent, options) {
176
180
  var _a;
@@ -178,14 +182,14 @@ export function buildAgentsMdContent(agent, options) {
178
182
  return [
179
183
  (_b = (_a = agent.instructions) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : "",
180
184
  buildIdentitySection(agent),
181
- buildAgentToolsCatalog(agent.tools, {
182
- includeScripts: options.includeScripts,
183
- }),
184
185
  options.serverToolsMcpName === undefined
185
186
  ? ""
186
187
  : buildServerToolsCatalog(agent.tools, {
187
188
  mcpServerName: options.serverToolsMcpName,
188
189
  }),
190
+ buildAgentToolsCatalog(agent.tools, {
191
+ includeScripts: options.includeScripts,
192
+ }),
189
193
  ]
190
194
  .filter((part) => part !== "")
191
195
  .join("\n\n");