@slates/proto 1.0.0-rc.2 → 1.0.0-rc.21

package/src/messages/action.ts

@@ -1,5 +1,19 @@
 import z from 'zod';
 import { slatesAction } from '../types';
+import { withRequestTraces } from './tracing';
+
+export let slatesWebhookHttpResponse = z.object({
+  status: z.number().int().min(100).max(599),
+  headers: z.record(z.string(), z.string()),
+  body: z
+    .object({
+      encoding: z.literal('base64'),
+      content: z.string()
+    })
+    .nullable()
+});
+
+export type SlatesWebhookHttpResponse = z.infer<typeof slatesWebhookHttpResponse>;
 
 /**
  * List Actions
@@ -8,7 +22,9 @@ export let slatesMessageActionsListRequest = z.object({
   jsonrpc: z.literal('2.0'),
   method: z.literal('slates/actions.list'),
   id: z.string(),
-  params: z.object({})
+  params: z.object({
+    includeAdapterActions: z.optional(z.nullable(z.boolean()))
+  })
 });
 
 export type SlatesMessageActionsListRequest = z.infer<typeof slatesMessageActionsListRequest>;
@@ -69,9 +85,36 @@ export type SlatesMessageActionInvokeRequest = z.infer<
 export let slatesMessageActionInvokeResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
+  result: withRequestTraces({
     output: z.record(z.string(), z.any()),
-    message: z.string().optional()
+    message: z.string().optional(),
+    attachments: z
+      .array(
+        z.object({
+          mimeType: z.string().optional(),
+          attachmentHash: z.string().optional(),
+          content: z.union([
+            z.object({
+              type: z.literal('url'),
+              url: z.string(),
+              headers: z.record(z.string(), z.string()).optional(),
+              query: z.record(z.string(), z.string()).optional(),
+              refreshReference: z.unknown().optional(),
+              refreshAt: z.string().optional()
+            }),
+            z.object({
+              type: z.literal('content'),
+              encoding: z.union([z.literal('base64'), z.literal('utf-8')]),
+              content: z.string()
+            }),
+            z.object({
+              type: z.literal('upload_reference'),
+              referenceId: z.string()
+            })
+          ])
+        })
+      )
+      .optional()
   })
 });
 
@@ -99,7 +142,7 @@ export type SlatesMessageActionTriggerEventMapRequest = z.infer<
 export let slatesMessageActionTriggerEventMapResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
+  result: withRequestTraces({
     type: z.string(),
     id: z.string(),
     output: z.record(z.string(), z.any())
@@ -110,174 +153,28 @@ export type SlatesMessageActionTriggerEventMapResponse = z.infer<
   typeof slatesMessageActionTriggerEventMapResponse
 >;
 
-/**
- * Poll Trigger Events
- */
-export let slatesMessageActionTriggerEventsPollRequest = z.object({
-  jsonrpc: z.literal('2.0'),
-  method: z.literal('slates/action.trigger.poll_events'),
-  id: z.string(),
-  params: z.object({
-    actionId: z.string(),
-    state: z.any().nullable()
-  })
-});
-
-export type SlatesMessageActionTriggerEventsPollRequest = z.infer<
-  typeof slatesMessageActionTriggerEventsPollRequest
->;
-
-export let slatesMessageActionTriggerEventsPollResponse = z.object({
-  jsonrpc: z.literal('2.0'),
-  id: z.string(),
-  result: z.object({
-    inputs: z.array(z.record(z.string(), z.any())),
-    updatedState: z.any().nullable().optional()
-  })
-});
-
-export type SlatesMessageActionTriggerEventsPollResponse = z.infer<
-  typeof slatesMessageActionTriggerEventsPollResponse
->;
-
-/**
- * Handle Webhook Request
- */
-export let slatesMessageActionTriggerWebhookHandleRequest = z.object({
-  jsonrpc: z.literal('2.0'),
-  method: z.literal('slates/action.trigger.webhook_handle'),
-  id: z.string(),
-  params: z.object({
-    actionId: z.string(),
-    url: z.string(),
-    method: z.string(),
-    headers: z.record(z.string(), z.string()),
-    body: z
-      .object({
-        encoding: z.literal('base64'),
-        content: z.string()
-      })
-      .nullable(),
-    state: z.any().nullable()
-  })
-});
-
-export type SlatesMessageActionTriggerWebhookHandleRequest = z.infer<
-  typeof slatesMessageActionTriggerWebhookHandleRequest
->;
-
-export let slatesMessageActionTriggerWebhookHandleResponse = z.object({
-  jsonrpc: z.literal('2.0'),
-  id: z.string(),
-  result: z.object({
-    inputs: z.array(z.record(z.string(), z.any())),
-    updatedState: z.any().nullable().optional()
-  })
-});
-
-export type SlatesMessageActionTriggerWebhookHandleResponse = z.infer<
-  typeof slatesMessageActionTriggerWebhookHandleResponse
->;
-
-/**
- * Handle Webhook Registration
- */
-export let slatesMessageActionTriggerWebhookRegisterRequest = z.object({
-  jsonrpc: z.literal('2.0'),
-  method: z.literal('slates/action.trigger.webhook_register'),
-  id: z.string(),
-  params: z.object({
-    actionId: z.string(),
-    webhookBaseUrl: z.string()
-  })
-});
-
-export type SlatesMessageActionTriggerWebhookRegisterRequest = z.infer<
-  typeof slatesMessageActionTriggerWebhookRegisterRequest
->;
-
-export let slatesMessageActionTriggerWebhookRegisterResponse = z.object({
-  jsonrpc: z.literal('2.0'),
-  id: z.string(),
-  result: z.object({
-    registrationDetails: z.any(),
-    state: z.any().optional()
-  })
-});
-
-export type SlatesMessageActionTriggerWebhookRegisterResponse = z.infer<
-  typeof slatesMessageActionTriggerWebhookRegisterResponse
->;
-
-/**
- * Handle Webhook Unregistration
- */
-export let slatesMessageActionTriggerWebhookUnregisterRequest = z.object({
-  jsonrpc: z.literal('2.0'),
-  method: z.literal('slates/action.trigger.webhook_unregister'),
-  id: z.string(),
-  params: z.object({
-    actionId: z.string(),
-    webhookBaseUrl: z.string(),
-    registrationDetails: z.any(),
-    state: z.any().optional()
-  })
-});
-
-export type SlatesMessageActionTriggerWebhookUnregisterRequest = z.infer<
-  typeof slatesMessageActionTriggerWebhookUnregisterRequest
->;
-
-export let slatesMessageActionTriggerWebhookUnregisterResponse = z.object({
-  jsonrpc: z.literal('2.0'),
-  id: z.string(),
-  result: z.object({})
-});
-
-export type SlatesMessageActionTriggerWebhookUnregisterResponse = z.infer<
-  typeof slatesMessageActionTriggerWebhookUnregisterResponse
->;
-
 export type SlatesActionRequests =
   | SlatesMessageActionsListRequest
   | SlatesMessageActionGetRequest
   | SlatesMessageActionInvokeRequest
