@amaster.ai/employee-runtime-connector 0.1.0-beta.53 → 0.1.0-beta.54

package/dist/amaster-runtime-daemon.mjs

@@ -1789,8 +1789,82 @@ function syncAmasterProviderFiles(agentDir, executorEnv) {
   };
 }
 
+// src/amaster-runtime-daemon/pi-mcp-args-normalizer.mjs
+function isJsonObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function escapeLiteralJsonStringControlCharacters(value) {
+  let output = "";
+  let inString = false;
+  let escaped = false;
+  let changed = false;
+  for (const character of value) {
+    if (!inString) {
+      output += character;
+      if (character === '"') inString = true;
+      continue;
+    }
+    if (escaped) {
+      output += character;
+      escaped = false;
+      continue;
+    }
+    if (character === "\\") {
+      output += character;
+      escaped = true;
+      continue;
+    }
+    if (character === '"') {
+      output += character;
+      inString = false;
+      continue;
+    }
+    const escapedControlCharacter = character === "\n" ? "\\n" : character === "\r" ? "\\r" : character === "	" ? "\\t" : character === "\b" ? "\\b" : character === "\f" ? "\\f" : character.charCodeAt(0) < 32 ? `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}` : null;
+    if (escapedControlCharacter) {
+      output += escapedControlCharacter;
+      changed = true;
+    } else {
+      output += character;
+    }
+  }
+  return changed ? output : value;
+}
+function normalizePiMcpProxyArgs(value) {
+  if (typeof value !== "string") return { value, repaired: false };
+  try {
+    JSON.parse(value);
+    return { value, repaired: false };
+  } catch {
+    const repairedValue = escapeLiteralJsonStringControlCharacters(value);
+    if (repairedValue === value) return { value, repaired: false };
+    try {
+      return isJsonObject(JSON.parse(repairedValue)) ? { value: repairedValue, repaired: true } : { value, repaired: false };
+    } catch {
+      return { value, repaired: false };
+    }
+  }
+}
+function registerManagedPiMcpArgsNormalizer(pi) {
+  pi.on("tool_call", (event) => {
+    if (event?.toolName !== "mcp" || !event.input || typeof event.input !== "object") return;
+    const normalized = normalizePiMcpProxyArgs(event.input.args);
+    if (normalized.repaired) event.input.args = normalized.value;
+  });
+}
+function managedPiMcpArgsNormalizerExtensionSource() {
+  return [
+    isJsonObject.toString(),
+    escapeLiteralJsonStringControlCharacters.toString(),
+    normalizePiMcpProxyArgs.toString(),
+    `export default ${registerManagedPiMcpArgsNormalizer.toString()};`,
+    ""
+  ].join("\n\n");
+}
+
 // src/amaster-runtime-daemon/pi-managed-mcp-profile.mjs
 var MANAGED_PI_MCP_TOOL_MODE = "proxy_only";
