@stina/extension-api 1.9.0 → 1.17.0

package/dist/{types.tools-DcFBsfRV.d.cts → types.tools-DswDxtun.d.cts}

@@ -770,6 +770,60 @@ interface CalendarEventProps extends ExtensionComponentData {
     /** One short line of context. */
     notes?: string;
 }
+/**
+ * One event on an agenda.
+ *
+ * Timestamps rather than worded times, for the same reason as `CalendarEvent`:
+ * the agenda is about where today stands, and it can only keep that true if it
+ * knows when things actually start and end.
+ */
+interface AgendaEvent {
+    /** Handed back to `onEventClickAction` as `$event.id`. Not shown. */
+    id?: string;
+    title: string;
+    /** ISO 8601, with an offset. */
+    start: string;
+    /** ISO 8601, with an offset. Absent for an event with no stated end. */
+    end?: string;
+    /** Drawn as a chip above the day's list rather than in it. */
+    allDay?: boolean;
+    /** One quiet line under the title: a place, a meeting link, a room. */
+    detail?: string;
+}
+/** One day on an agenda, as the caller groups them. */
+interface AgendaDay {
+    /** The day's heading, e.g. "Idag". */
+    label: string;
+    /** A quieter line beside the heading, e.g. "tis 6 okt". */
+    date?: string;
+    events: AgendaEvent[];
+}
+/**
+ * The extension API properties for the Agenda component.
+ *
+ * A day's schedule that knows what time it is. What is behind us recedes, what
+ * is running is lifted out with its progress drawn down its edge, what comes
+ * next counts down, and a line marks the gap we are in. The host works all of
+ * that out from the timestamps and keeps it current while the panel is open.
+ *
+ * For milestones, or anything whose times are words rather than instants, use
+ * `Timeline`. This is for a schedule.
+ */
+interface AgendaProps extends ExtensionComponentData {
+    component: 'Agenda';
+    /** Heading above the days. */
+    title?: string;
+    /** Icon shown to the left of the title. */
+    icon?: HugeIconName;
+    days: AgendaDay[];
+    /**
+     * Word clashes: "Krockar med 11:00", "2 samtidigt". Off by default, since a
+     * schedule of lessons or training sessions has nothing to warn about.
+     */
+    warnOverlaps?: boolean;
+    /** Called when an event is clicked, with the event in scope as `$event`. */
+    onEventClickAction?: ExtensionActionRef;
+}
 
 /**
  * What an extension can contribute to Stina
@@ -840,6 +894,29 @@ interface AccountContribution {
     /** Why the extension needs them, shown next to the scopes in the settings. */
     reason?: LocalizedString;
 }
+/**
+ * What a settings view is about, which decides where Stina shows it.
+ *
+ * An extension never picks a place in the settings menu: the menu belongs to Stina and
+ * changes between versions. It says what the view is *about*, and Stina puts each topic
+ * where it belongs, the way `accounts`, `providers` and `statusCards` already work.
+ *
+ * - `accounts`: connects Stina to an account or a service (a mailbox, a calendar feed).
+ *   Shown with the other connected accounts.
+ * - `notifications`: when and how the extension may get in touch. Shown with Stina's own
+ *   notification settings.
+ * - `personal`: facts about the user the extension relies on (a home town for the
+ *   weather). Shown with the profile.
+ * - `tracking`: things Stina keeps track of for the user that are worth looking through
+ *   now and then (people, projects, reminders). Gets its own row in the register.
+ *
+ * A view without a topic, or with one this version of Stina does not know, is shown on
+ * the extension's own page. That is always a working place, only a less fitting one, so
+ * a topic added later never breaks an older Stina.
+ */
+type ExtensionSettingsTopic = 'accounts' | 'notifications' | 'personal' | 'tracking';
+/** Every topic this version of the API knows, in no particular order. */
+declare const EXTENSION_SETTINGS_TOPICS: readonly ExtensionSettingsTopic[];
 /**
  * Tool settings view definition (UI schema)
  */
@@ -850,6 +927,8 @@ interface ToolSettingsViewDefinition {
     title: string;
     /** Help text */
     description?: string;
+    /** What the view is about, and so where Stina shows it. See {@link ExtensionSettingsTopic}. */
+    topic?: ExtensionSettingsTopic;
     /** View configuration */
     view: ToolSettingsView;
 }
