@stina/extension-api 1.7.0 → 1.16.0

package/dist/{types.tools-DcFBsfRV.d.cts → types.tools-CK0As7KV.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
@@ -2611,4 +2665,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 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 AgendaEvent as bp, type AgendaDay as bq, type AgendaProps as br, type ExecutionContext as bs, 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 };

package/dist/{types.tools-DcFBsfRV.d.ts → types.tools-CK0As7KV.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
@@ -2611,4 +2665,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 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 AgendaEvent as bp, type AgendaDay as bq, type AgendaProps as br, type ExecutionContext as bs, 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 };

package/package.json

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

package/src/index.ts

@@ -226,4 +226,7 @@ export type {
   NoteProps,
   CalendarEventStatus,
   CalendarEventProps,
+  AgendaEvent,
+  AgendaDay,
+  AgendaProps,
 } from './types.components.js'

package/src/schemas/card.schema.test.ts

@@ -30,6 +30,30 @@ describe('validateChatCard', () => {
     expect(result.ok).toBe(true)
   })
 
+  it('accepts a quotation with its attribution', () => {
+    const result = validateChatCard({
+      component: 'Quote',
+      text: 'Fyll gärna i del två i mallen innan vi ses.',
+      source: 'Maria Lind',
+      context: 'i morse 07:42',
+      footer: 'Ur mejlet om medarbetarsamtalet',
+    })
+
+    expect(result.ok).toBe(true)
+  })
+
+  it('rejects markup properties on a quotation', () => {
+    // Quoted text is printed as it arrived. A property that implied formatting
+    // would let someone else's words be dressed up as Stina's own.
+    const result = validateChatCard({
+      component: 'Quote',
+      text: 'Fyll gärna i del två.',
+      variant: 'accent',
+    })
+
+    expect(result.ok).toBe(false)
+  })
+
   it('accepts an icon beside every heading that has one', () => {
     for (const card of [
       { component: 'Chart', icon: 'temperature', series: [{ points: [1] }] },

package/src/schemas/card.schema.ts

@@ -333,6 +333,17 @@ const NoteCardSchema = z
   })
   .strict()
 
+const QuoteCardSchema = z
+  .object({
+    component: z.literal('Quote'),
+    text: z.string(),
+    source: z.string().optional(),
+    context: z.string().optional(),
+    footer: z.string().optional(),
+    style,
+  })
+  .strict()
+
 const CalendarEventCardSchema = z
   .object({
     component: z.literal('CalendarEvent'),
@@ -373,6 +384,7 @@ export const CHAT_CARD_COMPONENTS = [
   'KeyValueList',
   'Timeline',
   'Note',
+  'Quote',
   'CalendarEvent',
 ] as const
 
@@ -406,6 +418,7 @@ const CARD_MEMBERS = [
   KeyValueListCardSchema,
   TimelineCardSchema,
   NoteCardSchema,
+  QuoteCardSchema,
   CalendarEventCardSchema,
 ] as const
 

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/index.ts

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

package/src/types.components.ts

@@ -886,6 +886,33 @@ export interface NoteProps extends ExtensionComponentData {
   variant?: NoteVariant
 }
 
+/**
+ * The extension API properties for the Quote component.
+ *
+ * Someone else's words, set apart and attributed. For the sentence out of a mail
+ * that actually answers the question, the line from a document worth reading as
+ * written, the message a colleague sent.
+ *
+ * The text is rendered as written and never as markdown, which is the whole
+ * point of it existing beside `Note`: a link or a heading inside quoted text
+ * would be formatted as though Stina had put it there. `Note` is for the user's
+ * own writing and for hers; this is for everyone else's.
+ *
+ * Quote what bears quoting, not the whole message. A card is a thing to glance
+ * at, and a page of pasted mail is a page nobody reads.
+ */
+export interface QuoteProps extends ExtensionComponentData {
+  component: 'Quote'
+  /** The words themselves, verbatim. Rendered as written, never as markdown. */
+  text: string
+  /** Who wrote or said it, as they are known: a name, an address, a title. */
+  source?: string
+  /** When or where it came from: `i morse 07:42`, `i mötesanteckningarna`. */
+  context?: string
+  /** One quiet line under the quotation, for what is worth adding about it. */
+  footer?: string
+}
+
 /** Whether an event is going ahead. */
 export type CalendarEventStatus = 'confirmed' | 'tentative' | 'cancelled'
 
@@ -932,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
+}