@truefoundry/assistant-ui-runtime 0.1.7 → 0.1.9

package/dist/chunk-SQDOTGP2.js

@@ -1,292 +0,0 @@
-// src/plugins/truefoundry-agent-server-adapter/index.ts
-import { AgentSessionClient } from "truefoundry-gateway-sdk/agents";
-import { PrivateAgentSessionClient } from "truefoundry-gateway-sdk/agents/private";
-
-// src/plugins/truefoundry-agent-server-adapter/guards.ts
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
-}
-function hasNumbers(value, keys) {
-  return isRecord(value) && keys.every((key) => typeof value[key] === "number");
-}
-function isTfySystemToolInfo(toolInfo) {
-  return isRecord(toolInfo) && toolInfo.type === "truefoundry-system" && typeof toolInfo.name === "string";
-}
-function isTfyMcpToolInfo(toolInfo) {
-  return isRecord(toolInfo) && toolInfo.type === "mcp" && typeof toolInfo.name === "string" && typeof toolInfo.serverId === "string" && typeof toolInfo.serverName === "string";
-}
-function isTfyToolInfo(toolInfo) {
-  return isTfySystemToolInfo(toolInfo) || isTfyMcpToolInfo(toolInfo);
-}
-var USAGE_BREAKDOWN_KEYS = [
-  "harness",
-  "skills",
-  "instructions",
-  "toolDefinitions",
-  "messages"
-];
-function getTfyUsage(source) {
-  const usage = source?.usage;
-  if (!hasNumbers(usage, ["inputTokens", "outputTokens"])) {
-    return void 0;
-  }
-  if (!hasNumbers(usage.inputTokensBreakdown, USAGE_BREAKDOWN_KEYS)) {
-    return void 0;
-  }
-  return usage;
-}
-function getTfyThreadState(event) {
-  const state = event?.state;
-  if (!isRecord(state)) {
-    return void 0;
-  }
-  if (state.status === "done" && isRecord(state.output)) {
-    return state;
-  }
-  if (state.status === "error" && typeof state.error === "string") {
-    return state;
-  }
-  return void 0;
-}
-function getTfyMcpInitServers(event) {
-  const servers = event?.mcpServers;
-  if (!Array.isArray(servers)) {
-    return void 0;
-  }
-  const valid = servers.every(
-    (server) => isRecord(server) && typeof server.id === "string" && typeof server.name === "string"
-  );
-  return valid ? servers : void 0;
-}
-
-// src/plugins/truefoundry-agent-server-adapter/index.ts
-function isNotFound(error) {
-  return typeof error === "object" && error !== null && error.statusCode === 404;
-}
-function isDraft(session) {
-  return session.type === "session/draft";
-}
-function toSession(raw) {
-  const mutable = isDraft(raw);
-  return {
-    id: raw.id,
-    title: raw.title,
-    agentName: raw.agentName,
-    ...mutable ? { agentSpec: raw.agentSpec } : {},
-    isMutable: mutable,
-    createdBySubject: raw.createdBySubject,
-    createdAt: raw.createdAt,
-    updatedAt: raw.updatedAt
-  };
-}
-function toTurn(raw) {
-  return {
-    id: raw.id,
-    sessionId: raw.sessionId,
-    previousTurnId: raw.previousTurnId,
-    input: raw.input,
-    state: raw.state,
-    createdBySubject: raw.createdBySubject,
-    createdAt: raw.createdAt
-  };
-}
-async function toListResult(page, map) {
-  const nextPageToken = page.response?.pagination?.nextPageToken;
-  return {
-    data: page.data.map(map),
-    ...nextPageToken != null && nextPageToken !== "" ? { nextPageToken } : {}
-  };
-}
-function createTrueFoundryChatServer(opts) {
-  const gatewayOpts = { apiKey: opts.apiKey, baseUrl: opts.baseUrl };
-  const client = opts.client ?? new AgentSessionClient(gatewayOpts);
-  const privateClient = opts.privateClient ?? new PrivateAgentSessionClient(gatewayOpts);
-  const sessionTypeCache = /* @__PURE__ */ new Map();
-  const sessionTypeProbes = /* @__PURE__ */ new Map();
-  function cacheSessionType(session) {
-    sessionTypeCache.set(session.id, session.isMutable);
-  }
-  async function probeSessionType(sessionId) {
-    const inflight = sessionTypeProbes.get(sessionId);
-    if (inflight != null) {
-      return inflight;
-    }
-    const probe = (async () => {
-      try {
-        await privateClient.getDraftSession({ draftSessionId: sessionId });
-        return true;
-      } catch (error) {
-        if (!isNotFound(error)) {
-          throw error;
-        }
-        await client.getSession({ sessionId });
-        return false;
-      }
-    })();
-    sessionTypeProbes.set(sessionId, probe);
-    try {
-      const isMutable = await probe;
-      sessionTypeCache.set(sessionId, isMutable);
-      return isMutable;
-    } finally {
-      sessionTypeProbes.delete(sessionId);
-    }
-  }
-  async function getSessionObj(sessionId) {
-    const isMutable = sessionTypeCache.get(sessionId) ?? await probeSessionType(sessionId);
-    return isMutable ? privateClient.getDraftSession({ draftSessionId: sessionId }) : client.getSession({ sessionId });
-  }
-  const server = {
-    async createSession(req) {
-      if (req.agentSpec != null) {
-        const draft = await privateClient.createDraftSession({
-          agentSpec: req.agentSpec,
-          ...req.agentName != null ? { agentName: req.agentName } : {},
-          ...req.tfyMetadata != null ? { tfyMetadata: req.tfyMetadata } : {}
-        });
-        const session = toSession(draft);
-        cacheSessionType(session);
-        return session;
-      }
-      if (req.agentName != null) {
-        const named = await client.createSession({
-          agentName: req.agentName,
-          ...req.tfyMetadata != null ? { tfyMetadata: req.tfyMetadata } : {}
-        });
-        const session = toSession(named);
-        cacheSessionType(session);
-        return session;
-      }
-      throw new Error("createSession requires agentName and/or agentSpec");
-    },
-    async listSessions(req) {
-      const page = await privateClient.listOwnedSessions({
-        limit: req?.limit,
-        order: req?.order,
-        pageToken: req?.pageToken,
-        startTimestamp: req?.startTimestamp,
-        endTimestamp: req?.endTimestamp,
-        ...req?.agentName != null ? { agentName: req.agentName } : {}
-      });
-      const result = await toListResult(page, (s) => toSession(s));
-      for (const session of result.data) {
-        cacheSessionType(session);
-      }
-      return result;
-    },
-    async getSession({ sessionId }) {
-      const raw = await getSessionObj(sessionId);
-      const session = toSession(raw);
-      cacheSessionType(session);
-      return session;
-    },
-    async updateSession(req) {
-      const raw = await getSessionObj(req.sessionId);
-      if (!isDraft(raw)) {
-        throw new Error(
-          "updateSession: session is not mutable (isMutable=false)"
-        );
-      }
-      if (req.agentSpec != null) {
-        await raw.update({ agentSpec: req.agentSpec });
-      }
-      return toSession(raw);
-    },
-    prepareAndExecuteTurn(req) {
-      return (async function* () {
-        const session = await getSessionObj(req.sessionId);
-        const prepared = session.prepareTurn({
-          input: req.input,
-          previousTurnId: req.previousTurnId ?? "auto"
-        });
-        yield* prepared.execute(
-          { stream: true },
-          {
-            ...req.abortSignal != null ? { abortSignal: req.abortSignal } : {},
-            ...req.headers != null ? { headers: req.headers } : {}
-          }
-        );
-      })();
-    },
-    async cancelSession({ sessionId }) {
-      await (await getSessionObj(sessionId)).cancel();
-    },
-    async deleteSession({ sessionId }) {
-      if (opts.deleteSession == null) {
-        throw new Error(
-          "deleteSession is not on the gateway SDK. Pass deleteSession to createTrueFoundryChatServer."
-        );
-      }
-      await opts.deleteSession({ sessionId });
-    },
-    // The runtime's signature offers `order`, but the gateway's listTurns
-    // takes no such param — forwarding it silently did nothing.
-    async listTurns({ sessionId, limit, pageToken }) {
-      const raw = await getSessionObj(sessionId);
-      const page = await raw.listTurns({
-        ...limit != null ? { limit } : {},
-        ...pageToken != null ? { pageToken } : {}
-      });
-      return toListResult(page, (turn) => toTurn(turn));
-    },
-    async getTurn({ sessionId, turnId }) {
-      const raw = await getSessionObj(sessionId);
-      return toTurn(await raw.getTurn({ turnId }));
-    },
-    async listEvents({ sessionId, pageToken, lastTurnId, limit }) {
-      const raw = await getSessionObj(sessionId);
-      const page = await raw.listEvents({
-        ...limit != null ? { limit } : {},
-        ...pageToken != null ? { pageToken } : {},
-        ...lastTurnId != null ? { lastTurnId } : {}
-      });
-      return toListResult(
-        page,
-        (item) => item
-      );
-    },
-    async listTurnEvents({ sessionId, turnId, limit, pageToken, order }) {
-      const raw = await getSessionObj(sessionId);
-      const turn = await raw.getTurn({ turnId });
-      const page = await turn.listEvents({
-        ...limit != null ? { limit } : {},
-        ...pageToken != null ? { pageToken } : {},
-        ...order != null ? { order } : {}
-      });
-      return toListResult(page, (event) => event);
-    },
-    async *subscribeToTurn({
-      sessionId,
-      turnId,
-      afterSequenceNumber,
-      abortSignal
-    }) {
-      const raw = await getSessionObj(sessionId);
-      const turn = await raw.getTurn({ turnId });
-      yield* turn.stream(
-        afterSequenceNumber != null ? { afterSequenceNumber } : {},
-        abortSignal != null ? { abortSignal } : {}
-      );
-    },
-    async downloadSandboxFile(sandboxId, req) {
-      const response = await privateClient.downloadSandboxFile(
-        sandboxId,
-        req
-      );
-      return await response.blob();
-    },
-    getGatewayClients: () => ({ client, privateClient })
-  };
-  return server;
-}
-
-export {
-  isTfySystemToolInfo,
-  isTfyMcpToolInfo,
-  isTfyToolInfo,
-  getTfyUsage,
-  getTfyThreadState,
-  getTfyMcpInitServers,
-  createTrueFoundryChatServer
-};
-//# sourceMappingURL=chunk-SQDOTGP2.js.map

