@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/SessionArtifacts.js

@@ -0,0 +1,141 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { join, relative, resolve } from 'path';
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+import { getSessionScopePaths } from './utils.js';
+const SessionArtifactsSchema = z.object({
+    action: z.enum(['list', 'read']).describe('列出或读取当前 session 的白名单运行时文件'),
+    kind: z.enum(['all', 'scratchpad', 'context', 'implementations']).optional().describe('白名单范围，默认 all'),
+    artifact: z.string().optional().describe('要读取的文件路径，相对于当前 session 目录（action=read 时必填），如 scratchpad/T-1_research.md 或 implementations/T-1.md'),
+});
+function isInside(parent, target) {
+    const rel = relative(parent, target);
+    return rel === '' || (!rel.startsWith('..') && !rel.includes(`/../`) && !rel.includes('\\..\\'));
+}
+function collectFiles(rootDir, baseDir, maxFiles = 200) {
+    if (!existsSync(rootDir)) {
+        return [];
+    }
+    const results = [];
+    const stack = [rootDir];
+    while (stack.length > 0 && results.length < maxFiles) {
+        const current = stack.pop();
+        const entries = readdirSync(current).sort();
+        for (const entry of entries) {
+            const fullPath = join(current, entry);
+            const stat = statSync(fullPath);
+            if (stat.isDirectory()) {
+                stack.push(fullPath);
+                continue;
+            }
+            results.push(relative(baseDir, fullPath));
+            if (results.length >= maxFiles) {
+                break;
+            }
+        }
+    }
+    return results.sort();
+}
+export class SessionArtifactsTool extends Tool {
+    name = 'session_artifacts';
+    description = '列出或读取当前 session 的白名单运行时文件，只允许访问当前 session 的 scratchpad / context / implementations 目录';
+    parameters = SessionArtifactsSchema;
+    async execute(args, context) {
+        const params = args;
+        const scope = getSessionScopePaths(context?.workspace, typeof context?.sessionId === 'string' ? context.sessionId : undefined);
+        if (!scope.sessionId || !scope.sessionDir || !scope.scratchpadDir || !scope.contextDir) {
+            return {
+                success: false,
+                data: null,
+                error: 'ERROR: 当前没有可用的 session 作用域，无法读取 session artifacts。',
+            };
+        }
+        const sessionDir = scope.sessionDir;
+        const scratchpadDir = scope.scratchpadDir;
+        const contextDir = scope.contextDir;
+        const implementationsDir = scope.implementationsDir;
+        const kind = params.kind || 'all';
+        const allowedRoots = [
+            ...(kind === 'all' || kind === 'scratchpad' ? [scratchpadDir] : []),
+            ...(kind === 'all' || kind === 'context' ? [contextDir] : []),
+            ...((kind === 'all' || kind === 'implementations') && implementationsDir ? [implementationsDir] : []),
+        ].filter((path) => typeof path === 'string' && existsSync(path));
+        if (params.action === 'list') {
+            const files = allowedRoots.flatMap((root) => collectFiles(root, sessionDir));
+            return {
+                success: true,
+                data: [
+                    `session_id=${scope.sessionId}`,
+                    `session_dir=${sessionDir}`,
+                    `allowed_roots=${allowedRoots.join(', ') || '(none)'}`,
+                    'artifacts:',
+                    ...(files.length > 0 ? files.map((file) => `- ${file}`) : ['- (none)']),
+                ].join('\n'),
+            };
+        }
+        if (!params.artifact) {
+            return {
+                success: false,
+                data: null,
+                error: 'ERROR: 读取 session artifact 时必须提供 artifact 路径。',
+            };
+        }
+        const artifactPath = resolve(sessionDir, params.artifact);
+        const isAllowed = allowedRoots.some((root) => isInside(root, artifactPath));
+        if (!isAllowed) {
+            return {
+                success: false,
+                data: null,
+                error: `ERROR: 非法 artifact 路径 ${params.artifact}。仅允许读取当前 session 的 scratchpad/ 与 context/ 下文件。`,
+            };
+        }
+        if (!existsSync(artifactPath)) {
+            return {
+                success: false,
+                data: null,
+                error: `ERROR: artifact 不存在：${params.artifact}`,
+            };
+        }
+        if (statSync(artifactPath).isDirectory()) {
+            return {
+                success: false,
+                data: null,
+                error: `ERROR: artifact 必须是文件：${params.artifact}`,
+            };
+        }
+        const MAX_FILE_SIZE = 2 * 1024 * 1024; // 2MB
+        const fileStat = statSync(artifactPath);
+        if (fileStat.size > MAX_FILE_SIZE) {
+            return {
+                success: false,
+                data: null,
+                error: `ERROR: 文件过大 (${(fileStat.size / 1024 / 1024).toFixed(1)}MB)，超过限制 (${MAX_FILE_SIZE / 1024 / 1024}MB)。`,
+            };
+        }
+        try {
+            const content = readFileSync(artifactPath, 'utf-8');
+            const MAX_CONTENT_LENGTH = 50000; // 50KB
+            const truncated = content.length > MAX_CONTENT_LENGTH;
+            const displayContent = truncated
+                ? content.slice(0, MAX_CONTENT_LENGTH) + '\n\n... [内容已截断，剩余 ' + (content.length - MAX_CONTENT_LENGTH) + ' 字符] ...'
+                : content;
+            return {
+                success: true,
+                data: [
+                    `artifact=${relative(sessionDir, artifactPath)}`,
+                    '',
+                    displayContent,
+                ].join('\n'),
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                data: null,
+                error: `ERROR: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+}
+export default SessionArtifactsTool;
+//# sourceMappingURL=SessionArtifacts.js.map

package/dist/tools/implementations/SessionArtifacts.js.map

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

package/dist/tools/implementations/SessionInfoTool.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class SessionInfoTool extends Tool {
+    readonly name = "session_info";
+    readonly description = "\u8FD4\u56DE\u5F53\u524D\u4F1A\u8BDD\u7A7A\u95F4\u4FE1\u606F\uFF0C\u5305\u62EC session \u76EE\u5F55\u548C scratchpad \u76EE\u5F55";
+    readonly parameters: z.ZodObject<{}, z.core.$strip>;
+    execute(_args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+export default SessionInfoTool;
+//# sourceMappingURL=SessionInfoTool.d.ts.map

package/dist/tools/implementations/SessionInfoTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionInfoTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/SessionInfoTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAKrE,qBAAa,eAAgB,SAAQ,IAAI;IACvC,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,uIAA6C;IACjE,QAAQ,CAAC,UAAU,iCAAqB;IAElC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA0B1E;AAED,eAAe,eAAe,CAAC"}

package/dist/tools/implementations/SessionInfoTool.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+import { getSessionScopeDescription, getSessionScopePaths } from './utils.js';
+const SessionInfoSchema = z.object({});
+export class SessionInfoTool extends Tool {
+    name = 'session_info';
+    description = '返回当前会话空间信息，包括 session 目录和 scratchpad 目录';
+    parameters = SessionInfoSchema;
+    async execute(_args, context) {
+        try {
+            const scope = getSessionScopePaths(context?.workspace, context?.sessionId);
+            return {
+                success: true,
+                data: [
+                    '## 当前会话空间',
+                    getSessionScopeDescription(context?.workspace, context?.sessionId),
+                    '',
+                    '## 使用约定',
+                    '- 查找当前任务报告时，可优先读取当前 Scratchpad',
+                    '- 可使用 session_artifacts 列出并读取当前 session 的 scratchpad/context 文件',
+                    '- shell 命令可直接使用环境变量：$LINGXIAO_SESSION_ID / $LINGXIAO_SESSION_DIR / $LINGXIAO_SCRATCHPAD_DIR',
+                    '- 当前任务 scratchpad 命名规则：T-<任务号>_<角色>.md',
+                    '- 路径以本工具返回值和环境变量为准',
+                    '',
+                    '## 机器可读路径',
+                    `session_dir=${scope.sessionDir || '(unavailable)'}`,
+                    `scratchpad_dir=${scope.scratchpadDir || '(unavailable)'}`,
+                    `context_dir=${scope.contextDir || '(unavailable)'}`,
+                ].join('\n'),
+            };
+        }
+        catch (err) {
+            return { success: false, data: null, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+}
+export default SessionInfoTool;
+//# sourceMappingURL=SessionInfoTool.js.map

package/dist/tools/implementations/SessionInfoTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionInfoTool.js","sourceRoot":"","sources":["../../../src/tools/implementations/SessionInfoTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAqC,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEvC,MAAM,OAAO,eAAgB,SAAQ,IAAI;IAC9B,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG,yCAAyC,CAAC;IACxD,UAAU,GAAG,iBAAiB,CAAC;IAExC,KAAK,CAAC,OAAO,CAAC,KAAc,EAAE,OAAqB;QACjD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;YAC3E,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACJ,WAAW;oBACX,0BAA0B,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC;oBAClE,EAAE;oBACF,SAAS;oBACT,gCAAgC;oBAChC,iEAAiE;oBACjE,6FAA6F;oBAC7F,wCAAwC;oBACxC,oBAAoB;oBACpB,EAAE;oBACF,WAAW;oBACX,eAAe,KAAK,CAAC,UAAU,IAAI,eAAe,EAAE;oBACpD,kBAAkB,KAAK,CAAC,aAAa,IAAI,eAAe,EAAE;oBAC1D,eAAe,KAAK,CAAC,UAAU,IAAI,eAAe,EAAE;iBACrD,CAAC,IAAI,CAAC,IAAI,CAAC;aACb,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACjG,CAAC;IACH,CAAC;CACF;AAED,eAAe,eAAe,CAAC"}

package/dist/tools/implementations/Shell.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+/**
+ * Error-aware truncation: uses smartTruncate to detect error patterns in the
+ * tail and apply 70/30 head+tail split when errors are present.
+ * Falls back to head-only truncation for non-error output.
+ * Saves full output to a temp file when truncation occurs.
+ */
+export declare function truncateOutput(content: string): Promise<string>;
+export declare function isBinaryBuffer(buf: Buffer): boolean;
+/**
+ * 尝试将 Buffer 解码为可读文本。
+ * 优先 UTF-8，若含无效序列则尝试 Latin-1 回退，输出乱码提示。
+ */
+export declare function detectAndDecode(buf: Buffer): string;
+/**
+ * #6 优化：扫描已退出但仍在 tracking 表中的僵尸进程引用，清理泄漏
+ */
+export declare function scanZombieProcesses(): void;
+/** 清理所有后台进程（父进程退出时调用） */
+export declare function cleanupBackgroundProcesses(): void;
+export declare class ShellTool extends Tool {
+    readonly name = "shell";
+    readonly description = "\u5728\u5DE5\u4F5C\u533A\u6267\u884C shell \u547D\u4EE4\u3002\u652F\u6301\u524D\u53F0/\u540E\u53F0\u3001sandbox\u3001\u7F51\u7EDC\u9694\u79BB\u6A21\u5F0F";
+    readonly parameters: z.ZodObject<{
+        command: z.ZodString;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        cwd: z.ZodOptional<z.ZodString>;
+        network: z.ZodOptional<z.ZodEnum<{
+            disabled: "disabled";
+            inherit: "inherit";
+            allowlisted: "allowlisted";
+        }>>;
+        allowed_hosts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sandbox_backend: z.ZodOptional<z.ZodEnum<{
+            "app-guard": "app-guard";
+            bubblewrap: "bubblewrap";
+        }>>;
+        is_background: z.ZodOptional<z.ZodBoolean>;
+        _abortSignal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+    }, z.core.$strip>;
+    getSchema(): Record<string, unknown>;
+    private formatSandboxLabel;
+    private emitShellState;
+    getExecutionTimeoutMs(args: unknown): number;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+    /**
+     * Detect git subcommands in a shell command string and emit git:activity events.
+     * This covers cases where the Leader/worker uses `shell` to run git commands
+     * (e.g. `git push origin refs/heads/v1.0.2:refs/heads/v1.0.2`) instead of the
+     * dedicated `git` tool — those operations would otherwise be invisible in the
+     * Git Activity panel.
+     */
+    private maybeEmitGitActivity;
+    /**
+     * 前台执行 — 兼容原有逻辑，超时时自动转后台
+     */
+    private executeForeground;
+    /**
+     * 后台执行 — 注册到 TerminalSessionManager 并立即返回
+     */
+    private executeBackground;
+    /**
+     * PTY 模式后台执行
+     */
+    private executeBackgroundWithPty;
+    /**
+     * child_process 模式后台执行
+     */
+    private executeBackgroundWithChildProcess;
+    /**
+     * 前台超时自动转后台
+     */
+    private convertToBackground;
+}
+export default ShellTool;
+//# sourceMappingURL=Shell.d.ts.map

package/dist/tools/implementations/Shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Shell.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/Shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAkB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AA4CrF;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBrE;AA4BD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAanD;AAwBD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C;AAaD,yBAAyB;AACzB,wBAAgB,0BAA0B,IAAI,IAAI,CAOjD;AAyBD,qBAAa,SAAU,SAAQ,IAAI;IACjC,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,WAAW,+JAA4C;IAChE,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;sBAAe;IAEzB,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiB7C,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,cAAc;IAmBtB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAWtC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA0ExE;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAwD5B;;OAEG;YACW,iBAAiB;IAiO/B;;OAEG;YACW,iBAAiB;IA0D/B;;OAEG;YACW,wBAAwB;IAmEtC;;OAEG;IACH,OAAO,CAAC,iCAAiC;IAoDzC;;OAEG;IACH,OAAO,CAAC,mBAAmB;CA6D5B;AAED,eAAe,SAAS,CAAC"}