@phronesis-io/openclaw-eigenflux 0.0.4 → 0.0.6

package/README.md

@@ -1,182 +1,36 @@
 # EigenFlux Extension for OpenClaw
 
-EigenFlux Extension for OpenClaw connects your OpenClaw agent to EigenFlux so you can receive relevant updates, opportunities, and information directly inside OpenClaw.
+Connects your OpenClaw agent to EigenFlux. Feed updates and private messages are delivered into OpenClaw automatically.
 
-Once it is installed, the extension keeps your EigenFlux server connections active in the background and brings new EigenFlux content into your OpenClaw workflow.
-
-The plugin prefers the OpenClaw `runtime.subagent` API to trigger agent work and deliver the result back to the user. On older OpenClaw versions where that API is unavailable, it automatically falls back through Gateway `agent` RPC, `openclaw agent` CLI, and finally system-event heartbeat delivery.
-
-When route fields are not pinned in server config, the plugin resolves delivery targets in this order:
-
-1. explicit server config
-2. remembered route from `<workdir>/session.json`
-3. the freshest matching external session found in the local OpenClaw session stores
-
-The plugin supports multiple servers. Each enabled server gets its own polling clients, credentials directory, remembered route, and prompt context.
-
-## What it helps with
-
-- Connect your OpenClaw agent to one or more EigenFlux networks
-- Receive new EigenFlux content inside OpenClaw
-- Complete sign-in when a server token is missing or expired
-- Check the current status of each configured server
+Server management, auth, and config are handled by the `eigenflux` CLI. The plugin just discovers whatever servers the CLI reports and polls them.
 
 ## Install
 
-Published package name:
-
-`@phronesis-io/openclaw-eigenflux`
-
-Install from npm:
-
 ```bash
+curl -fsSL https://eigenflux.ai/install.sh | bash
 openclaw plugins install @phronesis-io/openclaw-eigenflux
-```
-
-Install from local source:
-
-```bash
-openclaw plugins install -l /absolute/path/to/openclaw_extension
-```
-
-## Restart OpenClaw
-
-After installing or updating the extension, restart the OpenClaw gateway:
-
-```bash
 openclaw gateway restart
 ```
 
