stageflow 0.35.0 → 0.36.0

package/dist/ui/index.html

@@ -13,8 +13,8 @@
     <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Figtree:wght@400;500;600;700&display=swap" />
     <link rel="icon" type="image/svg+xml" href="/stageflow-icon.svg" />
     <title>Stageflow</title>
-    <script type="module" crossorigin src="/assets/index-BoFPkKFg.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CIPbbBUi.css">
+    <script type="module" crossorigin src="/assets/index-BOhqnPNg.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-Clv4sJpU.css">
   </head>
   <body>
     <div id="root"></div>

package/examples/channels-smoke/README.md

@@ -0,0 +1,12 @@
+# Channels smoke test
+
+Two stages, one channel each: `send-email` sends one email (AgentMail) and then `send-text` sends one text (iMessage via Photon), through the connections on the Connections page. A stage can use one channel, so the two are separate stages. Nothing is sent until you start a run.
+
+1. Connect AgentMail and iMessage on the Connections page. The stage expects the connection ids `agentmail` and `imessage`; if yours differ, edit `connection:` in the two stage files.
+2. Pin your recipients: in `send-email.yaml` replace `to: [change-me@example.invalid]` with your email, and in `send-text.yaml` replace `to: "+10000000000"` with your phone in E.164 form (for example `+14155550123`). On a Free or Pro Photon project the phone must be a project user, and that person must have texted their assigned Photon line once, or the send is rejected.
+3. Change `model:` to one you have a provider for.
+4. Run `sf validate` on the pipeline, then open `channels-smoke` in the console and start it with `channels-smoke-task`. The run checks both connections live before the stage starts.
+
+The Claude agent backend does not provide `send_message`; use a Pi model (the default).
+
+The email subject is `Stageflow channels test`. The agent cannot change recipients, and declaring a second channel on either stage is rejected. A message that may have been sent is never resent: if a call returns `CHANNEL_SEND_OUTCOME_UNKNOWN`, check the provider before running again.

package/examples/channels-smoke/channels-smoke.pipeline.yaml

@@ -0,0 +1,11 @@
+id: channels-smoke
+stages:
+  - id: send-email
+    entry: true
+    uses: ./send-email.yaml
+    replay_safe: false
+    route:
+      - to: send-text
+  - id: send-text
+    uses: ./send-text.yaml
+    replay_safe: false

package/examples/channels-smoke/channels-smoke.task.yaml

@@ -0,0 +1,3 @@
+id: channels-smoke-task
+goal: Send one test email and one test text message through the connected channels.
+constraints: Send exactly one message per channel. Do not resend an uncertain submission.

package/examples/channels-smoke/send-email.yaml

@@ -0,0 +1,32 @@
+id: send-email
+# cursor/auto needs CURSOR_API_KEY on the host. Use another model if you prefer.
+model: cursor/auto
+# A stage uses one channel. Pin the recipient here: the agent can only send to it and cannot change it.
+# `connection` is the id shown on the Connections page.
+channels:
+  - connection: agentmail
+    to: [change-me@example.invalid]
+    operations: [send]
+io:
+  input:
+    schema:
+      type: object
+      additionalProperties: true
+  output:
+    schema:
+      type: object
+      required: [email]
+      properties:
+        email: { type: string, enum: [sent, failed] }
+      additionalProperties: false
+system_prompt: |
+  Send one test email, then report the result.
+  Call send_message once with operationKey "smoke-email", subject "Stageflow channels test"
+  and text "Hello! This email was sent by a Stageflow test pipeline."
+  The recipient is fixed by configuration; never try to choose or change it.
+  If the call is repeated, use the same operationKey and the same content.
+  Never resend an uncertain submission (code CHANNEL_SEND_OUTCOME_UNKNOWN) with a different key.
+  Do not send messages through shell commands or any other tool.
+  Write a short receipt via write_stage_artifact. Do not include secrets.
+  When finished, call emit_stage_envelope exactly once with payload.email set to "sent" or "failed".
+  If the send failed, use status failure.

package/examples/channels-smoke/send-text.yaml

@@ -0,0 +1,31 @@
+id: send-text
+model: cursor/auto
+# One channel per stage. The recipient is a phone number in E.164 form. On a Free or Pro Photon
+# project they must be a project user who has texted their assigned line once.
+channels:
+  - connection: imessage
+    to: "+10000000000"
+    operations: [send]
+io:
+  input:
+    schema:
+      type: object
+      additionalProperties: true
+  output:
+    schema:
+      type: object
+      required: [text]
+      properties:
+        text: { type: string, enum: [sent, failed] }
+      additionalProperties: false
+system_prompt: |
+  Send one test text message, then report the result.
+  Call send_message once with operationKey "smoke-text" and text
+  "Hello! This text was sent by a Stageflow test pipeline."
+  The recipient is fixed by configuration; never try to choose or change it.
+  If the call is repeated, use the same operationKey and the same content.
+  Never resend an uncertain submission (code CHANNEL_SEND_OUTCOME_UNKNOWN) with a different key.
+  Do not send messages through shell commands or any other tool.
+  Write a short receipt via write_stage_artifact. Do not include secrets.
+  When finished, call emit_stage_envelope exactly once with payload.text set to "sent" or "failed".
+  If the send failed, use status failure.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stageflow",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "description": "Stageflow — CLI pipeline runtime for configurable stages on Pi",
   "type": "module",
   "main": "./dist/index.js",
@@ -82,11 +82,11 @@
     "@modelcontextprotocol/node": "^2.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
     "better-sqlite3": "^13.0.3",
+    "croner": "^10.0.1",
     "imapflow": "^2.2.5",
+    "jiti": "^2.7.0",
     "mailparser": "^3.9.36",
     "nodemailer": "^10.0.15",
-    "croner": "^10.0.1",
-    "jiti": "^2.7.0",
     "octokit": "^5.0.5",
     "pi-cursor-sdk": "^0.5.0",
     "pi-mcp-adapter": "^2.32.1",
@@ -98,5 +98,10 @@
   },
   "allowScripts": {
     "better-sqlite3@13.0.3": true
+  },
+  "optionalDependencies": {
+    "@spectrum-ts/core": "12.10.1",
+    "@spectrum-ts/imessage": "12.10.1",
+    "@spectrum-ts/whatsapp-business": "12.10.1"
   }
 }