@executioncontrolprotocol/cli 0.10.0 → 0.11.0

package/dist/lib/up/create-daemon.js

@@ -0,0 +1,63 @@
+import { createServer } from "node:http";
+import { environment, extension } from "@executioncontrolprotocol/node";
+import "@executioncontrolprotocol/extension-ollama";
+import { registerOllamaExtension } from "@executioncontrolprotocol/extension-ollama";
+import { DEFAULT_CORS_ORIGINS, DEFAULT_ECP_UP_HOST, DEFAULT_ECP_UP_PORT, DEFAULT_OLLAMA_URL, } from "./constants.js";
+import { createUpRequestHandler } from "./handle-request.js";
+/**
+ * Start the local ECP daemon (`ecp up`).
+ * @category CLI
+ */
+export async function startEcpUpDaemon(options) {
+    const port = options.port ?? DEFAULT_ECP_UP_PORT;
+    const host = options.host ?? DEFAULT_ECP_UP_HOST;
+    const ollamaUrl = options.ollamaUrl ?? DEFAULT_OLLAMA_URL;
+    const token = options.token;
+    await registerOllamaExtension();
+    const env = (await environment("ecp-up")).withExtensions([
+        extension("@executioncontrolprotocol/ollama").with({
+            baseURL: ollamaUrl,
+        }),
+    ]);
+    const ecp = await env.init();
+    const allowOrigins = new Set([
+        ...DEFAULT_CORS_ORIGINS,
+        ...(options.corsOrigins ?? []),
+    ]);
+    const handler = createUpRequestHandler({
+        ecp,
+        allowOrigins,
+        token,
+        ollamaUrl,
+    });
+    const server = createServer((req, res) => {
+        void handler(req, res).catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            if (!res.headersSent) {
+                res.writeHead(500, { "Content-Type": "application/json" });
+            }
+            res.end(JSON.stringify({ error: message }));
+        });
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(port, host, () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    return {
+        server,
+        ecp,
+        port,
+        host,
+        token,
+        close: async () => {
+            await new Promise((resolve, reject) => {
+                server.close((err) => (err ? reject(err) : resolve()));
+            });
+            await ecp.terminate();
+        },
+    };
+}
+//# sourceMappingURL=create-daemon.js.map

package/dist/lib/up/create-daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-daemon.js","sourceRoot":"","sources":["../../../src/lib/up/create-daemon.ts"],"names":[],"mappings":"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"}

package/dist/lib/up/handle-request.d.ts

@@ -0,0 +1,19 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { Ecp } from "@executioncontrolprotocol/core";
+/** Dependencies for {@link createUpRequestHandler}. @category CLI */
+export interface UpRequestHandlerOptions {
+    /** Operational ECP instance. */
+    ecp: Ecp;
+    /** Allowlisted CORS origins. */
+    allowOrigins: ReadonlySet<string>;
+    /** Pairing token for `/v1/*`. */
+    token: string;
+    /** Ollama base URL used for `/health` reachability. */
+    ollamaUrl: string;
+}
+/**
+ * Create the HTTP request handler for `ecp up`.
+ * @category CLI
+ */
+export declare function createUpRequestHandler(options: UpRequestHandlerOptions): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+//# sourceMappingURL=handle-request.d.ts.map

package/dist/lib/up/handle-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-request.d.ts","sourceRoot":"","sources":["../../../src/lib/up/handle-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAA;AAOzD,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,GAAG,EAAE,GAAG,CAAA;IACR,gCAAgC;IAChC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,IAInE,KAAK,eAAe,EACpB,KAAK,cAAc,KAClB,OAAO,CAAC,IAAI,CAAC,CAwCjB"}

package/dist/lib/up/handle-request.js

@@ -0,0 +1,49 @@
+import { listOllamaModels } from "@executioncontrolprotocol/extension-ollama";
+import { handleInvokePost } from "../http/handle-invoke.js";
+import { writeJson } from "../http/write-json.js";
+import { ECP_UP_VERSION } from "./constants.js";
+import { readBearerToken, setCorsAndPna } from "./cors.js";
+/**
+ * Create the HTTP request handler for `ecp up`.
+ * @category CLI
+ */
+export function createUpRequestHandler(options) {
+    const { ecp, allowOrigins, token, ollamaUrl } = options;
+    return async function handleUpRequest(req, res) {
+        setCorsAndPna(req, res, allowOrigins);
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "127.0.0.1"}`);
+        const pathname = url.pathname;
+        if (req.method === "GET" && pathname === "/health") {
+            let ollamaReachable = false;
+            try {
+                await listOllamaModels(ollamaUrl, { signal: AbortSignal.timeout(2000) });
+                ollamaReachable = true;
+            }
+            catch {
+                ollamaReachable = false;
+            }
+            writeJson(res, 200, {
+                ok: true,
+                version: ECP_UP_VERSION,
+                ollamaReachable,
+            });
+            return;
+        }
+        if (req.method === "POST" && pathname === "/v1/invoke") {
+            const presented = readBearerToken(req);
+            if (!presented || presented !== token) {
+                writeJson(res, 401, { error: "Unauthorized" });
+                return;
+            }
+            await handleInvokePost(ecp, req, res);
+            return;
+        }
+        writeJson(res, 404, { error: "Not found" });
+    };
+}
+//# sourceMappingURL=handle-request.js.map

package/dist/lib/up/handle-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-request.js","sourceRoot":"","sources":["../../../src/lib/up/handle-request.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAA;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAc1D;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgC;IACrE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IAEvD,OAAO,KAAK,UAAU,eAAe,CACnC,GAAoB,EACpB,GAAmB;QAEnB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,YAAY,CAAC,CAAA;QAErC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;YAClB,GAAG,CAAC,GAAG,EAAE,CAAA;YACT,OAAM;QACR,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAA;QAChF,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAA;QAE7B,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnD,IAAI,eAAe,GAAG,KAAK,CAAA;YAC3B,IAAI,CAAC;gBACH,MAAM,gBAAgB,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACxE,eAAe,GAAG,IAAI,CAAA;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe,GAAG,KAAK,CAAA;YACzB,CAAC;YACD,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE;gBAClB,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,cAAc;gBACvB,eAAe;aAChB,CAAC,CAAA;YACF,OAAM;QACR,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YACvD,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;YACtC,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;gBACtC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAA;gBAC9C,OAAM;YACR,CAAC;YACD,MAAM,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;YACrC,OAAM;QACR,CAAC;QAED,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;IAC7C,CAAC,CAAA;AACH,CAAC"}

package/dist/lib/up/open-browser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Open a URL in the default browser (best-effort, fire-and-forget).
+ * @category CLI
+ */
+export declare function openBrowserUrl(url: string): void;
+/**
+ * Build the demo open URL with pairing token (and optional bridge base).
+ * @category CLI
+ */
+export declare function buildDemoOpenUrl(openUrl: string, options: {
+    token: string;
+    bridgeBaseURL?: string;
+}): string;
+/**
+ * Origin (scheme + host + port) for CORS allowlisting from an open URL.
+ * @category CLI
+ */
+export declare function originFromUrl(raw: string): string | undefined;
+//# sourceMappingURL=open-browser.d.ts.map

package/dist/lib/up/open-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../../../src/lib/up/open-browser.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAWhD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,MAAM,CAOR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO7D"}

package/dist/lib/up/open-browser.js

@@ -0,0 +1,43 @@
+import { spawn } from "node:child_process";
+/**
+ * Open a URL in the default browser (best-effort, fire-and-forget).
+ * @category CLI
+ */
+export function openBrowserUrl(url) {
+    const platform = process.platform;
+    if (platform === "win32") {
+        spawn("cmd", ["/c", "start", "", url], { detached: true, stdio: "ignore" }).unref();
+        return;
+    }
+    if (platform === "darwin") {
+        spawn("open", [url], { detached: true, stdio: "ignore" }).unref();
+        return;
+    }
+    spawn("xdg-open", [url], { detached: true, stdio: "ignore" }).unref();
+}
+/**
+ * Build the demo open URL with pairing token (and optional bridge base).
+ * @category CLI
+ */
+export function buildDemoOpenUrl(openUrl, options) {
+    const url = new URL(openUrl);
+    url.searchParams.set("token", options.token);
+    if (options.bridgeBaseURL) {
+        url.searchParams.set("bridge", options.bridgeBaseURL);
+    }
+    return url.toString();
+}
+/**
+ * Origin (scheme + host + port) for CORS allowlisting from an open URL.
+ * @category CLI
+ */
+export function originFromUrl(raw) {
+    try {
+        const url = new URL(raw);
+        return url.origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=open-browser.js.map

package/dist/lib/up/open-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.js","sourceRoot":"","sources":["../../../src/lib/up/open-browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IACjC,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;QACnF,OAAM;IACR,CAAC;IACD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;QACjE,OAAM;IACR,CAAC;IACD,KAAK,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,OAAkD;IAElD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC5C,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IACvD,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QACxB,OAAO,GAAG,CAAC,MAAM,CAAA;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/lib/up/read-body.d.ts

@@ -0,0 +1,3 @@
+/** Re-export for callers that still import from the up path. @category CLI */
+export { readRequestBody } from "../http/read-body.js";
+//# sourceMappingURL=read-body.d.ts.map

package/dist/lib/up/read-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-body.d.ts","sourceRoot":"","sources":["../../../src/lib/up/read-body.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/lib/up/read-body.js

@@ -0,0 +1,3 @@
+/** Re-export for callers that still import from the up path. @category CLI */
+export { readRequestBody } from "../http/read-body.js";
+//# sourceMappingURL=read-body.js.map

package/dist/lib/up/read-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-body.js","sourceRoot":"","sources":["../../../src/lib/up/read-body.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@executioncontrolprotocol/cli",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "ECP command-line interface",
   "license": "Apache-2.0",
   "type": "module",
@@ -19,18 +19,19 @@
     "start": "node ./bin/dev.js"
   },
   "peerDependencies": {
-    "@executioncontrolprotocol/core": "^0.10.0",
-    "@executioncontrolprotocol/types": "^0.10.0",
+    "@executioncontrolprotocol/core": "^0.11.0",
+    "@executioncontrolprotocol/types": "^0.11.0",
     "zod": "^3.24.0"
   },
   "dependencies": {
-    "@executioncontrolprotocol/node": "0.10.0",
-    "@executioncontrolprotocol/secrets": "0.10.0",
+    "@executioncontrolprotocol/node": "0.11.0",
+    "@executioncontrolprotocol/secrets": "0.11.0",
+    "@executioncontrolprotocol/extension-ollama": "0.11.0",
     "@oclif/core": "^4.10.0"
   },
   "devDependencies": {
-    "@executioncontrolprotocol/core": "0.10.0",
-    "@executioncontrolprotocol/types": "0.10.0",
+    "@executioncontrolprotocol/core": "0.11.0",
+    "@executioncontrolprotocol/types": "0.11.0",
     "typescript": "^5.7.0",
     "zod": "^3.24.0"
   },