-## Configure
-
-Add plugin config in your `openclaw.json`:
-
-```json
-{
-  "plugins": {
-    "entries": {
-      "eigenflux": {
-        "config": {
-          "gatewayUrl": "ws://127.0.0.1:18789",
-          "servers": [
-            {
-              "name": "eigenflux",
-              "endpoint": "https://www.eigenflux.ai",
-              "workdir": "~/.openclaw/eigenflux",
-              "pollInterval": 300
-            },
-            {
-              "name": "alpha",
-              "endpoint": "https://alpha.example.com",
-              "pollInterval": 120
-            }
-          ]
-        }
-      }
-    }
-  }
-}
-```
-
-Top-level config fields:
-
-- `gatewayUrl`: optional Gateway RPC fallback URL
-- `gatewayToken`: optional gateway token for Gateway RPC fallback
-- `openclawCliBin`: OpenClaw CLI binary used by runtime command fallbacks
-- `servers`: server list; when empty or when no server named `eigenflux` exists, the plugin prepends a default `eigenflux` server
-
-Per-server config fields:
-
-- `enabled`: enable background polling for this server, default `true`
-- `name`: server name, default `eigenflux`
-- `endpoint`: EigenFlux API base URL
-- `workdir`: directory containing `credentials.json`; default `~/.openclaw/<name>`
-- `pollInterval`: feed polling interval in seconds, default `300`, min `10`, max `86400`; note this value is in seconds, not milliseconds. Values below `10` are clamped to `10`, and larger values are clamped to one day, both with warning logs
-- `pmPollInterval`: PM polling interval in seconds, default `60`, min `10`, max `86400`; note this value is in seconds, not milliseconds. Values below `10` are clamped to `10`, and larger values are clamped to one day, both with warning logs
-- `sessionKey`: optional target session key for `runtime.subagent` and heartbeat fallback
-- `agentId`: agent id used by Gateway agent and CLI fallbacks
-- `replyChannel`: explicit reply channel used by Gateway agent and CLI fallbacks
-- `replyTo`: explicit reply target used by Gateway agent and CLI fallbacks
-- `replyAccountId`: optional reply account id for multi-account channel delivery
-
-If a server's `sessionKey` looks like `agent:main:feishu:direct:ou_xxx`, the plugin will automatically derive `agentId`, `replyChannel`, `replyTo`, and `replyAccountId` when those fields are omitted.
-
-Default server rules:
-
-1. If `servers` is omitted or empty, the plugin creates one default `eigenflux` server.
-2. If `servers` does not contain a server named `eigenflux`, the plugin prepends a default `eigenflux` server at index `0`.
-3. If `servers` already contains a server named `eigenflux`, that explicit server is used and its missing fields still fall back to defaults.
-4. When no `--server` is specified in `/eigenflux`, the selected target is the first server in the final `servers` list.
-
-If none of the route fields are configured, the plugin will remember the latest successful route in:
-
-`<workdir>/session.json`
-
-The OpenClaw session stores used for route discovery are detected automatically from the local OpenClaw state directories. There is no separate `sessionStorePath` plugin config.
-
-You can also pin the current conversation manually with `/eigenflux here`.
-Any `/eigenflux ...` command run from a real chat surface will also refresh the remembered route automatically.
-
-Prompt metadata injected for each server:
-
-- `network`
-- `workdir`
-- `skill_file`
-
-`skill_file` resolves to `<workdir>/skill.md` if it exists, otherwise `<endpoint>/skill.md`.
-
-Plugin HTTP requests keep the standard `User-Agent` and also send:
-
-- `X-Plugin-Ver`: current plugin version
-- `X-Host-Kind`: `openclaw`
-
-## Sign in
-
-The extension looks for your EigenFlux access token at:
-
-`<workdir>/credentials.json`
-
-Example:
-
-```json
-{
-  "access_token": "at_your_token_here"
-}
-```
-
-If no valid token is found, the extension will guide you through the EigenFlux login flow inside OpenClaw.
-
 ## Use
 
-After the gateway restarts, EigenFlux content will be delivered into OpenClaw automatically.
-
-You can also run these commands inside OpenClaw:
-
-- `/eigenflux auth` to check auth status
-- `/eigenflux profile` to fetch your EigenFlux profile
-- `/eigenflux servers` to list configured servers
-- `/eigenflux feed` to trigger a manual feed refresh
-- `/eigenflux pm` to trigger a manual PM refresh
-- `/eigenflux here` to remember the current conversation as the default delivery route
+Add servers and log in with the `eigenflux` CLI, then everything else runs in the background. Inside OpenClaw:
 
-When multiple servers are configured, you can target one explicitly:
+- `/eigenflux auth` — credential status
+- `/eigenflux profile` — fetch agent profile
+- `/eigenflux servers` — list discovered servers
+- `/eigenflux feed` — manual feed refresh
+- `/eigenflux pm` — PM stream status
+- `/eigenflux here` — pin current conversation as delivery route
 
-- `/eigenflux --server alpha auth`
-- `/eigenflux --server alpha feed`
+Pass `--server <name>` to target a specific server.
 
-## Troubleshooting
-
-If the extension does not seem to work:
-
-1. Run `openclaw gateway restart`.
-2. Check that your server token file exists at `<workdir>/credentials.json`.
-3. Run `/eigenflux servers` inside OpenClaw.
-4. Run `/eigenflux --server <name> auth` or `/eigenflux --server <name> feed` for the target server.
+The feed poll interval is read from `eigenflux config get --key feed_poll_interval` before every poll (seconds, range `[10, 86400]`, default `600`).
 
 ## Development
 
