@skillcdn/console 0.4.2 → 0.4.3

package/src/schemas.ts

@@ -284,6 +284,13 @@ export const restMeSchema = z.object({
    * built on this package still reads an older console's answer, and says it is older.
    */
   console: z.optional(z.object({ version: z.string(), clientRange: z.string() })),
+  /**
+   * How many decisions wait for the person's answer across the projects they may see
+   * (ADR-0042), for the pages to say beside My decisions; `null` for nobody. Answered from
+   * 0.4.3 and read as optional, so that a console built on this package still reads an older
+   * console's answer.
+   */
+  decisions: z.optional(z.nullable(z.object({ waiting: count }))),
 });
 export type RestMe = z.infer<typeof restMeSchema>;
 
@@ -643,10 +650,50 @@ export const restGoalPatchSchema = z.object({
 });
 export type RestGoalPatch = z.infer<typeof restGoalPatchSchema>;
 
+/** A file a run handed in, as the console keeps it; its bytes are at `projectPath(key, "files", <artifact id>)`. */
+export const restFileSchema = z.object({
+  /** What the agent called it: one line, without a path. */
+  name: z.string(),
+  /** In bytes. */
+  size: count,
+  /** The media type the agent said, or `application/octet-stream`. */
+  contentType: z.string(),
+  /** The SHA-256 of the bytes, in hex: what the console keeps them under. */
+  sha256: z.string(),
+});
+export type RestFile = z.infer<typeof restFileSchema>;
+
+/** A file put on a decision when it was raised (ADR-0055), kept as a run's file is; its bytes are at `projectPath(key, "files", <id>)`. */
+export const restDecisionFileSchema = z.object({
+  id: uuid,
+  file: restFileSchema,
+});
+export type RestDecisionFile = z.infer<typeof restDecisionFileSchema>;
+
+/**
+ * The key a raiser may give an option, for a program to read the answer by instead of
+ * comparing labels: spelled as a plugin's key is.
+ */
+export const OPTION_KEY_PATTERN = /^[a-z][a-z0-9-]{1,31}$/;
+const optionKey = z
+  .string()
+  .check(
+    z.regex(
+      OPTION_KEY_PATTERN,
+      "must be a key: a lowercase letter, then lowercase letters, digits and hyphens, 2 to 32 long",
+    ),
+  );
+
 export const restDecisionOptionSchema = z.object({
   /** What an answer names: stable once given. */
   id: z.string(),
   label: z.string(),
+  /**
+   * The key the raiser gave the option, for a program to read the answer by (`optionKey` on the
+   * `decision.answered` event) without comparing labels; none on an option given without one,
+   * and none on the person's own answer.
+   */
+  key: z.optional(z.string()),
   /**
    * On the one option a person's own answer became, when they answered in their own words
    * instead of choosing (`POST .../answer` with `own`): added then, after the options given,
@@ -686,6 +733,13 @@ export const restDecisionSchema = z.object({
   ),
   /** What followed the decision, in Markdown, written afterwards; `null` until someone does. */
   outcome: z.nullable(z.string()),
+  /**
+   * The files put on it when it was raised (ADR-0055), in the order they came; a picture among
+   * them is shown where the context names it as `![words](its name)`, else after it. Answered
+   * from 0.4.3 and read as optional, so that a console built on this package still reads an
+   * older console's decisions.
+   */
+  files: z.optional(z.array(restDecisionFileSchema)),
   createdAt: instant,
   updatedAt: instant,
 });
@@ -742,13 +796,25 @@ export const restPersonWorkSchema = z.object({
 });
 export type RestPersonWork = z.infer<typeof restPersonWorkSchema>;
 
