npm - @argosvix/mcp-server - Versions diffs - 0.9.3-alpha.1 → 0.10.0-alpha.4 - Mend

@argosvix/mcp-server 0.9.3-alpha.1 → 0.10.0-alpha.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/README.md +19 -1
package/dist/index.js +19 -2
package/dist/index.js.map +1 -1
package/dist/subscriptions.d.ts +55 -0
package/dist/subscriptions.d.ts.map +1 -0
package/dist/subscriptions.js +219 -0
package/dist/subscriptions.js.map +1 -0
package/dist/subscriptions.test.d.ts +2 -0
package/dist/subscriptions.test.d.ts.map +1 -0
package/dist/subscriptions.test.js +344 -0
package/dist/subscriptions.test.js.map +1 -0
package/dist/version.d.ts +1 -1
package/dist/version.d.ts.map +1 -1
package/dist/version.js +1 -1
package/dist/version.js.map +1 -1
package/package.json +2 -2

package/README.md CHANGED Viewed

@@ -104,7 +104,25 @@ Prompts are reusable templates the user can launch as slash commands.
 | `alert_audit` | Audit current alert rules and propose improvements |
 | `incident_triage` | Investigate recent error / latency anomalies (default last 24h) |
-Phase 3 backlog (= not yet shipped): `subscribe` / `listChanged` (= MCP spec real-time update).
+## Subscriptions (= v0.10, stdio only)
+`resources.subscribe` capability is declared in stdio mode. Clients can subscribe to one or more of the static resources below; the server polls each subscribed resource every 60 seconds and emits `notifications/resources/updated` when the content hash changes.
+Subscribable URIs (resource templates such as `argosvix://calls/{id}` are **not** subscribable):
+- `argosvix://account`
+- `argosvix://alerts/active`
+- `argosvix://cost/today`
+HTTP transport (= `argosvix-mcp --http`) does not declare `subscribe` and rejects subscribe requests, since per-request stateless mode cannot keep a subscription set or deliver server-initiated notifications. Use stdio for live updates.
+`listChanged` is intentionally not declared: the resource list is fixed for the server lifetime.
+Implementation notes (v0.10):
+- Single-flight guard: a slow polling cycle does not start a concurrent next cycle (= no overlapping `readResource` calls).
+- Unsubscribe / shutdown race: per-URI re-check before fetch and before notify, plus an `isShuttingDown` flag, so notifications are not emitted for URIs removed mid-cycle.
+- Failure handling: fetch and notify failures are silent (next cycle retries). With `ARGOSVIX_MCP_DEBUG=1` the server logs `{ uri, errorClass }` to stderr — error messages are intentionally **not** logged to avoid leaking upstream payload text.
+- Tests: 110 unit tests (incl. overlap single-flight + unsubscribe / shutdown race + invalid URI → `McpError(InvalidParams)`).
 ## Privacy

package/dist/index.js CHANGED Viewed

@@ -53,6 +53,7 @@ else {
     const { tools, dispatchTool } = await import("./tools.js");
     const { resources, resourceTemplates, readResource, ResourceNotFoundError, } = await import("./resources.js");
     const { prompts, getPrompt, PromptNotFoundError } = await import("./prompts.js");
+    const { setupSubscribe } = await import("./subscriptions.js");
     const { MCP_VERSION } = await import("./version.js");
     const API_KEY = process.env["ARGOSVIX_API_KEY"];
     const API_BASE = process.env["ARGOSVIX_API_BASE"] ?? "https://ingest.argosvix.com";
@@ -69,7 +70,12 @@ else {
     }, {
         capabilities: {
             tools: {},
-            resources: {},
+            // v0.10.0-alpha.1 = stdio transport 限定で resources.subscribe を carry。
+            // polling 60 秒 で 3 static resources (= account / alerts/active /
+            // cost/today) の hash 比較で 変化検出 → notifications/resources/updated。
+            // HTTP transport (= packages/mcp-server/src/http.ts) では per-request
+            // stateless なので subscribe declare せず、 setupSubscribe も呼ばない。
+            resources: { subscribe: true },
             prompts: {},
         },
     });
@@ -127,10 +133,21 @@ else {
             throw new McpError(ErrorCode.InternalError, err instanceof Error ? err.message : String(err));
         }
     });
