@intentic/extension-api 1.363.0 → 1.364.0

package/README.md

@@ -54,6 +54,7 @@ flowchart LR
   version (`uiKitDeprecated`: each deprecated kit name and retired prop or recipe member, `<what> → <use instead>`).
   The package exports the record as `./surface.json`, which the kit's `intentic-kit-check` reads to hold an
   extension's `engines.intentic` floor to the names it imports.
+  From 2.36.0, settings choices can carry `enumItemLabels` and `enumDescriptions` for their labels and explanations.
 - A bundle links by name both this package's runtime exports (`moduleExports`) and the UI kit's, so those two grains
   are held to semver as well: a version that adds a name is at least a minor, and one that drops a name is a major, for
   a name declared deprecated first (the kit's in its `names.mjs`) and at or past the floor that declaration gives. The

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const extensionApiVersion = "2.34.0";
+export declare const extensionApiVersion = "2.36.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,mBAAmB,WAAW,CAAC"}

package/dist/version.js

@@ -1,2 +1,2 @@
-export const extensionApiVersion = "2.34.0";
+export const extensionApiVersion = "2.36.0";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentic/extension-api",
-  "version": "1.363.0",
+  "version": "1.364.0",
   "description": "The versioned public API intentic extensions compile against, manifest schema, detection facts and the host API",
   "license": "MIT",
   "type": "module",
@@ -65,9 +65,9 @@
     "./surface.json": "./src/surface.json"
   },
   "dependencies": {
-    "@intentic/base": "1.363.0",
-    "@intentic/extension-manifest": "1.363.0",
-    "@intentic/sandbox-contract": "1.363.0",
+    "@intentic/base": "1.364.0",
+    "@intentic/extension-manifest": "1.364.0",
+    "@intentic/sandbox-contract": "1.364.0",
     "@orpc/client": "1.16.1",
     "@orpc/contract": "1.16.1",
     "@orpc/openapi-client": "1.16.1"

package/src/surface.json

@@ -4713,5 +4713,667 @@
             "useLoadingReveal → Await",
             "vSkeletonSource → Await"
         ]
