@teaflask/assistant 0.0.0 → 0.3.0

package/dist/contract/events.d.ts

@@ -0,0 +1,21 @@
+import type { ApprovalRequestedMarker, ApprovalResolvedMarker, InterruptAnswerConsumedMarker, RunResumedMarker, SubagentResultsDeliveredMarker, ToolExecutionRequestedMarker } from "../generated/models/index.js";
+export type AssistantStreamEventType = "TEXT_MESSAGE_START" | "TEXT_MESSAGE_CONTENT" | "TEXT_MESSAGE_END" | "REASONING_START" | "REASONING_END" | "REASONING_MESSAGE_START" | "REASONING_MESSAGE_CONTENT" | "REASONING_MESSAGE_END" | "TOOL_CALL_START" | "TOOL_CALL_ARGS" | "TOOL_CALL_END" | "TOOL_CALL_RESULT" | "RUN_STARTED" | "RUN_FINISHED" | "RUN_ERROR" | "CUSTOM";
+export declare const RUN_RESUMED_EVENT_NAME: "run_resumed";
+export type RunResumedPayload = RunResumedMarker;
+export declare const APPROVAL_REQUESTED_EVENT_NAME: "approval_requested";
+export type ApprovalRequestedPayload = ApprovalRequestedMarker & Required<Pick<ApprovalRequestedMarker, "tool_args" | "tool_input_schema" | "tool_output_schema" | "round" | "gated" | "trust_available">>;
+export declare const APPROVAL_RESOLVED_EVENT_NAME: "approval_resolved";
+export type ApprovalResolvedPayload = ApprovalResolvedMarker;
+export declare const INTERRUPT_ANSWER_CONSUMED_EVENT_NAME: "interrupt_answer_consumed";
+export type InterruptAnswerConsumedPayload = InterruptAnswerConsumedMarker;
+export declare const TURN_FAILED_EVENT_NAME: "turn_failed";
+export declare const TURN_STOPPED_EVENT_NAME: "turn_stopped";
+export declare const TOOL_EXECUTION_REQUESTED_EVENT_NAME: "tool_execution_requested";
+export type ToolExecutionRequestedPayload = ToolExecutionRequestedMarker & Required<Pick<ToolExecutionRequestedMarker, "round">>;
+export declare const TOOL_RESULT_RECORDED_EVENT_NAME: "tool_result_recorded";
+export declare const TOOL_CALL_ANNOTATED_EVENT_NAME: "tool_call_annotated";
+export declare const SUBAGENT_RESULTS_DELIVERED_EVENT_NAME: "subagent_results_delivered";
+export type SubagentResultsDeliveredPayload = SubagentResultsDeliveredMarker;
+export declare const TURN_USAGE_RECORDED_EVENT_NAME: "turn_usage_recorded";
+export declare const MEMORY_UPDATED_EVENT_NAME: "memory_updated";
+//# sourceMappingURL=events.d.ts.map

package/dist/contract/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/contract/events.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,8BAA8B,EAC9B,4BAA4B,EAC7B,MAAM,8BAA8B,CAAC;AAItC,MAAM,MAAM,wBAAwB,GAChC,oBAAoB,GACpB,sBAAsB,GACtB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,yBAAyB,GACzB,2BAA2B,GAC3B,uBAAuB,GACvB,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,aAAa,GACb,cAAc,GACd,WAAW,GACX,QAAQ,CAAC;AAIb,eAAO,MAAM,sBAAsB,eAAwC,CAAC;AAE5E,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAIjD,eAAO,MAAM,6BAA6B,sBACI,CAAC;AAG/C,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,GAC5D,QAAQ,CACN,IAAI,CACF,uBAAuB,EACrB,WAAW,GACX,mBAAmB,GACnB,oBAAoB,GACpB,OAAO,GACP,OAAO,GACP,iBAAiB,CACpB,CACF,CAAC;AAIJ,eAAO,MAAM,4BAA4B,qBACI,CAAC;AAE9C,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,CAAC;AAI7D,eAAO,MAAM,oCAAoC,6BACI,CAAC;AAEtD,MAAM,MAAM,8BAA8B,GAAG,6BAA6B,CAAC;AAK3E,eAAO,MAAM,sBAAsB,eAAwC,CAAC;AAG5E,eAAO,MAAM,uBAAuB,gBAAyC,CAAC;AAI9E,eAAO,MAAM,mCAAmC,4BACI,CAAC;AAGrD,MAAM,MAAM,6BAA6B,GAAG,4BAA4B,GACtE,QAAQ,CAAC,IAAI,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC,CAAC;AAGxD,eAAO,MAAM,+BAA+B,wBACI,CAAC;AAIjD,eAAO,MAAM,8BAA8B,uBACI,CAAC;AAIhD,eAAO,MAAM,qCAAqC,8BACI,CAAC;AAEvD,MAAM,MAAM,+BAA+B,GAAG,8BAA8B,CAAC;AAM7E,eAAO,MAAM,8BAA8B,uBACI,CAAC;AAKhD,eAAO,MAAM,yBAAyB,kBACI,CAAC"}

