@ebay-dt/bonfire-node 0.1.0-alpha.0 → 0.1.0-alpha.2

package/README.md

@@ -28,6 +28,48 @@ A competing mutation returns `repository-busy` immediately rather than waiting.
 The gate covers the supported local Node process only; coordination across
 multiple processes or machines is not provided.
 
+## Deployment provider
+
+Deployment is an optional development capability. Configure the generic provider
+only in a server-only host module with a complete HTTP endpoint; never expose the
+endpoint or provider to browser code:
+
+```ts
+import { createDeploymentProvider } from "@ebay-dt/bonfire-node";
+
+const deploymentProvider = createDeploymentProvider({
+  endpoint: process.env.BONFIRE_DEPLOYMENT_ENDPOINT!,
+  timeoutMs: 120_000,
+});
+```
+
+The provider sends exactly `{ applicationId, login }`. Bonfire supplies the
+application ID from trusted application configuration and the login from the
+verified authenticated identity; instances never provide owner/branch values.
+The application ID must exactly match the application's DT deployment-service
+registration; Bonfire does not validate that registration locally. A mismatch
+is returned as a safe deployment failure rather than exposing provider details.
+The documented success response is returned with HTTP 201 and contains
+`repository`, `ref`, `commitSha`, `sourceFileCount`, `project`, `deployed`,
+`deploymentId`, `url`, and `readyState`. `readyState` is one of `BLOCKED`,
+`BUILDING`, `CANCELED`, `ERROR`, `INITIALIZING`, `QUEUED`, or `READY`. HTTP 201
+means deployment creation succeeded, not that the preview is ready. A failure
+response contains `repository`, optional `ref`, `commitSha`, `project`, and
+`stage`, plus `deployed: false`, `statusCode`, and `details`; those diagnostics
+are validated and then intentionally hidden behind a safe provider error.
+
+The provider preserves the deployment ID and reported ready state, but Bonfire
+does not poll for later status. Provider failures are reduced to safe typed
+lifecycle errors; response diagnostics, credentials, Vercel credentials, and
+deployment-target selection remain outside Bonfire in the deployment service.
+If the deployment service exposes a registration-specific status, hosts may
+map it to a generic message such as “Deployment is not configured for this
+application.” They should not infer that classification from an arbitrary
+failure or forward provider response bodies, endpoint details, repository or
+branch data, or filesystem diagnostics to the browser. The provider validates the endpoint,
+response, HTTPS preview URL, and timeout without exposing service details to the
+browser.
+
 ## Prototype shape and duplication
 
 Duplicate sources must contain valid `metadata.json` plus regular,
@@ -68,10 +110,13 @@ completed destination. The default callback is a no-op.
 prototype reference, then returns a `clean` or `dirty` observation based only on
 Git status within that prototype path. `LocalPrototypeLifecycle.save` creates a
 local, path-scoped checkpoint without pushing; `.discard` restores tracked
-files and removes untracked files within that path. `LocalPrototypeLifecycle.create`
-and `.duplicate` return typed results and serialize repository mutations through
-one process-local operation gate. They
-prepare the authenticated identity branch when automatic switching is enabled;
+files and removes untracked files within that path. `LocalPrototypeLifecycle.create`,
+`.duplicate`, `.edit`, and `.delete` return typed results and serialize repository
+mutations through one process-local operation gate. Edit updates only title,
+description, and `updatedAt` while preserving the existing ref/URL. Delete
+removes the complete owned prototype directory, including uncommitted files,
+after ownership and path validation. These operations prepare the authenticated
+identity branch when automatic switching is enabled;
 `BF_DISABLE_AUTO_BRANCH_SWITCH=true` disables every automatic switch and leaves
 the current branch untouched. Git remains behind the Node-owned repository
 adapter, and `simple-git` is not part of the public API.
@@ -87,6 +132,34 @@ debounces filesystem events, and reports only clean/dirty transitions. The
 watcher subpath is intentionally separate so importing `@ebay-dt/bonfire-node` does
 not load Chokidar.
 
+## Agent launch preferences
+
+`PrototypeAgentService` stores a user's selected Claude Code terminal at
+`<prototypeRoot>/<login>/preferences.json`, using the explicit runtime context
+provided by the host. This is a local preference file, not prototype source:
+consuming applications must add their prototype-root preference pattern to
+`.gitignore`, for example:
+
+```gitignore
+/src/app/(prototypes)/*/preferences.json
+```
+
+The service writes the file atomically and only after authenticated ownership
+and command preflight have succeeded. Cursor launching requires `cursor` on the
+Bonfire server process's inherited `PATH`. Claude Code launching requires
+`claude` and, on macOS, `osascript` on that `PATH`; the service checks these
+commands without executing them. GUI-launched Node processes may have a
+different `PATH` from an interactive shell, so restart Bonfire after changing
+shell profiles.
+
+Claude Code supports the explicit terminal values `terminal` (Terminal.app),
+`iterm` (iTerm2), and `warp` (Warp). Unsupported platforms, missing commands,
+missing preferences, ownership failures, and launch failures are returned as
+safe typed results; raw process output and absolute paths are never public
+results. No skill, clipboard fallback, or copy/paste setup flow is involved.
+Production hosts must not construct the service or expose its local preference
+store.
+
 From the repository root, use Turbo filters so package dependencies are
 prepared in dependency order:
 

package/dist/agent-service.d.ts

@@ -0,0 +1,42 @@
+import { type AgentActionError, type AgentActionResult } from "@ebay-dt/bonfire-core";
+import { type ClaudeCodeLauncherLike } from "./claude.js";
+import { type CursorLauncherLike } from "./cursor.js";
+import { type ExecutableResolverLike } from "./executable.js";
+import { type PrototypePreferencesLike } from "./preferences.js";
+import type { PrototypeCatalogLike } from "./prototype-catalog.js";
+import type { PrototypeLifecycleRuntimeContext } from "./lifecycle/runtime-context.js";
+export type PrototypeAgentServiceOptions = {
+    runtime: Pick<PrototypeLifecycleRuntimeContext, "prototypeRoot">;
+    catalog: PrototypeCatalogLike;
+    executableResolver?: ExecutableResolverLike;
+    preferences?: PrototypePreferencesLike;
+    cursor?: CursorLauncherLike;
+    claudeCode?: ClaudeCodeLauncherLike;
+};
+export interface PrototypeAgentServiceLike {
+    openInCursor(identity: unknown, input: unknown): Promise<AgentActionResult>;
+    openInClaudeCode(identity: unknown, input: unknown): Promise<AgentActionResult>;
+}
+export declare class PrototypeAgentService implements PrototypeAgentServiceLike {
+    #private;
+    constructor(options: PrototypeAgentServiceOptions);
+    openInCursor(identity: unknown, input: unknown): Promise<{
+        ok: true;
+        value: import("@ebay-dt/bonfire-core").AgentLaunchValue;
+    } | {
+        ok: false;
+        error: AgentActionError;
+    }>;
+    openInClaudeCode(identity: unknown, input: unknown): Promise<{
+        ok: true;
+        value: import("@ebay-dt/bonfire-core").AgentLaunchValue;
+    } | {
+        ok: false;
+        error: {
+            agent?: import("@ebay-dt/bonfire-core").Agent;
+            terminal?: import("@ebay-dt/bonfire-core").TerminalApp;
+            code: import("@ebay-dt/bonfire-core").AgentActionErrorCode;
+        };
+    }>;
+}
+//# sourceMappingURL=agent-service.d.ts.map

