@vellumai/plugin-api 0.12.1-dev.202609141913.5e16607 → 0.12.1-staging.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/index.d.ts +47 -82
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -167,10 +167,10 @@ declare const AssistantConfigSchema: z.ZodObject<{
167
167
  language: z.ZodDefault<z.ZodString>;
168
168
  providers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
169
169
  roles: z.ZodDefault<z.ZodRecord<z.ZodEnum<{
170
+ watch: "watch";
170
171
  liveVoice: "liveVoice";
171
172
  telephony: "telephony";
172
173
  dictation: "dictation";
173
- watch: "watch";
174
174
  batch: "batch";
175
175
  }> & z.core.$partial, z.ZodObject<{
176
176
  provider: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
@@ -312,12 +312,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
312
312
  "your-own": "your-own";
313
313
  }>>;
314
314
  }, z.core.$strip>>;
315
- "shopify-oauth": z.ZodDefault<z.ZodObject<{
316
- mode: z.ZodDefault<z.ZodEnum<{
317
- managed: "managed";
318
- "your-own": "your-own";
319
- }>>;
320
- }, z.core.$strip>>;
321
315
  "stripe-link-oauth": z.ZodDefault<z.ZodObject<{
322
316
  mode: z.ZodDefault<z.ZodEnum<{
323
317
  managed: "managed";
@@ -598,7 +592,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
598
592
  }, z.core.$strip>>;
599
593
  retrospective: z.ZodDefault<z.ZodObject<{
600
594
  enabled: z.ZodDefault<z.ZodBoolean>;
601
- skillImprovement: z.ZodDefault<z.ZodBoolean>;
602
595
  timeThresholdMs: z.ZodDefault<z.ZodNumber>;
603
596
  messageThreshold: z.ZodDefault<z.ZodNumber>;
604
597
  minCooldownMs: z.ZodDefault<z.ZodNumber>;
@@ -952,14 +945,31 @@ declare const AssistantConfigSchema: z.ZodObject<{
952
945
  }, z.core.$strip>>;
953
946
  localDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
954
947
  }, z.core.$strip>>;
948
+ mcp: z.ZodDefault<z.ZodObject<{
949
+ servers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
950
+ transport: z.ZodDiscriminatedUnion<[z.ZodObject<{
951
+ type: z.ZodLiteral<"stdio">;
952
+ command: z.ZodString;
953
+ args: z.ZodDefault<z.ZodArray<z.ZodString>>;
954
+ env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
955
+ }, z.core.$strip>, z.ZodObject<{
956
+ type: z.ZodLiteral<"sse">;
957
+ url: z.ZodString;
958
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
959
+ }, z.core.$strip>, z.ZodObject<{
960
+ type: z.ZodLiteral<"streamable-http">;
961
+ url: z.ZodString;
962
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
963
+ }, z.core.$strip>], "type">;
964
+ }, z.core.$strip>>>;
965
+ }, z.core.$strip>>;
955
966
  acp: z.ZodDefault<z.ZodObject<{
956
967
  maxConcurrentSessions: z.ZodDefault<z.ZodNumber>;
957
968
  agents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
958
- command: z.ZodOptional<z.ZodString>;
969
+ command: z.ZodString;
959
970
  args: z.ZodDefault<z.ZodArray<z.ZodString>>;
960
971
  description: z.ZodOptional<z.ZodString>;
961
972
  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
962
- model: z.ZodOptional<z.ZodString>;
963
973
  }, z.core.$strip>>>;
964
974
  }, z.core.$strip>>;
