@agentoryhq/node 0.1.1

package/dist/probe.js

@@ -0,0 +1,86 @@
+import { worstMcpStatus } from "@agentoryhq/shared";
+const DEFAULT_TIMEOUT_MS = 50;
+/**
+ * Binding-level health probe (slice 3 / AC-2).
+ * Simulation hooks in command string for tests: invalid / ENOENT / timeout-sim / degraded.
+ * Optional real HTTP(S) fetch when command looks like a URL and AGENTORY_MCP_HTTP_PROBE=1.
+ */
+export async function probeMcpBinding(input, opts) {
+    const { name, command } = input;
+    if (!command || !command.trim()) {
+        return { name, status: "unknown", reason: "no command configured" };
+    }
+    const cmd = command.trim();
+    if (/ENOENT|invalid|bad-url|does-not-exist/i.test(cmd)) {
+        return {
+            name,
+            command: cmd,
+            status: "failed",
+            reason: readableFail(cmd),
+        };
+    }
+    if (/timeout-sim/i.test(cmd)) {
+        return {
+            name,
+            command: cmd,
+            status: "failed",
+            reason: `probe timeout after ${opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS}ms`,
+        };
+    }
+    if (/degraded/i.test(cmd)) {
+        return {
+            name,
+            command: cmd,
+            status: "degraded",
+            reason: "probe succeeded with warnings (simulated)",
+        };
+    }
+    const urlMatch = cmd.match(/https?:\/\/[^\s]+/i);
+    if (urlMatch && process.env.AGENTORY_MCP_HTTP_PROBE === "1") {
+        const fetchFn = opts?.fetchImpl ?? fetch;
+        const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        try {
+            const ctrl = new AbortController();
+            const t = setTimeout(() => ctrl.abort(), timeoutMs);
+            const res = await fetchFn(urlMatch[0], { method: "GET", signal: ctrl.signal });
+            clearTimeout(t);
+            if (!res.ok) {
+                return {
+                    name,
+                    command: cmd,
+                    status: "failed",
+                    reason: `HTTP ${res.status} from ${urlMatch[0]}`,
+                };
+            }
+            return { name, command: cmd, status: "healthy" };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                name,
+                command: cmd,
+                status: "failed",
+                reason: msg.includes("abort")
+                    ? `probe timeout after ${timeoutMs}ms`
+                    : `probe error: ${msg}`,
+            };
+        }
+    }
+    // Config present and no failure signal → healthy for MVP.
+    return { name, command: cmd, status: "healthy" };
+}
+function readableFail(cmd) {
+    if (/ENOENT/i.test(cmd)) {
+        const pathMatch = cmd.match(/\/[^\s]+/);
+        return pathMatch ? `ENOENT ${pathMatch[0]}` : "ENOENT path missing";
+    }
+    if (/bad-url|invalid/i.test(cmd))
+        return `invalid endpoint in command: ${cmd.slice(0, 80)}`;
+    return `probe failed for ${cmd.slice(0, 80)}`;
+}
+export async function probeAll(bindings, opts) {
+    return Promise.all(bindings.map((b) => probeMcpBinding(b, opts)));
+}
+export function worstStatus(statuses) {
+    return worstMcpStatus(statuses);
+}

package/dist/probe.test.d.ts

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

package/dist/probe.test.js

@@ -0,0 +1,37 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import { probeAll, probeMcpBinding, worstStatus } from "./probe.js";
+test("probe marks missing command unknown", async () => {
+    const r = await probeMcpBinding({ name: "empty" });
+    assert.equal(r.status, "unknown");
+    assert.match(r.reason ?? "", /no command/i);
+});
+test("probe simulates failed invalid / ENOENT / timeout", async () => {
+    const bad = await probeMcpBinding({ name: "bad", command: "npx invalid bad-url" });
+    assert.equal(bad.status, "failed");
+    assert.ok(bad.reason && bad.reason.length > 0);
+    const enoent = await probeMcpBinding({
+        name: "gone",
+        command: "ENOENT /usr/bin/missing-mcp",
+    });
+    assert.equal(enoent.status, "failed");
+    assert.match(enoent.reason ?? "", /ENOENT/);
+    const timed = await probeMcpBinding({ name: "slow", command: "timeout-sim http://127.0.0.1:9" }, { timeoutMs: 25 });
+    assert.equal(timed.status, "failed");
+    assert.match(timed.reason ?? "", /timeout/i);
+});
+test("probe healthy and degraded", async () => {
+    const ok = await probeMcpBinding({ name: "gh", command: "npx -y @modelcontextprotocol/server" });
+    assert.equal(ok.status, "healthy");
+    const deg = await probeMcpBinding({ name: "warn", command: "degraded npx server" });
+    assert.equal(deg.status, "degraded");
+    assert.ok(deg.reason);
+});
+test("probeAll + worstStatus", async () => {
+    const all = await probeAll([
+        { name: "a", command: "npx ok" },
+        { name: "b", command: "invalid endpoint" },
+    ]);
+    assert.equal(all.length, 2);
+    assert.equal(worstStatus(all.map((b) => b.status)), "failed");
+});

