@arden-hq/loop 0.0.0-stage → 0.1.0

package/dist/tools/tool.js

@@ -0,0 +1,275 @@
+import { PauseRequested, ToolExecutionError } from "../errors.js";
+import { canRunInBackground } from "../contracts/tools.js";
+import { normalizeToolResult } from "../internal/validate.js";
+import { withToolDisplayTitleParameter } from "./display-title.js";
+import { truncateToolResult } from "./truncate.js";
+import { errorMessage } from "@arden-hq/std/errors";
+/**
+ * The ONE place the converter's contravariant `never` parameter is bridged to
+ * a real schema — internally the loop only hands it schemas the host itself
+ * registered, so the cast is honest here and nowhere else.
+ */
+export const applyJsonSchemaConverter = (converter, schema) => converter(schema);
+const pathKey = (segment) => typeof segment === "object" ? segment.key : segment;
+const withoutRefusedNulls = (value, issues) => issues.reduce((current, issue) => {
+    const path = (issue.path ?? []).map(pathKey);
+    return path.length === 0 ? current : removeNullAt(current, path);
+}, value);
+const removeNullAt = (value, path) => {
+    const [head, ...rest] = path;
+    if (value === null || typeof value !== "object" || head === undefined)
+        return value;
+    if (Array.isArray(value)) {
+        const index = typeof head === "number" ? head : Number(head);
+        if (!Number.isInteger(index) || rest.length === 0)
+            return value;
+        const item = removeNullAt(value[index], rest);
+        return item === value[index] ? value : value.map((entry, at) => (at === index ? item : entry));
+    }
+    const entries = Object.entries(value);
+    const found = entries.find(([key]) => key === String(head));
+    if (found === undefined)
+        return value;
+    if (rest.length === 0)
+        return found[1] === null
+            ? Object.fromEntries(entries.filter(([key]) => key !== found[0]))
+            : value;
+    const field = removeNullAt(found[1], rest);
+    return field === found[1]
+        ? value
+        : Object.fromEntries(entries.map(([key, entry]) => [key, key === found[0] ? field : entry]));
+};
+/** `data.outcome` of a call its schema rejected: the tool never ran. */
+export const INVALID_ARGUMENTS_OUTCOME = "invalid_arguments";
+const invalidArgumentsResult = (name, issues) => {
+    const detail = issues
+        .map((issue) => {
+        const path = (issue.path ?? [])
+            .map((segment) => String(typeof segment === "object" && segment !== null ? segment.key : segment))
+            .join(".");
+        return path.length > 0 ? `${path}: ${issue.message}` : issue.message;
+    })
+        .join("; ");
+    return normalizeToolResult({
+        content: `The ${name} tool was called with invalid arguments: ${detail || "the input does not match the schema"}. ` +
+            "Rewrite the input so it satisfies the schema and retry the tool call.",
+        preview: "Invalid tool arguments",
+        is_error: true,
+        retryable: false,
+        data: { outcome: INVALID_ARGUMENTS_OUTCOME }
+    });
+};
+const toMeta = (definition) => {
+    const metadata = definition.metadata;
+    return {
+        name: definition.name,
+        ...(metadata.background === true ? { background: true } : {}),
+        ...(metadata.detached === true ? { detached: true } : {}),
+        ...(metadata.hosted === true ? { hosted: true } : {}),
+        changes_state: metadata.changes_state ?? false,
+        concurrency_group: metadata.concurrency_group ?? null,
+        ends_turn: metadata.ends_turn ?? false,
+        deferred: metadata.deferred ?? false,
+        ...(metadata.group === undefined ? {} : { group: metadata.group }),
+        ...(metadata.input_sources === undefined ? {} : { input_sources: metadata.input_sources }),
+        host: hostRecord(metadata)
+    };
+};
+const hostRecord = (metadata) => ({ ...metadata });
+const outputToResult = (output) => {
+    const value = typeof output === "string" ? { result: output } : output;
+    if (typeof value !== "object" || value === null || typeof value.result !== "string") {
+        throw new TypeError("tool execute must return a string or a { result } object");
+    }
+    return normalizeToolResult({
+        content: value.result,
+        preview: value.preview ?? value.result,
+        ...(value.data === undefined ? {} : { data: value.data }),
+        ...(value.host === undefined ? {} : { host: value.host }),
+        ...(value.model_content === undefined ? {} : { model_content: value.model_content })
+    });
+};
+const pauseUntilApproved = async (call, execute) => {
+    const { definition, input, ctx } = call;
+    const required = definition.approvalRequirement === undefined
+        ? undefined
+        : await definition.approvalRequirement(input, ctx);
+    if (ctx.approval !== undefined || (required === undefined && call.decision !== "ask"))
+        return execute(ctx);
+    const prompt = required ??
+        (definition.approvalPrompt === undefined
+            ? { preview: definition.description }
+            : await definition.approvalPrompt(input, ctx));
+    throw new PauseRequested("approval", prompt.preview, prompt);
+};
+/** Wrap one co-located definition with validation and approval gating. */
+export const createTool = (definition) => {
+    if (typeof definition.name !== "string" || definition.name.length === 0) {
+        throw new TypeError("createTool requires a non-empty name");
+    }
+    if (typeof definition.metadata !== "object" || definition.metadata === null) {
+        throw new TypeError(`createTool(${definition.name}) requires a metadata object`);
+    }
+    if (typeof definition.parameters?.["~standard"]?.validate !== "function") {
+        throw new TypeError(`createTool(${definition.name}) requires Standard Schema parameters`);
+    }
+    if (definition.metadata.background === true && !canRunInBackground(definition.metadata)) {
+        throw new TypeError(`createTool(${definition.name}): hosted, turn-ending and detached tools cannot run in the background`);
+    }
+    const erased = definition;
+    const execute = async (args, ctx, options = {}) => {
+        const sent = ctx.approval?.edited?.arguments ?? args;
+        const validate = async (value) => await definition.parameters["~standard"].validate(value);
+        let validated = await validate(sent);
+        if (validated.issues !== undefined) {
+            const absent = withoutRefusedNulls(sent, validated.issues);
+            if (absent !== sent) {
+                const retried = await validate(absent);
+                if (retried.issues === undefined)
+                    validated = retried;
+            }
+        }
+        if (validated.issues !== undefined) {
+            return invalidArgumentsResult(definition.name, validated.issues);
+        }
+        const input = validated.value;
+        const gate = options.gate ?? pauseUntilApproved;
+        options.phase?.("waiting");
+        return gate({
+            definition: erased,
+            input,
+            ctx,
+            decision: options.decision ?? (definition.metadata.approval === "ask" ? "ask" : "approve")
+        }, async (callCtx) => {
+            const refusal = await options.beforeExecute?.();
+            if (refusal !== undefined)
+                return normalizeToolResult(refusal);
+            options.phase?.("executing");
+            return outputToResult(await definition.execute(input, callCtx));
+        });
+    };
+    return Object.freeze({
+        definition: erased,
+        entry: (toJsonSchema, displayTitle) => {
+            const parameters = definition.parameterJsonSchema ??
+                applyJsonSchemaConverter(toJsonSchema, definition.parameters);
+            return {
+                description: definition.description,
+                parameters: displayTitle === undefined
+                    ? parameters
+                    : withToolDisplayTitleParameter(parameters, definition.name, displayTitle),
+                meta: toMeta(erased)
+            };
+        },
+        execute
+    });
+};
+const defaultExecuteError = (error, request) => new ToolExecutionError(errorMessage(error), {
+    diagnosticRef: `tool-call:${request.toolCallId}`,
+    retryable: null
+});
+const neverAborted = new AbortController().signal;
+/**
+ * Bind a tool list into a per-run Toolset. The returned factory replaces
+ * per-call dependency provisioning: call it once per run with the typed run
+ * context.
+ */
+export const createToolset = (tools, options) => {
+    if (typeof options?.toJsonSchema !== "function") {
+        throw new TypeError("createToolset requires a toJsonSchema converter");
+    }
+    const byName = new Map();
+    for (const tool of tools) {
+        if (byName.has(tool.definition.name)) {
+            throw new TypeError(`createToolset received duplicate tool name: ${tool.definition.name}`);
+        }
+        byName.set(tool.definition.name, tool);
+    }
+    const truncate = options.truncate;
+    if (truncate !== undefined) {
+        truncateToolResult("", truncate);
+    }
+    const applyTruncation = (result) => {
+        if (truncate === undefined)
+            return result;
+        const content = truncateToolResult(result.content, truncate);
+        return content === result.content ? result : { ...result, content };
+    };
+    const scope = options.scope === undefined ? null : new Set(options.scope);
+    const displayTitle = options.displayTitle;
+    const allEntries = tools.map((tool) => tool.entry(options.toJsonSchema, displayTitle));
+    const entries = scope === null ? allEntries : allEntries.filter((entry) => scope.has(entry.meta.name));
+    const metas = new Map(allEntries.map((entry) => [entry.meta.name, entry.meta]));
+    const entryNames = entries.map((entry) => entry.meta.name);
+    const onExecuteError = options.onExecuteError ?? defaultExecuteError;
+    const approvals = options.approvals;
+    return (run) => {
+        const loaded = new Set();
+        return {
+            ...(displayTitle === undefined ? {} : { displayTitle }),
+            entries: approvals === undefined
+                ? () => entries
+                : async () => {
+                    const decisions = await approvals(run, entryNames);
+                    return entries.filter((entry) => decisions[entry.meta.name] !== "deny");
+                },
+            metadata: (name) => metas.get(name),
+            loadedNames: () => new Set(loaded),
+            load: (names) => {
+                for (const name of names)
+                    if (byName.has(name))
+                        loaded.add(name);
+            },
+            seedLoadedNames: (names) => {
+                for (const name of names)
+                    if (byName.has(name))
+                        loaded.add(name);
+            },
+            execute: async (request) => {
+                const tool = byName.get(request.name);
+                if (tool === undefined) {
+                    throw new ToolExecutionError(`Tool '${request.name}' does not exist in this toolset.`, {
+                        retryable: false
+                    });
+                }
+                try {
+                    if (scope !== null && !scope.has(request.name)) {
+                        throw new ToolExecutionError(options.refusal?.(request.name, "scope") ??
+                            `Tool is outside this run's scope: ${request.name}`, { preview: "Tool out of scope", retryable: false });
+                    }
+                    const approvalDecision = approvals === undefined
+                        ? undefined
+                        : ((await approvals(run, [request.name]))[request.name] ?? "approve");
+                    if (approvalDecision === "deny") {
+                        throw new ToolExecutionError(options.refusal?.(request.name, "denied") ??
+                            `Tool denied by settings: ${request.name}`, { preview: "Not allowed here", retryable: false });
+                    }
+                    return applyTruncation(await tool.execute(request.args, {
+                        toolCallId: request.toolCallId,
+                        signal: request.signal ?? neverAborted,
+                        ...(request.approval === undefined ? {} : { approval: request.approval }),
+                        run,
+                        messages: request.messages ?? [],
+                        ...(request.beforeExecute === undefined
+                            ? {}
+                            : { beforeExecute: request.beforeExecute }),
+                        ...(request.emit === undefined ? {} : { emit: request.emit })
+                    }, {
+                        ...(approvalDecision === undefined ? {} : { decision: approvalDecision }),
+                        ...(options.approvalGate === undefined ? {} : { gate: options.approvalGate }),
+                        ...(request.beforeExecute === undefined
+                            ? {}
+                            : { beforeExecute: request.beforeExecute }),
+                        ...(request.phase === undefined ? {} : { phase: request.phase })
+                    }));
+                }
+                catch (cause) {
+                    if (cause instanceof PauseRequested || cause instanceof ToolExecutionError)
+                        throw cause;
+                    throw onExecuteError(cause, request);
+                }
+            }
+        };
+    };
+};
+//# sourceMappingURL=tool.js.map