-  | SlatesMessageActionTriggerEventMapRequest
-  | SlatesMessageActionTriggerEventsPollRequest
-  | SlatesMessageActionTriggerWebhookHandleRequest
-  | SlatesMessageActionTriggerWebhookRegisterRequest
-  | SlatesMessageActionTriggerWebhookUnregisterRequest;
+  | SlatesMessageActionTriggerEventMapRequest;
 
 export type SlatesActionResponses =
   | SlatesMessageActionsListResponse
   | SlatesMessageActionGetResponse
   | SlatesMessageActionInvokeResponse
-  | SlatesMessageActionTriggerEventMapResponse
-  | SlatesMessageActionTriggerEventsPollResponse
-  | SlatesMessageActionTriggerWebhookHandleResponse
-  | SlatesMessageActionTriggerWebhookRegisterResponse
-  | SlatesMessageActionTriggerWebhookUnregisterResponse;
+  | SlatesMessageActionTriggerEventMapResponse;
 
 export let slatesActionResponsesByMethod = {
   'slates/actions.list': slatesMessageActionsListResponse,
   'slates/action.get': slatesMessageActionGetResponse,
   'slates/action.tool.invoke': slatesMessageActionInvokeResponse,
-  'slates/action.trigger.map_event': slatesMessageActionTriggerEventMapResponse,
-  'slates/action.trigger.poll_events': slatesMessageActionTriggerEventsPollResponse,
-  'slates/action.trigger.webhook_handle': slatesMessageActionTriggerWebhookHandleResponse,
-  'slates/action.trigger.webhook_register': slatesMessageActionTriggerWebhookRegisterResponse,
-  'slates/action.trigger.webhook_unregister':
-    slatesMessageActionTriggerWebhookUnregisterResponse
+  'slates/action.trigger.map_event': slatesMessageActionTriggerEventMapResponse
 };
 
 export let slatesActionRequestsByMethod = {
   'slates/actions.list': slatesMessageActionsListRequest,
   'slates/action.get': slatesMessageActionGetRequest,
   'slates/action.tool.invoke': slatesMessageActionInvokeRequest,
-  'slates/action.trigger.map_event': slatesMessageActionTriggerEventMapRequest,
-  'slates/action.trigger.poll_events': slatesMessageActionTriggerEventsPollRequest,
-  'slates/action.trigger.webhook_handle': slatesMessageActionTriggerWebhookHandleRequest,
-  'slates/action.trigger.webhook_register': slatesMessageActionTriggerWebhookRegisterRequest,
-  'slates/action.trigger.webhook_unregister':
-    slatesMessageActionTriggerWebhookUnregisterRequest
+  'slates/action.trigger.map_event': slatesMessageActionTriggerEventMapRequest
 };

