@tangle-network/agent-app 0.44.49 → 0.44.51

package/dist/assistant/index.js

@@ -3,9 +3,9 @@ import {
   ChatMessages,
   ModelPicker,
   ProviderLogo
-} from "../chunk-D3GK2IPA.js";
+} from "../chunk-WXWU2FEB.js";
 import "../chunk-FBVLEGEG.js";
-import "../chunk-YOSSGDIG.js";
+import "../chunk-GINKOZFD.js";
 import "../chunk-YTMKRL3L.js";
 import "../chunk-GEYACSFW.js";
 import "../chunk-6MUJROBT.js";

package/dist/chat-routes/index.d.ts

@@ -68,6 +68,11 @@ interface DraftStoredMessage {
     role: 'user' | 'assistant' | 'system' | 'tool';
     content: string;
     parts?: ChatMessagePart[] | null;
+    model?: string | null;
+    requestedModel?: string | null;
+    servedModel?: string | null;
+    servedProvider?: string | null;
+    servedSource?: string | null;
 }
 /** Values written to the assistant row — the intersection of the append and
  *  patch shapes, so one snapshot serves both. */
@@ -75,6 +80,10 @@ interface AssistantRowValues {
     content: string;
     parts?: ChatMessagePart[];
     model?: string | null;
+    requestedModel?: string | null;
+    servedModel?: string | null;
+    servedProvider?: string | null;
+    servedSource?: string | null;
     inputTokens?: number | null;
     outputTokens?: number | null;
     reasoningTokens?: number | null;
@@ -281,6 +290,10 @@ interface ChatTurnMessageStore {
         content: string;
         parts?: ChatMessagePart[];
         model?: string | null;
+        requestedModel?: string | null;
+        servedModel?: string | null;
+        servedProvider?: string | null;
+        servedSource?: string | null;
         inputTokens?: number | null;
         outputTokens?: number | null;
         reasoningTokens?: number | null;
@@ -295,6 +308,10 @@ interface ChatTurnMessageStore {
         content?: string;
         parts?: ChatMessagePart[];
         model?: string | null;
+        requestedModel?: string | null;
+        servedModel?: string | null;
+        servedProvider?: string | null;
+        servedSource?: string | null;
         inputTokens?: number | null;
         outputTokens?: number | null;
         reasoningTokens?: number | null;
@@ -325,6 +342,9 @@ interface ChatTurnRouteProducer extends ChatTurnProducer {
     /** Model-failover attribution, when the producer supports it. Reported onto
      *  the usage/billing receipt so a downgrade is never silent. */
     modelFailover?(): ChatTurnModelFailover;
+    /** Requested-versus-served attribution reported by the sandbox sidecar.
+     *  `echoReceived` distinguishes a missing echo from a partial echo. */
+    modelAttribution?(): ChatTurnModelAttribution;
 }
 /** Which model served, and what it took to get there. */
 interface ChatTurnModelFailover {
@@ -335,6 +355,19 @@ interface ChatTurnModelFailover {
     /** True when the preferred model did not serve. */
     usedFallback: boolean;
 }
+/** Requested and effective model attribution for one sandbox turn. */
+interface ChatTurnModelAttribution {
+    /** The model explicitly requested by the caller, before shell failover. */
+    requestedModel?: string;
+    /** The model the downstream sandbox reports actually served the turn. */
+    servedModel?: string;
+    /** The provider that served the turn, when echoed by the sandbox. */
+    servedProvider?: string;
+    /** How the sandbox selected the served model. */
+    servedSource?: 'request' | 'environment' | 'profile';
+    /** True when a structurally valid effective-backend echo was observed. */
+    echoReceived: boolean;
+}
 /** Resolve authorization status and context for a chat turn including tenant and user identification */
 type ChatTurnAuthorization<TContext> = {
     ok: true;
@@ -475,6 +508,12 @@ interface ChatTurnLifecycleComplete<TContext> extends ChatTurnLifecycleBase<TCon
      *  `usage` is that model's, so telemetry that splits cost or quality by model
      *  must key on this and not on the requested one. */
     model?: string;
+    /** Requested-versus-served attribution. A difference is detectable from
+     *  this receipt and from the persisted assistant row independently. */
+    requestedModel?: string;
+    servedModel?: string;
+    servedProvider?: string;
+    servedSource?: 'request' | 'environment' | 'profile';
     /** Attribution for a downgrade: which models were tried and why each failed.
      *  `undefined` when the producer reports no failover support. */
     modelFailover?: ChatTurnModelFailover;
@@ -520,6 +559,12 @@ interface ChatTurnCompleteInput<TContext> {
      *  the requested one, so a product that bills or scores per model MUST read
      *  it here rather than assuming the model it asked for. */
     model?: string;
+    /** Requested-versus-served attribution. A difference is detectable from
+     *  this receipt and from the persisted assistant row independently. */
+    requestedModel?: string;
+    servedModel?: string;
+    servedProvider?: string;
+    servedSource?: 'request' | 'environment' | 'profile';
     /** Present when the producer supports failover: the full attempt trail, and
      *  `usedFallback` — the flag that makes a silent downgrade impossible. */
     modelFailover?: ChatTurnModelFailover;
@@ -1162,6 +1207,14 @@ interface DetachedTurnResult {
      *  A caller that bills or scores per model must read this, not the model it
      *  requested. */
     model?: string;
+    /** The caller's explicit model request, before shell failover. */
+    requestedModel?: string;
+    /** The effective model echoed by the downstream sandbox. */
+    servedModel?: string;
+    /** The effective provider echoed by the downstream sandbox. */
+    servedProvider?: string;
+    /** How the downstream sandbox selected the effective model. */
+    servedSource?: 'request' | 'environment' | 'profile';
     /** True when the preferred model did not serve. Makes an autonomous
      *  downgrade — which no human watched happen — attributable after the fact. */
     usedModelFallback?: boolean;
@@ -1702,4 +1755,4 @@ interface PromoteAgentFilePartOptions {
 /** Promote a part of an agent file with optional byte limits and MIME type detection */
 declare function promoteAgentFilePart(options: PromoteAgentFilePartOptions): Promise<PromoteFilePartResult>;
 
-export { type AssistantDraftSnapshot, type AssistantDraftStore, type AssistantDraftWriter, type AssistantDraftWriterOptions, type AssistantRowValues, type AttachmentPathArgs, type AttachmentPathCheck, type AttachmentReadResult, type AttachmentUploadAuthorization, type AttachmentWriteResult, type BuildDispatchPartsInput, ChatAttachmentKind, type ChatRouteDurableProjection, type ChatRouteDurableProjectionLogger, type ChatRouteEvent, type ChatTurnAuthorization, type ChatTurnAuthorizeArgs, type ChatTurnCompleteInput, ChatTurnFilePartInput, type ChatTurnGateResult, type ChatTurnHeartbeat, type ChatTurnInputPatch, type ChatTurnLifecycle, type ChatTurnLifecycleComplete, type ChatTurnLifecycleError, type ChatTurnLifecycleStart, type ChatTurnLock, type ChatTurnLockResult, type ChatTurnMessageStore, type ChatTurnModelFailover, ChatTurnPartInput, type ChatTurnProduceArgs, ChatTurnRequestPayload, type ChatTurnRouteProducer, type ChatTurnRoutes, type ChatTurnUsage, type CreateAttachmentUploadRouteOptions, type CreateChatTurnRoutesOptions, type CreateUploadRouteOptions, type DetachedTurnFinal, type DetachedTurnOptions, type DetachedTurnParts, type DetachedTurnResult, type DispatchPartsOutcome, type DraftPersistenceTuning, type DraftStoredMessage, type EmptyTurnRetryInfo, type FilePartPromotionOutcome, MAX_EMPTY_TURN_RETRIES, type ModelFailoverStreamHandle, type ModelFailoverStreamOptions, type ModelFallbackInfo, type OpenModelStream, PROMOTE_MAX_FILE_BYTES, type PromoteAgentFilePartOptions, type PromoteFilePartResult, PromptInputPart, type RawAgentFilePart, type ReadAttachmentFn, type ReadSandboxMentionFn, type ResolveChatAttachmentsOptions, type ResolveChatAttachmentsResult, type SandboxChatProducerOptions, type SandboxUploadSink, UPLOAD_INLINE_MAX_BYTES, UPLOAD_MAX_FILE_BYTES, type UploadAuthorization, type UploadedChatFile, type WriteAttachmentFn, assistantRowIdForTurn, buildDispatchParts, bytesToBase64, classifyTerminalFailure, createAssistantDraftWriter, createAttachmentUploadRoute, createChatTurnRoutes, createSandboxChatProducer, createUploadRoute, defaultValidateAttachmentPath, isCommittingSandboxEvent, isDraftContentEvent, normalizeChatPromptForSandbox, promoteAgentFilePart, resolveChatAttachments, resolveEmptyTurnRetries, rowIdOf, runDetachedTurn, sanitizeUploadFilename, sniffMimeFromName, storeSupportsDraftPersistence, streamWithModelFailover, summarizeFailoverReason, withDurableChatProjection };
+export { type AssistantDraftSnapshot, type AssistantDraftStore, type AssistantDraftWriter, type AssistantDraftWriterOptions, type AssistantRowValues, type AttachmentPathArgs, type AttachmentPathCheck, type AttachmentReadResult, type AttachmentUploadAuthorization, type AttachmentWriteResult, type BuildDispatchPartsInput, ChatAttachmentKind, type ChatRouteDurableProjection, type ChatRouteDurableProjectionLogger, type ChatRouteEvent, type ChatTurnAuthorization, type ChatTurnAuthorizeArgs, type ChatTurnCompleteInput, ChatTurnFilePartInput, type ChatTurnGateResult, type ChatTurnHeartbeat, type ChatTurnInputPatch, type ChatTurnLifecycle, type ChatTurnLifecycleComplete, type ChatTurnLifecycleError, type ChatTurnLifecycleStart, type ChatTurnLock, type ChatTurnLockResult, type ChatTurnMessageStore, type ChatTurnModelAttribution, type ChatTurnModelFailover, ChatTurnPartInput, type ChatTurnProduceArgs, ChatTurnRequestPayload, type ChatTurnRouteProducer, type ChatTurnRoutes, type ChatTurnUsage, type CreateAttachmentUploadRouteOptions, type CreateChatTurnRoutesOptions, type CreateUploadRouteOptions, type DetachedTurnFinal, type DetachedTurnOptions, type DetachedTurnParts, type DetachedTurnResult, type DispatchPartsOutcome, type DraftPersistenceTuning, type DraftStoredMessage, type EmptyTurnRetryInfo, type FilePartPromotionOutcome, MAX_EMPTY_TURN_RETRIES, type ModelFailoverStreamHandle, type ModelFailoverStreamOptions, type ModelFallbackInfo, type OpenModelStream, PROMOTE_MAX_FILE_BYTES, type PromoteAgentFilePartOptions, type PromoteFilePartResult, PromptInputPart, type RawAgentFilePart, type ReadAttachmentFn, type ReadSandboxMentionFn, type ResolveChatAttachmentsOptions, type ResolveChatAttachmentsResult, type SandboxChatProducerOptions, type SandboxUploadSink, UPLOAD_INLINE_MAX_BYTES, UPLOAD_MAX_FILE_BYTES, type UploadAuthorization, type UploadedChatFile, type WriteAttachmentFn, assistantRowIdForTurn, buildDispatchParts, bytesToBase64, classifyTerminalFailure, createAssistantDraftWriter, createAttachmentUploadRoute, createChatTurnRoutes, createSandboxChatProducer, createUploadRoute, defaultValidateAttachmentPath, isCommittingSandboxEvent, isDraftContentEvent, normalizeChatPromptForSandbox, promoteAgentFilePart, resolveChatAttachments, resolveEmptyTurnRetries, rowIdOf, runDetachedTurn, sanitizeUploadFilename, sniffMimeFromName, storeSupportsDraftPersistence, streamWithModelFailover, summarizeFailoverReason, withDurableChatProjection };

package/dist/chat-routes/index.js

@@ -504,6 +504,7 @@ function createChatTurnRoutes(options) {
           });
         } else {
           const failoverInfo = producer?.modelFailover?.();
+          const attribution = producer?.modelAttribution?.();
           await lifecycle.onTurnComplete?.({
             identity,
             executionId,
@@ -515,6 +516,10 @@ function createChatTurnRoutes(options) {
             assistantMessageId: assistantRowId(),
             ...gatedTurn ? { gated: true } : {},
             ...producer?.model ? { model: producer.model } : {},
+            ...attribution?.requestedModel ? { requestedModel: attribution.requestedModel } : {},
+            ...attribution?.servedModel ? { servedModel: attribution.servedModel } : {},
+            ...attribution?.servedProvider ? { servedProvider: attribution.servedProvider } : {},
+            ...attribution?.servedSource ? { servedSource: attribution.servedSource } : {},
             ...failoverInfo ? { modelFailover: failoverInfo } : {}
           });
         }
@@ -659,10 +664,15 @@ function createChatTurnRoutes(options) {
               return;
             }
             const usage = producer?.usage?.() ?? {};
+            const attribution = producer?.modelAttribution?.();
             const values = {
               content: finalText,
               ...parts && parts.length > 0 ? { parts } : {},
               ...producer?.model ? { model: producer.model } : {},
+              ...attribution?.requestedModel ? { requestedModel: attribution.requestedModel } : {},
+              ...attribution?.servedModel ? { servedModel: attribution.servedModel } : {},
+              ...attribution?.servedProvider ? { servedProvider: attribution.servedProvider } : {},
+              ...attribution?.servedSource ? { servedSource: attribution.servedSource } : {},
               ...usage.inputTokens !== void 0 ? { inputTokens: usage.inputTokens } : {},
               ...usage.outputTokens !== void 0 ? { outputTokens: usage.outputTokens } : {},
               ...usage.reasoningTokens !== void 0 ? { reasoningTokens: usage.reasoningTokens } : {},
@@ -691,6 +701,7 @@ function createChatTurnRoutes(options) {
             // complete with empty text.
             onTurnComplete: ({ identity: turnIdentity, finalText }) => {
               const failoverInfo = producer?.modelFailover?.();
+              const attribution = producer?.modelAttribution?.();
               return options.onTurnComplete({
                 identity: turnIdentity,
                 finalText,
@@ -699,6 +710,10 @@ function createChatTurnRoutes(options) {
                 assistantMessageId: assistantRowId(),
                 ...runFailed ? { failureReason: failureReasonOf(lastFailureData) } : {},
                 ...producer?.model ? { model: producer.model } : {},
+                ...attribution?.requestedModel ? { requestedModel: attribution.requestedModel } : {},
+                ...attribution?.servedModel ? { servedModel: attribution.servedModel } : {},
+                ...attribution?.servedProvider ? { servedProvider: attribution.servedProvider } : {},
+                ...attribution?.servedSource ? { servedSource: attribution.servedSource } : {},
                 ...failoverInfo ? { modelFailover: failoverInfo } : {}
               });
             }
@@ -1029,6 +1044,20 @@ function textDelta(tracker, key, part, rawDelta) {
   tracker.seen.set(key, snapshot);
   return snapshot;
 }
+function parseEffectiveBackend(data) {
+  const backend = asRecord(data.effectiveBackend);
+  if (!backend) return void 0;
+  const provider = asString(backend.provider);
+  const model = asString(backend.model);
+  const rawSource = asString(backend.source);
+  const source = rawSource === "request" || rawSource === "environment" || rawSource === "profile" ? rawSource : void 0;
+  if (!provider && !model && !source) return void 0;
+  return {
+    ...model ? { servedModel: model } : {},
+    ...provider ? { servedProvider: provider } : {},
+    ...source ? { servedSource: source } : {}
+  };
+}
 function usageFromStepFinish(part, usage) {
   const tokens = asRecord(part.tokens);
   if (tokens) {
@@ -1163,6 +1192,22 @@ function createSandboxChatProducer(options) {
     source = options.events;
   }
   const servingModel = () => failover?.servingModel() ?? options.model;
+  let effectiveBackend;
+  let substitutionNoticeQueued = false;
+  const servedModel = () => effectiveBackend?.servedModel ?? servingModel();
+  const captureEffectiveBackend = (data) => {
+    if (!data) return;
+    const parsed = parseEffectiveBackend(data);
+    if (!parsed) return;
+    effectiveBackend = parsed;
+    const sentModel = servingModel();
+    if (substitutionNoticeQueued || !options.model || !sentModel || !parsed.servedModel || parsed.servedModel === sentModel) return;
+    substitutionNoticeQueued = true;
+    pendingModelNotices.push({
+      id: "model-substitution-1",
+      text: `Requested ${sentModel} \u2014 the sandbox answered with ${parsed.servedModel} instead.`
+    });
+  };
   let fullText = "";
   const partOrder = [];
   const partMap = /* @__PURE__ */ new Map();
@@ -1220,8 +1265,9 @@ function createSandboxChatProducer(options) {
   async function* stream() {
     try {
       for await (const raw of source) {
-        yield* drainModelNotices();
         const record = asRecord(raw);
+        captureEffectiveBackend(asRecord(record?.data));
+        yield* drainModelNotices();
         if (!record || typeof record.type !== "string") continue;
         const normalized = normalizeToolEvent({ type: record.type, data: asRecord(record.data) });
         const event = normalized.type === "message.part.updated" ? normalized : { type: record.type, data: asRecord(record.data) };
@@ -1487,12 +1533,17 @@ ${diagnostic.userMessage}` : diagnostic.userMessage;
     // model into the row and make a downgrade unattributable — the exact
     // failure mode this work exists to prevent.
     get model() {
-      return servingModel();
+      return servedModel();
     },
     modelFailover: () => ({
       model: servingModel(),
       attempts: failover?.attempts() ?? [],
       usedFallback: failover?.usedFallback() ?? false
+    }),
+    modelAttribution: () => ({
+      ...options.model ? { requestedModel: options.model } : {},
+      ...effectiveBackend ?? {},
+      echoReceived: effectiveBackend !== void 0
     })
   };
 }
@@ -1544,10 +1595,23 @@ async function runDetachedTurn(opts) {
     });
   }
   const settleRow = async (base) => {
+    const persisted = !producer && opts.persist ? (await opts.persist.store.listMessages(opts.persist.threadId)).find(
+      (message) => message.id === (opts.persist?.messageId ?? assistantRowIdForTurn(turnId))
+    ) : void 0;
     const info = producer?.modelFailover?.();
+    const attribution = producer?.modelAttribution?.();
+    const model = producer?.model ?? persisted?.model ?? opts.model;
+    const requestedModel = attribution?.requestedModel ?? persisted?.requestedModel ?? opts.model;
+    const servedModel = attribution?.servedModel ?? persisted?.servedModel;
+    const servedProvider = attribution?.servedProvider ?? persisted?.servedProvider;
+    const servedSource = attribution?.servedSource ?? (persisted?.servedSource === "request" || persisted?.servedSource === "environment" || persisted?.servedSource === "profile" ? persisted.servedSource : void 0);
     const result = {
       ...base,
-      ...servingModel() ? { model: servingModel() } : {},
+      ...model ? { model } : {},
+      ...requestedModel ? { requestedModel } : {},
+      ...servedModel ? { servedModel } : {},
+      ...servedProvider ? { servedProvider } : {},
+      ...servedSource ? { servedSource } : {},
       ...info ? { usedModelFallback: info.usedFallback, modelAttempts: info.attempts } : {}
     };
     if (!draft) return result;
@@ -1567,6 +1631,10 @@ async function runDetachedTurn(opts) {
       content,
       ...parts2.length > 0 ? { parts: parts2 } : {},
       ...result.model ? { model: result.model } : {},
+      ...result.requestedModel ? { requestedModel: result.requestedModel } : {},
+      ...result.servedModel ? { servedModel: result.servedModel } : {},
+      ...result.servedProvider ? { servedProvider: result.servedProvider } : {},
+      ...result.servedSource ? { servedSource: result.servedSource } : {},
       ...result.usage.inputTokens !== void 0 ? { inputTokens: result.usage.inputTokens } : {},
       ...result.usage.outputTokens !== void 0 ? { outputTokens: result.usage.outputTokens } : {},
       ...result.usage.reasoningTokens !== void 0 ? { reasoningTokens: result.usage.reasoningTokens } : {},