poe-code 3.0.121 → 3.0.122

package/dist/sdk/launch.d.ts

@@ -0,0 +1,45 @@
+import { type ManagedProcessRecord, type ProcessSpec } from "@poe-code/process-launcher";
+export type { ManagedProcessRecord, ProcessSpec } from "@poe-code/process-launcher";
+export interface LaunchBaseOptions {
+    cwd?: string;
+    homeDir?: string;
+    variables?: Record<string, string | undefined>;
+}
+export interface StartLaunchOptions extends LaunchBaseOptions {
+    spec: ProcessSpec;
+}
+export interface StopLaunchOptions extends LaunchBaseOptions {
+    id: string;
+    force?: boolean;
+}
+export interface RestartLaunchOptions extends LaunchBaseOptions {
+    id: string;
+}
+export type ListLaunchesOptions = LaunchBaseOptions;
+export interface ReadLaunchLogsOptions extends LaunchBaseOptions {
+    id: string;
+    lines?: number;
+    stream?: "stdout" | "stderr";
+}
+export interface FollowLaunchLogsSdkOptions extends LaunchBaseOptions {
+    id: string;
+    lines?: number;
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+    stream?: "stdout" | "stderr";
+}
+export interface RemoveLaunchOptions extends LaunchBaseOptions {
+    id: string;
+}
+export interface RunLaunchDaemonOptions extends LaunchBaseOptions {
+    id: string;
+    signal?: AbortSignal;
+}
+export declare function startLaunch(options: StartLaunchOptions): Promise<ManagedProcessRecord>;
+export declare function stopLaunch(options: StopLaunchOptions): Promise<ManagedProcessRecord | null>;
+export declare function restartLaunch(options: RestartLaunchOptions): Promise<ManagedProcessRecord>;
+export declare function listLaunches(options?: ListLaunchesOptions): Promise<ManagedProcessRecord[]>;
+export declare function readLaunchLogs(options: ReadLaunchLogsOptions): Promise<string[]>;
+export declare function followLaunchLogs(options: FollowLaunchLogsSdkOptions): AsyncIterable<string>;
+export declare function removeLaunch(options: RemoveLaunchOptions): Promise<void>;
+export declare function runLaunchDaemon(options: RunLaunchDaemonOptions): Promise<void>;

package/dist/sdk/launch.js

