@agentuity/opencode 0.1.41 → 0.1.43

package/dist/tmux/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tmux/types.ts"],"names":[],"mappings":"AAkGA,0BAA0B;AAC1B,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,oBAAoB;AACpB,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tmux/types.ts"],"names":[],"mappings":"AA8GA,0BAA0B;AAC1B,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,oBAAoB;AACpB,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC"}

package/dist/tmux/utils.d.ts

@@ -29,4 +29,21 @@ export declare function runTmuxCommandSync(args: string[]): {
  * Get the path to the tmux binary synchronously
  */
 export declare function getTmuxPathSync(): string | null;
+/**
+ * Get the tmux session ID for a given pane.
+ * This is used to ensure windows are created in the correct tmux session
+ * when multiple opencode instances run in different sessions.
+ */
+export declare function getTmuxSessionId(paneId: string): Promise<string | undefined>;
+/**
+ * Get the tmux session ID synchronously (for shutdown scenarios)
+ */
+export declare function getTmuxSessionIdSync(paneId: string): string | undefined;
+/**
+ * Canonicalize server URL for consistent ownership tagging.
+ * Normalizes loopback addresses (127.0.0.1, ::1) to localhost.
+ *
+ * @throws Error if URL is invalid
+ */
+export declare function canonicalizeServerUrl(url: string): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/tmux/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tmux/utils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAErD;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS1D;AAED;;GAEG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAa/C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgBvF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAS/C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tmux/utils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAErD;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS1D;AAED;;GAEG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAa/C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgBvF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAS/C;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAIlF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIvE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWzD"}

package/dist/tmux/utils.js

@@ -77,4 +77,43 @@ export function getTmuxPathSync() {
         return null;
     }
 }
+/**
+ * Get the tmux session ID for a given pane.
+ * This is used to ensure windows are created in the correct tmux session
+ * when multiple opencode instances run in different sessions.
+ */
+export async function getTmuxSessionId(paneId) {
+    const result = await runTmuxCommand(['display', '-p', '-t', paneId, '#{session_id}']);
+    if (!result.success || !result.output)
+        return undefined;
+    return result.output.trim() || undefined;
+}
+/**
+ * Get the tmux session ID synchronously (for shutdown scenarios)
+ */
+export function getTmuxSessionIdSync(paneId) {
+    const result = runTmuxCommandSync(['display', '-p', '-t', paneId, '#{session_id}']);
+    if (!result.success || !result.output)
+        return undefined;
+    return result.output.trim() || undefined;
+}
+/**
+ * Canonicalize server URL for consistent ownership tagging.
+ * Normalizes loopback addresses (127.0.0.1, ::1) to localhost.
+ *
+ * @throws Error if URL is invalid
+ */
+export function canonicalizeServerUrl(url) {
+    try {
+        const parsed = new URL(url);
+        let host = parsed.hostname.toLowerCase();
+        if (host === '127.0.0.1' || host === '::1') {
+            host = 'localhost';
+        }
+        return `${parsed.protocol}//${host}:${parsed.port}`;
+    }
+    catch (error) {
+        throw new Error(`Invalid server URL: ${url}`, { cause: error });
+    }
+}
 //# sourceMappingURL=utils.js.map

package/dist/tmux/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tmux/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tmux/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAEvC;;GAEG;AACH,MAAM,UAAU,YAAY;IAC3B,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAChC,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,MAAM,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,IAAc;IAEd,MAAM,IAAI,GAAG,MAAM,WAAW,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAE/D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAEtD,OAAO;QACN,OAAO,EAAE,QAAQ,KAAK,CAAC;QACvB,MAAM,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;KACtD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAChD,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAE/D,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAE/C,OAAO;YACN,OAAO,EAAE,MAAM,CAAC,QAAQ,KAAK,CAAC;YAC9B,MAAM,EAAE,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;SAC7D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAC1D,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC9B,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC/C,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc;IACpD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IACtF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACxD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IAClD,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACxD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAChD,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YAC5C,IAAI,GAAG,WAAW,CAAC;QACpB,CAAC;QACD,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACjE,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/opencode",
-	"version": "0.1.41",
+	"version": "0.1.43",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"description": "Agentuity Open Code plugin with specialized AI coding agents",
@@ -40,13 +40,13 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.1.41",
+		"@agentuity/core": "0.1.43",
 		"@opencode-ai/plugin": "^1.1.36",
 		"yaml": "^2.8.1",
 		"zod": "^4.3.5"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "0.1.41",
+		"@agentuity/test-utils": "0.1.43",
 		"@types/bun": "latest",
 		"bun-types": "latest",
 		"typescript": "^5.9.0"

package/src/agents/lead.ts

