@ai-agent-forge/plugin-sdk 0.85.0

package/dist/session-lineage.js

@@ -0,0 +1,134 @@
+/**
+ * 会话头血缘读取公共面（D-075 S4 第三批）：`sessions/_agents/` 布局的 JSONL 会话
+ * 文件**只读首行头**的最小子集——按 `sessionId` 读会话头（`parentAgentSession` /
+ * `agentRole`）与沿父链上溯的祖先链。权威格式契约见
+ * docs/design/子代理会话与通信设计.md（D-060 S2 落盘格式）。
+ *
+ * 消费方：第一方 subagent 信箱（兄弟投递的血缘校验，@agent-forge/protocol）与
+ * subagent-delegate 的嵌套深度门（宿主）。两条纪律随宿主实现一并迁移：
+ * - **只读**：不创建任何目录/文件（区别于宿主写入侧的 `agentSessionsDir` mkdir 语义）；
+ * - **寻址安全**：`sessionId` 先过形状校验（UUID / `st:` 形态、无路径分隔符）再做
+ *   路径拼接，杜绝 `../` 逃逸；不存在/形状非法/无头行与"无权"同型返回 undefined。
+ *
+ * 纯 `node:fs`、确定性可测。
+ */
+import { closeSync, openSync, readdirSync, readSync, statSync } from "node:fs";
+import { join } from "node:path";
+/** 头行扫描字节上限（头行超出时按截断后的首行解析，解析失败即视为无头行）。 */
+const HEADER_SCAN_BYTES = 8192;
+/** 会话 id 形状：UUID（root/子会话）或池化 wire 任务 id（`st:` 前缀）。 */
+export function isAgentSessionId(value) {
+    if (value.length === 0 || value.length > 128)
+        return false;
+    if (value.startsWith("st:"))
+        return /^st:[0-9]+:[a-z0-9-]+$/i.test(value);
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value);
+}
+/** 子代理会话目录（纯路径拼接，不创建）：`<agentDir>/sessions/_agents/`。 */
+function agentSessionsDir(agentDir) {
+    return join(agentDir, "sessions", "_agents");
+}
+/** 目录内定位某会话文件：命名形如 `<时间戳>_<sessionId>.jsonl`（或裸 `<sessionId>.jsonl`）。 */
+export function findSessionFile(dir, sessionId) {
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return undefined;
+    }
+    const suffix = `_${sessionId}.jsonl`;
+    const match = names.find((name) => name === `${sessionId}.jsonl` || name.endsWith(suffix));
+    return match === undefined ? undefined : join(dir, match);
+}
+function parseHeader(line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed))
+            return undefined;
+        const record = parsed;
+        return record.type === "session" ? record : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 只读文件前 HEADER_SCAN_BYTES 字节取首行（大 transcript 不整读）。 */
+function readFirstLine(filePath) {
+    let handle;
+    try {
+        handle = openSync(filePath, "r");
+        const buffer = Buffer.alloc(HEADER_SCAN_BYTES);
+        const read = readSync(handle, buffer, 0, HEADER_SCAN_BYTES, 0);
+        if (read <= 0)
+            return undefined;
+        return buffer.toString("utf8", 0, read).split("\n", 1)[0] ?? "";
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        if (handle !== undefined)
+            closeSync(handle);
+    }
+}
+/**
+ * 按 `sessionId` 读会话头（只读首行，不解析消息体）。不存在/形状非法/无头行都返回
+ * undefined（与"无权"同型，不区分原因）。
+ */
+export function readAgentSessionHead(agentDir, sessionId) {
+    if (!isAgentSessionId(sessionId))
+        return undefined;
+    const filePath = findSessionFile(agentSessionsDir(agentDir), sessionId);
+    if (filePath === undefined)
+        return undefined;
+    let bytes;
+    let firstLine;
+    try {
+        bytes = statSync(filePath).size;
+        firstLine = readFirstLine(filePath);
+    }
+    catch {
+        return undefined;
+    }
+    if (firstLine === undefined)
+        return undefined;
+    const header = parseHeader(firstLine);
+    if (header === undefined)
+        return undefined;
+    const parentAgentSession = typeof header.parentAgentSession === "string" ? header.parentAgentSession : undefined;
+    const agentRole = typeof header.agentRole === "string" ? header.agentRole : undefined;
+    const createdAt = typeof header.timestamp === "string" ? header.timestamp : undefined;
+    return {
+        sessionId,
+        ...(parentAgentSession === undefined ? {} : { parentAgentSession }),
+        ...(agentRole === undefined ? {} : { agentRole }),
+        ...(createdAt === undefined ? {} : { createdAt }),
+        bytes,
+    };
+}
+/**
+ * 读 `sessionId` 的祖先链（有界上溯）：沿每级会话头的 `parentAgentSession` 上行，最多
+ * `maxDepth` 步。链在无父、自指（`parentAgentSession === sessionId`）或父 id 无落盘
+ * 文件处停止；走满步数仍有父则 `truncated: true`（损坏数据成环时按步数截断，不悬挂）。
+ */
+export function readAgentSessionLineage(agentDir, sessionId, maxDepth) {
+    const self = readAgentSessionHead(agentDir, sessionId);
+    if (self === undefined)
+        return { self: undefined, ancestors: [], truncated: false };
+    const ancestors = [];
+    let current = self;
+    for (let step = 0; step < maxDepth; step += 1) {
+        const parent = current.parentAgentSession;
+        if (parent === undefined || parent === current.sessionId) {
+            return { self, ancestors, truncated: false };
+        }
+        const head = readAgentSessionHead(agentDir, parent);
+        if (head === undefined)
+            return { self, ancestors, truncated: false };
+        ancestors.push(head);
+        current = head;
+    }
+    return { self, ancestors, truncated: true };
+}
+//# sourceMappingURL=session-lineage.js.map

