@amaster.ai/employee-runtime-connector 0.1.1-beta.10 → 0.1.1-beta.12

package/dist/amaster-runtime-daemon.mjs

@@ -3,7 +3,7 @@
 
 // src/amaster-runtime-daemon.mjs
 import { createHash as createHash13 } from "node:crypto";
-import { chmodSync as chmodSync6, copyFileSync as copyFileSync3, existsSync as existsSync14, lstatSync as lstatSync7, mkdirSync as mkdirSync9, mkdtempSync, readFileSync as readFileSync11, readdirSync as readdirSync9, realpathSync as realpathSync5, renameSync as renameSync6, rmSync as rmSync7, statSync as statSync7, symlinkSync as symlinkSync4, unlinkSync as unlinkSync2, writeFileSync as writeFileSync9 } from "node:fs";
+import { chmodSync as chmodSync6, copyFileSync as copyFileSync3, existsSync as existsSync14, lstatSync as lstatSync7, mkdirSync as mkdirSync9, mkdtempSync, readFileSync as readFileSync11, readdirSync as readdirSync9, realpathSync as realpathSync5, renameSync as renameSync6, rmSync as rmSync7, statSync as statSync8, symlinkSync as symlinkSync4, unlinkSync as unlinkSync2, writeFileSync as writeFileSync9 } from "node:fs";
 import { arch as arch3, homedir as homedir3, hostname as hostname2, platform as platform3, tmpdir } from "node:os";
 import { basename as basename6, delimiter as delimiter3, dirname as dirname9, extname as extname2, isAbsolute as isAbsolute8, join as join15, relative as relative9, resolve as resolve12 } from "node:path";
 import { spawn as spawn2, spawnSync as spawnSync6 } from "node:child_process";
@@ -3021,6 +3021,7 @@ function createManagedPiMcpProfileApi(options = {}) {
       throw new Error("pi_managed_mcp_source_acquisition_extension_missing");
     }
     copyPrivateFile(join4(source, "models.json"), join4(agentDir, "models.json"));
