@vellumai/plugin-api 0.12.1-staging.1 → 0.12.1

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 -74
  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<{
@@ -592,7 +592,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
592
592
  }, z.core.$strip>>;
593
593
  retrospective: z.ZodDefault<z.ZodObject<{
594
594
  enabled: z.ZodDefault<z.ZodBoolean>;
595
- skillImprovement: z.ZodDefault<z.ZodBoolean>;
596
595
  timeThresholdMs: z.ZodDefault<z.ZodNumber>;
597
596
  messageThreshold: z.ZodDefault<z.ZodNumber>;
598
597
  minCooldownMs: z.ZodDefault<z.ZodNumber>;
@@ -946,14 +945,31 @@ declare const AssistantConfigSchema: z.ZodObject<{
946
945
  }, z.core.$strip>>;
947
946
  localDirectory: z.ZodDefault<z.ZodNullable<z.ZodString>>;
948
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>>;
949
966
  acp: z.ZodDefault<z.ZodObject<{
950
967
  maxConcurrentSessions: z.ZodDefault<z.ZodNumber>;
951
968
  agents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
952
- command: z.ZodOptional<z.ZodString>;
969
+ command: z.ZodString;
953
970
  args: z.ZodDefault<z.ZodArray<z.ZodString>>;
954
971
  description: z.ZodOptional<z.ZodString>;
955
972
  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
956
- model: z.ZodOptional<z.ZodString>;
957
973
  }, z.core.$strip>>>;
958
974
  }, z.core.$strip>>;