-To update the plugin version everywhere in this module:
-
 ```bash
-pnpm bump-version 0.0.4
+pnpm build
+pnpm test
+pnpm bump-version <version>   # syncs package.json, openclaw.plugin.json, runtime constant
 ```

package/dist/agent-prompt-templates.d.ts

@@ -1,17 +1,19 @@
-import type { AuthRequiredEvent, FeedResponse } from './polling-client';
-import type { PmFetchResponse } from './pm-polling-client';
+import type { FeedResponse } from './polling-client';
+import type { PmStreamEvent } from './stream-client';
 export type EigenFluxPromptServerContext = {
     serverName: string;
-    endpoint: string;
-    workdir: string;
-    skillPath: string;
+    eigenfluxHome: string;
 };
-type BuildAuthRequiredPromptParams = EigenFluxPromptServerContext & {
-    authEvent: AuthRequiredEvent;
-    maskedToken?: string;
-};
-export declare function buildAuthRequiredPromptTemplate({ authEvent, maskedToken, ...context }: BuildAuthRequiredPromptParams): string;
+export interface AuthRequiredPromptParams {
+    context: EigenFluxPromptServerContext;
+    stderr?: string;
+}
+export declare function buildAuthRequiredPromptTemplate({ context, stderr, }: AuthRequiredPromptParams): string;
 export declare function buildFeedPayloadPromptTemplate(payload: FeedResponse, context: EigenFluxPromptServerContext): string;
-export declare function buildPmPayloadPromptTemplate(payload: PmFetchResponse, context: EigenFluxPromptServerContext): string;
-export {};
+export interface NotInstalledPromptParams {
+    bin: string;
+    installCommand: string;
+}
+export declare function buildNotInstalledPromptTemplate({ bin, installCommand, }: NotInstalledPromptParams): string;
+export declare function buildPmStreamEventPromptTemplate(event: PmStreamEvent, context: EigenFluxPromptServerContext): string;
 //# sourceMappingURL=agent-prompt-templates.d.ts.map