package/dist/agent-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-service.d.ts","sourceRoot":"","sources":["../src/agent-service.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAGvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAEvF,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,IAAI,CAAC,gCAAgC,EAAE,eAAe,CAAC,CAAC;IACjE,OAAO,EAAE,oBAAoB,CAAC;IAC9B,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;IAC5C,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5E,gBAAgB,CACd,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAiCD,qBAAa,qBAAsB,YAAW,yBAAyB;;IAOrE,YAAY,OAAO,EAAE,4BAA4B,EAUhD;IA4CK,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;;;;;;OASnD;IAEK,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;;;;;;;;;;OA2CvD;CACF","sourcesContent":["import { join } from \"node:path\";\nimport {\n  definePrototypeRef,\n  parseBonfireIdentity,\n  parseOpenInAgentInput,\n  parseOpenInClaudeCodeInput,\n  type AgentActionError,\n  type AgentActionResult,\n  type BonfireIdentity,\n  type OpenInAgentInput,\n} from \"@ebay-dt/bonfire-core\";\nimport { ClaudeCodeLauncher, type ClaudeCodeLauncherLike } from \"./claude.js\";\nimport { CursorLauncher, type CursorLauncherLike } from \"./cursor.js\";\nimport {\n  PathExecutableResolver,\n  type ExecutableResolverLike,\n} from \"./executable.js\";\nimport {\n  PrototypePreferences,\n  type PrototypePreferencesLike,\n} from \"./preferences.js\";\nimport type { PrototypeCatalogLike } from \"./prototype-catalog.js\";\nimport type { PrototypeLifecycleRuntimeContext } from \"./lifecycle/runtime-context.js\";\n\nexport type PrototypeAgentServiceOptions = {\n  runtime: Pick<PrototypeLifecycleRuntimeContext, \"prototypeRoot\">;\n  catalog: PrototypeCatalogLike;\n  executableResolver?: ExecutableResolverLike;\n  preferences?: PrototypePreferencesLike;\n  cursor?: CursorLauncherLike;\n  claudeCode?: ClaudeCodeLauncherLike;\n};\n\nexport interface PrototypeAgentServiceLike {\n  openInCursor(identity: unknown, input: unknown): Promise<AgentActionResult>;\n  openInClaudeCode(\n    identity: unknown,\n    input: unknown,\n  ): Promise<AgentActionResult>;\n}\n\ntype AuthorizedInput<Value> =\n  | {\n      ok: true;\n      identity: BonfireIdentity;\n      input: Value;\n      prototypePath: string;\n    }\n  | { ok: false; result: AgentActionResult };\n\nfunction failure(\n  code: AgentActionError[\"code\"],\n  extras: Pick<AgentActionError, \"agent\" | \"terminal\"> = {},\n) {\n  return {\n    ok: false,\n    error: { code, ...extras },\n  } satisfies AgentActionResult;\n}\n\nfunction authenticate(identity: unknown) {\n  if (identity === null || identity === undefined) return null;\n\n  try {\n    const parsed = parseBonfireIdentity(identity);\n    definePrototypeRef({ login: parsed.login, slug: \"prototype\" });\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nexport class PrototypeAgentService implements PrototypeAgentServiceLike {\n  readonly #runtime: PrototypeAgentServiceOptions[\"runtime\"];\n  readonly #catalog: PrototypeCatalogLike;\n  readonly #preferences: PrototypePreferencesLike;\n  readonly #cursor: CursorLauncherLike;\n  readonly #claudeCode: ClaudeCodeLauncherLike;\n\n  constructor(options: PrototypeAgentServiceOptions) {\n    const executableResolver =\n      options.executableResolver ?? new PathExecutableResolver();\n    this.#runtime = options.runtime;\n    this.#catalog = options.catalog;\n    this.#preferences =\n      options.preferences ?? new PrototypePreferences(options.runtime);\n    this.#cursor = options.cursor ?? new CursorLauncher({ executableResolver });\n    this.#claudeCode =\n      options.claudeCode ?? new ClaudeCodeLauncher({ executableResolver });\n  }\n\n  async #authorize<Value extends { ref: OpenInAgentInput[\"ref\"] }>(\n    identity: unknown,\n    input: unknown,\n    parse: (value: unknown) => Value,\n  ): Promise<AuthorizedInput<Value>> {\n    const authenticated = authenticate(identity);\n    if (authenticated === null) {\n      return { ok: false, result: failure(\"unauthenticated\") };\n    }\n\n    let normalizedInput: Value;\n    try {\n      normalizedInput = parse(input);\n    } catch {\n      return { ok: false, result: failure(\"invalid-input\") };\n    }\n\n    let summary;\n    try {\n      summary = await this.#catalog.getSummary(normalizedInput.ref);\n    } catch {\n      summary = null;\n    }\n    if (summary === null) {\n      return { ok: false, result: failure(\"not-found\") };\n    }\n    if (summary.authorLogin !== authenticated.login) {\n      return { ok: false, result: failure(\"forbidden\") };\n    }\n\n    return {\n      ok: true,\n      identity: authenticated,\n      input: normalizedInput,\n      prototypePath: join(\n        this.#runtime.prototypeRoot,\n        normalizedInput.ref.login,\n        normalizedInput.ref.slug,\n      ),\n    };\n  }\n\n  async openInCursor(identity: unknown, input: unknown) {\n    const authorized = await this.#authorize(\n      identity,\n      input,\n      parseOpenInAgentInput,\n    );\n    if (!authorized.ok) return authorized.result;\n\n    return this.#cursor.launch(authorized.prototypePath);\n  }\n\n  async openInClaudeCode(identity: unknown, input: unknown) {\n    const authorized = await this.#authorize(\n      identity,\n      input,\n      parseOpenInClaudeCodeInput,\n    );\n    if (!authorized.ok) return authorized.result;\n\n    const preflight = await this.#claudeCode.preflight(\n      authorized.input.terminal,\n    );\n    if (!preflight.ok) return preflight;\n\n    let terminal = authorized.input.terminal;\n    if (terminal === undefined) {\n      let preferences;\n      try {\n        preferences = await this.#preferences.read(authorized.identity.login);\n      } catch {\n        return failure(\"launch-failed\", { agent: \"claude-code\" });\n      }\n      terminal = preferences.preferredTerminal;\n      if (terminal === undefined) {\n        return failure(\"needs-terminal\", { agent: \"claude-code\" });\n      }\n    } else {\n      try {\n        await this.#preferences.update(authorized.identity.login, {\n          preferredTerminal: terminal,\n        });\n      } catch {\n        return failure(\"launch-failed\", {\n          agent: \"claude-code\",\n          terminal,\n        });\n      }\n    }\n\n    return this.#claudeCode.launch(\n      terminal,\n      authorized.prototypePath,\n      preflight,\n    );\n  }\n}\n"]}

