@relayfile/relay-helpers 0.4.3 → 0.4.5

package/dist/transport.d.ts

@@ -0,0 +1,86 @@
+import type { IntegrationClientOptions, WritebackResult } from '@relayfile/adapter-core/vfs-client';
+import type { PreviewAccess, PreviewAction, PreviewParameters } from './types.js';
+export type { EffectPolicyV1, PreviewAccess, PreviewAction, PreviewParameters, PreviewSimulatedReceipt, } from './types.js';
+export type RelayTransportParameters = PreviewParameters;
+export interface RelayTransportRequest {
+    provider: string;
+    resource: string;
+    parameters: RelayTransportParameters;
+    path: string;
+}
+export interface RelayTransportWriteRequest extends RelayTransportRequest {
+    body: unknown;
+}
+/**
+ * The provider-helper IO boundary. Implementations may use a Relayfile mount,
+ * a remote Relayfile API, or a side-effect-free recorder. This type has no
+ * Workforce dependency and is safe for runtimes to import directly.
+ */
+export interface RelayTransport {
+    read<T = unknown>(request: RelayTransportRequest): Promise<T>;
+    list<T = unknown>(request: RelayTransportRequest): Promise<T[]>;
+    write(request: RelayTransportWriteRequest): Promise<WritebackResult>;
+}
+/** Options accepted by every relay-helper client factory. */
+export interface RelayClientOptions extends IntegrationClientOptions {
+    /**
+     * Explicit helper transport. It takes precedence over mount and HTTP options
+     * and over every ambient Relayfile/provider credential.
+     */
+    transport?: RelayTransport;
+}
+export interface PreviewTransportOptions {
+    /** Data keyed by canonical Relayfile path for preview reads and lists. */
+    fixtures?: Readonly<Record<string, unknown>> | ReadonlyMap<string, unknown>;
+    /** Override deterministic fake identifiers when a consumer needs a fixture convention. */
+    idFactory?: (request: RelayTransportWriteRequest, sequence: number) => string;
+    /** Override deterministic timestamps. Sequence numbers start at one. */
+    timestampFactory?: (sequence: number) => string;
+}
+/**
+ * Side-effect-free provider transport used by local preview and test runs.
+ * It never inspects environment variables and never delegates to fetch or the
+ * filesystem. Writes are recorded and receive deterministic simulated IDs so
+ * later writes can safely refer to earlier ones.
+ */
+export declare class PreviewTransport implements RelayTransport {
+    readonly actions: PreviewAction[];
+    readonly accesses: PreviewAccess[];
+    private sequence;
+    private readonly data;
+    private readonly writtenPaths;
+    private readonly receiptsByReference;
+    private readonly idFactory;
+    private readonly timestampFactory;
+    constructor(options?: PreviewTransportOptions);
+    seed(path: string, value: unknown): this;
+    read<T = unknown>(request: RelayTransportRequest): Promise<T>;
+    list<T = unknown>(request: RelayTransportRequest): Promise<T[]>;
+    write(request: RelayTransportWriteRequest): Promise<WritebackResult>;
+    clear(): void;
+    private resolveParentReference;
+}
+/** Return the process-scoped transport used by legacy no-argument clients. */
+export declare function getProcessRelayTransport(): RelayTransport | undefined;
+/** Set or clear the process-scoped transport used by legacy no-argument clients. */
+export declare function setProcessRelayTransport(transport: RelayTransport | undefined): void;
+/** Compatibility name used by the preview runtime integration. */
+export declare function setPreviewTransport(transport: RelayTransport): void;
+/** Clear the process-scoped preview transport. */
+export declare function clearPreviewTransport(): void;
+/**
+ * Bind a process transport and return a restoration callback. Nested bindings
+ * restore correctly; the callback will not overwrite a newer binding.
+ */
+export declare function bindRelayTransport(transport: RelayTransport): () => void;
+/** Convenience name for the common process-scoped preview binding. */
+export declare const bindPreviewTransport: typeof bindRelayTransport;
+/** Explicit constructor injection always wins over the process binding. */
+export declare function resolveRelayTransport(options: RelayClientOptions): RelayTransport | undefined;
+/**
+ * Capture explicit constructor injection while resolving the process binding
+ * lazily for every operation. The lazy half is essential for handlers that
+ * construct a no-argument client at module load before a Run binds preview.
+ */
+export declare function createRelayTransportResolver(options: RelayClientOptions): () => RelayTransport | undefined;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

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

package/dist/transport.js

