@lightcone-ai/daemon 0.14.18 → 0.15.0

package/src/drivers/claude.js

@@ -40,34 +40,46 @@ You have MCP tools from the "chat" server. Use ONLY these for communication:
 
 CRITICAL RULES:
 - Always communicate through ${t("send_message")}. This is your only output method.
+- Plain assistant text is not a user-visible reply. If you need the human or another agent to see something, you must call ${t("send_message")}.
 - Use only the provided MCP tools for messaging — they are already available and ready.
 - Always claim a task via ${t("claim_tasks")} before starting work on it. If the claim fails, move on to a different task.
 
 ## Startup sequence
 
-1. If this turn already includes a concrete incoming message, first decide whether that message needs a visible acknowledgment, blocker question, or ownership signal. If it does, send it early with ${t("send_message")} before deep context gathering.
+1. If this turn already includes a concrete incoming message with \`from=user\`, first decide whether it needs a visible acknowledgment, blocker question, or ownership signal. If it does, send it early with ${t("send_message")} before deep context gathering.
 2. Read MEMORY.md (via ${t("read_memory")}) and then only the additional memory/notes files you need to handle the current turn well.
 3. If there is no concrete incoming message to handle, stop and wait. New messages will be delivered to you automatically via stdin.
-4. When you receive a message, process it and reply with ${t("send_message")}.
+4. When you receive a message, first apply the audience-aware rules below before deciding whether to call ${t("send_message")}. Do not treat plain narrative output as a substitute for a visible reply.
 5. **Complete ALL your work before stopping.** If a task requires multi-step work (research, code changes, testing), finish everything, report results, then stop. New messages arrive automatically — you do not need to poll or wait for them.
 
 ## Messaging
 
-Messages you receive have a single RFC 5424-style structured data header followed by the sender and content:
+Messages you receive have a single structured data header followed by the sender/content payload:
 
 \`\`\`
-[target=#general msg=a1b2c3d4 time=2026-03-15T01:00:00] @richard: hello everyone
-[target=#general msg=e5f6a7b8 time=2026-03-15T01:00:01 type=agent] @Alice: hi there
-[target=dm:@richard msg=c9d0e1f2 time=2026-03-15T01:00:02] @richard: hey, can you help?
-[target=#general:a1b2c3d4 msg=f3a4b5c6 time=2026-03-15T01:00:03] @richard: thread reply
-[target=dm:@richard:x9y8z7a0 msg=d7e8f9a0 time=2026-03-15T01:00:04] @richard: DM thread reply
+[from=user user=richard target=#general msg=a1b2c3d4 time=2026-03-15T01:00:00] @richard: hello everyone
+[from=peer-agent agent=Alice target=#general msg=e5f6a7b8 time=2026-03-15T01:00:01] @Alice: hi there
+[from=user user=richard target=dm:@richard msg=c9d0e1f2 time=2026-03-15T01:00:02] @richard: hey, can you help?
+[from=system reason=startup target=#general msg=f3a4b5c6 time=2026-03-15T01:00:03] Agent resumed
 \`\`\`
 
 Header fields:
+- \`from=\` — one of \`user\` / \`peer-agent\` / \`system\`.
 - \`target=\` — where the message came from. Reuse as the \`target\` parameter when replying.
 - \`msg=\` — message short ID (first 8 chars of UUID). Use as thread suffix to start/reply in a thread.
 - \`time=\` — timestamp.
-- \`type=agent\` — present only if the sender is an agent.
+
+## Audience-aware messaging
+
+Each incoming message has a \`from=\` tag and should be handled as follows:
+
+- **from=user**: this is a real user request. You MUST acknowledge with ${t("send_message")} before deep context-gathering, even if the acknowledgment is short.
+- **from=peer-agent**: default is **no reply**. Reply only when at least one condition holds:
+  1. You were explicitly @mentioned.
+  2. You have materially new information that changes execution decisions.
+  3. The peer explicitly asked you a concrete question.
+  Pure receipts like "收到/已对齐/分工确认" are not requests and should not trigger a reply.
+- **from=system**: internal lifecycle/governance/startup signal. Do not reply unless explicitly instructed.
 
 ### Sending messages
 
@@ -123,6 +135,12 @@ Only top-level workspace / DM messages can become tasks. Messages inside threads
 4. When done, set status to \`in_review\` so a human can validate
 5. After approval (e.g. "looks good", "merge it"), set status to \`done\`
 
+**Primary-agent dispatch hard rule (fail-closed):**
+- If your role is the workspace primary agent/owner and a user sends an execution request, you MUST call \`${t("create_tasks")}\` first and include an explicit \`scenario_type\` before routing work via \`${t("send_message")}\`.
+- Execution requests include requests like content writing, short-video scripting, research, design/asset production, implementation, or any request that requires downstream execution instead of a simple answer.
+- Use \`scenario_type\` values declared by your scenario manifest/dispatch protocol (for example: \`trend_scan\`, \`topic_research\`, \`research\`, \`graphic_writing\`, \`short_video_scripting\`, \`publish\`).
+- Do not route execution work with only \`${t("send_message")}\`: skipping \`${t("create_tasks")}\` can cause downstream \`${t("claim_tasks")}\` failures and deadlock the workflow.
+
 **What \`${t("create_tasks")}\` really means:**
 - Tasks live in the same chat flow as messages. A task is just a message with task metadata, not a separate source of truth.
 - \`${t("create_tasks")}\` is a convenience helper for a specific sequence: create a brand-new message, then publish that new message as a task-message.

package/src/drivers/codex.js

@@ -39,6 +39,14 @@ function quote(value) {
   return JSON.stringify(value);
 }
 
+function formatCodexServerKey(serverKey) {
+  const normalizedKey = String(serverKey ?? '').trim();
+  if (!normalizedKey) return null;
+  return /^[A-Za-z0-9_-]+$/.test(normalizedKey)
+    ? normalizedKey
+    : quote(normalizedKey);
+}
+
 function normalizeCodexModel(model) {
   if (!model) return 'gpt-5.2';
   const normalized = String(model).trim().toLowerCase();
@@ -71,7 +79,6 @@ export function adaptCodexSystemPrompt(sourcePrompt) {
   if (!basePrompt.trim()) return '';
 
   let prompt = basePrompt
-    .replaceAll('mcp__chat__', '')
     .replace(
       '3. If there is no concrete incoming message to handle, stop and wait. New messages will be delivered to you automatically via stdin.',
       '3. If there is no concrete incoming message to handle, stop. The daemon will restart you when new messages arrive.'
@@ -117,22 +124,24 @@ function normalizeDirectiveMcpServers(value) {
 function buildDirectiveMcpFlags(mcpServers) {
   const args = [];
   for (const [serverKey, mc] of Object.entries(mcpServers)) {
+    const keyExpr = formatCodexServerKey(serverKey);
+    if (!keyExpr) continue;
     const envPairs = Object.entries(mc.env ?? {}).map(([k, v]) => `${k}=${v ?? ''}`);
     if (envPairs.length > 0) {
       args.push(
-        '-c', `mcp_servers.${quote(serverKey)}.command=${quote('env')}`,
-        '-c', `mcp_servers.${quote(serverKey)}.args=${quote([...envPairs, mc.command, ...(mc.args ?? [])])}`,
-        '-c', `mcp_servers.${quote(serverKey)}.enabled=true`
+        '-c', `mcp_servers.${keyExpr}.command=${quote('env')}`,
+        '-c', `mcp_servers.${keyExpr}.args=${quote([...envPairs, mc.command, ...(mc.args ?? [])])}`,
+        '-c', `mcp_servers.${keyExpr}.enabled=true`
       );
     } else {
       args.push(
-        '-c', `mcp_servers.${quote(serverKey)}.command=${quote(mc.command)}`,
-        '-c', `mcp_servers.${quote(serverKey)}.args=${quote(mc.args ?? [])}`,
-        '-c', `mcp_servers.${quote(serverKey)}.enabled=true`
+        '-c', `mcp_servers.${keyExpr}.command=${quote(mc.command)}`,
+        '-c', `mcp_servers.${keyExpr}.args=${quote(mc.args ?? [])}`,
+        '-c', `mcp_servers.${keyExpr}.enabled=true`
       );
     }
     if (mc.required) {
-      args.push('-c', `mcp_servers.${quote(serverKey)}.required=true`);
+      args.push('-c', `mcp_servers.${keyExpr}.required=true`);
     }
   }
   return args;
@@ -206,19 +215,21 @@ export function buildCodexSpawn({
   });
 
   for (const [serverKey, mc] of Object.entries(skillMcpServers)) {
+    const keyExpr = formatCodexServerKey(serverKey);
+    if (!keyExpr) continue;
     const envPairs = Object.entries(mc.env ?? {}).map(([k, v]) => `${k}=${v ?? ''}`);
     if (envPairs.length > 0) {
       args.push(
-        '-c', `mcp_servers.${quote(serverKey)}.command=${quote('env')}`,
-        '-c', `mcp_servers.${quote(serverKey)}.args=${quote([...envPairs, mc.command, ...(mc.args ?? [])])}`,
-        '-c', `mcp_servers.${quote(serverKey)}.enabled=true`
+        '-c', `mcp_servers.${keyExpr}.command=${quote('env')}`,
+        '-c', `mcp_servers.${keyExpr}.args=${quote([...envPairs, mc.command, ...(mc.args ?? [])])}`,
+        '-c', `mcp_servers.${keyExpr}.enabled=true`
       );
       continue;
     }
     args.push(
-      '-c', `mcp_servers.${quote(serverKey)}.command=${quote(mc.command)}`,
-      '-c', `mcp_servers.${quote(serverKey)}.args=${quote(mc.args ?? [])}`,
-      '-c', `mcp_servers.${quote(serverKey)}.enabled=true`
+      '-c', `mcp_servers.${keyExpr}.command=${quote(mc.command)}`,
+      '-c', `mcp_servers.${keyExpr}.args=${quote(mc.args ?? [])}`,
+      '-c', `mcp_servers.${keyExpr}.enabled=true`
     );
   }
 

package/src/index.js

@@ -4,7 +4,7 @@ import { createRequire } from 'module';
 import { DaemonConnection } from './connection.js';
 import { AgentManager } from './agent-manager.js';
 import { releaseProfileLocksForProcess } from './profile-lock.js';
-import { resolveLightconeServerUrl } from '../../src/runtime/config.js';
+import { resolveLightconeServerUrl } from './runtime-config.js';
 
 const { version } = createRequire(import.meta.url)('../package.json');
 

package/src/lifecycle-protocol.js

@@ -1,6 +1,8 @@
 export function resolveExitOfflineDetail({ code, signal, stopCause }) {
   if (stopCause === 'manual_stop') return '';
   if (stopCause === 'credential_revoked') return 'credential_revoked';
+  if (stopCause === 'contract_violation') return 'contract_violation:visible_text_without_send_message';
+  if (stopCause === 'outbound_rate_limited') return 'outbound_rate_limited';
   if (code === 0) return '';
   if (signal === 'SIGTERM') return '';
   if (signal === 'SIGKILL') return 'agent_timeout';
@@ -25,6 +27,22 @@ export function resolveLifecycleExitState({ runtime, code, signal, stopCause })
       reason: 'manual_stop',
     };
   }
+  if (stopCause === 'contract_violation') {
+    return {
+      reachability: 'reachable',
+      availability: 'available',
+      runtimeState: 'standby',
+      reason: 'contract_violation:visible_text_without_send_message',
+    };
+  }
+  if (stopCause === 'outbound_rate_limited') {
+    return {
+      reachability: 'reachable',
+      availability: 'paused',
+      runtimeState: 'stopped',
+      reason: 'outbound_rate_limited',
+    };
+  }
   if (normalizedRuntime === 'codex' && code === 0) {
     return {
       reachability: 'reachable',

package/src/mcp-config.js

@@ -23,8 +23,14 @@ function resolveMcpPathToken(arg, mcpPaths = {}) {
   if (!trimmed.startsWith('{') || !trimmed.endsWith('}')) return null;
 
   const legacyId = LEGACY_MCP_PATH_TOKENS[trimmed] ?? null;
+  const legacyUnderscoreMatch = trimmed.match(/^\{([a-z0-9_]+)_mcp_path\}$/i);
+  const legacyUnderscoreId = legacyUnderscoreMatch
+    ? legacyUnderscoreMatch[1].toLowerCase().replaceAll('_', '-')
+    : null;
   const dynamicMatch = trimmed.match(/^\{mcp_path:([a-z0-9][a-z0-9_-]*)\}$/i);
-  const serverId = legacyId ?? (dynamicMatch ? dynamicMatch[1].toLowerCase() : null);
+  const serverId = legacyId
+    ?? legacyUnderscoreId
+    ?? (dynamicMatch ? dynamicMatch[1].toLowerCase() : null);
   if (!serverId) return null;
 
   const runtimeMcpPath = typeof mcpPaths?.[serverId] === 'string'
@@ -99,20 +105,25 @@ export function buildSkillMcpServers({
     const mc = skill.mcpConfig;
     if (mcpServers[mc.server]) continue;
 
-    const resolvedArgs = (mc.args ?? []).map(arg => resolveSkillArg(arg, config));
-    const resolvedEnv = {};
-    for (const envKey of (mc.env ?? [])) {
-      resolvedEnv[envKey] = agentEnv[envKey] ?? process.env[envKey] ?? '';
-    }
+    try {
+      const resolvedArgs = (mc.args ?? []).map(arg => resolveSkillArg(arg, config));
+      const resolvedEnv = {};
+      for (const envKey of (mc.env ?? [])) {
+        resolvedEnv[envKey] = agentEnv[envKey] ?? process.env[envKey] ?? '';
+      }
 
-    mcpServers[mc.server] = {
-      command: mc.command,
-      args: resolvedArgs,
-      env: {
-        ...resolvedEnv,
-        ...baseEnvForServer(mc.server, { serverUrl, authToken, agentId, workspaceId, workspaceDir }),
-      },
-    };
+      mcpServers[mc.server] = {
+        command: mc.command,
+        args: resolvedArgs,
+        env: {
+          ...resolvedEnv,
+          ...baseEnvForServer(mc.server, { serverUrl, authToken, agentId, workspaceId, workspaceDir }),
+        },
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error ?? 'unknown_error');
+      console.warn(`[mcp-config] Skipping MCP server '${mc.server}' due to invalid skill config: ${message}`);
+    }
   }
 
   return mcpServers;

package/src/runtime-config.js

@@ -0,0 +1,24 @@
+const DEFAULT_LIGHTCONE_PORT = 9779;
+const DEFAULT_OUTBOUND_WINDOW_MS = 60_000;
+const DEFAULT_OUTBOUND_SOFT_CAP = 5;
+const DEFAULT_OUTBOUND_HARD_CAP = 10;
+const DEFAULT_OUTBOUND_COOLDOWN_MS = 5 * 60_000;
+
+function resolvePositiveInt(value, fallback) {
+  const parsed = Number.parseInt(String(value ?? ''), 10);
+  if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
+  return parsed;
+}
+
+export function resolveLightconeServerUrl(env = process.env) {
+  return env.SERVER_URL || `http://localhost:${DEFAULT_LIGHTCONE_PORT}`;
+}
+
+export function resolveOutboundRateLimitConfig(env = process.env) {
+  return {
+    windowMs: resolvePositiveInt(env.AGENT_OUTBOUND_RATE_WINDOW_MS, DEFAULT_OUTBOUND_WINDOW_MS),
+    softCap: resolvePositiveInt(env.AGENT_OUTBOUND_RATE_SOFT_CAP, DEFAULT_OUTBOUND_SOFT_CAP),
+    hardCap: resolvePositiveInt(env.AGENT_OUTBOUND_RATE_HARD_CAP, DEFAULT_OUTBOUND_HARD_CAP),
+    cooldownMs: resolvePositiveInt(env.AGENT_OUTBOUND_RATE_COOLDOWN_MS, DEFAULT_OUTBOUND_COOLDOWN_MS),
+  };
+}