@standardagents/code-plugin-sdk 1.0.0-alpha.10-rows.0 → 1.0.0-alpha.11-headers.0

package/README.md

@@ -264,3 +264,14 @@ Layouts allow 1–32 fields, 2,048 UTF-8 bytes per text field and 8,192 total te
 bytes. Controls and bidi formatting characters are rejected. Layouts are
 supported only in pane header/footer slots. Ordinary rows and full/half slot
 stacking retain their existing behavior.
+
+Set a card declaration’s `title` to `""` to omit its heading and icon. With
+`border: false`, that also removes the heading row. An omitted title uses the
+plugin name.
+
+Canvas cards can set `CanvasSpec.titleRight` to a passive, right-aligned header label.
+It accepts a nonempty single-line string of up to 512 UTF-8 bytes; controls and
+bidirectional formatting characters are rejected. The host reserves the main
+title and icon, truncates the right label to fit, and preserves the pane-open
+indicator. Other canvas surface kinds reject this option. Update it through
+`canvas.replace({ kind: "canvas", canvas: { ...spec, titleRight: "sidebar-plugins" } })`.

package/REFERENCE.md

@@ -534,3 +534,10 @@ colors fall back to the named ANSI index or default foreground; unavailable
 background colors leave opacity unapplied. OSC queries remain unsupported
 in plugin canvas streams. This capability is public and identical for all
 plugins.
+
+Canvas cards can set `CanvasSpec.titleRight` to a passive, right-aligned header label.
+It accepts a nonempty single-line string of up to 512 UTF-8 bytes; controls and
+bidirectional formatting characters are rejected. The host reserves the main
+title and icon, truncates the right label to fit, and preserves the pane-open
+indicator. Other canvas surface kinds reject this option. Update it through
+`canvas.replace({ kind: "canvas", canvas: { ...spec, titleRight: "sidebar-plugins" } })`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@standardagents/code-plugin-sdk",
-  "version": "1.0.0-alpha.10-rows.0",
+  "version": "1.0.0-alpha.11-headers.0",
   "type": "module",
   "description": "Standard Code plugin authoring SDK",
   "license": "MIT",

package/src/index.d.ts

@@ -113,6 +113,8 @@ export interface CanvasThemeColor {
   opacity: number;
 }
 export interface CanvasSpec {
+  /** Card-only passive header text, right aligned and clipped to leave room for the title. Maximum 512 UTF-8 bytes. */
+  titleRight?: string;
   /** Up to 32 canvas-local indexed color recipes. Keys are ANSI indexes 0..255. */
   themeColors?: Record<number, CanvasThemeColor>;
   columns: number;

package/src/runtime.mjs

@@ -107,7 +107,7 @@ function validateContent(content, declaration, manifest) {
   }
   jsonBytes(content)
   if (content.kind === 'canvas') {
-    const { columns, rows, shade = 0, hover, themeColors } = content.canvas ?? {}
+    const { columns, rows, shade = 0, hover, themeColors, titleRight } = content.canvas ?? {}
     ensure(Number.isSafeInteger(columns) && columns > 0 && columns <= LIMITS.canvasColumns &&
       Number.isSafeInteger(rows) && rows > 0 && rows <= LIMITS.canvasRows &&
       Number.isFinite(shade) && shade >= 0 && shade <= 1, 'invalid_payload', 'Invalid canvas dimensions or shade')
@@ -121,6 +121,10 @@ function validateContent(content, declaration, manifest) {
         'invalid_payload', 'Invalid canvas theme color recipe')
       }
     }
+    if (titleRight !== undefined) {
+      ensure(declaration.kind === 'card' && typeof titleRight === 'string', 'invalid_payload', 'Canvas titleRight requires a card and string')
+      validatePassiveText(titleRight, 512, 'card header')
+    }
     if (hover !== undefined) validatePassiveText(hover)
   }
 }