poe-code 3.0.29 → 3.0.31

package/dist/cli/service-registry.d.ts

@@ -0,0 +1,108 @@
+import type { CliEnvironment } from "./environment.js";
+import type { CommandContext } from "./context.js";
+import type { ScopedLogger } from "./logger.js";
+import type { FileSystem } from "../utils/file-system.js";
+import type { CommandCheck } from "../utils/command-checks.js";
+import type { ModelPromptInput, ReasoningPromptInput } from "./prompts.js";
+import type { MutationObservers } from "@poe-code/config-mutations";
+export interface ServiceManifestPathMapper {
+    mapTargetDirectory: (input: {
+        targetDirectory: string;
+        env: CliEnvironment;
+    }) => string;
+}
+export interface ServiceRunOptions {
+    observers?: MutationObservers;
+}
+export interface ProviderColorSet {
+    light?: string;
+    dark?: string;
+}
+export interface ProviderBranding {
+    colors?: ProviderColorSet;
+}
+export interface ProviderConfigurePrompts {
+    model?: ModelPromptInput;
+    reasoningEffort?: ReasoningPromptInput;
+}
+export interface ProviderContext {
+    env: CliEnvironment;
+    command: CommandContext;
+    logger: ScopedLogger;
+    runCheck(check: CommandCheck): Promise<void>;
+}
+export interface ServiceExecutionContext<Options> {
+    fs: FileSystem;
+    env: CliEnvironment;
+    command: CommandContext;
+    options: Options;
+    pathMapper?: ServiceManifestPathMapper;
+}
+export interface ProviderService<TConfigure = any, TUnconfigure = TConfigure, TSpawn = any> {
+    id: string;
+    summary: string;
+    aliases?: string[];
+    configure(context: ServiceExecutionContext<TConfigure>, runOptions?: ServiceRunOptions): Promise<void>;
+    unconfigure(context: ServiceExecutionContext<TUnconfigure>, runOptions?: ServiceRunOptions): Promise<boolean>;
+    name: string;
+    label: string;
+    branding?: ProviderBranding;
+    disabled?: boolean;
+    supportsStdinPrompt?: boolean;
+    configurePrompts?: ProviderConfigurePrompts;
+    postConfigureMessages?: string[];
+    isolatedEnv?: ProviderIsolatedEnv;
+    install?(context: ProviderContext): Promise<void> | void;
+    spawn?(context: ProviderContext, options: TSpawn): Promise<unknown>;
+    test?(context: ProviderContext): Promise<void>;
+}
+export interface ProviderIsolatedEnv {
+    agentBinary: string;
+    configProbe?: IsolatedEnvPath;
+    env: Record<string, IsolatedEnvValue>;
+    repairs?: IsolatedEnvRepair[];
+    requiresConfig?: boolean;
+    /** CLI settings to inject via --settings flag (for agents that support it) */
+    cliSettings?: IsolatedCliSettings;
+}
+export interface IsolatedCliSettings {
+    /** Static settings values */
+    values: Record<string, unknown>;
+    /** Top-level settings that need runtime resolution */
+    resolved?: Record<string, IsolatedEnvPoeApiKey | IsolatedEnvPoeBaseUrl>;
+    /** Environment variables to inject into settings.env (resolved at runtime) */
+    env?: Record<string, string | IsolatedEnvPoeApiKey | IsolatedEnvPoeBaseUrl>;
+}
+export type IsolatedEnvRepair = {
+    kind: "chmod";
+    relativePath: string;
+    mode: number;
+};
+export type IsolatedEnvPath = {
+    kind: "isolatedDir";
+    relativePath?: string;
+} | {
+    kind: "isolatedFile";
+    relativePath: string;
+};
+export type IsolatedEnvValue = string | IsolatedEnvPath | IsolatedEnvVariable | IsolatedEnvPoeApiKey | IsolatedEnvPoeBaseUrl;
+export type IsolatedEnvVariable = {
+    kind: "envVar";
+    name: string;
+};
+export type IsolatedEnvPoeApiKey = {
+    kind: "poeApiKey";
+};
+export type IsolatedEnvPoeBaseUrl = {
+    kind: "poeBaseUrl";
+};
+export type ProviderOperation = "install" | "configure" | "unconfigure" | "spawn" | "test";
+export interface ServiceRegistry {
+    register(adapter: ProviderService): void;
+    discover(adapters: ProviderService[]): void;
+    get(name: string): ProviderService | undefined;
+    require(name: string): ProviderService;
+    list(): ProviderService[];
+    invoke<T>(serviceName: string, operation: ProviderOperation, runner: (adapter: ProviderService) => Promise<T>): Promise<T>;
+}
+export declare function createServiceRegistry(): ServiceRegistry;

