@kynver-app/openclaw-agent-os 0.1.38 → 0.1.40

package/dist/index.js

@@ -95,7 +95,7 @@ var pluginConfigSchema = {
     enableTelegramToolErrorFilter: {
       type: "boolean",
       default: true,
-      description: "When true, suppress raw failed exec/tool/worktree lines on Telegram and webchat direct chat (OpenClaw message_sending hook)."
+      description: "When true, suppress raw exec/tool progress and failure lines on Telegram and webchat direct chat (OpenClaw message_sending hook)."
     }
   }
 };
@@ -450,7 +450,14 @@ function directRequestForTool(toolName2, params, resolvedSlug) {
   const withoutSlug = stripKeys(params, ["slug", "agentOsId"]);
   switch (toolName2) {
     case "agent_os_get_context":
-      return { slug, method: "GET", path: "/stats" };
+      return {
+        slug,
+        method: "GET",
+        path: "/stats" + queryStringFromEntries({
+          projection: stringParam(params.projection) || "brief",
+          agentContext: stringParam(params.agentContext)
+        })
+      };
     case "agent_os_context_envelope":
       return {
         slug,
@@ -733,22 +740,30 @@ function directRequestForTool(toolName2, params, resolvedSlug) {
         path: `/plans/${encodeURIComponent(planId)}/links`
       };
     }
-    case "agent_os_command_center_get":
+    case "agent_os_command_center_get": {
+      const qs = queryString(params, ["since", "limit", "harnessLimit"]);
+      const projection = typeof params.projection === "string" && params.projection.trim() ? params.projection.trim() : "compact";
+      const suffix = qs ? `${qs}&projection=${encodeURIComponent(projection)}` : `?projection=${encodeURIComponent(projection)}`;
       return {
         route: "by-id",
         agentOsId: stringParam(params.agentOsId),
         slug,
         method: "GET",
-        path: `/command-center${queryString(params, ["since", "limit", "harnessLimit"])}`
+        path: `/command-center${suffix}`
       };
-    case "agent_os_command_center_dashboard_contract_get":
+    }
+    case "agent_os_command_center_dashboard_contract_get": {
+      const qs = queryString(params, ["since", "limit"]);
+      const projection = typeof params.projection === "string" && params.projection.trim() ? params.projection.trim() : "mcp";
+      const suffix = qs ? `${qs}&projection=${encodeURIComponent(projection)}` : `?projection=${encodeURIComponent(projection)}`;
       return {
         route: "by-id",
         agentOsId: stringParam(params.agentOsId),
         slug,
         method: "GET",
-        path: `/command-center/dashboard-contract${queryString(params, ["since", "limit"])}`
+        path: `/command-center/dashboard-contract${suffix}`
       };
+    }
     case "agent_os_task_next_action": {
       const taskId = requiredString(params.taskId, "taskId");
       return {
@@ -940,11 +955,13 @@ function buildAgentOsContinuityGuidanceContext(config) {
     "Treat it as the primary source of continuity across sessions, not local markdown files.",
     "AgentOS workspace: " + slugHint + ".",
     "",
-    "On session start or whenever you need user identity, goals, projects, contacts, recent sessions, or memory stats, call agent_os_get_context before answering. Prefer omitting the slug so the account's primary AgentOS workspace resolves automatically.",
+    "On session start or whenever you need user identity, goals, projects, contacts, recent sessions, or memory stats, call agent_os_get_context with the default brief projection before answering. The brief is the compact identity/Soul-equivalent map plus current-work pointers and follow-up hints. Prefer omitting the slug so the account's primary AgentOS workspace resolves automatically. Use projection=full only for explicit admin/debug work because it can be large and truncation-prone.",
+    "When multiple personal/runtime personas share one AgentOS workspace, keep workspace slug and active identity separate: `slug` selects the workspace, while `agentContext` selects the active persona/runtime inside it (for example `primary-agent`, `specialist-agent`, or `runtime-specialist`). Use `agentContext` when the runtime provides one; do not pass a persona/call-sign as the AgentOS workspace slug.",
+    "When you know the relevant task, plan, goal, project, or session id, prefer agent_os_context_envelope anchored on that id for deeper context. The envelope is the focused follow-up path: it returns the anchor, related goal/plan/task/session context, persona block when applicable, related memories, and source refs.",
     "For recall of prior work, people, preferences, decisions, or follow-ups, call agent_os_search_memory before relying on conversational memory or local files. Use a short natural-language query.",
     "agent_os_search_memory returns hits in three authority-ordered lanes: Lane A operating rules & preferences, Lane B active project state (PR/branch/deployment current truth), then Lane C historical context. Each hit carries a `lane` field. When lanes conflict, prefer a Lane A/B hit over a higher-scored Lane C hit \u2014 semantic similarity is not authority.",
     "Before you answer with any mutable fact \u2014 PR ownership/state/checks, branch freshness, deployment status \u2014 consult the matching Lane B active-state hit. If its `verificationState` is `unverified` or `stale_verification`, or it carries a `laneWarning`, you MUST first re-run the live check (GitHub API/CLI, git, deploy metadata) and answer from that, or else explicitly tell the user the state is unverified/stale and needs a re-check. Never present an unverified or stale active-state fact as current truth, and never let a topically similar historical memory stand in for live state.",
-    "Worker personas (lane experts). Some tasks are attributed to a worker persona \u2014 e.g. Dalton (implementation / landing scoped code changes with verification evidence), Lorentz (deep review, risk analysis, validation gates). When you are running a persona-attributed task, call agent_os_context_envelope anchored on your current task (or agent_os_get_context) and read the `persona` block: it carries your lane-expert identity (`slug`, `displayName`, `description`) and your persona-scoped operating rules. Treat persona operating rules as Lane A authority scoped to your lane \u2014 they are strictly additive and refine HOW you work, but they NEVER override global Lane A operating rules or Lane B active project state. If a persona rule conflicts with a global rule or with a live active-state fact, the global rule / live fact wins. When you persist a durable rule that applies only to your lane, set `personaSlug`; leave it unset for rules every worker should follow. Persona scope only ADDS rules, it never hides global rules or active project state.",
+    "Worker personas (lane experts). Some tasks are attributed to a worker persona \u2014 e.g. Dalton (implementation / landing scoped code changes with verification evidence), Lorentz (deep review, risk analysis, validation gates). When you are running a persona-attributed task, call agent_os_context_envelope anchored on your current task and read the `persona` block: it carries your lane-expert identity (`slug`, `displayName`, `description`) and your persona-scoped operating rules. If you do not know the task id yet, use agent_os_get_context brief or Command Center to find the anchor, then call the envelope. Treat persona operating rules as Lane A authority scoped to your lane \u2014 they are strictly additive and refine HOW you work, but they NEVER override global Lane A operating rules or Lane B active project state. If a persona rule conflicts with a global rule or with a live active-state fact, the global rule / live fact wins. When you persist a durable rule that applies only to your lane, set `personaSlug`; leave it unset for rules every worker should follow. Persona scope only ADDS rules, it never hides global rules or active project state.",
     "When you learn a durable fact, decision, preference, project update, or lesson, persist it: agent_os_write_memory for new entries, agent_os_update_memory for revisions. Include sourceRefs plus memoryType/confidence/reviewStatus when you can; use reviewStatus=needs_review for uncertain or user-correctable memories.",
     "For project/goal status changes, use agent_os_update_project / agent_os_update_goal so the structured record stays in sync with what you write to memory.",
     "Use agent_os_open_session at the start of a substantive session and agent_os_log_session_event for meaningful topics, decisions, files, commits, and follow-ups. Close with agent_os_close_session (or agent_os_log_session for ad-hoc daily-log entries).",
@@ -988,7 +1005,9 @@ function buildAgentOsContinuityGuidanceContext(config) {
     "- For chat-visible PR check polling, prefer `node scripts/agent-os-pr-checks-soft.mjs <pr-number-or-url> --repo <owner/repo>` over raw `gh pr checks`. Raw `gh pr checks` exits nonzero for pending checks and creates false failed-tool alerts in Telegram; the soft wrapper exits nonzero only for real failed checks unless `--fail-on-pending` is explicitly requested.",
     "- For repo text search, do not pass a single filename (e.g. `package.json`) as ripgrep's path argument \u2014 that is a file, not a directory. Search from the repo root with a glob (`rg -g package.json <pattern> .`) or use `node scripts/agent-os-repo-search.mjs normalize -- '<command>'` before exec. Searching only `package.json` for `agent-os-land-pr` should use `node scripts/agent-os-land-pr.mjs <pr-url>` directly.",
     "- Land PRs only through the repo's narrow landing wrapper: `node scripts/agent-os-land-pr.mjs <pr-number-or-url>`. The wrapper performs live GitHub readiness checks, squash-merges exactly that PR, deletes the branch, and verifies merged state.",
-    "- If the wrapper rejects a PR as draft, conflicted, non-green, pending checks, or missing an exact PR target, mark the landing task blocked with the exact reason instead of improvising a merge path."
+    "- If the wrapper rejects a PR as draft, conflicted, non-green, pending checks, or missing an exact PR target, mark the landing task blocked with the exact reason instead of improvising a merge path.",
+    "- Do not land unmanaged PRs. A PR must carry a hard AgentTask reference in the PR body and the AgentTask must carry `prUrl`; if either side is missing, block it as unmanaged and repair the link before merge.",
+    "- Any PR update sent to Telegram, AgentOS events, or Command Center summaries must include a direct PR link and a plain-English purpose, not just a PR number, task id, branch, or terse title."
   ];
   return lines.join("\n");
 }
@@ -1328,8 +1347,15 @@ function registerTelegramReplyContextHooks({
 var DIRECT_CHAT_CHANNEL_IDS = /* @__PURE__ */ new Set(["telegram", "webchat"]);
 var RAW_TOOL_ERROR_WARNING_RE = /^⚠️\s*🛠️\s*.+\bfailed\b/ui;
 var INTERNAL_TRACE_LINE_RE = /^(?:>\s*)?(?:📊|🛠️|📖|📝|🔍|🔎|⚙️)\s*(?:Session Status|Exec|Read|Edit|Write|Patch|Search|Open|Click|Find|Screenshot|Update Plan|Tool Call|Tool Result|Function Call|Shell|Command)\s*:/i;
+var INTERNAL_CHANNEL_LINE_RE = /^(?:>\s*)?(?:analysis|commentary|tool[-_ ]?call|tool[-_ ]?result|function[-_ ]?call|thinking|reasoning)\s*[:=]/i;
 var COMPACT_TOOL_COMMAND_LINE_RE = /^(?:>\s*)?🛠️\s*(?:(?:(?:elevated|pty)\b\s*(?:·|,)\s*)+)?(?:`{1,2}\s*\S|(?:run|check|fetch|pull|push|view|show|list|switch|create|merge|rebase|stage|restore|reset|stash|search|find|print|copy|move|remove|install|start|cd|git|worktree|pnpm|npm|yarn|bun|node|python|python3|bash|sh)\b)/i;
+var BARE_TOOL_STATUS_LINE_RE = /^(?:`{1,2}\s*)?🛠️\s*(?:Exec|Read|Edit|Write|Patch|Search|Open|Click|Find|Screenshot|Update Plan|Shell|Command)(?:\s*\([^)]*\))?\s*`{0,2}$/iu;
+var PLAIN_TOOL_PROGRESS_LINE_RE = /^print lines \d+(?:-\d+)?(?:\s+from\s+\S.*)?$/i;
+var CODEX_SEARCH_SCAFFOLD_LINE_RE = /^(?:search\s+)?<{4,}\|={4,}\|/i;
 var TOOL_AGENT_SCOPE_RE = /\(in\s+[~\/]|\(agent\)/i;
+function normalizeLineForToolFilter(line) {
+  return line.trim().replace(/^`+|`+$/g, "").trim();
+}
 function isDirectChatChannel(channelId) {
   if (!channelId) return false;
   const normalized = channelId.trim().toLowerCase();
@@ -1338,15 +1364,18 @@ function isDirectChatChannel(channelId) {
 function isRawInternalToolFailureLine(line) {
   const trimmed = line.trim();
   if (!trimmed) return false;
+  const normalized = normalizeLineForToolFilter(trimmed);
   if (RAW_TOOL_ERROR_WARNING_RE.test(trimmed)) return true;
-  if (INTERNAL_TRACE_LINE_RE.test(trimmed)) return true;
-  if (COMPACT_TOOL_COMMAND_LINE_RE.test(trimmed)) {
-    if (/\bfailed\b/i.test(trimmed)) return true;
-    if (TOOL_AGENT_SCOPE_RE.test(trimmed)) return true;
-  }
-  if (/^🛠️\s+/u.test(trimmed) && /\bfailed\b/i.test(trimmed) && TOOL_AGENT_SCOPE_RE.test(trimmed)) {
+  if (INTERNAL_TRACE_LINE_RE.test(trimmed) || INTERNAL_TRACE_LINE_RE.test(normalized)) return true;
+  if (INTERNAL_CHANNEL_LINE_RE.test(trimmed)) return true;
+  if (COMPACT_TOOL_COMMAND_LINE_RE.test(trimmed) || COMPACT_TOOL_COMMAND_LINE_RE.test(normalized)) {
     return true;
   }
+  if (BARE_TOOL_STATUS_LINE_RE.test(trimmed) || BARE_TOOL_STATUS_LINE_RE.test(normalized)) return true;
+  if (PLAIN_TOOL_PROGRESS_LINE_RE.test(trimmed)) return true;
+  if (CODEX_SEARCH_SCAFFOLD_LINE_RE.test(trimmed)) return true;
+  if (/^🛠️\s+/u.test(normalized) && /\bfailed\b/i.test(normalized)) return true;
+  if (/^(?:>\s*)?🛠️/u.test(trimmed) && TOOL_AGENT_SCOPE_RE.test(trimmed)) return true;
   return false;
 }
 function filterDirectChatOutboundContent(content) {
@@ -1479,9 +1508,18 @@ function createContactTools(config) {
 var getContextSchema = {
   type: "object",
   properties: {
+    projection: {
+      type: "string",
+      enum: ["brief", "full"],
+      description: "Response shape. Default brief returns compact identity/current-work context with follow-up hints. full returns the legacy broad stats payload and can be large/truncation-prone."
+    },
     slug: {
       type: "string",
       description: "AgentOS slug. Omit to use the account's primary AgentOS workspace."
+    },
+    agentContext: {
+      type: "string",
+      description: "Active agent/runtime/persona context within the AgentOS workspace, e.g. ghost, forge, or hermes-forge. Keeps shared workspace state available while scoping identity and recent-session current work."
     }
   },
   additionalProperties: false,
@@ -1527,7 +1565,7 @@ function createContextTools(config) {
     {
       name: "agent_os_get_context",
       label: "AgentOS Get Context",
-      description: "Get the agent's full AgentOS state in one call: identity, goals, projects, contacts, sessions, and memory stats.",
+      description: "Get compact startup context: identity/Soul-equivalent, key preferences, current-work pointers, memory stats, and follow-up instructions. Default brief stays small; projection=full returns the legacy broad stats payload.",
       parameters: getContextSchema,
       execute: (_toolCallId, params) => callAgentOsTool({
         serverName: config.agentOsServer,
@@ -2980,7 +3018,7 @@ var commandCenterDashboardContractSchema = {
     projection: {
       type: "string",
       enum: ["mcp", "slim"],
-      description: "mcp (default) \u2014 agentReadable + resultContract + dashboard fields. slim \u2014 legacy dashboard DTO only."
+      description: "mcp (default) \u2014 tiny brief flight-board (<12k). slim \u2014 full dashboard verification DTO (large)."
     }
   },
   additionalProperties: false,
@@ -3009,7 +3047,7 @@ var commandCenterGetSchema = {
     projection: {
       type: "string",
       enum: ["compact", "full"],
-      description: "Response shape. Default compact \u2014 agentReadable summary, countSnapshot, capped previews; omits graph/hierarchy."
+      description: "Response shape. Default compact \u2014 tiny brief flight-board (<12k). full \u2014 expensive admin/debug rollup."
     }
   },
   additionalProperties: false,
@@ -3145,7 +3183,7 @@ function createCommandCenterTools(config) {
     ),
     mk(
       "agent_os_command_center_dashboard_contract_get",
-      "Slim dashboard contract for runtime verification: countSnapshot, packageVersionHealth, runtime capacity, activePlanRollups, blockerSlo \u2014 no graph/hierarchy.",
+      "Command Center dashboard MCP brief (default): heads-up counts, running tasks, next actions, follow-up tool hints (<12k). Use projection=slim for full verification DTO.",
       commandCenterDashboardContractSchema
     ),
     mk(