@cursor/july 0.1.75 → 0.1.78

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 (143) hide show
  1. package/dist/channels/origin/origin-webhook.d.ts +23 -2
  2. package/dist/channels/origin/origin-webhook.d.ts.map +1 -1
  3. package/dist/channels/origin/origin-webhook.js +82 -20
  4. package/dist/docs/404.html +2 -2
  5. package/dist/docs/ab.html +3 -3
  6. package/dist/docs/assets/{app.b8bhB2SV.js → app.BsA7t7rS.js} +1 -1
  7. package/dist/docs/assets/chunks/@localSearchIndexroot.Dcs6boxD.js +1 -0
  8. package/dist/docs/assets/chunks/{VPLocalSearchBox.lLSeIyWw.js → VPLocalSearchBox.B1hHhktM.js} +1 -1
  9. package/dist/docs/assets/chunks/{theme.C_owesa-.js → theme.DLpLSsQh.js} +2 -2
  10. package/dist/docs/assets/{storage.md.D8NQ389l.js → storage.md.ks1u64_R.js} +3 -3
  11. package/dist/docs/assets/storage.md.ks1u64_R.lean.js +1 -0
  12. package/dist/docs/building-with-agents.html +3 -3
  13. package/dist/docs/concepts.html +3 -3
  14. package/dist/docs/deployment.html +3 -3
  15. package/dist/docs/evals.html +3 -3
  16. package/dist/docs/example-agents/approval-buddy.html +3 -3
  17. package/dist/docs/example-agents/benny.html +3 -3
  18. package/dist/docs/example-agents/bugbot.html +3 -3
  19. package/dist/docs/example-agents/codebase-wiki.html +3 -3
  20. package/dist/docs/example-agents/codeowners-review.html +3 -3
  21. package/dist/docs/example-agents/concierge.html +3 -3
  22. package/dist/docs/example-agents/fsd.html +3 -3
  23. package/dist/docs/example-agents/index.html +3 -3
  24. package/dist/docs/example-agents/knowledge-base.html +3 -3
  25. package/dist/docs/example-agents/oncall.html +3 -3
  26. package/dist/docs/example-agents/security-reviewer.html +3 -3
  27. package/dist/docs/example-agents/slack-agent.html +3 -3
  28. package/dist/docs/example-agents/weather-agent.html +3 -3
  29. package/dist/docs/guides/agent-to-agent.html +3 -3
  30. package/dist/docs/guides/cloud-runtime.html +3 -3
  31. package/dist/docs/guides/convert-automation.html +3 -3
  32. package/dist/docs/guides/github.html +3 -3
  33. package/dist/docs/guides/human-in-the-loop.html +3 -3
  34. package/dist/docs/guides/mcp-oauth.html +3 -3
  35. package/dist/docs/guides/opentelemetry.html +3 -3
  36. package/dist/docs/guides/slack.html +3 -3
  37. package/dist/docs/guides/webhooks.html +3 -3
  38. package/dist/docs/hashmap.json +1 -1
  39. package/dist/docs/hillclimbing.html +3 -3
  40. package/dist/docs/index.html +3 -3
  41. package/dist/docs/quickstart.html +3 -3
  42. package/dist/docs/reference/agent-config.html +3 -3
  43. package/dist/docs/reference/artifacts.html +3 -3
  44. package/dist/docs/reference/channels.html +3 -3
  45. package/dist/docs/reference/cli.html +3 -3
  46. package/dist/docs/reference/connections.html +3 -3
  47. package/dist/docs/reference/hooks.html +3 -3
  48. package/dist/docs/reference/http-api.html +3 -3
  49. package/dist/docs/reference/instructions.html +3 -3
  50. package/dist/docs/reference/playground.html +3 -3
  51. package/dist/docs/reference/project-layout.html +3 -3
  52. package/dist/docs/reference/prompt.html +3 -3
  53. package/dist/docs/reference/schedules.html +3 -3
  54. package/dist/docs/reference/sessions.html +3 -3
  55. package/dist/docs/reference/skills.html +3 -3
  56. package/dist/docs/reference/subagents.html +3 -3
  57. package/dist/docs/reference/tools.html +3 -3
  58. package/dist/docs/scaffolding-agents.html +3 -3
  59. package/dist/docs/storage.html +7 -7
  60. package/dist/docs/templates/agentic-owners.html +3 -3
  61. package/dist/docs/templates/demo.html +3 -3
  62. package/dist/docs/templates/pr-autofixer.html +3 -3
  63. package/dist/docs/templates/security-reviewer.html +3 -3
  64. package/dist/docs/templates/triage.html +3 -3
  65. package/dist/docs/troubleshooting.html +3 -3
  66. package/dist/index.d.ts +0 -1
  67. package/dist/index.d.ts.map +1 -1
  68. package/dist/index.js +0 -1
  69. package/dist/internal/authored-alias-hooks.d.ts +12 -0
  70. package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
  71. package/dist/internal/authored-alias-hooks.js +60 -8
  72. package/dist/internal/authored-loaders.d.ts +5 -3
  73. package/dist/internal/authored-loaders.d.ts.map +1 -1
  74. package/dist/internal/authored-loaders.js +13 -4
  75. package/dist/internal/deployment-scm-event-stream.js +4 -4
  76. package/dist/internal/discovery.d.ts.map +1 -1
  77. package/dist/internal/discovery.js +3 -21
  78. package/dist/internal/distribution.d.ts.map +1 -1
  79. package/dist/internal/distribution.js +0 -1
  80. package/dist/internal/review-comments.d.ts +62 -0
  81. package/dist/internal/review-comments.d.ts.map +1 -1
  82. package/dist/internal/review-comments.js +199 -0
  83. package/dist/internal/session-engine.d.ts +1 -60
  84. package/dist/internal/session-engine.d.ts.map +1 -1
  85. package/dist/internal/session-engine.js +10 -109
  86. package/dist/kv/memory-kv.d.ts +1 -10
  87. package/dist/kv/memory-kv.d.ts.map +1 -1
  88. package/dist/kv/memory-kv.js +1 -10
  89. package/dist/kv.d.ts +2 -3
  90. package/dist/kv.d.ts.map +1 -1
  91. package/dist/kv.js +2 -3
  92. package/dist/playground/assets/index-DJzcIeGt.css +1 -0
  93. package/dist/playground/assets/{index-BJy9UJrF.js → index-K3Sxyx0I.js} +48 -45
  94. package/dist/playground/index.html +2 -2
  95. package/dist/storage-backends/cursor-hosted.js +3 -3
  96. package/dist/storage-protocol.d.ts +3 -8
  97. package/dist/storage-protocol.d.ts.map +1 -1
  98. package/dist/storage-protocol.js +4 -10
  99. package/dist/storage.d.ts +5 -11
  100. package/dist/storage.d.ts.map +1 -1
  101. package/dist/storage.js +3 -4
  102. package/dist/types.d.ts +5 -34
  103. package/dist/types.d.ts.map +1 -1
  104. package/docs/storage.md +11 -44
  105. package/package.json +1 -8
  106. package/src/channels/origin/origin-webhook.ts +111 -25
  107. package/src/index.ts +0 -6
  108. package/src/internal/authored-alias-hooks.ts +75 -7
  109. package/src/internal/authored-loaders.ts +15 -4
  110. package/src/internal/deployment-scm-event-stream.ts +4 -4
  111. package/src/internal/discovery.ts +3 -27
  112. package/src/internal/distribution.ts +0 -1
  113. package/src/internal/review-comments.ts +286 -0
  114. package/src/internal/session-engine.ts +1 -168
  115. package/src/kv/memory-kv.ts +1 -10
  116. package/src/kv.ts +2 -3
  117. package/src/storage-backends/cursor-hosted.ts +3 -3
  118. package/src/storage-protocol.ts +4 -10
  119. package/src/storage.ts +6 -12
  120. package/src/types.ts +5 -35
  121. package/dist/docs/assets/chunks/@localSearchIndexroot.DGZeXVqn.js +0 -1
  122. package/dist/docs/assets/storage.md.D8NQ389l.lean.js +0 -1
  123. package/dist/internal/durable-session-store.d.ts +0 -60
  124. package/dist/internal/durable-session-store.d.ts.map +0 -1
  125. package/dist/internal/durable-session-store.js +0 -131
  126. package/dist/internal/ledger-serving.d.ts +0 -169
  127. package/dist/internal/ledger-serving.d.ts.map +0 -1
  128. package/dist/internal/ledger-serving.js +0 -393
  129. package/dist/ledger/janitor.d.ts +0 -60
  130. package/dist/ledger/janitor.d.ts.map +0 -1
  131. package/dist/ledger/janitor.js +0 -137
  132. package/dist/ledger/session-ledger.d.ts +0 -293
  133. package/dist/ledger/session-ledger.d.ts.map +0 -1
  134. package/dist/ledger/session-ledger.js +0 -614
  135. package/dist/ledger.d.ts +0 -12
  136. package/dist/ledger.d.ts.map +0 -1
  137. package/dist/ledger.js +0 -9
  138. package/dist/playground/assets/index-BrSd5vff.css +0 -1
  139. package/src/internal/durable-session-store.ts +0 -134
  140. package/src/internal/ledger-serving.ts +0 -531
  141. package/src/ledger/janitor.ts +0 -193
  142. package/src/ledger/session-ledger.ts +0 -839
  143. package/src/ledger.ts +0 -44
