@slates/test 1.0.0-rc.24 → 1.0.0-rc.25

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  connectSlateTriggerGroupGateway: () => connectSlateTriggerGroupGateway,
   createLocalSlateTestClient: () => createLocalSlateTestClient,
   createSlatesTestClient: () => createSlatesTestClient,
   describeMcpCompatibleToolSchemas: () => describeMcpCompatibleToolSchemas,
@@ -35,6 +36,7 @@ __export(index_exports, {
   mapSlateTriggerEvent: () => mapSlateTriggerEvent,
   pollSlateTriggerGroupEvents: () => pollSlateTriggerGroupEvents,
   processSlateTriggerGroupWebhook: () => processSlateTriggerGroupWebhook,
+  receiveSlateTriggerGroupGatewayFrames: () => receiveSlateTriggerGroupGatewayFrames,
   registerSlateTriggerGroupWebhook: () => registerSlateTriggerGroupWebhook,
   unregisterSlateTriggerGroupWebhook: () => unregisterSlateTriggerGroupWebhook,
   withSlateProfile: () => withSlateProfile
@@ -266,6 +268,22 @@ var pollSlateTriggerGroupEvents = async (d) => {
     state: d.state ?? null
   });
 };
+var connectSlateTriggerGroupGateway = async (d) => {
+  d.client.ensureSession();
+  return d.client.connectTriggerGroupGateway({
+    triggerGroupId: d.triggerGroupId,
+    state: d.state ?? null
+  });
+};
+var receiveSlateTriggerGroupGatewayFrames = async (d) => {
+  d.client.ensureSession();
+  return d.client.receiveTriggerGroupGatewayFrames({
+    triggerGroupId: d.triggerGroupId,
+    state: d.state ?? null,
+    frames: d.frames ?? [],
+    closed: d.closed ?? null
+  });
+};
 var processSlateTriggerGroupWebhook = async (d) => d.client.processTriggerGroupWebhook({
   triggerGroupId: d.triggerGroupId,
   url: d.url,
@@ -14867,6 +14885,7 @@ var describeMcpCompatibleToolSchemas = (name, source) => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  connectSlateTriggerGroupGateway,
   createLocalSlateTestClient,
   createSlatesTestClient,
   describeMcpCompatibleToolSchemas,
@@ -14882,6 +14901,7 @@ var describeMcpCompatibleToolSchemas = (name, source) => {
   mapSlateTriggerEvent,
   pollSlateTriggerGroupEvents,
   processSlateTriggerGroupWebhook,
+  receiveSlateTriggerGroupGatewayFrames,
   registerSlateTriggerGroupWebhook,
   unregisterSlateTriggerGroupWebhook,
   withSlateProfile

package/dist/index.d.cts

@@ -29,7 +29,7 @@ interface ExpectedSlateTriggerGroup {
     id: string;
     name?: string;
     description?: string;
-    invocationType?: 'polling' | 'webhook';
+    invocationType?: 'polling' | 'webhook' | 'gateway';
 }
 declare let getVitestExpect: () => vitest.ExpectStatic;
 declare let loadSlatesRuntimeContext: (opts?: {
@@ -238,6 +238,8 @@ declare let getSlateContract: (client: SlatesTestClient) => Promise<{
         invocation: {
             type: "polling";
             intervalSeconds: number;
+        } | {
+            type: "gateway";
         } | {
             type: "webhook";
             registration: {
@@ -429,6 +431,8 @@ declare let expectSlateContract: (d: {
         invocation: {
             type: "polling";
             intervalSeconds: number;
+        } | {
+            type: "gateway";
         } | {
             type: "webhook";
             registration: {
@@ -555,6 +559,98 @@ declare let pollSlateTriggerGroupEvents: (d: {
         } | undefined;
     }[] | undefined;
 }>;
+declare let connectSlateTriggerGroupGateway: (d: {
+    client: SlatesTestClient;
+    triggerGroupId: string;
+    state?: any;
+}) => Promise<{
+    url: string;
+    state?: any;
+    requestTraces?: {
+        startedAt: string;
+        durationMs: number;
+        request: {
+            method: string;
+            url: string;
+            headers?: Record<string, string> | undefined;
+            body?: {
+                text: string;
+                contentType?: string | undefined;
+                truncated?: boolean | undefined;
+            } | undefined;
+        };
+        response?: {
+            status: number;
+            statusText?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            body?: {
+                text: string;
+                contentType?: string | undefined;
+                truncated?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        error?: {
+            message: string;
+            code?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+}>;
+declare let receiveSlateTriggerGroupGatewayFrames: (d: {
+    client: SlatesTestClient;
+    triggerGroupId: string;
+    state?: any;
+    frames?: string[];
+    closed?: {
+        code: number;
+        reason: string;
+    } | null;
+}) => Promise<{
+    send: string[];
+    events: {
+        payload: Record<string, any>;
+        triggerIds: string[];
+        idempotencyKey?: string | undefined;
+    }[];
+    state?: any;
+    heartbeat?: {
+        intervalMs: number;
+        frame: string;
+        expectsAck?: boolean | undefined;
+    } | null | undefined;
+    heartbeatAcked?: boolean | undefined;
+    close?: {
+        reconnect: boolean;
+        reason?: string | undefined;
+    } | null | undefined;
+    requestTraces?: {
+        startedAt: string;
+        durationMs: number;
+        request: {
+            method: string;
+            url: string;
+            headers?: Record<string, string> | undefined;
+            body?: {
+                text: string;
+                contentType?: string | undefined;
+                truncated?: boolean | undefined;
+            } | undefined;
+        };
+        response?: {
+            status: number;
+            statusText?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            body?: {
+                text: string;
+                contentType?: string | undefined;
+                truncated?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        error?: {
+            message: string;
+            code?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+}>;
 declare let processSlateTriggerGroupWebhook: (d: {
     client: SlatesTestClient;
     triggerGroupId: string;
@@ -697,4 +793,4 @@ declare let getMcpCompatibleToolSchemaCases: (source: ToolSchemaSource) => Reado
 declare let expectMcpCompatibleToolSchema: (tool: ToolSchemaTarget) => void;
 declare let describeMcpCompatibleToolSchemas: (name: string, source: ToolSchemaSource) => void;
 
-export { type ExpectedSlateAction, type ExpectedSlateTriggerGroup, type SlatesRuntimeContext, type SlatesTestClient, createLocalSlateTestClient, createSlatesTestClient, describeMcpCompatibleToolSchemas, expectMcpCompatibleToolSchema, expectSlateContract, expectSlateError, expectToolCall, getMcpCompatibleToolSchemaCases, getSlateContract, getVitestExpect, loadSlatesProfile, loadSlatesRuntimeContext, mapSlateTriggerEvent, pollSlateTriggerGroupEvents, processSlateTriggerGroupWebhook, registerSlateTriggerGroupWebhook, unregisterSlateTriggerGroupWebhook, withSlateProfile };
+export { type ExpectedSlateAction, type ExpectedSlateTriggerGroup, type SlatesRuntimeContext, type SlatesTestClient, connectSlateTriggerGroupGateway, createLocalSlateTestClient, createSlatesTestClient, describeMcpCompatibleToolSchemas, expectMcpCompatibleToolSchema, expectSlateContract, expectSlateError, expectToolCall, getMcpCompatibleToolSchemaCases, getSlateContract, getVitestExpect, loadSlatesProfile, loadSlatesRuntimeContext, mapSlateTriggerEvent, pollSlateTriggerGroupEvents, processSlateTriggerGroupWebhook, receiveSlateTriggerGroupGatewayFrames, registerSlateTriggerGroupWebhook, unregisterSlateTriggerGroupWebhook, withSlateProfile };

package/dist/index.d.ts

@@ -29,7 +29,7 @@ interface ExpectedSlateTriggerGroup {
     id: string;
     name?: string;
     description?: string;
-    invocationType?: 'polling' | 'webhook';
+    invocationType?: 'polling' | 'webhook' | 'gateway';
 }
 declare let getVitestExpect: () => vitest.ExpectStatic;
 declare let loadSlatesRuntimeContext: (opts?: {
@@ -238,6 +238,8 @@ declare let getSlateContract: (client: SlatesTestClient) => Promise<{
         invocation: {
             type: "polling";
             intervalSeconds: number;
+        } | {
+            type: "gateway";
         } | {
             type: "webhook";
             registration: {
@@ -429,6 +431,8 @@ declare let expectSlateContract: (d: {
         invocation: {
             type: "polling";
             intervalSeconds: number;
+        } | {
+            type: "gateway";
         } | {
             type: "webhook";
             registration: {
@@ -555,6 +559,98 @@ declare let pollSlateTriggerGroupEvents: (d: {
         } | undefined;
     }[] | undefined;
 }>;
+declare let connectSlateTriggerGroupGateway: (d: {
+    client: SlatesTestClient;
+    triggerGroupId: string;
+    state?: any;
+}) => Promise<{
+    url: string;
+    state?: any;
+    requestTraces?: {
+        startedAt: string;
+        durationMs: number;
+        request: {
+            method: string;
+            url: string;
+            headers?: Record<string, string> | undefined;
+            body?: {
+                text: string;
+                contentType?: string | undefined;
+                truncated?: boolean | undefined;
+            } | undefined;
+        };
+        response?: {
+            status: number;
+            statusText?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            body?: {
+                text: string;
+                contentType?: string | undefined;
+                truncated?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        error?: {
+            message: string;
+            code?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+}>;
+declare let receiveSlateTriggerGroupGatewayFrames: (d: {
+    client: SlatesTestClient;
+    triggerGroupId: string;
+    state?: any;
+    frames?: string[];
+    closed?: {
+        code: number;
+        reason: string;
+    } | null;
+}) => Promise<{
+    send: string[];
+    events: {
+        payload: Record<string, any>;
+        triggerIds: string[];
+        idempotencyKey?: string | undefined;
+    }[];
+    state?: any;
+    heartbeat?: {
+        intervalMs: number;
+        frame: string;
+        expectsAck?: boolean | undefined;
+    } | null | undefined;
+    heartbeatAcked?: boolean | undefined;
+    close?: {
+        reconnect: boolean;
+        reason?: string | undefined;
+    } | null | undefined;
+    requestTraces?: {
+        startedAt: string;
+        durationMs: number;
+        request: {
+            method: string;
+            url: string;
+            headers?: Record<string, string> | undefined;
+            body?: {
+                text: string;
+                contentType?: string | undefined;
+                truncated?: boolean | undefined;
+            } | undefined;
+        };
+        response?: {
+            status: number;
+            statusText?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            body?: {
+                text: string;
+                contentType?: string | undefined;
+                truncated?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        error?: {
+            message: string;
+            code?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+}>;
 declare let processSlateTriggerGroupWebhook: (d: {
     client: SlatesTestClient;
     triggerGroupId: string;
@@ -697,4 +793,4 @@ declare let getMcpCompatibleToolSchemaCases: (source: ToolSchemaSource) => Reado
 declare let expectMcpCompatibleToolSchema: (tool: ToolSchemaTarget) => void;
 declare let describeMcpCompatibleToolSchemas: (name: string, source: ToolSchemaSource) => void;
 
-export { type ExpectedSlateAction, type ExpectedSlateTriggerGroup, type SlatesRuntimeContext, type SlatesTestClient, createLocalSlateTestClient, createSlatesTestClient, describeMcpCompatibleToolSchemas, expectMcpCompatibleToolSchema, expectSlateContract, expectSlateError, expectToolCall, getMcpCompatibleToolSchemaCases, getSlateContract, getVitestExpect, loadSlatesProfile, loadSlatesRuntimeContext, mapSlateTriggerEvent, pollSlateTriggerGroupEvents, processSlateTriggerGroupWebhook, registerSlateTriggerGroupWebhook, unregisterSlateTriggerGroupWebhook, withSlateProfile };
+export { type ExpectedSlateAction, type ExpectedSlateTriggerGroup, type SlatesRuntimeContext, type SlatesTestClient, connectSlateTriggerGroupGateway, createLocalSlateTestClient, createSlatesTestClient, describeMcpCompatibleToolSchemas, expectMcpCompatibleToolSchema, expectSlateContract, expectSlateError, expectToolCall, getMcpCompatibleToolSchemaCases, getSlateContract, getVitestExpect, loadSlatesProfile, loadSlatesRuntimeContext, mapSlateTriggerEvent, pollSlateTriggerGroupEvents, processSlateTriggerGroupWebhook, receiveSlateTriggerGroupGatewayFrames, registerSlateTriggerGroupWebhook, unregisterSlateTriggerGroupWebhook, withSlateProfile };

package/dist/index.module.js

@@ -236,6 +236,22 @@ var pollSlateTriggerGroupEvents = async (d) => {
     state: d.state ?? null
   });
 };
+var connectSlateTriggerGroupGateway = async (d) => {
+  d.client.ensureSession();
+  return d.client.connectTriggerGroupGateway({
+    triggerGroupId: d.triggerGroupId,
+    state: d.state ?? null
+  });
+};
+var receiveSlateTriggerGroupGatewayFrames = async (d) => {
+  d.client.ensureSession();
+  return d.client.receiveTriggerGroupGatewayFrames({
+    triggerGroupId: d.triggerGroupId,
+    state: d.state ?? null,
+    frames: d.frames ?? [],
+    closed: d.closed ?? null
+  });
+};
 var processSlateTriggerGroupWebhook = async (d) => d.client.processTriggerGroupWebhook({
   triggerGroupId: d.triggerGroupId,
   url: d.url,
@@ -14836,6 +14852,7 @@ var describeMcpCompatibleToolSchemas = (name, source) => {
   });
 };
 export {
+  connectSlateTriggerGroupGateway,
   createLocalSlateTestClient,
   createSlatesTestClient,
   describeMcpCompatibleToolSchemas,
@@ -14851,6 +14868,7 @@ export {
   mapSlateTriggerEvent,
   pollSlateTriggerGroupEvents,
   processSlateTriggerGroupWebhook,
+  receiveSlateTriggerGroupGatewayFrames,
   registerSlateTriggerGroupWebhook,
   unregisterSlateTriggerGroupWebhook,
   withSlateProfile

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slates/test",
-  "version": "1.0.0-rc.24",
+  "version": "1.0.0-rc.25",
   "publishConfig": {
     "access": "public"
   },
@@ -40,11 +40,11 @@
   },
   "dependencies": {
     "@lowerdeck/testing-tools": "latest",
-    "@slates/client": "1.0.0-rc.27",
-    "@slates/profiles": "1.0.0-rc.25"
+    "@slates/client": "1.0.0-rc.28",
+    "@slates/profiles": "1.0.0-rc.26"
   },
   "devDependencies": {
-    "@slates/provider": "1.0.0-rc.27",
+    "@slates/provider": "1.0.0-rc.28",
     "@slates/tsconfig": "1.0.0-rc.1",
     "typescript": "5.8.2",
     "vitest": "^3.1.2",

package/src/index.test.ts

@@ -15,6 +15,7 @@ import path from 'path';
 import { afterEach, describe, expect, it } from 'vitest';
 import { z } from 'zod';
 import {
+  connectSlateTriggerGroupGateway,
   createLocalSlateTestClient,
   expectSlateContract,
   expectSlateError,
@@ -23,6 +24,7 @@ import {
   mapSlateTriggerEvent,
   pollSlateTriggerGroupEvents,
   processSlateTriggerGroupWebhook,
+  receiveSlateTriggerGroupGatewayFrames,
   registerSlateTriggerGroupWebhook,
   unregisterSlateTriggerGroupWebhook
 } from './index';
@@ -298,11 +300,57 @@ let createDemoSlate = () => {
     }))
     .build();
 
+  let gatewayGroup = SlateTriggerGroup.create(spec, {
+    key: 'gateway_group',
+    name: 'Gateway Group'
+  })
+    .gateway({
+      connect: async ctx => ({
+        url: `wss://gateway.example.com?resume=${ctx.input.state?.session ?? 'none'}`,
+        state: { session: ctx.input.state?.session ?? null }
+      }),
+      receive: async ctx => {
+        if (ctx.input.closed) {
+          return { close: { reconnect: ctx.input.closed.code !== 4004 } };
+        }
+        let frames = ctx.input.frames.map(
+          frame => JSON.parse(frame) as { op: string; v?: string }
+        );
+        return {
+          state: { session: 'session-1' },
+          send: frames.some(f => f.op === 'hello')
+            ? [JSON.stringify({ op: 'identify', token: ctx.auth.token })]
+            : [],
+          heartbeat: { intervalMs: 41_250, frame: JSON.stringify({ op: 'heartbeat' }) },
+          events: frames
+            .filter(f => f.op === 'dispatch')
+            .map(f => ({ payload: { value: f.v }, idempotencyKey: `gw-${f.v}` }))
+        };
+      }
+    })
+    .routingMatchers(async () => [])
+    .build();
+
+  let gatewayEcho = SlateTrigger.create(spec, {
+    key: 'gateway_echo',
+    name: 'Gateway Echo'
+  })
+    .input(z.object({ value: z.string() }))
+    .output(z.object({ echoed: z.string() }))
+    .triggerGroup(gatewayGroup)
+    .matches(() => true)
+    .map(async ctx => ({
+      type: 'demo.gateway',
+      id: `gateway-${ctx.input.value}`,
+      output: { echoed: ctx.input.value }
+    }))
+    .build();
+
   return Slate.create({
     spec,
     tools: [echo, fail, attachmentEcho, downloadLink],
-    triggers: [webhookEcho, pollEcho],
-    triggerGroups: [webhookGroup, pollGroup]
+    triggers: [webhookEcho, pollEcho, gatewayEcho],
+    triggerGroups: [webhookGroup, pollGroup, gatewayGroup]
   });
 };
 
@@ -431,8 +479,8 @@ describe('@slates/test', () => {
         description: 'A tiny test slate'
       },
       toolIds: ['echo', 'fail', 'attachment_echo', 'download_link'],
-      triggerIds: ['webhook_echo', 'poll_echo'],
-      triggerGroupIds: ['webhook_group', 'poll_group'],
+      triggerIds: ['webhook_echo', 'poll_echo', 'gateway_echo'],
+      triggerGroupIds: ['webhook_group', 'poll_group', 'gateway_group'],
       authMethodIds: ['token_auth'],
       tools: [
         { id: 'echo', readOnly: false, destructive: false },
@@ -440,10 +488,11 @@ describe('@slates/test', () => {
         { id: 'attachment_echo', readOnly: true, destructive: false },
         { id: 'download_link', readOnly: true, destructive: false }
       ],
-      triggers: [{ id: 'webhook_echo' }, { id: 'poll_echo' }],
+      triggers: [{ id: 'webhook_echo' }, { id: 'poll_echo' }, { id: 'gateway_echo' }],
       triggerGroups: [
         { id: 'webhook_group', invocationType: 'webhook' },
-        { id: 'poll_group', invocationType: 'polling' }
+        { id: 'poll_group', invocationType: 'polling' },
+        { id: 'gateway_group', invocationType: 'gateway' }
       ]
     });
 
@@ -630,4 +679,64 @@ describe('@slates/test', () => {
       seen: true
     });
   });
+
+  it('wraps trigger gateway flows', async () => {
+    let client = createLocalSlateTestClient({
+      slate: createDemoSlate(),
+      state: {
+        config: { prefix: 'Hi' },
+        auth: { authenticationMethodId: 'token_auth', output: { token: 'secret-token' } }
+      }
+    });
+
+    let connected = await connectSlateTriggerGroupGateway({
+      client,
+      triggerGroupId: 'gateway_group'
+    });
+    expect(connected).toMatchObject({
+      url: 'wss://gateway.example.com?resume=none',
+      state: { session: null }
+    });
+
+    let received = await receiveSlateTriggerGroupGatewayFrames({
+      client,
+      triggerGroupId: 'gateway_group',
+      state: connected.state,
+      frames: [
+        JSON.stringify({ op: 'hello' }),
+        JSON.stringify({ op: 'dispatch', v: 'gw-value' })
+      ]
+    });
+    expect(received).toMatchObject({
+      state: { session: 'session-1' },
+      // The credential leaves the slate as a placeholder the hub resolves at the socket.
+      send: [JSON.stringify({ op: 'identify', token: '$$MT$secret$authConfig$token$$' })],
+      heartbeat: { intervalMs: 41_250, frame: JSON.stringify({ op: 'heartbeat' }) },
+      close: null,
+      events: [
+        {
+          payload: { value: 'gw-value' },
+          idempotencyKey: 'gw-gw-value',
+          triggerIds: ['gateway_echo']
+        }
+      ]
+    });
+
+    let mapped = await mapSlateTriggerEvent({
+      client,
+      triggerId: 'gateway_echo',
+      input: received.events[0]!.payload,
+      type: 'demo.gateway',
+      output: { echoed: 'gw-value' }
+    });
+    expect(mapped.id).toBe('gateway-gw-value');
+
+    let closed = await receiveSlateTriggerGroupGatewayFrames({
+      client,
+      triggerGroupId: 'gateway_group',
+      state: received.state,
+      closed: { code: 4004, reason: 'Authentication failed' }
+    });
+    expect(closed).toMatchObject({ send: [], events: [], close: { reconnect: false } });
+  });
 });

package/src/runtime.ts

@@ -71,7 +71,7 @@ export interface ExpectedSlateTriggerGroup {
   id: string;
   name?: string;
   description?: string;
-  invocationType?: 'polling' | 'webhook';
+  invocationType?: 'polling' | 'webhook' | 'gateway';
 }
 
 export let getVitestExpect = () => {
@@ -378,6 +378,34 @@ export let pollSlateTriggerGroupEvents = async (d: {
   });
 };
 
+export let connectSlateTriggerGroupGateway = async (d: {
+  client: SlatesTestClient;
+  triggerGroupId: string;
+  state?: any;
+}) => {
+  d.client.ensureSession();
+  return d.client.connectTriggerGroupGateway({
+    triggerGroupId: d.triggerGroupId,
+    state: d.state ?? null
+  });
+};
+
+export let receiveSlateTriggerGroupGatewayFrames = async (d: {
+  client: SlatesTestClient;
+  triggerGroupId: string;
+  state?: any;
+  frames?: string[];
+  closed?: { code: number; reason: string } | null;
+}) => {
+  d.client.ensureSession();
+  return d.client.receiveTriggerGroupGatewayFrames({
+    triggerGroupId: d.triggerGroupId,
+    state: d.state ?? null,
+    frames: d.frames ?? [],
+    closed: d.closed ?? null
+  });
+};
+
 export let processSlateTriggerGroupWebhook = async (d: {
   client: SlatesTestClient;
   triggerGroupId: string;