@@ -2611,4 +2690,4 @@ interface ActionResult {
     error?: string;
 }
 
-export { type ConnectedAccountsAPI as $, type ActionResult as A, type ProvidersAPI as B, type ChatMessage as C, type Disposable as D, type ExtensionContributions as E, type ToolsAPI as F, type GetModelsOptions as G, type HugeIconName as H, type ActionsAPI as I, type EventsAPI as J, type SchedulerAPI as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type SchedulerJobRequest as O, type PanelDefinition as P, type SchedulerSchedule as Q, type UserProfile as R, type SchedulerFirePayload as S, type ToolResult as T, type UserAPI as U, type VoiceSessionOptions as V, type ChatAPI as W, type ChatInstructionMessage as X, type ConversationPresentation as Y, type AttachmentsAPI as Z, type AttachmentContent as _, type ChatOptions as a, type MarkdownProps as a$, type ConnectedAccount as a0, type AccountAccessToken as a1, type LogAPI as a2, type BackgroundWorkersAPI as a3, type BackgroundTaskConfig as a4, type BackgroundTaskCallback as a5, type BackgroundTaskContext as a6, type BackgroundTaskHealth as a7, type BackgroundRestartPolicy as a8, type Query as a9, type ClockProps as aA, type ParagraphProps as aB, type ButtonProps as aC, type TextInputProps as aD, type PasswordInputProps as aE, type NumberInputProps as aF, type TextAreaProps as aG, type DateTimeInputProps as aH, type SelectProps as aI, type IconPickerProps as aJ, type VerticalStackProps as aK, type HorizontalStackProps as aL, type GridProps as aM, type DividerProps as aN, type IconProps as aO, type IconButtonType as aP, type IconButtonProps as aQ, type PanelAction as aR, type PanelProps as aS, type ToggleProps as aT, type CollapsibleProps as aU, type FrameVariant as aV, type FrameProps as aW, type ListProps as aX, type PillVariant as aY, type PillProps as aZ, type CheckboxProps as a_, type QueryOptions as aa, type StorageAPI as ab, type SecretsAPI as ac, type StorageCollectionConfig as ad, type StorageContributions as ae, type AIProvider as af, type ModelCapabilities as ag, type ChatImage as ah, type ChatFile as ai, type ToolCall as aj, type VoiceTransportRequest as ak, type Tool as al, type ToolAttachment as am, type Action as an, type ExtensionModule as ao, type AllowedCSSProperty as ap, type ExtensionComponentStyle as aq, type ExtensionComponentData as ar, type ExtensionComponentIterator as as, type ExtensionComponentChildren as at, type ExtensionActionCall as au, type ExtensionActionRef as av, type ExtensionDataSource as aw, type ExtensionPanelDefinition as ax, type HeaderProps as ay, type LabelProps as az, type StreamEvent as b, type TextPreviewProps as b0, type ModalProps as b1, type ConditionalGroupProps as b2, type WeatherCondition as b3, type WeatherWind as b4, type WeatherNowProps as b5, type WeatherForecastStep as b6, type WeatherForecastProps as b7, type ChartKind as b8, type ChartSeries as b9, type ChartProps as ba, type StatTrend as bb, type StatTileProps as bc, type ProgressShape as bd, type ProgressColor as be, type ProgressBarProps as bf, type KeyValueRow as bg, type KeyValueListProps as bh, type TimelineVariant as bi, type TimelineEntry as bj, type TimelineProps as bk, type NoteVariant as bl, type NoteProps as bm, type CalendarEventStatus as bn, type CalendarEventProps as bo, type ExecutionContext as bp, 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 AccountProvider as w, type AccountContribution as x, type ExtensionContext as y, type SettingsAPI as z };
+export { type AttachmentsAPI as $, type ActionResult as A, type ExtensionContext as B, type ChatMessage as C, type Disposable as D, type ExtensionContributions as E, type SettingsAPI as F, type GetModelsOptions as G, type HugeIconName as H, type ProvidersAPI as I, type ToolsAPI as J, type ActionsAPI as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type EventsAPI as O, type PanelDefinition as P, type SchedulerAPI as Q, type SchedulerJobRequest as R, type SchedulerFirePayload as S, type ToolResult as T, type SchedulerSchedule as U, type VoiceSessionOptions as V, type UserAPI as W, type UserProfile as X, type ChatAPI as Y, type ChatInstructionMessage as Z, type ConversationPresentation as _, type ChatOptions as a, type PillProps as a$, type AttachmentContent as a0, type ConnectedAccountsAPI as a1, type ConnectedAccount as a2, type AccountAccessToken as a3, type LogAPI as a4, type BackgroundWorkersAPI as a5, type BackgroundTaskConfig as a6, type BackgroundTaskCallback as a7, type BackgroundTaskContext as a8, type BackgroundTaskHealth as a9, type HeaderProps as aA, type LabelProps as aB, type ClockProps as aC, type ParagraphProps as aD, type ButtonProps as aE, type TextInputProps as aF, type PasswordInputProps as aG, type NumberInputProps as aH, type TextAreaProps as aI, type DateTimeInputProps as aJ, type SelectProps as aK, type IconPickerProps as aL, type VerticalStackProps as aM, type HorizontalStackProps as aN, type GridProps as aO, type DividerProps as aP, type IconProps as aQ, type IconButtonType as aR, type IconButtonProps as aS, type PanelAction as aT, type PanelProps as aU, type ToggleProps as aV, type CollapsibleProps as aW, type FrameVariant as aX, type FrameProps as aY, type ListProps as aZ, type PillVariant as a_, type BackgroundRestartPolicy as aa, type Query as ab, type QueryOptions as ac, type StorageAPI as ad, type SecretsAPI as ae, type StorageCollectionConfig as af, type StorageContributions as ag, type AIProvider as ah, type ModelCapabilities as ai, type ChatImage as aj, type ChatFile as ak, type ToolCall as al, type VoiceTransportRequest as am, type Tool as an, type ToolAttachment as ao, type Action as ap, type ExtensionModule as aq, type AllowedCSSProperty as ar, type ExtensionComponentStyle as as, type ExtensionComponentData as at, type ExtensionComponentIterator as au, type ExtensionComponentChildren as av, type ExtensionActionCall as aw, type ExtensionActionRef as ax, type ExtensionDataSource as ay, type ExtensionPanelDefinition as az, type StreamEvent as b, type CheckboxProps as b0, type MarkdownProps as b1, type TextPreviewProps as b2, type ModalProps as b3, type ConditionalGroupProps as b4, type WeatherCondition as b5, type WeatherWind as b6, type WeatherNowProps as b7, type WeatherForecastStep as b8, type WeatherForecastProps as b9, type ChartKind as ba, type ChartSeries as bb, type ChartProps as bc, type StatTrend as bd, type StatTileProps as be, type ProgressShape as bf, type ProgressColor as bg, type ProgressBarProps as bh, type KeyValueRow as bi, type KeyValueListProps as bj, type TimelineVariant as bk, type TimelineEntry as bl, type TimelineProps as bm, type NoteVariant as bn, type NoteProps as bo, type CalendarEventStatus as bp, type CalendarEventProps as bq, type AgendaEvent as br, type AgendaDay as bs, type AgendaProps as bt, type ExecutionContext as bu, type VoiceSessionDescriptor as c, EXTENSION_SETTINGS_TOPICS as d, type ToolSettingsViewDefinition as e, type ExtensionSettingsTopic as f, type ToolSettingsView as g, type ToolSettingsListView as h, type ToolSettingsListMapping as i, type ToolSettingsComponentView as j, type ToolSettingsActionDataSource as k, type StatusCardDefinition as l, type PanelView as m, type PanelComponentView as n, type PanelActionDataSource as o, type PanelUnknownView as p, type ProviderDefinition as q, resolveLocalizedString as r, type ProviderConfigView as s, type PromptContribution as t, type PromptSection as u, type ToolDefinition as v, type ToolConfirmationConfig as w, type CommandDefinition as x, type AccountProvider as y, type AccountContribution as z };

