@amaster.ai/employee-runtime-connector 0.1.1-beta.231 → 0.1.1-beta.233

package/README.md

@@ -18,6 +18,25 @@ npm install --omit=dev --prefix /opt/pi-cli-runtime @amaster.ai/employee-runtime
 
 Do not use `latest`, `^`, or `~` in a runtime image. The image tag and connector package version should identify one immutable deployment.
 
+## Incremental type safety
+
+`pnpm typecheck` runs the legacy entry-point syntax checks plus TypeScript strict
+`checkJs` over `src/amaster-runtime-daemon/typed/**/*.mjs` and compile-time contract
+tests in `type-tests/`. The first migrated boundary is the run-completion phase and
+event transition table. It is imported by the existing completion-state module and
+bundled normally; package layout and runtime state version are unchanged.
+
+The package declares its own TypeScript development dependency, using the same
+compiler version locked by the workspace. Source-development installs need dev
+dependencies for this gate; it must not depend on the root workspace exposing
+`tsc` on PATH. Published runtime consumers only need the distributed artifacts.
+
+Put newly extracted independent daemon logic in the typed lane with explicit
+inputs/outputs. New files in that directory are included automatically. Do not add
+`any` or disable checking to make the gate pass. Keep untrusted I/O validation at
+the boundary. `check:syntax` is only a parser check; this incremental gate does not
+claim that the existing CLI/daemon or all legacy helpers are fully type-checked.
+
 Immutable images should pin an exact package version as their baseline. The current connector does not download or replace runtime code while running; package upgrades and rollbacks belong to the image build and rollout.
 
 The governed MCP cache identity follows the installed `pi-mcp-adapter` version.

package/dist/amaster-runtime-daemon.mjs

@@ -5377,6 +5377,44 @@ var ERROR_PRESENTATIONS = {
 };
 var AMASTER_RUNTIME_USER_PRESENTATION_ERROR_CODES = Object.freeze(Object.keys(ERROR_PRESENTATIONS).sort());
 
