@demicodes/agent 0.19.0 → 0.19.1

package/dist/index.d.mts

@@ -271,6 +271,14 @@ interface AgentServerOptions {
   providers: Provider[];
   shell?: Omit<BashEnvironmentOptions, 'host' | 'commands'>;
   session?: AgentServerSessionOptions;
+  subagents?: {
+    /**
+     * When false, a child closing never wakes an idle parent with an automatic
+     * user send; the host app observes the `subagent closed` frame and drives
+     * the parent itself. Defaults to true.
+     */
+    notifyParentOnIdle?: boolean;
+  };
   /**
    * Optional host-side shell prep (env, PATH, etc.). Implementation-agnostic —
    * command bridge wiring lives in `@demicodes/host-local`, not here.
@@ -314,6 +322,7 @@ declare class AgentServer {
   private readonly shellOptions;
   private readonly sessionOptions;
   private readonly prepareShell;
+  private readonly notifyParentOnIdle;
   private readonly bindings;
   private readonly sessionOwnership;
   constructor(options: AgentServerOptions);
@@ -342,6 +351,8 @@ interface ChildSupervisorOptions<State> {
   shellOptions: Omit<BashEnvironmentOptions, 'host' | 'commands'>;
   prepareShell: PrepareShell | null;
   sessionOptions: AgentServerSessionOptions;
+  /** When false, a child closing never wakes an idle parent; the host app orchestrates the wakeup from the `subagent closed` frame. */
+  notifyParentOnIdle: boolean;
   emit(frame: ServerFrame): void;
 }
 /**

package/dist/index.mjs

@@ -3049,7 +3049,7 @@ var ChildSupervisor = class {
 	}
 	/** Wakes an idle parent with a user send; a parent blocked in the spawn gets the tool result instead. */
 	notifyIdleParent(job, close) {
-		if (this.isDisposed) return;
+		if (this.isDisposed || !this.options.notifyParentOnIdle) return;
 		const parent = this.parentSession;
 		if (!parent || parent.phase() !== "idle") return;
 		const label = `subagent ${job.id}${job.description ? ` — ${job.description}` : ""}`;
@@ -3057,7 +3057,7 @@ var ChildSupervisor = class {
 		parent.send([{
 			type: "text",
 			text: body
-		}]).catch(noop);
+		}], job.metadata ? { metadata: job.metadata } : {}).catch(noop);
 	}
 	createChildAgentNode(childId, description) {
 		return {
@@ -3090,13 +3090,15 @@ var ChildSupervisor = class {
 			type: "text",
 			text: `[subagent ${childId}${description ? ` — ${description}` : ""}] ${message}`
 		}];
+		const metadata = this.jobs.get(childId)?.metadata ?? null;
+		const sendOptions = metadata ? { metadata } : {};
 		if (parent.phase() !== "idle") {
 			parent.steer(content).catch(() => {
-				parent.send(content).catch(noop);
+				parent.send(content, sendOptions).catch(noop);
 			});
 			return;
 		}
-		parent.send(content).catch(noop);
+		parent.send(content, sendOptions).catch(noop);
 	}
 	async childEnvironment(job, ctx) {
 		const resolved = await this.options.agent.host({
@@ -3445,6 +3447,7 @@ var AgentServer = class {
 	shellOptions;
 	sessionOptions;
 	prepareShell;
+	notifyParentOnIdle;
 	bindings = /* @__PURE__ */ new Set();
 	sessionOwnership = new SessionOwnershipRegistry();
 	constructor(options) {
@@ -3453,6 +3456,7 @@ var AgentServer = class {
 		this.shellOptions = options.shell ?? {};
 		this.sessionOptions = options.session ?? {};
 		this.prepareShell = options.prepareShell ?? null;
+		this.notifyParentOnIdle = options.subagents?.notifyParentOnIdle ?? true;
 	}
 	client() {
 		const transports = createInProcessTransportPair();
@@ -3467,6 +3471,7 @@ var AgentServer = class {
 			shell: this.shellOptions,
 			session: this.sessionOptions,
 			prepareShell: this.prepareShell,
+			notifyParentOnIdle: this.notifyParentOnIdle,
 			sessions: this.sessionOwnership
 		});
 		this.bindings.add(binding);
@@ -3516,6 +3521,7 @@ var AgentTransportBindingImpl = class {
 	shellOptions;
 	sessionOptions;
 	prepareShell;
+	notifyParentOnIdle;
 	sessions;
 	session = null;
 	currentAgent = null;
@@ -3537,6 +3543,7 @@ var AgentTransportBindingImpl = class {
 		this.shellOptions = options.shell ?? {};
 		this.sessionOptions = options.session ?? {};
 		this.prepareShell = options.prepareShell;
+		this.notifyParentOnIdle = options.notifyParentOnIdle;
 		this.sessions = options.sessions;
 		this.unsubscribeTransport = this.transport.onFrame((frame) => {
 			this.handleFrame(frame);
@@ -3752,6 +3759,7 @@ var AgentTransportBindingImpl = class {
 			shellOptions: this.shellOptions,
 			prepareShell: this.prepareShell,
 			sessionOptions: this.sessionOptions,
+			notifyParentOnIdle: this.notifyParentOnIdle,
 			emit: (subagentFrame) => this.send(subagentFrame)
 		});
 		const commands = injectSubagentCommand(harnessCommands, supervisor.rootCommandNode());

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@demicodes/agent",
   "description": "Session runtime and transport-neutral client and server protocol for Demi.",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "private": false,
   "type": "module",
   "exports": {
@@ -19,10 +19,10 @@
     }
   },
   "dependencies": {
-    "@demicodes/core": "^0.19.0",
-    "@demicodes/provider": "^0.19.0",
-    "@demicodes/shell": "^0.19.0",
-    "@demicodes/utils": "^0.19.0",
+    "@demicodes/core": "^0.19.1",
+    "@demicodes/provider": "^0.19.1",
+    "@demicodes/shell": "^0.19.1",
+    "@demicodes/utils": "^0.19.1",
     "zod": "^4.0.0"
   },
   "license": "Apache-2.0",