@cadenya/widgets 1.1.1 → 1.2.0

package/dist/types.d.ts

@@ -214,7 +214,7 @@ export interface WidgetErrorEvent {
  *  strings. Tool arguments cross this boundary only when an enabled tool set
  *  overlay explicitly opts the matching tool in.
  */
-export type WidgetEvent = WidgetEvent_UserMessage | WidgetEvent_AssistantMessage | WidgetEvent_ToolApprovalRequested | WidgetEvent_ToolApproved | WidgetEvent_ToolDenied | WidgetEvent_ToolCalled | WidgetEvent_ToolResult | WidgetEvent_ToolError | WidgetEvent_Error | WidgetEvent_Cancelled | WidgetEvent_TimedOut | WidgetEvent_Finalized;
+export type WidgetEvent = WidgetEvent_UserMessage | WidgetEvent_AssistantMessage | WidgetEvent_ToolApprovalRequested | WidgetEvent_ToolApproved | WidgetEvent_ToolDenied | WidgetEvent_ToolCalled | WidgetEvent_ToolResult | WidgetEvent_ToolError | WidgetEvent_Error | WidgetEvent_Cancelled | WidgetEvent_TimedOut | WidgetEvent_Finalized | WidgetEvent_Heartbeat | WidgetEvent_StateChanged;
 /**
  * WidgetFinalizedEvent: the conversation's agent produced its structured
  *  output and the objective reached its terminal state. Only agents with an
@@ -229,6 +229,23 @@ export interface WidgetFinalizedEvent {
      */
     output?: Record<string, unknown>;
 }
+/**
+ * WidgetHeartbeatEvent mirrors objective heartbeat liveness. It is live-only,
+ *  absent from history, and never a reconnect checkpoint or state transition.
+ */
+export interface WidgetHeartbeatEvent {
+}
+export type WidgetObjectiveStateChangedEventFromState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' | 'WIDGET_OBJECTIVE_STATE_PENDING' | 'WIDGET_OBJECTIVE_STATE_RUNNING' | 'WIDGET_OBJECTIVE_STATE_WAITING' | 'WIDGET_OBJECTIVE_STATE_FAILED' | 'WIDGET_OBJECTIVE_STATE_CANCELLED' | 'WIDGET_OBJECTIVE_STATE_FINALIZED' | 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';
+export type WidgetObjectiveStateChangedEventToState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' | 'WIDGET_OBJECTIVE_STATE_PENDING' | 'WIDGET_OBJECTIVE_STATE_RUNNING' | 'WIDGET_OBJECTIVE_STATE_WAITING' | 'WIDGET_OBJECTIVE_STATE_FAILED' | 'WIDGET_OBJECTIVE_STATE_CANCELLED' | 'WIDGET_OBJECTIVE_STATE_FINALIZED' | 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';
+/**
+ * WidgetObjectiveStateChangedEvent mirrors a durable objective transition.
+ *  Internal status messages are intentionally omitted. Pending/running maps
+ *  to a responding conversation, waiting to open, and terminal states to closed.
+ */
+export interface WidgetObjectiveStateChangedEvent {
+    fromState: WidgetObjectiveStateChangedEventFromState;
+    toState: WidgetObjectiveStateChangedEventToState;
+}
 /**
  * WidgetTimedOutEvent: the conversation timed out after inactivity. Terminal.
  */
