pi-subagents 0.69.0 → 0.70.0

package/src/extension/tool-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-description.d.ts","sourceRoot":"","sources":["../../../src/extension/tool-description.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAQ/E,eAAO,MAAM,wBAAwB,48FAUmK,CAAC;AAQzM,eAAO,MAAM,iCAAiC,m5JAAyD,CAAC;AAExG,eAAO,MAAM,4BAA4B,qGAAqG,CAAC;AAC/I,eAAO,MAAM,+BAA+B,UAE3C,CAAC;AAEF,eAAO,MAAM,iCAAiC,m5JAAoC,CAAC;AAEnF,eAAO,MAAM,8BAA8B,srMAMsd,CAAC;AAUlgB,MAAM,WAAW,sBAAsB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,+BAA+B,CAAC,MAAM,GAAE,IAAI,CAAC,eAAe,EAAE,qBAAqB,CAAM,GAAG,0BAA0B,CAMrI;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,qBAAqB,CAAC,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,mBAAmB,CAMtJ;AAkFD,wBAAgB,4BAA4B,CAAC,MAAM,GAAE,IAAI,CAAC,eAAe,EAAE,qBAAqB,CAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAchJ"}

package/src/extension/tool-description.js

@@ -0,0 +1,160 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getAgentDir, getProjectConfigDir } from "../shared/utils.js";
+const CUSTOM_TOOL_DESCRIPTION_FILE = "subagent-tool-description.md";
+const CUSTOM_TOOL_DESCRIPTION_MAX_BYTES = 50 * 1024;
+const AGENT_SELECTION_GUIDANCE = 'First call {action:"list",capabilities:true}: executable, non-disabled agents only; external-cli requires runner.available === true. Passive PATH/PATHEXT/X_OK is not authentication/version/launch proof; preflight is authoritative.';
+const SUBAGENT_FAILURE_RECOVERY_GUIDANCE = "Workflow, child launch, prompt runtime, extension load or child tooling failure is a lane infrastructure blocker. Stop; report exact failure, run/status and repo/cwd/worktree/branch/ref; verify clean worktree or capture partial diff before same-protocol retry or asking the owner. Never silently switch to interactive_shell, pi -ne, Codex/Claude/Cursor CLI or foreground/external mode: governed-workflow fallback requires explicit owner approval, not Pi core's generic pi -ne hint. Explicit foreground/CLI requests and work outside that protocol remain valid.";
+export const SUBAGENT_SAFETY_GUIDANCE = `SAFETY-CRITICAL SUBAGENT GUIDANCE:
+• Direct parent execution is the default. Invoke subagents only when delegation is authorized by the operator's current request or applicable user/project instructions; task size, complexity, risk, tool-call count, or recipe fit do not independently authorize delegation.
+• ${AGENT_SELECTION_GUIDANCE}
+• ${SUBAGENT_FAILURE_RECOVERY_GUIDANCE}
+• Omit action for execution. For an authorized delegated multi-step/parallel workflow: exactly one top-level subagent workflow call with async:true; children launch only inside it.
+• Async follows asyncByDefault (normally true); async:false only to block the parent, not for final reviews/gates. Consume results at dependency barriers. Native async completion wakes this session: return control, no sleep/poll or bg_wait merely for a wake. bg_wait is for provider/detached work without native notification needing a same-turn result.
+• Ordinary child subagents are not orchestrators; only configured fanout within depth/session limits. For an authorized delegated workflow, keep one writer per cwd/worktree and isolate concurrent writers. Use fresh-context read-only reviewers when independent review was requested, then parent synthesis/fixes. Oracle/advisor unknowns use supervisor dialogue; one-shot only when requested.
+• Bind durable output on runs.run/runs.all, not task filename prose; return actual outputReference/outputPathMapping/artifactPaths, evidence and residual risks.
+• children.list: resume only resumable rows. {action:"resume",id,message} detaches a follow-up/challenge with stored agent/model/tool contract. If none is resumable, label a same-role fallback challenge. Scripts await runs.run(newKey,{resume:runId,task}); continue from latest returned runId. Each distinct resume pass needs a new stable key; same-key reuse requires identical launch parameters.
+• Named resources own authority; raw workflowScript/workflowScriptPath cannot use runs.host. Granted commands/relative outputs use workflow cwd, never per-step cwd.
+• Inspect asyncId/asyncDir (status.json, events.jsonl, logs) with status/debug.run; control with interrupt/stop/resume/steer. Read {action:"guide",topic:"tool-reference"} for controls/evidence gates.`;
+const EXECUTION_GUIDANCE = `Delegate one child with {agent,task?}; otherwise choose exactly one of {workflowScript,args?}, {workflowScriptPath,args?} or {workflow,args}. agent/task exclude workflow inputs; task excludes action. agent may target management actions. action is management/control; validate accepts either script without launching. workflowScriptPath loads from request cwd before sandbox execution.
+Scripts: JavaScript statement bodies with explicit return, top-level await, plain helpers/Promise chains; nested async function/arrow/method helpers are rejected. Await runs.run('key',{agent,task}) before .output; await runs.all([{key,agent,task},...]) for an ordered array, not a key map. Observe every stored run promise with direct await, Promise.race or Promise.all. Await/return runs.steer(key,message,options?) for a prior key, never raw run ids; queued/delivered/missed/failed receipts are not compliance proof.
+Before advanced orchestration (runs.lanes, rolling fanout, mission state, handoffs), read {action:"guide",topic:"workflows"} or the pi-subagents skill. Raw-script sandboxes add deeply frozen args; all sandboxes provide runs, emit, console, JavaScript and enabled mission state, with no filesystem/shell/Pi tools/host globals. External CLI agents support native options only when their runner declares them; read guide tool-reference before passing model, structured output, acceptance/agentContract, tool budget, fast, fork context or skills/tools.
+Model override: first call {action:"models"}; copy exact provider/id, not agent names. Thinking uses model suffix, not watchdog-only thinking.
+Named resources: {workflow:'review',args:{task:'...'}} or {workflow:'run-ci',args:{command:'npm test'}}. Raw scripts also accept bounded plain-data args; raw-script args persist as evidence, so never include secrets. worktree:true requires clean source; baseRef defaults to HEAD at allocation or a supported named ref, never full 40/64-character commit IDs or revision expressions.`;
+export const DEFAULT_SUBAGENT_TOOL_DESCRIPTION = `${EXECUTION_GUIDANCE}\n\n${SUBAGENT_SAFETY_GUIDANCE}`;
+export const SUBAGENT_TOOL_PROMPT_SNIPPET = "For operator-requested delegation, use subagents; compose multi-child work in one workflow call.";
+export const SUBAGENT_TOOL_PROMPT_GUIDELINES = [
+    "Do not invoke subagents unless the operator requested delegation directly or through applicable instructions.",
+];
+export const COMPACT_SUBAGENT_TOOL_DESCRIPTION = DEFAULT_SUBAGENT_TOOL_DESCRIPTION;
+export const FULL_SUBAGENT_TOOL_DESCRIPTION = `${DEFAULT_SUBAGENT_TOOL_DESCRIPTION}
+
+WORKFLOW DETAILS:
+• runs.lanes([{key,stages:[{key,agent,task},{key,resume:'previous',task}]}]) runs first stages together, later stages sequentially per lane. Failures stay lane-local; only explicit structuredOutput.verdict === 'blocked' blocks a successful stage, never reviewer prose.
+• Workflow child controls default onto runs.run/runs.all items; child fields override them. worktree:true isolates each child and returns handoff artifacts. usageBudget is shared across the workflow; already-running children are not stopped.
+• Missions auto-attach unless mission:false; await state.get(key)/state.set(key,JSONValue) requires a mission. See guide topic missions. Omit acceptance for reviewer/read-only calls; acceptance.review.required requests independent writer review.
+• Management discovery: list/get/models/guide; create/update/delete/eject/disable/enable/reset/refine; mission.*, schedule.*, watchdog.*, inspector.*, project.*, lane.status/recordMerge/recordSupersession; worktree.discard and plan-only worktree.cleanup; doctor and grant-spawn-budget. Use guide topics agents, missions, observability, tool-reference, configuration, models, watchdog or extension-api for exact action fields. Schedules take script inputs, not direct children; recipes live in the missions guide.`;
+function isToolDescriptionMode(value) {
+    return value === "full" || value === "compact" || value === "custom";
+}
+function warn(options, message) {
+    (options?.warn ?? console.warn)(`[pi-subagents] ${message}`);
+}
+export function buildSubagentToolPromptMetadata(config = {}) {
+    if (config.toolDescriptionMode !== undefined)
+        return {};
+    return {
+        promptSnippet: SUBAGENT_TOOL_PROMPT_SNIPPET,
+        promptGuidelines: SUBAGENT_TOOL_PROMPT_GUIDELINES,
+    };
+}
+export function resolveToolDescriptionMode(config, options) {
+    const mode = config.toolDescriptionMode;
+    if (mode === undefined)
+        return "full";
+    if (isToolDescriptionMode(mode))
+        return mode;
+    warn(options, `Ignoring invalid toolDescriptionMode ${JSON.stringify(mode)}; expected "full", "compact", or "custom".`);
+    return "full";
+}
+function customDescriptionPaths(options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const agentDir = options?.agentDir ?? getAgentDir();
+    return [
+        path.join(getProjectConfigDir(cwd), CUSTOM_TOOL_DESCRIPTION_FILE),
+        path.join(agentDir, CUSTOM_TOOL_DESCRIPTION_FILE),
+    ];
+}
+function renderCustomTemplate(template, options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const agentDir = options?.agentDir ?? getAgentDir();
+    const projectConfigDir = getProjectConfigDir(cwd);
+    const variables = {
+        fullDescription: () => FULL_SUBAGENT_TOOL_DESCRIPTION,
+        full: () => FULL_SUBAGENT_TOOL_DESCRIPTION,
+        compactDescription: () => COMPACT_SUBAGENT_TOOL_DESCRIPTION,
+        compact: () => COMPACT_SUBAGENT_TOOL_DESCRIPTION,
+        safetyGuidance: () => SUBAGENT_SAFETY_GUIDANCE,
+        safety: () => SUBAGENT_SAFETY_GUIDANCE,
+        agentDir: () => agentDir,
+        projectConfigDir: () => projectConfigDir,
+    };
+    return template.replace(/\{\{(\w+)\}\}/g, (raw, name) => {
+        const replacement = variables[name];
+        if (replacement)
+            return replacement();
+        warn(options, `${CUSTOM_TOOL_DESCRIPTION_FILE}: unknown placeholder ${raw} left unchanged.`);
+        return raw;
+    });
+}
+function loadCustomToolDescription(options) {
+    for (const filePath of customDescriptionPaths(options)) {
+        let stat;
+        try {
+            stat = fs.statSync(filePath);
+        }
+        catch (error) {
+            if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT")
+                continue;
+            warn(options, `Failed to inspect custom tool description '${filePath}': ${error instanceof Error ? error.message : String(error)}`);
+            continue;
+        }
+        if (!stat.isFile()) {
+            warn(options, `Ignoring custom tool description '${filePath}' because it is not a file.`);
+            continue;
+        }
+        if (stat.size > CUSTOM_TOOL_DESCRIPTION_MAX_BYTES) {
+            warn(options, `Ignoring custom tool description '${filePath}' because it is larger than ${CUSTOM_TOOL_DESCRIPTION_MAX_BYTES} bytes.`);
+            continue;
+        }
+        try {
+            const template = fs.readFileSync(filePath, "utf-8").trim();
+            if (!template) {
+                warn(options, `Ignoring empty custom tool description '${filePath}'.`);
+                continue;
+            }
+            const rendered = renderCustomTemplate(template, options).trim();
+            if (!rendered) {
+                warn(options, `Ignoring custom tool description '${filePath}' because it rendered empty.`);
+                continue;
+            }
+            return rendered;
+        }
+        catch (error) {
+            warn(options, `Failed to read custom tool description '${filePath}': ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return undefined;
+}
+function withMandatorySafetyGuidance(description) {
+    const customDescription = description
+        .split(SUBAGENT_SAFETY_GUIDANCE)
+        .flatMap((part) => part.split(SUBAGENT_FAILURE_RECOVERY_GUIDANCE))
+        .map((part) => part.trim())
+        .filter(Boolean)
+        .join("\n\n");
+    return customDescription
+        ? `${customDescription}\n\n${SUBAGENT_SAFETY_GUIDANCE}`
+        : SUBAGENT_SAFETY_GUIDANCE;
+}
+export function buildSubagentToolDescription(config = {}, options) {
+    if (config.toolDescriptionMode === undefined)
+        return DEFAULT_SUBAGENT_TOOL_DESCRIPTION;
+    const mode = resolveToolDescriptionMode(config, options);
+    let description;
+    if (mode === "compact")
+        description = COMPACT_SUBAGENT_TOOL_DESCRIPTION;
+    else if (mode === "custom") {
+        const custom = loadCustomToolDescription(options);
+        if (custom)
+            description = withMandatorySafetyGuidance(custom);
+        else {
+            warn(options, `${CUSTOM_TOOL_DESCRIPTION_FILE} was not found or valid for toolDescriptionMode "custom"; using full description.`);
+            description = FULL_SUBAGENT_TOOL_DESCRIPTION;
+        }
+    }
+    else
+        description = FULL_SUBAGENT_TOOL_DESCRIPTION;
+    return description;
+}
+//# sourceMappingURL=tool-description.js.map

package/src/extension/tool-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-description.js","sourceRoot":"","sources":["../../../src/extension/tool-description.ts"],"names":[],"mappings":"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"}

package/src/extension/tool-result.d.ts

@@ -0,0 +1,10 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+/**
+ * Convert pi-subagents' internal logical-error result into the rejection Pi's
+ * public tool boundary uses to emit a canonical errored ToolResult.
+ *
+ * Keep this at registered tool boundaries. Internal workflows intentionally
+ * retain their return-based error handling.
+ */
+export declare function finalizeToolResult<T>(result: AgentToolResult<T>): AgentToolResult<T>;
+//# sourceMappingURL=tool-result.d.ts.map

package/src/extension/tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../../../src/extension/tool-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CASpF"}

package/src/extension/tool-result.js

@@ -0,0 +1,17 @@
+/**
+ * Convert pi-subagents' internal logical-error result into the rejection Pi's
+ * public tool boundary uses to emit a canonical errored ToolResult.
+ *
+ * Keep this at registered tool boundaries. Internal workflows intentionally
+ * retain their return-based error handling.
+ */
+export function finalizeToolResult(result) {
+    if (result.isError !== true)
+        return result;
+    const message = result.content
+        .flatMap((item) => item.type === "text" && typeof item.text === "string" ? [item.text] : [])
+        .join("\n")
+        .trim();
+    throw new Error(message || "pi-subagents reported a logical tool failure.");
+}
+//# sourceMappingURL=tool-result.js.map

package/src/extension/tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../../../src/extension/tool-result.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAI,MAA0B;IAC/D,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAE3C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO;SAC5B,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3F,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;IAET,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,+CAA+C,CAAC,CAAC;AAC7E,CAAC"}

package/src/inspectors/actions.d.ts

@@ -0,0 +1,23 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { MissionStoreConfig } from "../missions/types.ts";
+import { type AuthorityPolicyConfig } from "../policy/authority.ts";
+import { type Details, type SubagentState } from "../shared/types.ts";
+import type { InspectorAction, InspectorParams, InspectorPlugin } from "./types.ts";
+export { INSPECTOR_ACTIONS } from "./types.ts";
+export type { InspectorAction, InspectorParams, InspectorPlugin } from "./types.ts";
+export interface InspectorDispatcherDeps {
+    state?: SubagentState;
+    asyncDirRoot?: string;
+    resultsDir?: string;
+    missions?: MissionStoreConfig;
+    authorityPolicy?: AuthorityPolicyConfig;
+    sessionRoots?: string[];
+    cwd: string;
+    signal?: AbortSignal;
+    now?: () => Date;
+    runnerPath?: string;
+    env?: NodeJS.ProcessEnv;
+    plugins?: readonly InspectorPlugin[];
+}
+export declare function handleInspectorAction(action: InspectorAction, params: InspectorParams, deps: InspectorDispatcherDeps): Promise<AgentToolResult<Details>>;
+//# sourceMappingURL=actions.d.ts.map

package/src/inspectors/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/inspectors/actions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAA4B,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAQ,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAM5E,OAAO,KAAK,EAAE,eAAe,EAAqC,eAAe,EAAE,eAAe,EAAmB,MAAM,YAAY,CAAC;AAExI,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAwFpF,MAAM,WAAW,uBAAuB;IACvC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACrC;AACD,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CA4B9J"}

package/src/inspectors/actions.js

@@ -0,0 +1,155 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { readMissionBinding } from "../missions/lifecycle.js";
+import { listMissions, missionRecordPath, resolveMissionStoreLocation } from "../missions/store.js";
+import { resolveAuthorityDecision } from "../policy/authority.js";
+import { DIRS } from "../shared/types.js";
+import { readStatus } from "../shared/utils.js";
+import { resolveSubagentRunId } from "../runs/background/run-id-resolver.js";
+import { resolveNodeExecutable } from "../shared/node-executable.js";
+import { encodeSessionRoots } from "./session-roots-codec.js";
+import { formatShellCommand } from "./shell-command.js";
+export { INSPECTOR_ACTIONS } from "./types.js";
+function result(text, isError = false) {
+    const response = {
+        content: [{ type: "text", text }],
+        details: { mode: "management", results: [] },
+    };
+    if (isError)
+        response.isError = true;
+    return response;
+}
+function pathWithin(base, candidate) {
+    const resolvedBase = path.resolve(base);
+    const resolvedCandidate = path.resolve(candidate);
+    return resolvedCandidate === resolvedBase || resolvedCandidate.startsWith(`${resolvedBase}${path.sep}`);
+}
+function trustedDir(dir, deps) {
+    try {
+        if (fs.lstatSync(dir).isSymbolicLink() || !fs.statSync(dir).isDirectory())
+            return false;
+        const real = fs.realpathSync(dir);
+        if ([...(deps.state?.asyncJobs.values() ?? []), ...(deps.state?.fleetJobs?.values() ?? [])].some((job) => {
+            try {
+                return fs.realpathSync(job.asyncDir) === real;
+            }
+            catch {
+                return false;
+            }
+        }))
+            return true;
+        const root = deps.asyncDirRoot ?? DIRS.async;
+        return fs.existsSync(root) && pathWithin(root, dir) && pathWithin(fs.realpathSync(root), real);
+    }
+    catch {
+        return false;
+    }
+}
+function resolveTarget(params, deps) {
+    const requested = params.id ?? params.runId;
+    let runId;
+    let asyncDir;
+    if (params.dir) {
+        asyncDir = path.resolve(params.dir);
+        if (!trustedDir(asyncDir, deps))
+            return { error: `Async run directory '${asyncDir}' is outside trusted run roots.` };
+        const status = readStatus(asyncDir);
+        if (!status)
+            return { error: `No async run status found in '${asyncDir}'.` };
+        if (requested && requested !== status.runId && !status.runId.startsWith(requested))
+            return { error: `Run '${requested}' does not match status run '${status.runId}'.` };
+        runId = status.runId;
+    }
+    else {
+        if (!requested)
+            return { error: "Inspector actions require id or dir." };
+        try {
+            const found = resolveSubagentRunId(requested, { state: deps.state, asyncDirRoot: deps.asyncDirRoot ?? DIRS.async, resultsDir: deps.resultsDir ?? DIRS.results });
+            if (!found)
+                return { error: `No subagent run found for '${requested}'.` };
+            if (found.kind !== "async" || !found.location.asyncDir)
+                return { error: `Run '${found.id}' is not an inspectable async run with lifecycle artifacts.` };
+            runId = found.id;
+            asyncDir = found.location.asyncDir;
+        }
+        catch (cause) {
+            return { error: cause instanceof Error ? cause.message : String(cause) };
+        }
+    }
+    const status = readStatus(asyncDir);
+    if (!status)
+        return { error: `No lifecycle status exists for async run '${runId}'.` };
+    if (params.index !== undefined && (params.index < 0 || params.index >= (status.steps?.length ?? 0)))
+        return { error: `Async run '${runId}' has ${status.steps?.length ?? 0} children. Index ${params.index} is out of range.` };
+    const target = { runId, asyncDir, status: { cwd: status.cwd, state: status.state, steps: status.steps } };
+    if (params.index !== undefined)
+        target.index = params.index;
+    return target;
+}
+function missionFor(target, deps) {
+    try {
+        const binding = readMissionBinding(target.asyncDir);
+        if (binding)
+            return { id: binding.missionId, path: missionRecordPath(binding.location, binding.missionId) };
+        const location = resolveMissionStoreLocation(deps.missions ? { projectRoot: deps.cwd, config: deps.missions } : { projectRoot: deps.cwd });
+        const mission = listMissions(location).records.find((record) => record.runs.some((run) => run.runId === target.runId));
+        return mission ? { id: mission.id, path: missionRecordPath(location, mission.id) } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function launchFor(target, deps) {
+    const mission = missionFor(target, deps);
+    const runnerPath = deps.runnerPath ?? fileURLToPath(new URL("../../inspector-runner.mjs", import.meta.url));
+    const job = deps.state?.asyncJobs.get(target.runId) ?? deps.state?.fleetJobs?.get(target.runId);
+    const sessionRoots = [...new Set([...(deps.sessionRoots ?? deps.state?.trustedSessionRoots ?? []), ...(job?.sessionRoot ? [job.sessionRoot] : [])])];
+    const allowSteer = resolveAuthorityDecision({ action: "steerRun", policy: deps.authorityPolicy }) === "auto";
+    const allowStop = resolveAuthorityDecision({ action: "stopRun", policy: deps.authorityPolicy }) === "auto";
+    const argv = [runnerPath, "--async-dir", target.asyncDir, "--run-id", target.runId, "--allow-steer", String(allowSteer), "--allow-stop", String(allowStop), "--session-roots", encodeSessionRoots(sessionRoots)];
+    if (target.index !== undefined)
+        argv.push("--index", String(target.index));
+    if (mission)
+        argv.push("--mission-path", mission.path);
+    const executable = resolveNodeExecutable();
+    const launch = { executable, argv, displayCommand: formatShellCommand(executable, argv), allowSteer, allowStop, sessionRoots };
+    if (mission)
+        launch.mission = mission;
+    return launch;
+}
+export async function handleInspectorAction(action, params, deps) {
+    const target = resolveTarget(params, deps);
+    if ("error" in target)
+        return result(target.error, true);
+    const context = {
+        cwd: deps.cwd,
+        signal: deps.signal,
+        env: deps.env ?? process.env,
+        target,
+    };
+    if (deps.now)
+        context.now = deps.now;
+    if (action === "inspector.command")
+        return result(launchFor(target, deps).displayCommand);
+    const plugins = deps.plugins ?? [];
+    if (action === "inspector.open") {
+        for (const plugin of plugins) {
+            if (await plugin.available(context))
+                return plugin.open(context, launchFor(target, deps), params);
+        }
+        return result("No inspector plugin is available. Start a supported inspector host, or use inspector.command for a standalone command.", true);
+    }
+    const owner = plugins.find((plugin) => plugin.owns(context));
+    if (!owner)
+        return result(`No inspector plugin owns this binding for async run ${target.runId}.`);
+    if (action === "inspector.status") {
+        return owner.status
+            ? owner.status(context)
+            : result(`Inspector plugin '${owner.name}' does not support status for async run ${target.runId}.`, true);
+    }
+    return owner.close
+        ? owner.close(context)
+        : result(`Inspector plugin '${owner.name}' does not support close for async run ${target.runId}.`, true);
+}
+//# sourceMappingURL=actions.js.map

package/src/inspectors/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/inspectors/actions.ts"],"names":[],"mappings":"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"}

package/src/inspectors/ghostty/actions.d.ts

@@ -0,0 +1,12 @@
+import { type ExecFileOptionsWithStringEncoding } from "node:child_process";
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { Details } from "../../shared/types.ts";
+import type { InspectorContext, InspectorLaunch, InspectorParams } from "../types.ts";
+/** Static Ghostty 1.3 AppleScript; dynamic values arrive as `on run argv` arguments. */
+export declare const GHOSTTY_APPLESCRIPT = "on run argv\n  set launchCommand to item 1 of argv\n  set launchCwd to item 2 of argv\n  set shouldFocus to item 3 of argv\n  tell application \"Ghostty\"\n    set sourceWindow to front window\n    set sourceTab to selected tab of sourceWindow\n    set sourceTerminal to focused terminal of sourceTab\n    set surfaceConfiguration to new surface configuration\n    set initial working directory of surfaceConfiguration to launchCwd\n    set command of surfaceConfiguration to launchCommand\n    set newTerminal to split sourceTerminal direction right with configuration surfaceConfiguration\n    if shouldFocus is \"true\" then\n      focus newTerminal\n    else\n      focus sourceTerminal\n    end if\n    return id of newTerminal\n  end tell\nend run";
+export type GhosttyRunner = (args: readonly string[], options: ExecFileOptionsWithStringEncoding) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export declare function openGhosttyInspector(context: InspectorContext, launch: InspectorLaunch, params: InspectorParams, runner?: GhosttyRunner): Promise<AgentToolResult<Details>>;
+//# sourceMappingURL=actions.d.ts.map

package/src/inspectors/ghostty/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../src/inspectors/ghostty/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtF,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,svBAmBxB,CAAC;AAET,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,iCAAiC,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AA0BjJ,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,EACvB,MAAM,GAAE,aAA6B,GACnC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAenC"}

package/src/inspectors/ghostty/actions.js

@@ -0,0 +1,63 @@
+import { execFile } from "node:child_process";
+/** Static Ghostty 1.3 AppleScript; dynamic values arrive as `on run argv` arguments. */
+export const GHOSTTY_APPLESCRIPT = `on run argv
+  set launchCommand to item 1 of argv
+  set launchCwd to item 2 of argv
+  set shouldFocus to item 3 of argv
+  tell application "Ghostty"
+    set sourceWindow to front window
+    set sourceTab to selected tab of sourceWindow
+    set sourceTerminal to focused terminal of sourceTab
+    set surfaceConfiguration to new surface configuration
+    set initial working directory of surfaceConfiguration to launchCwd
+    set command of surfaceConfiguration to launchCommand
+    set newTerminal to split sourceTerminal direction right with configuration surfaceConfiguration
+    if shouldFocus is "true" then
+      focus newTerminal
+    else
+      focus sourceTerminal
+    end if
+    return id of newTerminal
+  end tell
+end run`;
+function defaultRunner(args, options) {
+    return new Promise((resolve, reject) => {
+        execFile("/usr/bin/osascript", [...args], options, (error, stdout, stderr) => {
+            if (error) {
+                const failure = error instanceof Error ? error : new Error(String(error));
+                reject(failure);
+                return;
+            }
+            resolve({ stdout, stderr });
+        });
+    });
+}
+function result(text, isError = false) {
+    const response = {
+        content: [{ type: "text", text }],
+        details: { mode: "management", results: [] },
+    };
+    if (isError)
+        response.isError = true;
+    return response;
+}
+const failureHint = "Ghostty inspector requires Ghostty 1.3+ and Automation permission for osascript.";
+export async function openGhosttyInspector(context, launch, params, runner = defaultRunner) {
+    try {
+        const output = await runner(["-e", GHOSTTY_APPLESCRIPT, "--", launch.displayCommand, context.target.status.cwd ?? context.cwd, params.focus === true ? "true" : "false"], {
+            signal: context.signal,
+            timeout: 15_000,
+            encoding: "utf8",
+            maxBuffer: 64 * 1024,
+        });
+        const id = output.stdout.trim();
+        if (!id)
+            return result(`Ghostty inspector error: Ghostty returned an empty terminal id. ${failureHint}`, true);
+        return result(`Opened read-only Ghostty inspector terminal ${id} for async run ${context.target.runId}. Status and close are unavailable because this plugin writes no binding.`);
+    }
+    catch (cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        return result(`Ghostty inspector error: ${message}. ${failureHint}`, true);
+    }
+}
+//# sourceMappingURL=actions.js.map

package/src/inspectors/ghostty/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../../src/inspectors/ghostty/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA0C,MAAM,oBAAoB,CAAC;AAKtF,wFAAwF;AACxF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;QAmB3B,CAAC;AAIT,SAAS,aAAa,CAAC,IAAuB,EAAE,OAA0C;IACzF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,QAAQ,CAAC,oBAAoB,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC5E,IAAI,KAAK,EAAE,CAAC;gBACX,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC1E,MAAM,CAAC,OAAO,CAAC,CAAC;gBAChB,OAAO;YACR,CAAC;YACD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,OAAO,GAAG,KAAK;IAC5C,MAAM,QAAQ,GAA6B;QAC1C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE;KAC5C,CAAC;IACF,IAAI,OAAO;QAAE,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;IACrC,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,WAAW,GAAG,kFAAkF,CAAC;AAEvG,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,OAAyB,EACzB,MAAuB,EACvB,MAAuB,EACvB,SAAwB,aAAa;IAErC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,CAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;YACzK,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,EAAE,GAAG,IAAI;SACpB,CAAC,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC,mEAAmE,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;QAC/G,OAAO,MAAM,CAAC,+CAA+C,EAAE,kBAAkB,OAAO,CAAC,MAAM,CAAC,KAAK,2EAA2E,CAAC,CAAC;IACnL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,MAAM,CAAC,4BAA4B,OAAO,KAAK,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;AACF,CAAC"}

package/src/inspectors/ghostty/plugin.d.ts

@@ -0,0 +1,8 @@
+import { type GhosttyRunner } from "./actions.ts";
+import type { InspectorPlugin } from "../types.ts";
+export interface GhosttyPluginDeps {
+    platform?: NodeJS.Platform;
+    runner?: GhosttyRunner;
+}
+export declare function createGhosttyInspectorPlugin(deps?: GhosttyPluginDeps): InspectorPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/src/inspectors/ghostty/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/inspectors/ghostty/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnD,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,wBAAgB,4BAA4B,CAAC,IAAI,GAAE,iBAAsB,GAAG,eAAe,CAiB1F"}

package/src/inspectors/ghostty/plugin.js

@@ -0,0 +1,24 @@
+import { openGhosttyInspector } from "./actions.js";
+/** 独立 Ghostty.app 的 bundle id (作者 Mitchell Hashimoto)。 */
+const GHOSTTY_BUNDLE_ID = "com.mitchellh.ghostty";
+export function createGhosttyInspectorPlugin(deps = {}) {
+    const platform = deps.platform ?? process.platform;
+    return {
+        name: "ghostty",
+        available: (context) => {
+            // cmux 内嵌 Ghostty 内核, 也会把 TERM_PROGRAM 设成 "ghostty"。仅凭环境变量会让 plugin
+            // 在 cmux 下误接管, 随后 osascript 连不上真正的 Ghostty 应用而抛 -1728/-2741。
+            if (platform !== "darwin")
+                return false;
+            if (context.env.TERM_PROGRAM?.toLowerCase() !== "ghostty")
+                return false;
+            // macOS GUI 应用启动子进程时注入 __CFBundleIdentifier, 标识当前终端宿主 app。
+            // cmux 的 bundle id 是 com.cmuxterm.app, 而非 Ghostty; 即便系统同时装了独立 Ghostty,
+            // 也能据此判定当前终端不是 Ghostty, 避免误连独立 Ghostty 的窗口。
+            return context.env.__CFBundleIdentifier?.trim() === GHOSTTY_BUNDLE_ID;
+        },
+        owns: () => false,
+        open: (context, launch, params) => openGhosttyInspector(context, launch, params, deps.runner),
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/src/inspectors/ghostty/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../src/inspectors/ghostty/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAsB,MAAM,cAAc,CAAC;AAGxE,0DAA0D;AAC1D,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAOlD,MAAM,UAAU,4BAA4B,CAAC,OAA0B,EAAE;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,OAAO;QACN,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACtB,oEAAoE;YACpE,6DAA6D;YAC7D,IAAI,QAAQ,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACxC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACxE,2DAA2D;YAC3D,uEAAuE;YACvE,4CAA4C;YAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,KAAK,iBAAiB,CAAC;QACvE,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK;QACjB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;KAC7F,CAAC;AACH,CAAC"}

package/src/inspectors/herdr/actions.d.ts

@@ -0,0 +1,26 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { Details } from "../../shared/types.ts";
+import type { InspectorContext, InspectorLaunch, InspectorParams, InspectorTarget } from "../types.ts";
+import { type HerdrClient } from "./client.ts";
+export interface HerdrInspectorBinding {
+    schemaVersion: 1;
+    kind: "herdr-inspector";
+    runId: string;
+    asyncDir: string;
+    childIndex?: number;
+    missionId?: string;
+    missionPath?: string;
+    paneId: string;
+    openedAt: string;
+    lastFocusedAt?: string;
+    herdrVersion?: string;
+    command: string;
+}
+export declare function bindingPath(asyncDir: string, index?: number): string;
+export declare function readHerdrInspectorBinding(asyncDir: string, index?: number): HerdrInspectorBinding | undefined;
+/** Read a binding only when it belongs to the requested inspector target. */
+export declare function readHerdrInspectorBindingForTarget(target: InspectorTarget): HerdrInspectorBinding | undefined;
+export declare function openHerdrInspector(context: InspectorContext, launch: InspectorLaunch, params: InspectorParams, client: HerdrClient): Promise<AgentToolResult<Details>>;
+export declare function statusHerdrInspector(context: InspectorContext, client: HerdrClient): Promise<AgentToolResult<Details>>;
+export declare function closeHerdrInspector(context: InspectorContext, client: HerdrClient): Promise<AgentToolResult<Details>>;
+//# sourceMappingURL=actions.d.ts.map

package/src/inspectors/herdr/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../src/inspectors/herdr/actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACvG,OAAO,EAAe,KAAK,WAAW,EAAyC,MAAM,aAAa,CAAC;AAEnG,MAAM,WAAW,qBAAqB;IACrC,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AAgBD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAM7G;AAED,6EAA6E;AAC7E,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,eAAe,GAAG,qBAAqB,GAAG,SAAS,CAS7G;AA4BD,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,WAAW,GACjB,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAuCnC;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAU5H;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAS3H"}