@kynver-app/mcp-agent-os 0.3.60 → 0.3.62

package/dist/server.js

@@ -22,20 +22,21 @@ import { registerOperatingRulesTools } from "./tools/operating-rules.js";
 import { registerProviderEvidenceTools } from "./tools/provider-evidence.js";
 import { registerPrBacklogTools } from "./tools/pr-backlog.js";
 import { registerTaskBoardWatchdogTools } from "./tools/task-board-watchdog.js";
-import { registerTaskflowTools } from "./tools/taskflow.js";
 import { registerPlanAuditRollupTools } from "./tools/plan-audit-rollup.js";
 import { registerMeshLivenessTools } from "./tools/mesh-liveness.js";
 import { registerDiagnosticsTools } from "./tools/diagnostics.js";
 import { registerSkillsTools } from "./tools/skills.js";
 import { registerMemoryLedgerTools } from "./tools/memory-ledger.js";
 import { registerMemoryVaultTools } from "./tools/memory-vault.js";
-import { registerContextExpandTools } from "./tools/context-expand.js";
 import { registerMonitorTools } from "./tools/monitor.js";
 import { registerMacroControlsTools } from "./tools/macro-controls.js";
 import { registerKariAdMarketingLoopTools } from "./tools/kariad-marketing-loop.js";
 import { registerKariAdOutcomeImportTools } from "./tools/kariad-outcome-import.js";
 import { registerCmoControlTools } from "./tools/cmo-control.js";
 import { registerCurrentFocusTools } from "./tools/current-focus.js";