-/** What `POST /api/v1/projects/<key>/decisions` is sent: the question, its context, and the options. */
+/**
+ * What `POST /api/v1/projects/<key>/decisions` is sent: the question, its context, and the
+ * options. As JSON; or, with files put on the decision (ADR-0055), as the part `decision` of a
+ * form, with a part `file` for each file.
+ */
 export const restDecisionInputSchema = z.object({
   question: line(MAX_QUESTION_LENGTH),
   body: z.optional(body),
+  /** Each a label, and optionally a key a program reads the answer by, each key once. */
   options: z
-    .array(z.object({ label: line(MAX_OPTION_LABEL_LENGTH) }))
-    .check(z.minLength(MIN_OPTIONS), z.maxLength(MAX_OPTIONS)),
+    .array(z.object({ label: line(MAX_OPTION_LABEL_LENGTH), key: z.optional(optionKey) }))
+    .check(
+      z.minLength(MIN_OPTIONS),
+      z.maxLength(MAX_OPTIONS),
+      z.refine((options) => {
+        const keys = options.flatMap((option) => (option.key === undefined ? [] : [option.key]));
+        return new Set(keys).size === keys.length;
+      }, "each key once"),
+    ),
   taskId: z.optional(z.nullable(uuid)),
   /** The run that asks, when an agent does: the decision is about its task, and it waits for the answer. */
   runId: z.optional(z.nullable(uuid)),
@@ -801,8 +867,9 @@ export const restEventDataSchema = z.object({
   from: z.optional(z.enum(TASK_STATES)),
   to: z.optional(z.enum(TASK_STATES)),
   question: z.optional(z.string()),
-  /** For `decision.answered`: the label of the chosen option. */
+  /** For `decision.answered`: the label of the chosen option, and its key where the raiser gave one. */
   option: z.optional(z.string()),
+  optionKey: z.optional(z.string()),
   /** For `person.role_changed` and the events about a project's members: whose role, and what it became. */
   login: z.optional(z.string()),
   role: z.optional(z.string()),
@@ -818,7 +885,7 @@ export const restEventDataSchema = z.object({
   label: z.optional(z.string()),
   /** For `run.reported` and `task.commented`: the first words of what was written. */
   excerpt: z.optional(z.string()),
-  /** For `task.commented`: how many files came with it. */
+  /** For `task.commented`, and for `decision.raised` when any came: how many files came with it. */
   files: z.optional(z.int()),
   /** For `plugin.command`: the command, how it ended, the refusal's code where it was refused, how long it ran, and the arguments, a secret one as `[hidden]`. */
   command: z.optional(z.string()),
@@ -867,19 +934,6 @@ export const restReportSchema = z.object({
 });
 export type RestReport = z.infer<typeof restReportSchema>;
 
-/** A file a run handed in, as the console keeps it; its bytes are at `projectPath(key, "files", <artifact id>)`. */
-export const restFileSchema = z.object({
-  /** What the agent called it: one line, without a path. */
-  name: z.string(),
-  /** In bytes. */
-  size: count,
-  /** The media type the agent said, or `application/octet-stream`. */
-  contentType: z.string(),
-  /** The SHA-256 of the bytes, in hex: what the console keeps them under. */
-  sha256: z.string(),
-});
-export type RestFile = z.infer<typeof restFileSchema>;
-
 /** What a run handed in: a link to a branch, a pull request, a page; or a file the console keeps. */
 export const restArtifactSchema = z.object({
   id: uuid,

package/src/styles/console.css

@@ -2980,7 +2980,8 @@ select.sc-input {
   }
 }
 
-.sc-comment-files {
+.sc-comment-files,
+.sc-decision-files {
   display: grid;
   gap: var(--sc-space-2);
   margin: 0;
@@ -2990,6 +2991,7 @@ select.sc-input {
 }
 
 .sc-comment-picture,
+.sc-decision-picture,
 .sc-artifact-picture {
   display: grid;
   gap: var(--sc-space-1);

package/template/plugin/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "console-plugin-__key__",
+  "name": "__package__",
   "version": "0.1.0",
   "description": "__name__, a plugin of the SkillCDN Console.",
   "license": "MIT",
@@ -19,9 +19,9 @@
   },
   "devDependencies": {
     "@skillcdn/console": "__console__",
-    "@types/node": "^24.19.1",
+    "@types/node": "^24.19.2",
     "esbuild": "^0.28.2",
     "typescript": "^7.0.2",
-    "vitest": "^5.0.3"
+    "vitest": "^5.1.0"
   }
 }