@gajae-code/coding-agent 0.18.0 → 0.18.1

package/src/tools/eval-backends.ts

@@ -0,0 +1,95 @@
+/**
+ * Eval backend allowance (`GJC_PY`, legacy `PI_PY` / `PI_JS`, then `eval.py` / `eval.js` settings).
+ * Kept out of the tools index so lightweight modules, such as the pre-load tool descriptions, can
+ * resolve it without importing the whole registry.
+ */
+import { $env } from "@gajae-code/utils";
+import type { ToolSession } from ".";
+
+export interface EvalBackendsAllowance {
+	python: boolean;
+	js: boolean;
+}
+
+/**
+ * Parse the `GJC_PY` multi-value token into per-backend booleans.
+ *
+ * Tokens (case-insensitive):
+ * - `0` / `bash` → JavaScript only (`{ py: false, js: true }`)
+ * - `1` / `py`   → Python only (`{ py: true, js: false }`)
+ * - `js`         → JavaScript only (`{ py: false, js: true }`)
+ * - `mix` / `both` → both backends (`{ py: true, js: true }`)
+ *
+ * Returns `null` when `GJC_PY` is unset, empty, or holds an unrecognized
+ * token, so the caller can fall back to the legacy `PI_PY` / `PI_JS` flags or
+ * per-key settings. This matches the documented contract that invalid values
+ * are ignored.
+ */
+export function parseGjcPy(env: Record<string, string | undefined>): { py: boolean; js: boolean } | null {
+	const raw = env.GJC_PY;
+	if (raw === undefined) return null;
+	const token = raw.trim().toLowerCase();
+	if (token === "") return null;
+	switch (token) {
+		case "0":
+		case "bash":
+			return { py: false, js: true };
+		case "1":
+		case "py":
+			return { py: true, js: false };
+		case "js":
+			return { py: false, js: true };
+		case "mix":
+		case "both":
+			return { py: true, js: true };
+		default:
+			return null;
+	}
+}
+
+function isTruthyPythonFlag(value: string | undefined): boolean {
+	return value !== undefined && ["1", "true", "yes", "on", "y"].includes(value.trim().toLowerCase());
+}
+
+/**
+ * Parse legacy `PI_PY` / `PI_JS` boolean flags. Each is a boolean flag; unset
+ * means "not specified, defer to settings". Returns `null` when neither is set
+ * so the caller can fall through to `readEvalBackendsAllowance` per key.
+ */
+function parseLegacyEvalEnvFlags(env: Record<string, string | undefined>): EvalBackendsAllowance | null {
+	const pyEnv = env.PI_PY;
+	const jsEnv = env.PI_JS;
+	if (pyEnv === undefined && jsEnv === undefined) return null;
+	return {
+		python: pyEnv === undefined ? true : isTruthyPythonFlag(pyEnv),
+		js: jsEnv === undefined ? true : isTruthyPythonFlag(jsEnv),
+	};
+}
+
+/**
+ * Resolve eval-backend allowance from environment only. `GJC_PY` wins when set
+ * to a recognized token; otherwise the legacy `PI_PY` / `PI_JS` flags apply.
+ * Returns `null` when no env override is set so the caller can defer to settings.
+ */
+export function resolveEvalBackendsFromEnv(env: Record<string, string | undefined>): EvalBackendsAllowance | null {
+	const gjc = parseGjcPy(env);
+	if (gjc) return { python: gjc.py, js: gjc.js };
+	return parseLegacyEvalEnvFlags(env);
+}
+
+/** Read per-backend allowance from settings (defaults true). */
+export function readEvalBackendsAllowance(session: ToolSession): EvalBackendsAllowance {
+	return {
+		python: session.settings.get("eval.py") ?? true,
+		js: session.settings.get("eval.js") ?? true,
+	};
+}
+
+/**
+ * Materialize the active eval backend allowance. `GJC_PY` takes precedence
+ * over the legacy `PI_PY` / `PI_JS` env flags, which in turn override the
+ * per-key settings (defaults true). When no env override is set, settings win.
+ */
+export function resolveEvalBackends(session: ToolSession): EvalBackendsAllowance {
+	return resolveEvalBackendsFromEnv($env) ?? readEvalBackendsAllowance(session);
+}