965
975
  skills: z.ZodDefault<z.ZodObject<{
@@ -971,6 +981,8 @@ declare const AssistantConfigSchema: z.ZodObject<{
971
981
  }, z.core.$strip>>>;
972
982
  load: z.ZodDefault<z.ZodObject<{
973
983
  extraDirs: z.ZodDefault<z.ZodArray<z.ZodString>>;
984
+ watch: z.ZodDefault<z.ZodBoolean>;
985
+ watchDebounceMs: z.ZodDefault<z.ZodNumber>;
974
986
  }, z.core.$strip>>;
975
987
  install: z.ZodDefault<z.ZodObject<{
976
988
  nodeManager: z.ZodDefault<z.ZodEnum<{
@@ -1065,7 +1077,15 @@ declare const AssistantConfigSchema: z.ZodObject<{
1065
1077
  enabled: z.ZodDefault<z.ZodBoolean>;
1066
1078
  text: z.ZodDefault<z.ZodString>;
1067
1079
  }, z.core.$strip>>;
1080
+ safety: z.ZodDefault<z.ZodObject<{
1081
+ denyCategories: z.ZodDefault<z.ZodArray<z.ZodString>>;
1082
+ }, z.core.$strip>>;
1068
1083
  voice: z.ZodDefault<z.ZodObject<{
1084
+ interruptSensitivity: z.ZodDefault<z.ZodEnum<{
1085
+ low: "low";
1086
+ medium: "medium";
1087
+ high: "high";
1088
+ }>>;
1069
1089
  telephonyStreaming: z.ZodDefault<z.ZodBoolean>;
1070
1090
  utteranceEndMs: z.ZodDefault<z.ZodNumber>;
1071
1091
  }, z.core.$strip>>;
@@ -1080,6 +1100,10 @@ declare const AssistantConfigSchema: z.ZodObject<{
1080
1100
  }, z.core.$strip>>;
1081
1101
  }, z.core.$strip>>;
1082
1102
  liveVoice: z.ZodDefault<z.ZodObject<{
1103
+ mode: z.ZodDefault<z.ZodEnum<{
1104
+ ptt: "ptt";
1105
+ "open-mic": "open-mic";
1106
+ }>>;
1083
1107
  vad: z.ZodDefault<z.ZodObject<{
1084
1108
  speechEnergyThreshold: z.ZodDefault<z.ZodNumber>;
1085
1109
  noiseFloorMargin: z.ZodDefault<z.ZodNumber>;
@@ -1090,18 +1114,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
1090
1114
  echoEmaHalfLifeMs: z.ZodDefault<z.ZodNumber>;
1091
1115
  echoDrainSlackMs: z.ZodDefault<z.ZodNumber>;
1092
1116
  }, z.core.$strip>>;
1093
- flux: z.ZodDefault<z.ZodObject<{
1094
- turnEnd: z.ZodDefault<z.ZodObject<{
1095
- enabled: z.ZodDefault<z.ZodBoolean>;
1096
- }, z.core.$strip>>;
1097
- model: z.ZodOptional<z.ZodString>;
1098
- eotThreshold: z.ZodDefault<z.ZodNumber>;
1099
- eagerEotThreshold: z.ZodOptional<z.ZodNumber>;
1100
- eotTimeoutMs: z.ZodDefault<z.ZodNumber>;
1101
- }, z.core.$strip>>;
1102
- archiveAudio: z.ZodDefault<z.ZodBoolean>;
1103
- }, z.core.$strip>>;
1104
- voice: z.ZodDefault<z.ZodObject<{
1105
1117
  frontModel: z.ZodDefault<z.ZodObject<{
1106
1118
  endpointDecisionTimeoutMs: z.ZodDefault<z.ZodNumber>;
1107
1119
  endpointExtensionMs: z.ZodDefault<z.ZodNumber>;
@@ -1116,6 +1128,17 @@ declare const AssistantConfigSchema: z.ZodObject<{
1116
1128
  generationTimeoutMs: z.ZodDefault<z.ZodNumber>;
1117
1129
  }, z.core.$strip>>;
1118
1130
  }, z.core.$strip>>;
1131
+ flux: z.ZodDefault<z.ZodObject<{
1132
+ turnEnd: z.ZodDefault<z.ZodObject<{
1133
+ enabled: z.ZodDefault<z.ZodBoolean>;
1134
+ }, z.core.$strip>>;
1135
+ model: z.ZodOptional<z.ZodString>;
1136
+ eotThreshold: z.ZodDefault<z.ZodNumber>;
1137
+ eagerEotThreshold: z.ZodOptional<z.ZodNumber>;
1138
+ eotTimeoutMs: z.ZodDefault<z.ZodNumber>;
1139
+ }, z.core.$strip>>;
1140
+ maxSessionDurationSeconds: z.ZodDefault<z.ZodNumber>;
1141
+ archiveAudio: z.ZodDefault<z.ZodBoolean>;
1119
1142
  }, z.core.$strip>>;
1120
1143
  sight: z.ZodDefault<z.ZodObject<{
1121
1144
  keepLatestFrames: z.ZodDefault<z.ZodNumber>;
@@ -1290,18 +1313,6 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
1290
1313
  type: z.ZodLiteral<"acp_session_error">;
1291
1314
  acpSessionId: z.ZodString;
1292
1315
  error: z.ZodString;
1293
- }, z.core.$strict>, z.ZodObject<{
1294
- type: z.ZodLiteral<"acp_session_model_update">;
1295
- acpSessionId: z.ZodString;
1296
- modelRevisionEpoch: z.ZodString;
1297
- modelRevision: z.ZodNumber;
1298
- model: z.ZodOptional<z.ZodString>;
1299
- availableModels: z.ZodArray<z.ZodObject<{
1300
- value: z.ZodString;
1301
- label: z.ZodString;
1302
- description: z.ZodOptional<z.ZodString>;
1303
- group: z.ZodOptional<z.ZodString>;
1304
- }, z.core.$strip>>;
1305
1316
  }, z.core.$strict>, z.ZodObject<{
1306
1317
  type: z.ZodLiteral<"acp_session_spawned">;
1307
1318
  acpSessionId: z.ZodString;
@@ -2110,7 +2121,6 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
2110
2121
  }, z.core.$strip>, z.ZodObject<{
2111
2122
  type: z.ZodLiteral<"notification_intent">;
2112
2123
  sourceEventName: z.ZodString;
2113
- assistantName: z.ZodOptional<z.ZodString>;
2114
2124
  title: z.ZodString;
2115
2125
  body: z.ZodString;
2116
2126
  deliveryId: z.ZodOptional<z.ZodString>;
@@ -2831,18 +2841,6 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2831
2841
  type: z.ZodLiteral<"acp_session_error">;
2832
2842
  acpSessionId: z.ZodString;
2833
2843
  error: z.ZodString;
2834
- }, z.core.$strict>, z.ZodObject<{
2835
- type: z.ZodLiteral<"acp_session_model_update">;
2836
- acpSessionId: z.ZodString;
2837
- modelRevisionEpoch: z.ZodString;
2838
- modelRevision: z.ZodNumber;
2839
- model: z.ZodOptional<z.ZodString>;
2840
- availableModels: z.ZodArray<z.ZodObject<{
2841
- value: z.ZodString;
2842
- label: z.ZodString;
2843
- description: z.ZodOptional<z.ZodString>;
2844
- group: z.ZodOptional<z.ZodString>;
2845
- }, z.core.$strip>>;
2846
2844
  }, z.core.$strict>, z.ZodObject<{
2847
2845
  type: z.ZodLiteral<"acp_session_spawned">;
2848
2846
  acpSessionId: z.ZodString;
@@ -3651,7 +3649,6 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
3651
3649
  }, z.core.$strip>, z.ZodObject<{
3652
3650
  type: z.ZodLiteral<"notification_intent">;
3653
3651
  sourceEventName: z.ZodString;
3654
- assistantName: z.ZodOptional<z.ZodString>;
3655
3652
  title: z.ZodString;
3656
3653
  body: z.ZodString;
3657
3654
  deliveryId: z.ZodOptional<z.ZodString>;
@@ -4852,7 +4849,6 @@ export declare type HookBroadcast = (detail: Record<string, unknown>) => void;
4852
4849
  * - `post-model-call` — {@link PostModelCallContext}
4853
4850
  * - `conversation-deleted` — {@link ConversationDeletedContext}
4854
4851
  * - `conversations-cleared` — {@link ConversationsClearedContext}
4855
- * - `message-deleted`: {@link MessageDeletedContext}
4856
4852
  */
4857
4853
  export declare type HookFunction<TCtx = unknown> = (ctx: TCtx) => Promise<Partial<TCtx> | void>;
4858
4854
 
@@ -4894,8 +4890,6 @@ export declare const HOOKS: {
4894
4890
  readonly CONVERSATION_DELETED: "conversation-deleted";
4895
4891
  /** Fires once when every conversation is wiped at once (the clear-all reset), after the main tables are cleared. Carries no `conversationId`; cleanup hooks wipe their own per-conversation state wholesale. */
4896
4892
  readonly CONVERSATIONS_CLEARED: "conversations-cleared";
4897
- /** Fires once per deleted message row, after the row is removed, carrying the row's `(createdAt, id)` so a hook can settle state that pointed at it. Fire-and-forget cleanup signal, like `conversation-deleted`; whole-conversation deletes dispatch that hook instead. */
4898
- readonly MESSAGE_DELETED: "message-deleted";
4899
4893
  };
4900
4894
 
4901
4895
  /**
@@ -5299,6 +5293,8 @@ declare interface LiveVoiceMetricsServerFrame extends LiveVoiceServerFrameBase {
5299
5293
  * condition as the two fields above.
5300
5294
  */
5301
5295
  readonly endpointDecisionSource?: "front-door" | "provider";
5296
+ /** Which floor-holding ack actually spoke during the turn, if any. */
5297
+ readonly ackSpoken?: "first_delta" | "tool_use";
5302
5298
  /**
5303
5299
  * Spoken progress narrations during the turn. Present only when at least
5304
5300
  * one progress update spoke (otherwise the field is absent, keeping frames
@@ -5539,37 +5535,6 @@ export declare interface Message {
5539
5535
  content: ContentBlock[];
5540
5536
  }
5541
5537
 
5542
- /**
5543
- * The full `message-deleted` context a hook receives: the dispatching call
5544
- * site's {@link MessageDeletedInputContext} plus the pipeline-stamped
5545
- * {@link BaseHookContext} capabilities.
5546
- */
5547
- export declare interface MessageDeletedContext extends MessageDeletedInputContext, BaseHookContext {
5548
- }
5549
-
5550
- /**
5551
- * Context passed to the `message-deleted` hook. Fires once per deleted
5552
- * message row, from the shared single-message delete primitive, after the row
5553
- * is removed. Whole-conversation deletes dispatch `conversation-deleted`
5554
- * instead.
5555
- *
5556
- * Fire-and-forget like `conversation-deleted`: the primitive is synchronous
5557
- * and does not wait for the chain. The row is gone by the time a hook runs,
5558
- * so the context carries the row's `createdAt` alongside its id. Together
5559
- * they are the `(createdAt, id)` position the row held, which is what a hook
5560
- * keeping a cursor on that row needs to record once the row can no longer be
5561
- * looked up. The default memory plugin contributes a hook here that stamps
5562
- * its retrospective cursor.
5563
- */
5564
- declare interface MessageDeletedInputContext {
5565
- /** ID of the conversation that owned the row. */
5566
- readonly conversationId: string;
5567
- /** ID of the deleted message row. */
5568
- readonly messageId: string;
5569
- /** The deleted row's `createdAt`. */
5570
- readonly createdAt: number;
5571
- }
5572
-
5573
5538
  declare type MessageLexicalSearchResult = Awaited<ReturnType<searchMessageIdsLexical_2>>[number];
5574
5539
 
5575
5540
  declare interface MessageLexicalSearchResult_2 {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vellumai/plugin-api",
3
- "version": "0.12.1-dev.202609141913.5e16607",
3
+ "version": "0.12.1-staging.2",
4
4
  "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
5
5
  "license": "MIT",
6
6
  "type": "module",