package/dist/agent-service.js

@@ -0,0 +1,116 @@
+import { join } from "node:path";
+import { definePrototypeRef, parseBonfireIdentity, parseOpenInAgentInput, parseOpenInClaudeCodeInput, } from "@ebay-dt/bonfire-core";
+import { ClaudeCodeLauncher } from "./claude.js";
+import { CursorLauncher } from "./cursor.js";
+import { PathExecutableResolver, } from "./executable.js";
+import { PrototypePreferences, } from "./preferences.js";
+function failure(code, extras = {}) {
+    return {
+        ok: false,
+        error: { code, ...extras },
+    };
+}
+function authenticate(identity) {
+    if (identity === null || identity === undefined)
+        return null;
+    try {
+        const parsed = parseBonfireIdentity(identity);
+        definePrototypeRef({ login: parsed.login, slug: "prototype" });
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export class PrototypeAgentService {
+    #runtime;
+    #catalog;
+    #preferences;
+    #cursor;
+    #claudeCode;
+    constructor(options) {
+        const executableResolver = options.executableResolver ?? new PathExecutableResolver();
+        this.#runtime = options.runtime;
+        this.#catalog = options.catalog;
+        this.#preferences =
+            options.preferences ?? new PrototypePreferences(options.runtime);
+        this.#cursor = options.cursor ?? new CursorLauncher({ executableResolver });
+        this.#claudeCode =
+            options.claudeCode ?? new ClaudeCodeLauncher({ executableResolver });
+    }
+    async #authorize(identity, input, parse) {
+        const authenticated = authenticate(identity);
+        if (authenticated === null) {
+            return { ok: false, result: failure("unauthenticated") };
+        }
+        let normalizedInput;
+        try {
+            normalizedInput = parse(input);
+        }
+        catch {
+            return { ok: false, result: failure("invalid-input") };
+        }
+        let summary;
+        try {
+            summary = await this.#catalog.getSummary(normalizedInput.ref);
+        }
+        catch {
+            summary = null;
+        }
+        if (summary === null) {
+            return { ok: false, result: failure("not-found") };
+        }
+        if (summary.authorLogin !== authenticated.login) {
+            return { ok: false, result: failure("forbidden") };
+        }
+        return {
+            ok: true,
+            identity: authenticated,
+            input: normalizedInput,
+            prototypePath: join(this.#runtime.prototypeRoot, normalizedInput.ref.login, normalizedInput.ref.slug),
+        };
+    }
+    async openInCursor(identity, input) {
+        const authorized = await this.#authorize(identity, input, parseOpenInAgentInput);
+        if (!authorized.ok)
+            return authorized.result;
+        return this.#cursor.launch(authorized.prototypePath);
+    }
+    async openInClaudeCode(identity, input) {
+        const authorized = await this.#authorize(identity, input, parseOpenInClaudeCodeInput);
+        if (!authorized.ok)
+            return authorized.result;
+        const preflight = await this.#claudeCode.preflight(authorized.input.terminal);
+        if (!preflight.ok)
+            return preflight;
+        let terminal = authorized.input.terminal;
+        if (terminal === undefined) {
+            let preferences;
+            try {
+                preferences = await this.#preferences.read(authorized.identity.login);
+            }
+            catch {
+                return failure("launch-failed", { agent: "claude-code" });
+            }
+            terminal = preferences.preferredTerminal;
+            if (terminal === undefined) {
+                return failure("needs-terminal", { agent: "claude-code" });
+            }
+        }
+        else {
+            try {
+                await this.#preferences.update(authorized.identity.login, {
+                    preferredTerminal: terminal,
+                });
+            }
+            catch {
+                return failure("launch-failed", {
+                    agent: "claude-code",
+                    terminal,
+                });
+            }
+        }
+        return this.#claudeCode.launch(terminal, authorized.prototypePath, preflight);
+    }
+}
+//# sourceMappingURL=agent-service.js.map

