@jingyi0605/codingns 0.8.0 → 0.8.5

package/dist/server/modules/plugins/plugin-controller.js

@@ -0,0 +1,277 @@
+import { AppError } from "../../shared/errors/app-error.js";
+import { requireUserId } from "../preferences/common.js";
+export class PluginController {
+    pluginRegistryService;
+    pluginRuntimeService;
+    pluginStaticService;
+    pluginRuntimeSessionService;
+    pluginFileGatewayService;
+    pluginPermissionService;
+    constructor(pluginRegistryService, pluginRuntimeService, pluginStaticService, pluginRuntimeSessionService, pluginFileGatewayService, pluginPermissionService) {
+        this.pluginRegistryService = pluginRegistryService;
+        this.pluginRuntimeService = pluginRuntimeService;
+        this.pluginStaticService = pluginStaticService;
+        this.pluginRuntimeSessionService = pluginRuntimeSessionService;
+        this.pluginFileGatewayService = pluginFileGatewayService;
+        this.pluginPermissionService = pluginPermissionService;
+    }
+    list = async (_request, reply) => {
+        reply.send({
+            items: this.pluginRegistryService.listPlugins()
+        });
+    };
+    get = async (request, reply) => {
+        const detail = this.pluginRegistryService.getPlugin(request.params.pluginId);
+        reply.send({
+            ...detail,
+            frontend: detail.manifest.frontend
+                ? {
+                    basePath: this.pluginStaticService.buildFrontendBasePath(detail.definition.id),
+                    entryUrl: this.pluginStaticService.buildFrontendEntryUrl(detail.definition.id, detail.manifest)
+                }
+                : null
+        });
+    };
+    createRuntimeSession = async (request, reply) => {
+        const detail = this.pluginRegistryService.getPlugin(request.params.pluginId);
+        const workspaceId = resolveWorkspaceId(request.body?.workspaceId, request.auth?.workspaceId);
+        const session = this.pluginRuntimeSessionService.createSession({
+            pluginId: request.params.pluginId,
+            workspaceId,
+            openedByUserId: requireUserId(request),
+            source: request.auth?.callerKind === "workspace_session" ? "assistant" : "frontend"
+        });
+        reply.send({
+            runtimeSessionId: session.id,
+            session,
+            frontend: detail.manifest.frontend
+                ? {
+                    basePath: this.pluginStaticService.buildFrontendBasePath(detail.definition.id),
+                    entryUrl: this.pluginStaticService.buildFrontendEntryUrl(detail.definition.id, detail.manifest)
+                }
+                : null,
+            context: {
+                pluginId: detail.definition.id,
+                workspaceId: session.workspaceId,
+                runtimeSessionId: session.id,
+                pluginName: detail.manifest.name,
+                pluginVersion: detail.manifest.version,
+                frontendEntryUrl: detail.manifest.frontend
+                    ? this.pluginStaticService.buildFrontendEntryUrl(detail.definition.id, detail.manifest)
+                    : null,
+                hostOrigin: request.headers.origin ?? null
+            }
+        });
+    };
+    closeRuntimeSession = async (request, reply) => {
+        const session = this.pluginRuntimeSessionService.getSessionOrThrow(request.params.runtimeSessionId);
+        if (session.pluginId !== request.params.pluginId) {
+            throw new AppError({
+                statusCode: 403,
+                errorCode: "PLUGIN_SCOPE_REJECTED",
+                detail: "运行实例与目标插件不一致"
+            });
+        }
+        reply.send(this.pluginRuntimeSessionService.closeSession(session.id));
+    };
+    enable = async (request, reply) => {
+        reply.send(this.pluginRegistryService.enablePlugin(request.params.pluginId, requireUserId(request)));
+    };
+    disable = async (request, reply) => {
+        reply.send(this.pluginRegistryService.disablePlugin(request.params.pluginId, requireUserId(request), request.body?.reason));
+    };
+    callAction = async (request, reply) => {
+        const runtimeSessionId = requireRuntimeSessionId(request.body?.runtimeSessionId);
+        const runtimeSession = this.pluginRuntimeSessionService.getActiveSessionForPluginOrThrow(request.params.pluginId, runtimeSessionId);
+        assertNoMismatchedWorkspaceId(request.body?.workspaceId, runtimeSession.workspaceId);
+        reply.send(await this.pluginRuntimeService.callAction({
+            pluginId: request.params.pluginId,
+            actionId: request.params.actionId,
+            workspaceId: runtimeSession.workspaceId,
+            runtimeSessionId,
+            input: request.body?.input,
+            triggerKind: request.auth?.callerKind === "workspace_session" ? "assistant" : "frontend",
+            actorUserId: requireUserId(request)
+        }));
+    };
+    listRuns = async (request, reply) => {
+        reply.send({
+            items: this.pluginRuntimeService.listRuns(request.params.pluginId)
+        });
+    };
+    listPermissionGrants = async (request, reply) => {
+        const workspaceId = resolveWorkspaceId(request.query?.workspaceId, request.auth?.workspaceId);
+        this.pluginRegistryService.getPlugin(request.params.pluginId);
+        reply.send({
+            items: this.pluginPermissionService.listWorkspaceGrants(request.params.pluginId, workspaceId)
+        });
+    };
+    createPermissionGrant = async (request, reply) => {
+        const runtimeSessionId = requireRuntimeSessionId(request.body?.runtimeSessionId);
+        const runtimeSession = this.pluginRuntimeSessionService.getActiveSessionForPluginOrThrow(request.params.pluginId, runtimeSessionId);
+        assertNoMismatchedWorkspaceId(request.body?.workspaceId, runtimeSession.workspaceId);
+        const detail = this.pluginRegistryService.getPlugin(request.params.pluginId);
+        reply.send(this.pluginPermissionService.createGrant({
+            manifest: detail.manifest,
+            pluginId: request.params.pluginId,
+            workspaceId: runtimeSession.workspaceId,
+            permissionKey: requirePermissionKey(request.body?.permissionKey),
+            scopeType: request.body?.scopeType ?? "workspace",
+            scopePath: normalizeOptionalScopePath(request.body?.scopePath),
+            grantMode: request.body?.grantMode ?? "session",
+            runtimeSessionId,
+            grantedByUserId: requireUserId(request)
+        }));
+    };
+    revokePermissionGrant = async (request, reply) => {
+        const workspaceId = resolveWorkspaceId(request.body?.workspaceId, request.auth?.workspaceId);
+        this.pluginRegistryService.getPlugin(request.params.pluginId);
+        reply.send(this.pluginPermissionService.revokeGrant(request.params.pluginId, workspaceId, request.params.grantId, requireUserId(request)));
+    };
+    desktopOpenFile = async (request, reply) => {
+        const runtimeSessionId = requireRuntimeSessionId(request.body?.runtimeSessionId);
+        const runtimeSession = this.pluginRuntimeSessionService.getActiveSessionForPluginOrThrow(request.params.pluginId, runtimeSessionId);
+        assertNoMismatchedWorkspaceId(request.body?.workspaceId, runtimeSession.workspaceId);
+        reply.send(this.pluginRuntimeService.prepareDesktopAction({
+            pluginId: request.params.pluginId,
+            workspaceId: runtimeSession.workspaceId,
+            runtimeSessionId,
+            requestedPath: requirePluginPath(request.body?.path),
+            permission: "open_file",
+            actorUserId: requireUserId(request)
+        }));
+    };
+    readFile = async (request, reply) => {
+        const runtimeSessionId = requireRuntimeSessionId(request.body?.runtimeSessionId);
+        const runtimeSession = this.pluginRuntimeSessionService.getActiveSessionForPluginOrThrow(request.params.pluginId, runtimeSessionId);
+        assertNoMismatchedWorkspaceId(request.body?.workspaceId, runtimeSession.workspaceId);
+        reply.send(this.pluginFileGatewayService.readFile({
+            pluginId: request.params.pluginId,
+            workspaceId: runtimeSession.workspaceId,
+            runtimeSessionId,
+            requestedPath: requirePluginPath(request.body?.path),
+            actorUserId: requireUserId(request)
+        }));
+    };
+    writeFile = async (request, reply) => {
+        const runtimeSessionId = requireRuntimeSessionId(request.body?.runtimeSessionId);
+        const runtimeSession = this.pluginRuntimeSessionService.getActiveSessionForPluginOrThrow(request.params.pluginId, runtimeSessionId);
+        assertNoMismatchedWorkspaceId(request.body?.workspaceId, runtimeSession.workspaceId);
+        reply.send(this.pluginFileGatewayService.writeFile({
+            pluginId: request.params.pluginId,
+            workspaceId: runtimeSession.workspaceId,
+            runtimeSessionId,
+            requestedPath: requirePluginPath(request.body?.path),
+            content: typeof request.body?.content === "string" ? request.body.content : "",
+            actorUserId: requireUserId(request)
+        }));
+    };
+    listDirectory = async (request, reply) => {
+        const runtimeSessionId = requireRuntimeSessionId(request.body?.runtimeSessionId);
+        const runtimeSession = this.pluginRuntimeSessionService.getActiveSessionForPluginOrThrow(request.params.pluginId, runtimeSessionId);
+        assertNoMismatchedWorkspaceId(request.body?.workspaceId, runtimeSession.workspaceId);
+        reply.send({
+            items: this.pluginFileGatewayService.listDirectory({
+                pluginId: request.params.pluginId,
+                workspaceId: runtimeSession.workspaceId,
+                runtimeSessionId,
+                requestedPath: request.body?.path?.trim() ?? "",
+                actorUserId: requireUserId(request)
+            })
+        });
+    };
+    desktopRevealInFileManager = async (request, reply) => {
+        const runtimeSessionId = requireRuntimeSessionId(request.body?.runtimeSessionId);
+        const runtimeSession = this.pluginRuntimeSessionService.getActiveSessionForPluginOrThrow(request.params.pluginId, runtimeSessionId);
+        assertNoMismatchedWorkspaceId(request.body?.workspaceId, runtimeSession.workspaceId);
+        reply.send(this.pluginRuntimeService.prepareDesktopAction({
+            pluginId: request.params.pluginId,
+            workspaceId: runtimeSession.workspaceId,
+            runtimeSessionId,
+            requestedPath: requirePluginPath(request.body?.path),
+            permission: "reveal_in_file_manager",
+            actorUserId: requireUserId(request)
+        }));
+    };
+    publicFrontendAsset = async (request, reply) => {
+        const requestedPath = request.params["*"] ?? "";
+        return this.pluginStaticService.serveFrontendAsset(request.params.pluginId, requestedPath, reply);
+    };
+    publicRuntimeSdk = async (_request, reply) => {
+        return this.pluginStaticService.serveRuntimeSdk(reply);
+    };
+}
+function resolveWorkspaceId(bodyWorkspaceId, authWorkspaceId) {
+    const normalizedAuthWorkspaceId = authWorkspaceId?.trim() ?? "";
+    if (normalizedAuthWorkspaceId) {
+        if (bodyWorkspaceId?.trim() && bodyWorkspaceId.trim() !== normalizedAuthWorkspaceId) {
+            throw new AppError({
+                statusCode: 403,
+                errorCode: "PLUGIN_SCOPE_REJECTED",
+                detail: "插件请求的 workspaceId 与当前受控工作区不一致"
+            });
+        }
+        return normalizedAuthWorkspaceId;
+    }
+    const normalizedBodyWorkspaceId = bodyWorkspaceId?.trim() ?? "";
+    if (!normalizedBodyWorkspaceId) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "PLUGIN_WORKSPACE_CONTEXT_REQUIRED",
+            detail: "插件运行必须绑定当前工作区"
+        });
+    }
+    return normalizedBodyWorkspaceId;
+}
+function requireRuntimeSessionId(value) {
+    const normalized = value?.trim() ?? "";
+    if (!normalized) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "PLUGIN_RUNTIME_SESSION_REQUIRED",
+            detail: "插件运行必须提供 runtimeSessionId"
+        });
+    }
+    return normalized;
+}
+function assertNoMismatchedWorkspaceId(bodyWorkspaceId, workspaceId) {
+    const normalizedBodyWorkspaceId = bodyWorkspaceId?.trim() ?? "";
+    if (normalizedBodyWorkspaceId && normalizedBodyWorkspaceId !== workspaceId) {
+        throw new AppError({
+            statusCode: 403,
+            errorCode: "PLUGIN_SCOPE_REJECTED",
+            detail: "插件请求的 workspaceId 与当前运行实例不一致"
+        });
+    }
+}
+function requirePluginPath(value) {
+    const normalized = value?.trim() ?? "";
+    if (!normalized) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "PLUGIN_PATH_REQUIRED",
+            detail: "插件桌面动作必须提供目标路径"
+        });
+    }
+    return normalized;
+}
+function requirePermissionKey(value) {
+    const normalized = value?.trim() ?? "";
+    if (normalized === "workspace.read_file"
+        || normalized === "workspace.list_dir"
+        || normalized === "workspace.write_file"
+        || normalized === "desktop.open_file"
+        || normalized === "desktop.reveal_in_file_manager") {
+        return normalized;
+    }
+    throw new AppError({
+        statusCode: 400,
+        errorCode: "PLUGIN_PERMISSION_SCOPE_INVALID",
+        detail: "插件授权请求里的 permissionKey 不合法"
+    });
+}
+function normalizeOptionalScopePath(value) {
+    const normalized = value?.trim() ?? "";
+    return normalized || null;
+}
+//# sourceMappingURL=plugin-controller.js.map

