@yolk-sdk/agent 0.1.0-canary.52 → 0.1.0-canary.53

package/README.md

@@ -389,7 +389,9 @@ Recommended setup:
 - omit `task` from subagent toolsets
 - include only tools that are safe for autonomous delegated work
 - use `makeSubagentRunId(call.id)` for protocol-aligned run ids
-- return `makeTaskToolResult(...)` so UI can show subagent id, type, status, model, and timing
+- optionally configure model and reasoning-effort choices so the parent can select child runtime settings
+- treat omitted `model` and `reasoning_effort` parameters as inheritance of host runtime settings
+- return `makeTaskToolResult(...)` so UI can show subagent id, type, status, model, reasoning effort, and timing
 
 Keep host-owned subagent execution wiring outside this package; pass only the package task contract across the boundary.
 

package/dist/skillset/merge.d.mts

@@ -17,17 +17,16 @@ declare const mergeSkillsets: (sources: ReadonlyArray<SkillsetSource>) => Effect
   skills: {
     readonly name: string;
     readonly description: string;
-    readonly location: string;
     readonly content: string;
+    readonly location: string;
     readonly source?: string | undefined;
   }[];
   commands: {
     readonly name: string;
     readonly hints: readonly string[];
     readonly template: string;
-    readonly description?: string | undefined;
     readonly source?: string | undefined;
-    readonly location?: string | undefined;
+    readonly description?: string | undefined;
     readonly arguments?: readonly {
       readonly required: boolean;
       readonly name: string;
@@ -35,6 +34,7 @@ declare const mergeSkillsets: (sources: ReadonlyArray<SkillsetSource>) => Effect
     }[] | undefined;
     readonly access?: "read" | "write" | "destructive" | undefined;
     readonly fileRefs?: boolean | undefined;
+    readonly location?: string | undefined;
   }[];
 }, SkillsetError, never>;
 //#endregion

package/dist/skillset/name.d.mts

@@ -3,8 +3,8 @@ import { Effect } from "effect";
 
 //#region src/skillset/name.d.ts
 declare const isValidSkillsetName: (name: string) => boolean;
-declare const validateSkillsetName: (name: string) => Effect.Effect<never, SkillsetError, never> | Effect.Effect<string, never, never>;
-declare const validateDirectoryName: (expected: string, actual: string) => Effect.Effect<never, SkillsetError, never> | Effect.Effect<string, never, never>;
+declare const validateSkillsetName: (name: string) => Effect.Effect<string, never, never> | Effect.Effect<never, SkillsetError, never>;
+declare const validateDirectoryName: (expected: string, actual: string) => Effect.Effect<string, never, never> | Effect.Effect<never, SkillsetError, never>;
 //#endregion
 export { isValidSkillsetName, validateDirectoryName, validateSkillsetName };
 //# sourceMappingURL=name.d.mts.map

package/dist/skillset/name.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"name.d.mts","names":[],"sources":["../../src/skillset/name.ts"],"mappings":";;;;cAMa,mBAAA,GAAuB,IAAY;AAAA,cAGnC,oBAAA,GAAwB,IAAA,aAAY,MAAA,CAAA,MAAA,QAAA,aAAA,WAAA,MAAA,CAAA,MAAA;AAAA,cAUpC,qBAAA,GAAyB,QAAA,UAAkB,MAAA,aAAc,MAAA,CAAA,MAAA,QAAA,aAAA,WAAA,MAAA,CAAA,MAAA"}
+{"version":3,"file":"name.d.mts","names":[],"sources":["../../src/skillset/name.ts"],"mappings":";;;;cAMa,mBAAA,GAAuB,IAAY;AAAA,cAGnC,oBAAA,GAAwB,IAAA,aAAY,MAAA,CAAA,MAAA,yBAAA,MAAA,CAAA,MAAA,QAAA,aAAA;AAAA,cAUpC,qBAAA,GAAyB,QAAA,UAAkB,MAAA,aAAc,MAAA,CAAA,MAAA,yBAAA,MAAA,CAAA,MAAA,QAAA,aAAA"}

package/dist/tools/index.d.mts

@@ -1,4 +1,4 @@
 import { EmptyToolParams, ModelVisibleToolError, ModelVisibleToolErrorInput, ModelVisibleToolErrorReason, ModelVisibleToolErrorStructuredContent, ModelVisibleToolErrorStructuredContentSchema, ResolvedToolSet, SchemaToolExecutionInput, ToolAccess, ToolExecutionInput, ToolMetadata, ToolModule, ToolRegistration, ToolRegistryError, makeTool, makeToolExecutorLayer, modelVisibleToolError, modelVisibleToolErrorResult, modelVisibleToolErrorStructuredContent, resolveTools } from "./registry.mjs";
 import { QuestionExecutionInput, QuestionToolOptions, makeQuestionToolDef, makeQuestionToolModule, makeQuestionToolRegistration, questionToolName } from "./question.mjs";
-import { TaskExecutionInput, TaskSubagentContext, TaskSubagentDefinition, TaskToolOptions, TaskToolParams, TaskToolResultInput, formatTaskResult, makeNonRecursiveTaskToolModule, makeTaskToolDef, makeTaskToolModule, makeTaskToolRegistration, makeTaskToolResult, subagentResultText, taskSubagentRunId, taskToolName } from "./task.mjs";
-export { EmptyToolParams, ModelVisibleToolError, type ModelVisibleToolErrorInput, ModelVisibleToolErrorReason, type ModelVisibleToolErrorStructuredContent, ModelVisibleToolErrorStructuredContentSchema, type QuestionExecutionInput, type QuestionToolOptions, type ResolvedToolSet, type SchemaToolExecutionInput, type TaskExecutionInput, type TaskSubagentContext, type TaskSubagentDefinition, type TaskToolOptions, type TaskToolParams, type TaskToolResultInput, ToolAccess, type ToolExecutionInput, type ToolMetadata, type ToolModule, type ToolRegistration, ToolRegistryError, formatTaskResult, makeNonRecursiveTaskToolModule, makeQuestionToolDef, makeQuestionToolModule, makeQuestionToolRegistration, makeTaskToolDef, makeTaskToolModule, makeTaskToolRegistration, makeTaskToolResult, makeTool, makeToolExecutorLayer, modelVisibleToolError, modelVisibleToolErrorResult, modelVisibleToolErrorStructuredContent, questionToolName, resolveTools, subagentResultText, taskSubagentRunId, taskToolName };
+import { TaskExecutionInput, TaskModelDefinition, TaskReasoningEffortDefinition, TaskRuntimeSelectionOptions, TaskSubagentContext, TaskSubagentDefinition, TaskToolOptions, TaskToolParams, TaskToolResultInput, formatTaskResult, makeNonRecursiveTaskToolModule, makeTaskToolDef, makeTaskToolModule, makeTaskToolRegistration, makeTaskToolResult, subagentResultText, taskSubagentRunId, taskToolName } from "./task.mjs";
+export { EmptyToolParams, ModelVisibleToolError, type ModelVisibleToolErrorInput, ModelVisibleToolErrorReason, type ModelVisibleToolErrorStructuredContent, ModelVisibleToolErrorStructuredContentSchema, type QuestionExecutionInput, type QuestionToolOptions, type ResolvedToolSet, type SchemaToolExecutionInput, type TaskExecutionInput, type TaskModelDefinition, type TaskReasoningEffortDefinition, type TaskRuntimeSelectionOptions, type TaskSubagentContext, type TaskSubagentDefinition, type TaskToolOptions, type TaskToolParams, type TaskToolResultInput, ToolAccess, type ToolExecutionInput, type ToolMetadata, type ToolModule, type ToolRegistration, ToolRegistryError, formatTaskResult, makeNonRecursiveTaskToolModule, makeQuestionToolDef, makeQuestionToolModule, makeQuestionToolRegistration, makeTaskToolDef, makeTaskToolModule, makeTaskToolRegistration, makeTaskToolResult, makeTool, makeToolExecutorLayer, modelVisibleToolError, modelVisibleToolErrorResult, modelVisibleToolErrorStructuredContent, questionToolName, resolveTools, subagentResultText, taskSubagentRunId, taskToolName };

