fix: match the host's real capability set and correct the preset import

dist/manifest.d.ts

@@ -41,8 +41,21 @@ export type ExtensionContributions = {
     settings?: ExtensionSettingContribution[];
     keybindings?: ExtensionKeybindingContribution[];
 };
-/** A power requested beyond the always-granted Tier-0 API. Granted at install. */
-export type ExtensionCapability = 'workspace.observe' | 'sessions.observe' | 'panes.observe' | 'fs.read' | 'transcript.read' | 'git.read' | 'sessions.prompt' | 'fs.write' | 'git.commit' | 'network.fetch';
+/**
+ * A power requested beyond the always-granted Tier-0 API. Granted at install.
+ *
+ * ── THIS LIST MUST MATCH WHAT THE HOST IMPLEMENTS, NOT WHAT IT PLANS TO ──
+ * It previously also declared fs.read, transcript.read, git.read, sessions.prompt,
+ * fs.write, git.commit and network.fetch. None of them were implemented anywhere:
+ * no request method could carry them, no broker arm performed them, and the host
+ * now REFUSES to install a manifest that asks for one.
+ *
+ * Keeping them here was worse than useless. This package exists so an author gets
+ * a type error instead of a runtime surprise — and it delivered the exact opposite:
+ * `permissions: ['fs.write']` type-checked cleanly and then failed the install.
+ * A capability belongs in this union only once the host can actually perform it.
+ */
+export type ExtensionCapability = 'workspace.observe' | 'sessions.observe' | 'panes.observe';
 export type ExtensionActivationEvent = 'onStartupFinished' | '*' | `onCommand:${string}` | `onView:${string}`;
 export type ExtensionManifest = {
     id: string;

dist/vite-preset.js

@@ -15,8 +15,12 @@
 // dev guards throw at activate() unless it is defined at build time.
 //
 // Usage — vite.config.ts:
-//   import { extensionViteConfig } from 'agent-code-extension-api/vite'
+//   import { extensionViteConfig } from 'agent-code-extension-api'
 //   export default extensionViteConfig()
+//
+// NOTE the specifier: the package exposes exactly ONE export path ("." in
+// package.json), so the `/vite` subpath this comment used to name resolves to
+// nothing — an author copying it got a module-not-found before their first build.
 /** A plain object matching Vite's `UserConfig` shape — returned untyped so this
  *  package need not depend on vite. Spread/return it from vite.config.ts. */
 export function extensionViteConfig(options = {}) {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-code-extension-api",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Types and authoring helpers for building Agent Code extensions.",
   "type": "module",
   "main": "dist/index.js",

src/manifest.ts

@@ -37,18 +37,21 @@ export type ExtensionContributions = {
   keybindings?: ExtensionKeybindingContribution[]
 }
 
-/** A power requested beyond the always-granted Tier-0 API. Granted at install. */
-export type ExtensionCapability =
-  | 'workspace.observe'
-  | 'sessions.observe'
-  | 'panes.observe'
-  | 'fs.read'
-  | 'transcript.read'
-  | 'git.read'
-  | 'sessions.prompt'
-  | 'fs.write'
-  | 'git.commit'
-  | 'network.fetch'
+/**
+ * A power requested beyond the always-granted Tier-0 API. Granted at install.
+ *
+ * ── THIS LIST MUST MATCH WHAT THE HOST IMPLEMENTS, NOT WHAT IT PLANS TO ──
+ * It previously also declared fs.read, transcript.read, git.read, sessions.prompt,
+ * fs.write, git.commit and network.fetch. None of them were implemented anywhere:
+ * no request method could carry them, no broker arm performed them, and the host
+ * now REFUSES to install a manifest that asks for one.
+ *
+ * Keeping them here was worse than useless. This package exists so an author gets
+ * a type error instead of a runtime surprise — and it delivered the exact opposite:
+ * `permissions: ['fs.write']` type-checked cleanly and then failed the install.
+ * A capability belongs in this union only once the host can actually perform it.
+ */
+export type ExtensionCapability = 'workspace.observe' | 'sessions.observe' | 'panes.observe'
 
 export type ExtensionActivationEvent =
   | 'onStartupFinished'

src/vite-preset.ts

@@ -15,8 +15,12 @@
 // dev guards throw at activate() unless it is defined at build time.
 //
 // Usage — vite.config.ts:
-//   import { extensionViteConfig } from 'agent-code-extension-api/vite'
+//   import { extensionViteConfig } from 'agent-code-extension-api'
 //   export default extensionViteConfig()
+//
+// NOTE the specifier: the package exposes exactly ONE export path ("." in
+// package.json), so the `/vite` subpath this comment used to name resolves to
+// nothing — an author copying it got a module-not-found before their first build.
 
 export type ExtensionViteOptions = {
   /** Entry module path. Default: 'src/index.ts'. Must match manifest `entry` once built. */