@relayfile/sdk 0.10.12 → 0.10.13

package/dist/integration-adapter.d.ts

@@ -1,6 +1,7 @@
 import type { RelayFileClient } from "./client.js";
 import type { ConnectionProvider } from "./connection.js";
 import type { FileSemantics } from "./types.js";
+import type { WriteEvent } from "@relayfile/core";
 export interface AdapterWebhookMetadata {
     deliveryId?: string;
     delivery_id?: string;
@@ -48,6 +49,15 @@ export interface SyncResult {
         error: string;
     }>;
 }
+export interface RelayBindingView {
+    text: string;
+    author?: string;
+    skip?: boolean;
+}
+export interface RelayBinding {
+    present?(event: WriteEvent): RelayBindingView | null;
+    replyPathFor?(sourcePath: string): string | null;
+}
 export declare abstract class IntegrationAdapter {
     protected readonly client: RelayFileClient;
     protected readonly provider: ConnectionProvider;
@@ -59,5 +69,8 @@ export declare abstract class IntegrationAdapter {
     abstract computeSemantics(objectType: string, objectId: string, payload: Record<string, unknown>): FileSemantics;
     supportedEvents?(): string[];
     writeBack?(workspaceId: string, path: string, content: string): Promise<unknown>;
+    relayBinding?: RelayBinding;
     sync?(workspaceId: string, options?: SyncOptions): Promise<SyncResult>;
 }
+export declare function genericPresent(event: WriteEvent, adapter: IntegrationAdapter): RelayBindingView;
+export declare function genericReplyPathFor(sourcePath: string): string | null;

package/dist/integration-adapter.js

@@ -1,3 +1,4 @@
+const DEFAULT_PRESENT_TEXT_LIMIT = 500;
 export class IntegrationAdapter {
     client;
     provider;
@@ -5,4 +6,80 @@ export class IntegrationAdapter {
         this.client = client;
         this.provider = provider;
     }
+    relayBinding;
+}
+export function genericPresent(event, adapter) {
+    const provider = providerFromPath(event.path) || adapter.name;
+    const { objectType, objectId } = objectIdentityFromPath(event.path);
+    const payload = isRecord(event.value) ? event.value : {};
+    let semantics = {};
+    try {
+        semantics = adapter.computeSemantics(objectType, objectId, payload) ?? {};
+    }
+    catch {
+        semantics = {};
+    }
+    const summary = summarizeForRelayBinding(event, semantics, payload);
+    return {
+        text: truncateText(summary, DEFAULT_PRESENT_TEXT_LIMIT),
+        author: event.actor?.id || provider
+    };
+}
+export function genericReplyPathFor(sourcePath) {
+    const normalized = sourcePath.trim().replace(/\/+$/, "");
+    if (!normalized || !normalized.startsWith("/")) {
+        return null;
+    }
+    return `${normalized}/replies/draft.json`;
+}
+function summarizeForRelayBinding(event, semantics, payload) {
+    const semanticLines = [
+        firstNonEmpty("status", semantics.properties?.["provider.status"], semantics.properties?.status),
+        firstNonEmpty("updated", semantics.properties?.["provider.updated_at"], semantics.properties?.updatedAt),
+        firstNonEmpty("title", semantics.properties?.title, semantics.properties?.name, semantics.properties?.subject)
+    ].filter((line) => line !== undefined);
+    const relationCount = semantics.relations?.length ?? 0;
+    const commentCount = semantics.comments?.length ?? 0;
+    const permissionCount = semantics.permissions?.length ?? 0;
+    const counts = [
+        relationCount ? `${relationCount} relation${relationCount === 1 ? "" : "s"}` : undefined,
+        commentCount ? `${commentCount} comment${commentCount === 1 ? "" : "s"}` : undefined,
+        permissionCount ? `${permissionCount} permission${permissionCount === 1 ? "" : "s"}` : undefined
+    ].filter((entry) => entry !== undefined);
+    const payloadPreview = Object.keys(payload).length > 0
+        ? `payload: ${JSON.stringify(payload)}`
+        : undefined;
+    return [
+        `${event.operation} ${event.path}`,
+        counts.length > 0 ? counts.join(", ") : undefined,
+        ...semanticLines,
+        payloadPreview
+    ].filter((line) => line !== undefined && line.trim() !== "").join("\n");
+}
+function firstNonEmpty(label, ...values) {
+    const value = values.find((candidate) => candidate && candidate.trim() !== "");
+    return value ? `${label}: ${value}` : undefined;
+}
+function truncateText(value, limit) {
+    if (value.length <= limit) {
+        return value;
+    }
+    return value.slice(0, limit);
+}
+function providerFromPath(path) {
+    return normalizePath(path)[0] ?? "";
+}
+function objectIdentityFromPath(path) {
+    const segments = normalizePath(path);
+    const filename = segments[segments.length - 1] ?? "";
+    return {
+        objectType: segments[1] ?? "unknown",
+        objectId: filename.replace(/\.[^.]+$/, "")
+    };
+}
+function normalizePath(path) {
+    return path.split("/").filter(Boolean);
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/sdk",
-  "version": "0.10.12",
+  "version": "0.10.13",
   "description": "TypeScript SDK for relayfile — real-time filesystem for humans and agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -59,15 +59,15 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@relayfile/core": "0.10.12",
+    "@relayfile/core": "0.10.13",
     "ignore": "^7.0.5",
     "tar": "^7.5.10"
   },
   "optionalDependencies": {
-    "@relayfile/mount-darwin-arm64": "0.10.12",
-    "@relayfile/mount-darwin-x64": "0.10.12",
-    "@relayfile/mount-linux-arm64": "0.10.12",
-    "@relayfile/mount-linux-x64": "0.10.12"
+    "@relayfile/mount-darwin-arm64": "0.10.13",
+    "@relayfile/mount-darwin-x64": "0.10.13",
+    "@relayfile/mount-linux-arm64": "0.10.13",
+    "@relayfile/mount-linux-x64": "0.10.13"
   },
   "devDependencies": {
     "typescript": "^5.7.3",