package/dist/tools/task.d.mts

@@ -1,21 +1,33 @@
 import { ToolModule, ToolRegistration, ToolRegistryError } from "./registry.mjs";
 import { Effect } from "effect";
-import { AgentEvent, ToolCall, ToolResult } from "@yolk-sdk/agent/protocol";
-import * as Schema from "effect/Schema";
+import { AgentEvent, AgentReasoningEffort, ToolCall, ToolResult } from "@yolk-sdk/agent/protocol";
 import { ToolError } from "@yolk-sdk/agent/loop";
 
 //#region src/tools/task.d.ts
 declare const taskToolName = "task";
-declare const TaskToolParams: Schema.Struct<{
-  readonly description: Schema.String;
-  readonly prompt: Schema.String;
-  readonly subagent_type: Schema.String;
-}>;
-type TaskToolParams = typeof TaskToolParams.Type;
+type TaskToolParams = {
+  readonly description: string;
+  readonly prompt: string;
+  readonly subagent_type: string;
+  readonly model?: string;
+  readonly reasoning_effort?: AgentReasoningEffort;
+};
 type TaskSubagentDefinition = {
   readonly name: string;
   readonly description: string;
 };
+type TaskModelDefinition = {
+  readonly id: string;
+  readonly description: string;
+};
+type TaskReasoningEffortDefinition = {
+  readonly value: AgentReasoningEffort;
+  readonly description: string;
+};
+type TaskRuntimeSelectionOptions = {
+  readonly models?: ReadonlyArray<TaskModelDefinition>;
+  readonly reasoningEfforts?: ReadonlyArray<TaskReasoningEffortDefinition>;
+};
 type TaskSubagentContext = {
   readonly subagent?: boolean;
 };
@@ -24,7 +36,7 @@ type TaskExecutionInput<Context> = {
   readonly context: Context;
   readonly params: TaskToolParams;
 };