package/dist/tools/tool.js.map

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

package/dist/tools/truncate.d.ts

@@ -0,0 +1,18 @@
+/** The helper is pure — text in, text out. */
+export declare const DEFAULT_TRUNCATE_MAX_BYTES: number;
+export declare const DEFAULT_TRUNCATE_MAX_LINES = 2000;
+export interface TruncateToolResultOptions {
+    /** UTF-8 byte cap for the kept text (default 51200). */
+    readonly maxBytes?: number;
+    /** Line cap for the kept text (default 2000). */
+    readonly maxLines?: number;
+}
+/**
+ * Truncate one tool result's model-facing text to the byte/line caps. Text
+ * within both caps returns unchanged. Oversized text keeps its head and tail
+ * (half the budget each) around an elision notice naming how many lines and
+ * bytes were cut — both ends usually matter (the command echo and the final
+ * error), which is why this keeps head+tail where opencode keeps one end.
+ */
+export declare const truncateToolResult: (text: string, options?: TruncateToolResultOptions) => string;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/tools/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/tools/truncate.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAI9C,eAAO,MAAM,0BAA0B,QAAY,CAAA;AACnD,eAAO,MAAM,0BAA0B,OAAQ,CAAA;AAE/C,MAAM,WAAW,yBAAyB;IACxC,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAQD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,SACvB,MAAM,YACH,yBAAyB,KACjC,MA8DF,CAAA"}

