@llblab/pi-actors 0.58.1 → 0.58.3

package/lib/run-delivery.ts

@@ -69,7 +69,7 @@ export interface RunCompletionBatch {
   /** Retained singleton capture; absence preserves older indexed bytes. Never a new-capture selector. */
   readonly single_result?: true;
   /** Captured record-list shape; no public format/version choice or source authority. */
-  readonly result_layout?: "records" | "run_headers" | "headings" | "headings_flat_omissions" | "headings_outcomes" | "headings_shared_results" | "headings_shared_kinds" | "frontmatter_v1" | "frontmatter_v2" | "completion_yaml_core_v1" | "completion_yaml_files_v1" | "completion_yaml_files_v2";
+  readonly result_layout?: "records" | "run_headers" | "headings" | "headings_flat_omissions" | "headings_outcomes" | "headings_shared_results" | "headings_shared_kinds" | "frontmatter_v1" | "frontmatter_v2" | "completion_yaml_core_v1" | "completion_yaml_files_v1" | "completion_yaml_files_v2" | "completion_yaml_files_v3";
   /** Immutable scope/order/range data, not a caller-selected format or allocation authority. */
   readonly numbering?: RunCompletionNumbering;
   /** Formatting version/data only; no recipient ownership, read or publication capability. */
@@ -468,7 +468,7 @@ function isFrontmatterCompletionLayout(layout: unknown): boolean {
 }
 
 function isRootedCompletionLayout(layout: unknown): boolean {
-  return layout === "completion_yaml_files_v1" || layout === "completion_yaml_files_v2";
+  return layout === "completion_yaml_files_v1" || layout === "completion_yaml_files_v2" || layout === "completion_yaml_files_v3";
 }
 
 function isYamlCompletionLayout(layout: unknown): boolean {
@@ -899,7 +899,7 @@ export function requestRunCompletionStream(input: { tempDir: string; ownerId: st
 }
 
 export function admitRunCompletionBatch(input: AdmitRunCompletionBatchInput): RunCompletionBatch {
-  return captureCompletionBatch(input, false, "completion_yaml_files_v2");
+  return captureCompletionBatch(input, false, "completion_yaml_files_v3");
 }
 
 /** Kernel-only opt-in; ordinary Pi capture stays fenced until session/lifecycle integration is admitted. */
@@ -909,10 +909,10 @@ export function captureRunCompletionStreamBatch(input: AdmitRunCompletionBatchIn
 
 /** Private ordinary candidate composition; stream capture retains its separately gated codec. */
 export function captureRunCompletionYamlCandidateBatch(input: AdmitRunCompletionBatchInput): RunCompletionBatch {
-  return captureCompletionBatch(input, false, "completion_yaml_files_v2");
+  return captureCompletionBatch(input, false, "completion_yaml_files_v3");
 }
 
-function captureCompletionBatch(input: AdmitRunCompletionBatchInput, numbered: boolean, layout: "frontmatter_v2" | "completion_yaml_core_v1" | "completion_yaml_files_v1" | "completion_yaml_files_v2" = "frontmatter_v2"): RunCompletionBatch {
+function captureCompletionBatch(input: AdmitRunCompletionBatchInput, numbered: boolean, layout: "frontmatter_v2" | "completion_yaml_core_v1" | "completion_yaml_files_v1" | "completion_yaml_files_v2" | "completion_yaml_files_v3" = "frontmatter_v2"): RunCompletionBatch {
   const now = (input.now ?? new Date()).toISOString();
   if (Object.hasOwn(input, "presentationFormat")) throw new Error("Completion presentation selection is not supported; new batches use AX.");
   if (Object.hasOwn(input, "numbering")) throw new Error("Completion numbering is assigned only by journal capture");
@@ -1810,8 +1810,9 @@ function rootedCompletionPath(path: CompletionYamlData, runRoot?: string): { roo
 }
 
 /** Body-free, read-free navigation over already selected references. Roots are presentation bases, not containment proof. */
-function completionRootedFiles(row: CompletionRow, member: RunCompletionBatchMember, locations?: RunDirectoryNavigation): Record<string, CompletionYamlData> {
+function completionRootedFiles(row: CompletionRow, member: RunCompletionBatchMember, locations?: RunDirectoryNavigation, compact = false): Record<string, CompletionYamlData> {
   const technical = completionYamlReferences(row), files: Record<string, CompletionYamlData> = {};
+  const status: string[] = [];
   const groups: Array<{ root: CompletionYamlData; entries: Record<string, CompletionYamlData>[] }> = [];
   const runRoot = locations?.state === "available" ? locations.directory : undefined;
   const group = (root: CompletionYamlData): number => {
@@ -1838,26 +1839,41 @@ function completionRootedFiles(row: CompletionRow, member: RunCompletionBatchMem
     if (!detail) continue;
     const { source: rawSource, ...facts } = detail;
     const { path, ...binding } = rawSource as Record<string, CompletionYamlData>;
-    add(path!, { role, purpose, ...facts, source: binding }, rank);
+    add(path!, compact ? { role, ...(role === "primary" ? { status: facts.text_basis === "actor_response" ? "Actor response; admission privacy" : "Exported text; admission privacy, not complete Actor output" }
+      : role === "diagnostic_metadata" ? { status: "Recorded diagnostic metadata only; admission privacy",
+        ...(facts.recorded_fields_not_shown ? { recorded_fields_not_shown: facts.recorded_fields_not_shown } : {}) }
+      : { status: "Declarations only; target availability/production unproven" }) } : { role, purpose, ...facts, source: binding }, rank);
     delete technical[role];
   }
   const artifacts = technical.artifacts as { scope: string; declarations: { name: CompletionYamlData; path: CompletionYamlData }[] } | undefined;
   if (artifacts) {
     for (const item of artifacts.declarations)
-      add(item.path, { role: "artifact", purpose: "Declared artifact", name: item.name, scope: artifacts.scope, state: "declared" });
+      add(item.path, compact ? { role: "artifact", name: item.name } : { role: "artifact", purpose: "Declared artifact", name: item.name, scope: artifacts.scope, state: "declared" });
+    if (compact) status.push("Declared artifact paths; existence/production unproven");
     delete technical.artifacts;
   }
   if (locations?.state === "available") {
     const { directory, files: selectedFiles, ...observation } = locations;
-    files.observation = { ...observation, run: completionYamlString(locations.run), run_instance_id: completionYamlString(locations.run_instance_id),
+    if (!compact) files.observation = { ...observation, run: completionYamlString(locations.run), run_instance_id: completionYamlString(locations.run_instance_id),
       group: group(completionYamlString(directory)) };
-    for (const item of selectedFiles) {
+    if (compact) {
+      const unavailable = selectedFiles.filter(item => item.state === "unavailable").map(item => item.role);
+      if (unavailable.length) status.push(`Unavailable locations: ${unavailable.join(", ")}`);
+      if (selectedFiles.some(item => item.role === "result" && item.state === "missing")) status.push("Recorded result location missing");
+    }
+    const useful = selectedFiles.filter(item => item.state === "present" && ["context_index", "result", "execution"].includes(item.role));
+    if (!useful.length) useful.push(...selectedFiles.filter(item => item.state === "present" && item.role === "metadata"));
+    for (const item of compact ? useful : selectedFiles) {
       const { path, ...facts } = item;
       const purpose = item.role === "result" ? "Recorded result metadata" : item.role === "execution" ? "Recorded execution and capture locations" : "Recorded Run file";
-      add(typeof path === "string" ? completionYamlString(path) : null, { ...facts, purpose },
+      add(typeof path === "string" ? completionYamlString(path) : null, compact ? { role: item.role } : { ...facts, purpose },
         item.state === "present" && item.role === "result" ? 3 : item.state === "present" && item.role === "execution" ? 4 : Infinity, directory);
     }
-  } else if (locations) files.observation = { ...locations, run: completionYamlString(member.run), run_instance_id: completionYamlString(member.run_instance_id) };
+  } else if (locations) {
+    if (compact) status.push(`Run locations unavailable: ${locations.reason}`);
+    else files.observation = { ...locations, run: completionYamlString(member.run), run_instance_id: completionYamlString(member.run_instance_id) };
+  }
+  if (status.length) files.status = status.join("; ");
   if (groups.length) {
     files.groups = groups;
   }
@@ -1874,7 +1890,8 @@ function prepareCompletionYamlProjection(safe: RunCompletionBatch, candidates: r
   references: ReadonlySet<number>, ordered: readonly RunCompletionBatchMember[]): PreparedCompletionYamlProjection {
   const packet: CompletionYamlPacket = { batchId: safe.batch_id, records: [] };
   const rooted = isRootedCompletionLayout(safe.result_layout);
-  const localSingleton = safe.result_layout === "completion_yaml_files_v2" && !safe.numbering && candidates.length === 1;
+  const compact = safe.result_layout === "completion_yaml_files_v3";
+  const localSingleton = (compact || safe.result_layout === "completion_yaml_files_v2") && !safe.numbering && candidates.length === 1;
   if (!safe.batch_id.isWellFormed()) return { state: "unsupported" };
   for (const [index, { row, location }] of candidates.entries()) {
     const member = ordered[index]!;
@@ -1894,7 +1911,7 @@ function prepareCompletionYamlProjection(safe: RunCompletionBatch, candidates: r
     const navigation = references.has(index) && location
       ? safe.file_navigation!.find(item => safe.members[item.member_index] === member)!.locations : undefined;
     if (rooted) {
-      const files = completionRootedFiles(row, member, navigation);
+      const files = completionRootedFiles(row, member, navigation, compact);
       if (Object.keys(files).length) metadata.files = files;
     } else {
       const technical = completionYamlReferences(row);
@@ -1923,7 +1940,7 @@ function prepareCompletionYamlProjection(safe: RunCompletionBatch, candidates: r
     packet.records.push({ metadata, parts });
   }
   const service: Record<string, CompletionYamlData> = rooted ? {
-    header_layout: safe.result_layout === "completion_yaml_files_v2" ? "rooted_files_v2" : "rooted_files_v1",
+    header_layout: compact ? "rooted_files_v3" : safe.result_layout === "completion_yaml_files_v2" ? "rooted_files_v2" : "rooted_files_v1",
   } : {};
   const omitted = safe.members.length - candidates.length;
   if (omitted) {
@@ -2356,7 +2373,7 @@ export function readRunCompletionPresentation(content: string, value: unknown):
         !completionYamlKeys(hint, ["format", "content_sha256"]) || hint.format !== completionYamlCodec ||
         hint.content_sha256 !== createHash("sha256").update(content).digest("hex")) return full;
     const segments: NonNullable<RunCompletionPresentationView["segments"]>[number][] = [];
-    const rooted = core.packet.service?.header_layout === "rooted_files_v1" || core.packet.service?.header_layout === "rooted_files_v2";
+    const rooted = core.packet.service?.header_layout === "rooted_files_v1" || core.packet.service?.header_layout === "rooted_files_v2" || core.packet.service?.header_layout === "rooted_files_v3";
     const facts = Object.fromEntries(Object.entries(core.packet.service ?? {}).filter(([key]) => key !== "header_layout"));
     for (const [index, record] of core.packet.records.entries()) {
       if (index) segments.push({ kind: "separator", text: "\n" });
@@ -2589,7 +2606,7 @@ export function encodeCompletionYamlCarrier(input: unknown): { state: "available
       (Object.hasOwn(packet, "service") && (!completionYamlMapping(packet.service) || !Object.keys(packet.service).length)) ||
       (!packet.records.length && !Object.hasOwn(packet, "service"))) return unavailable;
   const localSingleton = packet.records.length === 1 && completionYamlMapping(packet.service) &&
-    packet.service.header_layout === "rooted_files_v2" && !Object.hasOwn(packet.service, "numbering");
+    (packet.service.header_layout === "rooted_files_v2" || packet.service.header_layout === "rooted_files_v3") && !Object.hasOwn(packet.service, "numbering");
   const rows: string[] = [];
   for (let index = 0; index < Math.max(1, packet.records.length); index++) {
     const row: CompletionYamlData | undefined = packet.records[index];

package/lib/run-evidence-policy.ts

@@ -69,8 +69,8 @@ export type RunControlAdmissionInput = {
 const PENDING_CONTROL_STATUSES = new Set<RunControlStatus>(["queued", "delivered", "claimed"]);
 const TERMINAL_CONTROL_STATUSES = new Set<RunControlStatus>(["handled", "failed"]);
 const CONTROL_ADMISSION_NEXT_ACTIONS = [
-  "inspect target=run:<id> view=control",
-  "inspect target=runtime view=triage",
+  "actors_inspect target=run:<id> view=control",
+  "actors_inspect target=runtime view=triage",
 ];
 
 function isCount(value: number): boolean {

package/lib/runtime.ts

@@ -8,6 +8,7 @@ import { existsSync, watch, type FSWatcher } from "node:fs";
 import { basename, dirname } from "node:path";
 
 import * as Config from "./config.ts";
+import * as Identity from "./identity.ts";
 import type { RegisteredToolExec } from "./execution.ts";
 import * as Paths from "./paths.ts";
 import type { RecipeResolutionContext } from "./recipes-context.ts";
@@ -36,7 +37,7 @@ export interface ToolRegistryRuntimeDeps {
   exec: RegisteredToolExec;
   recipeRoot?: string;
   getActiveTools?: () => string[];
-  getAllTools?: () => Array<{ name: string }>;
+  getAllTools?: () => Array<{ name: string; sourceInfo?: { path: string } }>;
   registerTool: (
     definition: ReturnType<typeof ToolsLocal.createRuntimeToolDefinition>,
   ) => void;
@@ -83,6 +84,8 @@ export function createAutoToolsRuntime(
   const tools = new Map<string, Config.RegisteredTool>();
   const runtimeToolFingerprints = new Map<string, string>();
   const runtimeTools = new Set<string>();
+  // Host declarations survive deactivation; retain their observed provenance separately.
+  const runtimeToolSources = new Map<string, string | undefined>();
   const recipeRoot = deps.recipeRoot ?? Paths.getRecipeRoot();
   const status: RecipeRegistryStatus = {
     active_tool_count: 0,
@@ -99,9 +102,14 @@ export function createAutoToolsRuntime(
     if (ctx.hasUI) ctx.ui.notify(message, type);
   }
   function getToolNameBlocker(name: string): string | undefined {
-    return deps.reservedToolNames.has(name)
-      ? `Reserved tool name: ${name}`
-      : undefined;
+    const normalized = Identity.normalizeToolName(name);
+    if ([...deps.reservedToolNames].some((reserved) => Identity.normalizeToolName(reserved) === normalized))
+      return `Reserved tool name: ${name}`;
+    const foreign = deps.getAllTools?.().find((tool) =>
+      Identity.normalizeToolName(tool.name) === normalized &&
+      !(tool.name === name && runtimeToolSources.has(name) &&
+        tool.sourceInfo?.path === runtimeToolSources.get(name)));
+    return foreign ? `Host tool name collision: ${name} conflicts with ${foreign.name}` : undefined;
   }
   function getToolFingerprint(cfg: Config.RegisteredTool): string {
     return JSON.stringify({
@@ -135,12 +143,15 @@ export function createAutoToolsRuntime(
   function deactivateMissingRuntimeTools(activeNames: Set<string>): void {
     const stale = [...runtimeTools].filter((name) => !activeNames.has(name));
     if (stale.length === 0) return;
+    const hostTools = deps.getAllTools?.();
+    const staleOwned = stale.filter((name) => !hostTools || hostTools.some((tool) =>
+      tool.name === name && tool.sourceInfo?.path === runtimeToolSources.get(name)));
     for (const name of stale) {
       runtimeTools.delete(name);
       runtimeToolFingerprints.delete(name);
     }
     if (!deps.getActiveTools || !deps.setActiveTools) return;
-    const staleSet = new Set(stale);
+    const staleSet = new Set(staleOwned);
     deps.setActiveTools(
       deps.getActiveTools().filter((name) => !staleSet.has(name)),
     );
@@ -157,10 +168,13 @@ export function createAutoToolsRuntime(
     };
   }
   function registerRuntimeTool(cfg: Config.RegisteredTool): RuntimeToolActivation {
+    const blocker = getToolNameBlocker(cfg.name);
+    if (blocker) throw new Error(blocker);
     const fingerprint = getToolFingerprint(cfg);
     if (runtimeToolFingerprints.get(cfg.name) !== fingerprint) {
       deps.registerTool(ToolsLocal.createRuntimeToolDefinition(cfg, deps.exec));
       runtimeTools.add(cfg.name);
+      runtimeToolSources.set(cfg.name, deps.getAllTools?.().find((tool) => tool.name === cfg.name)?.sourceInfo?.path);
       runtimeToolFingerprints.set(cfg.name, fingerprint);
     }
     if (deps.getActiveTools && deps.setActiveTools) {
@@ -215,7 +229,7 @@ export function createAutoToolsRuntime(
       lines.push(...other.map((warning) => `• ${warning}`));
       groups[groups.length] = ["other_diagnostics", start, lines.length];
     }
-    lines.push("Next: inspect target=recipes view=doctor");
+    lines.push("Next: actors_inspect target=recipes view=doctor");
     // Preserve the original layout join/coercion and its faults before projecting owned warning slots.
     void `${lines.join("\n")}\n`;
     let text = ToolsResponse.formatMarkdownField("report", "pi-actors recipe registry warning");
@@ -227,7 +241,7 @@ export function createAutoToolsRuntime(
           : "  - warning:\n    - result: unavailable\n    - reason: malformed_selected_text");
       }
     }
-    return text + "\n" + ToolsResponse.formatMarkdownField("instruction", "Next: inspect target=recipes view=doctor") + "\n";
+    return text + "\n" + ToolsResponse.formatMarkdownField("instruction", "Next: actors_inspect target=recipes view=doctor") + "\n";
   }
   function loadTools(
     ctx: RuntimeContext,
@@ -259,6 +273,7 @@ export function createAutoToolsRuntime(
       const blocker = getToolNameBlocker(cfg.name);
       if (blocker) {
         warnings.push(blocker);
+        tools.delete(cfg.name);
         continue;
       }
       registerRuntimeTool(cfg);
@@ -284,7 +299,7 @@ export function createAutoToolsRuntime(
     }),
     getToolStatus: (name) => {
       const cfg = tools.get(name);
-      if (!cfg) return undefined;
+      if (!cfg || getToolNameBlocker(name)) return undefined;
       const usage = cfg.sourcePath
         ? RecipesUsage.readRecipeUsage(cfg.sourcePath)
         : undefined;
@@ -305,8 +320,8 @@ export function createAutoToolsRuntime(
         next_actions: activation.callable_now
           ? [`call tool ${name}`]
           : [
-              `register_tool name=${name} update=true`,
-              `inspect target=tool:${name} view=status`,
+              `actors_tool_register name=${name} update=true`,
+              `actors_inspect target=tool:${name} view=status`,
             ],
         ...(usage?.launch_kind ? { launch_kind: usage.launch_kind } : {}),
         spawn_calls: Number(usage?.spawn_calls ?? 0),
@@ -372,7 +387,7 @@ export function createRecipeToolReloadWatcher(
     setWatchStatus("failed");
     try {
       ctx.ui.notify(
-        "- report: Recipe live reload watcher failed\n- instruction: restart the session or use register_tool again to refresh recipe tools.",
+        "- report: Recipe live reload watcher failed\n- instruction: restart the session or use actors_tool_register again to refresh recipe tools.",
         "warning",
       );
     } catch (error) {

package/lib/tool-review-scheduler.ts

@@ -404,7 +404,7 @@ export function applyApprovedToolReviewAtSessionBoundary(
         ...state,
         failedStage: "approval_state",
         lastError: "approved review path is unavailable",
-        nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
+        nextAction: "actors_control_apply target=runtime action=review.retry input={\"scope\":\"tool\"}",
         phase: "processing_failed" as const,
         updatedAt: (options.now ?? (() => new Date()))().toISOString(),
       };
@@ -427,7 +427,7 @@ export function applyApprovedToolReviewAtSessionBoundary(
           ...state,
           failedStage: "transaction",
           lastError: `tool review transaction remained ${transaction.phase}`,
-          nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
+          nextAction: "actors_control_apply target=runtime action=review.retry input={\"scope\":\"tool\"}",
           phase: "processing_failed" as const,
           updatedAt: (options.now ?? (() => new Date()))().toISOString(),
         };
@@ -458,7 +458,7 @@ export function applyApprovedToolReviewAtSessionBoundary(
           ...pending,
           failedStage: "lineage",
           lastError: error instanceof Error ? error.message : String(error),
-          nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
+          nextAction: "actors_control_apply target=runtime action=review.retry input={\"scope\":\"tool\"}",
         };
         writeJsonAtomic(statePath, failedPending);
         return { outcome: "lineage_pending", state: failedPending };
@@ -478,7 +478,7 @@ export function applyApprovedToolReviewAtSessionBoundary(
         ...state,
         failedStage: "transaction",
         lastError: error instanceof Error ? error.message : String(error),
-        nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
+        nextAction: "actors_control_apply target=runtime action=review.retry input={\"scope\":\"tool\"}",
         phase: "processing_failed" as const,
         updatedAt: (options.now ?? (() => new Date()))().toISOString(),
       };
@@ -541,7 +541,7 @@ export function createToolReviewScheduler(
           ...existing,
           failedStage: processed.stage ?? "review_result",
           lastError: processed.error ?? "automatic tool reviewer failed",
-          nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
+          nextAction: "actors_control_apply target=runtime action=review.retry input={\"scope\":\"tool\"}",
           phase: processed.outcome === "processing_failed"
             ? "processing_failed"
             : "failed",
@@ -577,7 +577,7 @@ export function createToolReviewScheduler(
             attempts: existing.attempts + 1,
             failedStage: "review_launch",
             lastError: error instanceof Error ? error.message : String(error),
-            nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
+            nextAction: "actors_control_apply target=runtime action=review.retry input={\"scope\":\"tool\"}",
             phase: "failed",
             updatedAt: now().toISOString(),
           } satisfies ToolReviewAdmissionState);
@@ -612,7 +612,7 @@ export function createToolReviewScheduler(
           failedStage: "review_launch",
           inputPath: batch.inputPath,
           lastError: error instanceof Error ? error.message : String(error),
-          nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
+          nextAction: "actors_control_apply target=runtime action=review.retry input={\"scope\":\"tool\"}",
           phase: "failed",
           reviewerInputPath: batch.reviewerInputPath,
           reviewId: batch.reviewId,

package/lib/tools-access.ts

@@ -55,7 +55,7 @@ export function sessionMismatchError(input: {
     ),
     {
       current_session: input.currentSession,
-      hint: "inspect target=runtime view=runs",
+      hint: "actors_inspect target=runtime view=runs",
       owner_session: input.expectedSession,
       reason: "session_mismatch",
       run: input.run,

package/lib/tools-inspect.ts

@@ -171,13 +171,13 @@ function runtimeTriage(
     trace_diagnostic_count: traceDiagnostics.length, trace_diagnostics: traceDiagnostics.slice(0, 40),
     attention_events: attentionEvents.slice(-40).reverse(),
     next_actions: [
-      ...(failed.length ? ["inspect target=runtime view=runs status=failed"] : []),
+      ...(failed.length ? ["actors_inspect target=runtime view=runs status=failed"] : []),
       ...new Set([...staleControls, ...backpressuredRuns].slice(0, 3).map((entry) =>
-        `inspect target=run:${entry.run} view=control`,
+        `actors_inspect target=run:${entry.run} view=control`,
       )),
       ...(attentionEvents.length
         ? attentionEvents.slice(-3).map((entry) =>
-            `inspect target=run:${String(entry.run)} view=trace source=runtime`,
+            `actors_inspect target=run:${String(entry.run)} view=trace source=runtime`,
           )
         : []),
     ],
@@ -247,7 +247,7 @@ function formatInspectFailure(
     return { omittable, full, selected };
   });
   // Only producer-known read-only inspect literals become a typed next, never a parsed action.
-  const typedNext = next ? { next: { tool: "inspect", target: next[0], view: next[1] } } : undefined;
+  const typedNext = next ? { next: { tool: "actors_inspect", target: next[0], view: next[1] } } : undefined;
   const nextFallback = { next_action: omitted };
   const document = () => ({ ...Object.assign({}, ...parts.map((part) => part.selected)),
     ...(typedNext ?? nextFallback) });
@@ -412,15 +412,15 @@ function inspectRecipeIdentity(
     ...(rejectedReason ? { rejected_reason: rejectedReason } : {}),
     next_actions: resolvable
       ? [
-          `spawn recipe=${identity}`,
-          `register_tool name=<tool-name> from=${identity}`,
+          `actors_run_spawn recipe=${identity}`,
+          `actors_tool_register name=<tool-name> from=${identity}`,
         ]
       : roots.length === 0 && skill
         ? [
             `activate Skill ${skill}`,
-            `inspect target=recipes view=doctor identity=${identity}`,
+            `actors_inspect target=recipes view=doctor identity=${identity}`,
           ]
-        : ["inspect target=recipes view=imports verbose=true"],
+        : ["actors_inspect target=recipes view=imports verbose=true"],
   };
 }
 
@@ -707,7 +707,7 @@ function compactResult(target: string, view: string, details: Record<string, unk
       ? String(details.next_actions[0])
       : details.callable_now === true
         ? `call tool ${name}`
-        : `register_tool name=${name} update=true`;
+        : `actors_tool_register name=${name} update=true`;
     const hint = ToolsResponse.nextActionMetadata(next, Limits.RUN_DELIVERY_MODEL_MAX_BYTES);
     const required = compactArguments("required_args", details.required_args);
     const optional = compactArguments("optional_args", details.optional_args);
@@ -727,7 +727,7 @@ export function createInspectToolDefinition<TContext = unknown>(
   deps: InspectToolDeps<TContext> = {},
 ): any {
   return {
-    name: "inspect",
+    name: "actors_inspect",
     label: "Inspect",
     description:
       "Inspect a Run's Recipe, Trace, or Control evidence, or runtime/recipe/tool diagnostics.",

package/lib/tools-message.ts

@@ -1,5 +1,5 @@
 /**
- * Public Control facade under the stable `message` tool name.
+ * Public Control facade under the stable `actors_control_apply` tool name.
  * Zones: Control request validation, Run/runtime dispatch, recipient-scoped receipts
  * Owns public Control execution; journaling, delivery, and lifecycle mutation stay in Run domains.
  */
@@ -52,9 +52,9 @@ function controlDocument(render: () => ControlDocument, order: readonly ControlP
 
 /** Only producer-known read-only inspect literals become typed next; other advice stays opaque content. */
 function controlNextPart(action: string): ControlPart {
-  const inspect = /^inspect target=([^\s]+) view=([^\s]+)$/u.exec(action);
+  const inspect = /^actors_inspect target=([^\s]+) view=([^\s]+)$/u.exec(action);
   if (inspect) {
-    return ToolsResponse.selectYamlNode("next", { tool: "inspect", target: inspect[1], view: inspect[2] }, CONTROL_BUDGET);
+    return ToolsResponse.selectYamlNode("next", { tool: "actors_inspect", target: inspect[1], view: inspect[2] }, CONTROL_BUDGET);
   }
   const wellFormed = action.isWellFormed();
   const omitted: ControlDocument = { next: { instruction: wellFormed ? "[omitted]" : "[unavailable]",
@@ -123,15 +123,15 @@ export function compactControlResult(
 }
 
 function runNextActions(run: string, result: Record<string, unknown>): string[] {
-  if (result.stopped === true) return [`inspect target=run:${run} view=trace`];
+  if (result.stopped === true) return [`actors_inspect target=run:${run} view=trace`];
   if (result.stopped === false || result.archived === false || result.pruned === false) {
     if (result.reason === "ownership changed" || result.reason === "run generation changed") {
-      return ["inspect target=runtime view=runs"];
+      return ["actors_inspect target=runtime view=runs"];
     }
-    if (result.stopped === false && result.reason !== "not running") return [`inspect target=run:${run} view=trace`];
+    if (result.stopped === false && result.reason !== "not running") return [`actors_inspect target=run:${run} view=trace`];
   }
   if (result.delivery === "queued" || result.delivery === "delivered") {
-    return [`inspect target=run:${run} view=control`];
+    return [`actors_inspect target=run:${run} view=control`];
   }
   return [];
 }
@@ -148,10 +148,10 @@ export function createControlToolDefinition<TContext = unknown>(
   deps: ControlToolDeps = {},
 ): any {
   return {
-    name: "message",
+    name: "actors_control_apply",
     label: "Control",
     description:
-      "Apply one Control action to an existing Run or the pi-actors runtime.",
+      "Apply one Run/runtime Control action. This is not chat or peer messaging.",
     parameters: Schema.objectSchema(
       {
         target: Schema.stringSchema("Run target run:<id>, or literal runtime."),
@@ -260,7 +260,7 @@ export function createControlToolDefinition<TContext = unknown>(
             // Admission-era correlation is not current reply-scope proof after an awaited dispatch.
             // Display one whole caller-owned id or an explicit whole-id omission; the warning stays literal.
             const identity = controlSelected("run", run);
-            const next = controlNextPart("inspect target=runtime view=runs");
+            const next = controlNextPart("actors_inspect target=runtime view=runs");
             const render = (): ControlDocument => ({ ...identity.selected, action: request.action,
               result: "request failed", delivery: "unconfirmed", handling: "unconfirmed",
               warning: "Effects may already exist.\nDo not repeat automatically.", ...next.selected });

package/lib/tools-register.ts

@@ -1,7 +1,7 @@
 /**
- * Public register_tool behavior
- * Zones: runtime tool registration, tool registry mutation, register_tool schema
- * Owns the public register_tool definition that persists local agent capabilities
+ * Public actors_tool_register behavior
+ * Zones: runtime tool registration, tool registry mutation, actors_tool_register schema
+ * Owns the public actors_tool_register definition that persists local agent capabilities
  */
 
 import * as Prompts from "./prompts.ts";
@@ -24,7 +24,7 @@ export function createRegisterToolDefinition<TContext>(
   deps: RegisterToolRuntimeDeps<TContext>,
 ) {
   return {
-    name: "register_tool",
+    name: "actors_tool_register",
     label: "Register Tool",
     description: Prompts.REGISTER_TOOL_DESCRIPTION,
     promptSnippet: Prompts.REGISTER_TOOL_PROMPT_SNIPPET,