@jeffusion/bungee-llms 5.19.0 → 5.20.0

package/dist/responses-codec/common.d.ts

@@ -0,0 +1,48 @@
+export type ResponsesProtocol = 'chat_completions' | 'anthropic_messages';
+export type JsonRecord = Record<string, unknown>;
+export interface ResponsesToolName {
+    name: string;
+    namespace?: string;
+    custom: boolean;
+}
+/** Per-request wire-name authority; never infer namespaces by splitting a provider name. */
+export type ResponsesToolNames = ReadonlyMap<string, ResponsesToolName>;
+export interface ResponsesCodecLimits {
+    maxRequestBytes: number;
+    maxOutputBytes: number;
+    maxArgumentBytes: number;
+    maxItems: number;
+}
+export declare const DEFAULT_RESPONSES_CODEC_LIMITS: Readonly<ResponsesCodecLimits>;
+export interface ResponsesCodecCapabilities {
+    reasoningEffort?: boolean;
+    /** Explicit provider-approved thinking budget; do not guess budgets from effort labels. */
+    anthropicThinkingBudget?: number;
+    maxOutputTokens?: number;
+    limits?: Partial<ResponsesCodecLimits>;
+}
+export declare class ResponsesCodecError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function fail(code: string, message: string): never;
+export declare function record(value: unknown, where: string): JsonRecord;
+export declare function string(value: unknown, where: string, nonempty?: boolean): string;
+export declare function list(value: unknown, where: string): unknown[];
+export declare function limits(overrides?: Partial<ResponsesCodecLimits>): ResponsesCodecLimits;
+export declare function bytes(value: string): number;
+export declare function bounded(value: string, max: number, where: string): string;
+export declare function serialized(value: unknown, max: number, where: string): string;
+export declare function argumentObject(text: string): JsonRecord;
+export declare function restoreTool(name: string, names: ResponsesToolNames): ResponsesToolName;
+export declare function customInput(text: string): string;
+/** Decode only complete JSON-string characters. A split escape remains buffered. */
+export declare function customInputPrefix(text: string): string;
+export interface Terminal {
+    status: 'completed' | 'incomplete' | 'failed';
+    reason: string;
+}
+export declare function terminal(reason: unknown, protocol: ResponsesProtocol): Terminal;
+export declare function normalizeUsage(raw: unknown, protocol: ResponsesProtocol, prior?: JsonRecord): JsonRecord;
+export declare function toolItem(id: string, name: string, args: string, names: ResponsesToolNames, status?: string): JsonRecord;
+export declare function responsePayload(id: string, model: string, output: JsonRecord[], end: Terminal, usage: JsonRecord, error?: unknown, createdAt?: number): JsonRecord;

package/dist/responses-codec/events.d.ts

@@ -0,0 +1,43 @@
+import { type JsonRecord, type ResponsesCodecLimits, type ResponsesProtocol, type ResponsesToolNames } from './common';
+/** Incremental payload codec. SSE framing and transport cancellation remain caller-owned.
+ * Chat terminal is deferred until finish() so trailing usage-only chunks are retained.
+ * Anthropic additionally requires message_stop, not merely a stop_reason in message_delta.
+ */
+export declare class ResponsesEventEncoder {
+    readonly protocol: ResponsesProtocol;
+    readonly model: string;
+    readonly toolNames: ResponsesToolNames;
+    private readonly budget;
+    private readonly id;
+    private readonly createdAt;
+    private readonly output;
+    private readonly states;
+    private readonly anthropicBlocks;
+    private usage;
+    private end?;
+    private error?;
+    private started;
+    private anthropicStarted;
+    private anthropicStopped;
+    private finalized;
+    private poisoned;
+    private sequence;
+    private retained;
+    constructor(protocol: ResponsesProtocol, model: string, toolNames?: ResponsesToolNames, configuredLimits?: Partial<ResponsesCodecLimits>);
+    private event;
+    private start;
+    private retain;
+    private state;
+    private fields;
+    private item;
+    private part;
+    private add;
+    private appendText;
+    private emitArgs;
+    private toolDelta;
+    push(raw: unknown): JsonRecord[];
+    private chat;
+    private anthropic;
+    private complete;
+    finish(): JsonRecord[];
+}

package/dist/responses-codec/index.d.ts

@@ -0,0 +1,4 @@
+export { decodeResponsesRequest, type DecodedResponsesRequest } from './request';
+export { encodeResponsesResult } from './result';
+export { ResponsesEventEncoder } from './events';
+export { ResponsesCodecError, DEFAULT_RESPONSES_CODEC_LIMITS, type ResponsesProtocol, type ResponsesToolName, type ResponsesToolNames, type ResponsesCodecCapabilities, type ResponsesCodecLimits } from './common';

package/dist/responses-codec/request.d.ts

@@ -0,0 +1,7 @@
+import { type JsonRecord, type ResponsesCodecCapabilities, type ResponsesProtocol, type ResponsesToolNames } from './common';
+export interface DecodedResponsesRequest {
+    body: JsonRecord;
+    toolNames: ResponsesToolNames;
+}
+/** Converts only self-contained history. Reference resolution belongs to the caller. */
+export declare function decodeResponsesRequest(raw: unknown, protocol: ResponsesProtocol, capabilities?: ResponsesCodecCapabilities): DecodedResponsesRequest;

package/dist/responses-codec/result.d.ts

@@ -0,0 +1,3 @@
+import { type JsonRecord, type ResponsesCodecLimits, type ResponsesProtocol, type ResponsesToolNames } from './common';
+/** JSON and SSE share the same validation and item/terminal semantics. */
+export declare function encodeResponsesResult(raw: unknown, protocol: ResponsesProtocol, model: string, toolNames?: ResponsesToolNames, configuredLimits?: Partial<ResponsesCodecLimits>): JsonRecord;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeffusion/bungee-llms",
-  "version": "5.19.0",
+  "version": "5.20.0",
   "description": "Extensible LLM adapters and protocol conversion package for Bungee",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@jeffusion/bungee-types": "^5.19.0"
+    "@jeffusion/bungee-types": "^5.20.0"
   },
   "devDependencies": {
     "bun-types": "^1.3.2",