package/dist/{types.tools-DcFBsfRV.d.ts → types.tools-DswDxtun.d.ts}

@@ -770,6 +770,60 @@ interface CalendarEventProps extends ExtensionComponentData {
     /** One short line of context. */
     notes?: string;
 }
+/**
+ * One event on an agenda.
+ *
+ * Timestamps rather than worded times, for the same reason as `CalendarEvent`:
+ * the agenda is about where today stands, and it can only keep that true if it
+ * knows when things actually start and end.
+ */
+interface AgendaEvent {
+    /** Handed back to `onEventClickAction` as `$event.id`. Not shown. */
+    id?: string;
+    title: string;
+    /** ISO 8601, with an offset. */
+    start: string;
+    /** ISO 8601, with an offset. Absent for an event with no stated end. */
+    end?: string;
+    /** Drawn as a chip above the day's list rather than in it. */
+    allDay?: boolean;
+    /** One quiet line under the title: a place, a meeting link, a room. */
+    detail?: string;
+}
+/** One day on an agenda, as the caller groups them. */
+interface AgendaDay {
+    /** The day's heading, e.g. "Idag". */
+    label: string;
+    /** A quieter line beside the heading, e.g. "tis 6 okt". */
+    date?: string;
+    events: AgendaEvent[];
+}
+/**
+ * The extension API properties for the Agenda component.
+ *
+ * A day's schedule that knows what time it is. What is behind us recedes, what
+ * is running is lifted out with its progress drawn down its edge, what comes
+ * next counts down, and a line marks the gap we are in. The host works all of
+ * that out from the timestamps and keeps it current while the panel is open.
+ *
+ * For milestones, or anything whose times are words rather than instants, use
+ * `Timeline`. This is for a schedule.
+ */
+interface AgendaProps extends ExtensionComponentData {
+    component: 'Agenda';
+    /** Heading above the days. */
+    title?: string;
+    /** Icon shown to the left of the title. */
+    icon?: HugeIconName;
+    days: AgendaDay[];
+    /**
+     * Word clashes: "Krockar med 11:00", "2 samtidigt". Off by default, since a
+     * schedule of lessons or training sessions has nothing to warn about.
+     */
+    warnOverlaps?: boolean;
+    /** Called when an event is clicked, with the event in scope as `$event`. */
+    onEventClickAction?: ExtensionActionRef;
+}
 
 /**
  * What an extension can contribute to Stina
@@ -840,6 +894,29 @@ interface AccountContribution {
     /** Why the extension needs them, shown next to the scopes in the settings. */
     reason?: LocalizedString;
 }