@@ -882,10 +882,9 @@ agentuity cloud queue publish agentuity-cadence-work '{
 }'
 \`\`\`
 
-Check on child teams:
+Check on child teams by querying KV state directly:
 \`\`\`bash
-agentuity ai cadence list
-agentuity ai cadence status lp_child
+agentuity cloud kv get agentuity-opencode-tasks "loop:lp_child:state" --json
 \`\`\`
 
 ### Context Management

package/src/background/manager.ts

@@ -31,6 +31,7 @@ export interface BackgroundManagerCallbacks {
 		title: string;
 	}) => void;
 	onSubagentSessionDeleted?: (event: { sessionId: string }) => void;
+	onShutdown?: () => void | Promise<void>;
 }
 
 export class BackgroundManager {
@@ -182,6 +183,11 @@ export class BackgroundManager {
 		this.shuttingDown = true;
 		this.concurrency.clear();
 		this.notifications.clear();
+		try {
+			void this.callbacks?.onShutdown?.();
+		} catch {
+			// Ignore shutdown callback errors
+		}
 	}
 
 	private indexTask(task: BackgroundTask): void {

package/src/plugin/hooks/cadence.ts

@@ -107,6 +107,7 @@ export function createCadenceHooks(ctx: PluginInput, _config: CoderConfig): Cade
 			);
 			if (statusMatch) {
 				const [, loopId, iteration, maxIterations] = statusMatch;
+				if (!iteration || !maxIterations) return;
 				const newIteration = parseInt(iteration, 10);
 				const newMax = parseInt(maxIterations, 10);
 				const changed =
@@ -127,7 +128,7 @@ export function createCadenceHooks(ctx: PluginInput, _config: CoderConfig): Cade
 
 			// Fallback: try to extract iteration from loose "iteration: N" pattern
 			const iterMatch = messageText.match(/iteration[:\s]+(\d+)/i);
-			if (iterMatch) {
+			if (iterMatch && iterMatch[1]) {
 				const newIteration = parseInt(iterMatch[1], 10);
 				if (newIteration !== state.iteration) {
 					state.iteration = newIteration;

package/src/plugin/plugin.ts

@@ -95,6 +95,11 @@ export async function createCoderPlugin(ctx: PluginInput): Promise<Hooks> {
 					void tmuxManager.onSessionDeleted(event);
 				}
 			: undefined,
+		onShutdown: tmuxManager
+			? () => {
+					void tmuxManager.cleanup();
+				}
+			: undefined,
 	});
 
 	// Session memory hooks handle checkpointing and compaction for non-Cadence sessions
@@ -106,7 +111,17 @@ export async function createCoderPlugin(ctx: PluginInput): Promise<Hooks> {
 	// Create plugin tools using the @opencode-ai/plugin tool helper
 	const tools = createTools(backgroundManager);
 
-	registerShutdownHandler(backgroundManager, tmuxManager);
+	// Create a logger for shutdown handler
+	const shutdownLogger = (message: string) =>
+		ctx.client.app.log({
+			body: {
+				service: 'agentuity-coder',
+				level: 'info',
+				message: `[shutdown] ${message}`,
+			},
+		});
+
+	registerShutdownHandler(backgroundManager, tmuxManager, shutdownLogger);
 
 	// Show startup toast (fire and forget, don't block)
 	try {
@@ -647,18 +662,59 @@ function extractEventFromInput(
 
 function registerShutdownHandler(
 	manager: BackgroundManager,
-	tmuxManager?: TmuxSessionManager
+	tmuxManager?: TmuxSessionManager,
+	logger?: (msg: string) => void
 ): void {
-	if (typeof process === 'undefined') return;
-	const shutdown = () => {
-		manager.shutdown();
+	if (typeof process === 'undefined') {
+		logger?.('[shutdown] process is undefined, cannot register handlers');
+		return;
+	}
+
+	const log = logger ?? (() => {});
+	let shutdownCalled = false;
+
+	log(
+		`Registering shutdown handlers (PID: ${process.pid}, tmuxManager: ${tmuxManager ? 'yes' : 'no'})`
+	);
+	log(`Current tracked sessions in tmuxManager: ${tmuxManager ? 'checking...' : 'N/A'}`);
+
+	const shutdown = (signal?: string) => {
+		// Prevent multiple shutdown calls
+		if (shutdownCalled) {
+			log(`Shutdown already in progress, ignoring ${signal ?? 'unknown'} signal`);
+			return;
+		}
+		shutdownCalled = true;
+
+		log(`Shutdown triggered by ${signal ?? 'unknown'} signal`);
+
+		try {
+			log('Shutting down background manager...');
+			manager.shutdown();
+			log('Background manager shutdown complete');
+		} catch (error) {
+			log(`Background manager shutdown error: ${error}`);
+		}
+
 		if (tmuxManager) {
-			// Use sync version to ensure cleanup completes before process exits
-			tmuxManager.cleanupSync();
+			try {
+				log('Cleaning up tmux sessions...');
+				// Use sync version to ensure cleanup completes before process exits
+				tmuxManager.cleanupSync();
+				log('Tmux cleanup complete');
+			} catch (error) {
+				log(`Tmux cleanup error: ${error}`);
+			}
 		}
+
+		log('Shutdown complete');
 	};
-	process.once('beforeExit', shutdown);
-	process.once('SIGINT', shutdown);
-	process.once('SIGTERM', shutdown);
-	process.once('exit', shutdown); // Also handle exit event for extra safety
+
+	process.once('beforeExit', () => shutdown('beforeExit'));
+	process.once('SIGINT', () => shutdown('SIGINT'));
+	process.once('SIGTERM', () => shutdown('SIGTERM'));
+	process.once('SIGHUP', () => shutdown('SIGHUP')); // Handle tmux pane close
+	process.once('exit', () => shutdown('exit')); // Also handle exit event for extra safety
+
+	log('Shutdown handlers registered for: beforeExit, SIGINT, SIGTERM, SIGHUP, exit');
 }

package/src/skills/frontmatter.ts

@@ -13,7 +13,7 @@ export function parseFrontmatter<T = Record<string, unknown>>(
 		return { data: {} as T, body: content.trim() };
 	}
 
-	const frontmatter = match[1];
+	const frontmatter = match[1] ?? '';
 	const body = content.slice(match[0].length).trim();
 
 	try {