package/src/messages/adapter.ts

@@ -0,0 +1,72 @@
+import z from 'zod';
+import { slatesAdapter } from '../types';
+
+/**
+ * List Adapters
+ */
+export let slatesMessageAdaptersListRequest = z.object({
+  jsonrpc: z.literal('2.0'),
+  method: z.literal('slates/adapters.list'),
+  id: z.string(),
+  params: z.object({
+    includeAdapters: z.optional(z.nullable(z.boolean()))
+  })
+});
+
+export type SlatesMessageAdaptersListRequest = z.infer<
+  typeof slatesMessageAdaptersListRequest
+>;
+
+export let slatesMessageAdaptersListResponse = z.object({
+  jsonrpc: z.literal('2.0'),
+  id: z.string(),
+  result: z.object({
+    adapters: z.array(slatesAdapter)
+  })
+});
+
+export type SlatesMessageAdaptersListResponse = z.infer<
+  typeof slatesMessageAdaptersListResponse
+>;
+
+/**
+ * Get Adapter
+ */
+export let slatesMessageAdapterGetRequest = z.object({
+  jsonrpc: z.literal('2.0'),
+  method: z.literal('slates/adapter.get'),
+  id: z.string(),
+  params: z.object({
+    adapterId: z.string()
+  })
+});
+
+export type SlatesMessageAdapterGetRequest = z.infer<typeof slatesMessageAdapterGetRequest>;
+
+export let slatesMessageAdapterGetResponse = z.object({
+  jsonrpc: z.literal('2.0'),
+  id: z.string(),
+  result: z.object({
+    adapter: slatesAdapter
+  })
+});
+
+export type SlatesMessageAdapterGetResponse = z.infer<typeof slatesMessageAdapterGetResponse>;
+
+export type SlatesAdapterRequests =
+  | SlatesMessageAdaptersListRequest
+  | SlatesMessageAdapterGetRequest;
+
+export type SlatesAdapterResponses =
+  | SlatesMessageAdaptersListResponse
+  | SlatesMessageAdapterGetResponse;
+
+export let slatesAdapterResponsesByMethod = {
+  'slates/adapters.list': slatesMessageAdaptersListResponse,
+  'slates/adapter.get': slatesMessageAdapterGetResponse
+};
+
+export let slatesAdapterRequestsByMethod = {
+  'slates/adapters.list': slatesMessageAdaptersListRequest,
+  'slates/adapter.get': slatesMessageAdapterGetRequest
+};

package/src/messages/auth.ts

@@ -1,5 +1,6 @@
 import z from 'zod';