@@ -0,0 +1,165 @@
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { followManagedLogs, listManagedProcesses, readManagedLogs, removeManagedProcess, restartManagedProcess, runManagedProcess, startManagedProcess, stopManagedProcess } from "@poe-code/process-launcher";
+import { createHostRunner, detectEngine } from "@poe-code/process-runner";
+import { getCurrentExecutionContext } from "../utils/execution-context.js";
+export async function startLaunch(options) {
+    const homeDir = resolveHomeDir(options.homeDir);
+    const cwd = options.cwd ?? process.cwd();
+    const variables = options.variables ?? process.env;
+    const executionContext = getCurrentExecutionContext(import.meta.url);
+    const runner = createHostRunner({ detached: true });
+    return await startManagedProcess({
+        baseDir: resolveLaunchBaseDir(homeDir),
+        spec: options.spec,
+        spawnDaemon: async (id) => {
+            const handle = runner.exec({
+                args: [...executionContext.command.args, "launch", "__run", id],
+                command: executionContext.command.command,
+                cwd,
+                env: objectToEnv(variables),
+                stderr: "inherit",
+                stdin: "ignore",
+                stdout: "inherit"
+            });
+            return handle.pid;
+        }
+    });
+}
+export async function stopLaunch(options) {
+    const homeDir = resolveHomeDir(options.homeDir);
+    return await stopManagedProcess({
+        baseDir: resolveLaunchBaseDir(homeDir),
+        force: options.force,
+        id: options.id,
+        signalProcess: sendSignalToManagedProcess,
+        stopRuntimeArtifacts: async ({ record, force }) => {
+            await stopDockerArtifacts(record, force);
+        }
+    });
+}
+export async function restartLaunch(options) {
+    const homeDir = resolveHomeDir(options.homeDir);
+    const cwd = options.cwd ?? process.cwd();
+    const variables = options.variables ?? process.env;
+    const executionContext = getCurrentExecutionContext(import.meta.url);
+    const runner = createHostRunner({ detached: true });
+    return await restartManagedProcess({
+        baseDir: resolveLaunchBaseDir(homeDir),
+        id: options.id,
+        signalProcess: sendSignalToManagedProcess,
+        spawnDaemon: async (id) => {
+            const handle = runner.exec({
+                args: [...executionContext.command.args, "launch", "__run", id],
+                command: executionContext.command.command,
+                cwd,
+                env: objectToEnv(variables),
+                stderr: "inherit",
+                stdin: "ignore",
+                stdout: "inherit"
+            });
+            return handle.pid;
+        },
+        stopRuntimeArtifacts: async ({ record, force }) => {
+            await stopDockerArtifacts(record, force);
+        }
+    });
+}
+export async function listLaunches(options = {}) {
+    return await listManagedProcesses({
+        baseDir: resolveLaunchBaseDir(resolveHomeDir(options.homeDir))
+    });
+}
+export async function readLaunchLogs(options) {
+    return await readManagedLogs({
+        baseDir: resolveLaunchBaseDir(resolveHomeDir(options.homeDir)),
+        id: options.id,
+        lines: options.lines,
+        stream: options.stream
+    });
+}
+export function followLaunchLogs(options) {
+    const forwarded = {
+        baseDir: resolveLaunchBaseDir(resolveHomeDir(options.homeDir)),
+        id: options.id,
+        lines: options.lines,
+        pollIntervalMs: options.pollIntervalMs,
+        signal: options.signal,
+        stream: options.stream
+    };
+    return followManagedLogs(forwarded);
+}
+export async function removeLaunch(options) {
+    await removeManagedProcess({
+        baseDir: resolveLaunchBaseDir(resolveHomeDir(options.homeDir)),
+        id: options.id,
+        removeRuntimeArtifacts: async ({ record }) => {
+            await removeDockerArtifacts(record);
+        }
+    });
+}
+export async function runLaunchDaemon(options) {
+    await runManagedProcess({
+        baseDir: resolveLaunchBaseDir(resolveHomeDir(options.homeDir)),
+        id: options.id,
+        signal: options.signal
+    });
+}
+function resolveLaunchBaseDir(homeDir) {
+    return path.join(homeDir, ".poe-code", "launch");
+}
+function resolveHomeDir(homeDir) {
+    if (homeDir) {
+        return homeDir;
+    }
+    return process.env.HOME ?? process.cwd();
+}
+function sendSignalToManagedProcess(pid, signal) {
+    if (process.platform === "win32") {
+        process.kill(pid, signal);
+        return;
+    }
+    try {
+        process.kill(-pid, signal);
+    }
+    catch (error) {
+        if (!isMissingProcessGroupError(error)) {
+            throw error;
+        }
+        process.kill(pid, signal);
+    }
+}
+function isMissingProcessGroupError(error) {
+    return error instanceof Error && "code" in error && error.code === "ESRCH";
+}
+function objectToEnv(variables) {
+    const env = {};
+    for (const [key, value] of Object.entries(variables)) {
+        if (value !== undefined) {
+            env[key] = value;
+        }
+    }
+    return env;
+}
+async function stopDockerArtifacts(record, force) {
+    if (!record.spec?.docker?.containerName) {
+        return;
+    }
+    const engine = resolveEngine(record.spec.docker.engine);
+    const command = force ? "kill" : "stop";
+    spawnSync(engine, [command, record.spec.docker.containerName], { stdio: "ignore" });
+}
+async function removeDockerArtifacts(record) {
+    if (!record.spec?.docker?.containerName) {
+        return;
+    }
+    const engine = resolveEngine(record.spec.docker.engine);
+    spawnSync(engine, ["rm", "-f", record.spec.docker.containerName], { stdio: "ignore" });
+}
+function resolveEngine(engine) {
+    if (engine) {
+        return engine;
+    }
+    return detectEngine();
+}
+//# sourceMappingURL=launch.js.map