package/dist/agent-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-service.js","sourceRoot":"","sources":["../src/agent-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport {\n  definePrototypeRef,\n  parseBonfireIdentity,\n  parseOpenInAgentInput,\n  parseOpenInClaudeCodeInput,\n  type AgentActionError,\n  type AgentActionResult,\n  type BonfireIdentity,\n  type OpenInAgentInput,\n} from \"@ebay-dt/bonfire-core\";\nimport { ClaudeCodeLauncher, type ClaudeCodeLauncherLike } from \"./claude.js\";\nimport { CursorLauncher, type CursorLauncherLike } from \"./cursor.js\";\nimport {\n  PathExecutableResolver,\n  type ExecutableResolverLike,\n} from \"./executable.js\";\nimport {\n  PrototypePreferences,\n  type PrototypePreferencesLike,\n} from \"./preferences.js\";\nimport type { PrototypeCatalogLike } from \"./prototype-catalog.js\";\nimport type { PrototypeLifecycleRuntimeContext } from \"./lifecycle/runtime-context.js\";\n\nexport type PrototypeAgentServiceOptions = {\n  runtime: Pick<PrototypeLifecycleRuntimeContext, \"prototypeRoot\">;\n  catalog: PrototypeCatalogLike;\n  executableResolver?: ExecutableResolverLike;\n  preferences?: PrototypePreferencesLike;\n  cursor?: CursorLauncherLike;\n  claudeCode?: ClaudeCodeLauncherLike;\n};\n\nexport interface PrototypeAgentServiceLike {\n  openInCursor(identity: unknown, input: unknown): Promise<AgentActionResult>;\n  openInClaudeCode(\n    identity: unknown,\n    input: unknown,\n  ): Promise<AgentActionResult>;\n}\n\ntype AuthorizedInput<Value> =\n  | {\n      ok: true;\n      identity: BonfireIdentity;\n      input: Value;\n      prototypePath: string;\n    }\n  | { ok: false; result: AgentActionResult };\n\nfunction failure(\n  code: AgentActionError[\"code\"],\n  extras: Pick<AgentActionError, \"agent\" | \"terminal\"> = {},\n) {\n  return {\n    ok: false,\n    error: { code, ...extras },\n  } satisfies AgentActionResult;\n}\n\nfunction authenticate(identity: unknown) {\n  if (identity === null || identity === undefined) return null;\n\n  try {\n    const parsed = parseBonfireIdentity(identity);\n    definePrototypeRef({ login: parsed.login, slug: \"prototype\" });\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nexport class PrototypeAgentService implements PrototypeAgentServiceLike {\n  readonly #runtime: PrototypeAgentServiceOptions[\"runtime\"];\n  readonly #catalog: PrototypeCatalogLike;\n  readonly #preferences: PrototypePreferencesLike;\n  readonly #cursor: CursorLauncherLike;\n  readonly #claudeCode: ClaudeCodeLauncherLike;\n\n  constructor(options: PrototypeAgentServiceOptions) {\n    const executableResolver =\n      options.executableResolver ?? new PathExecutableResolver();\n    this.#runtime = options.runtime;\n    this.#catalog = options.catalog;\n    this.#preferences =\n      options.preferences ?? new PrototypePreferences(options.runtime);\n    this.#cursor = options.cursor ?? new CursorLauncher({ executableResolver });\n    this.#claudeCode =\n      options.claudeCode ?? new ClaudeCodeLauncher({ executableResolver });\n  }\n\n  async #authorize<Value extends { ref: OpenInAgentInput[\"ref\"] }>(\n    identity: unknown,\n    input: unknown,\n    parse: (value: unknown) => Value,\n  ): Promise<AuthorizedInput<Value>> {\n    const authenticated = authenticate(identity);\n    if (authenticated === null) {\n      return { ok: false, result: failure(\"unauthenticated\") };\n    }\n\n    let normalizedInput: Value;\n    try {\n      normalizedInput = parse(input);\n    } catch {\n      return { ok: false, result: failure(\"invalid-input\") };\n    }\n\n    let summary;\n    try {\n      summary = await this.#catalog.getSummary(normalizedInput.ref);\n    } catch {\n      summary = null;\n    }\n    if (summary === null) {\n      return { ok: false, result: failure(\"not-found\") };\n    }\n    if (summary.authorLogin !== authenticated.login) {\n      return { ok: false, result: failure(\"forbidden\") };\n    }\n\n    return {\n      ok: true,\n      identity: authenticated,\n      input: normalizedInput,\n      prototypePath: join(\n        this.#runtime.prototypeRoot,\n        normalizedInput.ref.login,\n        normalizedInput.ref.slug,\n      ),\n    };\n  }\n\n  async openInCursor(identity: unknown, input: unknown) {\n    const authorized = await this.#authorize(\n      identity,\n      input,\n      parseOpenInAgentInput,\n    );\n    if (!authorized.ok) return authorized.result;\n\n    return this.#cursor.launch(authorized.prototypePath);\n  }\n\n  async openInClaudeCode(identity: unknown, input: unknown) {\n    const authorized = await this.#authorize(\n      identity,\n      input,\n      parseOpenInClaudeCodeInput,\n    );\n    if (!authorized.ok) return authorized.result;\n\n    const preflight = await this.#claudeCode.preflight(\n      authorized.input.terminal,\n    );\n    if (!preflight.ok) return preflight;\n\n    let terminal = authorized.input.terminal;\n    if (terminal === undefined) {\n      let preferences;\n      try {\n        preferences = await this.#preferences.read(authorized.identity.login);\n      } catch {\n        return failure(\"launch-failed\", { agent: \"claude-code\" });\n      }\n      terminal = preferences.preferredTerminal;\n      if (terminal === undefined) {\n        return failure(\"needs-terminal\", { agent: \"claude-code\" });\n      }\n    } else {\n      try {\n        await this.#preferences.update(authorized.identity.login, {\n          preferredTerminal: terminal,\n        });\n      } catch {\n        return failure(\"launch-failed\", {\n          agent: \"claude-code\",\n          terminal,\n        });\n      }\n    }\n\n    return this.#claudeCode.launch(\n      terminal,\n      authorized.prototypePath,\n      preflight,\n    );\n  }\n}\n"]}

package/dist/claude.d.ts

