@tangle-network/agent-app 0.60.113 → 0.60.115

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -14,7 +14,7 @@ import "../chunk-KHCJKVQN.js";
14
14
  import "../chunk-XEURJVS5.js";
15
15
  import "../chunk-E4AY62T2.js";
16
16
  import "../chunk-SJWIZT7B.js";
17
- import "../chunk-YL5ZTCRU.js";
17
+ import "../chunk-KYAUKYCR.js";
18
18
  import "../chunk-BPN4TEAT.js";
19
19
  import "../chunk-NJDQ2JCP.js";
20
20
  import {
@@ -58,7 +58,7 @@ import {
58
58
  } from "../chunk-RN2N75EI.js";
59
59
  import {
60
60
  runRouterTurn
61
- } from "../chunk-Q7M3GVLL.js";
61
+ } from "../chunk-JCSHTJT6.js";
62
62
  import "../chunk-D6UJEOZQ.js";
63
63
  import "../chunk-7YA4QNTU.js";
64
64
  import {
@@ -157,6 +157,36 @@ async function* streamChatCompletions(doFetch, url, apiKey, body, attribution, h
157
157
  }
158
158
  }
159
159
 
160
+ // src/runtime/turn-knowledge.ts
161
+ var DEFAULT_FILE_BYTES = 8e3;
162
+ var DEFAULT_TEXT_BYTES = 16e3;
163
+ var DEFAULT_MAX_FILES = 60;
164
+ function budgetTurnKnowledge(files, budget = {}) {
165
+ const fileBytes = budget.fileBytes ?? DEFAULT_FILE_BYTES;
166
+ let remaining = budget.textBytes ?? DEFAULT_TEXT_BYTES;
167
+ return [...files].sort((a, b) => a.path.localeCompare(b.path)).slice(0, budget.maxFiles ?? DEFAULT_MAX_FILES).map((file) => {
168
+ const fits = file.text !== null && file.size <= fileBytes && file.size <= remaining;
169
+ if (fits) remaining -= file.size;
170
+ return { path: file.path, size: file.size, text: fits ? file.text : null };
171
+ });
172
+ }
173
+ function turnKnowledgeInstructions(files, options = {}) {
174
+ const read = options.readTool;
175
+ return [
176
+ "Answer questions about this business or its work (hours, times, policies, codes, passwords, prices, contacts, amenities, procedures) only from the knowledge in these instructions, the knowledge files below, or a tool result. Never give a typical or assumed value, and do not say something is absent unless a source says so." + (read ? ` When a listed file without its text may cover the question, read it with ${read} before answering.` : "") + " When nothing covers it, say you do not have that information and offer to ask the owner.",
177
+ ...files.map((file) => file.text !== null ? `Knowledge file ${file.path}:
178
+ ${file.text}` : `Knowledge file ${file.path} (${file.size} bytes, text not shown)${read ? `: read it with ${read} when the question may be covered by it.` : "."}`)
179
+ ];
180
+ }
181
+ async function workspaceKnowledgeForTurn(store, workspaceId, options = {}) {
182
+ const entries = await store.list(workspaceId, options.prefix ?? "/files/");
183
+ return budgetTurnKnowledge(entries.filter((entry) => entry.kind === "file").map((entry) => ({
184
+ path: entry.path,
185
+ size: entry.content !== void 0 ? new TextEncoder().encode(entry.content).byteLength : entry.bytes?.size ?? 0,
186
+ text: entry.content ?? null
187
+ })), options);
188
+ }
189
+
160
190
  // src/runtime/router-turn.ts
161
191
  var DEFAULT_BUDGET_MS = 9e4;
162
192
  var TOOL_RESULT_LIMIT = 12e3;
@@ -164,7 +194,8 @@ function routerFunctionName(name) {
164
194
  return name.replace(/[^A-Za-z0-9_-]/g, "_").slice(0, 64);
165
195
  }
166
196
  function composeRouterTurnPrompt(profile, options = {}) {
167
- const text = [profile.prompt?.systemPrompt ?? "", ...profile.prompt?.instructions ?? [], ...options.context ?? []].filter((part) => part.trim()).join("\n\n");
197
+ const knowledge = options.knowledge ? turnKnowledgeInstructions(options.knowledge.files, { readTool: options.knowledge.readTool }) : [];
198
+ const text = [profile.prompt?.systemPrompt ?? "", ...profile.prompt?.instructions ?? [], ...knowledge, ...options.context ?? []].filter((part) => part.trim()).join("\n\n");
168
199
  return [...options.toolNames ?? []].sort((a, b) => b.length - a.length).reduce((out, name) => out.split(name).join(routerFunctionName(name)), text);
169
200
  }
