@amodalai/runtime 0.3.49 → 0.3.50

package/dist/src/tools/types.d.ts

@@ -13,9 +13,9 @@
 import type { z } from 'zod';
 import type { FlexibleSchema } from 'ai';
 import type { SearchProvider } from '../providers/search-provider.js';
-import type { SSEAskChoiceEvent, SSEShowPreviewEvent, SSEStartOAuthEvent, SSECollectSecretEvent } from '../types.js';
-/** SSE events tools can emit inline during execution. */
-export type ToolInlineEvent = SSEAskChoiceEvent | SSEShowPreviewEvent | SSEStartOAuthEvent | SSECollectSecretEvent;
+import type { SSEAskChoiceEvent, SSEShowPreviewEvent, SSEConnectionPanelEvent, SSEPlanSummaryEvent, SSEProposalEvent, SSEUpdatePlanEvent, SSESetupCancelledEvent, SSESetupCompletedEvent, SSEToolLabelUpdateEvent } from '../types.js';
+/** Discriminated set of SSE events tools can emit inline. */
+export type ToolInlineEvent = SSEAskChoiceEvent | SSEShowPreviewEvent | SSEConnectionPanelEvent | SSEPlanSummaryEvent | SSEProposalEvent | SSEUpdatePlanEvent | SSESetupCancelledEvent | SSESetupCompletedEvent | SSEToolLabelUpdateEvent;
 /**
  * Context passed to every tool execute function.
  *
@@ -39,6 +39,35 @@ export interface ToolContext {
     env(name: string): string | undefined;
     /** Log a message (emitted as tool_log SSE event) */
     log(message: string): void;
+    /**
+     * Emit an inline SSE event (e.g. `show_preview`, `ask_choice`). Drained by
+     * the executing state and pushed onto the stream alongside the tool result.
+     * Tools that don't need inline UI never call this — keep the API surface
+     * narrow.
+     */
+    emit?(event: ToolInlineEvent): void;
+    /**
+     * Update the friendly running / completed phrase the chat ToolCallCard
+     * shows for this call. Either or both fields may be set; subsequent
+     * calls overwrite the previous values. Internally emits a
+     * `tool_label_update` SSE event the widget consumes to patch the
+     * card in-place — useful for long-running tools that move through
+     * stages ("Cloning…" → "Installing packages" → "Composed plan").
+     *
+     * `tool_call_start` already carries the static defaults from the
+     * tool's `runningLabel` / `completedLabel`, so a tool that doesn't
+     * call this still gets sensible labels.
+     */
+    setLabel?(opts: {
+        running?: string;
+        completed?: string;
+    }): void;
+    /**
+     * Sink populated by `emit()` and drained by the executing state. Public on
+     * the type so the caller can read it; not part of the documented tool API.
+     * @internal
+     */
+    inlineEvents?: ToolInlineEvent[];
     /** Abort signal for cancellation/timeout */
     signal: AbortSignal;
     /** Session ID for correlation */
@@ -53,17 +82,6 @@ export interface ToolContext {
     scopeId: string;
     /** Scope context key-value pairs associated with this scope */
     scopeContext?: Record<string, string>;
-    /**
-     * Emit an inline SSE event (e.g. `show_gallery`, `ask_choice`).
-     * Drained by the executing state and pushed onto the stream
-     * alongside the tool result.
-     */
-    emit?(event: ToolInlineEvent): void;
-    /**
-     * Sink populated by `emit()` and drained by the executing state.
-     * @internal
-     */
-    inlineEvents?: ToolInlineEvent[];
 }
 /** Tool category for permission lookup and UI grouping. */
 export type ToolCategory = 'store' | 'connection' | 'custom' | 'mcp' | 'admin' | 'system';