package/src/storage.ts CHANGED
@@ -7,9 +7,8 @@
7
7
  * only, and eval/A/B history stays in process memory.
8
8
  *
9
9
  * The sink is a plain key-value store — put/get/delete/list, no schema —
10
- * plus a conditional-write group ({@link StorageConfig.cas}, the substrate
11
- * for framework coordination; optional for plain storage, required by
12
- * coordination features). Implementing that small KV core is enough for
10
+ * plus a conditional-write group ({@link StorageConfig.cas}; optional).
11
+ * Implementing that small KV core is enough for
13
12
  * FULL functionality: eval-run and A/B history are derived over the core
14
13
  * when the optional dedicated tables ({@link StorageConfig.evals} and
15
14
  * {@link StorageConfig.abs}) are not authored — those groups exist as
@@ -178,10 +177,7 @@ export interface StorageABTable {
178
177
  /**
179
178
  * Conditional writes (CAS) — the coordination tier of the storage backend
180
179
  * contract. Plain storage works without it, so existing backends keep
181
- * working across a platform upgrade; framework coordination (the upcoming
182
- * session ledger — see `@cursor/july/kv` for the backend-agnostic
183
- * interface) requires it and fails at startup, with an actionable
184
- * message, when the backend lacks it. The built-in backends all include
180
+ * working across a platform upgrade. The built-in backends all include
185
181
  * it, so implementing this group yourself only comes up for BYO storage.
186
182
  *
187
183
  * Grouped under {@link StorageConfig.cas} rather than as loose methods —
@@ -243,10 +239,8 @@ export interface StorageConfig {
243
239
  abs?: StorageABTable;
244
240
  /**
245
241
  * Conditional writes (CAS). Optional for plain storage — existing
246
- * backends keep working without it but required by coordination
247
- * features (the session ledger), which fail fast when it is absent.
248
- * The built-in backends (`fileKv`, `cursorHostedStorage`) both include
249
- * it. See {@link StorageCasTable}.
242
+ * backends keep working without it. The built-in backends (`fileKv`,
243
+ * `cursorHostedStorage`) both include it. See {@link StorageCasTable}.
250
244
  */
251
245
  cas?: StorageCasTable;
252
246
  /**
@@ -321,7 +315,7 @@ export function defineStorage(config: StorageConfig): StorageDefinition {
321
315
  ] as const;
322
316
  const cas = config.cas;
323
317
  // A partial group is a bug, not a legacy config: half-implemented CAS
324
- // would pass the capability probe and corrupt coordination.
318
+ // would pass the capability probe.
325
319
  const missingCasHooks = casHooks.filter(
326
320
  (hook) => typeof cas[hook] !== "function"
327
321
  );
package/src/types.ts CHANGED
@@ -240,31 +240,8 @@ export interface AgentConfig {
240
240
  * it only shapes what the model can call.
241
241
  */
242
242
  tools?: ToolName[];
243
- /**
244
- * How the serve host coordinates event delivery and turn execution. See
245
- * {@link AgentServingMode}. Defaults to `"resident"`; opt in to
246
- * `"ledger"` per agent — rollback is flipping the value back.
247
- */
248
- serving?: AgentServingMode;
249
243
  }
