effect-cursor-sdk 0.3.4 → 0.4.1

package/dist/index.js

@@ -149,11 +149,10 @@ const CursorLocalCwd = Schema.String.pipe(Schema.brand("CursorLocalCwd"));
 * {@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
@@ -201,7 +200,7 @@ const cursorConfig = Config.all({
 * 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.
@@ -223,7 +222,7 @@ const cursorConfig = Config.all({
 * @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
 */
@@ -248,7 +247,7 @@ const agentOptionsFromConfig = (config, overrides = {}) => {
 * 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.
 *
@@ -259,7 +258,7 @@ const agentOptionsFromConfig = (config, overrides = {}) => {
 * ```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,
@@ -287,7 +286,7 @@ const agentOptionsFromConfig = (config, overrides = {}) => {
 * @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
 */
@@ -569,7 +568,7 @@ const instrument = (operation, effect) => {
 * 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() },
 *   })
@@ -581,18 +580,16 @@ const instrument = (operation, effect) => {
 * @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
 */
 var CursorAgentService = class CursorAgentService extends Context.Service()("effect-cursor-sdk/cursor-agent/CursorAgentService") {
 	static Live = Layer.effect(CursorAgentService)(Effect.gen(function* () {
 		const sdk = yield* CursorSdkFactory;
-		const create = (options) => {
+		const createWithOptions = (options) => {
 			return instrument("agent.create", Effect.tryPromise({
 				try: () => sdk.create(options),
 				catch: (cause) => {
@@ -600,7 +597,7 @@ var CursorAgentService = class CursorAgentService extends Context.Service()("eff
 				}
 			}));
 		};
-		const resume = (agentId, options) => {
+		const resumeWithOptions = (agentId, options) => {
 			return instrument("agent.resume", Effect.tryPromise({
 				try: () => sdk.resume(agentId, options),
 				catch: (cause) => {
@@ -611,7 +608,7 @@ var CursorAgentService = class CursorAgentService extends Context.Service()("eff
 				}
 			}));
 		};
-		const prompt = (message, options) => {
+		const promptWithOptions = (message, options) => {
 			return instrument("agent.prompt", Effect.tryPromise({
 				try: () => sdk.prompt(message, options),
 				catch: (cause) => {
@@ -655,36 +652,29 @@ var CursorAgentService = class CursorAgentService extends Context.Service()("eff
 				}
 			}));
 		};
-		const scoped = (options) => {
-			return Effect.acquireRelease(create(options), (agent) => {
-				return Effect.ignore(dispose(agent));
-			});
-		};
-		const createFromConfig = (config, overrides = {}) => {
-			return create(agentOptionsFromConfig(config, overrides));
+		const create = (config, overrides = {}) => {
+			return createWithOptions(agentOptionsFromConfig(config, overrides));
 		};
-		const resumeFromConfig = (agentId, config, overrides = {}) => {
-			return resume(agentId, agentOptionsFromConfig(config, overrides));
+		const resume = (agentId, config, overrides = {}) => {
+			return resumeWithOptions(agentId, agentOptionsFromConfig(config, overrides));
 		};
-		const promptFromConfig = (message, config, overrides = {}) => {
-			return prompt(message, agentOptionsFromConfig(config, overrides));
+		const prompt = (message, config, overrides = {}) => {
+			return promptWithOptions(message, agentOptionsFromConfig(config, overrides));
 		};
-		const scopedFromConfig = (config, overrides = {}) => {
-			return scoped(agentOptionsFromConfig(config, overrides));
+		const scoped = (config, overrides = {}) => {
+			return Effect.acquireRelease(createWithOptions(agentOptionsFromConfig(config, overrides)), (agent) => {
+				return Effect.ignore(dispose(agent));
+			});
 		};
 		return {
 			create,
-			createFromConfig,
 			resume,
-			resumeFromConfig,
 			prompt,
-			promptFromConfig,
 			send,
 			reload,
 			close,
 			dispose,
-			scoped,
-			scopedFromConfig
+			scoped
 		};
 	}));
 };