lumiverse-spindle-types 0.4.32 → 0.4.34

package/package.json

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

package/src/api.ts

@@ -1280,10 +1280,20 @@ export type WorkerToHost =
   | { type: "frontend_message"; payload: unknown; userId?: string }
   | { type: "user_storage_read"; requestId: string; path: string; userId?: string }
   | { type: "user_storage_write"; requestId: string; path: string; data: string; userId?: string }
+  | { type: "user_storage_read_binary"; requestId: string; path: string; userId?: string }
+  | {
+      type: "user_storage_write_binary";
+      requestId: string;
+      path: string;
+      data: Uint8Array;
+      userId?: string;
+    }
   | { type: "user_storage_delete"; requestId: string; path: string; userId?: string }
   | { type: "user_storage_list"; requestId: string; prefix?: string; userId?: string }
   | { type: "user_storage_exists"; requestId: string; path: string; userId?: string }
   | { type: "user_storage_mkdir"; requestId: string; path: string; userId?: string }
+  | { type: "user_storage_move"; requestId: string; from: string; to: string; userId?: string }
+  | { type: "user_storage_stat"; requestId: string; path: string; userId?: string }
   | { type: "enclave_put"; requestId: string; key: string; value: string; userId?: string }
   | { type: "enclave_get"; requestId: string; key: string; userId?: string }
   | { type: "enclave_delete"; requestId: string; key: string; userId?: string }

package/src/council.ts

@@ -161,16 +161,32 @@ export type CouncilToolCategory =
   | "content"
   | "extension";
 
+export type CouncilToolExecution =
+  | "llm"
+  | "host"
+  | "extension"
+  | "mcp";
+
 /** Canonical definition of a council tool (built-in or DLC). */
 export interface CouncilToolDefinition {
   name: string;
   displayName: string;
   description: string;
   category: CouncilToolCategory;
-  /** The prompt sent to the sidecar LLM when invoking this tool. */
-  prompt: string;
-  /** JSON Schema describing the tool's expected output structure. */
-  inputSchema: Record<string, unknown>;
+  /** Optional explicit runtime. When omitted, the host may infer one from the tool source. */
+  execution?: CouncilToolExecution;
+  /** The prompt sent to the sidecar LLM when invoking prompt-style LLM tools. */
+  prompt?: string;
+  /**
+   * JSON Schema describing the prompt-style tool's expected output structure.
+   *
+   * Historically this field was also used as the callable argument schema for
+   * extension / MCP tools. New host-callable tools should prefer `argsSchema`
+   * instead so invocation arguments and returned content are not conflated.
+   */
+  inputSchema?: Record<string, unknown>;
+  /** JSON Schema describing the callable arguments for host / extension / MCP tools. */
+  argsSchema?: Record<string, unknown>;
   /** If set, the tool's result is stored under this variable name for macro access. */
   resultVariable?: string;
   /** Whether this tool's output appears in the deliberation block (default true). */

package/src/index.ts

@@ -132,6 +132,7 @@ export type {
   CouncilExecutionResult,
   CachedCouncilResult,
   CouncilToolCategory,
+  CouncilToolExecution,
   CouncilToolDefinition,
 } from "./council";
 export {

package/src/spindle-api.ts

@@ -255,10 +255,20 @@ export interface SpindleAPI {
   userStorage: {
     read(path: string, userId?: string): Promise<string>;
     write(path: string, data: string, userId?: string): Promise<void>;
+    readBinary(path: string, userId?: string): Promise<Uint8Array>;
+    writeBinary(path: string, data: Uint8Array, userId?: string): Promise<void>;
     delete(path: string, userId?: string): Promise<void>;
     list(prefix?: string, userId?: string): Promise<string[]>;
     exists(path: string, userId?: string): Promise<boolean>;
     mkdir(path: string, userId?: string): Promise<void>;
+    move(from: string, to: string, userId?: string): Promise<void>;
+    stat(path: string, userId?: string): Promise<{
+      exists: boolean;
+      isFile: boolean;
+      isDirectory: boolean;
+      sizeBytes: number;
+      modifiedAt: string;
+    }>;
     getJson<T>(path: string, options?: { fallback?: T; userId?: string }): Promise<T>;
     setJson(path: string, value: unknown, options?: { indent?: number; userId?: string }): Promise<void>;
   };