@chainingintention/pi-web-cn 2.202610.5 → 2.202611.2

package/examples/session-bridge-plugin/src/reviewRun.ts

@@ -1,39 +0,0 @@
-import type { PiWebHostPiSessionConnection } from "@chainingintention/pi-web-cn/server-plugin-api";
-import { MAX_FINDINGS, REVIEW_REPLY, REVIEW_REQUEST } from "./browser/protocol.js";
-
-/** Receipt and completion are separate, correlated events. Neither close nor timeout cancels Pi. */
-export async function collectReview(connection: PiWebHostPiSessionConnection, requestId: string, lifetime: AbortSignal): Promise<string> {
-  const signal = AbortSignal.any([lifetime, connection.signal]);
-  signal.throwIfAborted();
-  let unsubscribe: (() => void) | undefined;
-  let onAbort: (() => void) | undefined;
-  let receiptTimer: ReturnType<typeof setTimeout> | undefined;
-  let completionTimer: ReturnType<typeof setTimeout> | undefined;
-  try {
-    return await new Promise<string>((resolve, reject) => {
-      onAbort = () => { reject(new Error("审查连接已中断，代理可能仍在会话中运行")); };
-      signal.addEventListener("abort", onAbort, { once: true });
-      receiptTimer = setTimeout(() => { reject(new Error("5 秒内未收到伴随扩展回执。请检查包启用状态和项目信任，重试前先检查会话。")); }, 5_000);
-      completionTimer = setTimeout(() => { reject(new Error("审查超过 10 分钟，代理可能仍在会话中运行，未保存审查结果。")); }, 600_000);
-      unsubscribe = connection.on(REVIEW_REPLY, (data) => {
-        if (typeof data !== "object" || data === null || !("requestId" in data) || data.requestId !== requestId) return;
-        if (!("status" in data)) return;
-        if (data.status === "accepted") { clearTimeout(receiptTimer); return; }
-        if (data.status === "failed") {
-          reject(new Error("error" in data && typeof data.error === "string" ? data.error.slice(0, 4000) : "审查失败"));
-        } else if (data.status === "completed") {
-          if (!("text" in data) || typeof data.text !== "string" || !data.text.trim() || data.text.length > MAX_FINDINGS) {
-            reject(new Error("伴随扩展返回的审查结果无效"));
-          } else resolve(data.text);
-        }
-      });
-      // Native listeners can reply synchronously.
-      connection.emit(REVIEW_REQUEST, { requestId });
-    });
-  } finally {
-    clearTimeout(receiptTimer);
-    clearTimeout(completionTimer);
-    if (onAbort) signal.removeEventListener("abort", onAbort);
-    unsubscribe?.();
-  }
-}

package/examples/session-bridge-plugin/src/server.ts

