poe-code 2.0.57 → 2.0.58

package/README.md

@@ -80,3 +80,44 @@ npx poe-code@latest install kimi
 
 - `--dry-run` – show every mutation without touching disk.
 - `--yes` – accept defaults for prompts.
+
+## SDK
+
+Use `poe-code` programmatically in your own code:
+
+```typescript
+import { spawn, getPoeApiKey } from "poe-code"
+
+// Get stored API key
+const apiKey = await getPoeApiKey()
+
+// Run a prompt through a provider
+const result = await spawn("claude-code", {
+  prompt: "Fix the bug in auth.ts",
+  cwd: "/path/to/project",
+  model: "claude-sonnet-4"
+})
+
+console.log(result.stdout)
+```
+
+### `spawn(service, options)`
+
+Runs a single prompt through a configured service CLI.
+
+- `service` – Service identifier (`claude-code`, `codex`, `opencode`)
+- `options.prompt` – The prompt to send
+- `options.cwd` – Working directory for the service CLI (optional)
+- `options.model` – Model identifier override (optional)
+- `options.args` – Additional arguments forwarded to the CLI (optional)
+
+Returns `{ stdout, stderr, exitCode }`.
+
+### `getPoeApiKey()`
+
+Reads the Poe API key with the following priority:
+
+1. `POE_API_KEY` environment variable
+2. Credentials file (`~/.poe-code/credentials.json`)
+
+Throws if no credentials found.

package/dist/cli/commands/spawn.js

@@ -1,5 +1,6 @@
 import path from "node:path";
