@amaster.ai/employee-runtime-connector 0.1.0-beta.8 → 0.1.0-beta.9

package/dist/amaster-runtime-daemon.mjs

@@ -2335,7 +2335,7 @@ import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync
 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.8";
+const CONNECTOR_VERSION = "0.1.0-beta.9";
 const MAX_INFERRED_ARTIFACT_UPLOADS = 20;
 const MAX_CHECKPOINT_BYTES = 20 * 1024 * 1024;
 const CHECKPOINT_TTL_MS = 24 * 60 * 60 * 1000;
@@ -3550,9 +3550,12 @@ function runtimeActionsInstruction(options = {}) {
     "If direct AMaster API requests succeed for all requested mutations, finish with a normal summary and do not emit or mention the AMASTER_RUNTIME_ACTIONS marker.",
     "If direct AMaster API requests are unavailable from the executor sandbox, do not stop at blocked. Use the runtime action bridge for the unapplied mutations.",
     "Use runtime actions as a continuation patch, not as a full replay. If the wake reason or latest comments say a confirmation was accepted, rejected, or that no more child tasks/interactions should be created, do not recreate those earlier actions. Add the final result comment and update the parent task instead.",
+    "On an accepted request_confirmation or request_checkbox_confirmation continuation, any new confirmation must include payload.target.type and a non-empty payload.target.key. Missing decision identity fields fail before mutation with accepted_confirmation_decision_target_required. The server reuses identical content for the same target identity and rejects changed prompt, options, or labels until the action uses the genuinely new target revision.",
+    "Every request_confirmation and request_checkbox_confirmation should bind the concrete decision to payload.target using {type:\"custom\", key, label, revisionId} or the applicable issue_document target. Keep target.key stable for the same decision purpose and change target.revisionId only when the target content changes. Replace example target values with task-specific values; when no business revision exists, use the current run id as revisionId instead of omitting target.",
     "If the wake reason is issue_children_completed, treat the completed child tasks as already resolved blockers. Do not recreate blocker child tasks, do not repeat the first-run blocker plan, and do not create another review path unless new human input is truly required. Summarize the completed child work and use update_parent status done when no human review is needed.",
     "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.",
+    "Every root create_child_task with status todo or in_progress must establish the parent disposition in the same batch. Set blockParentUntilDone true when the parent depends on that child. Only omit the wait when the same batch also closes the parent's independent scope with update_parent status done or cancelled. parentId alone is structural and never proves that the parent is waiting; missing both paths fails with delegated_parent_wait_required.",
     "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.",
@@ -3572,6 +3575,9 @@ function runtimeActionsInstruction(options = {}) {
     options.canOrchestrateOrganization
       ? `For agent_hire, role must be one of: ${AGENT_HIRE_SCHEMA_ROLES.join(", ")}. Put custom business role names in name/title/capabilities/instructionsBundle, not in role. Map product/customer insight to research or product, growth/revenue to marketing or sales, finance/budget to finance, engineering delivery to engineering, legal/compliance to legal, customer success/support to customer_support. capabilities must be a string, not an array. instructionsBundle must use {entryFile:"AGENTS.md", files: {"AGENTS.md": "..."}}, and instructionsBundle.files must contain at least one file.`
       : "",
+    options.canOrchestrateOrganization
+      ? "Every agent_hire must declare exactly one reporting disposition. For an existing manager from the current task context, set reportsTo to that manager UUID. For a manager hired in the same batch, set reportsToAgentClientKey to the manager's clientKey. Only a genuinely company-root role may set topLevel true. reportsToAgentId is unsupported; use reportsTo for an existing manager UUID."
+      : "",
     options.canOrchestrateOrganization
       ? "When assigning a newly hired agent's first task in the same action batch, set clientKey on the agent_hire action and set assigneeAgentClientKey or agentClientKey on the create_child_task action to that same key. Do not leave the first task assigned to the current CEO/executing agent unless the CEO should actually do the work."
       : "",
@@ -3584,11 +3590,11 @@ function runtimeActionsInstruction(options = {}) {
       : "",
     `Allowed action types: ${allowedActionTypes}.`,
     "For upsert_document, write or replace a Markdown document on the current AMaster task. Use {\"type\":\"upsert_document\",\"key\":\"business-brief\",\"title\":\"2026-07-16 每日经营简报\",\"body\":\"# 每日经营简报\\n...\",\"format\":\"markdown\",\"changeSummary\":\"生成每日经营简报\"}. key, body, and format are required; format must be markdown. Never target a different issue.",
-    "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.",
+    "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\":\"调整\",\"target\":{\"type\":\"custom\",\"key\":\"delivery-review\",\"label\":\"交付结果\",\"revisionId\":\"v1\"}}}. 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 request_confirmation, follow the complete example above and do not use options arrays.",
+    "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\":\"调整\",\"target\":{\"type\":\"custom\",\"key\":\"approved-items\",\"label\":\"待批准项目\",\"revisionId\":\"v1\"}}.",
     "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.",
@@ -6166,6 +6172,7 @@ function runtimeChildActionFingerprint(action, issueId, parentIssueId) {
     title,
     status: readActionStatus(action.status) ?? null,
     priority: readActionPriority(action.priority) ?? null,
+    blockParentUntilDone: action.blockParentUntilDone === true || readActionStatus(action.status) === "blocked",
     parentClientKey: readString(action.parentClientKey) ?? null,
     inputWorkProductIds: Array.isArray(action.inputWorkProductIds)
       ? action.inputWorkProductIds.map(readString).filter(Boolean).sort()
@@ -6190,7 +6197,9 @@ function runtimeAgentHireActionFingerprint(action, companyId, issueId, body) {
     adapterType: readString(body.adapterType) ?? null,
     sourceIssueId: readString(body.sourceIssueId) ?? null,
     sourceIssueIds: runtimeActionIssueIdList(body.sourceIssueIds).sort(),
+    reportsTo: readString(body.reportsTo) ?? null,
     reportsToAgentClientKey: readString(action.reportsToAgentClientKey) ?? null,
+    topLevel: action.topLevel === true,
   })}`;
 }
 
@@ -6348,7 +6357,7 @@ function runtimeActionAcceptedConfirmationContinuation(command) {
   if (context.acceptedConfirmationContinuation === true) return true;
   if (readString(context.wakeReason) === "request_confirmation_accepted") return true;
   if (
-    readString(context.interactionKind) === "request_confirmation" &&
+    ["request_confirmation", "request_checkbox_confirmation"].includes(readString(context.interactionKind) ?? "") &&
     readString(context.interactionStatus) === "accepted"
   ) {
     return true;
@@ -6357,7 +6366,7 @@ function runtimeActionAcceptedConfirmationContinuation(command) {
   const interactions = Array.isArray(wake.interactions) ? wake.interactions : [];
   return interactions.some((entry) => {
     const interaction = asRecord(entry);
-    return readString(interaction.kind) === "request_confirmation" &&
+    return ["request_confirmation", "request_checkbox_confirmation"].includes(readString(interaction.kind) ?? "") &&
       readString(interaction.status) === "accepted";
   });
 }
@@ -7053,13 +7062,13 @@ const RUNTIME_ACTION_ALLOWED_FIELDS = new Map([
   ])],
   ["agent_hire", new Set([
     "clientKey", "idempotencyKey", "key", "companyId", "role", "title", "icon", "reportsTo",
-    "reportsToAgentClientKey", "capabilities", "desiredSkills", "adapterType", "adapterConfig",
+    "reportsToAgentClientKey", "topLevel", "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",
+    "reportsToAgentClientKey", "topLevel", "capabilities", "desiredSkills", "adapterType", "adapterConfig",
     "instructionsBundle", "runtimeConfig", "defaultEnvironmentId", "budgetMonthlyCents", "permissions",
     "metadata", "sourceIssueId", "sourceIssueIds", "executeBeforeConfirmation", "create_agent",
   ])],
@@ -7109,8 +7118,11 @@ function assertNoUnsupportedRuntimeActionFields(action, actionIndex) {
     if (RUNTIME_ACTION_COMMON_FIELDS.has(field) || allowed.has(field)) continue;
     const fieldPath = `actions[${actionIndex}].${field}`;
     const receivedType = runtimeActionReceivedType(value);
+    const managerFieldHint = ["agent_hire", "create_agent"].includes(type ?? "") && field === "reportsToAgentId"
+      ? "; reportsToAgentId is unsupported; use reportsTo for an existing manager UUID or reportsToAgentClientKey for a manager hired in the same batch"
+      : "";
     const err = runtimeActionValidationError(
-      `${type} action has unsupported field ${field} at ${fieldPath}; received ${receivedType}`,
+      `${type} action has unsupported field ${field} at ${fieldPath}; received ${receivedType}${managerFieldHint}`,
     );
     err.runtimeActionFieldPath = fieldPath;
     err.runtimeActionReceivedType = receivedType;
@@ -7121,7 +7133,7 @@ function assertNoUnsupportedRuntimeActionFields(action, actionIndex) {
 const RUNTIME_ACTION_BOOLEAN_FIELDS = new Set([
   "blockParentUntilDone", "executeBeforeConfirmation", "createWorkProduct", "isPrimary",
   "force", "markAutoDerived", "rejectRequiresReason", "allowDeclineReason", "supersedeOnUserComment",
-  "required",
+  "required", "topLevel",
 ]);
 const RUNTIME_ACTION_NUMBER_FIELDS = new Set(["budgetMonthlyCents", "minSelected", "maxSelected", "version"]);
 const RUNTIME_ACTION_ARRAY_FIELDS = new Set([
@@ -7408,6 +7420,29 @@ function assertNoAmbiguousApprovalGatedSideEffects(actions) {
   throw error;
 }
 
+function assertDelegatedParentWaitDisposition(actions) {
+  const closesIndependentParentScope = actions.some((action) => {
+    const fields = runtimeActionBusinessFields(action);
+    if (readRuntimeActionType(fields) !== "update_parent") return false;
+    return ["done", "cancelled"].includes(readActionStatus(fields.status) ?? "");
+  });
+  for (const [actionIndex, action] of actions.entries()) {
+    const fields = runtimeActionBusinessFields(action);
+    if (readRuntimeActionType(fields) !== "create_child_task") continue;
+    if (readString(fields.parentClientKey)) continue;
+    const status = readActionStatus(fields.status) ?? "todo";
+    if (!["todo", "in_progress"].includes(status)) continue;
+    if (fields.blockParentUntilDone === true || closesIndependentParentScope) continue;
+    const err = runtimeActionValidationError(
+      "delegated_parent_wait_required: root executable child tasks require blockParentUntilDone true, or the same batch must close the parent's independent scope with update_parent done/cancelled",
+    );
+    err.runtimeActionType = "create_child_task";
+    err.runtimeActionFieldPath = `actions[${actionIndex}].blockParentUntilDone`;
+    err.runtimeActionReason = err.message;
+    throw err;
+  }
+}
+
 function assertExplicitTaskDecomposition(command, actions) {
   const requirement = commandLegacyTaskDecompositionRequirement(command);
   if (!requirement.required) return;
@@ -7498,9 +7533,14 @@ function preflightRuntimeAction(action, preflightContext, actionIndex) {
   if (["agent_hire", "create_agent"].includes(type ?? "")) {
     assertNoPlaceholderRuntimeActionText(fields, ["name", "role", "title", "instructionsBundle"]);
     assertRuntimeActionValid(readBoundedActionString(fields, "name", 240), `${type} action requires name`);
+    const reportingDispositionCount = [
+      Boolean(readString(fields.reportsTo)),
+      Boolean(readString(fields.reportsToAgentClientKey)),
+      fields.topLevel === true,
+    ].filter(Boolean).length;
     assertRuntimeActionValid(
-      !readString(fields.reportsTo) || !readString(fields.reportsToAgentClientKey),
-      `${type} action cannot combine reportsTo with reportsToAgentClientKey`,
+      reportingDispositionCount === 1,
+      `${type} action requires exactly one of reportsTo, reportsToAgentClientKey, or topLevel true`,
     );
     return;
   }
@@ -7580,6 +7620,17 @@ function preflightRuntimeAction(action, preflightContext, actionIndex) {
       `create_interaction.${kind} action requires payload; expected shape is available in runtimeActionDiagnostics.expectedShape`,
     );
     assertRuntimeCreateInteractionPayload(kind, payload);
+    const confirmationTarget = asRecord(payload.target);
+    if (
+      preflightContext.acceptedConfirmationContinuation &&
+      ["request_confirmation", "request_checkbox_confirmation"].includes(kind) &&
+      (!readString(confirmationTarget.type) || !readString(confirmationTarget.key))
+    ) {
+      assertRuntimeActionValid(
+        false,
+        "accepted_confirmation_decision_target_required: an accepted confirmation continuation requires payload.target.type and a non-empty payload.target.key so the server can identify the decision; use a new target revision for genuinely changed content or finish the accepted work",
+      );
+    }
     preflightContext.createdReviewPathForInReview = true;
     return;
   }
@@ -7635,6 +7686,7 @@ function preflightRuntimeAction(action, preflightContext, actionIndex) {
 
 function preflightRuntimeActionBatch(actions, options = {}) {
   const actionIndexByObject = new Map(actions.map((action, index) => [action, index]));
+  assertDelegatedParentWaitDisposition(actions);
   const orderedActions = orderRuntimeActionsByClientKeyDependencies(actions);
   assertRuntimeActionsAllowedByContinuationScope(orderedActions, options.continuationScope);
   assertNoAmbiguousApprovalGatedSideEffects(orderedActions);
@@ -7643,6 +7695,7 @@ function preflightRuntimeActionBatch(actions, options = {}) {
     createdRootBlockingChildForInReview: false,
     createdHumanOwnedInputPath: false,
     answeredQuestionContinuation: options.answeredQuestionContinuation === true,
+    acceptedConfirmationContinuation: options.acceptedConfirmationContinuation === true,
     allowedContentTypes: Array.isArray(options.allowedContentTypes) ? options.allowedContentTypes : [],
     cwd: readString(options.cwd),
     finalCommentBodies: [],
@@ -7908,6 +7961,11 @@ async function applyRuntimeAction(config, command, runtimeAuth, issueId, action,
         `runtime_action_postcondition_failed: agent reportsTo mismatch; expected ${reportsTo}, received ${readString(agent.reportsTo) ?? "missing"}`,
       );
     }
+    if (fields.topLevel === true && readString(agent.reportsTo)) {
+      throw new Error(
+        `runtime_action_postcondition_failed: top-level agent reportsTo mismatch; expected missing, received ${readString(agent.reportsTo)}`,
+      );
+    }
     if (agentId && clientKey) actionContext.agentIdByClientKey.set(clientKey, agentId);
     return {
       type,
@@ -7920,6 +7978,8 @@ async function applyRuntimeAction(config, command, runtimeAuth, issueId, action,
       approvalStatus: readString(approval.status),
       sourceIssueId: readString(body.sourceIssueId) ?? null,
       sourceIssueIds: runtimeActionIssueIdList(body.sourceIssueIds),
+      reportsTo: reportsTo ?? null,
+      topLevel: fields.topLevel === true,
       ...(clientKey ? { clientKey } : {}),
       reusedExisting: asRecord(created).reusedExisting === true,
     };
@@ -9156,9 +9216,11 @@ async function applyRuntimeActionBridge(config, command, parsed, execution, cwd)
   }
   let actions = orderRuntimeActionsForGovernance([...generatedUploadActions, ...rawActions]);
   const answeredQuestionContinuation = runtimeActionAnsweredQuestionContinuation(command);
+  const acceptedConfirmationContinuation = runtimeActionAcceptedConfirmationContinuation(command);
   try {
     actions = preflightRuntimeActionBatch(actions, {
       answeredQuestionContinuation,
+      acceptedConfirmationContinuation,
       allowedContentTypes,
       continuationScope,
       cwd,
@@ -9196,7 +9258,7 @@ async function applyRuntimeActionBridge(config, command, parsed, execution, cwd)
     createdChildIssueIdByFingerprint: new Map(),
     completedChildIssuesByTitle: runtimeActionCompletedChildIssueMap(command),
     createdReviewPathForInReview: false,
-    acceptedConfirmationContinuation: runtimeActionAcceptedConfirmationContinuation(command),
+    acceptedConfirmationContinuation,
     answeredQuestionContinuation,
     finalCommentBodies: [],
   };

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

package/package.json

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