@@ -1,85 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { PI_WEB_HOST_PI_SESSIONS_CAPABILITY, PI_WEB_HOST_PI_SESSION_EVENTS_CAPABILITY } from "@chainingintention/pi-web-cn/server-plugin-api";
-import type { PiWebHostPiSessionsV1, PiWebHostPiSessionEventsV1, PiWebServerPlugin, ServerPluginActivationContext } from "@chainingintention/pi-web-cn/server-plugin-api";
-import type { Review } from "./browser/protocol.js";
-import { collectReview } from "./reviewRun.js";
-import { ReviewStore, reviewScope } from "./store.js";
-
-const plugin = {
-  apiVersion: 3,
-  name: "工作区审查",
-  requires: [PI_WEB_HOST_PI_SESSIONS_CAPABILITY, PI_WEB_HOST_PI_SESSION_EVENTS_CAPABILITY],
-  activate(host: ServerPluginActivationContext) {
-    const store = new ReviewStore(host.dataDirectory);
-    const active = new Map<string, Review>();
-    const tasks = new Set<Promise<void>>();
-    // Retain failed writes in memory so a refresh cannot present stale running/success state.
-    const unsaved = new Map<string, Review>();
-    let piSessions: PiWebHostPiSessionsV1;
-    let sessionEvents: PiWebHostPiSessionEventsV1;
-    const visible = (scope: string, record: Review): Review => {
-      const failed = unsaved.get(record.id);
-      if (failed) return failed;
-      return record.status === "running" && active.get(scope)?.id !== record.id
-        ? { ...record, status: "interrupted", text: "后端在记录完成结果前停止。请检查对话，再手动发起新审查。" }
-        : record;
-    };
-    return {
-      start({ capabilities }) {
-        piSessions = capabilities.resolve(PI_WEB_HOST_PI_SESSIONS_CAPABILITY);
-        sessionEvents = capabilities.resolve(PI_WEB_HOST_PI_SESSION_EVENTS_CAPABILITY);
-      },
-      peer: {
-        async request(context) {
-          context.signal.throwIfAborted();
-          host.lifetimeSignal.throwIfAborted();
-          const selection = { projectId: context.project.id, workspaceId: context.workspace.id };
-          const scope = reviewScope(selection.projectId, selection.workspaceId);
-          if (context.operation === "list") {
-            return (await store.list(scope)).map((record) => {
-              const review = visible(scope, record);
-              return { ...review, text: "" };
-            });
-          }
-          if (context.operation === "read") return { ...visible(scope, await store.read(scope, context.input)) };
-          if (context.operation !== "start") throw new Error("未知的审查操作");
-          if (active.has(scope)) throw new Error("此工作区已有审查运行中，请刷新状态");
-          const record: Review = { id: randomUUID(), createdAt: new Date().toISOString(), sessionId: "", status: "running", text: "正在启动审查会话…" };
-          active.set(scope, record);
-          try {
-            // Persist before starting work. Browser cancellation after admission does not own the run.
-            await store.save(scope, record);
-          } catch (error) { active.delete(scope); throw error; }
-          const task = (async () => {
-            try {
-              host.lifetimeSignal.throwIfAborted();
-              ({ sessionId: record.sessionId } = await piSessions.create(selection));
-              record.text = "审查进行中。刷新查看保存的结果，可在会话中打开对话。";
-              await store.save(scope, record);
-              host.lifetimeSignal.throwIfAborted();
-              const connection = await sessionEvents.connect({ ...selection, sessionId: record.sessionId });
-              try { record.text = await collectReview(connection, record.id, host.lifetimeSignal); }
-              finally { connection.close(); }
-              record.status = "completed";
-            } catch (error) {
-              record.status = "failed";
-              record.text = (error instanceof Error ? error.message : String(error)).slice(0, 4000);
-            }
-            try { await store.save(scope, record); }
-            catch (error) {
-              record.status = "failed";
-              record.text = `无法保存审查：${error instanceof Error ? error.message : String(error)}。请检查会话 ${record.sessionId}.`.slice(0, 4000);
-              unsaved.set(record.id, { ...record });
-              host.logger.error(record.text);
-            } finally { active.delete(scope); }
-          })();
-          tasks.add(task);
-          void task.finally(() => { tasks.delete(task); });
-          return { ...record };
-        },
-      },
-      async dispose() { await Promise.all(tasks); active.clear(); unsaved.clear(); },
-    };
-  },
-} satisfies PiWebServerPlugin;
-export default plugin;

package/examples/session-bridge-plugin/src/store.ts

