@subshell-ai/plugin-claude-code 0.0.1 → 1.0.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-//#region ../../plugin-api/dist/types-90lJTTx6.d.ts
+//#region ../../plugin-api/dist/types-CzNsDcbd.d.ts
 //#region src/types.d.ts
 /**
  * The contract a Subshell plugin implements.
@@ -81,8 +81,8 @@ interface BuildCommandInput {
    * declares the `resume` capability. `mode: "start"` means the conversation
    * is NEW and must be created under exactly this id (pin it, because the host
    * stores it and later resumes by it); `mode: "resume"` names an EXISTING
-   * conversation to continue (the host only asks after {@link HarnessResume.canResume}
-   * confirmed it survives).
+   * conversation to continue (the host only asks after {@link HarnessResume.resumePath}
+   * pointed at a file the host found there).
    */
   harnessSession?: {
     id: string;
@@ -95,18 +95,31 @@ interface BuildCommandInput {
  *
  * The ids here are HARNESS conversation ids (a claude transcript uuid, say),
  * never subshell ids: the host pins {@link allocateHarnessSessionId} at launch,
- * stores it on the subshell row, and consults {@link canResume} before every
+ * stores it on the subshell row, and consults {@link resumePath} before every
  * restart to choose between continuing and starting fresh.
+ *
+ * Both members are PURE, and that is the load-bearing property (spec
+ * 2026-09-10 §5): a resume runs on the CONTROL PLANE, for a pane that lives on
+ * a machine the plane cannot see. Computing (rather than checking) is what
+ * lets one plugin implementation serve local and remote restarts identically.
  */
 interface HarnessResume {
   /** Allocates the HARNESS conversation id to pin at launch (a uuid for claude). */
   allocateHarnessSessionId(): string;
   /**
-   * Whether the harness conversation `harnessSessionId` (last run in `cwd`)
-   * still exists and can be resumed. False means the host launches a fresh
-   * conversation rather than handing the harness an id it would reject.
+   * Where the resumable transcript would be, given the target machine's
+   * environment. PURE: it computes a path and never touches a filesystem, so
+   * the control plane can build it for a machine it cannot see. The HOST
+   * checks existence.
    */
-  canResume(harnessSessionId: string, cwd: string): boolean;
+  resumePath(harnessSessionId: string, cwd: string, hostEnv: HostEnv): string;
+}
+/** The parts of a target machine's environment a plugin may compute against. */
+interface HostEnv {
+  /** The node's home directory */
+  homeDir: string;
+  /** Values for the variables this plugin's manifest declared it needs */
+  env: Record<string, string>;
 }
 /** How to spawn the `subshell mcp` stdio server. */
 interface McpLaunchSpec {
@@ -299,6 +312,16 @@ interface SubshellManifest {
   detect?: DetectSpec;
   /** Install guidance shown when the binary is missing */
   install?: InstallSpec;
+  /**
+   * Environment variables this plugin computes against (spec 2026-09-10 §5).
+   *
+   * The node reports the VALUES of exactly these names at `ready`, so the
+   * reported set grows by declaration rather than a machine shipping its
+   * whole environment to the control plane. Declaring data is deliberate: a
+   * WRONG name is silent, yielding an absent key and the plugin's own
+   * fallback, i.e. a resume that quietly never offers itself (§11).
+   */
+  hostEnv?: string[];
 }
 //#endregion
 //#region src/manifest.d.ts

package/dist/index.js

@@ -1,7 +1,5 @@
-import { existsSync } from "node:fs";
-import { homedir } from "node:os";
 import { join, resolve } from "node:path";
-//#region ../../plugin-api/dist/manifest-im30YVIq.js
+//#region ../../plugin-api/dist/manifest-UFScnYqn.js
 /** Every {@link PluginType}, for anything that has to iterate or validate them. */
 const PLUGIN_TYPES = ["agent-harness", "terminal"];
 /**
@@ -62,6 +60,11 @@ function parseManifest(pkgJson) {
 			docsUrl: i.docsUrl
 		};
 	}
+	let hostEnv;
+	if (block.hostEnv !== void 0) {
+		if (!Array.isArray(block.hostEnv) || !block.hostEnv.every((k) => typeof k === "string" && k.trim() !== "")) return { error: "`subshell.hostEnv` must be an array of environment variable names" };
+		hostEnv = [...block.hostEnv];
+	}
 	return {
 		apiVersion: block.apiVersion,
 		id: block.id,
@@ -71,7 +74,8 @@ function parseManifest(pkgJson) {
 		...typeof block.icon === "string" ? { icon: block.icon } : {},
 		entry: block.entry,
 		...detect ? { detect } : {},
-		...install ? { install } : {}
+		...install ? { install } : {},
+		...hostEnv ? { hostEnv } : {}
 	};
 }
 //#endregion
@@ -115,7 +119,7 @@ function validateGenericProfile(profile) {
 const parsed = parseManifest({
 	name: "@subshell-ai/plugin-claude-code",
 	description: "Claude Code harness plugin for Subshell",
-	version: "0.0.1",
+	version: "1.0.0",
 	license: "Apache-2.0",
 	type: "module",
 	main: "dist/index.js",
@@ -162,6 +166,7 @@ const parsed = parseManifest({
 				".npm-global/bin/claude"
 			]
 		},
+		"hostEnv": ["CLAUDE_CONFIG_DIR"],
 		"install": {
 			"command": "curl -fsSL https://claude.ai/install.sh | bash",
 			"docsUrl": "https://code.claude.com/docs/en/setup"
@@ -387,11 +392,6 @@ const ATTENTION_HOOKS = {
 		command: sessionReportPing()
 	}] }]
 };
-/** Claude's state dir: the documented override, else `~/.claude`. */
-function claudeConfigDir() {
-	const override = process.env.CLAUDE_CONFIG_DIR?.trim();
-	return override ? resolve(override) : join(homedir(), ".claude");
-}
 /** Claude's transcript folder name for a project dir: every non-alphanumeric → `-`. */
 function projectSlug(cwd) {
 	return cwd.replace(/[^a-zA-Z0-9]/g, "-");
@@ -431,7 +431,19 @@ const createPlugin = (_host) => ({
 	*/
 	resume: {
 		allocateHarnessSessionId: () => crypto.randomUUID(),
-		canResume: (harnessSessionId, cwd) => existsSync(join(claudeConfigDir(), "projects", projectSlug(cwd), `${harnessSessionId}.jsonl`))
+		/**
+		* Claude's state dir: the documented override, else `<homeDir>/.claude`.
+		* Both halves come from the TARGET machine's `ready` report, never from
+		* this process, and no filesystem is touched (spec 2026-09-10 §5) — that
+		* is what lets the control plane build the path for a node it cannot
+		* see. The host stats the result and decides; this member cannot answer
+		* whether the transcript exists.
+		*/
+		resumePath: (harnessSessionId, cwd, hostEnv) => {
+			const override = hostEnv.env.CLAUDE_CONFIG_DIR?.trim();
+			const configDir = override ? resolve(override) : join(hostEnv.homeDir, ".claude");
+			return join(configDir, "projects", projectSlug(cwd), `${harnessSessionId}.jsonl`);
+		}
 	},
 	buildCommand(input) {
 		const { binary, profile, subshellName, extraFlags, mcp, harnessSession } = input;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@subshell-ai/plugin-claude-code",
   "description": "Claude Code harness plugin for Subshell",
-  "version": "0.0.1",
+  "version": "1.0.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -54,6 +54,7 @@
         ".npm-global/bin/claude"
       ]
     },
+    "hostEnv": ["CLAUDE_CONFIG_DIR"],
     "install": {
       "command": "curl -fsSL https://claude.ai/install.sh | bash",
       "docsUrl": "https://code.claude.com/docs/en/setup"