effect-cursor-sdk 0.3.4 → 0.4.1

package/DEPRECATIONS.md

@@ -1,88 +1,5 @@
 # Deprecations
 
-This document lists deprecated `effect-cursor-sdk` APIs, what to use instead today, and how names are expected to change in the **next major** release. Deprecated APIs remain available until that major; follow [CHANGELOG.md](./CHANGELOG.md) and release notes when upgrading.
+There are currently **no deprecations** in this version of `effect-cursor-sdk`.
 
-## Status definitions
-
-| Status                 | Meaning                                                                                              |
-| ---------------------- | ---------------------------------------------------------------------------------------------------- |
-| **Deprecated**         | Still supported; avoid in new code. May show IDE warnings via TSDoc `@deprecated`.                   |
-| **Preferred now**      | Current recommended API; use with [`loadCursorConfig`](./README.md#quick-start) and related helpers. |
-| **Planned next major** | Intended replacement names after deprecated overloads and `*FromConfig` suffixes are removed.        |
-
-## Agent entry: plain `AgentOptions` vs config-first
-
-Passing raw [`AgentOptions`](https://cursor.com/docs/sdk/typescript) (including a plain `apiKey` string) directly to `CursorAgentService` agent entry points is **deprecated**. Prefer loading `CursorConfig` with `loadCursorConfig` (exported from this package) and using the `*FromConfig` methods so secrets stay [`Redacted`](https://effect.website/docs/schema/redacted/) until merged for the SDK boundary.
-
-### API mapping
-
-| Deprecated (`CursorAgentService`) | Preferred now                                   | Planned next major (same signatures as “Preferred now”) |
-| --------------------------------- | ----------------------------------------------- | ------------------------------------------------------- |
-| `create(options)`                 | `createFromConfig(config, overrides?)`          | `create(config, overrides?)`                            |
-| `resume(agentId, options?)`       | `resumeFromConfig(agentId, config, overrides?)` | `resume(agentId, config, overrides?)`                   |
-| `prompt(message, options?)`       | `promptFromConfig(message, config, overrides?)` | `prompt(message, config, overrides?)`                   |
-| `scoped(options)`                 | `scopedFromConfig(config, overrides?)`          | `scoped(config, overrides?)`                            |
-
-The `*FromConfig` suffixes exist today to keep deprecated plain-`AgentOptions` entry points without breaking callers. After removal of the legacy forms, the shorter names above are the intended stable surface.
-
-### Migrate `create`
-
-**Before (deprecated):**
-
-```ts
-const agent =
-  yield *
-  agents.create({
-    apiKey: process.env.CURSOR_API_KEY,
-    model: { id: "composer-2" },
-    local: { cwd: process.cwd() },
-  });
-```
-
-**After (preferred):**
-
-```ts
-const config = yield * loadCursorConfig;
-const agent =
-  yield *
-  agents.createFromConfig(config, {
-    model: { id: "composer-2" },
-    local: { cwd: process.cwd() },
-  });
-```
-
-If you need full control over merging into SDK options, call `agentOptionsFromConfig(config, overrides)` and pass the result only through internal or transitional code paths; application code should still prefer `createFromConfig`.
-
-### Migrate `prompt`
-
-**Before (deprecated):**
-
-```ts
-const result =
-  yield *
-  agents.prompt("Summarize the README", {
-    apiKey: process.env.CURSOR_API_KEY,
-    model: { id: "composer-2" },
-  });
-```
-
-**After (preferred):**
-
-```ts
-const config = yield * loadCursorConfig;
-const result =
-  yield *
-  agents.promptFromConfig("Summarize the README", config, {
-    model: { id: "composer-2" },
-  });
-```
-
-## Other deprecations
-
-`CursorSdkFactory` exposes raw SDK-style `create` / `resume` / `prompt` helpers for tests and advanced wiring; those are **deprecated for application code** in favor of `CursorAgentService` with the config-first flow above. See TSDoc on `CursorSdkFactory` in the published types.
-
-## Where else this is documented
-
-- [README.md](./README.md) — quick summary and link here.
-- Package root ships this file next to `README.md` on npm (see `package.json` `files`).
-- Per-symbol `@deprecated` tags on `CursorAgentService` and related exports in the TypeScript declarations.
+For historical breaking changes and release notes, see [CHANGELOG.md](./CHANGELOG.md).

package/README.md

@@ -8,9 +8,6 @@ Effect-native access to the new [Cursor SDK](https://cursor.com/docs/sdk/typescr
 
 If you want to build with Cursor agents, and you are using Effect, this package is for you.
 
-> [!WARNING]
-> This project is in early development. While all functionality is available, there is still much room for improvement. Contributions are welcome!
-
 ## Philosophy
 
 - SDK-first: every public `@cursor/sdk` capability should be usable through this package.
@@ -25,7 +22,6 @@ If you want to build with Cursor agents, and you are using Effect, this package
 - [SDK coverage & compatibility](./docs/SDK_COVERAGE.md) — wrapper checklist, audit script, release alignment
 - [Recipes](./docs/RECIPES.md) — short patterns (config-first agent, streaming, pagination, lifecycle, tests)
 - [Release checklist](./docs/RELEASE_CHECKLIST.md) — gates, SDK bumps, Changesets
-- [Next major migration (planned)](./docs/MIGRATION_NEXT_MAJOR.md) — config-first renames after deprecations are removed
 
 ## Feature Coverage
 
@@ -38,7 +34,7 @@ If you want to build with Cursor agents, and you are using Effect, this package
 | `Agent.list`, `get`, `listRuns`, `getRun`, messages                              | `CursorInspectionService`                      |
 | `Agent.archive`, `unarchive`, `delete`                                           | `CursorInspectionService`                      |
 | `Cursor.me`, models, repositories                                                | `CursorInspectionService`                      |
-| MCP servers, sub-agents, local/cloud options, model options                      | Defaults via `CursorConfig` / `loadCursorConfig`; merged SDK `AgentOptions` ([deprecated](./DEPRECATIONS.md) at agent entry) |
+| MCP servers, sub-agents, local/cloud options, model options                      | Defaults via `CursorConfig` / `loadCursorConfig`; merged into SDK `AgentOptions` at the boundary |
 | Local run event helpers and platform helpers                                     | Re-exported from `@cursor/sdk`                 |
 
 ## Use cases
@@ -53,6 +49,28 @@ If you are new to the Cursor SDK, take a look at the [Cursor SDK Cookbook](https
 bun add effect-cursor-sdk effect @cursor/sdk
 ```
 
+`effect` is a **peer dependency** (Effect v4). `@cursor/sdk` is bundled with this package, but installing it in your app keeps SDK-owned types and versions explicit when you import from `@cursor/sdk` alongside the wrapper.
+
+### Requirements
+
+- **Runtime:** Bun or Node.js (examples and CI use Bun; Node works for library consumers).
+- **Effect:** `^4.0.0-beta` (see [Effect v4](https://effect.website/docs/introduction/overview) — still pre-release on the Effect side).
+- **Cursor SDK:** `@cursor/sdk` `^1.0.x` (pinned in this repo; see [SDK coverage](./docs/SDK_COVERAGE.md) when upgrading).
+
+### Configuration
+
+`loadCursorConfig` reads optional environment variables through Effect’s `ConfigProvider` (by default, `process.env`):
+
+| Variable | Purpose |
+| --- | --- |
+| `CURSOR_API_KEY` | API key for Cursor (stored as `Redacted` until merged into SDK options). |
+| `CURSOR_MODEL` | Default model id (for example `composer-2`). |
+| `CURSOR_LOCAL_CWD` | Default working directory for local agents. |
+
+All fields are optional at load time; missing `CURSOR_API_KEY` logs a warning and later SDK calls fail with authentication errors unless you pass overrides. Per-call overrides still win when using `create`, `scoped`, `prompt`, and `resume`.
+
+For offline tests and CI, use [`mockLayer`](#mocks-and-tests) or `makeMockRuntime` — no API key required.
+
 For development in this repo:
 
 ```bash
@@ -68,7 +86,7 @@ minimal first script to production-style Effect composition:
 
 | Example | What it demonstrates |
 | --- | --- |
-| [`quickstart`](./examples/quickstart) | First config-first local agent call with `loadCursorConfig`, `agentOptionsFromConfig`, and `collectText`. |
+| [`quickstart`](./examples/quickstart) | First config-first local agent call with `loadCursorConfig`, `scoped`, and `collectText`. |
 | [`cli`](./examples/cli) | A small terminal app with `liveRuntime`, offline `makeMockRuntime`, CLI overrides, and tagged error handling. |
 | [`basic-agent-workflow`](./examples/basic-agent-workflow) | Scoped agents, run status listeners, streaming, capability checks, and artifact listing/downloads. |
 | [`advanced-ops-dashboard`](./examples/advanced-ops-dashboard) | Inspection APIs, confirmation-gated lifecycle operations, parallel Effect composition, retries/timeouts, telemetry, redaction, and rich mocks. |
@@ -81,7 +99,7 @@ bun run examples:typecheck
 
 ## Quick Start
 
-Load environment defaults with `loadCursorConfig`, then create agents with `createFromConfig` (and `scopedFromConfig`, `promptFromConfig`, `resumeFromConfig` as needed). The API key stays in `Redacted` form until the merge step; `AgentOptions.apiKey` remains a plain string at the SDK boundary.
+Load environment defaults with `loadCursorConfig`, then create agents with `create` (and `scoped`, `prompt`, `resume` as needed). The API key stays in `Redacted` form until the merge step; `AgentOptions.apiKey` remains a plain string at the SDK boundary.
 
 ```ts
 import {
@@ -97,7 +115,7 @@ const program = Effect.gen(function* () {
   const runs = yield* CursorRunService;
 
   const config = yield* loadCursorConfig;
-  const agent = yield* agents.createFromConfig(config, {
+  const agent = yield* agents.create(config, {
     // Override the given config optionally with custom values
     model: { id: "composer-2" },
     local: { cwd: process.cwd() },
@@ -113,38 +131,11 @@ const program = Effect.gen(function* () {
 
 Effect’s default `ConfigProvider` reads `process.env`, so you usually do not need to install a custom provider for this.
 
-If you need full control over the merge into SDK options, you can still call `agentOptionsFromConfig` yourself and pass the result to deprecated `create`; prefer `createFromConfig` in application code.
-
-## Plain `AgentOptions` at the agent boundary (deprecated)
-
-Passing raw `AgentOptions` (for example `apiKey: process.env.CURSOR_API_KEY`) to `create`, `resume`, `prompt`, or `scoped` is **deprecated**. It still works for compatibility, but prefer the config flow above.
-
-```ts
-import { CursorAgentService, CursorRunService, liveLayer } from "effect-cursor-sdk";
-import { Effect } from "effect";
-
-const legacyProgram = Effect.gen(function* () {
-  const agents = yield* CursorAgentService;
-  const runs = yield* CursorRunService;
-
-  const agent = yield* agents.create({
-    apiKey: process.env.CURSOR_API_KEY,
-    model: { id: "composer-2" },
-    local: { cwd: process.cwd() },
-  });
-
-  const run = yield* agents.send(agent, "Explain this repository");
-  const text = yield* runs.collectText(run);
-  yield* agents.dispose(agent);
-  return text;
-}).pipe(Effect.provide(liveLayer));
-```
-
-Migrate by replacing `agents.create({ ... })` with `const config = yield* loadCursorConfig` and `agents.createFromConfig(config, { ... })` (or the other `*FromConfig` helpers).
+For advanced SDK-factory wiring in tests, you can still call `agentOptionsFromConfig` to merge config into plain `AgentOptions` before passing them to `CursorSdkFactory`.
 
 ## Scoped Agents
 
-Prefer `scopedFromConfig` when an agent should be disposed automatically:
+Prefer `scoped` when an agent should be disposed automatically:
 
 ```ts
 import { CursorAgentService, loadCursorConfig, liveLayer } from "effect-cursor-sdk";
@@ -154,7 +145,7 @@ const program = Effect.scoped(
   Effect.gen(function* () {
     const agents = yield* CursorAgentService;
     const config = yield* loadCursorConfig;
-    const agent = yield* agents.scopedFromConfig(config, {
+    const agent = yield* agents.scoped(config, {
       model: { id: "composer-2" },
       local: { cwd: process.cwd() },
     });
@@ -164,13 +155,24 @@ const program = Effect.scoped(
 ).pipe(Effect.provide(liveLayer));
 ```
 
+## Resume an existing agent
+
+Use `resume` with the agent id from a prior run or from `CursorInspectionService.listAgents`:
+
+```ts
+const config = yield* loadCursorConfig;
+const agent = yield* agents.resume("bc_abc123", config, {
+  local: { cwd: process.cwd() },
+});
+```
+
 ## Cloud Agents
 
 Cloud options are merged as SDK overrides on top of loaded config:
 
 ```ts
 const config = yield* loadCursorConfig;
-const agent = yield* agents.createFromConfig(config, {
+const agent = yield* agents.create(config, {
   model: { id: "composer-2" },
   cloud: {
     repos: [
@@ -206,6 +208,10 @@ yield* runs.streamEvents(run).pipe(
 );
 ```
 
+## Artifacts
+
+List and download run outputs with `CursorArtifactService` after `send` completes. See the [Artifacts recipe](./docs/RECIPES.md#artifacts) for path resolution and download patterns.
+
 ## Inspection And Metadata
 
 Use `CursorInspectionService` for agent/run listings, messages, lifecycle operations, account metadata, model discovery, and connected repositories.
@@ -222,7 +228,7 @@ const repos = yield* inspection.listRepositories();
 
 Because every Cursor call is an `Effect`, you compose it like the rest of your program: parallel requests, timeouts, retries, logging, and layers all work the same way.
 
-This agent garden snapshot loads your catalog in parallel, adds a resilient boundary around the batch, logs a safe summary (counts and IDs only — never log API keys), then asks Cursor for a one-shot triage opinion via `promptFromConfig`:
+This agent garden snapshot loads your catalog in parallel, adds a resilient boundary around the batch, logs a safe summary (counts and IDs only — never log API keys), then asks Cursor for a one-shot triage opinion via `prompt`:
 
 ```ts
 import {
@@ -258,7 +264,7 @@ const agentGardenSnapshot = Effect.gen(function* () {
     repos: catalog.repos.length,
   });
 
-  const triage = yield* agents.promptFromConfig(
+  const triage = yield* agents.prompt(
     [
       "You are helping on-call. Here is non-secret inventory:",
       `- Cloud agents (ids): ${catalog.cloud.items.map((a) => a.agentId).join(", ") || "(none)"}`,
@@ -310,7 +316,7 @@ import { Effect } from "effect";
 const testProgram = Effect.gen(function* () {
   const agents = yield* CursorAgentService;
   const config = yield* loadCursorConfig;
-  const agent = yield* agents.createFromConfig(config, { model: { id: "composer-2" } });
+  const agent = yield* agents.create(config, { model: { id: "composer-2" } });
   return yield* agents.send(agent, "Hello");
 }).pipe(
   Effect.provide(
@@ -327,11 +333,11 @@ The main exports are:
 
 - **Recipes** — common compositions (prompt text, send + collect, pagination, lifecycle guards, artifacts) in [RECIPES.md](./docs/RECIPES.md)
 - **Observability helpers** (`streamEventsTracked`, `collectTextTracked`, catalog retry/timeout presets, log summaries)
-- `CursorAgentService` (prefer `createFromConfig`, `scopedFromConfig`, `promptFromConfig`, `resumeFromConfig` with `loadCursorConfig`; plain `AgentOptions` at the agent boundary is [deprecated](./DEPRECATIONS.md))
+- `CursorAgentService` (`create`, `scoped`, `prompt`, `resume` with `loadCursorConfig`)
 - `CursorRunService`
 - `CursorArtifactService`
 - `CursorInspectionService`
-- `CursorSdkFactory` ([deprecated for application code](./DEPRECATIONS.md#other-deprecations); low-level tests and overrides)
+- `CursorSdkFactory` (low-level SDK adapter for tests and advanced overrides)
 - `liveLayer`, `mockLayer`, `liveRuntime`, `makeMockRuntime`
 - `CursorConfig`, `cursorConfig`, `agentOptionsFromConfig`, `loadCursorConfig`
 - tagged Cursor error classes and `mapCursorError`
@@ -358,7 +364,7 @@ Coverage is measured with Vitest v8 coverage. The suite focuses on deterministic
 
 ## Deprecations
 
-Whenever you need a single place for what is deprecated, what to use instead, how to migrate, and what may change in the next major (when that is already decided), read **[DEPRECATIONS.md](./DEPRECATIONS.md)**. Pair it with **[CHANGELOG.md](./CHANGELOG.md)** for release-by-release notes; `@deprecated` tags on exported symbols mirror the same intent for day-to-day coding.
+See **[DEPRECATIONS.md](./DEPRECATIONS.md)** for the canonical list of deprecated APIs. Pair it with **[CHANGELOG.md](./CHANGELOG.md)** for release-by-release notes.
 
 ## Versioning and Publishing
 

package/dist/index.d.ts

@@ -206,11 +206,10 @@ declare const CursorConfig_base: Schema.Class<CursorConfig, Schema.Struct<{
  * {@link AgentOptions} at the SDK boundary.
  *
  * @remarks
- * **Preferred path:** Load defaults with {@link loadCursorConfig}, then call
- * `CursorAgentService` methods such as `createFromConfig` (and related helpers)
- * or merge manually with {@link agentOptionsFromConfig}. Passing plain
- * {@link AgentOptions} directly to deprecated `create` / `resume` / `prompt` /
- * `scoped` overloads may be removed in a future major version.
+ * Load defaults with {@link loadCursorConfig}, then call
+ * `CursorAgentService` methods such as `create`, `resume`, `prompt`, and
+ * `scoped`, or merge manually with {@link agentOptionsFromConfig} for advanced
+ * SDK-factory wiring.
  *
  * @example
  * ```ts
@@ -254,7 +253,7 @@ declare const cursorConfig: Config.Config<{
  * Build SDK `AgentOptions` from wrapper config and optional overrides.
  *
  * This is the adapter from typed, redacted {@link CursorConfig} to the SDK's
- * plain-string `apiKey` boundary. Prefer `CursorAgentService.createFromConfig`
+ * plain-string `apiKey` boundary. Prefer `CursorAgentService.create`
  * (and related methods) over building {@link AgentOptions} by hand.
  *
  * @param config - Wrapper-owned environment defaults.
@@ -276,7 +275,7 @@ declare const cursorConfig: Config.Config<{
  * @remarks
  * Explicit override values always win over environment-derived defaults.
  * For application code, prefer service methods that take {@link CursorConfig}
- * instead of calling this helper and then the deprecated `create` overload.
+ * instead of calling this helper directly.
  *
  * @category config
  */
@@ -288,7 +287,7 @@ declare const agentOptionsFromConfig: (config: CursorConfig, overrides?: AgentOp
  * from {@link cursorConfig}.
  * Omitting `CURSOR_API_KEY` only means no default API-key-based auth will be
  * set; callers can still provide credentials via {@link agentOptionsFromConfig}
- * overrides or the `*FromConfig` service helpers.
+ * overrides or the config-first service helpers on {@link CursorAgentService}.
  *
  * If the API key is not set, it will log a warning message.
  *
@@ -299,7 +298,7 @@ declare const agentOptionsFromConfig: (config: CursorConfig, overrides?: AgentOp
  * ```ts
  * const config = yield* loadCursorConfig
  * const options = agentOptionsFromConfig(config, { local: { cwd: process.cwd() } })
- * // Or use CursorAgentService.createFromConfig(config, { local: { cwd: process.cwd() } })
+ * // Or use CursorAgentService.create(config, { local: { cwd: process.cwd() } })
  * ```
  *
  * To change the way that the environment variables are loaded,
@@ -327,7 +326,7 @@ declare const agentOptionsFromConfig: (config: CursorConfig, overrides?: AgentOp
  * @remarks
  * This effect is the preferred entry for redacted environment defaults.
  * Pair it with {@link agentOptionsFromConfig} or `CursorAgentService` helpers
- * such as `createFromConfig`.
+ * such as `create`, `resume`, `prompt`, and `scoped`.
  *
  * @category config
  */
@@ -364,29 +363,19 @@ declare const loadCursorConfig: Effect.Effect<CursorConfig, Config.ConfigError,
  * @see {@link CursorArtifactService} for artifact APIs on an SDK agent.
  *
  * @remarks
- * **Deprecated for application code:** `create`, `resume`, and `prompt` accept
- * raw {@link AgentOptions} (including a plain `apiKey` string). Prefer
- * {@link CursorAgentService} with `loadCursorConfig` and `createFromConfig` /
- * `resumeFromConfig` / `promptFromConfig` from this package instead.
- * This factory remains the low-level adapter for tests and advanced overrides.
+ * Application code should use {@link CursorAgentService} with
+ * {@link loadCursorConfig} and config-first `create` / `resume` / `prompt` /
+ * `scoped` helpers. This factory remains the low-level adapter for tests and
+ * advanced overrides.
  *
  * @category services
  */
 interface CursorSdkFactoryShape {
-  /**
-   * @deprecated Prefer {@link CursorAgentService} with config-based helpers.
-   * Low-level adapter to `Agent.create`.
-   */
+  /** Low-level adapter to `Agent.create`. */
   readonly create: (options: AgentOptions) => Promise<SDKAgent>;
-  /**
-   * @deprecated Prefer {@link CursorAgentService} with config-based helpers.
-   * Low-level adapter to `Agent.resume`.
-   */
+  /** Low-level adapter to `Agent.resume`. */
   readonly resume: (agentId: string, options?: Partial<AgentOptions>) => Promise<SDKAgent>;
-  /**
-   * @deprecated Prefer {@link CursorAgentService} with config-based helpers.
-   * Low-level adapter to `Agent.prompt`.
-   */
+  /** Low-level adapter to `Agent.prompt`. */
   readonly prompt: (message: string, options?: AgentOptions) => Promise<RunResult>;
   readonly listAgents: (options?: ListAgentsOptions) => Promise<ListResult<SDKAgentInfo>>;
   readonly listRuns: (agentId: string, options?: ListRunsOptions) => Promise<ListResult<Run>>;
@@ -432,80 +421,46 @@ declare class CursorSdkFactory extends CursorSdkFactory_base {
  * Agent lifecycle surface backed by the Cursor SDK.
  *
  * @remarks
- * Prefer {@link loadCursorConfig} with {@link CursorAgentServiceShape.createFromConfig},
- * {@link CursorAgentServiceShape.resumeFromConfig},
- * {@link CursorAgentServiceShape.promptFromConfig}, and
- * {@link CursorAgentServiceShape.scopedFromConfig}
+ * Use {@link loadCursorConfig} with {@link CursorAgentServiceShape.create},
+ * {@link CursorAgentServiceShape.resume},
+ * {@link CursorAgentServiceShape.prompt}, and
+ * {@link CursorAgentServiceShape.scoped}
  * so secrets stay in `Redacted` form until {@link agentOptionsFromConfig}
- * merges into SDK {@link AgentOptions}. Plain {@link AgentOptions} entry points
- * are deprecated; see `DEPRECATIONS.md` and the README at the package root.
+ * merges into SDK {@link AgentOptions} at the SDK boundary.
  */
 interface CursorAgentServiceShape {
-  /**
-   * @deprecated Prefer {@link CursorAgentServiceShape.createFromConfig} with {@link loadCursorConfig}
-   * instead of raw {@link AgentOptions} (including a plain `apiKey` string). Next major: `createFromConfig`
-   * is planned to become `create` with the same parameters.
-   */
-  readonly create: (options: AgentOptions) => Effect.Effect<SDKAgent, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
   /**
    * Create an agent from {@link CursorConfig} and optional SDK overrides.
    *
-   * @remarks
-   * Next major: planned rename to `create` with the same signature once plain-`AgentOptions` entry points are removed.
-   *
    * @see {@link loadCursorConfig}
    * @see {@link agentOptionsFromConfig}
    */
-  readonly createFromConfig: (config: CursorConfig, overrides?: AgentOptions) => Effect.Effect<SDKAgent, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
-  /**
-   * @deprecated Prefer {@link CursorAgentServiceShape.resumeFromConfig} with {@link loadCursorConfig}
-   * instead of raw {@link AgentOptions}. Next major: `resumeFromConfig` is planned to become `resume` with the same parameters.
-   */
-  readonly resume: (agentId: string, options?: Partial<AgentOptions>) => Effect.Effect<SDKAgent, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
+  readonly create: (config: CursorConfig, overrides?: AgentOptions) => Effect.Effect<SDKAgent, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
   /**
    * Resume an agent from {@link CursorConfig} and optional SDK overrides.
    *
-   * @remarks
-   * Next major: planned rename to `resume` with the same signature once plain-`AgentOptions` entry points are removed.
-   *
    * @see {@link loadCursorConfig}
    * @see {@link agentOptionsFromConfig}
    */
-  readonly resumeFromConfig: (agentId: string, config: CursorConfig, overrides?: AgentOptions) => Effect.Effect<SDKAgent, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
-  /**
-   * @deprecated Prefer {@link CursorAgentServiceShape.promptFromConfig} with {@link loadCursorConfig}
-   * instead of raw {@link AgentOptions}. Next major: `promptFromConfig` is planned to become `prompt` with the same parameters.
-   */
-  readonly prompt: (message: string, options?: AgentOptions) => Effect.Effect<RunResult, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
+  readonly resume: (agentId: string, config: CursorConfig, overrides?: AgentOptions) => Effect.Effect<SDKAgent, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
   /**
    * One-shot prompt from {@link CursorConfig} and optional SDK overrides.
    *
-   * @remarks
-   * Next major: planned rename to `prompt` with the same signature once plain-`AgentOptions` entry points are removed.
-   *
    * @see {@link loadCursorConfig}
    * @see {@link agentOptionsFromConfig}
    */
-  readonly promptFromConfig: (message: string, config: CursorConfig, overrides?: AgentOptions) => Effect.Effect<RunResult, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
+  readonly prompt: (message: string, config: CursorConfig, overrides?: AgentOptions) => Effect.Effect<RunResult, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
   readonly send: (agent: SDKAgent, message: string | SDKUserMessage, options?: SendOptions) => Effect.Effect<Run, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
   readonly reload: (agent: SDKAgent) => Effect.Effect<void, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
   readonly close: (agent: SDKAgent) => Effect.Effect<void>;
   readonly dispose: (agent: SDKAgent) => Effect.Effect<void, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError>;
-  /**
-   * @deprecated Prefer {@link CursorAgentServiceShape.scopedFromConfig} with {@link loadCursorConfig}
-   * instead of raw {@link AgentOptions}. Next major: `scopedFromConfig` is planned to become `scoped` with the same parameters.
-   */
-  readonly scoped: (options: AgentOptions) => Effect.Effect<SDKAgent, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError, Scope.Scope>;
   /**
    * Acquire an agent in a scope from {@link CursorConfig} and optional SDK overrides.
    *
-   * @remarks
-   * Next major: planned rename to `scoped` with the same signature once plain-`AgentOptions` entry points are removed.
-   *
    * @see {@link loadCursorConfig}
    * @see {@link agentOptionsFromConfig}
    */
-  readonly scopedFromConfig: (config: CursorConfig, overrides?: AgentOptions) => Effect.Effect<SDKAgent, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError, Scope.Scope>;
+  readonly scoped: (config: CursorConfig, overrides?: AgentOptions) => Effect.Effect<SDKAgent, CursorAuthenticationError | CursorRateLimitError | CursorIntegrationNotConnectedError | CursorConfigurationError | CursorAgentBusyError | CursorNetworkError | CursorUnknownError, Scope.Scope>;
 }
 declare const CursorAgentService_base: Context.ServiceClass<CursorAgentService, "effect-cursor-sdk/cursor-agent/CursorAgentService", CursorAgentServiceShape>;
 /**
@@ -523,7 +478,7 @@ declare const CursorAgentService_base: Context.ServiceClass<CursorAgentService,
  * const program = Effect.gen(function*() {
  *   const agents = yield* CursorAgentService
  *   const config = yield* loadCursorConfig
- *   const agent = yield* agents.createFromConfig(config, {
+ *   const agent = yield* agents.create(config, {
  *     model: { id: "composer-2" },
  *     local: { cwd: process.cwd() },
  *   })
@@ -535,11 +490,9 @@ declare const CursorAgentService_base: Context.ServiceClass<CursorAgentService,
  * @see {@link CursorSdkFactory} for replacing SDK construction in tests.
  *
  * @remarks
- * Prefer {@link CursorAgentServiceShape.createFromConfig} and related methods
- * with {@link loadCursorConfig}; raw {@link AgentOptions} on
- * {@link CursorAgentServiceShape.create} and siblings are deprecated.
- * See `DEPRECATIONS.md` at the package root for migration and planned next-major renames
- * (`createFromConfig` → `create`, etc.).
+ * Load defaults with {@link loadCursorConfig}, then call {@link CursorAgentServiceShape.create},
+ * {@link CursorAgentServiceShape.resume}, {@link CursorAgentServiceShape.prompt}, or
+ * {@link CursorAgentServiceShape.scoped} with optional SDK overrides.
  *
  * @category services
  */
@@ -974,7 +927,7 @@ declare class CursorRunService extends CursorRunService_base {
  *
  * @category layers
  */
-declare const liveLayer: Layer.Layer<CursorAgentService | CursorSdkFactory | CursorArtifactService | CursorInspectionService | CursorRunService, never, never>;
+declare const liveLayer: Layer.Layer<CursorSdkFactory | CursorInspectionService | CursorAgentService | CursorRunService | CursorArtifactService, never, never>;
 /**
  * Deterministic mock layer for tests and examples.
  *
@@ -992,7 +945,7 @@ declare const liveLayer: Layer.Layer<CursorAgentService | CursorSdkFactory | Cur
  *
  * @category layers
  */
-declare const mockLayer: (fixtures?: CursorMockFixtures) => Layer.Layer<CursorAgentService | CursorSdkFactory | CursorArtifactService | CursorInspectionService | CursorRunService, never, never>;
+declare const mockLayer: (fixtures?: CursorMockFixtures) => Layer.Layer<CursorSdkFactory | CursorInspectionService | CursorAgentService | CursorRunService | CursorArtifactService, never, never>;
 /**
  * Ready-made live runtime.
  *
@@ -1008,7 +961,7 @@ declare const mockLayer: (fixtures?: CursorMockFixtures) => Layer.Layer<CursorAg
  *
  * @category runtimes
  */
-declare const liveRuntime: ManagedRuntime.ManagedRuntime<CursorAgentService | CursorSdkFactory | CursorArtifactService | CursorInspectionService | CursorRunService, never>;
+declare const liveRuntime: ManagedRuntime.ManagedRuntime<CursorSdkFactory | CursorInspectionService | CursorAgentService | CursorRunService | CursorArtifactService, never>;
 /**
  * Ready-made mock runtime.
  *
@@ -1025,7 +978,7 @@ declare const liveRuntime: ManagedRuntime.ManagedRuntime<CursorAgentService | Cu
  *
  * @category runtimes
  */
-declare const makeMockRuntime: (fixtures?: CursorMockFixtures) => ManagedRuntime.ManagedRuntime<CursorAgentService | CursorSdkFactory | CursorArtifactService | CursorInspectionService | CursorRunService, never>;
+declare const makeMockRuntime: (fixtures?: CursorMockFixtures) => ManagedRuntime.ManagedRuntime<CursorSdkFactory | CursorInspectionService | CursorAgentService | CursorRunService | CursorArtifactService, never>;
 //#endregion
 //#region src/cursor-telemetry.d.ts
 /**