stageflow 0.32.0 → 0.35.0

package/dist/tools/writeStageArtifact.js

@@ -7,11 +7,9 @@
  * Parameter schemas use `typebox` (Pi's `defineTool` TSchema), not
  * `@sinclair/typebox`. Unlike emit, this tool does not terminate the turn.
  */
-import { randomBytes } from "node:crypto";
-import { lstat, realpath, rename, unlink, writeFile } from "node:fs/promises";
-import path from "node:path";
 import { Type } from "typebox";
-import { ensureRealArtifactsDir, isInsideDir, resolveArtifactTarget, resolveContainedParent, } from "../runstore/workspaceLayout.js";
+import { resolveArtifactTarget } from "../runstore/workspaceLayout.js";
+import { writeContainedArtifact } from "../runstore/writeContainedArtifact.js";
 function toolResult(text, details, options) {
     return {
         content: [{ type: "text", text }],
@@ -19,49 +17,6 @@ function toolResult(text, details, options) {
         ...(options?.isError ? { isError: true } : {}),
     };
 }
-async function assertSafeWriteTarget(targetPath) {
-    try {
-        const st = await lstat(targetPath);
-        if (st.isSymbolicLink()) {
-            throw new Error("path escapes the stage artifacts directory");
-        }
-        if (st.nlink > 1) {
-            throw new Error("refusing to overwrite hard-linked file");
-        }
-    }
-    catch (err) {
-        if (err.code !== "ENOENT") {
-            throw err;
-        }
-    }
-}
-async function writeContainedArtifact(runWorkspaceDir, artifactsDirectory, absolutePath, content) {
-    const { realArtifacts } = await ensureRealArtifactsDir(runWorkspaceDir, artifactsDirectory);
-    const relativeToArtifacts = path.relative(artifactsDirectory, absolutePath);
-    const parent = await resolveContainedParent(realArtifacts, relativeToArtifacts);
-    const baseName = path.basename(absolutePath);
-    const targetPath = path.join(parent, baseName);
-    await assertSafeWriteTarget(targetPath);
-    const tmpName = `.sf-artifact-${randomBytes(8).toString("hex")}.tmp`;
-    const tmpPath = path.join(parent, tmpName);
-    try {
-        await writeFile(tmpPath, content, "utf8");
-        await rename(tmpPath, targetPath);
-    }
-    catch (err) {
-        try {
-            await unlink(tmpPath);
-        }
-        catch {
-            // best-effort cleanup
-        }
-        throw err;
-    }
-    const realWritten = await realpath(targetPath);
-    if (!isInsideDir(realWritten, realArtifacts)) {
-        throw new Error("path escapes the stage artifacts directory");
-    }
-}
 export function createWriteStageArtifactTool(options) {
     const { runWorkspaceDir, stageId, attempt } = options;
     return {

package/dist/types/pipeline.d.ts

@@ -5,7 +5,7 @@ import type { ToolRequirement } from "../config/toolRequires.js";
 export type PipelineConfig = {
     id: string;
     stages: string[];
-    /** Selects the AgentPort backend for every stage in this pipeline; overrides the global default. */
+    /** Selects the StagePort backend for every stage in this pipeline; overrides the global default. */
     agent?: string;
     /** Default LLM model id for every stage in this pipeline; overrides the global default. */
     model?: string;

package/dist/types/stage.d.ts

@@ -63,7 +63,7 @@ export type StageConfig = {
     /** Browser session settings for this stage; adds the agent-browser requirement. */
     browser?: StageBrowserConfig;
     /**
-     * Selects the AgentPort backend for this stage, overriding pipeline/global.
+     * Selects the StagePort backend for this stage, overriding pipeline/global.
      * Parsed but not yet consulted — see STAGE_LEVEL_AGENT_OVERRIDE_ENABLED.
      */
     agent?: string;

package/dist/types/stageflowManifest.d.ts

@@ -13,7 +13,7 @@ export type StageflowManifestCatalog = {
 export type StageflowManifest = {
     version: StageflowManifestVersion;
     catalog: StageflowManifestCatalog;
-    /** Default AgentPort backend for every pipeline/stage that doesn't override it. */
+    /** Default StagePort backend for every pipeline/stage that doesn't override it. */
     agent?: string;
     /** Default LLM model id for every stage that doesn't override it at pipeline or stage level. */
     model?: string;