@acentric/llm 0.0.0-stage → 0.1.0

package/dist/read/anthropic.js

@@ -0,0 +1,56 @@
+// Readers over an Anthropic assistant message. They never change the message,
+// which is sent back as it is.
+import { isObject } from '../json.js';
+function blocks(items) {
+    return items.filter(isObject);
+}
+/** Text blocks split around citations are joined as written. */
+export function outputText(items) {
+    return blocks(items)
+        .map((block) => {
+        const text = block['text'];
+        return block['type'] === 'text' && typeof text === 'string' ? text : '';
+    })
+        .join('');
+}
+/** Anthropic reports a refusal as the stop reason, not as content. */
+export function refusals() {
+    return [];
+}
+/** Empty unless the request asked for `display: "summarized"`. */
+export function reasoningSummary(items) {
+    return blocks(items).flatMap((block) => {
+        const thinking = block['thinking'];
+        return block['type'] === 'thinking' && typeof thinking === 'string' && thinking !== ''
+            ? [thinking]
+            : [];
+    });
+}
+/**
+ * Calls to the caller's tools. Server tools (`server_tool_use`, `mcp_tool_use`)
+ * run at Anthropic and are answered in the same message, so they are not here,
+ * and every call here is pending.
+ */
+export function toolCalls(items) {
+    return blocks(items).flatMap((block) => {
+        const id = block['id'];
+        const name = block['name'];
+        const toolset = block['toolset_name'];
+        if (block['type'] !== 'tool_use' || typeof id !== 'string' || typeof name !== 'string') {
+            return [];
+        }
+        return [
+            {
+                toolCallId: id,
+                toolName: name,
+                toolType: 'function',
+                arguments: JSON.stringify(block['input'] ?? {}),
+                // A toolset member's result must name its toolset.
+                ...(typeof toolset === 'string' ? { resultOptions: { toolset_name: toolset } } : {}),
+                itemType: 'tool_use',
+                item: block,
+            },
+        ];
+    });
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/read/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/read/anthropic.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+BAA+B;AAI/B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,SAAS,MAAM,CAAC,KAAsB;IACpC,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,OAAO,MAAM,CAAC,KAAK,CAAC;SACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,UAAU,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,EAAE;YACpF,CAAC,CAAC,CAAC,QAAQ,CAAC;YACZ,CAAC,CAAC,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC9C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAc,EAAE;QACjD,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,UAAU,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvF,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO;YACL;gBACE,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,UAAU;gBACpB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC/C,mDAAmD;gBACnD,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpF,QAAQ,EAAE,UAAU;gBACpB,IAAI,EAAE,KAAK;aACZ;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/read/responses.d.ts

@@ -0,0 +1,26 @@
+import type { Json, JsonObject } from '@acentric/types';
+/** What a reader returns for one call, before it is typed for its provider. */
+export type ReadCall = {
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly toolType: 'function' | 'custom' | 'native';
+    readonly arguments?: string;
+    readonly input?: string;
+    readonly namespace?: string;
+    readonly async?: boolean;
+    readonly resultOptions?: JsonObject;
+    readonly itemType: string;
+    readonly item: JsonObject;
+};
+export type TextOptions = {
+    /** `final`, the default, leaves out commentary, which is a progress update and not the answer. */
+    readonly phase?: 'final' | 'all';
+};
+export declare function outputText(items: readonly Json[], { phase }?: TextOptions): string;
+export declare function refusals(items: readonly Json[]): string[];
+export declare function reasoningSummary(items: readonly Json[]): string[];
+/** Every call the caller answers, answered within the message or not. */
+export declare function toolCalls(items: readonly Json[]): ReadCall[];
+/** Calls with no answer in the message itself, as a hosted shell call has in its output. */
+export declare function pendingToolCalls(items: readonly Json[]): ReadCall[];
+//# sourceMappingURL=responses.d.ts.map

package/dist/read/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/read/responses.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIxD,+EAA+E;AAC/E,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,kGAAkG;IAClG,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;CAClC,CAAC;AA8BF,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,EAAE,KAAe,EAAE,GAAE,WAAgB,GAAG,MAAM,CAUhG;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,MAAM,EAAE,CAOzD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,MAAM,EAAE,CASjE;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,QAAQ,EAAE,CAe5D;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,QAAQ,EAAE,CAYnE"}

package/dist/read/responses.js

@@ -0,0 +1,121 @@
+// Readers over a Responses assistant message (OpenAI, Fireworks). They never
+// change the message, which is sent back as it is.
+import { isArray, isObject } from '../json.js';
+/** Item types answered with a `tool_result` message, and the tool type they answer. */
+const RESULT_CALLS = {
+    function_call: 'function',
+    custom_tool_call: 'custom',
+};
+/** Provider-defined calls the caller runs and answers with a `native` message. */
+const NATIVE_CALLS = new Set([
+    'computer_call',
+    'shell_call',
+    'apply_patch_call',
+    'local_shell_call',
+    'tool_search_call',
+    'mcp_approval_request',
+]);
+function messages(items) {
+    return items.filter((item) => isObject(item) && item['type'] === 'message' && isArray(item['content']));
+}
+function parts(message) {
+    const content = message['content'];
+    return isArray(content) ? content.filter(isObject) : [];
+}
+export function outputText(items, { phase = 'final' } = {}) {
+    return messages(items)
+        .filter((message) => phase === 'all' || message['phase'] !== 'commentary')
+        .map((message) => parts(message)
+        .map((part) => (part['type'] === 'output_text' ? text(part['text']) : ''))
+        .join(''))
+        .filter((joined) => joined !== '')
+        .join('\n\n');
+}
+export function refusals(items) {
+    return messages(items).flatMap((message) => parts(message).flatMap((part) => {
+        const refusal = part['refusal'];
+        return part['type'] === 'refusal' && typeof refusal === 'string' ? [refusal] : [];
+    }));
+}
+export function reasoningSummary(items) {
+    return items.flatMap((item) => {
+        if (!isObject(item) || item['type'] !== 'reasoning')
+            return [];
+        const summary = item['summary'];
+        if (!isArray(summary))
+            return [];
+        return summary.flatMap((part) => isObject(part) && typeof part['text'] === 'string' ? [part['text']] : []);
+    });
+}
+/** Every call the caller answers, answered within the message or not. */
+export function toolCalls(items) {
+    const calls = [];
+    for (const item of items) {
+        if (!isObject(item))
+            continue;
+        const type = item['type'];
+        if (typeof type !== 'string')
+            continue;
+        const toolType = RESULT_CALLS[type] ?? (NATIVE_CALLS.has(type) ? 'native' : undefined);
+        if (toolType === undefined)
+            continue;
+        // Tool search that runs at the provider has no call to answer.
+        if (type === 'tool_search_call' && item['execution'] !== 'client')
+            continue;
+        const id = type === 'mcp_approval_request' ? item['id'] : item['call_id'];
+        if (typeof id !== 'string' || id === '')
+            continue;
+        calls.push(toCall(item, type, id, toolType));
+    }
+    return calls;
+}
+/** Calls with no answer in the message itself, as a hosted shell call has in its output. */
+export function pendingToolCalls(items) {
+    const answered = new Set();
+    for (const item of items) {
+        if (!isObject(item))
+            continue;
+        const type = item['type'];
+        const request = item['approval_request_id'];
+        const callId = item['call_id'];
+        if (type === 'mcp_approval_response' && typeof request === 'string')
+            answered.add(request);
+        else if (typeof type === 'string' && type.endsWith('_output') && typeof callId === 'string')
+            answered.add(callId);
+    }
+    return toolCalls(items).filter((call) => !answered.has(call.toolCallId));
+}
+function toCall(item, type, id, toolType) {
+    const name = item['name'];
+    const namespace = item['namespace'];
+    const serverLabel = item['server_label'];
+    const args = item['arguments'];
+    const input = item['input'];
+    const caller = item['caller'];
+    const callNamespace = typeof namespace === 'string'
+        ? namespace
+        : type === 'mcp_approval_request' && typeof serverLabel === 'string'
+            ? serverLabel
+            : undefined;
+    // A result must repeat the call's caller (programmatic tool calling) and may name its namespace.
+    const resultOptions = {
+        ...(isObject(caller) ? { caller } : {}),
+        ...(toolType === 'function' && typeof namespace === 'string' ? { namespace } : {}),
+    };
+    return {
+        toolCallId: id,
+        toolName: typeof name === 'string' ? name : type.replace(/_call$/, ''),
+        toolType,
+        ...(typeof args === 'string' && toolType !== 'native' ? { arguments: args } : {}),
+        ...(typeof input === 'string' ? { input } : {}),
+        ...(callNamespace === undefined ? {} : { namespace: callNamespace }),
+        ...(item['async'] === true ? { async: true } : {}),
+        ...(Object.keys(resultOptions).length > 0 ? { resultOptions } : {}),
+        itemType: type,
+        item,
+    };
+}
+function text(value) {
+    return typeof value === 'string' ? value : '';
+}
+//# sourceMappingURL=responses.js.map

package/dist/read/responses.js.map

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

package/dist/read.d.ts

@@ -0,0 +1,32 @@
+import type { ContentPart } from './content.js';
+import type { AssistantMessage, Message, RequestMessage, ToolResultMessage } from './messages.js';
+import type { Provider } from './providers.js';
+import type { TextOptions } from './read/responses.js';
+import type { ToolCall } from './tool-calls.js';
+export type { TextOptions } from './read/responses.js';
+/**
+ * The text of the message's answer. On the Responses format, messages are
+ * joined by a blank line and commentary is left out unless `{ phase: 'all' }`.
+ */
+export declare function outputText(message: AssistantMessage, options?: TextOptions): string;
+/** What the model refused to do, in order. Anthropic says so in the stop reason instead, so its messages have none. */
+export declare function refusals(message: AssistantMessage): string[];
+/** Reasoning summaries or thinking texts, in order. Encrypted reasoning stays in the message. */
+export declare function reasoningSummary(message: AssistantMessage): string[];
+/** Every call in the message that the caller answers, answered within it or not. */
+export declare function toolCalls<P extends Provider>(message: AssistantMessage<P>): ToolCall<P>[];
+/** Calls the caller still has to answer. An async call may stay pending while the conversation goes on. */
+export declare function pendingToolCalls<P extends Provider>(message: AssistantMessage<P>): ToolCall<P>[];
+export type ToolResultOptions = {
+    /** Sent only where the provider has a field for it, so the content must say what failed. */
+    readonly isError?: boolean;
+};
+/**
+ * The message answering a `function` or `custom` call, with the fields the
+ * provider requires on its result, such as OpenAI's `caller`. A `native` call
+ * is answered with a `native` message instead.
+ */
+export declare function toolResult(call: ToolCall, content: string | readonly ContentPart[], { isError }?: ToolResultOptions): ToolResultMessage;
+/** The messages a provider receives: the application's own `custom` messages left out. */
+export declare function requestMessages<P extends Provider>(messages: readonly Message<P>[]): RequestMessage<P>[];
+//# sourceMappingURL=read.d.ts.map

package/dist/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAavD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAInF;AAED,uHAAuH;AACvH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAI5D;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAIpE;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAOzF;AAED,2GAA2G;AAC3G,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAOhG;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,EACxC,EAAE,OAAO,EAAE,GAAE,iBAAsB,GAClC,iBAAiB,CAenB;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,CAAC,SAAS,QAAQ,EAChD,QAAQ,EAAE,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,GAC9B,cAAc,CAAC,CAAC,CAAC,EAAE,CAErB"}

package/dist/read.js

@@ -0,0 +1,73 @@
+// Readers over any provider's assistant message, and the helpers that build
+// what a request sends. Each reader goes to its message's API format. Pure:
+// a step can use them.
+import * as anthropic from './read/anthropic.js';
+import * as responses from './read/responses.js';
+/** The message's items, read as plain Json. */
+function items(message) {
+    return message.content;
+}
+/** Typed for the message's provider: a reader returns that message's own items. */
+function typed(calls) {
+    // oxlint-disable-next-line typescript/no-unsafe-type-assertion
+    return calls;
+}
+/**
+ * The text of the message's answer. On the Responses format, messages are
+ * joined by a blank line and commentary is left out unless `{ phase: 'all' }`.
+ */
+export function outputText(message, options) {
+    return message.api === 'anthropic-messages'
+        ? anthropic.outputText(items(message))
+        : responses.outputText(items(message), options);
+}
+/** What the model refused to do, in order. Anthropic says so in the stop reason instead, so its messages have none. */
+export function refusals(message) {
+    return message.api === 'anthropic-messages'
+        ? anthropic.refusals()
+        : responses.refusals(items(message));
+}
+/** Reasoning summaries or thinking texts, in order. Encrypted reasoning stays in the message. */
+export function reasoningSummary(message) {
+    return message.api === 'anthropic-messages'
+        ? anthropic.reasoningSummary(items(message))
+        : responses.reasoningSummary(items(message));
+}
+/** Every call in the message that the caller answers, answered within it or not. */
+export function toolCalls(message) {
+    const any = message;
+    return typed(any.api === 'anthropic-messages'
+        ? anthropic.toolCalls(items(any))
+        : responses.toolCalls(items(any)));
+}
+/** Calls the caller still has to answer. An async call may stay pending while the conversation goes on. */
+export function pendingToolCalls(message) {
+    const any = message;
+    return typed(any.api === 'anthropic-messages'
+        ? anthropic.toolCalls(items(any))
+        : responses.pendingToolCalls(items(any)));
+}
+/**
+ * The message answering a `function` or `custom` call, with the fields the
+ * provider requires on its result, such as OpenAI's `caller`. A `native` call
+ * is answered with a `native` message instead.
+ */
+export function toolResult(call, content, { isError } = {}) {
+    if (call.toolType === 'native') {
+        throw new TypeError(`${call.itemType} is a provider-defined call: answer it with a native message`);
+    }
+    return {
+        role: 'tool_result',
+        toolCallId: call.toolCallId,
+        toolName: call.toolName,
+        toolType: call.toolType,
+        content: typeof content === 'string' ? [{ type: 'text', text: content }] : content,
+        ...(isError === undefined ? {} : { isError }),
+        ...(call.resultOptions === undefined ? {} : { providerOptions: call.resultOptions }),
+    };
+}
+/** The messages a provider receives: the application's own `custom` messages left out. */
+export function requestMessages(messages) {
+    return messages.filter((message) => message.role !== 'custom');
+}
+//# sourceMappingURL=read.js.map

package/dist/read.js.map

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

package/dist/request.d.ts

@@ -0,0 +1,23 @@
+import type { TextPart } from './content.js';
+import type { Message } from './messages.js';
+import type { ModelId, Provider, ProviderOptions } from './providers.js';
+import type { ToolDefinition } from './tools.js';
+/**
+ * One completion from provider `P`. Distributes over providers, so the model
+ * IDs, options and messages sent back all belong to `provider`.
+ */
+export type LlmRequest<P extends Provider = Provider> = P extends Provider ? {
+    readonly provider: P;
+    readonly model: ModelId<P>;
+    /** The provider's top-level system instructions. */
+    readonly instructions?: string | readonly TextPart[];
+    /** The conversation. `custom` messages are left out when sending. */
+    readonly messages: readonly Message<P>[];
+    /** Tools the caller runs. Hosted tools go in `options.tools`. */
+    readonly tools?: readonly ToolDefinition[];
+    /** The provider's own request fields, passed through. */
+    readonly options?: ProviderOptions<P>;
+    /** The most the call may take, in milliseconds. */
+    readonly timeoutMs?: number;
+} : never;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAAC,SAAS,QAAQ,GACtE;IACE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE,CAAC;IACrD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACtC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GACD,KAAK,CAAC"}

package/dist/request.js

@@ -0,0 +1,4 @@
+// What a handler asks the client for. It holds no credentials: the client
+// reads them from the handler's secrets, so they never reach args or the log.
+export {};
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E"}

package/dist/response.d.ts

@@ -0,0 +1,38 @@
+import type { AssistantMessage } from './messages.js';
+import type { ModelId, NativeResponse, Provider } from './providers.js';
+import type { Usage } from './usage.js';
+export type StopReason = 
+/** Generation ended normally, a stop sequence included. */
+'stop'
+/** Cut short by an output token or length limit. */
+ | 'length'
+/** The model called tools for the caller to run. */
+ | 'tool_use'
+/** The model declined. */
+ | 'refusal'
+/** A provider's safety filter blocked or ended generation. */
+ | 'content_filter'
+/** The provider paused a turn that can be continued, such as during a long server tool run. */
+ | 'pause_turn';
+/** One completion from provider `P`. */
+export type LlmResponse<P extends Provider = Provider> = P extends Provider ? {
+    /** The provider's response ID, such as for `previous_response_id`. */
+    readonly id?: string;
+    readonly provider: P;
+    /** The model ID the request asked for. */
+    readonly model: ModelId<P>;
+    /** The model the provider says answered, when it differs. */
+    readonly responseModel?: string;
+    readonly message: AssistantMessage<P>;
+    readonly stopReason: StopReason;
+    /** The provider's own reason, as it is, when it says more than `stopReason`. */
+    readonly providerStopReason?: string;
+    readonly usage?: Usage;
+    /** The provider's response fields that say something new: not its output or echoes of the request. */
+    readonly native: NativeResponse<P>;
+    /** How long the provider took, in milliseconds. */
+    readonly durationMs: number;
+    /** When the response arrived, in milliseconds since the Unix epoch. */
+    readonly timestamp: number;
+} : never;
+//# sourceMappingURL=response.d.ts.map

package/dist/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,UAAU;AACpB,2DAA2D;AACzD,MAAM;AACR,oDAAoD;GAClD,QAAQ;AACV,oDAAoD;GAClD,UAAU;AACZ,0BAA0B;GACxB,SAAS;AACX,8DAA8D;GAC5D,gBAAgB;AAClB,+FAA+F;GAC7F,YAAY,CAAC;AAEjB,wCAAwC;AACxC,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAAC,SAAS,QAAQ,GACvE;IACE,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,sGAAsG;IACtG,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACnC,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GACD,KAAK,CAAC"}

package/dist/response.js

@@ -0,0 +1,4 @@
+// What a completion returns, the same for every provider apart from the
+// assistant message and `native`, which are the provider's own.
+export {};
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,gEAAgE"}

package/dist/secrets.d.ts

@@ -0,0 +1,22 @@
+/** The secret holding each provider's API key. */
+export declare const PROVIDER_SECRETS: {
+    readonly anthropic: "ANTHROPIC_API_KEY";
+    readonly openai: "OPENAI_API_KEY";
+    readonly fireworks: "FIREWORKS_API_KEY";
+};
+/** The gateway's address and token, which acentric-cloud sets for agents that use its gateway. */
+export declare const GATEWAY_SECRETS: {
+    readonly url: "ACENTRIC_LLM_URL";
+    readonly token: "ACENTRIC_LLM_TOKEN";
+};
+/**
+ * The secrets the client reads, taken from an environment where they are set:
+ * what a runner on your own machine passes to handlers, such as
+ * `createMemoryRunner({ secrets: llmSecrets(process.env) })`.
+ */
+export declare function llmSecrets(env: {
+    readonly [name: string]: string | undefined;
+}): {
+    [name: string]: string;
+};
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAWA,kDAAkD;AAClD,eAAO,MAAM,gBAAgB;;;;CAI4B,CAAC;AAE1D,kGAAkG;AAClG,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE;IAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG;IAChF,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB,CAQA"}

package/dist/secrets.js

@@ -0,0 +1,35 @@
+// The secrets the client reads, by name. Runners and the CLI import these
+// names to pass the matching environment variables to handlers, so no
+// runner names a provider itself.
+//
+// The client calls a provider directly when its key is set, and otherwise
+// the gateway when both gateway secrets are set. A secret that is not set
+// rejects with SecretNotSet on every runner (RUNNERS.md §8), which is how the
+// client tells which are set.
+/** The secret holding each provider's API key. */
+export const PROVIDER_SECRETS = {
+    anthropic: 'ANTHROPIC_API_KEY',
+    openai: 'OPENAI_API_KEY',
+    fireworks: 'FIREWORKS_API_KEY',
+};
+/** The gateway's address and token, which acentric-cloud sets for agents that use its gateway. */
+export const GATEWAY_SECRETS = {
+    url: 'ACENTRIC_LLM_URL',
+    token: 'ACENTRIC_LLM_TOKEN',
+};
+/**
+ * The secrets the client reads, taken from an environment where they are set:
+ * what a runner on your own machine passes to handlers, such as
+ * `createMemoryRunner({ secrets: llmSecrets(process.env) })`.
+ */
+export function llmSecrets(env) {
+    const names = [...Object.values(PROVIDER_SECRETS), ...Object.values(GATEWAY_SECRETS)];
+    const found = {};
+    for (const name of names) {
+        const value = env[name];
+        if (value !== undefined && value !== '')
+            found[name] = value;
+    }
+    return found;
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,sEAAsE;AACtE,kCAAkC;AAClC,EAAE;AACF,0EAA0E;AAC1E,0EAA0E;AAC1E,8EAA8E;AAC9E,8BAA8B;AAI9B,kDAAkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,mBAAmB;IAC9B,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,mBAAmB;CACyB,CAAC;AAE1D,kGAAkG;AAClG,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,kBAAkB;IACvB,KAAK,EAAE,oBAAoB;CACnB,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,GAAoD;IAG7E,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;IACtF,MAAM,KAAK,GAA+B,EAAE,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tool-calls.d.ts

@@ -0,0 +1,28 @@
+import type { ProviderFields } from './fields.js';
+import type { NativeOutputItem, Provider } from './providers.js';
+export type ToolCall<P extends Provider = Provider> = P extends Provider ? {
+    /** The ID a result answers. */
+    readonly toolCallId: string;
+    /** The tool's name, or the item type for a provider-defined tool without one. */
+    readonly toolName: string;
+    /**
+     * `function` and `custom` calls are answered with a `tool_result` message,
+     * `native` ones (a provider-defined tool such as computer use, or an
+     * approval request) with a `native` message.
+     */
+    readonly toolType: 'function' | 'custom' | 'native';
+    /** A function call's arguments as the model wrote them: a JSON string, not parsed. */
+    readonly arguments?: string;
+    /** A custom tool call's text. */
+    readonly input?: string;
+    readonly namespace?: string;
+    /** The call may stay unanswered while the conversation goes on. */
+    readonly async?: boolean;
+    /** Fields the provider requires on this call's result; `toolResult` copies them. */
+    readonly resultOptions?: ProviderFields;
+    /** The provider's item type, such as `function_call` or `tool_use`. */
+    readonly itemType: string;
+    /** The call as the provider wrote it. */
+    readonly item: NativeOutputItem<P>;
+} : never;
+//# sourceMappingURL=tool-calls.d.ts.map

package/dist/tool-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-calls.d.ts","sourceRoot":"","sources":["../src/tool-calls.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEjE,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAAC,SAAS,QAAQ,GACpE;IACE,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpD,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,oFAAoF;IACpF,QAAQ,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CACpC,GACD,KAAK,CAAC"}

package/dist/tool-calls.js

@@ -0,0 +1,4 @@
+// A tool call as the readers report it: a view of an item in an assistant
+// message, which keeps the call itself.
+export {};
+//# sourceMappingURL=tool-calls.js.map

package/dist/tool-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-calls.js","sourceRoot":"","sources":["../src/tool-calls.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wCAAwC"}

package/dist/tools.d.ts

@@ -0,0 +1,33 @@
+import type { JsonObject } from '@acentric/types';
+import type { ProviderFields } from './fields.js';
+/** A JSON Schema object. */
+export type JsonSchema = JsonObject;
+type ToolBase = {
+    readonly name: string;
+    readonly description: string;
+    /** Merged into the provider's tool definition, such as Anthropic's `cache_control`. */
+    readonly providerOptions?: ProviderFields;
+};
+/** A tool called with JSON arguments matching `parameters`. */
+export type FunctionTool = ToolBase & {
+    readonly type: 'function';
+    readonly parameters: JsonSchema;
+    /** Asks the provider to hold the arguments to the schema, where it can. */
+    readonly strict?: boolean;
+};
+/** A tool called with free-form text, optionally held to a grammar. Not every provider has them. */
+export type CustomTool = ToolBase & {
+    readonly type: 'custom';
+    readonly format?: CustomToolFormat;
+};
+export type CustomToolFormat = {
+    readonly type: 'text';
+} | {
+    readonly type: 'grammar';
+    readonly syntax: 'lark' | 'regex';
+    readonly definition: string;
+};
+export type ToolDefinition = FunctionTool | CustomTool;
+export type ToolType = ToolDefinition['type'];
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AAEpC,KAAK,QAAQ,GAAG;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uFAAuF;IACvF,QAAQ,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC;CAC3C,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG;IACpC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,oGAAoG;AACpG,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;AAEvD,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/dist/tools.js

@@ -0,0 +1,4 @@
+// Tools the caller runs. A provider's hosted tools (web search, code
+// execution, ...) are its own definitions, passed in the request's options.
+export {};
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,4EAA4E"}

package/dist/usage.d.ts

@@ -0,0 +1,31 @@
+/** Token counts. A count the provider does not report is left out; zero is a known zero. */
+export type Usage = {
+    /** Every prompt token, cached or not. */
+    readonly totalInput?: number;
+    /** Prompt tokens neither read from nor written to a cache. */
+    readonly input?: number;
+    /** Output tokens, reasoning included where the provider counts it as output. */
+    readonly output?: number;
+    /** Reasoning tokens: part of `output` unless the provider bills them apart. */
+    readonly reasoning?: number;
+    readonly cacheRead?: number;
+    /** Every token written to a cache, whatever its time to live. */
+    readonly cacheWrite?: number;
+    /**
+     * What it cost: what the provider says it charged where it says so,
+     * otherwise estimated from the model's prices when they and every count
+     * needed are known.
+     */
+    readonly cost?: UsageCost;
+};
+/** US dollars. A part that is not known is left out. */
+export type UsageCost = {
+    /** `reported`: what the provider says it charged. `estimated`: tokens at known prices. */
+    readonly source: 'reported' | 'estimated';
+    readonly input?: number;
+    readonly output?: number;
+    readonly cacheRead?: number;
+    readonly cacheWrite?: number;
+    readonly total: number;
+};
+//# sourceMappingURL=usage.d.ts.map