@@ -117,6 +135,27 @@ export interface ToolDefinition<TParams = unknown> {
     requiresConfirmation?: boolean;
     /** Optional metadata for permission, routing, and UI */
     metadata?: ToolMetadata;
+    /**
+     * Present-participle label rendered while the tool is running, e.g.
+     * "Looking up template 'marketing-digest'". Supports `{{paramName}}`
+     * substitution against the call's parameters. Optional — undefined
+     * tools fall back to their `name` in the UI.
+     */
+    runningLabel?: string;
+    /**
+     * Past-tense label rendered after the tool completes successfully,
+     * e.g. "Looked up template". Same `{{paramName}}` substitution as
+     * `runningLabel`. Optional — when omitted the UI keeps the running
+     * label after completion (the status icon differentiates them).
+     */
+    completedLabel?: string;
+    /**
+     * Marks the tool as internal plumbing the user shouldn't see by
+     * default (state I/O, version checks, coordination calls). Stamped
+     * onto `tool_call_start` / `tool_call_result` SSE events; the chat
+     * widget hides these calls unless `verboseTools` is enabled.
+     */
+    internal?: boolean;
 }
 /**
  * Registry holding all available tools for a session.

package/dist/src/tools/web-search-tool.js

@@ -118,6 +118,8 @@ If the first query returns off-topic results, rewrite more specifically and sear
         parameters: WebSearchParamsSchema,
         readOnly: true,
         metadata: { category: 'system' },
+        runningLabel: 'Searching the web for "{{query}}"',
+        completedLabel: 'Searched the web for "{{query}}"',
         async execute(params, ctx) {
             const maxResults = params.max_results ?? DEFAULT_MAX_RESULTS;
             if (!ctx.searchProvider) {

package/dist/src/tools/web-search-tool.js.map

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

package/dist/src/types.d.ts

@@ -136,6 +136,14 @@ export declare enum SSEEventType {
     KBProposal = "kb_proposal",
     CredentialSaved = "credential_saved",
     Approved = "approved",
+    AskChoice = "ask_choice",
+    ShowPreview = "show_preview",
+    ConnectionPanel = "connection_panel",
+    PlanSummary = "plan_summary",
+    Proposal = "proposal",
+    UpdatePlan = "update_plan",
+    SetupCancelled = "setup_cancelled",
+    SetupCompleted = "setup_completed",
     ExploreStart = "explore_start",
     ExploreEnd = "explore_end",
     PlanMode = "plan_mode",
@@ -144,13 +152,11 @@ export declare enum SSEEventType {
     CompactionStart = "compaction_start",
     CompactionEnd = "compaction_end",
     ToolLog = "tool_log",
+    ToolLabelUpdate = "tool_label_update",
     Warning = "warning",
     Error = "error",
     Done = "done",
-    AskChoice = "ask_choice",
-    ShowPreview = "show_preview",
-    StartOAuth = "start_oauth",
-    CollectSecret = "collect_secret"
+    StartOAuth = "start_oauth"
 }
 export interface SSEInitEvent {
     type: SSEEventType.Init;
@@ -167,6 +173,24 @@ export interface SSEToolCallStartEvent {
     tool_name: string;
     tool_id: string;
     parameters: Record<string, unknown>;
+    /**
+     * Resolved present-participle label rendered while the tool runs
+     * (e.g. "Looking up template 'marketing-digest'"). Comes from the
+     * tool definition's `runningLabel` with `{{paramName}}` placeholders
+     * substituted against `parameters`.
+     */
+    running_label?: string;
+    /**
+     * Resolved past-tense label the widget swaps to once the call
+     * completes. Sent on the start event so the UI has both labels in
+     * hand and can switch purely on status.
+     */
+    completed_label?: string;
+    /**
+     * Marks the call as internal plumbing the user shouldn't see by
+     * default. Mirrors the tool definition's `internal` flag.
+     */
+    internal?: boolean;
     timestamp: string;
 }
 export interface SSEToolCallResultEvent {
@@ -283,6 +307,127 @@ export interface SSEConfirmationRequiredEvent {
     escalated: boolean;
     timestamp: string;
 }
+/**
+ * Single- or multi-select chat-inline question rendered as a button row.
+ * Mirrored from @amodalai/types.
+ */
+export interface SSEAskChoiceEvent {
+    type: SSEEventType.AskChoice;
+    ask_id: string;
+    question: string;
+    options: Array<{
+        label: string;
+        value: string;
+    }>;
+    multi?: boolean;
+    timestamp: string;
+}
+/** Inline template-card preview emitted by the admin agent's `show_preview` tool. */
+export interface SSEShowPreviewEvent {
+    type: SSEEventType.ShowPreview;
+    card: {
+        title: string;
+        tagline: string;
+        platforms: string[];
+        thumbnailConversation: Array<{
+            role: 'user' | 'agent';
+            content: string;
+        }>;
+        /** Marketplace card thumbnail URL (R2-hosted JPEG). Optional. */
+        imageUrl?: string;
+    };
+    timestamp: string;
+}
+/**
+ * Inline connection panel — Phase H.1. Auth-agnostic; the modal
+ * behind the panel handles dispatch.
+ */
+export interface SSEConnectionPanelEvent {
+    type: SSEEventType.ConnectionPanel;
+    panel_id: string;
+    package_name: string;
+    display_name: string;
+    description: string;
+    skippable: boolean;
+    timestamp: string;
+}
+/** Plan summary card emitted after load_template_plan composes the Plan. Read-only. */
+export interface SSEPlanSummaryEvent {
+    type: SSEEventType.PlanSummary;
+    template_title: string;
+    required_slots: Array<{
+        label: string;
+        description: string;
+        options: Array<{
+            display_name: string;
+            package_name: string;
+        }>;
+    }>;
+    optional_slots: Array<{
+        label: string;
+        description: string;
+        options: Array<{
+            display_name: string;
+            package_name: string;
+        }>;
+    }>;
+    config_questions: Array<{
+        key: string;
+        question: string;
+    }>;
+    completion_suggestions: string[];
+    timestamp: string;
+}
+/** Proposal card emitted by the admin agent's `propose_plan` tool (Phase D). */
+export interface SSEProposalEvent {
+    type: SSEEventType.Proposal;
+    proposal_id: string;
+    summary: string;
+    skills: Array<{
+        label: string;
+        description: string;
+    }>;
+    required_connections: Array<{
+        label: string;
+        description: string;
+    }>;
+    optional_connections: Array<{
+        label: string;
+        description: string;
+    }>;
+    timestamp: string;
+}
+/** Patch event for an in-flight proposal (Phase D). Matched by `proposal_id`. */
+export interface SSEUpdatePlanEvent {
+    type: SSEEventType.UpdatePlan;
+    proposal_id: string;
+    summary?: string;
+    skills?: Array<{
+        label: string;
+        description: string;
+    }>;
+    required_connections?: Array<{
+        label: string;
+        description: string;
+    }>;
+    optional_connections?: Array<{
+        label: string;
+        description: string;
+    }>;
+    timestamp: string;
+}
+/** Setup cancelled — Phase E.10. The setup_state row has been deleted; Studio flips back to picker. */
+export interface SSESetupCancelledEvent {
+    type: SSEEventType.SetupCancelled;
+    reason?: string;
+    timestamp: string;
+}
+/** Setup committed — emitted by commit_setup (via request/force_complete_setup) so AdminChat can transition deterministically. */
+export interface SSESetupCompletedEvent {
+    type: SSEEventType.SetupCompleted;
+    completed_at: string;
+    timestamp: string;
+}
 export interface SSECompactionStartEvent {
     type: SSEEventType.CompactionStart;
     estimated_tokens: number;
@@ -296,13 +441,27 @@ export interface SSECompactionEndEvent {
     compaction_tokens: number;
     timestamp: string;
 }
-export type SSEEvent = SSEInitEvent | SSETextDeltaEvent | SSEToolCallStartEvent | SSEToolCallResultEvent | SSESubagentEvent | SSESkillActivatedEvent | SSEWidgetEvent | SSEKBProposalEvent | SSECredentialSavedEvent | SSEApprovedEvent | SSEExploreStartEvent | SSEExploreEndEvent | SSEPlanModeEvent | SSEFieldScrubEvent | SSEConfirmationRequiredEvent | SSECompactionStartEvent | SSECompactionEndEvent | SSEToolLogEvent | SSEWarningEvent | SSEErrorEvent | SSEDoneEvent | SSEAskChoiceEvent | SSEShowPreviewEvent | SSEStartOAuthEvent | SSECollectSecretEvent;
+export type SSEEvent = SSEInitEvent | SSETextDeltaEvent | SSEToolCallStartEvent | SSEToolCallResultEvent | SSESubagentEvent | SSESkillActivatedEvent | SSEWidgetEvent | SSEKBProposalEvent | SSECredentialSavedEvent | SSEApprovedEvent | SSEExploreStartEvent | SSEExploreEndEvent | SSEPlanModeEvent | SSEFieldScrubEvent | SSEConfirmationRequiredEvent | SSEAskChoiceEvent | SSEShowPreviewEvent | SSEConnectionPanelEvent | SSEPlanSummaryEvent | SSEProposalEvent | SSEUpdatePlanEvent | SSESetupCancelledEvent | SSESetupCompletedEvent | SSECompactionStartEvent | SSECompactionEndEvent | SSEToolLogEvent | SSEToolLabelUpdateEvent | SSEWarningEvent | SSEErrorEvent | SSEDoneEvent | SSEStartOAuthEvent;
 export interface SSEToolLogEvent {
     type: SSEEventType.ToolLog;
     tool_name: string;
     message: string;
     timestamp: string;
 }
+/**
+ * Live label update emitted by a tool handler via `ctx.setLabel(...)`.
+ * Lets a tool dynamically replace its running / completed phrase as it
+ * works ("Cloning…" → "Installing 12 packages" → "Composed plan"). The
+ * widget patches the active tool-call card in place. Either or both
+ * fields may be present.
+ */
+export interface SSEToolLabelUpdateEvent {
+    type: SSEEventType.ToolLabelUpdate;
+    tool_id: string;
+    running_label?: string;
+    completed_label?: string;
+    timestamp: string;
+}
 export interface SSEAskChoiceEvent {
     type: SSEEventType.AskChoice;
     ask_id: string;
@@ -314,19 +473,6 @@ export interface SSEAskChoiceEvent {
     multi?: boolean;
     timestamp: string;
 }
-export interface SSEShowPreviewEvent {
-    type: SSEEventType.ShowPreview;
-    card: {
-        title: string;
-        tagline: string;
-        platforms: string[];
-        thumbnailConversation: Array<{
-            role: 'user' | 'agent';
-            content: string;
-        }>;
-    };
-    timestamp: string;
-}
 export interface SSEStartOAuthEvent {
     type: SSEEventType.StartOAuth;
     package_name: string;
@@ -335,16 +481,6 @@ export interface SSEStartOAuthEvent {
     skippable?: boolean;
     timestamp: string;
 }
-export interface SSECollectSecretEvent {
-    type: SSEEventType.CollectSecret;
-    secret_id: string;
-    name: string;
-    label: string;
-    description?: string;
-    link?: string;
-    required: boolean;
-    timestamp: string;
-}
 export interface ServerConfig {
     /** Port to listen on (default 3000) */
     port: number;

package/dist/src/types.js

@@ -66,6 +66,14 @@ export var SSEEventType;
     SSEEventType["KBProposal"] = "kb_proposal";
     SSEEventType["CredentialSaved"] = "credential_saved";
     SSEEventType["Approved"] = "approved";
+    SSEEventType["AskChoice"] = "ask_choice";
+    SSEEventType["ShowPreview"] = "show_preview";
+    SSEEventType["ConnectionPanel"] = "connection_panel";
+    SSEEventType["PlanSummary"] = "plan_summary";
+    SSEEventType["Proposal"] = "proposal";
+    SSEEventType["UpdatePlan"] = "update_plan";
+    SSEEventType["SetupCancelled"] = "setup_cancelled";
+    SSEEventType["SetupCompleted"] = "setup_completed";
     SSEEventType["ExploreStart"] = "explore_start";
     SSEEventType["ExploreEnd"] = "explore_end";
     SSEEventType["PlanMode"] = "plan_mode";
@@ -74,12 +82,10 @@ export var SSEEventType;
     SSEEventType["CompactionStart"] = "compaction_start";
     SSEEventType["CompactionEnd"] = "compaction_end";
     SSEEventType["ToolLog"] = "tool_log";
+    SSEEventType["ToolLabelUpdate"] = "tool_label_update";
     SSEEventType["Warning"] = "warning";
     SSEEventType["Error"] = "error";
     SSEEventType["Done"] = "done";
-    SSEEventType["AskChoice"] = "ask_choice";
-    SSEEventType["ShowPreview"] = "show_preview";
     SSEEventType["StartOAuth"] = "start_oauth";
-    SSEEventType["CollectSecret"] = "collect_secret";
 })(SSEEventType || (SSEEventType = {}));
 //# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,sBAAsB;IACtB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACxE,wEAAwE;IACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,4CAA4C;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,iCAAiC;IACjC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxD,qDAAqD;IACrD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,yEAAyE;IACzE,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChE,kFAAkF;IAClF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC;;;;;;;;;;;OAWG;IACH,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1D,qEAAqE;IACrE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACzB,CAAC,CAAC,QAAQ,EAAE;IACb,uDAAuD;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,mEAAmE;IACnE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,0DAA0D;IAC1D,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAoCH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAN,IAAY,YA0BX;AA1BD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,wCAAwB,CAAA;IACxB,iDAAiC,CAAA;IACjC,mDAAmC,CAAA;IACnC,gDAAgC,CAAA;IAChC,kDAAkC,CAAA;IAClC,iCAAiB,CAAA;IACjB,0CAA0B,CAAA;IAC1B,oDAAoC,CAAA;IACpC,qCAAqB,CAAA;IACrB,8CAA8B,CAAA;IAC9B,0CAA0B,CAAA;IAC1B,sCAAsB,CAAA;IACtB,0CAA0B,CAAA;IAC1B,8DAA8C,CAAA;IAC9C,oDAAoC,CAAA;IACpC,gDAAgC,CAAA;IAChC,oCAAoB,CAAA;IACpB,mCAAmB,CAAA;IACnB,+BAAe,CAAA;IACf,6BAAa,CAAA;IACb,wCAAwB,CAAA;IACxB,4CAA4B,CAAA;IAC5B,0CAA0B,CAAA;IAC1B,gDAAgC,CAAA;AAClC,CAAC,EA1BW,YAAY,KAAZ,YAAY,QA0BvB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}