@stina/extension-api 0.57.0 → 1.0.0

package/dist/schemas/index.js

@@ -24,6 +24,7 @@ var VALID_PERMISSIONS = [
   "settings.register",
   "commands.register",
   "panels.register",
+  "statusCards.register",
   "events.emit",
   "scheduler.register",
   "background.workers",
@@ -60,6 +61,7 @@ var CapabilityPermissionSchema = z.enum([
   "settings.register",
   "commands.register",
   "panels.register",
+  "statusCards.register",
   "events.emit",
   "scheduler.register",
   "chat.message.write",
@@ -477,6 +479,22 @@ var StatTilePropsSchema = z2.object({
   trendIsGood: z2.boolean().optional().describe("Whether up is the good direction. Defaults to true"),
   style: ExtensionComponentStyleSchema.optional()
 }).passthrough().describe("Single-number stat tile component");
+var ProgressShapeSchema = z2.enum(["bar", "circle"]).describe("Drawn as a rail or as a ring");
+var ProgressColorSchema = z2.enum(["accent", "success", "warning", "danger", "info", "neutral"]).describe("One of the theme colours");
+var ProgressBarPropsSchema = z2.object({
+  component: z2.literal("ProgressBar"),
+  label: z2.string().describe("What is being measured"),
+  value: z2.number().describe("Where the reading sits. Clamped to the range"),
+  min: z2.number().optional().describe("Bottom of the range. Defaults to 0"),
+  max: z2.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: z2.string().optional().describe("Written after the value"),
+  valueLabel: z2.string().optional().describe("The readout in words, replacing value and unit"),
+  caption: z2.string().optional().describe("One quiet line under the reading"),
+  icon: z2.string().optional().describe("Icon name"),
+  style: ExtensionComponentStyleSchema.optional()
+}).passthrough().describe("Progress component");
 var KeyValueRowSchema = z2.object({
   label: z2.string(),
   value: z2.string(),
@@ -604,6 +622,13 @@ var PanelDefinitionSchema = z3.object({
   icon: z3.string().optional().describe("Icon name (from huge-icons)"),
   view: PanelViewSchema.describe("Panel view schema")
 }).describe("Panel definition");
+var StatusCardDefinitionSchema = z3.object({
+  id: z3.string().describe("Unique card ID within the extension"),
+  title: z3.string().describe("What it is called where the user picks it"),
+  icon: z3.string().optional().describe("Icon name (from huge-icons)"),
+  size: z3.enum(["line", "block"]).describe("How much room it may take: one row, or up to three"),
+  view: PanelComponentViewSchema.describe("What it draws, and where the data comes from")
+}).describe("Status card definition");
 var ProviderConfigViewSchema = z3.object({
   content: ExtensionComponentDataSchema.describe("Root component to render")
 }).describe("Provider configuration view (component tree)");
@@ -646,6 +671,7 @@ var StorageContributionsSchema = z3.object({
 var ExtensionContributionsSchema = z3.object({
   toolSettings: z3.array(ToolSettingsViewDefinitionSchema).optional().describe("Tool settings views"),
   panels: z3.array(PanelDefinitionSchema).optional().describe("Right panel contributions"),
+  statusCards: z3.array(StatusCardDefinitionSchema).optional().describe("Cards for the strip above the conversation list"),
   providers: z3.array(ProviderDefinitionSchema).optional().describe("AI providers"),
   tools: z3.array(ToolDefinitionSchema).optional().describe("Tools for Stina to use"),
   commands: z3.array(CommandDefinitionSchema).optional().describe("Slash commands"),
@@ -801,6 +827,20 @@ var StatTileCardSchema = z5.object({
   trendIsGood: z5.boolean().optional(),
   style
 }).strict();
+var ProgressBarCardSchema = z5.object({
+  component: z5.literal("ProgressBar"),
+  label: z5.string(),
+  value: z5.number(),
+  min: z5.number().optional(),
+  max: z5.number().optional(),
+  shape: ProgressShapeSchema.optional(),
+  color: ProgressColorSchema.optional(),
+  unit: z5.string().optional(),
+  valueLabel: z5.string().optional(),
+  caption: z5.string().optional(),
+  icon: z5.string().optional(),
+  style
+}).strict();
 var KeyValueListCardSchema = z5.object({
   component: z5.literal("KeyValueList"),
   rows: z5.array(
@@ -869,6 +909,7 @@ var CHAT_CARD_COMPONENTS = [
   "WeatherForecast",
   "Chart",
   "StatTile",
+  "ProgressBar",
   "KeyValueList",
   "Timeline",
   "Note",
@@ -891,11 +932,21 @@ var CARD_MEMBERS = [
   WeatherForecastCardSchema,
   ChartCardSchema,
   StatTileCardSchema,
+  ProgressBarCardSchema,
   KeyValueListCardSchema,
   TimelineCardSchema,
   NoteCardSchema,
   CalendarEventCardSchema
 ];
+var CHAT_CARD_PROPS = Object.freeze(
+  Object.fromEntries(
+    CARD_MEMBERS.map((member) => {
+      const shape = member.shape;
+      const name = shape["component"]._def.value;
+      return [name, Object.freeze(Object.keys(shape))];
+    })
+  )
+);
 var ChatCardComponentSchema = z5.lazy(
   () => z5.discriminatedUnion(
     "component",
@@ -1007,7 +1058,8 @@ function describeType(schema) {
       return "component[]";
     case "ZodArray": {
       const inner = describeType(def.type);
-      return `${inner}[]`;
+      const max = def.maxLength?.value;
+      return typeof max === "number" ? `${inner}[\u2264${max}]` : `${inner}[]`;
     }
     case "ZodObject": {
       const shape = schema.shape;
@@ -1047,6 +1099,7 @@ export {
   AuthorSchema,
   ButtonPropsSchema,
   CHAT_CARD_COMPONENTS,
+  CHAT_CARD_PROPS,
   CalendarEventPropsSchema,
   CalendarEventStatusSchema,
   CapabilityPermissionSchema,
@@ -1103,6 +1156,9 @@ export {
   PillPropsSchema,
   PillVariantSchema,
   PlatformSchema,
+  ProgressBarPropsSchema,
+  ProgressColorSchema,
+  ProgressShapeSchema,
   PromptContributionSchema,
   PromptSectionSchema,
   ProviderConfigViewSchema,
@@ -1110,6 +1166,7 @@ export {
   SelectPropsSchema,
   StatTilePropsSchema,
   StatTrendSchema,
+  StatusCardDefinitionSchema,
   StoragePermissionSchema,
   SystemPermissionSchema,
   TextInputPropsSchema,