package/dist/registry.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeAdapter } from "@agentoryhq/runtime-contract";
+/** Built-in adapters shipped with agentory-node (仓内 adapters/*). */
+export declare const builtinAdapters: readonly RuntimeAdapter[];
+export declare function adapterForRuntime(runtime: string): RuntimeAdapter | undefined;

package/dist/registry.js

@@ -0,0 +1,7 @@
+import { claudeCodeAdapter } from "@agentoryhq/adapter-claude-code";
+import { cursorAdapter } from "@agentoryhq/adapter-cursor";
+/** Built-in adapters shipped with agentory-node (仓内 adapters/*). */
+export const builtinAdapters = [cursorAdapter, claudeCodeAdapter];
+export function adapterForRuntime(runtime) {
+    return builtinAdapters.find((a) => a.manifest.runtime === runtime);
+}

package/dist/transcript.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Host re-exports Cursor transcript capture (adapter owns paths / masking).
+ */
+export { TRANSCRIPT_MESSAGE_MAX_CHARS, TRANSCRIPT_WINDOW_MESSAGES, captureTranscriptSnapshot, maskSecrets, transcriptFileForSourceKey, } from "@agentoryhq/adapter-cursor";
+export type TranscriptFetchOpts = {
+    homeDir?: string;
+};

package/dist/transcript.js

@@ -0,0 +1,4 @@
+/**
+ * Host re-exports Cursor transcript capture (adapter owns paths / masking).
+ */
+export { TRANSCRIPT_MESSAGE_MAX_CHARS, TRANSCRIPT_WINDOW_MESSAGES, captureTranscriptSnapshot, maskSecrets, transcriptFileForSourceKey, } from "@agentoryhq/adapter-cursor";

package/dist/transcript.test.d.ts

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

package/dist/transcript.test.js

