stageflow 0.33.0 → 0.36.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

@@ -1,11 +1,11 @@
-import type { LoadedStageConfig, StageBrowserConfig, StageGateKind, StageIoYaml } from "./stage.js";
+import type { LoadedStageConfig, StageChannel, StageBrowserConfig, StageGateKind, StageIoYaml } from "./stage.js";
 import type { CompletionContract, RecoveryPolicy } from "./completion.js";
 import type { StageSecretDecl } from "../runtime/stageSecretDecl.js";
 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;
@@ -13,6 +13,8 @@ export type PipelineConfig = {
     schemas?: Record<string, unknown>;
     /** Declared toolchain binaries this pipeline needs (Slot 9). */
     requires?: ToolRequirement[];
+    /** Default channels inherited by every stage that does not override them. */
+    channels?: StageChannel[];
 };
 /** An inline pipeline definition authored directly in a `start_run` call, with no backing file. */
 export type InlinePipelineDefinition = {
@@ -22,6 +24,7 @@ export type InlinePipelineDefinition = {
     model?: unknown;
     schemas?: unknown;
     requires?: unknown;
+    channels?: unknown;
 };
 export type PipelineForkConfig = {
     select: "one" | "subset";

package/dist/types/stage.d.ts

@@ -36,6 +36,17 @@ export type StageBrowserConfig = {
         logged_out_url?: string | string[];
     };
 };
+export type StageChannelOperation = "send";
+/** A pinned communication target for a stage. Targets are validated per provider. */
+export type StageChannel = {
+    alias?: string;
+    connection: string;
+    operations: StageChannelOperation[];
+    to: string | string[];
+    cc?: string[];
+    /** Provider-specific message template, such as a pinned WhatsApp template. Validated by the provider. */
+    template?: Record<string, unknown>;
+};
 export type StageConfig = {
     id: string;
     system_prompt: string;
@@ -56,6 +67,8 @@ export type StageConfig = {
         operations: ("send" | "reply" | "getMessage" | "search" | "downloadAttachment")[];
     }[];
     mcp?: string[];
+    /** Communication channels this stage may send on. Inherits pipeline `channels` defaults. */
+    channels?: StageChannel[];
     /** Declared Host secret names this stage may receive (Slot 6). */
     secrets?: StageSecretDecl[];
     /** Declared toolchain binaries this stage needs (Slot 9). */
@@ -63,7 +76,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;