+    },
+    "2.35.0": {
+        "manifest": [
+            "$schema",
+            "art",
+            "category",
+            "contributes",
+            "engines",
+            "entry",
+            "icon",
+            "logo",
+            "name",
+            "permissions",
+            "publisher",
+            "server",
+            "version"
+        ],
+        "contributes": [
+            "agent",
+            "automationTemplates",
+            "bin",
+            "capabilities",
+            "commands",
+            "documents",
+            "environment",
+            "files",
+            "listener",
+            "processes",
+            "settings",
+            "sideViews",
+            "tools",
+            "viewers",
+            "views"
+        ],
+        "api": [
+            "apiVersion",
+            "audience",
+            "backend",
+            "chat",
+            "commands",
+            "documents",
+            "href",
+            "models",
+            "navigate",
+            "processes",
+            "route",
+            "sandbox",
+            "settings",
+            "sideViews",
+            "terminal",
+            "theme",
+            "viewers",
+            "views",
+            "workspace"
+        ],
+        "listener": [
+            "automation",
+            "events",
+            "provider"
+        ],
+        "sandboxApi": [
+            "fetch",
+            "json",
+            "key",
+            "origin",
+            "previewAddress",
+            "query",
+            "reachable",
+            "readKey",
+            "request",
+            "role",
+            "rpc"
+        ],
+        "workspaceApi": [
+            "capabilities",
+            "file",
+            "fillDiff",
+            "inProject",
+            "onDidChange",
+            "onDidChangeFiles",
+            "onDidChangeProject",
+            "onDidChangeRefs",
+            "onDidChangeRepos",
+            "openDiff",
+            "project",
+            "readJson",
+            "repos",
+            "setProject",
+            "write"
+        ],
+        "chatApi": [
+            "composeLoop",
+            "composeWorkflow",
+            "openAgent",
+            "openSession"
+        ],
+        "daemonApi": [
+            "json",
+            "request",
+            "rpc"
+        ],
+        "serverApi": [
+            "apiVersion",
+            "approvals",
+            "cacheDir",
+            "daemon",
+            "document",
+            "extensionDir",
+            "log",
+            "routes",
+            "settings",
+            "stateDir",
+            "tools",
+            "workspace",
+            "workspaceRoot"
+        ],
+        "toolDefinition": [
+            "call",
+            "description",
+            "effect",
+            "inputSchema",
+            "name"
+        ],
+        "sideViewsApi": [
+            "open",
+            "register"
+        ],
+        "sideViewRegistration": [
+            "claim",
+            "describe",
+            "home",
+            "id",
+            "view"
+        ],
+        "viewRegistration": [
+            "asks",
+            "auxiliary",
+            "badge",
+            "detect",
+            "fallback",
+            "id",
+            "label",
+            "surface",
+            "view",
+            "warm"
+        ],
+        "manifestSchema": "4acda6b9b1712bb3fb590360c00ef44f856881348d9a8454e7f87bc937f4ebe8",
+        "moduleExports": [
+            "allLoaded",
+            "conversions",
+            "dataOf",
+            "extensionApiVersion",
+            "flattenQuery",
+            "hostSlot",
+            "joinAwait",
+            "loadedFrom",
+            "mapLoaded",
+            "mergeQuery",
+            "readDaemonStream",
+            "resetSandboxScope",
+            "sandboxDocument",
+            "sandboxLedger",
+            "sandboxPoll",
+            "sandboxRef",
+            "sandboxScopeGuard",
+            "sandboxShallowRef",
+            "sandboxValue",
+            "satisfiesEngines",
+            "useLoaded"
+        ],
+        "serverSettingsApi": [
+            "get",
+            "onDidChange"
+        ],
+        "serverWorkspaceApi": [
+            "onDidChangeFiles",
+            "onDidChangeRefs",
+            "onDidChangeRepos"
+        ],
+        "uiKitExports": [
+            "ActionSheet",
+            "AddressField",
+            "AgentRunButton",
+            "AnchoredOverlay",
+            "Avatar",
+            "Await",
+            "BarChart",
+            "BottomSheet",
+            "BrandMark",
+            "Button",
+            "Card",
+            "ChangeStatusMark",
+            "Checkbox",
+            "Code",
+            "CodeField",
+            "ConfirmDialog",
+            "ContextMenu",
+            "CopyButton",
+            "DagEditor",
+            "DagGraph",
+            "DiffStat",
+            "DisclosureRow",
+            "FilterBar",
+            "Icon",
+            "ImageView",
+            "InfoDialog",
+            "InfoHint",
+            "InfoTable",
+            "InlineRename",
+            "Markdown",
+            "MarkdownDocument",
+            "MarkdownFigure",
+            "Modal",
+            "NavRail",
+            "NoteEditor",
+            "Notice",
+            "NoticeStack",
+            "OverflowActions",
+            "Page",
+            "PageAction",
+            "PageHeader",
+            "PersonaFace",
+            "Picker",
+            "Popover",
+            "ProgressRing",
+            "ProjectChip",
+            "ProseField",
+            "RepoPicker",
+            "RepoRail",
+            "ResizeSeam",
+            "ResponsiveOverlay",
+            "Row",
+            "RowGroup",
+            "RowNote",
+            "ScrollFrame",
+            "SearchBar",
+            "Section",
+            "SectionHeader",
+            "SegmentedControl",
+            "SkeletonRows",
+            "SkeletonSnapshot",
+            "SplitView",
+            "StatStrip",
+            "StatusBadge",
+            "StatusTally",
+            "StepSection",
+            "ToggleSwitch",
+            "WorkerCallError",
+            "activeLocale",
+            "appLink",
+            "browserOwnsClick",
+            "clipboardOf",
+            "createWorkerCall",
+            "diffMark",
+            "diffSequence",
+            "errorMessage",
+            "extensionI18n",
+            "extensionT",
+            "fixStanceLook",
+            "formatBytes",
+            "formatClock",
+            "formatCompact",
+            "formatCount",
+            "formatDate",
+            "formatDateLong",
+            "formatDateTime",
+            "formatDayMonth",
+            "formatDayMonthTime",
+            "formatDuration",
+            "formatElapsed",
+            "formatMoney",
+            "formatOf",
+            "formatPercent",
+            "formatTime",
+            "formatTimestamp",
+            "formatTokens",
+            "formatWeekdayTime",
+            "formatWhen",
+            "freshness",
+            "messageOr",
+            "noticeFrom",
+            "noticeOf",
+            "openForwardedPort",
+            "pairEdits",
+            "seriesColor",
+            "serveWorkerCall",
+            "similarity",
+            "sinceOf",
+            "timeAgo",
+            "timeWindowWords",
+            "timeWindows",
+            "toneDot",
+            "toneFill",
+            "toneHover",
+            "toneInk",
+            "tonePlate",
+            "toneRim",
+            "toneTint",
+            "toneWash",
+            "ui",
+            "useAgentRunPick",
+            "useAsyncAction",
+            "useCompact",
+            "useDevice",
+            "useKeyedDraft",
+            "useLatest",
+            "useListNavigation",
+            "useLoadingReveal",
+            "useNarrow",
+            "useNoteDraft",
+            "useNow",
+            "useRailMemory",
+            "useScrollReset",
+            "useStickyTop",
+            "useTheme",
+            "vAction",
+            "vSkeletonSource",
+            "wordDiff"
+        ],
+        "uiKitDeprecated": [
+            "NavRail.stickyHeadings → nothing: a rail's headers scroll with it",
+            "RepoRail → RepoPicker",
+            "RowGroup.caption → RowNote",
+            "RowGroup.count → the rows themselves",
+            "RowGroup.flat → Section",
+            "SkeletonSnapshot → Await",
+            "errorMessage → messageOr",
+            "ui.sectionLabel → Section, or SectionHeader for a header alone",
+            "useLoadingReveal → Await",
+            "vSkeletonSource → Await"
+        ]
+    },
+    "2.36.0": {
+        "manifest": [
+            "$schema",
+            "art",
+            "category",
+            "contributes",
+            "engines",
+            "entry",
+            "icon",
+            "logo",
+            "name",
+            "permissions",
+            "publisher",
+            "server",
+            "version"
+        ],
+        "contributes": [
+            "agent",
+            "automationTemplates",
+            "bin",
+            "capabilities",
+            "commands",
+            "documents",
+            "environment",
+            "files",
+            "listener",
+            "processes",
+            "settings",
+            "sideViews",
+            "tools",
+            "viewers",
+            "views"
+        ],
+        "api": [
+            "apiVersion",
+            "audience",
+            "backend",
+            "chat",
+            "commands",
+            "documents",
+            "href",
+            "models",
+            "navigate",
+            "processes",
+            "route",
+            "sandbox",
+            "settings",
+            "sideViews",
+            "terminal",
+            "theme",
+            "viewers",
+            "views",
+            "workspace"
+        ],
+        "listener": [
+            "automation",
+            "events",
+            "provider"
+        ],
+        "sandboxApi": [
+            "fetch",
+            "json",
+            "key",
+            "origin",
+            "previewAddress",
+            "query",
+            "reachable",
+            "readKey",
+            "request",
+            "role",
+            "rpc"
+        ],
+        "workspaceApi": [
+            "capabilities",
+            "file",
+            "fillDiff",
+            "inProject",
+            "onDidChange",
+            "onDidChangeFiles",
+            "onDidChangeProject",
+            "onDidChangeRefs",
+            "onDidChangeRepos",
+            "openDiff",
+            "project",
+            "readJson",
+            "repos",
+            "setProject",
+            "write"
+        ],
+        "chatApi": [
+            "composeLoop",
+            "composeWorkflow",
+            "openAgent",
+            "openSession"
+        ],
+        "daemonApi": [
+            "json",
+            "request",
+            "rpc"
+        ],
+        "serverApi": [
+            "apiVersion",
+            "approvals",
+            "cacheDir",
+            "daemon",
+            "document",
+            "extensionDir",
+            "log",
+            "routes",
+            "settings",
+            "stateDir",
+            "tools",
+            "workspace",
+            "workspaceRoot"
+        ],
+        "toolDefinition": [
+            "call",
+            "description",
+            "effect",
+            "inputSchema",
+            "name"
+        ],
+        "sideViewsApi": [
+            "open",
+            "register"
+        ],
+        "sideViewRegistration": [
+            "claim",
+            "describe",
+            "home",
+            "id",
+            "view"
+        ],
+        "viewRegistration": [
+            "asks",
+            "auxiliary",
+            "badge",
+            "detect",
+            "fallback",
+            "id",
+            "label",
+            "surface",
+            "view",
+            "warm"
+        ],
+        "manifestSchema": "bc50e4cbd79dc126a80460d0431b6eee7e895ac224dd7ae0cce945b3926b3d08",
+        "moduleExports": [
+            "allLoaded",
+            "conversions",
+            "dataOf",
+            "extensionApiVersion",
+            "flattenQuery",
+            "hostSlot",
+            "joinAwait",
+            "loadedFrom",
+            "mapLoaded",
+            "mergeQuery",
+            "readDaemonStream",
+            "resetSandboxScope",
+            "sandboxDocument",
+            "sandboxLedger",
+            "sandboxPoll",
+            "sandboxRef",
+            "sandboxScopeGuard",
+            "sandboxShallowRef",
+            "sandboxValue",
+            "satisfiesEngines",
+            "useLoaded"
+        ],
+        "serverSettingsApi": [
+            "get",
+            "onDidChange"
+        ],
+        "serverWorkspaceApi": [
+            "onDidChangeFiles",
+            "onDidChangeRefs",
+            "onDidChangeRepos"
+        ],
+        "uiKitExports": [
+            "ActionSheet",
+            "AddressField",
+            "AgentRunButton",
+            "AnchoredOverlay",
+            "Avatar",
+            "Await",
+            "BarChart",
+            "BottomSheet",
+            "BrandMark",
+            "Button",
+            "Card",
+            "ChangeStatusMark",
+            "Checkbox",
+            "Code",
+            "CodeField",
+            "ConfirmDialog",
+            "ContextMenu",
+            "CopyButton",
+            "DagEditor",
+            "DagGraph",
+            "DiffStat",
+            "DisclosureRow",
+            "FilterBar",
+            "Icon",
+            "ImageView",
+            "InfoDialog",
+            "InfoHint",
+            "InfoTable",
+            "InlineRename",
+            "Markdown",
+            "MarkdownDocument",
+            "MarkdownFigure",
+            "Modal",
+            "NavRail",
+            "NoteEditor",
+            "Notice",
+            "NoticeStack",
+            "OverflowActions",
+            "Page",
+            "PageAction",
+            "PageHeader",
+            "PersonaFace",
+            "Picker",
+            "Popover",
+            "ProgressRing",
+            "ProjectChip",
+            "ProseField",
+            "RepoPicker",
+            "RepoRail",
+            "ResizeSeam",
+            "ResponsiveOverlay",
+            "Row",
+            "RowGroup",
+            "RowNote",
+            "ScrollFrame",
+            "SearchBar",
+            "Section",
+            "SectionHeader",
+            "SegmentedControl",
+            "SkeletonRows",
+            "SkeletonSnapshot",
+            "SplitView",
+            "StatStrip",
+            "StatusBadge",
+            "StatusTally",
+            "StepSection",
+            "ToggleSwitch",
+            "WorkerCallError",
+            "activeLocale",
+            "appLink",
+            "browserOwnsClick",
+            "clipboardOf",
+            "createWorkerCall",
+            "diffMark",
+            "diffSequence",
+            "errorMessage",
+            "extensionI18n",
+            "extensionT",
+            "fixStanceLook",
+            "formatBytes",
+            "formatClock",
+            "formatCompact",
+            "formatCount",
+            "formatDate",
+            "formatDateLong",
+            "formatDateTime",
+            "formatDayMonth",
+            "formatDayMonthTime",
+            "formatDuration",
+            "formatElapsed",
+            "formatMoney",
+            "formatOf",
+            "formatPercent",
+            "formatTime",
+            "formatTimestamp",
+            "formatTokens",
+            "formatWeekdayTime",
+            "formatWhen",
+            "freshness",
+            "messageOr",
+            "noticeFrom",
+            "noticeOf",
+            "openForwardedPort",
+            "pairEdits",
+            "seriesColor",
+            "serveWorkerCall",
+            "similarity",
+            "sinceOf",
+            "timeAgo",
+            "timeWindowWords",
+            "timeWindows",
+            "toneDot",
+            "toneFill",
+            "toneHover",
+            "toneInk",
+            "tonePlate",
+            "toneRim",
+            "toneTint",
+            "toneWash",
+            "ui",
+            "useAgentRunPick",
+            "useAsyncAction",
+            "useCompact",
+            "useDevice",
+            "useKeyedDraft",
+            "useLatest",
+            "useListNavigation",
+            "useLoadingReveal",
+            "useNarrow",
+            "useNoteDraft",
+            "useNow",
+            "useRailMemory",
+            "useScrollReset",
+            "useStickyTop",
+            "useTheme",
+            "vAction",
+            "vSkeletonSource",
+            "wordDiff"
+        ],
+        "uiKitDeprecated": [
+            "NavRail.stickyHeadings → nothing: a rail's headers scroll with it",
+            "RepoRail → RepoPicker",
+            "RowGroup.caption → RowNote",
+            "RowGroup.count → the rows themselves",
+            "RowGroup.flat → Section",
+            "SkeletonSnapshot → Await",
+            "errorMessage → messageOr",
+            "ui.sectionLabel → Section, or SectionHeader for a header alone",
+            "useLoadingReveal → Await",
+            "vSkeletonSource → Await"
+        ]
     }
 }

package/src/version.ts

@@ -1,4 +1,10 @@
 // Protocol version matched by engines.intentic at load and reported as IntenticApi.apiVersion.
 // Bump with the published package: additive surface changes require a minor, breaking changes a major.
 // Keep published names compatible within a major; surface.json and the surface checks record API and UI-kit changes.
-export const extensionApiVersion = "2.34.0";
+// 2.35.0 lets a command declare its shortcut as a Mac spells it: `mac` beside `keybinding` in `contributes.commands`,
+// approved at install as a power of its own (a second chord the extension claims). Without one a Mac uses `keybinding`,
+// as before; with one, a Mac binds `mac` instead. Whichever is declared, a Mac's text field keeps the chords it answers
+// itself (⌃A, ⌃K, ⌥←, ⌘⌫). Additive: a manifest without `mac` is unchanged. The recorded surface grows the manifest
+// schema.
+// 2.36.0 records settings choice labels and explanations alongside the Mac shortcut schema.
+export const extensionApiVersion = "2.36.0";