-import { slatesAuthenticationMethod } from '../types';
+import { slatesAuthenticationMethod, slatesTriggerRoutingMatcher } from '../types';
+import { withRequestTraces } from './tracing';
 
 /**
  * Set Authentication
@@ -92,7 +93,7 @@ export type SlatesMessageAuthInputChangedRequest = z.infer<
 export let slatesMessageAuthInputChangedResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
+  result: withRequestTraces({
     input: z.record(z.string(), z.any()).optional()
   })
 });
@@ -120,7 +121,7 @@ export type SlatesMessageAuthDefaultInputGetRequest = z.infer<
 export let slatesMessageAuthDefaultInputGetResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
+  result: withRequestTraces({
     input: z.record(z.string(), z.any())
   })
 });
@@ -155,9 +156,10 @@ export type SlatesMessageAuthAuthorizationUrlGetRequest = z.infer<
 export let slatesMessageAuthAuthorizationUrlGetResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
+  result: withRequestTraces({
     authorizationUrl: z.string(),
-    input: z.record(z.string(), z.any()).optional()
+    input: z.record(z.string(), z.any()).optional(),
+    callbackState: z.record(z.string(), z.any()).optional()
   })
 });
 
@@ -181,7 +183,9 @@ export let slatesMessageAuthAuthorizationCallbackHandleRequest = z.object({
     input: z.record(z.string(), z.any()),
     clientId: z.string(),
     clientSecret: z.string(),
-    scopes: z.array(z.string())
+    scopes: z.array(z.string()),
+    callbackParams: z.record(z.string(), z.string()).optional(),
+    callbackState: z.record(z.string(), z.any()).optional()
   })
 });
 
@@ -192,9 +196,11 @@ export type SlatesMessageAuthAuthorizationCallbackHandleRequest = z.infer<
 export let slatesMessageAuthAuthorizationCallbackHandleResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
+  result: withRequestTraces({
     output: z.record(z.string(), z.any()),
-    input: z.record(z.string(), z.any()).optional()
+    input: z.record(z.string(), z.any()).optional(),
+    scopes: z.array(z.string()).optional(),
+    routingMatchers: z.array(slatesTriggerRoutingMatcher).optional()
   })
 });
 
@@ -227,9 +233,10 @@ export type SlatesMessageAuthTokenRefreshHandleRequest = z.infer<
 export let slatesMessageAuthTokenRefreshHandleResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
+  result: withRequestTraces({
     output: z.record(z.string(), z.any()),
-    input: z.record(z.string(), z.any()).optional()
+    input: z.record(z.string(), z.any()).optional(),
+    routingMatchers: z.array(slatesTriggerRoutingMatcher).optional()
   })
 });
 
@@ -260,7 +267,7 @@ export type SlatesMessageAuthProfileGetRequest = z.infer<
 export let slatesMessageAuthProfileGetResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
+  result: withRequestTraces({
     profile: z.record(z.string(), z.any())
   })
 });
@@ -290,8 +297,9 @@ export type SlatesMessageAuthOutputGetRequest = z.infer<
 export let slatesMessageAuthOutputGetResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
-    output: z.record(z.string(), z.any())
+  result: withRequestTraces({
+    output: z.record(z.string(), z.any()),
+    scopes: z.array(z.string()).optional()
   })
 });
 

package/src/messages/config.ts

@@ -1,4 +1,5 @@
 import z from 'zod';
+import { withRequestTraces } from './tracing';
 
 /**
  * Set Config
@@ -33,7 +34,14 @@ export let slatesMessageConfigSchemaGetResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
   result: z.object({
-    schema: z.record(z.string(), z.any())
+    schema: z.record(z.string(), z.any()),
+    docs: z.array(
+      z.object({
+        type: z.literal('docs.config.general').optional(),
+        name: z.string(),
+        url: z.string()
+      })
+    )
   })
 });
 
@@ -47,6 +55,7 @@ export type SlatesMessageConfigSchemaGetResponse = z.infer<
 export let slatesMessageConfigChangedRequest = z.object({
   jsonrpc: z.literal('2.0'),
   method: z.literal('slates/config.changed'),
+  id: z.string(),
   params: z.object({
     previousConfig: z.record(z.string(), z.any()).nullable(),
     newConfig: z.record(z.string(), z.any())
@@ -60,7 +69,7 @@ export type SlatesMessageConfigChangedRequest = z.infer<
 export let slatesMessageConfigChangedResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
+  result: withRequestTraces({
     success: z.boolean(),
     config: z.record(z.string(), z.any()).optional(),
     errors: z
@@ -96,7 +105,7 @@ export type SlatesMessageConfigDefaultGetRequest = z.infer<
 export let slatesMessageConfigDefaultGetResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
-  result: z.object({
+  result: withRequestTraces({
     config: z.record(z.string(), z.any()).nullable()
   })
 });

package/src/messages/controlFlow.ts

@@ -1,11 +1,12 @@
 import z from 'zod';
 import { slatesParticipant } from '../types';
+import { SLATES_PROTOCOL_VERSION } from '../version';
 
 export let slatesMessageHelloNotification = z.object({
   jsonrpc: z.literal('2.0'),
   method: z.literal('slates/hello'),
   params: z.object({
-    protocol: z.literal('slates@2026-01-01')
+    protocol: z.literal(SLATES_PROTOCOL_VERSION)
   })
 });
 

package/src/messages/hub.ts

@@ -0,0 +1,92 @@
+import z from 'zod';
+
+export let slatesMessageHubCapabilitiesSetNotification = z.object({
+  jsonrpc: z.literal('2.0'),
+  method: z.literal('slates/hub.capabilities.set'),
+  params: z.object({
+    capabilities: z.object({
+      attachments: z
+        .object({
+          directUpload: z.object({
+            enabled: z.boolean(),
+            maxAttachmentSizeBytes: z.number().optional()
+          })
+        })
+        .optional(),
+      adapters: z.boolean().optional(),
+      triggers: z.boolean().optional()
+    })
+  })
+});
+
+export type SlatesMessageHubCapabilitiesSetNotification = z.infer<
+  typeof slatesMessageHubCapabilitiesSetNotification
+>;
+
+export let slatesMessageHubLiveInvocationSetNotification = z.object({
+  jsonrpc: z.literal('2.0'),
+  method: z.literal('slates/hub.live_invocation.set'),
+  params: z.object({
+    token: z.string(),
+    baseUrl: z.string()
+  })
+});
+
+export type SlatesMessageHubLiveInvocationSetNotification = z.infer<
+  typeof slatesMessageHubLiveInvocationSetNotification
+>;
+
+export type SlatesHubNotifications =
+  | SlatesMessageHubCapabilitiesSetNotification
+  | SlatesMessageHubLiveInvocationSetNotification;
+
+export let slatesHubNotificationsByMethod = {
+  'slates/hub.capabilities.set': slatesMessageHubCapabilitiesSetNotification,
+  'slates/hub.live_invocation.set': slatesMessageHubLiveInvocationSetNotification
+};
+
+export let slatesMessageProviderCapabilitiesGetRequest = z.object({
+  jsonrpc: z.literal('2.0'),
+  method: z.literal('slates/provider.capabilities.get'),
+  id: z.string(),
+  params: z.object({})
+});
+
+export type SlatesMessageProviderCapabilitiesGetRequest = z.infer<
+  typeof slatesMessageProviderCapabilitiesGetRequest
+>;
+
+export let slatesMessageProviderCapabilitiesGetResponse = z.object({
+  jsonrpc: z.literal('2.0'),
+  id: z.string(),
+  result: z.object({
+    capabilities: z.object({
+      hub: z
+        .object({
+          capabilitiesNotification: z.boolean().optional(),
+          liveInvocation: z.boolean().optional()
+        })
+        .optional(),
+      provider: z
+        .object({
+          triggerGroups: z.boolean().optional()
+        })
+        .optional()
+    })
+  })
+});
+
+export type SlatesMessageProviderCapabilitiesGetResponse = z.infer<
+  typeof slatesMessageProviderCapabilitiesGetResponse
+>;
+
+export type SlatesHubRequests = SlatesMessageProviderCapabilitiesGetRequest;
+export type SlatesHubResponses = SlatesMessageProviderCapabilitiesGetResponse;
+
+export let slatesHubRequestsByMethod = {
+  'slates/provider.capabilities.get': slatesMessageProviderCapabilitiesGetRequest
+};
+
+export let slatesHubResponsesByMethod = {
+  'slates/provider.capabilities.get': slatesMessageProviderCapabilitiesGetResponse
+};

package/src/messages/identify.ts

@@ -1,8 +1,10 @@
 import z from 'zod';
+import { SLATES_PROTOCOL_VERSION } from '../version';
 
 export let slatesMessageProviderIdentifyRequest = z.object({
   jsonrpc: z.literal('2.0'),
   method: z.literal('slates/provider.identify'),
+  id: z.string(),
   params: z.object({})
 });
 
@@ -14,15 +16,20 @@ export let slatesMessageProviderIdentifyResponse = z.object({
   jsonrpc: z.literal('2.0'),
   id: z.string(),
   result: z.object({
-    protocol: z.literal('slates@2026-01-01'),
-
+    protocol: z.literal(SLATES_PROTOCOL_VERSION),
     provider: z.object({
       type: z.literal('provider'),
       id: z.string(),
       name: z.string(),
       description: z.string().optional(),
       metadata: z.record(z.string(), z.any()).optional()
-    })
+    }),
+    docs: z.array(
+      z.object({
+        name: z.string(),
+        url: z.string()
+      })
+    )
   })
 });