-type TaskToolOptions<Context> = {
+type TaskToolOptions<Context> = TaskRuntimeSelectionOptions & {
   readonly subagents: ReadonlyArray<TaskSubagentDefinition>;
   readonly isEnabled?: (context: Context) => Effect.Effect<boolean, ToolRegistryError>;
   readonly execute: (input: TaskExecutionInput<Context>) => Effect.Effect<ToolResult, ToolError>;
@@ -38,10 +50,11 @@ type TaskToolResultInput = {
   readonly startedAtMs: number;
   readonly endedAtMs: number;
   readonly model: string;
+  readonly reasoningEffort?: AgentReasoningEffort;
   readonly isError?: boolean;
 };
 declare const makeTaskToolRegistration: <Context>(options: TaskToolOptions<Context>) => ToolRegistration<Context>;
-declare const makeTaskToolDef: (subagents: ReadonlyArray<TaskSubagentDefinition>) => import("@yolk-sdk/agent/protocol").ToolDef;
+declare const makeTaskToolDef: (subagents: ReadonlyArray<TaskSubagentDefinition>, runtimeSelections?: TaskRuntimeSelectionOptions) => import("@yolk-sdk/agent/protocol").ToolDef;
 declare const makeTaskToolModule: <Context>(options: TaskToolOptions<Context>) => ToolModule<Context>;
 declare const makeNonRecursiveTaskToolModule: <Context extends TaskSubagentContext>(options: TaskToolOptions<Context>) => ToolModule<Context>;
 declare const formatTaskResult: (output: string) => string;
@@ -49,5 +62,5 @@ declare const taskSubagentRunId: (parentToolCallId: string) => string;
 declare const subagentResultText: (events: ReadonlyArray<AgentEvent>) => string;
 declare const makeTaskToolResult: (input: TaskToolResultInput) => ToolResult;
 //#endregion
-export { TaskExecutionInput, TaskSubagentContext, TaskSubagentDefinition, TaskToolOptions, TaskToolParams, TaskToolResultInput, formatTaskResult, makeNonRecursiveTaskToolModule, makeTaskToolDef, makeTaskToolModule, makeTaskToolRegistration, makeTaskToolResult, subagentResultText, taskSubagentRunId, taskToolName };
+export { TaskExecutionInput, TaskModelDefinition, TaskReasoningEffortDefinition, TaskRuntimeSelectionOptions, TaskSubagentContext, TaskSubagentDefinition, TaskToolOptions, TaskToolParams, TaskToolResultInput, formatTaskResult, makeNonRecursiveTaskToolModule, makeTaskToolDef, makeTaskToolModule, makeTaskToolRegistration, makeTaskToolResult, subagentResultText, taskSubagentRunId, taskToolName };
 //# sourceMappingURL=task.d.mts.map

package/dist/tools/task.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"task.d.mts","names":[],"sources":["../../src/tools/task.ts"],"mappings":";;;;;;;cAqBa,YAAA;AAAA,cAEP,cAAA,EAAc,MAAA,CAAA,MAAA;EAAA;;;;KAeR,cAAA,UAAwB,cAAA,CAAe,IAAI;AAAA,KAE3C,sBAAA;EAAA,SACD,IAAA;EAAA,SACA,WAAW;AAAA;AAAA,KAGV,mBAAA;EAAA,SACD,QAAQ;AAAA;AAAA,KAGP,kBAAA;EAAA,SACD,IAAA,EAAM,QAAA;EAAA,SACN,OAAA,EAAS,OAAA;EAAA,SACT,MAAA,EAAQ,cAAA;AAAA;AAAA,KAGP,eAAA;EAAA,SACD,SAAA,EAAW,aAAA,CAAc,sBAAA;EAAA,SACzB,SAAA,IAAa,OAAA,EAAS,OAAA,KAAY,MAAA,CAAO,MAAA,UAAgB,iBAAA;EAAA,SACzD,OAAA,GAAU,KAAA,EAAO,kBAAA,CAAmB,OAAA,MAAa,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,SAAA;AAAA;AAAA,KAG1E,mBAAA;EAAA,SACD,MAAA;EAAA,SACA,MAAA;EAAA,SACA,YAAA;EAAA,SACA,WAAA;EAAA,SACA,aAAA;EAAA,SACA,WAAA;EAAA,SACA,SAAA;EAAA,SACA,KAAA;EAAA,SACA,OAAA;AAAA;AAAA,cAgFE,wBAAA,YACX,OAAA,EAAS,eAAA,CAAgB,OAAA,MACxB,gBAAA,CAAiB,OAAA;AAAA,cAwBP,eAAA,GAAmB,SAAA,EAAW,aAAa,CAAC,sBAAA,yCAAuB,OAAA;AAAA,cAMnE,kBAAA,YACX,OAAA,EAAS,eAAA,CAAgB,OAAA,MACxB,UAAA,CAAW,OAAA;AAAA,cAKD,8BAAA,mBAAkD,mBAAA,EAC7D,OAAA,EAAS,eAAA,CAAgB,OAAA,MACxB,UAAA,CAAW,OAAA;AAAA,cAWD,gBAAA,GAAoB,MAAc;AAAA,cAGlC,iBAAA,GAAiB,gBAAA;AAAA,cAQjB,kBAAA,GAAsB,MAAA,EAAQ,aAAa,CAAC,UAAA;AAAA,cAO5C,kBAAA,GAAsB,KAAA,EAAO,mBAAA,KAAmB,UAezD"}
+{"version":3,"file":"task.d.mts","names":[],"sources":["../../src/tools/task.ts"],"mappings":";;;;;;cAsBa,YAAA;AAAA,KAiBD,cAAA;EAAA,SACD,WAAA;EAAA,SACA,MAAA;EAAA,SACA,aAAA;EAAA,SACA,KAAA;EAAA,SACA,gBAAA,GAAmB,oBAAoB;AAAA;AAAA,KAGtC,sBAAA;EAAA,SACD,IAAA;EAAA,SACA,WAAW;AAAA;AAAA,KAGV,mBAAA;EAAA,SACD,EAAA;EAAA,SACA,WAAW;AAAA;AAAA,KAGV,6BAAA;EAAA,SACD,KAAA,EAAO,oBAAoB;EAAA,SAC3B,WAAA;AAAA;AAAA,KAGC,2BAAA;EAAA,SACD,MAAA,GAAS,aAAA,CAAc,mBAAA;EAAA,SACvB,gBAAA,GAAmB,aAAA,CAAc,6BAAA;AAAA;AAAA,KAGhC,mBAAA;EAAA,SACD,QAAQ;AAAA;AAAA,KAGP,kBAAA;EAAA,SACD,IAAA,EAAM,QAAA;EAAA,SACN,OAAA,EAAS,OAAA;EAAA,SACT,MAAA,EAAQ,cAAA;AAAA;AAAA,KAGP,eAAA,YAA2B,2BAAA;EAAA,SAC5B,SAAA,EAAW,aAAA,CAAc,sBAAA;EAAA,SACzB,SAAA,IAAa,OAAA,EAAS,OAAA,KAAY,MAAA,CAAO,MAAA,UAAgB,iBAAA;EAAA,SACzD,OAAA,GAAU,KAAA,EAAO,kBAAA,CAAmB,OAAA,MAAa,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,SAAA;AAAA;AAAA,KAG1E,mBAAA;EAAA,SACD,MAAA;EAAA,SACA,MAAA;EAAA,SACA,YAAA;EAAA,SACA,WAAA;EAAA,SACA,aAAA;EAAA,SACA,WAAA;EAAA,SACA,SAAA;EAAA,SACA,KAAA;EAAA,SACA,eAAA,GAAkB,oBAAoB;EAAA,SACtC,OAAA;AAAA;AAAA,cA2JE,wBAAA,YACX,OAAA,EAAS,eAAA,CAAgB,OAAA,MACxB,gBAAA,CAAiB,OAAA;AAAA,cAwBP,eAAA,GACX,SAAA,EAAW,aAAA,CAAc,sBAAA,GACzB,iBAAA,GAAmB,2BAAA,wCAAgC,OAAA;AAAA,cAQxC,kBAAA,YACX,OAAA,EAAS,eAAA,CAAgB,OAAA,MACxB,UAAA,CAAW,OAAA;AAAA,cAKD,8BAAA,mBAAkD,mBAAA,EAC7D,OAAA,EAAS,eAAA,CAAgB,OAAA,MACxB,UAAA,CAAW,OAAA;AAAA,cAWD,gBAAA,GAAoB,MAAc;AAAA,cAGlC,iBAAA,GAAiB,gBAAA;AAAA,cAQjB,kBAAA,GAAsB,MAAA,EAAQ,aAAa,CAAC,UAAA;AAAA,cAO5C,kBAAA,GAAsB,KAAA,EAAO,mBAAA,KAAmB,UAgBzD"}

package/dist/tools/task.mjs

@@ -5,11 +5,11 @@ import * as Schema from "effect/Schema";
 import { ToolError } from "@yolk-sdk/agent/loop";
 //#region src/tools/task.ts
 const taskToolName = "task";
-const TaskToolParams = Schema.Struct({
+const TaskToolBaseFields = {
 	description: Schema.String.pipe(Schema.annotate({ description: "A short 3-5 word description of the task." })),
 	prompt: Schema.String.pipe(Schema.annotate({ description: "The complete task instructions for the subagent, including all context it needs." })),
 	subagent_type: Schema.String.pipe(Schema.annotate({ description: "The specialized subagent type to use for this task." }))
-});
+};
 const taskToolError = (message, cause) => new ToolError({
 	tool: taskToolName,
 	message,
@@ -20,10 +20,38 @@ const taskModelVisibleError = (message) => modelVisibleToolError({
 	message,
 	reason: "validation"
 });
+const enumRecord = (values) => Object.fromEntries(values.map((value) => [value, value]));
+const optionalRuntimeSelection = (input) => Schema.optionalKey(Schema.Enum(enumRecord(input.values)).pipe(Schema.annotate({ description: input.description })));
+const configuredTaskToolParams = (options) => {
+	const model = options.models === void 0 || options.models.length === 0 ? void 0 : optionalRuntimeSelection({
+		values: options.models.map((item) => item.id),
+		description: "Model for this subagent. Omit to inherit the host runtime model."
+	});
+	const reasoningEffort = options.reasoningEfforts === void 0 || options.reasoningEfforts.length === 0 ? void 0 : optionalRuntimeSelection({
+		values: options.reasoningEfforts.map((item) => item.value),
+		description: "Reasoning effort for this subagent. Omit to inherit the host runtime effort."
+	});
+	if (model !== void 0 && reasoningEffort !== void 0) return Schema.Struct({
+		...TaskToolBaseFields,
+		model,
+		reasoning_effort: reasoningEffort
+	});
+	if (model !== void 0) return Schema.Struct({
+		...TaskToolBaseFields,
+		model
+	});
+	if (reasoningEffort !== void 0) return Schema.Struct({
+		...TaskToolBaseFields,
+		reasoning_effort: reasoningEffort
+	});
+	return Schema.Struct(TaskToolBaseFields);
+};
 const trimmedTaskParams = (params) => ({
 	description: params.description.trim(),
 	prompt: params.prompt.trim(),
-	subagent_type: params.subagent_type.trim()
+	subagent_type: params.subagent_type.trim(),
+	...params.model === void 0 ? {} : { model: params.model },
+	...params.reasoning_effort === void 0 ? {} : { reasoning_effort: params.reasoning_effort }
 });
 const validateTaskParams = (params) => {
 	const trimmed = trimmedTaskParams(params);
@@ -38,19 +66,31 @@ const requireKnownSubagent = (subagents, name) => {
 	return subagent === void 0 ? Effect.fail(taskModelVisibleError(`Unknown subagent type: ${name}`)) : Effect.succeed(subagent);
 };
 const subagentDescription = (subagent) => `- ${subagent.name}: ${subagent.description}`;
-const taskToolDescription = (subagents) => [
+const modelDescription = (model) => `- ${model.id}: ${model.description}`;
+const reasoningEffortDescription = (effort) => `- ${effort.value}: ${effort.description}`;
+const taskToolDescription = (options) => [
 	"Launch a new agent to handle complex, multistep tasks autonomously.",
 	"Use this when delegating focused work to a specialized subagent would save context or allow parallel exploration.",
 	"To run subagents in parallel, call this task tool multiple times in the same assistant response.",
 	"Yolk runs same-turn task calls concurrently automatically.",
 	"A fresh subagent only sees the prompt you provide, so include all required context.",
 	"Subagents can use their normal tools but cannot launch further task subagents in v1.",
-	subagents.length === 0 ? "No subagent types are currently available." : `Available subagent types:\n${subagents.map(subagentDescription).join("\n")}`
-].join("\n\n");
+	options.subagents.length === 0 ? "No subagent types are currently available." : `Available subagent types:\n${options.subagents.map(subagentDescription).join("\n")}`,
+	options.models === void 0 || options.models.length === 0 ? void 0 : [
+		"Available subagent models:",
+		options.models.map(modelDescription).join("\n"),
+		"Omit model to inherit the host runtime model."
+	].join("\n"),
+	options.reasoningEfforts === void 0 || options.reasoningEfforts.length === 0 ? void 0 : [
+		"Available subagent reasoning efforts:",
+		options.reasoningEfforts.map(reasoningEffortDescription).join("\n"),
+		"Omit reasoning_effort to inherit the host runtime effort."
+	].join("\n")
+].filter((section) => section !== void 0).join("\n\n");
 const makeTaskToolRegistration = (options) => makeTool({
 	name: taskToolName,
-	description: taskToolDescription(options.subagents),
-	parameters: TaskToolParams,
+	description: taskToolDescription(options),
+	parameters: configuredTaskToolParams(options),
 	access: "read",
 	isEnabled: options.isEnabled,
 	invalidParamsMessage: (error) => `Invalid task arguments: ${error instanceof Error ? error.message : String(error)}`,
@@ -65,8 +105,9 @@ const makeTaskToolRegistration = (options) => makeTool({
 		});
 	})
 });
-const makeTaskToolDef = (subagents) => makeTaskToolRegistration({
+const makeTaskToolDef = (subagents, runtimeSelections = {}) => makeTaskToolRegistration({
 	subagents,
+	...runtimeSelections,
 	execute: ({ call }) => Effect.succeed(ToolResult.make({
 		toolCallId: call.id,
 		content: ""
@@ -106,7 +147,8 @@ const makeTaskToolResult = (input) => ToolResult.make({
 		ended_at_ms: input.endedAtMs,
 		duration_ms: Math.max(0, input.endedAtMs - input.startedAtMs),
 		status: input.isError === true ? "error" : "completed",
-		model: input.model
+		model: input.model,
+		...input.reasoningEffort === void 0 ? {} : { reasoning_effort: input.reasoningEffort }
 	}
 });
 //#endregion

package/dist/tools/task.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"task.mjs","names":[],"sources":["../../src/tools/task.ts"],"sourcesContent":["import { Effect } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport { ToolError } from '@yolk-sdk/agent/loop'\nimport {\n  assistantContent,\n  contentText,\n  makeSubagentRunId,\n  ToolResult,\n  type AgentEvent,\n  type AgentMessage,\n  type ToolCall\n} from '@yolk-sdk/agent/protocol'\nimport {\n  makeTool,\n  modelVisibleToolError,\n  type ModelVisibleToolError,\n  type ToolModule,\n  type ToolRegistration,\n  type ToolRegistryError\n} from './registry.ts'\n\nexport const taskToolName = 'task'\n\nconst TaskToolParams = Schema.Struct({\n  description: Schema.String.pipe(\n    Schema.annotate({ description: 'A short 3-5 word description of the task.' })\n  ),\n  prompt: Schema.String.pipe(\n    Schema.annotate({\n      description:\n        'The complete task instructions for the subagent, including all context it needs.'\n    })\n  ),\n  subagent_type: Schema.String.pipe(\n    Schema.annotate({ description: 'The specialized subagent type to use for this task.' })\n  )\n})\n\nexport type TaskToolParams = typeof TaskToolParams.Type\n\nexport type TaskSubagentDefinition = {\n  readonly name: string\n  readonly description: string\n}\n\nexport type TaskSubagentContext = {\n  readonly subagent?: boolean\n}\n\nexport type TaskExecutionInput<Context> = {\n  readonly call: ToolCall\n  readonly context: Context\n  readonly params: TaskToolParams\n}\n\nexport type TaskToolOptions<Context> = {\n  readonly subagents: ReadonlyArray<TaskSubagentDefinition>\n  readonly isEnabled?: (context: Context) => Effect.Effect<boolean, ToolRegistryError>\n  readonly execute: (input: TaskExecutionInput<Context>) => Effect.Effect<ToolResult, ToolError>\n}\n\nexport type TaskToolResultInput = {\n  readonly callId: string\n  readonly output: string\n  readonly subagentType: string\n  readonly description: string\n  readonly subagentRunId: string\n  readonly startedAtMs: number\n  readonly endedAtMs: number\n  readonly model: string\n  readonly isError?: boolean\n}\n\nconst taskToolError = (message: string, cause: ToolError['cause']) =>\n  new ToolError({\n    tool: taskToolName,\n    message,\n    cause\n  })\n\nconst taskModelVisibleError = (message: string) =>\n  modelVisibleToolError({\n    tool: taskToolName,\n    message,\n    reason: 'validation'\n  })\n\nconst trimmedTaskParams = (params: TaskToolParams) => ({\n  description: params.description.trim(),\n  prompt: params.prompt.trim(),\n  subagent_type: params.subagent_type.trim()\n})\n\nconst validateTaskParams = (\n  params: TaskToolParams\n): Effect.Effect<\n  {\n    readonly description: string\n    readonly prompt: string\n    readonly subagent_type: string\n  },\n  ModelVisibleToolError\n> => {\n  const trimmed = trimmedTaskParams(params)\n\n  if (trimmed.description.length === 0) {\n    return Effect.fail(taskModelVisibleError('description must not be empty'))\n  }\n\n  if (trimmed.prompt.length === 0) {\n    return Effect.fail(taskModelVisibleError('prompt must not be empty'))\n  }\n\n  if (trimmed.subagent_type.length === 0) {\n    return Effect.fail(taskModelVisibleError('subagent_type must not be empty'))\n  }\n\n  return Effect.succeed(trimmed)\n}\n\nconst findSubagent = (subagents: ReadonlyArray<TaskSubagentDefinition>, name: string) =>\n  subagents.find(subagent => subagent.name === name)\n\nconst requireKnownSubagent = (\n  subagents: ReadonlyArray<TaskSubagentDefinition>,\n  name: string\n): Effect.Effect<TaskSubagentDefinition, ModelVisibleToolError> => {\n  const subagent = findSubagent(subagents, name)\n\n  return subagent === undefined\n    ? Effect.fail(taskModelVisibleError(`Unknown subagent type: ${name}`))\n    : Effect.succeed(subagent)\n}\n\nconst subagentDescription = (subagent: TaskSubagentDefinition) =>\n  `- ${subagent.name}: ${subagent.description}`\n\nconst taskToolDescription = (subagents: ReadonlyArray<TaskSubagentDefinition>) =>\n  [\n    'Launch a new agent to handle complex, multistep tasks autonomously.',\n    'Use this when delegating focused work to a specialized subagent would save context or allow parallel exploration.',\n    'To run subagents in parallel, call this task tool multiple times in the same assistant response.',\n    'Yolk runs same-turn task calls concurrently automatically.',\n    'A fresh subagent only sees the prompt you provide, so include all required context.',\n    'Subagents can use their normal tools but cannot launch further task subagents in v1.',\n    subagents.length === 0\n      ? 'No subagent types are currently available.'\n      : `Available subagent types:\\n${subagents.map(subagentDescription).join('\\n')}`\n  ].join('\\n\\n')\n\nexport const makeTaskToolRegistration = <Context>(\n  options: TaskToolOptions<Context>\n): ToolRegistration<Context> =>\n  makeTool({\n    name: taskToolName,\n    description: taskToolDescription(options.subagents),\n    parameters: TaskToolParams,\n    access: 'read',\n    isEnabled: options.isEnabled,\n    invalidParamsMessage: error =>\n      `Invalid task arguments: ${error instanceof Error ? error.message : String(error)}`,\n    execute: ({ call, context, params }) =>\n      Effect.gen(function* () {\n        if (call.name !== taskToolName) {\n          return yield* Effect.fail(\n            taskToolError(`Tool is not configured: ${call.name}`, 'not_found')\n          )\n        }\n\n        const normalizedParams = yield* validateTaskParams(params)\n        yield* requireKnownSubagent(options.subagents, normalizedParams.subagent_type)\n\n        return yield* options.execute({ call, context, params: normalizedParams })\n      })\n  })\n\nexport const makeTaskToolDef = (subagents: ReadonlyArray<TaskSubagentDefinition>) =>\n  makeTaskToolRegistration({\n    subagents,\n    execute: ({ call }) => Effect.succeed(ToolResult.make({ toolCallId: call.id, content: '' }))\n  }).def\n\nexport const makeTaskToolModule = <Context>(\n  options: TaskToolOptions<Context>\n): ToolModule<Context> => ({\n  id: 'task',\n  tools: [makeTaskToolRegistration(options)]\n})\n\nexport const makeNonRecursiveTaskToolModule = <Context extends TaskSubagentContext>(\n  options: TaskToolOptions<Context>\n): ToolModule<Context> =>\n  makeTaskToolModule({\n    ...options,\n    isEnabled: context =>\n      context.subagent === true\n        ? Effect.succeed(false)\n        : options.isEnabled === undefined\n          ? Effect.succeed(true)\n          : options.isEnabled(context)\n  })\n\nexport const formatTaskResult = (output: string) =>\n  ['<task_result>', output, '</task_result>'].join('\\n')\n\nexport const taskSubagentRunId = makeSubagentRunId\n\nconst latestAssistantText = (messages: ReadonlyArray<AgentMessage>) => {\n  const assistant = [...messages].reverse().find(message => message._tag === 'Assistant')\n\n  return assistant === undefined ? '' : contentText(assistantContent(assistant))\n}\n\nexport const subagentResultText = (events: ReadonlyArray<AgentEvent>) => {\n  const messages = [...events].reverse().find(event => event._tag === 'AgentEnd')?.messages ?? []\n  const text = latestAssistantText(messages).trim()\n\n  return text.length === 0 ? 'Subagent completed without a final text response.' : text\n}\n\nexport const makeTaskToolResult = (input: TaskToolResultInput) =>\n  ToolResult.make({\n    toolCallId: input.callId,\n    content: formatTaskResult(input.output),\n    isError: input.isError,\n    structuredContent: {\n      subagent_run_id: input.subagentRunId,\n      subagent_type: input.subagentType,\n      description: input.description,\n      started_at_ms: input.startedAtMs,\n      ended_at_ms: input.endedAtMs,\n      duration_ms: Math.max(0, input.endedAtMs - input.startedAtMs),\n      status: input.isError === true ? 'error' : 'completed',\n      model: input.model\n    }\n  })\n"],"mappings":"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"}
+{"version":3,"file":"task.mjs","names":[],"sources":["../../src/tools/task.ts"],"sourcesContent":["import { Effect } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport { ToolError } from '@yolk-sdk/agent/loop'\nimport {\n  assistantContent,\n  contentText,\n  makeSubagentRunId,\n  ToolResult,\n  type AgentEvent,\n  type AgentMessage,\n  type AgentReasoningEffort,\n  type ToolCall\n} from '@yolk-sdk/agent/protocol'\nimport {\n  makeTool,\n  modelVisibleToolError,\n  type ModelVisibleToolError,\n  type ToolModule,\n  type ToolRegistration,\n  type ToolRegistryError\n} from './registry.ts'\n\nexport const taskToolName = 'task'\n\nconst TaskToolBaseFields = {\n  description: Schema.String.pipe(\n    Schema.annotate({ description: 'A short 3-5 word description of the task.' })\n  ),\n  prompt: Schema.String.pipe(\n    Schema.annotate({\n      description:\n        'The complete task instructions for the subagent, including all context it needs.'\n    })\n  ),\n  subagent_type: Schema.String.pipe(\n    Schema.annotate({ description: 'The specialized subagent type to use for this task.' })\n  )\n}\n\nexport type TaskToolParams = {\n  readonly description: string\n  readonly prompt: string\n  readonly subagent_type: string\n  readonly model?: string\n  readonly reasoning_effort?: AgentReasoningEffort\n}\n\nexport type TaskSubagentDefinition = {\n  readonly name: string\n  readonly description: string\n}\n\nexport type TaskModelDefinition = {\n  readonly id: string\n  readonly description: string\n}\n\nexport type TaskReasoningEffortDefinition = {\n  readonly value: AgentReasoningEffort\n  readonly description: string\n}\n\nexport type TaskRuntimeSelectionOptions = {\n  readonly models?: ReadonlyArray<TaskModelDefinition>\n  readonly reasoningEfforts?: ReadonlyArray<TaskReasoningEffortDefinition>\n}\n\nexport type TaskSubagentContext = {\n  readonly subagent?: boolean\n}\n\nexport type TaskExecutionInput<Context> = {\n  readonly call: ToolCall\n  readonly context: Context\n  readonly params: TaskToolParams\n}\n\nexport type TaskToolOptions<Context> = TaskRuntimeSelectionOptions & {\n  readonly subagents: ReadonlyArray<TaskSubagentDefinition>\n  readonly isEnabled?: (context: Context) => Effect.Effect<boolean, ToolRegistryError>\n  readonly execute: (input: TaskExecutionInput<Context>) => Effect.Effect<ToolResult, ToolError>\n}\n\nexport type TaskToolResultInput = {\n  readonly callId: string\n  readonly output: string\n  readonly subagentType: string\n  readonly description: string\n  readonly subagentRunId: string\n  readonly startedAtMs: number\n  readonly endedAtMs: number\n  readonly model: string\n  readonly reasoningEffort?: AgentReasoningEffort\n  readonly isError?: boolean\n}\n\nconst taskToolError = (message: string, cause: ToolError['cause']) =>\n  new ToolError({\n    tool: taskToolName,\n    message,\n    cause\n  })\n\nconst taskModelVisibleError = (message: string) =>\n  modelVisibleToolError({\n    tool: taskToolName,\n    message,\n    reason: 'validation'\n  })\n\nconst enumRecord = <Value extends string>(\n  values: ReadonlyArray<Value>\n): Readonly<Record<string, Value>> => Object.fromEntries(values.map(value => [value, value]))\n\nconst optionalRuntimeSelection = <Value extends string>(input: {\n  readonly values: ReadonlyArray<Value>\n  readonly description: string\n}) =>\n  Schema.optionalKey(\n    Schema.Enum(enumRecord(input.values)).pipe(Schema.annotate({ description: input.description }))\n  )\n\nconst configuredTaskToolParams = (options: TaskRuntimeSelectionOptions) => {\n  const model =\n    options.models === undefined || options.models.length === 0\n      ? undefined\n      : optionalRuntimeSelection({\n          values: options.models.map(item => item.id),\n          description: 'Model for this subagent. Omit to inherit the host runtime model.'\n        })\n  const reasoningEffort =\n    options.reasoningEfforts === undefined || options.reasoningEfforts.length === 0\n      ? undefined\n      : optionalRuntimeSelection({\n          values: options.reasoningEfforts.map(item => item.value),\n          description:\n            'Reasoning effort for this subagent. Omit to inherit the host runtime effort.'\n        })\n\n  if (model !== undefined && reasoningEffort !== undefined) {\n    return Schema.Struct({\n      ...TaskToolBaseFields,\n      model,\n      reasoning_effort: reasoningEffort\n    })\n  }\n\n  if (model !== undefined) {\n    return Schema.Struct({ ...TaskToolBaseFields, model })\n  }\n\n  if (reasoningEffort !== undefined) {\n    return Schema.Struct({ ...TaskToolBaseFields, reasoning_effort: reasoningEffort })\n  }\n\n  return Schema.Struct(TaskToolBaseFields)\n}\n\nconst trimmedTaskParams = (params: TaskToolParams): TaskToolParams => ({\n  description: params.description.trim(),\n  prompt: params.prompt.trim(),\n  subagent_type: params.subagent_type.trim(),\n  ...(params.model === undefined ? {} : { model: params.model }),\n  ...(params.reasoning_effort === undefined ? {} : { reasoning_effort: params.reasoning_effort })\n})\n\nconst validateTaskParams = (\n  params: TaskToolParams\n): Effect.Effect<\n  {\n    readonly description: string\n    readonly prompt: string\n    readonly subagent_type: string\n  },\n  ModelVisibleToolError\n> => {\n  const trimmed = trimmedTaskParams(params)\n\n  if (trimmed.description.length === 0) {\n    return Effect.fail(taskModelVisibleError('description must not be empty'))\n  }\n\n  if (trimmed.prompt.length === 0) {\n    return Effect.fail(taskModelVisibleError('prompt must not be empty'))\n  }\n\n  if (trimmed.subagent_type.length === 0) {\n    return Effect.fail(taskModelVisibleError('subagent_type must not be empty'))\n  }\n\n  return Effect.succeed(trimmed)\n}\n\nconst findSubagent = (subagents: ReadonlyArray<TaskSubagentDefinition>, name: string) =>\n  subagents.find(subagent => subagent.name === name)\n\nconst requireKnownSubagent = (\n  subagents: ReadonlyArray<TaskSubagentDefinition>,\n  name: string\n): Effect.Effect<TaskSubagentDefinition, ModelVisibleToolError> => {\n  const subagent = findSubagent(subagents, name)\n\n  return subagent === undefined\n    ? Effect.fail(taskModelVisibleError(`Unknown subagent type: ${name}`))\n    : Effect.succeed(subagent)\n}\n\nconst subagentDescription = (subagent: TaskSubagentDefinition) =>\n  `- ${subagent.name}: ${subagent.description}`\n\nconst modelDescription = (model: TaskModelDefinition) => `- ${model.id}: ${model.description}`\n\nconst reasoningEffortDescription = (effort: TaskReasoningEffortDefinition) =>\n  `- ${effort.value}: ${effort.description}`\n\nconst taskToolDescription = (\n  options: TaskRuntimeSelectionOptions & {\n    readonly subagents: ReadonlyArray<TaskSubagentDefinition>\n  }\n) =>\n  [\n    'Launch a new agent to handle complex, multistep tasks autonomously.',\n    'Use this when delegating focused work to a specialized subagent would save context or allow parallel exploration.',\n    'To run subagents in parallel, call this task tool multiple times in the same assistant response.',\n    'Yolk runs same-turn task calls concurrently automatically.',\n    'A fresh subagent only sees the prompt you provide, so include all required context.',\n    'Subagents can use their normal tools but cannot launch further task subagents in v1.',\n    options.subagents.length === 0\n      ? 'No subagent types are currently available.'\n      : `Available subagent types:\\n${options.subagents.map(subagentDescription).join('\\n')}`,\n    options.models === undefined || options.models.length === 0\n      ? undefined\n      : [\n          'Available subagent models:',\n          options.models.map(modelDescription).join('\\n'),\n          'Omit model to inherit the host runtime model.'\n        ].join('\\n'),\n    options.reasoningEfforts === undefined || options.reasoningEfforts.length === 0\n      ? undefined\n      : [\n          'Available subagent reasoning efforts:',\n          options.reasoningEfforts.map(reasoningEffortDescription).join('\\n'),\n          'Omit reasoning_effort to inherit the host runtime effort.'\n        ].join('\\n')\n  ]\n    .filter(section => section !== undefined)\n    .join('\\n\\n')\n\nexport const makeTaskToolRegistration = <Context>(\n  options: TaskToolOptions<Context>\n): ToolRegistration<Context> =>\n  makeTool({\n    name: taskToolName,\n    description: taskToolDescription(options),\n    parameters: configuredTaskToolParams(options),\n    access: 'read',\n    isEnabled: options.isEnabled,\n    invalidParamsMessage: error =>\n      `Invalid task arguments: ${error instanceof Error ? error.message : String(error)}`,\n    execute: ({ call, context, params }) =>\n      Effect.gen(function* () {\n        if (call.name !== taskToolName) {\n          return yield* Effect.fail(\n            taskToolError(`Tool is not configured: ${call.name}`, 'not_found')\n          )\n        }\n\n        const normalizedParams = yield* validateTaskParams(params)\n        yield* requireKnownSubagent(options.subagents, normalizedParams.subagent_type)\n\n        return yield* options.execute({ call, context, params: normalizedParams })\n      })\n  })\n\nexport const makeTaskToolDef = (\n  subagents: ReadonlyArray<TaskSubagentDefinition>,\n  runtimeSelections: TaskRuntimeSelectionOptions = {}\n) =>\n  makeTaskToolRegistration({\n    subagents,\n    ...runtimeSelections,\n    execute: ({ call }) => Effect.succeed(ToolResult.make({ toolCallId: call.id, content: '' }))\n  }).def\n\nexport const makeTaskToolModule = <Context>(\n  options: TaskToolOptions<Context>\n): ToolModule<Context> => ({\n  id: 'task',\n  tools: [makeTaskToolRegistration(options)]\n})\n\nexport const makeNonRecursiveTaskToolModule = <Context extends TaskSubagentContext>(\n  options: TaskToolOptions<Context>\n): ToolModule<Context> =>\n  makeTaskToolModule({\n    ...options,\n    isEnabled: context =>\n      context.subagent === true\n        ? Effect.succeed(false)\n        : options.isEnabled === undefined\n          ? Effect.succeed(true)\n          : options.isEnabled(context)\n  })\n\nexport const formatTaskResult = (output: string) =>\n  ['<task_result>', output, '</task_result>'].join('\\n')\n\nexport const taskSubagentRunId = makeSubagentRunId\n\nconst latestAssistantText = (messages: ReadonlyArray<AgentMessage>) => {\n  const assistant = [...messages].reverse().find(message => message._tag === 'Assistant')\n\n  return assistant === undefined ? '' : contentText(assistantContent(assistant))\n}\n\nexport const subagentResultText = (events: ReadonlyArray<AgentEvent>) => {\n  const messages = [...events].reverse().find(event => event._tag === 'AgentEnd')?.messages ?? []\n  const text = latestAssistantText(messages).trim()\n\n  return text.length === 0 ? 'Subagent completed without a final text response.' : text\n}\n\nexport const makeTaskToolResult = (input: TaskToolResultInput) =>\n  ToolResult.make({\n    toolCallId: input.callId,\n    content: formatTaskResult(input.output),\n    isError: input.isError,\n    structuredContent: {\n      subagent_run_id: input.subagentRunId,\n      subagent_type: input.subagentType,\n      description: input.description,\n      started_at_ms: input.startedAtMs,\n      ended_at_ms: input.endedAtMs,\n      duration_ms: Math.max(0, input.endedAtMs - input.startedAtMs),\n      status: input.isError === true ? 'error' : 'completed',\n      model: input.model,\n      ...(input.reasoningEffort === undefined ? {} : { reasoning_effort: input.reasoningEffort })\n    }\n  })\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolk-sdk/agent",
-  "version": "0.1.0-canary.52",
+  "version": "0.1.0-canary.53",
   "description": "Protocol, loop, runtime, client, compaction, tools, React, providers, OAuth, skillset, and voice primitives for building Yolk agents.",
   "license": "MIT",
   "type": "module",

package/src/tools/README.md

@@ -51,7 +51,11 @@ aborts, and implementation bugs outside typed tool execution.
 
 `task` is the standard tool for delegating focused work to a subagent. The SDK owns the
 tool schema, validation, event metadata shape, and result formatting. Host apps still own
-execution: model choice, provider layer, prompt, auth, concrete tools, storage, and policy.
+execution: available model/reasoning choices, provider layers, prompts, auth, concrete tools,
+storage, and policy. When choices are configured, the tool exposes optional `model` and
+`reasoning_effort` fields; omission lets the host inherit its current runtime settings. Model ids
+are opaque host values. Reasoning effort values are `minimal`, `low`, `medium`, `high`, and
+`xhigh`.
 
 Use `makeNonRecursiveTaskToolModule` for the top-level agent so nested subagents do not receive
 `task` again:
@@ -77,10 +81,20 @@ const taskToolModule = makeNonRecursiveTaskToolModule<ToolContext>({
     { name: 'general', description: 'Handle complex multi-step work.' },
     { name: 'explore', description: 'Explore code and docs.' }
   ],
+  models: [
+    { id: 'gpt-5.5', description: 'Strong general-purpose model.' },
+    { id: 'fast-model', description: 'Fast model for focused exploration.' }
+  ],
+  reasoningEfforts: [
+    { value: 'medium', description: 'Balanced default for normal exploration.' },
+    { value: 'high', description: 'Use for difficult reasoning.' }
+  ],
   execute: ({ call, context, params }) =>
     Effect.gen(function* () {
       const startedAtMs = yield* Clock.currentTimeMillis
       const subagentRunId = makeSubagentRunId(call.id)
+      const model = params.model ?? 'gpt-5.5'
+      const reasoningEffort = params.reasoning_effort ?? 'medium'
       const subagentToolSet = yield* resolveSubagentToolSet({
         ...context,
         subagent: true
@@ -89,7 +103,8 @@ const taskToolModule = makeNonRecursiveTaskToolModule<ToolContext>({
         messages: [UserMessage.make({ content: params.prompt })],
         systemPrompt: subagentSystemPrompt(params.subagent_type),
         tools: subagentToolSet.tools,
-        model: 'gpt-5.5'
+        model,
+        reasoningEffort
       }).pipe(Stream.runCollect, Effect.provide(makeToolExecutorLayer(subagentToolSet)))
       const endedAtMs = yield* Clock.currentTimeMillis
 
@@ -101,12 +116,17 @@ const taskToolModule = makeNonRecursiveTaskToolModule<ToolContext>({
         subagentRunId,
         startedAtMs,
         endedAtMs,
-        model: 'gpt-5.5'
+        model,
+        reasoningEffort
       })
     })
 })
 ```
 
+Host apps should advertise only runtime choices they can execute. If support depends on the
+selected model, validate the model/reasoning combination before constructing the child provider
+layer and return a model-visible error for unsupported combinations.
+
 Host apps should usually resolve a smaller subagent toolset:
 
 - include read/search tools that help delegated work

package/src/tools/index.ts

@@ -42,6 +42,9 @@ export type {
 export type { QuestionExecutionInput, QuestionToolOptions } from './question.ts'
 export type {
   TaskExecutionInput,
+  TaskModelDefinition,
+  TaskReasoningEffortDefinition,
+  TaskRuntimeSelectionOptions,
   TaskSubagentContext,
   TaskSubagentDefinition,
   TaskToolOptions,

package/src/tools/task.ts

@@ -8,6 +8,7 @@ import {
   ToolResult,
   type AgentEvent,
   type AgentMessage,
+  type AgentReasoningEffort,
   type ToolCall
 } from '@yolk-sdk/agent/protocol'
 import {
@@ -21,7 +22,7 @@ import {
 
 export const taskToolName = 'task'
 
-const TaskToolParams = Schema.Struct({
+const TaskToolBaseFields = {
   description: Schema.String.pipe(
     Schema.annotate({ description: 'A short 3-5 word description of the task.' })
   ),
@@ -34,15 +35,36 @@ const TaskToolParams = Schema.Struct({
   subagent_type: Schema.String.pipe(
     Schema.annotate({ description: 'The specialized subagent type to use for this task.' })
   )
-})
+}
 
-export type TaskToolParams = typeof TaskToolParams.Type
+export type TaskToolParams = {
+  readonly description: string
+  readonly prompt: string
+  readonly subagent_type: string
+  readonly model?: string
+  readonly reasoning_effort?: AgentReasoningEffort
+}
 
 export type TaskSubagentDefinition = {
   readonly name: string
   readonly description: string
 }
 
+export type TaskModelDefinition = {
+  readonly id: string
+  readonly description: string
+}
+
+export type TaskReasoningEffortDefinition = {
+  readonly value: AgentReasoningEffort
+  readonly description: string
+}
+
+export type TaskRuntimeSelectionOptions = {
+  readonly models?: ReadonlyArray<TaskModelDefinition>
+  readonly reasoningEfforts?: ReadonlyArray<TaskReasoningEffortDefinition>
+}
+
 export type TaskSubagentContext = {
   readonly subagent?: boolean
 }
@@ -53,7 +75,7 @@ export type TaskExecutionInput<Context> = {
   readonly params: TaskToolParams
 }
 
-export type TaskToolOptions<Context> = {
+export type TaskToolOptions<Context> = TaskRuntimeSelectionOptions & {
   readonly subagents: ReadonlyArray<TaskSubagentDefinition>
   readonly isEnabled?: (context: Context) => Effect.Effect<boolean, ToolRegistryError>
   readonly execute: (input: TaskExecutionInput<Context>) => Effect.Effect<ToolResult, ToolError>
@@ -68,6 +90,7 @@ export type TaskToolResultInput = {
   readonly startedAtMs: number
   readonly endedAtMs: number
   readonly model: string
+  readonly reasoningEffort?: AgentReasoningEffort
   readonly isError?: boolean
 }
 
@@ -85,10 +108,60 @@ const taskModelVisibleError = (message: string) =>
     reason: 'validation'
   })
 
-const trimmedTaskParams = (params: TaskToolParams) => ({
+const enumRecord = <Value extends string>(
+  values: ReadonlyArray<Value>
+): Readonly<Record<string, Value>> => Object.fromEntries(values.map(value => [value, value]))
+
+const optionalRuntimeSelection = <Value extends string>(input: {
+  readonly values: ReadonlyArray<Value>
+  readonly description: string
+}) =>
+  Schema.optionalKey(
+    Schema.Enum(enumRecord(input.values)).pipe(Schema.annotate({ description: input.description }))
+  )
+
+const configuredTaskToolParams = (options: TaskRuntimeSelectionOptions) => {
+  const model =
+    options.models === undefined || options.models.length === 0
+      ? undefined
+      : optionalRuntimeSelection({
+          values: options.models.map(item => item.id),
+          description: 'Model for this subagent. Omit to inherit the host runtime model.'
+        })
+  const reasoningEffort =
+    options.reasoningEfforts === undefined || options.reasoningEfforts.length === 0
+      ? undefined
+      : optionalRuntimeSelection({
+          values: options.reasoningEfforts.map(item => item.value),
+          description:
+            'Reasoning effort for this subagent. Omit to inherit the host runtime effort.'
+        })
+
+  if (model !== undefined && reasoningEffort !== undefined) {
+    return Schema.Struct({
+      ...TaskToolBaseFields,
+      model,
+      reasoning_effort: reasoningEffort
+    })
+  }
+
+  if (model !== undefined) {
+    return Schema.Struct({ ...TaskToolBaseFields, model })
+  }
+
+  if (reasoningEffort !== undefined) {
+    return Schema.Struct({ ...TaskToolBaseFields, reasoning_effort: reasoningEffort })
+  }
+
+  return Schema.Struct(TaskToolBaseFields)
+}
+
+const trimmedTaskParams = (params: TaskToolParams): TaskToolParams => ({
   description: params.description.trim(),
   prompt: params.prompt.trim(),
-  subagent_type: params.subagent_type.trim()
+  subagent_type: params.subagent_type.trim(),
+  ...(params.model === undefined ? {} : { model: params.model }),
+  ...(params.reasoning_effort === undefined ? {} : { reasoning_effort: params.reasoning_effort })
 })
 
 const validateTaskParams = (
@@ -135,7 +208,16 @@ const requireKnownSubagent = (
 const subagentDescription = (subagent: TaskSubagentDefinition) =>
   `- ${subagent.name}: ${subagent.description}`
 
-const taskToolDescription = (subagents: ReadonlyArray<TaskSubagentDefinition>) =>
+const modelDescription = (model: TaskModelDefinition) => `- ${model.id}: ${model.description}`
+
+const reasoningEffortDescription = (effort: TaskReasoningEffortDefinition) =>
+  `- ${effort.value}: ${effort.description}`
+
+const taskToolDescription = (
+  options: TaskRuntimeSelectionOptions & {
+    readonly subagents: ReadonlyArray<TaskSubagentDefinition>
+  }
+) =>
   [
     'Launch a new agent to handle complex, multistep tasks autonomously.',
     'Use this when delegating focused work to a specialized subagent would save context or allow parallel exploration.',
@@ -143,18 +225,34 @@ const taskToolDescription = (subagents: ReadonlyArray<TaskSubagentDefinition>) =
     'Yolk runs same-turn task calls concurrently automatically.',
     'A fresh subagent only sees the prompt you provide, so include all required context.',
     'Subagents can use their normal tools but cannot launch further task subagents in v1.',
-    subagents.length === 0
+    options.subagents.length === 0
       ? 'No subagent types are currently available.'
-      : `Available subagent types:\n${subagents.map(subagentDescription).join('\n')}`
-  ].join('\n\n')
+      : `Available subagent types:\n${options.subagents.map(subagentDescription).join('\n')}`,
+    options.models === undefined || options.models.length === 0
+      ? undefined
+      : [
+          'Available subagent models:',
+          options.models.map(modelDescription).join('\n'),
+          'Omit model to inherit the host runtime model.'
+        ].join('\n'),
+    options.reasoningEfforts === undefined || options.reasoningEfforts.length === 0
+      ? undefined
+      : [
+          'Available subagent reasoning efforts:',
+          options.reasoningEfforts.map(reasoningEffortDescription).join('\n'),
+          'Omit reasoning_effort to inherit the host runtime effort.'
+        ].join('\n')
+  ]
+    .filter(section => section !== undefined)
+    .join('\n\n')
 
 export const makeTaskToolRegistration = <Context>(
   options: TaskToolOptions<Context>
 ): ToolRegistration<Context> =>
   makeTool({
     name: taskToolName,
-    description: taskToolDescription(options.subagents),
-    parameters: TaskToolParams,
+    description: taskToolDescription(options),
+    parameters: configuredTaskToolParams(options),
     access: 'read',
     isEnabled: options.isEnabled,
     invalidParamsMessage: error =>
@@ -174,9 +272,13 @@ export const makeTaskToolRegistration = <Context>(
       })
   })
 
-export const makeTaskToolDef = (subagents: ReadonlyArray<TaskSubagentDefinition>) =>
+export const makeTaskToolDef = (
+  subagents: ReadonlyArray<TaskSubagentDefinition>,
+  runtimeSelections: TaskRuntimeSelectionOptions = {}
+) =>
   makeTaskToolRegistration({
     subagents,
+    ...runtimeSelections,
     execute: ({ call }) => Effect.succeed(ToolResult.make({ toolCallId: call.id, content: '' }))
   }).def
 
@@ -231,6 +333,7 @@ export const makeTaskToolResult = (input: TaskToolResultInput) =>
       ended_at_ms: input.endedAtMs,
       duration_ms: Math.max(0, input.endedAtMs - input.startedAtMs),
       status: input.isError === true ? 'error' : 'completed',
-      model: input.model
+      model: input.model,
+      ...(input.reasoningEffort === undefined ? {} : { reasoning_effort: input.reasoningEffort })
     }
   })