@relayflows/surface 2.0.8 → 2.0.10

package/src/helper-clients.ts

@@ -0,0 +1,30 @@
+import { githubClient as upstreamGithub, notionClient as upstreamNotion, created } from '@relayfile/relay-helpers';
+import type { RelayClientOptions } from '@relayfile/relay-helpers/transport';
+
+/** Accept the conventional owner/repo shorthand as well as upstream arguments. */
+export function githubClient(options: RelayClientOptions) {
+  const client = upstreamGithub(options);
+  return { ...client, createIssue(args: { owner?: string; repo: string; title: string; body: string; labels?: string[] }) {
+    const [owner, repo, extra] = args.repo.split('/');
+    if (!args.owner && (!owner || !repo || extra)) throw new Error('github.createIssue requires repo: "owner/repo" or an explicit owner');
+    return client.createIssue({ ...args, owner: args.owner ?? owner!, repo: args.owner ? args.repo : repo! });
+  } };
+}
+
+export function stripeClient(options: RelayClientOptions) {
+  return { createInvoice(args: { customer: string; auto_advance?: boolean; collection_method?: 'charge_automatically' | 'send_invoice'; days_until_due?: number; description?: string; metadata?: Record<string, string> }) {
+    if (!options.transport) throw new Error('Stripe requires a journal transport');
+    return created(options.transport.write({ provider: 'stripe', resource: 'invoices',
+      parameters: {}, path: '/stripe/invoices', body: args }));
+  } };
+}
+
+export function notionClient(options: RelayClientOptions) {
+  return { ...upstreamNotion(options), async appendBlock(args: { pageId: string; block: Record<string, unknown> }) {
+    if (!options.transport) throw new Error('Notion requires a journal transport');
+    // The adapter does not yet support this route. The runtime refuses it in
+    // mount mode, while mock mode can exercise authoring and effect lowering.
+    return created(options.transport.write({ provider: 'notion', resource: 'blocks',
+      parameters: { pageId: args.pageId }, path: `/notion/pages/${encodeURIComponent(args.pageId)}/blocks`, body: { children: [args.block] } }));
+  } };
+}

package/src/helpers/README.md

@@ -0,0 +1,42 @@
+Generated TypeScript helpers; do not edit the `.ts` files. Run
+`npm run gen --prefix packages/surface` from the repository root (or `npm run gen`
+inside this package). This repository has no root npm workspace, so
+`npm run gen -w @relayflows/surface` is not available.
+
+This minimal slice ships Slack's four existing journal-backed methods. Argument
+shapes come from the pinned `@relayfile/relay-helpers` declaration; return types
+come from the existing surface dispatcher contract, including `reply`'s `ref`.
+`post` extends that contract with a structured second argument (`text`, `blocks`,
+`attachments`) or `blocks`/`attachments` in its third options argument. Options
+take precedence when both forms provide the same field. `replyTo` still maps to
+the adapter's `parentRef`; no interaction callback registration is added.
+
+The pinned relay-helpers 0.4.11 package does **not** export Block Kit/OpenAPI
+types. Until it does, `scripts/slack-message-schema.json` vendors the small
+fragments used by the generator, with their upstream URL and JSON pointers.
+Slack's published OpenAPI schema requires a string `type` on blocks but leaves
+their other fields open. Attachment objects are likewise open (the generic
+chat.update message schema is used; chat.postMessage's response attachment
+schema requires a server-assigned `id`, unsuitable for authoring).
+These types do not validate individual block layouts or interaction handlers.
+The SDK preserves structured content at the adapter transport boundary because
+the pinned adapter's ergonomic `post` still accepts only text.
+
+`Ctx` extends the generated `Helpers` namespace map. A union of namespace maps
+would make only their common properties accessible, so composition uses an
+interface instead.
+
+To consume a read-only adapter checkout before release:
+`node scripts/generate-helpers.mjs --adapters-dir /path/to/relayfile-adapters`.
+Use `--out-dir /tmp/generated-helpers` to inspect output without changing source.
+CI regenerates from the installed pinned package and compares every generated
+TypeScript file byte-for-byte, including the namespace index.
+
+Follow-up for the full slice N: add GitHub, Notion, Linear, and Stripe once their
+methods have runtime dispatch support; consume mapping/discovery resources and
+generate the remaining providers. The current runtime implements only Slack.
+The uniform upstream clients expose resource `read`/`list`/`write` methods,
+not `stripe.createInvoice` or `notion.appendBlock`; those aliases need an agreed
+runtime contract before this types-only generator can expose them. GitHub's
+bespoke `createIssue` also requires `owner` in addition to `repo`, `title`, and
+`body`. No new provider methods or resource methods are advertised in this proof.