+/**
+ * What a settings view is about, which decides where Stina shows it.
+ *
+ * An extension never picks a place in the settings menu: the menu belongs to Stina and
+ * changes between versions. It says what the view is *about*, and Stina puts each topic
+ * where it belongs, the way `accounts`, `providers` and `statusCards` already work.
+ *
+ * - `accounts`: connects Stina to an account or a service (a mailbox, a calendar feed).
+ *   Shown with the other connected accounts.
+ * - `notifications`: when and how the extension may get in touch. Shown with Stina's own
+ *   notification settings.
+ * - `personal`: facts about the user the extension relies on (a home town for the
+ *   weather). Shown with the profile.
+ * - `tracking`: things Stina keeps track of for the user that are worth looking through
+ *   now and then (people, projects, reminders). Gets its own row in the register.
+ *
+ * A view without a topic, or with one this version of Stina does not know, is shown on
+ * the extension's own page. That is always a working place, only a less fitting one, so
+ * a topic added later never breaks an older Stina.
+ */
+type ExtensionSettingsTopic = 'accounts' | 'notifications' | 'personal' | 'tracking';
+/** Every topic this version of the API knows, in no particular order. */
+declare const EXTENSION_SETTINGS_TOPICS: readonly ExtensionSettingsTopic[];
 /**
  * Tool settings view definition (UI schema)
  */
@@ -850,6 +927,8 @@ interface ToolSettingsViewDefinition {
     title: string;
     /** Help text */
     description?: string;
+    /** What the view is about, and so where Stina shows it. See {@link ExtensionSettingsTopic}. */
+    topic?: ExtensionSettingsTopic;
     /** View configuration */
     view: ToolSettingsView;
 }
@@ -2611,4 +2690,4 @@ interface ActionResult {
     error?: string;
 }
 