250
244
 
251
- /**
252
- * Serving coordination mode on {@link AgentConfig.serving}.
253
- *
254
- * - `"resident"` (default): the in-process session engine owns delivery —
255
- * today's behavior, unchanged.
256
- * - `"ledger"`: every delivery coordinates through the KV session ledger
257
- * before its turn runs: session identity, a one-writer-per-session
258
- * lease with generation fencing, and a fenced commit sequence.
259
- * Requires a store with conditional writes (the `cas` group on
260
- * `defineStorage`, or an explicit CAS-capable override); startup fails
261
- * fast otherwise. This stage is coordination only — there is no
262
- * durable inbox yet, so an event arriving while the lease is held
263
- * waits in-process and a crash loses it exactly as resident serving
264
- * does. The durable mailbox lands in a follow-up.
265
- */
266
- export type AgentServingMode = "resident" | "ledger";
267
-
268
245
  /**
269
246
  * Built-in tools on {@link AgentConfig.builtinTools}. Each enabled
270
247
  * capability materializes as ordinary server tools at discovery time, so
@@ -596,14 +573,12 @@ export type KvCasResult =
596
573
  | { ok: false; current: KvVersionedEntry | undefined };
597
574
 
598
575
  /**
599
- * Conditional-write superset of {@link HostKvApi} for coordination
600
- * protocols (the upcoming session ledger). Version-token CAS was chosen
601
- * over compare-value: every candidate backend can mint a cheap opaque
602
- * token (counter, UUID, row version), while compare-value would force
603
- * deep JSON equality with key-order pitfalls on each of them. The
576
+ * Conditional-write superset of {@link HostKvApi}. Version-token CAS was
577
+ * chosen over compare-value: every candidate backend can mint a cheap
578
+ * opaque token (counter, UUID, row version), while compare-value would
579
+ * force deep JSON equality with key-order pitfalls on each of them. The
604
580
  * agent-facing `host.kv` stays plain {@link HostKvApi}; storage backends
605
- * supply CAS via the optional `cas` group on `defineStorage`, and
606
- * coordination features fail fast when the backend lacks it.
581
+ * supply CAS via the optional `cas` group on `defineStorage`.
607
582
  */
608
583
  export interface HostKvCasApi extends HostKvApi {
609
584
  /** Read one value with its version token. Miss → `undefined`. */
@@ -2574,11 +2549,6 @@ export interface ResolvedAgent {
2574
2549
  hosting?: AgentHostingOptions;
2575
2550
  /** Validated turn admission limits from {@link AgentConfig.concurrency}. */
2576
2551
  concurrency?: AgentConcurrencyOptions;
2577
- /**
2578
- * Validated serving mode from {@link AgentConfig.serving}. Undefined
2579
- * means `"resident"` (the default path).
2580
- */
2581
- serving?: AgentServingMode;
2582
2552
  tools: DiscoveredTool[];
2583
2553
  skills: DiscoveredSkill[];
2584
2554
  connections: DiscoveredConnection[];