+// ../shared/src/mirrorx-prerequisite-validators.ts
+var taskPrerequisiteCheckSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  revision: external_exports.number().int().positive(),
+  validatorId: external_exports.literal("accepted_product_specification_v1"),
+  input: external_exports.object({ delivery: external_exports.discriminatedUnion("kind", [
+    external_exports.object({ kind: external_exports.literal("missing") }).strict(),
+    external_exports.object({ kind: external_exports.literal("accepted_prerequisite"), bindingId: external_exports.string().uuid(), acceptanceId: external_exports.string().uuid() }).strict()
+  ]) }).strict()
+}).strict();
+var taskPrerequisiteChecksSchema = external_exports.array(taskPrerequisiteCheckSchema).max(20).superRefine((checks, ctx) => {
+  if (new Set(checks.map((check) => check.id)).size !== checks.length || new Set(checks.map((check) => check.validatorId)).size !== checks.length) {
+    ctx.addIssue({ code: external_exports.ZodIssueCode.custom, message: "Prerequisite checks must have unique identities and validators" });
+  }
+});
+var prerequisiteValidationReceiptSchema = external_exports.object({
+  schemaVersion: external_exports.literal("prerequisite-validation-v1"),
+  id: external_exports.string().uuid(),
+  companyId: external_exports.string().uuid(),
+  targetIssueId: external_exports.string().uuid(),
+  targetExecutionEpoch: external_exports.number().int().positive(),
+  checkId: external_exports.string().uuid(),
+  checkRevision: external_exports.number().int().positive(),
+  validatorId: external_exports.literal("accepted_product_specification_v1"),
+  validatorRevision: external_exports.literal("1"),
+  inputHash: external_exports.string().regex(/^sha256:[a-f0-9]{64}$/),
+  result: external_exports.enum(["missing", "satisfied"]),
+  reasonCode: external_exports.enum(["product_specification_receipt_missing", "product_specification_receipt_accepted"]),
+  deliveryBindingId: external_exports.string().uuid().nullable(),
+  acceptanceId: external_exports.string().uuid().nullable(),
+  validatedAt: external_exports.string().datetime({ offset: true })
+}).strict().superRefine((receipt, ctx) => {
+  const satisfied = receipt.result === "satisfied";
+  if (satisfied !== (receipt.reasonCode === "product_specification_receipt_accepted") || satisfied !== (receipt.deliveryBindingId !== null) || satisfied !== (receipt.acceptanceId !== null)) {
+    ctx.addIssue({ code: external_exports.ZodIssueCode.custom, message: "Prerequisite validation result and accepted receipt disagree" });
+  }
+});
+
 // ../shared/src/mirrorx-prerequisite-requirements.ts
 var taskPrerequisiteSlotSchema = external_exports.object({
   id: external_exports.string().uuid(),
@@ -6665,6 +6703,7 @@ var issueDeliveryRequirementV2Schema = external_exports.object({
 var issueTaskRequirementsV2Schema = external_exports.object({
   requirementsVersion: external_exports.literal("v2"),
   prerequisiteSlots: taskPrerequisiteSlotsSchema.optional(),
+  prerequisiteChecks: taskPrerequisiteChecksSchema.optional(),
   taskIntent: taskIntentRequirementSchema,
   executionShape: external_exports.enum(TASK_EXECUTION_SHAPES),
   completionStrategy: external_exports.enum(TASK_COMPLETION_STRATEGIES).nullable(),
@@ -9867,6 +9906,7 @@ function withCreateIssueStatusDefault(schema) {
 }
 var createIssueBaseSchema = external_exports.object({
   prerequisiteSlots: taskPrerequisiteSlotsSchema.optional(),
+  prerequisiteChecks: taskPrerequisiteChecksSchema.optional(),
   creationProfile: external_exports.literal(MIRRORX_AGENT_SESSION_CREATION_PROFILE).optional(),
   projectId: external_exports.string().uuid().optional().nullable(),
   projectWorkspaceId: external_exports.string().uuid().optional().nullable(),
@@ -9953,7 +9993,7 @@ var createIssueSchema = withCreateIssueStatusDefault(external_exports.union([
   ordinaryCreateIssueSchema
 ]));
 var createModelIssueSchema = createIssueSchema.superRefine((value, ctx) => {
-  if (value.prerequisiteSlots !== void 0) {
+  if (value.prerequisiteSlots !== void 0 || value.prerequisiteChecks !== void 0) {
     ctx.addIssue({ code: external_exports.ZodIssueCode.custom, path: ["prerequisiteSlots"], message: "Model creation cannot declare cross-Issue prerequisite authority" });
   }
   const systemWatchdogFollowUp = value.watchdogDiscovery?.kind === "product_bug";
@@ -9982,6 +10022,7 @@ var createChildIssueSchema = withCreateIssueStatusDefault(createIssueBaseSchema.
 }).extend({
   creationProfile: external_exports.never().optional(),
   prerequisiteSlots: external_exports.never().optional(),
+  prerequisiteChecks: external_exports.never().optional(),
   delegation: issueDelegationInputSchema,
   acceptanceCriteria: external_exports.array(external_exports.string().trim().min(1).max(500)).max(20).optional(),
   blockParentUntilDone: external_exports.boolean().optional().default(false),
@@ -10008,6 +10049,7 @@ var updateIssueSchema = createIssueBaseSchema.omit({
 }).partial().extend({
   creationProfile: external_exports.never().optional(),
   prerequisiteSlots: external_exports.never().optional(),
+  prerequisiteChecks: external_exports.never().optional(),
   taskIntent: external_exports.enum(["business", "system", "legacy"]).optional(),
   requestDepth: issueRequestDepthInputSchema.optional(),
   assigneeAgentId: external_exports.string().trim().min(1).optional().nullable(),
@@ -12281,6 +12323,8 @@ var BUSINESS_TASK_ENROLLMENT_READ_STATES = [
 var BUSINESS_TASK_ENROLLMENT_WAKE_STATUSES = [
   "pending",
   "waiting_dependency",
+  "waiting_prerequisite",
+  "transferred_prerequisite",
   "leased",
   "delivered",
   "cancelled",
@@ -12404,6 +12448,8 @@ var governedBusinessTaskEnrollmentSchema = external_exports.object({
 }).strict();
 var governedBusinessTaskWakeDispatchSchema = external_exports.object({
   outboxId: external_exports.string().uuid(),
+  prerequisiteAssignmentReceiptId: external_exports.string().uuid().nullable(),
+  prerequisiteReleaseBindingId: external_exports.string().uuid().nullable(),
   enrollmentId: external_exports.string().uuid(),
   executionEpoch: external_exports.number().int().positive(),
   agentId: external_exports.string().uuid(),
@@ -15985,6 +16031,16 @@ var listPluginStateSchema = external_exports.object({
   namespace: external_exports.string().min(1).optional()
 });
 
+// ../shared/src/validators/company-execution-control.ts
+var companyExecutionControlSchema = external_exports.object({
+  action: external_exports.enum(["pause", "resume"]),
+  confirmed: external_exports.literal(true)
+}).strict();
+var companyExecutionControlStatusSchema = external_exports.object({
+  companyId: external_exports.string().uuid(),
+  state: external_exports.enum(["running", "pausing", "paused", "resuming", "unavailable"])
+});
+
 // ../shared/src/api.ts
 var API_PREFIX = "/api";
 var API = {
@@ -20713,14 +20769,18 @@ function createManagedPiMcpProfileApi(options = {}) {
     "mirrorx.read_issue_evidence",
     "mirrorx.read_governed_business_state"
   ]);
-  const FULL_DIRECT_TYPED_V1_WIKI_TOOL_NAMES = /* @__PURE__ */ new Set([
+  const FULL_DIRECT_TYPED_V1_WIKI_READ_TOOL_NAMES = /* @__PURE__ */ new Set([
     "wiki_list",
     "wiki_search",
     "wiki_read",
-    "wiki_write",
     "wiki_list_versions",
     "wiki_diff_versions"
   ]);
+  const FULL_DIRECT_TYPED_V1_WIKI_WRITE_TOOL_NAME = "wiki_write";
+  const FULL_DIRECT_TYPED_V1_WIKI_TOOL_NAMES = /* @__PURE__ */ new Set([
+    ...FULL_DIRECT_TYPED_V1_WIKI_READ_TOOL_NAMES,
+    FULL_DIRECT_TYPED_V1_WIKI_WRITE_TOOL_NAME
+  ]);
   const FULL_DIRECT_TYPED_V1_CONNECTOR_TOOL_NAMES = /* @__PURE__ */ new Set([
     "connector.search_actions",
     "connector.get_action_guide",
@@ -21311,9 +21371,11 @@ function createManagedPiMcpProfileApi(options = {}) {
     const declaredToolNames = new Set(tools.map((tool) => tool.name).filter((name) => typeof name === "string"));
     const covers = (set) => [...set].every((name) => declaredToolNames.has(name));
     const countIn = (set) => tools.filter((tool) => set.has(tool.name)).length;
-    const fullWikiCount = countIn(FULL_DIRECT_TYPED_V1_WIKI_TOOL_NAMES);
+    const fullWikiReadCount = countIn(FULL_DIRECT_TYPED_V1_WIKI_READ_TOOL_NAMES);
+    const hasWikiWrite = declaredToolNames.has(FULL_DIRECT_TYPED_V1_WIKI_WRITE_TOOL_NAME);
+    const fullWikiCount = fullWikiReadCount + (hasWikiWrite ? 1 : 0);
     const fullConnectorCount = countIn(FULL_DIRECT_TYPED_V1_CONNECTOR_TOOL_NAMES);
-    const fullCatalog = mcpToolMode === MANAGED_PI_DIRECT_TYPED_MCP_TOOL_MODE && tools.length === FULL_DIRECT_TYPED_V1_BASE_TOOL_NAMES.size + fullWikiCount + fullConnectorCount && covers(FULL_DIRECT_TYPED_V1_BASE_TOOL_NAMES) && (fullWikiCount === 0 || fullWikiCount === FULL_DIRECT_TYPED_V1_WIKI_TOOL_NAMES.size) && (fullConnectorCount === 0 || fullConnectorCount === FULL_DIRECT_TYPED_V1_CONNECTOR_TOOL_NAMES.size) && tools.every((tool) => FULL_DIRECT_TYPED_V1_TOOL_NAMES.has(tool.name));
+    const fullCatalog = mcpToolMode === MANAGED_PI_DIRECT_TYPED_MCP_TOOL_MODE && tools.length === FULL_DIRECT_TYPED_V1_BASE_TOOL_NAMES.size + fullWikiCount + fullConnectorCount && covers(FULL_DIRECT_TYPED_V1_BASE_TOOL_NAMES) && (fullWikiReadCount === 0 && !hasWikiWrite || fullWikiReadCount === FULL_DIRECT_TYPED_V1_WIKI_READ_TOOL_NAMES.size) && (fullConnectorCount === 0 || fullConnectorCount === FULL_DIRECT_TYPED_V1_CONNECTOR_TOOL_NAMES.size) && tools.every((tool) => FULL_DIRECT_TYPED_V1_TOOL_NAMES.has(tool.name));
     if (mcpToolMode === MANAGED_PI_DIRECT_TYPED_MCP_TOOL_MODE && !fullCatalog) {
       throw new Error("pi_managed_mcp_invalid: direct tool catalog size mismatch");
     }
@@ -23491,8 +23553,8 @@ function isTerminalResultOutboxStatus(status) {
 // src/amaster-runtime-daemon/run-completion-state.mjs
 import { existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync10, readdirSync as readdirSync5, renameSync as renameSync5, unlinkSync as unlinkSync2, writeFileSync as writeFileSync6 } from "node:fs";
 import { join as join8 } from "node:path";
-var RUN_COMPLETION_STATE_VERSION = 1;
-var RUN_COMPLETION_USAGE_SCHEMA_VERSION = "runtime-command-usage-v1";
+
+// src/amaster-runtime-daemon/typed/run-completion-transitions.mjs
 var RUN_COMPLETION_PHASES = /* @__PURE__ */ new Set([
   "executing",
   "usage_snapshot_persisted",
@@ -23532,6 +23594,16 @@ var PHASE_TRANSITIONS = /* @__PURE__ */ new Map([
   ["profile_cleanup:profile_cleanup_abandoned", "result_post_pending"],
   ["result_post_pending:result_post_delivered", "terminal"]
 ]);
+function isRunCompletionPhase(value) {
+  return typeof value === "string" && RUN_COMPLETION_PHASES.has(value);
+}
+function nextRunCompletionPhase(phase, event) {
+  return PHASE_TRANSITIONS.get(`${phase}:${event}`);
+}
+
+// src/amaster-runtime-daemon/run-completion-state.mjs
+var RUN_COMPLETION_STATE_VERSION = 1;
+var RUN_COMPLETION_USAGE_SCHEMA_VERSION = "runtime-command-usage-v1";
 function record4(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
@@ -23662,7 +23734,7 @@ function appendRunCompletionUsageTurn(state, input) {
 }
 function transitionRunCompletionState(state, event, patch = {}, now = (/* @__PURE__ */ new Date()).toISOString()) {
   const current = assertValidRunCompletionState(state);
-  const nextPhase = PHASE_TRANSITIONS.get(`${current.phase}:${event}`);
+  const nextPhase = nextRunCompletionPhase(current.phase, event);
   if (!nextPhase) {
     throw new Error(`run_completion_state_transition_invalid:${current.phase}:${event}`);
   }
@@ -23690,7 +23762,7 @@ function assertValidRunCompletionState(value) {
   if (state.version !== RUN_COMPLETION_STATE_VERSION) throw new Error("run_completion_state_invalid:version");
   const commandId = nonEmptyString(state.commandId, "commandId");
   const connectorId = nonEmptyString(state.connectorId, "connectorId");
-  if (!RUN_COMPLETION_PHASES.has(state.phase)) throw new Error("run_completion_state_invalid:phase");
+  if (!isRunCompletionPhase(state.phase)) throw new Error("run_completion_state_invalid:phase");
   const command = record4(state.command);
   if (nonEmptyString(command.commandId ?? command.id, "command.commandId") !== commandId) {
     throw new Error("run_completion_state_invalid:command_binding");
@@ -30303,7 +30375,7 @@ function assertRequiredTaskAttachmentMaterialized(input, materialized) {
 }
 
 // src/amaster-runtime-daemon.mjs
-var CONNECTOR_VERSION = "0.1.1-beta.231";
+var CONNECTOR_VERSION = "0.1.1-beta.233";
 var CONNECTOR_CONTRACT_VERSION = "2026-06-04.v1";
 var daemonRequire = createRequire(import.meta.url);
 var MAX_CHECKPOINT_BYTES = 20 * 1024 * 1024;

package/dist/amaster-runtime.mjs

@@ -7,7 +7,7 @@ import { homedir, hostname } from "node:os";
 import { fileURLToPath } from "node:url";
 import { BUILD_SUPPORTED_CAPABILITIES } from "./amaster-runtime-daemon/capability-registry.mjs";
 
-const CONNECTOR_VERSION = "0.1.1-beta.231";
+const CONNECTOR_VERSION = "0.1.1-beta.233";
 
 const CONFIG_KEY_MAP = new Map([
   ["server_url", "AMASTER_EMPLOYEE_SERVER_URL"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/employee-runtime-connector",
-  "version": "0.1.1-beta.231",
+  "version": "0.1.1-beta.233",
   "description": "MirrorX runtime connector CLI and daemon",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,8 @@
     "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",
+    "check:syntax": "node --check scripts/build.mjs && node --check scripts/bundle.mjs && node --check src/amaster-runtime.mjs && node --check src/amaster-runtime-daemon.mjs",
+    "typecheck": "pnpm run check:syntax && tsc --project tsconfig.json",
     "test": "pnpm run build && node --test test/*.test.mjs src/amaster-runtime-daemon/*.test.mjs",
     "prepack": "pnpm run test"
   },
@@ -30,7 +31,8 @@
   "devDependencies": {
     "@paperclipai/shared": "workspace:*",
     "esbuild": "^0.27.3",
-    "smol-toml": "1.7.0"
+    "smol-toml": "1.7.0",
+    "typescript": "^5.7.3"
   },
   "dependencies": {
     "playwright-core": "^1.58.2"