+    const subscribeManager = setupSubscribe({
+        server,
+        apiKey: API_KEY,
+        apiBase: API_BASE,
+    });
+    const handleShutdown = () => {
+        subscribeManager.shutdown();
+    };
+    process.on("SIGINT", handleShutdown);
+    process.on("SIGTERM", handleShutdown);
+    process.on("beforeExit", handleShutdown);
     const transport = new StdioServerTransport();
     await server.connect(transport);
     // eslint-disable-next-line no-console
-    console.error(`[argosvix-mcp] argosvix@${MCP_VERSION} ready on stdio transport`);
+    console.error(`[argosvix-mcp] argosvix@${MCP_VERSION} ready on stdio transport (subscribe: 3 resources, poll 60s)`);
 }
 export {};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,mEAAmE;AACnE,2BAA2B;AAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAExC,IAAI,OAAO,EAAE,CAAC;IACZ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,OAAO,EAAE,CAAC;AAClB,CAAC;KAAM,CAAC;IACN,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC7E,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,2CAA2C,CAC5C,CAAC;IACF,MAAM,EACJ,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,kCAAkC,EAClC,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,SAAS,EACT,QAAQ,GACT,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;IACvD,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC3D,MAAM,EACJ,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,GACtB,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACnC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAC9D,cAAc,CACf,CAAC;IACF,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;IAErD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChD,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,6BAA6B,CAAC;IAEpE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,sCAAsC;QACtC,OAAO,CAAC,KAAK,CACX,sEAAsE;YACpE,uDAAuD;YACvD,4DAA4D,CAC/D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,WAAW;KACrB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;~~YACb~~,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK;KACN,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,YAAY,CAAC;YAClB,IAAI;YACJ,IAAI,EAAE,IAAI,IAAI,EAAE;YAChB,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAChE,SAAS;KACV,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACxE,iBAAiB;KAClB,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpE,IAAI,CAAC;YACH,OAAO,MAAM,YAAY,CAAC;gBACxB,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG;gBACvB,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;gBACzC,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,OAAO,EAAE;oBACvD,GAAG,EAAE,GAAG,CAAC,GAAG;iBACb,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9D,OAAO;KACR,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,IAAI,CAAC;YACH,OAAO,SAAS,CAAC;gBACf,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;gBACzB,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAA4B;aAClE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;gBACvC,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,OAAO,EAAE;oBACvD,IAAI,EAAE,GAAG,CAAC,UAAU;iBACrB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,sCAAsC;IACtC,OAAO,CAAC,KAAK,CACX,2BAA2B,WAAW,~~2BAA2B~~,~~CAClE~~,CAAC;AACJ,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/subscriptions.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+/**
+ * MCP resources/subscribe 軽量 carry (= v0.10.0-alpha.1、 v0.8 backlog 倒し込み)。
+ *
+ * MCP spec の `resources.subscribe` capability を stdio transport で carry する。
+ * client が `resources/subscribe` で URI を 登録すると、 polling cycle で 当該
+ * resource の hash を 比較し、 変化を 検出した時に `notifications/resources/updated`
+ * を send する。
+ *
+ * 対応 URI (= 3 static resources のみ、 resource templates = calls/{id} 等は対象外):
+ *   - argosvix://account
+ *   - argosvix://alerts/active
+ *   - argosvix://cost/today
+ *
+ * 設計選択:
+ *   - polling = 60 秒 interval (= backend 負荷と更新遅延の妥協点)
+ *   - HTTP transport では setupSubscribe を call しない (= per-request stateless で
+ *     subscription state が 持てない、 capabilities でも subscribe 宣言なし)
+ *   - shutdown / 接続切断時 = polling timer stop + subscription set 全削除
+ *   - subscription set は 単一 server instance 単位 (= stdio = 1 client 1 process)
+ *   - fetch 失敗 (= 401 / network) は silent skip (= 次回 cycle で 再試行)、 hash は
+ *     前回値 keep (= 「fetch 不可 = 変化なし」 と扱い 不要 notify 抑制)
+ *   - hash = JSON.stringify + djb2-like rolling 32bit (= 軽量、 暗号目的ではない)
+ *
+ * Codex / 実装 backlog (= v0.10 では carry しない):
+ *   - resource templates の per-id subscribe (= calls/{id} 等、 LLM が個別 call の
+ *     更新を 監視する path)
+ *   - listChanged notification (= resource list 自体は server lifecycle 内 固定で 不要)
+ *   - WebSocket / SSE 経由の HTTP subscribe (= persistent connection 必要、 重い)
+ *   - polling interval の env-driven 設定 (= MCP_SUBSCRIBE_POLL_MS で override 可能化)
+ */
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+interface SubscribeContext {
+    server: Server;
+    apiKey: string;
+    apiBase: string;
+    /** test 用 override (= 60 秒は long すぎるため unit test では小さい値で carry)。 */
+    pollIntervalMs?: number;
+}
+export interface SubscribeManager {
+    subscribe(uri: string): void;
+    unsubscribe(uri: string): void;
+    /** shutdown / 切断時 = polling 停止 + subscription set クリア。 */
+    shutdown(): void;
+    /** test 用 = polling cycle を 1 回 即時 trigger する。 */
+    pollNow(): Promise<void>;
+    /** test 用 = 現 subscription set snapshot。 */
+    snapshot(): {
+        uris: string[];
+        pollerActive: boolean;
+    };
+}
+export declare function setupSubscribe(ctx: SubscribeContext): SubscribeManager;
+export declare const SUBSCRIBABLE_URIS_FOR_TEST: ReadonlySet<string>;
+export {};
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/subscriptions.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAkBxE,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAkBD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,IAAI,IAAI,CAAC;IACjB,kDAAkD;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;CACvD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,gBAAgB,CAuKtE;AAED,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAAqB,CAAC"}

