@humain/terminal 0.0.4-beta.2 → 0.0.5

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.0.5] - 2026-08-25
+
+### Added
+
+- Added exact per-child model selection for built-in `subagent` single, parallel, and chain calls, with agent and parent-model fallbacks.
+
+### Changed
+
+- Updated the bundled `pi-web-access` implementation to upstream `0.24.2`.
+
 ## [0.0.4-beta.2] - 2026-08-22
 
 ### Added

package/dist/core/tools/subagent.d.ts

@@ -62,14 +62,17 @@ export interface SubagentDetails {
 declare const SubagentParams: Type.TObject<{
     agent: Type.TOptional<Type.TString>;
     task: Type.TOptional<Type.TString>;
+    model: Type.TOptional<Type.TString>;
     tasks: Type.TOptional<Type.TArray<Type.TObject<{
         agent: Type.TString;
         task: Type.TString;
+        model: Type.TOptional<Type.TString>;
         cwd: Type.TOptional<Type.TString>;
     }>>>;
     chain: Type.TOptional<Type.TArray<Type.TObject<{
         agent: Type.TString;
         task: Type.TString;
+        model: Type.TOptional<Type.TString>;
         cwd: Type.TOptional<Type.TString>;
     }>>>;
     agentScope: Type.TOptional<Type.TUnsafe<"both" | "project" | "user">>;

package/dist/core/tools/subagent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../src/core/tools/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI/B,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAU/E,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,mCAAmC,CAAC;AAUnE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAyED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,oBAAoB,CAmBnF;AAoGD,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACtC,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,oBAAoB,EAAE,CAAC;CAChC;AA4RD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;EAUlB,CAAC;AAEH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,cAAc,EAAE,eAAe,CAAC,CA+mBhH;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,2EAE7C"}
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../src/core/tools/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAO,OAAO,EAAS,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI/B,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAU/E,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,mCAAmC,CAAC;AAUnE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAyED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,oBAAoB,CAmBnF;AAoGD,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACtC,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAgTD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;EAWlB,CAAC;AAEH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,cAAc,EAAE,eAAe,CAAC,CAsnBhH;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,2EAE7C"}

package/dist/core/tools/subagent.js

@@ -297,7 +297,7 @@ function getCliInvocation(args) {
     }
     return { command: "humain-terminal", args };
 }
-async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, signal, onUpdate, makeDetails) {
+async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, model, parentModel, signal, onUpdate, makeDetails) {
     const agent = agents.find((a) => a.name === agentName);
     if (!agent) {
         const available = agents.map((a) => `"${a.name}"`).join(", ") || "none";
@@ -312,9 +312,26 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
             step,
         };
     }
+    const selectedModel = model ?? agent.model;
+    if (!selectedModel && !parentModel) {
+        const errorMessage = "Cannot run subagents without a selected model.";
+        return {
+            agent: agentName,
+            agentSource: agent.source,
+            task,
+            exitCode: 1,
+            messages: [],
+            stderr: errorMessage,
+            usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, contextTokens: 0, turns: 0 },
+            errorMessage,
+            step,
+        };
+    }
     const args = ["--mode", "json", "-p", "--no-session"];
-    if (agent.model)
-        args.push("--model", agent.model);
+    if (selectedModel)
+        args.push("--model", selectedModel);
+    else if (parentModel)
+        args.push("--provider", parentModel.provider, "--model", parentModel.id);
     if (agent.tools && agent.tools.length > 0)
         args.push("--tools", agent.tools.join(","));
     let tmpPromptDir = null;
@@ -327,7 +344,7 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
         messages: [],
         stderr: "",
         usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, contextTokens: 0, turns: 0 },
-        model: agent.model,
+        model: selectedModel ?? (parentModel ? `${parentModel.provider}/${parentModel.id}` : undefined),
         step,
     };
     const emitUpdate = () => {
@@ -380,8 +397,8 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
                             currentResult.usage.cost += usage.cost?.total || 0;
                             currentResult.usage.contextTokens = usage.totalTokens || 0;
                         }