+var MANAGED_PI_MCP_ARGS_NORMALIZATION = "json_string_control_characters_v1";
+var MANAGED_PI_MCP_ARGS_NORMALIZER_FILENAME = "amaster-mcp-args-normalizer.mjs";
 function createManagedPiMcpProfileApi(options = {}) {
   const spawnSyncImpl = typeof options.spawnSync === "function" ? options.spawnSync : spawnSync2;
   const nowImpl = typeof options.now === "function" ? options.now : Date.now;
@@ -2247,6 +2321,12 @@ function createManagedPiMcpProfileApi(options = {}) {
     };
     writePrivateFile2(join4(agentDir, "settings.json"), `${JSON.stringify(settings, null, 2)}
 `);
+    const extensionsDir = join4(agentDir, "extensions");
+    mkdirSync3(extensionsDir, { recursive: true, mode: 448 });
+    writePrivateFile2(
+      join4(extensionsDir, MANAGED_PI_MCP_ARGS_NORMALIZER_FILENAME),
+      managedPiMcpArgsNormalizerExtensionSource()
+    );
     copyPrivateFile(join4(source, "models.json"), join4(agentDir, "models.json"));
     const authSource = join4(source, "auth.json");
     const protectedValues = [];
@@ -2395,6 +2475,7 @@ ${result3.stderr ?? ""}`, "Pi", MINIMUM_PI_VERSION);
         ...executorAttestation,
         mcpAdapterVersion: seededRuntime.adapterVersion,
         mcpToolMode: MANAGED_PI_MCP_TOOL_MODE,
+        mcpArgsNormalization: MANAGED_PI_MCP_ARGS_NORMALIZATION,
         configMode: "isolated_home_run_scoped_mcp_file",
         namespace: SUPPORTED_SERVER_NAME2,
         schemaVersion: SUPPORTED_SCHEMA_VERSION2,
@@ -2910,8 +2991,14 @@ function removeRunCompletionState(directory, commandId) {
 }
 
 // src/amaster-runtime-daemon/prompt-compiler.mjs
-var DEADLINE_POSTURE_GUARD = "Named-window:skip_this_window_and_continue; no lower-quality/approval-bypass/fabrication/whole-task-stop; deadline_posture_receipt=targetMilestoneRef,posture,onMiss,taskContinuation,next owner/action; not Server proof";
+var DEADLINE_POSTURE_GUARD = "If a named time window or milestone is missed, skip that window and keep the task moving: never lower quality, bypass approvals, fabricate results, or stop the whole task because of the miss. Record a deadline-posture receipt with targetMilestoneRef, posture, onMiss=skip_this_window_and_continue, taskContinuation, and the next owner/action; the receipt is an execution signal, not Server-side proof.";
 var MIN_PROMPT_BUDGET_CHARS = 8192;
+var MAX_RESOLVED_DEPENDENCY_REQUIRED_READS = 20;
+function promptBudgetError(code, message) {
+  const error = new Error(message);
+  error.code = code;
+  return error;
+}
 var CONTINUATION_WAKE_PATTERN = /(continuation|continued|retry|approved|liveness|resume|max_turn)/i;
 var RECOVERY_WAKE_REASONS = /* @__PURE__ */ new Set([
   "finish_successful_run_handoff",
@@ -2933,7 +3020,7 @@ function jsonCharLength(value) {
 function estimatedTokens(chars) {
   return Math.ceil(chars / 4);
 }
-function contextMode(input) {
+function promptContextMode(input) {
   const nativeSession = asRecord(input.nativeSession);
   if (nativeSession.mode === "governed_action_approval" || readString(input.context?.resumeFromRunId) || isRecoveryWakeReason(input.wakeReason) || CONTINUATION_WAKE_PATTERN.test(input.wakeReason ?? "")) return "continuation";
   if (nativeSession.resume === true || Object.keys(asRecord(input.context?.paperclipContinuationSummary)).length > 0) {
@@ -2941,6 +3028,22 @@ function contextMode(input) {
   }
   return "cold";
 }
+function filterDuplicatedTaskComments(context, mode) {
+  if (mode !== "cold") return context;
+  const record5 = asRecord(context);
+  const included = new Set(
+    (Array.isArray(record5.paperclipTaskMarkdownCommentIds) ? record5.paperclipTaskMarkdownCommentIds : []).map((entry) => readString(entry)).filter(Boolean)
+  );
+  if (included.size === 0) return context;
+  const wake = asRecord(record5.paperclipWake);
+  const comments = Array.isArray(wake.comments) ? wake.comments : [];
+  const kept = comments.filter((entry) => {
+    const id = readString(asRecord(entry).id);
+    return !id || !included.has(id);
+  });
+  if (kept.length === comments.length) return context;
+  return { ...record5, paperclipWake: { ...wake, comments: kept } };
+}
 function commentRefs(context) {
   const comments = Array.isArray(asRecord(context.paperclipWake).comments) ? asRecord(context.paperclipWake).comments : [];
   return comments.map((entry) => readString(asRecord(entry).id)).filter(Boolean);
@@ -3036,6 +3139,7 @@ function resolvedDependencySections(context, input, contextScope, snapshotFreshn
   }
   const summaries = contextCopy ?? wakeCopy ?? [];
   const tuples = [];
+  const overflowRefs = [];
   const seenTuples = /* @__PURE__ */ new Set();
   const detailLines = [];
   const detailSourceRefs = [];
@@ -3086,15 +3190,19 @@ function resolvedDependencySections(context, input, contextScope, snapshotFreshn
       ]);
       if (seenTuples.has(tupleKey)) continue;
       seenTuples.add(tupleKey);
-      tuples.push({
-        blockerId,
-        blockerSelector,
-        documentId,
-        key,
-        expectedLatestRevisionId,
-        expectedLatestRevisionNumber: latestRevisionNumber ?? null,
-        observedAt: readString(document.updatedAt) ?? blockerObservedAt
-      });
+      if (tuples.length >= MAX_RESOLVED_DEPENDENCY_REQUIRED_READS) {
+        overflowRefs.push({ selector: blockerSelector, key });
+      } else {
+        tuples.push({
+          blockerId,
+          blockerSelector,
+          documentId,
+          key,
+          expectedLatestRevisionId,
+          expectedLatestRevisionNumber: latestRevisionNumber ?? null,
+          observedAt: readString(document.updatedAt) ?? blockerObservedAt
+        });
+      }
       const documentTitle = readString(document.title);
       detailLines.push(
         `  Document: ${key}${documentTitle ? ` (${documentTitle})` : ""}${latestRevisionNumber != null ? ` revision ${latestRevisionNumber}` : ""}`
@@ -3113,6 +3221,11 @@ function resolvedDependencySections(context, input, contextScope, snapshotFreshn
       if (workProductSummary) detailLines.push(`    ${workProductSummary}`);
     }
   }
+  if (overflowRefs.length > 0) {
+    detailLines.push(
+      `  \u2026mandatory required reads are capped at ${MAX_RESOLVED_DEPENDENCY_REQUIRED_READS}; the remaining ${overflowRefs.length} predecessor document(s) are listed under On-demand Context References.`
+    );
+  }
   const requiredLines = tuples.length > 0 ? [
     "Accepted predecessor outputs are binding inputs unless this issue explicitly requests reconsideration.",
     "Before any downstream document/artifact write, review request, status mutation, or completion, perform every Required read.",
@@ -3148,7 +3261,8 @@ function resolvedDependencySections(context, input, contextScope, snapshotFreshn
       observedAt: detailObservedAt,
       freshness: detailSourceRefs.map(() => snapshotFreshness),
       scope: detailSourceRefs.map(() => contextScope)
-    }
+    },
+    overflowRefs
   };
 }
 function verifiedCompanyContextSection(context) {
@@ -3180,12 +3294,29 @@ function verifiedCompanyContextSection(context) {
     ].filter(Boolean)
   };
 }
+function wikiAccessRuleLine(input) {
+  const access = asRecord(input.wikiAccess);
+  const tools = input.hasGovernedMcp === true && access.tools === true;
+  const treePath = readString(access.treePath);
+  if (tools && treePath) {
+    return `- Company wiki access in this run: the governed tools wiki_search / wiki_read_page / wiki_list_pages via the amaster MCP, and the wiki tree at ${treePath} (read wiki/index.md there first).`;
+  }
+  if (tools) {
+    return "- Company wiki access in this run: the governed tools wiki_search / wiki_read_page / wiki_list_pages via the amaster MCP. Use them for targeted lookup before re-deriving knowledge the company already holds.";
+  }
+  if (treePath) {
+    return `- Company wiki access in this run: the wiki tree at ${treePath}. Read wiki/index.md first (every page listed with a one-line summary), then open the specific pages you need; wiki_* tools are not available in this run.`;
+  }
+  return "";
+}
 function fixedRules(input, includeIssueLine) {
   return [
     "## AMaster Runtime Connector Task",
     "MirrorX task.",
     "Use only the declared workspace; make concrete progress and report concisely.",
-    "Before changing the task status to done, audit every explicit requirement in the task against the final evidence. A successful tool or document write proves delivery, not acceptance: inspect the delivered content for required sections, diagrams, tables, and factual constraints. Do not leave stale in-progress wording such as \u201Ccurrent run\u201D in a terminal deliverable; rewrite it to the final observed state. Do not list finalization itself as remaining or next work in a terminal deliverable. If any requirement is missing or cannot be verified, do not mark done. To request review, use create_interaction with kind request_confirmation and payload.resolutionMode review; never call update_parent with status in_review. Otherwise keep the issue todo or blocked with the exact gap and next owner.",
+    "Before changing the task status to done, audit every explicit requirement in the task against the final evidence. A successful tool or document write proves delivery, not acceptance: inspect the delivered content for required sections, diagrams, tables, and factual constraints.",
+    "Do not leave stale in-progress wording such as \u201Ccurrent run\u201D in a terminal deliverable; rewrite it to the final observed state. Do not list finalization itself as remaining or next work in a terminal deliverable.",
+    "If any requirement is missing or cannot be verified, do not mark done. To request review, use create_interaction with kind request_confirmation and payload.resolutionMode review; never call update_parent with status in_review. Otherwise keep the issue todo or blocked with the exact gap and next owner.",
     DEADLINE_POSTURE_GUARD,
     "Do not install operating-system or user-global packages, and do not use host package managers such as brew, apt, yum, or global pip/npm installs. Use tools already available or workspace-local dependencies or virtual environments. If a required renderer or evaluator is unavailable, keep the source artifact, record the exact verification gap, and do not mutate the host.",
     `- command id: ${input.commandId}`,
@@ -3198,9 +3329,10 @@ function fixedRules(input, includeIssueLine) {
     input.managed ? "Use the execution workspace as cwd. Never recursively scan the source workspace, the user's home directory, or any path outside the execution workspace. Only inspect a specific external source path when the task explicitly requires that exact path." : "",
     input.wakeReason ? `- wake reason: ${input.wakeReason}` : "",
     input.hasGovernedMcp ? "- AMaster mutations are available only through the managed amaster MCP server. Use discovered tools and immediate typed results; never call AMaster mutation REST endpoints directly." : "- No mutation channel is available for this command. Keep the run read-only and report the missing Runtime V2 capability as a blocker.",
+    wikiAccessRuleLine(input),
     "- Runtime Artifact lineage fields sourceWorkProductId and sourceWorkProductIds accept only current artifact work product ids returned as result.effectResult.workProductId by a succeeded upload_artifact action. Never pass a documentId or revisionId as artifact lineage.",
     "- When all inputs are issue documents and there is no source artifact work product, persist the derived result with upsert_document and do not call upload_artifact for a derived or review artifact.",
-    input.hasGovernedMcp && input.executorKind === "pi" && input.managedMcpToolMode === "proxy_only" ? "- For proxy-only Pi MCP writes, put the complete target argument object directly in the actual `mcp` call's string `args` field, even for long document bodies. Do not create shell, script, or file intermediates to stage or quote a would-be tool call, and do not narrate or print it as prose. After the needed `runtime_action.describe` result, emit the write call before further planning." : ""
+    input.hasGovernedMcp && input.executorKind === "pi" && input.managedMcpToolMode === "proxy_only" ? "- For proxy-only Pi MCP writes, put the complete target argument object directly in actual `mcp` string `args` as strict JSON; escape quotes, backslashes, and control characters. Do not stage or print tool calls. If inner JSON syntax fails, correct it once without changing values; never repeat a possibly accepted call. After `runtime_action.describe`, emit the write." : ""
   ].filter(Boolean).join("\n");
 }
 function approvalContinuationText(input) {
@@ -3360,6 +3492,25 @@ function runtimeDecompositionRequirementText(context) {
     `Requirement source: ${sourceType}:${sourceId}@${sourceRevision}`
   ].join("\n");
 }
+function readIssueEvidenceCommentCallText(issueId, commentId, options) {
+  const readArguments = { refs: [{ kind: "issue_comment", issueId, commentId }] };
+  if (options?.executorKind === "pi" && options?.managedMcpToolMode === "proxy_only") {
+    return `emit an mcp proxy call: ${JSON.stringify({ server: "amaster", tool: "amaster.read_issue_evidence", args: JSON.stringify(readArguments) })}`;
+  }
+  return `call amaster.read_issue_evidence with these exact arguments: ${JSON.stringify(readArguments)}`;
+}
+function overflowDependencyRefsText(overflowRefs) {
+  if (!Array.isArray(overflowRefs) || overflowRefs.length === 0) return "";
+  return [
+    "Additional predecessor documents available on demand \u2014 fetch each with amaster.read_issue_document before relying on it:",
+    ...overflowRefs.map((ref) => `- issue ${JSON.stringify(ref.selector)}, key ${JSON.stringify(ref.key)}`)
+  ].join("\n");
+}
+function taskCommentRefGuidance(input) {
+  if (!input.hasGovernedMcp || !readString(input.issueId)) return "";
+  const call = readIssueEvidenceCommentCallText(input.issueId, "<id>", input);
+  return `References like comment:<id> above mark truncated comment bodies. Fetch the full text before relying on them \u2014 ${call} (replace <id> with the referenced comment id).`;
+}
 function piMcpProxyExamplesText(input) {
   if (!input.hasGovernedMcp || input.executorKind !== "pi" || input.managedMcpToolMode !== "proxy_only" || isRecoveryWakeReason(input.wakeReason)) return "";
   const proxy = (tool, args) => JSON.stringify({
@@ -3370,10 +3521,11 @@ function piMcpProxyExamplesText(input) {
   return [
     "The Pi native tool is the outer `mcp` proxy. Emit these as actual tool calls; `args` is the stringified inner canonical object:",
     "Keep review payload strings short. Reference the exact document key and revision in `target`; do not duplicate the reviewed document body in `prompt` or `detailsMarkdown`.",
+    "update_parent.comment creates a separate persistent issue comment. Omit it when add_comment already recorded the message.",
     `- describe: ${proxy("runtime_action.describe", { schemaVersion: "runtime-action-v1", actionType: "update_parent" })}`,
-    `- submit: ${proxy("runtime_action.submit", { schemaVersion: "runtime-action-v1", idempotencyKey: "task-123-progress", action: { type: "update_parent", status: "in_progress", comment: "Continue the remaining work." } })}`,
+    `- submit: ${proxy("runtime_action.submit", { schemaVersion: "runtime-action-v1", idempotencyKey: "task-123-progress", action: { type: "update_parent", status: "in_progress" } })}`,
     `- submit review interaction: ${proxy("runtime_action.submit", { schemaVersion: "runtime-action-v1", idempotencyKey: "task-123-review", action: { type: "create_interaction", kind: "request_confirmation", continuationPolicy: "wake_assignee_on_accept", payload: { version: 1, resolutionMode: "review", prompt: "Review `plan` revision 1.", target: { type: "issue_document", issueId: "11111111-1111-4111-8111-111111111111", documentId: "33333333-3333-4333-8333-333333333333", key: "plan", revisionId: "22222222-2222-4222-8222-222222222222", revisionNumber: 1 } } } })}`,
-    `- plan: ${proxy("runtime_action.plan", { schemaVersion: "runtime-action-v1", idempotencyKey: "task-123-plan", actions: [{ type: "update_parent", status: "in_progress", comment: "Continue the remaining work." }] })}`,
+    `- plan: ${proxy("runtime_action.plan", { schemaVersion: "runtime-action-v1", idempotencyKey: "task-123-plan", actions: [{ type: "update_parent", status: "in_progress" }] })}`,
     `- commit the returned plan revision: ${proxy("runtime_action.commit", { schemaVersion: "runtime-action-v1", planId: "11111111-1111-4111-8111-111111111111", revision: "plan-revision-1" })}`,
     `- read document: ${proxy("amaster.read_issue_document", { issueId: "AM-123", key: "plan" })}`
   ].join("\n");
@@ -3444,7 +3596,7 @@ function compileCommandPromptWithManifest(input, options = {}) {
     throw new RangeError(`Prompt budget must be an integer of at least ${MIN_PROMPT_BUDGET_CHARS} characters`);
   }
   const context = asRecord(input.context);
-  const mode = contextMode(input);
+  const mode = promptContextMode(input);
   const recoveryInstruction = recoveryInstructionText(input);
   const recoveryContinuationOption = recoveryInstruction ? runtimeActionContinuationOptionText(input) : "";
   const completeRecoveryInstruction = [recoveryInstruction, recoveryContinuationOption].filter(Boolean).join("\n\n");
@@ -3456,7 +3608,8 @@ function compileCommandPromptWithManifest(input, options = {}) {
   const continuationSummary = continuationText(context);
   const includeTask = mode === "cold" || !continuationSummary && asRecord(input.nativeSession).mode !== "governed_action_approval";
   const wakeBodies = commentBodies(context);
-  const commentsDuplicatedByTask = hasTask && wakeBodies.length > 0 && wakeBodies.every((body) => taskText.includes(body));
+  const hasTaskCommentIds = Array.isArray(context.paperclipTaskMarkdownCommentIds);
+  const commentsDuplicatedByTask = !hasTaskCommentIds && hasTask && wakeBodies.length > 0 && wakeBodies.every((body) => taskText.includes(body));
   const commentsSelected = mode !== "cold" || !commentsDuplicatedByTask;
   const interactionResolution = interactionResolutionText(context);
   const selectedComments = commentsSelected ? readString(input.comments) ?? "" : "";
@@ -3502,11 +3655,11 @@ ${resolvedDependencies.details.content}` : ""
     { name: "continuation_summary", title: "Continuation Summary", priority: 97, sourceRef: readString(asRecord(context.paperclipContinuationSummary).key) ?? `issue:${input.issueId ?? "unknown"}`, observedAt: readString(asRecord(context.paperclipContinuationSummary).updatedAt), originalContent: continuationSummary, content: mode === "cold" ? "" : continuationSummary, truncationReason: mode === "cold" ? "mode_selection" : null },
     ...verifiedCompanyContext.content ? [{ name: "verified_company_context", title: "Verified Company Context", priority: 96, sourceRef: verifiedCompanyContext.sourceRef, observedAt: verifiedCompanyContext.observedAt, freshness: { kind: "run_snapshot" }, content: verifiedCompanyContext.content }] : [],
     { name: "wake_comments", title: wakeDeltaTitle, priority: interactionResolution ? 99 : 95, sourceRef: wakeDeltaSourceRefs, originalContent: wakeDeltaOriginal, content: wakeDeltaContent, truncationReason: commentsSelected ? null : "duplicate_task_context" },
-    { name: "task", title: "Task Context", priority: 90, sourceRef: `issue:${input.issueId ?? "unknown"}`, originalContent: taskText, content: includeTask ? taskText : "", truncationReason: includeTask ? null : "mode_selection" },
+    { name: "task", title: "Task Context", priority: 90, sourceRef: `issue:${input.issueId ?? "unknown"}`, originalContent: [taskText, taskCommentRefGuidance(input)].filter(Boolean).join("\n"), content: includeTask ? [taskText, taskCommentRefGuidance(input)].filter(Boolean).join("\n") : "", truncationReason: includeTask ? null : "mode_selection" },
     { name: "governed_reads", title: "Governed External Reads", priority: 88, sourceRef: governedReads.provenance.map((entry) => entry.sourceRef), observedAt: governedReads.provenance.map((entry) => entry.observedAt), freshness: governedReads.provenance.map((entry) => entry.freshness), scope: governedReads.provenance.map((entry) => entry.scope), content: governedReads.content },
     { name: "agent_instructions", title: "Agent Instructions", priority: 100, sourceRef: "agent_instructions_bundle", content: readString(input.agentInstructions) ?? "" },
     { name: "attachments", title: "Materialized Inputs", priority: 80, sourceRef: "materialized_attachments", content: readString(input.attachmentsText) ?? "" },
-    { name: "on_demand_refs", title: "On-demand Context References", priority: 70, sourceRef: `issue:${input.issueId ?? "unknown"}`, content: onDemandRefs(input) },
+    { name: "on_demand_refs", title: "On-demand Context References", priority: 70, sourceRef: `issue:${input.issueId ?? "unknown"}`, content: [onDemandRefs(input), overflowDependencyRefsText(resolvedDependencies.overflowRefs)].filter(Boolean).join("\n") },
     { name: "raw_snapshot", title: "Raw Context Snapshot", priority: 0, sourceRef: `run:${input.runId ?? "unknown"}`, originalChars: jsonCharLength(context), content: "", truncationReason: "on_demand_large_object" }
   ];
   const seenContent = /* @__PURE__ */ new Set();