package/dist/sdk/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../src/sdk/launch.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAInB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAe,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAgD3E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;IACnD,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpD,OAAO,MAAM,mBAAmB,CAAC;QAC/B,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC;QACtC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACxB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;gBACzB,IAAI,EAAE,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO;gBACzC,GAAG;gBACH,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC;gBAC3B,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,QAAQ;gBACf,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,GAAG,CAAC;QACpB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B;IACzD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,MAAM,kBAAkB,CAAC;QAC9B,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,aAAa,EAAE,0BAA0B;QACzC,oBAAoB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;YAChD,MAAM,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA6B;IAC/D,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC;IACnD,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpD,OAAO,MAAM,qBAAqB,CAAC;QACjC,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC;QACtC,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,aAAa,EAAE,0BAA0B;QACzC,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACxB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;gBACzB,IAAI,EAAE,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO;gBACzC,GAAG;gBACH,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC;gBAC3B,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,QAAQ;gBACf,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,GAAG,CAAC;QACpB,CAAC;QACD,oBAAoB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;YAChD,MAAM,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAA+B,EAAE;IAClE,OAAO,MAAM,oBAAoB,CAAC;QAChC,OAAO,EAAE,oBAAoB,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA8B;IACjE,OAAO,MAAM,eAAe,CAAC;QAC3B,OAAO,EAAE,oBAAoB,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9D,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAmC;IAClE,MAAM,SAAS,GAA6B;QAC1C,OAAO,EAAE,oBAAoB,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9D,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;IACF,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,oBAAoB,CAAC;QACzB,OAAO,EAAE,oBAAoB,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9D,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,sBAAsB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YAC3C,MAAM,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA+B;IACnE,MAAM,iBAAiB,CAAC;QACtB,OAAO,EAAE,oBAAoB,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9D,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,cAAc,CAAC,OAA2B;IACjD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,0BAA0B,CAAC,GAAW,EAAE,MAAsB;IACrE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,0BAA0B,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IAChD,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;AAC7E,CAAC;AAED,SAAS,WAAW,CAClB,SAA6C;IAE7C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,MAA4B,EAAE,KAAc;IAC7E,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACxC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,MAA4B;IAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACxC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxD,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,aAAa,CAAC,MAA0B;IAC/C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC"}

package/dist/sdk/process-launcher.d.ts

@@ -0,0 +1,2 @@
+export { createLogWriter, createStateStore, createSupervisor, waitForReady } from "@poe-code/process-launcher";
+export type { LauncherFileSystem, LogWriter, ManagedProcessRecord, ProcessSpec, ProcessState, ProcessStatus, ReadyCheck, RestartPolicy, StateStore, Supervisor, SupervisorOptions } from "@poe-code/process-launcher";

package/dist/sdk/process-launcher.js

@@ -0,0 +1,2 @@
+export { createLogWriter, createStateStore, createSupervisor, waitForReady } from "@poe-code/process-launcher";
+//# sourceMappingURL=process-launcher.js.map

package/dist/sdk/process-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-launcher.js","sourceRoot":"","sources":["../../src/sdk/process-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACb,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poe-code",
-  "version": "3.0.121",
+  "version": "3.0.122",
   "description": "CLI tool to configure Poe API for developer workflows.",
   "type": "module",
   "main": "./dist/index.js",
@@ -115,7 +115,9 @@
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.54.0",
     "vitest": "^4.0.18",
-    "@poe-code/experiment-loop": "*"
+    "@poe-code/experiment-loop": "*",
+    "@poe-code/process-launcher": "*",
+    "@poe-code/process-runner": "*"
   },
   "repository": {
     "type": "git",