-export { type ConnectedAccountsAPI as $, type ActionResult as A, type ProvidersAPI as B, type ChatMessage as C, type Disposable as D, type ExtensionContributions as E, type ToolsAPI as F, type GetModelsOptions as G, type HugeIconName as H, type ActionsAPI as I, type EventsAPI as J, type SchedulerAPI as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type SchedulerJobRequest as O, type PanelDefinition as P, type SchedulerSchedule as Q, type UserProfile as R, type SchedulerFirePayload as S, type ToolResult as T, type UserAPI as U, type VoiceSessionOptions as V, type ChatAPI as W, type ChatInstructionMessage as X, type ConversationPresentation as Y, type AttachmentsAPI as Z, type AttachmentContent as _, type ChatOptions as a, type MarkdownProps as a$, type ConnectedAccount as a0, type AccountAccessToken as a1, type LogAPI as a2, type BackgroundWorkersAPI as a3, type BackgroundTaskConfig as a4, type BackgroundTaskCallback as a5, type BackgroundTaskContext as a6, type BackgroundTaskHealth as a7, type BackgroundRestartPolicy as a8, type Query as a9, type ClockProps as aA, type ParagraphProps as aB, type ButtonProps as aC, type TextInputProps as aD, type PasswordInputProps as aE, type NumberInputProps as aF, type TextAreaProps as aG, type DateTimeInputProps as aH, type SelectProps as aI, type IconPickerProps as aJ, type VerticalStackProps as aK, type HorizontalStackProps as aL, type GridProps as aM, type DividerProps as aN, type IconProps as aO, type IconButtonType as aP, type IconButtonProps as aQ, type PanelAction as aR, type PanelProps as aS, type ToggleProps as aT, type CollapsibleProps as aU, type FrameVariant as aV, type FrameProps as aW, type ListProps as aX, type PillVariant as aY, type PillProps as aZ, type CheckboxProps as a_, type QueryOptions as aa, type StorageAPI as ab, type SecretsAPI as ac, type StorageCollectionConfig as ad, type StorageContributions as ae, type AIProvider as af, type ModelCapabilities as ag, type ChatImage as ah, type ChatFile as ai, type ToolCall as aj, type VoiceTransportRequest as ak, type Tool as al, type ToolAttachment as am, type Action as an, type ExtensionModule as ao, type AllowedCSSProperty as ap, type ExtensionComponentStyle as aq, type ExtensionComponentData as ar, type ExtensionComponentIterator as as, type ExtensionComponentChildren as at, type ExtensionActionCall as au, type ExtensionActionRef as av, type ExtensionDataSource as aw, type ExtensionPanelDefinition as ax, type HeaderProps as ay, type LabelProps as az, type StreamEvent as b, type TextPreviewProps as b0, type ModalProps as b1, type ConditionalGroupProps as b2, type WeatherCondition as b3, type WeatherWind as b4, type WeatherNowProps as b5, type WeatherForecastStep as b6, type WeatherForecastProps as b7, type ChartKind as b8, type ChartSeries as b9, type ChartProps as ba, type StatTrend as bb, type StatTileProps as bc, type ProgressShape as bd, type ProgressColor as be, type ProgressBarProps as bf, type KeyValueRow as bg, type KeyValueListProps as bh, type TimelineVariant as bi, type TimelineEntry as bj, type TimelineProps as bk, type NoteVariant as bl, type NoteProps as bm, type CalendarEventStatus as bn, type CalendarEventProps as bo, type ExecutionContext as bp, 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 AccountProvider as w, type AccountContribution as x, type ExtensionContext as y, type SettingsAPI as z };
+export { type AttachmentsAPI as $, type ActionResult as A, type ExtensionContext as B, type ChatMessage as C, type Disposable as D, type ExtensionContributions as E, type SettingsAPI as F, type GetModelsOptions as G, type HugeIconName as H, type ProvidersAPI as I, type ToolsAPI as J, type ActionsAPI as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type EventsAPI as O, type PanelDefinition as P, type SchedulerAPI as Q, type SchedulerJobRequest as R, type SchedulerFirePayload as S, type ToolResult as T, type SchedulerSchedule as U, type VoiceSessionOptions as V, type UserAPI as W, type UserProfile as X, type ChatAPI as Y, type ChatInstructionMessage as Z, type ConversationPresentation as _, type ChatOptions as a, type PillProps as a$, type AttachmentContent as a0, type ConnectedAccountsAPI as a1, type ConnectedAccount as a2, type AccountAccessToken as a3, type LogAPI as a4, type BackgroundWorkersAPI as a5, type BackgroundTaskConfig as a6, type BackgroundTaskCallback as a7, type BackgroundTaskContext as a8, type BackgroundTaskHealth as a9, type HeaderProps as aA, type LabelProps as aB, type ClockProps as aC, type ParagraphProps as aD, type ButtonProps as aE, type TextInputProps as aF, type PasswordInputProps as aG, type NumberInputProps as aH, type TextAreaProps as aI, type DateTimeInputProps as aJ, type SelectProps as aK, type IconPickerProps as aL, type VerticalStackProps as aM, type HorizontalStackProps as aN, type GridProps as aO, type DividerProps as aP, type IconProps as aQ, type IconButtonType as aR, type IconButtonProps as aS, type PanelAction as aT, type PanelProps as aU, type ToggleProps as aV, type CollapsibleProps as aW, type FrameVariant as aX, type FrameProps as aY, type ListProps as aZ, type PillVariant as a_, type BackgroundRestartPolicy as aa, type Query as ab, type QueryOptions as ac, type StorageAPI as ad, type SecretsAPI as ae, type StorageCollectionConfig as af, type StorageContributions as ag, type AIProvider as ah, type ModelCapabilities as ai, type ChatImage as aj, type ChatFile as ak, type ToolCall as al, type VoiceTransportRequest as am, type Tool as an, type ToolAttachment as ao, type Action as ap, type ExtensionModule as aq, type AllowedCSSProperty as ar, type ExtensionComponentStyle as as, type ExtensionComponentData as at, type ExtensionComponentIterator as au, type ExtensionComponentChildren as av, type ExtensionActionCall as aw, type ExtensionActionRef as ax, type ExtensionDataSource as ay, type ExtensionPanelDefinition as az, type StreamEvent as b, type CheckboxProps as b0, type MarkdownProps as b1, type TextPreviewProps as b2, type ModalProps as b3, type ConditionalGroupProps as b4, type WeatherCondition as b5, type WeatherWind as b6, type WeatherNowProps as b7, type WeatherForecastStep as b8, type WeatherForecastProps as b9, type ChartKind as ba, type ChartSeries as bb, type ChartProps as bc, type StatTrend as bd, type StatTileProps as be, type ProgressShape as bf, type ProgressColor as bg, type ProgressBarProps as bh, type KeyValueRow as bi, type KeyValueListProps as bj, type TimelineVariant as bk, type TimelineEntry as bl, type TimelineProps as bm, type NoteVariant as bn, type NoteProps as bo, type CalendarEventStatus as bp, type CalendarEventProps as bq, type AgendaEvent as br, type AgendaDay as bs, type AgendaProps as bt, type ExecutionContext as bu, type VoiceSessionDescriptor as c, EXTENSION_SETTINGS_TOPICS as d, type ToolSettingsViewDefinition as e, type ExtensionSettingsTopic as f, type ToolSettingsView as g, type ToolSettingsListView as h, type ToolSettingsListMapping as i, type ToolSettingsComponentView as j, type ToolSettingsActionDataSource as k, type StatusCardDefinition as l, type PanelView as m, type PanelComponentView as n, type PanelActionDataSource as o, type PanelUnknownView as p, type ProviderDefinition as q, resolveLocalizedString as r, type ProviderConfigView as s, type PromptContribution as t, type PromptSection as u, type ToolDefinition as v, type ToolConfirmationConfig as w, type CommandDefinition as x, type AccountProvider as y, type AccountContribution as z };