@@ -3560,17 +3713,24 @@ ${resolvedDependencies.details.content}` : ""
       const fixedChars = sections.filter((section) => section.priority === 100).map(sectionText).join("\n").length;
       const manifestChars = JSON.stringify(manifest).length;
       if (resolvedDependencies.required.tupleCount > 0) {
-        throw new Error(
+        throw promptBudgetError(
+          "resolved_dependencies_budget_exceeded",
           `Resolved dependency mandatory read tuples exceed the unified ${maxChars}-character prompt budget: tupleCount=${resolvedDependencies.required.tupleCount} promptChars=${prompt.length} fixedChars=${fixedChars} manifestChars=${manifestChars}`
         );
       }
-      throw new Error(`Prompt fixed sections exceed the unified ${maxChars}-character budget: promptChars=${prompt.length} fixedChars=${fixedChars} manifestChars=${manifestChars}`);
+      throw promptBudgetError(
+        "prompt_budget_exceeded",
+        `Prompt fixed sections exceed the unified ${maxChars}-character budget: promptChars=${prompt.length} fixedChars=${fixedChars} manifestChars=${manifestChars}`
+      );
     }
     truncateSection(candidate, Math.max(0, candidate.content.length - overflow - 32));
     manifest = buildManifest(mode, maxChars, sections, governedReads.provenance, 0);
   }
   if (prompt.length > maxChars || manifest.budget.usedChars !== prompt.length) {
-    throw new Error(`Prompt compiler could not satisfy the unified ${maxChars}-character budget`);
+    throw promptBudgetError(
+      "prompt_budget_exceeded",
+      `Prompt compiler could not satisfy the unified ${maxChars}-character budget`
+    );
   }
   return { prompt, manifest };
 }
@@ -6775,6 +6935,7 @@ var ARTIFACT_EXTENSIONS = /* @__PURE__ */ new Map([
   [".jpeg", "image"],
   [".webp", "image"],
   [".gif", "image"],
+  [".svg", "image"],
   [".mp4", "video"],
   [".m4v", "video"],
   [".mov", "video"],
@@ -6812,7 +6973,7 @@ function isSafeRelativePath(value) {
   const text = String(value ?? "").trim().split(/[\\/]+/).join("/");
   if (!text || text.startsWith("../") || text === ".." || text.startsWith("/")) return false;
   const segments = text.split("/").filter(Boolean);
-  return !SECRET_PATH_PATTERN.test(text) && !RUNTIME_INSTRUCTION_FILENAMES.has(basename5(text)) && !segments.some((segment) => segment === ".venv" || segment === "venv");
+  return !SECRET_PATH_PATTERN.test(text) && !RUNTIME_INSTRUCTION_FILENAMES.has(basename5(text)) && !segments.some((segment) => segment.startsWith(".")) && !segments.some((segment) => segment === ".venv" || segment === "venv");
 }
 function gitStatusPath(line) {
   if (line.startsWith("?? ")) return line.slice(3);
@@ -6886,8 +7047,7 @@ function scanArtifactCandidates(cwd, opts = {}) {
       }
       if (!entry.isFile()) continue;
       const ext = extname(entry.name).toLowerCase();
-      const type = ARTIFACT_EXTENSIONS.get(ext);
-      if (!type) continue;
+      const type = ARTIFACT_EXTENSIONS.get(ext) ?? "file";
       let stat;
       try {
         stat = statSync6(fullPath);
@@ -8744,11 +8904,10 @@ function createPublicNetworkScope(options = {}) {
 }
 
 // src/amaster-runtime-daemon.mjs
-var CONNECTOR_VERSION = "0.1.0-beta.53";
+var CONNECTOR_VERSION = "0.1.0-beta.54";
 var CONNECTOR_CONTRACT_VERSION = "2026-06-04.v1";
 var MAX_CHECKPOINT_BYTES = 20 * 1024 * 1024;
 var CHECKPOINT_TTL_MS = 24 * 60 * 60 * 1e3;
-var PROMPT_AGENT_INSTRUCTION_FILE_ORDER = ["AGENTS.md", "SOUL.md"];
 var AMASTER_PI_PROHIBITED_EXTRA_ARGS = /* @__PURE__ */ new Set(["--no-extensions", "--no-skills", "--no-tools", "--no-session"]);
 var MAX_PI_CAPABILITY_SOURCE_ENTRIES = 200;
 var PI_COMPLETION_OUTPUT_GRACE_MS = 1e3;
@@ -9869,51 +10028,46 @@ function renderIssueLine(context) {
   const title = readString(issue.title);
   return [identifier, title].filter(Boolean).join(" ");
 }
-function renderComments(context) {
+function renderComments(context, options = {}) {
   const wake = asRecord(context.paperclipWake);
   const comments = Array.isArray(wake.comments) ? wake.comments : [];
+  const issueId = readString(options.issueId) ?? "";
+  let truncatedCount = 0;
   const rendered = comments.map((entry, index) => {
     const comment = asRecord(entry);
     const id = readString(comment.id) ?? `comment-${index + 1}`;
     const body = readString(comment.body) ?? "";
-    const truncatedNote = comment.bodyTruncated === true ? `
-[comment body truncated \u2014 fetch full text via typed read tool: comment:${id}]` : "";
+    const truncated = comment.bodyTruncated === true;
+    if (truncated) truncatedCount += 1;
+    const truncatedNote = truncated ? `
+[comment body truncated \u2014 fetch the full text before relying on it: comment:${id}]` : "";
     return `${index + 1}. ${id}
 ${body}${truncatedNote}`;
   }).filter((entry) => entry.trim().length > 0).join("\n\n");
-  const fallbackNote = wake.fallbackFetchNeeded === true ? "[some wake comments were truncated or omitted from this prompt \u2014 fetch full text via managed typed read tools using the comment:<id> references]" : "";
-  return [rendered, fallbackNote].filter(Boolean).join("\n\n");
+  const guidance = [];
+  if (truncatedCount > 0 && issueId) {
+    guidance.push(
+      `Truncated comments above are marked comment:<id>. Fetch the full text before relying on a truncated comment \u2014 ${readIssueEvidenceCommentCallText(issueId, "<id>", options)} (replace <id> with the referenced comment id).`
+    );
+  }
+  if (wake.fallbackFetchNeeded === true) {
+    guidance.push(
+      "[some wake comments were truncated or omitted from this prompt \u2014 fetch full text via amaster.read_issue_evidence using the comment:<id> references]"
+    );
+  }
+  return [rendered, ...guidance].filter(Boolean).join("\n\n");
 }
 function renderTaskMarkdown(context) {
   return readString(context.paperclipTaskMarkdown);
 }
-function normalizeAgentInstructionsFiles(bundle) {
-  const files = asRecord(bundle.files);
-  const selected = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const path of PROMPT_AGENT_INSTRUCTION_FILE_ORDER) {
-    const content = readString(files[path]);
-    if (!content) continue;
-    selected.push({ path, content });
-    seen.add(path);
-  }
-  const entryFile = readString(bundle.entryFile);
-  if (entryFile && !seen.has(entryFile)) {
-    const content = readString(files[entryFile]);
-    if (content) {
-      selected.push({ path: entryFile, content });
-      seen.add(entryFile);
-    }
-  }
-  return selected;
-}
 function renderAgentInstructionsBundle(bundle) {
-  const files = normalizeAgentInstructionsFiles(asRecord(bundle));
-  if (files.length === 0) return "";
+  const files = asRecord(asRecord(bundle).files);
+  const names = Object.keys(files).filter((path) => readString(files[path])).sort((left, right) => left === right ? 0 : left === "AGENTS.md" ? -1 : right === "AGENTS.md" ? 1 : left.localeCompare(right));
+  if (names.length === 0) return "";
   return [
-    "Current agent instructions:",
-    ...files.map((file) => [`### ${file.path}`, file.content].join("\n"))
-  ].join("\n\n");
+    `Current agent instructions are materialized in the execution workspace as: ${names.map((name) => `./${name}`).join(", ")}.`,
+    "They are authoritative for this run and are not inlined here. Read ./AGENTS.md first and follow it (including any sibling files it references) for the whole run."
+  ].join("\n");
 }
 function commandRuntimeAuth(command) {
   const topLevel = asRecord(command.runtimeAuth);
@@ -10064,13 +10218,44 @@ async function materializeAgentInstructionsBundle(config, command, workspace) {
   }
   return materialized;
 }