@@ -0,0 +1,50 @@
+import { type AgentActionError, type AgentActionResult, type AgentLaunchValue, type TerminalApp } from "@ebay-dt/bonfire-core";
+import { type ExecutableResolverLike } from "./executable.js";
+export type ClaudeCodeExecOptions = {
+    timeout: number;
+    maxBuffer: number;
+};
+export type ClaudeCodeExecResult = {
+    stdout: string;
+    stderr: string;
+};
+export type ClaudeCodeProcessRunner = {
+    execFile(executable: string, args: readonly string[], options: ClaudeCodeExecOptions): Promise<ClaudeCodeExecResult>;
+};
+export type ClaudeCodePreflightValue = {
+    osascript: string;
+};
+export type ClaudeCodePreflightResult = AgentActionResult<ClaudeCodePreflightValue>;
+export type ClaudeCodeLauncherOptions = {
+    executableResolver?: ExecutableResolverLike;
+    platform?: NodeJS.Platform;
+    process?: ClaudeCodeProcessRunner;
+};
+export interface ClaudeCodeLauncherLike {
+    preflight(terminal?: TerminalApp): Promise<ClaudeCodePreflightResult>;
+    launch(terminal: TerminalApp, prototypePath: string, preflight?: ClaudeCodePreflightResult): Promise<AgentActionResult<AgentLaunchValue>>;
+}
+export declare function buildClaudeCodeAppleScript(terminal: TerminalApp, prototypePath: string): string;
+export declare class ClaudeCodeLauncher implements ClaudeCodeLauncherLike {
+    #private;
+    constructor(options?: ClaudeCodeLauncherOptions);
+    preflight(terminal?: TerminalApp): Promise<{
+        ok: false;
+        error: AgentActionError;
+    } | {
+        ok: true;
+        value: {
+            osascript: string;
+        };
+    }>;
+    launch(terminal: TerminalApp, prototypePath: string, preflight?: ClaudeCodePreflightResult): Promise<{
+        ok: false;
+        error: AgentActionError;
+    } | {
+        ok: true;
+        value: {
+            agent: "claude-code";
+        };
+    }>;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../src/claude.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AAOzB,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACnC,iBAAiB,CAAC,wBAAwB,CAAC,CAAC;AAE9C,MAAM,MAAM,yBAAyB,GAAG;IACtC,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtE,MAAM,CACJ,QAAQ,EAAE,WAAW,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,yBAAyB,GACpC,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAC;CACjD;AAuCD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,WAAW,EACrB,aAAa,EAAE,MAAM,UA2BtB;AAoBD,qBAAa,kBAAmB,YAAW,sBAAsB;;IAK/D,YAAY,OAAO,GAAE,yBAA8B,EAKlD;IAEK,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW;;;;;;;;OAmBrC;IAEK,MAAM,CACV,QAAQ,EAAE,WAAW,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,yBAAyB;;;;;;;;OAmBtC;CACF","sourcesContent":["import { execFile as nodeExecFile } from \"node:child_process\";\nimport {\n  type AgentActionError,\n  type AgentActionResult,\n  type AgentCommand,\n  type AgentLaunchValue,\n  type TerminalApp,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n  PathExecutableResolver,\n  type ExecutableResolverLike,\n} from \"./executable.js\";\n\nconst CLAUDE_COMMAND = \"claude\";\nconst OSASCRIPT_COMMAND = \"osascript\";\nconst APPLESCRIPT_TIMEOUT = 10_000;\nconst APPLESCRIPT_MAX_BUFFER = 1024 * 1024;\n\nexport type ClaudeCodeExecOptions = {\n  timeout: number;\n  maxBuffer: number;\n};\n\nexport type ClaudeCodeExecResult = {\n  stdout: string;\n  stderr: string;\n};\n\nexport type ClaudeCodeProcessRunner = {\n  execFile(\n    executable: string,\n    args: readonly string[],\n    options: ClaudeCodeExecOptions,\n  ): Promise<ClaudeCodeExecResult>;\n};\n\nexport type ClaudeCodePreflightValue = {\n  osascript: string;\n};\n\nexport type ClaudeCodePreflightResult =\n  AgentActionResult<ClaudeCodePreflightValue>;\n\nexport type ClaudeCodeLauncherOptions = {\n  executableResolver?: ExecutableResolverLike;\n  platform?: NodeJS.Platform;\n  process?: ClaudeCodeProcessRunner;\n};\n\nexport interface ClaudeCodeLauncherLike {\n  preflight(terminal?: TerminalApp): Promise<ClaudeCodePreflightResult>;\n  launch(\n    terminal: TerminalApp,\n    prototypePath: string,\n    preflight?: ClaudeCodePreflightResult,\n  ): Promise<AgentActionResult<AgentLaunchValue>>;\n}\n\nconst defaultProcess: ClaudeCodeProcessRunner = {\n  execFile(executable, args, options) {\n    return new Promise((resolve, reject) => {\n      nodeExecFile(\n        executable,\n        [...args],\n        { ...options, encoding: \"utf8\" },\n        (error, stdout, stderr) => {\n          if (error) {\n            Object.assign(error, { stdout, stderr });\n            reject(error);\n            return;\n          }\n\n          resolve({ stdout, stderr });\n        },\n      );\n    });\n  },\n};\n\nfunction appleScriptString(value: string) {\n  return `\"${value\n    .replaceAll(\"\\\\\", \"\\\\\\\\\")\n    .replaceAll('\"', '\\\\\"')\n    .replaceAll(\"\\r\", \"\\\\r\")\n    .replaceAll(\"\\n\", \"\\\\n\")}\"`;\n}\n\nfunction shellString(value: string) {\n  return `'${value.replaceAll(\"'\", `'\"'\"'`)}'`;\n}\n\nfunction commandForPath(prototypePath: string) {\n  return `cd ${shellString(prototypePath)} && ${CLAUDE_COMMAND}`;\n}\n\nexport function buildClaudeCodeAppleScript(\n  terminal: TerminalApp,\n  prototypePath: string,\n) {\n  const command = commandForPath(prototypePath);\n\n  switch (terminal) {\n    case \"terminal\":\n      return `tell application \"Terminal\" to do script ${appleScriptString(command)}`;\n    case \"iterm\":\n      return [\n        'tell application \"iTerm\"',\n        \"  create window with default profile\",\n        \"  tell current session of current window\",\n        `    write text ${appleScriptString(command)}`,\n        \"  end tell\",\n        \"end tell\",\n      ].join(\"\\n\");\n    case \"warp\": {\n      const uri = `warp://action/new_tab?path=${encodeURIComponent(prototypePath)}`;\n      return [\n        `do shell script ${appleScriptString(`open ${shellString(uri)}`)}`,\n        \"delay 1\",\n        'tell application \"Warp\" to activate',\n        `tell application \"System Events\" to keystroke ${appleScriptString(command)}`,\n        'tell application \"System Events\" to key code 36',\n      ].join(\"\\n\");\n    }\n  }\n}\n\nfunction actionFailure(\n  code: \"missing-command\" | \"launch-failed\" | \"unsupported-platform\",\n  terminal?: TerminalApp,\n  command?: AgentCommand,\n) {\n  const error: AgentActionError = {\n    code,\n    agent: \"claude-code\",\n    ...(command ? { command } : {}),\n    ...(terminal ? { terminal } : {}),\n  };\n\n  return {\n    ok: false,\n    error,\n  } satisfies AgentActionResult;\n}\n\nexport class ClaudeCodeLauncher implements ClaudeCodeLauncherLike {\n  readonly #executableResolver: ExecutableResolverLike;\n  readonly #platform: NodeJS.Platform;\n  readonly #process: ClaudeCodeProcessRunner;\n\n  constructor(options: ClaudeCodeLauncherOptions = {}) {\n    this.#executableResolver =\n      options.executableResolver ?? new PathExecutableResolver();\n    this.#platform = options.platform ?? process.platform;\n    this.#process = options.process ?? defaultProcess;\n  }\n\n  async preflight(terminal?: TerminalApp) {\n    if (this.#platform !== \"darwin\") {\n      return actionFailure(\"unsupported-platform\", terminal);\n    }\n\n    const claude = await this.#executableResolver.resolve(CLAUDE_COMMAND);\n    if (claude === null) {\n      return actionFailure(\"missing-command\", terminal, CLAUDE_COMMAND);\n    }\n\n    const osascript = await this.#executableResolver.resolve(OSASCRIPT_COMMAND);\n    if (osascript === null) {\n      return actionFailure(\"missing-command\", terminal, OSASCRIPT_COMMAND);\n    }\n\n    return {\n      ok: true,\n      value: { osascript },\n    } satisfies ClaudeCodePreflightResult;\n  }\n\n  async launch(\n    terminal: TerminalApp,\n    prototypePath: string,\n    preflight?: ClaudeCodePreflightResult,\n  ) {\n    const checked = preflight ?? (await this.preflight(terminal));\n    if (!checked.ok) return checked;\n\n    const script = buildClaudeCodeAppleScript(terminal, prototypePath);\n    try {\n      await this.#process.execFile(checked.value.osascript, [\"-e\", script], {\n        timeout: APPLESCRIPT_TIMEOUT,\n        maxBuffer: APPLESCRIPT_MAX_BUFFER,\n      });\n    } catch {\n      return actionFailure(\"launch-failed\", terminal);\n    }\n\n    return {\n      ok: true,\n      value: { agent: \"claude-code\" },\n    } satisfies AgentActionResult;\n  }\n}\n"]}

package/dist/claude.js