@@ -0,0 +1,192 @@
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stablePart(value) {
+    const normalized = value.toLowerCase().replace(/[^a-z0-9]+/gu, '-').replace(/^-|-$/gu, '');
+    return normalized || 'action';
+}
+function defaultId(request, sequence) {
+    return `preview-${stablePart(request.provider)}-${stablePart(request.resource)}-${String(sequence).padStart(4, '0')}`;
+}
+function defaultTimestamp(sequence) {
+    return new Date(Date.UTC(2000, 0, 1) + sequence - 1).toISOString();
+}
+function collectionRecordPath(path, id) {
+    return path.endsWith('.json') ? path : `${path.replace(/\/+$/u, '')}/${encodeURIComponent(id)}.json`;
+}
+/**
+ * Side-effect-free provider transport used by local preview and test runs.
+ * It never inspects environment variables and never delegates to fetch or the
+ * filesystem. Writes are recorded and receive deterministic simulated IDs so
+ * later writes can safely refer to earlier ones.
+ */
+export class PreviewTransport {
+    actions = [];
+    accesses = [];
+    sequence = 0;
+    data = new Map();
+    writtenPaths = new Set();
+    receiptsByReference = new Map();
+    idFactory;
+    timestampFactory;
+    constructor(options = {}) {
+        const fixtures = options.fixtures;
+        if (fixtures instanceof Map) {
+            for (const [fixturePath, value] of fixtures)
+                this.data.set(fixturePath, value);
+        }
+        else if (fixtures) {
+            for (const [fixturePath, value] of Object.entries(fixtures))
+                this.data.set(fixturePath, value);
+        }
+        this.idFactory = options.idFactory ?? defaultId;
+        this.timestampFactory = options.timestampFactory ?? defaultTimestamp;
+    }
+    seed(path, value) {
+        this.data.set(path, value);
+        return this;
+    }
+    async read(request) {
+        const parameters = { ...request.parameters };
+        const action = {
+            ...request,
+            kind: 'provider.read',
+            status: 'previewed',
+            data: { operation: 'read', parameters, path: request.path },
+            parameters,
+            method: 'read',
+        };
+        this.accesses.push(action);
+        this.actions.push(action);
+        return this.data.get(request.path);
+    }
+    async list(request) {
+        const parameters = { ...request.parameters };
+        const action = {
+            ...request,
+            kind: 'provider.read',
+            status: 'previewed',
+            data: { operation: 'list', parameters, path: request.path },
+            parameters,
+            method: 'list',
+        };
+        this.accesses.push(action);
+        this.actions.push(action);
+        const fixture = this.data.get(request.path);
+        if (Array.isArray(fixture))
+            return [...fixture];
+        const prefix = `${request.path.replace(/\/+$/u, '')}/`;
+        const records = [];
+        for (const [recordPath, value] of this.data) {
+            if (!recordPath.startsWith(prefix))
+                continue;
+            const remainder = recordPath.slice(prefix.length);
+            if (remainder && !remainder.includes('/') && remainder.endsWith('.json'))
+                records.push(value);
+        }
+        return records;
+    }
+    async write(request) {
+        this.sequence += 1;
+        const simulatedReceipt = {
+            id: this.idFactory(request, this.sequence),
+            timestamp: this.timestampFactory(this.sequence),
+        };
+        const path = collectionRecordPath(request.path, simulatedReceipt.id);
+        const body = this.resolveParentReference(request.body);
+        const parameters = { ...request.parameters };
+        const action = {
+            ...request,
+            id: simulatedReceipt.id,
+            kind: 'provider.write',
+            status: 'previewed',
+            data: { operation: 'write', parameters, path, body, simulatedReceipt },
+            method: 'write',
+            parameters,
+            path,
+            body,
+            simulatedReceipt,
+        };
+        this.actions.push(action);
+        this.data.set(path, body);
+        this.writtenPaths.add(path);
+        this.receiptsByReference.set(path, simulatedReceipt);
+        this.receiptsByReference.set(simulatedReceipt.id, simulatedReceipt);
+        return {
+            path,
+            absolutePath: path,
+            receipt: {
+                id: simulatedReceipt.id,
+                created: simulatedReceipt.id,
+                externalId: simulatedReceipt.id,
+                ts: simulatedReceipt.id,
+                timestamp: simulatedReceipt.timestamp,
+                path,
+                ok: true,
+            },
+        };
+    }
+    clear() {
+        for (const path of this.writtenPaths)
+            this.data.delete(path);
+        this.writtenPaths.clear();
+        this.actions.length = 0;
+        this.accesses.length = 0;
+        this.sequence = 0;
+        this.receiptsByReference.clear();
+    }
+    resolveParentReference(body) {
+        if (!isRecord(body) || typeof body.parentRef !== 'string')
+            return body;
+        const parent = this.receiptsByReference.get(body.parentRef);
+        return parent ? { ...body, thread_ts: parent.id } : { ...body };
+    }
+}
+const PROCESS_TRANSPORT_KEY = Symbol.for('agentworkforce.preview-transport');
+function processTransportRegistry() {
+    return globalThis;
+}
+/** Return the process-scoped transport used by legacy no-argument clients. */
+export function getProcessRelayTransport() {
+    return processTransportRegistry()[PROCESS_TRANSPORT_KEY];
+}
+/** Set or clear the process-scoped transport used by legacy no-argument clients. */
+export function setProcessRelayTransport(transport) {
+    processTransportRegistry()[PROCESS_TRANSPORT_KEY] = transport;
+}
+/** Compatibility name used by the preview runtime integration. */
+export function setPreviewTransport(transport) {
+    setProcessRelayTransport(transport);
+}
+/** Clear the process-scoped preview transport. */
+export function clearPreviewTransport() {
+    setProcessRelayTransport(undefined);
+}
+/**
+ * Bind a process transport and return a restoration callback. Nested bindings
+ * restore correctly; the callback will not overwrite a newer binding.
+ */
+export function bindRelayTransport(transport) {
+    const previous = getProcessRelayTransport();
+    setProcessRelayTransport(transport);
+    return () => {
+        if (getProcessRelayTransport() === transport)
+            setProcessRelayTransport(previous);
+    };
+}
+/** Convenience name for the common process-scoped preview binding. */
+export const bindPreviewTransport = bindRelayTransport;
+/** Explicit constructor injection always wins over the process binding. */
+export function resolveRelayTransport(options) {
+    return options.transport ?? getProcessRelayTransport();
+}
+/**
+ * Capture explicit constructor injection while resolving the process binding
+ * lazily for every operation. The lazy half is essential for handlers that
+ * construct a no-argument client at module load before a Run binds preview.
+ */
+export function createRelayTransportResolver(options) {
+    const explicitTransport = options.transport;
+    return () => explicitTransport ?? getProcessRelayTransport();
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+export interface EffectPolicyV1 {
+    reads: 'deny' | 'fixtures' | 'live';
+    writes: 'deny' | 'preview' | 'sandbox' | 'live';
+    model: 'stub' | 'fixture' | 'live';
+    shell: 'deny' | 'simulate' | 'sandbox' | 'live';
+    compose: 'deny' | 'preview' | 'sandbox' | 'live';
+    allowedHttp: Array<{
+        method: string;
+        urlGlob: string;
+    }>;
+    allowedProviders?: string[];
+}
+export interface PreviewSimulatedReceipt {
+    id: string;
+    timestamp: string;
+}
+export type PreviewParameters = Record<string, string | number>;
+export interface PreviewAction {
+    id?: string;
+    kind: 'provider.read' | 'provider.write';
+    provider: string;
+    resource: string;
+    status: 'previewed';
+    data: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+    method: 'read' | 'list' | 'write';
+    path: string;
+    parameters?: PreviewParameters;
+    body?: unknown;
+    simulatedReceipt?: PreviewSimulatedReceipt;
+}
+export type TransportPreviewAction = PreviewAction;
+export type PreviewAccess = PreviewAction & {
+    kind: 'provider.read';
+    method: 'read' | 'list';
+    body?: never;
+    simulatedReceipt?: never;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IACpC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAChD,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IAChD,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACjD,WAAW,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,eAAe,GAAG,gBAAgB,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAC1C,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,gBAAgB,CAAC,EAAE,KAAK,CAAC;CAC1B,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// relay-helpers owns this type; @agentworkforce/runtime maps it when consuming.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/relay-helpers",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Ergonomic, catalog-backed provider clients for Relayfile integration handlers",
   "license": "Apache-2.0",
   "repository": {
@@ -17,6 +17,16 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./transport": {
+      "types": "./dist/transport.d.ts",
+      "import": "./dist/transport.js",
+      "default": "./dist/transport.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -31,7 +41,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@relayfile/adapter-core": "^0.4.6",
-    "@relayfile/adapter-linear": "^0.4.2"
+    "@relayfile/adapter-core": "^0.5.3",
+    "@relayfile/adapter-linear": "^0.4.4",
+    "@relayfile/adapter-reddit": "^0.2.3"
   }
 }