@cleocode/core 2026.6.6 → 2026.6.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/core",
-  "version": "2026.6.6",
+  "version": "2026.6.8",
   "description": "CLEO core business logic kernel — tasks, sessions, memory, orchestration, lifecycle, with bundled SQLite store",
   "type": "module",
   "main": "./dist/index.js",
@@ -429,16 +429,16 @@
     "write-file-atomic": "^7.0.1",
     "yaml": "^2.8.3",
     "zod": "^4.3.6",
-    "@cleocode/adapters": "2026.6.6",
-    "@cleocode/agents": "2026.6.6",
-    "@cleocode/contracts": "2026.6.6",
-    "@cleocode/git-shim": "2026.6.6",
-    "@cleocode/caamp": "2026.6.6",
-    "@cleocode/lafs": "2026.6.6",
-    "@cleocode/nexus": "2026.6.6",
-    "@cleocode/skills": "2026.6.6",
-    "@cleocode/paths": "2026.6.6",
-    "@cleocode/worktree": "2026.6.6"
+    "@cleocode/adapters": "2026.6.8",
+    "@cleocode/agents": "2026.6.8",
+    "@cleocode/caamp": "2026.6.8",
+    "@cleocode/git-shim": "2026.6.8",
+    "@cleocode/contracts": "2026.6.8",
+    "@cleocode/lafs": "2026.6.8",
+    "@cleocode/paths": "2026.6.8",
+    "@cleocode/nexus": "2026.6.8",
+    "@cleocode/worktree": "2026.6.8",
+    "@cleocode/skills": "2026.6.8"
   },
   "engines": {
     "node": ">=24.16.0"
@@ -472,7 +472,7 @@
   },
   "optionalDependencies": {
     "llmtxt": "^2026.5.15",
-    "@cleocode/studio": "^2026.6.6"
+    "@cleocode/studio": "^2026.6.8"
   },
   "scripts": {
     "build": "tsc",

package/dist/llm/transports/openai.d.ts

@@ -1,181 +0,0 @@
-/**
- * OpenAI LLM transport — real implementation.
- *
- * Migrated from {@link OpenAIBackend} (`backends/openai.ts`), adapted to the
- * provider-neutral {@link LlmTransport} interface. Behavior is preserved
- * verbatim; only the constructor signature and I/O types change to match the
- * Phase-4 transport contract.
- *
- * Key behavioral invariants (each enforced with `@invariant` TSDoc at the
- * enforcement site):
- *
- * 1. `usesMaxCompletionTokens` o-series branching — `gpt-5*`, `o1*`, `o3*`,
- *    `o4*` use `max_completion_tokens`; all others use `max_tokens`.
- * 2. `extractReasoningContent` intentional try/catch swallow — NEVER re-throws.
- *    Returns null on any parse error.
- * 3. `parse()` vs `json_schema` streaming split — `complete()` may use `.parse()`
- *    for non-streaming structured output; `stream()` NEVER uses `.parse()`,
- *    always `json_schema` response_format.
- *
- * @module llm/transports/openai
- * @task T9284 (W1b)
- * @epic T-LLM-CRED-CENTRALIZATION
- * @see ADR-072 §LlmTransport — pure wire level
- */
-import type { NormalizedDelta, TransportContext } from '@cleocode/contracts/llm/interfaces.js';
-import type { LlmTransport, NormalizedResponse, TransportRequest } from '@cleocode/contracts/llm/normalized-response.js';
-import type { ApiMode } from '@cleocode/contracts/llm/provider-id.js';
-/**
- * Options accepted by {@link OpenAITransport}.
- *
- * Structurally identical to `AnthropicTransportOptions` so the role-resolver
- * can swap providers by swapping only the constructor reference.
- */
-export interface OpenAITransportOptions {
-    /** API key or bearer token. */
-    apiKey: string;
-    /** Override base URL (e.g. Azure OpenAI endpoint). */
-    baseUrl?: string;
-    /** Extra headers merged into every SDK request. */
-    defaultHeaders?: Record<string, string>;
-}
-/**
- * Determine if the model requires `max_completion_tokens` instead of `max_tokens`.
- *
- * @invariant usesMaxCompletionTokens o-series branching — `gpt-5`, `gpt-5-*`,
- *   `gpt-5.*`, `o1*`, `o3*`, `o4*` use `max_completion_tokens`; all others use
- *   `max_tokens`. Exported with the SAME name and signature as the old backend
- *   so all callers via `index.ts` continue to work without change.
- *
- * @param model - Provider model identifier to test.
- * @returns `true` when the model family requires `max_completion_tokens`.
- */
-export declare function usesMaxCompletionTokens(model: string): boolean;
-/**
- * Real OpenAI transport.
- *
- * Wraps the `openai` SDK and normalizes requests/responses to/from the
- * provider-neutral {@link LlmTransport} interface. Supports o-series models
- * (via `max_completion_tokens` branching), structured output (via `json_schema`
- * response_format or Zod `.parse()`), streaming, and reasoning content
- * extraction.
- *
- * @example
- * ```ts
- * const transport = new OpenAITransport({ apiKey: process.env.OPENAI_API_KEY! });
- * const response = await transport.complete({
- *   model: 'gpt-4o',
- *   messages: [{ role: 'user', content: 'Hello' }],
- *   maxTokens: 1024,
- * });
- * ```
- */
-export declare class OpenAITransport implements LlmTransport {
-    /** Provider identifier — always `'openai'`. */
-    readonly provider: "openai";
-    /**
-     * Wire protocol spoken by this transport — always `'chat_completions'`.
-     *
-     * @see ADR-072 §Type lock-in
-     */
-    readonly apiMode: ApiMode;
-    private readonly _client;
-    /**
-     * Create an `OpenAITransport`.
-     *
-     * @param options - API key, optional base URL, and optional extra headers.
-     */
-    constructor(options: OpenAITransportOptions);
-    /**
-     * Execute a single completion call against the OpenAI chat completions API.
-     *
-     * Maps provider-neutral {@link TransportRequest} to the `openai` SDK
-     * `chat.completions.create` call, then normalizes the response to
-     * {@link NormalizedResponse}.
-     *
-     * When `request` carries a Zod-schema `responseFormat`, uses `.parse()` for
-     * non-streaming structured output (the only path where `.parse()` is safe).
-     *
-     * @invariant parse() vs json_schema streaming split — `complete()` is the ONLY
-     *   path that may use `.parse()` for structured output. `stream()` MUST NOT use
-     *   `.parse()` — it always uses `json_schema` response_format instead.
-     *
-     * @param request - Provider-neutral request parameters.
-     * @param _ctx - Transport context (unused by this transport).
-     * @returns Normalized response including content, tool calls, usage, and raw SDK object.
-     */
-    complete(request: TransportRequest, _ctx?: TransportContext): Promise<NormalizedResponse>;
-    /**
-     * Stream a completion against the OpenAI chat completions API.
-     *
-     * Yields {@link NormalizedDelta} chunks including incremental text deltas and
-     * tool-call argument deltas. The final delta carries `stopReason` and `usage`.
-     *
-     * Tool-call streaming sequence per tool index:
-     * 1. First chunk for index `i` (`tool_calls[i].function.name` present) → yields
-     *    `toolCallDelta` with `{ index, name, argumentsChunk }` (start marker).
-     * 2. Subsequent chunks (name absent) → yields `toolCallDelta` with
-     *    `{ index, argumentsChunk }` (incremental JSON fragment).
-     *
-     * @invariant T9316 tool-call streaming parity — emits same toolCallDelta shape
-     *   as AnthropicTransport and ChatCompletionsTransport.
-     *
-     * @invariant parse() vs json_schema streaming split — `stream()` MUST NOT use
-     *   `.parse()` for structured output. When a `responseFormat` schema is present,
-     *   only `json_schema` response_format is used. `.parse()` would block the
-     *   stream since the full JSON must be assembled first — use `complete()` instead.
-     *
-     * @param request - Provider-neutral request parameters.
-     * @param _ctx - Transport context (unused by this transport).
-     * @returns An async iterable of normalized delta chunks.
-     */
-    stream(request: TransportRequest, _ctx: TransportContext): AsyncIterable<NormalizedDelta>;
-    /**
-     * Returns true when the error signals a credential rotation should be attempted.
-     *
-     * @param err - The error thrown by the provider SDK.
-     * @returns Whether a credential rotation should be attempted.
-     */
-    shouldRotateCredential(err: unknown): boolean;
-    /**
-     * Build the OpenAI API request params from normalized request fields.
-     *
-     * @invariant usesMaxCompletionTokens o-series branching — sets
-     *   `max_completion_tokens` for gpt-5* / o1* / o3* / o4* models;
-     *   `max_tokens` for all others.
-     */
-    private _buildParams;
-    /**
-     * Normalize a raw OpenAI SDK response into {@link NormalizedResponse}.
-     *
-     * @param response - Raw `OpenAI.ChatCompletion` from the SDK.
-     * @param modelName - Model identifier (carried into the response envelope).
-     * @param contentOverride - When set, replaces the message content (used for structured output).
-     */
-    private _normalizeResponse;
-    /**
-     * Convert provider-neutral tools to OpenAI `function` tool format.
-     *
-     * Already-converted inputs (first element has `type: 'function'`) are passed
-     * through unchanged.
-     */
-    private _convertTools;
-    /**
-     * Extract a Zod schema from a class or constructor that carries a `.schema`
-     * property or IS a ZodType.
-     *
-     * Accepts `unknown` because at runtime the value can be a constructor with a
-     * static `.schema`, a Zod type instance, or neither — narrowed via type
-     * guards rather than `as unknown as` chains (T9767).
-     */
-    private _zodSchemaFrom;
-    /**
-     * Convert a Zod schema to a minimal JSON Schema object for the
-     * `json_schema` response_format.
-     *
-     * Uses `.shape` for `ZodObject`; returns `{}` for other Zod types.
-     * Full support would require `zod-to-json-schema` — this covers the common case.
-     */
-    private _zodToJsonSchema;
-}
-//# sourceMappingURL=openai.d.ts.map

package/dist/llm/transports/openai.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/llm/transports/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAGlB,gBAAgB,EACjB,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAatE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO9D;AAsND;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAG,QAAQ,CAAU;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAA+B;IAExD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC;;;;OAIG;gBACS,OAAO,EAAE,sBAAsB;IAQ3C;;;;;;;;;;;;;;;;;OAiBG;IACG,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsG/F;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACI,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAAC,eAAe,CAAC;IAmKhG;;;;;OAKG;IACH,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAY7C;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAkDpB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IA+D1B;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;CAazB"}