package/dist/server/modules/plugins/plugin-controller.js.map

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

package/dist/server/modules/plugins/plugin-file-gateway-service.d.ts

@@ -0,0 +1,38 @@
+import type { PluginAuditEventRepository } from "../../storage/repositories/plugin-audit-event-repository.js";
+import type { FileNode, FileSnapshot } from "../../types/domain.js";
+import type { FileAccessGuard } from "../file/file-access-guard.js";
+import { PluginPermissionService } from "./plugin-permission-service.js";
+import type { PluginRegistryService } from "./plugin-registry-service.js";
+export interface PluginFileGatewayReadInput {
+    pluginId: string;
+    workspaceId: string;
+    runtimeSessionId: string;
+    requestedPath: string;
+    actorUserId: string | null;
+}
+export interface PluginFileGatewayWriteInput extends PluginFileGatewayReadInput {
+    content: string;
+}
+export interface PluginFileGatewayListInput {
+    pluginId: string;
+    workspaceId: string;
+    runtimeSessionId: string;
+    requestedPath?: string | null;
+    actorUserId: string | null;
+}
+export declare class PluginFileGatewayService {
+    private readonly pluginRegistryService;
+    private readonly fileAccessGuard;
+    private readonly pluginPermissionService;
+    private readonly pluginAuditEventRepository;
+    constructor(pluginRegistryService: PluginRegistryService, fileAccessGuard: FileAccessGuard, pluginPermissionService: PluginPermissionService, pluginAuditEventRepository: PluginAuditEventRepository);
+    readFile(input: PluginFileGatewayReadInput): FileSnapshot;
+    writeFile(input: PluginFileGatewayWriteInput): {
+        path: string;
+        size: number;
+        updatedAt: string;
+    };
+    listDirectory(input: PluginFileGatewayListInput): FileNode[];
+    private recordAuditEvent;
+    private recordPermissionAudit;
+}