package/src/helpers/airtable.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 AirtableHelper = UnavailableHelper;
+
+export const createAirtableHelper = (dispatch: EffectDispatcher): AirtableHelper =>
+  bindHelper("airtable", undefined, dispatch);

package/src/helpers/asana.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 { asanaClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type AsanaHelper = JournalHelper<ReturnType<typeof asanaClient>>;
+
+export const createAsanaHelper = (dispatch: EffectDispatcher): AsanaHelper =>
+  bindHelper("asana", asanaClient, dispatch);

package/src/helpers/azure-blob.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 { azureBlobClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type AzureBlobHelper = JournalHelper<ReturnType<typeof azureBlobClient>>;
+
+export const createAzureBlobHelper = (dispatch: EffectDispatcher): AzureBlobHelper =>
+  bindHelper("azure-blob", azureBlobClient, dispatch);

package/src/helpers/box.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 { boxClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type BoxHelper = JournalHelper<ReturnType<typeof boxClient>>;
+
+export const createBoxHelper = (dispatch: EffectDispatcher): BoxHelper =>
+  bindHelper("box", boxClient, dispatch);

package/src/helpers/calendly.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 { calendlyClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type CalendlyHelper = JournalHelper<ReturnType<typeof calendlyClient>>;
+
+export const createCalendlyHelper = (dispatch: EffectDispatcher): CalendlyHelper =>
+  bindHelper("calendly", calendlyClient, dispatch);

package/src/helpers/clickup.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 { clickupClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type ClickupHelper = JournalHelper<ReturnType<typeof clickupClient>>;
+
+export const createClickupHelper = (dispatch: EffectDispatcher): ClickupHelper =>
+  bindHelper("clickup", clickupClient, dispatch);

package/src/helpers/clients.ts

@@ -0,0 +1,48 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import * as upstream from "@relayfile/relay-helpers";
+import * as custom from "../helper-clients.js";
+import type { HelperFactory } from "../effect-transport.js";
+
+export const helperClients: Readonly<Record<string, HelperFactory>> = {
+  "asana": upstream.asanaClient,
+  "azure-blob": upstream.azureBlobClient,
+  "box": upstream.boxClient,
+  "calendly": upstream.calendlyClient,
+  "clickup": upstream.clickupClient,
+  "cloudflare": upstream.cloudflareClient,
+  "confluence": upstream.confluenceClient,
+  "daytona": upstream.daytonaClient,
+  "dropbox": upstream.dropboxClient,
+  "gcs": upstream.gcsClient,
+  "github": custom.githubClient,
+  "gitlab": upstream.gitlabClient,
+  "gmail": upstream.gmailClient,
+  "google-calendar": upstream.googleCalendarClient,
+  "google-drive": upstream.googleDriveClient,
+  "granola": upstream.granolaClient,
+  "hubspot": upstream.hubspotClient,
+  "intercom": upstream.intercomClient,
+  "jira": upstream.jiraClient,
+  "linear": upstream.linearClient,
+  "mailgun": upstream.mailgunClient,
+  "mixpanel": upstream.mixpanelClient,
+  "notion": custom.notionClient,
+  "onedrive": upstream.onedriveClient,
+  "pipedrive": upstream.pipedriveClient,
+  "postgres": upstream.postgresClient,
+  "ramp": (options) => upstream.providerClient("ramp", options),
+  "recall": upstream.recallClient,
+  "reddit": upstream.redditClient,
+  "redis": upstream.redisClient,
+  "s3": upstream.s3Client,
+  "salesforce": upstream.salesforceClient,
+  "sendgrid": upstream.sendgridClient,
+  "sharepoint": upstream.sharepointClient,
+  "shortcut": upstream.shortcutClient,
+  "stripe": custom.stripeClient,
+  "teams": upstream.teamsClient,
+  "telegram": upstream.telegramClient,
+  "zendesk": upstream.zendeskClient,
+};

package/src/helpers/cloudflare.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 { cloudflareClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type CloudflareHelper = JournalHelper<ReturnType<typeof cloudflareClient>>;
+
+export const createCloudflareHelper = (dispatch: EffectDispatcher): CloudflareHelper =>
+  bindHelper("cloudflare", cloudflareClient, dispatch);

package/src/helpers/confluence.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 { confluenceClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type ConfluenceHelper = JournalHelper<ReturnType<typeof confluenceClient>>;
+
+export const createConfluenceHelper = (dispatch: EffectDispatcher): ConfluenceHelper =>
+  bindHelper("confluence", confluenceClient, dispatch);

package/src/helpers/daytona.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 { daytonaClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type DaytonaHelper = JournalHelper<ReturnType<typeof daytonaClient>>;
+
+export const createDaytonaHelper = (dispatch: EffectDispatcher): DaytonaHelper =>
+  bindHelper("daytona", daytonaClient, dispatch);

package/src/helpers/docker-hub.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 DockerHubHelper = UnavailableHelper;
+
+export const createDockerHubHelper = (dispatch: EffectDispatcher): DockerHubHelper =>
+  bindHelper("docker-hub", undefined, dispatch);

package/src/helpers/dropbox.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 { dropboxClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type DropboxHelper = JournalHelper<ReturnType<typeof dropboxClient>>;
+
+export const createDropboxHelper = (dispatch: EffectDispatcher): DropboxHelper =>
+  bindHelper("dropbox", dropboxClient, dispatch);

package/src/helpers/fathom.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 FathomHelper = UnavailableHelper;
+
+export const createFathomHelper = (dispatch: EffectDispatcher): FathomHelper =>
+  bindHelper("fathom", undefined, dispatch);

package/src/helpers/gcp.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 GcpHelper = UnavailableHelper;
+
+export const createGcpHelper = (dispatch: EffectDispatcher): GcpHelper =>
+  bindHelper("gcp", undefined, dispatch);

package/src/helpers/gcs.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 { gcsClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type GcsHelper = JournalHelper<ReturnType<typeof gcsClient>>;
+
+export const createGcsHelper = (dispatch: EffectDispatcher): GcsHelper =>
+  bindHelper("gcs", gcsClient, dispatch);

package/src/helpers/github.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 { githubClient } from "../helper-clients.js";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type GithubHelper = JournalHelper<ReturnType<typeof githubClient>>;
+
+export const createGithubHelper = (dispatch: EffectDispatcher): GithubHelper =>
+  bindHelper("github", githubClient, dispatch);

package/src/helpers/gitlab.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 { gitlabClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type GitlabHelper = JournalHelper<ReturnType<typeof gitlabClient>>;
+
+export const createGitlabHelper = (dispatch: EffectDispatcher): GitlabHelper =>
+  bindHelper("gitlab", gitlabClient, dispatch);

package/src/helpers/gmail.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 { gmailClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type GmailHelper = JournalHelper<ReturnType<typeof gmailClient>>;
+
+export const createGmailHelper = (dispatch: EffectDispatcher): GmailHelper =>
+  bindHelper("gmail", gmailClient, dispatch);

package/src/helpers/google-calendar.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 { googleCalendarClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type GoogleCalendarHelper = JournalHelper<ReturnType<typeof googleCalendarClient>>;
+
+export const createGoogleCalendarHelper = (dispatch: EffectDispatcher): GoogleCalendarHelper =>
+  bindHelper("google-calendar", googleCalendarClient, dispatch);

package/src/helpers/google-drive.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 { googleDriveClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type GoogleDriveHelper = JournalHelper<ReturnType<typeof googleDriveClient>>;
+
+export const createGoogleDriveHelper = (dispatch: EffectDispatcher): GoogleDriveHelper =>
+  bindHelper("google-drive", googleDriveClient, dispatch);

package/src/helpers/granola.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 { granolaClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type GranolaHelper = JournalHelper<ReturnType<typeof granolaClient>>;
+
+export const createGranolaHelper = (dispatch: EffectDispatcher): GranolaHelper =>
+  bindHelper("granola", granolaClient, dispatch);

package/src/helpers/hubspot.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 { hubspotClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type HubspotHelper = JournalHelper<ReturnType<typeof hubspotClient>>;
+
+export const createHubspotHelper = (dispatch: EffectDispatcher): HubspotHelper =>
+  bindHelper("hubspot", hubspotClient, dispatch);

package/src/helpers/index.ts

@@ -0,0 +1,212 @@
+// GENERATED by scripts/generate-helpers.mjs — do not edit.
+// Run `npm run gen --prefix packages/surface` from the repository root.
+
+import type { SlackHelper } from "./slack.js";
+import { createAirtableHelper, type AirtableHelper } from "./airtable.js";
+import { createAsanaHelper, type AsanaHelper } from "./asana.js";
+import { createAzureBlobHelper, type AzureBlobHelper } from "./azure-blob.js";
+import { createBoxHelper, type BoxHelper } from "./box.js";
+import { createCalendlyHelper, type CalendlyHelper } from "./calendly.js";
+import { createClickupHelper, type ClickupHelper } from "./clickup.js";
+import { createCloudflareHelper, type CloudflareHelper } from "./cloudflare.js";
+import { createConfluenceHelper, type ConfluenceHelper } from "./confluence.js";
+import { createDaytonaHelper, type DaytonaHelper } from "./daytona.js";
+import { createDockerHubHelper, type DockerHubHelper } from "./docker-hub.js";
+import { createDropboxHelper, type DropboxHelper } from "./dropbox.js";
+import { createFathomHelper, type FathomHelper } from "./fathom.js";
+import { createGcpHelper, type GcpHelper } from "./gcp.js";
+import { createGcsHelper, type GcsHelper } from "./gcs.js";
+import { createGithubHelper, type GithubHelper } from "./github.js";
+import { createGitlabHelper, type GitlabHelper } from "./gitlab.js";
+import { createGmailHelper, type GmailHelper } from "./gmail.js";
+import { createGoogleCalendarHelper, type GoogleCalendarHelper } from "./google-calendar.js";
+import { createGoogleDriveHelper, type GoogleDriveHelper } from "./google-drive.js";
+import { createGranolaHelper, type GranolaHelper } from "./granola.js";
+import { createHubspotHelper, type HubspotHelper } from "./hubspot.js";
+import { createIntercomHelper, type IntercomHelper } from "./intercom.js";
+import { createJiraHelper, type JiraHelper } from "./jira.js";
+import { createLinearHelper, type LinearHelper } from "./linear.js";
+import { createMailgunHelper, type MailgunHelper } from "./mailgun.js";
+import { createMixpanelHelper, type MixpanelHelper } from "./mixpanel.js";
+import { createNeonHelper, type NeonHelper } from "./neon.js";
+import { createNotionHelper, type NotionHelper } from "./notion.js";
+import { createOnedriveHelper, type OnedriveHelper } from "./onedrive.js";
+import { createPipedriveHelper, type PipedriveHelper } from "./pipedrive.js";
+import { createPostgresHelper, type PostgresHelper } from "./postgres.js";
+import { createPosthogHelper, type PosthogHelper } from "./posthog.js";
+import { createRampHelper, type RampHelper } from "./ramp.js";
+import { createRecallHelper, type RecallHelper } from "./recall.js";
+import { createRedditHelper, type RedditHelper } from "./reddit.js";
+import { createRedisHelper, type RedisHelper } from "./redis.js";
+import { createS3Helper, type S3Helper } from "./s3.js";
+import { createSalesforceHelper, type SalesforceHelper } from "./salesforce.js";
+import { createSegmentHelper, type SegmentHelper } from "./segment.js";
+import { createSendgridHelper, type SendgridHelper } from "./sendgrid.js";
+import { createSharepointHelper, type SharepointHelper } from "./sharepoint.js";
+import { createShopifyHelper, type ShopifyHelper } from "./shopify.js";
+import { createShortcutHelper, type ShortcutHelper } from "./shortcut.js";
+import { createStripeHelper, type StripeHelper } from "./stripe.js";
+import { createTeamsHelper, type TeamsHelper } from "./teams.js";
+import { createTelegramHelper, type TelegramHelper } from "./telegram.js";
+import { createWebhookServerHelper, type WebhookServerHelper } from "./webhook-server.js";
+import { createXHelper, type XHelper } from "./x.js";
+import { createZendeskHelper, type ZendeskHelper } from "./zendesk.js";
+import type { EffectDispatcher } from "../effect-transport.js";
+
+export type { AirtableHelper } from "./airtable.js";
+export type { AsanaHelper } from "./asana.js";
+export type { AzureBlobHelper } from "./azure-blob.js";
+export type { BoxHelper } from "./box.js";
+export type { CalendlyHelper } from "./calendly.js";
+export type { ClickupHelper } from "./clickup.js";
+export type { CloudflareHelper } from "./cloudflare.js";
+export type { ConfluenceHelper } from "./confluence.js";
+export type { DaytonaHelper } from "./daytona.js";
+export type { DockerHubHelper } from "./docker-hub.js";
+export type { DropboxHelper } from "./dropbox.js";
+export type { FathomHelper } from "./fathom.js";
+export type { GcpHelper } from "./gcp.js";
+export type { GcsHelper } from "./gcs.js";
+export type { GithubHelper } from "./github.js";
+export type { GitlabHelper } from "./gitlab.js";
+export type { GmailHelper } from "./gmail.js";
+export type { GoogleCalendarHelper } from "./google-calendar.js";
+export type { GoogleDriveHelper } from "./google-drive.js";
+export type { GranolaHelper } from "./granola.js";
+export type { HubspotHelper } from "./hubspot.js";
+export type { IntercomHelper } from "./intercom.js";
+export type { JiraHelper } from "./jira.js";
+export type { LinearHelper } from "./linear.js";
+export type { MailgunHelper } from "./mailgun.js";
+export type { MixpanelHelper } from "./mixpanel.js";
+export type { NeonHelper } from "./neon.js";
+export type { NotionHelper } from "./notion.js";
+export type { OnedriveHelper } from "./onedrive.js";
+export type { PipedriveHelper } from "./pipedrive.js";
+export type { PostgresHelper } from "./postgres.js";
+export type { PosthogHelper } from "./posthog.js";
+export type { RampHelper } from "./ramp.js";
+export type { RecallHelper } from "./recall.js";
+export type { RedditHelper } from "./reddit.js";
+export type { RedisHelper } from "./redis.js";
+export type { S3Helper } from "./s3.js";
+export type { SalesforceHelper } from "./salesforce.js";
+export type { SegmentHelper } from "./segment.js";
+export type { SendgridHelper } from "./sendgrid.js";
+export type { SharepointHelper } from "./sharepoint.js";
+export type { ShopifyHelper } from "./shopify.js";
+export type { ShortcutHelper } from "./shortcut.js";
+export type { SlackHelper } from "./slack.js";
+export type { StripeHelper } from "./stripe.js";
+export type { TeamsHelper } from "./teams.js";
+export type { TelegramHelper } from "./telegram.js";
+export type { WebhookServerHelper } from "./webhook-server.js";
+export type { XHelper } from "./x.js";
+export type { ZendeskHelper } from "./zendesk.js";
+
+export interface Helpers {
+  airtable: AirtableHelper;
+  asana: AsanaHelper;
+  azureBlob: AzureBlobHelper;
+  box: BoxHelper;
+  calendly: CalendlyHelper;
+  clickup: ClickupHelper;
+  cloudflare: CloudflareHelper;
+  confluence: ConfluenceHelper;
+  daytona: DaytonaHelper;
+  dockerHub: DockerHubHelper;
+  dropbox: DropboxHelper;
+  fathom: FathomHelper;
+  gcp: GcpHelper;
+  gcs: GcsHelper;
+  github: GithubHelper;
+  gitlab: GitlabHelper;
+  gmail: GmailHelper;
+  googleCalendar: GoogleCalendarHelper;
+  googleDrive: GoogleDriveHelper;
+  granola: GranolaHelper;
+  hubspot: HubspotHelper;
+  intercom: IntercomHelper;
+  jira: JiraHelper;
+  linear: LinearHelper;
+  mailgun: MailgunHelper;
+  mixpanel: MixpanelHelper;
+  neon: NeonHelper;
+  notion: NotionHelper;
+  onedrive: OnedriveHelper;
+  pipedrive: PipedriveHelper;
+  postgres: PostgresHelper;
+  posthog: PosthogHelper;
+  ramp: RampHelper;
+  recall: RecallHelper;
+  reddit: RedditHelper;
+  redis: RedisHelper;
+  s3: S3Helper;
+  salesforce: SalesforceHelper;
+  segment: SegmentHelper;
+  sendgrid: SendgridHelper;
+  sharepoint: SharepointHelper;
+  shopify: ShopifyHelper;
+  shortcut: ShortcutHelper;
+  slack: SlackHelper;
+  stripe: StripeHelper;
+  teams: TeamsHelper;
+  telegram: TelegramHelper;
+  webhookServer: WebhookServerHelper;
+  x: XHelper;
+  zendesk: ZendeskHelper;
+}
+
+export function createHelpers(dispatch: EffectDispatcher): Omit<Helpers, "slack"> {
+  return {
+    airtable: createAirtableHelper(dispatch),
+    asana: createAsanaHelper(dispatch),
+    azureBlob: createAzureBlobHelper(dispatch),
+    box: createBoxHelper(dispatch),
+    calendly: createCalendlyHelper(dispatch),
+    clickup: createClickupHelper(dispatch),
+    cloudflare: createCloudflareHelper(dispatch),
+    confluence: createConfluenceHelper(dispatch),
+    daytona: createDaytonaHelper(dispatch),
+    dockerHub: createDockerHubHelper(dispatch),
+    dropbox: createDropboxHelper(dispatch),
+    fathom: createFathomHelper(dispatch),
+    gcp: createGcpHelper(dispatch),
+    gcs: createGcsHelper(dispatch),
+    github: createGithubHelper(dispatch),
+    gitlab: createGitlabHelper(dispatch),
+    gmail: createGmailHelper(dispatch),
+    googleCalendar: createGoogleCalendarHelper(dispatch),
+    googleDrive: createGoogleDriveHelper(dispatch),
+    granola: createGranolaHelper(dispatch),
+    hubspot: createHubspotHelper(dispatch),
+    intercom: createIntercomHelper(dispatch),
+    jira: createJiraHelper(dispatch),
+    linear: createLinearHelper(dispatch),
+    mailgun: createMailgunHelper(dispatch),
+    mixpanel: createMixpanelHelper(dispatch),
+    neon: createNeonHelper(dispatch),
+    notion: createNotionHelper(dispatch),
+    onedrive: createOnedriveHelper(dispatch),
+    pipedrive: createPipedriveHelper(dispatch),
+    postgres: createPostgresHelper(dispatch),
+    posthog: createPosthogHelper(dispatch),
+    ramp: createRampHelper(dispatch),
+    recall: createRecallHelper(dispatch),
+    reddit: createRedditHelper(dispatch),
+    redis: createRedisHelper(dispatch),
+    s3: createS3Helper(dispatch),
+    salesforce: createSalesforceHelper(dispatch),
+    segment: createSegmentHelper(dispatch),
+    sendgrid: createSendgridHelper(dispatch),
+    sharepoint: createSharepointHelper(dispatch),
+    shopify: createShopifyHelper(dispatch),
+    shortcut: createShortcutHelper(dispatch),
+    stripe: createStripeHelper(dispatch),
+    teams: createTeamsHelper(dispatch),
+    telegram: createTelegramHelper(dispatch),
+    webhookServer: createWebhookServerHelper(dispatch),
+    x: createXHelper(dispatch),
+    zendesk: createZendeskHelper(dispatch),
+  };
+}

package/src/helpers/intercom.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 { intercomClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type IntercomHelper = JournalHelper<ReturnType<typeof intercomClient>>;
+
+export const createIntercomHelper = (dispatch: EffectDispatcher): IntercomHelper =>
+  bindHelper("intercom", intercomClient, dispatch);

package/src/helpers/jira.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 { jiraClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type JiraHelper = JournalHelper<ReturnType<typeof jiraClient>>;
+
+export const createJiraHelper = (dispatch: EffectDispatcher): JiraHelper =>
+  bindHelper("jira", jiraClient, dispatch);

package/src/helpers/linear.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 { linearClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type LinearHelper = JournalHelper<ReturnType<typeof linearClient>>;
+
+export const createLinearHelper = (dispatch: EffectDispatcher): LinearHelper =>
+  bindHelper("linear", linearClient, dispatch);

package/src/helpers/mailgun.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 { mailgunClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type MailgunHelper = JournalHelper<ReturnType<typeof mailgunClient>>;
+
+export const createMailgunHelper = (dispatch: EffectDispatcher): MailgunHelper =>
+  bindHelper("mailgun", mailgunClient, dispatch);

package/src/helpers/mixpanel.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 { mixpanelClient } from "@relayfile/relay-helpers";
+import { bindHelper, type EffectDispatcher, type JournalHelper } from "../effect-transport.js";
+
+export type MixpanelHelper = JournalHelper<ReturnType<typeof mixpanelClient>>;
+
+export const createMixpanelHelper = (dispatch: EffectDispatcher): MixpanelHelper =>
+  bindHelper("mixpanel", mixpanelClient, dispatch);