@amaster.ai/employee-runtime-connector 0.1.0-beta.5 → 0.1.0-beta.7

package/dist/amaster-runtime-daemon.mjs

@@ -2335,7 +2335,7 @@ import { copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSy
 import { homedir, hostname } from "node:os";
 import { basename, delimiter, dirname, extname, isAbsolute, join, relative, resolve } from "node:path";
 import { spawn, spawnSync } from "node:child_process";
-const CONNECTOR_VERSION = "0.1.0-beta.5";
+const CONNECTOR_VERSION = "0.1.0-beta.7";
 const MAX_INFERRED_ARTIFACT_UPLOADS = 20;
 const MAX_CHECKPOINT_BYTES = 20 * 1024 * 1024;
 const CHECKPOINT_TTL_MS = 24 * 60 * 60 * 1000;
@@ -3527,6 +3527,7 @@ function runtimeActionsInstruction(options = {}) {
   const artifactVerifierCommands = Array.isArray(options.artifactVerifierCommands)
     ? options.artifactVerifierCommands.map(readString).filter(Boolean)
     : [];
+  const actionValidatorCommand = readString(options.actionValidatorCommand);
   return [
     "Runtime action bridge:",
     "Choose exactly one mutation path for each requested action: direct AMaster API or the runtime action bridge. Never replay the same mutation through both paths.",
@@ -3537,12 +3538,17 @@ function runtimeActionsInstruction(options = {}) {
     "Use update_parent status done when no human review is needed. Prefer creating a pending review path such as request_confirmation, request_checkbox_confirmation, ask_user_questions, or suggest_tasks before status in_review; if a bare in_review update is emitted, AMaster will create a fallback request_confirmation before PATCH.",
     "For create_child_task, do not create ownerless executable todo tasks. Set assigneeAgentId only when the target agent id came from the current AMaster task context or an agent_hire action in this same batch. Do not invent agent ids, role ids, or ids from another company. If you are unsure, omit assigneeAgentId and assigneeUserId; AMaster will assign the current executing agent for todo/in_progress children. Use backlog only when a task is intentionally unassigned.",
     "Creating child tasks and delegating them to existing agents is task execution, not organization orchestration. Use assignee ids only from the current task context; server permissions still decide whether an assignment is allowed.",
+    "Runtime actions use a strict schema. Unknown fields, unsupported action types, duplicate clientKey values, unknown client-key references, and client-key dependency cycles reject the entire batch before any mutation. blockedByIssueIds is supported only on create_child_task for existing issue UUIDs supplied by the current task context; connector preflight checks UUID shape, while the server validates same-company existence and permissions. Do not place it on update_parent or invent fields that are not in the canonical action examples.",
+    "Use native JSON scalar types exactly: booleans such as create_child_task.blockParentUntilDone, top-level deliverables[].required, and create_interaction payload questions[].required must be true or false without quotes. Numbers such as minSelected/maxSelected/version must be numeric literals without quotes. String forms such as \"true\" or \"1\" reject the whole batch; AMaster does not silently coerce them.",
+    "For same-batch relationships, assign a unique clientKey to each agent_hire or create_child_task producer. Use reportsToAgentClientKey for a new agent's manager, assigneeAgentClientKey for a child owner, parentClientKey for a nested child, and blockedByClientKeys for first-class child blockers. Use blockedByIssueIds only when a new child depends on existing issue UUIDs supplied by the current task context; connector preflight checks UUID shape and the server validates same-company existence. References may point forward within the same batch; every referenced key must resolve to the correct resource kind in that batch.",
     options.explicitDecompositionRequired
-      ? "This standard task explicitly requires child task decomposition. The runtime action batch must include create_child_task or one suggest_tasks interaction unless child tasks already exist. A checklist in a comment or artifact is not decomposition. Create independently executable internal preparation tasks now. If any pending interaction and create_child_task actions share the same batch, every todo or in_progress child in that batch must set executeBeforeConfirmation true. Otherwise change the child to backlog or move it into suggest_tasks. Use backlog for recorded work that should not start now, and use suggest_tasks for work that must wait for human approval. When a pending interaction is created, keep the parent in_review rather than in_progress or done."
+      ? "This standard task explicitly requires child task decomposition. The runtime action batch must include create_child_task or one suggest_tasks interaction unless child tasks already exist. A checklist in a comment or artifact is not decomposition. Create independently executable internal preparation tasks now. Use backlog for recorded work that should not start now, and use suggest_tasks for work that must wait for human approval. When a pending interaction is created, keep the parent in_review rather than in_progress or done."
       : "",
-    "If child tasks must wait for a human confirmation, use one suggest_tasks interaction so AMaster creates and wakes the selected tasks only after acceptance. A batch that combines executable create_child_task actions with a pending interaction is rejected before mutation unless every such child is backlog or explicitly sets executeBeforeConfirmation true.",
     options.canOrchestrateOrganization
-      ? "For AMaster organization-building requests, such as creating other roles, hiring digital employees, building the first team, or assigning work to roles, do not stop at a strategy document. Include agent_hire for each needed role and create_child_task for that role's first concrete assignment. If approval is required, create a request_confirmation or leave the hire approval pending. These organization batches must include add_comment or update_parent.comment explaining what was created, requested, assigned, or blocked."
+      ? "Pending-interaction batch gate: before emitting JSON, scan every agent_hire and create_child_task. Every co-batched hire must independently set executeBeforeConfirmation true; every create_child_task must independently be backlog, set executeBeforeConfirmation true, or move into suggest_tasks. blockParentUntilDone=false and a flagged assignee hire do not exempt a child. Otherwise move the hires to a later continuation and use suggest_tasks for work that must wait for acceptance. This applies to every pending interaction, including budget or business approval."
+      : "Pending-interaction batch gate: before emitting JSON, scan every create_child_task. Every create_child_task must independently be backlog, set executeBeforeConfirmation true, or move into suggest_tasks. blockParentUntilDone=false does not exempt a child. Use suggest_tasks for work that must wait for acceptance.",
+    options.canOrchestrateOrganization
+      ? "For AMaster organization-building requests, such as creating other roles, hiring digital employees, building the first team, or assigning work to roles, do not stop at a strategy document. Include agent_hire for each needed role and create_child_task for that role's first concrete assignment. agent_hire already creates the native pending hire approval; do not also ask whether to approve that hire in a create_interaction action in the same batch. If approval must happen before any hire record exists, create only a proposal interaction and hire in a later continuation. These organization batches must include add_comment or update_parent.comment explaining what was created, requested, assigned, or blocked."
       : "",
     options.canOrchestrateOrganization
       ? `For agent_hire, set adapterType explicitly. Default to the current executing agent adapterType${currentAgentAdapterType ? ` (${currentAgentAdapterType})` : ""} unless the task names a different approved adapter.`
@@ -3557,16 +3563,26 @@ function runtimeActionsInstruction(options = {}) {
     "Never use write, bash, cat, printf, echo, or any other tool to emit the marker or JSON. You may prepare and validate the envelope in a temporary workspace file, but the final assistant message itself must contain the exact marker and JSON; tool output is ignored by the runtime action bridge.",
     "The runtime action block must be strict JSON parseable by JSON.parse. Do not use ellipses, placeholders such as [...], comments, trailing commas, single quotes, markdown tables outside quoted strings, or raw double quotes inside string values. Escape quotes and newlines in string values, or generate the block with JSON.stringify / @amaster/runtime-sdk before including it in the final assistant message.",
     "Before final output, validate the runtime action block with JSON.parse. If it would fail, fix the JSON and only then include AMASTER_RUNTIME_ACTIONS in the final assistant message.",
+    actionValidatorCommand
+      ? `Before final output, write only the JSON envelope to .amaster-runtime-actions.json and run this exact strict-schema validator: ${actionValidatorCommand}. Fix every reported error and rerun until it exits 0. JSON.parse alone is not sufficient. Do not include the marker in the temporary file.`
+      : "",
     `Allowed action types: ${allowedActionTypes}.`,
-    "For every create_interaction action, set top-level kind to the interaction kind and set payload to a JSON object. Use this complete canonical request_confirmation example: {\"type\":\"create_interaction\",\"kind\":\"request_confirmation\",\"payload\":{\"version\":1,\"prompt\":\"Confirm this result?\",\"acceptLabel\":\"确认\",\"rejectLabel\":\"调整\"}}. Never use interactionType.",
-    "For create_interaction ask_user_questions, use payload {\"version\":1,\"title\":\"...\",\"questions\":[{\"id\":\"question_key\",\"prompt\":\"Question text\",\"selectionMode\":\"single\",\"required\":true,\"options\":[{\"id\":\"option_key\",\"label\":\"Option label\"}]}]}. Do not use question/options.value at the top level.",
+    "For every create_interaction action, set top-level kind to the interaction kind and set payload to a JSON object. Use this complete canonical request_confirmation example: {\"type\":\"create_interaction\",\"kind\":\"request_confirmation\",\"continuationPolicy\":\"wake_assignee_on_accept\",\"payload\":{\"version\":1,\"prompt\":\"Confirm this result?\",\"acceptLabel\":\"确认\",\"rejectLabel\":\"调整\"}}. Never use interactionType.",
+    "Interactions cannot be updated with PATCH after creation. For direct API calls, include continuationPolicy in the initial POST /api/issues/{issueId}/interactions request and use only the documented POST accept, reject, respond, or cancel resolution endpoint afterward.",
+    "For create_interaction ask_user_questions, use continuationPolicy wake_assignee, never wake_assignee_on_accept, because answering questions does not produce accepted status. Every question requires 1-10 options; do not emit an open-text question without options. The UI provides an Other text answer alongside the declared options. Use payload {\"version\":1,\"title\":\"...\",\"questions\":[{\"id\":\"question_key\",\"prompt\":\"Question text\",\"selectionMode\":\"single\",\"required\":true,\"options\":[{\"id\":\"option_key\",\"label\":\"Option label\"}]}]}. Do not use question/options.value at the top level.",
     "For create_interaction request_confirmation, use payload {\"version\":1,\"prompt\":\"Confirm this result?\",\"acceptLabel\":\"确认\",\"rejectLabel\":\"调整\"}. Do not use options arrays for request_confirmation.",
     "For create_interaction request_checkbox_confirmation, use payload {\"version\":1,\"prompt\":\"Select approved items\",\"options\":[{\"id\":\"option_key\",\"label\":\"Option label\"}],\"minSelected\":1,\"maxSelected\":2,\"acceptLabel\":\"确认\",\"rejectLabel\":\"调整\"}.",
     "For create_interaction suggest_tasks, use payload {\"version\":1,\"tasks\":[{\"clientKey\":\"task_key\",\"title\":\"Task title\",\"description\":\"Task description\",\"priority\":\"medium\"}]}.",
     "When a suggested task should start automatically after acceptance, set assigneeAgentId to an agent id from the current task context. Set assigneeUserId only when a known user must own the task. Omit both assignee fields only when the accepted task should remain intentionally unassigned in backlog. Never substitute a role name for an assignee id.",
+    "An external input or human approval cannot exist only as free-text owner/next-step prose. Create a human-owned create_child_task with assigneeUserId and blockParentUntilDone=true (or another explicit interaction/dependency path), then keep the parent blocked or in_review until it resolves.",
     "Do not copy placeholder names, placeholder summaries, placeholder action arrays, or placeholder paths. Every title, body, role, idempotencyKey, artifact path, and task description must be specific to the current issue and company.",
     "Only include upload_artifact for a file that you actually created in the execution workspace and whose path exists relative to cwd. If no file was created, omit upload_artifact.",
+    "upload_artifact actions do not accept required. Artifact required belongs only to top-level deliverables entries, not action objects.",
+    "When a child artifact is promoted as a replacement for a parent artifact, run upload_artifact on the parent issue and include both sourceWorkProductId (the child artifact) and supersedesWorkProductId (the current parent artifact). Never claim the parent artifact was corrected without this durable lineage.",
+    "For derived artifacts, set evidenceRole=derived, sourceWorkProductIds to every consumed input work product, and scenarioKeys to the unchanged source scenario set. For post-implementation review artifacts, set evidenceRole=review and sourceWorkProductIds to the exact current artifacts reviewed; stale or missing sources fail closed.",
+    "When creating a review child that must run after sibling implementation or governance tasks, express that ordering with blockedByClientKeys in the same create_child_task batch. Do not start a post-implementation review as an independent sibling without dependencies.",
     "For required deliverables, add top-level deliverables entries using {\"path\":\"relative/file\",\"required\":true}.",
+    "update_parent accepts only status, comment, and force. Never put deliverables, artifacts, interactions, blockers, or child-task fields inside update_parent; keep top-level deliverables beside actions and use their dedicated action objects.",
     artifactVerifierCommands.length > 0
       ? `Executable deliverable verification is enabled. Allowed verifier commands: ${artifactVerifierCommands.join(", ")}. For runnable outputs, add verification {\"command\":\"${artifactVerifierCommands[0]}\",\"args\":[\"script.js\"],\"timeoutSeconds\":30,\"expectedExitCode\":0,\"expectedOutputs\":[\"result.json\"]}. Commands are argv-only and run without a shell.`
       : "Executable deliverable verification is disabled by runtime policy. Do not include verification blocks. Required deliverables are still checked for presence and upload completeness.",
@@ -3860,11 +3876,17 @@ function buildCommandPrompt(command, workspace, materializedAttachments = [], op
     && runtimeActionChildIssueSummaryEntries(command).length === 0;
   const executingAgent = asRecord(context.paperclipExecutingAgent);
   const currentAgentAdapterType = readString(executingAgent.adapterType);
+  const validatorContentTypes = runtimeAttachmentContentTypes(command);
+  // Built-in executors run on the connector host, so the prompt may reference these host paths.
+  // A custom wrapper may isolate model tools; until isolation is an explicit capability, this
+  // validator is same-host only and must fail visibly rather than fall back to a weaker check.
+  const actionValidatorCommand = `${quoteShell(process.execPath)} ${quoteShell(resolve(process.argv[1]))} validate-actions --file .amaster-runtime-actions.json --cwd . --allowed-content-types ${quoteShell(validatorContentTypes.join(","))}`;
   return [
     "## AMaster Runtime Connector Task",
     "",
     "You are executing a task dispatched by AMaster Employee from the central control plane.",
     "Work only inside the declared workspace. Make concrete progress and finish with a concise result summary.",
+    "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: ${command.commandId}`,
     `- run id: ${commandRunId(command) ?? "unknown"}`,
@@ -3872,7 +3894,9 @@ function buildCommandPrompt(command, workspace, materializedAttachments = [], op
     issueLine ? `- issue: ${issueLine}` : "",
     `- workspace: ${cwd}`,
     workspaceContext.managed ? `- source workspace: ${workspaceContext.sourceWorkspacePath}` : "",
-    workspaceContext.managed ? "Use the execution workspace as cwd. Do not run broad scans in the source workspace; only inspect specific source paths when the task requires it." : "",
+    workspaceContext.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."
+      : "",
     readString(context.wakeReason) ? `- wake reason: ${readString(context.wakeReason)}` : "",
     hasRuntimeApi
       ? "- AMaster API env: PAPERCLIP_API_URL, PAPERCLIP_API_KEY, AMASTER_BOARD_API_KEY, PAPERCLIP_RUN_ID, PAPERCLIP_TASK_ID, PAPERCLIP_AGENT_ID, PAPERCLIP_COMPANY_ID are available to update the task, create child tasks, and report progress. Treat API keys as secrets; never print them or include them in runtime actions."
@@ -3883,6 +3907,7 @@ function buildCommandPrompt(command, workspace, materializedAttachments = [], op
       currentAgentAdapterType,
       explicitDecompositionRequired,
       artifactVerifierCommands: options.artifactVerifierCommands,
+      actionValidatorCommand,
     }) : "",
     "",
     agentInstructions,
@@ -5358,6 +5383,15 @@ function parseRuntimeActionEnvelopeJson(jsonText) {
   }
 }
 
+function hasMalformedRuntimeActionMarkerIntent(text) {
+  const value = String(text ?? "");
+  if (!value.includes("AMASTER_RUNTIME_ACTIONS")) return false;
+  const hasNonCanonicalMarkerLine = value
+    .split(/\r?\n/)
+    .some((line) => line.includes("AMASTER_RUNTIME_ACTIONS") && line.trim() !== "AMASTER_RUNTIME_ACTIONS");
+  return hasNonCanonicalMarkerLine && /["']actions["']\s*:/.test(value);
+}
+
 function readBoundedActionString(record, key, maxChars) {
   const value = readString(record[key]);
   return value ? truncateText(value, maxChars) : null;
@@ -6021,6 +6055,9 @@ function runtimeChildActionFingerprint(action, issueId, parentIssueId) {
     status: readActionStatus(action.status) ?? null,
     priority: readActionPriority(action.priority) ?? null,
     parentClientKey: readString(action.parentClientKey) ?? null,
+    blockedByClientKeys: Array.isArray(action.blockedByClientKeys)
+      ? action.blockedByClientKeys.map(readString).filter(Boolean).sort()
+      : [],
   })}`;
 }
 
@@ -6038,6 +6075,7 @@ function runtimeAgentHireActionFingerprint(action, companyId, issueId, body) {
     adapterType: readString(body.adapterType) ?? null,
     sourceIssueId: readString(body.sourceIssueId) ?? null,
     sourceIssueIds: runtimeActionIssueIdList(body.sourceIssueIds).sort(),
+    reportsToAgentClientKey: readString(action.reportsToAgentClientKey) ?? null,
   })}`;
 }
 
@@ -6085,21 +6123,6 @@ function runtimeActionDoneNeedsExternalHuman(action, actionContext) {
   ].some((pattern) => pattern.test(normalized));
 }
 
-function runtimeActionExternalHumanPatch(comment) {
-  const owner = "人工负责人";
-  const action = "补充或授权外部输入后再继续；涉及个人信息、付款、报名提交或审批时由人工处理";
-  const guard = [
-    "AMaster 已检测到本次运行仍依赖人工授权或外部输入，任务已转为 blocked / external_owner_action。本次运行不会自动发送飞书消息；请通过人工协作或已配置的飞书 CLI 通知对应负责人处理，收到明确授权后再继续。",
-    "",
-    `external owner: ${owner}`,
-    `external action: ${action}`,
-  ].join("\n");
-  return {
-    status: "blocked",
-    comment: comment ? `${comment}\n\n${guard}` : guard,
-  };
-}
-
 function runtimeActionReviewConfirmation(action, runtimeAuth, command, actionContext, opts = {}) {
   const runId = runtimeActionRunId(runtimeAuth) ?? commandRunId(command) ?? "unknown-run";
   const comment = readBoundedActionString(action, "comment", 20_000)
@@ -6249,6 +6272,24 @@ function runtimeActionContinuationScope(command) {
   return ["revision_only", "interaction_accepted", "message_only"].includes(scope ?? "") ? scope : null;
 }
 
+function runtimeActionAuthorizationEnvelope(command) {
+  const payload = asRecord(command.payload);
+  const context = asRecord(payload.contextSnapshot);
+  const rawEnvelope = asRecord(context.authorizationEnvelope);
+  const allowedActionClasses = Array.isArray(rawEnvelope.allowedActionClasses)
+    ? rawEnvelope.allowedActionClasses.map(readString).filter(Boolean)
+    : [];
+  const effectiveAllowedActionClasses = allowedActionClasses.length > 0
+    ? allowedActionClasses
+    : ["task_governance"];
+  return {
+    allowedActionClasses: new Set(effectiveAllowedActionClasses),
+    sourceKind: readString(rawEnvelope.sourceKind) ?? "implicit_default",
+    sourceId: readString(rawEnvelope.sourceId) ?? commandRunId(command),
+    sourceRevision: readString(rawEnvelope.sourceRevision) ?? "missing_envelope",
+  };
+}
+
 function runtimeActionInReviewNeedsFollowUpText(text) {
   const normalized = String(text ?? "")
     .replace(/\s+/g, "")
@@ -6411,6 +6452,35 @@ function runtimeActionParentIssueId(action, actionContext, fallbackIssueId) {
   return parentIssueId;
 }
 
+function runtimeActionReportsToAgentId(action, actionContext) {
+  const reportsToAgentClientKey = readString(action.reportsToAgentClientKey);
+  if (!reportsToAgentClientKey) return readString(action.reportsTo);
+  const reportsTo = actionContext.agentIdByClientKey.get(reportsToAgentClientKey);
+  if (!reportsTo) {
+    throw new Error(`agent_hire action references unknown reportsToAgentClientKey: ${reportsToAgentClientKey}`);
+  }
+  return reportsTo;
+}
+
+function runtimeActionBlockedByIssueIds(action, actionContext) {
+  const explicitIssueIds = Array.isArray(action.blockedByIssueIds)
+    ? action.blockedByIssueIds.map((rawIssueId) => readString(rawIssueId)).filter(Boolean)
+    : [];
+  if (action.blockedByClientKeys === undefined) return [...new Set(explicitIssueIds)];
+  const clientKeyIssueIds = action.blockedByClientKeys.map((rawClientKey, index) => {
+    const clientKey = readString(rawClientKey);
+    if (!clientKey) {
+      throw runtimeActionValidationError(`create_child_task blockedByClientKeys[${index}] must be a non-empty string`);
+    }
+    const blockerIssueId = actionContext.issueIdByClientKey.get(clientKey);
+    if (!blockerIssueId) {
+      throw new Error(`create_child_task action references unknown blockedByClientKeys entry: ${clientKey}`);
+    }
+    return blockerIssueId;
+  });
+  return [...new Set([...explicitIssueIds, ...clientKeyIssueIds])];
+}
+
 const RUNTIME_EXECUTOR_ADAPTER_TYPE_ALIASES = new Map([
   ["pi", "pi_local"],
   ["pi_local", "pi_local"],
@@ -6858,6 +6928,237 @@ function assertRuntimeActionValid(condition, message) {
   if (!condition) throw runtimeActionValidationError(message);
 }
 
+const RUNTIME_ACTION_COMMON_FIELDS = new Set(["type", "action", "name", "payload"]);
+const RUNTIME_ACTION_ALLOWED_FIELDS = new Map([
+  ["create_child_task", new Set([
+    "title", "description", "status", "priority", "assigneeAgentId", "assigneeUserId",
+    "assigneeAgentClientKey", "agentClientKey", "blockParentUntilDone", "executeBeforeConfirmation",
+    "clientKey", "idempotencyKey", "parentClientKey", "blockedByIssueIds", "blockedByClientKeys", "create_child_task",
+  ])],
+  ["agent_hire", new Set([
+    "clientKey", "idempotencyKey", "key", "companyId", "role", "title", "icon", "reportsTo",
+    "reportsToAgentClientKey", "capabilities", "desiredSkills", "adapterType", "adapterConfig",
+    "instructionsBundle", "runtimeConfig", "defaultEnvironmentId", "budgetMonthlyCents", "permissions",
+    "metadata", "sourceIssueId", "sourceIssueIds", "executeBeforeConfirmation", "agent_hire", "agent_hire/create_agent",
+  ])],
+  ["create_agent", new Set([
+    "clientKey", "idempotencyKey", "key", "companyId", "role", "title", "icon", "reportsTo",
+    "reportsToAgentClientKey", "capabilities", "desiredSkills", "adapterType", "adapterConfig",
+    "instructionsBundle", "runtimeConfig", "defaultEnvironmentId", "budgetMonthlyCents", "permissions",
+    "metadata", "sourceIssueId", "sourceIssueIds", "executeBeforeConfirmation", "create_agent",
+  ])],
+  ["add_comment", new Set(["body", "content", "text", "message", "add_comment"])],
+  ["upload_artifact", new Set([
+    "path", "filePath", "artifactPath", "artifact_path", "title", "summary", "contentType",
+    "createWorkProduct", "provider", "status", "reviewState", "isPrimary", "healthStatus",
+    "sourceWorkProductId", "sourceWorkProductIds", "supersedesWorkProductId", "evidenceRole", "scenarioKeys",
+    "idempotencyKey", "upload_artifact",
+  ])],
+  ["create_interaction", new Set([
+    "kind", "continuationPolicy", "title", "summary", "idempotencyKey", "interaction", "version",
+    "prompt", "question", "body", "content", "text", "message", "description", "acceptLabel",
+    "requestChangesLabel", "requestChangesReasonLabel", "rejectLabel", "rejectRequiresReason",
+    "rejectReasonLabel", "allowDeclineReason", "declineReasonPlaceholder", "detailsMarkdown",
+    "supersedeOnUserComment", "target", "artifactRefs", "tasks", "options", "defaultSelectedOptionIds",
+    "minSelected", "maxSelected", "questions", "submitLabel", "selectionMode", "required", "helpText",
+    "create_interaction",
+  ])],
+  ["update_parent", new Set(["status", "comment", "force", "update_parent"])],
+  ["update_company_profile", new Set([
+    "companyId", "tagline", "stage", "targetCustomers", "products", "currentPriority", "businessModel",
+    "regions", "brandTone", "markAutoDerived", "idempotencyKey", "update_company_profile",
+  ])],
+  ["create_routine", new Set([
+    "companyId", "title", "description", "cronExpression", "priority", "concurrencyPolicy", "catchUpPolicy",
+    "assigneeAgentId", "timezone", "idempotencyKey", "create_routine",
+  ])],
+]);
+
+function runtimeActionReceivedType(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "array";
+  return typeof value;
+}
+
+function assertNoUnsupportedRuntimeActionFields(action, actionIndex) {
+  const type = readRuntimeActionType(action);
+  const allowed = RUNTIME_ACTION_ALLOWED_FIELDS.get(type);
+  assertRuntimeActionValid(allowed, `unsupported AMaster runtime action type: ${type ?? "missing"}`);
+  const fields = runtimeActionBusinessFields(action);
+  for (const [field, value] of Object.entries(fields)) {
+    if (type === "create_interaction" && field === "interactionType") continue;
+    if (RUNTIME_ACTION_COMMON_FIELDS.has(field) || allowed.has(field)) continue;
+    const fieldPath = `actions[${actionIndex}].${field}`;
+    const receivedType = runtimeActionReceivedType(value);
+    const err = runtimeActionValidationError(
+      `${type} action has unsupported field ${field} at ${fieldPath}; received ${receivedType}`,
+    );
+    err.runtimeActionFieldPath = fieldPath;
+    err.runtimeActionReceivedType = receivedType;
+    throw err;
+  }
+}
+
+const RUNTIME_ACTION_BOOLEAN_FIELDS = new Set([
+  "blockParentUntilDone", "executeBeforeConfirmation", "createWorkProduct", "isPrimary",
+  "force", "markAutoDerived", "rejectRequiresReason", "allowDeclineReason", "supersedeOnUserComment",
+  "required",
+]);
+const RUNTIME_ACTION_NUMBER_FIELDS = new Set(["budgetMonthlyCents", "minSelected", "maxSelected", "version"]);
+const RUNTIME_ACTION_ARRAY_FIELDS = new Set([
+  "blockedByIssueIds", "blockedByClientKeys", "desiredSkills", "sourceIssueIds", "artifactRefs", "tasks",
+  "options", "defaultSelectedOptionIds", "questions", "sourceWorkProductIds", "scenarioKeys",
+]);
+const RUNTIME_ACTION_OBJECT_FIELDS = new Set([
+  "adapterConfig", "instructionsBundle", "runtimeConfig", "permissions", "metadata", "target",
+  "interaction",
+]);
+
+function assertRuntimeActionFieldTypes(action, actionIndex) {
+  const fields = runtimeActionBusinessFields(action);
+  const type = readRuntimeActionType(fields) ?? "unknown";
+  for (const [field, value] of Object.entries(fields)) {
+    if (value === undefined) continue;
+    if (SINGLE_KEY_RUNTIME_ACTION_TYPES.has(field)) continue;
+    if (type === "create_interaction" && field === "payload") continue;
+    let expectedType = null;
+    let valid = true;
+    if (RUNTIME_ACTION_BOOLEAN_FIELDS.has(field)) {
+      expectedType = "boolean";
+      valid = typeof value === "boolean";
+    } else if (RUNTIME_ACTION_NUMBER_FIELDS.has(field)) {
+      expectedType = "number";
+      valid = typeof value === "number" && Number.isFinite(value);
+    } else if (RUNTIME_ACTION_ARRAY_FIELDS.has(field)) {
+      expectedType = "array";
+      valid = Array.isArray(value);
+    } else if (field === "capabilities") {
+      expectedType = "string or array";
+      valid = typeof value === "string" || Array.isArray(value);
+    } else if (RUNTIME_ACTION_OBJECT_FIELDS.has(field) || field === "payload") {
+      expectedType = "object";
+      valid = value !== null && typeof value === "object" && !Array.isArray(value);
+    } else if (!RUNTIME_ACTION_COMMON_FIELDS.has(field) && value !== null) {
+      expectedType = "string";
+      valid = typeof value === "string";
+    }
+    if (valid || !expectedType) continue;
+    const fieldPath = `actions[${actionIndex}].${field}`;
+    const err = runtimeActionValidationError(
+      `${type} action field ${fieldPath} must be ${expectedType}; received ${runtimeActionReceivedType(value)}`,
+    );
+    err.runtimeActionFieldPath = fieldPath;
+    err.runtimeActionReceivedType = runtimeActionReceivedType(value);
+    throw err;
+  }
+}
+
+function runtimeActionClientKeyProducerKind(type) {
+  if (["agent_hire", "create_agent"].includes(type ?? "")) return "agent";
+  if (type === "create_child_task") return "issue";
+  return null;
+}
+
+function runtimeActionClientKeyReferences(fields) {
+  const type = readRuntimeActionType(fields);
+  const references = [];
+  if (["agent_hire", "create_agent"].includes(type ?? "")) {
+    const clientKey = readString(fields.reportsToAgentClientKey);
+    if (clientKey) references.push({ clientKey, expectedKind: "agent", field: "reportsToAgentClientKey" });
+  }
+  if (type === "create_child_task") {
+    const assigneeClientKey = readString(fields.assigneeAgentClientKey) ?? readString(fields.agentClientKey);
+    if (assigneeClientKey) references.push({ clientKey: assigneeClientKey, expectedKind: "agent", field: "assigneeAgentClientKey" });
+    const parentClientKey = readString(fields.parentClientKey);
+    if (parentClientKey) references.push({ clientKey: parentClientKey, expectedKind: "issue", field: "parentClientKey" });
+    if (fields.blockedByClientKeys !== undefined) {
+      assertRuntimeActionValid(Array.isArray(fields.blockedByClientKeys), "create_child_task blockedByClientKeys must be an array");
+      for (const [index, value] of fields.blockedByClientKeys.entries()) {
+        const clientKey = readString(value);
+        assertRuntimeActionValid(clientKey, `create_child_task blockedByClientKeys[${index}] must be a non-empty string`);
+        references.push({ clientKey, expectedKind: "issue", field: `blockedByClientKeys[${index}]` });
+      }
+    }
+  }
+  return references;
+}
+
+function throwRuntimeActionGraphValidation(message, action, actionIndex, fieldPath) {
+  const err = runtimeActionValidationError(message);
+  err.runtimeActionType = readRuntimeActionType(action) ?? "unknown";
+  err.runtimeActionOriginalType = readRuntimeActionOriginalType(action);
+  err.runtimeActionFieldPath = fieldPath ?? `actions[${actionIndex}]`;
+  throw err;
+}
+
+function orderRuntimeActionsByClientKeyDependencies(actions) {
+  const producers = new Map();
+  for (const [index, action] of actions.entries()) {
+    const fields = runtimeActionBusinessFields(action);
+    const type = readRuntimeActionType(fields);
+    const kind = runtimeActionClientKeyProducerKind(type);
+    const clientKey = readString(fields.clientKey);
+    if (!clientKey || !kind) continue;
+    if (producers.has(clientKey)) {
+      throwRuntimeActionGraphValidation(
+        `runtime action clientKey must be unique: ${clientKey}`,
+        action,
+        index,
+        `actions[${index}].clientKey`,
+      );
+    }
+    producers.set(clientKey, { index, kind, type });
+  }
+
+  const dependenciesByIndex = actions.map(() => new Set());
+  const dependentsByIndex = actions.map(() => new Set());
+  for (const [index, action] of actions.entries()) {
+    const fields = runtimeActionBusinessFields(action);
+    for (const reference of runtimeActionClientKeyReferences(fields)) {
+      const producer = producers.get(reference.clientKey);
+      if (!producer) {
+        throwRuntimeActionGraphValidation(
+          `${readRuntimeActionType(fields)} action references unknown ${reference.field}: ${reference.clientKey}`,
+          action,
+          index,
+          `actions[${index}].${reference.field}`,
+        );
+      }
+      if (producer.kind !== reference.expectedKind) {
+        throwRuntimeActionGraphValidation(
+          `${readRuntimeActionType(fields)} action ${reference.field} must reference a ${reference.expectedKind} clientKey: ${reference.clientKey}`,
+          action,
+          index,
+          `actions[${index}].${reference.field}`,
+        );
+      }
+      dependenciesByIndex[index].add(producer.index);
+      dependentsByIndex[producer.index].add(index);
+    }
+  }
+
+  const ready = actions.map((_, index) => index).filter((index) => dependenciesByIndex[index].size === 0);
+  const orderedIndexes = [];
+  while (ready.length > 0) {
+    ready.sort((left, right) => left - right);
+    const index = ready.shift();
+    orderedIndexes.push(index);
+    for (const dependentIndex of dependentsByIndex[index]) {
+      dependenciesByIndex[dependentIndex].delete(index);
+      if (dependenciesByIndex[dependentIndex].size === 0) ready.push(dependentIndex);
+    }
+  }
+  if (orderedIndexes.length !== actions.length) {
+    const cycleIndex = dependenciesByIndex.findIndex((dependencies) => dependencies.size > 0);
+    throwRuntimeActionGraphValidation(
+      "runtime action clientKey dependency graph contains a cycle",
+      actions[cycleIndex],
+      cycleIndex,
+    );
+  }
+  return orderedIndexes.map((index) => actions[index]);
+}
+
 function assertRuntimeInteractionOptions(options, path) {
   assertRuntimeActionValid(Array.isArray(options) && options.length > 0 && options.length <= 10, `${path} requires 1-10 options`);
   const ids = new Set();
@@ -6935,6 +7236,16 @@ function willRuntimeActionCreateRootBlockingChild(action) {
   return fields.blockParentUntilDone === true || childStatus === "blocked";
 }
 
+function willRuntimeActionCreateHumanOwnedInputPath(action) {
+  const fields = runtimeActionBusinessFields(action);
+  if (readRuntimeActionType(fields) !== "create_child_task") return false;
+  const childStatus = readActionStatus(fields.status) ?? "todo";
+  return Boolean(
+    readString(fields.assigneeUserId) &&
+    (fields.blockParentUntilDone === true || childStatus === "blocked"),
+  );
+}
+
 function willRuntimeActionCreatePendingInteraction(action) {
   const fields = runtimeActionBusinessFields(action);
   if (readRuntimeActionType(fields) !== "create_interaction") return false;
@@ -6950,8 +7261,22 @@ function runtimeActionIsAmbiguousApprovalGatedChild(action) {
   return childStatus !== "backlog";
 }
 
-function assertNoAmbiguousApprovalGatedChildren(actions) {
+function assertNoAmbiguousApprovalGatedSideEffects(actions) {
   if (!actions.some(willRuntimeActionCreatePendingInteraction)) return;
+  const ambiguousHire = actions.find((action) => {
+    const fields = runtimeActionBusinessFields(action);
+    return ["agent_hire", "create_agent"].includes(readRuntimeActionType(fields) ?? "") &&
+      fields.executeBeforeConfirmation !== true;
+  });
+  if (ambiguousHire) {
+    const error = runtimeActionValidationError(
+      "approval-gated agent hire actions require the native hire approval only, a separate proposal interaction, or executeBeforeConfirmation true",
+    );
+    error.runtimeActionType = readRuntimeActionType(ambiguousHire) ?? "agent_hire";
+    error.runtimeActionOriginalType = readRuntimeActionOriginalType(ambiguousHire);
+    error.runtimeActionReason = error.message;
+    throw error;
+  }
   const ambiguousChild = actions.find(runtimeActionIsAmbiguousApprovalGatedChild);
   if (!ambiguousChild) return;
   const error = new Error(
@@ -7006,9 +7331,44 @@ function assertRuntimeActionsAllowedByContinuationScope(actions, scope) {
   }
 }
 
-function preflightRuntimeAction(action, preflightContext) {
+function preflightRuntimeAction(action, preflightContext, actionIndex) {
   const type = readRuntimeActionType(action);
   const fields = runtimeActionBusinessFields(action);
+  assertNoUnsupportedRuntimeActionFields(action, actionIndex);
+  assertRuntimeActionFieldTypes(action, actionIndex);
+  if (type === "create_child_task") {
+    assertNoPlaceholderRuntimeActionText(fields, ["title", "description"]);
+    assertRuntimeActionValid(readBoundedActionString(fields, "title", 240), "create_child_task action requires title");
+    if (fields.status !== undefined) {
+      assertRuntimeActionValid(readActionStatus(fields.status), `create_child_task status is unsupported: ${String(fields.status)}`);
+    }
+    if (fields.priority !== undefined) {
+      assertRuntimeActionValid(readActionPriority(fields.priority), `create_child_task priority is unsupported: ${String(fields.priority)}`);
+    }
+    assertRuntimeActionValid(
+      !readString(fields.assigneeAgentId) || (!readString(fields.assigneeAgentClientKey) && !readString(fields.agentClientKey)),
+      "create_child_task action cannot combine assigneeAgentId with assigneeAgentClientKey/agentClientKey",
+    );
+    if (fields.blockedByIssueIds !== undefined) {
+      for (const [index, rawIssueId] of fields.blockedByIssueIds.entries()) {
+        const issueId = readString(rawIssueId);
+        assertRuntimeActionValid(
+          issueId && /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(issueId),
+          `create_child_task blockedByIssueIds[${index}] must be a UUID`,
+        );
+      }
+    }
+    return;
+  }
+  if (["agent_hire", "create_agent"].includes(type ?? "")) {
+    assertNoPlaceholderRuntimeActionText(fields, ["name", "role", "title", "instructionsBundle"]);
+    assertRuntimeActionValid(readBoundedActionString(fields, "name", 240), `${type} action requires name`);
+    assertRuntimeActionValid(
+      !readString(fields.reportsTo) || !readString(fields.reportsToAgentClientKey),
+      `${type} action cannot combine reportsTo with reportsToAgentClientKey`,
+    );
+    return;
+  }
   if (type === "add_comment") {
     assertNoPlaceholderRuntimeActionText(fields, ["body", "content", "text", "message"]);
     const body = readBoundedActionString(fields, "body", 20_000)
@@ -7019,7 +7379,38 @@ function preflightRuntimeAction(action, preflightContext) {
     return;
   }
   if (type === "upload_artifact") {
+    assertNoPlaceholderRuntimeActionText(fields, ["path", "filePath", "artifactPath", "artifact_path", "title", "summary"]);
+    assertRuntimeActionValid(readRuntimeArtifactPath(fields), "upload_artifact action requires path");
+    const pathFields = ["path", "filePath", "artifactPath", "artifact_path"].filter((field) => readString(fields[field]));
+    assertRuntimeActionValid(pathFields.length === 1, "upload_artifact action requires exactly one path field");
+    const sourceWorkProductId = readString(fields.sourceWorkProductId);
+    const sourceWorkProductIds = Array.isArray(fields.sourceWorkProductIds)
+      ? fields.sourceWorkProductIds.map(readString).filter(Boolean)
+      : [];
+    const supersedesWorkProductId = readString(fields.supersedesWorkProductId);
+    assertRuntimeActionValid(
+      Boolean(sourceWorkProductId) === Boolean(supersedesWorkProductId),
+      "upload_artifact parent replacement requires both sourceWorkProductId and supersedesWorkProductId",
+    );
+    const evidenceRole = readString(fields.evidenceRole);
+    assertRuntimeActionValid(
+      !evidenceRole || ["source", "derived", "review"].includes(evidenceRole),
+      `upload_artifact evidenceRole is unsupported: ${String(fields.evidenceRole)}`,
+    );
+    assertRuntimeActionValid(
+      !["derived", "review"].includes(evidenceRole ?? "") || sourceWorkProductIds.length > 0 || Boolean(sourceWorkProductId),
+      `upload_artifact evidenceRole=${evidenceRole} requires sourceWorkProductIds`,
+    );
+    if (fields.sourceWorkProductIds !== undefined) {
+      assertRuntimeActionValid(Array.isArray(fields.sourceWorkProductIds), "upload_artifact sourceWorkProductIds must be an array");
+      assertRuntimeActionValid(sourceWorkProductIds.length === fields.sourceWorkProductIds.length, "upload_artifact sourceWorkProductIds must contain non-empty strings");
+    }
+    if (fields.scenarioKeys !== undefined) {
+      assertRuntimeActionValid(Array.isArray(fields.scenarioKeys), "upload_artifact scenarioKeys must be an array");
+      assertRuntimeActionValid(fields.scenarioKeys.map(readString).filter(Boolean).length === fields.scenarioKeys.length, "upload_artifact scenarioKeys must contain non-empty strings");
+    }
     assertRuntimeArtifactContentType(fields, preflightContext.allowedContentTypes);
+    resolveWorkspaceArtifactPath(fields, { cwd: preflightContext.cwd });
     return;
   }
   if (type === "create_interaction") {
@@ -7030,6 +7421,10 @@ function preflightRuntimeAction(action, preflightContext) {
       ["request_confirmation", "request_checkbox_confirmation", "ask_user_questions", "suggest_tasks"].includes(kind),
       `create_interaction action does not support kind: ${kind}`,
     );
+    assertRuntimeActionValid(
+      kind !== "ask_user_questions" || readString(fields.continuationPolicy) !== "wake_assignee_on_accept",
+      "ask_user_questions continuationPolicy cannot be wake_assignee_on_accept; use wake_assignee so answering the questions resumes the assignee",
+    );
     const payload = normalizeCreateInteractionPayload(fields, kind);
     assertRuntimeActionValid(
       Object.keys(payload).length > 0,
@@ -7044,6 +7439,20 @@ function preflightRuntimeAction(action, preflightContext) {
     const status = readActionStatus(fields.status);
     const comment = readBoundedActionString(fields, "comment", 20_000);
     assertRuntimeActionValid(status || comment, "update_parent action requires status or comment");
+    if (fields.status !== undefined) {
+      assertRuntimeActionValid(status, `update_parent status is unsupported: ${String(fields.status)}`);
+    }
+    if (
+      status === "done" &&
+      runtimeActionDoneNeedsExternalHuman(fields, preflightContext) &&
+      !preflightContext.createdHumanOwnedInputPath &&
+      fields.force !== true
+    ) {
+      assertRuntimeActionValid(
+        false,
+        "external_input_disposition_required: external input cannot be represented only by a free-text owner; create a human-owned blocking child task or another first-class external dependency path",
+      );
+    }
     if (
       status === "in_review" &&
       !preflightContext.createdReviewPathForInReview &&
@@ -7056,22 +7465,43 @@ function preflightRuntimeAction(action, preflightContext) {
     ) {
       preflightContext.createdReviewPathForInReview = true;
     }
+    return;
+  }
+  if (type === "update_company_profile") {
+    const profileFields = ["tagline", "stage", "targetCustomers", "products", "currentPriority", "businessModel", "regions", "brandTone"];
+    assertRuntimeActionValid(
+      profileFields.some((field) => fields[field] === null || readBoundedActionString(fields, field, 2000)),
+      "update_company_profile action requires at least one profile field",
+    );
+    return;
+  }
+  if (type === "create_routine") {
+    assertRuntimeActionValid(readBoundedActionString(fields, "title", 240), "create_routine action requires title");
+    assertRuntimeActionValid(readBoundedActionString(fields, "cronExpression", 120), "create_routine action requires cronExpression");
+    if (fields.priority !== undefined) {
+      assertRuntimeActionValid(readActionPriority(fields.priority), `create_routine priority is unsupported: ${String(fields.priority)}`);
+    }
   }
 }
 
 function preflightRuntimeActionBatch(actions, options = {}) {
-  assertRuntimeActionsAllowedByContinuationScope(actions, options.continuationScope);
-  assertNoAmbiguousApprovalGatedChildren(actions);
+  const actionIndexByObject = new Map(actions.map((action, index) => [action, index]));
+  const orderedActions = orderRuntimeActionsByClientKeyDependencies(actions);
+  assertRuntimeActionsAllowedByContinuationScope(orderedActions, options.continuationScope);
+  assertNoAmbiguousApprovalGatedSideEffects(orderedActions);
   const preflightContext = {
     createdReviewPathForInReview: false,
     createdRootBlockingChildForInReview: false,
+    createdHumanOwnedInputPath: false,
     answeredQuestionContinuation: options.answeredQuestionContinuation === true,
     allowedContentTypes: Array.isArray(options.allowedContentTypes) ? options.allowedContentTypes : [],
+    cwd: readString(options.cwd),
     finalCommentBodies: [],
   };
-  for (const action of actions) {
+  for (const action of orderedActions) {
+    const actionIndex = actionIndexByObject.get(action);
     try {
-      preflightRuntimeAction(action, preflightContext);
+      preflightRuntimeAction(action, preflightContext, actionIndex);
       const fields = runtimeActionBusinessFields(action);
       if (readRuntimeActionType(fields) === "add_comment") {
         const body = readBoundedActionString(fields, "body", 20_000)
@@ -7083,6 +7513,9 @@ function preflightRuntimeActionBatch(actions, options = {}) {
       if (willRuntimeActionCreateRootBlockingChild(action)) {
         preflightContext.createdRootBlockingChildForInReview = true;
       }
+      if (willRuntimeActionCreateHumanOwnedInputPath(action)) {
+        preflightContext.createdHumanOwnedInputPath = true;
+      }
       if (willRuntimeActionCreateReviewPath(action)) {
         preflightContext.createdReviewPathForInReview = true;
       }
@@ -7099,6 +7532,40 @@ function preflightRuntimeActionBatch(actions, options = {}) {
       throw err;
     }
   }
+  return orderedActions;
+}
+
+function runtimeActionAuthorizationClass(action) {
+  // Keep these high-risk route mappings aligned with server-side checks in
+  // routes/agents.ts (organization_mutation) and routes/issues.ts
+  // (executable_child). Unknown action types intentionally remain governance.
+  const fields = runtimeActionBusinessFields(action);
+  const type = readRuntimeActionType(fields);
+  if (["agent_hire", "create_agent"].includes(type ?? "")) return "organization_mutation";
+  if (
+    type === "create_child_task" &&
+    ["todo", "in_progress"].includes(readActionStatus(fields.status) ?? "todo")
+  ) return "executable_child";
+  return "task_governance";
+}
+
+function assertRuntimeActionsAllowedByAuthorizationEnvelope(actions, envelope) {
+  for (const [actionIndex, action] of actions.entries()) {
+    const requiredAuthorization = runtimeActionAuthorizationClass(action);
+    if (envelope.allowedActionClasses.has(requiredAuthorization)) continue;
+    const type = readRuntimeActionType(runtimeActionBusinessFields(action)) ?? "unknown";
+    const err = runtimeActionValidationError(
+      `${type} action at index ${actionIndex} requires authorization class ${requiredAuthorization}; ` +
+      `source ${envelope.sourceKind ?? "unknown"}:${envelope.sourceId ?? "unknown"} revision ${envelope.sourceRevision ?? "unknown"}`,
+    );
+    err.runtimeActionType = type;
+    err.runtimeActionFieldPath = `actions[${actionIndex}]`;
+    err.runtimeActionRequiredAuthorization = requiredAuthorization;
+    err.runtimeActionAuthorizationSourceKind = envelope.sourceKind;
+    err.runtimeActionAuthorizationSourceId = envelope.sourceId;
+    err.runtimeActionAuthorizationSourceRevision = envelope.sourceRevision;
+    throw err;
+  }
 }
 
 function normalizeRuntimeActionPlaceholderText(value) {
@@ -7201,6 +7668,7 @@ async function applyRuntimeAction(config, command, runtimeAuth, issueId, action,
       priority: readActionPriority(fields.priority) ?? "medium",
       assigneeAgentId: runtimeChildAssigneeAgentId(fields, runtimeAuth, command, actionContext),
       assigneeUserId: readString(fields.assigneeUserId),
+      blockedByIssueIds: runtimeActionBlockedByIssueIds(fields, actionContext),
       blockParentUntilDone,
       originKind: "amaster_runtime_child_task",
       originId: issueId,
@@ -7211,6 +7679,23 @@ async function applyRuntimeAction(config, command, runtimeAuth, issueId, action,
       idempotencyKey: originFingerprint,
     });
     const createdIssueId = readString(asRecord(created).id);
+    const persistedAssigneeAgentId = readString(asRecord(created).assigneeAgentId);
+    if (body.assigneeAgentId && persistedAssigneeAgentId !== body.assigneeAgentId) {
+      throw new Error(
+        `runtime_action_postcondition_failed: child assignee mismatch; expected ${body.assigneeAgentId}, received ${persistedAssigneeAgentId ?? "missing"}`,
+      );
+    }
+    if (body.blockedByIssueIds.length > 0) {
+      const persistedBlockerIds = Array.isArray(asRecord(created).blockedBy)
+        ? asRecord(created).blockedBy.map((entry) => readString(asRecord(entry).id)).filter(Boolean)
+        : [];
+      const missingBlockerIds = body.blockedByIssueIds.filter((blockerId) => !persistedBlockerIds.includes(blockerId));
+      if (missingBlockerIds.length > 0) {
+        throw new Error(
+          `runtime_action_postcondition_failed: child blockers were not persisted: ${missingBlockerIds.join(", ")}`,
+        );
+      }
+    }
     const clientKey = runtimeActionResultKey(fields);
     if (createdIssueId) actionContext.createdChildIssueIdByFingerprint.set(duplicateKey, createdIssueId);
     if (createdIssueId && clientKey) actionContext.issueIdByClientKey.set(clientKey, createdIssueId);
@@ -7250,6 +7735,8 @@ async function applyRuntimeAction(config, command, runtimeAuth, issueId, action,
       adapterType: runtimeActionCurrentAgentAdapterType(command),
       runtimeConfig: runtimeActionCurrentAgentRuntimeConnector(command),
     });
+    const reportsTo = runtimeActionReportsToAgentId(fields, actionContext);
+    if (reportsTo) body.reportsTo = reportsTo;
     const idempotencyKey = runtimeAgentHireActionFingerprint(fields, companyId, issueId, body);
     body.idempotencyKey = idempotencyKey;
     const created = asRecord(await runtimeApiJson(
@@ -7263,6 +7750,11 @@ async function applyRuntimeAction(config, command, runtimeAuth, issueId, action,
     const approval = asRecord(created.approval);
     const clientKey = runtimeActionResultKey(fields);
     const agentId = readString(agent.id);
+    if (reportsTo && readString(agent.reportsTo) !== reportsTo) {
+      throw new Error(
+        `runtime_action_postcondition_failed: agent reportsTo mismatch; expected ${reportsTo}, received ${readString(agent.reportsTo) ?? "missing"}`,
+      );
+    }
     if (agentId && clientKey) actionContext.agentIdByClientKey.set(clientKey, agentId);
     return {
       type,
@@ -7308,25 +7800,6 @@ async function applyRuntimeAction(config, command, runtimeAuth, issueId, action,
       { key: "idempotencyKey", placeholders: ["artifact-key", "artifact key", "upload-artifact-key", "upload artifact key"] },
     ]);
     const rawPath = readRuntimeArtifactPath(fields);
-    if (!rawPath) {
-      const title = readBoundedActionString(fields, "title", 240) ?? "运行产物";
-      const summary = readBoundedActionString(fields, "summary", 20_000);
-      const body = [
-        `AMaster 未上传产物 \`${title}\`，因为 runtime action 没有提供工作区内文件路径。`,
-        summary ? `\n${summary}` : "",
-        "\n请在后续运行中先把文件写入执行工作区，再用 upload_artifact.path 引用该相对路径。",
-      ].join("");
-      const created = await runtimeApiJson(runtimeAuth, "POST", `/api/issues/${encodeURIComponent(issueId)}/comments`, { body });
-      actionContext.finalCommentBodies.push(body);
-      return {
-        type,
-        ...(originalType && originalType !== type ? { originalType } : {}),
-        status: "skipped",
-        reason: "missing_path",
-        title,
-        commentId: readString(asRecord(created).id),
-      };
-    }
     const payload = asRecord(command.payload);
     const companyId = readString(payload.companyId) ?? readString(runtimeAuth.companyId);
     if (!companyId) throw new Error("upload_artifact action requires companyId");
@@ -7348,7 +7821,7 @@ async function applyRuntimeAction(config, command, runtimeAuth, issueId, action,
     const title = readBoundedActionString(fields, "title", 240) ?? filename;
     if (fields.createWorkProduct !== false) {
       const existingWorkProducts = await listExistingIssueWorkProducts(runtimeAuth, issueId);
-      const existingWorkProduct = existingExplicitArtifactUploadMatch(filePath, title, existingWorkProducts);
+      const existingWorkProduct = existingExplicitArtifactUploadMatch(filePath, title, existingWorkProducts, fields);
       if (existingWorkProduct) {
         const metadata = asRecord(existingWorkProduct.metadata);
         return {
@@ -7401,8 +7874,16 @@ async function applyRuntimeAction(config, command, runtimeAuth, issueId, action,
           openPath,
           downloadPath,
           originalFilename: readString(attachment.originalFilename) ?? filename,
+          ...(readString(fields.sourceWorkProductId) ? { sourceWorkProductId: readString(fields.sourceWorkProductId) } : {}),
+          ...(Array.isArray(fields.sourceWorkProductIds) ? { sourceWorkProductIds: fields.sourceWorkProductIds.map(readString).filter(Boolean) } : {}),
+          ...(readString(fields.supersedesWorkProductId) ? { supersedesWorkProductId: readString(fields.supersedesWorkProductId) } : {}),
+          ...(readString(fields.evidenceRole) ? { evidenceRole: readString(fields.evidenceRole) } : {}),
+          ...(Array.isArray(fields.scenarioKeys) ? { scenarioKeys: fields.scenarioKeys.map(readString).filter(Boolean) } : {}),
         },
       }));
+      if (!readString(workProduct.id)) {
+        throw new Error("runtime_action_postcondition_failed: artifact work product response did not include id");
+      }
     }
 
     return {
@@ -7475,18 +7956,6 @@ async function applyRuntimeAction(config, command, runtimeAuth, issueId, action,
     if (Object.keys(patch).length === 0) {
       throw new Error("update_parent action requires status or comment");
     }
-    if (status === "done" && runtimeActionDoneNeedsExternalHuman(fields, actionContext) && fields.force !== true) {
-      Object.assign(patch, runtimeActionExternalHumanPatch(comment));
-      const updated = await runtimeApiJson(runtimeAuth, "PATCH", `/api/issues/${encodeURIComponent(issueId)}`, patch);
-      return {
-        type,
-        ...(originalType && originalType !== type ? { originalType } : {}),
-        issueId: readString(asRecord(updated).id),
-        status: readString(asRecord(updated).status) ?? "blocked",
-        coercedFromStatus: "done",
-        externalOwnerAction: true,
-      };
-    }
     if (status === "done" && actionContext.createdReviewPathForInReview && fields.force !== true) {
       patch.status = "in_review";
       patch.comment = comment
@@ -7742,6 +8211,48 @@ function runtimeActionFailureSummary(action, err) {
   };
 }
 
+function runtimeActionLedgerResourceIds(result) {
+  const record = asRecord(result);
+  const resourceIds = {};
+  for (const key of ["issueId", "parentIssueId", "agentId", "approvalId", "commentId", "interactionId", "attachmentId", "workProductId", "routineId", "profileId"]) {
+    const value = readString(record[key]);
+    if (value) resourceIds[key] = value;
+  }
+  return resourceIds;
+}
+
+function runtimeActionLedgerPostconditionStatus(action, status, error) {
+  if (status === "failed") {
+    return /runtime_action_postcondition_failed/i.test(String(error instanceof Error ? error.message : error ?? ""))
+      ? "failed"
+      : "not_run";
+  }
+  if (status !== "applied" && status !== "reused") return "not_run";
+  return ["create_child_task", "agent_hire", "create_agent", "upload_artifact"].includes(
+    readRuntimeActionType(action) ?? "",
+  )
+    ? "passed"
+    : "not_applicable";
+}
+
+function runtimeActionLedgerEntry(action, actionIndex, status, result = null, error = null) {
+  const fields = runtimeActionBusinessFields(action);
+  const resultRecord = asRecord(result);
+  const clientKey = readString(fields.clientKey);
+  const resourceIds = runtimeActionLedgerResourceIds(resultRecord);
+  return {
+    actionIndex,
+    actionType: readRuntimeActionType(fields) ?? "unknown",
+    actionKey: clientKey ?? `index:${actionIndex}`,
+    ...(clientKey ? { clientKey } : {}),
+    status,
+    reusedExisting: resultRecord.reusedExisting === true,
+    postconditionStatus: runtimeActionLedgerPostconditionStatus(fields, status, error),
+    ...(Object.keys(resourceIds).length > 0 ? { resourceIds } : {}),
+    ...(error ? { error: truncateText(error instanceof Error ? error.message : String(error), 1000) } : {}),
+  };
+}
+
 function isSkippedRuntimeActionResult(result) {
   return readString(asRecord(result).status) === "skipped";
 }
@@ -7922,6 +8433,12 @@ function runtimeActionDiagnostics(err, options = {}) {
       ? { decompositionMatch: err.runtimeActionDecompositionMatch }
       : {}),
     ...(err?.runtimeActionInferenceTrace ? { inferenceTrace: err.runtimeActionInferenceTrace } : {}),
+    ...(readString(err?.runtimeActionFieldPath) ? { fieldPath: readString(err.runtimeActionFieldPath) } : {}),
+    ...(readString(err?.runtimeActionReceivedType) ? { receivedType: readString(err.runtimeActionReceivedType) } : {}),
+    ...(readString(err?.runtimeActionRequiredAuthorization) ? { requiredAuthorization: readString(err.runtimeActionRequiredAuthorization) } : {}),
+    ...(readString(err?.runtimeActionAuthorizationSourceKind) ? { authorizationSourceKind: readString(err.runtimeActionAuthorizationSourceKind) } : {}),
+    ...(readString(err?.runtimeActionAuthorizationSourceId) ? { authorizationSourceId: readString(err.runtimeActionAuthorizationSourceId) } : {}),
+    ...(readString(err?.runtimeActionAuthorizationSourceRevision) ? { authorizationSourceRevision: readString(err.runtimeActionAuthorizationSourceRevision) } : {}),
     ...(Array.isArray(err?.runtimeActionAllowedContentTypes)
       ? { allowedContentTypes: err.runtimeActionAllowedContentTypes }
       : {}),
@@ -7931,6 +8448,7 @@ function runtimeActionDiagnostics(err, options = {}) {
     ...(err?.runtimeActionVerificationResult
       ? { verificationResult: err.runtimeActionVerificationResult }
       : {}),
+    ...(err?.runtimeActionLedger ? { actionLedger: err.runtimeActionLedger } : {}),
     ...(runtimeActionExpectedShape(actionType, actionKind) ? { expectedShape: runtimeActionExpectedShape(actionType, actionKind) } : {}),
     ...(typeof err?.httpStatus === "number" ? { backendStatus: err.httpStatus } : {}),
     ...(backendErrors.length > 0 ? { backendErrors } : {}),
@@ -7967,7 +8485,7 @@ function classifyRuntimeActionFailure(err) {
   }
   if (actionType === "output_channel") {
     return {
-      errorCode: "runtime_action_validation_failed",
+      errorCode: readString(err?.runtimeActionErrorCode) ?? "runtime_action_validation_failed",
       errorFamily: "output_contract",
       ...details,
       ...(diagnostics ? { runtimeActionDiagnostics: diagnostics } : {}),
@@ -7984,7 +8502,10 @@ function classifyRuntimeActionFailure(err) {
       ...(diagnostics ? { runtimeActionDiagnostics: diagnostics } : {}),
     };
   }
-  if (actionType === "upload_artifact" && /unsupported artifact content type/i.test(haystack)) {
+  if (
+    actionType === "upload_artifact" &&
+    /unsupported artifact content type|requires path|file does not exist|path must be inside/i.test(haystack)
+  ) {
     return {
       errorCode: "runtime_action_validation_failed",
       errorFamily: "output_contract",
@@ -8008,6 +8529,31 @@ function classifyRuntimeActionFailure(err) {
       ...(diagnostics ? { runtimeActionDiagnostics: diagnostics } : {}),
     };
   }
+  if (/runtime_action_postcondition_failed/i.test(haystack)) {
+    return {
+      errorCode: "runtime_action_postcondition_failed",
+      errorFamily: "output_contract",
+      ...details,
+      ...(diagnostics ? { runtimeActionDiagnostics: diagnostics } : {}),
+    };
+  }
+  if (err?.httpStatus === 401) {
+    const authenticationDiagnostics = runtimeActionDiagnostics(err, { retryable: true });
+    return {
+      errorCode: "runtime_action_authentication_failed",
+      errorFamily: "authentication",
+      ...details,
+      ...(authenticationDiagnostics ? { runtimeActionDiagnostics: authenticationDiagnostics } : {}),
+    };
+  }
+  if (err?.httpStatus === 403) {
+    return {
+      errorCode: "runtime_action_permission_denied",
+      errorFamily: "permission",
+      ...details,
+      ...(diagnostics ? { runtimeActionDiagnostics: diagnostics } : {}),
+    };
+  }
   if (/approval-gated executable child tasks/i.test(haystack)) {
     return {
       errorCode: "runtime_action_validation_failed",
@@ -8312,9 +8858,19 @@ async function applyRuntimeActionBridge(config, command, parsed, execution, cwd)
     err.runtimeActionReasonHint = "assistant_message_required";
     throw err;
   }
+  if (!envelope && hasMalformedRuntimeActionMarkerIntent(actionText)) {
+    const err = runtimeActionValidationError(
+      "AMASTER_RUNTIME_ACTIONS action intent used a non-canonical marker; the marker must be an unformatted bare line",
+    );
+    err.runtimeActionType = "output_channel";
+    err.runtimeActionReasonHint = "bare_marker_line_required";
+    err.runtimeActionErrorCode = "runtime_action_output_marker_invalid";
+    throw err;
+  }
   if (!envelope) return null;
   const rawActions = Array.isArray(envelope.actions) ? envelope.actions.map(asRecord) : [];
   const continuationScope = runtimeActionContinuationScope(command);
+  const authorizationEnvelope = runtimeActionAuthorizationEnvelope(command);
   assertRuntimeActionsAllowedByContinuationScope(rawActions, continuationScope);
   assertExplicitTaskDecomposition(command, rawActions);
   if (
@@ -8327,6 +8883,10 @@ async function applyRuntimeActionBridge(config, command, parsed, execution, cwd)
   const runtimeAuth = runtimeActionAuthForCommand(command);
   const issueId = readString(runtimeAuth.issueId) ?? commandIssueId(command);
   if (!issueId) throw new Error("AMaster runtime action bridge requires a current issue id");
+  const batchFingerprint = `runtime-action-batch:${stableRuntimeActionHash({
+    runId: runtimeActionRunId(runtimeAuth) ?? commandRunId(command),
+    envelope,
+  })}`;
   const allowedContentTypes = runtimeAttachmentContentTypes(command);
   let deliverableManifest;
   try {
@@ -8358,20 +8918,39 @@ async function applyRuntimeActionBridge(config, command, parsed, execution, cwd)
     attachRuntimeCheckpointCandidates(err, envelope, cwd);
     throw err;
   }
-  const actions = orderRuntimeActionsForGovernance([...generatedUploadActions, ...rawActions]);
+  let actions = orderRuntimeActionsForGovernance([...generatedUploadActions, ...rawActions]);
   const answeredQuestionContinuation = runtimeActionAnsweredQuestionContinuation(command);
   try {
-    preflightRuntimeActionBatch(actions, {
+    actions = preflightRuntimeActionBatch(actions, {
       answeredQuestionContinuation,
       allowedContentTypes,
       continuationScope,
+      cwd,
     });
+    assertRuntimeActionsAllowedByAuthorizationEnvelope(actions, authorizationEnvelope);
   } catch (err) {
+    if (err && typeof err === "object" && !err.runtimeActionLedger) {
+      const fieldPath = readString(err.runtimeActionFieldPath);
+      const failedIndex = Number.parseInt(fieldPath?.match(/^actions\[(\d+)]/)?.[1] ?? "0", 10);
+      err.runtimeActionLedger = {
+        batchFingerprint,
+        traceId: batchFingerprint,
+        status: "validation_failed",
+        actions: actions.map((action, index) => runtimeActionLedgerEntry(
+          action,
+          index,
+          index === failedIndex ? "failed" : "pending",
+          null,
+          index === failedIndex ? err : null,
+        )),
+      };
+    }
     attachRuntimeCheckpointCandidates(err, envelope, cwd);
     throw err;
   }
   const results = [];
   const skipped = [];
+  const actionLedgerEntries = [];
   const actionContext = {
     rootIssueId: issueId,
     cwd,
@@ -8385,10 +8964,16 @@ async function applyRuntimeActionBridge(config, command, parsed, execution, cwd)
     answeredQuestionContinuation,
     finalCommentBodies: [],
   };
-  for (const action of actions) {
+  for (const [actionIndex, action] of actions.entries()) {
     try {
       const result = await applyRuntimeAction(config, command, runtimeAuth, issueId, action, actionContext);
       results.push(result);
+      actionLedgerEntries.push(runtimeActionLedgerEntry(
+        action,
+        actionIndex,
+        asRecord(result).reusedExisting === true ? "reused" : "applied",
+        result,
+      ));
       if (isSkippedRuntimeActionResult(result)) {
         skipped.push(result);
       }
@@ -8417,6 +9002,17 @@ async function applyRuntimeActionBridge(config, command, parsed, execution, cwd)
           err.runtimeActionOriginalType = readRuntimeActionOriginalType(action);
           err.runtimeActionKind = readString(action.kind) ?? readString(asRecord(action.payload).kind);
           err.runtimeActionReason = truncateText(err instanceof Error ? err.message : String(err), 1000);
+          err.runtimeActionLedger = {
+            batchFingerprint,
+            traceId: batchFingerprint,
+            status: "partial_failed",
+            actions: [
+              ...actionLedgerEntries,
+              runtimeActionLedgerEntry(action, actionIndex, "failed", null, err),
+              ...actions.slice(actionIndex + 1).map((pendingAction, offset) =>
+                runtimeActionLedgerEntry(pendingAction, actionIndex + offset + 1, "pending")),
+            ],
+          };
         }
         attachRuntimeCheckpointCandidates(err, envelope, cwd);
         throw err;
@@ -8424,6 +9020,7 @@ async function applyRuntimeActionBridge(config, command, parsed, execution, cwd)
       const skippedResult = runtimeActionFailureSummary(action, err);
       skipped.push(skippedResult);
       results.push(skippedResult);
+      actionLedgerEntries.push(runtimeActionLedgerEntry(action, actionIndex, "skipped", skippedResult, err));
       await ingestLog(config, command, "system", "warn", `Skipped AMaster runtime action: ${skippedResult.reason}`, {
         runtimeAction: skippedResult,
       });
@@ -8431,8 +9028,19 @@ async function applyRuntimeActionBridge(config, command, parsed, execution, cwd)
   }
   return {
     version: readNumber(envelope.version, 1),
+    markerFound: true,
+    jsonParsed: true,
+    actionsValidated: true,
+    postconditionsPassed: true,
+    actionLedger: {
+      batchFingerprint,
+      traceId: batchFingerprint,
+      status: "completed",
+      actions: actionLedgerEntries,
+    },
     requestedCount: actions.length,
     appliedCount: results.length - skipped.length,
+    actionsApplied: results.length - skipped.length,
     skippedCount: skipped.length,
     results,
     deliverableManifest: {
@@ -8488,7 +9096,7 @@ function existingArtifactUploadMatches(artifact, existingWorkProducts) {
   });
 }
 
-function existingExplicitArtifactUploadMatch(filePath, title, existingWorkProducts) {
+function existingExplicitArtifactUploadMatch(filePath, title, existingWorkProducts, fields = {}) {
   const filename = basename(filePath);
   const byteSize = statSync(filePath).size;
   const sha256 = hashFileSha256(filePath);
@@ -8499,6 +9107,22 @@ function existingExplicitArtifactUploadMatch(filePath, title, existingWorkProduc
     if (readString(workProduct.provider) !== "paperclip") return false;
     if (readString(workProduct.status) === "archived") return false;
     const metadata = asRecord(workProduct.metadata);
+    const sourceWorkProductId = readString(fields.sourceWorkProductId);
+    const sourceWorkProductIds = Array.isArray(fields.sourceWorkProductIds)
+      ? fields.sourceWorkProductIds.map(readString).filter(Boolean).sort()
+      : [];
+    const supersedesWorkProductId = readString(fields.supersedesWorkProductId);
+    const evidenceRole = readString(fields.evidenceRole);
+    const scenarioKeys = Array.isArray(fields.scenarioKeys) ? fields.scenarioKeys.map(readString).filter(Boolean).sort() : [];
+    if (sourceWorkProductId || supersedesWorkProductId || sourceWorkProductIds.length > 0 || evidenceRole || scenarioKeys.length > 0) {
+      if (readString(metadata.sourceWorkProductId) !== sourceWorkProductId) return false;
+      if (readString(metadata.supersedesWorkProductId) !== supersedesWorkProductId) return false;
+      const existingSourceIds = Array.isArray(metadata.sourceWorkProductIds) ? metadata.sourceWorkProductIds.map(readString).filter(Boolean).sort() : [];
+      const existingScenarioKeys = Array.isArray(metadata.scenarioKeys) ? metadata.scenarioKeys.map(readString).filter(Boolean).sort() : [];
+      if (JSON.stringify(existingSourceIds) !== JSON.stringify(sourceWorkProductIds)) return false;
+      if (readString(metadata.evidenceRole) !== evidenceRole) return false;
+      if (JSON.stringify(existingScenarioKeys) !== JSON.stringify(scenarioKeys)) return false;
+    }
     const existingSha = readString(metadata.sha256) ?? readString(workProduct.sha256);
     if (existingSha) return existingSha === sha256;
 
@@ -9112,6 +9736,26 @@ function statusSummary(config) {
   }), null, 2)}\n`);
 }
 
+function validateRuntimeActionsFile(config, flags) {
+  const rawFile = readString(flags.file);
+  if (!rawFile) throw new Error("--file is required");
+  const cwd = resolve(readString(flags.cwd) ?? process.cwd());
+  const file = resolve(cwd, rawFile);
+  const allowedContentTypes = splitList(flags["allowed-content-types"]);
+  const envelope = JSON.parse(readFileSync(file, "utf8"));
+  if (!envelope || typeof envelope !== "object" || Array.isArray(envelope)) {
+    throw runtimeActionValidationError("runtime action envelope must be a JSON object");
+  }
+  assertRuntimeActionValid(envelope.version === 1, "runtime action envelope version must be 1");
+  assertRuntimeActionValid(Array.isArray(envelope.actions), "runtime action envelope actions must be an array");
+  assertRuntimeActionValid(envelope.actions.length <= 20, "runtime action envelope actions exceed the limit of 20");
+
+  preflightRuntimeDeliverables(config, envelope, cwd, allowedContentTypes);
+  const actions = orderRuntimeActionsForGovernance(envelope.actions.map(asRecord));
+  preflightRuntimeActionBatch(actions, { cwd, allowedContentTypes });
+  process.stdout.write(`${JSON.stringify({ valid: true, actionCount: actions.length }, null, 2)}\n`);
+}
+
 async function runLoop(config) {
   config = await ensureRegistered(config);
   let startupOrphanCheckPending = true;
@@ -9145,6 +9789,7 @@ Commands:
   run-once                  Register if needed, heartbeat, poll once, execute leased commands, then exit.
   workspace-gc-dry-run      Print managed runtime workdir GC candidates without deleting anything.
   status-summary            Print safe local daemon storage/outbox summary JSON.
+  validate-actions          Validate a JSON action envelope with --file, --cwd, and --allowed-content-types.
   start | run               Register if needed, then heartbeat and poll in a foreground loop.
 
 Key env:
@@ -9196,6 +9841,9 @@ async function main() {
     case "status-summary":
       statusSummary(config);
       break;
+    case "validate-actions":
+      validateRuntimeActionsFile(config, flags);
+      break;
     case "start":
     case "run":
       await runLoop(config);

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.5";
+const CONNECTOR_VERSION = "0.1.0-beta.7";
 
 const CAPABILITIES = [
   "remote_registration",

package/package.json

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