@vellumai/plugin-api 0.10.11-dev.202607231450.b516b22 → 0.10.11-dev.202607231649.18b8bbb

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 +31 -179
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -42,12 +42,12 @@ declare const AcpSessionUpdateEventSchema: z.ZodObject<{
42
42
  type: z.ZodLiteral<"acp_session_update">;
43
43
  acpSessionId: z.ZodString;
44
44
  updateType: z.ZodEnum<{
45
- plan: "plan";
46
45
  agent_message_chunk: "agent_message_chunk";
47
46
  agent_thought_chunk: "agent_thought_chunk";
48
47
  user_message_chunk: "user_message_chunk";
49
48
  tool_call: "tool_call";
50
49
  tool_call_update: "tool_call_update";
50
+ plan: "plan";
51
51
  }>;
52
52
  content: z.ZodOptional<z.ZodString>;
53
53
  toolCallId: z.ZodOptional<z.ZodString>;
@@ -710,6 +710,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
710
710
  enabled: z.ZodDefault<z.ZodBoolean>;
711
711
  blockIngress: z.ZodDefault<z.ZodBoolean>;
712
712
  allowOneTimeSend: z.ZodDefault<z.ZodBoolean>;
713
+ blockTokenShapedMessages: z.ZodDefault<z.ZodBoolean>;
713
714
  }, z.core.$strip>>;