@@ -0,0 +1,121 @@
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { test } from "node:test";
+import { TRANSCRIPT_MESSAGE_MAX_CHARS, TRANSCRIPT_WINDOW_MESSAGES, captureTranscriptSnapshot, maskSecrets, transcriptFileForSourceKey, } from "./transcript.js";
+function makeHome() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), "agentory-tr-"));
+}
+function writeJsonl(home, rel, rows) {
+    const file = path.join(home, ".cursor", "projects", rel);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, rows.map((r) => JSON.stringify(r)).join("\n"));
+    return file;
+}
+test("maskSecrets masks common token shapes (AC-3)", () => {
+    const cases = [
+        ["sk-abcdef0123456789abcdef", "sk-••••••••"],
+        ["ghp_0123456789abcdefghijklmnopqrstuvwxyz", "ghp_••••••••"],
+        ["xoxb-0123456789abcdefGHI", "xox•-••••••••"],
+    ];
+    for (const [raw, masked] of cases) {
+        assert.equal(maskSecrets(raw).includes(masked), true);
+        assert.equal(maskSecrets(raw).includes(raw), false);
+    }
+    const kv = maskSecrets("deploy with password=hunter2-secret now");
+    assert.equal(kv.includes("hunter2"), false);
+    // 普通文本不受影响
+    assert.equal(maskSecrets("fix the login bug please"), "fix the login bug please");
+});
+test("maskSecrets masks long hex / base64 blobs", () => {
+    const hex = "a".repeat(48);
+    const b64 = "AbcD" + "e6Fg7H" + "a9b8c7d6e5f4g3h2i1j0k9l8m7n6o5p4q3r2s1"; // ≥40 随机形态
+    for (const raw of [hex, b64]) {
+        const out = maskSecrets(raw);
+        assert.equal(out.includes(raw), false, `leaked: ${raw}`);
+    }
+});
+test("captureTranscriptSnapshot parses jsonl, caps long messages, masks secrets", () => {
+    const home = makeHome();
+    try {
+        const long = "x".repeat(TRANSCRIPT_MESSAGE_MAX_CHARS + 500);
+        const file = writeJsonl(home, "Users-dev-work-app/agent-transcripts/id1/id1.jsonl", [
+            { role: "user", message: { content: [{ type: "text", text: "Fix login with sk-abcdef0123456789abcdef" }] }, ts: "2026-09-24T10:00:00.000Z" },
+            { role: "assistant", message: { content: [{ type: "text", text: long }] }, ts: "2026-09-24T10:00:05.000Z" },
+            { role: "tool", message: { content: [{ type: "text", text: "ignored role" }] } },
+            "not-json",
+            { role: "user", message: { content: [{ type: "text", text: "<timestamp>x</timestamp>hi <user_query>there" }] }, ts: "2026-09-24T10:01:00.000Z" },
+        ]);
+        const snap = captureTranscriptSnapshot(file, new Date("2026-09-24T12:00:00.000Z"));
+        assert.ok(snap);
+        assert.equal(snap.sourceKey, `cursor-transcript:${file}`);
+        assert.equal(snap.messages.length, 3);
+        assert.equal(snap.messages[0].role, "user");
+        assert.equal(snap.messages[0].text.includes("sk-abcdef"), false);
+        assert.ok(snap.messages[0].text.includes("sk-••••••••"));
+        assert.ok(snap.messages[1].text.length <= TRANSCRIPT_MESSAGE_MAX_CHARS + 1);
+        assert.ok(snap.messages[1].text.endsWith("…"));
+        // timestamp 标签被清理
+        assert.ok(!snap.messages[2].text.includes("timestamp"));
+        assert.equal(snap.messages[2].text, "hi there");
+        assert.equal(snap.truncated, false);
+        assert.equal(snap.capturedAt, "2026-09-24T12:00:00.000Z");
+    }
+    finally {
+        fs.rmSync(home, { recursive: true, force: true });
+    }
+});
+test("captureTranscriptSnapshot keeps near-end window and sets truncated (AC-4)", () => {
+    const home = makeHome();
+    try {
+        const rows = Array.from({ length: TRANSCRIPT_WINDOW_MESSAGES + 27 }, (_, i) => ({
+            role: "user",
+            message: `msg-${i}`,
+        }));
+        const file = writeJsonl(home, "p/agent-transcripts/id2/id2.jsonl", rows);
+        const snap = captureTranscriptSnapshot(file);
+        assert.ok(snap);
+        assert.equal(snap.messages.length, TRANSCRIPT_WINDOW_MESSAGES);
+        assert.equal(snap.truncated, true);
+        assert.ok(snap.windowTotal);
+        assert.match(snap.windowTotal, new RegExp(`${TRANSCRIPT_WINDOW_MESSAGES} / ${rows.length}`));
+        // 近端：窗口第一条是倒数第 40 条
+        assert.equal(snap.messages[0].text, `msg-${rows.length - TRANSCRIPT_WINDOW_MESSAGES}`);
+    }
+    finally {
+        fs.rmSync(home, { recursive: true, force: true });
+    }
+});
+test("captureTranscriptSnapshot empty / missing files (AC-1 空态)", () => {
+    const home = makeHome();
+    try {
+        const file = writeJsonl(home, "p/agent-transcripts/id3/id3.jsonl", [
+            { role: "tool", message: "no user/assistant rows" },
+        ]);
+        const empty = captureTranscriptSnapshot(file);
+        assert.ok(empty);
+        assert.deepEqual(empty.messages, []);
+        const missing = captureTranscriptSnapshot(path.join(home, "nope.jsonl"));
+        assert.equal(missing, undefined);
+    }
+    finally {
+        fs.rmSync(home, { recursive: true, force: true });
+    }
+});
+test("transcriptFileForSourceKey enforces ~/.cursor/projects containment (invariants §4)", () => {
+    const home = makeHome();
+    try {
+        const inside = path.join(home, ".cursor", "projects", "slug", "agent-transcripts", "id", "id.jsonl");
+        assert.equal(transcriptFileForSourceKey(`cursor-transcript:${inside}`, home), inside);
+        // 逃逸出 projects 根 → 拒绝
+        const outside = path.join(home, ".ssh", "id_ed25519");
+        assert.equal(transcriptFileForSourceKey(`cursor-transcript:${outside}`, home), undefined);
+        // 其他前缀 / 非路径
+        assert.equal(transcriptFileForSourceKey(`cursor-session:${inside}`, home), undefined);
+        assert.equal(transcriptFileForSourceKey("cursor-transcript:", home), undefined);
+    }
+    finally {
+        fs.rmSync(home, { recursive: true, force: true });
+    }
+});

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@agentoryhq/node",
+  "version": "0.1.1",
+  "description": "Agentory Node CLI — register, discover, align, daemon",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "agentory-node": "./dist/cli.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/cli.js"
+  },
+  "dependencies": {
+    "@agentoryhq/adapter-claude-code": "*",
+    "@agentoryhq/adapter-cursor": "*",
+    "@agentoryhq/runtime-contract": "*",
+    "@agentoryhq/shared": "*"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tunsuy/agentory-node.git",
+    "directory": "apps/node"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}