@subshell-ai/plugin-codex 0.0.1 → 0.1.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,4 +1,4 @@
-//#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"];
 /**
@@ -59,6 +59,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,
@@ -68,7 +73,8 @@ function parseManifest(pkgJson) {
 		...typeof block.icon === "string" ? { icon: block.icon } : {},
 		entry: block.entry,
 		...detect ? { detect } : {},
-		...install ? { install } : {}
+		...install ? { install } : {},
+		...hostEnv ? { hostEnv } : {}
 	};
 }
 //#endregion
@@ -112,7 +118,7 @@ function validateGenericProfile(profile) {
 const parsed = parseManifest({
 	name: "@subshell-ai/plugin-codex",
 	description: "Codex harness plugin for Subshell",
-	version: "0.0.1",
+	version: "0.1.0",
 	license: "Apache-2.0",
 	type: "module",
 	main: "dist/index.js",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@subshell-ai/plugin-codex",
   "description": "Codex harness plugin for Subshell",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",