@teaflask/assistant 0.7.1 → 0.8.0

package/README.md

@@ -63,7 +63,7 @@ import { TeaflaskAssistant } from "@teaflask/assistant";
 
 ## What your agent can do
 
-- **Take actions.** It calls your API on the user's behalf, with the user's own session. You set every action to Allow, Ask or Deny.
+- **Take actions.** It calls your API on the user's behalf, with the user's own session. You set every action to Allow, Ask or Deny. On a [GraphQL](https://docs.teaflask.com/adapters#graphql) API, it runs them through your app's own client.
 - **Follow your workflows.** Write a procedure once, like how refunds work or when to escalate, and the agent follows it.
 - **Guide users around your app.** It takes people to the right page and highlights what to click.
 - **Fill in forms.** It fills the fields; the user reviews and submits.

package/dist/components/tool-views/action-values.js

@@ -0,0 +1,43 @@
+import { prettyPrintParameters } from "../pretty-print.js";
+import { CARD_BLOCK_CLASS } from "./parts-classes.js";
+import { el, factRows, recordOf, scrollRegion } from "./view-dom.js";
+const VALUE_PANE_CLASS = "tf:m-0 tf:whitespace-pre-wrap tf:font-mono tf:text-xs tf:text-tf-card-foreground";
+export function valueRows(value) {
+    const record = recordOf(value);
+    if (record !== null) {
+        return scrollRegion([
+            factRows(Object.entries(record).map(([key, entry]) => [key, _valueOf(entry)])),
+        ]);
+    }
+    return valueBlock(value);
+}
+export function valueBlock(value) {
+    const wrapper = el("div", CARD_BLOCK_CLASS);
+    wrapper.dataset.tfActionValueBlock = "";
+    wrapper.append(el("pre", VALUE_PANE_CLASS, prettyPrintParameters(value)));
+    return scrollRegion([wrapper]);
+}
+function _valueOf(value) {
+    if (typeof value === "string") {
+        return value === "" ? "—" : value;
+    }
+    if (typeof value === "number" ||
+        typeof value === "boolean" ||
+        typeof value === "bigint") {
+        return String(value);
+    }
+    if (value === null || value === undefined) {
+        return "—";
+    }
+    return el("pre", VALUE_PANE_CLASS, prettyPrintParameters(value));
+}
+export function statusBadgeOf(status) {
+    const badge = el("span", status >= 400
+        ? "tf:font-medium tf:text-tf-destructive"
+        : "tf:text-tf-muted-foreground", `HTTP ${String(status)}`);
+    badge.dataset.tfActionStatus = String(status);
+    return badge;
+}
+export function isEmptyBody(body) {
+    return body === undefined || body === null || body === "";
+}

package/dist/components/tool-views/action-view.js

@@ -1,12 +1,10 @@
-import { prettyPrintParameters } from "../pretty-print.js";
-import { CARD_BLOCK_CLASS } from "./parts-classes.js";
-import { actionEnvelopeOf, actionFailureOf, captionRow, card, el, factRows, note, recordOf, scrollRegion, settledOutcomeNotesOf, settledWithResult, statelessToolView, } from "./view-dom.js";
+import { isEmptyBody, statusBadgeOf, valueRows } from "./action-values.js";
+import { actionEnvelopeOf, actionFailureOf, captionRow, card, el, factRows, note, recordOf, settledOutcomeNotesOf, settledWithResult, statelessToolView, } from "./view-dom.js";
 const REQUEST_SECTIONS = [
     ["path_params", "Path parameters"],
     ["query", "Query"],
     ["body", "Body"],
 ];
-const VALUE_PANE_CLASS = "tf:m-0 tf:whitespace-pre-wrap tf:font-mono tf:text-xs tf:text-tf-card-foreground";
 export const actionToolView = statelessToolView(_renderAction);
 function _renderAction({ call }) {
     const root = el("div", "tf:flex tf:flex-col tf:gap-2");
@@ -21,7 +19,7 @@ function _renderAction({ call }) {
         if (record !== null && Object.keys(record).length === 0) {
             continue;
         }
-        sections.push(captionRow(label), _valueRows(value));
+        sections.push(captionRow(label), valueRows(value));
     }
     if (sections.length > 0) {
         root.append(card(sections));
@@ -52,32 +50,6 @@ function _appendFieldProblems(root, call) {
     }
     root.append(card(parts));
 }
-function _valueRows(value) {
-    const record = recordOf(value);
-    if (record !== null) {
-        return scrollRegion([
-            factRows(Object.entries(record).map(([key, entry]) => [key, _valueOf(entry)])),
-        ]);
-    }
-    const wrapper = el("div", CARD_BLOCK_CLASS);
-    wrapper.dataset.tfActionValueBlock = "";
-    wrapper.append(el("pre", VALUE_PANE_CLASS, prettyPrintParameters(value)));
-    return scrollRegion([wrapper]);
-}
-function _valueOf(value) {
-    if (typeof value === "string") {
-        return value === "" ? "—" : value;
-    }
-    if (typeof value === "number" ||
-        typeof value === "boolean" ||
-        typeof value === "bigint") {
-        return String(value);
-    }
-    if (value === null || value === undefined) {
-        return "—";
-    }
-    return el("pre", VALUE_PANE_CLASS, prettyPrintParameters(value));
-}
 function _appendResponse(root, call) {
     if (call.resultText === undefined) {
         return;
@@ -88,24 +60,16 @@ function _appendResponse(root, call) {
         return;
     }
     const rows = [];
-    let status;
-    if (envelope.status !== null) {
-        status = el("span", envelope.status >= 400
-            ? "tf:font-medium tf:text-tf-destructive"
-            : "tf:text-tf-muted-foreground", `HTTP ${String(envelope.status)}`);
-        status.dataset.tfActionStatus = String(envelope.status);
-    }
+    const status = envelope.status === null ? undefined : statusBadgeOf(envelope.status);
     rows.push(captionRow(envelope.truncated ? "Response (truncated)" : "Response", status));
     if (envelope.truncated) {
         rows.push(captionRow("The response body was truncated by the client to fit the size cap."));
     }
-    if (envelope.body === undefined ||
-        envelope.body === null ||
-        envelope.body === "") {
+    if (isEmptyBody(envelope.body)) {
         rows.push(captionRow("Empty response body."));
     }
     else {
-        rows.push(_valueRows(envelope.body));
+        rows.push(valueRows(envelope.body));
     }
     root.append(card(rows));
 }

package/dist/components/tool-views/graphql-action-view.js

@@ -0,0 +1,95 @@
+import { prettyPrintParameters } from "../pretty-print.js";
+import { isEmptyBody, statusBadgeOf, valueBlock, valueRows, } from "./action-values.js";
+import { actionEnvelopeOf, captionRow, card, el, factRows, note, recordOf, settledOutcomeNotesOf, scrollRegion, settledWithResult, statelessToolView, } from "./view-dom.js";
+export const graphqlActionToolView = statelessToolView(_renderGraphQLAction);
+function _renderGraphQLAction({ call }) {
+    const root = el("div", "tf:flex tf:flex-col tf:gap-2");
+    root.dataset.tfGraphqlActionView = "";
+    const variables = recordOf(call.args.variables);
+    if (variables !== null && Object.keys(variables).length > 0) {
+        root.append(card([captionRow("Variables"), _valuesOf(variables)]));
+    }
+    root.append(...settledOutcomeNotesOf(call));
+    if (settledWithResult(call)) {
+        _appendResponse(root, call);
+    }
+    return root;
+}
+function _appendResponse(root, call) {
+    const envelope = actionEnvelopeOf(call.resultText);
+    if (envelope === null) {
+        root.append(note("The response couldn't be read as an action result and isn't rendered."));
+        return;
+    }
+    const response = recordOf(envelope.body);
+    const errors = Array.isArray(response?.errors) ? response.errors : [];
+    const graphqlShaped = _readsAsGraphQLResponse(response, errors);
+    const rows = [
+        captionRow(envelope.truncated ? "Response (truncated)" : "Response", _statusOf(envelope.status)),
+    ];
+    if (envelope.truncated) {
+        rows.push(captionRow(_cutSentenceOf(graphqlShaped, errors, response)));
+    }
+    if (response === null || !graphqlShaped) {
+        rows.push(isEmptyBody(envelope.body)
+            ? captionRow("Empty response body.")
+            : valueRows(envelope.body));
+        root.append(card(rows));
+        return;
+    }
+    if (errors.length > 0) {
+        rows.push(_errorsCaption(errors.length), _errorRows(errors));
+    }
+    const hasData = response.data !== null && response.data !== undefined;
+    rows.push(hasData ? captionRow("Data") : captionRow("Data", "none"));
+    if (hasData) {
+        rows.push(_valuesOf(_withoutCutMarker(response.data)));
+    }
+    root.append(card(rows));
+}
+function _readsAsGraphQLResponse(response, errors) {
+    return response !== null && (errors.length > 0 || "data" in response);
+}
+function _statusOf(status) {
+    return status === null || status === 200 ? undefined : statusBadgeOf(status);
+}
+function _cutSentenceOf(graphqlShaped, errors, response) {
+    if (!graphqlShaped || errors.length === 0) {
+        return "Too large to show in full: the response is shortened.";
+    }
+    return typeof response?.data === "string"
+        ? "Too large to show in full: the data is shortened and any other response fields dropped; the errors are complete."
+        : "Too large to show in full: other response fields are dropped; the data and errors are complete.";
+}
+function _errorsCaption(count) {
+    const row = captionRow("");
+    row.replaceChildren(el("span", "tf:font-medium tf:text-tf-destructive", `${String(count)} ${count === 1 ? "error" : "errors"}`));
+    return row;
+}
+function _errorRows(errors) {
+    const rows = factRows(errors.map((error) => {
+        const record = recordOf(error);
+        const path = Array.isArray(record?.path)
+            ? record.path.map(String).join(".")
+            : "";
+        const message = typeof record?.message === "string" && record.message !== ""
+            ? record.message
+            : prettyPrintParameters(error);
+        return [
+            path === "" ? "—" : path.replaceAll(".", ".\u200b"),
+            message,
+        ];
+    }));
+    rows.dataset.tfGraphqlErrors = String(errors.length);
+    return scrollRegion([rows]);
+}
+function _valuesOf(value) {
+    const record = recordOf(value);
+    const flat = record !== null &&
+        Object.values(record).every((entry) => entry === null || typeof entry !== "object");
+    return flat ? valueRows(value) : valueBlock(value);
+}
+const CUT_MARKER = /… \[truncated: [^\]]*\]$/;
+function _withoutCutMarker(data) {
+    return typeof data === "string" ? data.replace(CUT_MARKER, "…") : data;
+}

package/dist/contract/actions-adapter.d.ts

@@ -39,9 +39,41 @@ export interface ActionIntent {
     query: Record<string, unknown>;
     /**
      * The JSON request body; absent when the action sends none. The cookies and
-     * headers adapters send it with Content-Type application/json.
+     * headers adapters send it with Content-Type application/json. For a
+     * GraphQL action it is the standard GraphQL request, {query, operationName,
+     * variables}.
      */
     body?: unknown;
+    /**
+     * Present when the action is an operation of your app's GraphQL API, so a
+     * request adapter can run it through your own GraphQL client; absent for
+     * every other action.
+     */
+    graphql?: ActionIntentGraphQL;
+}
+/**
+ * The GraphQL operation an action runs, one your app's own code defines. Run it
+ * through your app's GraphQL client. Looking it up by operationName among your
+ * app's own operations sends exactly the request your app sends; parsing
+ * document lets a client print it again, which a persisted-query allowlist may
+ * refuse.
+ */
+export interface ActionIntentGraphQL {
+    /** The operation's name in your app's code, such as "RenamePost". */
+    operationName: string;
+    /** Whether the operation is a "query" or a "mutation". */
+    operationType: "query" | "mutation";
+    /**
+     * The operation's GraphQL document as found in your app's code, with every
+     * fragment it uses; a client that sends parsed documents, such as Apollo
+     * Client, can parse and run it.
+     */
+    document: string;
+    /**
+     * The operation's variables, already validated against the action's
+     * variables schema; empty when it takes none.
+     */
+    variables: Record<string, unknown>;
 }
 /**
  * For APIs authenticated by session cookies. The package fetches baseUrl plus
@@ -88,8 +120,10 @@ export interface RequestActionsAdapter {
     kind: "request";
     /**
      * Performs the request and resolves with your API's response body, which
-     * the agent receives with status 200. Reject (for example by throwing on a
-     * non-2xx response) to report the action as failed.
+     * the agent receives with status 200. For a GraphQL action, resolve the
+     * whole GraphQL response, {data, errors}, even when it carries errors.
+     * Reject (for example by throwing on a non-2xx response) to report the
+     * action as failed.
      */
     execute: (intent: ActionIntent) => Promise<unknown>;
 }
@@ -99,6 +133,10 @@ export interface RequestActionsAdapter {
  * actions and tells the user to do them. The response's status and body (parsed
  * as JSON, otherwise text) go back to the agent; a non-2xx status counts as
  * your API's answer, not a failure, and bodies over about 16,000 characters are
- * truncated.
+ * truncated. A GraphQL response that carries errors keeps all of them unless
+ * the errors alone exceed the limit: its other top-level fields such as
+ * extensions are dropped first, and its data is shortened only if it still does
+ * not fit. A GraphQL response without errors is truncated whole, like any other
+ * body.
  */
 export type ActionsAdapter = CookiesActionsAdapter | HeadersActionsAdapter | RequestActionsAdapter;

package/dist/core/tool-view.js

@@ -1,4 +1,5 @@
 import { actionToolView } from "../components/tool-views/action-view.js";
+import { graphqlActionToolView } from "../components/tool-views/graphql-action-view.js";
 import { commandToolView } from "../components/tool-views/command-view.js";
 import { docsSearchToolView } from "../components/tool-views/docs-search-view.js";
 import { fileEditToolView } from "../components/tool-views/file-edit-view.js";
@@ -10,6 +11,7 @@ export function isReservedToolViewKey(key) {
 export const PACKAGE_TOOL_VIEWS = Object.freeze({
     "teaflask.questions": { version: 1, view: questionsToolView },
     "teaflask.action": { version: 1, view: actionToolView },
+    "teaflask.graphql-action": { version: 1, view: graphqlActionToolView },
     "teaflask.command": { version: 1, view: commandToolView },
     "teaflask.file-edit": { version: 1, view: fileEditToolView },
     "teaflask.docs-search": { version: 1, view: docsSearchToolView },

package/dist/generated/models/apiErrorCode.d.ts

@@ -90,6 +90,9 @@ export declare const ApiErrorCode: {
     readonly ORG_ACTION_PROPOSAL_CHANGED: "ORG_ACTION_PROPOSAL_CHANGED";
     readonly ORG_ACTION_PROPOSAL_NOT_EDITABLE: "ORG_ACTION_PROPOSAL_NOT_EDITABLE";
     readonly ORG_ACTION_SCAN_ALREADY_RUNNING: "ORG_ACTION_SCAN_ALREADY_RUNNING";
+    readonly ORG_ACTION_SPEC_UPLOADS_NOT_AVAILABLE: "ORG_ACTION_SPEC_UPLOADS_NOT_AVAILABLE";
+    readonly ORG_ACTION_SPEC_UPLOAD_INVALID: "ORG_ACTION_SPEC_UPLOAD_INVALID";
+    readonly ORG_ACTION_SPEC_UPLOAD_TOO_LARGE: "ORG_ACTION_SPEC_UPLOAD_TOO_LARGE";
     readonly ORG_SITEMAP_PAGE_INVALID: "ORG_SITEMAP_PAGE_INVALID";
     readonly ORG_SITEMAP_ROUTE_ALREADY_REGISTERED: "ORG_SITEMAP_ROUTE_ALREADY_REGISTERED";
     readonly ORG_SITEMAP_PAGE_ALREADY_ARCHIVED: "ORG_SITEMAP_PAGE_ALREADY_ARCHIVED";
@@ -141,6 +144,12 @@ export declare const ApiErrorCode: {
     readonly SSO_REQUIRED_FOR_DOMAIN: "SSO_REQUIRED_FOR_DOMAIN";
     readonly SSO_CONNECTION_NOT_ACTIVE: "SSO_CONNECTION_NOT_ACTIVE";
     readonly EDGE_ORIGIN_REQUIRED: "EDGE_ORIGIN_REQUIRED";
+    readonly MCP_CONNECTIONS_NOT_AVAILABLE: "MCP_CONNECTIONS_NOT_AVAILABLE";
+    readonly MCP_AUTHORIZATION_EXPIRED: "MCP_AUTHORIZATION_EXPIRED";
+    readonly MCP_CAPABILITY_ABOVE_ROLE: "MCP_CAPABILITY_ABOVE_ROLE";
+    readonly MCP_CAPABILITIES_INVALID: "MCP_CAPABILITIES_INVALID";
+    readonly MCP_AUTHORIZATION_SERVER_UNAVAILABLE: "MCP_AUTHORIZATION_SERVER_UNAVAILABLE";
+    readonly MCP_CONNECTION_CONFLICT: "MCP_CONNECTION_CONFLICT";
     readonly DEMO_ERROR: "DEMO_ERROR";
     readonly HTTP_ERROR: "HTTP_ERROR";
     readonly INTERNAL_ERROR: "INTERNAL_ERROR";

package/dist/generated/models/apiErrorCode.js

@@ -89,6 +89,9 @@ export const ApiErrorCode = {
     ORG_ACTION_PROPOSAL_CHANGED: "ORG_ACTION_PROPOSAL_CHANGED",
     ORG_ACTION_PROPOSAL_NOT_EDITABLE: "ORG_ACTION_PROPOSAL_NOT_EDITABLE",
     ORG_ACTION_SCAN_ALREADY_RUNNING: "ORG_ACTION_SCAN_ALREADY_RUNNING",
+    ORG_ACTION_SPEC_UPLOADS_NOT_AVAILABLE: "ORG_ACTION_SPEC_UPLOADS_NOT_AVAILABLE",
+    ORG_ACTION_SPEC_UPLOAD_INVALID: "ORG_ACTION_SPEC_UPLOAD_INVALID",
+    ORG_ACTION_SPEC_UPLOAD_TOO_LARGE: "ORG_ACTION_SPEC_UPLOAD_TOO_LARGE",
     ORG_SITEMAP_PAGE_INVALID: "ORG_SITEMAP_PAGE_INVALID",
     ORG_SITEMAP_ROUTE_ALREADY_REGISTERED: "ORG_SITEMAP_ROUTE_ALREADY_REGISTERED",
     ORG_SITEMAP_PAGE_ALREADY_ARCHIVED: "ORG_SITEMAP_PAGE_ALREADY_ARCHIVED",
@@ -140,6 +143,12 @@ export const ApiErrorCode = {
     SSO_REQUIRED_FOR_DOMAIN: "SSO_REQUIRED_FOR_DOMAIN",
     SSO_CONNECTION_NOT_ACTIVE: "SSO_CONNECTION_NOT_ACTIVE",
     EDGE_ORIGIN_REQUIRED: "EDGE_ORIGIN_REQUIRED",
+    MCP_CONNECTIONS_NOT_AVAILABLE: "MCP_CONNECTIONS_NOT_AVAILABLE",
+    MCP_AUTHORIZATION_EXPIRED: "MCP_AUTHORIZATION_EXPIRED",
+    MCP_CAPABILITY_ABOVE_ROLE: "MCP_CAPABILITY_ABOVE_ROLE",
+    MCP_CAPABILITIES_INVALID: "MCP_CAPABILITIES_INVALID",
+    MCP_AUTHORIZATION_SERVER_UNAVAILABLE: "MCP_AUTHORIZATION_SERVER_UNAVAILABLE",
+    MCP_CONNECTION_CONFLICT: "MCP_CONNECTION_CONFLICT",
     DEMO_ERROR: "DEMO_ERROR",
     HTTP_ERROR: "HTTP_ERROR",
     INTERNAL_ERROR: "INTERNAL_ERROR",

package/dist/headless.d.ts

@@ -1,6 +1,6 @@
 export { TeaflaskAssistantProvider, type TeaflaskAssistantAnonymousProps, type TeaflaskAssistantIdentityProps, type TeaflaskAssistantProviderBaseProps, type TeaflaskAssistantProviderProps, } from "./components/teaflask-assistant-provider.js";
 export type { AssistantTheme, AssistantThemeDarkTokens, AssistantThemeMode, AssistantThemeTokens, } from "./appearance/theme.js";
-export type { ActionsAdapter, ActionIntent, ActionIntentAction, CookiesActionsAdapter, HeadersActionsAdapter, RequestActionsAdapter, } from "./contract/actions-adapter.js";
+export type { ActionsAdapter, ActionIntent, ActionIntentAction, ActionIntentGraphQL, CookiesActionsAdapter, HeadersActionsAdapter, RequestActionsAdapter, } from "./contract/actions-adapter.js";
 export type { ApprovalSubmitTelemetryEvent, AssistantTelemetryEvent, StreamFailedTelemetryEvent, } from "./contract/telemetry.js";
 export type { AssistantSuggestion, AssistantSuggestionInput, AssistantSuggestionKind, } from "./components/conversation-view.js";
 export type { IconAdapter, JsonSchema, ToolViewAdapter, ToolViewCall, ToolViewInstance, ToolViewProps, ToolViewRegistration, ToolViewRegistry, } from "./core/tool-view.js";

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export type { AssistantActivityResult, AssistantActivitySnapshot, } from "./core
 export type { PendingDecisionGap } from "./core/pending-decision-gap.js";
 export { resetAssistant } from "./persistence/stored-thread.js";
 export { ServingApiError } from "./transport/serving-error.js";
-export type { ActionIntent, ActionIntentAction, ActionsAdapter, CookiesActionsAdapter, HeadersActionsAdapter, RequestActionsAdapter, } from "./contract/actions-adapter.js";
+export type { ActionIntent, ActionIntentAction, ActionIntentGraphQL, ActionsAdapter, CookiesActionsAdapter, HeadersActionsAdapter, RequestActionsAdapter, } from "./contract/actions-adapter.js";
 export type { ServingErrorCode, ServingErrorCodeOnTheWire, } from "./contract/errors.js";
 export { ASSISTANT_MESSAGE_MAX_CHARS, type ServingAssistantThread, type TurnStatus, } from "./contract/threads.js";
 export { activeFoldElapsedOf, settledFoldDurationOf, type BlockTiming, type SegmentDuration, } from "./core/segment-timing.js";

package/dist/transport/actions-adapter.js

@@ -27,19 +27,96 @@ export function actionIntentOf(wire) {
     if (wire.body !== null && wire.body !== undefined) {
         intent.body = wire.body;
     }
+    const graphql = _graphqlOf(wire);
+    if (graphql !== null) {
+        intent.graphql = graphql;
+    }
     return intent;
 }
+function _graphqlOf(wire) {
+    const descriptor = _recordOf(wire.graphql);
+    const body = _recordOf(wire.body);
+    if (descriptor === null || body === null) {
+        return null;
+    }
+    const halves = {
+        operationName: _nonEmptyStringOf(descriptor.operation_name),
+        operationType: descriptor.operation_type,
+        document: _nonEmptyStringOf(body.query),
+        variables: body.variables === undefined || body.variables === null
+            ? {}
+            : _recordOf(body.variables),
+    };
+    if (!_descriptorAgreesWithBody(halves, body.operationName)) {
+        return null;
+    }
+    const { operationName, operationType, document, variables } = halves;
+    return { operationName, operationType, document, variables };
+}
+function _descriptorAgreesWithBody(halves, bodyOperationName) {
+    return (halves.operationName !== null &&
+        halves.operationName === bodyOperationName &&
+        (halves.operationType === "query" || halves.operationType === "mutation") &&
+        halves.document !== null &&
+        halves.variables !== null);
+}
 export async function performActionIntent(adapter, intent) {
+    const land = intent.graphql === undefined ? _landableBodyOf : _landableGraphQLBodyOf;
     if (adapter.kind === "request") {
-        return _intentResultOf(200, await adapter.execute(intent));
+        return _intentResultOf(200, land(await adapter.execute(intent)));
     }
     const response = await fetch(_urlOf(adapter.baseUrl, intent), await _requestInitOf(adapter, intent));
-    return _resultOf(response);
+    return _resultOf(response, land);
 }
-function _intentResultOf(status, rawBody) {
-    const landed = _landableBodyOf(rawBody);
+function _intentResultOf(status, landed) {
     return { status, body: landed.body, truncated: landed.truncated };
 }
+function _landableGraphQLBodyOf(body) {
+    const whole = _landableBodyOf(body);
+    const errored = whole.truncated ? _erroredResponseOf(body) : null;
+    if (errored === null) {
+        return whole;
+    }
+    return (_errorsAndDataWhole(errored) ??
+        _errorsWithDataCut(errored) ??
+        _wholeCutErrorsFirst(errored));
+}
+function _erroredResponseOf(body) {
+    const response = _recordOf(body);
+    if (response === null) {
+        return null;
+    }
+    const errors = JSON.parse(JSON.stringify(response.errors ?? null));
+    if (!Array.isArray(errors) || errors.length === 0) {
+        return null;
+    }
+    return { errors, data: response.data ?? null, response };
+}
+function _errorsAndDataWhole({ errors, data, }) {
+    const kept = { errors, data };
+    return doorLengthCeilingOf(JSON.stringify(kept)) <= RESPONSE_BODY_MAX_CHARS
+        ? { body: kept, truncated: true }
+        : null;
+}
+function _errorsWithDataCut({ errors, data, }) {
+    const dataBudget = RESPONSE_BODY_MAX_CHARS -
+        doorLengthCeilingOf(JSON.stringify({ errors, data: "" })) -
+        doorCostOfText(TRUNCATION_NOTICE);
+    if (dataBudget < 0) {
+        return null;
+    }
+    const dataText = JSON.stringify(data);
+    const bounded = boundedTextOf(dataText, Math.min(dataBudget, doorCostOfText(dataText) - 1));
+    return {
+        body: { errors, data: bounded + TRUNCATION_NOTICE },
+        truncated: true,
+    };
+}
+function _wholeCutErrorsFirst({ errors, response, }) {
+    const rest = { ...response };
+    delete rest.errors;
+    return _landableBodyOf(JSON.stringify({ errors, ...rest }));
+}
 function _landableBodyOf(body) {
     if (body === undefined) {
         return { body: null, truncated: false };
@@ -105,8 +182,8 @@ function _queryStringOf(query) {
     const encoded = parameters.toString();
     return encoded === "" ? "" : `?${encoded}`;
 }
-async function _resultOf(response) {
-    return _intentResultOf(response.status, _jsonOrTextOf(await response.text()));
+async function _resultOf(response, land) {
+    return _intentResultOf(response.status, land(_jsonOrTextOf(await response.text())));
 }
 function _jsonOrTextOf(text) {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teaflask/assistant",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "The AI assistant for your product: drop it into your React app or any page with a script tag.",
   "license": "FSL-1.1-ALv2",
   "author": "Teaflask",