@vellumai/plugin-api 0.12.2-staging.6 → 0.12.2-staging.7

package/index.d.ts

@@ -1661,6 +1661,8 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
         type: z.ZodLiteral<"conversation_title_updated">;
         conversationId: z.ZodString;
         title: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"desktop_activity_changed">;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"disk_pressure_status_changed">;
         status: z.ZodObject<{
@@ -3204,6 +3206,8 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"conversation_title_updated">;
     conversationId: z.ZodString;
     title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"desktop_activity_changed">;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"disk_pressure_status_changed">;
     status: z.ZodObject<{
@@ -4767,6 +4771,12 @@ export declare function getConversationDirPath(id: string, createdAtMs: number):
  */
 export declare function getConversationProcessingStartedAt(id: string): Promise<number | null>;
 
+/**
+ * The tool definitions the conversation's most recent live turn sent to the
+ * provider, or `null` when none has been recorded.
+ */
+export declare function getConversationToolSurface(conversationId: string): Promise<ToolDefinition_2[] | null>;
+
 /** Fetch one document from the calling plugin's index, or null. */
 export declare function getDocument(documentId: string): Promise<IndexedDocument | null>;
 
@@ -5896,6 +5906,11 @@ export declare interface PluginLogger {
     debug(obj: Record<string, unknown>, msg?: string): void;
 }
 
+export declare class PluginTurnNotAdmittedError extends Error {
+    readonly reason: string;
+    constructor(reason: string);
+}
+
 /**
  * The full `post-compact` context a hook receives — the dispatching call
  * site's {@link PostCompactInputContext} plus the pipeline-stamped
@@ -6780,6 +6795,23 @@ export declare interface RunConversationTurnResult {
     queued?: boolean;
 }
 
+/**
+ * Slice a string like `String.prototype.slice`, but never cut a UTF-16
+ * surrogate pair in half.
+ *
+ * If the character at `end - 1` is a high surrogate *and* there is more of
+ * the string beyond `end` (so cutting would actually orphan it), `end` is
+ * decremented by one.
+ *
+ * If the character at `start` is a low surrogate *and* `start > 0` (so we
+ * would be starting mid-pair), `start` is incremented by one.
+ *
+ * When `end === str.length` we do not touch a trailing high surrogate: if it
+ * was already orphaned upstream, repairing it here would silently mutate
+ * content. That is the sanitizer's job, not this function's.
+ */
+export declare function safeStringSlice(str: string, start?: number, end?: number): string;
+
 /** Sparse lexical search over stored message text; ranked message-id hits. */
 export declare function searchMessageIdsLexical(query: string, limit: number, opts?: {
     conversationId?: string;

package/index.js

@@ -5,6 +5,7 @@ export const CredentialResolutionError = api.CredentialResolutionError;
 export const CredentialStoreError = api.CredentialStoreError;
 export const HOOKS = api.HOOKS;
 export const INTERNAL_NUDGE_OUTPUT_SUPPRESSION = api.INTERNAL_NUDGE_OUTPUT_SUPPRESSION;
+export const PluginTurnNotAdmittedError = api.PluginTurnNotAdmittedError;
 export const REFUSAL_FALLBACK_TEXT = api.REFUSAL_FALLBACK_TEXT;
 export const RiskLevel = api.RiskLevel;
 export const TtsSynthesisError = api.TtsSynthesisError;
@@ -25,6 +26,7 @@ export const getConfiguredProvider = api.getConfiguredProvider;
 export const getConversation = api.getConversation;
 export const getConversationDirPath = api.getConversationDirPath;
 export const getConversationProcessingStartedAt = api.getConversationProcessingStartedAt;
+export const getConversationToolSurface = api.getConversationToolSurface;
 export const getDocument = api.getDocument;
 export const getMessages = api.getMessages;
 export const getModelProfiles = api.getModelProfiles;
@@ -54,6 +56,7 @@ export const resolveOauthCallbackUrl = api.resolveOauthCallbackUrl;
 export const resolveUserName = api.resolveUserName;
 export const resolveWebhookUrl = api.resolveWebhookUrl;
 export const runConversationTurn = api.runConversationTurn;
+export const safeStringSlice = api.safeStringSlice;
 export const searchMessageIdsLexical = api.searchMessageIdsLexical;
 export const selectedBackendSupportsMultimodal = api.selectedBackendSupportsMultimodal;
 export const storeCredential = api.storeCredential;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.12.2-staging.6",
+  "version": "0.12.2-staging.7",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",