+import { registerContextExpandTools } from "./tools/context-expand.js";
+import { registerContextPreviewTools } from "./tools/context-preview.js";
+import { registerTaskflowTools } from "./tools/taskflow.js";
 import { readOwnPackageVersion } from "./lib/package-version.js";
 const PACKAGE_VERSION = readOwnPackageVersion(import.meta.url);
 function jsonResult(data) {
@@ -723,6 +724,7 @@ export function createAgentOsServer() {
     registerPrBacklogTools({ register, resolveToolSlug, jsonResult });
     // Kynver-native task board watchdog (read + tick for verify_live).
     registerTaskBoardWatchdogTools({ register, resolveToolSlug, jsonResult });
+    // Taskflow list/get/mutate (factory task board).
     registerTaskflowTools({ register, resolveToolSlug, jsonResult });
     // Compact active-plan audit rollup (broad completion audits).
     registerPlanAuditRollupTools({ register, resolveToolSlug, jsonResult });
@@ -730,6 +732,8 @@ export function createAgentOsServer() {
     registerMeshLivenessTools({ register, resolveToolSlug, jsonResult });
     // Visible Diagnostics report (dispatch-funnel, closed-loop, verify-live health …).
     registerDiagnosticsTools({ register, resolveToolSlug, jsonResult });
+    // PR6 dark preview shadow comparison (operator verification).
+    registerContextPreviewTools({ register, jsonResult });
     // Skill library: query-first discovery + on-demand recipe fetch (bounded, metadata-first).
     registerSkillsTools({ register, resolveToolSlug, jsonResult });
     registerMemoryLedgerTools({ register, resolveToolSlug, jsonResult });

package/dist/tools/context-preview.d.ts

@@ -0,0 +1,14 @@
+type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: unknown;
+};
+export interface ContextPreviewToolDeps {
+    register: (name: string, description: string, inputSchema: Record<string, unknown>, cb: (args: Record<string, unknown>) => unknown) => void;
+    jsonResult: (data: unknown) => ToolResult;
+}
+/** Admin-safe MCP tool — reports legacy vs shadow preview deltas (PR6 dark integration). */
+export declare function registerContextPreviewTools({ register, jsonResult }: ContextPreviewToolDeps): void;
+export {};

package/dist/tools/context-preview.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { buildChatMemoryShadowPreview, buildLegacyChatMemorySection, } from "@kynver-app/runtime";
+function envTruthy(value) {
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on";
+}
+const DEFAULT_EXPANSION_ROUTE = "agent_os_search_memory";
+/** Admin-safe MCP tool — reports legacy vs shadow preview deltas (PR6 dark integration). */
+export function registerContextPreviewTools({ register, jsonResult }) {
+    register("agent_os_context_preview_shadow", "Compare legacy vs unified preview renderer output for a sample memory list. Dark rollout only — does not mutate prompts. Safe for operator verification.", {
+        memories: z
+            .array(z.object({
+            content: z.string(),
+            similarity: z.number().optional(),
+        }))
+            .optional()
+            .describe("Sample recalled memories to shadow-compare (default: one fixture row)."),
+    }, async (args) => {
+        const memories = args.memories ?? [
+            {
+                content: "Context maps should use route-map previews before raw payloads.",
+                similarity: 0.92,
+            },
+        ];
+        const legacy = buildLegacyChatMemorySection(memories);
+        const shadow = buildChatMemoryShadowPreview(memories);
+        const flagEnabled = envTruthy(process.env.KYNVER_MEMORY_PREVIEW_ALL_SURFACES);
+        const legacyChars = legacy.length;
+        const shadowChars = shadow.length;
+        return jsonResult({
+            flag: {
+                enabled: flagEnabled,
+                envVar: "KYNVER_MEMORY_PREVIEW_ALL_SURFACES",
+                effectiveSource: flagEnabled ? "env_explicit_on" : "default_off",
+            },
+            comparison: {
+                surface: "chat_default",
+                legacyChars,
+                shadowChars,
+                charDelta: shadowChars - legacyChars,
+                shadowWithinBaseline: shadowChars <= legacyChars,
+                expansionRoutesRetained: shadow.includes(DEFAULT_EXPANSION_ROUTE),
+                usingShadow: flagEnabled,
+            },
+            legacyPreview: legacy.slice(0, 500),
+            shadowPreview: shadow.slice(0, 500),
+        });
+    });
+}

package/dist/tools/taskflow.js

@@ -22,11 +22,46 @@ const idSchema = {
 export function registerTaskflowTools({ register, resolveToolSlug, jsonResult, }) {
     register("agent_os_taskflow_list", [
         "List Kynver-native managed TaskFlows projected to the openclaw adapter wire shape.",
+        "Defaults: scope=active, detail=compact (use scope=all|recent and detail=full for audits).",
+        "Supports limit/offset flow pagination; taskWindow.truncated signals the shared 1000-row board window was saturated.",
         "Safe for verify_live — read-only.",
-    ].join(" "), idSchema, async (args) => {
+    ].join(" "), {
+        ...idSchema,
+        scope: z
+            .enum(["active", "recent", "all"])
+            .optional()
+            .describe("Flow inventory scope (default active — non-terminal only)"),
+        detail: z
+            .enum(["compact", "full"])
+            .optional()
+            .describe("Projection detail (default compact — pruned terminal state)"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(200)
+            .optional()
+            .describe("Max flows per page (default 50, max 200)"),
+        offset: z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Flow page offset (default 0)"),
+    }, async (args) => {
         const agentOsId = args.agentOsId?.trim() ||
             (await resolveAgentOsId(args.slug ?? (await resolveToolSlug())));
-        const data = await get(`/agent-os/by-id/${encodeURIComponent(agentOsId)}/taskflow`);
+        const params = new URLSearchParams();
+        if (args.scope)
+            params.set("scope", args.scope);
+        if (args.detail)
+            params.set("detail", args.detail);
+        if (args.limit !== undefined)
+            params.set("limit", String(args.limit));
+        if (args.offset !== undefined)
+            params.set("offset", String(args.offset));
+        const qs = params.toString();
+        const data = await get(`/agent-os/by-id/${encodeURIComponent(agentOsId)}/taskflow${qs ? `?${qs}` : ""}`);
         return jsonResult(data);
     });
     register("agent_os_taskflow_get", [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynver-app/mcp-agent-os",
-  "version": "0.3.60",
+  "version": "0.3.62",
   "description": "Kynver Agentic OS MCP server \u2014 slug-keyed agent identity, goals, projects, sessions, and long-term memory",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "node": ">=24.11.0"
   },
   "dependencies": {
-    "@kynver-app/runtime": "^0.2.0",
+    "@kynver-app/runtime": "^0.2.3",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.23.0"
   },