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

package/README.md

@@ -28,6 +28,40 @@ 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 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.
+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 +102,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 +124,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"}

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":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,GAK3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAA+B,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,cAAc,EAA2B,MAAM,aAAa,CAAC;AACtE,OAAO,EACL,sBAAsB,GAEvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,GAErB,MAAM,kBAAkB,CAAC;AA8B1B,SAAS,OAAO,CACd,IAA8B,EAC9B,MAAM,GAAiD,EAAE;IAEzD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE;KACC,CAAC;AAChC,CAAC;AAED,SAAS,YAAY,CAAC,QAAiB;IACrC,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC9C,kBAAkB,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,OAAO,qBAAqB;IACvB,QAAQ,CAA0C;IAClD,QAAQ,CAAuB;IAC/B,YAAY,CAA2B;IACvC,OAAO,CAAqB;IAC5B,WAAW,CAAyB;IAE7C,YAAY,OAAqC;QAC/C,MAAM,kBAAkB,GACtB,OAAO,CAAC,kBAAkB,IAAI,IAAI,sBAAsB,EAAE,CAAC;QAC7D,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,YAAY;YACf,OAAO,CAAC,WAAW,IAAI,IAAI,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,WAAW;YACd,OAAO,CAAC,UAAU,IAAI,IAAI,kBAAkB,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,UAAU,CACd,QAAiB,EACjB,KAAc,EACd,KAAgC;QAEhC,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC3D,CAAC;QAED,IAAI,eAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QACzD,CAAC;QAED,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,KAAK,aAAa,CAAC,KAAK,EAAE,CAAC;YAChD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACrD,CAAC;QAED,OAAO;YACL,EAAE,EAAE,IAAI;YACR,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,eAAe;YACtB,aAAa,EAAE,IAAI,CACjB,IAAI,CAAC,QAAQ,CAAC,aAAa,EAC3B,eAAe,CAAC,GAAG,CAAC,KAAK,EACzB,eAAe,CAAC,GAAG,CAAC,IAAI,CACzB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAiB,EAAE,KAAc;QAClD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CACtC,QAAQ,EACR,KAAK,EACL,qBAAqB,CACtB,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,EAAE;YAAE,OAAO,UAAU,CAAC,MAAM,CAAC;QAE7C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,QAAiB,EAAE,KAAc;QACtD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CACtC,QAAQ,EACR,KAAK,EACL,0BAA0B,CAC3B,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,EAAE;YAAE,OAAO,UAAU,CAAC,MAAM,CAAC;QAE7C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAChD,UAAU,CAAC,KAAK,CAAC,QAAQ,CAC1B,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAEpC,IAAI,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,WAAW,CAAC;YAChB,IAAI,CAAC;gBACH,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,OAAO,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,QAAQ,GAAG,WAAW,CAAC,iBAAiB,CAAC;YACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE;oBACxD,iBAAiB,EAAE,QAAQ;iBAC5B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,OAAO,CAAC,eAAe,EAAE;oBAC9B,KAAK,EAAE,aAAa;oBACpB,QAAQ;iBACT,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAC5B,QAAQ,EACR,UAAU,CAAC,aAAa,EACxB,SAAS,CACV,CAAC;IACJ,CAAC;CACF"}

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"}

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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"}

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"}

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"}

package/dist/deployment-provider.d.ts

@@ -0,0 +1,32 @@
+import type { DeploymentReadyState } from "@ebay-dt/bonfire-core";
+/**
+ * The normalized result returned by a deployment provider. `url` is the
+ * deployment-root URL; the lifecycle service adds the active prototype route.
+ */
+export type DeploymentProviderResult = {
+    url: string;
+    deploymentId: string;
+    readyState: DeploymentReadyState;
+};
+/** Server-side transport boundary for creating an application deployment. */
+export interface DeploymentProvider {
+    deploy(input: {
+        applicationId: string;
+        login: string;
+    }): Promise<DeploymentProviderResult>;
+}
+export type CreateDeploymentProviderOptions = {
+    endpoint: string;
+    timeoutMs?: number;
+};
+export type DeploymentProviderErrorKind = "timeout" | "service-failure" | "invalid-response" | "invalid-url" | "invalid-configuration";
+/**
+ * Safe provider failure classification. It intentionally carries no response
+ * body, endpoint credentials, or unbounded service diagnostics.
+ */
+export declare class DeploymentProviderError extends Error {
+    readonly kind: DeploymentProviderErrorKind;
+    constructor(kind: DeploymentProviderErrorKind);
+}
+export declare function createDeploymentProvider({ endpoint: configuredEndpoint, timeoutMs: configuredTimeout, }: CreateDeploymentProviderOptions): DeploymentProvider;
+//# sourceMappingURL=deployment-provider.d.ts.map

package/dist/deployment-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-provider.d.ts","sourceRoot":"","sources":["../src/deployment-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQlE;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,KAAK,EAAE;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GACnC,SAAS,GACT,iBAAiB,GACjB,kBAAkB,GAClB,aAAa,GACb,uBAAuB,CAAC;AAE5B;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAE3C,YAAY,IAAI,EAAE,2BAA2B,EAI5C;CACF;AA8KD,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,iBAAiB,GAC7B,EAAE,+BAA+B,GAAG,kBAAkB,CA2CtD"}