@@ -327,8 +344,9 @@ export interface WidgetEvent_UserMessage {
     type: 'userMessage';
     userMessage: WidgetUserMessageEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -341,8 +359,9 @@ export interface WidgetEvent_AssistantMessage {
     type: 'assistantMessage';
     assistantMessage: WidgetAssistantMessageEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -355,8 +374,9 @@ export interface WidgetEvent_ToolApprovalRequested {
     type: 'toolApprovalRequested';
     toolApprovalRequested: WidgetToolApprovalRequestedEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -369,8 +389,9 @@ export interface WidgetEvent_ToolApproved {
     type: 'toolApproved';
     toolApproved: WidgetToolApprovedEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -383,8 +404,9 @@ export interface WidgetEvent_ToolDenied {
     type: 'toolDenied';
     toolDenied: WidgetToolDeniedEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -397,8 +419,9 @@ export interface WidgetEvent_ToolCalled {
     type: 'toolCalled';
     toolCalled: WidgetToolCalledEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -411,8 +434,9 @@ export interface WidgetEvent_ToolResult {
     type: 'toolResult';
     toolResult: WidgetToolResultEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -425,8 +449,9 @@ export interface WidgetEvent_ToolError {
     type: 'toolError';
     toolError: WidgetToolErrorEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -439,8 +464,9 @@ export interface WidgetEvent_Error {
     type: 'error';
     error: WidgetErrorEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -453,8 +479,9 @@ export interface WidgetEvent_Cancelled {
     type: 'cancelled';
     cancelled: WidgetCancelledEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -467,8 +494,9 @@ export interface WidgetEvent_TimedOut {
     type: 'timedOut';
     timedOut: WidgetTimedOutEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**
@@ -481,8 +509,39 @@ export interface WidgetEvent_Finalized {
     type: 'finalized';
     finalized: WidgetFinalizedEvent;
     /**
-     * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-     *  `Last-Event-ID` on reconnect to resume without duplication.
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
+     */
+    id: string;
+    /**
+     * The conversation this event belongs to.
+     */
+    conversationId: string;
+    createdAt: string;
+}
+export interface WidgetEvent_Heartbeat {
+    type: 'heartbeat';
+    heartbeat: WidgetHeartbeatEvent;
+    /**
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
+     */
+    id: string;
+    /**
+     * The conversation this event belongs to.
+     */
+    conversationId: string;
+    createdAt: string;
+}
+export interface WidgetEvent_StateChanged {
+    type: 'stateChanged';
+    stateChanged: WidgetObjectiveStateChangedEvent;
+    /**
+     * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+     *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+     *  Transient heartbeats carry hb_ IDs in this payload only.
      */
     id: string;
     /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6CAA6C","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\n/**\n * Approve tool call request. Responds to a toolApprovalRequested event.\n */\nexport interface ApproveToolCallRequest {\n  /**\n   * Conversation ID.\n   */\n  id?: string;\n  /**\n   * The tool call awaiting a decision, from the toolApprovalRequested event.\n   */\n  toolCallId?: string;\n}\n\n/**\n * Continue conversation request.\n */\nexport interface ContinueConversationRequest {\n  /**\n   * Conversation ID.\n   */\n  id?: string;\n  /**\n   * The visitor's next message.\n   */\n  message: string;\n}\n\n/**\n * Create conversation request. The session, tenant, subject, secrets, labels,\n *  and pinned parameters all come from the presenting token's session — the\n *  browser asserts nothing.\n */\nexport interface CreateConversationRequest {\n  /**\n   * The visitor's opening message.\n   */\n  message: string;\n}\n\n/**\n * Deny tool call request. Responds to a toolApprovalRequested event.\n */\nexport interface DenyToolCallRequest {\n  /**\n   * Conversation ID.\n   */\n  id?: string;\n  /**\n   * The tool call awaiting a decision, from the toolApprovalRequested event.\n   */\n  toolCallId?: string;\n}\n\n/**\n * Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.\n */\nexport interface GoogleProtobufAny {\n  /**\n   * The type of the serialized message.\n   */\n  '@type'?: string;\n}\n\n/**\n * Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.\n */\nexport type GoogleProtobufValue = unknown;\n\n/**\n * List conversation events response. Ordered oldest first.\n */\nexport interface ListConversationEventsResponse {\n  items?: Array<WidgetEvent>;\n  pagination?: Page;\n}\n\n/**\n * List conversations response. Ordered by last activity, newest first.\n */\nexport interface ListConversationsResponse {\n  items?: Array<WidgetConversation>;\n  pagination?: Page;\n}\n\n/**\n * Page carries pagination data for list responses. A deliberate local\n *  duplicate of the api module's Page — this package imports nothing from\n *  cadenya.api.v1 (see the workspace README).\n */\nexport interface Page {\n  /**\n   * Cursor for the next page. Empty when there are no further results.\n   */\n  nextCursor?: string;\n  /**\n   * Total number of items matching the request.\n   */\n  total?: number;\n}\n\n/**\n * Set tool call content request. Lets the embedding page supply the result\n *  of a bare tool call (one whose tool set has no execution adapter) — the\n *  widget-session flavor of the reverse-harness pattern, where client-side\n *  logic executes the tool and reports the result back. The result then\n *  reaches the conversation as a toolResult event.\n */\nexport interface SetToolCallContentRequest {\n  /**\n   * Conversation ID.\n   */\n  id?: string;\n  /**\n   * The bare tool call to supply content for.\n   */\n  toolCallId?: string;\n  /**\n   * The tool call's result content.\n   */\n  content: string;\n}\n\n/**\n * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).\n */\nexport interface Status {\n  /**\n   * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].\n   */\n  code?: number;\n  /**\n   * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.\n   */\n  message?: string;\n  /**\n   * A list of messages that carry the error details.  There is a common set of message types for APIs to use.\n   */\n  details?: Array<GoogleProtobufAny>;\n}\n\n/**\n * Submit conversation feedback request — the visitor's rating of a\n *  conversation, mirroring internal objective feedback in slimmed form. Flows\n *  into the same feedback machinery that scores agent variations.\n */\nexport interface SubmitConversationFeedbackRequest {\n  /**\n   * Conversation ID.\n   */\n  id?: string;\n  /**\n   * A score between -1.0 and 1.0. -1.0 is the worst, 0.0 neutral, 1.0 the\n   *  best — a thumbs-down/up UI maps to -1.0/1.0.\n   */\n  score: number;\n  /**\n   * Optional comment explaining the feedback.\n   */\n  comment?: string;\n}\n\n/**\n * WidgetAssistantMessageEvent is a message from the agent. Content may\n *  arrive incrementally: later events for the same turn replace earlier\n *  partial content.\n */\nexport interface WidgetAssistantMessageEvent {\n  content: string;\n}\n\n/**\n * WidgetCancelledEvent: the conversation was cancelled. Terminal.\n */\nexport interface WidgetCancelledEvent {\n}\n\n/**\n * WidgetConfig is the widget's presentation configuration, served to the\n *  browser before any session exists. Contains nothing sensitive: the widget\n *  is identified by the hostname, and the edge has already enforced the\n *  origin allowlist by the time this is served.\n */\nexport interface WidgetConfig {\n  /**\n   * Display name shown in the widget header.\n   */\n  displayName: string;\n}\n\nexport type WidgetConversationState = 'STATE_UNSPECIFIED' | 'STATE_RESPONDING' | 'STATE_OPEN' | 'STATE_CLOSED';\n\n/**\n * WidgetConversation is one conversation between the session's visitor and\n *  the widget's agent. Conversations are scoped by the presenting token to the\n *  VISITOR: a session with a subject sees that subject's conversations on this\n *  widget; a session without one sees only the conversations it created\n *  itself. A conversation id from outside that scope is indistinguishable from\n *  one that does not exist. Tenant is a management-side grouping only — it is\n *  never a read scope on this surface.\n */\nexport interface WidgetConversation {\n  id: string;\n  state: WidgetConversationState;\n  /**\n   * Server-derived display title (e.g. from the opening message).\n   */\n  title?: string;\n  createdAt: string;\n  /**\n   * When the conversation last saw a message or event.\n   */\n  lastActiveAt?: string;\n}\n\n/**\n * WidgetErrorEvent reports a visitor-safe conversation error. The message is\n *  sanitized; internal error detail never reaches the widget.\n */\nexport interface WidgetErrorEvent {\n  message: string;\n}\n\n/**\n * WidgetEvent is the visitor-facing event vocabulary. It MIRRORS the internal\n *  conversation event variants — same granularity, same discriminator names —\n *  with slimmed messages holding exactly what a widget UI needs. Internal\n *  events map to these through an explicit, exhaustive server-side projection;\n *  internal-only types (context compaction, memory reads, sub-agent\n *  bookkeeping) have no widget variant and are dropped. Nothing here carries\n *  tool configuration, server identities, operator details, or internal error\n *  strings. Tool arguments cross this boundary only when an enabled tool set\n *  overlay explicitly opts the matching tool in.\n */\nexport type WidgetEvent =\n  | WidgetEvent_UserMessage\n  | WidgetEvent_AssistantMessage\n  | WidgetEvent_ToolApprovalRequested\n  | WidgetEvent_ToolApproved\n  | WidgetEvent_ToolDenied\n  | WidgetEvent_ToolCalled\n  | WidgetEvent_ToolResult\n  | WidgetEvent_ToolError\n  | WidgetEvent_Error\n  | WidgetEvent_Cancelled\n  | WidgetEvent_TimedOut\n  | WidgetEvent_Finalized;\n\n/**\n * WidgetFinalizedEvent: the conversation's agent produced its structured\n *  output and the objective reached its terminal state. Only agents with an\n *  output definition finalize — such an agent ends the conversation after one\n *  turn, so a widget bound to one should treat this as the answer, not a\n *  message to keep chatting past.\n */\nexport interface WidgetFinalizedEvent {\n  /**\n   * The structured output the agent produced, matching the shape of the\n   *  agent's output definition schema.\n   */\n  output?: Record<string, unknown>;\n}\n\n/**\n * WidgetTimedOutEvent: the conversation timed out after inactivity. Terminal.\n */\nexport interface WidgetTimedOutEvent {\n}\n\n/**\n * WidgetToolApprovalRequestedEvent asks the visitor to approve or deny a\n *  tool call before it runs. The tool reference lets the embedding UI render\n *  a custom approval experience per tool; the visitor responds via the\n *  approve/deny endpoints.\n */\nexport interface WidgetToolApprovalRequestedEvent {\n  /**\n   * The tool call awaiting a decision; pass it to the approve/deny endpoint.\n   */\n  toolCallId: string;\n  tool: WidgetToolReference;\n}\n\n/**\n * WidgetToolApprovedEvent records that the pending tool call was approved.\n */\nexport interface WidgetToolApprovedEvent {\n  toolCallId: string;\n}\n\n/**\n * WidgetToolCalledEvent reports that the agent invoked a tool.\n */\nexport interface WidgetToolCalledEvent {\n  toolCallId: string;\n  tool: WidgetToolReference;\n  /**\n   * The final arguments sent to the tool, after parameter actions were\n   *  applied. Present only when an enabled matching tool set overlay opts the\n   *  tool into exposing arguments in widget sessions. Arguments are omitted\n   *  by default because they may contain sensitive customer data.\n   */\n  arguments?: Record<string, unknown>;\n}\n\n/**\n * WidgetToolDeniedEvent records that the pending tool call was denied.\n */\nexport interface WidgetToolDeniedEvent {\n  toolCallId: string;\n}\n\n/**\n * WidgetToolErrorEvent reports that a tool call failed. Internal error\n *  detail never reaches the widget.\n */\nexport interface WidgetToolErrorEvent {\n  toolCallId: string;\n  tool: WidgetToolReference;\n}\n\n/**\n * WidgetToolReference identifies the tool involved in a tool event — enough\n *  for the embedding UI to label the activity and to register custom\n *  renderers keyed by the tool's id or the customer's own external id.\n *  Deliberately omitted: tool configuration, adapter details, and any server\n *  identity.\n */\nexport interface WidgetToolReference {\n  /**\n   * Cadenya's canonical tool id.\n   */\n  id: string;\n  /**\n   * The tool's external id in the customer's namespace, when set.\n   */\n  externalId?: string;\n  /**\n   * The tool's name as the workspace configured it (e.g. \"FetchOrderDetails\").\n   */\n  name: string;\n}\n\n/**\n * WidgetToolResultEvent reports that a tool call finished. Result content is\n *  omitted by default and included only for tools the workspace has opted in\n *  to sharing content with widget sessions.\n */\nexport interface WidgetToolResultEvent {\n  toolCallId: string;\n  tool: WidgetToolReference;\n  /**\n   * The tool's result, present only for tools opted in to sharing content\n   *  with widget sessions (a per-tool setting; default off). Arbitrary JSON\n   *  the embedding UI may render — chart data, cards, structured results.\n   */\n  content?: GoogleProtobufValue;\n}\n\n/**\n * WidgetUserMessageEvent is a message from the visitor.\n */\nexport interface WidgetUserMessageEvent {\n  content: string;\n}\n\nexport interface WidgetEvent_UserMessage {\n  type: 'userMessage';\n  userMessage: WidgetUserMessageEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_AssistantMessage {\n  type: 'assistantMessage';\n  assistantMessage: WidgetAssistantMessageEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolApprovalRequested {\n  type: 'toolApprovalRequested';\n  toolApprovalRequested: WidgetToolApprovalRequestedEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolApproved {\n  type: 'toolApproved';\n  toolApproved: WidgetToolApprovedEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolDenied {\n  type: 'toolDenied';\n  toolDenied: WidgetToolDeniedEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolCalled {\n  type: 'toolCalled';\n  toolCalled: WidgetToolCalledEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolResult {\n  type: 'toolResult';\n  toolResult: WidgetToolResultEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolError {\n  type: 'toolError';\n  toolError: WidgetToolErrorEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_Error {\n  type: 'error';\n  error: WidgetErrorEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_Cancelled {\n  type: 'cancelled';\n  cancelled: WidgetCancelledEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_TimedOut {\n  type: 'timedOut';\n  timedOut: WidgetTimedOutEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_Finalized {\n  type: 'finalized';\n  finalized: WidgetFinalizedEvent;\n  /**\n   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as\n   *  `Last-Event-ID` on reconnect to resume without duplication.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6CAA6C","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\n/**\n * Approve tool call request. Responds to a toolApprovalRequested event.\n */\nexport interface ApproveToolCallRequest {\n  /**\n   * Conversation ID.\n   */\n  id?: string;\n  /**\n   * The tool call awaiting a decision, from the toolApprovalRequested event.\n   */\n  toolCallId?: string;\n}\n\n/**\n * Continue conversation request.\n */\nexport interface ContinueConversationRequest {\n  /**\n   * Conversation ID.\n   */\n  id?: string;\n  /**\n   * The visitor's next message.\n   */\n  message: string;\n}\n\n/**\n * Create conversation request. The session, tenant, subject, secrets, labels,\n *  and pinned parameters all come from the presenting token's session — the\n *  browser asserts nothing.\n */\nexport interface CreateConversationRequest {\n  /**\n   * The visitor's opening message.\n   */\n  message: string;\n}\n\n/**\n * Deny tool call request. Responds to a toolApprovalRequested event.\n */\nexport interface DenyToolCallRequest {\n  /**\n   * Conversation ID.\n   */\n  id?: string;\n  /**\n   * The tool call awaiting a decision, from the toolApprovalRequested event.\n   */\n  toolCallId?: string;\n}\n\n/**\n * Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.\n */\nexport interface GoogleProtobufAny {\n  /**\n   * The type of the serialized message.\n   */\n  '@type'?: string;\n}\n\n/**\n * Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.\n */\nexport type GoogleProtobufValue = unknown;\n\n/**\n * List conversation events response. Ordered oldest first.\n */\nexport interface ListConversationEventsResponse {\n  items?: Array<WidgetEvent>;\n  pagination?: Page;\n}\n\n/**\n * List conversations response. Ordered by last activity, newest first.\n */\nexport interface ListConversationsResponse {\n  items?: Array<WidgetConversation>;\n  pagination?: Page;\n}\n\n/**\n * Page carries pagination data for list responses. A deliberate local\n *  duplicate of the api module's Page — this package imports nothing from\n *  cadenya.api.v1 (see the workspace README).\n */\nexport interface Page {\n  /**\n   * Cursor for the next page. Empty when there are no further results.\n   */\n  nextCursor?: string;\n  /**\n   * Total number of items matching the request.\n   */\n  total?: number;\n}\n\n/**\n * Set tool call content request. Lets the embedding page supply the result\n *  of a bare tool call (one whose tool set has no execution adapter) — the\n *  widget-session flavor of the reverse-harness pattern, where client-side\n *  logic executes the tool and reports the result back. The result then\n *  reaches the conversation as a toolResult event.\n */\nexport interface SetToolCallContentRequest {\n  /**\n   * Conversation ID.\n   */\n  id?: string;\n  /**\n   * The bare tool call to supply content for.\n   */\n  toolCallId?: string;\n  /**\n   * The tool call's result content.\n   */\n  content: string;\n}\n\n/**\n * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).\n */\nexport interface Status {\n  /**\n   * The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].\n   */\n  code?: number;\n  /**\n   * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.\n   */\n  message?: string;\n  /**\n   * A list of messages that carry the error details.  There is a common set of message types for APIs to use.\n   */\n  details?: Array<GoogleProtobufAny>;\n}\n\n/**\n * Submit conversation feedback request — the visitor's rating of a\n *  conversation, mirroring internal objective feedback in slimmed form. Flows\n *  into the same feedback machinery that scores agent variations.\n */\nexport interface SubmitConversationFeedbackRequest {\n  /**\n   * Conversation ID.\n   */\n  id?: string;\n  /**\n   * A score between -1.0 and 1.0. -1.0 is the worst, 0.0 neutral, 1.0 the\n   *  best — a thumbs-down/up UI maps to -1.0/1.0.\n   */\n  score: number;\n  /**\n   * Optional comment explaining the feedback.\n   */\n  comment?: string;\n}\n\n/**\n * WidgetAssistantMessageEvent is a message from the agent. Content may\n *  arrive incrementally: later events for the same turn replace earlier\n *  partial content.\n */\nexport interface WidgetAssistantMessageEvent {\n  content: string;\n}\n\n/**\n * WidgetCancelledEvent: the conversation was cancelled. Terminal.\n */\nexport interface WidgetCancelledEvent {\n}\n\n/**\n * WidgetConfig is the widget's presentation configuration, served to the\n *  browser before any session exists. Contains nothing sensitive: the widget\n *  is identified by the hostname, and the edge has already enforced the\n *  origin allowlist by the time this is served.\n */\nexport interface WidgetConfig {\n  /**\n   * Display name shown in the widget header.\n   */\n  displayName: string;\n}\n\nexport type WidgetConversationState = 'STATE_UNSPECIFIED' | 'STATE_RESPONDING' | 'STATE_OPEN' | 'STATE_CLOSED';\n\n/**\n * WidgetConversation is one conversation between the session's visitor and\n *  the widget's agent. Conversations are scoped by the presenting token to the\n *  VISITOR: a session with a subject sees that subject's conversations on this\n *  widget; a session without one sees only the conversations it created\n *  itself. A conversation id from outside that scope is indistinguishable from\n *  one that does not exist. Tenant is a management-side grouping only — it is\n *  never a read scope on this surface.\n */\nexport interface WidgetConversation {\n  id: string;\n  state: WidgetConversationState;\n  /**\n   * Server-derived display title (e.g. from the opening message).\n   */\n  title?: string;\n  createdAt: string;\n  /**\n   * When the conversation last saw a message or event.\n   */\n  lastActiveAt?: string;\n}\n\n/**\n * WidgetErrorEvent reports a visitor-safe conversation error. The message is\n *  sanitized; internal error detail never reaches the widget.\n */\nexport interface WidgetErrorEvent {\n  message: string;\n}\n\n/**\n * WidgetEvent is the visitor-facing event vocabulary. It MIRRORS the internal\n *  conversation event variants — same granularity, same discriminator names —\n *  with slimmed messages holding exactly what a widget UI needs. Internal\n *  events map to these through an explicit, exhaustive server-side projection;\n *  internal-only types (context compaction, memory reads, sub-agent\n *  bookkeeping) have no widget variant and are dropped. Nothing here carries\n *  tool configuration, server identities, operator details, or internal error\n *  strings. Tool arguments cross this boundary only when an enabled tool set\n *  overlay explicitly opts the matching tool in.\n */\nexport type WidgetEvent =\n  | WidgetEvent_UserMessage\n  | WidgetEvent_AssistantMessage\n  | WidgetEvent_ToolApprovalRequested\n  | WidgetEvent_ToolApproved\n  | WidgetEvent_ToolDenied\n  | WidgetEvent_ToolCalled\n  | WidgetEvent_ToolResult\n  | WidgetEvent_ToolError\n  | WidgetEvent_Error\n  | WidgetEvent_Cancelled\n  | WidgetEvent_TimedOut\n  | WidgetEvent_Finalized\n  | WidgetEvent_Heartbeat\n  | WidgetEvent_StateChanged;\n\n/**\n * WidgetFinalizedEvent: the conversation's agent produced its structured\n *  output and the objective reached its terminal state. Only agents with an\n *  output definition finalize — such an agent ends the conversation after one\n *  turn, so a widget bound to one should treat this as the answer, not a\n *  message to keep chatting past.\n */\nexport interface WidgetFinalizedEvent {\n  /**\n   * The structured output the agent produced, matching the shape of the\n   *  agent's output definition schema.\n   */\n  output?: Record<string, unknown>;\n}\n\n/**\n * WidgetHeartbeatEvent mirrors objective heartbeat liveness. It is live-only,\n *  absent from history, and never a reconnect checkpoint or state transition.\n */\nexport interface WidgetHeartbeatEvent {\n}\n\nexport type WidgetObjectiveStateChangedEventFromState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' | 'WIDGET_OBJECTIVE_STATE_PENDING' | 'WIDGET_OBJECTIVE_STATE_RUNNING' | 'WIDGET_OBJECTIVE_STATE_WAITING' | 'WIDGET_OBJECTIVE_STATE_FAILED' | 'WIDGET_OBJECTIVE_STATE_CANCELLED' | 'WIDGET_OBJECTIVE_STATE_FINALIZED' | 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';\n\nexport type WidgetObjectiveStateChangedEventToState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' | 'WIDGET_OBJECTIVE_STATE_PENDING' | 'WIDGET_OBJECTIVE_STATE_RUNNING' | 'WIDGET_OBJECTIVE_STATE_WAITING' | 'WIDGET_OBJECTIVE_STATE_FAILED' | 'WIDGET_OBJECTIVE_STATE_CANCELLED' | 'WIDGET_OBJECTIVE_STATE_FINALIZED' | 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';\n\n/**\n * WidgetObjectiveStateChangedEvent mirrors a durable objective transition.\n *  Internal status messages are intentionally omitted. Pending/running maps\n *  to a responding conversation, waiting to open, and terminal states to closed.\n */\nexport interface WidgetObjectiveStateChangedEvent {\n  fromState: WidgetObjectiveStateChangedEventFromState;\n  toState: WidgetObjectiveStateChangedEventToState;\n}\n\n/**\n * WidgetTimedOutEvent: the conversation timed out after inactivity. Terminal.\n */\nexport interface WidgetTimedOutEvent {\n}\n\n/**\n * WidgetToolApprovalRequestedEvent asks the visitor to approve or deny a\n *  tool call before it runs. The tool reference lets the embedding UI render\n *  a custom approval experience per tool; the visitor responds via the\n *  approve/deny endpoints.\n */\nexport interface WidgetToolApprovalRequestedEvent {\n  /**\n   * The tool call awaiting a decision; pass it to the approve/deny endpoint.\n   */\n  toolCallId: string;\n  tool: WidgetToolReference;\n}\n\n/**\n * WidgetToolApprovedEvent records that the pending tool call was approved.\n */\nexport interface WidgetToolApprovedEvent {\n  toolCallId: string;\n}\n\n/**\n * WidgetToolCalledEvent reports that the agent invoked a tool.\n */\nexport interface WidgetToolCalledEvent {\n  toolCallId: string;\n  tool: WidgetToolReference;\n  /**\n   * The final arguments sent to the tool, after parameter actions were\n   *  applied. Present only when an enabled matching tool set overlay opts the\n   *  tool into exposing arguments in widget sessions. Arguments are omitted\n   *  by default because they may contain sensitive customer data.\n   */\n  arguments?: Record<string, unknown>;\n}\n\n/**\n * WidgetToolDeniedEvent records that the pending tool call was denied.\n */\nexport interface WidgetToolDeniedEvent {\n  toolCallId: string;\n}\n\n/**\n * WidgetToolErrorEvent reports that a tool call failed. Internal error\n *  detail never reaches the widget.\n */\nexport interface WidgetToolErrorEvent {\n  toolCallId: string;\n  tool: WidgetToolReference;\n}\n\n/**\n * WidgetToolReference identifies the tool involved in a tool event — enough\n *  for the embedding UI to label the activity and to register custom\n *  renderers keyed by the tool's id or the customer's own external id.\n *  Deliberately omitted: tool configuration, adapter details, and any server\n *  identity.\n */\nexport interface WidgetToolReference {\n  /**\n   * Cadenya's canonical tool id.\n   */\n  id: string;\n  /**\n   * The tool's external id in the customer's namespace, when set.\n   */\n  externalId?: string;\n  /**\n   * The tool's name as the workspace configured it (e.g. \"FetchOrderDetails\").\n   */\n  name: string;\n}\n\n/**\n * WidgetToolResultEvent reports that a tool call finished. Result content is\n *  omitted by default and included only for tools the workspace has opted in\n *  to sharing content with widget sessions.\n */\nexport interface WidgetToolResultEvent {\n  toolCallId: string;\n  tool: WidgetToolReference;\n  /**\n   * The tool's result, present only for tools opted in to sharing content\n   *  with widget sessions (a per-tool setting; default off). Arbitrary JSON\n   *  the embedding UI may render — chart data, cards, structured results.\n   */\n  content?: GoogleProtobufValue;\n}\n\n/**\n * WidgetUserMessageEvent is a message from the visitor.\n */\nexport interface WidgetUserMessageEvent {\n  content: string;\n}\n\nexport interface WidgetEvent_UserMessage {\n  type: 'userMessage';\n  userMessage: WidgetUserMessageEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_AssistantMessage {\n  type: 'assistantMessage';\n  assistantMessage: WidgetAssistantMessageEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolApprovalRequested {\n  type: 'toolApprovalRequested';\n  toolApprovalRequested: WidgetToolApprovalRequestedEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolApproved {\n  type: 'toolApproved';\n  toolApproved: WidgetToolApprovedEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolDenied {\n  type: 'toolDenied';\n  toolDenied: WidgetToolDeniedEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolCalled {\n  type: 'toolCalled';\n  toolCalled: WidgetToolCalledEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolResult {\n  type: 'toolResult';\n  toolResult: WidgetToolResultEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_ToolError {\n  type: 'toolError';\n  toolError: WidgetToolErrorEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_Error {\n  type: 'error';\n  error: WidgetErrorEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_Cancelled {\n  type: 'cancelled';\n  cancelled: WidgetCancelledEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_TimedOut {\n  type: 'timedOut';\n  timedOut: WidgetTimedOutEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_Finalized {\n  type: 'finalized';\n  finalized: WidgetFinalizedEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_Heartbeat {\n  type: 'heartbeat';\n  heartbeat: WidgetHeartbeatEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\nexport interface WidgetEvent_StateChanged {\n  type: 'stateChanged';\n  stateChanged: WidgetObjectiveStateChangedEvent;\n  /**\n   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted\n   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.\n   *  Transient heartbeats carry hb_ IDs in this payload only.\n   */\n  id: string;\n  /**\n   * The conversation this event belongs to.\n   */\n  conversationId: string;\n  createdAt: string;\n}\n\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cadenya/widgets",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "The official TypeScript SDK for the CadenyaWidgets API",
   "license": "Apache-2.0",
   "type": "module",
@@ -13,12 +13,21 @@
     }
   },
   "sideEffects": false,
-  "publishConfig": { "access": "public" },
-  "repository": { "type": "git", "url": "https://github.com/cadenya/widgets-sdk" },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cadenya/widgets-sdk"
+  },
   "engines": {
     "node": ">=18"
   },
-  "files": ["dist", "src", "api.md"],
+  "files": [
+    "dist",
+    "src",
+    "api.md"
+  ],
   "scripts": {
     "build": "tsc",
     "typecheck": "tsc --noEmit"

package/src/types.ts

@@ -246,7 +246,9 @@ export type WidgetEvent =
   | WidgetEvent_Error
   | WidgetEvent_Cancelled
   | WidgetEvent_TimedOut
-  | WidgetEvent_Finalized;
+  | WidgetEvent_Finalized
+  | WidgetEvent_Heartbeat
+  | WidgetEvent_StateChanged;
 
 /**
  * WidgetFinalizedEvent: the conversation's agent produced its structured
@@ -263,6 +265,27 @@ export interface WidgetFinalizedEvent {
   output?: Record<string, unknown>;
 }
 
+/**
+ * WidgetHeartbeatEvent mirrors objective heartbeat liveness. It is live-only,
+ *  absent from history, and never a reconnect checkpoint or state transition.
+ */
+export interface WidgetHeartbeatEvent {
+}
+
+export type WidgetObjectiveStateChangedEventFromState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' | 'WIDGET_OBJECTIVE_STATE_PENDING' | 'WIDGET_OBJECTIVE_STATE_RUNNING' | 'WIDGET_OBJECTIVE_STATE_WAITING' | 'WIDGET_OBJECTIVE_STATE_FAILED' | 'WIDGET_OBJECTIVE_STATE_CANCELLED' | 'WIDGET_OBJECTIVE_STATE_FINALIZED' | 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';
+
+export type WidgetObjectiveStateChangedEventToState = 'WIDGET_OBJECTIVE_STATE_UNSPECIFIED' | 'WIDGET_OBJECTIVE_STATE_PENDING' | 'WIDGET_OBJECTIVE_STATE_RUNNING' | 'WIDGET_OBJECTIVE_STATE_WAITING' | 'WIDGET_OBJECTIVE_STATE_FAILED' | 'WIDGET_OBJECTIVE_STATE_CANCELLED' | 'WIDGET_OBJECTIVE_STATE_FINALIZED' | 'WIDGET_OBJECTIVE_STATE_TIMED_OUT';
+
+/**
+ * WidgetObjectiveStateChangedEvent mirrors a durable objective transition.
+ *  Internal status messages are intentionally omitted. Pending/running maps
+ *  to a responding conversation, waiting to open, and terminal states to closed.
+ */
+export interface WidgetObjectiveStateChangedEvent {
+  fromState: WidgetObjectiveStateChangedEventFromState;
+  toState: WidgetObjectiveStateChangedEventToState;
+}
+
 /**
  * WidgetTimedOutEvent: the conversation timed out after inactivity. Terminal.
  */
@@ -370,8 +393,9 @@ export interface WidgetEvent_UserMessage {
   type: 'userMessage';
   userMessage: WidgetUserMessageEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -385,8 +409,9 @@ export interface WidgetEvent_AssistantMessage {
   type: 'assistantMessage';
   assistantMessage: WidgetAssistantMessageEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -400,8 +425,9 @@ export interface WidgetEvent_ToolApprovalRequested {
   type: 'toolApprovalRequested';
   toolApprovalRequested: WidgetToolApprovalRequestedEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -415,8 +441,9 @@ export interface WidgetEvent_ToolApproved {
   type: 'toolApproved';
   toolApproved: WidgetToolApprovedEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -430,8 +457,9 @@ export interface WidgetEvent_ToolDenied {
   type: 'toolDenied';
   toolDenied: WidgetToolDeniedEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -445,8 +473,9 @@ export interface WidgetEvent_ToolCalled {
   type: 'toolCalled';
   toolCalled: WidgetToolCalledEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -460,8 +489,9 @@ export interface WidgetEvent_ToolResult {
   type: 'toolResult';
   toolResult: WidgetToolResultEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -475,8 +505,9 @@ export interface WidgetEvent_ToolError {
   type: 'toolError';
   toolError: WidgetToolErrorEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -490,8 +521,9 @@ export interface WidgetEvent_Error {
   type: 'error';
   error: WidgetErrorEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -505,8 +537,9 @@ export interface WidgetEvent_Cancelled {
   type: 'cancelled';
   cancelled: WidgetCancelledEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -520,8 +553,9 @@ export interface WidgetEvent_TimedOut {
   type: 'timedOut';
   timedOut: WidgetTimedOutEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**
@@ -535,8 +569,41 @@ export interface WidgetEvent_Finalized {
   type: 'finalized';
   finalized: WidgetFinalizedEvent;
   /**
-   * Unique event id (ULID). Doubles as the SSE `id:` — replay it as
-   *  `Last-Event-ID` on reconnect to resume without duplication.
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
+   */
+  id: string;
+  /**
+   * The conversation this event belongs to.
+   */
+  conversationId: string;
+  createdAt: string;
+}
+
+export interface WidgetEvent_Heartbeat {
+  type: 'heartbeat';
+  heartbeat: WidgetHeartbeatEvent;
+  /**
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
+   */
+  id: string;
+  /**
+   * The conversation this event belongs to.
+   */
+  conversationId: string;
+  createdAt: string;
+}
+
+export interface WidgetEvent_StateChanged {
+  type: 'stateChanged';
+  stateChanged: WidgetObjectiveStateChangedEvent;
+  /**
+   * Unique event id (prefixed ULID). Only durable objevt_ IDs are emitted
+   *  as SSE `id:` fields and accepted as Last-Event-ID reconnect cursors.
+   *  Transient heartbeats carry hb_ IDs in this payload only.
    */
   id: string;
   /**