@powerhousedao/workflow 6.2.3-dev.11

package/dist/browser/index.js

@@ -0,0 +1,330 @@
+import { n as powerhouse_manifest_default, t as documentModels } from "./document-models-vmNTCrKx.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";
+import { WorkflowEditor } from "./editors/workflow-editor/module.js";
+import { WorkflowStudio } from "./editors/workflow-studio/module.js";
+import { z } from "zod";
+import { resolveDriveSwitchboard } from "@powerhousedao/reactor-browser/ai";
+//#region ai/runtime-url.ts
+function syncRuntimeUrl() {
+	if (typeof window === "undefined") return;
+	const switchboard = resolveDriveSwitchboard(window.ph?.selectedDriveId);
+	setRuntimeUrl(switchboard ? `${switchboard.graphqlUrl}/workflow-runtime` : DEFAULT_RUNTIME_URL);
+}
+//#endregion
+//#region ai/workflow-tools.ts
+const READ_ONLY$1 = {
+	readOnlyHint: true,
+	destructiveHint: false,
+	idempotentHint: true,
+	openWorldHint: false
+};
+const CORE_TRIGGERS = new Set([
+	"core#manual",
+	"core#schedule",
+	"core#webhook"
+]);
+function kindOf(blockType) {
+	return CORE_TRIGGERS.has(blockType) || blockType.includes("#trigger:") ? "trigger" : "step";
+}
+function portsFor(blockType) {
+	return blockType === "core#branch" ? ["true", "false"] : ["next"];
+}
+function describeProp(prop) {
+	return {
+		name: prop.name,
+		label: prop.displayName,
+		type: prop.type,
+		required: prop.required,
+		...prop.description ? { description: prop.description } : {},
+		...prop.defaultValue !== void 0 ? { default: prop.defaultValue } : {},
+		...prop.staticOptions ? { options: prop.staticOptions.map((option) => option.value) } : {},
+		...prop.hasDynamicResolver ? { dynamicOptions: true } : {}
+	};
+}
+const EXPRESSIONS = [
+	"Step configs and edge conditions may contain expressions in double braces.",
+	"{{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.",
+	"{{steps.<key>.output.<path>}} reads an upstream step's output by that step's key, e.g. {{steps.fetch.output.body.title}}.",
+	"{{variables.<key>}} reads a workflow variable.",
+	"'a' || 'b' picks the first non-empty value, e.g. {{trigger.payload.url || 'https://example.com'}}.",
+	"A whole-string expression yields the raw value; text around expressions is interpolated."
+];
+const GRAPH_RULES = [
+	"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.",
+	"Edges use port 'next' for the trigger and ordinary steps; core#branch emits 'true' and 'false'.",
+	"Piece block types are '<package>@<version>#<action>' for actions and '<package>@<version>#trigger:<trigger>' for triggers. Always use the pinned strings returned by getWorkflowPieceBlocks.",
+	"Steps whose piece needs a connection must set connectionId to a powerhouse/connection document id (see getConnections).",
+	"Only workflows with status ENABLED get trigger instances and can be fired; set it with SET_WORKFLOW_STATUS."
+];
+/** Workflow authoring and run tools, merged into `aiTools` in tools.ts. */
+const workflowTools = [
+	{
+		name: "getWorkflowPieceBlocks",
+		description: "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.",
+		inputSchema: { packageName: z.string().describe("Piece package name, e.g. @activepieces/piece-http.") },
+		annotations: {
+			title: "Get Workflow Piece Blocks",
+			...READ_ONLY$1
+		},
+		callback: async (args) => {
+			syncRuntimeUrl();
+			const [actions, triggers] = await Promise.all([fetchPieceActions(args.packageName), fetchPieceTriggers(args.packageName)]);
+			return {
+				packageName: args.packageName,
+				actions: actions.map((action) => ({
+					blockType: action.blockType,
+					displayName: action.displayName,
+					description: action.description
+				})),
+				triggers: triggers.map((trigger) => ({
+					blockType: trigger.blockType,
+					displayName: trigger.displayName,
+					description: trigger.description,
+					strategy: trigger.strategy
+				}))
+			};
+		}
+	},
+	{
+		name: "getWorkflowBlockConfig",
+		description: "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.",
+		inputSchema: { blockType: z.string().describe("Block type, e.g. core#branch or @activepieces/piece-http@0.11.19#send_request.") },
+		annotations: {
+			title: "Get Workflow Block Config",
+			...READ_ONLY$1
+		},
+		callback: async (args) => {
+			const { blockType } = args;
+			if (!Object.hasOwn(CORE_FORMS, blockType)) syncRuntimeUrl();
+			const form = await getBlockForm(blockType);
+			if (!form) return {
+				blockType,
+				error: "Unknown block type. Use getConnectors and getWorkflowPieceBlocks to find valid block types (documents live in @powerhousedao/piece-reactor), or listWorkflowCoreBlocks for built-ins."
+			};
+			return {
+				blockType,
+				title: form.title,
+				kind: kindOf(blockType),
+				requiresConnection: form.auth === "required",
+				props: form.props.map(describeProp),
+				ports: portsFor(blockType)
+			};
+		}
+	},
+	{
+		name: "listWorkflowCoreBlocks",
+		description: "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.",
+		inputSchema: {},
+		annotations: {
+			title: "List Workflow Core Blocks",
+			...READ_ONLY$1
+		},
+		callback: () => Promise.resolve({
+			blocks: Object.entries(CORE_FORMS).map(([blockType, form]) => ({
+				blockType,
+				title: form.title,
+				kind: kindOf(blockType),
+				props: form.props.map(describeProp),
+				ports: portsFor(blockType)
+			})),
+			expressions: EXPRESSIONS,
+			rules: GRAPH_RULES
+		})
+	},
+	{
+		name: "listWorkflowRuns",
+		description: "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.",
+		inputSchema: {
+			workflowId: z.string().optional().describe("Workflow document id to filter by."),
+			driveId: z.string().optional().describe("Drive id to filter by (all workflows in that drive)."),
+			limit: z.number().int().min(1).max(100).optional().describe("Maximum runs to return (default 10).")
+		},
+		annotations: {
+			title: "List Workflow Runs",
+			...READ_ONLY$1
+		},
+		callback: async (args) => {
+			syncRuntimeUrl();
+			return { runs: (await fetchRuns({
+				workflowId: args.workflowId,
+				driveId: args.driveId,
+				limit: args.limit ?? 10
+			})).map((run) => ({
+				id: run.id,
+				workflowId: run.workflowId,
+				workflowName: run.workflowName,
+				status: run.status,
+				error: run.error,
+				triggerKind: run.triggerKind,
+				startedAt: run.startedAt,
+				endedAt: run.endedAt,
+				steps: run.steps.map((step) => ({
+					key: step.stepKey,
+					status: step.status,
+					error: step.error
+				}))
+			})) };
+		}
+	},
+	{
+		name: "fireWorkflow",
+		description: "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.",
+		inputSchema: {
+			workflowId: z.string().describe("Workflow document id."),
+			payload: z.record(z.string(), z.unknown()).optional().describe("Trigger payload object.")
+		},
+		annotations: {
+			title: "Fire Workflow",
+			readOnlyHint: false,
+			destructiveHint: true,
+			idempotentHint: false,
+			openWorldHint: false
+		},
+		callback: (args) => {
+			syncRuntimeUrl();
+			return fireWorkflow(args.workflowId, args.payload ?? {});
+		}
+	}
+];
+//#endregion
+//#region ai/tools.ts
+const MAX_CONNECTORS = 20;
+function toField(field, secret) {
+	return {
+		name: field.name,
+		label: field.displayName,
+		required: field.required,
+		description: field.description,
+		secret
+	};
+}
+async function connectorDetail(piece) {
+	const plan = planFromAuth(piece.auth);
+	const [actions, triggers] = await Promise.all([fetchPieceActions(piece.name), fetchPieceTriggers(piece.name)]);
+	return {
+		connectorId: connectorIdForPiece(piece.name),
+		pieceName: piece.name,
+		displayName: piece.displayName,
+		description: piece.description,
+		version: piece.version,
+		authType: plan.authType,
+		supported: plan.supported,
+		fields: [...plan.configFields.map((field) => toField(field, false)), ...plan.secretFields.map((field) => toField(field, true))],
+		actions: actions.map((action) => action.name),
+		triggers: triggers.map((trigger) => trigger.name)
+	};
+}
+/**
+* Stage one of connector discovery: the catalog, optionally narrowed to a
+* case-insensitive substring match on name, display name, or description,
+* capped at {@link MAX_CONNECTORS}. Full auth/action/trigger detail is
+* fetched only for the surviving entries (stage two).
+*/
+async function getConnectors(query) {
+	syncRuntimeUrl();
+	const catalog = await fetchPieceCatalog();
+	const needle = query?.trim().toLowerCase();
+	const matches = needle ? catalog.filter((piece) => [
+		piece.name,
+		piece.displayName,
+		piece.description
+	].some((field) => field.toLowerCase().includes(needle))) : [...catalog];
+	const page = matches.slice(0, MAX_CONNECTORS);
+	const connectors = await Promise.all(page.map(connectorDetail));
+	return {
+		total: catalog.length,
+		matches: matches.length,
+		truncated: matches.length > page.length,
+		connectors
+	};
+}
+/**
+* Every connection document with its credential state compared against the
+* piece's auth plan. Only field names and opaque refs are surfaced; secret
+* values never do.
+*/
+async function getConnections() {
+	syncRuntimeUrl();
+	const [catalog, summaries] = await Promise.all([fetchPieceCatalog(), fetchConnections()]);
+	const client = typeof window !== "undefined" ? window.ph?.reactorClient : void 0;
+	return { connections: await Promise.all(summaries.map(async (summary) => {
+		const plan = planFromAuth(catalog.find((entry) => entry.name === packageFromConnectorId(summary.connectorId))?.auth ?? null);
+		let state;
+		if (client) try {
+			state = (await client.get(summary.id)).state.global;
+		} catch {
+			state = void 0;
+		}
+		const refNames = new Set((state?.secretRefs ?? []).map((ref) => ref.name));
+		const config = state?.config ?? {};
+		return {
+			id: summary.id,
+			name: summary.name,
+			connectorId: summary.connectorId,
+			authType: summary.authType,
+			status: summary.status,
+			accountLabel: summary.accountLabel,
+			missingSecrets: plan.secretFields.filter((field) => field.required && !refNames.has(field.name)).map((field) => field.name),
+			missingConfig: plan.configFields.filter((field) => field.required && isConfigValueMissing(config[field.name])).map((field) => field.name)
+		};
+	})) };
+}
+const READ_ONLY = {
+	readOnlyHint: true,
+	destructiveHint: false,
+	idempotentHint: true,
+	openWorldHint: false
+};
+/** Tool descriptors the host app offers the AI assistant. */
+const aiTools = [
+	{
+		name: "getConnectors",
+		description: "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.",
+		inputSchema: { query: z.string().optional() },
+		annotations: {
+			title: "Get Connectors",
+			...READ_ONLY
+		},
+		callback: (args) => getConnectors(args.query)
+	},
+	{
+		name: "getConnections",
+		description: "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.",
+		inputSchema: {},
+		annotations: {
+			title: "Get Connections",
+			...READ_ONLY
+		},
+		callback: () => getConnections()
+	},
+	{
+		name: "checkConnection",
+		description: "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.",
+		inputSchema: { connectionId: z.string() },
+		annotations: {
+			title: "Check Connection",
+			...READ_ONLY
+		},
+		callback: (args) => {
+			syncRuntimeUrl();
+			return checkConnection(args.connectionId);
+		}
+	},
+	...workflowTools
+];
+//#endregion
+//#region editors/editors.ts
+const editors = [
+	ConnectionEditor,
+	WorkflowEditor,
+	WorkflowStudio
+];
+//#endregion
+//#region index.ts
+const manifest = powerhouse_manifest_default;
+//#endregion
+export { aiTools, documentModels, editors, manifest, upgradeManifests };
+
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["READ_ONLY","runConnectionCheck","manifestJson"],"sources":["../../ai/runtime-url.ts","../../ai/workflow-tools.ts","../../ai/tools.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","/**\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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"}