@kynver-app/mcp-agent-os 0.3.34 → 0.3.36

package/dist/index.js

@@ -4,12 +4,17 @@
  * Run: node dist/index.js
  * Env: KYNVER_API_URL, KYNVER_API_KEY (required)
  */
+import { enforceMemoryCostPackageGuardAtStartup } from "@kynver-app/runtime/server/memory-cost-enforce";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { handleCliVersionFlag } from "./lib/package-version.js";
+import { handleCliVersionFlag, readOwnPackageVersion } from "./lib/package-version.js";
 import { createAgentOsServer } from "./server.js";
 if (handleCliVersionFlag(process.argv.slice(2), import.meta.url, "kynver-mcp-agent-os")) {
     // exits
 }
+await enforceMemoryCostPackageGuardAtStartup({
+    selfPackageName: "@kynver-app/mcp-agent-os",
+    selfVersion: readOwnPackageVersion(import.meta.url),
+});
 const server = createAgentOsServer();
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/server.js

@@ -305,7 +305,7 @@ export function createAgentOsServer() {
     });
     register("agent_os_search_memory", "Semantic + keyword hybrid search over 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 operator diagnostics (rrfScore, lanes, hygiene) 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 10, max 50)."),
+        k: z.number().optional().describe("Number of results (default 5, max 50)."),
         sourceId: z
             .string()
             .optional()

package/dist/sse.js

@@ -1,6 +1,12 @@
+import { enforceMemoryCostPackageGuardAtStartup } from "@kynver-app/runtime/server/memory-cost-enforce";
 import { startKynverMcpSseServer } from "./lib/mcp-sse-server.js";
+import { readOwnPackageVersion } from "./lib/package-version.js";
 import { createAgentOsServer } from "./server.js";
 import { requestContext } from "./lib/kynver-client.js";
+await enforceMemoryCostPackageGuardAtStartup({
+    selfPackageName: "@kynver-app/mcp-agent-os",
+    selfVersion: readOwnPackageVersion(import.meta.url),
+});
 startKynverMcpSseServer({
     label: "Agentic OS server",
     defaultPort: 3101,

package/dist/tools/__tests__/tasks.plan-link.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/__tests__/tasks.plan-link.test.js

@@ -0,0 +1,65 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const postMock = vi.fn().mockResolvedValue({ task: { id: "task-1" }, created: true });
+vi.mock("../../lib/kynver-client.js", () => ({
+    get: vi.fn(),
+    post: (...args) => postMock(...args),
+    patch: vi.fn(),
+}));
+import { registerTaskTools } from "../tasks.js";
+describe("AgentTask MCP plan linkage", () => {
+    let createHandler;
+    let createSchema;
+    let updateSchema;
+    beforeEach(() => {
+        postMock.mockClear();
+        createHandler = undefined;
+        createSchema = undefined;
+        updateSchema = undefined;
+        registerTaskTools({
+            register: (name, _description, schema, cb) => {
+                if (name === "agent_os_task_create") {
+                    createSchema = schema;
+                    createHandler = cb;
+                }
+                if (name === "agent_os_task_update") {
+                    updateSchema = schema;
+                }
+            },
+            resolveToolSlug: async (slug) => slug ?? "ghost",
+            jsonResult: (data) => ({ content: [], structuredContent: data }),
+            compact: (source) => Object.fromEntries(Object.entries(source).filter(([, value]) => value !== undefined)),
+        });
+    });
+    it("exposes planId so harness tasks can satisfy lineage admission", async () => {
+        expect(createSchema).toHaveProperty("planId");
+        await createHandler({
+            title: "Milestone PR 1: Heavy eval harness",
+            executor: "harness",
+            planId: "plan-123",
+            idempotencyKey: "plan-123:m1",
+        });
+        expect(postMock).toHaveBeenCalledWith("/agent-os/ghost/tasks", {
+            title: "Milestone PR 1: Heavy eval harness",
+            executor: "harness",
+            planId: "plan-123",
+            idempotencyKey: "plan-123:m1",
+        });
+    });
+    it("exposes standaloneReason for explicitly unscoped harness tasks", async () => {
+        expect(createSchema).toHaveProperty("standaloneReason");
+        await createHandler({
+            title: "Operator-requested sandbox",
+            executor: "harness",
+            standaloneReason: "operator-requested sandbox task outside a plan",
+        });
+        expect(postMock).toHaveBeenCalledWith("/agent-os/ghost/tasks", {
+            title: "Operator-requested sandbox",
+            executor: "harness",
+            standaloneReason: "operator-requested sandbox task outside a plan",
+        });
+    });
+    it("exposes planId on update so existing tasks can be linked after creation", () => {
+        expect(updateSchema).toHaveProperty("planId");
+        expect(updateSchema).toHaveProperty("planStageId");
+    });
+});

package/dist/tools/tasks.js

@@ -82,9 +82,18 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
         parentTaskId: z.string().optional().describe("Parent task id when this is one of 2+ coordinated workers."),
         goalId: z.string().optional(),
         projectId: z.string().optional(),
+        planId: z
+            .string()
+            .optional()
+            .describe("AgentPlan id to link this task to; required for plan-scoped harness work."),
+        planStageId: z.string().optional().describe("Optional AgentPlan stage id for finer plan lineage."),
         personaSlug,
         scheduledFor,
         dependsOnTaskIds,
+        standaloneReason: z
+            .string()
+            .optional()
+            .describe("Required when intentionally creating an unscoped harness task without parentTaskId or planId; explain why it is standalone."),
         idempotencyKey: z.string().optional().describe("Dedupe key from the foreground turn. Strongly recommended."),
         requestId: z.string().optional().describe("Raw foreground request id; used as the dedupe key if idempotencyKey is absent."),
         slug: slugField,
@@ -132,6 +141,8 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
         parentTaskId: z.string().optional(),
         goalId: z.string().optional(),
         projectId: z.string().optional(),
+        planId: z.string().optional(),
+        planStageId: z.string().optional(),
         personaSlug,
         scheduledFor,
         dependsOnTaskIds,
@@ -211,4 +222,30 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
         const s = await resolveToolSlug(slug);
         return jsonResult(await post(`/agent-os/${s}/tasks/${taskId}/renew-lease`, compact(body)));
     });