170
201
  function defaultToolError(error) {
@@ -344,8 +375,11 @@ export {
344
375
  createOpenAICompatStreamTurn,
345
376
  runToolLoop,
346
377
  streamToolLoop,
378
+ budgetTurnKnowledge,
379
+ turnKnowledgeInstructions,
380
+ workspaceKnowledgeForTurn,
347
381
  routerFunctionName,
348
382
  composeRouterTurnPrompt,
349
383
  runRouterTurn
350
384
  };
351
- //# sourceMappingURL=chunk-Q7M3GVLL.js.map
385
+ //# sourceMappingURL=chunk-JCSHTJT6.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/runtime/loop.ts","../src/runtime/openai-stream.ts","../src/runtime/turn-knowledge.ts","../src/runtime/router-turn.ts"],"sourcesContent":["/**\n * The bounded agent tool-loop — owned by `@tangle-network/agent-runtime`.\n *\n * A model turn may emit tool calls (integration-hub actions, the app tools from\n * `../tools`, delegation). The loop streams a turn, collects the executable tool\n * calls, dispatches each, appends the results to history in OpenAI\n * function-calling shape, and re-runs so the model reads them — bounded by\n * `maxToolTurns`, a wall-clock `deadlineMs`, and a `maxCostUsd` budget.\n *\n * The history shape is the OpenAI function-calling contract: the assistant turn\n * that emitted tool calls is preserved as an `assistant` message carrying its\n * `tool_calls` array, and each result is its own `{ role: 'tool', tool_call_id,\n * content }` message keyed to the call. A strict model (Claude, and any\n * OpenAI-compatible provider that validates tool history) needs this to read its\n * own tool use back; folding results into a `user` message makes such models\n * re-issue the same call in a loop.\n *\n * The loop is substrate-owned (`runToolLoop` / `streamToolLoop`); the app\n * supplies `streamTurn` (wrapping its model endpoint) and `executeToolCall`\n * (routing to its integration + app-tool executors). The app-facing names below\n * are 1:1 aliases of the canonical symbols, kept so this package's consumers and\n * the in-package `createAgentRuntime` read against a single, stable vocabulary.\n *\n * This is the LEAF the runtime barrel and its children both import — keeping the\n * tool-loop vocabulary out of any import cycle. The barrel re-exports it.\n */\n\nexport {\n runToolLoop as runAppToolLoop,\n streamToolLoop as streamAppToolLoop,\n} from '@tangle-network/agent-runtime/tool-loop'\nexport type {\n ToolLoopCall as LoopToolCall,\n ToolLoopAssistantToolCall as LoopAssistantToolCall,\n ToolLoopMessage as LoopMessage,\n ToolLoopEvent,\n ToolLoopStopReason,\n ToolLoopResult,\n RunToolLoopOptions as AppToolLoopOptions,\n StreamToolLoopOptions as StreamAppToolLoopOptions,\n StreamToolLoopYield as StreamLoopYield,\n} from '@tangle-network/agent-runtime/tool-loop'\n\n/**\n * Events the app's OpenAI-compat stream adapter ({@link toLoopEvents}) yields.\n *\n * This is the app's own `Raw` event type for the streaming loop — the canonical\n * `streamToolLoop<Raw>` is generic over it. It widens the substrate's\n * tool-loop event with `reasoning` (DeepSeek/router `reasoning_content` /\n * `thinking` deltas, rendered as thinking sections) and `usage` (per-message\n * token accounting) — neither belongs in the substrate's loop contract, so they\n * stay here. The adapter maps each into the `streamTurn` seam; `text` and\n * `tool_call` drive the loop, `reasoning` / `usage` pass through to the UI.\n */\nexport type LoopEvent =\n | { type: 'text'; text: string }\n | { type: 'reasoning'; text: string }\n /** The model has begun a tool call: its name is known, its arguments are\n * still streaming. Emitted once per call, before its `tool_call`. Lets a\n * caller start slow work the call will need (resuming a sandbox box for\n * `sandbox_run`) while the arguments arrive. Consumers that do not care\n * ignore it: it never drives the loop. */\n | { type: 'tool_call_start'; toolCallId?: string; toolName: string }\n | {\n type: 'tool_call'\n call: import('@tangle-network/agent-runtime/tool-loop').ToolLoopCall\n }\n | { type: 'usage'; usage: { promptTokens: number; completionTokens: number } }\n | { type: 'other'; event: unknown }\n","/**\n * OpenAI-compatible stream → `LoopEvent` adapter, for NON-sandbox copilots.\n *\n * `streamAppToolLoop` takes a `streamTurn` seam that yields `LoopEvent`s. A\n * sandboxed agent produces those from its container; a browser/edge copilot\n * instead calls a model directly. The Tangle Router, the tcloud SDK, and most\n * providers all speak the OpenAI Chat Completions streaming shape — so the ONE\n * reusable piece is assembling that stream (content deltas + FRAGMENTED\n * tool-call deltas) into `LoopEvent`s. That assembly is the boilerplate every\n * copilot would re-write (and get wrong — OpenAI streams tool-call arguments in\n * pieces across chunks).\n *\n * This does NOT implement an HTTP client beyond a minimal `fetch` + SSE reader\n * (browser/edge/Node-safe, zero deps). For richer transport use the tcloud SDK\n * or the Vercel AI SDK and pipe their stream through {@link toLoopEvents}.\n */\nimport type { LoopEvent, LoopMessage, LoopToolCall } from './loop'\nimport { normalizeModelId } from './model-catalog'\n\n/** Minimal OpenAI Chat Completions streaming chunk (structural — no `openai` dep). */\nexport interface OpenAIStreamChunk {\n /** The model that produced this chunk. The Tangle Router reports the DATED\n * upstream id here (`gpt-5-2025-08-07`) whether or not it substituted, so\n * this is a served-model source only after id folding — see\n * {@link OpenAICompatServedModel}. */\n model?: string\n choices?: Array<{\n delta?: {\n content?: string | null\n /** Reasoning deltas — DeepSeek/router use `reasoning_content`; some proxies use `thinking`. */\n reasoning_content?: string | null\n thinking?: string | null\n tool_calls?: Array<{\n index: number\n id?: string\n function?: { name?: string; arguments?: string }\n /** Provider-specific call data the next request must echo back. Gemini 3\n * sends `{ google: { thought_signature } }` here and answers HTTP 400\n * when a later request's assistant `tool_calls` entry lacks it. */\n extra_content?: unknown\n }>\n }\n finish_reason?: string | null\n }>\n /** Token accounting (requires `stream_options.include_usage`). Cumulative for\n * the call: the Tangle Router can send it on more than one chunk. */\n usage?: {\n prompt_tokens?: number\n completion_tokens?: number\n } | null\n}\n\ninterface PartialToolCall {\n id?: string\n name: string\n args: string\n extraContent?: unknown\n announced: boolean\n}\n\n/**\n * Map an OpenAI-compat streaming chunk iterator to `LoopEvent`s: each content\n * delta → a `text` event; tool-call deltas are accumulated by index across\n * chunks and emitted as one complete `tool_call` event when the stream finishes\n * (arguments JSON-parsed; an empty/garbled args string yields `{}` rather than\n * throwing). Works for the Tangle Router, tcloud, or any OpenAI-compat source.\n *\n * A call's `extra_content` is kept as `providerFields.extra_content`, which the\n * tool loop echoes on the call's assistant `tool_calls` entry in the next request.\n * Usage is cumulative per call and may arrive on several chunks, so it is\n * yielded once, the last value, when the stream ends.\n *\n * Each call also yields one `tool_call_start` as soon as its name arrives,\n * while its arguments are still streaming, so a caller can start work the call\n * will need. Providers send the whole name in the call's first delta.\n */\nexport async function* toLoopEvents(chunks: AsyncIterable<OpenAIStreamChunk>): AsyncIterable<LoopEvent> {\n const calls = new Map<number, PartialToolCall>()\n let usage: { promptTokens: number; completionTokens: number } | undefined\n for await (const chunk of chunks) {\n // Usage can ride a chunk with an empty choices array — read it before the\n // choice guard. Each report is cumulative, so the last one is the call's.\n if (chunk.usage?.prompt_tokens != null || chunk.usage?.completion_tokens != null) {\n usage = {\n promptTokens: chunk.usage.prompt_tokens ?? 0,\n completionTokens: chunk.usage.completion_tokens ?? 0,\n }\n }\n const choice = chunk.choices?.[0]\n if (!choice) continue\n const content = choice.delta?.content\n if (content) yield { type: 'text', text: content }\n const reasoning = choice.delta?.reasoning_content ?? choice.delta?.thinking\n if (reasoning) yield { type: 'reasoning', text: reasoning }\n for (const tc of choice.delta?.tool_calls ?? []) {\n const cur = calls.get(tc.index) ?? { name: '', args: '', announced: false }\n if (tc.id) cur.id = tc.id\n if (tc.function?.name) cur.name += tc.function.name\n if (tc.function?.arguments) cur.args += tc.function.arguments\n if (tc.extra_content !== undefined) cur.extraContent = tc.extra_content\n calls.set(tc.index, cur)\n if (!cur.announced && cur.name) {\n cur.announced = true\n yield { type: 'tool_call_start', ...(cur.id ? { toolCallId: cur.id } : {}), toolName: cur.name }\n }\n }\n }\n if (usage) yield { type: 'usage', usage }\n for (const [, c] of [...calls.entries()].sort((a, b) => a[0] - b[0])) {\n if (!c.name) continue\n yield {\n type: 'tool_call',\n call: {\n toolCallId: c.id,\n toolName: c.name,\n args: safeParse(c.args),\n ...(c.extraContent !== undefined ? { providerFields: { extra_content: c.extraContent } } : {}),\n } satisfies LoopToolCall,\n }\n }\n}\n\nfunction safeParse(s: string): Record<string, unknown> {\n if (!s.trim()) return {}\n try {\n const v = JSON.parse(s)\n return v && typeof v === 'object' && !Array.isArray(v) ? (v as Record<string, unknown>) : {}\n } catch {\n return {}\n }\n}\n\n/**\n * Which model actually served one direct-router turn.\n *\n * The router substitutes models on purpose — a quota-walled primary comes back\n * `200` answered by a different model — and says so in response headers. This\n * lane used to drop the whole `Response` after taking `.body`, so a turn\n * requested as `claude-sonnet-4-6` and answered by `openai/gpt-5` was recorded\n * by its caller as Claude: per-model quality scoring blamed the wrong model and\n * cost used the wrong price basis.\n *\n * Map this onto the shell's existing attribution contract rather than inventing\n * a second channel — `ChatTurnRouteProducer.modelAttribution()` (`/chat-routes`):\n *\n * modelAttribution: () => ({ requestedModel, servedModel, echoReceived: true })\n *\n * Leave that contract's `servedSource` unset: its union is sandbox\n * profile-resolution vocabulary with no router analogue.\n */\nexport interface OpenAICompatServedModel {\n /** The model id this turn asked for (`OpenAICompatStreamTurnOptions.model`). */\n requestedModel: string\n /** The model the router/provider reports having actually served. */\n servedModel: string\n /** Where `servedModel` was read from. The header is the router's own\n * substitution signal; the body is the backstop that survives CORS. */\n source: 'router_header' | 'response_body'\n /** True when served differs from requested after id folding. Folded, not\n * compared raw: the body reports a dated id on EVERY turn, so `!==` would\n * claim a substitution every time. */\n substituted: boolean\n /** `x-tangle-failover` `trigger=` — why the router swapped. Absent when the\n * router did not inject the substitute (a caller-supplied fallback chain\n * sets the served-model header without the failover one). */\n trigger?: string\n /** `x-tangle-failover` `degraded=`. */\n degraded?: boolean\n}\n\n/** Parse `from=…; to=…; trigger=…; degraded=…` down to the fields we report.\n * Absent/garbled segments are simply omitted — attribution is best-effort and\n * must never fail a turn that is otherwise streaming fine. */\nfunction parseFailoverHeader(raw: string | null): { trigger?: string; degraded?: boolean } {\n if (!raw) return {}\n const fields = new Map<string, string>()\n for (const segment of raw.split(';')) {\n const eq = segment.indexOf('=')\n if (eq === -1) continue\n fields.set(segment.slice(0, eq).trim().toLowerCase(), segment.slice(eq + 1).trim())\n }\n const trigger = fields.get('trigger')\n const degraded = fields.get('degraded')\n return {\n ...(trigger ? { trigger } : {}),\n ...(degraded != null ? { degraded: degraded === 'true' } : {}),\n }\n}\n\n/** Define options for configuring an OpenAI-compatible streaming chat turn including API details and tools */\nexport interface OpenAICompatStreamTurnOptions {\n /** OpenAI-compat base URL (e.g. the Tangle Router `https://router.tangle.tools/v1`). */\n baseUrl: string\n apiKey: string\n model: string\n /** OpenAI tool definitions — pass `buildAppToolOpenAITools(taxonomy)` so the\n * model can call the app tools. Omit for a tool-free copilot. */\n tools?: unknown[]\n temperature?: number\n fetchImpl?: typeof fetch\n /** Extra body fields (e.g. `max_tokens`). */\n extraBody?: Record<string, unknown>\n /** Extra request headers, e.g. a trace id the router records with the generation. */\n headers?: Record<string, string>\n /**\n * Called at most ONCE per turn, as soon as the serving model is\n * determinable, with what actually answered. Never called when neither the\n * header nor the body names a model — silence means \"learned nothing\", not\n * \"nothing was substituted\".\n *\n * `streamTurn` runs once per TOOL turn, so a multi-turn `runAppToolLoop`\n * fires this once per turn; take the last for row attribution.\n */\n onServedModel?: (served: OpenAICompatServedModel) => void\n}\n\n/**\n * Build a `streamTurn` that calls an OpenAI-compatible `/chat/completions`\n * endpoint (Tangle Router / tcloud / any compat provider) with `stream: true`\n * and yields `LoopEvent`s via {@link toLoopEvents}. Browser/edge/Node-safe —\n * just `fetch` + an SSE reader. Drop straight into `streamAppToolLoop`:\n *\n * const cfg = resolveTangleModelConfig() // or { baseUrl, apiKey, model }\n * streamAppToolLoop({ streamTurn: createOpenAICompatStreamTurn({ ...cfg, tools }), executeToolCall, ... })\n */\nexport function createOpenAICompatStreamTurn(\n opts: OpenAICompatStreamTurnOptions,\n): (messages: LoopMessage[]) => AsyncIterable<LoopEvent> {\n const base = opts.baseUrl.replace(/\\/+$/, '')\n const doFetch = opts.fetchImpl ?? fetch\n return (messages) =>\n toLoopEvents(\n streamChatCompletions(doFetch, `${base}/chat/completions`, opts.apiKey, {\n model: opts.model,\n messages,\n stream: true,\n stream_options: { include_usage: true },\n ...(opts.tools && opts.tools.length > 0 ? { tools: opts.tools } : {}),\n ...(opts.temperature != null ? { temperature: opts.temperature } : {}),\n ...opts.extraBody,\n }, opts.onServedModel ? { requestedModel: opts.model, report: opts.onServedModel } : undefined, opts.headers),\n )\n}\n\n/** Stream + parse an OpenAI-compat SSE response into chunks. Tolerates `data:`\n * framing, multi-line buffers, and the terminal `[DONE]`. */\nasync function* streamChatCompletions(\n doFetch: typeof fetch,\n url: string,\n apiKey: string,\n body: Record<string, unknown>,\n attribution?: { requestedModel: string; report: (served: OpenAICompatServedModel) => void },\n headers?: Record<string, string>,\n): AsyncIterable<OpenAIStreamChunk> {\n const res = await doFetch(url, {\n method: 'POST',\n headers: { ...headers, Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json', Accept: 'text/event-stream' },\n body: JSON.stringify(body),\n })\n if (!res.ok || !res.body) {\n const text = res.body ? await res.text().catch(() => '') : ''\n const error = new Error(`OpenAI-compat stream failed (HTTP ${res.status})${text ? `: ${text.slice(0, 200)}` : ''}`)\n // Stamp the NUMERIC status. `isUpstreamUnavailable` (`/model-resolution`)\n // reads a numeric field first and prose only as a backstop, and a\n // Cloudflare EDGE 502 gives it nothing else to read: `content-type:\n // text/plain`, a body of `error code: 502`, and none of the router's own\n // `x-tangle-*` headers, because the origin never ran. Carrying the status\n // as data keeps THIS path — the browser/edge copilot lane, which calls the\n // router directly — out of the string-matching business entirely.\n Object.assign(error, { status: res.status })\n throw error\n }\n // Served-model attribution, fired at most once, as early as it is knowable.\n //\n // The header comes first because it is the router's OWN substitution signal:\n // `X-Tangle-Served-Model` is set only when the served model differs from the\n // requested one, so its presence is authoritative and it arrives before the\n // first byte of content. `X-Tangle-Failover` rides along only when the router\n // itself picked the substitute (a caller-supplied fallback chain sets the\n // former without the latter), which is why `trigger`/`degraded` are optional.\n //\n // The body is the backstop for when the header cannot reach us. In a BROWSER,\n // headers are invisible to JS unless the server lists them in\n // `Access-Control-Expose-Headers` — tangle-router#324 added both, but that\n // only helps once it is DEPLOYED, and any other OpenAI-compat endpoint\n // pointed at this client exposes nothing. The chunk `model` field is not\n // subject to CORS, so it keeps the browser lane attributable regardless.\n let reported = false\n const report = (served: OpenAICompatServedModel): void => {\n if (reported || !attribution) return\n reported = true\n attribution.report(served)\n }\n if (attribution) {\n const servedHeader = res.headers.get('x-tangle-served-model')\n if (servedHeader) {\n report({\n requestedModel: attribution.requestedModel,\n servedModel: servedHeader,\n source: 'router_header',\n substituted: normalizeModelId(servedHeader) !== normalizeModelId(attribution.requestedModel),\n ...parseFailoverHeader(res.headers.get('x-tangle-failover')),\n })\n }\n }\n const reader = res.body.getReader()\n const decoder = new TextDecoder()\n let buffer = ''\n for (;;) {\n const { done, value } = await reader.read()\n if (done) break\n buffer += decoder.decode(value, { stream: true })\n const lines = buffer.split('\\n')\n buffer = lines.pop() ?? ''\n for (const line of lines) {\n const trimmed = line.trim()\n if (!trimmed.startsWith('data:')) continue\n const data = trimmed.slice(5).trim()\n if (data === '[DONE]') return\n let chunk: OpenAIStreamChunk\n try {\n chunk = JSON.parse(data) as OpenAIStreamChunk\n } catch {\n continue /* skip a partial/garbled SSE frame */\n }\n // Body fallback: only when the header said nothing. Fold both ids before\n // comparing — the router reports the dated upstream id (`gpt-5-2025-08-07`)\n // for a request of `openai/gpt-5` even with NO substitution, so a raw\n // `!==` would report a swap on literally every turn.\n if (attribution && !reported && chunk.model) {\n report({\n requestedModel: attribution.requestedModel,\n servedModel: chunk.model,\n source: 'response_body',\n substituted: normalizeModelId(chunk.model) !== normalizeModelId(attribution.requestedModel),\n })\n }\n yield chunk\n }\n }\n}\n","/**\n * Knowledge in every turn: the index of an app's knowledge files, the full\n * text of the small ones, and the rule that keeps answers on them.\n *\n * Measured on Hospitality production (2026-10-11): a Router turn that had to\n * discover files through list/read tools answered 17/17 correctly but needed\n * 3 tool calls (first words 12-17 s), and a turn that skipped the tools\n * answered from model defaults (\"checkout 11:00\" when the file said 12 pm).\n * Putting the text in the prompt removes both failure modes.\n */\n/** The fields read from an agent-runtime workspace-store entry; structural so older runtimes still type-check. */\ninterface KnowledgeEntry { path: string; kind: string; content?: string; bytes?: { size: number } }\n\n/** One knowledge file a turn carries; `text` is null when it is too large or not readable here. */\nexport interface TurnKnowledgeFile {\n path: string\n size: number\n text: string | null\n}\n\nexport interface TurnKnowledgeBudget {\n /** Files at most this many bytes have their text included. Default 8 000. */\n fileBytes?: number\n /** Total text bytes across files. Default 16 000. */\n textBytes?: number\n /** Most files listed. Default 60. */\n maxFiles?: number\n}\n\nconst DEFAULT_FILE_BYTES = 8_000\nconst DEFAULT_TEXT_BYTES = 16_000\nconst DEFAULT_MAX_FILES = 60\n\n/** Apply the byte budget in path order: small files keep their text until the total is spent. */\nexport function budgetTurnKnowledge(files: readonly TurnKnowledgeFile[], budget: TurnKnowledgeBudget = {}): TurnKnowledgeFile[] {\n const fileBytes = budget.fileBytes ?? DEFAULT_FILE_BYTES\n let remaining = budget.textBytes ?? DEFAULT_TEXT_BYTES\n return [...files].sort((a, b) => a.path.localeCompare(b.path)).slice(0, budget.maxFiles ?? DEFAULT_MAX_FILES)\n .map(file => {\n const fits = file.text !== null && file.size <= fileBytes && file.size <= remaining\n if (fits) remaining -= file.size\n return { path: file.path, size: file.size, text: fits ? file.text : null }\n })\n}\n\n/**\n * The prompt lines for a turn's knowledge. `readTool` names the tool that\n * opens a listed file whose text is not shown; without one, such a file is\n * listed by name only.\n */\nexport function turnKnowledgeInstructions(files: readonly TurnKnowledgeFile[], options: { readTool?: string } = {}): string[] {\n const read = options.readTool\n return [\n 'Answer questions about this business or its work (hours, times, policies, codes, passwords, prices, contacts, amenities, procedures) only from the knowledge in these instructions, the knowledge files below, or a tool result. Never give a typical or assumed value, and do not say something is absent unless a source says so.' +\n (read ? ` When a listed file without its text may cover the question, read it with ${read} before answering.` : '') +\n ' When nothing covers it, say you do not have that information and offer to ask the owner.',\n ...files.map(file => file.text !== null ? `Knowledge file ${file.path}:\\n${file.text}`\n : `Knowledge file ${file.path} (${file.size} bytes, text not shown)${read ? `: read it with ${read} when the question may be covered by it.` : '.'}`),\n ]\n}\n\n/** A workspace store's knowledge files (kind `file` under `prefix`) as turn knowledge, within the budget. */\nexport async function workspaceKnowledgeForTurn(\n store: { list(workspaceId: string, prefix: string): Promise<readonly KnowledgeEntry[]> },\n workspaceId: string,\n options: TurnKnowledgeBudget & { prefix?: string } = {},\n): Promise<TurnKnowledgeFile[]> {\n const entries = await store.list(workspaceId, options.prefix ?? '/files/')\n return budgetTurnKnowledge(entries.filter(entry => entry.kind === 'file').map(entry => ({\n path: entry.path,\n size: entry.content !== undefined ? new TextEncoder().encode(entry.content).byteLength : entry.bytes?.size ?? 0,\n text: entry.content ?? null,\n })), options)\n}\n","/**\n * One conversational turn answered by a model through the Tangle Router, with\n * the app's own tools executed in-process — no sandbox in the path.\n *\n * This is the default runtime for conversational turns in an agent app: the\n * product supplies the principal's tools, the profile prompt and the\n * conversation; the engine streams words as the model writes them, runs tool\n * calls through the bounded `streamAppToolLoop`, and returns one outcome.\n * Long, file or code work belongs to the sandbox, reached through a tool the\n * product adds to `tools`.\n *\n * Every failure is an outcome, never a throw. A durable turn owner retries\n * thrown errors, and a retry after a tool ran would repeat that tool's effect\n * (\"never re-run a turn automatically\", docs/agent-app-lessons.md). The only\n * automatic repeat is one model call that failed before any word or tool.\n */\nimport { streamAppToolLoop, type LoopEvent, type LoopMessage, type LoopToolCall, type ToolLoopStopReason } from './loop'\nimport { DEFAULT_TANGLE_ROUTER_BASE_URL } from './model'\nimport { createOpenAICompatStreamTurn } from './openai-stream'\nimport { turnKnowledgeInstructions, type TurnKnowledgeFile } from './turn-knowledge'\nexport { budgetTurnKnowledge, turnKnowledgeInstructions, workspaceKnowledgeForTurn, type TurnKnowledgeBudget, type TurnKnowledgeFile } from './turn-knowledge'\n\n/** A tool the turn may call. Structurally an `McpToolDefinition` whose env is already bound. */\nexport interface RouterTurnTool {\n name: string\n description: string\n /** JSON Schema for the arguments object. */\n inputSchema: Record<string, unknown>\n run(args: Record<string, unknown>): Promise<unknown>\n}\n\n/** What the turn is doing, in the order it happens, for a live view. */\nexport type RouterTurnEvent =\n | { type: 'text'; segment: number; delta: string }\n | { type: 'tool'; callId: string; toolName: string; status: 'running'; input: Record<string, unknown>; startedAt: number }\n | { type: 'tool'; callId: string; toolName: string; status: 'completed'; output: unknown; startedAt: number; endedAt: number }\n | { type: 'tool'; callId: string; toolName: string; status: 'error'; error: { code: string; message: string }; startedAt: number; endedAt: number }\n | { type: 'usage'; promptTokens: number; completionTokens: number }\n\nexport interface RouterTurnFailure {\n /** `model_http_<status>`, `model_unavailable`, `turn_<stopReason>` or `router_unconfigured`. */\n code: string\n status?: number\n message: string\n}\n\nexport interface RouterTurnOutcome {\n /** Every text segment the model wrote, joined by blank lines. */\n text: string\n /** The model the router reports having served, when it said. */\n servedModel: string | null\n toolCalls: Array<{ callId: string; toolName: string; ok: boolean }>\n /** Token use summed over every model call in the turn, as the router reported it. */\n usage: { promptTokens: number; completionTokens: number; modelCalls: number }\n failure?: RouterTurnFailure\n}\n\nexport interface RouterTurnOptions {\n apiKey: string\n model: string\n /** Defaults to the Tangle Router. */\n baseUrl?: string\n systemPrompt: string\n userMessage: string\n /** Earlier turns. Plain text messages, or OpenAI function-calling history (an assistant message\n * carrying `tool_calls` and the `tool` messages answering them) so the model sees what it did. */\n history?: Array<{ role: 'user' | 'assistant'; content: string } | LoopMessage>\n tools?: RouterTurnTool[]\n /** Wall-clock budget in ms. Default 90 s. A caller whose retry window is shorter passes less. */\n budgetMs?: number\n /** Runaway backstop on model turns. Default 12. */\n maxToolTurns?: number\n maxTokens?: number\n /** Sent as `x-tangle-trace-id` so the router's generation joins the app's trace. */\n traceId?: string\n fetchImpl?: typeof fetch\n onEvent?: (event: RouterTurnEvent) => void\n /** Map a thrown tool error to what the model reads. Default: an error carrying string `code`\n * (and numeric `status`) is reported with its message; anything else is a generic failure. */\n toolError?: (error: unknown) => { code: string; message: string; status?: number } | null\n /** Called for a tool failure the default mapping hides from the model, for the app's logs. */\n onToolFailure?: (toolName: string, error: unknown) => void\n}\n\nconst DEFAULT_BUDGET_MS = 90_000\nconst TOOL_RESULT_LIMIT = 12_000\n\n/** OpenAI-compatible function names allow only `[A-Za-z0-9_-]{1,64}`; app tool names often use dots. */\nexport function routerFunctionName(name: string): string {\n return name.replace(/[^A-Za-z0-9_-]/g, '_').slice(0, 64)\n}\n\n/**\n * The lean system prompt for a Router turn: the profile's system prompt and\n * instructions, the turn's knowledge files, then caller context, with tool names rewritten to the function\n * names the model actually calls.\n */\nexport function composeRouterTurnPrompt(\n profile: { prompt?: { systemPrompt?: string; instructions?: readonly string[] } },\n options: {\n context?: readonly string[]\n toolNames?: readonly string[]\n /** Knowledge files every turn carries; see {@link turnKnowledgeInstructions}. */\n knowledge?: { files: readonly TurnKnowledgeFile[]; readTool?: string }\n } = {},\n): string {\n const knowledge = options.knowledge ? turnKnowledgeInstructions(options.knowledge.files, { readTool: options.knowledge.readTool }) : []\n const text = [profile.prompt?.systemPrompt ?? '', ...(profile.prompt?.instructions ?? []), ...knowledge, ...(options.context ?? [])]\n .filter(part => part.trim()).join('\\n\\n')\n return [...(options.toolNames ?? [])].sort((a, b) => b.length - a.length)\n .reduce((out, name) => out.split(name).join(routerFunctionName(name)), text)\n}\n\nfunction defaultToolError(error: unknown): { code: string; message: string; status?: number } | null {\n const value = error as { code?: unknown; status?: unknown; message?: unknown; issues?: unknown }\n if (Array.isArray(value?.issues)) {\n return { code: 'invalid_arguments', message: JSON.stringify(value.issues).slice(0, 600) }\n }\n if (typeof value?.code === 'string' && typeof value.message === 'string') {\n return { code: value.code, message: value.message, ...(typeof value.status === 'number' ? { status: value.status } : {}) }\n }\n return null\n}\n\nfunction renderResult(outcome: { ok: true; result: unknown } | { ok: false; code: string; message: string }): string {\n if (!outcome.ok) return `Error (${outcome.code}): ${outcome.message}`\n let text: string\n try { text = typeof outcome.result === 'string' ? outcome.result : JSON.stringify(outcome.result ?? null) }\n catch { text = String(outcome.result) }\n return text.length > TOOL_RESULT_LIMIT ? `${text.slice(0, TOOL_RESULT_LIMIT)}…` : text\n}\n\nexport async function runRouterTurn(options: RouterTurnOptions): Promise<RouterTurnOutcome> {\n if (!options.apiKey) {\n return { text: '', servedModel: null, toolCalls: [], usage: { promptTokens: 0, completionTokens: 0, modelCalls: 0 },\n failure: { code: 'router_unconfigured', message: 'The model credential is not configured.' } }\n }\n const emit = options.onEvent ?? (() => {})\n const byFunction = new Map<string, RouterTurnTool>()\n for (const tool of options.tools ?? []) {\n const fn = routerFunctionName(tool.name)\n if (!byFunction.has(fn)) byFunction.set(fn, tool)\n }\n let servedModel: string | null = null\n const streamTurn = createOpenAICompatStreamTurn({\n baseUrl: options.baseUrl ?? DEFAULT_TANGLE_ROUTER_BASE_URL,\n apiKey: options.apiKey,\n model: options.model,\n tools: [...byFunction.entries()].map(([name, tool]) => ({\n type: 'function', function: { name, description: tool.description, parameters: tool.inputSchema },\n })),\n ...(options.maxTokens ? { extraBody: { max_tokens: options.maxTokens } } : {}),\n ...(options.traceId ? { headers: { 'x-tangle-trace-id': options.traceId } } : {}),\n ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),\n onServedModel: served => { servedModel = served.servedModel },\n })\n const segments: string[] = []\n const usage = { promptTokens: 0, completionTokens: 0, modelCalls: 0 }\n const toolCalls: RouterTurnOutcome['toolCalls'] = []\n const started = new Map<string, number>()\n let segmentOpen = false\n let toolsRan = 0\n const deadline = Date.now() + (options.budgetMs ?? DEFAULT_BUDGET_MS)\n const callIdOf = (id: string | undefined, toolName: string) => id ?? `${toolName}-${started.size}`\n\n const run = async (): Promise<ToolLoopStopReason> => {\n for await (const step of streamAppToolLoop<LoopEvent>({\n systemPrompt: options.systemPrompt,\n userMessage: options.userMessage,\n priorMessages: (options.history ?? []) as LoopMessage[],\n streamTurn,\n extractText: event => event.type === 'text' ? event.text : '',\n extractToolCall: event => event.type === 'tool_call' ? event.call : null,\n isExecutableTool: name => byFunction.has(name),\n deadlineMs: deadline,\n maxToolTurns: options.maxToolTurns ?? 12,\n renderResult: (_label, outcome) => renderResult(outcome),\n executeToolCall: async (call: LoopToolCall) => {\n const tool = byFunction.get(call.toolName)\n if (!tool) return { ok: false, code: 'unknown_tool', message: `No tool named ${call.toolName}` }\n toolsRan++\n try {\n return { ok: true, result: await tool.run(call.args) }\n } catch (error) {\n const mapped = (options.toolError ?? defaultToolError)(error)\n if (mapped) return { ok: false, ...mapped }\n options.onToolFailure?.(tool.name, error)\n return { ok: false, code: 'tool_failed', message: 'The tool failed; tell the user what could not be completed.' }\n }\n },\n })) {\n if (step.kind === 'event') {\n const event = step.event\n if (event.type === 'text' && event.text) {\n if (!segmentOpen) { segments.push(''); segmentOpen = true }\n segments[segments.length - 1] += event.text\n emit({ type: 'text', segment: segments.length, delta: event.text })\n } else if (event.type === 'usage') {\n usage.promptTokens += event.usage.promptTokens\n usage.completionTokens += event.usage.completionTokens\n usage.modelCalls++\n emit({ type: 'usage', ...event.usage })\n } else if (event.type === 'tool_call') {\n segmentOpen = false\n const tool = byFunction.get(event.call.toolName)\n const callId = callIdOf(event.call.toolCallId, event.call.toolName)\n started.set(callId, Date.now())\n emit({ type: 'tool', callId, toolName: tool?.name ?? event.call.toolName, status: 'running',\n input: event.call.args, startedAt: started.get(callId)! })\n }\n } else if (step.kind === 'tool_result') {\n const tool = byFunction.get(step.toolName)\n const callId = callIdOf(step.toolCallId, step.toolName)\n const startedAt = started.get(callId) ?? Date.now()\n const toolName = tool?.name ?? step.toolName\n toolCalls.push({ callId, toolName, ok: step.outcome.ok })\n emit(step.outcome.ok\n ? { type: 'tool', callId, toolName, status: 'completed', output: step.outcome.result, startedAt, endedAt: Date.now() }\n : { type: 'tool', callId, toolName, status: 'error', startedAt, endedAt: Date.now(),\n error: { code: step.outcome.code, message: step.outcome.message } })\n } else if (step.kind === 'capped') {\n return step.stopReason\n }\n }\n return 'completed'\n }\n\n const outcome = (failure?: RouterTurnFailure): RouterTurnOutcome => ({\n text: segments.map(part => part.trim()).filter(Boolean).join('\\n\\n'),\n servedModel, toolCalls, usage: { ...usage }, ...(failure ? { failure } : {}),\n })\n let stop: ToolLoopStopReason\n try {\n try {\n stop = await run()\n } catch (error) {\n // Safe to repeat only while nothing was said and no tool ran.\n if (toolsRan > 0 || segments.length > 0) throw error\n stop = await run()\n }\n } catch (error) {\n const status = (error as { status?: unknown }).status\n return outcome(typeof status === 'number'\n ? { code: `model_http_${status}`, status, message: 'The model service did not answer.' }\n : { code: 'model_unavailable', message: 'The model service did not answer.' })\n }\n if (stop !== 'completed') return outcome({ code: `turn_${stop}`, message: 'The reply was stopped before it finished.' })\n // A model can end its turn with neither a word nor a tool call (gemini-2.5-flash did on 8 of\n // 53 \"remember\" turns, 2026-10-11). Nothing was said and nothing ran, so one repeat is safe;\n // an answer still blank is a typed failure, never a successful empty reply.\n if (!segments.some(part => part.trim())) {\n if (toolsRan === 0) {\n try { stop = await run() } catch { stop = 'completed' }\n if (stop !== 'completed') return outcome({ code: `turn_${stop}`, message: 'The reply was stopped before it finished.' })\n }\n if (!segments.some(part => part.trim())) {\n return outcome({ code: 'model_empty', message: 'The model finished without writing a reply.' })\n }\n }\n return outcome()\n}\n"],"mappings":"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","names":["outcome"]}
@@ -1310,6 +1310,11 @@ function AgentProfileEditor({
1310
1310
  if (!jsonDirty) setJson(JSON.stringify(value, null, 2));
1311
1311
  }, [value, jsonDirty]);
1312
1312
  const editingDisabled = disabled || jsonDirty;
1313
+ const hasMorePrompt = Boolean(value.prompt?.systemPrompt || value.prompt?.instructions?.length);
1314
+ const [moreOpen, setMoreOpen] = useState7(hasMorePrompt);
1315
+ useEffect4(() => {
1316
+ if (hasMorePrompt) setMoreOpen(true);
1317
+ }, [hasMorePrompt]);
1313
1318
  const sectionAllowed = (section) => !config?.sections || config.sections.includes(section);
1314
1319
  const allowsResource = (kind) => !allowedResourceKinds || allowedResourceKinds.includes(kind);
1315
1320
  const show = {
@@ -1372,7 +1377,11 @@ function AgentProfileEditor({
1372
1377
  return true;
1373
1378
  }
1374
1379
  function prompt(next) {
1375
- emit({ ...value, prompt: next });
1380
+ const cleaned = { ...next };
1381
+ if (cleaned.systemPrompt === "") delete cleaned.systemPrompt;
1382
+ if (cleaned.appendSystemPrompt === "") delete cleaned.appendSystemPrompt;
1383
+ const { prompt: _prompt, ...rest } = value;
1384
+ emit(Object.values(cleaned).some((item) => item !== void 0) ? { ...rest, prompt: cleaned } : rest);
1376
1385
  }
1377
1386
  function model(next) {
1378
1387
  const cleaned = Object.fromEntries(Object.entries(next).filter(([, item]) => item !== void 0 && item !== ""));
@@ -1783,22 +1792,22 @@ function AgentProfileEditor({
1783
1792
  /* @__PURE__ */ jsx7(
1784
1793
  Field,
1785
1794
  {
1786
- label: "System prompt",
1787
- htmlFor: `${id}-system`,
1788
- info: "Replaces the harness's built-in system prompt. Leave it empty to keep the built-in prompt.",
1795
+ label: "Additional instructions",
1796
+ htmlFor: `${id}-append`,
1797
+ info: "Added after the agent's built-in prompt, which stays in force. Leave it empty to add nothing.",
1789
1798
  children: /* @__PURE__ */ jsx7(
1790
1799
  Textarea,
1791
1800
  {
1792
- id: `${id}-system`,
1793
- className: "min-h-52 text-sm leading-6",
1801
+ id: `${id}-append`,
1802
+ className: "min-h-40 text-sm leading-6",
1794
1803
  disabled: editingDisabled,
1795
- value: value.prompt?.systemPrompt ?? "",
1796
- onChange: (event) => prompt({ ...value.prompt, systemPrompt: event.target.value })
1804
+ value: value.prompt?.appendSystemPrompt ?? "",
1805
+ onChange: (event) => prompt({ ...value.prompt, appendSystemPrompt: event.target.value })
1797
1806
  }
1798
1807
  )
1799
1808
  }
1800
1809
  ),
1801
- /* @__PURE__ */ jsxs7("details", { className: "group/more", open: Boolean(value.prompt?.appendSystemPrompt || value.prompt?.instructions?.length) || void 0, children: [
1810
+ /* @__PURE__ */ jsxs7("details", { className: "group/more", open: moreOpen, onToggle: (event) => setMoreOpen(event.currentTarget.open), children: [
1802
1811
  /* @__PURE__ */ jsxs7("summary", { className: "flex w-fit cursor-pointer list-none items-center gap-1.5 rounded-md text-sm font-medium text-muted-foreground hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring [&::-webkit-details-marker]:hidden", children: [
1803
1812
  /* @__PURE__ */ jsx7("svg", { "aria-hidden": "true", viewBox: "0 0 24 24", className: "size-4 transition-transform group-open/more:rotate-90", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx7("path", { d: "m9 6 6 6-6 6" }) }),
1804
1813
  "More instructions"
@@ -1807,22 +1816,24 @@ function AgentProfileEditor({
1807
1816
  /* @__PURE__ */ jsx7(
1808
1817
  Field,
1809
1818
  {
1810
- label: "Appended prompt",
1811
- htmlFor: `${id}-append`,
1812
- info: "Added after the system prompt, or after the built-in prompt when the system prompt is empty.",
1819
+ label: "Replacement system prompt",
1820
+ htmlFor: `${id}-system`,
1821
+ info: "Replaces the agent's built-in prompt entirely. Leave it empty to keep the built-in prompt.",
1813
1822
  children: /* @__PURE__ */ jsx7(
1814
1823
  Textarea,
1815
1824
  {
1816
- id: `${id}-append`,
1825
+ id: `${id}-system`,
1817
1826
  size: "compact",
1818
1827
  className: "min-h-24 text-sm leading-6",
1819
1828
  disabled: editingDisabled,
1820
- value: value.prompt?.appendSystemPrompt ?? "",
1821
- onChange: (event) => prompt({ ...value.prompt, appendSystemPrompt: event.target.value })
1829
+ value: value.prompt?.systemPrompt ?? "",
1830
+ "aria-describedby": value.prompt?.systemPrompt ? `${id}-system-replaces` : void 0,
1831
+ onChange: (event) => prompt({ ...value.prompt, systemPrompt: event.target.value })
1822
1832
  }
1823
1833
  )
1824
1834
  }
1825
1835
  ),
1836
+ value.prompt?.systemPrompt && /* @__PURE__ */ jsx7(StatusLine, { id: `${id}-system-replaces`, tone: "warning", children: "The built-in prompt is replaced. The agent receives this text, then the additional instructions." }),
1826
1837
  /* @__PURE__ */ jsxs7("div", { role: "group", "aria-labelledby": `${id}-instructions-label`, className: "space-y-2", children: [
1827
1838
  /* @__PURE__ */ jsx7("div", { className: "flex items-center gap-1.5", children: /* @__PURE__ */ jsx7("span", { id: `${id}-instructions-label`, className: formText.label, children: "Project instructions" }) }),
1828
1839
  /* @__PURE__ */ jsx7("p", { className: formText.muted, children: "Lower-priority guidance the agent reads like a project file." }),
@@ -2199,4 +2210,4 @@ export {
2199
2210
  AGENT_PROFILE_EDITOR_SECTIONS,
2200
2211
  AgentProfileEditor
2201
2212
  };
2202
- //# sourceMappingURL=chunk-YL5ZTCRU.js.map
2213
+ //# sourceMappingURL=chunk-KYAUKYCR.js.map