@agentstorm/server 0.2.5

package/dist/workflow-package.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The on-disk contract for a project Workflow.  A Workflow is one directory
+ * named by its display name; executable graph, canvas metadata and Prompt
+ * files are never split across sibling roots.
+ *
+ * .agentstorm/workflows/<display name>/
+ *   manifest.json
+ *   workflow.json
+ *   layout.json
+ *   prompts/<agent id>.md
+ *   assets/<...>
+ *   .versions/<n>.json
+ */
+export declare const WORKFLOW_PACKAGE_ROOT = ".agentstorm/workflows";
+export interface WorkflowPackageManifest {
+    schemaVersion: 1;
+    name: string;
+    description: string;
+    version: number;
+    source?: {
+        kind: "blank" | "template" | "bundle";
+        templateId?: string;
+        templateVersion?: number;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WorkflowPackagePaths {
+    root: string;
+    manifest: string;
+    workflow: string;
+    layout: string;
+    prompts: string;
+    assets: string;
+    versions: string;
+}
+export declare function assertWorkflowDisplayName(value: string): string;
+export declare function workflowPackagePaths(workspaceRoot: string, displayName: string): WorkflowPackagePaths;
+export declare function workflowPackageExists(workspaceRoot: string, displayName: string): boolean;
+export declare function listWorkflowPackageNames(workspaceRoot: string): string[];
+export declare function readJsonFile<T>(filePath: string): T;
+export declare function writeJsonAtomic(filePath: string, value: unknown): void;
+export declare function writeTextAtomic(filePath: string, value: string): void;
+export declare function safePackageRelativePath(value: string): string | null;
+export declare function assertInsidePackage(packageRoot: string, candidate: string): void;
+export declare function recordWorkflowPackageVersion(paths: WorkflowPackagePaths, raw: string): number;
+export declare function latestWorkflowPackageVersion(paths: WorkflowPackagePaths): number;
+export declare function workflowPromptRelativePath(nodeId: string): string;
+//# sourceMappingURL=workflow-package.d.ts.map

package/dist/workflow-package.js

@@ -0,0 +1,113 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+/**
+ * The on-disk contract for a project Workflow.  A Workflow is one directory
+ * named by its display name; executable graph, canvas metadata and Prompt
+ * files are never split across sibling roots.
+ *
+ * .agentstorm/workflows/<display name>/
+ *   manifest.json
+ *   workflow.json
+ *   layout.json
+ *   prompts/<agent id>.md
+ *   assets/<...>
+ *   .versions/<n>.json
+ */
+export const WORKFLOW_PACKAGE_ROOT = ".agentstorm/workflows";
+export function assertWorkflowDisplayName(value) {
+    const name = value.trim();
+    if (!name || name === "." || name === ".." || /[\\/\0]/.test(name)) {
+        throw new Error("Workflow 显示名称不能为空，且不能包含 /、\\ 或 NUL");
+    }
+    return name;
+}
+export function workflowPackagePaths(workspaceRoot, displayName) {
+    const name = assertWorkflowDisplayName(displayName);
+    const root = path.join(workspaceRoot, WORKFLOW_PACKAGE_ROOT, name);
+    return {
+        root,
+        manifest: path.join(root, "manifest.json"),
+        workflow: path.join(root, "workflow.json"),
+        layout: path.join(root, "layout.json"),
+        prompts: path.join(root, "prompts"),
+        assets: path.join(root, "assets"),
+        versions: path.join(root, ".versions"),
+    };
+}
+export function workflowPackageExists(workspaceRoot, displayName) {
+    const paths = workflowPackagePaths(workspaceRoot, displayName);
+    return fs.existsSync(paths.root) && fs.statSync(paths.root).isDirectory();
+}
+export function listWorkflowPackageNames(workspaceRoot) {
+    const root = path.join(workspaceRoot, WORKFLOW_PACKAGE_ROOT);
+    if (!fs.existsSync(root))
+        return [];
+    return fs.readdirSync(root, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && entry.name !== "." && entry.name !== ".." && !entry.name.startsWith("."))
+        .map((entry) => entry.name)
+        .filter((name) => {
+        try {
+            return fs.existsSync(workflowPackagePaths(workspaceRoot, name).workflow);
+        }
+        catch {
+            return false;
+        }
+    });
+}
+export function readJsonFile(filePath) {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+export function writeJsonAtomic(filePath, value) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const tmp = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+    fs.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+    fs.renameSync(tmp, filePath);
+}
+export function writeTextAtomic(filePath, value) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const tmp = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+    fs.writeFileSync(tmp, value, "utf8");
+    fs.renameSync(tmp, filePath);
+}
+export function safePackageRelativePath(value) {
+    const normalized = value.replaceAll("\\", "/");
+    if (!normalized || normalized.startsWith("/") || /^[A-Za-z]:\//.test(normalized))
+        return null;
+    const parts = normalized.split("/");
+    if (parts.some((part) => !part || part === "." || part === ".."))
+        return null;
+    return parts.join(path.sep);
+}
+export function assertInsidePackage(packageRoot, candidate) {
+    const root = path.resolve(packageRoot);
+    const target = path.resolve(candidate);
+    if (target !== root && !target.startsWith(`${root}${path.sep}`)) {
+        throw new Error("Workflow 资源路径超出 Workflow 包目录");
+    }
+}
+export function recordWorkflowPackageVersion(paths, raw) {
+    fs.mkdirSync(paths.versions, { recursive: true });
+    const versions = fs.readdirSync(paths.versions)
+        .map((file) => /^(\d+)\.json$/.exec(file)?.[1])
+        .filter(Boolean)
+        .map(Number);
+    const version = Math.max(0, ...versions) + 1;
+    writeTextAtomic(path.join(paths.versions, `${version}.json`), raw);
+    return version;
+}
+export function latestWorkflowPackageVersion(paths) {
+    if (!fs.existsSync(paths.versions))
+        return 0;
+    return fs.readdirSync(paths.versions)
+        .map((file) => /^(\d+)\.json$/.exec(file)?.[1])
+        .filter(Boolean)
+        .map(Number)
+        .filter((version) => Number.isSafeInteger(version) && version > 0)
+        .sort((a, b) => a - b)
+        .at(-1) ?? 0;
+}
+export function workflowPromptRelativePath(nodeId) {
+    const safe = nodeId.trim().replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "").toLowerCase();
+    return path.join("prompts", `${safe || "agent"}.md`);
+}
+//# sourceMappingURL=workflow-package.js.map

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@agentstorm/server",
+  "version": "0.2.5",
+  "description": "AgentStorm resident Pipeline service",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "@agentstorm/agent-runtime": "0.2.5",
+    "@agentstorm/kernel": "0.2.5",
+    "@agentstorm/protocol": "0.2.5",
+    "express": "^4.21.0"
+  },
+  "license": "AGPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "https://git.woa.com/jetteyang/agentstorm.git"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}