959
975
  skills: z.ZodDefault<z.ZodObject<{
@@ -965,6 +981,8 @@ declare const AssistantConfigSchema: z.ZodObject<{
965
981
  }, z.core.$strip>>>;
966
982
  load: z.ZodDefault<z.ZodObject<{
967
983
  extraDirs: z.ZodDefault<z.ZodArray<z.ZodString>>;
984
+ watch: z.ZodDefault<z.ZodBoolean>;
985
+ watchDebounceMs: z.ZodDefault<z.ZodNumber>;
968
986
  }, z.core.$strip>>;
969
987
  install: z.ZodDefault<z.ZodObject<{
970
988
  nodeManager: z.ZodDefault<z.ZodEnum<{
@@ -1059,7 +1077,15 @@ declare const AssistantConfigSchema: z.ZodObject<{
1059
1077
  enabled: z.ZodDefault<z.ZodBoolean>;
1060
1078
  text: z.ZodDefault<z.ZodString>;
1061
1079
  }, z.core.$strip>>;
1080
+ safety: z.ZodDefault<z.ZodObject<{
1081
+ denyCategories: z.ZodDefault<z.ZodArray<z.ZodString>>;
1082
+ }, z.core.$strip>>;
1062
1083
  voice: z.ZodDefault<z.ZodObject<{
1084
+ interruptSensitivity: z.ZodDefault<z.ZodEnum<{
1085
+ low: "low";
1086
+ medium: "medium";
1087
+ high: "high";
1088
+ }>>;
1063
1089
  telephonyStreaming: z.ZodDefault<z.ZodBoolean>;
1064
1090
  utteranceEndMs: z.ZodDefault<z.ZodNumber>;
1065
1091
  }, z.core.$strip>>;
@@ -1074,6 +1100,10 @@ declare const AssistantConfigSchema: z.ZodObject<{
1074
1100
  }, z.core.$strip>>;
1075
1101
  }, z.core.$strip>>;
1076
1102
  liveVoice: z.ZodDefault<z.ZodObject<{
1103
+ mode: z.ZodDefault<z.ZodEnum<{
1104
+ ptt: "ptt";
1105
+ "open-mic": "open-mic";
1106
+ }>>;
1077
1107
  vad: z.ZodDefault<z.ZodObject<{
1078
1108
  speechEnergyThreshold: z.ZodDefault<z.ZodNumber>;
1079
1109
  noiseFloorMargin: z.ZodDefault<z.ZodNumber>;
@@ -1084,18 +1114,6 @@ declare const AssistantConfigSchema: z.ZodObject<{
1084
1114
  echoEmaHalfLifeMs: z.ZodDefault<z.ZodNumber>;
1085
1115
  echoDrainSlackMs: z.ZodDefault<z.ZodNumber>;
1086
1116
  }, z.core.$strip>>;
1087
- flux: z.ZodDefault<z.ZodObject<{
1088
- turnEnd: z.ZodDefault<z.ZodObject<{
1089
- enabled: z.ZodDefault<z.ZodBoolean>;
1090
- }, z.core.$strip>>;
1091
- model: z.ZodOptional<z.ZodString>;
1092
- eotThreshold: z.ZodDefault<z.ZodNumber>;
1093
- eagerEotThreshold: z.ZodOptional<z.ZodNumber>;
1094
- eotTimeoutMs: z.ZodDefault<z.ZodNumber>;
1095
- }, z.core.$strip>>;
1096
- archiveAudio: z.ZodDefault<z.ZodBoolean>;
1097
- }, z.core.$strip>>;
1098
- voice: z.ZodDefault<z.ZodObject<{
1099
1117
  frontModel: z.ZodDefault<z.ZodObject<{
1100
1118
  endpointDecisionTimeoutMs: z.ZodDefault<z.ZodNumber>;
1101
1119
  endpointExtensionMs: z.ZodDefault<z.ZodNumber>;
@@ -1110,6 +1128,17 @@ declare const AssistantConfigSchema: z.ZodObject<{
1110
1128
  generationTimeoutMs: z.ZodDefault<z.ZodNumber>;
1111
1129
  }, z.core.$strip>>;
1112
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>;
1113
1142
  }, z.core.$strip>>;
1114
1143
  sight: z.ZodDefault<z.ZodObject<{
1115
1144
  keepLatestFrames: z.ZodDefault<z.ZodNumber>;
@@ -1284,18 +1313,6 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
1284
1313
  type: z.ZodLiteral<"acp_session_error">;
1285
1314
  acpSessionId: z.ZodString;
1286
1315
  error: z.ZodString;
1287
- }, z.core.$strict>, z.ZodObject<{
1288
- type: z.ZodLiteral<"acp_session_model_update">;
1289
- acpSessionId: z.ZodString;
1290
- modelRevisionEpoch: z.ZodString;
1291
- modelRevision: z.ZodNumber;
1292
- model: z.ZodOptional<z.ZodString>;
1293
- availableModels: z.ZodArray<z.ZodObject<{
1294
- value: z.ZodString;
1295
- label: z.ZodString;
1296
- description: z.ZodOptional<z.ZodString>;
1297
- group: z.ZodOptional<z.ZodString>;
1298
- }, z.core.$strip>>;
1299
1316
  }, z.core.$strict>, z.ZodObject<{
1300
1317
  type: z.ZodLiteral<"acp_session_spawned">;
1301
1318
  acpSessionId: z.ZodString;
@@ -2824,18 +2841,6 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2824
2841
  type: z.ZodLiteral<"acp_session_error">;
2825
2842
  acpSessionId: z.ZodString;
2826
2843
  error: z.ZodString;
2827
- }, z.core.$strict>, z.ZodObject<{
2828
- type: z.ZodLiteral<"acp_session_model_update">;
2829
- acpSessionId: z.ZodString;
2830
- modelRevisionEpoch: z.ZodString;
2831
- modelRevision: z.ZodNumber;
2832
- model: z.ZodOptional<z.ZodString>;
2833
- availableModels: z.ZodArray<z.ZodObject<{
2834
- value: z.ZodString;
2835
- label: z.ZodString;
2836
- description: z.ZodOptional<z.ZodString>;
2837
- group: z.ZodOptional<z.ZodString>;
2838
- }, z.core.$strip>>;
2839
2844
  }, z.core.$strict>, z.ZodObject<{
2840
2845
  type: z.ZodLiteral<"acp_session_spawned">;
2841
2846
  acpSessionId: z.ZodString;
@@ -4844,7 +4849,6 @@ export declare type HookBroadcast = (detail: Record<string, unknown>) => void;
4844
4849
  * - `post-model-call` — {@link PostModelCallContext}
4845
4850
  * - `conversation-deleted` — {@link ConversationDeletedContext}
4846
4851
  * - `conversations-cleared` — {@link ConversationsClearedContext}
4847
- * - `message-deleted`: {@link MessageDeletedContext}
4848
4852
  */
4849
4853
  export declare type HookFunction<TCtx = unknown> = (ctx: TCtx) => Promise<Partial<TCtx> | void>;
4850
4854
 
@@ -4886,8 +4890,6 @@ export declare const HOOKS: {
4886
4890
  readonly CONVERSATION_DELETED: "conversation-deleted";
4887
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. */
4888
4892
  readonly CONVERSATIONS_CLEARED: "conversations-cleared";
4889
- /** 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. */
4890
- readonly MESSAGE_DELETED: "message-deleted";
4891
4893
  };
4892
4894
 
4893
4895
  /**
@@ -5291,6 +5293,8 @@ declare interface LiveVoiceMetricsServerFrame extends LiveVoiceServerFrameBase {
5291
5293
  * condition as the two fields above.
5292
5294
  */
5293
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";
5294
5298
  /**
5295
5299
  * Spoken progress narrations during the turn. Present only when at least
5296
5300
  * one progress update spoke (otherwise the field is absent, keeping frames
@@ -5531,37 +5535,6 @@ export declare interface Message {
5531
5535
  content: ContentBlock[];
5532
5536
  }
5533
5537
 
5534
- /**
5535
- * The full `message-deleted` context a hook receives: the dispatching call
5536
- * site's {@link MessageDeletedInputContext} plus the pipeline-stamped
5537
- * {@link BaseHookContext} capabilities.
5538
- */
5539
- export declare interface MessageDeletedContext extends MessageDeletedInputContext, BaseHookContext {
5540
- }
5541
-
5542
- /**
5543
- * Context passed to the `message-deleted` hook. Fires once per deleted
5544
- * message row, from the shared single-message delete primitive, after the row
5545
- * is removed. Whole-conversation deletes dispatch `conversation-deleted`
5546
- * instead.
5547
- *
5548
- * Fire-and-forget like `conversation-deleted`: the primitive is synchronous
5549
- * and does not wait for the chain. The row is gone by the time a hook runs,
5550
- * so the context carries the row's `createdAt` alongside its id. Together
5551
- * they are the `(createdAt, id)` position the row held, which is what a hook
5552
- * keeping a cursor on that row needs to record once the row can no longer be
5553
- * looked up. The default memory plugin contributes a hook here that stamps
5554
- * its retrospective cursor.
5555
- */
5556
- declare interface MessageDeletedInputContext {
5557
- /** ID of the conversation that owned the row. */
5558
- readonly conversationId: string;
5559
- /** ID of the deleted message row. */
5560
- readonly messageId: string;
5561
- /** The deleted row's `createdAt`. */
5562
- readonly createdAt: number;
5563
- }
5564
-
5565
5538
  declare type MessageLexicalSearchResult = Awaited<ReturnType<searchMessageIdsLexical_2>>[number];
5566
5539
 
5567
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-staging.1",
3
+ "version": "0.12.1",
4
4
  "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
5
5
  "license": "MIT",
6
6
  "type": "module",