@chainingintention/pi-web-cn 1.202606.12 → 1.202606.14

package/dist/server/sessions/spawnSessionTool.js

@@ -0,0 +1,36 @@
+import { Type } from "typebox";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+const SpawnSessionParams = Type.Object({
+    prompt: Type.String({
+        description: "发送给新建会话的第一条指令。新会话会独立运行；你不会收到它的输出。",
+    }),
+    cwd: Type.Optional(Type.String({
+        description: "新会话的工作目录。必须是与当前会话同一项目下的工作区（worktree 或根目录）。默认使用当前会话的工作目录。",
+    })),
+});
+/**
+ * Custom tool that lets the LLM start a new, independent pi-web session and
+ * deliver an initial prompt to it. The spawned session is a normal pi-web session
+ * a human can open and interact with. The tool is constructed per-session, so it
+ * carries the spawning session's cwd for project-scope validation.
+ */
+export function createSpawnSessionToolDefinition(spawningCwd, deps) {
+    return defineTool({
+        name: "spawn_session",
+        label: "派生会话",
+        description: "启动一个新的独立 pi-web 会话，并发送初始提示。可用于派遣新的代理继续工作或执行计划。新会话会自行运行，人类可以打开并交互；你不会收到它的输出。",
+        promptSnippet: "spawn_session：使用第一条提示启动新的独立会话",
+        parameters: SpawnSessionParams,
+        async execute(_toolCallId, params) {
+            // Failures throw: the agent loop turns the thrown message into an error
+            // tool result the model sees, so the spawning agent can adapt (e.g. pick a
+            // valid workspace) rather than crash.
+            const result = await deps.spawn({ spawningCwd, prompt: params.prompt, cwd: params.cwd });
+            return {
+                content: [{ type: "text", text: `已在 ${result.cwd} 启动会话 ${result.sessionId}。` }],
+                details: result,
+            };
+        },
+    });
+}
+//# sourceMappingURL=spawnSessionTool.js.map

package/dist/server/sessions/spawnSessionTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnSessionTool.js","sourceRoot":"","sources":["../../../src/server/sessions/spawnSessionTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAmB7D,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,WAAW,EAAE,mCAAmC;KACjD,CAAC;IACF,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAC7B,WAAW,EAAE,0DAA0D;KACxE,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAAC,WAAmB,EAAE,IAA0B;IAC9F,OAAO,UAAU,CAAqD;QACpE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,6EAA6E;QAC1F,aAAa,EAAE,+BAA+B;QAC9C,UAAU,EAAE,kBAAkB;QAC9B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;YAC/B,wEAAwE;YACxE,2EAA2E;YAC3E,sCAAsC;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;YACzF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,GAAG,SAAS,MAAM,CAAC,SAAS,GAAG,EAAE,CAAC;gBAC/E,OAAO,EAAE,MAAM;aAChB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/server/sessions/spawnTargetResolver.js

