@caplets/opencode 0.6.0 → 0.6.1

package/README.md

@@ -8,6 +8,8 @@ MCP-backed Caplets advertise resource, prompt, template, and completion operatio
 
 Use `caplets__code_mode` for multi-step workflows that benefit from Code Mode: TypeScript with generated `caplets.<id>` handles, progressive discovery, downstream tool calls, filtering, joins, and compact synthesis in one native OpenCode call.
 
+For adjacent workflows, omit top-level `sessionId` to start a fresh reusable Code Mode session, then pass the returned `meta.sessionId` as top-level `sessionId` on later calls that should reuse live helper functions, `var` bindings, and runtime state while the session remains available. Unknown or expired sessions fail before execution; use recovery metadata for audit or manual reconstruction rather than automatic replay.
+
 ```jsonc
 {
   "plugin": ["@caplets/opencode"],
@@ -48,11 +50,9 @@ export default {
       "@caplets/opencode",
       {
         mode: "remote",
-        server: {
+        remote: {
           url: "https://caplets.example.com/caplets",
           user: "caplets",
-        },
-        remote: {
           pollIntervalMs: 5_000,
         },
       },
@@ -61,4 +61,4 @@ export default {
 };
 ```
 
-Plugin config overrides environment variables. The explicit config shape is `{ mode, server: { url, user }, remote: { pollIntervalMs } }`. Prefer `CAPLETS_REMOTE_TOKEN` or `CAPLETS_REMOTE_PASSWORD` for self-hosted credentials unless your OpenCode setup provides secure secret storage.
+Plugin config overrides environment variables. The explicit config shape is `{ mode, remote: { url, user, pollIntervalMs } }`. Prefer `CAPLETS_REMOTE_TOKEN` or `CAPLETS_REMOTE_PASSWORD` for self-hosted credentials unless your OpenCode setup provides secure secret storage.

package/dist/index.js

@@ -29,7 +29,8 @@ function capletsOpenCodeArgs(operationNames = [...operations]) {
 function capletsOpenCodeRunArgs() {
 	return {
 		code: tool.schema.string(),
-		timeoutMs: tool.schema.number().int().positive().optional()
+		timeoutMs: tool.schema.number().int().positive().optional(),
+		sessionId: tool.schema.string().optional()
 	};
 }
 function capletsOpenCodeJsonSchemaArgs(schema) {
@@ -55,10 +56,10 @@ async function createCapletsOpenCodeHooks(service) {
 	const registeredToolNames = new Set(capletTools.map((caplet) => caplet.toolName));
 	return {
 		tool: Object.fromEntries(capletTools.map((caplet) => [caplet.toolName, tool({
-			description: caplet.description,
+			description: caplet.codeModeRun ? openCodeCodeModeDescription(caplet.description) : caplet.description,
 			args: caplet.codeModeRun ? capletsOpenCodeRunArgs() : caplet.operationNames ? capletsOpenCodeArgs(caplet.operationNames) : capletsOpenCodeJsonSchemaArgs(caplet.inputSchema),
 			async execute(args) {
-				return compactOpenCodeResult(await service.execute(caplet.caplet, args));
+				return compactOpenCodeResult(await service.execute(caplet.caplet, caplet.codeModeRun ? normalizeCodeModeRunArgs(args) : args));
 			}
 		})])),
 		"experimental.chat.system.transform": async (_input, output) => {
@@ -66,6 +67,23 @@ async function createCapletsOpenCodeHooks(service) {
 		}
 	};
 }
+function openCodeCodeModeDescription(description) {
+	return [
+		description,
+		"",
+		"OpenCode argument shape: omit top-level `sessionId` to start a fresh reusable session. To reuse a live session, pass top-level `sessionId: meta.sessionId`."
+	].join("\n");
+}
+function normalizeCodeModeRunArgs(args) {
+	if (!args || typeof args !== "object" || Array.isArray(args)) return args;
+	const record = args;
+	const { sessionId: _sessionId, ...rest } = record;
+	if (typeof record.sessionId === "string" && record.sessionId.trim() !== "") return {
+		...rest,
+		sessionId: record.sessionId
+	};
+	return rest;
+}
 function compactOpenCodeResult(result) {
 	if (typeof result === "string") return result;
 	if (!result || typeof result !== "object" || Array.isArray(result)) return String(result ?? "null");
@@ -92,7 +110,6 @@ function normalizeOpenCodeConfig(config) {
 	if (!config) return {};
 	return {
 		...config.mode ? { mode: config.mode } : {},
-		...config.server ? { server: config.server } : {},
 		...config.remote ? { remote: config.remote } : {}
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caplets/opencode",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Native OpenCode plugin for Caplets.",
   "homepage": "https://github.com/spiritledsoftware/caplets#readme",
   "bugs": {
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@caplets/core": "0.23.0"
+    "@caplets/core": "0.24.0"
   },
   "devDependencies": {
     "@jitl/quickjs-wasmfile-release-sync": "^0.32.0",