@runtypelabs/persona 3.26.0 → 3.27.0

package/dist/theme-editor.d.cts

@@ -701,6 +701,556 @@ interface AgentWidgetPlugin {
     onUnregister?: () => void;
 }
 
+type RuntypeAgentSSEEvent = {
+    agentId: string;
+    agentName: string;
+    config?: {
+        enableReflection?: boolean;
+        model?: string;
+    };
+    executionId: string;
+    maxTurns: number;
+    seq: number;
+    startedAt: string;
+    type: "agent_start";
+} | {
+    executionId: string;
+    iteration: number;
+    maxTurns: number;
+    seq: number;
+    startedAt: string;
+    totalCost?: number;
+    type: "agent_iteration_start";
+} | ({
+    executionId: string;
+    iteration: number;
+    role: "user" | "assistant" | "system";
+    seq: number;
+    turnId: string;
+    turnIndex: number;
+    type: "agent_turn_start";
+}) | ({
+    contentType: "text" | "thinking" | "tool_input";
+    delta: string;
+    executionId: string;
+    iteration: number;
+    seq: number;
+    turnId: string;
+    type: "agent_turn_delta";
+}) | ({
+    completedAt: string;
+    content?: string;
+    cost?: number;
+    estimatedContextBreakdown?: {
+        categories: Record<string, {
+            chars: number;
+            estimatedTokens: number;
+        }>;
+        contextWindowSize?: number;
+        estimatedTotalTokens: number;
+        estimatedUtilizationPercent?: number;
+    };
+    executionId: string;
+    iteration: number;
+    role: "user" | "assistant" | "system";
+    seq: number;
+    stopReason?: "end_turn" | "max_tool_calls" | "length" | "content_filter" | "error" | "unknown";
+    tokens?: {
+        input: number;
+        output: number;
+    };
+    turnId: string;
+    type: "agent_turn_complete";
+}) | ({
+    executionId: string;
+    iteration: number;
+    origin?: "webmcp" | "sdk";
+    pageOrigin?: string;
+    parameters?: Record<string, unknown>;
+    seq: number;
+    toolCallId: string;
+    toolName: string;
+    toolType: "flow" | "mcp" | "builtin" | "custom" | "external" | "advisor" | "subagent" | "local";
+    type: "agent_tool_start";
+}) | {
+    delta: string;
+    executionId: string;
+    iteration: number;
+    seq: number;
+    toolCallId: string;
+    type: "agent_tool_delta";
+} | {
+    delta: string;
+    executionId: string;
+    iteration: number;
+    seq: number;
+    toolCallId: string;
+    type: "agent_tool_input_delta";
+} | {
+    executionId: string;
+    hiddenParameterNames?: Array<string>;
+    iteration: number;
+    parameters: Record<string, unknown>;
+    seq: number;
+    toolCallId: string;
+    toolName: string;
+    type: "agent_tool_input_complete";
+} | {
+    executionId: string;
+    executionTime?: number;
+    iteration: number;
+    result?: unknown;
+    seq: number;
+    success: boolean;
+    toolCallId: string;
+    toolName: string;
+    type: "agent_tool_complete";
+} | ({
+    executionId?: string;
+    iteration: number;
+    media: Array<({
+        annotations?: {
+            audience?: Array<"user" | "assistant">;
+        };
+        data: string;
+        mediaType: string;
+        type: "media";
+    }) | ({
+        annotations?: {
+            audience?: Array<"user" | "assistant">;
+        };
+        mediaType?: string;
+        type: "image-url";
+        url: string;
+    }) | ({
+        annotations?: {
+            audience?: Array<"user" | "assistant">;
+        };
+        mediaType: string;
+        type: "file-url";
+        url: string;
+    })>;
+    seq?: number;
+    toolCallId: string;
+    toolName: string;
+    type: "agent_media";
+}) | {
+    approvalId: string;
+    description: string;
+    executionId: string;
+    externalAgent?: {
+        contextId?: string;
+        taskId?: string;
+    };
+    iteration?: number;
+    parameters?: Record<string, unknown>;
+    seq: number;
+    startedAt: string;
+    timeout: number;
+    toolCallId: string;
+    toolName: string;
+    toolType: string;
+    type: "agent_approval_start";
+} | ({
+    approvalId: string;
+    completedAt: string;
+    decision: "approved" | "denied" | "timeout";
+    executionId: string;
+    resolvedBy: "user" | "system";
+    seq: number;
+    type: "agent_approval_complete";
+}) | ({
+    awaitedAt: string;
+    executionId: string;
+    origin?: "webmcp" | "sdk";
+    pageOrigin?: string;
+    parameters?: Record<string, unknown>;
+    seq: number;
+    toolCallId?: string;
+    toolId: string;
+    toolName: string;
+    type: "agent_await";
+}) | {
+    completedAt: string;
+    cost?: number;
+    duration?: number;
+    estimatedContextBreakdown?: {
+        categories: Record<string, {
+            chars: number;
+            estimatedTokens: number;
+        }>;
+        contextWindowSize?: number;
+        estimatedTotalTokens: number;
+        estimatedUtilizationPercent?: number;
+    };
+    executionId: string;
+    iteration: number;
+    output?: string;
+    runningTotalCost?: number;
+    seq: number;
+    stopConditionMet: boolean;
+    tokens?: {
+        input: number;
+        output: number;
+    };
+    toolCallsMade: number;
+    type: "agent_iteration_complete";
+} | {
+    executionId: string;
+    iteration: number;
+    reflection?: string;
+    seq: number;
+    type: "agent_reflection";
+} | {
+    activatedCapabilities: Array<string>;
+    executionId: string;
+    iteration: number;
+    seq: number;
+    skill: string;
+    toolCallId: string;
+    type: "agent_skill_loaded";
+} | ({
+    executionId: string;
+    iteration: number;
+    outcome: "pending_approval" | "auto_published";
+    proposalId?: string;
+    seq: number;
+    skill: string;
+    toolCallId: string;
+    type: "agent_skill_proposed";
+}) | ({
+    agentId: string;
+    completedAt: string;
+    duration?: number;
+    error?: string;
+    executionId: string;
+    externalAgent?: {
+        contextId?: string;
+        taskId?: string;
+    };
+    finalOutput?: string;
+    iterations: number;
+    seq: number;
+    stopReason: "complete" | "end_turn" | "max_turns" | "max_cost" | "timeout" | "error";
+    success: boolean;
+    totalCost?: number;
+    totalTokens?: {
+        input: number;
+        output: number;
+    };
+    type: "agent_complete";
+}) | {
+    error: {
+        code: string;
+        details?: Record<string, unknown>;
+        message: string;
+    };
+    executionId: string;
+    iteration?: number;
+    recoverable: boolean;
+    seq: number;
+    type: "agent_error";
+} | {
+    executionId: string;
+    seq: number;
+    timestamp: string;
+    type: "agent_ping";
+};
+type RuntypeFlowSSEEvent = {
+    executionContext?: Record<string, unknown>;
+    executionId?: string;
+    flowId: string;
+    flowName?: string;
+    input?: unknown;
+    seq?: number;
+    source?: string;
+    startedAt: string;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    totalSteps?: number;
+    type: "flow_start";
+} | {
+    completedAt?: string;
+    completedSteps?: number;
+    duration?: number;
+    executionContext?: Record<string, unknown>;
+    executionId?: string;
+    executionTime?: number;
+    failedSteps?: number;
+    finalOutput?: string;
+    flowId?: string;
+    output?: unknown;
+    seq?: number;
+    source?: string;
+    success?: boolean;
+    successfulSteps?: number;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    totalSteps?: number;
+    totalTokensUsed?: number;
+    type: "flow_complete";
+} | ({
+    code?: string;
+    error: string | {
+        code: string;
+        message: string;
+        stepId?: string;
+        stepType?: string;
+    };
+    executionId?: string;
+    executionTime?: number;
+    flowId?: string;
+    seq?: number;
+    timestamp?: string;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    type: "flow_error";
+    upgradeUrl?: string;
+}) | ({
+    awaitedAt: string;
+    executionId?: string;
+    flowId: string;
+    origin?: "webmcp" | "sdk";
+    pageOrigin?: string;
+    parameters?: Record<string, unknown>;
+    seq?: number;
+    toolCallId?: string;
+    toolId?: string;
+    toolName?: string;
+    type: "flow_await";
+}) | {
+    estimatedTokens?: number;
+    executionId?: string;
+    id?: string;
+    index?: number;
+    name?: string;
+    seq?: number;
+    startedAt: string;
+    stepId?: string;
+    stepName?: string;
+    stepType?: string;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    totalSteps?: number;
+    type: "step_start";
+} | {
+    delta?: string;
+    executionId?: string;
+    id?: string;
+    messageId?: string;
+    partId?: string;
+    seq?: number;
+    text?: string;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    toolId?: string;
+    type: "step_delta";
+} | ({
+    completedAt?: string;
+    duration?: number;
+    durationMs?: number;
+    error?: string;
+    executionId?: string;
+    executionTime?: number;
+    id?: string;
+    index?: number;
+    name?: string;
+    output?: unknown;
+    result?: unknown;
+    seq?: number;
+    stepId?: string;
+    stepName?: string;
+    stepType?: string;
+    stopReason?: "end_turn" | "max_tool_calls" | "length" | "content_filter" | "error" | "unknown";
+    success?: boolean;
+    tokensUsed?: number;
+    toolContext?: {
+        executionId: string;
+        stepId: string;
+        toolId: string;
+    };
+    type: "step_complete";
+}) | {
+    error: string;
+    executionId?: string;
+    executionTime?: number;
+    id?: string;
+    index?: number;
+    name?: string;
+    seq?: number;
+    stepType?: string;
+    type: "step_error";
+} | {
+    error?: string;
+    executionId?: string;
+    id: string;
+    index?: number;
+    name?: string;
+    seq?: number;
+    skippedAt: string;
+    stepType: string;
+    totalSteps: number;
+    type: "step_skip";
+    when: string;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "step_await";
+    [key: string]: unknown;
+} | ({
+    agentContext?: {
+        executionId: string;
+        iteration: number;
+        seq: number;
+    };
+    executionId?: string;
+    hiddenParameterNames?: Array<string>;
+    name?: string;
+    parameters?: Record<string, unknown>;
+    providerOptions?: Record<string, unknown>;
+    seq?: number;
+    startedAt?: string;
+    stepId?: string;
+    toolCallId?: string;
+    toolId?: string;
+    toolName?: string;
+    toolType: "flow" | "mcp" | "builtin" | "custom" | "external" | "advisor" | "subagent" | "local";
+    type: "tool_start";
+    [key: string]: unknown;
+}) | {
+    delta?: string;
+    executionId?: string;
+    seq?: number;
+    toolId?: string;
+    type: "tool_delta";
+    [key: string]: unknown;
+} | {
+    delta: string;
+    executionId?: string;
+    seq?: number;
+    stepId?: string;
+    toolCallId?: string;
+    toolId?: string;
+    type: "tool_input_delta";
+} | {
+    executionId?: string;
+    hiddenParameterNames?: Array<string>;
+    parameters: Record<string, unknown>;
+    providerOptions?: Record<string, unknown>;
+    seq?: number;
+    stepId?: string;
+    toolCallId?: string;
+    toolId?: string;
+    toolName?: string;
+    type: "tool_input_complete";
+} | {
+    agentContext?: {
+        executionId: string;
+        iteration: number;
+        seq: number;
+    };
+    completedAt?: string;
+    error?: string;
+    executionId?: string;
+    executionTime?: number;
+    name?: string;
+    result?: unknown;
+    seq?: number;
+    stepId?: string;
+    success: boolean;
+    toolCallId?: string;
+    toolCost?: number;
+    toolId?: string;
+    toolName?: string;
+    type: "tool_complete";
+} | {
+    agentContext?: {
+        executionId: string;
+        iteration: number;
+        seq: number;
+    };
+    error: string;
+    executionId?: string;
+    executionTime?: number;
+    failedAt?: string;
+    name: string;
+    seq?: number;
+    toolId: string;
+    type: "tool_error";
+} | {
+    executionId?: string;
+    id: string;
+    seq?: number;
+    text: string;
+    type: "chunk";
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "text_start";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "text_end";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "reason_start";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "reason_delta";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "reason_complete";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "source";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "fallback_start";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "fallback_complete";
+    [key: string]: unknown;
+} | {
+    executionId?: string;
+    seq?: number;
+    type: "fallback_exhausted";
+    [key: string]: unknown;
+};
+type RuntypeStreamEventOf<U, T extends string> = Extract<U, {
+    type: T;
+}>;
+type RuntypeAgentTurnCompleteEvent = RuntypeStreamEventOf<RuntypeAgentSSEEvent, "agent_turn_complete">;
+type RuntypeStepCompleteEvent = RuntypeStreamEventOf<RuntypeFlowSSEEvent, "step_complete">;
+type RuntypeStopReasonKind = NonNullable<RuntypeAgentTurnCompleteEvent["stopReason"] | RuntypeStepCompleteEvent["stopReason"]>;
+
 /**
  * Text content part for multi-modal messages
  */
@@ -4103,7 +4653,7 @@ type AgentWidgetMessageVariant = "assistant" | "reasoning" | "tool" | "approval"
  *
  * Absent (`undefined`) means "not reported" — distinct from `'unknown'`.
  */
-type StopReasonKind = 'end_turn' | 'max_tool_calls' | 'length' | 'content_filter' | 'error' | 'unknown';
+type StopReasonKind = RuntypeStopReasonKind;
 /**
  * Represents a message in the chat conversation.
  *