+function wikiTreePathForCommand(command, workspaceBindings) {
+  const runtimeAuth = commandRuntimeAuth(command);
+  const companyId = readString(runtimeAuth.companyId) ?? readString(asRecord(command.payload).companyId) ?? "";
+  for (const binding of Array.isArray(workspaceBindings) ? workspaceBindings : []) {
+    const root = readString(binding);
+    if (!root) continue;
+    const candidates = [];
+    if (root.endsWith("paperclipai.plugin-llm-wiki")) candidates.push(root);
+    if (basename6(root) === "plugin-data" && companyId) {
+      candidates.push(join15(root, companyId, "paperclipai.plugin-llm-wiki"));
+    }
+    for (const candidate of candidates) {
+      try {
+        if (existsSync14(candidate)) return candidate;
+      } catch {
+      }
+    }
+  }
+  return null;
+}
 function buildCommandPrompt(command, workspace, materializedAttachments = [], options = {}) {
   const workspaceContext = normalizeWorkspaceContext(workspace);
   const cwd = workspaceContext.cwd;
   const payload = asRecord(command.payload);
   const context = asRecord(payload.contextSnapshot);
   const issueLine = renderIssueLine(context);
-  const comments = renderComments(context);
+  const comments = renderComments(
+    filterDuplicatedTaskComments(context, promptContextMode({
+      nativeSession: asRecord(payload.nativeSession),
+      wakeReason: readString(context.wakeReason),
+      context
+    })),
+    {
+      executorKind: options.executorKind,
+      managedMcpToolMode: options.managedMcpToolMode,
+      issueId: commandIssueId(command)
+    }
+  );
   const taskMarkdown = renderTaskMarkdown(context);
   const agentInstructions = renderAgentInstructionsBundle(asRecord(payload.agentInstructionsBundle));
   const runtimeAuth = commandRuntimeAuth(command);
@@ -10110,7 +10295,11 @@ function buildCommandPrompt(command, workspace, materializedAttachments = [], op
     attachmentsText,
     comments,
     context,
-    nativeSession: asRecord(payload.nativeSession)
+    nativeSession: asRecord(payload.nativeSession),
+    wikiAccess: {
+      tools: context.wikiToolsAvailable === true,
+      treePath: wikiTreePathForCommand(command, options.workspaceBindings)
+    }
   });
 }
 function companyPiHomeRoot(baseEnv) {
@@ -12858,7 +13047,8 @@ async function executeRunCommand(config, command) {
   const promptCompilation = buildCommandPrompt(command, workspace, materializedAttachments, {
     executorKind: executor.kind,
     managedMcpToolMode: executor.kind === "pi" && Object.keys(governedMcp).length > 0 ? MANAGED_PI_MCP_TOOL_MODE : null,
-    artifactVerifierCommands: config.artifactVerifierCommands
+    artifactVerifierCommands: config.artifactVerifierCommands,
+    workspaceBindings: config.workspaceBindings
   });
   const nativeSessionRequest = asRecord(asRecord(command.payload).nativeSession);
   const prompt = promptCompilation.prompt;

package/dist/amaster-runtime.mjs

@@ -5,7 +5,7 @@ import { dirname, join, resolve } from "node:path";
 import { homedir, hostname } from "node:os";
 import { fileURLToPath } from "node:url";
 
-const CONNECTOR_VERSION = "0.1.0-beta.53";
+const CONNECTOR_VERSION = "0.1.0-beta.54";
 
 const CAPABILITIES = [
   "remote_registration",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/employee-runtime-connector",
-  "version": "0.1.0-beta.53",
+  "version": "0.1.0-beta.54",
   "description": "MirrorX runtime connector CLI and daemon",
   "license": "MIT",
   "type": "module",