@kynver-app/mcp-agent-os 0.3.68 → 0.3.71

package/dist/server.js

@@ -1,751 +0,0 @@
-/**
- * Kynver Agentic OS MCP server: slug-keyed agent identity, goals, projects,
- * sessions, contacts, and long-term memory.
- *
- * Each tool proxies to `/api/agent-os/{slug}/*` on Kynver. The optional `slug`
- * argument resolves in order: explicit arg → `KYNVER_AGENT_OS_SLUG` → cached
- * `GET /api/agent-os` `{ primarySlug }` → list first item → legacy `"ghost"`.
- */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { get, post, patch } from "./lib/kynver-client.js";
-import { registerPlanTools } from "./tools/plans.js";
-import { registerPlanProgressTools } from "./tools/plan-progress.js";
-import { registerPlanToFactoryTools } from "./tools/plan-to-factory.js";
-import { registerTaskTools } from "./tools/tasks.js";
-import { registerActionRequiredTools } from "./tools/action-required.js";
-import { registerGraphTools } from "./tools/graph.js";
-import { registerWorkbenchTools } from "./tools/workbench.js";
-import { registerCommandCenterTools } from "./tools/command-center.js";
-import { registerMemoryQualityFeedbackTools } from "./tools/memory-quality-feedback.js";
-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 { 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 { 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) {
-    return {
-        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
-        structuredContent: data,
-    };
-}
-function compact(source) {
-    const out = {};
-    for (const [key, value] of Object.entries(source)) {
-        if (value !== undefined)
-            out[key] = value;
-    }
-    return out;
-}
-const MCP_LEGACY_SLUG_FALLBACK = "ghost";
-export function resolveAgentContext(explicitAgentContext) {
-    const explicit = explicitAgentContext?.trim();
-    if (explicit)
-        return explicit;
-    const fromEnv = process.env.KYNVER_AGENT_CONTEXT?.trim() || process.env.KYNVER_AGENT_OS_CONTEXT?.trim() || "";
-    return fromEnv || undefined;
-}
-export function createAgentOsServer() {
-    const server = new McpServer({ name: "kynver-mcp-agent-os", version: PACKAGE_VERSION }, { capabilities: { tools: {} } });
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    function register(name, description, inputSchema, cb) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        server.registerTool(name, { description, inputSchema }, cb);
-    }
-    let cachedResolvedPrimarySlug = null;
-    async function resolveToolSlug(explicitSlug) {
-        const trimmed = explicitSlug?.trim();
-        if (trimmed)
-            return trimmed;
-        const fromEnv = process.env.KYNVER_AGENT_OS_SLUG?.trim();
-        if (fromEnv)
-            return fromEnv;
-        if (cachedResolvedPrimarySlug)
-            return cachedResolvedPrimarySlug;
-        try {
-            const body = await get("/agent-os");
-            const primary = typeof body.primarySlug === "string" ? body.primarySlug.trim() : "";
-            if (primary) {
-                cachedResolvedPrimarySlug = primary;
-                return primary;
-            }
-            const first = Array.isArray(body.items) ? body.items[0]?.slug : undefined;
-            if (typeof first === "string") {
-                const t = first.trim();
-                if (t) {
-                    cachedResolvedPrimarySlug = t;
-                    return t;
-                }
-            }
-        }
-        catch {
-            // fall through
-        }
-        return MCP_LEGACY_SLUG_FALLBACK;
-    }
-    const slugField = z.string().optional().describe("AgentOS slug within your account. Omit to use env or server-discovered primary (GET /api/agent-os). Legacy: `ghost`.");
-    const memorySurfaceField = z
-        .enum(["operator", "customer"])
-        .optional()
-        .describe("Response shape for memory reads. Owners/env admins may pass operator for full diagnostics or customer to preview grantee-safe JSON. Grantees always receive customer-safe fields regardless of this flag.");
-    const contextProjectionField = z
-        .enum(["brief", "full"])
-        .optional()
-        .describe("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.");
-    const agentContextField = z
-        .string()
-        .optional()
-        .describe("Active agent/runtime/persona context within the shared AgentOS workspace, e.g. ghost, forge, or hermes-forge. Do not use slug for this; slug selects the workspace.");
-    const sourceRefSchema = z
-        .object({
-        type: z
-            .enum(["repo", "commit", "branch", "pr", "map", "session", "tool", "url", "manual", "unknown"])
-            .describe("What kind of source backs this memory."),
-        label: z.string().optional(),
-        repo: z.string().optional(),
-        path: z.string().optional(),
-        commit: z.string().optional(),
-        branch: z.string().optional(),
-        pr: z.union([z.number(), z.string()]).optional(),
-        url: z.string().optional(),
-        sessionId: z.string().optional(),
-        toolName: z.string().optional(),
-        note: z.string().optional(),
-    })
-        .passthrough();
-    const memoryTypeSchema = z
-        .enum(["decision", "lesson", "fact", "preference", "project_update", "runbook", "source_map", "correction", "active_state", "note"])
-        .describe("What kind of durable memory this is. Use note only when a more specific type does not fit.");
-    const confidenceSchema = z
-        .enum(["low", "medium", "high"])
-        .describe("How reliable this memory is based on available evidence.");
-    const reviewStatusSchema = z
-        .enum(["none", "needs_review", "reviewed", "stale", "rejected"])
-        .describe("Set needs_review for important, uncertain, stale-looking, or user-correctable memories.");
-    const activeStateEntityTypeSchema = z
-        .enum(["pr_watch", "branch", "deployment"])
-        .describe("Tracked entity kind. pr_watch: a live PR. branch: local-vs-remote branch state. deployment: a live release.");
-    const skillCategorySchema = z.enum(["engineering", "productivity", "agent_ops", "domain", "personal", "misc"]);
-    const skillStatusSchema = z.enum(["draft", "active", "deprecated", "archived"]);
-    const skillDraftSchema = z.object({
-        slug: z.string().optional().describe("Stable skill slug. Required for JSON skill imports and skill creation."),
-        name: z.string().optional(),
-        description: z.string().nullable().optional(),
-        category: skillCategorySchema.optional(),
-        status: skillStatusSchema.optional().describe("Imports default to draft regardless of this value."),
-        triggerRules: z.string().nullable().optional(),
-        instructions: z.string().optional(),
-        sourceRefs: z.array(sourceRefSchema).optional(),
-        metadata: z.record(z.string(), z.unknown()).nullable().optional(),
-    });
-    const sessionEventSchema = z
-        .object({
-        type: z.enum(["topic", "decision", "action", "file", "commit", "pr", "tool", "follow_up", "blocker", "note"]).optional(),
-        summary: z.string().describe("Short factual event summary."),
-        timestamp: z.string().optional(),
-        details: z.record(z.string(), z.unknown()).optional(),
-        sourceRefs: z.array(sourceRefSchema).optional(),
-    })
-        .passthrough();
-    register("agent_os_get_context", "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. Pass agentContext for persona-specific context inside a shared workspace.", { slug: slugField, projection: contextProjectionField, agentContext: agentContextField }, async (args) => {
-        const s = await resolveToolSlug(args.slug);
-        const params = new URLSearchParams();
-        params.set("projection", args.projection === "full" ? "full" : "brief");
-        const agentContext = resolveAgentContext(args.agentContext);
-        if (agentContext) {
-            params.set("agentContext", agentContext);
-        }
-        return jsonResult(await get(`/agent-os/${s}/stats?${params}`));
-    });
-    register("agent_os_context_envelope", "Build a compact context envelope for one anchor (plan | task | goal | project | session). Returns the resolved anchor, its goal + plan (with current version body) + most-relevant task + recent session + top related memories with deduplicated source refs. Use this instead of reading giant docs when picking up an in-flight piece of work — one round trip, scoped to your workspace.", {
-        anchorType: z.enum(["plan", "task", "goal", "project", "session"]).describe("Kind of anchor to load context around."),
-        anchorId: z.string().describe("Id of the anchor row within this workspace."),
-        memoryQuery: z.string().optional().describe("Override the memory search query. Defaults to a query derived from the anchor's title/summary."),
-        memoryLimit: z.number().optional().describe("Max memory hits (default 5, max 20). Set 0 to skip memory recall."),
-        sessionLimit: z.number().optional().describe("Max recent sessions (default 1, max 5). Set 0 to skip."),
-        resolveCurrentFocus: z.boolean().optional().describe("M2: when true and anchorType=session, resolve the most-recently-active non-terminal task as current focus. Read-only — never mutates task status. Use for agents (e.g. Hermes chat) that do not start from an explicit task anchor."),
-        surface: memorySurfaceField,
-        slug: slugField,
-    }, async (args) => {
-        const s = await resolveToolSlug(args.slug);
-        const params = new URLSearchParams();
-        params.set("anchorType", args.anchorType);
-        params.set("anchorId", args.anchorId);
-        if (args.memoryQuery)
-            params.set("memoryQuery", args.memoryQuery);
-        if (args.memoryLimit !== undefined)
-            params.set("memoryLimit", String(args.memoryLimit));
-        if (args.sessionLimit !== undefined)
-            params.set("sessionLimit", String(args.sessionLimit));
-        if (args.resolveCurrentFocus)
-            params.set("resolveCurrentFocus", "true");
-        if (args.surface)
-            params.set("surface", args.surface);
-        return jsonResult(await get(`/agent-os/${s}/context-envelope?${params}`));
-    });
-    register("agent_os_open_session", "Call this at the START of every session. Records channel, model, and opens a session record for continuity. Ghost calls this immediately after agent_os_get_context on startup.", {
-        channel: z.string().describe("Runtime channel: 'webchat' | 'telegram' | 'discord' | …"),
-        model: z.string().optional().describe("Model used for the session (default 'claude-sonnet-4-6')."),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await post(`/agent-os/${s}/sessions`, body));
-    });
-    register("agent_os_close_session", "Call this at the END of every session with a summary of what was accomplished and key decisions made. This is how Ghost maintains cross-session continuity — without it, the next session has no record of what happened.", {
-        sessionId: z.string(),
-        summary: z.string().optional(),
-        topicsWorked: z.array(z.string()).optional(),
-        decisionsLog: z.unknown().optional(),
-        events: z.array(sessionEventSchema).optional().describe("Structured events to merge into the session trace before close-summary synthesis."),
-        goalIds: z.array(z.string()).optional(),
-        projectIds: z.array(z.string()).optional(),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, sessionId, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await patch(`/agent-os/${s}/sessions/${sessionId}`, body));
-    });
-    register("agent_os_log_session_event", "Append a structured event to an open AgentOS session. Use for topics, decisions, actions, touched files, commits/PRs, blockers, and follow-ups so close summaries can be synthesized from real session traces.", {
-        sessionId: z.string().describe("Open AgentOS session id."),
-        type: z.enum(["topic", "decision", "action", "file", "commit", "pr", "tool", "follow_up", "blocker", "note"]).optional(),
-        summary: z.string().describe("Short factual event summary."),
-        timestamp: z.string().optional(),
-        details: z.record(z.string(), z.unknown()).optional(),
-        sourceRefs: z.array(sourceRefSchema).optional(),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, sessionId, ...event } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await post(`/agent-os/${s}/sessions/${sessionId}/events`, { event }));
-    });
-    register("agent_os_log_session", "Append a structured session-log entry to the agent's daily log. Call at session end or mid-session checkpoints. Replaces writing to memory/YYYY-MM-DD.md. Entries accumulate across sessions; consolidation distils them into long-term memory.", {
-        summary: z.string().describe("2-4 sentence summary of what was worked on."),
-        topicsWorked: z.array(z.string()).optional().describe("Topics covered this session."),
-        keyDecisions: z.array(z.string()).optional().describe("Important decisions made."),
-        date: z.string().optional().describe("Date to log against (YYYY-MM-DD, defaults to today UTC)."),
-        slug: slugField,
-    }, async (args) => {
-        const lines = [args.summary];
-        if (args.topicsWorked?.length)
-            lines.push(`Topics: ${args.topicsWorked.join(", ")}`);
-        if (args.keyDecisions?.length) {
-            lines.push("Key decisions:");
-            args.keyDecisions.forEach((d) => lines.push(`- ${d}`));
-        }
-        const entry = lines.join("\n");
-        const s = await resolveToolSlug(args.slug);
-        return jsonResult(await post(`/agent-os/${s}/daily-log`, {
-            entry,
-            ...(args.date ? { date: args.date } : {}),
-        }));
-    });
-    register("agent_os_list_goals", "List the agent's goals, optionally filtered by status or project. Replaces reading the pending sections of MEMORY.md.", {
-        status: z
-            .enum(["open", "in_progress", "blocked", "complete", "cancelled"])
-            .optional()
-            .describe("Filter by status. Omit to get all goals."),
-        projectId: z.string().optional().describe("Filter by project DB ID."),
-        slug: slugField,
-    }, async (args) => {
-        const params = new URLSearchParams();
-        if (args.status)
-            params.set("status", args.status);
-        if (args.projectId)
-            params.set("projectId", args.projectId);
-        const qs = params.toString();
-        const s = await resolveToolSlug(args.slug);
-        return jsonResult(await get(`/agent-os/${s}/goals${qs ? `?${qs}` : ""}`));
-    });
-    register("agent_os_update_goal", "Create a new goal or update an existing one. Pass goalId to update; omit to create (title is then required). Set status=complete with an outcome to close a goal (stamps closedAt). projectId is the project DB ID from agent_os_get_projects.", {
-        title: z.string().optional().describe("Goal title. Required when creating."),
-        description: z.string().optional(),
-        status: z.enum(["open", "in_progress", "blocked", "complete", "cancelled"]).optional(),
-        priority: z.enum(["low", "normal", "high", "critical"]).optional(),
-        projectId: z.string().optional().describe("Project DB ID to associate."),
-        analystHypothesisId: z.string().optional().describe("Optional analyst hypothesis to link (create-only)."),
-        outcome: z.string().optional().describe("Outcome — include when closing a goal."),
-        goalId: z.string().optional().describe("ID of existing goal to update. Omit to create."),
-        slug: slugField,
-    }, async (args) => {
-        const { goalId, slug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        if (goalId) {
-            return jsonResult(await patch(`/agent-os/${s}/goals/${goalId}`, body));
-        }
-        if (!body.title) {
-            return jsonResult({ error: "title is required when creating a goal" });
-        }
-        return jsonResult(await post(`/agent-os/${s}/goals`, body));
-    });
-    register("agent_os_get_projects", "Get all projects the agent is tracking with current focus, next actions, blockers, and status. Replaces reading project sections of MEMORY.md.", {
-        status: z
-            .enum(["active", "on_hold", "shipped", "archived"])
-            .optional()
-            .describe("Filter by project status. Omit to get all."),
-        slug: slugField,
-    }, async (args) => {
-        const params = new URLSearchParams();
-        if (args.status)
-            params.set("status", args.status);
-        const qs = params.toString();
-        const s = await resolveToolSlug(args.slug);
-        return jsonResult(await get(`/agent-os/${s}/projects${qs ? `?${qs}` : ""}`));
-    });
-    register("agent_os_update_project", "Update a project's current focus, next-actions queue, blockers list, status, or repo/deploy URLs. The projectId is the DB ID from agent_os_get_projects.", {
-        projectId: z.string().describe("Project DB ID (from agent_os_get_projects)."),
-        name: z.string().optional(),
-        description: z.string().optional(),
-        status: z.enum(["active", "on_hold", "shipped", "archived"]).optional(),
-        currentFocus: z.string().optional().describe("What's being worked on right now."),
-        nextActions: z.array(z.string()).optional().describe("Ordered list of next steps."),
-        blockers: z.array(z.string()).optional().describe("Current blockers."),
-        repoUrl: z.string().optional(),
-        deployUrl: z.string().optional(),
-        slug: slugField,
-    }, async (args) => {
-        const { projectId, slug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await patch(`/agent-os/${s}/projects/${projectId}`, body));
-    });
-    register("agent_os_search_memory", "Search the agent's long-term memory (ownerType=agent). Use to recall specific decisions, project details, or lessons without loading full context. Replaces grep/reading MEMORY.md. Optionally restrict to one source namespace via sourceId, or several via sourceIds (sourceId takes precedence when both are set). Workspace owners and env admins receive additional operator diagnostics unless surface=customer; grantees always receive grantee-safe hits (content, trust, evidence links only).", {
-        query: z.string().describe("Natural language query to search memory."),
-        k: z.number().optional().describe("Number of results (default 5, max 50)."),
-        sourceId: z
-            .string()
-            .optional()
-            .describe("Restrict search to a single memory source namespace (e.g. agent:session). Takes precedence over sourceIds when both are set."),
-        sourceIds: z
-            .array(z.string())
-            .optional()
-            .describe("Restrict search to any of these source namespaces. Ignored when sourceId is also set."),
-        ticker: z.string().optional().describe("Trading desk: filter hits to this ticker symbol."),
-        debatePersona: z.enum(["bull", "bear"]).optional().describe("Trading desk: filter to bull or bear advocate memories."),
-        personaSlug: z.string().optional().describe("Layer in this persona's operating rules alongside global rules."),
-        surface: memorySurfaceField,
-        slug: slugField,
-    }, async (args) => {
-        const params = new URLSearchParams({ q: args.query });
-        if (args.k)
-            params.set("k", String(args.k));
-        if (args.sourceId)
-            params.set("sourceId", args.sourceId);
-        if (args.sourceIds?.length) {
-            for (const id of args.sourceIds)
-                params.append("sourceIds", id);
-        }
-        if (args.ticker)
-            params.set("ticker", args.ticker);
-        if (args.debatePersona)
-            params.set("debatePersona", args.debatePersona);
-        if (args.personaSlug)
-            params.set("personaSlug", args.personaSlug);
-        if (args.surface)
-            params.set("surface", args.surface);
-        const s = await resolveToolSlug(args.slug);
-        return jsonResult(await get(`/agent-os/${s}/memory?${params}`));
-    });
-    register("agent_os_get_desk_debate_context", "Fetch trading-desk debate context for a ticker: latest canonical DeskAnalysisReport debate fields plus bull/bear MARM snippets scoped by ticker and debatePersona.", {
-        ticker: z.string().describe("Equity ticker symbol, e.g. NVDA."),
-        reportId: z.string().optional().describe("Optional DeskAnalysisReport id; defaults to latest canonical report for the ticker."),
-        slug: slugField,
-    }, async (args) => {
-        const params = new URLSearchParams({ ticker: args.ticker });
-        if (args.reportId)
-            params.set("reportId", args.reportId);
-        const s = await resolveToolSlug(args.slug);
-        return jsonResult(await get(`/agent-os/${s}/desk-debate-context?${params}`));
-    });
-    register("agent_os_list_skills", "List AgentOS skills available to this workspace, including Kynver built-ins, user-authored skills, and per-AgentOS binding state. Pass view=\"manifest\" for the runtime read path: only enabled, runtime-eligible skills (enabled binding plus, for user skills, status=active) with metadata only — no instructions. Skill instructions are fetched on demand with agent_os_get_skill; do not inject every skill into every model context.", {
-        view: z
-            .enum(["full", "manifest"])
-            .optional()
-            .describe("\"manifest\" returns only enabled, runtime-eligible skills with metadata (slug, name, description, triggerRules, priority, autoInvoke) and no instructions; \"full\" (default) returns every skill with binding state."),
-        slug: slugField,
-    }, async (args) => {
-        const s = await resolveToolSlug(args.slug);
-        const qs = args.view === "manifest" ? "?view=manifest" : "";
-        return jsonResult(await get("/agent-os/" + s + "/skills" + qs));
-    });
-    register("agent_os_create_skill", "Create a user-authored AgentOS skill. Skill instructions are user content fetched on demand, not system instructions. Created skills are not enabled until bound with agent_os_bind_skill.", {
-        skillSlug: z.string().describe("Stable skill slug."),
-        name: z.string(),
-        description: z.string().nullable().optional(),
-        category: skillCategorySchema.optional(),
-        status: skillStatusSchema.optional().describe("Defaults to draft server-side."),
-        triggerRules: z.string().nullable().optional(),
-        instructions: z.string(),
-        sourceRefs: z.array(sourceRefSchema).optional(),
-        metadata: z.record(z.string(), z.unknown()).nullable().optional(),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, skillSlug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await post("/agent-os/" + s + "/skills", { ...body, slug: skillSlug }));
-    });
-    register("agent_os_update_skill", "Update a user-authored AgentOS skill. Built-in skills are read-only; imported skills should be user-authored rows so users and agents can edit them.", {
-        skillSlug: z.string().describe("Existing user-authored skill slug."),
-        name: z.string().optional(),
-        description: z.string().nullable().optional(),
-        category: skillCategorySchema.optional(),
-        status: skillStatusSchema.optional(),
-        triggerRules: z.string().nullable().optional(),
-        instructions: z.string().optional(),
-        sourceRefs: z.array(sourceRefSchema).optional(),
-        metadata: z.record(z.string(), z.unknown()).nullable().optional(),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, skillSlug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await patch("/agent-os/" + s + "/skills/" + encodeURIComponent(skillSlug), body));
-    });
-    register("agent_os_import_skills", "Import external skill markdown or JSON as user-authored draft skills. Imported skills are not enabled or bound automatically; list/get them, suggest choices to the user, then bind only selected skills.", {
-        markdown: z.string().optional().describe("One or more markdown skills with frontmatter, or a JSON string/object encoded as text."),
-        skills: z.array(skillDraftSchema).optional().describe("JSON skill definitions to import."),
-        sourceLabel: z.string().optional(),
-        overwrite: z.boolean().optional().describe("Update existing user skills with matching slugs instead of skipping them."),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await post("/agent-os/" + s + "/skills/import", body));
-    });
-    register("agent_os_bind_skill", "Enable or update a skill binding for this AgentOS workspace. Built-in skills use skillSource=builtin and skillSlug; user-authored skills use skillSource=user and skillSlug.", {
-        skillSlug: z.string().describe("Skill slug to bind, for example diagnose or a user-authored slug."),
-        skillSource: z.enum(["builtin", "user"]).describe("Whether the skill is a file-backed built-in or a user-authored AgentSkill."),
-        enabled: z.boolean().optional().describe("Whether the binding is enabled. Defaults to true server-side."),
-        priority: z.number().optional().describe("Higher priority skills can be preferred by clients when multiple skills match."),
-        autoInvoke: z.boolean().optional().describe("Whether clients may auto-invoke this skill when trigger rules match."),
-        notes: z.string().optional().describe("Operator notes about why this skill is bound or how it should be used."),
-        config: z.record(z.string(), z.unknown()).optional().describe("Per-binding configuration for future clients."),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, skillSlug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await post("/agent-os/" + s + "/skills/" + encodeURIComponent(skillSlug) + "/bind", body));
-    });
-    register("agent_os_write_memory", "Write a durable memory entry to AgentOS MARM. Use for facts, decisions, lessons, preferences, source maps, and runbooks that should survive sessions. For ordinary progress during a live session, prefer agent_os_log_session_event or agent_os_log_session. Include sourceRefs whenever possible, set memoryType/confidence, and mark important or uncertain memories reviewStatus='needs_review'.", {
-        content: z.string().describe("The memory content to store."),
-        key: z.string().optional().describe("Unique slug identifier for this memory (e.g. 'kynver-arch-decision-2026-05'). Defaults to a timestamped note slug."),
-        category: z
-            .enum(["long_term", "project", "contact", "tool_config"])
-            .optional()
-            .describe("Memory category. Mapped to sourceId: long_term/contact/tool_config -> 'agent:long-term', project -> 'agent:project'. Ignored if sourceId is set."),
-        sourceId: z.string().optional().describe("Advanced: override the sourceId tag directly. If set, category is ignored."),
-        metadata: z.record(z.string(), z.unknown()).optional(),
-        sourceRefs: z.array(sourceRefSchema).optional().describe("Structured provenance references for this memory, such as repo/path/commit/PR/map/session."),
-        memoryType: memoryTypeSchema.optional(),
-        confidence: confidenceSchema.optional(),
-        reviewStatus: reviewStatusSchema.optional(),
-        projectId: z.string().optional().describe("AgentOS project id this memory belongs to, when known."),
-        goalId: z.string().optional().describe("AgentOS goal id this memory supports, when known."),
-        contactId: z.string().optional().describe("AgentOS contact id this memory concerns, when known."),
-        skillId: z.string().optional().describe("Skill identifier this memory belongs to. Built-ins use skill slug; user-authored skills use AgentSkill.id."),
-        correctionReason: z
-            .string()
-            .optional()
-            .describe("When this write encodes a user/operator correction (e.g. Telegram preference fix), explain why — triggers memory-quality negative feedback."),
-        correctionSource: z
-            .enum(["telegram", "manual", "api", "session"])
-            .optional()
-            .describe("Channel that supplied the correction; stored in metadata for audit, not memory body."),
-        slug: slugField,
-    }, async (args) => {
-        const categoryToSourceId = {
-            long_term: "agent:long-term",
-            project: "agent:project",
-            contact: "agent:long-term",
-            tool_config: "agent:long-term",
-        };
-        const sourceId = args.sourceId ?? (args.category ? categoryToSourceId[args.category] : undefined);
-        const body = { content: args.content };
-        if (args.key)
-            body.slug = args.key;
-        if (sourceId)
-            body.sourceId = sourceId;
-        if (args.metadata)
-            body.metadata = args.metadata;
-        if (args.sourceRefs)
-            body.sourceRefs = args.sourceRefs;
-        if (args.memoryType)
-            body.memoryType = args.memoryType;
-        if (args.confidence)
-            body.confidence = args.confidence;
-        if (args.reviewStatus)
-            body.reviewStatus = args.reviewStatus;
-        if (args.projectId)
-            body.projectId = args.projectId;
-        if (args.goalId)
-            body.goalId = args.goalId;
-        if (args.contactId)
-            body.contactId = args.contactId;
-        if (args.skillId)
-            body.skillId = args.skillId;
-        if (args.correctionReason)
-            body.correctionReason = args.correctionReason;
-        if (args.correctionSource)
-            body.correctionSource = args.correctionSource;
-        const s = await resolveToolSlug(args.slug);
-        return jsonResult(await post(`/agent-os/${s}/memory`, body));
-    });
-    register("agent_os_write_skill_memory", "Write a durable AgentOS memory tagged to a skill. Use this for lessons, runbooks, and decisions learned while applying a skill. Built-in skills use skillId=skill slug; user-authored skills use skillId=AgentSkill.id.", {
-        skillId: z.string().describe("Skill identifier: built-in skill slug or user-authored AgentSkill.id."),
-        content: z.string().describe("The memory content to store."),
-        key: z.string().optional().describe("Unique slug identifier for this memory. Defaults to a timestamped note slug."),
-        sourceId: z.string().optional().describe("Advanced: override sourceId. Defaults to agent:long-term."),
-        metadata: z.record(z.string(), z.unknown()).optional(),
-        sourceRefs: z.array(sourceRefSchema).optional().describe("Structured provenance references for this skill memory."),
-        memoryType: memoryTypeSchema.optional(),
-        confidence: confidenceSchema.optional(),
-        reviewStatus: reviewStatusSchema.optional(),
-        projectId: z.string().optional(),
-        goalId: z.string().optional(),
-        contactId: z.string().optional(),
-        slug: slugField,
-    }, async (args) => {
-        const s = await resolveToolSlug(args.slug);
-        const body = compact({
-            content: args.content,
-            slug: args.key,
-            sourceId: args.sourceId ?? "agent:long-term",
-            metadata: args.metadata,
-            sourceRefs: args.sourceRefs,
-            memoryType: args.memoryType ?? "lesson",
-            confidence: args.confidence,
-            reviewStatus: args.reviewStatus,
-            projectId: args.projectId,
-            goalId: args.goalId,
-            contactId: args.contactId,
-            skillId: args.skillId,
-        });
-        return jsonResult(await post("/agent-os/" + s + "/memory", body));
-    });
-    register("agent_os_get_contacts", "Get all people the agent knows: their relationship, context, preferences, and notes. Replaces reading USER.md and contact sections of MEMORY.md.", { slug: slugField }, async (args) => {
-        const s = await resolveToolSlug(args.slug);
-        return jsonResult(await get(`/agent-os/${s}/contacts`));
-    });
-    register("agent_os_consolidate_memory", "Trigger a memory consolidation pass: LLM reviews recent daily logs and distils key decisions, lessons, and facts into long-term MARM memory. Use during heartbeat maintenance instead of manually rewriting MEMORY.md. Rate-limited to 2 runs per agent per day.", { slug: slugField }, async (args) => {
-        const s = await resolveToolSlug(args.slug);
-        return jsonResult(await post(`/agent-os/${s}/consolidate`, {}));
-    });
-    register("agent_os_create_project", "Create a new project in the agent OS. Use this to add a newly started project to tracking. Returns the created project with its DB id.", {
-        name: z.string().describe("Project name (required)."),
-        description: z.string().optional(),
-        status: z.enum(["active", "on_hold", "shipped", "archived"]).optional().default("active"),
-        currentFocus: z.string().optional().describe("What is being worked on right now."),
-        nextActions: z.array(z.string()).optional().describe("Ordered list of next steps."),
-        blockers: z.array(z.string()).optional(),
-        repoUrl: z.string().optional(),
-        deployUrl: z.string().optional(),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await post(`/agent-os/${s}/projects`, body));
-    });
-    register("agent_os_create_contact", "Add a new contact (or upsert by name) to the agent OS. Use when you meet someone new or want to record info about a person.", {
-        name: z.string().describe("Contact name (required)."),
-        relationship: z.string().optional().describe("e.g. owner, collaborator, client, stakeholder"),
-        context: z.string().optional().describe("Background on who they are and what they do."),
-        preferences: z.record(z.string(), z.unknown()).optional().describe("Communication preferences, timezone, style notes, etc."),
-        notes: z.string().optional(),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await post(`/agent-os/${s}/contacts`, body));
-    });
-    register("agent_os_update_contact", "Update an existing contact by their DB id. Use agent_os_get_contacts to get the id first.", {
-        contactId: z.string().describe("DB id of the contact to update (from agent_os_get_contacts)."),
-        name: z.string().optional(),
-        relationship: z.string().optional(),
-        context: z.string().optional(),
-        preferences: z.record(z.string(), z.unknown()).optional(),
-        notes: z.string().optional(),
-        slug: slugField,
-    }, async (args) => {
-        const { contactId, slug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await patch(`/agent-os/${s}/contacts/${contactId}`, body));
-    });
-    register("agent_os_update_memory", "Update an existing durable memory entry by its key/slug. Use to correct, replace, review, stale, or reclassify a previously written memory. Preserve or improve sourceRefs and writer-contract fields so future agents and the dashboard can audit it.", {
-        key: z.string().describe("The slug/key of the memory to update (from the original agent_os_write_memory call)."),
-        content: z.string().describe("New content to replace the existing memory with."),
-        sourceId: z.string().optional().describe("Override the sourceId tag if needed."),
-        metadata: z.record(z.string(), z.unknown()).optional(),
-        sourceRefs: z.array(sourceRefSchema).optional().describe("Structured provenance references for this replacement memory."),
-        memoryType: memoryTypeSchema.optional(),
-        confidence: confidenceSchema.optional(),
-        reviewStatus: reviewStatusSchema.optional(),
-        projectId: z.string().optional(),
-        goalId: z.string().optional(),
-        contactId: z.string().optional(),
-        skillId: z.string().optional().describe("Skill identifier this memory belongs to. Built-ins use skill slug; user-authored skills use AgentSkill.id."),
-        correctionReason: z
-            .string()
-            .optional()
-            .describe("Why this update corrects prior memory — triggers memory-quality negative feedback when set."),
-        correctionSource: z
-            .enum(["telegram", "manual", "api", "session"])
-            .optional()
-            .describe("Channel that supplied the correction."),
-        slug: slugField,
-    }, async (args) => {
-        const { key, slug, content, sourceId, metadata, sourceRefs, memoryType, confidence, reviewStatus, projectId, goalId, contactId, skillId, correctionReason, correctionSource } = args;
-        const body = { content, slug: key };
-        if (sourceId)
-            body.sourceId = sourceId;
-        if (metadata)
-            body.metadata = metadata;
-        if (sourceRefs)
-            body.sourceRefs = sourceRefs;
-        if (memoryType)
-            body.memoryType = memoryType;
-        if (confidence)
-            body.confidence = confidence;
-        if (reviewStatus)
-            body.reviewStatus = reviewStatus;
-        if (projectId)
-            body.projectId = projectId;
-        if (goalId)
-            body.goalId = goalId;
-        if (contactId)
-            body.contactId = contactId;
-        if (skillId)
-            body.skillId = skillId;
-        if (correctionReason)
-            body.correctionReason = correctionReason;
-        if (correctionSource)
-            body.correctionSource = correctionSource;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await post(`/agent-os/${s}/memory`, body));
-    });
-    register("agent_os_correct_memory", "Write an auditable correction memory that supersedes a stale or wrong memory by slug. Use when fixing an incorrect remembered claim rather than silently editing history.", {
-        targetSlug: z.string().describe("Slug/key of the memory being corrected."),
-        content: z.string().describe("Correct replacement content to remember."),
-        reason: z.string().describe("Why the target is wrong; recorded on the superseded target."),
-        key: z.string().optional().describe("Slug for the new correction memory. Defaults to <targetSlug>-correction."),
-        alsoInvalidates: z.array(z.string()).optional().describe("Additional memory slugs/ids to supersede alongside targetSlug."),
-        assertedBySessionId: z.string().optional(),
-        sourceId: z.string().optional(),
-        sourceRefs: z.array(sourceRefSchema).optional(),
-        memoryType: memoryTypeSchema.optional(),
-        confidence: confidenceSchema.optional(),
-        reviewStatus: reviewStatusSchema.optional(),
-        projectId: z.string().optional(),
-        goalId: z.string().optional(),
-        contactId: z.string().optional(),
-        skillId: z.string().optional(),
-        correctionSource: z.enum(["telegram", "manual", "api", "session"]).optional(),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await post("/agent-os/" + s + "/memory/correct", body));
-    });
-    register("agent_os_record_state", "Record current active state for a live mutable entity such as a PR, branch, or deployment. Server derives the canonical entityKey from fields and upserts one active_state row per entity.", {
-        entityType: activeStateEntityTypeSchema,
-        fields: z.record(z.string(), z.unknown()).describe("Entity-specific current truth. pr_watch requires repo, pr, author, headOwner, headBranch, state. branch requires repo, branch, aheadBy, behindBy, lastCommit. deployment requires target, env, state, url, and version or sha."),
-        observedAt: z.string().optional().describe("ISO timestamp the state was observed. Defaults to now."),
-        content: z.string().optional().describe("Optional human summary; one is generated otherwise."),
-        sourceRefs: z.array(sourceRefSchema).optional(),
-        projectId: z.string().optional(),
-        confidence: confidenceSchema.optional(),
-        reviewStatus: reviewStatusSchema.optional(),
-        sourceId: z.string().optional(),
-        metadata: z.record(z.string(), z.unknown()).optional(),
-        slug: slugField,
-    }, async (args) => {
-        const { slug, ...body } = args;
-        const s = await resolveToolSlug(slug);
-        return jsonResult(await post("/agent-os/" + s + "/memory/state", body));
-    });
-    register("agent_os_get_state", "Get current active state records. Pass entityKey for one record, or entityType/projectId/limit to list active PR, branch, or deployment state.", {
-        entityKey: z.string().optional().describe("Canonical key of a single record, e.g. pr:openclaw/openclaw#83529. Omit to list records."),
-        entityType: activeStateEntityTypeSchema.optional(),
-        projectId: z.string().optional(),
-        limit: z.number().optional(),
-        surface: memorySurfaceField,
-        slug: slugField,
-    }, async (args) => {
-        const { slug, entityKey, entityType, projectId, limit, surface } = args;
-        const s = await resolveToolSlug(slug);
-        const qs = new URLSearchParams();
-        if (entityKey)
-            qs.set("entityKey", entityKey);
-        if (entityType)
-            qs.set("entityType", entityType);
-        if (projectId)
-            qs.set("projectId", projectId);
-        if (limit !== undefined)
-            qs.set("limit", String(limit));
-        if (surface)
-            qs.set("surface", surface);
-        const suffix = qs.toString() ? "?" + qs.toString() : "";
-        return jsonResult(await get("/agent-os/" + s + "/memory/state" + suffix));
-    });
-    // AgentTask board — batch 1 (CRUD) + batch 1.5 (steering / lease) tools.
-    registerTaskTools({ register, resolveToolSlug, jsonResult, compact });
-    // First-class AgentOS plans (Phase 5A): versioned operational artifacts.
-    registerPlanTools({ register, resolveToolSlug, jsonResult, compact });
-    registerPlanProgressTools({ register, resolveToolSlug, jsonResult, compact });
-    registerPlanToFactoryTools({ register, resolveToolSlug, jsonResult, compact });
-    // Action Required inbox: agent_os_ask_human + agent_os_await_action (slice 1).
-    registerActionRequiredTools({ register, jsonResult, compact });
-    // Operational graph insights — Agent SEE (agent_os_graph_query).
-    registerGraphTools({ register, resolveToolSlug, jsonResult });
-    // Workbench view control — steer whole Command Center (agent_os_workbench_*).
-    registerWorkbenchTools({ register, resolveToolSlug, jsonResult });
-    // Command Center rollup (by-id route; includes packageVersionHealth).
-    registerCommandCenterTools({ register, resolveToolSlug, jsonResult });
-    // Memory quality feedback (M2): record events + query status.
-    registerMemoryQualityFeedbackTools({ register, resolveToolSlug, jsonResult, compact });
-    // Operating-rules instruction policy.
-    registerOperatingRulesTools({ register, resolveToolSlug, jsonResult, compact });
-    // Daemon-mediated provider evidence (read-only verification surface).
-    registerProviderEvidenceTools({ register, resolveToolSlug, jsonResult });
-    // PR backlog drain (read-only routing-funnel surface).
-    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 });
-    // Connected-box mesh liveness (heartbeats, cron lease, peer rescues).
-    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 });
-    registerMemoryVaultTools({ register, resolveToolSlug, jsonResult });
-    registerContextExpandTools({ register, resolveToolSlug, jsonResult });
-    registerMonitorTools({ register, resolveToolSlug, jsonResult });
-    registerMacroControlsTools({ register, resolveToolSlug, jsonResult });
-    registerKariAdMarketingLoopTools({ register, resolveToolSlug, jsonResult });
-    // KariAd marketing loop — M6 outcome import (analytics feedback + memory learning).
-    registerKariAdOutcomeImportTools({ register, resolveToolSlug, jsonResult });
-    registerCmoControlTools({ register, resolveToolSlug, jsonResult });
-    // M5: Kynver current-focus / todo adapter (agent-loop focus ≠ executor lease).
-    registerCurrentFocusTools({ register, resolveToolSlug, jsonResult, compact });
-    return server;
-}