package/package.json

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

package/schema/extension-manifest.schema.json

@@ -163,6 +163,10 @@
                     "type": "string",
                     "description": "Help text"
                   },
+                  "topic": {
+                    "type": "string",
+                    "description": "What the view is about, which decides where Stina shows it: accounts, notifications, personal or tracking. Without one, or with one Stina does not know, the view is shown on the extension's own page."
+                  },
                   "view": {
                     "anyOf": [
                       {

package/src/index.ts

@@ -10,6 +10,7 @@
 // Localization
 export type { LocalizedString } from './types.js'
 export { resolveLocalizedString } from './types.js'
+export { EXTENSION_SETTINGS_TOPICS } from './types.js'
 
 // Types
 export type {
@@ -18,6 +19,7 @@ export type {
   Platform,
   ExtensionContributions,
   ToolSettingsViewDefinition,
+  ExtensionSettingsTopic,
   ToolSettingsView,
   ToolSettingsListView,
   ToolSettingsListMapping,
@@ -226,4 +228,7 @@ export type {
   NoteProps,
   CalendarEventStatus,
   CalendarEventProps,
+  AgendaEvent,
+  AgendaDay,
+  AgendaProps,
 } from './types.components.js'

package/src/schemas/components.schema.ts

@@ -774,6 +774,42 @@ export const CalendarEventPropsSchema = z
   .passthrough()
   .describe('Single calendar event component')
 
+export const AgendaEventSchema = z
+  .object({
+    id: z.string().optional().describe('Handed back to onEventClickAction as $event.id'),
+    title: z.string(),
+    start: z.string().describe('ISO 8601 with an offset'),
+    end: z.string().optional().describe('ISO 8601 with an offset'),
+    allDay: z.boolean().optional(),
+    detail: z.string().optional().describe('One quiet line under the title'),
+  })
+  .passthrough()
+  .describe('One agenda event')
+
+export const AgendaDaySchema = z
+  .object({
+    label: z.string().describe('The day heading'),
+    date: z.string().optional().describe('A quieter line beside the heading'),
+    events: z.array(AgendaEventSchema),
+  })
+  .passthrough()
+  .describe('One agenda day')
+
+export const AgendaPropsSchema = z
+  .object({
+    component: z.literal('Agenda'),
+    title: z.string().optional(),
+    icon: z.string().optional().describe('Icon shown to the left of the title'),
+    days: z.array(AgendaDaySchema),
+    warnOverlaps: z.boolean().optional().describe('Word clashes between events'),
+    onEventClickAction: ExtensionActionRefSchema.optional().describe(
+      'Action to call when an event is clicked, with the event as $event'
+    ),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('Schedule component that tracks the current time')
+
 // =============================================================================
 // Type Exports
 // =============================================================================
@@ -841,3 +877,6 @@ export type NoteVariant = z.infer<typeof NoteVariantSchema>
 export type NoteProps = z.infer<typeof NotePropsSchema>
 export type CalendarEventStatus = z.infer<typeof CalendarEventStatusSchema>
 export type CalendarEventProps = z.infer<typeof CalendarEventPropsSchema>
+export type AgendaEvent = z.infer<typeof AgendaEventSchema>
+export type AgendaDay = z.infer<typeof AgendaDaySchema>
+export type AgendaProps = z.infer<typeof AgendaPropsSchema>

package/src/schemas/contributions.schema.ts

@@ -117,6 +117,14 @@ export const ToolSettingsViewDefinitionSchema = z
     id: z.string().describe('Unique view ID within the extension'),
     title: z.string().describe('Display title'),
     description: z.string().optional().describe('Help text'),
+    // A string rather than the known topics: one this host does not know yet must not stop
+    // the extension installing, it only lands on the extension's own page.
+    topic: z
+      .string()
+      .optional()
+      .describe(
+        'What the view is about, which decides where Stina shows it: accounts, notifications, personal or tracking. Without one, or with one Stina does not know, the view is shown on the extension\'s own page.'
+      ),
     view: ToolSettingsViewSchema.describe('View configuration'),
   })
   .describe('Tool settings view definition')

package/src/schemas/index.ts

@@ -149,6 +149,9 @@ export {
   NotePropsSchema,
   CalendarEventStatusSchema,
   CalendarEventPropsSchema,
+  AgendaEventSchema,
+  AgendaDaySchema,
+  AgendaPropsSchema,
   type ExtensionComponentData,
   type ExtensionComponentStyle,
   type ExtensionActionCall,

package/src/types.components.ts

@@ -959,3 +959,60 @@ export interface CalendarEventProps extends ExtensionComponentData {
   /** One short line of context. */
   notes?: string
 }
+
+/**
+ * One event on an agenda.
+ *
+ * Timestamps rather than worded times, for the same reason as `CalendarEvent`:
+ * the agenda is about where today stands, and it can only keep that true if it
+ * knows when things actually start and end.
+ */
+export interface AgendaEvent {
+  /** Handed back to `onEventClickAction` as `$event.id`. Not shown. */
+  id?: string
+  title: string
+  /** ISO 8601, with an offset. */
+  start: string
+  /** ISO 8601, with an offset. Absent for an event with no stated end. */
+  end?: string
+  /** Drawn as a chip above the day's list rather than in it. */
+  allDay?: boolean
+  /** One quiet line under the title: a place, a meeting link, a room. */
+  detail?: string
+}
+
+/** One day on an agenda, as the caller groups them. */
+export interface AgendaDay {
+  /** The day's heading, e.g. "Idag". */
+  label: string
+  /** A quieter line beside the heading, e.g. "tis 6 okt". */
+  date?: string
+  events: AgendaEvent[]
+}
+
+/**
+ * The extension API properties for the Agenda component.
+ *
+ * A day's schedule that knows what time it is. What is behind us recedes, what
+ * is running is lifted out with its progress drawn down its edge, what comes
+ * next counts down, and a line marks the gap we are in. The host works all of
+ * that out from the timestamps and keeps it current while the panel is open.
+ *
+ * For milestones, or anything whose times are words rather than instants, use
+ * `Timeline`. This is for a schedule.
+ */
+export interface AgendaProps extends ExtensionComponentData {
+  component: 'Agenda'
+  /** Heading above the days. */
+  title?: string
+  /** Icon shown to the left of the title. */
+  icon?: HugeIconName
+  days: AgendaDay[]
+  /**
+   * Word clashes: "Krockar med 11:00", "2 samtidigt". Off by default, since a
+   * schedule of lessons or training sessions has nothing to warn about.
+   */
+  warnOverlaps?: boolean
+  /** Called when an event is clicked, with the event in scope as `$event`. */
+  onEventClickAction?: ExtensionActionRef
+}

package/src/types.contributions.ts

@@ -87,6 +87,36 @@ export interface AccountContribution {
 // Tool Settings Views
 // ============================================================================
 
+/**
+ * What a settings view is about, which decides where Stina shows it.
+ *
+ * An extension never picks a place in the settings menu: the menu belongs to Stina and
+ * changes between versions. It says what the view is *about*, and Stina puts each topic
+ * where it belongs, the way `accounts`, `providers` and `statusCards` already work.
+ *
+ * - `accounts`: connects Stina to an account or a service (a mailbox, a calendar feed).
+ *   Shown with the other connected accounts.
+ * - `notifications`: when and how the extension may get in touch. Shown with Stina's own
+ *   notification settings.
+ * - `personal`: facts about the user the extension relies on (a home town for the
+ *   weather). Shown with the profile.
+ * - `tracking`: things Stina keeps track of for the user that are worth looking through
+ *   now and then (people, projects, reminders). Gets its own row in the register.
+ *
+ * A view without a topic, or with one this version of Stina does not know, is shown on
+ * the extension's own page. That is always a working place, only a less fitting one, so
+ * a topic added later never breaks an older Stina.
+ */
+export type ExtensionSettingsTopic = 'accounts' | 'notifications' | 'personal' | 'tracking'
+
+/** Every topic this version of the API knows, in no particular order. */
+export const EXTENSION_SETTINGS_TOPICS: readonly ExtensionSettingsTopic[] = [
+  'accounts',
+  'notifications',
+  'personal',
+  'tracking',
+]
+
 /**
  * Tool settings view definition (UI schema)
  */
@@ -97,6 +127,8 @@ export interface ToolSettingsViewDefinition {
   title: string
   /** Help text */
   description?: string
+  /** What the view is about, and so where Stina shows it. See {@link ExtensionSettingsTopic}. */
+  topic?: ExtensionSettingsTopic
   /** View configuration */
   view: ToolSettingsView
 }

package/src/types.ts

@@ -24,6 +24,7 @@ export type {
   ExtensionContributions,
   // Tool Settings Views
   ToolSettingsViewDefinition,
+  ExtensionSettingsTopic,
   ToolSettingsView,
   ToolSettingsListView,
   ToolSettingsListMapping,
@@ -51,6 +52,7 @@ export type {
   AccountProvider,
   AccountContribution,
 } from './types.contributions.js'
+export { EXTENSION_SETTINGS_TOPICS } from './types.contributions.js'
 
 // Manifest
 export type { ExtensionManifest, Platform } from './types.manifest.js'