@stina/extension-api 0.58.0 → 1.3.1

package/dist/{types.tools-DtYAgtto.d.cts → types.tools-C0GqXQlu.d.cts}

@@ -171,6 +171,18 @@ interface LabelProps extends ExtensionComponentData {
     component: 'Label';
     text: string;
 }
+/**
+ * The extension API properties for the Clock component.
+ *
+ * The odd one out among the display components: it takes no facts, because the
+ * fact it shows is what time it is, and that is not something an action can
+ * hand over once. It reads the clock and the timezone from the host and keeps
+ * itself current, so a card carrying one stays right while the window is left
+ * open.
+ */
+interface ClockProps extends ExtensionComponentData {
+    component: 'Clock';
+}
 /** The extension API properties for the paragraph component. */
 interface ParagraphProps extends ExtensionComponentData {
     component: 'Paragraph';
@@ -581,6 +593,50 @@ interface StatTileProps extends ExtensionComponentData {
      */
     trendIsGood?: boolean;
 }
+/** Whether a progress reading is drawn as a rail or as a ring. */
+type ProgressShape = 'bar' | 'circle';
+/**
+ * The colours a progress reading may take.
+ *
+ * A closed list rather than a colour string: the caller is usually a language
+ * model, and the six names here are the six the themes actually define, so a
+ * reading cannot end up in a hue the current theme has no contrast for.
+ */
+type ProgressColor = 'accent' | 'success' | 'warning' | 'danger' | 'info' | 'neutral';
+/**
+ * The extension API properties for the ProgressBar component.
+ *
+ * One value seen against the range it lives in — how far along something is,
+ * how loaded a day looks, how high a level sits. A StatTile says what the
+ * number *is*; this says where it *sits*, which is the thing a number alone
+ * cannot show.
+ *
+ * `min` and `max` are the range, not decoration: a value is drawn as its
+ * position between them, so "3 of 5" and "60 of 100" fill the same amount.
+ * Values outside the range are clamped rather than refused — a reading that
+ * ran past its ceiling should still draw as full.
+ */
+interface ProgressBarProps extends ExtensionComponentData {
+    component: 'ProgressBar';
+    /** What is being measured, e.g. "Stressnivå". Shown beside the reading. */
+    label: string;
+    value: number;
+    /** Bottom of the range. Defaults to 0. */
+    min?: number;
+    /** Top of the range. Defaults to 100. */
+    max?: number;
+    /** Defaults to `bar`. */
+    shape?: ProgressShape;
+    /** Defaults to `accent`. */
+    color?: ProgressColor;
+    /** Written after the value, e.g. `%` or ` av 5`. */
+    unit?: string;
+    /** The readout in words, when the bare number does not say it. Replaces value and unit. */
+    valueLabel?: string;
+    /** One quiet line under the reading. */
+    caption?: string;
+    icon?: HugeIconName;
+}
 /** One row of a KeyValueList. */
 interface KeyValueRow {
     label: string;
@@ -721,6 +777,8 @@ interface CalendarEventProps extends ExtensionComponentData {
 interface ExtensionContributions {
     /** Tool settings views for UI */
     toolSettings?: ToolSettingsViewDefinition[];
+    /** Cards for the strip above the conversation list */
+    statusCards?: StatusCardDefinition[];
     /** Right panel contributions */
     panels?: PanelDefinition[];
     /** AI providers */
@@ -861,6 +919,38 @@ interface PanelDefinition {
     /** Panel view schema */
     view: PanelView;
 }
+/**
+ * A card for the strip above the conversation list.
+ *
+ * The same declarative machinery as a panel, in a much smaller space and with
+ * one rule that is not a style guide: a card says what is true right now. It
+ * has no controls, because a sidebar is read in passing and anything the user
+ * wants to do about what it says, they say in words.
+ *
+ * The user chooses which cards they want and in what order, so an extension
+ * offering three is offering three, not imposing them.
+ */
+interface StatusCardDefinition {
+    /** Unique card ID within the extension */
+    id: string;
+    /** What it is called where the user picks it */
+    title: string;
+    /** Icon name (from huge-icons) */
+    icon?: string;
+    /**
+     * How much room it may take.
+     *
+     * Part of the contract rather than a guideline, because the sidebar is a few
+     * hundred pixels wide and the first card written without a limit will be
+     * written against a screen.
+     *
+     * - `line`: one row. A figure, a label, a pill.
+     * - `block`: up to three rows.
+     */
+    size: 'line' | 'block';
+    /** What it draws, and where the data comes from */
+    view: PanelComponentView;
+}
 /**
  * Panel view schema (declarative)
  */
@@ -2262,6 +2352,32 @@ interface ToolResult {
      * would send her after a component that does not exist.
      */
     cardSuggestion?: string;
+    /**
+     * Pictures to show the user, rendered in the conversation where the tool ran.
+     *
+     * For what a card cannot hold and the model cannot reproduce: a generated
+     * image, a rendered document, a photo fetched on the user's behalf. Like
+     * {@link ToolResult.display}, this is for the user only — it is lifted out
+     * before the result reaches the model, which would have nothing to do with
+     * the bytes but spend tokens on them. Say in `data` that a picture was shown,
+     * so she can talk about it without describing it back.
+     *
+     * The host stores each one as an attachment of the conversation, the same way
+     * a picture the user sends is stored, so it is served to every client and can
+     * be saved or shared from there. JPEG and PNG only, and 20 MB at most, since
+     * those are the limits the attachment store already holds users to. One that
+     * fails them is dropped with a warning rather than half-shown.
+     */
+    attachments?: ToolAttachment[];
+}
+/**
+ * One picture a tool wants shown. See {@link ToolResult.attachments}.
+ */
+interface ToolAttachment {
+    /** The image bytes, base64 encoded. The format is read from the bytes. */
+    data: string;
+    /** A file name to offer when the user saves it, e.g. `friday.png`. */
+    name?: string;
 }
 /**
  * Action implementation for UI interactions.
@@ -2289,4 +2405,4 @@ interface ActionResult {
     error?: string;
 }
 
-export { type BackgroundTaskHealth as $, type ActionResult as A, type EventsAPI as B, type ChatMessage as C, type Disposable as D, type ExtensionContributions as E, type SchedulerAPI as F, type GetModelsOptions as G, type HugeIconName as H, type SchedulerJobRequest as I, type SchedulerSchedule as J, type UserProfile as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type ChatAPI as O, type PanelDefinition as P, type ChatInstructionMessage as Q, type ConversationPresentation as R, type SchedulerFirePayload as S, type ToolResult as T, type UserAPI as U, type VoiceSessionOptions as V, type LogAPI as W, type BackgroundWorkersAPI as X, type BackgroundTaskConfig as Y, type BackgroundTaskCallback as Z, type BackgroundTaskContext as _, type ChatOptions as a, type ChartProps as a$, type BackgroundRestartPolicy as a0, type Query as a1, type QueryOptions as a2, type StorageAPI as a3, type SecretsAPI as a4, type StorageCollectionConfig as a5, type StorageContributions as a6, type AIProvider as a7, type ModelCapabilities as a8, type ChatImage as a9, type HorizontalStackProps as aA, type GridProps as aB, type DividerProps as aC, type IconProps as aD, type IconButtonType as aE, type IconButtonProps as aF, type PanelAction as aG, type PanelProps as aH, type ToggleProps as aI, type CollapsibleProps as aJ, type FrameVariant as aK, type FrameProps as aL, type ListProps as aM, type PillVariant as aN, type PillProps as aO, type CheckboxProps as aP, type MarkdownProps as aQ, type TextPreviewProps as aR, type ModalProps as aS, type ConditionalGroupProps as aT, type WeatherCondition as aU, type WeatherWind as aV, type WeatherNowProps as aW, type WeatherForecastStep as aX, type WeatherForecastProps as aY, type ChartKind as aZ, type ChartSeries as a_, type ToolCall as aa, type VoiceTransportRequest as ab, type Tool as ac, type Action as ad, type ExtensionModule as ae, type AllowedCSSProperty as af, type ExtensionComponentStyle as ag, type ExtensionComponentData as ah, type ExtensionComponentIterator as ai, type ExtensionComponentChildren as aj, type ExtensionActionCall as ak, type ExtensionActionRef as al, type ExtensionDataSource as am, type ExtensionPanelDefinition as an, type HeaderProps as ao, type LabelProps as ap, type ParagraphProps as aq, type ButtonProps as ar, type TextInputProps as as, type PasswordInputProps as at, type NumberInputProps as au, type TextAreaProps as av, type DateTimeInputProps as aw, type SelectProps as ax, type IconPickerProps as ay, type VerticalStackProps as az, type StreamEvent as b, type StatTrend as b0, type StatTileProps as b1, type KeyValueRow as b2, type KeyValueListProps as b3, type TimelineVariant as b4, type TimelineEntry as b5, type TimelineProps as b6, type NoteVariant as b7, type NoteProps as b8, type CalendarEventStatus as b9, type CalendarEventProps as ba, type ExecutionContext as bb, type VoiceSessionDescriptor as c, type ToolSettingsViewDefinition as d, type ToolSettingsView as e, type ToolSettingsListView as f, type ToolSettingsListMapping as g, type ToolSettingsComponentView as h, type ToolSettingsActionDataSource as i, type PanelView as j, type PanelComponentView as k, type PanelActionDataSource as l, type PanelUnknownView as m, type ProviderDefinition as n, type ProviderConfigView as o, type PromptContribution as p, type PromptSection as q, resolveLocalizedString as r, type ToolDefinition as s, type ToolConfirmationConfig as t, type CommandDefinition as u, type ExtensionContext as v, type SettingsAPI as w, type ProvidersAPI as x, type ToolsAPI as y, type ActionsAPI as z };
+export { type BackgroundTaskContext as $, type ActionResult as A, type ActionsAPI as B, type ChatMessage as C, type Disposable as D, type ExtensionContributions as E, type EventsAPI as F, type GetModelsOptions as G, type HugeIconName as H, type SchedulerAPI as I, type SchedulerJobRequest as J, type SchedulerSchedule as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type UserProfile as O, type PanelDefinition as P, type ChatAPI as Q, type ChatInstructionMessage as R, type SchedulerFirePayload as S, type ToolResult as T, type UserAPI as U, type VoiceSessionOptions as V, type ConversationPresentation as W, type LogAPI as X, type BackgroundWorkersAPI as Y, type BackgroundTaskConfig as Z, type BackgroundTaskCallback as _, type ChatOptions as a, type WeatherForecastProps as a$, type BackgroundTaskHealth as a0, type BackgroundRestartPolicy as a1, type Query as a2, type QueryOptions as a3, type StorageAPI as a4, type SecretsAPI as a5, type StorageCollectionConfig as a6, type StorageContributions as a7, type AIProvider as a8, type ModelCapabilities as a9, type SelectProps as aA, type IconPickerProps as aB, type VerticalStackProps as aC, type HorizontalStackProps as aD, type GridProps as aE, type DividerProps as aF, type IconProps as aG, type IconButtonType as aH, type IconButtonProps as aI, type PanelAction as aJ, type PanelProps as aK, type ToggleProps as aL, type CollapsibleProps as aM, type FrameVariant as aN, type FrameProps as aO, type ListProps as aP, type PillVariant as aQ, type PillProps as aR, type CheckboxProps as aS, type MarkdownProps as aT, type TextPreviewProps as aU, type ModalProps as aV, type ConditionalGroupProps as aW, type WeatherCondition as aX, type WeatherWind as aY, type WeatherNowProps as aZ, type WeatherForecastStep as a_, type ChatImage as aa, type ToolCall as ab, type VoiceTransportRequest as ac, type Tool as ad, type ToolAttachment as ae, type Action as af, type ExtensionModule as ag, type AllowedCSSProperty as ah, type ExtensionComponentStyle as ai, type ExtensionComponentData as aj, type ExtensionComponentIterator as ak, type ExtensionComponentChildren as al, type ExtensionActionCall as am, type ExtensionActionRef as an, type ExtensionDataSource as ao, type ExtensionPanelDefinition as ap, type HeaderProps as aq, type LabelProps as ar, type ClockProps as as, type ParagraphProps as at, type ButtonProps as au, type TextInputProps as av, type PasswordInputProps as aw, type NumberInputProps as ax, type TextAreaProps as ay, type DateTimeInputProps as az, type StreamEvent as b, type ChartKind as b0, type ChartSeries as b1, type ChartProps as b2, type StatTrend as b3, type StatTileProps as b4, type ProgressShape as b5, type ProgressColor as b6, type ProgressBarProps as b7, type KeyValueRow as b8, type KeyValueListProps as b9, type TimelineVariant as ba, type TimelineEntry as bb, type TimelineProps as bc, type NoteVariant as bd, type NoteProps as be, type CalendarEventStatus as bf, type CalendarEventProps as bg, type ExecutionContext as bh, type VoiceSessionDescriptor as c, type ToolSettingsViewDefinition as d, type ToolSettingsView as e, type ToolSettingsListView as f, type ToolSettingsListMapping as g, type ToolSettingsComponentView as h, type ToolSettingsActionDataSource as i, type StatusCardDefinition as j, type PanelView as k, type PanelComponentView as l, type PanelActionDataSource as m, type PanelUnknownView as n, type ProviderDefinition as o, type ProviderConfigView as p, type PromptContribution as q, resolveLocalizedString as r, type PromptSection as s, type ToolDefinition as t, type ToolConfirmationConfig as u, type CommandDefinition as v, type ExtensionContext as w, type SettingsAPI as x, type ProvidersAPI as y, type ToolsAPI as z };

package/dist/{types.tools-DtYAgtto.d.ts → types.tools-C0GqXQlu.d.ts}

@@ -171,6 +171,18 @@ interface LabelProps extends ExtensionComponentData {
     component: 'Label';
     text: string;
 }
+/**
+ * The extension API properties for the Clock component.
+ *
+ * The odd one out among the display components: it takes no facts, because the
+ * fact it shows is what time it is, and that is not something an action can
+ * hand over once. It reads the clock and the timezone from the host and keeps
+ * itself current, so a card carrying one stays right while the window is left
+ * open.
+ */
+interface ClockProps extends ExtensionComponentData {
+    component: 'Clock';
+}
 /** The extension API properties for the paragraph component. */
 interface ParagraphProps extends ExtensionComponentData {
     component: 'Paragraph';
@@ -581,6 +593,50 @@ interface StatTileProps extends ExtensionComponentData {
      */
     trendIsGood?: boolean;
 }
+/** Whether a progress reading is drawn as a rail or as a ring. */
+type ProgressShape = 'bar' | 'circle';
+/**
+ * The colours a progress reading may take.
+ *
+ * A closed list rather than a colour string: the caller is usually a language
+ * model, and the six names here are the six the themes actually define, so a
+ * reading cannot end up in a hue the current theme has no contrast for.
+ */
+type ProgressColor = 'accent' | 'success' | 'warning' | 'danger' | 'info' | 'neutral';
+/**
+ * The extension API properties for the ProgressBar component.
+ *
+ * One value seen against the range it lives in — how far along something is,
+ * how loaded a day looks, how high a level sits. A StatTile says what the
+ * number *is*; this says where it *sits*, which is the thing a number alone
+ * cannot show.
+ *
+ * `min` and `max` are the range, not decoration: a value is drawn as its
+ * position between them, so "3 of 5" and "60 of 100" fill the same amount.
+ * Values outside the range are clamped rather than refused — a reading that
+ * ran past its ceiling should still draw as full.
+ */
+interface ProgressBarProps extends ExtensionComponentData {
+    component: 'ProgressBar';
+    /** What is being measured, e.g. "Stressnivå". Shown beside the reading. */
+    label: string;
+    value: number;
+    /** Bottom of the range. Defaults to 0. */
+    min?: number;
+    /** Top of the range. Defaults to 100. */
+    max?: number;
+    /** Defaults to `bar`. */
+    shape?: ProgressShape;
+    /** Defaults to `accent`. */
+    color?: ProgressColor;
+    /** Written after the value, e.g. `%` or ` av 5`. */
+    unit?: string;
+    /** The readout in words, when the bare number does not say it. Replaces value and unit. */
+    valueLabel?: string;
+    /** One quiet line under the reading. */
+    caption?: string;
+    icon?: HugeIconName;
+}
 /** One row of a KeyValueList. */
 interface KeyValueRow {
     label: string;
@@ -721,6 +777,8 @@ interface CalendarEventProps extends ExtensionComponentData {
 interface ExtensionContributions {
     /** Tool settings views for UI */
     toolSettings?: ToolSettingsViewDefinition[];
+    /** Cards for the strip above the conversation list */
+    statusCards?: StatusCardDefinition[];
     /** Right panel contributions */
     panels?: PanelDefinition[];
     /** AI providers */
@@ -861,6 +919,38 @@ interface PanelDefinition {
     /** Panel view schema */
     view: PanelView;
 }
+/**
+ * A card for the strip above the conversation list.
+ *
+ * The same declarative machinery as a panel, in a much smaller space and with
+ * one rule that is not a style guide: a card says what is true right now. It
+ * has no controls, because a sidebar is read in passing and anything the user
+ * wants to do about what it says, they say in words.
+ *
+ * The user chooses which cards they want and in what order, so an extension
+ * offering three is offering three, not imposing them.
+ */
+interface StatusCardDefinition {
+    /** Unique card ID within the extension */
+    id: string;
+    /** What it is called where the user picks it */
+    title: string;
+    /** Icon name (from huge-icons) */
+    icon?: string;
+    /**
+     * How much room it may take.
+     *
+     * Part of the contract rather than a guideline, because the sidebar is a few
+     * hundred pixels wide and the first card written without a limit will be
+     * written against a screen.
+     *
+     * - `line`: one row. A figure, a label, a pill.
+     * - `block`: up to three rows.
+     */
+    size: 'line' | 'block';
+    /** What it draws, and where the data comes from */
+    view: PanelComponentView;
+}
 /**
  * Panel view schema (declarative)
  */
@@ -2262,6 +2352,32 @@ interface ToolResult {
      * would send her after a component that does not exist.
      */
     cardSuggestion?: string;
+    /**
+     * Pictures to show the user, rendered in the conversation where the tool ran.
+     *
+     * For what a card cannot hold and the model cannot reproduce: a generated
+     * image, a rendered document, a photo fetched on the user's behalf. Like
+     * {@link ToolResult.display}, this is for the user only — it is lifted out
+     * before the result reaches the model, which would have nothing to do with
+     * the bytes but spend tokens on them. Say in `data` that a picture was shown,
+     * so she can talk about it without describing it back.
+     *
+     * The host stores each one as an attachment of the conversation, the same way
+     * a picture the user sends is stored, so it is served to every client and can
+     * be saved or shared from there. JPEG and PNG only, and 20 MB at most, since
+     * those are the limits the attachment store already holds users to. One that
+     * fails them is dropped with a warning rather than half-shown.
+     */
+    attachments?: ToolAttachment[];
+}
+/**
+ * One picture a tool wants shown. See {@link ToolResult.attachments}.
+ */
+interface ToolAttachment {
+    /** The image bytes, base64 encoded. The format is read from the bytes. */
+    data: string;
+    /** A file name to offer when the user saves it, e.g. `friday.png`. */
+    name?: string;
 }
 /**
  * Action implementation for UI interactions.
@@ -2289,4 +2405,4 @@ interface ActionResult {
     error?: string;
 }
 
-export { type BackgroundTaskHealth as $, type ActionResult as A, type EventsAPI as B, type ChatMessage as C, type Disposable as D, type ExtensionContributions as E, type SchedulerAPI as F, type GetModelsOptions as G, type HugeIconName as H, type SchedulerJobRequest as I, type SchedulerSchedule as J, type UserProfile as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type ChatAPI as O, type PanelDefinition as P, type ChatInstructionMessage as Q, type ConversationPresentation as R, type SchedulerFirePayload as S, type ToolResult as T, type UserAPI as U, type VoiceSessionOptions as V, type LogAPI as W, type BackgroundWorkersAPI as X, type BackgroundTaskConfig as Y, type BackgroundTaskCallback as Z, type BackgroundTaskContext as _, type ChatOptions as a, type ChartProps as a$, type BackgroundRestartPolicy as a0, type Query as a1, type QueryOptions as a2, type StorageAPI as a3, type SecretsAPI as a4, type StorageCollectionConfig as a5, type StorageContributions as a6, type AIProvider as a7, type ModelCapabilities as a8, type ChatImage as a9, type HorizontalStackProps as aA, type GridProps as aB, type DividerProps as aC, type IconProps as aD, type IconButtonType as aE, type IconButtonProps as aF, type PanelAction as aG, type PanelProps as aH, type ToggleProps as aI, type CollapsibleProps as aJ, type FrameVariant as aK, type FrameProps as aL, type ListProps as aM, type PillVariant as aN, type PillProps as aO, type CheckboxProps as aP, type MarkdownProps as aQ, type TextPreviewProps as aR, type ModalProps as aS, type ConditionalGroupProps as aT, type WeatherCondition as aU, type WeatherWind as aV, type WeatherNowProps as aW, type WeatherForecastStep as aX, type WeatherForecastProps as aY, type ChartKind as aZ, type ChartSeries as a_, type ToolCall as aa, type VoiceTransportRequest as ab, type Tool as ac, type Action as ad, type ExtensionModule as ae, type AllowedCSSProperty as af, type ExtensionComponentStyle as ag, type ExtensionComponentData as ah, type ExtensionComponentIterator as ai, type ExtensionComponentChildren as aj, type ExtensionActionCall as ak, type ExtensionActionRef as al, type ExtensionDataSource as am, type ExtensionPanelDefinition as an, type HeaderProps as ao, type LabelProps as ap, type ParagraphProps as aq, type ButtonProps as ar, type TextInputProps as as, type PasswordInputProps as at, type NumberInputProps as au, type TextAreaProps as av, type DateTimeInputProps as aw, type SelectProps as ax, type IconPickerProps as ay, type VerticalStackProps as az, type StreamEvent as b, type StatTrend as b0, type StatTileProps as b1, type KeyValueRow as b2, type KeyValueListProps as b3, type TimelineVariant as b4, type TimelineEntry as b5, type TimelineProps as b6, type NoteVariant as b7, type NoteProps as b8, type CalendarEventStatus as b9, type CalendarEventProps as ba, type ExecutionContext as bb, type VoiceSessionDescriptor as c, type ToolSettingsViewDefinition as d, type ToolSettingsView as e, type ToolSettingsListView as f, type ToolSettingsListMapping as g, type ToolSettingsComponentView as h, type ToolSettingsActionDataSource as i, type PanelView as j, type PanelComponentView as k, type PanelActionDataSource as l, type PanelUnknownView as m, type ProviderDefinition as n, type ProviderConfigView as o, type PromptContribution as p, type PromptSection as q, resolveLocalizedString as r, type ToolDefinition as s, type ToolConfirmationConfig as t, type CommandDefinition as u, type ExtensionContext as v, type SettingsAPI as w, type ProvidersAPI as x, type ToolsAPI as y, type ActionsAPI as z };
+export { type BackgroundTaskContext as $, type ActionResult as A, type ActionsAPI as B, type ChatMessage as C, type Disposable as D, type ExtensionContributions as E, type EventsAPI as F, type GetModelsOptions as G, type HugeIconName as H, type SchedulerAPI as I, type SchedulerJobRequest as J, type SchedulerSchedule as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type UserProfile as O, type PanelDefinition as P, type ChatAPI as Q, type ChatInstructionMessage as R, type SchedulerFirePayload as S, type ToolResult as T, type UserAPI as U, type VoiceSessionOptions as V, type ConversationPresentation as W, type LogAPI as X, type BackgroundWorkersAPI as Y, type BackgroundTaskConfig as Z, type BackgroundTaskCallback as _, type ChatOptions as a, type WeatherForecastProps as a$, type BackgroundTaskHealth as a0, type BackgroundRestartPolicy as a1, type Query as a2, type QueryOptions as a3, type StorageAPI as a4, type SecretsAPI as a5, type StorageCollectionConfig as a6, type StorageContributions as a7, type AIProvider as a8, type ModelCapabilities as a9, type SelectProps as aA, type IconPickerProps as aB, type VerticalStackProps as aC, type HorizontalStackProps as aD, type GridProps as aE, type DividerProps as aF, type IconProps as aG, type IconButtonType as aH, type IconButtonProps as aI, type PanelAction as aJ, type PanelProps as aK, type ToggleProps as aL, type CollapsibleProps as aM, type FrameVariant as aN, type FrameProps as aO, type ListProps as aP, type PillVariant as aQ, type PillProps as aR, type CheckboxProps as aS, type MarkdownProps as aT, type TextPreviewProps as aU, type ModalProps as aV, type ConditionalGroupProps as aW, type WeatherCondition as aX, type WeatherWind as aY, type WeatherNowProps as aZ, type WeatherForecastStep as a_, type ChatImage as aa, type ToolCall as ab, type VoiceTransportRequest as ac, type Tool as ad, type ToolAttachment as ae, type Action as af, type ExtensionModule as ag, type AllowedCSSProperty as ah, type ExtensionComponentStyle as ai, type ExtensionComponentData as aj, type ExtensionComponentIterator as ak, type ExtensionComponentChildren as al, type ExtensionActionCall as am, type ExtensionActionRef as an, type ExtensionDataSource as ao, type ExtensionPanelDefinition as ap, type HeaderProps as aq, type LabelProps as ar, type ClockProps as as, type ParagraphProps as at, type ButtonProps as au, type TextInputProps as av, type PasswordInputProps as aw, type NumberInputProps as ax, type TextAreaProps as ay, type DateTimeInputProps as az, type StreamEvent as b, type ChartKind as b0, type ChartSeries as b1, type ChartProps as b2, type StatTrend as b3, type StatTileProps as b4, type ProgressShape as b5, type ProgressColor as b6, type ProgressBarProps as b7, type KeyValueRow as b8, type KeyValueListProps as b9, type TimelineVariant as ba, type TimelineEntry as bb, type TimelineProps as bc, type NoteVariant as bd, type NoteProps as be, type CalendarEventStatus as bf, type CalendarEventProps as bg, type ExecutionContext as bh, type VoiceSessionDescriptor as c, type ToolSettingsViewDefinition as d, type ToolSettingsView as e, type ToolSettingsListView as f, type ToolSettingsListMapping as g, type ToolSettingsComponentView as h, type ToolSettingsActionDataSource as i, type StatusCardDefinition as j, type PanelView as k, type PanelComponentView as l, type PanelActionDataSource as m, type PanelUnknownView as n, type ProviderDefinition as o, type ProviderConfigView as p, type PromptContribution as q, resolveLocalizedString as r, type PromptSection as s, type ToolDefinition as t, type ToolConfirmationConfig as u, type CommandDefinition as v, type ExtensionContext as w, type SettingsAPI as x, type ProvidersAPI as y, type ToolsAPI as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stina/extension-api",
-  "version": "0.58.0",
+  "version": "1.3.1",
   "private": false,
   "repository": {
     "type": "git",

package/schema/extension-manifest.schema.json

@@ -119,6 +119,7 @@
                   "settings.register",
                   "commands.register",
                   "panels.register",
+                  "statusCards.register",
                   "events.emit",
                   "scheduler.register",
                   "background.workers",
@@ -564,6 +565,63 @@
               },
               "description": "Right panel contributions"
             },
+            "statusCards": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "Unique card ID within the extension"
+                  },
+                  "title": {
+                    "type": "string",
+                    "description": "What it is called where the user picks it"
+                  },
+                  "icon": {
+                    "type": "string",
+                    "description": "Icon name (from huge-icons)"
+                  },
+                  "size": {
+                    "type": "string",
+                    "enum": [
+                      "line",
+                      "block"
+                    ],
+                    "description": "How much room it may take: one row, or up to three"
+                  },
+                  "view": {
+                    "type": "object",
+                    "properties": {
+                      "kind": {
+                        "$ref": "#/definitions/ExtensionManifest/properties/contributes/properties/panels/items/properties/view/anyOf/0/properties/kind"
+                      },
+                      "data": {
+                        "$ref": "#/definitions/ExtensionManifest/properties/contributes/properties/panels/items/properties/view/anyOf/0/properties/data"
+                      },
+                      "content": {
+                        "$ref": "#/definitions/ExtensionManifest/properties/contributes/properties/panels/items/properties/view/anyOf/0/properties/content"
+                      }
+                    },
+                    "required": [
+                      "kind",
+                      "content"
+                    ],
+                    "additionalProperties": false,
+                    "description": "What it draws, and where the data comes from"
+                  }
+                },
+                "required": [
+                  "id",
+                  "title",
+                  "size",
+                  "view"
+                ],
+                "additionalProperties": false,
+                "description": "Status card definition"
+              },
+              "description": "Cards for the strip above the conversation list"
+            },
             "providers": {
               "type": "array",
               "items": {

package/src/index.ts

@@ -24,6 +24,7 @@ export type {
   ToolSettingsComponentView,
   ToolSettingsActionDataSource,
   PanelDefinition,
+  StatusCardDefinition,
   PanelView,
   PanelComponentView,
   PanelActionDataSource,
@@ -99,6 +100,7 @@ export type {
   // Tools
   Tool,
   ToolResult,
+  ToolAttachment,
 
   // Actions
   Action,
@@ -162,6 +164,7 @@ export type {
   // Component Props
   HeaderProps,
   LabelProps,
+  ClockProps,
   ParagraphProps,
   ButtonProps,
   TextInputProps,
@@ -203,6 +206,9 @@ export type {
   ChartProps,
   StatTrend,
   StatTileProps,
+  ProgressShape,
+  ProgressColor,
+  ProgressBarProps,
   KeyValueRow,
   KeyValueListProps,
   TimelineVariant,

package/src/runtime.ts

@@ -648,11 +648,36 @@ function buildContext(
   if (permissions.some((p) => p.startsWith('network:'))) {
     const networkApi: NetworkAPI = {
       async fetch(url: string, options?: RequestInit): Promise<Response> {
-        const result = await sendRequest<{ status: number; statusText: string; headers: Record<string, string>; body: string }>('network.fetch', { url, options })
-        return new Response(result.body, {
+        const result = await sendRequest<{
+          status: number
+          statusText: string
+          headers: Record<string, string>
+          body: string
+          bodyEncoding?: 'base64'
+        }>('network.fetch', { url, options })
+        // The host sends a body that is not text as base64, since the bridge is
+        // JSON. Turn it back into bytes here so `response.arrayBuffer()` gives
+        // the extension what the server sent and `text()` still works.
+        const isBase64 = result.bodyEncoding === 'base64'
+        const body = isBase64
+          ? Uint8Array.from(atob(result.body), (char) => char.charCodeAt(0))
+          : result.body
+
+        // The host says the same thing in a header, for extensions whose bundled
+        // copy of this runtime is older than the encoding and would hand the
+        // base64 on as text. This runtime just decoded it, so the header would be
+        // a lie by the time the extension reads it: take it back out.
+        const headers = { ...result.headers }
+        if (isBase64) {
+          for (const name of Object.keys(headers)) {
+            if (name.toLowerCase() === 'x-stina-body-encoding') delete headers[name]
+          }
+        }
+
+        return new Response(body, {
           status: result.status,
           statusText: result.statusText,
-          headers: result.headers,
+          headers,
         })
       },
 
@@ -996,6 +1021,7 @@ export type {
   Tool,
   ToolDefinition,
   ToolResult,
+  ToolAttachment,
   ToolCall,
   Action,
   ActionResult,

package/src/schemas/card.schema.ts

@@ -34,6 +34,8 @@ import {
   WeatherWindSchema,
   ChartKindSchema,
   StatTrendSchema,
+  ProgressShapeSchema,
+  ProgressColorSchema,
   TimelineVariantSchema,
   NoteVariantSchema,
   CalendarEventStatusSchema,
@@ -259,6 +261,23 @@ const StatTileCardSchema = z
   })
   .strict()
 
+const ProgressBarCardSchema = z
+  .object({
+    component: z.literal('ProgressBar'),
+    label: z.string(),
+    value: z.number(),
+    min: z.number().optional(),
+    max: z.number().optional(),
+    shape: ProgressShapeSchema.optional(),
+    color: ProgressColorSchema.optional(),
+    unit: z.string().optional(),
+    valueLabel: z.string().optional(),
+    caption: z.string().optional(),
+    icon: z.string().optional(),
+    style,
+  })
+  .strict()
+
 const KeyValueListCardSchema = z
   .object({
     component: z.literal('KeyValueList'),
@@ -350,6 +369,7 @@ export const CHAT_CARD_COMPONENTS = [
   'WeatherForecast',
   'Chart',
   'StatTile',
+  'ProgressBar',
   'KeyValueList',
   'Timeline',
   'Note',
@@ -382,12 +402,35 @@ const CARD_MEMBERS = [
   WeatherForecastCardSchema,
   ChartCardSchema,
   StatTileCardSchema,
+  ProgressBarCardSchema,
   KeyValueListCardSchema,
   TimelineCardSchema,
   NoteCardSchema,
   CalendarEventCardSchema,
 ] as const
 
+/**
+ * The properties each card component accepts, read off the schemas themselves.
+ *
+ * Derived rather than listed, for the same reason `describeChatCardProfile`
+ * is: a hand-kept copy of this drifts, and a drifted copy rejects components
+ * that are in fact legal.
+ *
+ * Used by profiles that validate a card *template* rather than a finished card
+ * — the status card, whose leaves are references to data that does not exist
+ * yet and so cannot be type-checked by these schemas. They can still be held to
+ * this vocabulary, which is what catches a property the model invented.
+ */
+export const CHAT_CARD_PROPS: Readonly<Record<string, readonly string[]>> = Object.freeze(
+  Object.fromEntries(
+    CARD_MEMBERS.map((member) => {
+      const shape = (member as unknown as z.AnyZodObject).shape as Record<string, z.ZodTypeAny>
+      const name = (shape['component']!._def as { value: string }).value
+      return [name, Object.freeze(Object.keys(shape))]
+    })
+  )
+)
+
 /**
  * One component of a chat card.
  *

package/src/schemas/components.schema.ts

@@ -197,6 +197,14 @@ export const LabelPropsSchema = z
   .passthrough()
   .describe('Label component')
 
+export const ClockPropsSchema = z
+  .object({
+    component: z.literal('Clock'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('Clock component: the current date and time where the user is')
+
 export const ParagraphPropsSchema = z
   .object({
     component: z.literal('Paragraph'),
@@ -651,6 +659,32 @@ export const StatTilePropsSchema = z
   .passthrough()
   .describe('Single-number stat tile component')
 
+export const ProgressShapeSchema = z
+  .enum(['bar', 'circle'])
+  .describe('Drawn as a rail or as a ring')
+
+export const ProgressColorSchema = z
+  .enum(['accent', 'success', 'warning', 'danger', 'info', 'neutral'])
+  .describe('One of the theme colours')
+
+export const ProgressBarPropsSchema = z
+  .object({
+    component: z.literal('ProgressBar'),
+    label: z.string().describe('What is being measured'),
+    value: z.number().describe('Where the reading sits. Clamped to the range'),
+    min: z.number().optional().describe('Bottom of the range. Defaults to 0'),
+    max: z.number().optional().describe('Top of the range. Defaults to 100'),
+    shape: ProgressShapeSchema.optional().describe('Defaults to bar'),
+    color: ProgressColorSchema.optional().describe('Defaults to accent'),
+    unit: z.string().optional().describe('Written after the value'),
+    valueLabel: z.string().optional().describe('The readout in words, replacing value and unit'),
+    caption: z.string().optional().describe('One quiet line under the reading'),
+    icon: z.string().optional().describe('Icon name'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('Progress component')
+
 export const KeyValueRowSchema = z
   .object({
     label: z.string(),
@@ -794,6 +828,10 @@ export type ChartSeries = z.infer<typeof ChartSeriesSchema>
 export type ChartProps = z.infer<typeof ChartPropsSchema>
 export type StatTrend = z.infer<typeof StatTrendSchema>
 export type StatTileProps = z.infer<typeof StatTilePropsSchema>
+export type ClockProps = z.infer<typeof ClockPropsSchema>
+export type ProgressShape = z.infer<typeof ProgressShapeSchema>
+export type ProgressColor = z.infer<typeof ProgressColorSchema>
+export type ProgressBarProps = z.infer<typeof ProgressBarPropsSchema>
 export type KeyValueRow = z.infer<typeof KeyValueRowSchema>
 export type KeyValueListProps = z.infer<typeof KeyValueListPropsSchema>
 export type TimelineVariant = z.infer<typeof TimelineVariantSchema>