-import { buildProviderContext, createExecutionResources, resolveCommandFlags, resolveServiceAdapter, } from "./shared.js";
+import { createExecutionResources, resolveCommandFlags, resolveServiceAdapter } from "./shared.js";
+import { spawnCore } from "../../sdk/spawn-core.js";
 export function registerSpawnCommand(program, container, options = {}) {
     const defaultServices = ["claude-code", "codex", "opencode"];
     const serviceList = options.extraServices && options.extraServices.length > 0
@@ -50,6 +51,7 @@ export function registerSpawnCommand(program, container, options = {}) {
             cwd: cwdOverride,
             useStdin: shouldReadFromStdin
         };
+        // Check for custom handlers first
         const directHandler = options.handlers?.[service];
         if (directHandler) {
             await directHandler({
@@ -74,35 +76,16 @@ export function registerSpawnCommand(program, container, options = {}) {
             });
             return;
         }
-        if (typeof adapter.spawn !== "function") {
-            throw new Error(`${adapter.label} does not support spawn.`);
-        }
-        if (spawnOptions.useStdin && !adapter.supportsStdinPrompt) {
-            throw new Error(`${adapter.label} does not support stdin prompts. Use a different service (e.g. "codex") or pass the prompt as an argument.`);
-        }
-        const providerContext = buildProviderContext(container, adapter, resources);
+        // Use SDK core spawn implementation
+        const result = await spawnCore(container, service, spawnOptions, {
+            dryRun: flags.dryRun,
+            verbose: flags.verbose
+        });
+        // Handle dry run - spawnCore already logged the message
         if (flags.dryRun) {
-            const extra = spawnOptions.args && spawnOptions.args.length > 0
-                ? ` with args ${JSON.stringify(spawnOptions.args)}`
-                : "";
-            const cwdSuffix = spawnOptions.cwd ? ` from ${spawnOptions.cwd}` : "";
-            const promptDetail = spawnOptions.useStdin
-                ? `(stdin, ${spawnOptions.prompt.length} chars)`
-                : `"${spawnOptions.prompt}"`;
-            resources.logger.dryRun(`Dry run: would spawn ${adapter.label} with prompt ${promptDetail}${extra}${cwdSuffix}.`);
-            return;
-        }
-        const result = (await container.registry.invoke(canonicalService, "spawn", async (entry) => {
-            if (!entry.spawn) {
-                throw new Error(`${adapter.label} does not support spawn.`);
-            }
-            const output = await entry.spawn(providerContext, spawnOptions);
-            return output;
-        }));
-        if (!result) {
-            resources.logger.info(`${adapter.label} spawn completed.`);
             return;
         }
+        // Handle result output
         if (result.exitCode !== 0) {
             const detail = result.stderr.trim() || result.stdout.trim();
             const suffix = detail ? `: ${detail}` : "";

package/dist/cli/commands/spawn.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
 import { isCliInvocation } from "./cli/bootstrap.js";
+export { spawn } from "./sdk/spawn.js";
+export { getPoeApiKey } from "./sdk/credentials.js";
+export type { SpawnOptions, SpawnResult } from "./sdk/types.js";
 declare const main: () => Promise<void>;
 export { main, isCliInvocation };

package/dist/index.js

@@ -1,9 +1,13 @@
 #!/usr/bin/env node
 import { createProgram } from "./cli/program.js";
 import { createCliMain, isCliInvocation } from "./cli/bootstrap.js";
+// SDK exports
+export { spawn } from "./sdk/spawn.js";
+export { getPoeApiKey } from "./sdk/credentials.js";
 const main = createCliMain(createProgram);
 if (isCliInvocation(process.argv, import.meta.url)) {
     void main();
 }
+// CLI exports
 export { main, isCliInvocation };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;AAE1C,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACnD,KAAK,IAAI,EAAE,CAAC;AACd,CAAC;AAED,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEpE,cAAc;AACd,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,MAAM,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;AAE1C,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACnD,KAAK,IAAI,EAAE,CAAC;AACd,CAAC;AAED,cAAc;AACd,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC"}

package/dist/sdk/container.d.ts

@@ -0,0 +1,18 @@
+import type { CliContainer } from "../cli/container.js";
+export interface SdkContainerOptions {
+    /** Working directory (defaults to process.cwd()) */
+    cwd?: string;
+    /** Home directory (defaults to os.homedir()) */
+    homeDir?: string;
+    /** Environment variables (defaults to process.env) */
+    variables?: Record<string, string | undefined>;
+    /** Enable verbose logging (defaults to false) */
+    verbose?: boolean;
+}
+/**
+ * Creates a lightweight container for SDK usage.
+ * Uses real file system and command runner.
+ * No prompts needed (non-interactive).
+ * Minimal logger (silent by default).
+ */
+export declare function createSdkContainer(options?: SdkContainerOptions): CliContainer;

package/dist/sdk/container.js

@@ -0,0 +1,127 @@
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import { createCliEnvironment } from "../cli/environment.js";
+import { createServiceRegistry } from "../cli/service-registry.js";
+import { createCommandContextFactory } from "../cli/context.js";
+import { createPromptLibrary } from "../cli/prompts.js";
+import { createOptionResolvers } from "../cli/options.js";
+import { createLoggerFactory } from "../cli/logger.js";
+import { ErrorLogger } from "../cli/error-logger.js";
+import { createDefaultCommandRunner } from "../cli/command-runner.js";
+import { getDefaultProviders } from "../providers/index.js";
+import { createPoeCodeCommandRunner } from "../cli/poe-code-command-runner.js";
+import { loadCredentials, saveCredentials } from "../services/credentials.js";
+import * as nodeFsSync from "node:fs";
+/**
+ * Creates a lightweight container for SDK usage.
+ * Uses real file system and command runner.
+ * No prompts needed (non-interactive).
+ * Minimal logger (silent by default).
+ */
+export function createSdkContainer(options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const homeDir = options?.homeDir ?? os.homedir();
+    const variables = options?.variables ?? process.env;
+    const verbose = options?.verbose ?? false;
+    const environment = createCliEnvironment({
+        cwd,
+        homeDir,
+        platform: process.platform,
+        variables
+    });
+    // Silent logger for SDK - only emits if verbose
+    const silentEmitter = verbose ? undefined : () => { };
+    const loggerFactory = createLoggerFactory(silentEmitter);
+    // Create error logger with sync fs
+    const errorLogger = new ErrorLogger({
+        fs: nodeFsSync,
+        logDir: environment.logDir,
+        logToStderr: false
+    });
+    loggerFactory.setErrorLogger(errorLogger);
+    // Create async file system adapter
+    const asyncFs = {
+        readFile: ((path, encoding) => {
+            if (encoding) {
+                return fs.readFile(path, encoding);
+            }
+            return fs.readFile(path);
+        }),
+        writeFile: (path, data, opts) => fs.writeFile(path, data, opts),
+        mkdir: (path, opts) => fs.mkdir(path, opts).then(() => { }),
+        stat: (path) => fs.stat(path),
+        rm: (path, opts) => fs.rm(path, opts),
+        unlink: (path) => fs.unlink(path),
+        readdir: (path) => fs.readdir(path),
+        copyFile: (src, dest) => fs.copyFile(src, dest),
+        chmod: (path, mode) => fs.chmod(path, mode)
+    };
+    const contextFactory = createCommandContextFactory({ fs: asyncFs });
+    // No-op prompts for SDK (non-interactive)
+    const noopPrompts = async () => {
+        throw new Error("SDK does not support interactive prompts");
+    };
+    const promptLibrary = createPromptLibrary();
+    const optionResolvers = createOptionResolvers({
+        prompts: noopPrompts,
+        promptLibrary,
+        apiKeyStore: {
+            read: () => loadCredentials({
+                fs: asyncFs,
+                filePath: environment.credentialsPath
+            }),
+            write: (value) => saveCredentials({
+                fs: asyncFs,
+                filePath: environment.credentialsPath,
+                apiKey: value
+            })
+        }
+    });
+    const registry = createServiceRegistry();
+    const providers = getDefaultProviders().filter((adapter) => !adapter.disabled);
+    for (const adapter of providers) {
+        registry.register(adapter);
+    }
+    const baseRunner = createDefaultCommandRunner();
+    // Create container with wrapped runner
+    let container = null;
+    const wrappedRunner = createPoeCodeCommandRunner({
+        getContainer: () => container,
+        baseRunner
+    });
+    // HTTP client using global fetch
+    const httpClient = async (url, init) => {
+        const response = await globalThis.fetch(url, init);
+        return {
+            ok: response.ok,
+            status: response.status,
+            json: () => response.json()
+        };
+    };
+    container = {
+        env: environment,
+        fs: asyncFs,
+        prompts: noopPrompts,
+        promptLibrary,
+        loggerFactory,
+        errorLogger,
+        options: optionResolvers,
+        contextFactory,
+        registry,
+        httpClient,
+        commandRunner: wrappedRunner,
+        providers,
+        dependencies: {
+            fs: asyncFs,
+            prompts: noopPrompts,
+            env: {
+                cwd,
+                homeDir,
+                platform: process.platform,
+                variables
+            }
+        }
+    };
+    return container;
+}
+//# sourceMappingURL=container.js.map

package/dist/sdk/container.js.map

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

package/dist/sdk/credentials.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Reads the Poe API key with the following priority:
+ * 1. `POE_API_KEY` environment variable (if set)
+ * 2. Credentials file (`~/.poe-code/credentials.json`)
+ *
+ * @returns The API key
+ * @throws Error if no credentials found
+ */
+export declare function getPoeApiKey(): Promise<string>;

package/dist/sdk/credentials.js

@@ -0,0 +1,35 @@
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+const CREDENTIALS_RELATIVE_PATH = ".poe-code/credentials.json";
+/**
+ * Reads the Poe API key with the following priority:
+ * 1. `POE_API_KEY` environment variable (if set)
+ * 2. Credentials file (`~/.poe-code/credentials.json`)
+ *
+ * @returns The API key
+ * @throws Error if no credentials found
+ */
+export async function getPoeApiKey() {
+    const envKey = process.env.POE_API_KEY;
+    if (typeof envKey === "string" && envKey.trim().length > 0) {
+        return envKey.trim();
+    }
+    const homeDir = os.homedir();
+    const credentialsPath = path.join(homeDir, CREDENTIALS_RELATIVE_PATH);
+    try {
+        const content = await fs.readFile(credentialsPath, "utf8");
+        const parsed = JSON.parse(content);
+        if (typeof parsed === "object" &&
+            parsed !== null &&
+            typeof parsed.apiKey === "string" &&
+            parsed.apiKey.length > 0) {
+            return parsed.apiKey;
+        }
+    }
+    catch {
+        // File doesn't exist or is invalid
+    }
+    throw new Error("No API key found. Set POE_API_KEY or run 'poe-code login'.");
+}
+//# sourceMappingURL=credentials.js.map

package/dist/sdk/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/sdk/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,yBAAyB,GAAG,4BAA4B,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACvC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7B,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;IAEtE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,IACE,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;YACjC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EACxB,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IAED,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;AACJ,CAAC"}

package/dist/sdk/spawn-core.d.ts

@@ -0,0 +1,23 @@
+import type { CliContainer } from "../cli/container.js";
+import type { SpawnResult } from "./types.js";
+export interface SpawnCoreOptions {
+    /** The prompt to send to the provider */
+    prompt: string;
+    /** Working directory for the service CLI */
+    cwd?: string;
+    /** Model identifier override */
+    model?: string;
+    /** Additional arguments forwarded to the CLI */
+    args?: string[];
+    /** Whether prompt was read from stdin */
+    useStdin?: boolean;
+}
+export interface SpawnCoreFlags {
+    dryRun: boolean;
+    verbose: boolean;
+}
+/**
+ * Core spawn implementation used by both SDK and CLI.
+ * Accepts an existing container to avoid creating a new one.
+ */
+export declare function spawnCore(container: CliContainer, service: string, options: SpawnCoreOptions, flags?: SpawnCoreFlags): Promise<SpawnResult>;

package/dist/sdk/spawn-core.js

@@ -0,0 +1,81 @@
+import path from "node:path";
+import { buildProviderContext, createExecutionResources } from "../cli/commands/shared.js";
+/**
+ * Core spawn implementation used by both SDK and CLI.
+ * Accepts an existing container to avoid creating a new one.
+ */
+export async function spawnCore(container, service, options, flags = { dryRun: false, verbose: false }) {
+    // Resolve working directory
+    const cwdOverride = resolveSpawnWorkingDirectory(container.env.cwd, options.cwd);
+    // Build spawn command options (internal format)
+    const spawnOptions = {
+        prompt: options.prompt,
+        args: options.args,
+        model: options.model,
+        cwd: cwdOverride,
+        useStdin: options.useStdin ?? false
+    };
+    // Resolve service adapter
+    const adapter = container.registry.get(service);
+    if (!adapter) {
+        throw new Error(`Unknown service "${service}".`);
+    }
+    if (typeof adapter.spawn !== "function") {
+        throw new Error(`${adapter.label} does not support spawn.`);
+    }
+    if (spawnOptions.useStdin && !adapter.supportsStdinPrompt) {
+        throw new Error(`${adapter.label} does not support stdin prompts. Use a different service (e.g. "codex") or pass the prompt as an argument.`);
+    }
+    // Create execution resources (logger, context)
+    const commandFlags = { dryRun: flags.dryRun, assumeYes: true, verbose: flags.verbose };
+    const resources = createExecutionResources(container, commandFlags, `spawn:${service}`);
+    // Build provider context
+    const providerContext = buildProviderContext(container, adapter, resources);
+    // Handle dry run
+    if (flags.dryRun) {
+        const extra = spawnOptions.args && spawnOptions.args.length > 0
+            ? ` with args ${JSON.stringify(spawnOptions.args)}`
+            : "";
+        const cwdSuffix = spawnOptions.cwd ? ` from ${spawnOptions.cwd}` : "";
+        const promptDetail = spawnOptions.useStdin
+            ? `(stdin, ${spawnOptions.prompt.length} chars)`
+            : `"${spawnOptions.prompt}"`;
+        resources.logger.dryRun(`Dry run: would spawn ${adapter.label} with prompt ${promptDetail}${extra}${cwdSuffix}.`);
+        return {
+            stdout: "",
+            stderr: "",
+            exitCode: 0
+        };
+    }
+    // Invoke spawn through registry
+    const result = (await container.registry.invoke(adapter.name, "spawn", async (entry) => {
+        if (!entry.spawn) {
+            throw new Error(`${adapter.label} does not support spawn.`);
+        }
+        const output = await entry.spawn(providerContext, spawnOptions);
+        return output;
+    }));
+    // Return normalized result
+    if (!result) {
+        return {
+            stdout: "",
+            stderr: "",
+            exitCode: 0
+        };
+    }
+    return {
+        stdout: result.stdout,
+        stderr: result.stderr,
+        exitCode: result.exitCode
+    };
+}
+function resolveSpawnWorkingDirectory(baseDir, candidate) {
+    if (!candidate || candidate.trim().length === 0) {
+        return undefined;
+    }
+    if (path.isAbsolute(candidate)) {
+        return candidate;
+    }
+    return path.resolve(baseDir, candidate);
+}
+//# sourceMappingURL=spawn-core.js.map

package/dist/sdk/spawn-core.js.map

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

package/dist/sdk/spawn.d.ts

@@ -0,0 +1,23 @@
+import type { SpawnOptions, SpawnResult } from "./types.js";
+/**
+ * Runs a single prompt through a configured service CLI.
+ *
+ * @param service - Service identifier (claude-code, codex, opencode)
+ * @param options - Configuration for the spawn
+ * @returns Promise resolving to SpawnResult with stdout, stderr, and exitCode
+ * @throws Error if no API key found or service doesn't support spawn
+ *
+ * @example
+ * ```typescript
+ * import { spawn } from "poe-code"
+ *
+ * const result = await spawn("claude-code", {
+ *   prompt: "Fix the bug in auth.ts",
+ *   cwd: "/path/to/project",
+ *   model: "claude-sonnet-4"
+ * })
+ *
+ * console.log(result.stdout)
+ * ```
+ */
+export declare function spawn(service: string, options: SpawnOptions): Promise<SpawnResult>;

package/dist/sdk/spawn.js

@@ -0,0 +1,41 @@
+import { createSdkContainer } from "./container.js";
+import { getPoeApiKey } from "./credentials.js";
+import { spawnCore } from "./spawn-core.js";
+/**
+ * Runs a single prompt through a configured service CLI.
+ *
+ * @param service - Service identifier (claude-code, codex, opencode)
+ * @param options - Configuration for the spawn
+ * @returns Promise resolving to SpawnResult with stdout, stderr, and exitCode
+ * @throws Error if no API key found or service doesn't support spawn
+ *
+ * @example
+ * ```typescript
+ * import { spawn } from "poe-code"
+ *
+ * const result = await spawn("claude-code", {
+ *   prompt: "Fix the bug in auth.ts",
+ *   cwd: "/path/to/project",
+ *   model: "claude-sonnet-4"
+ * })
+ *
+ * console.log(result.stdout)
+ * ```
+ */
+export async function spawn(service, options) {
+    // Validate API key exists (throws if not found)
+    await getPoeApiKey();
+    // Create SDK container with cwd from options
+    const container = createSdkContainer({
+        cwd: options.cwd
+    });
+    // Delegate to core spawn implementation
+    return spawnCore(container, service, {
+        prompt: options.prompt,
+        cwd: options.cwd,
+        model: options.model,
+        args: options.args,
+        useStdin: false
+    });
+}
+//# sourceMappingURL=spawn.js.map

package/dist/sdk/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../src/sdk/spawn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,OAAe,EACf,OAAqB;IAErB,gDAAgD;IAChD,MAAM,YAAY,EAAE,CAAC;IAErB,6CAA6C;IAC7C,MAAM,SAAS,GAAG,kBAAkB,CAAC;QACnC,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IAEH,wCAAwC;IACxC,OAAO,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE;QACnC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/sdk/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Options for spawning a provider CLI.
+ */
+export interface SpawnOptions {
+    /** The prompt to send to the provider */
+    prompt: string;
+    /** Working directory for the service CLI */
+    cwd?: string;
+    /** Model identifier override */
+    model?: string;
+    /** Additional arguments forwarded to the CLI */
+    args?: string[];
+}
+/**
+ * Result from spawning a provider CLI.
+ */
+export interface SpawnResult {
+    /** Standard output from the CLI */
+    stdout: string;
+    /** Standard error from the CLI */
+    stderr: string;
+    /** Exit code from the CLI process */
+    exitCode: number;
+}

package/dist/sdk/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poe-code",
-  "version": "2.0.57",
+  "version": "2.0.58",
   "description": "CLI tool to configure Poe API for developer workflows.",
   "type": "module",
   "scripts": {