package/dist/contract/events.js

@@ -0,0 +1,43 @@
+// The stream's frozen AG-UI event vocabulary. Structural shapes come from
+// @ag-ui/core; CUSTOM marker names and payloads are generated from
+// serving-openapi.json. Clients MUST ignore unrecognized events and fields.
+import { AssistantStreamMarkerName } from "../generated/models/index.js";
+// A retried activity attempt, emitted only when attempt > 1 — never a
+// message; the client reads it for retry severance only (stream-resume).
+export const RUN_RESUMED_EVENT_NAME = AssistantStreamMarkerName.run_resumed;
+// One per pending approval while the turn awaits input; tool_call_id anchors
+// the ask to the already-streamed tool call (the card is keyed by interrupt_id).
+export const APPROVAL_REQUESTED_EVENT_NAME = AssistantStreamMarkerName.approval_requested;
+// The durable receipt of a human's answer to an approval_requested ask —
+// never a message; a replayed receipt flips the replayed card to answered.
+export const APPROVAL_RESOLVED_EVENT_NAME = AssistantStreamMarkerName.approval_resolved;
+// A resume carried this pause's answer into the agent: never
+// rendered, it is consumed evidence for the pending-decision-gap derivation.
+export const INTERRUPT_ANSWER_CONSUMED_EVENT_NAME = AssistantStreamMarkerName.interrupt_answer_consumed;
+// The turn settled failed outside any single tool — never a
+// message or banner. Its live run ends in RUN_ERROR; on replay the terminal
+// demotes to RUN_FINISHED and this marker is the failure's durable record.
+export const TURN_FAILED_EVENT_NAME = AssistantStreamMarkerName.turn_failed;
+// The member ended the turn; same { receipt } shape as turn_failed.
+export const TURN_STOPPED_EVENT_NAME = AssistantStreamMarkerName.turn_stopped;
+// One per pending client-executed tool call while the turn awaits input —
+// this package's execution loop executes it and POSTs the result back.
+export const TOOL_EXECUTION_REQUESTED_EVENT_NAME = AssistantStreamMarkerName.tool_execution_requested;
+// Durable receipt of a delivered result: a reconnect never re-runs the request.
+export const TOOL_RESULT_RECORDED_EVENT_NAME = AssistantStreamMarkerName.tool_result_recorded;
+// Backend-authored human copy for one tool call, anchored by tool_call_id. May
+// arrive more than once per call: merged per field by tool-call-display-anchors.ts.
+export const TOOL_CALL_ANNOTATED_EVENT_NAME = AssistantStreamMarkerName.tool_call_annotated;
+// A machine-started delivery turn opens its run with this receipt
+// naming the settled dispatches it pushes. A quiet divider, never a message.
+export const SUBAGENT_RESULTS_DELIVERED_EVENT_NAME = AssistantStreamMarkerName.subagent_results_delivered;
+// The turn's settled token totals: one per settled turn that had
+// usage to sum, landed just before the terminal. Only finality "final" is
+// settled truth ("partial" sums are lower bounds); absence means UNKNOWN —
+// never an estimate or zero.
+export const TURN_USAGE_RECORDED_EVENT_NAME = AssistantStreamMarkerName.turn_usage_recorded;
+// One agent-memory row actually written during the run; a dedup
+// no-op emits nothing. memory_id reconciles re-deliveries. End-user safe:
+// a scope token and a canned sentence, never the memory's content.
+export const MEMORY_UPDATED_EVENT_NAME = AssistantStreamMarkerName.memory_updated;
+//# sourceMappingURL=events.js.map