package/dist/chunk-SQDOTGP2.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/plugins/truefoundry-agent-server-adapter/index.ts","../src/plugins/truefoundry-agent-server-adapter/guards.ts"],"sourcesContent":["import { AgentSessionClient } from \"truefoundry-gateway-sdk/agents\";\nimport type { AgentSession } from \"truefoundry-gateway-sdk/agents\";\nimport { PrivateAgentSessionClient } from \"truefoundry-gateway-sdk/agents/private\";\nimport type { AgentDraftSession } from \"truefoundry-gateway-sdk/agents/private\";\nimport type {\n    AgentChatServer,\n    ListResult,\n    TurnInputItem,\n    PreviousTurnIdInput,\n    UpdateSessionRequest,\n} from \"../../server/types.js\";\nimport type {\n    SessionEventItem,\n    TurnEvent,\n    TurnStreamData,\n} from \"../../server/events.js\";\nimport type {\n    TfyAgentSpec,\n    TfyCreateSessionRequest,\n    TfyListSessionsParams,\n    TfySession,\n    TfyTurn,\n    TfyTurnState,\n} from \"./types.js\";\n\nexport {\n    type TfyAgentSpec,\n    type TfySkillMount,\n    type TfyMcpServerMount,\n    type TfyModelParams,\n    type TfyRuntimeConfig,\n    type TfyResponseFormat,\n    type TfySubject,\n    type ToolsSelectorItem,\n    type ToolsSelectorTag,\n    type RequireApprovalToolSelectorItem,\n    type RequireApprovalToolsSelectorTag,\n    type TfyTurn,\n    type TfyTurnState,\n    type TfyTurnCancelledReason,\n    type TfyTurnStateDoneOutput,\n    type TfySession,\n    type TfyCreateSessionRequest,\n    type TfyListSessionsParams,\n    type TfyToolInfo,\n    type TfySystemToolInfo,\n    type TfyMcpToolInfo,\n    type TfyModelMessageUsage,\n    type TfyFinishReason,\n    type TfyThreadState,\n    type TfyMcpServerInitInfo,\n} from \"./types.js\";\n\nexport {\n    isTfyToolInfo,\n    isTfySystemToolInfo,\n    isTfyMcpToolInfo,\n    getTfyUsage,\n    getTfyThreadState,\n    getTfyMcpInitServers,\n} from \"./guards.js\";\n\ntype GwSession = AgentSession | AgentDraftSession;\n\nexport type CreateTrueFoundryChatServerOptions = {\n    apiKey: string;\n    baseUrl: string;\n    /** Optional override — otherwise constructed from apiKey/baseUrl. */\n    client?: AgentSessionClient;\n    privateClient?: PrivateAgentSessionClient;\n    deleteSession?: (req: { sessionId: string }) => Promise<void>;\n};\n\n/**\n * Only the spec is generic. Session/Turn/list-params are the concrete Tfy*\n * types because the adapter builds them as fixed object literals — a generic\n * there would type fields that nothing ever populates. The spec is safe: the\n * gateway SDK serializes with `unrecognizedObjectKeys: \"passthrough\"`, so\n * host-added spec fields survive the round trip.\n */\nexport type TrueFoundryChatServer<TSpec extends TfyAgentSpec = TfyAgentSpec> =\n    AgentChatServer<\n        TSpec,\n        TfySession<TSpec>,\n        TfyCreateSessionRequest<TSpec>,\n        TfyListSessionsParams,\n        UpdateSessionRequest<TSpec>,\n        TfyTurn\n    > & {\n        /** Escape hatch for hosts that still need raw gateway clients. */\n        getGatewayClients(): {\n            client: AgentSessionClient;\n            privateClient: PrivateAgentSessionClient;\n        };\n    };\n\n/** Gateway SDK errors carry the HTTP status as `statusCode`. */\nfunction isNotFound(error: unknown): boolean {\n    return (\n        typeof error === \"object\" &&\n        error !== null &&\n        (error as { statusCode?: unknown }).statusCode === 404\n    );\n}\n\nfunction isDraft(session: GwSession): session is AgentDraftSession {\n    return (session as AgentDraftSession).type === \"session/draft\";\n}\n\nfunction toSession<TSpec extends TfyAgentSpec>(raw: GwSession): TfySession<TSpec> {\n    const mutable = isDraft(raw);\n    return {\n        id: raw.id,\n        title: raw.title,\n        agentName: raw.agentName,\n        ...(mutable ? { agentSpec: raw.agentSpec as TSpec } : {}),\n        isMutable: mutable,\n        createdBySubject: raw.createdBySubject,\n        createdAt: raw.createdAt,\n        updatedAt: raw.updatedAt,\n    };\n}\n\nfunction toTurn(raw: {\n    id: string;\n    sessionId: string;\n    previousTurnId?: string | null;\n    input?: TurnInputItem[];\n    state: unknown;\n    createdBySubject: TfyTurn[\"createdBySubject\"];\n    createdAt: string;\n}): TfyTurn {\n    return {\n        id: raw.id,\n        sessionId: raw.sessionId,\n        previousTurnId: raw.previousTurnId,\n        input: raw.input,\n        state: raw.state as TfyTurnState,\n        createdBySubject: raw.createdBySubject,\n        createdAt: raw.createdAt,\n    };\n}\n\nasync function toListResult<TIn, TOut>(\n    page: {\n        data: TIn[];\n        response?: { pagination?: { nextPageToken?: string } };\n        hasNextPage?: () => boolean;\n    },\n    map: (item: TIn) => TOut,\n): Promise<ListResult<TOut>> {\n    const nextPageToken = page.response?.pagination?.nextPageToken;\n    return {\n        data: page.data.map(map),\n        ...(nextPageToken != null && nextPageToken !== \"\"\n            ? { nextPageToken }\n            : {}),\n    };\n}\n\n/**\n * Wraps TrueFoundry gateway clients into a flat `AgentChatServer`.\n * Named vs draft routing is fully internal — an in-memory session-type cache\n * (populated by createSession/listSessions) determines which gateway client\n * to call, falling back to a one-time probe for ids seen only in a URL.\n */\nexport function createTrueFoundryChatServer<\n    TSpec extends TfyAgentSpec = TfyAgentSpec,\n>(\n    opts: CreateTrueFoundryChatServerOptions,\n): TrueFoundryChatServer<TSpec> {\n    const gatewayOpts = { apiKey: opts.apiKey, baseUrl: opts.baseUrl };\n    const client = opts.client ?? new AgentSessionClient(gatewayOpts);\n    const privateClient =\n        opts.privateClient ?? new PrivateAgentSessionClient(gatewayOpts);\n\n    const sessionTypeCache = new Map<string, boolean>();\n    const sessionTypeProbes = new Map<string, Promise<boolean>>();\n\n    function cacheSessionType(session: {\n        id: string;\n        isMutable: boolean;\n    }): void {\n        sessionTypeCache.set(session.id, session.isMutable);\n    }\n\n    /**\n     * Resolving a session id straight from a URL (page reload / shared link)\n     * reaches the gateway before createSession or listSessions has cached the\n     * type, so discover it by probing the draft endpoint and falling back to\n     * the conversation endpoint. Concurrent callers share one probe.\n     */\n    async function probeSessionType(sessionId: string): Promise<boolean> {\n        const inflight = sessionTypeProbes.get(sessionId);\n        if (inflight != null) {\n            return inflight;\n        }\n        const probe = (async () => {\n            try {\n                await privateClient.getDraftSession({ draftSessionId: sessionId });\n                return true;\n            } catch (error) {\n                // Only a miss proves the id isn't a draft. Auth or transient\n                // failures would otherwise be retried as a conversation session\n                // and mislabel a real draft as named.\n                if (!isNotFound(error)) {\n                    throw error;\n                }\n                await client.getSession({ sessionId });\n                return false;\n            }\n        })();\n        sessionTypeProbes.set(sessionId, probe);\n        try {\n            const isMutable = await probe;\n            sessionTypeCache.set(sessionId, isMutable);\n            return isMutable;\n        } finally {\n            sessionTypeProbes.delete(sessionId);\n        }\n    }\n\n    async function getSessionObj(sessionId: string): Promise<GwSession> {\n        const isMutable =\n            sessionTypeCache.get(sessionId) ?? (await probeSessionType(sessionId));\n        return isMutable\n            ? privateClient.getDraftSession({ draftSessionId: sessionId })\n            : client.getSession({ sessionId });\n    }\n\n    const server: TrueFoundryChatServer<TSpec> = {\n        async createSession(req) {\n            if (req.agentSpec != null) {\n                const draft = await privateClient.createDraftSession({\n                    agentSpec: req.agentSpec,\n                    ...(req.agentName != null ? { agentName: req.agentName } : {}),\n                    ...(req.tfyMetadata != null\n                        ? { tfyMetadata: req.tfyMetadata }\n                        : {}),\n                });\n                const session = toSession<TSpec>(draft);\n                cacheSessionType(session);\n                return session;\n            }\n            if (req.agentName != null) {\n                const named = await client.createSession({\n                    agentName: req.agentName,\n                    ...(req.tfyMetadata != null\n                        ? { tfyMetadata: req.tfyMetadata }\n                        : {}),\n                });\n                const session = toSession<TSpec>(named);\n                cacheSessionType(session);\n                return session;\n            }\n            throw new Error(\"createSession requires agentName and/or agentSpec\");\n        },\n\n        async listSessions(req) {\n            const page = await privateClient.listOwnedSessions({\n                limit: req?.limit,\n                order: req?.order,\n                pageToken: req?.pageToken,\n                startTimestamp: req?.startTimestamp,\n                endTimestamp: req?.endTimestamp,\n                ...(req?.agentName != null ? { agentName: req.agentName } : {}),\n            });\n            const result = await toListResult(page, (s) => toSession<TSpec>(s));\n            for (const session of result.data) {\n                cacheSessionType(session);\n            }\n            return result;\n        },\n\n        async getSession({ sessionId }) {\n            const raw = await getSessionObj(sessionId);\n            const session = toSession<TSpec>(raw);\n            cacheSessionType(session);\n            return session;\n        },\n\n        async updateSession(req) {\n            const raw = await getSessionObj(req.sessionId);\n            if (!isDraft(raw)) {\n                throw new Error(\n                    \"updateSession: session is not mutable (isMutable=false)\",\n                );\n            }\n            if (req.agentSpec != null) {\n                await raw.update({ agentSpec: req.agentSpec });\n            }\n            return toSession<TSpec>(raw);\n        },\n\n        prepareAndExecuteTurn(req: {\n            sessionId: string;\n            input?: TurnInputItem[];\n            previousTurnId?: PreviousTurnIdInput;\n            abortSignal?: AbortSignal;\n            headers?: Record<string, string>;\n        }): AsyncIterable<TurnStreamData> {\n            return (async function* () {\n                const session = await getSessionObj(req.sessionId);\n                const prepared = session.prepareTurn({\n                    input: req.input,\n                    previousTurnId: req.previousTurnId ?? \"auto\",\n                });\n                yield* prepared.execute(\n                    { stream: true },\n                    {\n                        ...(req.abortSignal != null\n                            ? { abortSignal: req.abortSignal }\n                            : {}),\n                        ...(req.headers != null ? { headers: req.headers } : {}),\n                    },\n                ) as AsyncIterable<TurnStreamData>;\n            })();\n        },\n\n        async cancelSession({ sessionId }) {\n            await (await getSessionObj(sessionId)).cancel();\n        },\n\n        async deleteSession({ sessionId }) {\n            if (opts.deleteSession == null) {\n                throw new Error(\n                    \"deleteSession is not on the gateway SDK. Pass deleteSession to createTrueFoundryChatServer.\",\n                );\n            }\n            await opts.deleteSession({ sessionId });\n        },\n\n        // The runtime's signature offers `order`, but the gateway's listTurns\n        // takes no such param — forwarding it silently did nothing.\n        async listTurns({ sessionId, limit, pageToken }) {\n            const raw = await getSessionObj(sessionId);\n            const page = await raw.listTurns({\n                ...(limit != null ? { limit } : {}),\n                ...(pageToken != null ? { pageToken } : {}),\n            });\n            return toListResult(page, (turn) => toTurn(turn));\n        },\n\n        async getTurn({ sessionId, turnId }) {\n            const raw = await getSessionObj(sessionId);\n            return toTurn(await raw.getTurn({ turnId }));\n        },\n\n        async listEvents({ sessionId, pageToken, lastTurnId, limit }) {\n            const raw = await getSessionObj(sessionId);\n            const page = await raw.listEvents({\n                ...(limit != null ? { limit } : {}),\n                ...(pageToken != null ? { pageToken } : {}),\n                ...(lastTurnId != null ? { lastTurnId } : {}),\n            });\n            return toListResult(\n                page,\n                (item) => item as SessionEventItem,\n            );\n        },\n\n        async listTurnEvents({ sessionId, turnId, limit, pageToken, order }) {\n            const raw = await getSessionObj(sessionId);\n            const turn = await raw.getTurn({ turnId });\n            const page = await turn.listEvents({\n                ...(limit != null ? { limit } : {}),\n                ...(pageToken != null ? { pageToken } : {}),\n                ...(order != null ? { order } : {}),\n            });\n            return toListResult(page, (event) => event as TurnEvent);\n        },\n\n        async *subscribeToTurn({\n            sessionId,\n            turnId,\n            afterSequenceNumber,\n            abortSignal,\n        }) {\n            const raw = await getSessionObj(sessionId);\n            const turn = await raw.getTurn({ turnId });\n            yield* turn.stream(\n                afterSequenceNumber != null ? { afterSequenceNumber } : {},\n                abortSignal != null ? { abortSignal } : {},\n            ) as AsyncIterable<TurnStreamData>;\n        },\n\n        async downloadSandboxFile(sandboxId, req) {\n            const response = await privateClient.downloadSandboxFile(\n                sandboxId,\n                req,\n            );\n            return await response.blob();\n        },\n\n        getGatewayClients: () => ({ client, privateClient }),\n    };\n\n    return server;\n}\n","/**\n * Point-of-use narrowing for the event half of the gateway protocol.\n *\n * `AgentChatServer` hardcodes the runtime's event types on listEvents,\n * listTurnEvents, subscribeToTurn and prepareAndExecuteTurn — there is no\n * generic to override them from here. So instead of typing those channels,\n * hosts call these guards on the values they receive.\n *\n * They validate rather than cast: this data comes off the network, and the\n * runtime types the relevant fields as `unknown` precisely because nothing\n * has checked them yet.\n */\n\nimport type {\n    TfyMcpServerInitInfo,\n    TfyMcpToolInfo,\n    TfyModelMessageUsage,\n    TfySystemToolInfo,\n    TfyThreadState,\n    TfyToolInfo,\n} from \"./types.js\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return typeof value === \"object\" && value !== null;\n}\n\nfunction hasNumbers<K extends string>(\n    value: unknown,\n    keys: readonly K[],\n): value is Record<string, unknown> & Record<K, number> {\n    return isRecord(value) && keys.every((key) => typeof value[key] === \"number\");\n}\n\n/**\n * Identifies built-in tools such as `ask_user_question` and `create_sub_agent`.\n * Note `toolInfo` is legitimately absent on streamed deltas, so callers must\n * keep their `function.name` fallback rather than treating absence as an error.\n */\nexport function isTfySystemToolInfo(\n    toolInfo: unknown,\n): toolInfo is TfySystemToolInfo {\n    return (\n        isRecord(toolInfo) &&\n        toolInfo.type === \"truefoundry-system\" &&\n        typeof toolInfo.name === \"string\"\n    );\n}\n\n/** Carries `serverId` / `serverName`, so the UI can attribute a call to its MCP server. */\nexport function isTfyMcpToolInfo(toolInfo: unknown): toolInfo is TfyMcpToolInfo {\n    return (\n        isRecord(toolInfo) &&\n        toolInfo.type === \"mcp\" &&\n        typeof toolInfo.name === \"string\" &&\n        typeof toolInfo.serverId === \"string\" &&\n        typeof toolInfo.serverName === \"string\"\n    );\n}\n\nexport function isTfyToolInfo(toolInfo: unknown): toolInfo is TfyToolInfo {\n    return isTfySystemToolInfo(toolInfo) || isTfyMcpToolInfo(toolInfo);\n}\n\nconst USAGE_BREAKDOWN_KEYS = [\n    \"harness\",\n    \"skills\",\n    \"instructions\",\n    \"toolDefinitions\",\n    \"messages\",\n] as const;\n\n/**\n * Token usage including the TrueFoundry-specific `inputTokensBreakdown`, which\n * attributes input tokens across harness, skills, instructions, tool\n * definitions and messages.\n */\nexport function getTfyUsage(\n    source: { usage?: unknown } | null | undefined,\n): TfyModelMessageUsage | undefined {\n    const usage = source?.usage;\n    if (!hasNumbers(usage, [\"inputTokens\", \"outputTokens\"])) {\n        return undefined;\n    }\n    if (!hasNumbers(usage.inputTokensBreakdown, USAGE_BREAKDOWN_KEYS)) {\n        return undefined;\n    }\n    return usage as unknown as TfyModelMessageUsage;\n}\n\n/**\n * Completion state of a sub-agent thread. The runtime types `thread.done`'s\n * `state` as `unknown`, so a sub-agent that errored is otherwise\n * indistinguishable from one that succeeded.\n */\nexport function getTfyThreadState(\n    event: { state?: unknown } | null | undefined,\n): TfyThreadState | undefined {\n    const state = event?.state;\n    if (!isRecord(state)) {\n        return undefined;\n    }\n    if (state.status === \"done\" && isRecord(state.output)) {\n        return state as unknown as TfyThreadState;\n    }\n    if (state.status === \"error\" && typeof state.error === \"string\") {\n        return state as unknown as TfyThreadState;\n    }\n    return undefined;\n}\n\n/**\n * Servers from an `mcp.initialize` event, including each one's `transportType`.\n * The runtime models this event with an index signature, so the array is\n * `unknown` until checked.\n */\nexport function getTfyMcpInitServers(\n    event: { mcpServers?: unknown } | null | undefined,\n): TfyMcpServerInitInfo[] | undefined {\n    const servers = event?.mcpServers;\n    if (!Array.isArray(servers)) {\n        return undefined;\n    }\n    const valid = servers.every(\n        (server) =>\n            isRecord(server) &&\n            typeof server.id === \"string\" &&\n            typeof server.name === \"string\",\n    );\n    return valid ? (servers as TfyMcpServerInitInfo[]) : undefined;\n}\n"],"mappings":"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","names":[]}