@agentstorm/server 0.2.5

package/dist/pipeline-status.d.ts

@@ -0,0 +1,20 @@
+import type { ApprovalRequest, PipelineRun } from "@agentstorm/protocol";
+export type PipelineNextAction = "wait" | "human_approval" | "human_intervention" | "resume_node" | "completed" | "none";
+export interface PipelineStatusNotification {
+    kind: "approval_required" | "human_required" | "blocked" | "completed" | "progress";
+    message: string;
+    at: string;
+}
+/**
+ * Translate the durable PipelineRun phase into a small, model-readable
+ * notification.  This is deliberately derived from persisted state rather
+ * than pushed as an unsolicited chat message: a Main Agent can call
+ * pipeline_status at any time and will not miss a transition after a restart.
+ */
+export declare function buildPipelineStatusSummary(run: PipelineRun, approvals: ApprovalRequest[]): {
+    nextAction: PipelineNextAction;
+    notifications: PipelineStatusNotification[];
+    canRevisePlan: boolean;
+    revisionCommand: string | null;
+};
+//# sourceMappingURL=pipeline-status.d.ts.map

package/dist/pipeline-status.js

@@ -0,0 +1,75 @@
+/**
+ * Translate the durable PipelineRun phase into a small, model-readable
+ * notification.  This is deliberately derived from persisted state rather
+ * than pushed as an unsolicited chat message: a Main Agent can call
+ * pipeline_status at any time and will not miss a transition after a restart.
+ */
+export function buildPipelineStatusSummary(run, approvals) {
+    const revisionCapability = {
+        canRevisePlan: run.phase !== "cancelled",
+        revisionCommand: run.phase === "cancelled"
+            ? null
+            : 'agentstorm pipeline extend --request "<修改要求>"',
+    };
+    const pendingApprovals = approvals.filter((approval) => approval.status === "pending");
+    if (run.phase === "awaiting_approval" || pendingApprovals.length > 0) {
+        return {
+            ...revisionCapability,
+            nextAction: "human_approval",
+            notifications: [{
+                    kind: "approval_required",
+                    message: "计划等待用户审批；主 Agent 不得代替用户批准。",
+                    at: run.updatedAt,
+                }],
+        };
+    }
+    if (run.phase === "waiting_human" ||
+        (run.phase === "paused" && run.blockReason === "waiting_human")) {
+        return {
+            ...revisionCapability,
+            nextAction: "human_intervention",
+            notifications: [
+                {
+                    kind: "human_required",
+                    message: "当前节点等待用户完成登录、授权或其他外部操作；打开对应节点处理请求。",
+                    at: run.updatedAt,
+                },
+            ],
+        };
+    }
+    if (run.phase === "blocked") {
+        return {
+            ...revisionCapability,
+            nextAction: "resume_node",
+            notifications: [{
+                    kind: "blocked",
+                    message: `流水线已阻塞${run.blockReason ? `：${run.blockReason}` : ""}；向阻塞节点发送说明即可在原 ExecuteRun 上恢复。`,
+                    at: run.updatedAt,
+                }],
+        };
+    }
+    if (run.phase === "done" || run.phase === "cancelled") {
+        return {
+            ...revisionCapability,
+            nextAction: "completed",
+            notifications: [{
+                    kind: "completed",
+                    message: run.phase === "done" ? "流水线已完成。" : "流水线已取消。",
+                    at: run.updatedAt,
+                }],
+        };
+    }
+    if (run.phase === "planning" || run.phase === "ready" || run.phase === "executing" || run.phase === "paused") {
+        return {
+            ...revisionCapability,
+            nextAction: "wait",
+            notifications: [{
+                    kind: "progress",
+                    message: `流水线当前阶段：${run.phase}。AgentStorm 将继续负责阶段转换。`,
+                    at: run.updatedAt,
+                }],
+        };
+    }
+    return { ...revisionCapability, nextAction: "none", notifications: [] };
+}
+//# sourceMappingURL=pipeline-status.js.map

package/dist/template-library.d.ts

@@ -0,0 +1,87 @@
+import { type WorkflowSpec } from "@agentstorm/protocol";
+export type TemplateGraph = "plan" | "execute";
+export interface TemplateCanvasLayout {
+    plan?: Record<string, {
+        x: number;
+        y: number;
+    }>;
+    execute?: Record<string, {
+        x: number;
+        y: number;
+    }>;
+    edgeHandles?: Partial<Record<TemplateGraph, Record<string, {
+        sourceHandle?: string;
+        targetHandle?: string;
+    }>>>;
+}
+export interface TemplateAgentConfig {
+    backend?: "paseo";
+    provider?: string;
+    model?: string;
+    mode?: string;
+    thinking?: string;
+}
+export interface GlobalTemplateManifest {
+    schemaVersion: 1;
+    id: string;
+    name: string;
+    description: string;
+    version: number;
+    seeded: boolean;
+    updatedAt: string;
+}
+export interface GlobalTemplateSummary extends GlobalTemplateManifest {
+    etag: string;
+}
+export interface GlobalTemplateDocument extends GlobalTemplateSummary {
+    spec: WorkflowSpec;
+    layout: TemplateCanvasLayout;
+    assets: Record<string, string>;
+}
+export interface GlobalTemplateInput {
+    id?: string;
+    name: string;
+    description?: string;
+    spec: unknown;
+    layout?: unknown;
+    assets?: Record<string, unknown>;
+}
+export interface MaterializedWorkflow {
+    id: string;
+    spec: WorkflowSpec;
+    etag: string;
+    updatedAt: string;
+    version: number;
+    templateId: string;
+    templateVersion: number;
+}
+export declare function resolveBuiltinTemplateRoot(options?: {
+    home?: string;
+    moduleUrl?: string;
+    resourcesPath?: string;
+}): string;
+export declare function resolveTemplateRoot(options?: {
+    home?: string;
+}): string;
+export declare class GlobalTemplateLibrary {
+    readonly rootPath: string;
+    constructor(options?: {
+        home?: string;
+    });
+    list(): GlobalTemplateSummary[];
+    get(id: string): GlobalTemplateDocument;
+    create(input: GlobalTemplateInput): GlobalTemplateDocument;
+    update(id: string, input: GlobalTemplateInput, expectedEtag?: string): GlobalTemplateDocument;
+    delete(id: string): void;
+    materialize(id: string, workspaceRoot: string, options?: {
+        agentConfig?: TemplateAgentConfig;
+        name?: string;
+    }): MaterializedWorkflow;
+    private ensureSeedTemplates;
+    private migrateGeneralWorkflowId;
+    private retireLegacySeedTemplates;
+    private normalizeLegacyManifest;
+    private templateDir;
+    private writeDocument;
+}
+//# sourceMappingURL=template-library.d.ts.map