+    const operatorPriorityLevel = z
+        .enum(["high", "critical"])
+        .optional()
+        .describe("Override dispatch level when expediting (default high). Separate from stored task priority — " +
+        "uses audited operatorPriority* fields, not priority inflation.");
+    register("agent_os_task_operator_priority", "Expedite a ready task to the front of the operator dispatch queue, or clear the override. " +
+        "Requires tasks:write. Set action=set with reason (12+ chars); action=clear to demote. " +
+        "Does not bypass blockers, dependencies, scheduledFor, Will/security gates, or lane filters — " +
+        "only reorders eligible dispatch candidates.", {
+        taskId: z.string(),
+        action: z
+            .enum(["set", "clear"])
+            .optional()
+            .describe("set = front-of-queue override (default). clear = remove override."),
+        reason: z
+            .string()
+            .optional()
+            .describe("Required for set — operator-authored reason (min 12 chars)."),
+        level: operatorPriorityLevel,
+        clearNote: z.string().optional().describe("Optional note when clearing the override."),
+        slug: slugField,
+    }, async (args) => {
+        const { slug, taskId, ...body } = args;
+        const s = await resolveToolSlug(slug);
+        return jsonResult(await post(`/agent-os/${s}/tasks/${taskId}/operator-priority`, compact(body)));
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynver-app/mcp-agent-os",
-  "version": "0.3.34",
+  "version": "0.3.36",
   "description": "Kynver Agentic OS MCP server — slug-keyed agent identity, goals, projects, sessions, and long-term memory",
   "type": "module",
   "bin": {
@@ -22,6 +22,7 @@
     "node": ">=18"
   },
   "dependencies": {
+    "@kynver-app/runtime": "^0.1.0",
     "@modelcontextprotocol/sdk": "^1.27.0",
     "zod": "^3.23.0"
   },