package/dist/tools/truncate.js

@@ -0,0 +1,76 @@
+/** The helper is pure — text in, text out. */
+import { utf8Prefix, utf8Suffix } from "@arden-hq/std/text";
+export const DEFAULT_TRUNCATE_MAX_BYTES = 50 * 1024;
+export const DEFAULT_TRUNCATE_MAX_LINES = 2_000;
+const encoder = new TextEncoder();
+const bytesOf = (text) => encoder.encode(text).length;
+const positiveInteger = (value) => Number.isSafeInteger(value) && value >= 1;
+/**
+ * Truncate one tool result's model-facing text to the byte/line caps. Text
+ * within both caps returns unchanged. Oversized text keeps its head and tail
+ * (half the budget each) around an elision notice naming how many lines and
+ * bytes were cut — both ends usually matter (the command echo and the final
+ * error), which is why this keeps head+tail where opencode keeps one end.
+ */
+export const truncateToolResult = (text, options = {}) => {
+    const maxBytes = options.maxBytes ?? DEFAULT_TRUNCATE_MAX_BYTES;
+    const maxLines = options.maxLines ?? DEFAULT_TRUNCATE_MAX_LINES;
+    if (!positiveInteger(maxBytes))
+        throw new TypeError("truncateToolResult maxBytes must be a positive integer");
+    if (!positiveInteger(maxLines))
+        throw new TypeError("truncateToolResult maxLines must be a positive integer");
+    const totalBytes = bytesOf(text);
+    const lines = text.split("\n");
+    if (lines.length <= maxLines && totalBytes <= maxBytes)
+        return text;
+    const headLineBudget = Math.max(1, Math.floor(maxLines / 2));
+    const tailLineBudget = Math.max(0, maxLines - headLineBudget);
+    const headByteBudget = Math.max(1, Math.floor(maxBytes / 2));
+    const tailByteBudget = Math.max(0, maxBytes - headByteBudget);
+    const head = [];
+    let headBytes = 0;
+    for (const line of lines) {
+        if (head.length >= headLineBudget)
+            break;
+        const size = bytesOf(line) + (head.length > 0 ? 1 : 0);
+        if (headBytes + size > headByteBudget)
+            break;
+        head.push(line);
+        headBytes += size;
+    }
+    const firstLine = lines[0];
+    if (head.length === 0 && firstLine !== undefined) {
+        const slice = utf8Prefix(firstLine, headByteBudget);
+        if (slice.length > 0) {
+            head.push(slice);
+            headBytes = bytesOf(slice);
+        }
+    }
+    const tail = [];
+    let tailBytes = 0;
+    for (const line of lines.slice(head.length).reverse()) {
+        if (tail.length >= tailLineBudget)
+            break;
+        const size = bytesOf(line) + (tail.length > 0 ? 1 : 0);
+        if (tailBytes + size > tailByteBudget)
+            break;
+        tail.unshift(line);
+        tailBytes += size;
+    }
+    const lastLine = lines.at(-1);
+    if (tail.length === 0 && tailLineBudget > 0 && tailByteBudget > 0 && lastLine !== undefined) {
+        const slice = utf8Suffix(lastLine, tailByteBudget);
+        if (slice.length > 0) {
+            tail.unshift(slice);
+            tailBytes = bytesOf(slice);
+        }
+    }
+    const keptLines = head.length + tail.length;
+    const removedLines = Math.max(0, lines.length - keptLines);
+    const removedBytes = Math.max(0, totalBytes - headBytes - tailBytes);
+    const notice = removedLines > 0
+        ? `[... tool output truncated: ${removedLines} of ${lines.length} lines (~${removedBytes} bytes) elided ...]`
+        : `[... tool output truncated: ~${removedBytes} bytes elided ...]`;
+    return [head.join("\n"), notice, tail.join("\n")].filter((part) => part.length > 0).join("\n\n");
+};
+//# sourceMappingURL=truncate.js.map