package/dist/contract/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/contract/events.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,mEAAmE;AACnE,4EAA4E;AAU5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAqBzE,sEAAsE;AACtE,yEAAyE;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,yBAAyB,CAAC,WAAW,CAAC;AAI5E,6EAA6E;AAC7E,iFAAiF;AACjF,MAAM,CAAC,MAAM,6BAA6B,GACxC,yBAAyB,CAAC,kBAAkB,CAAC;AAgB/C,yEAAyE;AACzE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,4BAA4B,GACvC,yBAAyB,CAAC,iBAAiB,CAAC;AAI9C,6DAA6D;AAC7D,6EAA6E;AAC7E,MAAM,CAAC,MAAM,oCAAoC,GAC/C,yBAAyB,CAAC,yBAAyB,CAAC;AAItD,4DAA4D;AAC5D,4EAA4E;AAC5E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAAG,yBAAyB,CAAC,WAAW,CAAC;AAE5E,oEAAoE;AACpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC,YAAY,CAAC;AAE9E,0EAA0E;AAC1E,uEAAuE;AACvE,MAAM,CAAC,MAAM,mCAAmC,GAC9C,yBAAyB,CAAC,wBAAwB,CAAC;AAMrD,gFAAgF;AAChF,MAAM,CAAC,MAAM,+BAA+B,GAC1C,yBAAyB,CAAC,oBAAoB,CAAC;AAEjD,+EAA+E;AAC/E,oFAAoF;AACpF,MAAM,CAAC,MAAM,8BAA8B,GACzC,yBAAyB,CAAC,mBAAmB,CAAC;AAEhD,kEAAkE;AAClE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qCAAqC,GAChD,yBAAyB,CAAC,0BAA0B,CAAC;AAIvD,iEAAiE;AACjE,0EAA0E;AAC1E,2EAA2E;AAC3E,6BAA6B;AAC7B,MAAM,CAAC,MAAM,8BAA8B,GACzC,yBAAyB,CAAC,mBAAmB,CAAC;AAEhD,gEAAgE;AAChE,0EAA0E;AAC1E,mEAAmE;AACnE,MAAM,CAAC,MAAM,yBAAyB,GACpC,yBAAyB,CAAC,cAAc,CAAC"}

package/dist/contract/identity.d.ts

@@ -0,0 +1,2 @@
+export type { CurrentVisitorResponse as WhoamiResponse, EndUserIdentity, MintVisitorTokenRequest, MintVisitorTokenResponse, PublishableKeyMode, VisitorTier, } from "../generated/models/index.js";
+//# sourceMappingURL=identity.d.ts.map

package/dist/contract/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/contract/identity.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,sBAAsB,IAAI,cAAc,EACxC,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,GACZ,MAAM,8BAA8B,CAAC"}

package/dist/contract/identity.js

@@ -0,0 +1,5 @@
+// The token handshake and the session self-check. The shapes are generated
+// from serving-openapi.json; this file keeps the package's public names
+// stable over the generated ones.
+export {};
+//# sourceMappingURL=identity.js.map

package/dist/contract/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/contract/identity.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wEAAwE;AACxE,kCAAkC"}

package/dist/contract/subscriptions.d.ts

@@ -0,0 +1,2 @@
+export type { CreateDeviceAuthorizationResponse as SubscriptionDeviceAuthorization, PollDeviceAuthorizationResponse as SubscriptionDeviceAuthorizationPoll, ServingSubscriptionStatus as SubscriptionStatus, SubscriptionCredentialState, SubscriptionProvider, } from "../generated/models/index.js";
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/contract/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/contract/subscriptions.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,iCAAiC,IAAI,+BAA+B,EACpE,+BAA+B,IAAI,mCAAmC,EACtE,yBAAyB,IAAI,kBAAkB,EAC/C,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,8BAA8B,CAAC"}

package/dist/contract/subscriptions.js

@@ -0,0 +1,5 @@
+// The subscription-connect surfaces. The shapes are generated
+// from serving-openapi.json; this file keeps the package's public names
+// stable over the generated ones.
+export {};
+//# sourceMappingURL=subscriptions.js.map

package/dist/contract/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/contract/subscriptions.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,wEAAwE;AACxE,kCAAkC"}

package/dist/contract/telemetry.d.ts