714
715
  auditLog: z.ZodDefault<z.ZodObject<{
715
716
  retentionDays: z.ZodDefault<z.ZodNumber>;
@@ -1480,15 +1481,6 @@ export declare interface AssistantEventSubscription {
1480
1481
  readonly connectionId: string;
1481
1482
  }
1482
1483
 
1483
- /**
1484
- * Managed skill authored by the assistant's retrospective. Identical shape to a
1485
- * custom skill — it stays managed/deletable — but carries a distinct origin so
1486
- * the UI badges it as "Assistant's Memory" instead of "Custom".
1487
- */
1488
- declare interface AssistantMemorySlimSkill extends SlimSkillBase {
1489
- origin: "assistant-memory";
1490
- }
1491
-
1492
1484
  declare interface AssistantStatusMessage {
1493
1485
  type: "assistant_status";
1494
1486
  version?: string;
@@ -1549,8 +1541,8 @@ declare const BackgroundToolCompletedEventSchema: z.ZodObject<{
1549
1541
  conversationId: z.ZodString;
1550
1542
  status: z.ZodEnum<{
1551
1543
  cancelled: "cancelled";
1552
- failed: "failed";
1553
1544
  completed: "completed";
1545
+ failed: "failed";
1554
1546
  }>;
1555
1547
  exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1556
1548
  output: z.ZodOptional<z.ZodString>;
@@ -1837,17 +1829,6 @@ declare const ChoiceSurfaceDataSchema: z.ZodObject<{
1837
1829
  submitLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
1838
1830
  }, z.core.$strip>;
1839
1831
 
1840
- declare interface ClawhubSlimSkill extends SlimSkillBase {
1841
- origin: "clawhub";
1842
- slug: string;
1843
- author: string;
1844
- stars: number;
1845
- installs: number;
1846
- reports: number;
1847
- publishedAt?: string;
1848
- version: string;
1849
- }
1850
-
1851
1832
  export declare const CLI_COMMAND_HELP: readonly CliCommandHelp[];
1852
1833
 
1853
1834
  declare interface CliArgumentHelp {
@@ -2214,8 +2195,8 @@ declare const ConversationListInvalidatedEventSchema: z.ZodObject<{
2214
2195
  type: z.ZodLiteral<"conversation_list_invalidated">;
2215
2196
  reason: z.ZodEnum<{
2216
2197
  created: "created";
2217
- deleted: "deleted";
2218
2198
  renamed: "renamed";
2199
+ deleted: "deleted";
2219
2200
  reordered: "reordered";
2220
2201
  seen_changed: "seen_changed";
2221
2202
  }>;
@@ -2407,10 +2388,6 @@ export declare class CredentialResolutionError extends Error {
2407
2388
  constructor(message: string);
2408
2389
  }
2409
2390
 
2410
- declare interface CustomSlimSkill extends SlimSkillBase {
2411
- origin: "custom";
2412
- }
2413
-
2414
2391
  /**
2415
2392
  * Delete a conversation, yielding the event loop between row batches, and
2416
2393
  * enqueue vector-store cleanup for the memory segments and summaries the
@@ -2437,8 +2414,8 @@ declare const DiskPressureStatusChangedEventSchema: z.ZodObject<{
2437
2414
  unknown: "unknown";
2438
2415
  disabled: "disabled";
2439
2416
  critical: "critical";
2440
- ok: "ok";
2441
2417
  warning: "warning";
2418
+ ok: "ok";
2442
2419
  }>;
2443
2420
  locked: z.ZodBoolean;
2444
2421
  acknowledged: z.ZodBoolean;
@@ -2676,8 +2653,8 @@ declare const FormSurfaceDataSchema: z.ZodObject<{
2676
2653
  type: z.ZodCatch<z.ZodEnum<{
2677
2654
  number: "number";
2678
2655
  text: "text";
2679
- select: "select";
2680
2656
  textarea: "textarea";
2657
+ select: "select";
2681
2658
  toggle: "toggle";
2682
2659
  password: "password";
2683
2660
  }>>;
@@ -2700,8 +2677,8 @@ declare const FormSurfaceDataSchema: z.ZodObject<{
2700
2677
  type: z.ZodCatch<z.ZodEnum<{
2701
2678
  number: "number";
2702
2679
  text: "text";
2703
- select: "select";
2704
2680
  textarea: "textarea";
2681
+ select: "select";
2705
2682
  toggle: "toggle";
2706
2683
  password: "password";
2707
2684
  }>>;
@@ -4039,10 +4016,10 @@ declare const messageMetadataSchema: z.ZodObject<{
4039
4016
  subagentId: z.ZodString;
4040
4017
  label: z.ZodString;
4041
4018
  status: z.ZodEnum<{
4042
- failed: "failed";
4043
- aborted: "aborted";
4044
4019
  completed: "completed";
4020
+ failed: "failed";
4045
4021
  running: "running";
4022
+ aborted: "aborted";
4046
4023
  }>;
4047
4024
  error: z.ZodOptional<z.ZodString>;
4048
4025
  conversationId: z.ZodOptional<z.ZodString>;
@@ -4082,8 +4059,8 @@ declare const messageMetadataSchema: z.ZodObject<{
4082
4059
  startedAt: z.ZodNumber;
4083
4060
  status: z.ZodEnum<{
4084
4061
  cancelled: "cancelled";
4085
- failed: "failed";
4086
4062
  completed: "completed";
4063
+ failed: "failed";
4087
4064
  }>;
4088
4065
  exitCode: z.ZodNullable<z.ZodNumber>;
4089
4066
  output: z.ZodString;
@@ -4341,26 +4318,6 @@ declare const OpenUrlEventSchema: z.ZodObject<{
4341
4318
  conversationId: z.ZodOptional<z.ZodString>;
4342
4319
  }, z.core.$strip>;
4343
4320
 
4344
- /**
4345
- * Identifies what owns a tool: the built-in default set, or a skill / plugin /
4346
- * MCP server / workspace override. Tracked by the tool registry keyed by tool
4347
- * name, not stored on the `Tool` object itself — query via
4348
- * {@link ../tools/registry.getToolOwner}.
4349
- */
4350
- declare interface OwnerInfo {
4351
- kind: OwnerKind;
4352
- /** ID of the owner: skill id / plugin name / MCP server id / workspace path, or `"default"` for built-ins. */
4353
- id: string;
4354
- }
4355
-
4356
- /**
4357
- * The kind of entity that owns a tool. `"default"` is the built-in tool set
4358
- * that ships with the assistant; the others are extension surfaces. Every
4359
- * *registered* tool has an owner — {@link ../tools/registry.getToolOwner}
4360
- * returns `undefined` only for a name that is not registered at all.
4361
- */
4362
- declare type OwnerKind = "default" | "skill" | "mcp" | "plugin" | "workspace";
4363
-
4364
4321
  /** Parse a stored message-metadata JSON string; undefined when absent/invalid. */
4365
4322
  export declare function parseMessageMetadata(metadataJson: string | null): Promise<MessageMetadata>;
4366
4323
 
@@ -4374,13 +4331,6 @@ export declare function parseMessageMetadata(metadataJson: string | null): Promi
4374
4331
  */
4375
4332
  declare function parseMessageMetadata_2(metadataJson: string | null): MessageMetadata_2 | undefined;
4376
4333
 
4377
- declare interface PartnerAudit {
4378
- risk: RiskLevel_2;
4379
- alerts?: number;
4380
- score?: number;
4381
- analyzedAt: string;
4382
- }
4383
-
4384
4334
  declare interface PlatformConfigResponse {
4385
4335
  type: "platform_config_response";
4386
4336
  baseUrl: string;
@@ -5173,15 +5123,6 @@ export declare enum RiskLevel {
5173
5123
  High = "high"
5174
5124
  }
5175
5125
 
5176
- /**
5177
- * Audit types for SkillSSH partner security analysis.
5178
- *
5179
- * Extracted as a leaf module so daemon message types can reference
5180
- * PartnerAudit without pulling in the full skillssh-registry module
5181
- * (which transitively imports cli/program and the entire CLI graph).
5182
- */
5183
- declare type RiskLevel_2 = "safe" | "low" | "medium" | "high" | "critical" | "unknown";
5184
-
5185
5126
  /**
5186
5127
  * Run a full conversation agent-loop turn: persist the user message, execute
5187
5128
  * the agent loop (history, tools, compaction, injections), and return the
@@ -5615,14 +5556,6 @@ declare interface SignBundlePayloadRequest {
5615
5556
  payload: string;
5616
5557
  }
5617
5558
 
5618
- declare interface SkillBodyResponse {
5619
- type: "skill_detail_response";
5620
- skillId: string;
5621
- body: string;
5622
- icon?: string;
5623
- error?: string;
5624
- }
5625
-
5626
5559
  declare interface SkillInstallMeta {
5627
5560
  origin: "vellum" | "clawhub" | "skillssh" | "custom";
5628
5561
  installedAt: string;
@@ -5638,61 +5571,6 @@ declare interface SkillInstallMeta {
5638
5571
  lastUsedAt?: string;
5639
5572
  }
5640
5573
 
5641
- declare interface SkillsDraftResponse {
5642
- type: "skills_draft_response";
5643
- success: boolean;
5644
- draft?: {
5645
- skillId: string;
5646
- name: string;
5647
- description: string;
5648
- emoji?: string;
5649
- bodyMarkdown: string;
5650
- };
5651
- warnings?: string[];
5652
- error?: string;
5653
- }
5654
-
5655
- declare interface SkillsInspectResponse {
5656
- type: "skills_inspect_response";
5657
- slug: string;
5658
- data?: {
5659
- skill: {
5660
- slug: string;
5661
- displayName: string;
5662
- summary: string;
5663
- };
5664
- owner?: {
5665
- handle: string;
5666
- displayName: string;
5667
- image?: string;
5668
- } | null;
5669
- stats?: {
5670
- stars: number;
5671
- installs: number;
5672
- downloads: number;
5673
- versions: number;
5674
- } | null;
5675
- createdAt?: number | null;
5676
- updatedAt?: number | null;
5677
- latestVersion?: {
5678
- version: string;
5679
- changelog?: string;
5680
- } | null;
5681
- files?: Array<{
5682
- path: string;
5683
- size: number;
5684
- contentType?: string;
5685
- }> | null;
5686
- skillMdContent?: string | null;
5687
- };
5688
- error?: string;
5689
- }
5690
-
5691
- declare interface SkillsListResponse {
5692
- type: "skills_list_response";
5693
- skills: SlimSkillResponse[];
5694
- }
5695
-
5696
5574
  /**
5697
5575
  * Origin of a skill in the merged catalog.
5698
5576
  *
@@ -5707,21 +5585,20 @@ declare interface SkillsListResponse {
5707
5585
  */
5708
5586
  declare type SkillSource = "bundled" | "managed" | "workspace" | "extra" | "plugin";
5709
5587
 
5710
- declare type _SkillsServerMessages = SkillsListResponse | SkillBodyResponse | SkillStateChanged | SkillsInspectResponse | SkillsDraftResponse;
5588
+ declare type _SkillsServerMessages = SkillStateChangedEvent;
5711
5589
 
5712
- declare interface SkillsshSlimSkill extends SlimSkillBase {
5713
- origin: "skillssh";
5714
- slug: string;
5715
- sourceRepo: string;
5716
- installs: number;
5717
- audit?: Record<string, PartnerAudit>;
5718
- }
5590
+ declare type SkillStateChangedEvent = z.infer<typeof SkillStateChangedEventSchema>;
5719
5591
 
5720
- declare interface SkillStateChanged {
5721
- type: "skills_state_changed";
5722
- name: string;
5723
- state: "enabled" | "disabled" | "installed" | "uninstalled";
5724
- }
5592
+ declare const SkillStateChangedEventSchema: z.ZodObject<{
5593
+ type: z.ZodLiteral<"skills_state_changed">;
5594
+ name: z.ZodString;
5595
+ state: z.ZodEnum<{
5596
+ enabled: "enabled";
5597
+ disabled: "disabled";
5598
+ installed: "installed";
5599
+ uninstalled: "uninstalled";
5600
+ }>;
5601
+ }, z.core.$strip>;
5725
5602
 
5726
5603
  declare interface SlackWebhookConfigResponse {
5727
5604
  type: "slack_webhook_config_response";
@@ -5730,27 +5607,6 @@ declare interface SlackWebhookConfigResponse {
5730
5607
  error?: string;
5731
5608
  }
5732
5609
 
5733
- /** Fields shared by all skill origins. */
5734
- declare interface SlimSkillBase {
5735
- id: string;
5736
- name: string;
5737
- description: string;
5738
- icon?: string;
5739
- emoji?: string;
5740
- kind: "bundled" | "installed" | "catalog";
5741
- status: "enabled" | "disabled" | "available";
5742
- category: string;
5743
- /**
5744
- * Extension that ships this skill, reusing the tool registry's
5745
- * {@link OwnerInfo} model. Set for plugin-resident skills as
5746
- * `{ kind: "plugin", id: <plugin dir name> }` so clients can attribute
5747
- * them to the owning plugin instead of collapsing to their `kind`/`origin`.
5748
- */
5749
- owner?: OwnerInfo;
5750
- }
5751
-
5752
- declare type SlimSkillResponse = VellumSlimSkill | ClawhubSlimSkill | SkillsshSlimSkill | CustomSlimSkill | AssistantMemorySlimSkill;
5753
-
5754
5610
  declare type SoundsConfigUpdatedEvent = z.infer<typeof SoundsConfigUpdatedEventSchema>;
5755
5611
 
5756
5612
  declare const SoundsConfigUpdatedEventSchema: z.ZodObject<{
@@ -6030,11 +5886,11 @@ declare const SubagentStatusChangedEventSchema: z.ZodObject<{
6030
5886
  type: z.ZodLiteral<"subagent_status_changed">;
6031
5887
  subagentId: z.ZodString;
6032
5888
  status: z.ZodEnum<{
6033
- pending: "pending";
6034
- failed: "failed";
6035
- aborted: "aborted";
6036
5889
  completed: "completed";
5890
+ failed: "failed";
6037
5891
  running: "running";
5892
+ aborted: "aborted";
5893
+ pending: "pending";
6038
5894
  awaiting_input: "awaiting_input";
6039
5895
  interrupted: "interrupted";
6040
5896
  }>;
@@ -6109,13 +5965,13 @@ declare type SurfaceType = z.infer<typeof SurfaceTypeSchema>;
6109
5965
 
6110
5966
  declare const SurfaceTypeSchema: z.ZodEnum<{
6111
5967
  table: "table";
6112
- form: "form";
6113
- list: "list";
6114
5968
  card: "card";
6115
5969
  channel_setup: "channel_setup";
6116
5970
  choice: "choice";
6117
5971
  copy_block: "copy_block";
6118
5972
  oauth_connect: "oauth_connect";
5973
+ form: "form";
5974
+ list: "list";
6119
5975
  confirmation: "confirmation";
6120
5976
  dynamic_page: "dynamic_page";
6121
5977
  file_upload: "file_upload";
@@ -7196,10 +7052,6 @@ declare interface UserPromptSubmitInputContext {
7196
7052
  latestMessages: Message[];
7197
7053
  }
7198
7054
 
7199
- declare interface VellumSlimSkill extends SlimSkillBase {
7200
- origin: "vellum";
7201
- }
7202
-
7203
7055
  declare interface VercelApiConfigResponse {
7204
7056
  type: "vercel_api_config_response";
7205
7057
  hasToken: boolean;
@@ -7272,10 +7124,10 @@ declare const WorkflowCompletedEventSchema: z.ZodObject<{
7272
7124
  runId: z.ZodString;
7273
7125
  conversationId: z.ZodOptional<z.ZodString>;
7274
7126
  status: z.ZodEnum<{
7275
- failed: "failed";
7276
- aborted: "aborted";
7277
7127
  completed: "completed";
7128
+ failed: "failed";
7278
7129
  running: "running";
7130
+ aborted: "aborted";
7279
7131
  interrupted: "interrupted";
7280
7132
  cap_exceeded: "cap_exceeded";
7281
7133
  }>;
@@ -7293,8 +7145,8 @@ declare const WorkflowLeafFinishedEventSchema: z.ZodObject<{
7293
7145
  conversationId: z.ZodString;
7294
7146
  seq: z.ZodNumber;
7295
7147
  status: z.ZodEnum<{
7296
- failed: "failed";
7297
7148
  completed: "completed";
7149
+ failed: "failed";
7298
7150
  }>;
7299
7151
  label: z.ZodOptional<z.ZodString>;
7300
7152
  inputTokens: z.ZodOptional<z.ZodNumber>;
@@ -7343,10 +7195,10 @@ declare type WorkResultSurfaceData = z.infer<typeof WorkResultSurfaceDataSchema>
7343
7195
  declare const WorkResultSurfaceDataSchema: z.ZodObject<{
7344
7196
  eyebrow: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7345
7197
  status: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
7198
+ completed: "completed";
7346
7199
  failed: "failed";
7347
7200
  partial: "partial";
7348
7201
  in_progress: "in_progress";
7349
- completed: "completed";
7350
7202
  }>>>;
7351
7203
  summary: z.ZodCatch<z.ZodOptional<z.ZodString>>;
7352
7204
  metrics: z.ZodCatch<z.ZodOptional<z.ZodPipe<z.ZodTransform<Record<string, unknown>[], unknown>, z.ZodArray<z.ZodObject<{
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vellumai/plugin-api",
3
- "version": "0.10.11-dev.202607231450.b516b22",
3
+ "version": "0.10.11-dev.202607231649.18b8bbb",
4
4
  "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
5
5
  "license": "MIT",
6
6
  "type": "module",