package/dist/tools/truncate.js.map

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

package/package.json

@@ -1,6 +1,69 @@
 {
+  "$schema": "https://json.schemastore.org/package.json",
   "name": "@arden-hq/loop",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Provider-independent Promise and AsyncIterable runtime for tool-calling agents",
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=20.19"
+  },
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "arden-source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./providers/openai-responses": {
+      "arden-source": "./src/providers/openai-responses/provider.ts",
+      "types": "./dist/providers/openai-responses/provider.d.ts",
+      "import": "./dist/providers/openai-responses/provider.js"
+    },
+    "./provider-kit": {
+      "arden-source": "./src/providers/kit/index.ts",
+      "types": "./dist/providers/kit/index.d.ts",
+      "import": "./dist/providers/kit/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts.map",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "agent",
+    "tool-calling",
+    "typescript"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "node ../../tooling/clean-dist.mjs",
+    "prepack": "bun run clean && bun run build",
+    "typecheck": "tsc -p tsconfig.check.json --noEmit --pretty false --incremental --tsBuildInfoFile ../../node_modules/.cache/tsc/libs-loop.tsbuildinfo",
+    "test": "vitest run --exclude test/public-boundary.test.ts",
+    "test:dist": "bun run build && vitest run test/public-boundary.test.ts"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "typescript": "7.0.2",
+    "vitest": "4.1.12"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@arden-hq/std": "0.1.0",
+    "eventsource-parser": "4.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arden-hq/arden-engine.git",
+    "directory": "libs/loop"
+  }
+}