@@ -0,0 +1,119 @@
+import { execFile as nodeExecFile } from "node:child_process";
+import { PathExecutableResolver, } from "./executable.js";
+const CLAUDE_COMMAND = "claude";
+const OSASCRIPT_COMMAND = "osascript";
+const APPLESCRIPT_TIMEOUT = 10_000;
+const APPLESCRIPT_MAX_BUFFER = 1024 * 1024;
+const defaultProcess = {
+    execFile(executable, args, options) {
+        return new Promise((resolve, reject) => {
+            nodeExecFile(executable, [...args], { ...options, encoding: "utf8" }, (error, stdout, stderr) => {
+                if (error) {
+                    Object.assign(error, { stdout, stderr });
+                    reject(error);
+                    return;
+                }
+                resolve({ stdout, stderr });
+            });
+        });
+    },
+};
+function appleScriptString(value) {
+    return `"${value
+        .replaceAll("\\", "\\\\")
+        .replaceAll('"', '\\"')
+        .replaceAll("\r", "\\r")
+        .replaceAll("\n", "\\n")}"`;
+}
+function shellString(value) {
+    return `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+function commandForPath(prototypePath) {
+    return `cd ${shellString(prototypePath)} && ${CLAUDE_COMMAND}`;
+}
+export function buildClaudeCodeAppleScript(terminal, prototypePath) {
+    const command = commandForPath(prototypePath);
+    switch (terminal) {
+        case "terminal":
+            return `tell application "Terminal" to do script ${appleScriptString(command)}`;
+        case "iterm":
+            return [
+                'tell application "iTerm"',
+                "  create window with default profile",
+                "  tell current session of current window",
+                `    write text ${appleScriptString(command)}`,
+                "  end tell",
+                "end tell",
+            ].join("\n");
+        case "warp": {
+            const uri = `warp://action/new_tab?path=${encodeURIComponent(prototypePath)}`;
+            return [
+                `do shell script ${appleScriptString(`open ${shellString(uri)}`)}`,
+                "delay 1",
+                'tell application "Warp" to activate',
+                `tell application "System Events" to keystroke ${appleScriptString(command)}`,
+                'tell application "System Events" to key code 36',
+            ].join("\n");
+        }
+    }
+}
+function actionFailure(code, terminal, command) {
+    const error = {
+        code,
+        agent: "claude-code",
+        ...(command ? { command } : {}),
+        ...(terminal ? { terminal } : {}),
+    };
+    return {
+        ok: false,
+        error,
+    };
+}
+export class ClaudeCodeLauncher {
+    #executableResolver;
+    #platform;
+    #process;
+    constructor(options = {}) {
+        this.#executableResolver =
+            options.executableResolver ?? new PathExecutableResolver();
+        this.#platform = options.platform ?? process.platform;
+        this.#process = options.process ?? defaultProcess;
+    }
+    async preflight(terminal) {
+        if (this.#platform !== "darwin") {
+            return actionFailure("unsupported-platform", terminal);
+        }
+        const claude = await this.#executableResolver.resolve(CLAUDE_COMMAND);
+        if (claude === null) {
+            return actionFailure("missing-command", terminal, CLAUDE_COMMAND);
+        }
+        const osascript = await this.#executableResolver.resolve(OSASCRIPT_COMMAND);
+        if (osascript === null) {
+            return actionFailure("missing-command", terminal, OSASCRIPT_COMMAND);
+        }
+        return {
+            ok: true,
+            value: { osascript },
+        };
+    }
+    async launch(terminal, prototypePath, preflight) {
+        const checked = preflight ?? (await this.preflight(terminal));
+        if (!checked.ok)
+            return checked;
+        const script = buildClaudeCodeAppleScript(terminal, prototypePath);
+        try {
+            await this.#process.execFile(checked.value.osascript, ["-e", script], {
+                timeout: APPLESCRIPT_TIMEOUT,
+                maxBuffer: APPLESCRIPT_MAX_BUFFER,
+            });
+        }
+        catch {
+            return actionFailure("launch-failed", terminal);
+        }
+        return {
+            ok: true,
+            value: { agent: "claude-code" },
+        };
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../src/claude.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile as nodeExecFile } from \"node:child_process\";\nimport {\n  type AgentActionError,\n  type AgentActionResult,\n  type AgentCommand,\n  type AgentLaunchValue,\n  type TerminalApp,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n  PathExecutableResolver,\n  type ExecutableResolverLike,\n} from \"./executable.js\";\n\nconst CLAUDE_COMMAND = \"claude\";\nconst OSASCRIPT_COMMAND = \"osascript\";\nconst APPLESCRIPT_TIMEOUT = 10_000;\nconst APPLESCRIPT_MAX_BUFFER = 1024 * 1024;\n\nexport type ClaudeCodeExecOptions = {\n  timeout: number;\n  maxBuffer: number;\n};\n\nexport type ClaudeCodeExecResult = {\n  stdout: string;\n  stderr: string;\n};\n\nexport type ClaudeCodeProcessRunner = {\n  execFile(\n    executable: string,\n    args: readonly string[],\n    options: ClaudeCodeExecOptions,\n  ): Promise<ClaudeCodeExecResult>;\n};\n\nexport type ClaudeCodePreflightValue = {\n  osascript: string;\n};\n\nexport type ClaudeCodePreflightResult =\n  AgentActionResult<ClaudeCodePreflightValue>;\n\nexport type ClaudeCodeLauncherOptions = {\n  executableResolver?: ExecutableResolverLike;\n  platform?: NodeJS.Platform;\n  process?: ClaudeCodeProcessRunner;\n};\n\nexport interface ClaudeCodeLauncherLike {\n  preflight(terminal?: TerminalApp): Promise<ClaudeCodePreflightResult>;\n  launch(\n    terminal: TerminalApp,\n    prototypePath: string,\n    preflight?: ClaudeCodePreflightResult,\n  ): Promise<AgentActionResult<AgentLaunchValue>>;\n}\n\nconst defaultProcess: ClaudeCodeProcessRunner = {\n  execFile(executable, args, options) {\n    return new Promise((resolve, reject) => {\n      nodeExecFile(\n        executable,\n        [...args],\n        { ...options, encoding: \"utf8\" },\n        (error, stdout, stderr) => {\n          if (error) {\n            Object.assign(error, { stdout, stderr });\n            reject(error);\n            return;\n          }\n\n          resolve({ stdout, stderr });\n        },\n      );\n    });\n  },\n};\n\nfunction appleScriptString(value: string) {\n  return `\"${value\n    .replaceAll(\"\\\\\", \"\\\\\\\\\")\n    .replaceAll('\"', '\\\\\"')\n    .replaceAll(\"\\r\", \"\\\\r\")\n    .replaceAll(\"\\n\", \"\\\\n\")}\"`;\n}\n\nfunction shellString(value: string) {\n  return `'${value.replaceAll(\"'\", `'\"'\"'`)}'`;\n}\n\nfunction commandForPath(prototypePath: string) {\n  return `cd ${shellString(prototypePath)} && ${CLAUDE_COMMAND}`;\n}\n\nexport function buildClaudeCodeAppleScript(\n  terminal: TerminalApp,\n  prototypePath: string,\n) {\n  const command = commandForPath(prototypePath);\n\n  switch (terminal) {\n    case \"terminal\":\n      return `tell application \"Terminal\" to do script ${appleScriptString(command)}`;\n    case \"iterm\":\n      return [\n        'tell application \"iTerm\"',\n        \"  create window with default profile\",\n        \"  tell current session of current window\",\n        `    write text ${appleScriptString(command)}`,\n        \"  end tell\",\n        \"end tell\",\n      ].join(\"\\n\");\n    case \"warp\": {\n      const uri = `warp://action/new_tab?path=${encodeURIComponent(prototypePath)}`;\n      return [\n        `do shell script ${appleScriptString(`open ${shellString(uri)}`)}`,\n        \"delay 1\",\n        'tell application \"Warp\" to activate',\n        `tell application \"System Events\" to keystroke ${appleScriptString(command)}`,\n        'tell application \"System Events\" to key code 36',\n      ].join(\"\\n\");\n    }\n  }\n}\n\nfunction actionFailure(\n  code: \"missing-command\" | \"launch-failed\" | \"unsupported-platform\",\n  terminal?: TerminalApp,\n  command?: AgentCommand,\n) {\n  const error: AgentActionError = {\n    code,\n    agent: \"claude-code\",\n    ...(command ? { command } : {}),\n    ...(terminal ? { terminal } : {}),\n  };\n\n  return {\n    ok: false,\n    error,\n  } satisfies AgentActionResult;\n}\n\nexport class ClaudeCodeLauncher implements ClaudeCodeLauncherLike {\n  readonly #executableResolver: ExecutableResolverLike;\n  readonly #platform: NodeJS.Platform;\n  readonly #process: ClaudeCodeProcessRunner;\n\n  constructor(options: ClaudeCodeLauncherOptions = {}) {\n    this.#executableResolver =\n      options.executableResolver ?? new PathExecutableResolver();\n    this.#platform = options.platform ?? process.platform;\n    this.#process = options.process ?? defaultProcess;\n  }\n\n  async preflight(terminal?: TerminalApp) {\n    if (this.#platform !== \"darwin\") {\n      return actionFailure(\"unsupported-platform\", terminal);\n    }\n\n    const claude = await this.#executableResolver.resolve(CLAUDE_COMMAND);\n    if (claude === null) {\n      return actionFailure(\"missing-command\", terminal, CLAUDE_COMMAND);\n    }\n\n    const osascript = await this.#executableResolver.resolve(OSASCRIPT_COMMAND);\n    if (osascript === null) {\n      return actionFailure(\"missing-command\", terminal, OSASCRIPT_COMMAND);\n    }\n\n    return {\n      ok: true,\n      value: { osascript },\n    } satisfies ClaudeCodePreflightResult;\n  }\n\n  async launch(\n    terminal: TerminalApp,\n    prototypePath: string,\n    preflight?: ClaudeCodePreflightResult,\n  ) {\n    const checked = preflight ?? (await this.preflight(terminal));\n    if (!checked.ok) return checked;\n\n    const script = buildClaudeCodeAppleScript(terminal, prototypePath);\n    try {\n      await this.#process.execFile(checked.value.osascript, [\"-e\", script], {\n        timeout: APPLESCRIPT_TIMEOUT,\n        maxBuffer: APPLESCRIPT_MAX_BUFFER,\n      });\n    } catch {\n      return actionFailure(\"launch-failed\", terminal);\n    }\n\n    return {\n      ok: true,\n      value: { agent: \"claude-code\" },\n    } satisfies AgentActionResult;\n  }\n}\n"]}

