@demicodes/agent 0.23.0 → 0.24.1

package/dist/index.d.mts

@@ -672,6 +672,11 @@ declare class ChildSupervisor<State = unknown> {
   private notifyIdleParent;
   private childEnvironment;
   private createChildEnvironment;
+  /**
+   * No name means the unnamed inherit profile: the parent harness, model, Host
+   * and commands, always available and never configurable. A name must match a
+   * declared profile; "default" is not a name.
+   */
   private resolveProfile;
   private configuredProfileNames;
   private subagentPreamble;

package/dist/index.mjs

@@ -2751,6 +2751,13 @@ var AgentDirectory = class {
 		return [await build(this.rootId(), null, null, null, this.root.supervisor)];
 	}
 };
+/** The reserved word a harness may not use as a profile name: it is not a profile, it is the absence of one. */
+const INHERIT_PROFILE_NAME = "default";
+const INHERIT_PROFILE_LABEL = "(inherit)";
+const INHERIT_PROFILE = {
+	name: INHERIT_PROFILE_LABEL,
+	description: "Inherits the parent harness, model, Host, and commands."
+};
 /**
 * Per-session subagent supervisor. Every session — root or subagent — owns one
 * and carries the identical `demi agent` command tree, so spawn nests to any
@@ -2767,6 +2774,7 @@ var ChildSupervisor = class ChildSupervisor {
 	parentSession = null;
 	isDisposed = false;
 	constructor(options) {
+		if (options.profiles?.some((profile) => profile.name === INHERIT_PROFILE_NAME)) throw new Error(`subagent profile name "${INHERIT_PROFILE_NAME}" is reserved: omitting --profile already inherits the parent`);
 		this.options = options;
 	}
 	attachParent(session) {
@@ -2798,7 +2806,7 @@ var ChildSupervisor = class ChildSupervisor {
 			failureOutput: "non-zero exit with the abort or failure reason on stderr",
 			input: {
 				prompt: z.string().optional().describe(SPAWN_PROMPT_DESCRIPTION),
-				profile: z.string().optional().describe(`Named subagent profile configured at harness assembly. Available: ${profileNames.join(", ")}.`),
+				profile: z.string().optional().describe(`Named subagent profile configured at harness assembly; omit to inherit the parent's model, prompt, Host and commands. Available: ${profileNames.length > 0 ? profileNames.join(", ") : "none"}.`),
 				description: z.string().optional().describe("Short UI title distinguishing concurrent children."),
 				"no-subagents": z.boolean().optional().describe("Forbid this child from spawning subagents of its own; it can still send, steer, list, and show.")
 			},
@@ -3123,6 +3131,7 @@ var ChildSupervisor = class ChildSupervisor {
 		if (!meta?.closedPhase) throw new Error(`no archived subagent "${id}" (see \`demi agent list\`)`);
 		const checkpoint = await this.childSessionStore(id).loadCheckpoint();
 		if (!checkpoint) throw new Error(`archived subagent "${id}" has no checkpoint left`);
+		this.resolveProfile(meta.profileName ?? void 0);
 		const liveMeta = {
 			description: meta.description,
 			profileName: meta.profileName,
@@ -3174,7 +3183,7 @@ var ChildSupervisor = class ChildSupervisor {
 		const profile = this.resolveProfile(input.profileName);
 		const id = createId();
 		const metadata = parent.actionMetadata();
-		const profileName = input.profileName ?? (this.options.profiles ? profile.name : null);
+		const profileName = input.profileName ?? null;
 		const spawnedAt = Date.now();
 		const canSpawnSubagents = !input.isSpawnForbidden && profile.canSpawnSubagents !== false;
 		const { job, runtime } = this.assembleJob({
@@ -3587,25 +3596,20 @@ var ChildSupervisor = class ChildSupervisor {
 			commands: job.commandRegistry
 		});
 	}
+	/**
+	* No name means the unnamed inherit profile: the parent harness, model, Host
+	* and commands, always available and never configurable. A name must match a
+	* declared profile; "default" is not a name.
+	*/
 	resolveProfile(name) {
-		const profiles = this.options.profiles;
-		const implicitDefault = {
-			name: "default",
-			description: "Inherits the parent harness, model, Host, and commands."
-		};
-		if (!profiles || profiles.length === 0) {
-			if (name !== void 0 && name !== "default") throw new Error(`unknown profile "${name}" (available: default)`);
-			return implicitDefault;
-		}
-		const target = name ?? "default";
-		const profile = profiles.find((candidate) => candidate.name === target);
+		if (name === void 0) return INHERIT_PROFILE;
+		const profile = this.options.profiles?.find((candidate) => candidate.name === name);
 		if (profile) return profile;
-		if (name === void 0) return implicitDefault;
-		throw new Error(`unknown profile "${name}" (available: ${this.configuredProfileNames().join(", ")})`);
+		const names = this.configuredProfileNames();
+		throw new Error(`unknown profile "${name}" (available: ${names.length > 0 ? names.join(", ") : "none; omit --profile to inherit the parent"})`);
 	}
 	configuredProfileNames() {
-		const names = (this.options.profiles ?? []).map((profile) => profile.name);
-		return names.includes("default") ? names : ["default", ...names];
+		return (this.options.profiles ?? []).map((profile) => profile.name);
 	}
 	subagentPreamble(childId) {
 		return [
@@ -3711,7 +3715,7 @@ var ChildSupervisor = class ChildSupervisor {
 			job.phase,
 			`up ${formatDuration(now - job.spawnedAt)}`,
 			`last-event ${formatDuration(now - job.lastEventAt)} ago`,
-			`profile=${job.profileName ?? "default"}`,
+			`profile=${job.profileName ?? INHERIT_PROFILE_LABEL}`,
 			job.description ? `"${job.description}"` : "(no description)",
 			`execution=${execution}`,
 			`activity=${this.activityOf(job, execution)}`
@@ -3724,7 +3728,7 @@ var ChildSupervisor = class ChildSupervisor {
 			`id: ${job.id}`,
 			`parent: ${this.ownerId()}`,
 			`description: ${job.description || "(none)"}`,
-			`profile: ${job.profileName ?? "default"}`,
+			`profile: ${job.profileName ?? INHERIT_PROFILE_LABEL}`,
 			`phase: ${job.phase}`,
 			`elapsed: ${formatDuration(now - job.spawnedAt)}`,
 			`execution: ${execution} (for ${formatDuration(this.executionForMs(job, execution, now))})`,

package/package.json

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