@kynver-app/mcp-agent-os 0.3.5 → 0.3.6

package/README.md

@@ -63,6 +63,12 @@ state to important memories instead of burying those pointers in freeform text.
 Set `reviewStatus: "needs_review"` for important or uncertain memories that a
 human should be able to find and correct in the dashboard.
 
+Active-state and correction tools expose the "what is true right now" layer:
+`agent_os_record_state` / `agent_os_get_state` manage one current
+`active_state` row per live PR, branch, or deployment, while
+`agent_os_correct_memory` writes an auditable correction that supersedes stale
+or wrong remembered claims instead of silently editing history.
+
 Skill tools expose the AgentOS skill registry and skill-tagged memory contract.
 Use `agent_os_get_skill` to fetch instructions on demand, `agent_os_create_skill`
 /`agent_os_update_skill` to manage user-authored skills, `agent_os_import_skills`

package/dist/server.js

@@ -82,7 +82,7 @@ export function createAgentOsServer() {
     })
         .passthrough();
     const memoryTypeSchema = z
-        .enum(["decision", "lesson", "fact", "preference", "project_update", "runbook", "source_map", "correction", "note"])
+        .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"])
@@ -90,6 +90,9 @@ export function createAgentOsServer() {
     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({
@@ -244,14 +247,31 @@ export function createAgentOsServer() {
     register("agent_os_search_memory", "Semantic + keyword hybrid search over the agent's long-term MARM memory (ownerType=agent). Use to recall specific decisions, project details, or lessons without loading full context. Replaces grep/reading MEMORY.md. Results include rrfScore — a Reciprocal Rank Fusion score where ~0.033 is a near-perfect match. Higher is better; do not treat low numbers as poor results.", {
         query: z.string().describe("Natural language query to search memory."),
         k: z.number().optional().describe("Number of results (default 10, max 50)."),
+        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."),
         slug: slugField,
     }, async (args) => {
         const params = new URLSearchParams({ q: args.query });
         if (args.k)
             params.set("k", String(args.k));
+        if (args.ticker)
+            params.set("ticker", args.ticker);
+        if (args.debatePersona)
+            params.set("debatePersona", args.debatePersona);
         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"])
@@ -504,6 +524,66 @@ export function createAgentOsServer() {
         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(),
+        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(),
+        slug: slugField,
+    }, async (args) => {
+        const { slug, entityKey, entityType, projectId, limit } = 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));
+        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 });
     return server;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynver-app/mcp-agent-os",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Kynver Agentic OS MCP server — slug-keyed agent identity, goals, projects, sessions, and long-term memory",
   "type": "module",
   "bin": {