package/dist/cli/service-registry.js

@@ -0,0 +1,83 @@
+import { resolveAgentId } from "@poe-code/agent-defs";
+export function createServiceRegistry() {
+    const canonicalAdapters = new Map();
+    const nameToCanonical = new Map();
+    const listProviderKeys = (adapter) => {
+        const keys = [adapter.name];
+        for (const alias of adapter.aliases ?? []) {
+            if (typeof alias !== "string") {
+                continue;
+            }
+            const normalized = alias.trim();
+            if (normalized.length === 0) {
+                continue;
+            }
+            if (!keys.includes(normalized)) {
+                keys.push(normalized);
+            }
+        }
+        return keys;
+    };
+    const register = (adapter) => {
+        if (canonicalAdapters.has(adapter.name)) {
+            throw new Error(`Provider "${adapter.name}" is already registered.`);
+        }
+        const keys = listProviderKeys(adapter);
+        for (const key of keys) {
+            if (nameToCanonical.has(key)) {
+                throw new Error(`Provider "${key}" is already registered.`);
+            }
+        }
+        canonicalAdapters.set(adapter.name, adapter);
+        for (const key of keys) {
+            nameToCanonical.set(key, adapter.name);
+        }
+    };
+    const discover = (candidates) => {
+        for (const candidate of candidates) {
+            if (canonicalAdapters.has(candidate.name)) {
+                continue;
+            }
+            const keys = listProviderKeys(candidate);
+            if (keys.some((key) => nameToCanonical.has(key))) {
+                continue;
+            }
+            canonicalAdapters.set(candidate.name, candidate);
+            for (const key of keys) {
+                nameToCanonical.set(key, candidate.name);
+            }
+        }
+    };
+    const resolveCanonicalName = (name) => {
+        const direct = nameToCanonical.get(name);
+        if (direct) {
+            return direct;
+        }
+        const resolvedAgent = resolveAgentId(name);
+        if (!resolvedAgent) {
+            return undefined;
+        }
+        return nameToCanonical.get(resolvedAgent);
+    };
+    const get = (name) => {
+        const canonicalName = resolveCanonicalName(name);
+        if (!canonicalName) {
+            return undefined;
+        }
+        return canonicalAdapters.get(canonicalName);
+    };
+    const require = (name) => {
+        const adapter = get(name);
+        if (!adapter) {
+            throw new Error(`Unknown provider "${name}".`);
+        }
+        return adapter;
+    };
+    const list = () => Array.from(canonicalAdapters.values());
+    const invoke = async (serviceName, operation, runner) => {
+        const adapter = require(serviceName);
+        return await runner(adapter);
+    };
+    return { register, discover, get, require, list, invoke };
+}
+//# sourceMappingURL=service-registry.js.map

package/dist/cli/service-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registry.js","sourceRoot":"","sources":["../../src/cli/service-registry.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmJtD,MAAM,UAAU,qBAAqB;IACnC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC7D,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,MAAM,gBAAgB,GAAG,CAAC,OAAwB,EAAY,EAAE;QAC9D,MAAM,IAAI,GAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,OAAwB,EAAQ,EAAE;QAClD,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,CAAC,IAAI,0BAA0B,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,0BAA0B,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,UAA6B,EAAQ,EAAE;QACvD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACjD,SAAS;YACX,CAAC;YAED,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAsB,EAAE;QAChE,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEF,MAAM,GAAG,GAAG,CAAC,IAAY,EAA+B,EAAE;QACxD,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,iBAAiB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAmB,EAAE;QAChD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,GAAsB,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC;IAE7E,MAAM,MAAM,GAAG,KAAK,EAClB,WAAmB,EACnB,SAA4B,EAC5B,MAAgD,EACpC,EAAE;QACd,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QACrC,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC5D,CAAC"}

