@teaflask/assistant 0.8.0 → 0.9.0

package/dist/core/error-copy.js

@@ -1,10 +1,14 @@
 import { ServingApiError } from "../transport/serving-error.js";
+import { MESSAGE_TOO_LONG_SENTENCE } from "./message-copy.js";
 import { STOP_NOT_DELIVERED_SENTENCE } from "./stop-copy.js";
 const GENERIC_FAILURE_SENTENCE = "Something went wrong sending that. Please try again.";
 export function userSentenceFor(error) {
     if (!(error instanceof ServingApiError)) {
         return GENERIC_FAILURE_SENTENCE;
     }
+    if (_isAMessageTooLong(error)) {
+        return MESSAGE_TOO_LONG_SENTENCE;
+    }
     switch (error.code) {
         case "ASSISTANT_THREAD_BUSY":
             return ("The assistant is already answering — possibly in another tab. " +
@@ -20,7 +24,7 @@ export function userSentenceFor(error) {
         case "NOT_FOUND":
             return "That conversation isn't available.";
         case "VALIDATION_ERROR":
-            return "That message couldn't be sent. Shorten it and try again.";
+            return "That message couldn't be sent. Check it and try again.";
         default:
             return error.message;
     }
@@ -37,6 +41,10 @@ export function failureSentenceOf(error) {
     }
     return "Something went wrong. Try again.";
 }
+function _isAMessageTooLong(error) {
+    return (error.code === "MESSAGE_TOO_LONG" ||
+        (error.status === 413 && error.code === "UNKNOWN"));
+}
 function _rateLimitedSentence(retryAfterSeconds) {
     if (retryAfterSeconds !== null && retryAfterSeconds > 0) {
         return `You're sending messages too quickly. Try again in ${String(retryAfterSeconds)} seconds.`;

package/dist/core/long-message.js

@@ -0,0 +1,22 @@
+export const LONG_MESSAGE_COLLAPSE_FROM = 20_000;
+const PREVIEW_CHARS = 600;
+const WORD_BREAK_WINDOW = 120;
+export function longMessagePreviewOf(text) {
+    if (text.length <= LONG_MESSAGE_COLLAPSE_FROM) {
+        return null;
+    }
+    return text.slice(0, _previewEndOf(text)).trimEnd();
+}
+function _previewEndOf(text) {
+    const windowStart = PREVIEW_CHARS - WORD_BREAK_WINDOW;
+    const lastBreak = text.slice(windowStart, PREVIEW_CHARS).search(/\s\S*$/);
+    if (lastBreak >= 0) {
+        return windowStart + lastBreak;
+    }
+    return _isLowSurrogate(text.charCodeAt(PREVIEW_CHARS))
+        ? PREVIEW_CHARS - 1
+        : PREVIEW_CHARS;
+}
+function _isLowSurrogate(code) {
+    return code >= 0xdc00 && code <= 0xdfff;
+}

package/dist/core/message-copy.js

@@ -0,0 +1 @@
+export const MESSAGE_TOO_LONG_SENTENCE = "This message is too long to answer. Please shorten it or split it into smaller messages.";

package/dist/core/tool-call-display.d.ts

@@ -63,15 +63,9 @@ export interface ToolCallViewModel {
     argsText?: string;
     /**
      * The raw result text. Undefined until the call finishes, and withheld for
-     * calls that failed, were not approved, didn't run, were declined or had
-     * their result replaced by a preview.
+     * calls that failed, were not approved, didn't run or were declined.
      */
     output?: string;
-    /**
-     * True when the result was too large for the agent and was replaced by a
-     * shortened preview. `output` is then withheld.
-     */
-    offloaded?: boolean;
     /** Why the call failed, set when it failed. */
     errorText?: string;
     /**

package/dist/core/tool-call-presentation.js

@@ -67,9 +67,6 @@ function _toolViewCallOf(view, awaitingDecision) {
             },
         });
     }
-    if (view.offloaded === true) {
-        call.offloaded = true;
-    }
     if (view.errorText !== undefined) {
         call.errorText = view.errorText;
     }

package/dist/core/tool-outcome.js

@@ -5,7 +5,6 @@ const TOOL_OUTCOME_FIELDS = [
     "refused",
     "cancelled",
     "truncated",
-    "offloaded",
 ];
 const NAMESPACE = "teaflask";
 const OUTCOME_KEY = "toolOutcome";

package/dist/core/tool-view.d.ts

@@ -40,8 +40,8 @@ export interface ToolViewCall<TArgs = Record<string, unknown>, TResult = unknown
     result?: TResult;
     /**
      * The raw result text as recorded. Undefined until the call finishes, and
-     * withheld for calls that failed, were not approved, didn't run, were
-     * declined or had their result replaced by a preview.
+     * withheld for calls that failed, were not approved, didn't run or were
+     * declined.
      */
     resultText?: string;
     /**
@@ -50,11 +50,6 @@ export interface ToolViewCall<TArgs = Record<string, unknown>, TResult = unknown
      * complete.
      */
     truncated?: boolean;
-    /**
-     * True when the result was too large for the agent and was replaced by a
-     * shortened preview. The tool's real output is not available to the view.
-     */
-    offloaded?: boolean;
     /**
      * Why the call failed, set when it failed. Use humanFailureSentenceOf to
      * get a sentence fit for the user, and actionFailureOf to read an action's

package/dist/core/transcript-rows.d.ts

@@ -110,12 +110,6 @@ export interface ToolCallRow {
      * arrives.
      */
     result?: string;
-    /**
-     * True when the tool's output was too large and `result` holds a shortened
-     * stand-in rather than the actual output; show a "result shortened" note
-     * instead of the content.
-     */
-    offloaded: boolean;
     /** Why the call failed. Present only when state is output-error. */
     errorText?: string;
     /**

package/dist/core/transcript-rows.js

@@ -21,7 +21,6 @@ export function transcriptRowsOf(messages, anchors, running, metaByMessageId = N
             errors: anchors.toolErrorAnchors,
             refusals: anchors.toolRefusalAnchors,
             cancels: anchors.toolCancelAnchors,
-            offloads: anchors.toolOffloadAnchors,
             decisions: anchors.toolDecisionAnchors ?? EMPTY_TOOL_DECISION_ANCHORS,
             denials: anchors.toolDenialAnchors ?? EMPTY_TOOL_DENIAL_ANCHORS,
             displays: anchors.toolCallDisplayAnchors,
@@ -112,7 +111,6 @@ function _pushMessageRows(rows, message, results, context) {
             state,
             argsText: toolCall.function.arguments,
             result,
-            offloaded: context.offloads.has(toolCall.id),
             errorText: errorTextOf(recordedError, result),
             ...(state === "refused" ? { refusalText: recordedRefusal } : {}),
             display: context.displays.get(toolCall.id),
@@ -239,7 +237,6 @@ export function transcriptBlocksOf(messages, anchors, running, metaByMessageId =
             errors: anchors.toolErrorAnchors,
             refusals: anchors.toolRefusalAnchors,
             cancels: anchors.toolCancelAnchors,
-            offloads: anchors.toolOffloadAnchors,
             decisions: anchors.toolDecisionAnchors ?? EMPTY_TOOL_DECISION_ANCHORS,
             denials: anchors.toolDenialAnchors ?? EMPTY_TOOL_DENIAL_ANCHORS,
             displays: anchors.toolCallDisplayAnchors,

package/dist/core/withdrawn-anchors.d.ts

@@ -0,0 +1,11 @@
+import type { AgentSubscriber } from "@ag-ui/client";
+import type { Message } from "@ag-ui/core";
+import type { ReplyWithdrawnMarker } from "../generated/models/index.js";
+export interface WithdrawnReplies {
+    messageIds: ReadonlySet<string>;
+    toolCallIds: ReadonlySet<string>;
+}
+export declare const EMPTY_WITHDRAWN_REPLIES: WithdrawnReplies;
+export declare function withRepliesWithdrawn(previous: WithdrawnReplies, marker: ReplyWithdrawnMarker): WithdrawnReplies;
+export declare function withdrawnReplyRecorder(onWithdrawn: (marker: ReplyWithdrawnMarker) => void): AgentSubscriber;
+export declare function withoutWithdrawnReplies(messages: readonly Message[], withdrawn: WithdrawnReplies): readonly Message[];

package/dist/core/withdrawn-anchors.js

@@ -0,0 +1,76 @@
+import { REPLY_WITHDRAWN_EVENT_NAME } from "../contract/events.js";
+export const EMPTY_WITHDRAWN_REPLIES = {
+    messageIds: new Set(),
+    toolCallIds: new Set(),
+};
+function _withdrawnRepliesOf(name, value) {
+    if (name !== REPLY_WITHDRAWN_EVENT_NAME ||
+        typeof value !== "object" ||
+        value === null) {
+        return null;
+    }
+    const record = value;
+    return {
+        messageIds: _idsIn(record.messageIds),
+        toolCallIds: _idsIn(record.toolCallIds),
+    };
+}
+function _idsIn(field) {
+    if (!Array.isArray(field)) {
+        return [];
+    }
+    return field.filter((id) => typeof id === "string" && id !== "");
+}
+export function withRepliesWithdrawn(previous, marker) {
+    const messageIds = _withIds(previous.messageIds, marker.messageIds);
+    const toolCallIds = _withIds(previous.toolCallIds, marker.toolCallIds);
+    if (messageIds === previous.messageIds &&
+        toolCallIds === previous.toolCallIds) {
+        return previous;
+    }
+    return { messageIds, toolCallIds };
+}
+function _withIds(previous, ids) {
+    if (ids.every((id) => previous.has(id))) {
+        return previous;
+    }
+    return new Set([...previous, ...ids]);
+}
+export function withdrawnReplyRecorder(onWithdrawn) {
+    return {
+        onCustomEvent({ event }) {
+            const marker = _withdrawnRepliesOf(event.name, event.value);
+            if (marker !== null) {
+                onWithdrawn(marker);
+            }
+        },
+    };
+}
+export function withoutWithdrawnReplies(messages, withdrawn) {
+    if (_nothingIsWithdrawn(withdrawn)) {
+        return messages;
+    }
+    return messages.flatMap((message) => _visiblePartOf(message, withdrawn));
+}
+function _nothingIsWithdrawn(withdrawn) {
+    return withdrawn.messageIds.size === 0 && withdrawn.toolCallIds.size === 0;
+}
+function _visiblePartOf(message, withdrawn) {
+    if (withdrawn.messageIds.has(message.id)) {
+        return [];
+    }
+    if (message.role === "tool") {
+        return withdrawn.toolCallIds.has(message.toolCallId) ? [] : [message];
+    }
+    if (message.role !== "assistant" || message.toolCalls === undefined) {
+        return [message];
+    }
+    const toolCalls = message.toolCalls.filter((toolCall) => !withdrawn.toolCallIds.has(toolCall.id));
+    if (toolCalls.length === message.toolCalls.length) {
+        return [message];
+    }
+    if (toolCalls.length === 0 && !message.content) {
+        return [];
+    }
+    return [{ ...message, toolCalls }];
+}

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

@@ -22,6 +22,7 @@ export declare const ApiErrorCode: {
     readonly DOC_REVISION_NOT_PUBLISHABLE: "DOC_REVISION_NOT_PUBLISHABLE";
     readonly DOC_REVISION_NOT_DISCARDABLE: "DOC_REVISION_NOT_DISCARDABLE";
     readonly DOC_PROPOSAL_STALE: "DOC_PROPOSAL_STALE";
+    readonly REVISION_STALE: "REVISION_STALE";
     readonly DOC_LIMIT_REACHED: "DOC_LIMIT_REACHED";
     readonly HELP_SITE_CONFIG_INVALID: "HELP_SITE_CONFIG_INVALID";
     readonly HELP_SITE_NEVER_PUBLISHED: "HELP_SITE_NEVER_PUBLISHED";
@@ -115,6 +116,7 @@ export declare const ApiErrorCode: {
     readonly WORK_CREDIT_REQUEST_PENDING: "WORK_CREDIT_REQUEST_PENDING";
     readonly JOIN_REQUEST_ALREADY_MEMBER: "JOIN_REQUEST_ALREADY_MEMBER";
     readonly JOIN_REQUEST_ALREADY_PENDING: "JOIN_REQUEST_ALREADY_PENDING";
+    readonly LAST_OWNER: "LAST_OWNER";
     readonly ORGANIZATION_DOMAIN_DNS_CLAIMED: "ORGANIZATION_DOMAIN_DNS_CLAIMED";
     readonly EMAIL_DOMAIN_NOT_CLAIMABLE: "EMAIL_DOMAIN_NOT_CLAIMABLE";
     readonly EMAIL_DOMAIN_REVOKED: "EMAIL_DOMAIN_REVOKED";
@@ -150,6 +152,7 @@ export declare const ApiErrorCode: {
     readonly MCP_CAPABILITIES_INVALID: "MCP_CAPABILITIES_INVALID";
     readonly MCP_AUTHORIZATION_SERVER_UNAVAILABLE: "MCP_AUTHORIZATION_SERVER_UNAVAILABLE";
     readonly MCP_CONNECTION_CONFLICT: "MCP_CONNECTION_CONFLICT";
+    readonly MESSAGE_TOO_LONG: "MESSAGE_TOO_LONG";
     readonly DEMO_ERROR: "DEMO_ERROR";
     readonly HTTP_ERROR: "HTTP_ERROR";
     readonly INTERNAL_ERROR: "INTERNAL_ERROR";

package/dist/generated/models/apiErrorCode.js

@@ -21,6 +21,7 @@ export const ApiErrorCode = {
     DOC_REVISION_NOT_PUBLISHABLE: "DOC_REVISION_NOT_PUBLISHABLE",
     DOC_REVISION_NOT_DISCARDABLE: "DOC_REVISION_NOT_DISCARDABLE",
     DOC_PROPOSAL_STALE: "DOC_PROPOSAL_STALE",
+    REVISION_STALE: "REVISION_STALE",
     DOC_LIMIT_REACHED: "DOC_LIMIT_REACHED",
     HELP_SITE_CONFIG_INVALID: "HELP_SITE_CONFIG_INVALID",
     HELP_SITE_NEVER_PUBLISHED: "HELP_SITE_NEVER_PUBLISHED",
@@ -114,6 +115,7 @@ export const ApiErrorCode = {
     WORK_CREDIT_REQUEST_PENDING: "WORK_CREDIT_REQUEST_PENDING",
     JOIN_REQUEST_ALREADY_MEMBER: "JOIN_REQUEST_ALREADY_MEMBER",
     JOIN_REQUEST_ALREADY_PENDING: "JOIN_REQUEST_ALREADY_PENDING",
+    LAST_OWNER: "LAST_OWNER",
     ORGANIZATION_DOMAIN_DNS_CLAIMED: "ORGANIZATION_DOMAIN_DNS_CLAIMED",
     EMAIL_DOMAIN_NOT_CLAIMABLE: "EMAIL_DOMAIN_NOT_CLAIMABLE",
     EMAIL_DOMAIN_REVOKED: "EMAIL_DOMAIN_REVOKED",
@@ -149,6 +151,7 @@ export const ApiErrorCode = {
     MCP_CAPABILITIES_INVALID: "MCP_CAPABILITIES_INVALID",
     MCP_AUTHORIZATION_SERVER_UNAVAILABLE: "MCP_AUTHORIZATION_SERVER_UNAVAILABLE",
     MCP_CONNECTION_CONFLICT: "MCP_CONNECTION_CONFLICT",
+    MESSAGE_TOO_LONG: "MESSAGE_TOO_LONG",
     DEMO_ERROR: "DEMO_ERROR",
     HTTP_ERROR: "HTTP_ERROR",
     INTERNAL_ERROR: "INTERNAL_ERROR",

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

@@ -16,4 +16,5 @@ export declare const AssistantStreamMarkerName: {
     readonly turn_failed: "turn_failed";
     readonly turn_stop_requested: "turn_stop_requested";
     readonly interrupt_answer_consumed: "interrupt_answer_consumed";
+    readonly reply_withdrawn: "reply_withdrawn";
 };

package/dist/generated/models/assistantStreamMarkerName.js

@@ -15,4 +15,5 @@ export const AssistantStreamMarkerName = {
     turn_failed: "turn_failed",
     turn_stop_requested: "turn_stop_requested",
     interrupt_answer_consumed: "interrupt_answer_consumed",
+    reply_withdrawn: "reply_withdrawn",
 };

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

@@ -83,6 +83,7 @@ export * from "./readPageResult.js";
 export * from "./reasoningMessage.js";
 export * from "./reasoningMessageMetadata.js";
 export * from "./refusedField.js";
+export * from "./replyWithdrawnMarker.js";
 export * from "./resolvedLanding.js";
 export * from "./resolvedLandingCard.js";
 export * from "./resolveServingTurnApprovalRequest.js";

package/dist/generated/models/index.js

@@ -83,6 +83,7 @@ export * from "./readPageResult.js";
 export * from "./reasoningMessage.js";
 export * from "./reasoningMessageMetadata.js";
 export * from "./refusedField.js";
+export * from "./replyWithdrawnMarker.js";
 export * from "./resolvedLanding.js";
 export * from "./resolvedLandingCard.js";
 export * from "./resolveServingTurnApprovalRequest.js";

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

@@ -0,0 +1,4 @@
+export interface ReplyWithdrawnMarker {
+    messageIds: string[];
+    toolCallIds: string[];
+}

package/dist/generated/models/replyWithdrawnMarker.js

@@ -0,0 +1 @@
+export {};

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

@@ -4,8 +4,8 @@
  * integration; RATE_LIMITED and ORCHESTRATION_UNAVAILABLE clear on retry;
  * ASSISTANT_SIGN_IN_REQUIRED means the assistant only serves signed-in users;
  * ASSISTANT_UNFUNDED means your Teaflask organization has no funds to pay for
- * replies; the SUBSCRIPTION_ codes come from a user connecting their own
- * ChatGPT plan.
+ * replies; MESSAGE_TOO_LONG means a message was over the 4 MB size limit; the
+ * SUBSCRIPTION_ codes come from a user connecting their own ChatGPT plan.
  */
 export type ServingErrorCode = (typeof ServingErrorCode)[keyof typeof ServingErrorCode];
 /**
@@ -14,8 +14,8 @@ export type ServingErrorCode = (typeof ServingErrorCode)[keyof typeof ServingErr
  * integration; RATE_LIMITED and ORCHESTRATION_UNAVAILABLE clear on retry;
  * ASSISTANT_SIGN_IN_REQUIRED means the assistant only serves signed-in users;
  * ASSISTANT_UNFUNDED means your Teaflask organization has no funds to pay for
- * replies; the SUBSCRIPTION_ codes come from a user connecting their own
- * ChatGPT plan.
+ * replies; MESSAGE_TOO_LONG means a message was over the 4 MB size limit; the
+ * SUBSCRIPTION_ codes come from a user connecting their own ChatGPT plan.
  */
 export declare const ServingErrorCode: {
     readonly PUBLISHABLE_KEY_INVALID: "PUBLISHABLE_KEY_INVALID";
@@ -45,6 +45,7 @@ export declare const ServingErrorCode: {
     readonly SUBSCRIPTION_CANNOT_PAY: "SUBSCRIPTION_CANNOT_PAY";
     readonly SUBSCRIPTION_PLAN_UNSERVABLE: "SUBSCRIPTION_PLAN_UNSERVABLE";
     readonly ASSISTANT_CONFIGURATION_UNRUNNABLE: "ASSISTANT_CONFIGURATION_UNRUNNABLE";
+    readonly MESSAGE_TOO_LONG: "MESSAGE_TOO_LONG";
     readonly ORCHESTRATION_UNAVAILABLE: "ORCHESTRATION_UNAVAILABLE";
     readonly FEEDBACK_DISABLED: "FEEDBACK_DISABLED";
     readonly INTERNAL_ERROR: "INTERNAL_ERROR";

package/dist/generated/models/servingErrorCode.js

@@ -26,6 +26,7 @@ export const ServingErrorCode = {
     SUBSCRIPTION_CANNOT_PAY: "SUBSCRIPTION_CANNOT_PAY",
     SUBSCRIPTION_PLAN_UNSERVABLE: "SUBSCRIPTION_PLAN_UNSERVABLE",
     ASSISTANT_CONFIGURATION_UNRUNNABLE: "ASSISTANT_CONFIGURATION_UNRUNNABLE",
+    MESSAGE_TOO_LONG: "MESSAGE_TOO_LONG",
     ORCHESTRATION_UNAVAILABLE: "ORCHESTRATION_UNAVAILABLE",
     FEEDBACK_DISABLED: "FEEDBACK_DISABLED",
     INTERNAL_ERROR: "INTERNAL_ERROR",

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { resetAssistant } from "./persistence/stored-thread.js";
 export { ServingApiError } from "./transport/serving-error.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 type { ServingAssistantThread, TurnStatus } from "./contract/threads.js";
 export { activeFoldElapsedOf, settledFoldDurationOf, type BlockTiming, type SegmentDuration, } from "./core/segment-timing.js";
 export type { MemoryUpdated } from "./core/memory-provenance-anchors.js";
 export type { ApprovalSubmitDropReason, ApprovalSubmitTelemetryEvent, AssistantTelemetryEvent, StreamFailedTelemetryEvent, StreamFailureClass, } from "./contract/telemetry.js";

package/dist/index.js

@@ -5,7 +5,6 @@ export { AssistantPalette, } from "./components/assistant-palette.js";
 export { useAssistantActivity } from "./components/use-assistant-activity.js";
 export { resetAssistant } from "./persistence/stored-thread.js";
 export { ServingApiError } from "./transport/serving-error.js";
-export { ASSISTANT_MESSAGE_MAX_CHARS, } from "./contract/threads.js";
 export { activeFoldElapsedOf, settledFoldDurationOf, } from "./core/segment-timing.js";
 export { TOOL_CALL_ICONS, toolCallPresentationOf, } from "./core/tool-call-presentation.js";
 export { actionToolName, actionToolViews, resolvedToolViewsOf, } from "./core/tool-view.js";