package/dist/server/modules/plugins/plugin-file-gateway-service.js

@@ -0,0 +1,178 @@
+import fs from "node:fs";
+import { createId } from "../../shared/utils/id.js";
+import { nowIso } from "../../shared/utils/time.js";
+export class PluginFileGatewayService {
+    pluginRegistryService;
+    fileAccessGuard;
+    pluginPermissionService;
+    pluginAuditEventRepository;
+    constructor(pluginRegistryService, fileAccessGuard, pluginPermissionService, pluginAuditEventRepository) {
+        this.pluginRegistryService = pluginRegistryService;
+        this.fileAccessGuard = fileAccessGuard;
+        this.pluginPermissionService = pluginPermissionService;
+        this.pluginAuditEventRepository = pluginAuditEventRepository;
+    }
+    readFile(input) {
+        const detail = this.pluginRegistryService.getPlugin(input.pluginId);
+        try {
+            this.pluginPermissionService.assertWorkspaceRead(detail.manifest, {
+                pluginId: input.pluginId,
+                workspaceId: input.workspaceId
+            });
+        }
+        catch (error) {
+            this.recordPermissionAudit(input, "workspace.read_file", error);
+            throw error;
+        }
+        const resolved = this.fileAccessGuard.resolvePath(input.workspaceId, input.requestedPath, {
+            mustExist: true,
+            kind: "file"
+        });
+        const buffer = fs.readFileSync(resolved.absolutePath);
+        const stats = fs.statSync(resolved.absolutePath);
+        const snapshot = {
+            workspaceId: input.workspaceId,
+            path: resolved.relativePath,
+            content: buffer.toString("utf8"),
+            encoding: "utf-8",
+            version: buildPluginFileVersion(buffer, stats),
+            size: buffer.byteLength,
+            updatedAt: stats.mtime.toISOString()
+        };
+        this.recordAuditEvent(input.pluginId, input.workspaceId, input.actorUserId, "plugin.file_read", {
+            runtimeSessionId: input.runtimeSessionId,
+            path: resolved.relativePath,
+            size: snapshot.size
+        });
+        return snapshot;
+    }
+    writeFile(input) {
+        const detail = this.pluginRegistryService.getPlugin(input.pluginId);
+        try {
+            this.pluginPermissionService.assertWorkspaceWrite(detail.manifest, {
+                pluginId: input.pluginId,
+                workspaceId: input.workspaceId
+            }, input.requestedPath);
+        }
+        catch (error) {
+            this.recordPermissionAudit(input, "workspace.write_file", error);
+            throw error;
+        }
+        const resolved = this.fileAccessGuard.resolvePath(input.workspaceId, input.requestedPath, {
+            mustExist: false,
+            kind: "file"
+        });
+        const buffer = Buffer.from(input.content, "utf8");
+        fs.writeFileSync(resolved.absolutePath, buffer);
+        const stats = fs.statSync(resolved.absolutePath);
+        this.recordAuditEvent(input.pluginId, input.workspaceId, input.actorUserId, "plugin.file_write", {
+            runtimeSessionId: input.runtimeSessionId,
+            path: resolved.relativePath,
+            size: buffer.byteLength
+        });
+        return {
+            path: resolved.relativePath,
+            size: buffer.byteLength,
+            updatedAt: stats.mtime.toISOString()
+        };
+    }
+    listDirectory(input) {
+        const detail = this.pluginRegistryService.getPlugin(input.pluginId);
+        try {
+            this.pluginPermissionService.requirePermissionGrant({
+                manifest: detail.manifest,
+                pluginId: input.pluginId,
+                workspaceId: input.workspaceId,
+                permissionKey: "workspace.list_dir",
+                scopePath: input.requestedPath ?? null,
+                runtimeSessionId: input.runtimeSessionId
+            });
+        }
+        catch (error) {
+            this.recordPermissionAudit(input, "workspace.list_dir", error);
+            throw error;
+        }
+        const resolved = this.fileAccessGuard.resolvePath(input.workspaceId, input.requestedPath ?? "", {
+            allowRoot: true,
+            mustExist: true,
+            kind: "directory"
+        });
+        const items = fs
+            .readdirSync(resolved.absolutePath, { withFileTypes: true })
+            .filter((entry) => !entry.isSymbolicLink())
+            .map((entry) => {
+            const childAbsolutePath = `${resolved.absolutePath}/${entry.name}`;
+            const childStats = fs.statSync(childAbsolutePath);
+            const childRelativePath = resolved.relativePath
+                ? `${resolved.relativePath}/${entry.name}`
+                : entry.name;
+            return {
+                path: childRelativePath.replace(/\\/g, "/"),
+                name: entry.name,
+                kind: entry.isDirectory() ? "directory" : "file",
+                size: entry.isDirectory() ? null : childStats.size,
+                updatedAt: childStats.mtime.toISOString()
+            };
+        })
+            .sort((left, right) => {
+            if (left.kind !== right.kind) {
+                return left.kind === "directory" ? -1 : 1;
+            }
+            return left.name.localeCompare(right.name);
+        });
+        this.recordAuditEvent(input.pluginId, input.workspaceId, input.actorUserId, "plugin.file_list", {
+            runtimeSessionId: input.runtimeSessionId,
+            path: resolved.relativePath,
+            count: items.length
+        });
+        return items;
+    }
+    recordAuditEvent(pluginId, workspaceId, actorUserId, operation, payload) {
+        this.pluginAuditEventRepository.create({
+            id: createId(),
+            pluginId,
+            workspaceId,
+            eventType: "plugin.action_invoked",
+            actorUserId,
+            payloadJson: JSON.stringify({
+                operation,
+                ...payload
+            }),
+            createdAt: nowIso()
+        });
+    }
+    recordPermissionAudit(input, permissionKey, error) {
+        if (!(error instanceof Error) || !("errorCode" in error)) {
+            return;
+        }
+        const errorCode = String(error.errorCode ?? "");
+        if (errorCode === "PLUGIN_PERMISSION_DECLARATION_MISSING") {
+            this.pluginPermissionService.recordPermissionDenied({
+                pluginId: input.pluginId,
+                workspaceId: input.workspaceId,
+                actorUserId: input.actorUserId,
+                permissionKey,
+                scopePath: "requestedPath" in input ? input.requestedPath ?? null : null,
+                runtimeSessionId: input.runtimeSessionId,
+                reason: "declaration_missing"
+            });
+            return;
+        }
+        if (errorCode === "PLUGIN_PERMISSION_GRANT_REQUIRED") {
+            this.pluginPermissionService.recordPermissionDenied({
+                pluginId: input.pluginId,
+                workspaceId: input.workspaceId,
+                actorUserId: input.actorUserId,
+                permissionKey,
+                scopePath: "requestedPath" in input ? input.requestedPath ?? null : null,
+                runtimeSessionId: input.runtimeSessionId,
+                reason: "grant_required"
+            });
+            return;
+        }
+    }
+}
+function buildPluginFileVersion(buffer, stats) {
+    return `${buffer.byteLength}:${stats.mtimeMs}:${stats.ino}`;
+}
+//# sourceMappingURL=plugin-file-gateway-service.js.map

package/dist/server/modules/plugins/plugin-file-gateway-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-file-gateway-service.js","sourceRoot":"","sources":["../../../../src/modules/plugins/plugin-file-gateway-service.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/plugins/plugin-manifest.d.ts

@@ -0,0 +1,8 @@
+import type { PluginManifest } from "../../types/domain.js";
+export interface ParsedPluginManifest {
+    manifest: PluginManifest;
+    installRoot: string;
+    manifestPath: string;
+}
+export declare function readPluginManifest(installRoot: string): ParsedPluginManifest;
+export declare function validatePluginManifest(input: unknown, installRoot: string): PluginManifest;