@@ -0,0 +1,36 @@
+import { cwdPathsEqual } from "../workingDirectory.js";
+/**
+ * Default resolver composing the project registry and live worktree discovery.
+ * It finds the registered project whose current workspace set contains the
+ * spawning session's cwd, then validates the requested target against that set.
+ */
+export class ProjectScopedSpawnTargetResolver {
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async resolveSpawnTarget(spawningCwd, requestedCwd) {
+        const allowedCwds = await this.allowedSpawnTargets(spawningCwd);
+        if (allowedCwds === undefined)
+            return { allowed: false, reason: "not-registered" };
+        const target = requestedCwd === undefined || requestedCwd === "" ? spawningCwd : requestedCwd;
+        const match = allowedCwds.find((path) => cwdPathsEqual(path, target));
+        if (match === undefined)
+            return { allowed: false, reason: "out-of-project", allowedCwds };
+        return { allowed: true, cwd: match };
+    }
+    /**
+     * Workspace paths of the registered project that owns `spawningCwd`, or
+     * `undefined` when no registered project contains it.
+     */
+    async allowedSpawnTargets(spawningCwd) {
+        const projects = await this.deps.projects.list();
+        for (const project of projects) {
+            const workspaces = await this.deps.workspaces.list(project);
+            const paths = workspaces.map((workspace) => workspace.path);
+            if (paths.some((path) => cwdPathsEqual(path, spawningCwd)))
+                return paths;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=spawnTargetResolver.js.map

package/dist/server/sessions/spawnTargetResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnTargetResolver.js","sourceRoot":"","sources":["../../../src/server/sessions/spawnTargetResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA+CvD;;;;GAIG;AACH,MAAM,OAAO,gCAAgC;IAC3C,YAA6B,IAA0C;QAA1C,SAAI,GAAJ,IAAI,CAAsC;IAAG,CAAC;IAE3E,KAAK,CAAC,kBAAkB,CAAC,WAAmB,EAAE,YAAgC;QAC5E,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAChE,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QACnF,MAAM,MAAM,GAAG,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;QAC9F,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACtE,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC;QAC1F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5D,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC3E,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/shared/apiTypes.d.ts

@@ -52,6 +52,8 @@ export interface PiWebConfigValues {
     managementEmbed?: PiWebManagementEmbedConfig;
     /** Maximum accepted HTTP request body size in bytes (uploads/attachments). */
     maxUploadBytes?: number;
+    /** When true, LLMs can start new sessions via the spawn_session tool. */
+    spawnSessions?: boolean;
 }
 export interface PiWebManagementEmbedConfig {
     enabled?: boolean;
@@ -87,6 +89,7 @@ export interface PiWebConfigEnvOverrides {
     host: boolean;
     port: boolean;
     allowedHosts: boolean;
+    spawnSessions: boolean;
 }
 export interface PiWebConfigResponse {
     path: string;
@@ -562,11 +565,14 @@ export type SessionUiEvent = {
     type: "session.name";
     sessionId: string;
     name?: string;
+} | {
+    type: "session.created";
+    session: SessionInfo;
 } | {
     type: "pi.event";
     eventType: string;
 };
 export type GlobalSessionEvent = Extract<SessionUiEvent, {
-    type: "status.update" | "activity.update" | "session.name";
+    type: "status.update" | "activity.update" | "session.name" | "session.created";
 }>;
 export type RealtimeEvent = GlobalSessionEvent | TerminalUiEvent | WorkspaceActivityUiEvent;

package/docs/plugins.md

@@ -42,7 +42,7 @@ Copy-paste prompt for creating a plugin:
 Build a PI WEB plugin for this project.
 Goal: <describe the UI behavior>.
 Before coding, read the PI WEB plugin docs:
-https://pi-web.dev/plugins.html
+https://pi-web.dev/plugins
 Full API reference:
 https://pi-web.dev/plugins.md
 Create it as a local plugin under ~/.pi-web/plugins/<plugin-id>.
@@ -56,7 +56,7 @@ Copy-paste prompt for modifying a plugin:
 ```text
 Improve the PI WEB plugin at <path>.
 Before coding, read the PI WEB plugin docs:
-https://pi-web.dev/plugins.html
+https://pi-web.dev/plugins
 Full API reference:
 https://pi-web.dev/plugins.md
 Keep the plugin compatible with the documented v1 API.
@@ -131,7 +131,7 @@ Reload the PI WEB browser tab. PI WEB serves plugin modules with an mtime-based
 
 ## Remote machine plugins
 
-When [machine federation](https://pi-web.dev/machines.html) is enabled, PI WEB also loads discovered plugins from the selected remote machine. Remote plugins are trusted browser-side code like local plugins, but their contributions are machine-scoped:
+When [machine federation](https://pi-web.dev/machines) is enabled, PI WEB also loads discovered plugins from the selected remote machine. Remote plugins are trusted browser-side code like local plugins, but their contributions are machine-scoped:
 
 - actions, workspace panels, and workspace labels only appear while that machine is selected;
 - plugin file and terminal helpers run against that machine;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chainingintention/pi-web-cn",
-  "version": "1.202606.12",
+  "version": "1.202606.14",
   "description": "Remote web UI and browser control plane for persistent Pi Coding Agent sessions.",
   "license": "MIT",
   "author": "Federico Jaramillo Martinez",
@@ -72,6 +72,7 @@
     "lit": "^3.3.1",
     "marked": "^18.0.3",
     "node-pty": "^1.1.0",
+    "typebox": "1.1.38",
     "ws": "^8.20.1"
   },
   "devDependencies": {