package/dist/subscriptions.js ADDED Viewed

@@ -0,0 +1,219 @@
+/**
+ * MCP resources/subscribe 軽量 carry (= v0.10.0-alpha.1、 v0.8 backlog 倒し込み)。
+ *
+ * MCP spec の `resources.subscribe` capability を stdio transport で carry する。
+ * client が `resources/subscribe` で URI を 登録すると、 polling cycle で 当該
+ * resource の hash を 比較し、 変化を 検出した時に `notifications/resources/updated`
+ * を send する。
+ *
+ * 対応 URI (= 3 static resources のみ、 resource templates = calls/{id} 等は対象外):
+ *   - argosvix://account
+ *   - argosvix://alerts/active
+ *   - argosvix://cost/today
+ *
+ * 設計選択:
+ *   - polling = 60 秒 interval (= backend 負荷と更新遅延の妥協点)
+ *   - HTTP transport では setupSubscribe を call しない (= per-request stateless で
+ *     subscription state が 持てない、 capabilities でも subscribe 宣言なし)
+ *   - shutdown / 接続切断時 = polling timer stop + subscription set 全削除
+ *   - subscription set は 単一 server instance 単位 (= stdio = 1 client 1 process)
+ *   - fetch 失敗 (= 401 / network) は silent skip (= 次回 cycle で 再試行)、 hash は
+ *     前回値 keep (= 「fetch 不可 = 変化なし」 と扱い 不要 notify 抑制)
+ *   - hash = JSON.stringify + djb2-like rolling 32bit (= 軽量、 暗号目的ではない)
+ *
+ * Codex / 実装 backlog (= v0.10 では carry しない):
+ *   - resource templates の per-id subscribe (= calls/{id} 等、 LLM が個別 call の
+ *     更新を 監視する path)
+ *   - listChanged notification (= resource list 自体は server lifecycle 内 固定で 不要)
+ *   - WebSocket / SSE 経由の HTTP subscribe (= persistent connection 必要、 重い)
+ *   - polling interval の env-driven 設定 (= MCP_SUBSCRIBE_POLL_MS で override 可能化)
+ */
+import { ErrorCode, McpError, SubscribeRequestSchema, UnsubscribeRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { isDebugEnabled } from "./debug.js";
+import { readResource } from "./resources.js";
+const DEFAULT_POLL_INTERVAL_MS = 60 * 1000;
+const SUBSCRIBABLE_URIS = new Set([
+    "argosvix://account",
+    "argosvix://alerts/active",
+    "argosvix://cost/today",
+]);
+/**
+ * 軽量 32bit hash (= djb2 風)。 暗号目的ではなく、 等価判定の高速軸として carry。
+ * 衝突確率は内容比較で十分低いが、 重大判定 (= 課金 / 認証) には使わない。
+ */
+function hashString(s) {
+    let h = 5381;
+    for (let i = 0; i < s.length; i++) {
+        h = ((h << 5) + h + s.charCodeAt(i)) | 0;
+    }
+    return h >>> 0;
+}
+function resourceHash(contents) {
+    return hashString(JSON.stringify(contents));
+}
+export function setupSubscribe(ctx) {
+    const subscriptions = new Set();
+    const lastHashes = new Map();
+    const pollIntervalMs = ctx.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    let pollTimer = null;
+    // Codex round 1 HIGH 1 fix carry = single-flight guard。 setInterval は 前 cycle
+    // が終わっていなくても 次の cycle を 並列 起動するため、 遅い fetch 1 つ
+    // (= 5xx + 長 retry / 60 秒 超過 latency) で polling が overlap し、
+    // backend 負荷 spike + 重複 notification を 起こす。
+    let pollInFlight = false;
+    // Codex round 1 HIGH 2 fix carry = shutdown race 防御。 cycle 開始後に
+    // shutdown が来た場合、 残り URI に対する notify を 全 skip する。
+    let isShuttingDown = false;
+    async function pollOnce() {
+        if (pollInFlight)
+            return;
+        if (subscriptions.size === 0)
+            return;
+        pollInFlight = true;
+        try {
+            const uris = Array.from(subscriptions);
+            for (const uri of uris) {
+                // Codex round 1 HIGH 2 fix carry = cycle 内 unsubscribe / shutdown 検出。
+                // uris snapshot 取得後に unsubscribe された URI に対しては notify しない。
+                if (isShuttingDown)
+                    return;
+                if (!subscriptions.has(uri))
+                    continue;
+                let result;
+                try {
+                    result = await readResource({
+                        uri,
+                        apiKey: ctx.apiKey,
+                        apiBase: ctx.apiBase,
+                    });
+                }
+                catch (err) {
+                    // 401 / network / 5xx 等の 一時的 failure は silent skip (= 次回 cycle で
+                    // 再試行)。 hash 更新しない (= 「fetch 不可 = 変化なし」 扱いで 不要
+                    // notification 抑制)。 debug 時のみ stderr に carry。
+                    //
+                    // Codex round 2 LOW 3 fix carry = error.message は upstream の
+                    // response body / 内部実装文字列を含む可能性があるため、 default は
+                    // errorClass のみ log。 full message が必要な場合は別途 redact pattern
+                    // 軸で carry path (= 現状 carry なし)。
+                    if (isDebugEnabled()) {
+                        // eslint-disable-next-line no-console
+                        console.error(`[argosvix-mcp] subscribe poll fetch failed (silent skip)`, {
+                            uri,
+                            errorClass: err instanceof Error ? err.constructor.name : typeof err,
+                        });
+                    }
+                    continue;
+                }
+                if (isShuttingDown || !subscriptions.has(uri))
+                    continue;
+                const h = resourceHash(result.contents);
+                const prev = lastHashes.get(uri);
+                if (prev === undefined) {
+                    lastHashes.set(uri, h);
+                    continue;
+                }
+                if (prev !== h) {
+                    lastHashes.set(uri, h);
+                    try {
+                        await ctx.server.notification({
+                            method: "notifications/resources/updated",
+                            params: { uri },
+                        });
+                    }
+                    catch (err) {
+                        // notification 送信失敗 (= transport 切断 / 一時的 error) は silent
+                        // skip だが、 fetch 失敗と path を分けて log carry (= MEDIUM 2 fix、
+                        // operational blind spot 解消)。 次回 cycle で 変化検出すれば 再 notify
+                        // される。 LOW 3 fix carry = errorClass のみ log (= upstream message
+                        // 経由の情報漏洩 構造防御)。
+                        if (isDebugEnabled()) {
+                            // eslint-disable-next-line no-console
+                            console.error(`[argosvix-mcp] subscribe notify failed (silent skip)`, {
+                                uri,
+                                errorClass: err instanceof Error ? err.constructor.name : typeof err,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        finally {
+            pollInFlight = false;
+        }
+    }
+    function startPolling() {
+        if (pollTimer !== null)
+            return;
+        pollTimer = setInterval(() => {
+            void pollOnce();
+        }, pollIntervalMs);
+        // Node.js では setInterval の timer が default で event loop に登録される。
+        // unref で 「他に pending task が無くなれば process 終了可能」 にする
+        // (= shutdown 漏れ 防御)。 setInterval の戻り値型は Node では unref を
+        // 持つが TS 型では optional のため guard。
+        if (typeof pollTimer.unref === "function") {
+            pollTimer.unref();
+        }
+    }
+    function stopPolling() {
+        if (pollTimer === null)
+            return;
+        clearInterval(pollTimer);
+        pollTimer = null;
+    }
+    ctx.server.setRequestHandler(SubscribeRequestSchema, async (request) => {
+        const uri = request.params.uri;
+        if (!SUBSCRIBABLE_URIS.has(uri)) {
+            // Codex round 1 MEDIUM 1 fix carry = McpError(InvalidParams) で throw して
+            // client に正しい -32602 を返す (= 旧実装は raw Error で SDK が
+            // InternalError に変換、 InvalidParams semantic が落ちる)。
+            throw new McpError(ErrorCode.InvalidParams, `Resource ${uri} does not support subscriptions. Subscribable URIs: ${Array.from(SUBSCRIBABLE_URIS).join(", ")}`);
+        }
+        subscriptions.add(uri);
+        if (subscriptions.size === 1)
+            startPolling();
+        return {};
+    });
+    ctx.server.setRequestHandler(UnsubscribeRequestSchema, async (request) => {
+        const uri = request.params.uri;
+        subscriptions.delete(uri);
+        lastHashes.delete(uri);
+        if (subscriptions.size === 0)
+            stopPolling();
+        return {};
+    });
+    return {
+        subscribe(uri) {
+            if (!SUBSCRIBABLE_URIS.has(uri))
+                return;
+            subscriptions.add(uri);
+            if (subscriptions.size === 1)
+                startPolling();
+        },
+        unsubscribe(uri) {
+            subscriptions.delete(uri);
+            lastHashes.delete(uri);
+            if (subscriptions.size === 0)
+                stopPolling();
+        },
+        shutdown() {
+            // Codex round 1 HIGH 2 fix carry = in-flight cycle が ある 場合に
+            // notify suppress を 即時有効化。 stopPolling() 後の cycle 内 残 URI
+            // への notify を 構造防御。
+            isShuttingDown = true;
+            stopPolling();
+            subscriptions.clear();
+            lastHashes.clear();
+        },
+        pollNow: pollOnce,
+        snapshot() {
+            return {
+                uris: Array.from(subscriptions),
+                pollerActive: pollTimer !== null,
+            };
+        },
+    };
+}
+export const SUBSCRIBABLE_URIS_FOR_TEST = SUBSCRIBABLE_URIS;
+//# sourceMappingURL=subscriptions.js.map

package/dist/subscriptions.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"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"}

package/dist/subscriptions.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=subscriptions.test.d.ts.map

package/dist/subscriptions.test.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"subscriptions.test.d.ts","sourceRoot":"","sources":["../src/subscriptions.test.ts"],"names":[],"mappings":""}

package/dist/subscriptions.test.js ADDED Viewed

@@ -0,0 +1,344 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { ErrorCode, McpError, SubscribeRequestSchema, UnsubscribeRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { setupSubscribe, SUBSCRIBABLE_URIS_FOR_TEST, } from "./subscriptions.js";
+/**
+ * resources.subscribe 軽量 carry の regression 防御。
+ *
+ * stub server で setRequestHandler / notification の call を capture して、
+ * subscribe → polling → 変化検出 → notification の flow を 確認する。
+ * 実 polling は 60 秒 interval = unit test では pollNow() で 1 cycle を 即時
+ * trigger する。
+ */
+const ALLOWED_URI = "argosvix://account";
+const DISALLOWED_URI = "argosvix://calls/abc123";
+function createStubServer() {
+    const handlers = new Map();
+    return {
+        handlers,
+        setRequestHandler: vi.fn((schema, handler) => {
+            handlers.set(schema, handler);
+        }),
+        notification: vi.fn(async () => undefined),
+    };
+}
+describe("setupSubscribe", () => {
+    // CI tsc は vi.spyOn(globalThis, "fetch") の MockInstance<fetch overloads> と
+    // generic default の MockInstance<(this: unknown, ...args: unknown[]) => unknown>
+    // が assignment 不可。 typed alias 経路は globalThis の prop key narrow で別 fail
+    // のため、 test スコープ限定で any cast で carry (= 型安全性 loss は test
+    // isolation 内に閉じる)。
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let stubFetch;
+    beforeEach(() => {
+        // global fetch を stub。 1 回目 = {value: 1}、 2 回目 = {value: 2} で 変化検出を
+        // simulate。 readResource は /v1/account を 内部 で fetch する。
+        let callCount = 0;
+        stubFetch = vi
+            .spyOn(globalThis, "fetch")
+            .mockImplementation(async () => {
+            callCount += 1;
+            const payload = {
+                account: {
+                    id: "acc_test",
+                    plan: "free",
+                    retentionDays: 7,
+                    createdAt: "2026-05-31T00:00:00.000Z",
+                },
+                usage: {
+                    recordsThisMonth: callCount,
+                    quotaRecordsPerMonth: 10000,
+                    yearMonth: "2026-05",
+                },
+            };
+            return new Response(JSON.stringify(payload), {
+                status: 200,
+                headers: { "Content-Type": "application/json" },
+            });
+        });
+    });
+    afterEach(() => {
+        stubFetch.mockRestore();
+    });
+    it("subscribable URI を 列挙する", () => {
+        expect(SUBSCRIBABLE_URIS_FOR_TEST.has("argosvix://account")).toBe(true);
+        expect(SUBSCRIBABLE_URIS_FOR_TEST.has("argosvix://alerts/active")).toBe(true);
+        expect(SUBSCRIBABLE_URIS_FOR_TEST.has("argosvix://cost/today")).toBe(true);
+    });
+    it("subscribe → polling 1 cycle で hash 確立、 2 cycle 目で変化 detect → notification", async () => {
+        const server = createStubServer();
+        const mgr = setupSubscribe({
+            server: server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        mgr.subscribe(ALLOWED_URI);
+        expect(mgr.snapshot().uris).toEqual([ALLOWED_URI]);
+        expect(mgr.snapshot().pollerActive).toBe(true);
+        // 1 cycle = baseline hash 確立 = notification なし
+        await mgr.pollNow();
+        expect(server.notification).not.toHaveBeenCalled();
+        // 2 cycle = recordsThisMonth が 2 に増えて hash 変化 = notification 1 回
+        await mgr.pollNow();
+        expect(server.notification).toHaveBeenCalledTimes(1);
+        expect(server.notification.mock.calls[0]?.[0]).toEqual({
+            method: "notifications/resources/updated",
+            params: { uri: ALLOWED_URI },
+        });
+        mgr.shutdown();
+    });
+    it("unsubscribe で polling 停止 + 後続 cycle で notification なし", async () => {
+        const server = createStubServer();
+        const mgr = setupSubscribe({
+            server: server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        mgr.subscribe(ALLOWED_URI);
+        await mgr.pollNow();
+        mgr.unsubscribe(ALLOWED_URI);
+        expect(mgr.snapshot().uris).toEqual([]);
+        expect(mgr.snapshot().pollerActive).toBe(false);
+        await mgr.pollNow();
+        expect(server.notification).not.toHaveBeenCalled();
+        mgr.shutdown();
+    });
+    it("非 subscribable URI は subscribe で silent skip (= 公開 API)", () => {
+        const server = createStubServer();
+        const mgr = setupSubscribe({
+            server: server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        mgr.subscribe(DISALLOWED_URI);
+        expect(mgr.snapshot().uris).toEqual([]);
+        mgr.shutdown();
+    });
+    it("非 subscribable URI を MCP request 経由で subscribe = McpError InvalidParams で throw", async () => {
+        const server = createStubServer();
+        setupSubscribe({
+            server: server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        // Codex round 1 MEDIUM 4 fix carry = schema identity で handler を取得 (=
+        // 旧設計は Array index 0 だったため registration 順序変化で fragile)。
+        const subscribeHandler = server.handlers.get(SubscribeRequestSchema);
+        expect(subscribeHandler).toBeDefined();
+        let caught = null;
+        try {
+            await subscribeHandler?.({ params: { uri: DISALLOWED_URI } });
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(McpError);
+        expect(caught.code).toBe(ErrorCode.InvalidParams);
+        expect(caught.message).toMatch(/does not support subscriptions/);
+    });
+    it("unsubscribe が cycle 中の URI に対する notify を抑制", async () => {
+        const server = createStubServer();
+        const mgr = setupSubscribe({
+            server: server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        mgr.subscribe(ALLOWED_URI);
+        await mgr.pollNow(); // baseline 確立
+        // 2 cycle 中で fetch 完了直前 (= 直後の re-check 直前) に unsubscribe シナリオは
+        // 実機では race だが、 unsubscribe を pollNow の 前に 呼んで 直後 cycle で
+        // notification 抑制を 確認 (= 「unsubscribe 後 cycle で notify 0」)。
+        mgr.unsubscribe(ALLOWED_URI);
+        await mgr.pollNow();
+        expect(server.notification).not.toHaveBeenCalled();
+        mgr.shutdown();
+    });
+    it("shutdown 後の polling は notify を抑制", async () => {
+        const server = createStubServer();
+        const mgr = setupSubscribe({
+            server: server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        mgr.subscribe(ALLOWED_URI);
+        await mgr.pollNow();
+        mgr.shutdown();
+        await mgr.pollNow(); // shutdown 後の cycle = 0 notify
+        expect(server.notification).not.toHaveBeenCalled();
+    });
+    it("setRequestHandler は SubscribeRequestSchema + UnsubscribeRequestSchema を登録 (= identity 軸 verify)", () => {
+        const server = createStubServer();
+        setupSubscribe({
+            server: server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        expect(server.handlers.has(SubscribeRequestSchema)).toBe(true);
+        expect(server.handlers.has(UnsubscribeRequestSchema)).toBe(true);
+    });
+    // Codex round 2 LOW 1 fix carry = overlap single-flight 検証。 deferred promise
+    // で fetch を block して、 並列 pollNow() を 2 回 trigger、 1 つ目だけ fetch
+    // 開始 + 2 つ目は即 return を 確認。 fetch 解放後に 3 回目 pollNow() が 通常
+    // 動作するか までを 1 sequence で verify。
+    it("polling overlap = single-flight guard で 2 回目 cycle skip + 解放後の 3 回目は通常 carry", async () => {
+        stubFetch.mockRestore();
+        let fetchEntered = 0;
+        let releaseFetch = () => {
+            /* placeholder replaced by Promise constructor below */
+        };
+        const fetchGate = new Promise((resolve) => {
+            releaseFetch = resolve;
+        });
+        stubFetch = vi
+            .spyOn(globalThis, "fetch")
+            .mockImplementation(async () => {
+            fetchEntered += 1;
+            await fetchGate;
+            return new Response(JSON.stringify({
+                account: {
+                    id: "acc_test",
+                    plan: "free",
+                    retentionDays: 7,
+                    createdAt: "2026-05-31T00:00:00.000Z",
+                },
+                usage: {
+                    recordsThisMonth: fetchEntered,
+                    quotaRecordsPerMonth: 10000,
+                    yearMonth: "2026-05",
+                },
+            }), { status: 200, headers: { "Content-Type": "application/json" } });
+        });
+        const server = createStubServer();
+        const mgr = setupSubscribe({
+            server: server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        mgr.subscribe(ALLOWED_URI);
+        // 並列に 2 回 trigger、 1 つ目だけ fetch entry。 2 つ目は pollInFlight ガード
+        // で 即 return。
+        const p1 = mgr.pollNow();
+        const p2 = mgr.pollNow();
+        // microtask だけ進めて fetchEntered を確認 (= まだ 解放してない = 1 のまま)
+        await Promise.resolve();
+        await Promise.resolve();
+        expect(fetchEntered).toBe(1);
+        // fetch 解放、 1 cycle 完了
+        releaseFetch();
+        await p1;
+        await p2;
+        // 3 回目 pollNow() は guard 解除済 + cycle 通常 carry
+        await mgr.pollNow();
+        expect(fetchEntered).toBe(2);
+        mgr.shutdown();
+    });
+    it("shutdown で subscription set クリア + polling 停止", () => {
+        const server = createStubServer();
+        const mgr = setupSubscribe({
+            server: server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        mgr.subscribe(ALLOWED_URI);
+        expect(mgr.snapshot().pollerActive).toBe(true);
+        mgr.shutdown();
+        expect(mgr.snapshot().uris).toEqual([]);
+        expect(mgr.snapshot().pollerActive).toBe(false);
+    });
+    it("fetch 失敗時 (= network error) は silent skip + hash 更新なし", async () => {
+        // beforeEach の stubFetch を 直接 mockImplementation で override (= 再 assign
+        // を避けて vi.spyOn の type 不整合 を 構造防御)。 afterEach の mockRestore で
+        // baseline (= success path) に戻る。
+        stubFetch.mockImplementation(async () => {
+            throw new Error("network error");
+        });
+        const server = createStubServer();
+        const mgr = setupSubscribe({
+            server: server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        mgr.subscribe(ALLOWED_URI);
+        await mgr.pollNow();
+        await mgr.pollNow();
+        expect(server.notification).not.toHaveBeenCalled();
+        mgr.shutdown();
+    });
+});
+// ============================================================
+// Codex round 2 LOW 2 fix carry = wire-level JSON-RPC -32602 mapping verify。
+// 既存 test は McpError instance + code で 検査していたが、 SDK protocol が
+// 実際に JSON-RPC error response の `error.code = -32602` を carry するか は
+// in-memory transport pair の wire 経由で 確認しないと regression を捕捉できない。
+// ============================================================
+describe("subscribe wire-level error mapping (= JSON-RPC -32602)", () => {
+    it("非 subscribable URI は wire error.code = -32602 で reject", async () => {
+        const { Server } = await import("@modelcontextprotocol/sdk/server/index.js");
+        const { Client } = await import("@modelcontextprotocol/sdk/client/index.js");
+        const { InMemoryTransport } = await import("@modelcontextprotocol/sdk/inMemory.js");
+        const { EmptyResultSchema } = await import("@modelcontextprotocol/sdk/types.js");
+        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+        const server = new Server({ name: "argosvix-test", version: "0.0.0-test" }, { capabilities: { resources: { subscribe: true } } });
+        setupSubscribe({
+            server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        await server.connect(serverTransport);
+        const client = new Client({ name: "argosvix-wire-test-client", version: "0.0.0-test" }, { capabilities: {} });
+        await client.connect(clientTransport);
+        let caught = null;
+        try {
+            await client.request({
+                method: "resources/subscribe",
+                params: { uri: "argosvix://calls/abc123" },
+            }, EmptyResultSchema);
+        }
+        catch (err) {
+            caught = err;
+        }
+        expect(caught).toBeInstanceOf(McpError);
+        expect(caught.code).toBe(ErrorCode.InvalidParams);
+        // ErrorCode.InvalidParams は JSON-RPC spec の -32602 と一致 (= SDK が
+        // McpError.code を そのまま wire error.code に carry する)。
+        expect(ErrorCode.InvalidParams).toBe(-32602);
+        expect(caught.message).toMatch(/does not support subscriptions/);
+        await client.close();
+        await server.close();
+    });
+    it("subscribable URI は wire 経由でも accept + {} return", async () => {
+        const { Server } = await import("@modelcontextprotocol/sdk/server/index.js");
+        const { Client } = await import("@modelcontextprotocol/sdk/client/index.js");
+        const { InMemoryTransport } = await import("@modelcontextprotocol/sdk/inMemory.js");
+        const { EmptyResultSchema } = await import("@modelcontextprotocol/sdk/types.js");
+        const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+        const server = new Server({ name: "argosvix-test", version: "0.0.0-test" }, { capabilities: { resources: { subscribe: true } } });
+        setupSubscribe({
+            server,
+            apiKey: "argk_test",
+            apiBase: "https://ingest.test",
+            pollIntervalMs: 60_000,
+        });
+        await server.connect(serverTransport);
+        const client = new Client({ name: "argosvix-wire-test-client", version: "0.0.0-test" }, { capabilities: {} });
+        await client.connect(clientTransport);
+        const result = await client.request({
+            method: "resources/subscribe",
+            params: { uri: "argosvix://account" },
+        }, EmptyResultSchema);
+        expect(result).toEqual({});
+        await client.close();
+        await server.close();
+    });
+});
+//# sourceMappingURL=subscriptions.test.js.map

package/dist/subscriptions.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"subscriptions.test.js","sourceRoot":"","sources":["../src/subscriptions.test.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts CHANGED Viewed

@@ -11,5 +11,5 @@
  *   2. packages/mcp-server/package.json の `version` も同 値に更新
  *   3. `npm run build && npx vitest run` を pass させてから commit
  */
-export declare const MCP_VERSION: "0.9.3-alpha.1";
+export declare const MCP_VERSION: "0.10.0-alpha.4";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,WAAW,EAAG,~~eAAwB~~,CAAC"}
1	+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,WAAW,EAAG,gBAAyB,CAAC"}

package/dist/version.js CHANGED Viewed

@@ -11,5 +11,5 @@
  *   2. packages/mcp-server/package.json の `version` も同 値に更新
  *   3. `npm run build && npx vitest run` を pass させてから commit
  */
-export const MCP_VERSION = "0.9.3-alpha.1";
+export const MCP_VERSION = "0.10.0-alpha.4";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,~~eAAwB~~,CAAC"}
1	+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAyB,CAAC"}

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@argosvix/mcp-server",
-  "version": "0.9.3-alpha.1",
-  "description": "Argosvix MCP server — AI agent から traces / cost / alert を直接 query / 監査 / 受領するための Model Context Protocol server (stdio + HTTP transport、 tools 9 件 / resources 3 件 + template 3 件 / prompts 3 件).",
+  "version": "0.10.0-alpha.4",
+  "description": "Argosvix MCP server — AI agent から traces / cost / alert を直接 query / 監査 / 受領するための Model Context Protocol server (stdio + HTTP transport、 tools 9 件 / resources 3 件 + template 3 件 / prompts 3 件、 stdio で resources subscribe + polling 60s 更新通知).",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",