package/dist/cursor.d.ts

@@ -0,0 +1,30 @@
+import { type ChildProcess } from "node:child_process";
+import { type AgentActionResult, type AgentLaunchValue } from "@ebay-dt/bonfire-core";
+import { type ExecutableResolverLike } from "./executable.js";
+export type CursorSpawnOptions = {
+    detached: true;
+    shell: false;
+    stdio: "ignore";
+};
+export type CursorChildProcess = Pick<ChildProcess, "once" | "unref">;
+export type CursorSpawn = (executable: string, args: readonly string[], options: CursorSpawnOptions) => CursorChildProcess;
+export type CursorLauncherOptions = {
+    executableResolver?: ExecutableResolverLike;
+    spawn?: CursorSpawn;
+};
+export interface CursorLauncherLike {
+    launch(prototypePath: string): Promise<AgentActionResult<AgentLaunchValue>>;
+}
+export declare class CursorLauncher implements CursorLauncherLike {
+    #private;
+    constructor(options?: CursorLauncherOptions);
+    launch(prototypePath: string): Promise<{
+        ok: false;
+        error: {
+            code: "launch-failed";
+            agent: "cursor";
+            command: "cursor";
+        };
+    } | AgentActionResult>;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../src/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AAIzB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AAEtE,MAAM,MAAM,WAAW,GAAG,CACxB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,kBAAkB,KACxB,kBAAkB,CAAC;AAExB,MAAM,MAAM,qBAAqB,GAAG;IAClC,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;IAC5C,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAC;CAC7E;AAgBD,qBAAa,cAAe,YAAW,kBAAkB;;IAIvD,YAAY,OAAO,GAAE,qBAA0B,EAI9C;IAEK,MAAM,CAAC,aAAa,EAAE,MAAM;;;;;;;2BAiCjC;CACF","sourcesContent":["import { spawn as nodeSpawn, type ChildProcess } from \"node:child_process\";\nimport {\n  type AgentActionResult,\n  type AgentLaunchValue,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n  PathExecutableResolver,\n  type ExecutableResolverLike,\n} from \"./executable.js\";\n\nconst CURSOR_COMMAND = \"cursor\";\n\nexport type CursorSpawnOptions = {\n  detached: true;\n  shell: false;\n  stdio: \"ignore\";\n};\n\nexport type CursorChildProcess = Pick<ChildProcess, \"once\" | \"unref\">;\n\nexport type CursorSpawn = (\n  executable: string,\n  args: readonly string[],\n  options: CursorSpawnOptions,\n) => CursorChildProcess;\n\nexport type CursorLauncherOptions = {\n  executableResolver?: ExecutableResolverLike;\n  spawn?: CursorSpawn;\n};\n\nexport interface CursorLauncherLike {\n  launch(prototypePath: string): Promise<AgentActionResult<AgentLaunchValue>>;\n}\n\nconst defaultSpawn: CursorSpawn = (executable, args, options) =>\n  nodeSpawn(executable, [...args], options);\n\nfunction launchFailure() {\n  return {\n    ok: false,\n    error: {\n      code: \"launch-failed\",\n      agent: \"cursor\",\n      command: CURSOR_COMMAND,\n    },\n  } satisfies AgentActionResult;\n}\n\nexport class CursorLauncher implements CursorLauncherLike {\n  readonly #executableResolver: ExecutableResolverLike;\n  readonly #spawn: CursorSpawn;\n\n  constructor(options: CursorLauncherOptions = {}) {\n    this.#executableResolver =\n      options.executableResolver ?? new PathExecutableResolver();\n    this.#spawn = options.spawn ?? defaultSpawn;\n  }\n\n  async launch(prototypePath: string) {\n    const executable = await this.#executableResolver.resolve(CURSOR_COMMAND);\n    if (executable === null) {\n      return {\n        ok: false,\n        error: {\n          code: \"missing-command\",\n          agent: \"cursor\",\n          command: CURSOR_COMMAND,\n        },\n      } satisfies AgentActionResult;\n    }\n\n    let child: CursorChildProcess;\n    try {\n      child = this.#spawn(executable, [prototypePath], {\n        detached: true,\n        shell: false,\n        stdio: \"ignore\",\n      });\n      child.unref();\n    } catch {\n      return launchFailure();\n    }\n\n    return new Promise<AgentActionResult>((resolve) => {\n      child.once(\"spawn\", () => {\n        resolve({ ok: true, value: { agent: \"cursor\" } });\n      });\n      child.once(\"error\", () => {\n        resolve(launchFailure());\n      });\n    });\n  }\n}\n"]}