@@ -0,0 +1,48 @@
+/** Why an attempted approval submit produced no request. */
+export type ApprovalSubmitDropReason = "no_active_thread" | "card_missing" | "already_submitting" | "not_actionable_answered" | "not_actionable_stale" | "no_turn_id";
+/** ApprovalCardStatus["kind"] (core/approval-inbox.ts) restated: the contract
+ *  layer never imports core; the store's `card.status.kind` pass pins drift. */
+type ApprovalCardStatusKind = "actionable" | "submitting" | "answered" | "stale";
+export interface ApprovalSubmitTelemetryEvent {
+    name: "approval_submit_attempted" | "approval_submit_sent" | "approval_submit_dropped";
+    properties: {
+        interrupt_id: string;
+        thread_id: string | null;
+        approved: boolean;
+        trusted: boolean;
+        /** The rendered card's status kind at handler entry. */
+        card_status: ApprovalCardStatusKind;
+        parked: boolean;
+        drop_reason?: ApprovalSubmitDropReason;
+    };
+}
+/** How a stream fetch failed: where in the request's life the wire died,
+ *  since each class has a different owner (network, edge, origin, client). */
+export type StreamFailureClass = "network_rejected" | "http_error" | "no_body" | "mid_stream" | "parse_or_validation" | "client_abort";
+/** One stream failure, narrated for the host's analytics. Cursor fields
+ *  locate it on the recorded log; NEVER message text, tool args or prompts. */
+export interface StreamFailedTelemetryEvent {
+    name: "assistant_stream_failed";
+    properties: {
+        failure_class: StreamFailureClass;
+        /** The HTTP status when a response arrived; null before one. */
+        status: number | null;
+        thread_id: string | null;
+        /** The resume snapshot's cursor a reconnect would replay past. */
+        resume_cursor: string | null;
+        /** The last SSE `id:` the dying connection committed. */
+        last_committed_sse_id: string | null;
+    };
+}
+export type AssistantTelemetryEvent = ApprovalSubmitTelemetryEvent | StreamFailedTelemetryEvent;
+/** Classify a stream failure off the transport's shapes: runHttpRequest
+ *  stamps `.status` on a non-2xx, a missing body is its fixed sentence,
+ *  protocol refusals are AGUIError, schema rejections are raw ZodErrors. A
+ *  network death is a bare TypeError at BOTH ends of the request's life, so
+ *  the caller says whether the body delivered any bytes (keepalives count):
+ *  with bytes the wire died mid-stream; without, no response ever flowed. */
+export declare function streamFailureClassOf(error: Error, context: {
+    sawBodyBytes: boolean;
+}): StreamFailureClass;
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/contract/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/contract/telemetry.ts"],"names":[],"mappings":"AAMA,4DAA4D;AAC5D,MAAM,MAAM,wBAAwB,GAGhC,kBAAkB,GAElB,cAAc,GAEd,oBAAoB,GAEpB,yBAAyB,GACzB,sBAAsB,GAEtB,YAAY,CAAC;AAEjB;gFACgF;AAChF,KAAK,sBAAsB,GACzB,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EACA,2BAA2B,GAC3B,sBAAsB,GACtB,yBAAyB,CAAC;IAC9B,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,wDAAwD;QACxD,WAAW,EAAE,sBAAsB,CAAC;QACpC,MAAM,EAAE,OAAO,CAAC;QAChB,WAAW,CAAC,EAAE,wBAAwB,CAAC;KACxC,CAAC;CACH;AAED;8EAC8E;AAC9E,MAAM,MAAM,kBAAkB,GAE1B,kBAAkB,GAElB,YAAY,GAEZ,SAAS,GAET,YAAY,GAEZ,qBAAqB,GAErB,cAAc,CAAC;AAEnB;+EAC+E;AAC/E,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,yBAAyB,CAAC;IAChC,UAAU,EAAE;QACV,aAAa,EAAE,kBAAkB,CAAC;QAClC,gEAAgE;QAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,kEAAkE;QAClE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,yDAAyD;QACzD,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;KACtC,CAAC;CACH;AAED,MAAM,MAAM,uBAAuB,GACjC,4BAA4B,GAAG,0BAA0B,CAAC;AAE5D;;;;;6EAK6E;AAC7E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE;IAAE,YAAY,EAAE,OAAO,CAAA;CAAE,GACjC,kBAAkB,CAiBpB"}

package/dist/contract/telemetry.js

