@amaster.ai/employee-runtime-connector 0.1.0-beta.16 → 0.1.0-beta.17

package/dist/amaster-runtime-daemon.mjs

@@ -2359,7 +2359,7 @@ 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";
 import { StringDecoder } from "node:string_decoder";
-const CONNECTOR_VERSION = "0.1.0-beta.16";
+const CONNECTOR_VERSION = "0.1.0-beta.17";
 const MAX_INFERRED_ARTIFACT_UPLOADS = 20;
 const MAX_CHECKPOINT_BYTES = 20 * 1024 * 1024;
 const CHECKPOINT_TTL_MS = 24 * 60 * 60 * 1000;
@@ -3483,6 +3483,52 @@ function commandLegacyTaskDecompositionRequirement(command) {
   return legacyTaskDecompositionRequirement(asRecord(payload.contextSnapshot));
 }
 
+const TASK_DECOMPOSITION_MODES = new Set(["none", "required", "suggest_only"]);
+const TASK_DECOMPOSITION_SOURCE_TYPES = new Set([
+  "system_default",
+  "system_migration",
+  "operator",
+  "api",
+  "accepted_plan",
+  "workflow",
+]);
+
+function commandTaskDecompositionRequirement(command) {
+  const payload = asRecord(command.payload);
+  const context = asRecord(payload.contextSnapshot);
+  const envelope = asRecord(context.authorizationEnvelope);
+  const authority = readString(envelope.decompositionRequirementAuthority) ?? "shadow";
+  if (authority === "shadow") return commandLegacyTaskDecompositionRequirement(command);
+  if (authority !== "enforce") {
+    throw new Error(`Invalid typed decomposition requirement authority ${authority}`);
+  }
+  const requirement = asRecord(envelope.decompositionRequirement);
+  const source = asRecord(requirement.source);
+  const mode = readString(requirement.mode);
+  const sourceType = readString(source.type);
+  const sourceId = readString(source.id);
+  const sourceRevision = readString(source.revision);
+  const requirementKeys = Object.keys(requirement).sort().join(",");
+  const sourceKeys = Object.keys(source).sort().join(",");
+  if (
+    !TASK_DECOMPOSITION_MODES.has(mode)
+    || !TASK_DECOMPOSITION_SOURCE_TYPES.has(sourceType)
+    || !sourceId
+    || !sourceRevision
+    || requirementKeys !== "mode,source"
+    || sourceKeys !== "id,revision,type"
+  ) {
+    throw new Error("Candidate command requires one strict typed decomposition requirement");
+  }
+  return {
+    required: mode === "required",
+    suggested: mode === "suggest_only",
+    authorityMode: "enforce",
+    source: "typed_task_requirement",
+    sourceRef: { type: sourceType, id: sourceId, revision: sourceRevision, mode },
+  };
+}
+
 function normalizeAgentInstructionsFiles(bundle) {
   const files = asRecord(bundle.files);
   const selected = [];
@@ -3599,6 +3645,9 @@ function runtimeActionsInstruction(options = {}) {
     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. 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."
       : "",
+    options.decompositionSuggested
+      ? "The typed task requirement suggests child task decomposition without making it a hard gate. Prefer create_child_task or suggest_tasks when decomposition materially helps; other valid mutations remain allowed."
+      : "",
     options.canOrchestrateOrganization
       ? "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.",
@@ -3933,9 +3982,11 @@ function buildCommandPrompt(command, workspace, materializedAttachments = [], op
   const authorizationEnvelope = runtimeActionAuthorizationEnvelope(command);
   const canOrchestrateOrganization = canRuntimeAgentOrchestrateOrganization(context)
     && authorizationEnvelope.allowedActionClasses.has("organization_mutation");
-  const decompositionRequirement = commandLegacyTaskDecompositionRequirement(command);
+  const decompositionRequirement = commandTaskDecompositionRequirement(command);
   const explicitDecompositionRequired = decompositionRequirement.required
     && runtimeActionChildIssueSummaryEntries(command).length === 0;
+  const decompositionSuggested = decompositionRequirement.suggested === true
+    && runtimeActionChildIssueSummaryEntries(command).length === 0;
   const executingAgent = asRecord(context.paperclipExecutingAgent);
   const currentAgentAdapterType = readString(executingAgent.adapterType);
   const validatorContentTypes = runtimeAttachmentContentTypes(command);
@@ -3968,6 +4019,7 @@ function buildCommandPrompt(command, workspace, materializedAttachments = [], op
       canOrchestrateOrganization,
       currentAgentAdapterType,
       explicitDecompositionRequired,
+      decompositionSuggested,
       artifactVerifierCommands: options.artifactVerifierCommands,
       actionValidatorCommand,
       authorizationEnvelope,
@@ -7724,7 +7776,7 @@ function assertDelegatedParentWaitDisposition(actions) {
 }
 
 function assertExplicitTaskDecomposition(command, actions) {
-  const requirement = commandLegacyTaskDecompositionRequirement(command);
+  const requirement = commandTaskDecompositionRequirement(command);
   if (!requirement.required) return;
   if (runtimeActionChildIssueSummaryEntries(command).length > 0) return;
   const hasDecompositionAction = actions.some((action) => {
@@ -7735,12 +7787,15 @@ function assertExplicitTaskDecomposition(command, actions) {
   });
   if (hasDecompositionAction) return;
   const error = new Error(
-    "task explicitly requires child task decomposition under the legacy text hard gate; emit create_child_task or suggest_tasks instead of only describing a checklist",
+    requirement.authorityMode === "enforce"
+      ? "task explicitly requires child task decomposition under the typed task requirement; emit create_child_task or suggest_tasks instead of only describing a checklist"
+      : "task explicitly requires child task decomposition under the legacy text hard gate; emit create_child_task or suggest_tasks instead of only describing a checklist",
   );
   error.runtimeActionType = "decomposition";
   error.runtimeActionReason = error.message;
   error.runtimeActionDecompositionRequirementSource = requirement.source;
   error.runtimeActionDecompositionMatch = requirement.match;
+  error.runtimeActionDecompositionSourceRef = requirement.sourceRef;
   throw error;
 }
 
@@ -9241,6 +9296,9 @@ function runtimeActionDiagnostics(err, options = {}) {
     ...(err?.runtimeActionDecompositionMatch
       ? { decompositionMatch: err.runtimeActionDecompositionMatch }
       : {}),
+    ...(err?.runtimeActionDecompositionSourceRef
+      ? { decompositionSourceRef: err.runtimeActionDecompositionSourceRef }
+      : {}),
     ...(err?.runtimeActionInferenceTrace ? { inferenceTrace: err.runtimeActionInferenceTrace } : {}),
     ...(readString(err?.runtimeActionFieldPath) ? { fieldPath: readString(err.runtimeActionFieldPath) } : {}),
     ...(readString(err?.runtimeActionReceivedType) ? { receivedType: readString(err.runtimeActionReceivedType) } : {}),

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/employee-runtime-connector",
-  "version": "0.1.0-beta.16",
+  "version": "0.1.0-beta.17",
   "description": "AMaster Employee runtime connector CLI and daemon",
   "license": "MIT",
   "type": "module",
@@ -15,6 +15,8 @@
   "scripts": {
     "build": "node scripts/build.mjs",
     "clean": "node scripts/clean.mjs",
+    "phase0b:live": "node probes/runtime-v2-phase0b/live-probe.mjs",
+    "phase0b:test": "node --test probes/runtime-v2-phase0b/*.test.mjs",
     "typecheck": "node --check scripts/build.mjs && node --check scripts/bundle.mjs && node --check src/amaster-runtime.mjs && node --check src/amaster-runtime-daemon.mjs",
     "test": "pnpm run build && node --test test/*.test.mjs src/amaster-runtime-daemon/*.test.mjs",
     "prepack": "pnpm run test"