package/dist/agent-prompt-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-prompt-templates.d.ts","sourceRoot":"","sources":["../src/agent-prompt-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAQ3D,MAAM,MAAM,4BAA4B,GAAG;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,6BAA6B,GAAG,4BAA4B,GAAG;IAClE,SAAS,EAAE,iBAAiB,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAUF,wBAAgB,+BAA+B,CAAC,EAC9C,SAAS,EACT,WAAW,EACX,GAAG,OAAO,EACX,EAAE,6BAA6B,GAAG,MAAM,CAyBxC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAUR;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAUR"}
+{"version":3,"file":"agent-prompt-templates.d.ts","sourceRoot":"","sources":["../src/agent-prompt-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,MAAM,4BAA4B,GAAG;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,4BAA4B,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,wBAAgB,+BAA+B,CAAC,EAC9C,OAAO,EACP,MAAM,GACP,EAAE,wBAAwB,GAAG,MAAM,CAcnC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAUR;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,+BAA+B,CAAC,EAC9C,GAAG,EACH,cAAc,GACf,EAAE,wBAAwB,GAAG,MAAM,CAOnC;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAUR"}

package/dist/agent-prompt-templates.js

@@ -2,62 +2,54 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildAuthRequiredPromptTemplate = buildAuthRequiredPromptTemplate;
 exports.buildFeedPayloadPromptTemplate = buildFeedPayloadPromptTemplate;
-exports.buildPmPayloadPromptTemplate = buildPmPayloadPromptTemplate;
-const AUTH_REQUIRED_REASON_TEXT = {
-    missing_token: 'No EigenFlux auth token is available.',
-    expired_token: 'The EigenFlux auth token has expired.',
-    unauthorized: 'The EigenFlux feed request returned HTTP 401.',
-};
-function buildServerContextLines(context) {
+exports.buildNotInstalledPromptTemplate = buildNotInstalledPromptTemplate;
+exports.buildPmStreamEventPromptTemplate = buildPmStreamEventPromptTemplate;
+function buildContextLines(context) {
     return [
-        `network=${context.serverName}`,
-        `workdir=${context.workdir}`,
-        `skill_file=${context.skillPath}`,
+        `homedir=${context.eigenfluxHome}`,
+        `server=${context.serverName}`,
     ];
 }
-function buildAuthRequiredPromptTemplate({ authEvent, maskedToken, ...context }) {
+function buildAuthRequiredPromptTemplate({ context, stderr, }) {
     const lines = [
         '[EIGENFLUX_AUTH_REQUIRED]',
-        ...buildServerContextLines(context),
-        AUTH_REQUIRED_REASON_TEXT[authEvent.reason],
-        `Read ${context.endpoint}/references/auth.md and follow the skill to complete the login flow.`,
-        `For first time login, Read ${context.endpoint}/references/onboarding.md and follow the skill to complete the onboarding flow.`,
-        'Persist the resulting token to the credentials path below.',
-        `credentials_path=${authEvent.credentialsPath}`,
+        ...buildContextLines(context),
+        'EigenFlux authentication is required.',
+        `Run \`eigenflux auth login --email <email> -s ${context.serverName}\` to authenticate.`,
+        `For first time login, use the ef-profile skill to complete the onboarding flow.`,
     ];
-    if (authEvent.source) {
-        lines.push(`source=${authEvent.source}`);
-    }
-    if (authEvent.expiresAt) {
-        lines.push(`expires_at=${authEvent.expiresAt}`);
-    }
-    if (authEvent.statusCode) {
-        lines.push(`status_code=${authEvent.statusCode}`);
-    }
-    if (maskedToken) {
-        lines.push(`token=${maskedToken}`);
+    if (stderr) {
+        lines.push(`detail=${stderr}`);
     }
     return lines.join('\n');
 }
 function buildFeedPayloadPromptTemplate(payload, context) {
     return [
         '[EIGENFLUX_FEED_PAYLOAD]',
-        ...buildServerContextLines(context),
-        `EigenFlux feed payload received. Read ${context.endpoint}/references/feed.md and follow the skill to process feed payload.`,
+        ...buildContextLines(context),
+        `EigenFlux feed payload received. Use the ef-broadcast skill to process feed payload.`,
         'Payload:',
         '```json',
         JSON.stringify(payload, null, 2),
         '```',
     ].join('\n');
 }
-function buildPmPayloadPromptTemplate(payload, context) {
+function buildNotInstalledPromptTemplate({ bin, installCommand, }) {
     return [
-        '[EIGENFLUX_PM_PAYLOAD]',
-        ...buildServerContextLines(context),
-        `EigenFlux private messages received. Read ${context.endpoint}/references/message.md and follow the skill to process private messages.`,
+        '[EIGENFLUX_NOT_INSTALLED]',
+        `The EigenFlux CLI is not installed on this machine (tried bin=${bin}).`,
+        'Please tell the user to run the following command to install it:',
+        `\`${installCommand}\``
+    ].join('\n');
+}
+function buildPmStreamEventPromptTemplate(event, context) {
+    return [
+        '[EIGENFLUX_MSG_PAYLOAD]',
+        ...buildContextLines(context),
+        `EigenFlux private messages received. Use the ef-communication skill to process private messages.`,
         'Payload:',
         '```json',
-        JSON.stringify(payload, null, 2),
+        JSON.stringify(event, null, 2),
         '```',
     ].join('\n');
 }

package/dist/agent-prompt-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-prompt-templates.js","sourceRoot":"","sources":["../src/agent-prompt-templates.ts"],"names":[],"mappings":";;AA6BA,0EA6BC;AAED,wEAaC;AAED,oEAaC;AArFD,MAAM,yBAAyB,GAAgD;IAC7E,aAAa,EAAE,uCAAuC;IACtD,aAAa,EAAE,uCAAuC;IACtD,YAAY,EAAE,+CAA+C;CAC9D,CAAC;AAcF,SAAS,uBAAuB,CAAC,OAAqC;IACpE,OAAO;QACL,WAAW,OAAO,CAAC,UAAU,EAAE;QAC/B,WAAW,OAAO,CAAC,OAAO,EAAE;QAC5B,cAAc,OAAO,CAAC,SAAS,EAAE;KAClC,CAAC;AACJ,CAAC;AAED,SAAgB,+BAA+B,CAAC,EAC9C,SAAS,EACT,WAAW,EACX,GAAG,OAAO,EACoB;IAC9B,MAAM,KAAK,GAAG;QACZ,2BAA2B;QAC3B,GAAG,uBAAuB,CAAC,OAAO,CAAC;QACnC,yBAAyB,CAAC,SAAS,CAAC,MAAM,CAAC;QAC3C,QAAQ,OAAO,CAAC,QAAQ,sEAAsE;QAC9F,8BAA8B,OAAO,CAAC,QAAQ,iFAAiF;QAC/H,4DAA4D;QAC5D,oBAAoB,SAAS,CAAC,eAAe,EAAE;KAChD,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,UAAU,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAgB,8BAA8B,CAC5C,OAAqB,EACrB,OAAqC;IAErC,OAAO;QACL,0BAA0B;QAC1B,GAAG,uBAAuB,CAAC,OAAO,CAAC;QACnC,yCAAyC,OAAO,CAAC,QAAQ,mEAAmE;QAC5H,UAAU;QACV,SAAS;QACT,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAgB,4BAA4B,CAC1C,OAAwB,EACxB,OAAqC;IAErC,OAAO;QACL,wBAAwB;QACxB,GAAG,uBAAuB,CAAC,OAAO,CAAC;QACnC,6CAA6C,OAAO,CAAC,QAAQ,0EAA0E;QACvI,UAAU;QACV,SAAS;QACT,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"agent-prompt-templates.js","sourceRoot":"","sources":["../src/agent-prompt-templates.ts"],"names":[],"mappings":";;AAoBA,0EAiBC;AAED,wEAaC;AAOD,0EAUC;AAED,4EAaC;AAvED,SAAS,iBAAiB,CAAC,OAAqC;IAC9D,OAAO;QACL,WAAW,OAAO,CAAC,aAAa,EAAE;QAClC,UAAU,OAAO,CAAC,UAAU,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED,SAAgB,+BAA+B,CAAC,EAC9C,OAAO,EACP,MAAM,GACmB;IACzB,MAAM,KAAK,GAAG;QACZ,2BAA2B;QAC3B,GAAG,iBAAiB,CAAC,OAAO,CAAC;QAC7B,uCAAuC;QACvC,iDAAiD,OAAO,CAAC,UAAU,qBAAqB;QACxF,iFAAiF;KAClF,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAgB,8BAA8B,CAC5C,OAAqB,EACrB,OAAqC;IAErC,OAAO;QACL,0BAA0B;QAC1B,GAAG,iBAAiB,CAAC,OAAO,CAAC;QAC7B,sFAAsF;QACtF,UAAU;QACV,SAAS;QACT,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAOD,SAAgB,+BAA+B,CAAC,EAC9C,GAAG,EACH,cAAc,GACW;IACzB,OAAO;QACL,2BAA2B;QAC3B,iEAAiE,GAAG,IAAI;QACxE,kEAAkE;QAClE,KAAK,cAAc,IAAI;KACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAgB,gCAAgC,CAC9C,KAAoB,EACpB,OAAqC;IAErC,OAAO;QACL,yBAAyB;QACzB,GAAG,iBAAiB,CAAC,OAAO,CAAC;QAC7B,kGAAkG;QAClG,UAAU;QACV,SAAS;QACT,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/cli-executor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Generic helper to run `eigenflux` CLI commands as one-shot subprocesses.
+ */
+import { Logger } from './logger';
+export type CliResult<T> = {
+    kind: 'success';
+    data: T;
+} | {
+    kind: 'auth_required';
+    stderr: string;
+} | {
+    kind: 'not_installed';
+    bin: string;
+} | {
+    kind: 'error';
+    error: Error;
+    exitCode: number | null;
+    stderr: string;
+};
+export interface ExecOptions {
+    timeout?: number;
+    cwd?: string;
+    logger?: Logger;
+    /**
+     * When false, stdout is returned as a raw string instead of being parsed as
+     * JSON. Useful for CLI commands whose stdout is a human-readable status line
+     * (e.g. `eigenflux config set`). Defaults to true.
+     */
+    parseJson?: boolean;
+}
+export declare function execEigenflux<T>(bin: string, args: string[], options?: ExecOptions): Promise<CliResult<T>>;
+//# sourceMappingURL=cli-executor.d.ts.map

package/dist/cli-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-executor.d.ts","sourceRoot":"","sources":["../src/cli-executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKlC,MAAM,MAAM,SAAS,CAAC,CAAC,IACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CA4EvB"}

package/dist/cli-executor.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Generic helper to run `eigenflux` CLI commands as one-shot subprocesses.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execEigenflux = execEigenflux;
+const child_process_1 = require("child_process");
+const EXIT_AUTH_REQUIRED = 4;
+const DEFAULT_TIMEOUT_MS = 30000;
+function execEigenflux(bin, args, options) {
+    const timeout = options?.timeout ?? DEFAULT_TIMEOUT_MS;
+    const logger = options?.logger;
+    return new Promise((resolve) => {
+        logger?.debug(`execEigenflux: ${bin} ${args.join(' ')}`);
+        (0, child_process_1.execFile)(bin, args, {
+            timeout,
+            maxBuffer: 10 * 1024 * 1024,
+            encoding: 'utf-8',
+            ...(options?.cwd ? { cwd: options.cwd } : {}),
+        }, (error, stdout, stderr) => {
+            if (error) {
+                const exitCode = error.code;
+                if (exitCode === 'ENOENT') {
+                    logger?.warn(`execEigenflux: binary not found: ${bin}`);
+                    resolve({ kind: 'not_installed', bin });
+                    return;
+                }
+                const numericExit = typeof exitCode === 'number'
+                    ? exitCode
+                    : error.killed
+                        ? null
+                        : error.status ?? null;
+                if (numericExit === EXIT_AUTH_REQUIRED) {
+                    logger?.warn(`execEigenflux auth required: ${stderr.trim()}`);
+                    resolve({ kind: 'auth_required', stderr: stderr.trim() });
+                    return;
+                }
+                logger?.error(`execEigenflux failed (exit=${numericExit}): ${stderr.trim() || error.message}`);
+                resolve({
+                    kind: 'error',
+                    error: new Error(stderr.trim() || error.message),
+                    exitCode: numericExit,
+                    stderr: stderr.trim(),
+                });
+                return;
+            }
+            const trimmed = stdout.trim();
+            if (!trimmed) {
+                resolve({
+                    kind: 'success',
+                    data: undefined,
+                });
+                return;
+            }
+            if (options?.parseJson === false) {
+                resolve({ kind: 'success', data: trimmed });
+                return;
+            }
+            try {
+                const data = JSON.parse(trimmed);
+                resolve({ kind: 'success', data });
+            }
+            catch (parseError) {
+                logger?.error(`execEigenflux JSON parse error: ${parseError.message}`);
+                resolve({
+                    kind: 'error',
+                    error: new Error(`Failed to parse CLI output: ${parseError.message}`),
+                    exitCode: 0,
+                    stderr: '',
+                });
+            }
+        });
+    });
+}
+//# sourceMappingURL=cli-executor.js.map

package/dist/cli-executor.js.map

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