@@ -0,0 +1,29 @@
+// The package's product-telemetry seam: safety-critical human
+// controls must never fail silently, so the approval submit path narrates
+// itself as events the host forwards through onTelemetry (never an SDK here).
+import { AGUIError } from "@ag-ui/core";
+/** Classify a stream failure off the transport's shapes: runHttpRequest
+ *  stamps `.status` on a non-2xx, a missing body is its fixed sentence,
+ *  protocol refusals are AGUIError, schema rejections are raw ZodErrors. A
+ *  network death is a bare TypeError at BOTH ends of the request's life, so
+ *  the caller says whether the body delivered any bytes (keepalives count):
+ *  with bytes the wire died mid-stream; without, no response ever flowed. */
+export function streamFailureClassOf(error, context) {
+    if (error.name === "AbortError" || /\baborted?\b/i.test(error.message)) {
+        return "client_abort";
+    }
+    if (typeof error.status === "number") {
+        return "http_error";
+    }
+    if (error instanceof AGUIError || error.name === "ZodError") {
+        return "parse_or_validation";
+    }
+    if (error.message.includes("Failed to getReader")) {
+        return "no_body";
+    }
+    if (error instanceof TypeError) {
+        return context.sawBodyBytes ? "mid_stream" : "network_rejected";
+    }
+    return "mid_stream";
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/contract/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/contract/telemetry.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,0EAA0E;AAC1E,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA0ExC;;;;;6EAK6E;AAC7E,MAAM,UAAU,oBAAoB,CAClC,KAAY,EACZ,OAAkC;IAElC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,IAAI,OAAQ,KAA8B,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/D,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC5D,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAClE,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/contract/threads.d.ts

@@ -0,0 +1,4 @@
+export type { CreateServingAttachmentUploadResponse as AttachmentUploadIntent, HighlightResult, NavigateResult, PrefillFormResult, ReadPageResult, ResolveServingTurnApprovalRequest as ResolveTurnApprovalRequest, ResolveServingTurnApprovalResponse as ResolveTurnApprovalResponse, ResolveServingTurnToolResultsRequest as ResolveTurnToolResultsRequest, ResolveServingTurnToolResultsResponse as ResolveTurnToolResultsResponse, SendServingAssistantMessageRequest as SendAssistantMessageRequest, SendServingAssistantMessageResponse as SendAssistantMessageResponse, ServingApprovalDelivery as ApprovalDelivery, ServingAssistantThreadDetailResponse as AssistantThreadDetailResponse, ServingAssistantThreadResponse as ServingAssistantThread, ServingAssistantTurnResponse as ServingAssistantTurn, ServingAttachmentResponse as ServingAttachment, ServingTurnApprovalDecision as TurnApprovalDecision, ServingTurnAttachmentResponse as TurnAttachment, StopServingTurnResponse as StopTurnResponse, ThreadModelPickResponse as ThreadModelPick, AssistantTurnStatus as TurnStatus, } from "../generated/models/index.js";
+export declare const ASSISTANT_MESSAGE_MAX_CHARS = 4000;
+export declare const ASSISTANT_MAX_ATTACHMENTS = 10;
+//# sourceMappingURL=threads.d.ts.map

package/dist/contract/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/contract/threads.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,qCAAqC,IAAI,sBAAsB,EAC/D,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iCAAiC,IAAI,0BAA0B,EAC/D,kCAAkC,IAAI,2BAA2B,EACjE,oCAAoC,IAAI,6BAA6B,EACrE,qCAAqC,IAAI,8BAA8B,EACvE,kCAAkC,IAAI,2BAA2B,EACjE,mCAAmC,IAAI,4BAA4B,EACnE,uBAAuB,IAAI,gBAAgB,EAC3C,oCAAoC,IAAI,6BAA6B,EACrE,8BAA8B,IAAI,sBAAsB,EACxD,4BAA4B,IAAI,oBAAoB,EACpD,yBAAyB,IAAI,iBAAiB,EAC9C,2BAA2B,IAAI,oBAAoB,EACnD,6BAA6B,IAAI,cAAc,EAC/C,uBAAuB,IAAI,gBAAgB,EAC3C,uBAAuB,IAAI,eAAe,EAC1C,mBAAmB,IAAI,UAAU,GAClC,MAAM,8BAA8B,CAAC;AAMtC,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAIhD,eAAO,MAAM,yBAAyB,KAAK,CAAC"}

package/dist/contract/threads.js

@@ -0,0 +1,13 @@
+// The conversation surfaces: send, list, detail, approval. The shapes are
+// generated from serving-openapi.json; this file keeps the package's
+// public names stable over the generated ones. The serving contract
+// stays normative for semantics (additive-only policy, tier rules).
+// Mirrors the send surface's message length bound, so the limit is felt
+// while typing rather than as a 422 after submitting. A runtime value the
+// schema carries only as a maxLength annotation — tests/contract-parity
+// pins it to serving-openapi.json.
+export const ASSISTANT_MESSAGE_MAX_CHARS = 4000;
+// Mirrors the send surface's attachment_ids bound the same way — the
+// composer refuses an eleventh chip instead of surfacing a 422.
+export const ASSISTANT_MAX_ATTACHMENTS = 10;
+//# sourceMappingURL=threads.js.map

package/dist/contract/threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../src/contract/threads.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,oEAAoE;AACpE,oEAAoE;AA0BpE,wEAAwE;AACxE,0EAA0E;AAC1E,wEAAwE;AACxE,mCAAmC;AACnC,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD,qEAAqE;AACrE,gEAAgE;AAChE,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC"}

package/dist/core/activity-title.d.ts

@@ -0,0 +1,2 @@
+export declare function activityTitleOf(label: string): string;
+//# sourceMappingURL=activity-title.d.ts.map

package/dist/core/activity-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-title.d.ts","sourceRoot":"","sources":["../../src/core/activity-title.ts"],"names":[],"mappings":"AAQA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMrD"}

package/dist/core/activity-title.js

@@ -0,0 +1,14 @@
+// Compact visible activity copy for a dispatch label: the first
+// MAX_TITLE_CHARS characters of the whitespace-collapsed label, with an
+// ellipsis when anything was cut. No sentence detection — a prefix is all
+// a one-line row needs, and callers keep the complete label in the title
+// attribute.
+const MAX_TITLE_CHARS = 64;
+export function activityTitleOf(label) {
+    const compact = label.trim().replace(/\s+/g, " ");
+    if (compact.length <= MAX_TITLE_CHARS) {
+        return compact;
+    }
+    return `${compact.slice(0, MAX_TITLE_CHARS - 1).trimEnd()}…`;
+}
+//# sourceMappingURL=activity-title.js.map

package/dist/core/activity-title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-title.js","sourceRoot":"","sources":["../../src/core/activity-title.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wEAAwE;AACxE,0EAA0E;AAC1E,yEAAyE;AACzE,aAAa;AAEb,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;AAC/D,CAAC"}

package/dist/core/activity.d.ts

@@ -0,0 +1,42 @@
+import type { ServingAssistantTurn, TurnStatus } from "../contract/threads.js";
+import type { ApprovalCardModel } from "./approval-inbox.js";
+import type { PendingDecisionGap } from "./pending-decision-gap.js";
+export interface AssistantActivityResult {
+    turnId: string;
+    status: TurnStatus;
+    failureSentence: string | null;
+}
+export interface AssistantActivitySnapshot {
+    busy: boolean;
+    newestTurnStatus: TurnStatus | null;
+    newestTurnId: string | null;
+    pendingApprovalCount: number;
+    pendingDecisionGap: PendingDecisionGap | null;
+    lastResult: AssistantActivityResult | null;
+}
+export declare const IDLE_ACTIVITY: AssistantActivitySnapshot;
+export declare function activitySnapshotOf(args: {
+    busy: boolean;
+    newestTurn: ServingAssistantTurn | null;
+    approvalCards: readonly ApprovalCardModel[];
+    pendingDecisionGap: PendingDecisionGap | null;
+    lastResult: AssistantActivityResult | null;
+}): AssistantActivitySnapshot;
+/** A settled turn becomes the feed's last result; a live one (queued,
+ *  working, awaiting_input, parked) leaves the previous result standing.
+ *  Machine turns (kind non-null, the delivery push) report here too,
+ *  DELIBERATELY: this feed's contract is "how did the last thing end",
+ *  not "did your message fail" — the conversation-level failure banner
+ *  (failureSentenceOf) is the surface that hides them. */
+export declare function settledResultOf(turn: ServingAssistantTurn): AssistantActivityResult | null;
+export declare function sameActivitySnapshot(a: AssistantActivitySnapshot, b: AssistantActivitySnapshot): boolean;
+/** Terminal turn statuses — the run reached an outcome and will not
+ *  produce further work. The completed-episode fold (core/run-folds.ts)
+ *  keys on this rather than on "running" (queued/working) so a
+ *  HITL pause (awaiting_input, parked) never unifies a turn mid-flight
+ *  and then pops its prose back out of the fold on resume. The one
+ *  settled-turn predicate in the package: the approval inbox's terminal
+ *  reconcile and the execution inbox's ledger's-word close both read it,
+ *  so the four words are spelled once against the generated union. */
+export declare function isTerminalTurnStatus(status: TurnStatus): boolean;
+//# sourceMappingURL=activity.d.ts.map

package/dist/core/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/core/activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQpE,MAAM,WAAW,uBAAuB;IAGtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,gBAAgB,EAAE,UAAU,GAAG,IAAI,CAAC;IAIpC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAI5B,oBAAoB,EAAE,MAAM,CAAC;IAO7B,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC5C;AAED,eAAO,MAAM,aAAa,EAAE,yBAO3B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxC,aAAa,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC5C,GAAG,yBAAyB,CAS5B;AAED;;;;;0DAK0D;AAC1D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,oBAAoB,GACzB,uBAAuB,GAAG,IAAI,CAShC;AAED,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,yBAAyB,EAC5B,CAAC,EAAE,yBAAyB,GAC3B,OAAO,CAWT;AAoBD;;;;;;;sEAOsE;AACtE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAOhE"}

package/dist/core/activity.js

@@ -0,0 +1,70 @@
+export const IDLE_ACTIVITY = {
+    busy: false,
+    newestTurnStatus: null,
+    newestTurnId: null,
+    pendingApprovalCount: 0,
+    pendingDecisionGap: null,
+    lastResult: null,
+};
+export function activitySnapshotOf(args) {
+    return {
+        busy: args.busy,
+        newestTurnStatus: args.newestTurn?.status ?? null,
+        newestTurnId: args.newestTurn?.id ?? null,
+        pendingApprovalCount: args.approvalCards.filter(_cardAwaitsTheHuman).length,
+        pendingDecisionGap: args.pendingDecisionGap,
+        lastResult: args.lastResult,
+    };
+}
+/** A settled turn becomes the feed's last result; a live one (queued,
+ *  working, awaiting_input, parked) leaves the previous result standing.
+ *  Machine turns (kind non-null, the delivery push) report here too,
+ *  DELIBERATELY: this feed's contract is "how did the last thing end",
+ *  not "did your message fail" — the conversation-level failure banner
+ *  (failureSentenceOf) is the surface that hides them. */
+export function settledResultOf(turn) {
+    if (!isTerminalTurnStatus(turn.status)) {
+        return null;
+    }
+    return {
+        turnId: turn.id,
+        status: turn.status,
+        failureSentence: turn.status === "failed" ? (turn.error ?? null) : null,
+    };
+}
+export function sameActivitySnapshot(a, b) {
+    return (a.busy === b.busy &&
+        a.newestTurnStatus === b.newestTurnStatus &&
+        a.newestTurnId === b.newestTurnId &&
+        a.pendingApprovalCount === b.pendingApprovalCount &&
+        // Reference identity is sound: the store keeps the published gap
+        // reference-stable while its signature holds.
+        a.pendingDecisionGap === b.pendingDecisionGap &&
+        _sameResult(a.lastResult, b.lastResult));
+}
+function _sameResult(a, b) {
+    if (a === null || b === null) {
+        return a === b;
+    }
+    return (a.turnId === b.turnId &&
+        a.status === b.status &&
+        a.failureSentence === b.failureSentence);
+}
+function _cardAwaitsTheHuman(card) {
+    return card.status.kind === "actionable" || card.status.kind === "submitting";
+}
+/** Terminal turn statuses — the run reached an outcome and will not
+ *  produce further work. The completed-episode fold (core/run-folds.ts)
+ *  keys on this rather than on "running" (queued/working) so a
+ *  HITL pause (awaiting_input, parked) never unifies a turn mid-flight
+ *  and then pops its prose back out of the fold on resume. The one
+ *  settled-turn predicate in the package: the approval inbox's terminal
+ *  reconcile and the execution inbox's ledger's-word close both read it,
+ *  so the four words are spelled once against the generated union. */
+export function isTerminalTurnStatus(status) {
+    return (status === "succeeded" ||
+        status === "failed" ||
+        status === "superseded" ||
+        status === "stopped");
+}
+//# sourceMappingURL=activity.js.map

package/dist/core/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/core/activity.ts"],"names":[],"mappings":"AAuCA,MAAM,CAAC,MAAM,aAAa,GAA8B;IACtD,IAAI,EAAE,KAAK;IACX,gBAAgB,EAAE,IAAI;IACtB,YAAY,EAAE,IAAI;IAClB,oBAAoB,EAAE,CAAC;IACvB,kBAAkB,EAAE,IAAI;IACxB,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,IAMlC;IACC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,gBAAgB,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,IAAI,IAAI;QACjD,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,IAAI;QACzC,oBAAoB,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,MAAM;QAC3E,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;0DAK0D;AAC1D,MAAM,UAAU,eAAe,CAC7B,IAA0B;IAE1B,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,eAAe,EAAE,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;KACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,CAA4B,EAC5B,CAA4B;IAE5B,OAAO,CACL,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;QACjB,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,gBAAgB;QACzC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,YAAY;QACjC,CAAC,CAAC,oBAAoB,KAAK,CAAC,CAAC,oBAAoB;QACjD,iEAAiE;QACjE,8CAA8C;QAC9C,CAAC,CAAC,kBAAkB,KAAK,CAAC,CAAC,kBAAkB;QAC7C,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,CAAiC,EACjC,CAAiC;IAEjC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,CACL,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QACrB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QACrB,CAAC,CAAC,eAAe,KAAK,CAAC,CAAC,eAAe,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAuB;IAClD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC;AAChF,CAAC;AAED;;;;;;;sEAOsE;AACtE,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,OAAO,CACL,MAAM,KAAK,WAAW;QACtB,MAAM,KAAK,QAAQ;QACnB,MAAM,KAAK,YAAY;QACvB,MAAM,KAAK,SAAS,CACrB,CAAC;AACJ,CAAC"}

package/dist/core/agent-identity.d.ts

@@ -0,0 +1,10 @@
+/** The primary assistant's identity token — one agent, one constant. */
+export declare const PRIMARY_AGENT_IDENTITY_TOKEN = "teaflask";
+/**
+ * A subagent's identity token: the child SESSION is the coworker's
+ * identity (a resume chain deliberately shares it — several asks
+ * of ONE coworker wear one mark), and the prefix makes a collision with
+ * the primary token structurally impossible.
+ */
+export declare function subagentIdentityTokenOf(childSessionId: string): string;
+//# sourceMappingURL=agent-identity.d.ts.map

package/dist/core/agent-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-identity.d.ts","sourceRoot":"","sources":["../../src/core/agent-identity.ts"],"names":[],"mappings":"AAUA,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEtE"}

package/dist/core/agent-identity.js

@@ -0,0 +1,21 @@
+// TeaFlask agent identity tokens (contract law 10). The DOM hooks
+// [data-tf-agent-identity] / [data-tf-subagent-identity] carry these as
+// their VALUES — a valueless hook is not an identity (TVC-090/091 read
+// the tokens, not the attributes' presence).
+//
+// Ownership note: this module mints the identity tokens alone; the
+// marks and their visible treatment are the renderer's. Every mark must
+// derive its token from this module — a second token spelling would
+// break TVC-091's cross-surface stability law.
+/** The primary assistant's identity token — one agent, one constant. */
+export const PRIMARY_AGENT_IDENTITY_TOKEN = "teaflask";
+/**
+ * A subagent's identity token: the child SESSION is the coworker's
+ * identity (a resume chain deliberately shares it — several asks
+ * of ONE coworker wear one mark), and the prefix makes a collision with
+ * the primary token structurally impossible.
+ */
+export function subagentIdentityTokenOf(childSessionId) {
+    return `subagent:${childSessionId}`;
+}
+//# sourceMappingURL=agent-identity.js.map

package/dist/core/agent-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-identity.js","sourceRoot":"","sources":["../../src/core/agent-identity.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,wEAAwE;AACxE,uEAAuE;AACvE,6CAA6C;AAC7C,EAAE;AACF,mEAAmE;AACnE,wEAAwE;AACxE,oEAAoE;AACpE,+CAA+C;AAE/C,wEAAwE;AACxE,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,cAAsB;IAC5D,OAAO,YAAY,cAAc,EAAE,CAAC;AACtC,CAAC"}

package/dist/core/approval-decision.d.ts

@@ -0,0 +1,7 @@
+import { type ApprovalCardModel, type ApprovalDecisionInput } from "./approval-inbox.js";
+import type { ActiveConversation } from "./conversation-contract.js";
+import type { AssistantConversationStore } from "./conversation-store.js";
+import type { ElicitationCardModel } from "./elicitation-cards.js";
+export declare function submitApprovalDecisionFromStore(store: AssistantConversationStore, card: ApprovalCardModel, decision: ApprovalDecisionInput): Promise<void>;
+export declare function turnIdAnsweredBy(store: AssistantConversationStore, active: ActiveConversation, card: ElicitationCardModel): Promise<string | null>;
+//# sourceMappingURL=approval-decision.d.ts.map

package/dist/core/approval-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-decision.d.ts","sourceRoot":"","sources":["../../src/core/approval-decision.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAE3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAKnE,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,0BAA0B,EACjC,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA2Ef;AA2LD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBxB"}