-                        if (!currentResult.model && msg.model)
-                            currentResult.model = msg.model;
+                        if (msg.model)
+                            currentResult.model = msg.responseModel ?? msg.model;
                         if (msg.stopReason)
                             currentResult.stopReason = msg.stopReason;
                         if (msg.errorMessage)
@@ -452,11 +469,13 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
 const TaskItem = Type.Object({
     agent: Type.String({ description: "Name of the agent to invoke" }),
     task: Type.String({ description: "Task to delegate to the agent" }),
+    model: Type.Optional(Type.String({ description: "Canonical provider/model for this child" })),
     cwd: Type.Optional(Type.String({ description: "Working directory for the agent process" })),
 });
 const ChainItem = Type.Object({
     agent: Type.String({ description: "Name of the agent to invoke" }),
     task: Type.String({ description: "Task with optional {previous} placeholder for prior output" }),
+    model: Type.Optional(Type.String({ description: "Canonical provider/model for this child" })),
     cwd: Type.Optional(Type.String({ description: "Working directory for the agent process" })),
 });
 const AgentScopeSchema = StringEnum(["user", "project", "both"], {
@@ -466,6 +485,7 @@ const AgentScopeSchema = StringEnum(["user", "project", "both"], {
 const SubagentParams = Type.Object({
     agent: Type.Optional(Type.String({ description: "Name of the agent to invoke (for single mode)" })),
     task: Type.Optional(Type.String({ description: "Task to delegate (for single mode)" })),
+    model: Type.Optional(Type.String({ description: "Canonical provider/model for the single child" })),
     tasks: Type.Optional(Type.Array(TaskItem, { description: "Array of {agent, task} for parallel execution" })),
     chain: Type.Optional(Type.Array(ChainItem, { description: "Array of {agent, task} for sequential execution" })),
     agentScope: Type.Optional(AgentScopeSchema),
@@ -490,6 +510,7 @@ export function createSubagentToolDefinition(cwd) {
         async execute(_toolCallId, params, signal, onUpdate, ctx) {
             const agentScope = params.agentScope ?? "user";
             const defaultCwd = ctx?.cwd ?? cwd;
+            const parentModel = ctx?.model;
             const discovery = discoverAgents(defaultCwd, agentScope);
             const agents = discovery.agents;
             const confirmProjectAgents = params.confirmProjectAgents ?? true;
@@ -596,7 +617,7 @@ export function createSubagentToolDefinition(cwd) {
                             }
                         }
                         : undefined;
-                    const result = await runSingleAgent(defaultCwd, agents, step.agent, taskWithContext, step.cwd, i + 1, signal, chainUpdate, makeDetails("chain"));
+                    const result = await runSingleAgent(defaultCwd, agents, step.agent, taskWithContext, step.cwd, i + 1, step.model, parentModel, signal, chainUpdate, makeDetails("chain"));
                     results.push(result);
                     const isError = isFailedResult(result);
                     if (isError) {
@@ -656,7 +677,7 @@ export function createSubagentToolDefinition(cwd) {
                     }
                 };
                 const results = await mapWithConcurrencyLimit(params.tasks, MAX_CONCURRENCY, async (t, index) => {
-                    const result = await runSingleAgent(defaultCwd, agents, t.agent, t.task, t.cwd, undefined, signal, 
+                    const result = await runSingleAgent(defaultCwd, agents, t.agent, t.task, t.cwd, undefined, t.model, parentModel, signal, 
                     // Per-task update callback
                     (partial) => {
                         if (partial.details?.results[0]) {
@@ -687,7 +708,7 @@ export function createSubagentToolDefinition(cwd) {
                 };
             }
             if (params.agent && params.task) {
-                const result = await runSingleAgent(defaultCwd, agents, params.agent, params.task, params.cwd, undefined, signal, onUpdate, makeDetails("single"));
+                const result = await runSingleAgent(defaultCwd, agents, params.agent, params.task, params.cwd, undefined, params.model, parentModel, signal, onUpdate, makeDetails("single"));
                 const isError = isFailedResult(result);
                 if (isError) {
                     const errorMsg = getResultOutput(result);