lumiverse-spindle-types 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/api.ts

@@ -25,11 +25,30 @@ export interface ToolRegistrationDTO {
   council_eligible?: boolean;
 }
 
+/** Tool/function schema passed to LLM for inline function calling. */
+export interface ToolSchemaDTO {
+  name: string;
+  description: string;
+  parameters: Record<string, unknown>; // JSON Schema
+}
+
+/** A single function call made by the LLM. */
+export interface ToolCallDTO {
+  /** Tool name (as given in the schema). */
+  name: string;
+  /** Parsed JSON arguments as returned by the LLM. */
+  args: Record<string, unknown>;
+  /** Provider call ID (e.g. Anthropic `id`, OpenAI `id`). Synthetic UUID for providers that don't supply one (e.g. Google). */
+  call_id: string;
+}
+
 export interface GenerationRequestDTO {
   type: "raw" | "quiet" | "batch";
   messages?: LlmMessageDTO[];
   parameters?: Record<string, unknown>;
   connection_id?: string;
+  /** Optional tool/function definitions for inline function calling (raw/quiet only). */
+  tools?: ToolSchemaDTO[];
   /**
    * For operator-scoped extensions: the user ID whose connection profiles
    * and generation context should be used. For user-scoped extensions this
@@ -618,7 +637,10 @@ export type WorkerToHost =
   // ─── Chat Memories (gated: "chats") ───────────────────────────────
   | { type: "chats_get_memories"; requestId: string; chatId: string; topK?: number; userId?: string }
   // ─── Toast (free tier) ───────────────────────────────────────────────
-  | { type: "toast_show"; toastType: "success" | "warning" | "error" | "info"; message: string; title?: string; duration?: number };
+  | { type: "toast_show"; toastType: "success" | "warning" | "error" | "info"; message: string; title?: string; duration?: number }
+  // ─── Push Notifications (gated: "push_notification") ────────────────
+  | { type: "push_send"; requestId: string; title: string; body: string; tag?: string; url?: string; userId?: string }
+  | { type: "push_get_status"; requestId: string; userId?: string };
 
 // ─── Host → Worker messages ──────────────────────────────────────────────
 

package/src/index.ts

@@ -16,6 +16,8 @@ export type {
   LlmMessageDTO,
   MacroDefinitionDTO,
   ToolRegistrationDTO,
+  ToolSchemaDTO,
+  ToolCallDTO,
   GenerationRequestDTO,
   RequestInitDTO,
   ConnectionProfileDTO,

package/src/permissions.ts

@@ -28,7 +28,8 @@ export type SpindlePermission =
   | "characters"
   | "chats"
   | "world_books"
-  | "personas";
+  | "personas"
+  | "push_notification";
 
 export const ALL_PERMISSIONS: readonly SpindlePermission[] = [
   "generation",
@@ -46,6 +47,7 @@ export const ALL_PERMISSIONS: readonly SpindlePermission[] = [
   "chats",
   "world_books",
   "personas",
+  "push_notification",
 ] as const;
 
 export function isValidPermission(p: string): p is SpindlePermission {

package/src/spindle-api.ts

@@ -376,6 +376,32 @@ export interface SpindleAPI {
     error(msg: string): void;
   };
 
+  /**
+   * Push notifications (permission: "push_notification").
+   * Send OS-level push notifications to users and check push status.
+   * Notifications are attributed to your extension name.
+   */
+  push: {
+    /**
+     * Send a push notification to a user's registered devices.
+     * Only delivered when the app is not focused (avoids double-notification).
+     */
+    send(input: {
+      title: string;
+      body: string;
+      tag?: string;
+      url?: string;
+    }, userId?: string): Promise<{ sent: number }>;
+    /**
+     * Check if push notifications are available for a user.
+     * Returns subscription count and whether the push system is active.
+     */
+    getStatus(userId?: string): Promise<{
+      available: boolean;
+      subscriptionCount: number;
+    }>;
+  };
+
   /** Show toast notifications in the frontend UI (free tier — no permission needed) */
   toast: {
     success(message: string, options?: { title?: string; duration?: number }): void;