+    copyPrivateFile(join4(source, "SYSTEM.md"), join4(agentDir, "SYSTEM.md"));
     const authSource = join4(source, "auth.json");
     const protectedValues = [];
     if (copyPrivateFile(authSource, join4(agentDir, "auth.json"))) {
@@ -7073,13 +7074,27 @@ function createRuntimeArtifactIngestQueue({ ingest, onError }) {
 
 // src/amaster-runtime-daemon/workspace-guard.mjs
 import { createHash as createHash6 } from "node:crypto";
-import { existsSync as existsSync7, mkdirSync as mkdirSync6, realpathSync as realpathSync4, statSync as statSync3 } from "node:fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync6, realpathSync as realpathSync4, statSync as statSync4 } from "node:fs";
 import { basename as basename4, join as join8, isAbsolute as isAbsolute4, relative as relative4, resolve as resolve4 } from "node:path";
 
 // src/amaster-runtime-daemon/workspace-manifest.mjs
-import { existsSync as existsSync6, readFileSync as readFileSync7, renameSync as renameSync4, rmSync as rmSync4, writeFileSync as writeFileSync6 } from "node:fs";
+import { chownSync, existsSync as existsSync6, readFileSync as readFileSync7, renameSync as renameSync4, rmSync as rmSync4, statSync as statSync3, writeFileSync as writeFileSync6 } from "node:fs";
 import { basename as basename3, dirname as dirname5, join as join7 } from "node:path";
 var WORKSPACE_MANIFEST_FILENAME = ".amaster-runtime.json";
+function syncManifestDirOwnership(manifestPath, deps = {}) {
+  const stat = deps.statSync ?? statSync3;
+  const chown = deps.chownSync ?? chownSync;
+  const geteuid = deps.geteuid ?? (typeof process.geteuid === "function" ? process.geteuid.bind(process) : () => null);
+  try {
+    if (geteuid() !== 0) return false;
+    const dirStat = stat(dirname5(manifestPath));
+    if (dirStat.uid === 0 && dirStat.gid === 0) return false;
+    chown(manifestPath, dirStat.uid, dirStat.gid);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function nowIso() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
@@ -7098,7 +7113,7 @@ function readWorkspaceManifest(manifestPath) {
     return null;
   }
 }
-function writeWorkspaceManifest(manifestPath, manifest) {
+function writeWorkspaceManifest(manifestPath, manifest, deps) {
   const tempPath = join7(
     dirname5(manifestPath),
     `.${basename3(manifestPath)}.tmp-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`
@@ -7107,6 +7122,7 @@ function writeWorkspaceManifest(manifestPath, manifest) {
     writeFileSync6(tempPath, `${JSON.stringify(manifest, null, 2)}
 `, { mode: 384 });
     renameSync4(tempPath, manifestPath);
+    syncManifestDirOwnership(manifestPath, deps);
   } catch (err) {
     rmSync4(tempPath, { force: true });
     throw err;
@@ -7177,7 +7193,7 @@ function resolveWorkspaceCwd(config, command) {
   if (!allowed) {
     throw new Error(`Workspace path is outside AMASTER_WORKSPACE_ALLOWLIST: ${cwd}`);
   }
-  if (!existsSync7(cwd) || !statSync3(cwd).isDirectory()) {
+  if (!existsSync7(cwd) || !statSync4(cwd).isDirectory()) {
     throw new Error(`Workspace path does not exist or is not a directory: ${cwd}`);
   }
   return cwd;
@@ -7247,7 +7263,7 @@ function resolveExecutionWorkspace(config, command, opts = {}) {
 }
 
 // src/amaster-runtime-daemon/workspace-gc.mjs
-import { existsSync as existsSync8, readdirSync as readdirSync4, statSync as statSync4 } from "node:fs";
+import { existsSync as existsSync8, readdirSync as readdirSync4, statSync as statSync5 } from "node:fs";
 import { join as join9, resolve as resolve5 } from "node:path";
 function readIsoTime(value) {
   if (typeof value !== "string" || !value.trim()) return null;
@@ -7289,7 +7305,7 @@ function directorySizeBytes(path) {
     if (!current) continue;
     let stat;
     try {
-      stat = statSync4(current, { throwIfNoEntry: false });
+      stat = statSync5(current, { throwIfNoEntry: false });
     } catch {
       continue;
     }
@@ -7375,7 +7391,7 @@ function planManagedWorkspaceGcDryRun(input) {
 }
 
 // src/amaster-runtime-daemon/runtime-status-summary.mjs
-import { existsSync as existsSync9, readdirSync as readdirSync5, statSync as statSync5 } from "node:fs";
+import { existsSync as existsSync9, readdirSync as readdirSync5, statSync as statSync6 } from "node:fs";
 import { dirname as dirname6, join as join10, resolve as resolve6 } from "node:path";
 function runtimeStatusDirectoryEntries(path) {
   try {
@@ -7392,7 +7408,7 @@ function runtimeStatusDirectorySizeBytes(path) {
     if (!current) continue;
     let stat;
     try {
-      stat = statSync5(current, { throwIfNoEntry: false });
+      stat = statSync6(current, { throwIfNoEntry: false });
     } catch {
       continue;
     }
@@ -7630,13 +7646,13 @@ function summarizeAmasterRuntimeVersionDrift(input = {}) {
 import { createHash as createHash7 } from "node:crypto";
 import {
   chmodSync as chmodSync3,
-  chownSync,
+  chownSync as chownSync2,
   lchownSync,
   lstatSync as lstatSync4,
   readdirSync as readdirSync6
 } from "node:fs";
 import { resolve as resolve7, sep } from "node:path";
-var defaultFs = { chmodSync: chmodSync3, chownSync, lchownSync, lstatSync: lstatSync4, readdirSync: readdirSync6 };
+var defaultFs = { chmodSync: chmodSync3, chownSync: chownSync2, lchownSync, lstatSync: lstatSync4, readdirSync: readdirSync6 };
 function defaultHashRunId(runId) {
   return Number.parseInt(createHash7("sha256").update(runId).digest("hex").slice(0, 8), 16);
 }
@@ -7765,7 +7781,7 @@ function preparePiChildIsolation(input) {
 import { createHash as createHash8 } from "node:crypto";
 import {
   chmodSync as chmodSync4,
-  chownSync as chownSync2,
+  chownSync as chownSync3,
   existsSync as existsSync10,
   lchownSync as lchownSync2,
   lstatSync as lstatSync5,
@@ -7785,7 +7801,7 @@ var DEFAULT_GID_BASE = 1e5;
 var DEFAULT_GID_SPAN = 1e6;
 var defaultFs2 = {
   chmodSync: chmodSync4,
-  chownSync: chownSync2,
+  chownSync: chownSync3,
   existsSync: existsSync10,
   lchownSync: lchownSync2,
   lstatSync: lstatSync5,
@@ -8528,7 +8544,7 @@ function verifyTrustedPiRuntimeAssertion(input) {
 // src/amaster-runtime-daemon/workspace-status.mjs
 import { spawnSync as spawnSync4 } from "node:child_process";
 import { createHash as createHash10 } from "node:crypto";
-import { existsSync as existsSync12, readdirSync as readdirSync8, readFileSync as readFileSync10, statSync as statSync6 } from "node:fs";
+import { existsSync as existsSync12, readdirSync as readdirSync8, readFileSync as readFileSync10, statSync as statSync7 } from "node:fs";
 import { basename as basename5, extname, isAbsolute as isAbsolute7, join as join13, relative as relative7, resolve as resolve10 } from "node:path";
 var WORKSPACE_RUNTIME_SERVICES_FILENAME = ".amaster-runtime-services.json";
 var ARTIFACT_EXTENSIONS = /* @__PURE__ */ new Map([
@@ -8661,7 +8677,7 @@ function scanArtifactCandidates(cwd, opts = {}) {
       const type = ARTIFACT_EXTENSIONS.get(ext) ?? "file";
       let stat;
       try {
-        stat = statSync6(fullPath);
+        stat = statSync7(fullPath);
       } catch {
         continue;
       }
@@ -9394,7 +9410,7 @@ function assertSourceAcquisitionRuntimeAuthority({
 }
 
 // src/amaster-runtime-daemon.mjs
-var CONNECTOR_VERSION = "0.1.1-beta.10";
+var CONNECTOR_VERSION = "0.1.1-beta.12";
 var CONNECTOR_CONTRACT_VERSION = "2026-06-04.v1";
 var SOURCE_ACQUISITION_CAPABILITY = "source_acquisition_v1";
 var SOURCE_ACQUISITION_PROFILE_VERSION = "source_acquisition_v1";
@@ -9681,7 +9697,7 @@ function safeDirectorySummary(pathValue) {
     return { configured: false, available: false, entryCount: 0 };
   }
   try {
-    const stat = statSync7(pathValue);
+    const stat = statSync8(pathValue);
     if (!stat.isDirectory()) {
       return { configured: true, available: false, entryCount: 0, reason: "not_directory" };
     }
@@ -9715,7 +9731,7 @@ function safeSkillRootSummary(kind, source, pathValue) {
         if (name.startsWith(".")) continue;
         const skillDir = join15(pathValue, name);
         try {
-          if (!statSync7(skillDir).isDirectory()) continue;
+          if (!statSync8(skillDir).isDirectory()) continue;
           if (!existsSync14(join15(skillDir, "SKILL.md"))) continue;
           skillCount += 1;
           if (skillCount >= MAX_PI_CAPABILITY_SOURCE_ENTRIES) {
@@ -9744,7 +9760,7 @@ function safeJsonConfigSummary(source, pathValue, counter) {
     return { source, configured: false, available: false, parseable: false };
   }
   try {
-    const stat = statSync7(pathValue);
+    const stat = statSync8(pathValue);
     if (!stat.isFile()) {
       return { source, configured: true, available: false, parseable: false, reason: "not_file" };
     }
@@ -10065,8 +10081,10 @@ function buildHeartbeatPayload(config, options = {}) {
   const desktopPlatformCredential = desktopPlatformCredentialStatus(config);
   const headedBrowserAuth = browserCapabilityStatus(config, "headed_browser_auth");
   const sourceAcquisition = sourceAcquisitionRuntimeReadiness(config);
+  const status = options.status === "offline" ? "offline" : "online";
+  const daemonStatus = status === "offline" ? "stopping" : "running";
   return {
-    status: "online",
+    status,
     workspaceBindings: config.workspaceBindings,
     networkDomains: config.networkDomains,
     executors: config.executors,
@@ -10078,8 +10096,9 @@ function buildHeartbeatPayload(config, options = {}) {
     arch: process.arch,
     ...trustedPiRuntimeProvenancePayload(config),
     runtimeStatus: {
-      daemon: "running",
+      daemon: daemonStatus,
       pid: process.pid,
+      ...status === "offline" ? { offlineReason: readString(options.offlineReason) ?? "daemon_shutdown" } : {},
       ...heartbeatMode === "diagnostic" ? { heartbeatMode: "diagnostic" } : {},
       ...diagnosticSource ? { diagnosticSource } : {},
       ...orphanCheck === "startup" ? { orphanCheck: "startup" } : {},
@@ -10349,7 +10368,11 @@ async function register(config, options = {}) {
 async function heartbeat(config, options = {}) {
   const connectorId = requireConnectorId(config);
   const mode = heartbeatLogMode(options.logMode) || heartbeatLogMode(process.env.AMASTER_HEARTBEAT_LOG_MODE) || "compact";
-  const payload = buildHeartbeatPayload(config, { orphanCheck: options.orphanCheck });
+  const payload = buildHeartbeatPayload(config, {
+    orphanCheck: options.orphanCheck,
+    status: options.status,
+    offlineReason: options.offlineReason
+  });
   writeLocalRuntimeStatus(config, payload.runtimeStatus);
   const body = await postJson(
     config,
@@ -10361,6 +10384,38 @@ async function heartbeat(config, options = {}) {
 `);
   return body;
 }
+async function reportOfflineHeartbeat(config, reason) {
+  if (!readString(config.connectorId)) {
+    return;
+  }
+  await heartbeat(config, {
+    logMode: "compact",
+    status: "offline",
+    offlineReason: reason
+  });
+}
+var shutdownHeartbeatInFlight = false;
+function installShutdownHeartbeatHandlers() {
+  const shutdown = (signal) => {
+    if (shutdownHeartbeatInFlight) return;
+    shutdownHeartbeatInFlight = true;
+    const exitCode = signal === "SIGINT" ? 130 : 0;
+    const timeout = setTimeout(() => process.exit(exitCode), 3e3);
+    timeout.unref?.();
+    const latestConfig = buildConfig(process.env, {});
+    reportOfflineHeartbeat(latestConfig, signal.toLowerCase()).catch((err) => {
+      const message = err instanceof Error ? err.stack || err.message : String(err);
+      process.stderr.write(`AMaster daemon offline heartbeat failed during ${signal}; exiting anyway:
+${message}
+`);
+    }).finally(() => {
+      clearTimeout(timeout);
+      process.exit(exitCode);
+    });
+  };
+  process.once("SIGTERM", () => shutdown("SIGTERM"));
+  process.once("SIGINT", () => shutdown("SIGINT"));
+}
 function activeRunHeartbeatIntervalMs(config) {
   const configured = Number(config.pollIntervalSeconds);
   const baseMs = Number.isFinite(configured) && configured > 0 ? configured * 1e3 : 1e4;
@@ -13685,7 +13740,7 @@ async function materializeIssueCheckpoint(config, command, workspace) {
       }
       if (!existsSync14(sourceCandidate)) throw new Error(`issue checkpoint file is missing: ${relativePath}`);
       const source = realpathSync5(sourceCandidate);
-      if (!pathWithin2(source, filesRoot) || !statSync7(source).isFile()) {
+      if (!pathWithin2(source, filesRoot) || !statSync8(source).isFile()) {
         throw new Error(`issue checkpoint source escapes its storage root: ${relativePath}`);
       }
       const expectedSha256 = readString(file.sha256);
@@ -13693,7 +13748,7 @@ async function materializeIssueCheckpoint(config, command, workspace) {
       if (!expectedSha256 || expectedByteSize === null || expectedByteSize <= 0) {
         throw new Error(`issue checkpoint evidence is incomplete: ${relativePath}`);
       }
-      if (hashFileSha256(source) !== expectedSha256 || statSync7(source).size !== expectedByteSize) {
+      if (hashFileSha256(source) !== expectedSha256 || statSync8(source).size !== expectedByteSize) {
         throw new Error(`issue checkpoint integrity mismatch: ${relativePath}`);
       }
       totalBytes += expectedByteSize;
@@ -13746,12 +13801,12 @@ async function saveIssueCheckpoint(config, command, workspace, candidates) {
   for (const candidate of candidates.slice(0, 20)) {
     const relativePath = safeCheckpointRelativePath(candidate.rawPath);
     const source = readString(candidate.filePath);
-    if (!relativePath || !source || !existsSync14(source) || !statSync7(source).isFile()) continue;
+    if (!relativePath || !source || !existsSync14(source) || !statSync8(source).isFile()) continue;
     const ownedSource = realpathSync5(source);
     if (!pathWithin2(ownedSource, workspaceRoot)) {
       throw new Error(`issue checkpoint source escapes its execution workspace: ${relativePath}`);
     }
-    const byteSize = statSync7(ownedSource).size;
+    const byteSize = statSync8(ownedSource).size;
     if (byteSize <= 0 || totalBytes + byteSize > MAX_CHECKPOINT_BYTES) continue;
     const target = resolve12(filesDir, relativePath);
     if (!pathWithin2(target, filesDir)) continue;
@@ -14871,7 +14926,11 @@ async function main() {
 `);
       break;
     case "render-heartbeat-payload":
-      process.stdout.write(`${JSON.stringify(buildHeartbeatPayload(config, { orphanCheck: flags.orphanCheck ?? flags.orphan_check ?? flags["orphan-check"] }), null, 2)}
+      process.stdout.write(`${JSON.stringify(buildHeartbeatPayload(config, {
+        orphanCheck: flags.orphanCheck ?? flags.orphan_check ?? flags["orphan-check"],
+        status: flags.status,
+        offlineReason: flags.offlineReason ?? flags.offline_reason ?? flags["offline-reason"]
+      }), null, 2)}
 `);
       break;
     case "print-smoke":
@@ -14881,7 +14940,11 @@ async function main() {
       await register(config);
       break;
     case "heartbeat":
-      await heartbeat(config, { logMode: "full" });
+      await heartbeat(config, {
+        logMode: "full",
+        status: flags.status,
+        offlineReason: flags.offlineReason ?? flags.offline_reason ?? flags["offline-reason"]
+      });
       break;
     case "poll":
       await poll(config);
@@ -14903,6 +14966,7 @@ async function main() {
       break;
     case "start":
     case "run":
+      installShutdownHeartbeatHandlers();
       await runLoop(config);
       break;
     case "help":

package/dist/amaster-runtime.mjs

@@ -6,7 +6,7 @@ import { basename, dirname, join, resolve } from "node:path";
 import { homedir, hostname } from "node:os";
 import { fileURLToPath } from "node:url";
 
-const CONNECTOR_VERSION = "0.1.1-beta.10";
+const CONNECTOR_VERSION = "0.1.1-beta.12";
 
 const CAPABILITIES = [
   "remote_registration",

package/package.json

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