@relayflows/surface 2.0.8 → 2.0.10

package/src/helpers/neon.ts

@@ -0,0 +1,9 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { bindHelper, type EffectDispatcher, type JournalHelper, type UnavailableHelper } from "../effect-transport.js";
+
+export type NeonHelper = UnavailableHelper;
+
+export const createNeonHelper = (dispatch: EffectDispatcher): NeonHelper =>
+  bindHelper("neon", undefined, dispatch);

package/src/helpers/notion.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { notionClient } from "../helper-clients.js";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type NotionHelper = JournalHelper<ReturnType<typeof notionClient>>;
+
+export const createNotionHelper = (dispatch: EffectDispatcher): NotionHelper =>
+  bindHelper("notion", notionClient, dispatch);

package/src/helpers/onedrive.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { onedriveClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type OnedriveHelper = JournalHelper<ReturnType<typeof onedriveClient>>;
+
+export const createOnedriveHelper = (dispatch: EffectDispatcher): OnedriveHelper =>
+  bindHelper("onedrive", onedriveClient, dispatch);

package/src/helpers/pipedrive.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { pipedriveClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type PipedriveHelper = JournalHelper<ReturnType<typeof pipedriveClient>>;
+
+export const createPipedriveHelper = (dispatch: EffectDispatcher): PipedriveHelper =>
+  bindHelper("pipedrive", pipedriveClient, dispatch);

package/src/helpers/postgres.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { postgresClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type PostgresHelper = JournalHelper<ReturnType<typeof postgresClient>>;
+
+export const createPostgresHelper = (dispatch: EffectDispatcher): PostgresHelper =>
+  bindHelper("postgres", postgresClient, dispatch);

package/src/helpers/posthog.ts

@@ -0,0 +1,9 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { bindHelper, type EffectDispatcher, type JournalHelper, type UnavailableHelper } from "../effect-transport.js";
+
+export type PosthogHelper = UnavailableHelper;
+
+export const createPosthogHelper = (dispatch: EffectDispatcher): PosthogHelper =>
+  bindHelper("posthog", undefined, dispatch);

package/src/helpers/providers.ts

@@ -0,0 +1,305 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+export const helperProviders = [
+  {
+    "provider": "airtable",
+    "namespace": "airtable",
+    "mockEnv": "RELAYFLOWS_AIRTABLE_MOCK",
+    "supported": false
+  },
+  {
+    "provider": "asana",
+    "namespace": "asana",
+    "mockEnv": "RELAYFLOWS_ASANA_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "azure-blob",
+    "namespace": "azureBlob",
+    "mockEnv": "RELAYFLOWS_AZURE_BLOB_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "box",
+    "namespace": "box",
+    "mockEnv": "RELAYFLOWS_BOX_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "calendly",
+    "namespace": "calendly",
+    "mockEnv": "RELAYFLOWS_CALENDLY_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "clickup",
+    "namespace": "clickup",
+    "mockEnv": "RELAYFLOWS_CLICKUP_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "cloudflare",
+    "namespace": "cloudflare",
+    "mockEnv": "RELAYFLOWS_CLOUDFLARE_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "confluence",
+    "namespace": "confluence",
+    "mockEnv": "RELAYFLOWS_CONFLUENCE_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "daytona",
+    "namespace": "daytona",
+    "mockEnv": "RELAYFLOWS_DAYTONA_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "docker-hub",
+    "namespace": "dockerHub",
+    "mockEnv": "RELAYFLOWS_DOCKER_HUB_MOCK",
+    "supported": false
+  },
+  {
+    "provider": "dropbox",
+    "namespace": "dropbox",
+    "mockEnv": "RELAYFLOWS_DROPBOX_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "fathom",
+    "namespace": "fathom",
+    "mockEnv": "RELAYFLOWS_FATHOM_MOCK",
+    "supported": false
+  },
+  {
+    "provider": "gcp",
+    "namespace": "gcp",
+    "mockEnv": "RELAYFLOWS_GCP_MOCK",
+    "supported": false
+  },
+  {
+    "provider": "gcs",
+    "namespace": "gcs",
+    "mockEnv": "RELAYFLOWS_GCS_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "github",
+    "namespace": "github",
+    "mockEnv": "RELAYFLOWS_GITHUB_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "gitlab",
+    "namespace": "gitlab",
+    "mockEnv": "RELAYFLOWS_GITLAB_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "gmail",
+    "namespace": "gmail",
+    "mockEnv": "RELAYFLOWS_GMAIL_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "google-calendar",
+    "namespace": "googleCalendar",
+    "mockEnv": "RELAYFLOWS_GOOGLE_CALENDAR_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "google-drive",
+    "namespace": "googleDrive",
+    "mockEnv": "RELAYFLOWS_GOOGLE_DRIVE_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "granola",
+    "namespace": "granola",
+    "mockEnv": "RELAYFLOWS_GRANOLA_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "hubspot",
+    "namespace": "hubspot",
+    "mockEnv": "RELAYFLOWS_HUBSPOT_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "intercom",
+    "namespace": "intercom",
+    "mockEnv": "RELAYFLOWS_INTERCOM_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "jira",
+    "namespace": "jira",
+    "mockEnv": "RELAYFLOWS_JIRA_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "linear",
+    "namespace": "linear",
+    "mockEnv": "RELAYFLOWS_LINEAR_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "mailgun",
+    "namespace": "mailgun",
+    "mockEnv": "RELAYFLOWS_MAILGUN_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "mixpanel",
+    "namespace": "mixpanel",
+    "mockEnv": "RELAYFLOWS_MIXPANEL_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "neon",
+    "namespace": "neon",
+    "mockEnv": "RELAYFLOWS_NEON_MOCK",
+    "supported": false
+  },
+  {
+    "provider": "notion",
+    "namespace": "notion",
+    "mockEnv": "RELAYFLOWS_NOTION_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "onedrive",
+    "namespace": "onedrive",
+    "mockEnv": "RELAYFLOWS_ONEDRIVE_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "pipedrive",
+    "namespace": "pipedrive",
+    "mockEnv": "RELAYFLOWS_PIPEDRIVE_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "postgres",
+    "namespace": "postgres",
+    "mockEnv": "RELAYFLOWS_POSTGRES_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "posthog",
+    "namespace": "posthog",
+    "mockEnv": "RELAYFLOWS_POSTHOG_MOCK",
+    "supported": false
+  },
+  {
+    "provider": "ramp",
+    "namespace": "ramp",
+    "mockEnv": "RELAYFLOWS_RAMP_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "recall",
+    "namespace": "recall",
+    "mockEnv": "RELAYFLOWS_RECALL_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "reddit",
+    "namespace": "reddit",
+    "mockEnv": "RELAYFLOWS_REDDIT_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "redis",
+    "namespace": "redis",
+    "mockEnv": "RELAYFLOWS_REDIS_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "s3",
+    "namespace": "s3",
+    "mockEnv": "RELAYFLOWS_S3_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "salesforce",
+    "namespace": "salesforce",
+    "mockEnv": "RELAYFLOWS_SALESFORCE_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "segment",
+    "namespace": "segment",
+    "mockEnv": "RELAYFLOWS_SEGMENT_MOCK",
+    "supported": false
+  },
+  {
+    "provider": "sendgrid",
+    "namespace": "sendgrid",
+    "mockEnv": "RELAYFLOWS_SENDGRID_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "sharepoint",
+    "namespace": "sharepoint",
+    "mockEnv": "RELAYFLOWS_SHAREPOINT_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "shopify",
+    "namespace": "shopify",
+    "mockEnv": "RELAYFLOWS_SHOPIFY_MOCK",
+    "supported": false
+  },
+  {
+    "provider": "shortcut",
+    "namespace": "shortcut",
+    "mockEnv": "RELAYFLOWS_SHORTCUT_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "slack",
+    "namespace": "slack",
+    "mockEnv": "RELAYFLOWS_SLACK_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "stripe",
+    "namespace": "stripe",
+    "mockEnv": "RELAYFLOWS_STRIPE_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "teams",
+    "namespace": "teams",
+    "mockEnv": "RELAYFLOWS_TEAMS_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "telegram",
+    "namespace": "telegram",
+    "mockEnv": "RELAYFLOWS_TELEGRAM_MOCK",
+    "supported": true
+  },
+  {
+    "provider": "webhook-server",
+    "namespace": "webhookServer",
+    "mockEnv": "RELAYFLOWS_WEBHOOK_SERVER_MOCK",
+    "supported": false
+  },
+  {
+    "provider": "x",
+    "namespace": "x",
+    "mockEnv": "RELAYFLOWS_X_MOCK",
+    "supported": false
+  },
+  {
+    "provider": "zendesk",
+    "namespace": "zendesk",
+    "mockEnv": "RELAYFLOWS_ZENDESK_MOCK",
+    "supported": true
+  }
+] as const;

package/src/helpers/ramp.ts

@@ -0,0 +1,12 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { providerClient } from "@relayfile/relay-helpers";
+import type { RelayClientOptions } from "@relayfile/relay-helpers/transport";
+const rampClient = (options: RelayClientOptions) => providerClient("ramp", options);
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type RampHelper = JournalHelper<ReturnType<typeof rampClient>>;
+
+export const createRampHelper = (dispatch: EffectDispatcher): RampHelper =>
+  bindHelper("ramp", rampClient, dispatch);

package/src/helpers/recall.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { recallClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type RecallHelper = JournalHelper<ReturnType<typeof recallClient>>;
+
+export const createRecallHelper = (dispatch: EffectDispatcher): RecallHelper =>
+  bindHelper("recall", recallClient, dispatch);

package/src/helpers/reddit.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { redditClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type RedditHelper = JournalHelper<ReturnType<typeof redditClient>>;
+
+export const createRedditHelper = (dispatch: EffectDispatcher): RedditHelper =>
+  bindHelper("reddit", redditClient, dispatch);

package/src/helpers/redis.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { redisClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type RedisHelper = JournalHelper<ReturnType<typeof redisClient>>;
+
+export const createRedisHelper = (dispatch: EffectDispatcher): RedisHelper =>
+  bindHelper("redis", redisClient, dispatch);

package/src/helpers/s3.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { s3Client } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type S3Helper = JournalHelper<ReturnType<typeof s3Client>>;
+
+export const createS3Helper = (dispatch: EffectDispatcher): S3Helper =>
+  bindHelper("s3", s3Client, dispatch);

package/src/helpers/salesforce.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { salesforceClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type SalesforceHelper = JournalHelper<ReturnType<typeof salesforceClient>>;
+
+export const createSalesforceHelper = (dispatch: EffectDispatcher): SalesforceHelper =>
+  bindHelper("salesforce", salesforceClient, dispatch);

package/src/helpers/segment.ts

@@ -0,0 +1,9 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { bindHelper, type EffectDispatcher, type JournalHelper, type UnavailableHelper } from "../effect-transport.js";
+
+export type SegmentHelper = UnavailableHelper;
+
+export const createSegmentHelper = (dispatch: EffectDispatcher): SegmentHelper =>
+  bindHelper("segment", undefined, dispatch);

package/src/helpers/sendgrid.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { sendgridClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type SendgridHelper = JournalHelper<ReturnType<typeof sendgridClient>>;
+
+export const createSendgridHelper = (dispatch: EffectDispatcher): SendgridHelper =>
+  bindHelper("sendgrid", sendgridClient, dispatch);

package/src/helpers/sharepoint.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { sharepointClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type SharepointHelper = JournalHelper<ReturnType<typeof sharepointClient>>;
+
+export const createSharepointHelper = (dispatch: EffectDispatcher): SharepointHelper =>
+  bindHelper("sharepoint", sharepointClient, dispatch);

package/src/helpers/shopify.ts

@@ -0,0 +1,9 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { bindHelper, type EffectDispatcher, type JournalHelper, type UnavailableHelper } from "../effect-transport.js";
+
+export type ShopifyHelper = UnavailableHelper;
+
+export const createShopifyHelper = (dispatch: EffectDispatcher): ShopifyHelper =>
+  bindHelper("shopify", undefined, dispatch);

package/src/helpers/shortcut.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { shortcutClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type ShortcutHelper = JournalHelper<ReturnType<typeof shortcutClient>>;
+
+export const createShortcutHelper = (dispatch: EffectDispatcher): ShortcutHelper =>
+  bindHelper("shortcut", shortcutClient, dispatch);

package/src/helpers/slack.ts

@@ -0,0 +1,16 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import type { SlackHelper as RuntimeSlackHelper } from "../slack.js";
+
+/** Generated from the pinned Slack OpenAPI fragments in scripts/slack-message-schema.json. */
+export type SlackBlock = { type: string; [key: string]: unknown; };
+export type SlackAttachment = { [key: string]: unknown; };
+
+/** Adapter argument shapes over the journal-backed Slack dispatcher. */
+export interface SlackHelper {
+  post(...args: Parameters<RuntimeSlackHelper["post"]>): ReturnType<RuntimeSlackHelper["post"]>;
+  dm(user: string, text: string): ReturnType<RuntimeSlackHelper["dm"]>;
+  reply(channel: string, threadTs: string, text: string): ReturnType<RuntimeSlackHelper["reply"]>;
+  react(channel: string, messageTs: string, emoji: string): ReturnType<RuntimeSlackHelper["react"]>;
+}

package/src/helpers/stripe.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { stripeClient } from "../helper-clients.js";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type StripeHelper = JournalHelper<ReturnType<typeof stripeClient>>;
+
+export const createStripeHelper = (dispatch: EffectDispatcher): StripeHelper =>
+  bindHelper("stripe", stripeClient, dispatch);

package/src/helpers/teams.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { teamsClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type TeamsHelper = JournalHelper<ReturnType<typeof teamsClient>>;
+
+export const createTeamsHelper = (dispatch: EffectDispatcher): TeamsHelper =>
+  bindHelper("teams", teamsClient, dispatch);

package/src/helpers/telegram.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { telegramClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type TelegramHelper = JournalHelper<ReturnType<typeof telegramClient>>;
+
+export const createTelegramHelper = (dispatch: EffectDispatcher): TelegramHelper =>
+  bindHelper("telegram", telegramClient, dispatch);

package/src/helpers/webhook-server.ts

@@ -0,0 +1,9 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { bindHelper, type EffectDispatcher, type JournalHelper, type UnavailableHelper } from "../effect-transport.js";
+
+export type WebhookServerHelper = UnavailableHelper;
+
+export const createWebhookServerHelper = (dispatch: EffectDispatcher): WebhookServerHelper =>
+  bindHelper("webhook-server", undefined, dispatch);

package/src/helpers/x.ts

@@ -0,0 +1,9 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { bindHelper, type EffectDispatcher, type JournalHelper, type UnavailableHelper } from "../effect-transport.js";
+
+export type XHelper = UnavailableHelper;
+
+export const createXHelper = (dispatch: EffectDispatcher): XHelper =>
+  bindHelper("x", undefined, dispatch);

package/src/helpers/zendesk.ts

@@ -0,0 +1,10 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import { zendeskClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type ZendeskHelper = JournalHelper<ReturnType<typeof zendeskClient>>;
+
+export const createZendeskHelper = (dispatch: EffectDispatcher): ZendeskHelper =>
+  bindHelper("zendesk", zendeskClient, dispatch);

package/src/index.ts

@@ -7,16 +7,40 @@ export type {
   WorkerSummary,
   CloudHelper,
 } from "./cloud.js";
-export type { AgentOptions, AgentResult, Ctx } from "./context.js";
+export type { AgentOptions, AgentResult, LlmOptions, Ctx } from "./context.js";
 export {
   COMPLETION_REASONS,
   RUN_COMPLETION_REASONS,
   type CompletionReason,
   type RunCompletionReason,
+  type FlowCompletionReason,
 } from "./completion.js";
-export type { Step } from "./step.js";
+export type {
+  Step,
+  NamedGate,
+  ReferencesInputNamedGate,
+  SubprocessNamedGate,
+  WordCountBoundsNamedGate,
+  RegexMatchNamedGate,
+} from "./step.js";
 export {
   flow,
   type FlowHandle,
+  type TriggeredFlowHandle,
   type FlowHeader,
 } from "./flow.js";
+export {
+  flowRunWritebackIdempotency,
+  type SlackHelper,
+  type SlackReceipt,
+  type SlackBlock,
+  type SlackAttachment,
+  type SlackPostMessage,
+  type SlackPostOptions,
+} from "./slack.js";
+export type { Helpers } from "./helpers/index.js";
+export type { MemoryHelper, MemoryFinding, MemoryRecallOptions, HistoryEntry, TrajectoryEntry } from "./memory.js";
+export { webhook, type TriggerSource, type WebhookFilter, type WebhookValue } from "./triggers.js";
+export * from "./triggers/index.js";
+export type { ProviderTriggerSource } from "./provider-trigger.js";
+export type { PluginMethod, PluginPrimitive } from './plugin-contract.js';

package/src/memory.ts

@@ -0,0 +1,20 @@
+import type { HistoryEntry, SearchOptions, TrajectoryEntry } from "ai-hist";
+
+export type { HistoryEntry, TrajectoryEntry } from "ai-hist";
+/** Reads cannot widen the current flow's script scope. */
+export type MemoryRecallOptions = Omit<SearchOptions, "project">;
+export interface MemoryFinding {
+  question: string;
+  chosen: string;
+  reasoning: string;
+  alternatives?: string[];
+}
+
+export interface MemoryHelper {
+  /** Local script memory read; does not journal a step. */
+  recall(query: string, options?: MemoryRecallOptions): Promise<HistoryEntry[]>;
+  /** Best matching decision trajectory, or an empty array. No journal step. */
+  why(task: string): Promise<TrajectoryEntry[]>;
+  /** Reserved for the journal-backed write slice; currently refuses. */
+  learn(finding: MemoryFinding): Promise<void>;
+}

package/src/plugin-contract.ts

@@ -0,0 +1,5 @@
+import type { Step } from './step.js';
+
+/** Plugins augment Ctx in @relayflows/surface; no catch-all index signature. */
+export type PluginMethod<Args, Output = unknown> = (args: Args) => Step<Output>;
+export type PluginPrimitive = 'run' | 'llm' | 'agent' | 'effect' | 'wait';