@moxxy/plugin-provider-openai 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+# @moxxy/plugin-provider-openai
+
+The **OpenAI** `LLMProvider` for [moxxy](https://moxxy.ai) — streams Chat
+Completions with `tool_calls` and translates moxxy's `ProviderRequest`/event
+shape ↔ the OpenAI wire format. Register it into a
+[`Session`](https://www.npmjs.com/package/@moxxy/core) to route turns to OpenAI.
+
+Because it speaks the OpenAI Chat Completions API, it also drives any
+**OpenAI-compatible** endpoint (z.ai, xAI, Google's OpenAI shim, Ollama / local)
+via the `baseURL` override.
+
+## Install
+
+```bash
+npm i @moxxy/core @moxxy/sdk @moxxy/mode-default @moxxy/plugin-provider-openai
+```
+
+## Usage
+
+```ts
+import { Session, collectTurn, autoAllowResolver } from '@moxxy/core';
+import defaultModePlugin from '@moxxy/mode-default';
+import openaiPlugin from '@moxxy/plugin-provider-openai';
+
+const session = new Session({ cwd: process.cwd(), permissionResolver: autoAllowResolver });
+session.pluginHost.registerStatic(defaultModePlugin);
+session.pluginHost.registerStatic(openaiPlugin);
+
+session.providers.setActive('openai', {
+  apiKey: process.env.OPENAI_API_KEY,
+  // model: 'gpt-5.2',          // optional — defaults to the built-in catalog
+});
+
+console.log((await collectTurn(session, 'Hello!')).findLast((e) => e.type === 'assistant_message')?.content);
+```
+
+### Point at an OpenAI-compatible vendor
+
+```ts
+session.providers.setActive('openai', {
+  apiKey: process.env.GROQ_API_KEY,
+  baseURL: 'https://api.groq.com/openai/v1',
+  // model: '...'   // the vendor's model id
+});
+```
+
+## Config (`OpenAIProviderConfig`)
+
+| field | meaning |
+|---|---|
+| `apiKey` | the API key (or wire it through the Session's `secretResolver`) |
+| `baseURL` | override the API base for an OpenAI-compatible vendor |
+| `model` / `models` | pick / override the advertised model catalog |
+
+## Exports
+
+`default` / `openaiPlugin` (register this), `openaiProviderDef`, `OpenAIProvider`,
+`openAIModels`, `validateKey`, and `defineOpenAICompatProvider` (build a provider
+for another OpenAI-compatible vendor in a few lines).
+
+## License
+
+MIT

package/dist/compat.d.ts

@@ -0,0 +1,72 @@
+import { type ModelDescriptor, type ProviderAuthDescriptor, type ProviderDef } from '@moxxy/sdk';
+/**
+ * The slice of the registry's untyped `Record<string, unknown>` config that an
+ * OpenAI-compatible vendor actually forwards. The provider registry hands
+ * `createClient` a `Record<string, unknown>` (resolved credentials + any
+ * persisted provider config); only these three optional strings are ever
+ * meaningful to the underlying {@link OpenAIProvider}, so we narrow to them.
+ */
+export interface OpenAICompatConfig {
+    readonly apiKey?: string;
+    readonly baseURL?: string;
+    readonly defaultModel?: string;
+}
+/**
+ * Narrow the registry's untyped config down to the handful of optional string
+ * fields an OpenAI-compatible vendor forwards (`apiKey`/`baseURL`/`defaultModel`).
+ * A blanket `config as OpenAIProviderConfig` cast would silently smuggle any
+ * wrong-typed field straight through to the client; this pick keeps only
+ * known-good strings so a bad value falls back to the vendor defaults instead.
+ */
+export declare function pickOpenAICompatConfig(config: Record<string, unknown>): OpenAICompatConfig;
+export interface DefineOpenAICompatProviderSpec {
+    /**
+     * Vendor slug (e.g. `xai`, `zai`, `google`, `local`). Stamped onto the
+     * underlying client so usage stats, provider_request/response events and
+     * error context attribute to the vendor, NOT `openai`.
+     */
+    readonly name: string;
+    /** Vendor base URL. Config may override it (narrow string pick); else this default is used. */
+    readonly baseURL: string;
+    /** Default model when a request didn't pin one. Config may override it (narrow string pick). */
+    readonly defaultModel: string;
+    /** The vendor's model catalog, forced onto the client (so context-window/capability lookups hit the vendor's models). */
+    readonly models: ReadonlyArray<ModelDescriptor>;
+    /** Auth descriptor surfaced to the setup wizard / `moxxy login`. */
+    readonly auth?: ProviderAuthDescriptor;
+    /**
+     * Key validation. When `true` (the default), wire `validateOpenAICompatKey`
+     * to probe `baseURL`'s `/models`. When `false`, omit `validateKey` entirely
+     * (local servers don't authenticate, so probing a possibly-offline box would
+     * surface confusing setup errors).
+     */
+    readonly validate?: boolean;
+    /**
+     * Optional override for resolving the API key from the narrowed config.
+     * Defaults to `config.apiKey`. The `local` provider uses this to fall back to
+     * an env var + placeholder, since the OpenAI SDK requires a non-empty key but
+     * local servers don't authenticate.
+     */
+    readonly resolveApiKey?: (config: OpenAICompatConfig) => string | undefined;
+    /**
+     * Optional override for resolving the base URL from the narrowed config.
+     * Defaults to `config.baseURL ?? baseURL`. The `local` provider uses this to
+     * insert an env-var fallback (`LOCAL_MODEL_BASE_URL`) between the config and
+     * the static default, read per-call.
+     */
+    readonly resolveBaseURL?: (config: OpenAICompatConfig) => string;
+}
+/**
+ * Build a {@link ProviderDef} for any vendor that speaks the OpenAI Chat
+ * Completions wire protocol. Centralizes the construction shared by xai / zai /
+ * google / local and the runtime-registered (`provider-admin`) vendors: it
+ * reuses the shared {@link OpenAIProvider} with the vendor slug + base URL +
+ * default model + catalog forced on, and (unless `validate: false`) wires
+ * `validateOpenAICompatKey` against the vendor's base URL.
+ *
+ * The per-vendor file becomes a single declarative call carrying only the
+ * vendor's constants; the cfg-narrowing + slug-forcing + validate wiring live
+ * here once.
+ */
+export declare function defineOpenAICompatProvider(spec: DefineOpenAICompatProviderSpec): ProviderDef;
+//# sourceMappingURL=compat.d.ts.map

package/dist/compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../src/compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAIjH;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,CAO1F;AAED,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gGAAgG;IAChG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yHAAyH;IACzH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAChD,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,MAAM,GAAG,SAAS,CAAC;IAC5E;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,MAAM,CAAC;CAClE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,WAAW,CAqB5F"}

package/dist/compat.js

@@ -0,0 +1,53 @@
+import { defineProvider } from '@moxxy/sdk';
+import { OpenAIProvider } from './provider.js';
+import { validateKey as validateOpenAICompatKey } from './validate.js';
+/**
+ * Narrow the registry's untyped config down to the handful of optional string
+ * fields an OpenAI-compatible vendor forwards (`apiKey`/`baseURL`/`defaultModel`).
+ * A blanket `config as OpenAIProviderConfig` cast would silently smuggle any
+ * wrong-typed field straight through to the client; this pick keeps only
+ * known-good strings so a bad value falls back to the vendor defaults instead.
+ */
+export function pickOpenAICompatConfig(config) {
+    const str = (v) => (typeof v === 'string' ? v : undefined);
+    return {
+        apiKey: str(config.apiKey),
+        baseURL: str(config.baseURL),
+        defaultModel: str(config.defaultModel),
+    };
+}
+/**
+ * Build a {@link ProviderDef} for any vendor that speaks the OpenAI Chat
+ * Completions wire protocol. Centralizes the construction shared by xai / zai /
+ * google / local and the runtime-registered (`provider-admin`) vendors: it
+ * reuses the shared {@link OpenAIProvider} with the vendor slug + base URL +
+ * default model + catalog forced on, and (unless `validate: false`) wires
+ * `validateOpenAICompatKey` against the vendor's base URL.
+ *
+ * The per-vendor file becomes a single declarative call carrying only the
+ * vendor's constants; the cfg-narrowing + slug-forcing + validate wiring live
+ * here once.
+ */
+export function defineOpenAICompatProvider(spec) {
+    const resolveApiKey = spec.resolveApiKey ?? ((cfg) => cfg.apiKey);
+    const resolveBaseURL = spec.resolveBaseURL ?? ((cfg) => cfg.baseURL ?? spec.baseURL);
+    return defineProvider({
+        name: spec.name,
+        models: [...spec.models],
+        createClient: (config) => {
+            const cfg = pickOpenAICompatConfig(config);
+            return new OpenAIProvider({
+                apiKey: resolveApiKey(cfg),
+                name: spec.name,
+                baseURL: resolveBaseURL(cfg),
+                defaultModel: cfg.defaultModel ?? spec.defaultModel,
+                models: spec.models,
+            });
+        },
+        ...(spec.validate === false
+            ? {}
+            : { validateKey: (key) => validateOpenAICompatKey(key, { baseURL: spec.baseURL }) }),
+        ...(spec.auth ? { auth: spec.auth } : {}),
+    });
+}
+//# sourceMappingURL=compat.js.map

package/dist/compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.js","sourceRoot":"","sources":["../src/compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuE,MAAM,YAAY,CAAC;AACjH,OAAO,EAAE,cAAc,EAA6B,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,WAAW,IAAI,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAevE;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA+B;IACpE,MAAM,GAAG,GAAG,CAAC,CAAU,EAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACxF,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;QAC1B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;QAC5B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC;KACvC,CAAC;AACJ,CAAC;AAwCD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAoC;IAC7E,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,GAAuB,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtF,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC,GAAuB,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IACzG,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACxB,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;YACvB,MAAM,GAAG,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;YAC3C,OAAO,IAAI,cAAc,CAAC;gBACxB,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC;gBAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC;gBAC5B,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY;gBACnD,MAAM,EAAE,IAAI,CAAC,MAAM;aACW,CAAC,CAAC;QACpC,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,KAAK;YACzB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC9F,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { OpenAIProvider, openAIModels, type OpenAIProviderConfig } from './provider.js';
+export { OpenAIProvider, openAIModels };
+export type { OpenAIProviderConfig };
+export { toOpenAIMessages, toOpenAITools } from './translate.js';
+export { validateKey, type ValidateKeyDeps, type ValidationResult } from './validate.js';
+export { validateKey as validateOpenAICompatKey } from './validate.js';
+export { defineOpenAICompatProvider, pickOpenAICompatConfig, type DefineOpenAICompatProviderSpec, type OpenAICompatConfig, } from './compat.js';
+export declare const openaiProviderDef: import("@moxxy/sdk").ProviderDef;
+export declare const openaiPlugin: import("@moxxy/sdk").Plugin;
+export default openaiPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAExF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC;AACxC,YAAY,EAAE,oBAAoB,EAAE,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAIzF,OAAO,EAAE,WAAW,IAAI,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAIvE,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,KAAK,8BAA8B,EACnC,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAIrB,eAAO,MAAM,iBAAiB,kCAK5B,CAAC;AAEH,eAAO,MAAM,YAAY,6BAIvB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+import { defineProvider, definePlugin } from '@moxxy/sdk';
+import { OpenAIProvider, openAIModels } from './provider.js';
+export { OpenAIProvider, openAIModels };
+export { toOpenAIMessages, toOpenAITools } from './translate.js';
+export { validateKey } from './validate.js';
+// DI-friendly alias: any OpenAI-compatible vendor (same `models.list` probe)
+// can reuse this validator. Re-exported under a vendor-neutral name so other
+// packages don't couple to the OpenAI-specific `validateKey` symbol.
+export { validateKey as validateOpenAICompatKey } from './validate.js';
+// Shared factory for OpenAI-Chat-Completions-compatible vendors (xai/zai/google/
+// local + runtime provider-admin entries). Captures the slug-forcing client
+// construction + config narrowing + validateKey wiring in one place.
+export { defineOpenAICompatProvider, pickOpenAICompatConfig, } from './compat.js';
+import { validateKey as validateOpenAIKey } from './validate.js';
+export const openaiProviderDef = defineProvider({
+    name: 'openai',
+    models: [...openAIModels],
+    createClient: (config) => new OpenAIProvider(config),
+    validateKey: (key) => validateOpenAIKey(key),
+});
+export const openaiPlugin = definePlugin({
+    name: '@moxxy/plugin-provider-openai',
+    version: '0.0.0',
+    providers: [openaiProviderDef],
+});
+export default openaiPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,YAAY,EAA6B,MAAM,eAAe,CAAC;AAExF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,WAAW,EAA+C,MAAM,eAAe,CAAC;AACzF,6EAA6E;AAC7E,6EAA6E;AAC7E,qEAAqE;AACrE,OAAO,EAAE,WAAW,IAAI,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACvE,iFAAiF;AACjF,4EAA4E;AAC5E,qEAAqE;AACrE,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,GAGvB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;IAC9C,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC;IACzB,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,MAA8B,CAAC;IAC5E,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC;IACvC,IAAI,EAAE,+BAA+B;IACrC,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,CAAC,iBAAiB,CAAC;CAC/B,CAAC,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,44 @@
+import OpenAI from 'openai';
+import type { LLMProvider, ModelDescriptor, ProviderEvent, ProviderRequest } from '@moxxy/sdk';
+export interface OpenAIProviderConfig {
+    readonly apiKey?: string;
+    readonly baseURL?: string;
+    readonly defaultModel?: string;
+    readonly client?: OpenAI;
+    /**
+     * Override the reported provider name (events, usage stats, error
+     * context). Defaults to `'openai'`. Runtime-registered OpenAI-compatible
+     * vendors (provider_add → z.ai, deepseek, groq, …) reuse this class and
+     * MUST pass their own slug here, otherwise their traffic and errors are
+     * all misattributed to OpenAI.
+     */
+    readonly name?: string;
+    /**
+     * Override the advertised model catalog. Defaults to the OpenAI catalog.
+     * Runtime-registered vendors pass their own descriptors so context-window
+     * lookups (compaction/elision budgets) and capability gating
+     * (supportsImages/supportsDocuments) work against the vendor's models
+     * instead of missing on the OpenAI list.
+     */
+    readonly models?: ReadonlyArray<ModelDescriptor>;
+}
+/**
+ * Model catalog as of OpenAI's 2026 API surface. The 5.x family supersedes
+ * the 4o family but the older ones stay listed so existing configs keep
+ * working without a forced migration.
+ *
+ * Output/context numbers are the public documented limits as of April-May
+ * 2026; verify against https://developers.openai.com/api/docs/models when
+ * picking a model for a long-context workload.
+ */
+export declare const openAIModels: ReadonlyArray<ModelDescriptor>;
+export declare class OpenAIProvider implements LLMProvider {
+    readonly name: string;
+    readonly models: ReadonlyArray<ModelDescriptor>;
+    private readonly client;
+    private readonly defaultModel;
+    constructor(config?: OpenAIProviderConfig);
+    stream(req: ProviderRequest): AsyncIterable<ProviderEvent>;
+    countTokens(req: Pick<ProviderRequest, 'model' | 'messages' | 'system' | 'tools'>): Promise<number>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,eAAe,EAEhB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CAClD;AAED;;;;;;;;GAQG;AAMH,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,eAAe,CAyBvD,CAAC;AASF,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,GAAE,oBAAyB;IAYtC,MAAM,CAAC,GAAG,EAAE,eAAe,GAAG,aAAa,CAAC,aAAa,CAAC;IAoM3D,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAQ1G"}

package/dist/provider.js

@@ -0,0 +1,261 @@
+import OpenAI from 'openai';
+import { estimateTextTokens, toFriendlyError } from '@moxxy/sdk';
+import { toOpenAIMessages, toOpenAITools } from './translate.js';
+/**
+ * Model catalog as of OpenAI's 2026 API surface. The 5.x family supersedes
+ * the 4o family but the older ones stay listed so existing configs keep
+ * working without a forced migration.
+ *
+ * Output/context numbers are the public documented limits as of April-May
+ * 2026; verify against https://developers.openai.com/api/docs/models when
+ * picking a model for a long-context workload.
+ */
+// The gpt-5.x family are reasoning models (`supportsReasoning`): they accept
+// `reasoning_effort` and, on backends that stream a summary, surface reasoning
+// deltas. Official OpenAI Chat Completions doesn't stream a reasoning summary
+// (Responses-API only), so the flag mainly gates the config UI + effort there;
+// OpenAI-compatible reasoning backends (DeepSeek/z.ai/local) do stream it.
+export const openAIModels = [
+    // GPT-5.5 family (released April 23, 2026): newest frontier class.
+    { id: 'gpt-5.5', contextWindow: 1_050_000, maxOutputTokens: 128_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true, supportsReasoning: true },
+    { id: 'gpt-5.5-pro', contextWindow: 1_050_000, maxOutputTokens: 128_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true, supportsReasoning: true },
+    // GPT-5.4 family: cheaper general-purpose tier; -mini and -nano are the
+    // new sweet-spot defaults for high-volume agentic workloads.
+    { id: 'gpt-5.4', contextWindow: 1_000_000, maxOutputTokens: 128_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true, supportsReasoning: true },
+    { id: 'gpt-5.4-pro', contextWindow: 1_000_000, maxOutputTokens: 128_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true, supportsReasoning: true },
+    { id: 'gpt-5.4-mini', contextWindow: 400_000, maxOutputTokens: 128_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true, supportsReasoning: true },
+    { id: 'gpt-5.4-nano', contextWindow: 400_000, maxOutputTokens: 128_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true, supportsReasoning: true },
+    // GPT-5.3-Codex: agentic coding specialist. Vision-capable.
+    { id: 'gpt-5.3-codex', contextWindow: 400_000, maxOutputTokens: 128_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true, supportsReasoning: true },
+    // GPT-5.2 and GPT-5: prior reasoning models, configurable effort.
+    { id: 'gpt-5.2', contextWindow: 400_000, maxOutputTokens: 128_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true, supportsReasoning: true },
+    { id: 'gpt-5', contextWindow: 400_000, maxOutputTokens: 128_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true, supportsReasoning: true },
+    // GPT-4 family: kept for explicit-pin use cases.
+    // 4.1 is text-only; 4o/4o-mini are vision + document capable; 4-turbo predates file inputs.
+    { id: 'gpt-4.1', contextWindow: 1_000_000, maxOutputTokens: 32_768, supportsTools: true, supportsStreaming: true },
+    { id: 'gpt-4o', contextWindow: 128_000, maxOutputTokens: 16_384, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true },
+    { id: 'gpt-4o-mini', contextWindow: 128_000, maxOutputTokens: 16_384, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsDocuments: true },
+    { id: 'gpt-4-turbo', contextWindow: 128_000, maxOutputTokens: 4_096, supportsTools: true, supportsStreaming: true, supportsImages: true },
+];
+export class OpenAIProvider {
+    name;
+    models;
+    client;
+    defaultModel;
+    constructor(config = {}) {
+        this.name = config.name ?? 'openai';
+        this.models = config.models ?? openAIModels;
+        this.client =
+            config.client ??
+                new OpenAI({
+                    apiKey: config.apiKey ?? process.env.OPENAI_API_KEY,
+                    ...(config.baseURL ? { baseURL: config.baseURL } : {}),
+                });
+        this.defaultModel = config.defaultModel ?? 'gpt-5.4-mini';
+    }
+    async *stream(req) {
+        const messages = toOpenAIMessages(req.messages);
+        // `req.system` is the hook-injection side channel (e.g. the memory
+        // consolidation nudge): extra system text delivered IN ADDITION to any
+        // system-role messages already in `req.messages`. Insert it right after
+        // the leading system message(s) so it reads as system guidance without
+        // reordering the conversation.
+        if (req.system) {
+            let insertAt = 0;
+            while (insertAt < messages.length && messages[insertAt].role === 'system')
+                insertAt += 1;
+            messages.splice(insertAt, 0, { role: 'system', content: req.system });
+        }
+        const tools = req.tools && req.tools.length > 0 ? toOpenAITools(req.tools) : undefined;
+        const model = req.model || this.defaultModel;
+        yield { type: 'message_start', model };
+        // GPT-5.x (and OpenAI's reasoning models) renamed the token cap field
+        // from `max_tokens` to `max_completion_tokens` and ALSO reject the
+        // legacy name with a 400. Use the new name for any model whose id
+        // starts with gpt-5 / o1 / o3; keep the legacy name for the gpt-4
+        // family so existing callers don't regress.
+        const usesCompletionTokens = /^(?:gpt-5|o1|o3)/.test(model);
+        const tokenLimitKey = usesCompletionTokens ? 'max_completion_tokens' : 'max_tokens';
+        // Reasoning preview is gated by the per-provider toggle (`req.reasoning`).
+        // When on, request `reasoning_effort` for OpenAI reasoning models (improves
+        // depth + makes a summary available where the backend streams one) and
+        // surface the streamed reasoning/reasoning_content deltas.
+        const emitReasoning = req.reasoning != null && req.reasoning !== false;
+        const reasoningEffort = typeof req.reasoning === 'object' ? req.reasoning.effort : undefined;
+        // Type the request body as the SDK's streaming-create params so field
+        // names/value types are checked. The local `OpenAIChatMessage` /
+        // `OpenAIToolDef` shapes genuinely diverge from the SDK's wide message/tool
+        // unions (we build a narrower, hand-rolled shape), so cast ONLY those two
+        // fields — not the whole body — keeping the rest type-checked.
+        const params = {
+            model,
+            messages: messages,
+            ...(tools
+                ? { tools: tools }
+                : {}),
+            ...(req.temperature !== undefined ? { temperature: req.temperature } : {}),
+            ...(req.maxTokens ? { [tokenLimitKey]: req.maxTokens } : {}),
+            // Send `reasoning_effort` independently of the token-field heuristic.
+            // The two are unrelated concerns: `usesCompletionTokens` picks the cap
+            // FIELD NAME for the OpenAI-hosted reasoning models, while effort applies
+            // to any reasoning backend. OpenAI-compatible vendors (z.ai GLM,
+            // DeepSeek-R1, vLLM, Ollama) honor reasoning_effort but their model ids
+            // never match the gpt-5/o1/o3 regex, so gating effort on it silently
+            // dropped a user-requested effort for exactly those backends. The
+            // descriptor's `supportsReasoning` already gates this upstream via
+            // req.reasoning.
+            ...(emitReasoning && reasoningEffort ? { reasoning_effort: reasoningEffort } : {}),
+            stream: true,
+            // OpenAI only emits the final `usage` chunk when this is set;
+            // without it `raw.usage` is null on every chunk and token usage
+            // (and cache-read counts) are silently lost for every streamed turn.
+            stream_options: { include_usage: true },
+        };
+        let stream;
+        try {
+            stream = (await this.client.chat.completions.create(params, 
+            // Pass the AbortSignal into the SDK request options so cancelling
+            // mid-stream tears down the underlying HTTP request instead of just
+            // stopping our consumption loop. Without this, Esc / Ctrl+C felt
+            // like nothing happened — the model kept generating and the user
+            // got charged for tokens after the cancel.
+            req.signal ? { signal: req.signal } : undefined));
+        }
+        catch (err) {
+            // A cancel can surface as a thrown AbortError from the create() await —
+            // report the clean terminal 'aborted' event (parity with the Anthropic
+            // provider) so callers that suppress error UI on user cancel don't get a
+            // noisy classified provider error.
+            if (req.signal?.aborted) {
+                yield { type: 'error', message: 'aborted', retryable: false };
+                return;
+            }
+            yield { type: 'error', ...toFriendlyError(err, { provider: this.name }) };
+            return;
+        }
+        const pending = new Map();
+        let stopReason = 'end_turn';
+        let usageIn = 0;
+        let usageOut = 0;
+        let usageCacheRead = 0;
+        try {
+            for await (const raw of stream) {
+                if (req.signal?.aborted) {
+                    yield { type: 'error', message: 'aborted', retryable: false };
+                    return;
+                }
+                // Usage arrives in a FINAL chunk that has an empty `choices` array
+                // (only when stream_options.include_usage is set), so it must be read
+                // before the `!choice` guard below — otherwise it's `continue`d past.
+                if (raw.usage) {
+                    usageIn = raw.usage.prompt_tokens ?? usageIn;
+                    usageOut = raw.usage.completion_tokens ?? usageOut;
+                    // `prompt_tokens` already includes the cached portion; surface the
+                    // cached count so cache hit-rate accounting works (parity with the
+                    // Anthropic provider's cache_read_input_tokens).
+                    usageCacheRead = raw.usage.prompt_tokens_details?.cached_tokens ?? usageCacheRead;
+                }
+                const choice = raw.choices?.[0];
+                if (!choice)
+                    continue;
+                const delta = choice.delta ?? {};
+                if (typeof delta.content === 'string' && delta.content) {
+                    yield { type: 'text_delta', delta: delta.content };
+                }
+                if (emitReasoning) {
+                    const reasoning = delta.reasoning_content ?? delta.reasoning;
+                    if (typeof reasoning === 'string' && reasoning) {
+                        yield { type: 'reasoning_delta', delta: reasoning };
+                    }
+                }
+                if (delta.tool_calls) {
+                    for (const tcDelta of delta.tool_calls) {
+                        const idx = tcDelta.index ?? 0;
+                        let entry = pending.get(idx);
+                        if (!entry) {
+                            entry = {
+                                id: tcDelta.id ?? `call_${idx}`,
+                                name: tcDelta.function?.name ?? '',
+                                argsBuffer: '',
+                                emittedStart: false,
+                            };
+                            pending.set(idx, entry);
+                        }
+                        else if (tcDelta.id) {
+                            entry.id = tcDelta.id;
+                        }
+                        if (tcDelta.function?.name && !entry.name)
+                            entry.name = tcDelta.function.name;
+                        if (tcDelta.function?.name && !entry.emittedStart && entry.name) {
+                            entry.emittedStart = true;
+                            yield { type: 'tool_use_start', id: entry.id, name: entry.name };
+                        }
+                        if (typeof tcDelta.function?.arguments === 'string') {
+                            entry.argsBuffer += tcDelta.function.arguments;
+                            yield { type: 'tool_use_delta', id: entry.id, partialInput: tcDelta.function.arguments };
+                        }
+                    }
+                }
+                if (choice.finish_reason) {
+                    stopReason = mapStopReason(choice.finish_reason);
+                }
+            }
+        }
+        catch (err) {
+            // The SDK rejects the iterator with an AbortError once req.signal fires;
+            // emit the clean 'aborted' event instead of a classified provider error
+            // (parity with the Anthropic provider and the in-loop abort check above).
+            if (req.signal?.aborted) {
+                yield { type: 'error', message: 'aborted', retryable: false };
+                return;
+            }
+            yield { type: 'error', ...toFriendlyError(err, { provider: this.name }) };
+            return;
+        }
+        // Flush tool_use_end events with parsed arguments.
+        for (const entry of pending.values()) {
+            let parsed = {};
+            if (entry.argsBuffer) {
+                try {
+                    parsed = JSON.parse(entry.argsBuffer);
+                }
+                catch {
+                    parsed = { _rawPartial: entry.argsBuffer };
+                }
+            }
+            if (entry.emittedStart) {
+                yield { type: 'tool_use_end', id: entry.id, input: parsed };
+            }
+        }
+        yield {
+            type: 'message_end',
+            stopReason,
+            usage: usageIn > 0 || usageOut > 0
+                ? {
+                    inputTokens: usageIn,
+                    outputTokens: usageOut,
+                    ...(usageCacheRead > 0 ? { cacheReadTokens: usageCacheRead } : {}),
+                }
+                : undefined,
+        };
+    }
+    async countTokens(req) {
+        // OpenAI doesn't expose a free token counter; fall back to a coarse estimate.
+        const blob = (req.system ?? '') +
+            req.messages.map((m) => m.content.map((c) => ('text' in c ? c.text : JSON.stringify(c))).join('')).join('') +
+            (req.tools ?? []).map((t) => t.name + t.description).join('');
+        return estimateTextTokens(blob);
+    }
+}
+function mapStopReason(s) {
+    if (s === 'tool_calls')
+        return 'tool_use';
+    if (s === 'length')
+        return 'max_tokens';
+    if (s === 'stop')
+        return 'end_turn';
+    if (s === 'content_filter')
+        return 'error';
+    return 'end_turn';
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/translate.d.ts

@@ -0,0 +1,41 @@
+import type { ProviderMessage, ToolDef } from '@moxxy/sdk';
+export type OpenAIUserContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+    };
+} | {
+    type: 'file';
+    file: {
+        filename?: string;
+        file_data: string;
+    };
+};
+export interface OpenAIChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content?: string | ReadonlyArray<OpenAIUserContentPart> | null;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    tool_call_id?: string;
+    name?: string;
+}
+export interface OpenAIToolDef {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: unknown;
+    };
+}
+export declare function toOpenAIMessages(messages: ReadonlyArray<ProviderMessage>): OpenAIChatMessage[];
+export declare function toOpenAITools(tools: ReadonlyArray<ToolDef>): OpenAIToolDef[];
+//# sourceMappingURL=translate.d.ts.map