@mono-agent/agent-app 0.2.1 → 0.2.2

package/dist/launchd.js

@@ -0,0 +1,164 @@
+import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+import { basename, dirname, resolve } from "node:path";
+import process from "node:process";
+const LABEL_PREFIX = "com.mono-agent";
+const MAX_FOLDER_SEGMENT = 40;
+const FALLBACK_PATH = "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/homebrew/bin";
+const PATH_EXTRAS = ["/opt/homebrew/bin", "/usr/local/bin"];
+/**
+ * A stable, launchd-legal label derived from the resolved config path. The
+ * folder name keeps it human-readable; an 8-char hash of the absolute config
+ * path disambiguates same-named folders and keeps the label deterministic so
+ * `start`/`stop`/`status` all address the same service.
+ */
+export function deriveLaunchdLabel(configPath) {
+    const resolved = resolve(configPath);
+    const folder = basename(dirname(resolved))
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/gu, "-")
+        .replace(/-+/gu, "-")
+        .replace(/^-+|-+$/gu, "")
+        .slice(0, MAX_FOLDER_SEGMENT)
+        .replace(/-+$/gu, "");
+    const hash = createHash("sha256").update(resolved).digest("hex").slice(0, 8);
+    return `${LABEL_PREFIX}.${folder.length === 0 ? "agent" : folder}-${hash}`;
+}
+export function launchdPathsFor(label, home = homedir()) {
+    const launchAgentsDir = resolve(home, "Library", "LaunchAgents");
+    const logDir = resolve(home, ".mono-agent", "logs");
+    return {
+        launchAgentsDir,
+        logDir,
+        plistPath: resolve(launchAgentsDir, `${label}.plist`),
+        stdoutPath: resolve(logDir, `${label}.out.log`),
+        stderrPath: resolve(logDir, `${label}.err.log`),
+    };
+}
+export function escapeXml(value) {
+    return value
+        .replace(/&/gu, "&")
+        .replace(/</gu, "&lt;")
+        .replace(/>/gu, "&gt;")
+        .replace(/"/gu, "&quot;")
+        .replace(/'/gu, "&apos;");
+}
+/**
+ * The plist runs `node <cli.js> start --foreground …` (the existing blocking
+ * worker) in the config's directory. No secrets are written here — the worker
+ * loads `.env` from its working directory exactly like the foreground CLI.
+ */
+export function buildPlistXml(input) {
+    const programArguments = [
+        input.nodePath,
+        input.cliPath,
+        "start",
+        "--foreground",
+        "--config",
+        input.configPath,
+        ...(input.envFile === undefined ? [] : ["--env-file", input.envFile]),
+        ...(input.port === undefined ? [] : ["--port", String(input.port)]),
+        ...(input.noConsole ? ["--no-console"] : []),
+    ];
+    const argsXml = programArguments.map((arg) => `    <string>${escapeXml(arg)}</string>`).join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${escapeXml(input.label)}</string>
+  <key>ProgramArguments</key>
+  <array>
+${argsXml}
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${escapeXml(input.cwd)}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${escapeXml(input.pathEnv)}</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <dict>
+    <key>SuccessfulExit</key>
+    <false/>
+  </dict>
+  <key>StandardOutPath</key>
+  <string>${escapeXml(input.stdoutPath)}</string>
+  <key>StandardErrorPath</key>
+  <string>${escapeXml(input.stderrPath)}</string>
+  <key>ThrottleInterval</key>
+  <integer>10</integer>
+  <key>ProcessType</key>
+  <string>Interactive</string>
+</dict>
+</plist>
+`;
+}
+/**
+ * PATH for the background worker: the launching shell's PATH (so the user's
+ * toolchain is reachable) plus Homebrew/usr-local in case launchd started from
+ * a bare login. Never includes anything secret.
+ */
+export function defaultPathEnv(env = process.env) {
+    const current = env.PATH?.trim();
+    if (current === undefined || current.length === 0) {
+        return FALLBACK_PATH;
+    }
+    const parts = current.split(":").filter((part) => part.length > 0);
+    for (const extra of PATH_EXTRAS) {
+        if (!parts.includes(extra)) {
+            parts.push(extra);
+        }
+    }
+    return parts.join(":");
+}
+export function domainTarget(uid) {
+    return `gui/${uid}`;
+}
+export function serviceTarget(label, uid) {
+    return `gui/${uid}/${label}`;
+}
+export function makeLaunchctlRunner() {
+    return (args) => new Promise((resolvePromise) => {
+        const child = spawn("launchctl", [...args], { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", (error) => {
+            resolvePromise({ code: 127, stdout, stderr: `${stderr}${error.message}` });
+        });
+        child.on("close", (code) => {
+            resolvePromise({ code: code ?? 0, stdout, stderr });
+        });
+    });
+}
+/** True when the service is bootstrapped in the user's gui domain. */
+export async function isLoaded(runner, label, uid) {
+    const result = await runner(["print", serviceTarget(label, uid)]);
+    return result.code === 0;
+}
+/** Bootstrap (load + RunAtLoad-launch) the plist. Caller tolerates "already bootstrapped". */
+export async function bootstrap(runner, plistPath, uid) {
+    return await runner(["bootstrap", domainTarget(uid), plistPath]);
+}
+/** Kill and restart an already-loaded service, picking up a rewritten plist. */
+export async function kickstartRestart(runner, label, uid) {
+    return await runner(["kickstart", "-k", serviceTarget(label, uid)]);
+}
+/**
+ * Remove the service from the domain. Sends SIGTERM and — unlike a plain kill —
+ * prevents KeepAlive from relaunching it. Caller tolerates "not loaded".
+ */
+export async function bootout(runner, label, uid) {
+    return await runner(["bootout", serviceTarget(label, uid)]);
+}
+//# sourceMappingURL=launchd.js.map

package/dist/launchd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchd.js","sourceRoot":"","sources":["../src/launchd.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mono-agent/agent-app",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Config-first mono-agent host: builds a responder and starts every configured communication channel, operator console, and traceability from one mono-agent.config.json.",
   "type": "module",
   "license": "UNLICENSED",
@@ -22,20 +22,20 @@
     "README.md"
   ],
   "dependencies": {
-    "@mono-agent/a2a-adapter": "0.2.1",
-    "@mono-agent/agent-contracts": "0.2.1",
-    "@mono-agent/agent-host": "0.2.1",
-    "@mono-agent/config": "0.2.1",
-    "@mono-agent/cron-adapter": "0.2.1",
-    "@mono-agent/observability": "0.2.1",
-    "@mono-agent/openai-api-adapter": "0.2.1",
-    "@mono-agent/operator-console": "0.2.1",
-    "@mono-agent/runtime-adapter": "0.2.1",
-    "@mono-agent/settings": "0.2.1",
-    "@mono-agent/slack-adapter": "0.2.1",
-    "@mono-agent/telegram-adapter": "0.2.1",
-    "@mono-agent/webhook-adapter": "0.2.1",
-    "@mono-agent/whatsapp-adapter": "0.2.1"
+    "@mono-agent/a2a-adapter": "0.2.2",
+    "@mono-agent/agent-contracts": "0.2.2",
+    "@mono-agent/agent-host": "0.2.2",
+    "@mono-agent/config": "0.2.2",
+    "@mono-agent/cron-adapter": "0.2.2",
+    "@mono-agent/observability": "0.2.2",
+    "@mono-agent/openai-api-adapter": "0.2.2",
+    "@mono-agent/operator-console": "0.2.2",
+    "@mono-agent/runtime-adapter": "0.2.2",
+    "@mono-agent/settings": "0.2.2",
+    "@mono-agent/slack-adapter": "0.2.2",
+    "@mono-agent/telegram-adapter": "0.2.2",
+    "@mono-agent/webhook-adapter": "0.2.2",
+    "@mono-agent/whatsapp-adapter": "0.2.2"
   },
   "publishConfig": {
     "access": "public"

package/skills/mono-agent-composer/references/config-blueprint.md

@@ -32,7 +32,7 @@ my-agent/
     "effort": "medium",                    // none|low|medium|high|xhigh|max
     "permissionMode": "default",           // default|plan|acceptEdits|bypassPermissions (CLI backends)
     "reasoningSummary": "auto",            // auto|concise|detailed|off|on
-    "maxTurns": 8,                         // 1-100
+    "maxTurns": 0,                         // 0 or omitted means unlimited; 1-100 caps turns
     "workspace": ".",
     "session": { "mode": "continuous", "idleTimeoutMs": 1800000 } // or "per-message"
   },
@@ -138,12 +138,14 @@ my-agent/
   },
 
   "telegram": {
+    "enabled": true,                       // opt-in; defaults to false (off → "disabled")
     "botToken": "...",
     "allowedChatIds": ["123456789"],       // or "allowAllChats": true
     "allowAllChats": false
   },
 
   "slack": {
+    "enabled": true,                       // opt-in; defaults to false (off → "disabled")
     "botToken": "xoxb-...",                // Socket Mode app
     "appToken": "xapp-...",
     "allowedChannelIds": ["C0123"],        // or "allowAllChannels": true
@@ -154,6 +156,7 @@ my-agent/
   },
 
   "whatsapp": {
+    "enabled": true,                       // opt-in; defaults to false (off → "disabled")
     "allowedChatJids": ["123@s.whatsapp.net"], // or "allowAllChats": true
     "allowAllChats": false,
     "groupMode": "mention",                // mention | any (group trigger rule)
@@ -187,6 +190,7 @@ my-agent/
   },
 
   "cron": {
+    "dir": "cron",                         // optional: folder of *.md jobs (frontmatter + prompt body), default "cron"
     "jobs": [
       {
         "id": "daily",
@@ -197,6 +201,7 @@ my-agent/
         "conversationId": "cron-daily"     // optional: share memory/history across ticks
       }
     ]
+    // Jobs here merge with cron/*.md files (duplicate ids error).
     // Overlapping ticks of the same job are skipped, never queued.
   }
 }

package/skills/mono-agent-composer/references/feature-coverage.md

@@ -26,7 +26,7 @@ Every framework capability and how a composed agent reaches it. Use this to answ
 | Identity + optional soul documents | config | `context.identityPath`, `context.soulPath` |
 | Selected skills from a skills root | config | `context.skillsRoot`, `context.selectedSkills` |
 | Per-skill byte cap | config | `context.skillMaxBytes` |
-| Conversation history (in-memory, capped) | auto | sized from `runtime.maxTurns`; custom store via code |
+| Conversation history (in-memory; unlimited unless turns are capped) | auto | sized from `runtime.maxTurns`; custom store via code |
 | Markdown memory (single-file / per-conversation, capped) | config | `memory.mode: "markdown"`, `path`, `maxBytes`, `scope` |
 | Journal memory (daily notes always in context) | config | `memory.mode: "journal"`, `path` |
 | Host summaries appended after runs | config | `memory.writeMode: "append-host-summary"` |