@gaunt-sloth/core 2.0.0-alpha.9 → 2.0.0-beta.0

package/dist/core/toolCallRepair/grammar.js

@@ -0,0 +1,116 @@
+// EXT-35 — plain-text tool-call repair grammar.
+//
+// Ported (TypeScript, gaunt-sloth house style) from the openclaw
+// `@openclaw/tool-call-repair` reference (`packages/tool-call-repair/src/grammar.ts`).
+// Only the low-level scanners the standalone-block parser in `./payload.ts` needs are
+// carried over; the reference's streaming/normalizer/strip helpers are intentionally omitted.
+//
+// These functions recognise the fixed protocol markers small/local models emit when they
+// serialise a tool call as assistant TEXT instead of a native tool_call. They do no allow-list
+// or size gating themselves — that lives in `./payload.ts` / `./promote.ts`.
+/** Legacy marker some models emit after a serialized JSON tool request. */
+export const END_TOOL_REQUEST = '[END_TOOL_REQUEST]';
+/** Harmony stream marker that introduces the target channel before a tool call. */
+export const HARMONY_CHANNEL_MARKER = '<|channel|>';
+/** Harmony stream marker that may separate the header from the JSON payload. */
+export const HARMONY_MESSAGE_MARKER = '<|message|>';
+/** Harmony stream marker that may close a serialized tool-call payload. */
+export const HARMONY_CALL_MARKER = '<|call|>';
+/**
+ * Harmony marker real gpt-oss emits in place of the reference grammar's literal `code` token —
+ * e.g. `<|constrain|>json` declares the tool-call payload format. (EXT-43.)
+ */
+export const HARMONY_CONSTRAIN_MARKER = '<|constrain|>';
+/** Tool names in bracket/plain-text repairs intentionally match provider-safe ids only. */
+export function isPlainTextToolNameChar(char) {
+    return Boolean(char && /[A-Za-z0-9_-]/.test(char));
+}
+/**
+ * Harmony tool names may be NAMESPACED with dots (real gpt-oss emits `to=functions.get_weather`),
+ * so the Harmony header scanner accepts `.` on top of the provider-safe id chars. This is a
+ * Harmony-only widening (EXT-43): the bracket/XML-ish dialects keep {@link isPlainTextToolNameChar}
+ * unchanged so their prose-safety is untouched. The final dot-segment is the tool name matched
+ * against the allow-list (see {@link finalDotSegment}).
+ */
+export function isHarmonyToolNameChar(char) {
+    return Boolean(char && /[A-Za-z0-9_.-]/.test(char));
+}
+/**
+ * The tool name for a (possibly namespaced) Harmony target: the final dot-segment.
+ * `functions.get_weather` → `get_weather`; `functions.tools.get_weather` → `get_weather`; a dotless
+ * `get_weather` → itself. Returns `''` for a trailing-dot / empty final segment (rejected upstream).
+ */
+export function finalDotSegment(name) {
+    const lastDot = name.lastIndexOf('.');
+    return lastDot === -1 ? name : name.slice(lastDot + 1);
+}
+/** Skips spaces and tabs only, preserving line boundaries for grammar decisions. */
+export function skipHorizontalWhitespace(text, start) {
+    let index = start;
+    while (index < text.length && (text[index] === ' ' || text[index] === '\t')) {
+        index += 1;
+    }
+    return index;
+}
+/** Skips all JavaScript whitespace when line structure is no longer meaningful. */
+export function skipWhitespace(text, start) {
+    let index = start;
+    while (index < text.length && /\s/.test(text[index] ?? '')) {
+        index += 1;
+    }
+    return index;
+}
+/** Consumes either Unix or Windows line endings and returns the first offset after them. */
+export function consumeLineBreak(text, start) {
+    if (text[start] === '\r') {
+        return text[start + 1] === '\n' ? start + 2 : start + 1;
+    }
+    if (text[start] === '\n') {
+        return start + 1;
+    }
+    return null;
+}
+/**
+ * Finds the exclusive end offset of a balanced JSON object starting at `start`. Returns null if
+ * the object never closes, or (when `maxPayloadBytes` is set) as soon as the scan runs past the
+ * cap — the payload-size gate that keeps a runaway blob from being treated as a tool call.
+ */
+export function findJsonObjectEnd(text, start, maxPayloadBytes) {
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let index = start; index < text.length; index += 1) {
+        if (maxPayloadBytes !== undefined && index + 1 - start > maxPayloadBytes) {
+            return null;
+        }
+        const char = text[index];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (char === '\\') {
+                escaped = true;
+            }
+            else if (char === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (char === '"') {
+            inString = true;
+            continue;
+        }
+        if (char === '{') {
+            depth += 1;
+            continue;
+        }
+        if (char === '}') {
+            depth -= 1;
+            if (depth === 0) {
+                return index + 1;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=grammar.js.map

package/dist/core/toolCallRepair/grammar.js.map

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

package/dist/core/toolCallRepair/index.d.ts

@@ -0,0 +1,2 @@
+export { parseStandalonePlainTextToolCallBlocks, type PlainTextToolCallBlock, type PlainTextToolCallParseOptions, } from './payload.js';
+export { textToNativeToolCalls, promoteTextEmittedToolCallMessage, MAX_TEXT_EMITTED_TOOL_CALL_PAYLOAD_BYTES, type TextToolCallRepairOptions, } from './promote.js';

package/dist/core/toolCallRepair/index.js

@@ -0,0 +1,7 @@
+// EXT-35 — plain-text tool-call repair: promote a text-emitted tool call to a native tool_call.
+// Ported/adapted from the openclaw `@openclaw/tool-call-repair` reference. See the sibling files
+// for the per-dialect grammar (`grammar.ts`), the standalone-block parser (`payload.ts`), and the
+// LangChain-message promotion + gates (`promote.ts`).
+export { parseStandalonePlainTextToolCallBlocks, } from './payload.js';
+export { textToNativeToolCalls, promoteTextEmittedToolCallMessage, MAX_TEXT_EMITTED_TOOL_CALL_PAYLOAD_BYTES, } from './promote.js';
+//# sourceMappingURL=index.js.map

package/dist/core/toolCallRepair/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/toolCallRepair/index.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,iGAAiG;AACjG,kGAAkG;AAClG,sDAAsD;AACtD,OAAO,EACL,sCAAsC,GAGvC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qBAAqB,EACrB,iCAAiC,EACjC,wCAAwC,GAEzC,MAAM,cAAc,CAAC"}

package/dist/core/toolCallRepair/payload.d.ts

@@ -0,0 +1,36 @@
+/** Parsed standalone plain-text tool call block with source offsets for repair. */
+export type PlainTextToolCallBlock = {
+    /** Parsed JSON arguments object. */
+    arguments: Record<string, unknown>;
+    /** Exclusive end offset of the parsed block. */
+    end: number;
+    /** Tool name parsed from bracket, Harmony, or XML-ish syntax. */
+    name: string;
+    /** Original text slice that produced this block. */
+    raw: string;
+    /** Inclusive start offset of the parsed block. */
+    start: number;
+};
+/** Parser limits and allow-list options for plain-text tool-call repair. */
+export type PlainTextToolCallParseOptions = {
+    /** Optional allow-list of tool names that may be repaired. */
+    allowedToolNames?: Iterable<string>;
+    /** Maximum serialized payload size accepted for one repaired call. */
+    maxPayloadBytes?: number;
+};
+/**
+ * The single source of truth for the plain-text tool-call payload cap (256 KB). A serialized call
+ * larger than this is never treated as a tool call. Re-exported from `./promote.js` (and the module
+ * index) as `MAX_TEXT_EMITTED_TOOL_CALL_PAYLOAD_BYTES` — the public name — so there is ONE constant,
+ * not two duplicated literals. (EXT-43 unified the former `DEFAULT_MAX_PLAIN_TEXT_TOOL_PAYLOAD_BYTES`
+ * here with `promote.ts`'s copy.)
+ */
+export declare const MAX_TEXT_EMITTED_TOOL_CALL_PAYLOAD_BYTES = 256000;
+/**
+ * Parse the WHOLE input into standalone plain-text tool-call blocks, or return null if any part of
+ * it is not such a block. This all-or-nothing walk is the standalone-only gate: prose that merely
+ * mentions a tool name, contains brackets, or embeds a call inside a sentence never parses (the
+ * first non-block character aborts the parse). Allow-list + payload-cap gating are applied per
+ * block via {@link PlainTextToolCallParseOptions}.
+ */
+export declare function parseStandalonePlainTextToolCallBlocks(text: string, options?: PlainTextToolCallParseOptions): PlainTextToolCallBlock[] | null;

package/dist/core/toolCallRepair/payload.js

@@ -0,0 +1,341 @@
+// EXT-35 — plain-text tool-call repair payload parser.
+//
+// Ported (TypeScript, gaunt-sloth house style) from the openclaw
+// `@openclaw/tool-call-repair` reference (`packages/tool-call-repair/src/payload.ts`).
+// Carries the three text-emitted tool-call dialects small/local models produce:
+//   • bracket:   `[tool:name]{...json...}`  /  `[name]\n{...json...}[/name]`
+//   • XML-ish:   `<function=name><parameter=key>value</parameter></function>`
+//   • Harmony:   `<|channel|>commentary to=name code<|message|>{...json...}<|call|>`
+//     — plus the real gpt-oss variant (EXT-43) with a NAMESPACED name and a `<|constrain|>` marker:
+//       `<|channel|>commentary to=functions.get_weather<|constrain|>json<|message|>{...}<|call|>`
+//
+// {@link parseStandalonePlainTextToolCallBlocks} is STANDALONE-only by construction: it walks the
+// WHOLE input and returns null the moment it hits text that is not a tool-call block, so prose that
+// merely mentions a tool or contains brackets never parses as a call. Allow-list + payload-size
+// gating are threaded through {@link PlainTextToolCallParseOptions}. The reference's streaming
+// normalizer and user-visible strip helpers are intentionally omitted (not needed for promotion).
+import { consumeLineBreak, END_TOOL_REQUEST, finalDotSegment, findJsonObjectEnd, HARMONY_CALL_MARKER, HARMONY_CHANNEL_MARKER, HARMONY_CONSTRAIN_MARKER, HARMONY_MESSAGE_MARKER, isHarmonyToolNameChar, isPlainTextToolNameChar, skipHorizontalWhitespace, skipWhitespace, } from './grammar.js';
+/**
+ * The single source of truth for the plain-text tool-call payload cap (256 KB). A serialized call
+ * larger than this is never treated as a tool call. Re-exported from `./promote.js` (and the module
+ * index) as `MAX_TEXT_EMITTED_TOOL_CALL_PAYLOAD_BYTES` — the public name — so there is ONE constant,
+ * not two duplicated literals. (EXT-43 unified the former `DEFAULT_MAX_PLAIN_TEXT_TOOL_PAYLOAD_BYTES`
+ * here with `promote.ts`'s copy.)
+ */
+export const MAX_TEXT_EMITTED_TOOL_CALL_PAYLOAD_BYTES = 256_000;
+const utf8Encoder = new TextEncoder();
+function utf8ByteLengthWithinLimit(text, start, end, maxBytes) {
+    if (end - start > maxBytes) {
+        return null;
+    }
+    const byteLength = utf8Encoder.encode(text.slice(start, end)).byteLength;
+    return byteLength <= maxBytes ? byteLength : null;
+}
+function parseBracketOpening(text, start) {
+    if (text[start] !== '[') {
+        return null;
+    }
+    let cursor = start + 1;
+    if (text.startsWith('tool:', cursor)) {
+        cursor += 'tool:'.length;
+        const nameStart = cursor;
+        while (isPlainTextToolNameChar(text[cursor])) {
+            cursor += 1;
+        }
+        if (cursor === nameStart || text[cursor] !== ']') {
+            return null;
+        }
+        return {
+            allowsOptionalXmlishClose: true,
+            end: cursor + 1,
+            name: text.slice(nameStart, cursor),
+            requiresClosing: false,
+        };
+    }
+    const nameStart = cursor;
+    while (isPlainTextToolNameChar(text[cursor])) {
+        cursor += 1;
+    }
+    if (cursor === nameStart || text[cursor] !== ']') {
+        return null;
+    }
+    const name = text.slice(nameStart, cursor);
+    cursor += 1;
+    cursor = skipHorizontalWhitespace(text, cursor);
+    const afterLineBreak = consumeLineBreak(text, cursor);
+    if (afterLineBreak === null) {
+        return null;
+    }
+    return { end: afterLineBreak, name, requiresClosing: true };
+}
+function parseHarmonyOpening(text, start) {
+    let cursor = start;
+    if (text.startsWith(HARMONY_CHANNEL_MARKER, cursor)) {
+        cursor += HARMONY_CHANNEL_MARKER.length;
+    }
+    const channelStart = cursor;
+    while (/[A-Za-z_]/.test(text[cursor] ?? '')) {
+        cursor += 1;
+    }
+    const channel = text.slice(channelStart, cursor);
+    if (channel !== 'commentary' && channel !== 'analysis' && channel !== 'final') {
+        return null;
+    }
+    cursor = skipHorizontalWhitespace(text, cursor);
+    if (!text.startsWith('to=', cursor)) {
+        return null;
+    }
+    cursor += 3;
+    // Tool name. EXT-43: accept the real gpt-oss NAMESPACED form (`to=functions.get_weather`) by
+    // scanning dot-inclusive chars, then take the FINAL dot-segment as the allow-listed tool name.
+    // The reference dotless form (`to=get_weather`) is the single-segment degenerate case.
+    const nameStart = cursor;
+    while (isHarmonyToolNameChar(text[cursor])) {
+        cursor += 1;
+    }
+    if (cursor === nameStart) {
+        return null;
+    }
+    const name = finalDotSegment(text.slice(nameStart, cursor));
+    if (!name) {
+        // Trailing-dot / empty final segment (e.g. `to=functions.`) is not a valid tool name.
+        return null;
+    }
+    cursor = skipHorizontalWhitespace(text, cursor);
+    // Payload-format marker between the header and the JSON. The reference grammar requires the
+    // literal `code` token; real gpt-oss instead emits `<|constrain|>json` (EXT-43). Accept EITHER —
+    // but a marker is still REQUIRED, so the widening does not relax prose-safety (a bare
+    // `commentary to=x {…}` never promotes).
+    if (text.startsWith('code', cursor)) {
+        cursor += 4;
+    }
+    else if (text.startsWith(HARMONY_CONSTRAIN_MARKER, cursor)) {
+        cursor += HARMONY_CONSTRAIN_MARKER.length;
+        // Optional constraint-format token that follows the marker (e.g. `json`).
+        cursor = skipHorizontalWhitespace(text, cursor);
+        while (isPlainTextToolNameChar(text[cursor])) {
+            cursor += 1;
+        }
+    }
+    else {
+        return null;
+    }
+    cursor = skipWhitespace(text, cursor);
+    if (text.startsWith(HARMONY_MESSAGE_MARKER, cursor)) {
+        cursor = skipWhitespace(text, cursor + HARMONY_MESSAGE_MARKER.length);
+    }
+    return { end: cursor, name, requiresClosing: false };
+}
+function parseXmlishFunctionOpening(text, start) {
+    const match = /^<function=([A-Za-z0-9_.:-]{1,120})>\s*/i.exec(text.slice(start));
+    if (!match?.[1]) {
+        return null;
+    }
+    return { end: start + match[0].length, name: match[1], requiresClosing: false };
+}
+function parseOpening(text, start) {
+    return parseBracketOpening(text, start) ?? parseHarmonyOpening(text, start);
+}
+function consumeJsonObject(text, start, maxPayloadBytes) {
+    const cursor = skipWhitespace(text, start);
+    if (text[cursor] !== '{') {
+        return null;
+    }
+    const end = findJsonObjectEnd(text, cursor, maxPayloadBytes);
+    if (end === null || utf8ByteLengthWithinLimit(text, cursor, end, maxPayloadBytes) === null) {
+        return null;
+    }
+    const rawJson = text.slice(cursor, end);
+    try {
+        const parsed = JSON.parse(rawJson);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return null;
+        }
+        return { end, value: parsed };
+    }
+    catch {
+        return null;
+    }
+}
+function parseClosing(text, start, name) {
+    const cursor = skipWhitespace(text, start);
+    if (text.startsWith(END_TOOL_REQUEST, cursor)) {
+        return cursor + END_TOOL_REQUEST.length;
+    }
+    const namedClosing = `[/${name}]`;
+    if (text.startsWith(namedClosing, cursor)) {
+        return cursor + namedClosing.length;
+    }
+    return null;
+}
+function parseOptionalHarmonyClosing(text, start) {
+    const cursor = skipWhitespace(text, start);
+    if (text.startsWith(HARMONY_CALL_MARKER, cursor)) {
+        return cursor + HARMONY_CALL_MARKER.length;
+    }
+    return start;
+}
+function parsePlainTextToolCallBlockAt(text, start, options) {
+    const opening = parseOpening(text, start);
+    if (!opening) {
+        return null;
+    }
+    const allowedToolNames = options?.allowedToolNames
+        ? new Set(options.allowedToolNames)
+        : undefined;
+    if (allowedToolNames && !allowedToolNames.has(opening.name)) {
+        return null;
+    }
+    const payload = consumeJsonObject(text, opening.end, options?.maxPayloadBytes ?? MAX_TEXT_EMITTED_TOOL_CALL_PAYLOAD_BYTES);
+    if (!payload) {
+        return null;
+    }
+    const closingEnd = opening.requiresClosing
+        ? parseClosing(text, payload.end, opening.name)
+        : parseOptionalHarmonyClosing(text, payload.end);
+    if (closingEnd === null) {
+        return null;
+    }
+    return {
+        arguments: payload.value,
+        end: closingEnd,
+        name: opening.name,
+        raw: text.slice(start, closingEnd),
+        start,
+    };
+}
+function findXmlishParameterBlock(text, start) {
+    const cursor = skipWhitespace(text, start);
+    const openMatch = /^<parameter=([A-Za-z0-9_.:-]{1,120})>/i.exec(text.slice(cursor));
+    if (!openMatch?.[1]) {
+        return null;
+    }
+    const payloadStart = cursor + openMatch[0].length;
+    const closeMatch = /<\/parameter>/i.exec(text.slice(payloadStart));
+    if (!closeMatch) {
+        return null;
+    }
+    const closeStart = payloadStart + closeMatch.index;
+    const closeEnd = closeStart + closeMatch[0].length;
+    return {
+        closeStart,
+        end: closeEnd,
+        name: openMatch[1],
+        payloadStart,
+        start: cursor,
+    };
+}
+function extractXmlishParameterValue(text, start, end) {
+    let payloadStart = start;
+    let payloadEnd = end;
+    const afterOpeningLineBreak = consumeLineBreak(text, payloadStart);
+    if (afterOpeningLineBreak !== null) {
+        payloadStart = afterOpeningLineBreak;
+        if (payloadEnd > payloadStart && text[payloadEnd - 1] === '\n') {
+            payloadEnd -= 1;
+            if (payloadEnd > payloadStart && text[payloadEnd - 1] === '\r') {
+                payloadEnd -= 1;
+            }
+        }
+        else if (payloadEnd > payloadStart && text[payloadEnd - 1] === '\r') {
+            payloadEnd -= 1;
+        }
+    }
+    return text.slice(payloadStart, payloadEnd);
+}
+function consumeXmlishParameterBlock(text, start, maxPayloadBytes) {
+    const bounds = findXmlishParameterBlock(text, start);
+    if (!bounds) {
+        return null;
+    }
+    const byteLength = utf8ByteLengthWithinLimit(text, start, bounds.end, maxPayloadBytes);
+    if (byteLength === null) {
+        return null;
+    }
+    return {
+        byteLength,
+        end: bounds.end,
+        name: bounds.name,
+        value: extractXmlishParameterValue(text, bounds.payloadStart, bounds.closeStart),
+    };
+}
+function consumeXmlishFunctionClose(text, start) {
+    const cursor = skipWhitespace(text, start);
+    return text.slice(cursor).toLowerCase().startsWith('</function>')
+        ? cursor + '</function>'.length
+        : null;
+}
+function consumeOptionalXmlishFunctionClose(text, start) {
+    return consumeXmlishFunctionClose(text, start) ?? start;
+}
+function parseXmlishOpening(text, start) {
+    return parseBracketOpening(text, start) ?? parseXmlishFunctionOpening(text, start);
+}
+function parseXmlishPlainTextToolCallBlockAt(text, start, options) {
+    const opening = parseXmlishOpening(text, start);
+    if (!opening) {
+        return null;
+    }
+    const allowedToolNames = options?.allowedToolNames
+        ? new Set(options.allowedToolNames)
+        : undefined;
+    if (allowedToolNames && !allowedToolNames.has(opening.name)) {
+        return null;
+    }
+    const maxPayloadBytes = options?.maxPayloadBytes ?? MAX_TEXT_EMITTED_TOOL_CALL_PAYLOAD_BYTES;
+    const args = {};
+    let cursor = opening.end;
+    let parameterCount = 0;
+    let payloadBytes = 0;
+    while (true) {
+        const parameter = consumeXmlishParameterBlock(text, cursor, maxPayloadBytes);
+        if (!parameter) {
+            break;
+        }
+        payloadBytes += parameter.byteLength;
+        if (payloadBytes > maxPayloadBytes) {
+            return null;
+        }
+        args[parameter.name] = parameter.value;
+        parameterCount += 1;
+        cursor = parameter.end;
+    }
+    if (parameterCount === 0) {
+        return null;
+    }
+    const end = opening.allowsOptionalXmlishClose
+        ? consumeOptionalXmlishFunctionClose(text, cursor)
+        : consumeXmlishFunctionClose(text, cursor);
+    if (end === null) {
+        return null;
+    }
+    return {
+        arguments: args,
+        end,
+        name: opening.name,
+        raw: text.slice(start, end),
+        start,
+    };
+}
+/**
+ * Parse the WHOLE input into standalone plain-text tool-call blocks, or return null if any part of
+ * it is not such a block. This all-or-nothing walk is the standalone-only gate: prose that merely
+ * mentions a tool name, contains brackets, or embeds a call inside a sentence never parses (the
+ * first non-block character aborts the parse). Allow-list + payload-cap gating are applied per
+ * block via {@link PlainTextToolCallParseOptions}.
+ */
+export function parseStandalonePlainTextToolCallBlocks(text, options) {
+    const blocks = [];
+    let cursor = skipWhitespace(text, 0);
+    while (cursor < text.length) {
+        const block = parsePlainTextToolCallBlockAt(text, cursor, options) ??
+            parseXmlishPlainTextToolCallBlockAt(text, cursor, options);
+        if (!block) {
+            return null;
+        }
+        blocks.push(block);
+        cursor = skipWhitespace(text, block.end);
+    }
+    return blocks.length > 0 ? blocks : null;
+}
+//# sourceMappingURL=payload.js.map

package/dist/core/toolCallRepair/payload.js.map

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

package/dist/core/toolCallRepair/promote.d.ts

@@ -0,0 +1,45 @@
+import { AIMessage } from '@langchain/core/messages';
+/**
+ * A sane default cap on a single repaired call's serialized payload. A text blob larger than this
+ * is never treated as a tool call. Overridable per call so a test can assert the cap with a small
+ * value; production leaves it at the default. The single source of truth lives in `./payload.js`
+ * and is re-exported here under its public name (EXT-43 unified the former duplicated literal).
+ */
+export { MAX_TEXT_EMITTED_TOOL_CALL_PAYLOAD_BYTES } from './payload.js';
+/** LangChain native tool-call shape (structurally a `ToolCall` from `@langchain/core/messages`). */
+type NativeToolCall = {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+    type: 'tool_call';
+};
+/** Gates for {@link textToNativeToolCalls} / {@link promoteTextEmittedToolCallMessage}. */
+export interface TextToolCallRepairOptions {
+    /**
+     * The names of the tools bound to this run (the allow-list). Only a text-emitted call whose name
+     * is one of these promotes; an unknown name is left as text. An EMPTY set promotes nothing — the
+     * prose-safe default (no toolset ⇒ nothing is a call).
+     */
+    allowedToolNames: Iterable<string>;
+    /** Payload-size cap; defaults to {@link MAX_TEXT_EMITTED_TOOL_CALL_PAYLOAD_BYTES}. */
+    maxPayloadBytes?: number;
+}
+/**
+ * Parse assistant `text` as one-or-more STANDALONE text-emitted tool calls and return them as
+ * native LangChain tool_calls, or `undefined` when the text is not a standalone call, names a tool
+ * outside the allow-list, or exceeds the payload cap. Fresh `id`s are minted per call (the model
+ * emitted none). Empty allow-list ⇒ `undefined` (never promote).
+ */
+export declare function textToNativeToolCalls(text: string | undefined, options: TextToolCallRepairOptions): NativeToolCall[] | undefined;
+/**
+ * Repair one assistant {@link AIMessage}: if it has NO native tool_calls but its content is a
+ * standalone text-emitted call (allow-listed, within the payload cap), return a NEW AIMessage that
+ * carries the promoted native tool_calls; otherwise return `undefined` (the caller keeps the
+ * original, so the native happy path is untouched).
+ *
+ * The returned message PRESERVES the original `id`. That is load-bearing: LangGraph's message-state
+ * reducer merges by id, so a same-id message REPLACES the original in graph state (rather than
+ * appending a duplicate/dangling assistant message). Content is cleared to '' since the raw
+ * text-call is now represented natively as tool_calls.
+ */
+export declare function promoteTextEmittedToolCallMessage(message: AIMessage, options: TextToolCallRepairOptions): AIMessage | undefined;