package/dist/cli/types.d.ts

@@ -0,0 +1,2 @@
+export type PromptFn = (questions: unknown) => Promise<Record<string, unknown>>;
+export type LoggerFn = (message: string) => void;

package/dist/cli/types.js

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

package/dist/cli/types.js.map

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

package/dist/cli/ui/service-menu.d.ts

@@ -0,0 +1,7 @@
+import type { ProviderService } from "../service-registry.js";
+import { type ThemeName } from "@poe-code/design-system";
+export interface RenderServiceMenuOptions {
+    themeName?: ThemeName;
+}
+export declare function formatServiceLabel(service: ProviderService, themeName?: ThemeName): string;
+export declare function renderServiceMenu(services: ProviderService[], options?: RenderServiceMenuOptions): string[];

package/dist/cli/ui/service-menu.js

@@ -0,0 +1,43 @@
+import chalk from "chalk";
+import { getTheme, resolveThemeName } from "@poe-code/design-system";
+const HEADER_WIDTH = 70;
+const repeat = (char, count) => char.repeat(count);
+const CLI_COPY = {
+    tagline: "Configure coding agents to use the Poe API.",
+    get menuHeader() {
+        return `poe-code · ${this.tagline}`;
+    },
+    serviceSelection: (action) => `Pick an agent to ${action}:`
+};
+export function formatServiceLabel(service, themeName = "dark") {
+    const colors = service.branding?.colors;
+    if (colors) {
+        const preferred = themeName === "dark"
+            ? colors.dark ?? colors.light
+            : colors.light ?? colors.dark;
+        if (preferred) {
+            return chalk.hex(preferred).bold(service.label);
+        }
+    }
+    return service.label;
+}
+export function renderServiceMenu(services, options) {
+    const themeName = options?.themeName ?? resolveThemeName();
+    const palette = getTheme();
+    const border = repeat("=", HEADER_WIDTH);
+    const divider = repeat("-", HEADER_WIDTH);
+    const lines = [
+        palette.divider(border),
+        palette.header(CLI_COPY.menuHeader),
+        palette.divider(divider),
+        palette.prompt(CLI_COPY.serviceSelection("configure"))
+    ];
+    services.forEach((service, index) => {
+        const number = palette.number(`[${index + 1}]`);
+        const label = formatServiceLabel(service, themeName);
+        lines.push(`${number} ${label}`);
+    });
+    lines.push(palette.divider(divider));
+    return lines;
+}
+//# sourceMappingURL=service-menu.js.map

package/dist/cli/ui/service-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-menu.js","sourceRoot":"","sources":["../../../src/cli/ui/service-menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAErF,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAE3E,MAAM,QAAQ,GAAG;IACf,OAAO,EAAE,6CAA6C;IACtD,IAAI,UAAU;QACZ,OAAO,cAAc,IAAI,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC;IACD,gBAAgB,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,oBAAoB,MAAM,GAAG;CACpE,CAAC;AAMF,MAAM,UAAU,kBAAkB,CAChC,OAAwB,EACxB,YAAuB,MAAM;IAE7B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,SAAS,GACb,SAAS,KAAK,MAAM;YAClB,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK;YAC7B,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC;QAClC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAA2B,EAC3B,OAAkC;IAElC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,CAAC;IAC3D,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAa;QACtB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;QACnC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;KACvD,CAAC;IAEF,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAErC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { isCliInvocation } from "./cli/bootstrap.js";
+export { spawn } from "./sdk/spawn.js";
+export { generate, generateImage, generateVideo, generateAudio } from "./sdk/generate.js";
+export { getPoeApiKey } from "./sdk/credentials.js";
+export type { SpawnOptions, SpawnResult, GenerateOptions, MediaGenerateOptions, GenerateResult, MediaGenerateResult } from "./sdk/types.js";
+declare const main: () => Promise<void>;
+export { main, isCliInvocation };