@subshell-ai/plugin-claude-code 1.0.1 → 2.0.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-//#region ../../plugin-api/dist/types-CSNepTNr.d.ts
+//#region ../../plugin-api/dist/types-B_wiApwK.d.ts
 //#region src/types.d.ts
 /**
  * The contract a Subshell plugin implements.
@@ -27,9 +27,9 @@ type PluginType = "agent-harness" | "terminal";
  * branches on {@link PluginType}.
  */
 type PluginCapability = "mcp" | "resume" | "attention" | "settings";
-/** A harness profile as defined by the user (decoded JSON blobs). */
-interface ProfileDefinition {
-  /** Human-friendly profile name */
+/** A harness preset as defined by the user (decoded JSON blobs). */
+interface PresetDefinition {
+  /** Human-friendly preset name */
   name: string;
   /** Optional longer description */
   description?: string | null;
@@ -39,21 +39,21 @@ interface ProfileDefinition {
   flags: string[];
   /** Settings blob passed to the harness (e.g. claude --settings JSON) */
   settings: Record<string, unknown> | null;
-  /** If true, only this profile's config sources apply (isolation) */
+  /** If true, only this preset's config sources apply (isolation) */
   configIsolation: boolean;
-  /** If true, new subshells from this profile auto-restart on exit */
+  /** If true, new subshells from this preset auto-restart on exit */
   restartOnExit?: boolean;
 }
-/** Snapshot of a single field-level validation error on a profile. */
-interface ProfileValidationIssue {
+/** Snapshot of a single field-level validation error on a preset. */
+interface PresetValidationIssue {
   /** Field name (e.g. "name", "env", "settings") */
   field: string;
   /** Human-readable problem description */
   message: string;
 }
-interface ProfileValidationResult {
+interface PresetValidationResult {
   valid: boolean;
-  issues: ProfileValidationIssue[];
+  issues: PresetValidationIssue[];
 }
 /** Everything a plugin needs to build a launch command. */
 interface BuildCommandInput {
@@ -61,8 +61,8 @@ interface BuildCommandInput {
   binary: string;
   /** Working directory the harness runs in */
   cwd: string;
-  /** The validated profile being used */
-  profile: ProfileDefinition;
+  /** The validated preset being used */
+  preset: PresetDefinition;
   /** Subshell display name ("" = let the harness pick a default) */
   subshellName: string;
   /** Any additional CLI flags from route/request context */
@@ -169,12 +169,12 @@ interface McpRegistration {
   args?: string[];
   /**
    * Extra pane env the harness needs to discover the file (e.g. OPENCODE_CONFIG).
-   * Consumed by the HOST, which bakes it into the pane env ahead of profile env;
+   * Consumed by the HOST, which bakes it into the pane env ahead of preset env;
    * plugins never read it back.
    */
   env?: Record<string, string>;
 }
-/** One copy-paste line shown in the profile editor for manual-setup harnesses. */
+/** One copy-paste line shown in the preset editor for manual-setup harnesses. */
 interface McpSetupStep {
   /** What the user should do, and where the text goes */
   label: string;
@@ -259,8 +259,8 @@ interface PluginHost {
 interface SubshellPlugin {
   /** Builds the argv (no shell) used to launch a subshell. */
   buildCommand(input: BuildCommandInput): string[];
-  /** Validates a profile definition before saving. */
-  validateProfile(profile: ProfileDefinition): ProfileValidationResult;
+  /** Validates a preset definition before saving. */
+  validatePreset(preset: PresetDefinition): PresetValidationResult;
   /** Which optional members below are meaningful on this plugin. */
   capabilities(): PluginCapability[];
   /** Maps a harness exit code to a human label (null = unknown). */
@@ -292,14 +292,14 @@ interface SubshellPlugin {
   mcpRegistration?(launch: McpLaunchSpec, configPath: string): McpRegistration;
   /** How users obtain the subshell MCP tools here. Declare the `mcp` capability with it. */
   mcpSetup?(launch: McpLaunchSpec): McpSetupInfo;
-  /** Settings rendered in the PROFILE editor and stored on the profile. */
-  profileSettings?(): SettingsField[];
-  /** Known extra env var suggestions for the profile editor. */
+  /** Settings rendered in the PRESET editor and stored on the preset. */
+  presetSettings?(): SettingsField[];
+  /** Known extra env var suggestions for the preset editor. */
   suggestedEnv?(): {
     key: string;
     description: string;
   }[];
-  /** Known CLI flag suggestions for the profile editor. */
+  /** Known CLI flag suggestions for the preset editor. */
   suggestedFlags?(): {
     flag: string;
     description: string;
@@ -337,7 +337,11 @@ interface SubshellManifest {
   name: string;
   /** One-line description shown in the UI */
   description: string;
-  /** Optional emoji/glyph */
+  /**
+   * Relative path to this plugin's icon file, e.g. `icon.svg`. Served by
+   * the control plane at `/api/plugins/<id>/icon`; absent means the UI
+   * renders a monogram instead.
+   */
   icon?: string;
   /** Module to import, relative to the package directory */
   entry: string;
@@ -365,9 +369,9 @@ declare const manifest: SubshellManifest;
  * Built-in harness: Claude Code.
  *
  * Launch shape:
- *   claude --settings <json> --name <subshell> [profile flags] [extra flags]
+ *   claude --settings <json> --name <subshell> [preset flags] [extra flags]
  * Settings are passed as a JSON string via `--settings` (per-invocation, so
- * profile config never needs to write into the user's real ~/.claude).
+ * preset config never needs to write into the user's real ~/.claude).
  *
  * Identity, detection and install guidance live in this package's
  * package.json `subshell` block, NOT here: the host reads them without

package/dist/index.js

@@ -1,5 +1,5 @@
 import { join, resolve } from "node:path";
-//#region ../../plugin-api/dist/manifest-UFScnYqn.js
+//#region ../../plugin-api/dist/manifest-Czd9ea1g.js
 /** Every {@link PluginType}, for anything that has to iterate or validate them. */
 const PLUGIN_TYPES = ["agent-harness", "terminal"];
 /**
@@ -10,6 +10,17 @@ const PLUGIN_TYPES = ["agent-harness", "terminal"];
 */
 const MCP_SERVER_NAME = "subshell";
 /**
+* Image formats a plugin icon may be. The server maps these to a Content-Type
+* from a fixed table rather than sniffing the file, so this list and that
+* table are one decision: adding a format here without adding it there leaves
+* an icon that parses and then 500s when something asks for it.
+*/
+const ICON_EXTENSIONS = [
+	".svg",
+	".png",
+	".webp"
+];
+/**
 * Ids become directory names under `<dataDir>/plugins/`, so they are path
 * segments and nothing else: no separators, no traversal, no surprises from a
 * case-insensitive filesystem.
@@ -32,13 +43,18 @@ function parseManifest(pkgJson) {
 	const block = pkgJson.subshell;
 	if (!isRecord(block)) return { error: "package.json has no `subshell` block, so it is not a Subshell plugin" };
 	if (typeof block.apiVersion !== "number" || !Number.isInteger(block.apiVersion)) return { error: "`subshell.apiVersion` must be an integer" };
-	if (block.apiVersion < 1) return { error: `this plugin declares plugin-api ${block.apiVersion}, which is not a version; the lowest is 1 and this host implements 1` };
-	if (block.apiVersion > 1) return { error: `this plugin needs plugin-api ${block.apiVersion}, but this host implements 1; upgrade the agent` };
+	if (block.apiVersion < 1) return { error: `this plugin declares plugin-api ${block.apiVersion}, which is not a version; the lowest is 1 and this host implements 2` };
+	if (block.apiVersion > 2) return { error: `this plugin needs plugin-api ${block.apiVersion}, but this host implements 2; upgrade the agent` };
 	if (typeof block.id !== "string" || !ID_RE.test(block.id)) return { error: "`subshell.id` must be lowercase letters, digits and hyphens, starting alphanumeric (it becomes a directory name)" };
 	if (typeof block.type !== "string" || !PLUGIN_TYPES.includes(block.type)) return { error: `\`subshell.type\` must be one of: ${PLUGIN_TYPES.join(", ")}` };
 	if (typeof block.name !== "string" || block.name.trim() === "") return { error: "`subshell.name` must be a non-empty string" };
 	if (typeof block.description !== "string") return { error: "`subshell.description` must be a string" };
-	if (block.icon !== void 0 && typeof block.icon !== "string") return { error: "`subshell.icon` must be a string" };
+	if (block.icon !== void 0) {
+		if (typeof block.icon !== "string" || block.icon.trim() === "") return { error: "`subshell.icon` must be a non-empty relative path to an image in the package" };
+		if (block.icon.startsWith("/") || block.icon.split("/").includes("..")) return { error: "`subshell.icon` must stay inside the package (no leading `/` and no `..` segment)" };
+		const icon = block.icon;
+		if (!ICON_EXTENSIONS.some((ext) => icon.endsWith(ext))) return { error: `\`subshell.icon\` must end in one of: ${ICON_EXTENSIONS.join(", ")}` };
+	}
 	if (typeof block.entry !== "string" || block.entry.trim() === "") return { error: "`subshell.entry` must be a non-empty relative path" };
 	if (block.entry.startsWith("/") || block.entry.split("/").includes("..")) return { error: "`subshell.entry` must stay inside the package (no leading `/` and no `..` segment)" };
 	let detect;
@@ -81,23 +97,23 @@ function parseManifest(pkgJson) {
 //#endregion
 //#region ../../plugin-api/dist/index.js
 /**
-* The profile checks every built-in harness performs unchanged: a non-empty
+* The preset checks every built-in harness performs unchanged: a non-empty
 * name, string env values, and flags that look like flags. Harnesses with
 * extra rules run their own checks on top of these.
-* @param profile - The decoded profile definition to check
+* @param preset - The decoded preset definition to check
 * @returns Issues per field; `valid` is true when no issues were found
 */
-function validateGenericProfile(profile) {
+function validateGenericPreset(preset) {
 	const issues = [];
-	if (!profile.name || profile.name.trim().length === 0) issues.push({
+	if (!preset.name || preset.name.trim().length === 0) issues.push({
 		field: "name",
-		message: "Profile name is required."
+		message: "Preset name is required."
 	});
-	for (const [key, value] of Object.entries(profile.env)) if (typeof value !== "string") issues.push({
+	for (const [key, value] of Object.entries(preset.env)) if (typeof value !== "string") issues.push({
 		field: "env",
 		message: `Env var "${key}" must be a string.`
 	});
-	for (const flag of profile.flags) if (!flag.startsWith("-")) issues.push({
+	for (const flag of preset.flags) if (!flag.startsWith("-")) issues.push({
 		field: "flags",
 		message: `Flag "${flag}" must start with "-".`
 	});
@@ -119,7 +135,7 @@ function validateGenericProfile(profile) {
 const parsed = parseManifest({
 	name: "@subshell-ai/plugin-claude-code",
 	description: "Claude Code harness plugin for Subshell",
-	version: "1.0.1",
+	version: "2.0.0",
 	license: "Apache-2.0",
 	type: "module",
 	main: "dist/index.js",
@@ -153,15 +169,15 @@ const parsed = parseManifest({
 		"tsdown": "0.22.14",
 		"typescript": "7.0.2"
 	},
-	files: ["dist"],
+	files: ["dist", "icon.svg"],
 	publishConfig: { "access": "public" },
 	subshell: {
-		"apiVersion": 1,
+		"apiVersion": 2,
 		"id": "claude-code",
 		"type": "agent-harness",
 		"name": "Claude Code",
 		"description": "Anthropic's agentic coding assistant (interactive CLI)",
-		"icon": "🤖",
+		"icon": "icon.svg",
 		"entry": "dist/index.js",
 		"detect": {
 			"binaryName": "claude",
@@ -410,9 +426,9 @@ function projectSlug(cwd) {
 * Built-in harness: Claude Code.
 *
 * Launch shape:
-*   claude --settings <json> --name <subshell> [profile flags] [extra flags]
+*   claude --settings <json> --name <subshell> [preset flags] [extra flags]
 * Settings are passed as a JSON string via `--settings` (per-invocation, so
-* profile config never needs to write into the user's real ~/.claude).
+* preset config never needs to write into the user's real ~/.claude).
 *
 * Identity, detection and install guidance live in this package's
 * package.json `subshell` block, NOT here: the host reads them without
@@ -456,16 +472,16 @@ const createPlugin = (host) => ({
 		}
 	},
 	buildCommand(input) {
-		const { binary, profile, subshellName, extraFlags, mcp, harnessSession, reporter } = input;
+		const { binary, preset, subshellName, extraFlags, mcp, harnessSession, reporter } = input;
 		const args = [binary];
 		if (mcp?.args) args.push(...mcp.args);
 		if (harnessSession) args.push(harnessSession.mode === "resume" ? "--resume" : "--session-id", harnessSession.id);
-		const settings = { ...profile.settings ?? {} };
+		const settings = { ...preset.settings ?? {} };
 		if (reporter) settings.hooks = attentionHooks(host, reporter);
 		else host.log.warn("no reporter resolved for this launch: attention and conversation-identity hooks are omitted");
 		if (Object.keys(settings).length > 0) args.push("--settings", JSON.stringify(settings));
 		if (subshellName) args.push("--name", subshellName);
-		for (const flag of profile.flags) args.push(flag);
+		for (const flag of preset.flags) args.push(flag);
 		if (extraFlags) args.push(...extraFlags);
 		return args;
 	},
@@ -486,10 +502,10 @@ const createPlugin = (host) => ({
 			summary: "Subshell registers itself with every Claude Code subshell automatically (via --mcp-config)."
 		};
 	},
-	validateProfile(profile) {
-		return validateGenericProfile(profile);
+	validatePreset(preset) {
+		return validateGenericPreset(preset);
 	},
-	profileSettings() {
+	presetSettings() {
 		return CLAUDE_SETTINGS_FIELDS;
 	},
 	suggestedEnv() {

package/icon.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 248 248" fill="none" xmlns="http://www.w3.org/2000/svg"><title>Claude Code</title>
+<path d="M52.4285 162.873L98.7844 136.879L99.5485 134.602L98.7844 133.334H96.4921L88.7237 132.862L62.2346 132.153L39.3113 131.207L17.0249 130.026L11.4214 128.844L6.2 121.873L6.7094 118.447L11.4214 115.257L18.171 115.847L33.0711 116.911L55.485 118.447L71.6586 119.392L95.728 121.873H99.5485L100.058 120.337L98.7844 119.392L97.7656 118.447L74.5877 102.732L49.4995 86.1905L36.3823 76.62L29.3779 71.7757L25.8121 67.2858L24.2839 57.3608L30.6515 50.2716L39.3113 50.8623L41.4763 51.4531L50.2636 58.1879L68.9842 72.7209L93.4357 90.6804L97.0015 93.6343L98.4374 92.6652L98.6571 91.9801L97.0015 89.2625L83.757 65.2772L69.621 40.8192L63.2534 30.6579L61.5978 24.632C60.9565 22.1032 60.579 20.0111 60.579 17.4246L67.8381 7.49965L71.9133 6.19995L81.7193 7.49965L85.7946 11.0443L91.9074 24.9865L101.714 46.8451L116.996 76.62L121.453 85.4816L123.873 93.6343L124.764 96.1155H126.292V94.6976L127.566 77.9197L129.858 57.3608L132.15 30.8942L132.915 23.4505L136.608 14.4708L143.994 9.62643L149.725 12.344L154.437 19.0788L153.8 23.4505L150.998 41.6463L145.522 70.1215L141.957 89.2625H143.994L146.414 86.7813L156.093 74.0206L172.266 53.698L179.398 45.6635L187.803 36.802L193.152 32.5484H203.34L210.726 43.6549L207.415 55.1159L196.972 68.3492L188.312 79.5739L175.896 96.2095L168.191 109.585L168.882 110.689L170.738 110.53L198.755 104.504L213.91 101.787L231.994 98.7149L240.144 102.496L241.036 106.395L237.852 114.311L218.495 119.037L195.826 123.645L162.07 131.592L161.696 131.893L162.137 132.547L177.36 133.925L183.855 134.279H199.774L229.447 136.524L237.215 141.605L241.8 147.867L241.036 152.711L229.065 158.737L213.019 154.956L175.45 145.977L162.587 142.787H160.805V143.85L171.502 154.366L191.242 172.089L215.82 195.011L217.094 200.682L213.91 205.172L210.599 204.699L188.949 188.394L180.544 181.069L161.696 165.118H160.422V166.772L164.752 173.152L187.803 207.771L188.949 218.405L187.294 221.832L181.308 223.959L174.813 222.777L161.187 203.754L147.305 182.486L136.098 163.345L134.745 164.2L128.075 235.42L125.019 239.082L117.887 241.8L111.902 237.31L108.718 229.984L111.902 215.452L115.722 196.547L118.779 181.541L121.58 162.873L123.291 156.636L123.14 156.219L121.773 156.449L107.699 175.752L86.304 204.699L69.3663 222.777L65.291 224.431L58.2867 220.768L58.9235 214.27L62.8713 208.48L86.304 178.705L100.44 160.155L109.551 149.507L109.462 147.967L108.959 147.924L46.6977 188.512L35.6182 189.93L30.7788 185.44L31.4156 178.115L33.7079 175.752L52.4285 162.873Z" fill="#D97757"/>
+</svg>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@subshell-ai/plugin-claude-code",
   "description": "Claude Code harness plugin for Subshell",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -39,19 +39,17 @@
     "tsdown": "0.22.14",
     "typescript": "7.0.2"
   },
-  "files": [
-    "dist"
-  ],
+  "files": ["dist", "icon.svg"],
   "publishConfig": {
     "access": "public"
   },
   "subshell": {
-    "apiVersion": 1,
+    "apiVersion": 2,
     "id": "claude-code",
     "type": "agent-harness",
     "name": "Claude Code",
     "description": "Anthropic's agentic coding assistant (interactive CLI)",
-    "icon": "🤖",
+    "icon": "icon.svg",
     "entry": "dist/index.js",
     "detect": {
       "binaryName": "claude",