@kynver-app/mcp-agent-os 0.3.22 → 0.3.23

package/dist/server.js

@@ -15,6 +15,8 @@ import { registerTaskTools } from "./tools/tasks.js";
 import { registerActionRequiredTools } from "./tools/action-required.js";
 import { registerGraphTools } from "./tools/graph.js";
 import { registerCommandCenterTools } from "./tools/command-center.js";
+import { registerMemoryQualityFeedbackTools } from "./tools/memory-quality-feedback.js";
+import { registerOperatingRulesTools } from "./tools/operating-rules.js";
 function jsonResult(data) {
     return {
         content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
@@ -31,7 +33,7 @@ function compact(source) {
 }
 const MCP_LEGACY_SLUG_FALLBACK = "ghost";
 export function createAgentOsServer() {
-    const server = new McpServer({ name: "kynver-mcp-agent-os", version: "0.3.5" }, { capabilities: { tools: {} } });
+    const server = new McpServer({ name: "kynver-mcp-agent-os", version: "0.3.6" }, { 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
@@ -675,5 +677,9 @@ export function createAgentOsServer() {
     registerGraphTools({ 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 });
+    // Lane A instruction policy (operating rules boundary).
+    registerOperatingRulesTools({ register, resolveToolSlug, jsonResult, compact });
     return server;
 }

package/dist/tools/memory-quality-feedback.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP tools for the Memory Quality Feedback pipeline.
+ *
+ * agent_os_record_memory_quality_feedback — POST a feedback event (operator only).
+ * agent_os_memory_quality_status_get      — GET recent feedback events with optional filters.
+ *
+ * Both proxy to `/api/agent-os/{slug}/memory/quality-feedback` on Kynver.
+ */
+type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: unknown;
+};
+export interface MemoryQualityFeedbackToolDeps {
+    register: (name: string, description: string, inputSchema: Record<string, unknown>, cb: (args: any) => any) => void;
+    resolveToolSlug: (explicitSlug?: string) => Promise<string>;
+    jsonResult: (data: unknown) => ToolResult;
+    compact: (source: Record<string, unknown>) => Record<string, unknown>;
+}
+export declare function registerMemoryQualityFeedbackTools({ register, resolveToolSlug, jsonResult, compact, }: MemoryQualityFeedbackToolDeps): void;
+export {};

package/dist/tools/memory-quality-feedback.js

@@ -0,0 +1,100 @@
+/**
+ * MCP tools for the Memory Quality Feedback pipeline.
+ *
+ * agent_os_record_memory_quality_feedback — POST a feedback event (operator only).
+ * agent_os_memory_quality_status_get      — GET recent feedback events with optional filters.
+ *
+ * Both proxy to `/api/agent-os/{slug}/memory/quality-feedback` on Kynver.
+ */
+import { z } from "zod";
+import { get, post } from "../lib/kynver-client.js";
+const SIGNAL_VALUES = ["positive", "negative"];
+const OUTCOME_KIND_VALUES = [
+    "retrieval_used",
+    "retrieval_miss",
+    "human_correction",
+    "task_review_pass",
+    "task_review_fail",
+    "pr_linked",
+    "eval_example",
+    "regression_failure",
+];
+const signalEnum = z.enum(SIGNAL_VALUES);
+const outcomeKindEnum = z.enum(OUTCOME_KIND_VALUES);
+export function registerMemoryQualityFeedbackTools({ register, resolveToolSlug, jsonResult, compact, }) {
+    register("agent_os_record_memory_quality_feedback", [
+        "Record a memory quality feedback event for the AgentOS workspace.",
+        "Use this to signal whether a memory retrieval helped or hurt a task outcome.",
+        "Operator access required (owner or admin). Supports idempotency via idempotencyKey.",
+        "signal: 'positive' for helpful retrievals or correct outcomes, 'negative' for misses or corrections.",
+        "outcomeKind: one of retrieval_used | retrieval_miss | human_correction | task_review_pass",
+        "| task_review_fail | pr_linked | eval_example | regression_failure.",
+    ].join(" "), {
+        signal: signalEnum.describe("Quality signal: 'positive' or 'negative'."),
+        outcomeKind: outcomeKindEnum.describe("Outcome kind: retrieval_used | retrieval_miss | human_correction | task_review_pass | task_review_fail | pr_linked | eval_example | regression_failure."),
+        queryText: z
+            .string()
+            .optional()
+            .describe("The query text that triggered the retrieval (omit sensitive content)."),
+        memoryIds: z
+            .array(z.string())
+            .optional()
+            .describe("IDs of the memory rows that were retrieved or involved."),
+        taskId: z.string().optional().describe("AgentTask id associated with this outcome."),
+        planId: z.string().optional().describe("Plan id associated with this outcome."),
+        prUrl: z.string().optional().describe("GitHub PR URL linked to this outcome."),
+        note: z.string().optional().describe("Free-text operator note."),
+        idempotencyKey: z
+            .string()
+            .optional()
+            .describe("Unique key to prevent duplicate records for the same event."),
+        slug: z
+            .string()
+            .optional()
+            .describe("AgentOS slug. Defaults to the configured env/primary AgentOS."),
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const { slug: _slug, ...body } = args;
+        return jsonResult(await post(`/agent-os/${encodeURIComponent(s)}/memory/quality-feedback`, compact(body)));
+    });
+    register("agent_os_memory_quality_status_get", [
+        "List recent memory quality feedback events for the AgentOS workspace.",
+        "Operator access required (owner or admin).",
+        "Supports filtering by signal (positive|negative), outcomeKind, and a time window via 'since'.",
+        "Returns items array and count. Pair with agent_os_command_center_get to see the memoryQuality rollup",
+        "(aggregate counts + regression gate status).",
+    ].join(" "), {
+        slug: z
+            .string()
+            .optional()
+            .describe("AgentOS slug. Defaults to the configured env/primary AgentOS."),
+        signal: signalEnum
+            .optional()
+            .describe("Filter by signal: 'positive' or 'negative'."),
+        outcomeKind: outcomeKindEnum
+            .optional()
+            .describe("Filter to a specific outcome kind."),
+        since: z
+            .string()
+            .optional()
+            .describe("ISO timestamp — only include events recorded after this instant."),
+        limit: z
+            .number()
+            .optional()
+            .describe("Max events to return (server default 50, max 500)."),
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const qs = new URLSearchParams();
+        if (args.signal)
+            qs.set("signal", args.signal);
+        if (args.outcomeKind)
+            qs.set("outcomeKind", args.outcomeKind);
+        if (args.since)
+            qs.set("since", args.since);
+        if (typeof args.limit === "number" && Number.isFinite(args.limit)) {
+            qs.set("limit", String(args.limit));
+        }
+        const suffix = qs.toString() ? `?${qs.toString()}` : "";
+        return jsonResult(await get(`/agent-os/${encodeURIComponent(s)}/memory/quality-feedback${suffix}`));
+    });
+}

package/dist/tools/operating-rules.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tools for Lane A instruction policy (operating rules boundary).
+ *
+ * agent_os_operating_rules_get — deterministic Lane A policy + optional injection markdown.
+ */
+import type { MemoryQualityFeedbackToolDeps } from "./memory-quality-feedback.js";
+export declare function registerOperatingRulesTools(deps: MemoryQualityFeedbackToolDeps): void;

package/dist/tools/operating-rules.js

@@ -0,0 +1,37 @@
+/**
+ * MCP tools for Lane A instruction policy (operating rules boundary).
+ *
+ * agent_os_operating_rules_get — deterministic Lane A policy + optional injection markdown.
+ */
+import { z } from "zod";
+import { get } from "../lib/kynver-client.js";
+export function registerOperatingRulesTools(deps) {
+    const { register, resolveToolSlug, jsonResult, compact } = deps;
+    register("agent_os_operating_rules_get", [
+        "Return the AgentOS instruction policy (internal + custom operating-rule tiers).",
+        "Uses explicit kind=operating-rule Prisma fetch — not semantic Lane A recall.",
+        "Operator access required; internal-tier mechanics visible to Kynver platform admins only.",
+        "Set includeMarkdown=1 to receive prompt injection text.",
+    ].join(" "), {
+        slug: z.string().optional().describe("AgentOS slug (defaults from env / primary)."),
+        personaSlug: z
+            .string()
+            .optional()
+            .describe("Worker persona slug for additive persona rules."),
+        planId: z.string().optional().describe("Optional plan id for envelope context."),
+        includeMarkdown: z
+            .boolean()
+            .optional()
+            .describe("When true, include formatted markdown suitable for worker prompts."),
+    }, async (args) => {
+        const slug = await resolveToolSlug(args.slug);
+        const qs = new URLSearchParams();
+        if (args.personaSlug?.trim())
+            qs.set("personaSlug", args.personaSlug.trim());
+        if (args.includeMarkdown)
+            qs.set("includeMarkdown", "1");
+        const suffix = qs.toString() ? `?${qs}` : "";
+        const data = await get(`/agent-os/${encodeURIComponent(slug)}/memory/instruction-policy${suffix}`);
+        return jsonResult(compact({ slug, ...data }));
+    });
+}

package/dist/tools/plan-progress.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { get, post } from "../lib/kynver-client.js";
-const progressStatus = z.enum(["todo", "running", "partial", "blocked", "done"]);
+const progressStatus = z.enum(["todo", "in_progress", "running", "partial", "blocked", "done"]);
 const roleLane = z.enum([
     "plan_author",
     "plan_reviewer",
@@ -79,6 +79,20 @@ export function registerPlanProgressTools({ register, resolveToolSlug, jsonResul
         const { slug, planId, ...rest } = args;
         return jsonResult(await post(`/agent-os/${s}/plans/${planId}/review-tasks`, compact(rest)));
     });
+    register("agent_os_plan_progress_focus_set", "Set or clear the plan's agent-loop current focus (`in_progress` on a row). Does not claim an executor lease — use status `running` only when a worker holds a lease.", {
+        planId: z.string(),
+        rowKey: z.string().optional().describe("Row to focus; omit to clear current focus."),
+        rowId: z.string().optional(),
+        taskId: z.string().optional(),
+        roleLane: roleLane.optional().default("implementer"),
+        note: z.string().optional(),
+        executorRef: z.string().optional(),
+        slug: slugField,
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const { slug, planId, ...rest } = args;
+        return jsonResult(await post(`/agent-os/${s}/plans/${planId}/progress-focus`, compact(rest)));
+    });
     register("agent_os_plan_progress_rows_list", "List structured progress rows for a plan.", { planId: z.string(), slug: slugField }, async (args) => {
         const s = await resolveToolSlug(args.slug);
         return jsonResult(await get(`/agent-os/${s}/plans/${args.planId}/progress-rows`));

package/package.json

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