package/src/tools/eval.ts

@@ -2,7 +2,6 @@ import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallb
 import type { ImageContent } from "@gajae-code/ai/core";
 import type { Component } from "@gajae-code/tui";
 import { Markdown, Text } from "@gajae-code/tui";
-import { prompt } from "@gajae-code/utils";
 import * as z from "zod/v4";
 import { jsBackend, pythonBackend } from "../eval";
 import type { ExecutorBackend } from "../eval/backend";
@@ -10,7 +9,6 @@ import type { EvalCellResult, EvalDisplayOutput, EvalLanguage, EvalStatusEvent,
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import { truncateToVisualLines } from "../modes/components/visual-truncate";
 import { getMarkdownTheme, type Theme } from "../modes/theme/theme";
-import evalDescription from "../prompts/tools/eval.md" with { type: "text" };
 import { DEFAULT_MAX_BYTES, OutputSink, type OutputSummary, TailBuffer } from "../session/streaming-output";
 import { getTreeBranch, getTreeContinuePrefix, renderCodeCell } from "../tui";
 import { resolveEvalBackends, type ToolSession } from ".";
@@ -21,6 +19,7 @@ import {
 	stripOutputNotice,
 } from "./output-meta";
 import { formatTitle, replaceTabs, shortenPath, truncateToWidth, wrapBrackets } from "./render-utils";
+import { evalToolDescriptionForSession } from "./session-descriptions";
 import { ToolAbortError, ToolError } from "./tool-errors";
 import { toolResult } from "./tool-result";
 import { clampTimeout } from "./tool-timeouts";
@@ -134,16 +133,7 @@ function renderJsonTree(value: unknown, theme: Theme, expanded: boolean, maxDept
 	return renderNode(value, "", 0, true);
 }
 
-export interface EvalToolDescriptionOptions {
-	py?: boolean;
-	js?: boolean;
-}
-
-export function getEvalToolDescription(options: EvalToolDescriptionOptions = {}): string {
-	const py = options.py ?? true;
-	const js = options.js ?? true;
-	return prompt.render(evalDescription, { py, js });
-}
+export { type EvalToolDescriptionOptions, getEvalToolDescription } from "./session-descriptions";
 
 export interface EvalToolOptions {
 	proxyExecutor?: EvalProxyExecutor;
@@ -204,9 +194,7 @@ export class EvalTool implements AgentTool<typeof evalSchema> {
 	readonly loadMode = "discoverable";
 	readonly label = "Eval";
 	get description(): string {
-		if (!this.session) return getEvalToolDescription();
-		const backends = resolveEvalBackends(this.session);
-		return getEvalToolDescription({ py: backends.python, js: backends.js });
+		return evalToolDescriptionForSession(this.session);
 	}
 	readonly parameters = evalSchema;
 	readonly concurrency = "exclusive";

package/src/tools/index.ts

@@ -1,6 +1,6 @@
 import type { AgentTelemetryConfig, AgentTool } from "@gajae-code/agent-core";
 import type { Model, ServiceTier, ToolChoice } from "@gajae-code/ai/core";
-import { $env, logger } from "@gajae-code/utils";
+import { logger } from "@gajae-code/utils";
 import type { AsyncJobManager, FoldReason } from "../async";
 import type { PromptTemplate } from "../config/prompt-templates";
 import type { Settings } from "../config/settings";
@@ -37,6 +37,7 @@ import {
 	resolveEffectiveDiscoveryMode,
 	type ToolAvailabilityContext,
 } from "./descriptors";
+import { resolveEvalBackends } from "./eval-backends";
 import { wrapToolWithMetaNotice } from "./output-meta";
 import type { TodoPhase } from "./todo-write";
 
@@ -491,93 +492,13 @@ const GOAL_MODE_TOOL_NAMES = [] as const;
 
 export type ToolName = keyof typeof BUILTIN_TOOLS;
 
-export interface EvalBackendsAllowance {
-	python: boolean;
-	js: boolean;
-}
-
-/**
- * Parse the `GJC_PY` multi-value token into per-backend booleans.
- *
- * Tokens (case-insensitive):
- * - `0` / `bash` → JavaScript only (`{ py: false, js: true }`)
- * - `1` / `py`   → Python only (`{ py: true, js: false }`)
- * - `js`         → JavaScript only (`{ py: false, js: true }`)
- * - `mix` / `both` → both backends (`{ py: true, js: true }`)
- *
- * Returns `null` when `GJC_PY` is unset, empty, or holds an unrecognized
- * token, so the caller can fall back to the legacy `PI_PY` / `PI_JS` flags or
- * per-key settings. This matches the documented contract that invalid values
- * are ignored.
- */
-export function parseGjcPy(env: Record<string, string | undefined>): { py: boolean; js: boolean } | null {
-	const raw = env.GJC_PY;
-	if (raw === undefined) return null;
-	const token = raw.trim().toLowerCase();
-	if (token === "") return null;
-	switch (token) {
-		case "0":
-		case "bash":
-			return { py: false, js: true };
-		case "1":
-		case "py":
-			return { py: true, js: false };
-		case "js":
-			return { py: false, js: true };
-		case "mix":
-		case "both":
-			return { py: true, js: true };
-		default:
-			return null;
-	}
-}
-
-function isTruthyPythonFlag(value: string | undefined): boolean {
-	return value !== undefined && ["1", "true", "yes", "on", "y"].includes(value.trim().toLowerCase());
-}
-
-/**
- * Parse legacy `PI_PY` / `PI_JS` boolean flags. Each is a boolean flag; unset
- * means "not specified, defer to settings". Returns `null` when neither is set
- * so the caller can fall through to `readEvalBackendsAllowance` per key.
- */
-function parseLegacyEvalEnvFlags(env: Record<string, string | undefined>): EvalBackendsAllowance | null {
-	const pyEnv = env.PI_PY;
-	const jsEnv = env.PI_JS;
-	if (pyEnv === undefined && jsEnv === undefined) return null;
-	return {
-		python: pyEnv === undefined ? true : isTruthyPythonFlag(pyEnv),
-		js: jsEnv === undefined ? true : isTruthyPythonFlag(jsEnv),
-	};
-}
-
-/**
- * Resolve eval-backend allowance from environment only. `GJC_PY` wins when set
- * to a recognized token; otherwise the legacy `PI_PY` / `PI_JS` flags apply.
- * Returns `null` when no env override is set so the caller can defer to settings.
- */
-export function resolveEvalBackendsFromEnv(env: Record<string, string | undefined>): EvalBackendsAllowance | null {
-	const gjc = parseGjcPy(env);
-	if (gjc) return { python: gjc.py, js: gjc.js };
-	return parseLegacyEvalEnvFlags(env);
-}
-
-/** Read per-backend allowance from settings (defaults true). */
-export function readEvalBackendsAllowance(session: ToolSession): EvalBackendsAllowance {
-	return {
-		python: session.settings.get("eval.py") ?? true,
-		js: session.settings.get("eval.js") ?? true,
-	};
-}
-
-/**
- * Materialize the active eval backend allowance. `GJC_PY` takes precedence
- * over the legacy `PI_PY` / `PI_JS` env flags, which in turn override the
- * per-key settings (defaults true). When no env override is set, settings win.
- */
-export function resolveEvalBackends(session: ToolSession): EvalBackendsAllowance {
-	return resolveEvalBackendsFromEnv($env) ?? readEvalBackendsAllowance(session);
-}
+export {
+	type EvalBackendsAllowance,
+	parseGjcPy,
+	readEvalBackendsAllowance,
+	resolveEvalBackends,
+	resolveEvalBackendsFromEnv,
+} from "./eval-backends";
 
 /**
  * Create tools from the descriptor registry.

package/src/tools/search.ts

@@ -5,12 +5,10 @@ import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallb
 import type { GrepMatch, GrepResult, grep as grepFn } from "@gajae-code/natives";
 import type { Component } from "@gajae-code/tui";
 import { Text } from "@gajae-code/tui";
-import { prompt } from "@gajae-code/utils";
 import * as z from "zod/v4";
 import { getFileReadCache } from "../edit/file-read-cache";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import type { Theme } from "../modes/theme/theme";
-import searchDescription from "../prompts/tools/search.md" with { type: "text" };
 import { DEFAULT_MAX_COLUMN, type TruncationResult, truncateHead } from "../session/streaming-output";
 import { Ellipsis, fileHyperlink, renderStatusLine, renderTreeList, truncateToWidth } from "../tui";
 import { resolveFileDisplayMode } from "../utils/file-display-mode";
@@ -35,6 +33,7 @@ import {
 	PREVIEW_LIMITS,
 	splitGroupsByBlankLine,
 } from "./render-utils";
+import { searchToolDescriptionForSession } from "./session-descriptions";
 import { ToolAbortError, ToolError } from "./tool-errors";
 import { toolResult } from "./tool-result";
 
@@ -259,11 +258,7 @@ export class SearchTool implements AgentTool<typeof searchSchema, SearchToolDeta
 	readonly loadMode = "discoverable";
 	readonly summary = "Search file contents using ripgrep (fast text search)";
 	get description(): string {
-		const displayMode = resolveFileDisplayMode(this.session);
-		return prompt.render(searchDescription, {
-			IS_HL_MODE: displayMode.hashLines,
-			IS_LINE_NUMBER_MODE: !displayMode.hashLines && displayMode.lineNumbers,
-		});
+		return searchToolDescriptionForSession(this.session);
 	}
 	readonly parameters = searchSchema;
 	readonly strict = true;

package/src/tools/session-descriptions.ts

@@ -0,0 +1,135 @@
+/**
+ * Session-dependent descriptions for tools whose prompt text varies with session settings.
+ *
+ * A discoverable tool is advertised before its implementation loads. The facade renders these
+ * descriptions from the session itself, so the text sent before the first call is the text the
+ * loaded tool reports afterwards, and the provider-visible `tools` block (and with it the
+ * prompt-cache prefix) does not change when the implementation loads (#5992).
+ */
+import { parseFrontmatter, prompt } from "@gajae-code/utils";
+import architectAgent from "../prompts/agents/architect.md" with { type: "text" };
+import criticAgent from "../prompts/agents/critic.md" with { type: "text" };
+import executorAgent from "../prompts/agents/executor.md" with { type: "text" };
+import plannerAgent from "../prompts/agents/planner.md" with { type: "text" };
+import evalDescription from "../prompts/tools/eval.md" with { type: "text" };
+import searchDescription from "../prompts/tools/search.md" with { type: "text" };
+import taskDescription from "../prompts/tools/task.md" with { type: "text" };
+import { getTaskSimpleModeCapabilities, type TaskSimpleMode } from "../task/simple-mode";
+import { getTaskSchema, type TaskToolSchemaInstance } from "../task/types";
+import { resolveFileDisplayMode } from "../utils/file-display-mode";
+import { resolveEvalBackends } from "./eval-backends";
+
+interface DescriptionSettings {
+	get(
+		key:
+			| "task.maxConcurrency"
+			| "task.isolation.mode"
+			| "task.simple"
+			| "task.disabledAgents"
+			| "eval.py"
+			| "eval.js"
+			| "readLineNumbers"
+			| "readHashLines"
+			| "edit.mode",
+	): unknown;
+	getEffectiveAutorouting(): { active: boolean };
+}
+
+interface DescriptionSession {
+	settings: DescriptionSettings;
+	getSessionSpawns?: () => string | null;
+	hasEditTool?: boolean;
+}
+
+interface BundledAgentName {
+	name: string;
+	hide?: boolean;
+}
+
+function parseBundledAgentName(markdown: string): BundledAgentName {
+	const { frontmatter } = parseFrontmatter(markdown, { level: "fatal" });
+	const { name, hide } = frontmatter;
+	if (typeof name !== "string") {
+		throw new Error("Bundled task agent frontmatter must include a name");
+	}
+	return { name, hide: hide === true };
+}
+
+// Read only each role's frontmatter; importing task/agents would also load and render the full prompts.
+const BUNDLED_AGENT_NAMES = [
+	parseBundledAgentName(executorAgent),
+	parseBundledAgentName(architectAgent),
+	parseBundledAgentName(plannerAgent),
+	parseBundledAgentName(criticAgent),
+];
+
+export interface EvalToolDescriptionOptions {
+	py?: boolean;
+	js?: boolean;
+}
+
+export function getEvalToolDescription(options: EvalToolDescriptionOptions = {}): string {
+	const py = options.py ?? true;
+	const js = options.js ?? true;
+	return prompt.render(evalDescription, { py, js });
+}
+
+export function evalToolDescriptionForSession(session: DescriptionSession | null | undefined): string {
+	if (!session) return getEvalToolDescription();
+	const backends = resolveEvalBackends({ settings: session.settings } as Parameters<typeof resolveEvalBackends>[0]);
+	return getEvalToolDescription({ py: backends.python, js: backends.js });
+}
+
+export function searchToolDescriptionForSession(session: DescriptionSession): string {
+	const displayMode = resolveFileDisplayMode(session);
+	return prompt.render(searchDescription, {
+		IS_HL_MODE: displayMode.hashLines,
+		IS_LINE_NUMBER_MODE: !displayMode.hashLines && displayMode.lineNumbers,
+	});
+}
+
+export function renderTaskDescription(session: DescriptionSession): string {
+	const simpleMode = session.settings.get("task.simple") as TaskSimpleMode;
+	const { contextEnabled, customSchemaEnabled } = getTaskSimpleModeCapabilities(simpleMode);
+	const isolationMode = session.settings.get("task.isolation.mode");
+	const parentSpawns = session.getSessionSpawns?.() ?? "*";
+	const spawningDisabled = parentSpawns === "";
+	const disabledSetting = session.settings.get("task.disabledAgents");
+	const disabledAgents = Array.isArray(disabledSetting)
+		? disabledSetting.filter((agent): agent is string => typeof agent === "string")
+		: [];
+	const allowedSpawns =
+		parentSpawns === "*"
+			? undefined
+			: new Set(
+					parentSpawns
+						.split(",")
+						.map(agent => agent.trim())
+						.filter(Boolean),
+				);
+	const agents = BUNDLED_AGENT_NAMES.filter(
+		agent =>
+			agent.hide !== true &&
+			!disabledAgents.includes(agent.name) &&
+			(allowedSpawns === undefined || allowedSpawns.has(agent.name)),
+	);
+	return prompt.render(taskDescription, {
+		agents: agents.map(({ name }) => ({ name })),
+		spawningDisabled,
+		MAX_CONCURRENCY: session.settings.get("task.maxConcurrency"),
+		isolationEnabled: isolationMode !== "none",
+		asyncEnabled: true,
+		contextEnabled,
+		customSchemaEnabled,
+		defaultMode: simpleMode === "default",
+		schemaFreeMode: simpleMode === "schema-free",
+		independentMode: simpleMode === "independent",
+		autoroutingActive: session.settings.getEffectiveAutorouting().active,
+	});
+}
+
+export function taskParametersForSession(session?: DescriptionSession): TaskToolSchemaInstance {
+	const simpleMode = session ? (session.settings.get("task.simple") as TaskSimpleMode) : "default";
+	const isolationMode = session?.settings.get("task.isolation.mode");
+	return getTaskSchema({ isolationEnabled: session !== undefined && isolationMode !== "none", simpleMode });
+}

package/src/tools/tool-catalog.generated.ts

@@ -2095,7 +2095,7 @@ export const TOOL_CATALOG: Readonly<Record<string, ToolCatalogEntry>> = {
 	"task": {
 		"name": "task",
 		"label": "Task",
-		"description": "Launches subagents to parallelize workflows.\n\n- Results are delivered automatically when complete.\n- The tool result lists the assigned task ids (e.g. `0-AuthLoader`) — those are the live agent ids.\n- Use `subagent` action `inspect` or `list` to snapshot manager state.\n- To wait or cancel, use the `subagent` tool; its await/cancel doctrine is authoritative.\n\nSubagents have no conversation history. Every fact, file path, and direction they need MUST be explicit in `context` or `assignment`.\n\n<parameters>\n- `agent`: agent type for all tasks\n- `tasks`: tasks to execute in parallel\n - `.id`: filesystem-safe, ≤48 chars, matching `[A-Za-z0-9][A-Za-z0-9_-]*`; prefer CamelCase\n - `.description`: UI label only — subagent never sees it\n - `.assignment`: complete self-contained instructions; one-liners and missing acceptance criteria are PROHIBITED\n- `context`: shared background prepended to every assignment; session-specific only\n- `.inheritContext` (optional): fork-context mode for seeding the subagent with sanitized parent conversation. Omit it or set `\"none\"` for no copied context. `\"receipt\"` copies a minimal receipt-sized snapshot, `\"last-turn\"` copies only the latest exchange, `\"bounded\"` copies the bounded default snapshot, and `\"full\"` copies a larger snapshot up to the configured/model token cap. Non-`none` modes work only when global `task.forkContext.enabled` is true and the target agent declares `forkContext: allowed`; otherwise the call is rejected. Bundled agents that support it: `executor`, `architect`. Use inherited context only when the subagent's value depends on parent context; cloned tokens are billed to the child as fresh input and surfaced in task receipts as fork-context cloned-token accounting.\n\n- `schema`: JTD schema for expected structured output (do not put format rules in assignments)\n- `spawnPlan` (optional): required before any batch with more than 4 tasks; include whyParallel, whyNotLocal, independence, expectedReceiptShape, and maxInlineTokens.\n\n- `repositoryBinding`: optional authoritative repository/worktree identity. It must match the active session and cannot authorize a foreign repository from this session. For another approved repository, start a fresh session rooted there (for example, `gjc --cwd <approved-worktree>`); do not use `/move` because materialized tasks retain their original binding.\n</parameters>\n\n<rules>\n- HARD runtime gate: calls with more than 4 tasks are rejected before any child launches unless `spawnPlan` is complete.\n- NEVER assign tasks to run project-wide build/test/lint. Caller verifies after the batch.\n- **Subagents do not verify, lint, or format.** Every assignment MUST instruct the subagent to skip all gates and formatters. You run them once at the end across the union of changed files — avoids redundant runs and racing formatter passes.\n- Each task: ≤3–5 explicit files. No globs, no \"update all\", no package-wide scope. Fan out to a cluster instead.\n- Pass large payloads via `local://<path>` URIs, not inline.\n- Put shared constraints in `context` once; do not duplicate across assignments.\n- Prefer agents that investigate **and** edit in one pass; only spin a read-only discovery step when affected files are genuinely unknown.\n</rules>\n\n<parallelization>\nTest: can task B run correctly without seeing A's output? If no, sequence A → B.\nSequential when one task produces a contract (types, API, schema, core module) the other consumes.\nParallel when tasks touch disjoint files or are independent refactors/tests.\n</parallelization>\n\n<context-fmt>\n# Goal         ← one sentence: what the batch accomplishes\n# Constraints  ← MUST/NEVER rules and session decisions\n# Contract     ← exact types/signatures if tasks share an interface\n</context-fmt>\n\n<assignment-fmt>\n# Target       ← exact files and symbols; explicit non-goals\n# Change       ← step-by-step add/remove/rename; APIs and patterns\n# Acceptance   ← observable result; no project-wide commands\n</assignment-fmt>\n\n<agents>\n# executor\nAutonomous implementation agent for bounded code changes, fixes, and verification-ready edits\n\n# architect\nRead-only architecture and code-review agent with severity-rated findings and status verdicts\n\n# planner\nRead-only planning agent for sequencing, acceptance criteria, risks, and handoff shape\n\n# critic\nRead-only plan critic that approves only actionable, verifiable execution plans\n</agents>",
+		"description": "Launches subagents to parallelize workflows.\n\n- Results are delivered automatically when complete.\n- The tool result lists the assigned task ids (e.g. `0-AuthLoader`) — those are the live agent ids.\n- Coordinate with running tasks via `irc` when available, using those ids. `subagent` cancel terminates a task and **cannot carry a message**.\n- Use `subagent` action `inspect` or `list` to snapshot manager state.\n- To wait or cancel, use the `subagent` tool; its await/cancel doctrine is authoritative.\n\nSubagents have no conversation history. Every fact, file path, and direction they need MUST be explicit in `context` or `assignment`.\nUse `irc` for live coordination when it is available.\n\n<parameters>\n- `agent`: agent type for all tasks\n- `tasks`: tasks to execute in parallel\n - `.id`: filesystem-safe, ≤48 chars, matching `[A-Za-z0-9][A-Za-z0-9_-]*`; prefer CamelCase\n - `.description`: UI label only — subagent never sees it\n - `.assignment`: complete self-contained instructions; one-liners and missing acceptance criteria are PROHIBITED\n- `context`: shared background prepended to every assignment; session-specific only\n- `.inheritContext` (optional): fork-context mode for seeding the subagent with sanitized parent conversation. Omit it or set `\"none\"` for no copied context. `\"receipt\"` copies a minimal receipt-sized snapshot, `\"last-turn\"` copies only the latest exchange, `\"bounded\"` copies the bounded default snapshot, and `\"full\"` copies a larger snapshot up to the configured/model token cap. Non-`none` modes work only when global `task.forkContext.enabled` is true and the target agent declares `forkContext: allowed`; otherwise the call is rejected. Bundled agents that support it: `executor`, `architect`. Use inherited context only when the subagent's value depends on parent context; cloned tokens are billed to the child as fresh input and surfaced in task receipts as fork-context cloned-token accounting.\n\n- `schema`: JTD schema for expected structured output (do not put format rules in assignments)\n- `spawnPlan` (optional): required before any batch with more than 4 tasks; include whyParallel, whyNotLocal, independence, expectedReceiptShape, and maxInlineTokens.\n\n- `repositoryBinding`: optional authoritative repository/worktree identity. It must match the active session and cannot authorize a foreign repository from this session. For another approved repository, start a fresh session rooted there (for example, `gjc --cwd <approved-worktree>`); do not use `/move` because materialized tasks retain their original binding.\n</parameters>\n\n<rules>\n- HARD runtime gate: calls with more than 4 tasks are rejected before any child launches unless `spawnPlan` is complete.\n- NEVER assign tasks to run project-wide build/test/lint. Caller verifies after the batch.\n- **Subagents do not verify, lint, or format.** Every assignment MUST instruct the subagent to skip all gates and formatters. You run them once at the end across the union of changed files — avoids redundant runs and racing formatter passes.\n- Each task: ≤3–5 explicit files. No globs, no \"update all\", no package-wide scope. Use `irc` to coordinate overlapping work when it is available; otherwise keep file sets independent.\n- Pass large payloads via `local://<path>` URIs, not inline.\n- Put shared constraints in `context` once; do not duplicate across assignments.\n- Prefer agents that investigate **and** edit in one pass; only spin a read-only discovery step when affected files are genuinely unknown.\n</rules>\n\n<parallelization>\nTest: can task B run correctly without seeing A's output? If no, sequence A → B, unless `irc` is available and A can answer a small clarification.\nStill sequence when one task produces a large, evolving contract (generated types, schema migration, core module API); live coordination is not a substitute for a finished contract.\nParallel when tasks touch disjoint files, are independent refactors/tests, or need only occasional peer clarification.\n</parallelization>\n\n<context-fmt>\n# Goal         ← one sentence: what the batch accomplishes\n# Constraints  ← MUST/NEVER rules and session decisions\n# Contract     ← exact types/signatures if tasks share an interface\n</context-fmt>\n\n<assignment-fmt>\n# Target       ← exact files and symbols; explicit non-goals\n# Change       ← step-by-step add/remove/rename; APIs and patterns\n# Acceptance   ← observable result; no project-wide commands\n</assignment-fmt>\n\n<agents>\nBundled role names: executor, architect, planner, critic. A configured agent may override a bundled role name and takes precedence.\nOther configured agents (project, user, plugin) may also be available; calling with an unknown `agent` lists the agents callable in this session.\n</agents>",
 		"parameters": {
 			"type": "object",
 			"properties": {