@evandu/super-pi 0.1.156 → 0.1.157

package/agents/super-pi-task/core.ts

@@ -1135,7 +1135,7 @@ export async function executeScheduledTask(
 export const PROJECT_TOOL_NAME = "project";
 export const PROJECT_ENDPOINT_ENV = "SUPER_PI_PROJECT_ENDPOINT";
 
-export const PROJECT_DESCRIPTION = `Manage a user-triggered project through accountable delegation, evidence and independent review. Read the latest state with get. The project leader uses add_task (title, objective, deliverables, acceptanceCriteria, dependencies, role=leader/executor, optional executorProfile/reviewerProfile with agentId, cwd, model, thinkingLevel, watchdogTimeoutSeconds), dispatch and request_review. A branch leader creates children with parentTaskId set to its own task ID and manages only its direct tasks. Dependencies must be siblings. Leader aggregate submission requires independently accepted children. Keep at most 3 leader levels and 8 branch leaders; small projects need only one executor. Workers submit output plus evidenceRefs. Only the assigned independent reviewer can review with verdict accepted or changes_requested, summary and evidenceRefs. update_task marks blocked/failed with blockedReason, updates executorProfile/reviewerProfile before child sessions spawn, or the leader resets ready for retry. report records kind=progress/blocked, progress, variance, nextStep, risks, decisionNeeded and evidenceRefs. escalate records reason and severity=low/medium/high for Boss decisions. complete requires all tasks independently accepted and a final summary with evidenceRefs. Project and task IDs come from get/add_task. Reads never invoke models. Dispatch is asynchronous and consumes budget; stop polling when capacity is full and wait for child completion reports. Do not use session_spawn, session_dispatch, task or workflow to bypass the project dispatch guard. Never claim success on an error.`;
+export const PROJECT_DESCRIPTION = `Manage a user-triggered project through accountable delegation, evidence and independent review. When the user describes a project in natural language, decompose it yourself into title, objective, deliverables, acceptanceCriteria and budget, then call create with those fields and the top-level tasks you derived. Create also accepts optional constraints, risk, budget with maxTokens/maxConcurrent, and default profiles defaultLeaderProfile/defaultExecutorProfile/defaultReviewerProfile. The tasks array carries that decomposition: each entry needs a title and an objective, and its dependencies name the titles of sibling tasks in the same array. The project starts on action="start" - call it only after you have registered the top-level tasks, because the leader session begins decomposing the work the moment it starts. You are the initiator: you may create the project, register top-level tasks and start it; you may not register child tasks, change the budget or cancel the scope. Only a root conversation may create a project. Top-level tasks can also be registered later with add_task. Read the latest state with get. The project leader uses add_task (title, objective, deliverables, acceptanceCriteria, dependencies, role=leader/executor, optional executorProfile/reviewerProfile with agentId, cwd, model, thinkingLevel, watchdogTimeoutSeconds), dispatch and request_review. A branch leader creates children with parentTaskId set to its own task ID and manages only its direct tasks. Dependencies must be siblings. Leader aggregate submission requires independently accepted children. Keep at most 3 leader levels and 8 branch leaders; small projects need only one executor. Workers submit output plus evidenceRefs. Only the assigned independent reviewer can review with verdict accepted or changes_requested, summary and evidenceRefs. update_task marks blocked/failed with blockedReason, updates executorProfile/reviewerProfile before child sessions spawn, or the leader resets ready for retry. report records kind=progress/blocked, progress, variance, nextStep, risks, decisionNeeded and evidenceRefs. escalate records reason and severity=low/medium/high for Boss decisions. complete requires all tasks independently accepted and a final summary with evidenceRefs. Project and task IDs come from create/get/add_task. Reads never invoke models. Dispatch is asynchronous and consumes budget; stop polling when capacity is full and wait for child completion reports. Do not use session_spawn, session_dispatch, task or workflow to bypass the project dispatch guard. Never claim success on an error.`;
 
 export function readProjectConfig(env: Record<string, string | undefined>) {
   return { endpoint: env[PROJECT_ENDPOINT_ENV] ?? "", conversationId: env[TASK_CONVERSATION_ENV] ?? "", workspaceId: env.SUPER_PI_ORCHESTRATOR_WORKSPACE ?? "", capability: env[TASK_CAPABILITY_ENV] };

package/agents/super-pi-task/index.ts

@@ -305,15 +305,37 @@ const extension = (pi: ExtensionApi): void => {
   pi.registerTool({
     name: PROJECT_TOOL_NAME, label: "Project", description: PROJECT_DESCRIPTION,
     parameters: Type.Object({
-      action: Type.Union(["get", "add_task", "dispatch", "submit", "request_review", "review", "update_task", "report", "escalate", "complete"].map((value) => Type.Literal(value))),
-      projectId: Type.String(), taskId: Type.Optional(Type.String()),
+      action: Type.Union(["create", "start", "get", "add_task", "dispatch", "submit", "request_review", "review", "update_task", "report", "escalate", "complete"].map((value) => Type.Literal(value))),
+      projectId: Type.Optional(Type.String()), taskId: Type.Optional(Type.String()),
       parentTaskId: Type.Optional(Type.String()), role: Type.Optional(Type.Union([Type.Literal("leader"), Type.Literal("executor")])),
       title: Type.Optional(Type.String()), objective: Type.Optional(Type.String()),
-      deliverables: Type.Optional(Type.Array(Type.String())), acceptanceCriteria: Type.Optional(Type.Array(Type.String())), dependencies: Type.Optional(Type.Array(Type.String())),
+      deliverables: Type.Optional(Type.Array(Type.String())), acceptanceCriteria: Type.Optional(Type.Array(Type.String())), constraints: Type.Optional(Type.Array(Type.String())), dependencies: Type.Optional(Type.Array(Type.String())),
+      risk: Type.Optional(Type.String()),
+      budget: Type.Optional(Type.Object({ maxTokens: Type.Optional(Type.Number()), maxConcurrent: Type.Optional(Type.Number()) })),
       priority: Type.Optional(Type.String()), status: Type.Optional(Type.String()), blockedReason: Type.Optional(Type.String()),
+      tasks: Type.Optional(Type.Array(Type.Object({
+        title: Type.String(), objective: Type.String(),
+        deliverables: Type.Optional(Type.Array(Type.String())), acceptanceCriteria: Type.Optional(Type.Array(Type.String())),
+        dependencies: Type.Optional(Type.Array(Type.String())), priority: Type.Optional(Type.String()),
+      }))),
       output: Type.Optional(Type.String()), evidenceRefs: Type.Optional(Type.Array(Type.String())), verdict: Type.Optional(Type.String()), summary: Type.Optional(Type.String()),
       kind: Type.Optional(Type.String()), progress: Type.Optional(Type.String()), variance: Type.Optional(Type.String()), nextStep: Type.Optional(Type.String()),
       risks: Type.Optional(Type.Array(Type.String())), decisionNeeded: Type.Optional(Type.String()), reason: Type.Optional(Type.String()), severity: Type.Optional(Type.String()),
+      defaultLeaderProfile: Type.Optional(Type.Object({
+        agentId: Type.Optional(Type.String()), cwd: Type.Optional(Type.String()),
+        model: Type.Optional(Type.Object({ provider: Type.String(), modelId: Type.String() })),
+        thinkingLevel: Type.Optional(Type.String()), watchdogTimeoutSeconds: Type.Optional(Type.Number()),
+      })),
+      defaultExecutorProfile: Type.Optional(Type.Object({
+        agentId: Type.Optional(Type.String()), cwd: Type.Optional(Type.String()),
+        model: Type.Optional(Type.Object({ provider: Type.String(), modelId: Type.String() })),
+        thinkingLevel: Type.Optional(Type.String()), watchdogTimeoutSeconds: Type.Optional(Type.Number()),
+      })),
+      defaultReviewerProfile: Type.Optional(Type.Object({
+        agentId: Type.Optional(Type.String()), cwd: Type.Optional(Type.String()),
+        model: Type.Optional(Type.Object({ provider: Type.String(), modelId: Type.String() })),
+        thinkingLevel: Type.Optional(Type.String()), watchdogTimeoutSeconds: Type.Optional(Type.Number()),
+      })),
       executorProfile: Type.Optional(Type.Object({
         agentId: Type.Optional(Type.String()), cwd: Type.Optional(Type.String()),
         model: Type.Optional(Type.Object({ provider: Type.String(), modelId: Type.String() })),

package/dist/client/.super-pi-client-sources.json

@@ -39,5 +39,5 @@
     "src/client/types.ts": "b4d24bfabf230e29b984cf698aeb579c19797139a2b358f1a4e61cafce02964d",
     "src/client/vite-env.d.ts": "65996936fbb042915f7b74a200fcdde7e410f32a669b1ab9597cfaa4b0faddb5"
   },
-  "recordedAt": "2026-11-03T12:20:19.321Z"
+  "recordedAt": "2026-11-04T06:54:50.867Z"
 }

package/dist/server/application/project-service.d.ts

@@ -19,6 +19,7 @@ export type CreateProjectInput = {
     defaultLeaderProfile?: unknown;
     defaultExecutorProfile?: unknown;
     defaultReviewerProfile?: unknown;
+    initiatorConversationId?: string;
 };
 export type AddTaskInput = Partial<ProjectTask> & {
     title: string;
@@ -26,6 +27,15 @@ export type AddTaskInput = Partial<ProjectTask> & {
     executorProfile?: unknown;
     reviewerProfile?: unknown;
 };
+/** A top-level task an initiator hands over with create, before the service gives it an ID. */
+export type TopLevelTaskPlan = {
+    title: string;
+    objective: string;
+    deliverables?: string[];
+    acceptanceCriteria?: string[];
+    priority?: ProjectTask["priority"];
+    dependencies: string[];
+};
 /** Persist explicit domain fields only; transport credentials never enter project records. */
 export declare class ProjectService {
     private readonly store;
@@ -40,6 +50,7 @@ export declare class ProjectService {
     private change;
     private live;
     private leader;
+    private topLevelAuthor;
     private manager;
     private requiredComplete;
     private task;
@@ -49,7 +60,7 @@ export declare class ProjectService {
     list(workspaceId?: string): Project[];
     get(id: string, workspaceId?: string): Project;
     projectForSession(conversationId: string): Project | undefined;
-    create(input: CreateProjectInput): Promise<Project>;
+    create(input: CreateProjectInput, initiatorConversationId?: string): Promise<Project>;
     private admission;
     private context;
     start(id: string, workspaceId: string, actor?: string): Promise<Project>;
@@ -77,5 +88,13 @@ export declare class ProjectService {
     addEscalation(id: string, input: Pick<ProjectEscalation, "reason" | "severity" | "taskId">, workspaceId?: string, actor?: string): Promise<ProjectEscalation>;
     resolveEscalation(id: string, escalationId: string, decision: string, status: "resolved" | "dismissed", workspaceId?: string): Promise<ProjectEscalation>;
     complete(id: string, summary: string, evidenceRefs: unknown, workspaceId: string, actor?: string): Promise<Project>;
+    /**
+     * The tasks an initiator hands over with create. A dependency names the TITLE of another task in
+     * the same batch, because the batch carries no task IDs yet - the service assigns them while it
+     * registers the batch. The plan comes back in dependency order, so the plain add_task rules
+     * (title, objective, priority, sibling dependencies) can be reused unchanged.
+     */
+    private planTopLevelTasks;
+    private registerTopLevelTasks;
     tool(body: Record<string, any>, workspaceId: string, actor: string): Promise<unknown>;
 }

package/dist/server/application/project-service.js

@@ -177,6 +177,15 @@ export class ProjectService {
         throw new Error("项目已结束，不能继续修改或派发"); }
     leader(p, actor) { if (actor && actor !== p.ownerConversationId)
         throw new Error("仅项目负责人可以执行此操作"); }
+    topLevelAuthor(p, actor) {
+        if (!actor)
+            return;
+        if (actor === p.ownerConversationId)
+            return;
+        if (actor === p.initiatorConversationId)
+            return;
+        throw new Error("只有项目负责人或发起人可以登记顶层任务");
+    }
     manager(p, t, actor) {
         const manager = t.parentTaskId ? this.task(p, t.parentTaskId).ownerConversationId : p.ownerConversationId;
         if (actor && actor !== manager)
@@ -194,7 +203,7 @@ export class ProjectService {
         return t;
     }
     member(p, actor) {
-        if (actor && actor !== p.ownerConversationId && !p.tasks.some((t) => t.ownerConversationId === actor || t.reviewerConversationId === actor))
+        if (actor && actor !== p.ownerConversationId && actor !== p.initiatorConversationId && !p.tasks.some((t) => t.ownerConversationId === actor || t.reviewerConversationId === actor))
             throw new Error("调用会话不属于项目执行团队");
     }
     reconcile(p) {
@@ -250,7 +259,7 @@ export class ProjectService {
         }
         return undefined;
     }
-    async create(input) {
+    async create(input, initiatorConversationId) {
         const workspaceId = this.workspace(input.workspaceId);
         if (input.ownerConversationId !== undefined)
             throw new Error("项目负责人由启动操作创建独立会话");
@@ -258,12 +267,16 @@ export class ProjectService {
             throw new Error("项目风险等级不合法");
         if (input.budget !== undefined && (!input.budget || typeof input.budget !== "object" || Array.isArray(input.budget)))
             throw new Error("资源预算不合法");
-        for (const [key, value] of Object.entries(input.budget ?? {}))
+        for (const [key, value] of Object.entries(input.budget ?? {})) {
+            if (value === undefined)
+                continue;
             if (!["maxTokens", "maxConcurrent"].includes(key) || !Number.isSafeInteger(value) || value <= 0)
                 throw new Error("资源预算必须是正整数");
+        }
         const defaultLeaderProfile = profile(input.defaultLeaderProfile, "默认 Leader 配置");
         const defaultExecutorProfile = profile(input.defaultExecutorProfile, "默认执行配置");
         const defaultReviewerProfile = profile(input.defaultReviewerProfile, "默认复核配置");
+        const initiator = (initiatorConversationId ?? (typeof input.initiatorConversationId === "string" ? input.initiatorConversationId : undefined))?.trim() || undefined;
         const now = stamp();
         const p = { id: `project_${randomUUID()}`, workspaceId, title: text(input.title, "项目标题"), objective: text(input.objective, "项目目标"),
             deliverables: strings(input.deliverables, "交付物"), acceptanceCriteria: strings(input.acceptanceCriteria, "验收标准"), constraints: strings(input.constraints, "约束"),
@@ -271,8 +284,14 @@ export class ProjectService {
             ...(defaultLeaderProfile ? { defaultLeaderProfile } : {}),
             ...(defaultExecutorProfile ? { defaultExecutorProfile } : {}),
             ...(defaultReviewerProfile ? { defaultReviewerProfile } : {}),
+            ...(initiator ? { initiatorConversationId: initiator } : {}),
             tasks: [], reports: [], escalations: [], events: [], createdAt: now, updatedAt: now };
-        this.event(p, "created", "Boss 触发项目");
+        if (initiator) {
+            this.event(p, "created", "Agent 触发项目", undefined, initiator);
+        }
+        else {
+            this.event(p, "created", "Boss 触发项目");
+        }
         const saved = await this.store.setProject(p);
         return this.projectView(saved);
     }
@@ -303,7 +322,7 @@ export class ProjectService {
     }
     async start(id, workspaceId, actor) {
         return this.change(id, workspaceId, async (p) => {
-            this.leader(p, actor);
+            this.topLevelAuthor(p, actor);
             this.admission(p, false);
             if (!this.orchestrator)
                 throw new Error("会话编排服务未就绪");
@@ -334,7 +353,9 @@ export class ProjectService {
         return this.change(id, workspaceId, (p) => {
             this.live(p);
             const parentTaskId = optional(input.parentTaskId, "父任务 id");
-            let manager = p.ownerConversationId;
+            // A top-level task is accountable to whoever owns the project: the leader once it runs, and
+            // before that the initiator who registered it - a task nobody answers for cannot be closed.
+            let manager = p.ownerConversationId ?? p.initiatorConversationId;
             if (parentTaskId) {
                 const parent = this.task(p, parentTaskId);
                 if (parent.role !== "leader" || parent.status !== "in_progress" || !parent.ownerConversationId)
@@ -352,7 +373,7 @@ export class ProjectService {
                     throw new Error("Leader 最多 3 层，请改为执行任务");
             }
             else
-                this.leader(p, actor);
+                this.topLevelAuthor(p, actor);
             if (input.role !== undefined && input.role !== "leader" && input.role !== "executor")
                 throw new Error("任务角色必须是 leader 或 executor");
             const dependencies = strings(input.dependencies, "任务依赖");
@@ -723,12 +744,104 @@ export class ProjectService {
             return p;
         });
     }
+    /**
+     * The tasks an initiator hands over with create. A dependency names the TITLE of another task in
+     * the same batch, because the batch carries no task IDs yet - the service assigns them while it
+     * registers the batch. The plan comes back in dependency order, so the plain add_task rules
+     * (title, objective, priority, sibling dependencies) can be reused unchanged.
+     */
+    planTopLevelTasks(batch) {
+        if (batch === undefined || batch === null)
+            return [];
+        if (!Array.isArray(batch))
+            throw new Error("tasks 必须是任务数组");
+        if (batch.length > 100)
+            throw new Error("项目最多 100 个任务，请收敛分工范围");
+        const items = batch.map((raw) => {
+            if (!raw || typeof raw !== "object" || Array.isArray(raw))
+                throw new Error("tasks 的每一项必须是任务对象");
+            const record = raw;
+            const priority = record.priority;
+            if (priority !== undefined && !["low", "medium", "high", "urgent"].includes(String(priority)))
+                throw new Error("任务优先级不合法");
+            return {
+                title: text(record.title, "任务标题"),
+                objective: text(record.objective, "任务目标"),
+                deliverables: record.deliverables === undefined ? undefined : strings(record.deliverables, "任务交付物"),
+                acceptanceCriteria: record.acceptanceCriteria === undefined ? undefined : strings(record.acceptanceCriteria, "任务验收标准"),
+                priority: priority,
+                dependencies: record.dependencies === undefined ? [] : strings(record.dependencies, "任务依赖"),
+            };
+        });
+        const index = new Map();
+        items.forEach((item, at) => {
+            if (index.has(item.title))
+                throw new Error(`任务标题重复：${item.title}`);
+            index.set(item.title, at);
+        });
+        const edges = items.map((item) => item.dependencies.map((dependency) => {
+            const at = index.get(dependency);
+            if (at === undefined)
+                throw new Error(`任务依赖不存在：${dependency}`);
+            return at;
+        }));
+        const ordered = [];
+        const done = new Set();
+        while (ordered.length < items.length) {
+            let progressed = false;
+            for (let at = 0; at < items.length; at += 1) {
+                if (done.has(at))
+                    continue;
+                if (!edges[at].every((dependency) => done.has(dependency)))
+                    continue;
+                ordered.push(items[at]);
+                done.add(at);
+                progressed = true;
+            }
+            if (!progressed)
+                throw new Error("任务依赖存在循环，无法登记顶层任务");
+        }
+        return ordered;
+    }
+    async registerTopLevelTasks(projectId, plan, workspaceId, actor) {
+        const ids = new Map();
+        for (const item of plan) {
+            const dependencies = item.dependencies.map((dependency) => ids.get(dependency));
+            const task = await this.addTask(projectId, {
+                title: item.title, objective: item.objective,
+                ...(item.deliverables ? { deliverables: item.deliverables } : {}),
+                ...(item.acceptanceCriteria ? { acceptanceCriteria: item.acceptanceCriteria } : {}),
+                ...(item.priority !== undefined ? { priority: item.priority } : {}),
+                dependencies,
+            }, workspaceId, actor);
+            ids.set(item.title, task.id);
+        }
+    }
     async tool(body, workspaceId, actor) {
+        if (body.action === "create") {
+            // ONLY A ROOT CONVERSATION MAY OPEN A PROJECT. Every dispatched session - the leader, its
+            // reviewers, the workers - holds the same tool, and a project opened from one of them would
+            // carry its own budget and concurrency guards while sitting outside the guard that dispatched it.
+            const conversation = this.store.conversation(actor);
+            if (!conversation)
+                throw new Error("找不到这个会话。");
+            if (conversation.parentConversationId)
+                throw new Error("只有主对话可以创建项目：派发出来的会话不能另起项目，否则会绕过项目的预算与并发护栏。");
+            const running = this.store.projects().filter((p) => p.initiatorConversationId === actor && !closed(p));
+            if (running.length >= 3)
+                throw new Error("你同时进行的项目超过上限（3 个），先完成或停止一个再新建。");
+            const { tasks: batch, ...input } = body;
+            const plan = this.planTopLevelTasks(batch);
+            const project = await this.create({ ...input, workspaceId }, actor);
+            await this.registerTopLevelTasks(project.id, plan, workspaceId, actor);
+            return this.get(project.id, workspaceId);
+        }
         const id = text(body.projectId, "projectId");
         const p = this.get(id, workspaceId);
         this.member(p, actor);
         switch (body.action) {
             case "get": return p;
+            case "start": return this.start(id, workspaceId, actor);
             case "add_task": return this.addTask(id, body, workspaceId, actor);
             case "dispatch": return this.dispatchTask(id, text(body.taskId, "taskId"), workspaceId, actor);
             case "submit": return this.submit(id, text(body.taskId, "taskId"), body, workspaceId, actor);

package/dist/server/types.d.ts

@@ -996,6 +996,9 @@ export type Project = {
     risk: ProjectRisk;
     status: ProjectStatus;
     ownerConversationId?: string;
+    /** The session that created the project - the Boss's own conversation, which may register the
+     *  top-level tasks and is the one the project answers to. */
+    initiatorConversationId?: string;
     budget?: {
         maxTokens?: number;
         maxConcurrent?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evandu/super-pi",
-  "version": "0.1.156",
+  "version": "0.1.157",
   "description": "Web control plane and companion for Pi",
   "license": "MIT",
   "type": "module",