package/dist/session-lineage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lineage.js","sourceRoot":"","sources":["../src/session-lineage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 会话头血缘读取公共面（D-075 S4 第三批）：`sessions/_agents/` 布局的 JSONL 会话\n * 文件**只读首行头**的最小子集——按 `sessionId` 读会话头（`parentAgentSession` /\n * `agentRole`）与沿父链上溯的祖先链。权威格式契约见\n * docs/design/子代理会话与通信设计.md（D-060 S2 落盘格式）。\n *\n * 消费方：第一方 subagent 信箱（兄弟投递的血缘校验，@agent-forge/protocol）与\n * subagent-delegate 的嵌套深度门（宿主）。两条纪律随宿主实现一并迁移：\n * - **只读**：不创建任何目录/文件（区别于宿主写入侧的 `agentSessionsDir` mkdir 语义）；\n * - **寻址安全**：`sessionId` 先过形状校验（UUID / `st:` 形态、无路径分隔符）再做\n *   路径拼接，杜绝 `../` 逃逸；不存在/形状非法/无头行与\"无权\"同型返回 undefined。\n *\n * 纯 `node:fs`、确定性可测。\n */\nimport { closeSync, openSync, readdirSync, readSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\n/** 头行扫描字节上限（头行超出时按截断后的首行解析，解析失败即视为无头行）。 */\nconst HEADER_SCAN_BYTES = 8192;\n\n/** 会话 id 形状：UUID（root/子会话）或池化 wire 任务 id（`st:` 前缀）。 */\nexport function isAgentSessionId(value: string): boolean {\n\tif (value.length === 0 || value.length > 128) return false;\n\tif (value.startsWith(\"st:\")) return /^st:[0-9]+:[a-z0-9-]+$/i.test(value);\n\treturn /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value);\n}\n\n/** 子代理会话目录（纯路径拼接，不创建）：`<agentDir>/sessions/_agents/`。 */\nfunction agentSessionsDir(agentDir: string): string {\n\treturn join(agentDir, \"sessions\", \"_agents\");\n}\n\n/** 目录内定位某会话文件：命名形如 `<时间戳>_<sessionId>.jsonl`（或裸 `<sessionId>.jsonl`）。 */\nexport function findSessionFile(dir: string, sessionId: string): string | undefined {\n\tlet names: string[];\n\ttry {\n\t\tnames = readdirSync(dir);\n\t} catch {\n\t\treturn undefined;\n\t}\n\tconst suffix = `_${sessionId}.jsonl`;\n\tconst match = names.find((name) => name === `${sessionId}.jsonl` || name.endsWith(suffix));\n\treturn match === undefined ? undefined : join(dir, match);\n}\n\n/** 会话头（首行 `type: \"session\"` JSON 的有界投影，不含消息正文）。 */\nexport interface AgentSessionHeadV1 {\n\treadonly sessionId: string;\n\t/** 血缘：父 agent 会话 id（子会话必有；缺失说明文件非 D-060 落盘产物）。 */\n\treadonly parentAgentSession?: string;\n\t/** 血缘：创建该会话的角色 id（审计用途，不是权限判据）。 */\n\treadonly agentRole?: string;\n\treadonly createdAt?: string;\n\t/** 整份 transcript 的字节数（不是头行的字节数）。 */\n\treadonly bytes: number;\n}\n\nfunction parseHeader(line: string): Record<string, unknown> | undefined {\n\ttry {\n\t\tconst parsed = JSON.parse(line) as unknown;\n\t\tif (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) return undefined;\n\t\tconst record = parsed as Record<string, unknown>;\n\t\treturn record.type === \"session\" ? record : undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\n/** 只读文件前 HEADER_SCAN_BYTES 字节取首行（大 transcript 不整读）。 */\nfunction readFirstLine(filePath: string): string | undefined {\n\tlet handle: number | undefined;\n\ttry {\n\t\thandle = openSync(filePath, \"r\");\n\t\tconst buffer = Buffer.alloc(HEADER_SCAN_BYTES);\n\t\tconst read = readSync(handle, buffer, 0, HEADER_SCAN_BYTES, 0);\n\t\tif (read <= 0) return undefined;\n\t\treturn buffer.toString(\"utf8\", 0, read).split(\"\\n\", 1)[0] ?? \"\";\n\t} catch {\n\t\treturn undefined;\n\t} finally {\n\t\tif (handle !== undefined) closeSync(handle);\n\t}\n}\n\n/**\n * 按 `sessionId` 读会话头（只读首行，不解析消息体）。不存在/形状非法/无头行都返回\n * undefined（与\"无权\"同型，不区分原因）。\n */\nexport function readAgentSessionHead(agentDir: string, sessionId: string): AgentSessionHeadV1 | undefined {\n\tif (!isAgentSessionId(sessionId)) return undefined;\n\tconst filePath = findSessionFile(agentSessionsDir(agentDir), sessionId);\n\tif (filePath === undefined) return undefined;\n\tlet bytes: number;\n\tlet firstLine: string | undefined;\n\ttry {\n\t\tbytes = statSync(filePath).size;\n\t\tfirstLine = readFirstLine(filePath);\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (firstLine === undefined) return undefined;\n\tconst header = parseHeader(firstLine);\n\tif (header === undefined) return undefined;\n\tconst parentAgentSession = typeof header.parentAgentSession === \"string\" ? header.parentAgentSession : undefined;\n\tconst agentRole = typeof header.agentRole === \"string\" ? header.agentRole : undefined;\n\tconst createdAt = typeof header.timestamp === \"string\" ? header.timestamp : undefined;\n\treturn {\n\t\tsessionId,\n\t\t...(parentAgentSession === undefined ? {} : { parentAgentSession }),\n\t\t...(agentRole === undefined ? {} : { agentRole }),\n\t\t...(createdAt === undefined ? {} : { createdAt }),\n\t\tbytes,\n\t};\n}\n\n/** 沿 `parentAgentSession` 上溯的祖先链读取结果。 */\nexport interface AgentSessionLineageV1 {\n\t/** 起点会话头；缺文件/缺头行/非法 id 时 undefined（root 或未落盘会话即此形态）。 */\n\treadonly self: AgentSessionHeadV1 | undefined;\n\t/** 祖先链（最近父在前），不含 self；链在无父/自指/缺文件处停止。 */\n\treadonly ancestors: readonly AgentSessionHeadV1[];\n\t/** 走满 `maxDepth` 步仍有可解析的父时为 true（有界截断；防环按步数，语义与宿主 lineageDepth 的 maxWalk 对齐）。 */\n\treadonly truncated: boolean;\n}\n\n/**\n * 读 `sessionId` 的祖先链（有界上溯）：沿每级会话头的 `parentAgentSession` 上行，最多\n * `maxDepth` 步。链在无父、自指（`parentAgentSession === sessionId`）或父 id 无落盘\n * 文件处停止；走满步数仍有父则 `truncated: true`（损坏数据成环时按步数截断，不悬挂）。\n */\nexport function readAgentSessionLineage(agentDir: string, sessionId: string, maxDepth: number): AgentSessionLineageV1 {\n\tconst self = readAgentSessionHead(agentDir, sessionId);\n\tif (self === undefined) return { self: undefined, ancestors: [], truncated: false };\n\tconst ancestors: AgentSessionHeadV1[] = [];\n\tlet current = self;\n\tfor (let step = 0; step < maxDepth; step += 1) {\n\t\tconst parent = current.parentAgentSession;\n\t\tif (parent === undefined || parent === current.sessionId) {\n\t\t\treturn { self, ancestors, truncated: false };\n\t\t}\n\t\tconst head = readAgentSessionHead(agentDir, parent);\n\t\tif (head === undefined) return { self, ancestors, truncated: false };\n\t\tancestors.push(head);\n\t\tcurrent = head;\n\t}\n\treturn { self, ancestors, truncated: true };\n}\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+	"name": "@ai-agent-forge/plugin-sdk",
+	"version": "0.85.0",
+	"description": "Shared plugin development contracts (artifact, operation, diff, render, context budget DTOs) for Agent Forge plugins",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./session-lineage": {
+			"types": "./dist/session-lineage.d.ts",
+			"import": "./dist/session-lineage.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.build.json",
+		"test": "vitest --run",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"keywords": [
+		"agent-forge",
+		"plugin",
+		"sdk",
+		"contracts"
+	],
+	"author": "Agent Forge contributors",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agent-forge/agent-forge.git",
+		"directory": "packages/plugin-sdk"
+	},
+	"bugs": {
+		"url": "https://github.com/agent-forge/agent-forge/issues"
+	},
+	"homepage": "https://github.com/agent-forge/agent-forge#readme",
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"dependencies": {
+		"semver": "7.8.0"
+	},
+	"devDependencies": {
+		"shx": "0.4.0",
+		"vitest": "4.1.9"
+	}
+}