@powerhousedao/workflow 6.2.3-dev.20 → 6.2.3-dev.21

package/README.md

@@ -22,11 +22,11 @@ reactor piece that lets a workflow read and write documents.
 
 ## The three packages
 
-| Package | What it is |
-| --- | --- |
-| [`@powerhousedao/pieces-framework`](../pieces-framework) | The piece authoring API (Activepieces', vendored) plus `ctx.reactor`. |
-| `@powerhousedao/workflow` (this one) | Models, editors, assistant tools and the reactor piece. Loaded by Connect; its models are loaded by a reactor. |
-| `@powerhousedao/reactor-workflow` | The engine that runs a workflow: scheduler, executor, piece host, and the GraphQL surface. Arrives next. |
+| Package                                                  | What it is                                                                                                     |
+| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| [`@powerhousedao/pieces-framework`](../pieces-framework) | The piece authoring API (Activepieces', vendored) plus `ctx.reactor`.                                          |
+| `@powerhousedao/workflow` (this one)                     | Models, editors, assistant tools and the reactor piece. Loaded by Connect; its models are loaded by a reactor. |
+| `@powerhousedao/reactor-workflow`                        | The engine that runs a workflow: scheduler, executor, piece host, and the GraphQL surface. Arrives next.       |
 
 This package deliberately depends on neither the engine nor
 `@powerhousedao/reactor-api`, so Connect can load it without pulling a server
@@ -45,6 +45,12 @@ flag on, the reactor registers this package's two document models, so
 workflows and connections can be created and synced. Running them is the
 engine's job and follows in `@powerhousedao/reactor-workflow`.
 
+What that engine reads from the environment is declared under `config` in
+[`powerhouse.manifest.json`](./powerhouse.manifest.json) — every entry prefixed
+`PH_WORKFLOWS_`, each with its type, default and what it sets. The table in
+[`@powerhousedao/reactor-workflow`'s README](../reactor-workflow/README.md#configuration)
+explains them, including which ones a deployment should not leave unset.
+
 ## Developing
 
 ```sh

package/dist/browser/document-models-BYheX-te.js

@@ -0,0 +1,98 @@
+import { t as Connection } from "./module-12vI18HY.js";
+import { t as Workflow } from "./module-CYQnNZWl.js";
+//#region powerhouse.manifest.json
+var powerhouse_manifest_default = {
+	name: "@powerhousedao/workflow",
+	description: "Workflows in Connect: the workflow and connection document models, their editors and Workflow Studio, and the reactor piece.",
+	category: "",
+	publisher: {
+		"name": "@powerhousedao",
+		"url": "https://github.com/powerhouse-inc/powerhouse/tree/main/packages/workflow"
+	},
+	documentModels: [{
+		"id": "powerhouse/workflow",
+		"name": "Workflow"
+	}, {
+		"id": "powerhouse/connection",
+		"name": "Connection"
+	}],
+	apps: [{
+		"id": "workflow-studio",
+		"name": "Workflow Studio",
+		"documentTypes": ["powerhouse/document-drive"]
+	}],
+	editors: [{
+		"id": "workflow-editor",
+		"name": "Workflow Editor",
+		"documentTypes": ["powerhouse/workflow"]
+	}, {
+		"id": "connection-editor",
+		"name": "Connection Editor",
+		"documentTypes": ["powerhouse/connection"]
+	}],
+	pieces: [{
+		"id": "@powerhousedao/piece-reactor",
+		"name": "Powerhouse Reactor"
+	}],
+	processors: [],
+	subgraphs: [],
+	config: [
+		{
+			"name": "PH_WORKFLOWS_SECRETS_MASTER_KEY",
+			"type": "secret",
+			"description": "64 hex chars (32 bytes) encrypting connection secrets at rest. Unset, a key is generated at ./.ph/secrets.key and reused; a host whose working directory does not survive a restart must set this or every stored secret becomes undecryptable."
+		},
+		{
+			"name": "PH_WORKFLOWS_EGRESS_ALLOW_ADDRESSES",
+			"type": "var",
+			"description": "Comma-separated addresses or CIDRs a piece may reach, widening the default policy that refuses private and loopback space. A bare address is taken as one host. Applies to steps and to design-time piece code alike."
+		},
+		{
+			"name": "PH_WORKFLOWS_RUN_CONCURRENCY",
+			"type": "var",
+			"description": "How many runs execute at once. Each slot is a forked node process, so this is the reactor's real connector concurrency.",
+			"default": "4"
+		},
+		{
+			"name": "PH_WORKFLOWS_RUN_QUEUE_DEPTH",
+			"type": "var",
+			"description": "How many runs may wait for a slot before new ones are refused. 0 waits without limit, turning saturation into latency rather than failures.",
+			"default": "0"
+		},
+		{
+			"name": "PH_WORKFLOWS_POLL_INTERVAL_MS",
+			"type": "var",
+			"description": "Cadence for a polling trigger that names none of its own. An author's override and a piece's requested schedule both win over it; a 1000ms floor applies to all three.",
+			"default": "60000"
+		},
+		{
+			"name": "PH_WORKFLOWS_WEBHOOK_RECONCILE_MS",
+			"type": "var",
+			"description": "How often a webhook trigger re-registers with its provider, so a registration the provider dropped comes back.",
+			"default": "900000"
+		},
+		{
+			"name": "PH_WORKFLOWS_WEBHOOK_TIMEOUT_MS",
+			"type": "var",
+			"description": "How long a sync-mode delivery holds the provider's socket. Past it the run continues and the provider is told so, lest a wedged step tie up connections.",
+			"default": "30000"
+		},
+		{
+			"name": "PH_WORKFLOWS_PIECE_MAX_FILE_BYTES",
+			"type": "var",
+			"description": "File-size ceiling for both directions: a FILE property hydrated from a URL, data URI or attachment ref, and ctx.files.write.",
+			"default": "8388608"
+		}
+	]
+};
+//#endregion
+//#region document-models/document-models.ts
+/**
+* WARNING: DO NOT EDIT
+* This file is auto-generated and updated by codegen
+*/
+const documentModels = [Connection, Workflow];
+//#endregion
+export { powerhouse_manifest_default as n, documentModels as t };
+
+//# sourceMappingURL=document-models-BYheX-te.js.map

package/dist/browser/{document-models-vmNTCrKx.js.map → document-models-BYheX-te.js.map}

@@ -1 +1 @@
-{"version":3,"file":"document-models-vmNTCrKx.js","names":["ConnectionV1","WorkflowV1"],"sources":["../../powerhouse.manifest.json","../../document-models/document-models.ts"],"sourcesContent":["","import { Connection as ConnectionV1 } from \"document-models/connection/v1\";\nimport { Workflow as WorkflowV1 } from \"document-models/workflow/v1\";\n\n/**\n * WARNING: DO NOT EDIT\n * This file is auto-generated and updated by codegen\n */\n\nexport const documentModels = [ConnectionV1, WorkflowV1] as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACQA,MAAa,iBAAiB,CAACA,YAAcC,SAAW"}
+{"version":3,"file":"document-models-BYheX-te.js","names":["ConnectionV1","WorkflowV1"],"sources":["../../powerhouse.manifest.json","../../document-models/document-models.ts"],"sourcesContent":["","import { Connection as ConnectionV1 } from \"document-models/connection/v1\";\nimport { Workflow as WorkflowV1 } from \"document-models/workflow/v1\";\n\n/**\n * WARNING: DO NOT EDIT\n * This file is auto-generated and updated by codegen\n */\n\nexport const documentModels = [ConnectionV1, WorkflowV1] as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACQA,MAAa,iBAAiB,CAACA,YAAcC,SAAW"}

package/dist/browser/index.js

@@ -1,4 +1,4 @@
-import { n as powerhouse_manifest_default, t as documentModels } from "./document-models-vmNTCrKx.js";
+import { n as powerhouse_manifest_default, t as documentModels } from "./document-models-BYheX-te.js";
 import { C as connectorIdForPiece, D as planFromAuth, E as packageFromConnectorId, T as isConfigValueMissing, a as fetchConnections, c as fetchPieceTriggers, f as fireWorkflow, l as fetchRuns, n as checkConnection, o as fetchPieceActions, p as getBlockForm, s as fetchPieceCatalog, t as DEFAULT_RUNTIME_URL, x as CORE_FORMS, y as setRuntimeUrl } from "./runtime-api-DQa04P3e.js";
 import { t as upgradeManifests } from "./upgrade-manifests-Cnpfo6kC.js";
 import { ConnectionEditor } from "./editors/connection-editor/module.js";

package/dist/browser/reactor/index.js

@@ -1,4 +1,4 @@
-import { n as powerhouse_manifest_default, t as documentModels } from "../document-models-vmNTCrKx.js";
+import { n as powerhouse_manifest_default, t as documentModels } from "../document-models-BYheX-te.js";
 import { t as upgradeManifests } from "../upgrade-manifests-Cnpfo6kC.js";
 //#region reactor/index.ts
 const manifest = powerhouse_manifest_default;

package/dist/node/index.mjs

@@ -43,7 +43,54 @@ var powerhouse_manifest_default = {
 	}],
 	processors: [],
 	subgraphs: [],
-	config: []
+	config: [
+		{
+			"name": "PH_WORKFLOWS_SECRETS_MASTER_KEY",
+			"type": "secret",
+			"description": "64 hex chars (32 bytes) encrypting connection secrets at rest. Unset, a key is generated at ./.ph/secrets.key and reused; a host whose working directory does not survive a restart must set this or every stored secret becomes undecryptable."
+		},
+		{
+			"name": "PH_WORKFLOWS_EGRESS_ALLOW_ADDRESSES",
+			"type": "var",
+			"description": "Comma-separated addresses or CIDRs a piece may reach, widening the default policy that refuses private and loopback space. A bare address is taken as one host. Applies to steps and to design-time piece code alike."
+		},
+		{
+			"name": "PH_WORKFLOWS_RUN_CONCURRENCY",
+			"type": "var",
+			"description": "How many runs execute at once. Each slot is a forked node process, so this is the reactor's real connector concurrency.",
+			"default": "4"
+		},
+		{
+			"name": "PH_WORKFLOWS_RUN_QUEUE_DEPTH",
+			"type": "var",
+			"description": "How many runs may wait for a slot before new ones are refused. 0 waits without limit, turning saturation into latency rather than failures.",
+			"default": "0"
+		},
+		{
+			"name": "PH_WORKFLOWS_POLL_INTERVAL_MS",
+			"type": "var",
+			"description": "Cadence for a polling trigger that names none of its own. An author's override and a piece's requested schedule both win over it; a 1000ms floor applies to all three.",
+			"default": "60000"
+		},
+		{
+			"name": "PH_WORKFLOWS_WEBHOOK_RECONCILE_MS",
+			"type": "var",
+			"description": "How often a webhook trigger re-registers with its provider, so a registration the provider dropped comes back.",
+			"default": "900000"
+		},
+		{
+			"name": "PH_WORKFLOWS_WEBHOOK_TIMEOUT_MS",
+			"type": "var",
+			"description": "How long a sync-mode delivery holds the provider's socket. Past it the run continues and the provider is told so, lest a wedged step tie up connections.",
+			"default": "30000"
+		},
+		{
+			"name": "PH_WORKFLOWS_PIECE_MAX_FILE_BYTES",
+			"type": "var",
+			"description": "File-size ceiling for both directions: a FILE property hydrated from a URL, data URI or attachment ref, and ctx.files.write.",
+			"default": "8388608"
+		}
+	]
 };
 //#endregion
 //#region ai/runtime-url.ts

package/dist/node/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["READ_ONLY","runConnectionCheck","ConnectionV1","WorkflowV1","manifestJson"],"sources":["../../powerhouse.manifest.json","../../ai/runtime-url.ts","../../ai/workflow-tools.ts","../../ai/tools.ts","../../document-models/document-models.ts","../../editors/editors.ts","../../index.ts"],"sourcesContent":["","// Points the module-level runtime client at the selected drive's\n// workflow-runtime subgraph before an AI tool talks to it.\nimport { resolveDriveSwitchboard } from \"@powerhousedao/reactor-browser/ai\";\nimport {\n  DEFAULT_RUNTIME_URL,\n  setRuntimeUrl,\n} from \"../editors/workflow-editor/runtime-api.js\";\n\nexport function syncRuntimeUrl(): void {\n  if (typeof window === \"undefined\") return;\n  const switchboard = resolveDriveSwitchboard(window.ph?.selectedDriveId);\n  // No resolvable switchboard (no selection, or a local/unsynced drive):\n  // reset to the default rather than leaving a prior drive's URL attached.\n  setRuntimeUrl(\n    switchboard\n      ? `${switchboard.graphqlUrl}/workflow-runtime`\n      : DEFAULT_RUNTIME_URL,\n  );\n}\n","// AI tool descriptors for authoring and running workflows: the exact block\n// types a piece offers, a block's config props, the built-in core blocks with\n// the expression syntax, run history and manual firing. Complements the\n// connector/connection tools in tools.ts, which cover the catalog and auth.\nimport type { PhAiToolDescriptor } from \"@powerhousedao/shared/document-model\";\nimport { z } from \"zod\";\nimport {\n  fetchPieceActions,\n  fetchPieceTriggers,\n  fetchRuns,\n  fireWorkflow,\n  getBlockForm,\n} from \"../editors/workflow-editor/runtime-api.js\";\nimport {\n  CORE_FORMS,\n  type BlockFormProp,\n} from \"../editors/workflow-editor/ui/forms.js\";\nimport { syncRuntimeUrl } from \"./runtime-url.js\";\n\nconst READ_ONLY = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: false,\n} as const;\n\n// Core blocks that are triggers. A piece's trigger says so in its own block\n// type, which is how every document trigger is classified now.\nconst CORE_TRIGGERS = new Set([\"core#manual\", \"core#schedule\", \"core#webhook\"]);\n\nfunction kindOf(blockType: string): \"trigger\" | \"step\" {\n  return CORE_TRIGGERS.has(blockType) || blockType.includes(\"#trigger:\")\n    ? \"trigger\"\n    : \"step\";\n}\n\nfunction portsFor(blockType: string): string[] {\n  return blockType === \"core#branch\" ? [\"true\", \"false\"] : [\"next\"];\n}\n\nfunction describeProp(prop: BlockFormProp) {\n  return {\n    name: prop.name,\n    label: prop.displayName,\n    type: prop.type,\n    required: prop.required,\n    ...(prop.description ? { description: prop.description } : {}),\n    ...(prop.defaultValue !== undefined ? { default: prop.defaultValue } : {}),\n    ...(prop.staticOptions\n      ? { options: prop.staticOptions.map((option) => option.value) }\n      : {}),\n    ...(prop.hasDynamicResolver ? { dynamicOptions: true } : {}),\n  };\n}\n\nconst EXPRESSIONS = [\n  \"Step configs and edge conditions may contain expressions in double braces.\",\n  \"{{trigger.payload.<field>}} reads the trigger payload: for core#manual the payload passed to fireWorkflow; for the reactor piece's document triggers it carries documentId, documentType, driveId and name.\",\n  \"{{steps.<key>.output.<path>}} reads an upstream step's output by that step's key, e.g. {{steps.fetch.output.body.title}}.\",\n  \"{{variables.<key>}} reads a workflow variable.\",\n  \"'a' || 'b' picks the first non-empty value, e.g. {{trigger.payload.url || 'https://example.com'}}.\",\n  \"A whole-string expression yields the raw value; text around expressions is interpolated.\",\n];\n\nconst GRAPH_RULES = [\n  \"A workflow is a powerhouse/workflow document. Build it with SET_TRIGGER once, ADD_STEP per step (each with a unique id and key), and ADD_EDGE from the trigger id to the first step and between steps.\",\n  \"Edges use port 'next' for the trigger and ordinary steps; core#branch emits 'true' and 'false'.\",\n  \"Piece block types are '<package>@<version>#<action>' for actions and '<package>@<version>#trigger:<trigger>' for triggers. Always use the pinned strings returned by getWorkflowPieceBlocks.\",\n  \"Steps whose piece needs a connection must set connectionId to a powerhouse/connection document id (see getConnections).\",\n  \"Only workflows with status ENABLED get trigger instances and can be fired; set it with SET_WORKFLOW_STATUS.\",\n];\n\nexport const getWorkflowPieceBlocksTool: PhAiToolDescriptor = {\n  name: \"getWorkflowPieceBlocks\",\n  description:\n    \"Lists the actions and triggers of one Activepieces piece with the exact, version-pinned blockType to use in ADD_STEP or SET_TRIGGER. Takes the piece package name from getConnectors. Call getWorkflowBlockConfig next for a block's config props.\",\n  inputSchema: {\n    packageName: z\n      .string()\n      .describe(\"Piece package name, e.g. @activepieces/piece-http.\"),\n  },\n  annotations: { title: \"Get Workflow Piece Blocks\", ...READ_ONLY },\n  callback: async (args: { packageName: string }) => {\n    syncRuntimeUrl();\n    const [actions, triggers] = await Promise.all([\n      fetchPieceActions(args.packageName),\n      fetchPieceTriggers(args.packageName),\n    ]);\n    return {\n      packageName: args.packageName,\n      actions: actions.map((action) => ({\n        blockType: action.blockType,\n        displayName: action.displayName,\n        description: action.description,\n      })),\n      triggers: triggers.map((trigger) => ({\n        blockType: trigger.blockType,\n        displayName: trigger.displayName,\n        description: trigger.description,\n        strategy: trigger.strategy,\n      })),\n    };\n  },\n};\n\nexport const getWorkflowBlockConfigTool: PhAiToolDescriptor = {\n  name: \"getWorkflowBlockConfig\",\n  description:\n    \"Describes the config of a block type (core#… or a piece blockType): prop names, types, whether required, allowed options, the output ports, and whether a connection is needed. Use it before writing a step or trigger config.\",\n  inputSchema: {\n    blockType: z\n      .string()\n      .describe(\n        \"Block type, e.g. core#branch or @activepieces/piece-http@0.11.19#send_request.\",\n      ),\n  },\n  annotations: { title: \"Get Workflow Block Config\", ...READ_ONLY },\n  callback: async (args: { blockType: string }) => {\n    const { blockType } = args;\n    if (!Object.hasOwn(CORE_FORMS, blockType)) syncRuntimeUrl();\n    const form = await getBlockForm(blockType);\n    if (!form) {\n      return {\n        blockType,\n        error:\n          \"Unknown block type. Use getConnectors and getWorkflowPieceBlocks to find valid block types (documents live in @powerhousedao/piece-reactor), or listWorkflowCoreBlocks for built-ins.\",\n      };\n    }\n    return {\n      blockType,\n      title: form.title,\n      kind: kindOf(blockType),\n      requiresConnection: form.auth === \"required\",\n      props: form.props.map(describeProp),\n      ports: portsFor(blockType),\n    };\n  },\n};\n\nexport const listWorkflowCoreBlocksTool: PhAiToolDescriptor = {\n  name: \"listWorkflowCoreBlocks\",\n  description:\n    \"Lists the built-in core#… blocks (manual, schedule and webhook triggers, branch and assert) with their config props, plus the expression syntax and the rules for building a powerhouse/workflow document. Documents are read and written by the @powerhousedao/piece-reactor blocks; list those with getWorkflowPieceBlocks.\",\n  inputSchema: {},\n  annotations: { title: \"List Workflow Core Blocks\", ...READ_ONLY },\n  callback: () =>\n    Promise.resolve({\n      blocks: Object.entries(CORE_FORMS).map(([blockType, form]) => ({\n        blockType,\n        title: form.title,\n        kind: kindOf(blockType),\n        props: form.props.map(describeProp),\n        ports: portsFor(blockType),\n      })),\n      expressions: EXPRESSIONS,\n      rules: GRAPH_RULES,\n    }),\n};\n\nexport const listWorkflowRunsTool: PhAiToolDescriptor = {\n  name: \"listWorkflowRuns\",\n  description:\n    \"Lists recent workflow runs, newest first, with status, error and each step's outcome. Filter by workflowId to inspect one workflow, or by driveId for every workflow in a drive.\",\n  inputSchema: {\n    workflowId: z\n      .string()\n      .optional()\n      .describe(\"Workflow document id to filter by.\"),\n    driveId: z\n      .string()\n      .optional()\n      .describe(\"Drive id to filter by (all workflows in that drive).\"),\n    limit: z\n      .number()\n      .int()\n      .min(1)\n      .max(100)\n      .optional()\n      .describe(\"Maximum runs to return (default 10).\"),\n  },\n  annotations: { title: \"List Workflow Runs\", ...READ_ONLY },\n  callback: async (args: {\n    workflowId?: string;\n    driveId?: string;\n    limit?: number;\n  }) => {\n    syncRuntimeUrl();\n    const runs = await fetchRuns({\n      workflowId: args.workflowId,\n      driveId: args.driveId,\n      limit: args.limit ?? 10,\n    });\n    return {\n      runs: runs.map((run) => ({\n        id: run.id,\n        workflowId: run.workflowId,\n        workflowName: run.workflowName,\n        status: run.status,\n        error: run.error,\n        triggerKind: run.triggerKind,\n        startedAt: run.startedAt,\n        endedAt: run.endedAt,\n        steps: run.steps.map((step) => ({\n          key: step.stepKey,\n          status: step.status,\n          error: step.error,\n        })),\n      })),\n    };\n  },\n};\n\nexport const fireWorkflowTool: PhAiToolDescriptor = {\n  name: \"fireWorkflow\",\n  description:\n    \"Fires an ENABLED workflow that has a core#manual trigger and runs it to completion. The payload becomes {{trigger.payload}}. Returns the run id and final status.\",\n  inputSchema: {\n    workflowId: z.string().describe(\"Workflow document id.\"),\n    payload: z\n      .record(z.string(), z.unknown())\n      .optional()\n      .describe(\"Trigger payload object.\"),\n  },\n  annotations: {\n    title: \"Fire Workflow\",\n    readOnlyHint: false,\n    destructiveHint: true,\n    idempotentHint: false,\n    openWorldHint: false,\n  },\n  callback: (args: {\n    workflowId: string;\n    payload?: Record<string, unknown>;\n  }) => {\n    syncRuntimeUrl();\n    return fireWorkflow(args.workflowId, args.payload ?? {});\n  },\n};\n\n/** Workflow authoring and run tools, merged into `aiTools` in tools.ts. */\nexport const workflowTools: PhAiToolDescriptor[] = [\n  getWorkflowPieceBlocksTool,\n  getWorkflowBlockConfigTool,\n  listWorkflowCoreBlocksTool,\n  listWorkflowRunsTool,\n  fireWorkflowTool,\n];\n","// Read-only AI tool descriptors for the Connect assistant: the project's\n// piece catalog, connection documents, and connection health. The `aiTools`\n// export is how the host app discovers this package's tools (the line in the\n// project index is synced by `ph generate`).\nimport type { PhAiToolDescriptor } from \"@powerhousedao/shared/document-model\";\nimport { z } from \"zod\";\nimport {\n  connectorIdForPiece,\n  isConfigValueMissing,\n  packageFromConnectorId,\n  planFromAuth,\n  type AuthField,\n} from \"../editors/connection-editor/piece-auth.js\";\nimport {\n  checkConnection as runConnectionCheck,\n  fetchConnections,\n  fetchPieceActions,\n  fetchPieceCatalog,\n  fetchPieceTriggers,\n  type PieceSummary,\n} from \"../editors/workflow-editor/runtime-api.js\";\nimport { syncRuntimeUrl } from \"./runtime-url.js\";\nimport { workflowTools } from \"./workflow-tools.js\";\n\nconst MAX_CONNECTORS = 20;\n\nexport interface ConnectorField {\n  name: string;\n  label: string;\n  required: boolean;\n  description?: string;\n  secret: boolean;\n}\n\nexport interface ConnectorDetail {\n  connectorId: string;\n  pieceName: string;\n  displayName: string;\n  description: string;\n  version: string;\n  authType: string;\n  /** False for auth kinds the runtime cannot execute yet (OAUTH2, OIDC). */\n  supported: boolean;\n  fields: ConnectorField[];\n  actions: string[];\n  triggers: string[];\n}\n\nfunction toField(field: AuthField, secret: boolean): ConnectorField {\n  return {\n    name: field.name,\n    label: field.displayName,\n    required: field.required,\n    description: field.description,\n    secret,\n  };\n}\n\nasync function connectorDetail(piece: PieceSummary): Promise<ConnectorDetail> {\n  const plan = planFromAuth(piece.auth);\n  const [actions, triggers] = await Promise.all([\n    fetchPieceActions(piece.name),\n    fetchPieceTriggers(piece.name),\n  ]);\n  return {\n    connectorId: connectorIdForPiece(piece.name),\n    pieceName: piece.name,\n    displayName: piece.displayName,\n    description: piece.description,\n    version: piece.version,\n    authType: plan.authType,\n    supported: plan.supported,\n    fields: [\n      ...plan.configFields.map((field) => toField(field, false)),\n      ...plan.secretFields.map((field) => toField(field, true)),\n    ],\n    actions: actions.map((action) => action.name),\n    triggers: triggers.map((trigger) => trigger.name),\n  };\n}\n\n/**\n * Stage one of connector discovery: the catalog, optionally narrowed to a\n * case-insensitive substring match on name, display name, or description,\n * capped at {@link MAX_CONNECTORS}. Full auth/action/trigger detail is\n * fetched only for the surviving entries (stage two).\n */\nexport async function getConnectors(query?: string): Promise<{\n  total: number;\n  matches: number;\n  truncated: boolean;\n  connectors: ConnectorDetail[];\n}> {\n  syncRuntimeUrl();\n  const catalog = await fetchPieceCatalog();\n  const needle = query?.trim().toLowerCase();\n  const matches = needle\n    ? catalog.filter((piece) =>\n        [piece.name, piece.displayName, piece.description].some((field) =>\n          field.toLowerCase().includes(needle),\n        ),\n      )\n    : [...catalog];\n  const page = matches.slice(0, MAX_CONNECTORS);\n  const connectors = await Promise.all(page.map(connectorDetail));\n  return {\n    total: catalog.length,\n    matches: matches.length,\n    truncated: matches.length > page.length,\n    connectors,\n  };\n}\n\ninterface ConnectionState {\n  config?: unknown;\n  secretRefs?: { name: string }[];\n}\n\nexport interface ConnectionDetail {\n  id: string;\n  name: string;\n  connectorId: string;\n  authType: string;\n  status: string;\n  accountLabel: string | null;\n  /** Required secret fields with no stored ref, by auth property name. */\n  missingSecrets: string[];\n  /** Required config fields with no value, by auth property name. */\n  missingConfig: string[];\n}\n\n/**\n * Every connection document with its credential state compared against the\n * piece's auth plan. Only field names and opaque refs are surfaced; secret\n * values never do.\n */\nexport async function getConnections(): Promise<{\n  connections: ConnectionDetail[];\n}> {\n  syncRuntimeUrl();\n  const [catalog, summaries] = await Promise.all([\n    fetchPieceCatalog(),\n    fetchConnections(),\n  ]);\n  const client =\n    typeof window !== \"undefined\" ? window.ph?.reactorClient : undefined;\n  const connections = await Promise.all(\n    summaries.map(async (summary) => {\n      const piece = catalog.find(\n        (entry) => entry.name === packageFromConnectorId(summary.connectorId),\n      );\n      const plan = planFromAuth(piece?.auth ?? null);\n      let state: ConnectionState | undefined;\n      if (client) {\n        try {\n          const document = await client.get(summary.id);\n          state = (document.state as { global?: ConnectionState }).global;\n        } catch {\n          state = undefined;\n        }\n      }\n      const refNames = new Set(\n        (state?.secretRefs ?? []).map((ref) => ref.name),\n      );\n      const config = (state?.config ?? {}) as Record<string, unknown>;\n      return {\n        id: summary.id,\n        name: summary.name,\n        connectorId: summary.connectorId,\n        authType: summary.authType,\n        status: summary.status,\n        accountLabel: summary.accountLabel,\n        missingSecrets: plan.secretFields\n          .filter((field) => field.required && !refNames.has(field.name))\n          .map((field) => field.name),\n        missingConfig: plan.configFields\n          .filter(\n            (field) =>\n              field.required && isConfigValueMissing(config[field.name]),\n          )\n          .map((field) => field.name),\n      };\n    }),\n  );\n  return { connections };\n}\n\nconst READ_ONLY = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: false,\n} as const;\n\nexport const getConnectorsTool: PhAiToolDescriptor = {\n  name: \"getConnectors\",\n  description:\n    \"Lists the connectors (Activepieces pieces) available to the workflow runtime with their auth fields, actions, and triggers. Without a query it returns up to 20 connectors; pass `query` to search by name or description. Secret fields are listed by name only, never by value.\",\n  inputSchema: { query: z.string().optional() },\n  annotations: { title: \"Get Connectors\", ...READ_ONLY },\n  callback: (args: { query?: string }) => getConnectors(args.query),\n};\n\nexport const getConnectionsTool: PhAiToolDescriptor = {\n  name: \"getConnections\",\n  description:\n    \"Lists the project's connection documents with their credential status: which required secrets and config values are still missing, and the last account label. Secret values are never included.\",\n  inputSchema: {},\n  annotations: { title: \"Get Connections\", ...READ_ONLY },\n  callback: () => getConnections(),\n};\n\nexport const checkConnectionTool: PhAiToolDescriptor = {\n  name: \"checkConnection\",\n  description:\n    \"Runs a connection's own check against its stored credentials to verify they work. Takes a connection id (from getConnections) and reports success, the failure detail, and the account label when the provider returns one.\",\n  inputSchema: { connectionId: z.string() },\n  annotations: { title: \"Check Connection\", ...READ_ONLY },\n  callback: (args: { connectionId: string }) => {\n    syncRuntimeUrl();\n    return runConnectionCheck(args.connectionId);\n  },\n};\n\n/** Tool descriptors the host app offers the AI assistant. */\nexport const aiTools: PhAiToolDescriptor[] = [\n  getConnectorsTool,\n  getConnectionsTool,\n  checkConnectionTool,\n  ...workflowTools,\n];\n","import { Connection as ConnectionV1 } from \"document-models/connection/v1\";\nimport { Workflow as WorkflowV1 } from \"document-models/workflow/v1\";\n\n/**\n * WARNING: DO NOT EDIT\n * This file is auto-generated and updated by codegen\n */\n\nexport const documentModels = [ConnectionV1, WorkflowV1] as const;\n","/**\n * WARNING: DO NOT EDIT\n * This file is auto-generated and updated by codegen\n */\nimport type { EditorModule } from \"document-model\";\nimport { ConnectionEditor } from \"./connection-editor/module.js\";\nimport { WorkflowEditor } from \"./workflow-editor/module.js\";\nimport { WorkflowStudio } from \"./workflow-studio/module.js\";\n\nexport const editors: EditorModule[] = [\n  ConnectionEditor,\n  WorkflowEditor,\n  WorkflowStudio,\n];\n","import type { Manifest } from \"document-model\";\nimport manifestJson from \"./powerhouse.manifest.json\" with { type: \"json\" };\n\nexport { aiTools } from \"./ai/tools.js\";\nexport { documentModels } from \"./document-models/document-models.js\";\nexport { upgradeManifests } from \"./document-models/upgrade-manifests.js\";\nexport { editors } from \"./editors/editors.js\";\nexport const manifest = manifestJson as Manifest;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["READ_ONLY","runConnectionCheck","ConnectionV1","WorkflowV1","manifestJson"],"sources":["../../powerhouse.manifest.json","../../ai/runtime-url.ts","../../ai/workflow-tools.ts","../../ai/tools.ts","../../document-models/document-models.ts","../../editors/editors.ts","../../index.ts"],"sourcesContent":["","// Points the module-level runtime client at the selected drive's\n// workflow-runtime subgraph before an AI tool talks to it.\nimport { resolveDriveSwitchboard } from \"@powerhousedao/reactor-browser/ai\";\nimport {\n  DEFAULT_RUNTIME_URL,\n  setRuntimeUrl,\n} from \"../editors/workflow-editor/runtime-api.js\";\n\nexport function syncRuntimeUrl(): void {\n  if (typeof window === \"undefined\") return;\n  const switchboard = resolveDriveSwitchboard(window.ph?.selectedDriveId);\n  // No resolvable switchboard (no selection, or a local/unsynced drive):\n  // reset to the default rather than leaving a prior drive's URL attached.\n  setRuntimeUrl(\n    switchboard\n      ? `${switchboard.graphqlUrl}/workflow-runtime`\n      : DEFAULT_RUNTIME_URL,\n  );\n}\n","// AI tool descriptors for authoring and running workflows: the exact block\n// types a piece offers, a block's config props, the built-in core blocks with\n// the expression syntax, run history and manual firing. Complements the\n// connector/connection tools in tools.ts, which cover the catalog and auth.\nimport type { PhAiToolDescriptor } from \"@powerhousedao/shared/document-model\";\nimport { z } from \"zod\";\nimport {\n  fetchPieceActions,\n  fetchPieceTriggers,\n  fetchRuns,\n  fireWorkflow,\n  getBlockForm,\n} from \"../editors/workflow-editor/runtime-api.js\";\nimport {\n  CORE_FORMS,\n  type BlockFormProp,\n} from \"../editors/workflow-editor/ui/forms.js\";\nimport { syncRuntimeUrl } from \"./runtime-url.js\";\n\nconst READ_ONLY = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: false,\n} as const;\n\n// Core blocks that are triggers. A piece's trigger says so in its own block\n// type, which is how every document trigger is classified now.\nconst CORE_TRIGGERS = new Set([\"core#manual\", \"core#schedule\", \"core#webhook\"]);\n\nfunction kindOf(blockType: string): \"trigger\" | \"step\" {\n  return CORE_TRIGGERS.has(blockType) || blockType.includes(\"#trigger:\")\n    ? \"trigger\"\n    : \"step\";\n}\n\nfunction portsFor(blockType: string): string[] {\n  return blockType === \"core#branch\" ? [\"true\", \"false\"] : [\"next\"];\n}\n\nfunction describeProp(prop: BlockFormProp) {\n  return {\n    name: prop.name,\n    label: prop.displayName,\n    type: prop.type,\n    required: prop.required,\n    ...(prop.description ? { description: prop.description } : {}),\n    ...(prop.defaultValue !== undefined ? { default: prop.defaultValue } : {}),\n    ...(prop.staticOptions\n      ? { options: prop.staticOptions.map((option) => option.value) }\n      : {}),\n    ...(prop.hasDynamicResolver ? { dynamicOptions: true } : {}),\n  };\n}\n\nconst EXPRESSIONS = [\n  \"Step configs and edge conditions may contain expressions in double braces.\",\n  \"{{trigger.payload.<field>}} reads the trigger payload: for core#manual the payload passed to fireWorkflow; for the reactor piece's document triggers it carries documentId, documentType, driveId and name.\",\n  \"{{steps.<key>.output.<path>}} reads an upstream step's output by that step's key, e.g. {{steps.fetch.output.body.title}}.\",\n  \"{{variables.<key>}} reads a workflow variable.\",\n  \"'a' || 'b' picks the first non-empty value, e.g. {{trigger.payload.url || 'https://example.com'}}.\",\n  \"A whole-string expression yields the raw value; text around expressions is interpolated.\",\n];\n\nconst GRAPH_RULES = [\n  \"A workflow is a powerhouse/workflow document. Build it with SET_TRIGGER once, ADD_STEP per step (each with a unique id and key), and ADD_EDGE from the trigger id to the first step and between steps.\",\n  \"Edges use port 'next' for the trigger and ordinary steps; core#branch emits 'true' and 'false'.\",\n  \"Piece block types are '<package>@<version>#<action>' for actions and '<package>@<version>#trigger:<trigger>' for triggers. Always use the pinned strings returned by getWorkflowPieceBlocks.\",\n  \"Steps whose piece needs a connection must set connectionId to a powerhouse/connection document id (see getConnections).\",\n  \"Only workflows with status ENABLED get trigger instances and can be fired; set it with SET_WORKFLOW_STATUS.\",\n];\n\nexport const getWorkflowPieceBlocksTool: PhAiToolDescriptor = {\n  name: \"getWorkflowPieceBlocks\",\n  description:\n    \"Lists the actions and triggers of one Activepieces piece with the exact, version-pinned blockType to use in ADD_STEP or SET_TRIGGER. Takes the piece package name from getConnectors. Call getWorkflowBlockConfig next for a block's config props.\",\n  inputSchema: {\n    packageName: z\n      .string()\n      .describe(\"Piece package name, e.g. @activepieces/piece-http.\"),\n  },\n  annotations: { title: \"Get Workflow Piece Blocks\", ...READ_ONLY },\n  callback: async (args: { packageName: string }) => {\n    syncRuntimeUrl();\n    const [actions, triggers] = await Promise.all([\n      fetchPieceActions(args.packageName),\n      fetchPieceTriggers(args.packageName),\n    ]);\n    return {\n      packageName: args.packageName,\n      actions: actions.map((action) => ({\n        blockType: action.blockType,\n        displayName: action.displayName,\n        description: action.description,\n      })),\n      triggers: triggers.map((trigger) => ({\n        blockType: trigger.blockType,\n        displayName: trigger.displayName,\n        description: trigger.description,\n        strategy: trigger.strategy,\n      })),\n    };\n  },\n};\n\nexport const getWorkflowBlockConfigTool: PhAiToolDescriptor = {\n  name: \"getWorkflowBlockConfig\",\n  description:\n    \"Describes the config of a block type (core#… or a piece blockType): prop names, types, whether required, allowed options, the output ports, and whether a connection is needed. Use it before writing a step or trigger config.\",\n  inputSchema: {\n    blockType: z\n      .string()\n      .describe(\n        \"Block type, e.g. core#branch or @activepieces/piece-http@0.11.19#send_request.\",\n      ),\n  },\n  annotations: { title: \"Get Workflow Block Config\", ...READ_ONLY },\n  callback: async (args: { blockType: string }) => {\n    const { blockType } = args;\n    if (!Object.hasOwn(CORE_FORMS, blockType)) syncRuntimeUrl();\n    const form = await getBlockForm(blockType);\n    if (!form) {\n      return {\n        blockType,\n        error:\n          \"Unknown block type. Use getConnectors and getWorkflowPieceBlocks to find valid block types (documents live in @powerhousedao/piece-reactor), or listWorkflowCoreBlocks for built-ins.\",\n      };\n    }\n    return {\n      blockType,\n      title: form.title,\n      kind: kindOf(blockType),\n      requiresConnection: form.auth === \"required\",\n      props: form.props.map(describeProp),\n      ports: portsFor(blockType),\n    };\n  },\n};\n\nexport const listWorkflowCoreBlocksTool: PhAiToolDescriptor = {\n  name: \"listWorkflowCoreBlocks\",\n  description:\n    \"Lists the built-in core#… blocks (manual, schedule and webhook triggers, branch and assert) with their config props, plus the expression syntax and the rules for building a powerhouse/workflow document. Documents are read and written by the @powerhousedao/piece-reactor blocks; list those with getWorkflowPieceBlocks.\",\n  inputSchema: {},\n  annotations: { title: \"List Workflow Core Blocks\", ...READ_ONLY },\n  callback: () =>\n    Promise.resolve({\n      blocks: Object.entries(CORE_FORMS).map(([blockType, form]) => ({\n        blockType,\n        title: form.title,\n        kind: kindOf(blockType),\n        props: form.props.map(describeProp),\n        ports: portsFor(blockType),\n      })),\n      expressions: EXPRESSIONS,\n      rules: GRAPH_RULES,\n    }),\n};\n\nexport const listWorkflowRunsTool: PhAiToolDescriptor = {\n  name: \"listWorkflowRuns\",\n  description:\n    \"Lists recent workflow runs, newest first, with status, error and each step's outcome. Filter by workflowId to inspect one workflow, or by driveId for every workflow in a drive.\",\n  inputSchema: {\n    workflowId: z\n      .string()\n      .optional()\n      .describe(\"Workflow document id to filter by.\"),\n    driveId: z\n      .string()\n      .optional()\n      .describe(\"Drive id to filter by (all workflows in that drive).\"),\n    limit: z\n      .number()\n      .int()\n      .min(1)\n      .max(100)\n      .optional()\n      .describe(\"Maximum runs to return (default 10).\"),\n  },\n  annotations: { title: \"List Workflow Runs\", ...READ_ONLY },\n  callback: async (args: {\n    workflowId?: string;\n    driveId?: string;\n    limit?: number;\n  }) => {\n    syncRuntimeUrl();\n    const runs = await fetchRuns({\n      workflowId: args.workflowId,\n      driveId: args.driveId,\n      limit: args.limit ?? 10,\n    });\n    return {\n      runs: runs.map((run) => ({\n        id: run.id,\n        workflowId: run.workflowId,\n        workflowName: run.workflowName,\n        status: run.status,\n        error: run.error,\n        triggerKind: run.triggerKind,\n        startedAt: run.startedAt,\n        endedAt: run.endedAt,\n        steps: run.steps.map((step) => ({\n          key: step.stepKey,\n          status: step.status,\n          error: step.error,\n        })),\n      })),\n    };\n  },\n};\n\nexport const fireWorkflowTool: PhAiToolDescriptor = {\n  name: \"fireWorkflow\",\n  description:\n    \"Fires an ENABLED workflow that has a core#manual trigger and runs it to completion. The payload becomes {{trigger.payload}}. Returns the run id and final status.\",\n  inputSchema: {\n    workflowId: z.string().describe(\"Workflow document id.\"),\n    payload: z\n      .record(z.string(), z.unknown())\n      .optional()\n      .describe(\"Trigger payload object.\"),\n  },\n  annotations: {\n    title: \"Fire Workflow\",\n    readOnlyHint: false,\n    destructiveHint: true,\n    idempotentHint: false,\n    openWorldHint: false,\n  },\n  callback: (args: {\n    workflowId: string;\n    payload?: Record<string, unknown>;\n  }) => {\n    syncRuntimeUrl();\n    return fireWorkflow(args.workflowId, args.payload ?? {});\n  },\n};\n\n/** Workflow authoring and run tools, merged into `aiTools` in tools.ts. */\nexport const workflowTools: PhAiToolDescriptor[] = [\n  getWorkflowPieceBlocksTool,\n  getWorkflowBlockConfigTool,\n  listWorkflowCoreBlocksTool,\n  listWorkflowRunsTool,\n  fireWorkflowTool,\n];\n","// Read-only AI tool descriptors for the Connect assistant: the project's\n// piece catalog, connection documents, and connection health. The `aiTools`\n// export is how the host app discovers this package's tools (the line in the\n// project index is synced by `ph generate`).\nimport type { PhAiToolDescriptor } from \"@powerhousedao/shared/document-model\";\nimport { z } from \"zod\";\nimport {\n  connectorIdForPiece,\n  isConfigValueMissing,\n  packageFromConnectorId,\n  planFromAuth,\n  type AuthField,\n} from \"../editors/connection-editor/piece-auth.js\";\nimport {\n  checkConnection as runConnectionCheck,\n  fetchConnections,\n  fetchPieceActions,\n  fetchPieceCatalog,\n  fetchPieceTriggers,\n  type PieceSummary,\n} from \"../editors/workflow-editor/runtime-api.js\";\nimport { syncRuntimeUrl } from \"./runtime-url.js\";\nimport { workflowTools } from \"./workflow-tools.js\";\n\nconst MAX_CONNECTORS = 20;\n\nexport interface ConnectorField {\n  name: string;\n  label: string;\n  required: boolean;\n  description?: string;\n  secret: boolean;\n}\n\nexport interface ConnectorDetail {\n  connectorId: string;\n  pieceName: string;\n  displayName: string;\n  description: string;\n  version: string;\n  authType: string;\n  /** False for auth kinds the runtime cannot execute yet (OAUTH2, OIDC). */\n  supported: boolean;\n  fields: ConnectorField[];\n  actions: string[];\n  triggers: string[];\n}\n\nfunction toField(field: AuthField, secret: boolean): ConnectorField {\n  return {\n    name: field.name,\n    label: field.displayName,\n    required: field.required,\n    description: field.description,\n    secret,\n  };\n}\n\nasync function connectorDetail(piece: PieceSummary): Promise<ConnectorDetail> {\n  const plan = planFromAuth(piece.auth);\n  const [actions, triggers] = await Promise.all([\n    fetchPieceActions(piece.name),\n    fetchPieceTriggers(piece.name),\n  ]);\n  return {\n    connectorId: connectorIdForPiece(piece.name),\n    pieceName: piece.name,\n    displayName: piece.displayName,\n    description: piece.description,\n    version: piece.version,\n    authType: plan.authType,\n    supported: plan.supported,\n    fields: [\n      ...plan.configFields.map((field) => toField(field, false)),\n      ...plan.secretFields.map((field) => toField(field, true)),\n    ],\n    actions: actions.map((action) => action.name),\n    triggers: triggers.map((trigger) => trigger.name),\n  };\n}\n\n/**\n * Stage one of connector discovery: the catalog, optionally narrowed to a\n * case-insensitive substring match on name, display name, or description,\n * capped at {@link MAX_CONNECTORS}. Full auth/action/trigger detail is\n * fetched only for the surviving entries (stage two).\n */\nexport async function getConnectors(query?: string): Promise<{\n  total: number;\n  matches: number;\n  truncated: boolean;\n  connectors: ConnectorDetail[];\n}> {\n  syncRuntimeUrl();\n  const catalog = await fetchPieceCatalog();\n  const needle = query?.trim().toLowerCase();\n  const matches = needle\n    ? catalog.filter((piece) =>\n        [piece.name, piece.displayName, piece.description].some((field) =>\n          field.toLowerCase().includes(needle),\n        ),\n      )\n    : [...catalog];\n  const page = matches.slice(0, MAX_CONNECTORS);\n  const connectors = await Promise.all(page.map(connectorDetail));\n  return {\n    total: catalog.length,\n    matches: matches.length,\n    truncated: matches.length > page.length,\n    connectors,\n  };\n}\n\ninterface ConnectionState {\n  config?: unknown;\n  secretRefs?: { name: string }[];\n}\n\nexport interface ConnectionDetail {\n  id: string;\n  name: string;\n  connectorId: string;\n  authType: string;\n  status: string;\n  accountLabel: string | null;\n  /** Required secret fields with no stored ref, by auth property name. */\n  missingSecrets: string[];\n  /** Required config fields with no value, by auth property name. */\n  missingConfig: string[];\n}\n\n/**\n * Every connection document with its credential state compared against the\n * piece's auth plan. Only field names and opaque refs are surfaced; secret\n * values never do.\n */\nexport async function getConnections(): Promise<{\n  connections: ConnectionDetail[];\n}> {\n  syncRuntimeUrl();\n  const [catalog, summaries] = await Promise.all([\n    fetchPieceCatalog(),\n    fetchConnections(),\n  ]);\n  const client =\n    typeof window !== \"undefined\" ? window.ph?.reactorClient : undefined;\n  const connections = await Promise.all(\n    summaries.map(async (summary) => {\n      const piece = catalog.find(\n        (entry) => entry.name === packageFromConnectorId(summary.connectorId),\n      );\n      const plan = planFromAuth(piece?.auth ?? null);\n      let state: ConnectionState | undefined;\n      if (client) {\n        try {\n          const document = await client.get(summary.id);\n          state = (document.state as { global?: ConnectionState }).global;\n        } catch {\n          state = undefined;\n        }\n      }\n      const refNames = new Set(\n        (state?.secretRefs ?? []).map((ref) => ref.name),\n      );\n      const config = (state?.config ?? {}) as Record<string, unknown>;\n      return {\n        id: summary.id,\n        name: summary.name,\n        connectorId: summary.connectorId,\n        authType: summary.authType,\n        status: summary.status,\n        accountLabel: summary.accountLabel,\n        missingSecrets: plan.secretFields\n          .filter((field) => field.required && !refNames.has(field.name))\n          .map((field) => field.name),\n        missingConfig: plan.configFields\n          .filter(\n            (field) =>\n              field.required && isConfigValueMissing(config[field.name]),\n          )\n          .map((field) => field.name),\n      };\n    }),\n  );\n  return { connections };\n}\n\nconst READ_ONLY = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: false,\n} as const;\n\nexport const getConnectorsTool: PhAiToolDescriptor = {\n  name: \"getConnectors\",\n  description:\n    \"Lists the connectors (Activepieces pieces) available to the workflow runtime with their auth fields, actions, and triggers. Without a query it returns up to 20 connectors; pass `query` to search by name or description. Secret fields are listed by name only, never by value.\",\n  inputSchema: { query: z.string().optional() },\n  annotations: { title: \"Get Connectors\", ...READ_ONLY },\n  callback: (args: { query?: string }) => getConnectors(args.query),\n};\n\nexport const getConnectionsTool: PhAiToolDescriptor = {\n  name: \"getConnections\",\n  description:\n    \"Lists the project's connection documents with their credential status: which required secrets and config values are still missing, and the last account label. Secret values are never included.\",\n  inputSchema: {},\n  annotations: { title: \"Get Connections\", ...READ_ONLY },\n  callback: () => getConnections(),\n};\n\nexport const checkConnectionTool: PhAiToolDescriptor = {\n  name: \"checkConnection\",\n  description:\n    \"Runs a connection's own check against its stored credentials to verify they work. Takes a connection id (from getConnections) and reports success, the failure detail, and the account label when the provider returns one.\",\n  inputSchema: { connectionId: z.string() },\n  annotations: { title: \"Check Connection\", ...READ_ONLY },\n  callback: (args: { connectionId: string }) => {\n    syncRuntimeUrl();\n    return runConnectionCheck(args.connectionId);\n  },\n};\n\n/** Tool descriptors the host app offers the AI assistant. */\nexport const aiTools: PhAiToolDescriptor[] = [\n  getConnectorsTool,\n  getConnectionsTool,\n  checkConnectionTool,\n  ...workflowTools,\n];\n","import { Connection as ConnectionV1 } from \"document-models/connection/v1\";\nimport { Workflow as WorkflowV1 } from \"document-models/workflow/v1\";\n\n/**\n * WARNING: DO NOT EDIT\n * This file is auto-generated and updated by codegen\n */\n\nexport const documentModels = [ConnectionV1, WorkflowV1] as const;\n","/**\n * WARNING: DO NOT EDIT\n * This file is auto-generated and updated by codegen\n */\nimport type { EditorModule } from \"document-model\";\nimport { ConnectionEditor } from \"./connection-editor/module.js\";\nimport { WorkflowEditor } from \"./workflow-editor/module.js\";\nimport { WorkflowStudio } from \"./workflow-studio/module.js\";\n\nexport const editors: EditorModule[] = [\n  ConnectionEditor,\n  WorkflowEditor,\n  WorkflowStudio,\n];\n","import type { Manifest } from \"document-model\";\nimport manifestJson from \"./powerhouse.manifest.json\" with { type: \"json\" };\n\nexport { aiTools } from \"./ai/tools.js\";\nexport { documentModels } from \"./document-models/document-models.js\";\nexport { upgradeManifests } from \"./document-models/upgrade-manifests.js\";\nexport { editors } from \"./editors/editors.js\";\nexport const manifest = manifestJson as Manifest;\n"],"mappings":"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"}

package/dist/powerhouse.manifest.json

@@ -53,5 +53,52 @@
   ],
   "processors": [],
   "subgraphs": [],
-  "config": []
+  "config": [
+    {
+      "name": "PH_WORKFLOWS_SECRETS_MASTER_KEY",
+      "type": "secret",
+      "description": "64 hex chars (32 bytes) encrypting connection secrets at rest. Unset, a key is generated at ./.ph/secrets.key and reused; a host whose working directory does not survive a restart must set this or every stored secret becomes undecryptable."
+    },
+    {
+      "name": "PH_WORKFLOWS_EGRESS_ALLOW_ADDRESSES",
+      "type": "var",
+      "description": "Comma-separated addresses or CIDRs a piece may reach, widening the default policy that refuses private and loopback space. A bare address is taken as one host. Applies to steps and to design-time piece code alike."
+    },
+    {
+      "name": "PH_WORKFLOWS_RUN_CONCURRENCY",
+      "type": "var",
+      "description": "How many runs execute at once. Each slot is a forked node process, so this is the reactor's real connector concurrency.",
+      "default": "4"
+    },
+    {
+      "name": "PH_WORKFLOWS_RUN_QUEUE_DEPTH",
+      "type": "var",
+      "description": "How many runs may wait for a slot before new ones are refused. 0 waits without limit, turning saturation into latency rather than failures.",
+      "default": "0"
+    },
+    {
+      "name": "PH_WORKFLOWS_POLL_INTERVAL_MS",
+      "type": "var",
+      "description": "Cadence for a polling trigger that names none of its own. An author's override and a piece's requested schedule both win over it; a 1000ms floor applies to all three.",
+      "default": "60000"
+    },
+    {
+      "name": "PH_WORKFLOWS_WEBHOOK_RECONCILE_MS",
+      "type": "var",
+      "description": "How often a webhook trigger re-registers with its provider, so a registration the provider dropped comes back.",
+      "default": "900000"
+    },
+    {
+      "name": "PH_WORKFLOWS_WEBHOOK_TIMEOUT_MS",
+      "type": "var",
+      "description": "How long a sync-mode delivery holds the provider's socket. Past it the run continues and the provider is told so, lest a wedged step tie up connections.",
+      "default": "30000"
+    },
+    {
+      "name": "PH_WORKFLOWS_PIECE_MAX_FILE_BYTES",
+      "type": "var",
+      "description": "File-size ceiling for both directions: a FILE property hydrated from a URL, data URI or attachment ref, and ctx.files.write.",
+      "default": "8388608"
+    }
+  ]
 }

package/dist/types/pieces/reactor/lib/actions/dispatch-outcome.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dispatch-outcome.test.d.ts.map

package/dist/types/pieces/reactor/lib/actions/dispatch-outcome.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-outcome.test.d.ts","sourceRoot":"","sources":["../../../../../../pieces/reactor/lib/actions/dispatch-outcome.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/workflow",
-  "version": "6.2.3-dev.20",
+  "version": "6.2.3-dev.21",
   "license": "AGPL-3.0-only",
   "type": "module",
   "sideEffects": [
@@ -63,13 +63,13 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@powerhousedao/design-system": "6.2.3-dev.20",
-    "@powerhousedao/pieces-framework": "6.2.3-dev.20",
-    "@powerhousedao/reactor": "6.2.3-dev.20",
-    "@powerhousedao/reactor-browser": "6.2.3-dev.20",
-    "@powerhousedao/shared": "6.2.3-dev.20",
+    "@powerhousedao/design-system": "6.2.3-dev.21",
+    "@powerhousedao/pieces-framework": "6.2.3-dev.21",
+    "@powerhousedao/reactor": "6.2.3-dev.21",
+    "@powerhousedao/reactor-browser": "6.2.3-dev.21",
+    "@powerhousedao/shared": "6.2.3-dev.21",
     "@xyflow/react": "12.11.6",
-    "document-model": "6.2.3-dev.20",
+    "document-model": "6.2.3-dev.21",
     "react": "19.2.6",
     "react-dom": "19.2.6",
     "react-markdown": "10.1.0",

package/dist/browser/document-models-vmNTCrKx.js

@@ -1,51 +0,0 @@
-import { t as Connection } from "./module-12vI18HY.js";
-import { t as Workflow } from "./module-CYQnNZWl.js";
-//#region powerhouse.manifest.json
-var powerhouse_manifest_default = {
-	name: "@powerhousedao/workflow",
-	description: "Workflows in Connect: the workflow and connection document models, their editors and Workflow Studio, and the reactor piece.",
-	category: "",
-	publisher: {
-		"name": "@powerhousedao",
-		"url": "https://github.com/powerhouse-inc/powerhouse/tree/main/packages/workflow"
-	},
-	documentModels: [{
-		"id": "powerhouse/workflow",
-		"name": "Workflow"
-	}, {
-		"id": "powerhouse/connection",
-		"name": "Connection"
-	}],
-	apps: [{
-		"id": "workflow-studio",
-		"name": "Workflow Studio",
-		"documentTypes": ["powerhouse/document-drive"]
-	}],
-	editors: [{
-		"id": "workflow-editor",
-		"name": "Workflow Editor",
-		"documentTypes": ["powerhouse/workflow"]
-	}, {
-		"id": "connection-editor",
-		"name": "Connection Editor",
-		"documentTypes": ["powerhouse/connection"]
-	}],
-	pieces: [{
-		"id": "@powerhousedao/piece-reactor",
-		"name": "Powerhouse Reactor"
-	}],
-	processors: [],
-	subgraphs: [],
-	config: []
-};
-//#endregion
-//#region document-models/document-models.ts
-/**
-* WARNING: DO NOT EDIT
-* This file is auto-generated and updated by codegen
-*/
-const documentModels = [Connection, Workflow];
-//#endregion
-export { powerhouse_manifest_default as n, documentModels as t };
-
-//# sourceMappingURL=document-models-vmNTCrKx.js.map