@@ -1,80 +0,0 @@
-import { createHash, randomUUID } from "node:crypto";
-import { constants } from "node:fs";
-import { lstat, mkdir, open, readdir, rename, rm } from "node:fs/promises";
-import { join, resolve } from "node:path";
-import { isReview, type Review } from "./browser/protocol.js";
-
-/** Only host-resolved ids enter the scope hash; peer input is never a filesystem path. */
-export function reviewScope(projectId: string, workspaceId: string): string {
-  return createHash("sha256").update(JSON.stringify([projectId, workspaceId])).digest("hex");
-}
-
-export class ReviewStore {
-  private static readonly pending = new Map<string, Promise<void>>();
-
-  constructor(private readonly dataDirectory: string) {}
-
-  private async directory(scope: string): Promise<string> {
-    if (!/^[a-f0-9]{64}$/.test(scope)) throw new Error("Invalid review scope");
-    const directory = join(this.dataDirectory, scope);
-    await mkdir(directory, { recursive: true, mode: 0o700 });
-    if (!(await lstat(directory)).isDirectory()) throw new Error("Review directory must not be a symlink");
-    return directory;
-  }
-
-  save(scope: string, review: Review): Promise<void> {
-    if (!isReview(review)) return Promise.reject(new Error("Invalid review record"));
-    const snapshot = { ...review };
-    return this.enqueue(scope, review.id, () => this.saveRecord(scope, snapshot));
-  }
-
-  private async saveRecord(scope: string, review: Review): Promise<void> {
-    const directory = await this.directory(scope);
-    const temporary = join(directory, `.${randomUUID()}.tmp`);
-    try {
-      const file = await open(temporary, "wx", 0o600);
-      try { await file.writeFile(JSON.stringify(review)); await file.sync(); } finally { await file.close(); }
-      await rename(temporary, join(directory, `${review.id}.json`));
-    } finally { await rm(temporary, { force: true }); }
-  }
-
-  read(scope: string, id: unknown): Promise<Review> {
-    if (typeof id !== "string" || !/^[a-f0-9-]{36}$/.test(id)) return Promise.reject(new Error("Invalid review id"));
-    return this.enqueue(scope, id, () => this.readRecord(scope, id));
-  }
-
-  private async readRecord(scope: string, id: string): Promise<Review> {
-    const path = join(await this.directory(scope), `${id}.json`);
-    // O_NOFOLLOW is not enforced on Windows; reject existing links there too.
-    if (!(await lstat(path)).isFile()) throw new Error("Invalid review file");
-    const file = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
-    try {
-      const stat = await file.stat();
-      if (!stat.isFile() || stat.size > 300_000) throw new Error("Invalid review file");
-      const value: unknown = JSON.parse(await file.readFile("utf8"));
-      if (!isReview(value) || value.id !== id) throw new Error("Invalid saved review");
-      return value;
-    } finally { await file.close(); }
-  }
-
-  private enqueue<T>(scope: string, id: string, operation: () => Promise<T>): Promise<T> {
-    const key = resolve(this.dataDirectory, scope, id);
-    // Windows cannot replace a file while our own read handle is still open.
-    const result = (ReviewStore.pending.get(key) ?? Promise.resolve()).then(operation);
-    const settled = result.then(() => undefined, () => undefined);
-    ReviewStore.pending.set(key, settled);
-    void settled.then(() => {
-      if (ReviewStore.pending.get(key) === settled) ReviewStore.pending.delete(key);
-    });
-    return result;
-  }
-
-  async list(scope: string): Promise<Review[]> {
-    const names = await readdir(await this.directory(scope));
-    const reviews: Review[] = [];
-    for (const name of names) {
-      if (/^[a-f0-9-]{36}\.json$/.test(name)) reviews.push(await this.read(scope, name.slice(0, -5)));
-    }
-    return reviews.sort((a, b) => b.createdAt.localeCompare(a.createdAt) || b.id.localeCompare(a.id));
-  }
-}

package/examples/session-bridge-plugin/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "lib": ["ES2022", "DOM"],
-    "types": ["node"],
-    "rootDir": "src",
-    "outDir": "dist",
-    "strict": true,
-    "exactOptionalPropertyTypes": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "forceConsistentCasingInFileNames": true,
-    "verbatimModuleSyntax": true,
-    "skipLibCheck": true,
-    "noEmitOnError": true
-  },
-  "include": ["src/**/*.ts"]
-}