package/dist/cursor.js

@@ -0,0 +1,57 @@
+import { spawn as nodeSpawn } from "node:child_process";
+import { PathExecutableResolver, } from "./executable.js";
+const CURSOR_COMMAND = "cursor";
+const defaultSpawn = (executable, args, options) => nodeSpawn(executable, [...args], options);
+function launchFailure() {
+    return {
+        ok: false,
+        error: {
+            code: "launch-failed",
+            agent: "cursor",
+            command: CURSOR_COMMAND,
+        },
+    };
+}
+export class CursorLauncher {
+    #executableResolver;
+    #spawn;
+    constructor(options = {}) {
+        this.#executableResolver =
+            options.executableResolver ?? new PathExecutableResolver();
+        this.#spawn = options.spawn ?? defaultSpawn;
+    }
+    async launch(prototypePath) {
+        const executable = await this.#executableResolver.resolve(CURSOR_COMMAND);
+        if (executable === null) {
+            return {
+                ok: false,
+                error: {
+                    code: "missing-command",
+                    agent: "cursor",
+                    command: CURSOR_COMMAND,
+                },
+            };
+        }
+        let child;
+        try {
+            child = this.#spawn(executable, [prototypePath], {
+                detached: true,
+                shell: false,
+                stdio: "ignore",
+            });
+            child.unref();
+        }
+        catch {
+            return launchFailure();
+        }
+        return new Promise((resolve) => {
+            child.once("spawn", () => {
+                resolve({ ok: true, value: { agent: "cursor" } });
+            });
+            child.once("error", () => {
+                resolve(launchFailure());
+            });
+        });
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../src/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AAK3E,OAAO,EACL,sBAAsB,GAEvB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,cAAc,GAAG,QAAQ,CAAC;AAyBhC,MAAM,YAAY,GAAgB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC9D,SAAS,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAE5C,SAAS,aAAa;IACpB,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE;YACL,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,cAAc;SACxB;KAC0B,CAAC;AAChC,CAAC;AAED,MAAM,OAAO,cAAc;IAChB,mBAAmB,CAAyB;IAC5C,MAAM,CAAc;IAE7B,YAAY,OAAO,GAA0B,EAAE;QAC7C,IAAI,CAAC,mBAAmB;YACtB,OAAO,CAAC,kBAAkB,IAAI,IAAI,sBAAsB,EAAE,CAAC;QAC7D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,aAAqB;QAChC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC1E,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,iBAAiB;oBACvB,KAAK,EAAE,QAAQ;oBACf,OAAO,EAAE,cAAc;iBACxB;aAC0B,CAAC;QAChC,CAAC;QAED,IAAI,KAAyB,CAAC;QAC9B,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,aAAa,CAAC,EAAE;gBAC/C,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;YACH,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,aAAa,EAAE,CAAC;QACzB,CAAC;QAED,OAAO,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,EAAE;YAChD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACvB,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACvB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { spawn as nodeSpawn, type ChildProcess } from \"node:child_process\";\nimport {\n  type AgentActionResult,\n  type AgentLaunchValue,\n} from \"@ebay-dt/bonfire-core\";\nimport {\n  PathExecutableResolver,\n  type ExecutableResolverLike,\n} from \"./executable.js\";\n\nconst CURSOR_COMMAND = \"cursor\";\n\nexport type CursorSpawnOptions = {\n  detached: true;\n  shell: false;\n  stdio: \"ignore\";\n};\n\nexport type CursorChildProcess = Pick<ChildProcess, \"once\" | \"unref\">;\n\nexport type CursorSpawn = (\n  executable: string,\n  args: readonly string[],\n  options: CursorSpawnOptions,\n) => CursorChildProcess;\n\nexport type CursorLauncherOptions = {\n  executableResolver?: ExecutableResolverLike;\n  spawn?: CursorSpawn;\n};\n\nexport interface CursorLauncherLike {\n  launch(prototypePath: string): Promise<AgentActionResult<AgentLaunchValue>>;\n}\n\nconst defaultSpawn: CursorSpawn = (executable, args, options) =>\n  nodeSpawn(executable, [...args], options);\n\nfunction launchFailure() {\n  return {\n    ok: false,\n    error: {\n      code: \"launch-failed\",\n      agent: \"cursor\",\n      command: CURSOR_COMMAND,\n    },\n  } satisfies AgentActionResult;\n}\n\nexport class CursorLauncher implements CursorLauncherLike {\n  readonly #executableResolver: ExecutableResolverLike;\n  readonly #spawn: CursorSpawn;\n\n  constructor(options: CursorLauncherOptions = {}) {\n    this.#executableResolver =\n      options.executableResolver ?? new PathExecutableResolver();\n    this.#spawn = options.spawn ?? defaultSpawn;\n  }\n\n  async launch(prototypePath: string) {\n    const executable = await this.#executableResolver.resolve(CURSOR_COMMAND);\n    if (executable === null) {\n      return {\n        ok: false,\n        error: {\n          code: \"missing-command\",\n          agent: \"cursor\",\n          command: CURSOR_COMMAND,\n        },\n      } satisfies AgentActionResult;\n    }\n\n    let child: CursorChildProcess;\n    try {\n      child = this.#spawn(executable, [prototypePath], {\n        detached: true,\n        shell: false,\n        stdio: \"ignore\",\n      });\n      child.unref();\n    } catch {\n      return launchFailure();\n    }\n\n    return new Promise<AgentActionResult>((resolve) => {\n      child.once(\"spawn\", () => {\n        resolve({ ok: true, value: { agent: \"cursor\" } });\n      });\n      child.once(\"error\", () => {\n        resolve(launchFailure());\n      });\n    });\n  }\n}\n"]}