@relayfile/relay-helpers 0.1.0

package/README.md

@@ -0,0 +1,48 @@
+# @relayfile/relay-helpers
+
+Ergonomic, catalog-backed provider clients for Workforce agent handlers.
+
+The runtime exposes only generic VFS helpers (`writeJsonFile`, `readJsonFile`, …);
+the per-provider typed clients (`ctx.linear.comment(...)`) were removed. This
+package recovers that ergonomics as an **opt-in factory**, with every path
+sourced from [`@relayfile/adapter-core/writeback-paths`](https://www.npmjs.com/package/@relayfile/adapter-core)
+(the adapter-owned source of truth) instead of hardcoded — so paths never drift
+from the adapter that materializes the draft.
+
+```ts
+import { linearClient, githubClient, slackClient } from '@relayfile/relay-helpers';
+
+const linear = linearClient();             // binds the mount root once (RELAYFILE_MOUNT_ROOT)
+const issue = await linear.getIssue(issueId);
+await linear.comment(issueId, ':rocket: done');
+
+await githubClient().mergePullRequest({ owner, repo, number });
+await slackClient().post('#eng', 'shipped');
+```
+
+## A named client for every provider
+
+Every provider in the catalog has a named client (`asanaClient`, `notionClient`,
+`jiraClient`, … — all 29), exposing its resources as
+`.{resource}.{path,write,read,list}`:
+
+```ts
+import { notionClient } from '@relayfile/relay-helpers';
+
+const notion = notionClient();
+notion.pages.path({ databaseId });                  // resolve a path (no IO)
+await notion.pages.write({ databaseId }, { /* … */ }); // collection create or item write
+await notion.pages.list({ databaseId });               // list a collection
+```
+
+- `write(params, body)` drops a uniquely-named draft for a collection resource,
+  or writes directly to an item resource (a path ending in `.json`). The
+  Relayfile writeback worker turns the draft into the real provider call.
+- `read` / `list` operate over the catalog paths.
+- Unknown providers/resources or missing path params throw loudly — never a
+  guessed path.
+
+`linearClient` / `githubClient` / `slackClient` are the same resource-keyed
+clients **plus** named ergonomic methods (`comment`, `post`, `mergePullRequest`,
+…). `relayClient(provider)` is the dynamic, string-keyed escape hatch when the
+provider isn't known at author time.

package/dist/generated/clients.d.ts

@@ -0,0 +1,29 @@
+import type { IntegrationClientOptions } from '@relayfile/adapter-core/vfs-client';
+import { type ProviderClient } from '../provider-client.js';
+export declare const asanaClient: (opts?: IntegrationClientOptions) => ProviderClient<"asana">;
+export declare const azureBlobClient: (opts?: IntegrationClientOptions) => ProviderClient<"azure-blob">;
+export declare const boxClient: (opts?: IntegrationClientOptions) => ProviderClient<"box">;
+export declare const clickupClient: (opts?: IntegrationClientOptions) => ProviderClient<"clickup">;
+export declare const confluenceClient: (opts?: IntegrationClientOptions) => ProviderClient<"confluence">;
+export declare const dropboxClient: (opts?: IntegrationClientOptions) => ProviderClient<"dropbox">;
+export declare const gcsClient: (opts?: IntegrationClientOptions) => ProviderClient<"gcs">;
+export declare const gitlabClient: (opts?: IntegrationClientOptions) => ProviderClient<"gitlab">;
+export declare const gmailClient: (opts?: IntegrationClientOptions) => ProviderClient<"gmail">;
+export declare const googleCalendarClient: (opts?: IntegrationClientOptions) => ProviderClient<"google-calendar">;
+export declare const googleDriveClient: (opts?: IntegrationClientOptions) => ProviderClient<"google-drive">;
+export declare const granolaClient: (opts?: IntegrationClientOptions) => ProviderClient<"granola">;
+export declare const hubspotClient: (opts?: IntegrationClientOptions) => ProviderClient<"hubspot">;
+export declare const intercomClient: (opts?: IntegrationClientOptions) => ProviderClient<"intercom">;
+export declare const jiraClient: (opts?: IntegrationClientOptions) => ProviderClient<"jira">;
+export declare const notionClient: (opts?: IntegrationClientOptions) => ProviderClient<"notion">;
+export declare const onedriveClient: (opts?: IntegrationClientOptions) => ProviderClient<"onedrive">;
+export declare const pipedriveClient: (opts?: IntegrationClientOptions) => ProviderClient<"pipedrive">;
+export declare const postgresClient: (opts?: IntegrationClientOptions) => ProviderClient<"postgres">;
+export declare const redditClient: (opts?: IntegrationClientOptions) => ProviderClient<"reddit">;
+export declare const redisClient: (opts?: IntegrationClientOptions) => ProviderClient<"redis">;
+export declare const s3Client: (opts?: IntegrationClientOptions) => ProviderClient<"s3">;
+export declare const salesforceClient: (opts?: IntegrationClientOptions) => ProviderClient<"salesforce">;
+export declare const sharepointClient: (opts?: IntegrationClientOptions) => ProviderClient<"sharepoint">;
+export declare const teamsClient: (opts?: IntegrationClientOptions) => ProviderClient<"teams">;
+export declare const zendeskClient: (opts?: IntegrationClientOptions) => ProviderClient<"zendesk">;
+//# sourceMappingURL=clients.d.ts.map

package/dist/generated/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/generated/clients.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5E,eAAO,MAAM,WAAW,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,OAAO,CACrD,CAAC;AAEhC,eAAO,MAAM,eAAe,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,YAAY,CACzD,CAAC;AAErC,eAAO,MAAM,SAAS,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,KAAK,CACnD,CAAC;AAE9B,eAAO,MAAM,aAAa,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,SAAS,CACvD,CAAC;AAElC,eAAO,MAAM,gBAAgB,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,YAAY,CAC1D,CAAC;AAErC,eAAO,MAAM,aAAa,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,SAAS,CACvD,CAAC;AAElC,eAAO,MAAM,SAAS,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,KAAK,CACnD,CAAC;AAE9B,eAAO,MAAM,YAAY,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,QAAQ,CACtD,CAAC;AAEjC,eAAO,MAAM,WAAW,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,OAAO,CACrD,CAAC;AAEhC,eAAO,MAAM,oBAAoB,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,iBAAiB,CAC9D,CAAC;AAE1C,eAAO,MAAM,iBAAiB,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,cAAc,CAC3D,CAAC;AAEvC,eAAO,MAAM,aAAa,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,SAAS,CACvD,CAAC;AAElC,eAAO,MAAM,aAAa,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,SAAS,CACvD,CAAC;AAElC,eAAO,MAAM,cAAc,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,UAAU,CACxD,CAAC;AAEnC,eAAO,MAAM,UAAU,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,MAAM,CACpD,CAAC;AAE/B,eAAO,MAAM,YAAY,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,QAAQ,CACtD,CAAC;AAEjC,eAAO,MAAM,cAAc,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,UAAU,CACxD,CAAC;AAEnC,eAAO,MAAM,eAAe,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,WAAW,CACzD,CAAC;AAEpC,eAAO,MAAM,cAAc,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,UAAU,CACxD,CAAC;AAEnC,eAAO,MAAM,YAAY,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,QAAQ,CACtD,CAAC;AAEjC,eAAO,MAAM,WAAW,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,OAAO,CACrD,CAAC;AAEhC,eAAO,MAAM,QAAQ,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,IAAI,CAClD,CAAC;AAE7B,eAAO,MAAM,gBAAgB,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,YAAY,CAC1D,CAAC;AAErC,eAAO,MAAM,gBAAgB,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,YAAY,CAC1D,CAAC;AAErC,eAAO,MAAM,WAAW,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,OAAO,CACrD,CAAC;AAEhC,eAAO,MAAM,aAAa,GAAI,OAAO,wBAAwB,KAAG,cAAc,CAAC,SAAS,CACvD,CAAC"}

package/dist/generated/clients.js

@@ -0,0 +1,34 @@
+// GENERATED by scripts/generate-clients.mjs from
+// @relayfile/adapter-core/writeback-paths — do not edit by hand.
+// Run `npm run gen -w @relayfile/relay-helpers` after bumping adapter-core.
+//
+// linear / github / slack have bespoke ergonomic clients in their own modules;
+// every other catalog provider gets a uniform resource-keyed client here.
+import { providerClient } from '../provider-client.js';
+export const asanaClient = (opts) => providerClient('asana', opts);
+export const azureBlobClient = (opts) => providerClient('azure-blob', opts);
+export const boxClient = (opts) => providerClient('box', opts);
+export const clickupClient = (opts) => providerClient('clickup', opts);
+export const confluenceClient = (opts) => providerClient('confluence', opts);
+export const dropboxClient = (opts) => providerClient('dropbox', opts);
+export const gcsClient = (opts) => providerClient('gcs', opts);
+export const gitlabClient = (opts) => providerClient('gitlab', opts);
+export const gmailClient = (opts) => providerClient('gmail', opts);
+export const googleCalendarClient = (opts) => providerClient('google-calendar', opts);
+export const googleDriveClient = (opts) => providerClient('google-drive', opts);
+export const granolaClient = (opts) => providerClient('granola', opts);
+export const hubspotClient = (opts) => providerClient('hubspot', opts);
+export const intercomClient = (opts) => providerClient('intercom', opts);
+export const jiraClient = (opts) => providerClient('jira', opts);
+export const notionClient = (opts) => providerClient('notion', opts);
+export const onedriveClient = (opts) => providerClient('onedrive', opts);
+export const pipedriveClient = (opts) => providerClient('pipedrive', opts);
+export const postgresClient = (opts) => providerClient('postgres', opts);
+export const redditClient = (opts) => providerClient('reddit', opts);
+export const redisClient = (opts) => providerClient('redis', opts);
+export const s3Client = (opts) => providerClient('s3', opts);
+export const salesforceClient = (opts) => providerClient('salesforce', opts);
+export const sharepointClient = (opts) => providerClient('sharepoint', opts);
+export const teamsClient = (opts) => providerClient('teams', opts);
+export const zendeskClient = (opts) => providerClient('zendesk', opts);
+//# sourceMappingURL=clients.js.map

package/dist/generated/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/generated/clients.ts"],"names":[],"mappings":"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"}

package/dist/generic.d.ts

@@ -0,0 +1,37 @@
+import { encodeSegment, type IntegrationClientOptions, type WritebackResult } from '@relayfile/adapter-core/vfs-client';
+import { type WritebackProvider, type WritebackResource } from '@relayfile/adapter-core/writeback-paths';
+export type RelayParams = Record<string, string | number>;
+/**
+ * A catalog-backed client for one provider. Every path comes from
+ * `@relayfile/adapter-core/writeback-paths` (the adapter-owned source of
+ * truth), so handlers never hardcode `/linear/issues/...` strings that drift
+ * from the adapter. Works for any provider in the catalog; the
+ * `linearClient` / `githubClient` / `slackClient` factories wrap this with
+ * named, ergonomic methods.
+ */
+export interface RelayClient<P extends WritebackProvider> {
+    readonly provider: P;
+    /** Resolve a resource's canonical mount path (no IO). */
+    path(resource: WritebackResource<P> & string, params?: RelayParams): string;
+    /**
+     * Write `body`. For a collection resource (e.g. `/linear/issues/{id}/comments`)
+     * this drops a uniquely-named draft the Relayfile writeback worker turns into
+     * the create call. For an item resource (a path ending in `.json`, e.g.
+     * `…/pulls/{n}/merge.json`) this writes the body to that exact path.
+     */
+    write(resource: WritebackResource<P> & string, params: RelayParams, body: unknown): Promise<WritebackResult>;
+    /** Read a single item resource (a `.json` path). */
+    read<T>(resource: WritebackResource<P> & string, params?: RelayParams): Promise<T>;
+    /** List the records of a collection resource. */
+    list<T>(resource: WritebackResource<P> & string, params?: RelayParams): Promise<T[]>;
+}
+/**
+ * Build a {@link RelayClient} for `provider`. `opts` (mount root, writeback
+ * timeout, …) is bound once and reused by every method; it defaults to the
+ * ambient `RELAYFILE_MOUNT_ROOT` env, so `relayClient('linear')` is enough
+ * inside a sandbox handler.
+ */
+export declare function relayClient<P extends WritebackProvider>(provider: P, opts?: IntegrationClientOptions): RelayClient<P>;
+/** Re-exported so callers can build item-read paths (`${collection}/${id}.json`). */
+export { encodeSegment, type IntegrationClientOptions, type WritebackResult };
+//# sourceMappingURL=generic.d.ts.map

package/dist/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../src/generic.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EAIb,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACrB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yCAAyC,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,iBAAiB;IACtD,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,yDAAyD;IACzD,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC5E;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7G,oDAAoD;IACpD,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnF,iDAAiD;IACjD,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACtF;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,iBAAiB,EACrD,QAAQ,EAAE,CAAC,EACX,IAAI,GAAE,wBAA6B,GAClC,WAAW,CAAC,CAAC,CAAC,CAmChB;AAED,qFAAqF;AACrF,OAAO,EAAE,aAAa,EAAE,KAAK,wBAAwB,EAAE,KAAK,eAAe,EAAE,CAAC"}

package/dist/generic.js

@@ -0,0 +1,46 @@
+import { draftFile, encodeSegment, listJsonFiles, readJsonFile, writeJsonFile } from '@relayfile/adapter-core/vfs-client';
+import { WRITEBACK_PATH_CATALOG, writebackPath } from '@relayfile/adapter-core/writeback-paths';
+function isItemPath(path) {
+    return path.endsWith('.json');
+}
+/**
+ * Build a {@link RelayClient} for `provider`. `opts` (mount root, writeback
+ * timeout, …) is bound once and reused by every method; it defaults to the
+ * ambient `RELAYFILE_MOUNT_ROOT` env, so `relayClient('linear')` is enough
+ * inside a sandbox handler.
+ */
+export function relayClient(provider, opts = {}) {
+    const knownResources = () => Object.keys(WRITEBACK_PATH_CATALOG[provider] ?? {}).join(', ');
+    return {
+        provider,
+        path(resource, params = {}) {
+            return writebackPath(provider, resource, params);
+        },
+        async write(resource, params, body) {
+            const base = writebackPath(provider, resource, params);
+            const target = isItemPath(base) ? base : `${base}/${draftFile(String(resource))}`;
+            return writeJsonFile(opts, provider, `write.${String(resource)}`, target, body);
+        },
+        async read(resource, params = {}) {
+            // `async` so a validation/path error rejects the promise rather than
+            // throwing synchronously — keeps `read` consistent with `write`/`list`
+            // for callers using `.catch()`.
+            const path = writebackPath(provider, resource, params);
+            if (!isItemPath(path)) {
+                throw new Error(`read("${String(resource)}") resolves to collection "${path}"; read a specific item path or use list(). Known resources for ${provider}: ${knownResources()}`);
+            }
+            return readJsonFile(opts, provider, `read.${String(resource)}`, path);
+        },
+        async list(resource, params = {}) {
+            const path = writebackPath(provider, resource, params);
+            if (isItemPath(path)) {
+                throw new Error(`list("${String(resource)}") resolves to item "${path}"; use read() instead. Known resources for ${provider}: ${knownResources()}`);
+            }
+            const files = await listJsonFiles(opts, provider, `list.${String(resource)}`, path);
+            return files.map((file) => file.value);
+        }
+    };
+}
+/** Re-exported so callers can build item-read paths (`${collection}/${id}.json`). */
+export { encodeSegment };
+//# sourceMappingURL=generic.js.map

package/dist/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../src/generic.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EAGd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,sBAAsB,EACtB,aAAa,EAGd,MAAM,yCAAyC,CAAC;AA6BjD,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,QAAW,EACX,OAAiC,EAAE;IAEnC,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpG,OAAO;QACL,QAAQ;QACR,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE;YACxB,OAAO,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI;YAChC,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAClF,OAAO,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAClF,CAAC;QACD,KAAK,CAAC,IAAI,CAAI,QAAuC,EAAE,SAAsB,EAAE;YAC7E,qEAAqE;YACrE,uEAAuE;YACvE,gCAAgC;YAChC,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACvD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,SAAS,MAAM,CAAC,QAAQ,CAAC,8BAA8B,IAAI,mEAAmE,QAAQ,KAAK,cAAc,EAAE,EAAE,CAC9J,CAAC;YACJ,CAAC;YACD,OAAO,YAAY,CAAI,IAAI,EAAE,QAAQ,EAAE,QAAQ,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3E,CAAC;QACD,KAAK,CAAC,IAAI,CAAI,QAAuC,EAAE,SAAsB,EAAE;YAC7E,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACvD,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CACb,SAAS,MAAM,CAAC,QAAQ,CAAC,wBAAwB,IAAI,8CAA8C,QAAQ,KAAK,cAAc,EAAE,EAAE,CACnI,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAI,IAAI,EAAE,QAAQ,EAAE,QAAQ,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACvF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,OAAO,EAAE,aAAa,EAAuD,CAAC"}

package/dist/github.d.ts

@@ -0,0 +1,57 @@
+import type { IntegrationClientOptions } from '@relayfile/adapter-core/vfs-client';
+import { type ProviderClient } from './provider-client.js';
+export interface GithubTarget {
+    owner: string;
+    repo: string;
+    number: number;
+}
+export interface GithubClient extends ProviderClient<'github'> {
+    /** Comment on an issue or pull request. */
+    comment(target: GithubTarget, body: string): Promise<{
+        id: string;
+        url: string;
+    }>;
+    /** Create an issue. */
+    createIssue(args: {
+        owner: string;
+        repo: string;
+        title: string;
+        body: string;
+        labels?: string[];
+    }): Promise<{
+        id: string;
+        url: string;
+    }>;
+    /**
+     * Merge a pull request. (Named `mergePullRequest`, not `merge`, because
+     * `merge` is the catalog resource key exposed as `.merge`.)
+     */
+    mergePullRequest(args: {
+        owner: string;
+        repo: string;
+        number: number;
+        method?: 'merge' | 'squash' | 'rebase';
+        commitTitle?: string;
+        commitMessage?: string;
+        sha?: string;
+    }): Promise<{
+        merged: boolean;
+        sha?: string;
+    }>;
+    /** Post a review on a pull request. */
+    review(target: GithubTarget, args: {
+        body: string;
+        event: 'COMMENT' | 'APPROVE' | 'REQUEST_CHANGES';
+        comments?: Array<{
+            path: string;
+            line: number;
+            body: string;
+        }>;
+    }): Promise<void>;
+}
+/**
+ * Ergonomic GitHub client over the writeback-path catalog, plus the uniform
+ * resource-keyed access (`.issues`, `.["issue-comments"]`, `.merge`, `.reviews`).
+ */
+export declare function githubClient(opts?: IntegrationClientOptions): GithubClient;
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAC5D,2CAA2C;IAC3C,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF,uBAAuB;IACvB,WAAW,CAAC,IAAI,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzC;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACvC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,uCAAuC;IACvC,MAAM,CACJ,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,CAAC;QACjD,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChE,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,wBAA6B,GAAG,YAAY,CA+D9E"}

package/dist/github.js

@@ -0,0 +1,39 @@
+import { providerClient } from './provider-client.js';
+import { created } from './receipt.js';
+/**
+ * Ergonomic GitHub client over the writeback-path catalog, plus the uniform
+ * resource-keyed access (`.issues`, `.["issue-comments"]`, `.merge`, `.reviews`).
+ */
+export function githubClient(opts = {}) {
+    const base = providerClient('github', opts);
+    return Object.assign(base, {
+        async comment(target, body) {
+            return created(await base['issue-comments'].write({ owner: target.owner, repo: target.repo, issueNumber: target.number }, { body }));
+        },
+        async createIssue(args) {
+            return created(await base.issues.write({ owner: args.owner, repo: args.repo }, { title: args.title, body: args.body, ...(args.labels ? { labels: args.labels } : {}) }));
+        },
+        async mergePullRequest(args) {
+            const result = await base.merge.write({ owner: args.owner, repo: args.repo, pullNumber: args.number }, {
+                ...(args.method !== undefined ? { merge_method: args.method } : {}),
+                ...(args.commitTitle !== undefined ? { commit_title: args.commitTitle } : {}),
+                ...(args.commitMessage !== undefined ? { commit_message: args.commitMessage } : {}),
+                ...(args.sha !== undefined ? { sha: args.sha } : {})
+            });
+            const sha = typeof result.receipt?.sha === 'string'
+                ? result.receipt.sha
+                : typeof result.receipt?.id === 'string'
+                    ? result.receipt.id
+                    : undefined;
+            const merged = result.receipt?.merged;
+            return {
+                merged: merged === true || merged === 'true' || (merged === undefined && Boolean(sha)),
+                ...(sha ? { sha } : {})
+            };
+        },
+        async review(target, args) {
+            await base.reviews.write({ owner: target.owner, repo: target.repo, pullNumber: target.number }, { ...args, comments: args.comments ?? [] });
+        }
+    });
+}
+//# sourceMappingURL=github.js.map

package/dist/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `@relayfile/relay-helpers` — ergonomic, catalog-backed provider clients
+ * for Workforce agent handlers.
+ *
+ * The runtime exposes only generic VFS helpers (`writeJsonFile`, `readJsonFile`,
+ * …); the per-provider typed clients (`ctx.linear.comment(...)`) were removed.
+ * This package recovers that ergonomics as an opt-in factory, with every path
+ * sourced from `@relayfile/adapter-core/writeback-paths` (the adapter-owned
+ * source of truth) instead of hardcoded — so paths never drift from the
+ * adapter that materializes the draft.
+ *
+ *   import { linearClient } from '@relayfile/relay-helpers';
+ *   const linear = linearClient();              // binds the mount root once
+ *   const issue = await linear.getIssue(issueId);
+ *   await linear.comment(issueId, ':rocket: done');
+ *
+ * Every provider in the catalog has a named client (`asanaClient`,
+ * `notionClient`, … through all 29), exposing its resources as
+ * `.{resource}.{path,write,read,list}`. `linear` / `github` / `slack` add
+ * named ergonomic methods on top. `relayClient(provider)` is the dynamic,
+ * string-keyed escape hatch when the provider isn't known at author time.
+ */
+export { relayClient, encodeSegment, type RelayClient, type RelayParams } from './generic.js';
+export { providerClient, type ProviderClient, type ResourceClient } from './provider-client.js';
+export { created } from './receipt.js';
+export { linearClient, type LinearClient, type LinearCreateIssueArgs } from './linear.js';
+export { githubClient, type GithubClient, type GithubTarget } from './github.js';
+export { slackClient, type SlackClient } from './slack.js';
+export * from './generated/clients.js';
+export type { IntegrationClientOptions, WritebackResult } from '@relayfile/adapter-core/vfs-client';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAK3D,cAAc,wBAAwB,CAAC;AAEvC,YAAY,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * `@relayfile/relay-helpers` — ergonomic, catalog-backed provider clients
+ * for Workforce agent handlers.
+ *
+ * The runtime exposes only generic VFS helpers (`writeJsonFile`, `readJsonFile`,
+ * …); the per-provider typed clients (`ctx.linear.comment(...)`) were removed.
+ * This package recovers that ergonomics as an opt-in factory, with every path
+ * sourced from `@relayfile/adapter-core/writeback-paths` (the adapter-owned
+ * source of truth) instead of hardcoded — so paths never drift from the
+ * adapter that materializes the draft.
+ *
+ *   import { linearClient } from '@relayfile/relay-helpers';
+ *   const linear = linearClient();              // binds the mount root once
+ *   const issue = await linear.getIssue(issueId);
+ *   await linear.comment(issueId, ':rocket: done');
+ *
+ * Every provider in the catalog has a named client (`asanaClient`,
+ * `notionClient`, … through all 29), exposing its resources as
+ * `.{resource}.{path,write,read,list}`. `linear` / `github` / `slack` add
+ * named ergonomic methods on top. `relayClient(provider)` is the dynamic,
+ * string-keyed escape hatch when the provider isn't known at author time.
+ */
+export { relayClient, encodeSegment } from './generic.js';
+export { providerClient } from './provider-client.js';
+export { created } from './receipt.js';
+// Ergonomic clients (resource-keyed access + named methods).
+export { linearClient } from './linear.js';
+export { githubClient } from './github.js';
+export { slackClient } from './slack.js';
+// Named resource-keyed clients for the remaining catalog providers
+// (generated from the catalog — see scripts/generate-clients.mjs).
+// `export *` so a newly-added provider needs only a re-`gen`, no edit here.
+export * from './generated/clients.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAsC,MAAM,cAAc,CAAC;AAC9F,OAAO,EAAE,cAAc,EAA4C,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,6DAA6D;AAC7D,OAAO,EAAE,YAAY,EAAiD,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAwC,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,WAAW,EAAoB,MAAM,YAAY,CAAC;AAE3D,mEAAmE;AACnE,mEAAmE;AACnE,4EAA4E;AAC5E,cAAc,wBAAwB,CAAC"}

package/dist/linear.d.ts

@@ -0,0 +1,41 @@
+import { type IntegrationClientOptions } from '@relayfile/adapter-core/vfs-client';
+import { type ProviderClient } from './provider-client.js';
+export interface LinearCreateIssueArgs {
+    teamId: string;
+    title: string;
+    description?: string;
+    assigneeId?: string;
+    labelIds?: string[];
+    projectId?: string;
+    stateId?: string;
+}
+export interface LinearClient extends ProviderClient<'linear'> {
+    /** Comment on an issue. */
+    comment(issueId: string, body: string): Promise<{
+        id: string;
+        url: string;
+    }>;
+    /** Create an issue. */
+    createIssue(args: LinearCreateIssueArgs): Promise<{
+        id: string;
+        url: string;
+    }>;
+    /** Patch an existing issue. */
+    updateIssue(issueId: string, args: {
+        title?: string;
+        description?: string;
+        assigneeId?: string;
+        stateId?: string;
+    }): Promise<void>;
+    /** Read one issue by id. */
+    getIssue<T = Record<string, unknown>>(issueId: string): Promise<T>;
+    /** List issues. */
+    listIssues<T = Record<string, unknown>>(): Promise<T[]>;
+}
+/**
+ * Ergonomic Linear client over the writeback-path catalog. Recovers the
+ * `ctx.linear.comment(...)` shape removed from the runtime, plus the uniform
+ * resource-keyed access (`.issues`, `.comments`) every provider client has.
+ */
+export declare function linearClient(opts?: IntegrationClientOptions): LinearClient;
+//# sourceMappingURL=linear.d.ts.map

package/dist/linear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../src/linear.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAa,SAAQ,cAAc,CAAC,QAAQ,CAAC;IAC5D,2BAA2B;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,uBAAuB;IACvB,WAAW,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,+BAA+B;IAC/B,WAAW,CACT,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACpF,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,mBAAmB;IACnB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,wBAA6B,GAAG,YAAY,CAoB9E"}

package/dist/linear.js

@@ -0,0 +1,31 @@
+import { readJsonFile, writeJsonFile } from '@relayfile/adapter-core/vfs-client';
+import { encodeSegment } from './generic.js';
+import { providerClient } from './provider-client.js';
+import { created } from './receipt.js';
+/**
+ * Ergonomic Linear client over the writeback-path catalog. Recovers the
+ * `ctx.linear.comment(...)` shape removed from the runtime, plus the uniform
+ * resource-keyed access (`.issues`, `.comments`) every provider client has.
+ */
+export function linearClient(opts = {}) {
+    const base = providerClient('linear', opts);
+    const issuePath = (issueId) => `${base.issues.path()}/${encodeSegment(issueId)}.json`;
+    return Object.assign(base, {
+        async comment(issueId, body) {
+            return created(await base.comments.write({ issueId }, { body }));
+        },
+        async createIssue(args) {
+            return created(await base.issues.write({}, args));
+        },
+        async updateIssue(issueId, args) {
+            await writeJsonFile(opts, 'linear', 'updateIssue', issuePath(issueId), args);
+        },
+        getIssue(issueId) {
+            return readJsonFile(opts, 'linear', 'getIssue', issuePath(issueId));
+        },
+        listIssues() {
+            return base.issues.list();
+        }
+    });
+}
+//# sourceMappingURL=linear.js.map

package/dist/linear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.js","sourceRoot":"","sources":["../src/linear.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EAEd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAuB,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA4BvC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAiC,EAAE;IAC9D,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC;IAC9F,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QACzB,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,IAAY;YACzC,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,IAA2B;YAC3C,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,IAA6B;YAC9D,MAAM,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/E,CAAC;QACD,QAAQ,CAA8B,OAAe;YACnD,OAAO,YAAY,CAAI,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACzE,CAAC;QACD,UAAU;YACR,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAK,CAAC;QAC/B,CAAC;KACF,CAAiB,CAAC;AACrB,CAAC"}

package/dist/provider-client.d.ts

@@ -0,0 +1,36 @@
+import type { IntegrationClientOptions, WritebackResult } from '@relayfile/adapter-core/vfs-client';
+import { type WritebackProvider, type WritebackResource } from '@relayfile/adapter-core/writeback-paths';
+import { type RelayParams } from './generic.js';
+/**
+ * One resource of a provider, bound to a client. Every path is resolved from
+ * the writeback-path catalog.
+ */
+export interface ResourceClient {
+    /** Resolve this resource's canonical mount path (no IO). */
+    path(params?: RelayParams): string;
+    /**
+     * Write `body`: a uniquely-named draft for a collection resource, or a direct
+     * write for an item (`.json`) resource. The writeback worker materializes the
+     * draft into the real provider call.
+     */
+    write(params: RelayParams, body: unknown): Promise<WritebackResult>;
+    /** Read a single item resource (a `.json` path). */
+    read<T = unknown>(params?: RelayParams): Promise<T>;
+    /** List the records of a collection resource. */
+    list<T = unknown>(params?: RelayParams): Promise<T[]>;
+}
+/** A provider client: one {@link ResourceClient} per catalog resource. */
+export type ProviderClient<P extends WritebackProvider> = {
+    readonly [R in WritebackResource<P> & string]: ResourceClient;
+};
+/**
+ * Build a resource-keyed client for any provider in the catalog. The mount
+ * root / writeback options are bound once and shared by every resource.
+ *
+ * @example
+ *   const notion = providerClient('notion');
+ *   await notion.pages.write({ databaseId }, { ... });
+ *   await notion.comments.path({ databaseId, pageId });
+ */
+export declare function providerClient<P extends WritebackProvider>(provider: P, opts?: IntegrationClientOptions): ProviderClient<P>;
+//# sourceMappingURL=provider-client.d.ts.map

package/dist/provider-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-client.d.ts","sourceRoot":"","sources":["../src/provider-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACpG,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IACnC;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACpE,oDAAoD;IACpD,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpD,iDAAiD;IACjD,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACvD;AAED,0EAA0E;AAC1E,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,iBAAiB,IAAI;IACxD,QAAQ,EAAE,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,cAAc;CAC9D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,iBAAiB,EACxD,QAAQ,EAAE,CAAC,EACX,IAAI,GAAE,wBAA6B,GAClC,cAAc,CAAC,CAAC,CAAC,CAqBnB"}

package/dist/provider-client.js

@@ -0,0 +1,32 @@
+import { WRITEBACK_PATH_CATALOG } from '@relayfile/adapter-core/writeback-paths';
+import { relayClient } from './generic.js';
+/**
+ * Build a resource-keyed client for any provider in the catalog. The mount
+ * root / writeback options are bound once and shared by every resource.
+ *
+ * @example
+ *   const notion = providerClient('notion');
+ *   await notion.pages.write({ databaseId }, { ... });
+ *   await notion.comments.path({ databaseId, pageId });
+ */
+export function providerClient(provider, opts = {}) {
+    const relay = relayClient(provider, opts);
+    const out = {};
+    // Typed callers can't reach this, but a runtime/JS caller passing an unknown
+    // provider would otherwise hit a cryptic `Object.keys(undefined)` TypeError.
+    const resources = WRITEBACK_PATH_CATALOG[provider];
+    if (!resources) {
+        throw new Error(`Unknown writeback provider "${provider}". Known providers: ${Object.keys(WRITEBACK_PATH_CATALOG).join(", ")}`);
+    }
+    for (const resource of Object.keys(resources)) {
+        const r = resource;
+        out[resource] = {
+            path: (params) => relay.path(r, params),
+            write: (params, body) => relay.write(r, params, body),
+            read: (params) => relay.read(r, params),
+            list: (params) => relay.list(r, params)
+        };
+    }
+    return out;
+}
+//# sourceMappingURL=provider-client.js.map

package/dist/provider-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-client.js","sourceRoot":"","sources":["../src/provider-client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EAGvB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAC;AA0B7D;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAW,EACX,OAAiC,EAAE;IAEnC,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAmC,EAAE,CAAC;IAC/C,6EAA6E;IAC7E,6EAA6E;IAC7E,MAAM,SAAS,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,uBAAuB,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/G,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,QAAyC,CAAC;QACpD,GAAG,CAAC,QAAQ,CAAC,GAAG;YACd,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC;YACvC,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC;YACrD,IAAI,EAAE,CAAI,MAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAI,CAAC,EAAE,MAAM,CAAC;YAC3D,IAAI,EAAE,CAAI,MAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAI,CAAC,EAAE,MAAM,CAAC;SAC5D,CAAC;IACJ,CAAC;IACD,OAAO,GAAwB,CAAC;AAClC,CAAC"}

package/dist/receipt.d.ts

@@ -0,0 +1,11 @@
+import type { WritebackResult } from '@relayfile/adapter-core/vfs-client';
+/**
+ * Normalize the writeback receipt into the `{ id, url }` shape the old typed
+ * clients returned. Falls back to the draft path when the worker hasn't
+ * written a receipt yet (fire-and-forget / timeout).
+ */
+export declare function created(result: WritebackResult): {
+    id: string;
+    url: string;
+};
+//# sourceMappingURL=receipt.d.ts.map

package/dist/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../src/receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAK5E"}

package/dist/receipt.js

@@ -0,0 +1,12 @@
+/**
+ * Normalize the writeback receipt into the `{ id, url }` shape the old typed
+ * clients returned. Falls back to the draft path when the worker hasn't
+ * written a receipt yet (fire-and-forget / timeout).
+ */
+export function created(result) {
+    return {
+        id: result.receipt?.created ?? result.receipt?.id ?? result.path,
+        url: result.receipt?.url ?? result.path
+    };
+}
+//# sourceMappingURL=receipt.js.map

package/dist/receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.js","sourceRoot":"","sources":["../src/receipt.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,MAAuB;IAC7C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,MAAM,CAAC,IAAI;QAChE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,MAAM,CAAC,IAAI;KACxC,CAAC;AACJ,CAAC"}

package/dist/relay-helpers.test.d.ts

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

package/dist/relay-helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-helpers.test.d.ts","sourceRoot":"","sources":["../src/relay-helpers.test.ts"],"names":[],"mappings":""}

package/dist/relay-helpers.test.js

@@ -0,0 +1,109 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { WRITEBACK_PATH_CATALOG } from '@relayfile/adapter-core/writeback-paths';
+import * as helpers from './index.js';
+import { githubClient, linearClient, notionClient, providerClient, relayClient, slackClient } from './index.js';
+const clientExportName = (provider) => `${provider.replace(/-([a-z])/g, (_m, c) => c.toUpperCase())}Client`;
+/** Fire-and-forget client bound to a throwaway mount; no writeback worker runs. */
+async function mount() {
+    const root = await mkdtemp(path.join(tmpdir(), 'relay-helpers-'));
+    return { root, opts: { relayfileMountRoot: root, writebackTimeoutMs: 0 } };
+}
+async function onlyJsonIn(dir) {
+    const entries = (await readdir(dir)).filter((entry) => entry.endsWith('.json'));
+    assert.equal(entries.length, 1, `expected one draft in ${dir}, saw ${entries.join(', ') || 'none'}`);
+    return { name: entries[0], body: JSON.parse(await readFile(path.join(dir, entries[0]), 'utf8')) };
+}
+test('relayClient.path resolves catalog paths and write drops a collection draft', async () => {
+    const { root, opts } = await mount();
+    const linear = relayClient('linear', opts);
+    assert.equal(linear.path('comments', { issueId: 'ISS-1' }), '/linear/issues/ISS-1/comments');
+    await linear.write('comments', { issueId: 'ISS-1' }, { body: 'hi' });
+    const draft = await onlyJsonIn(path.join(root, 'linear/issues/ISS-1/comments'));
+    assert.deepEqual(draft.body, { body: 'hi' });
+});
+test('relayClient.write writes item (.json) resources to the exact path', async () => {
+    const { root, opts } = await mount();
+    const gh = relayClient('github', opts);
+    // `merge` resolves to `…/merge.json` — an item path, written directly (no draft).
+    await gh.write('merge', { owner: 'o', repo: 'r', pullNumber: 7 }, { merge_method: 'squash' });
+    const body = JSON.parse(await readFile(path.join(root, 'github/repos/o/r/pulls/7/merge.json'), 'utf8'));
+    assert.deepEqual(body, { merge_method: 'squash' });
+});
+test('relayClient.read / list operate over the catalog paths', async () => {
+    const { root, opts } = await mount();
+    await mkdir(path.join(root, 'linear/issues'), { recursive: true });
+    await writeFile(path.join(root, 'linear/issues/ISS-9.json'), JSON.stringify({ id: 'ISS-9', title: 't' }));
+    const linear = relayClient('linear', opts);
+    const listed = await linear.list('issues');
+    assert.deepEqual(listed.map((i) => i.id), ['ISS-9']);
+});
+test('linearClient recovers comment / createIssue / getIssue ergonomics', async () => {
+    const { root, opts } = await mount();
+    await mkdir(path.join(root, 'linear/issues'), { recursive: true });
+    await writeFile(path.join(root, 'linear/issues/ISS-1.json'), JSON.stringify({ id: 'ISS-1', title: 'Fix' }));
+    const linear = linearClient(opts);
+    const issue = await linear.getIssue('ISS-1');
+    assert.equal(issue.title, 'Fix');
+    await linear.comment('ISS-1', ':rocket: done');
+    const comment = await onlyJsonIn(path.join(root, 'linear/issues/ISS-1/comments'));
+    assert.deepEqual(comment.body, { body: ':rocket: done' });
+    // Fresh mount so the create draft is the only file in /linear/issues.
+    const fresh = await mount();
+    await linearClient(fresh.opts).createIssue({ teamId: 'T', title: 'New' });
+    const created = await onlyJsonIn(path.join(fresh.root, 'linear/issues'));
+    assert.deepEqual(created.body, { teamId: 'T', title: 'New' });
+});
+test('githubClient.comment and slackClient.post target the canonical paths', async () => {
+    const { root, opts } = await mount();
+    await githubClient(opts).comment({ owner: 'AgentWorkforce', repo: 'cloud', number: 1643 }, 'hello');
+    const ghComment = await onlyJsonIn(path.join(root, 'github/repos/AgentWorkforce/cloud/issues/1643/comments'));
+    assert.deepEqual(ghComment.body, { body: 'hello' });
+    await slackClient(opts).post('C123', 'shipped');
+    const msg = await onlyJsonIn(path.join(root, 'slack/channels/C123/messages'));
+    assert.deepEqual(msg.body, { text: 'shipped' });
+});
+test('every catalog provider has a named client export', () => {
+    const providers = Object.keys(WRITEBACK_PATH_CATALOG);
+    assert.ok(providers.length >= 29, `expected >=29 providers, saw ${providers.length}`);
+    const missing = providers.filter((provider) => typeof helpers[clientExportName(provider)] !== 'function');
+    assert.deepEqual(missing, [], `providers without a named client export: ${missing.join(', ')}`);
+});
+test('src/generated/clients.ts is in sync with the catalog', async () => {
+    // dist/<this>.test.js → package root is one level up.
+    const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+    const { renderClients } = await import(pathToFileURL(path.join(pkgRoot, 'scripts/generate-clients.mjs')).href);
+    const committed = await readFile(path.join(pkgRoot, 'src/generated/clients.ts'), 'utf8');
+    assert.equal(committed, renderClients(), 'generated clients are stale — run `npm run gen -w @relayfile/relay-helpers`');
+});
+test('a named resource-keyed client resolves and writes catalog paths', async () => {
+    const { root, opts } = await mount();
+    const notion = notionClient(opts);
+    assert.equal(notion.pages.path({ databaseId: 'db1' }), '/notion/databases/db1/pages');
+    await notion.pages.write({ databaseId: 'db1' }, { title: 'P' });
+    const draft = await onlyJsonIn(path.join(root, 'notion/databases/db1/pages'));
+    assert.deepEqual(draft.body, { title: 'P' });
+});
+test('read() rejects (not throws synchronously) on a collection resource', async () => {
+    const { opts } = await mount();
+    // `comments` is a collection path, so read is invalid — but calling it must
+    // not throw synchronously; the returned promise rejects so `.catch()` works.
+    const promise = relayClient('linear', opts).read('comments', { issueId: 'ISS-1' });
+    await assert.rejects(promise, /resolves to collection/);
+});
+test('providerClient throws a clear error for an unknown provider', () => {
+    assert.throws(() => providerClient('not-a-provider'), /Unknown writeback provider "not-a-provider"/);
+});
+test('relayClient (dynamic) still resolves paths for every provider', () => {
+    for (const provider of Object.keys(WRITEBACK_PATH_CATALOG)) {
+        const client = relayClient(provider);
+        const [resource, variants] = Object.entries(WRITEBACK_PATH_CATALOG[provider])[0];
+        const params = Object.fromEntries(variants[0].params.map((name) => [name, 'x']));
+        assert.ok(client.path(resource, params).startsWith(`/${provider}`));
+    }
+});
+//# sourceMappingURL=relay-helpers.test.js.map

package/dist/relay-helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-helpers.test.js","sourceRoot":"","sources":["../src/relay-helpers.test.ts"],"names":[],"mappings":"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"}

package/dist/slack.d.ts

@@ -0,0 +1,27 @@
+import type { IntegrationClientOptions } from '@relayfile/adapter-core/vfs-client';
+import { type ProviderClient } from './provider-client.js';
+export interface SlackClient extends ProviderClient<'slack'> {
+    /** Post a message to a channel. */
+    post(channel: string, text: string): Promise<{
+        channel: string;
+        ts: string;
+    }>;
+    /** Direct-message a user. */
+    dm(user: string, text: string): Promise<{
+        user: string;
+        ts: string;
+    }>;
+    /** Reply in a thread. */
+    reply(channel: string, threadTs: string, text: string): Promise<{
+        channel: string;
+        ts: string;
+    }>;
+    /** React to a message. */
+    react(channel: string, messageTs: string, emoji: string): Promise<void>;
+}
+/**
+ * Ergonomic Slack client over the writeback-path catalog, plus the uniform
+ * resource-keyed access (`.messages`, `.["direct-messages"]`, `.replies`, `.reactions`).
+ */
+export declare function slackClient(opts?: IntegrationClientOptions): SlackClient;
+//# sourceMappingURL=slack.d.ts.map

package/dist/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../src/slack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3E,MAAM,WAAW,WAAY,SAAQ,cAAc,CAAC,OAAO,CAAC;IAC1D,mCAAmC;IACnC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,6BAA6B;IAC7B,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,yBAAyB;IACzB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjG,0BAA0B;IAC1B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,wBAA6B,GAAG,WAAW,CAmB5E"}

package/dist/slack.js

@@ -0,0 +1,30 @@
+import { providerClient } from './provider-client.js';
+/** Slack message timestamps contain `.`; the mount path encodes it as `_`. */
+function tsParam(ts) {
+    return ts.replace(/\./g, '_');
+}
+/**
+ * Ergonomic Slack client over the writeback-path catalog, plus the uniform
+ * resource-keyed access (`.messages`, `.["direct-messages"]`, `.replies`, `.reactions`).
+ */
+export function slackClient(opts = {}) {
+    const base = providerClient('slack', opts);
+    return Object.assign(base, {
+        async post(channel, text) {
+            const result = await base.messages.write({ channelId: channel }, { text });
+            return { channel, ts: result.receipt?.created ?? result.receipt?.id ?? '' };
+        },
+        async dm(user, text) {
+            const result = await base['direct-messages'].write({ userId: user }, { text });
+            return { user, ts: result.receipt?.created ?? result.receipt?.id ?? '' };
+        },
+        async reply(channel, threadTs, text) {
+            const result = await base.replies.write({ channelId: channel, messageTs: tsParam(threadTs) }, { text });
+            return { channel, ts: result.receipt?.created ?? result.receipt?.id ?? '' };
+        },
+        async react(channel, messageTs, emoji) {
+            await base.reactions.write({ channelId: channel, messageTs: tsParam(messageTs) }, { emoji });
+        }
+    });
+}
+//# sourceMappingURL=slack.js.map

package/dist/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../src/slack.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAuB,MAAM,sBAAsB,CAAC;AAE3E,8EAA8E;AAC9E,SAAS,OAAO,CAAC,EAAU;IACzB,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC;AAaD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAiC,EAAE;IAC7D,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QACzB,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,IAAY;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3E,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAC9E,CAAC;QACD,KAAK,CAAC,EAAE,CAAC,IAAY,EAAE,IAAY;YACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/E,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3E,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,QAAgB,EAAE,IAAY;YACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACxG,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAC9E,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,SAAiB,EAAE,KAAa;YAC3D,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/F,CAAC;KACF,CAAgB,CAAC;AACpB,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@relayfile/relay-helpers",
+  "version": "0.1.0",
+  "description": "Ergonomic, catalog-backed provider clients for Relayfile integration handlers",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "gen": "node scripts/generate-clients.mjs",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "tsc -p tsconfig.json && node --test \"dist/**/*.test.js\"",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@relayfile/adapter-core": "^0.3.27"
+  }
+}