assistant-action-bar headless API

type ActionBarAutohide = "always" | "not-last" | "never";

type ActionBarFeedback = "positive" | "negative";

export declare const assistantActionBarAnatomy: {
  readonly scope: "assistant-action-bar";
  readonly parts: readonly ["root", "copy", "reload", "edit", "speak", "stop-speaking", "feedback-positive", "feedback-negative", "export-markdown"];
};

interface AssistantActionBarApi {
  rootProps(): PartProps;
  copyProps(): PartProps;
  reloadProps(): PartProps;
  editProps(): PartProps;
  speakProps(): PartProps;
  stopSpeakingProps(): PartProps;
  feedbackPositiveProps(): PartProps;
  feedbackNegativeProps(): PartProps;
  exportMarkdownProps(): PartProps;
  getVersion(): number;
  subscribe(listener: () => void): () => void;
  destroy(): void;
}

interface AssistantActionBarClientLike {
  readonly thread?: {
    readonly getState: () => Record<string, unknown>;
  };
  readonly message?: {
    readonly getState: () => Record<string, unknown>;
  };
  readonly capabilities?: Record<string, boolean>;
}

interface AssistantActionBarConnectOptions {
  readonly messageId?: string;
  readonly message?: ExportableMessage;
  readonly copyText?: string;
  readonly hideWhenRunning?: boolean;
  readonly autohide?: ActionBarAutohide;
  readonly autohideFloat?: boolean;
  readonly isLast?: boolean;
  readonly copiedDuration?: number;
  readonly clipboard?: {
    readonly writeText: (text: string) => void | Promise<void>;
  };
  readonly onFeedback?: (feedback: ActionBarFeedback) => void;
  readonly onExport?: (markdown: string) => void;
  readonly onReload?: () => void;
  readonly onEdit?: () => void;
  readonly onSpeak?: () => void;
  readonly onStopSpeaking?: () => void;
}

interface AssistantActionBarMount {
  readonly connector: AssistantActionBarApi;
  readonly root: HTMLElement;
  destroy(): void;
}

type AssistantActionBarPart = (typeof parts)[number];

declare function connectAssistantActionBar(client: AssistantActionBarClientLike, scope: PartScope, options?: AssistantActionBarConnectOptions): AssistantActionBarApi;

interface ExportableMessage {
  readonly [key: string]: unknown;
  readonly role?: string;
  readonly content?: readonly ExportableMessagePart[];
}

interface ExportableMessagePart {
  readonly id?: string;
  readonly type?: string;
  readonly sourceType?: string;
  readonly toolCallId?: string;
  readonly text?: string;
  readonly title?: string;
  readonly url?: string;
  readonly filename?: string;
  readonly image?: string;
  readonly data?: unknown;
  readonly name?: string;
  readonly toolName?: string;
  readonly args?: unknown;
  readonly result?: unknown;
  readonly isError?: boolean;
  readonly argsText?: string;
}

declare function exportMessageMarkdown(message: ExportableMessage): string;

declare function mountAssistantActionBar(container: HTMLElement, client: AssistantActionBarClientLike, options?: MountAssistantActionBarOptions): AssistantActionBarMount;

interface MountAssistantActionBarOptions extends AssistantActionBarConnectOptions {}