lumiverse-spindle-types 0.6.44 → 0.6.45

package/dist/api.d.ts

@@ -3333,7 +3333,7 @@ export interface ProviderManager {
         key: ProviderKeyDTO;
     }) => void): () => void;
 }
-export type WorkerToHost = import("./file-transfers.js").FileTransferWorkerMessage | import("./desktop-capture.js").DesktopCaptureWorkerMessage | {
+export type WorkerToHost = import("./decisions.js").DecisionWorkerMessage | import("./file-transfers.js").FileTransferWorkerMessage | import("./desktop-capture.js").DesktopCaptureWorkerMessage | {
     type: "subscribe_event";
     event: string;
 } | {

package/dist/decisions.d.ts

@@ -0,0 +1,143 @@
+/** Native typed Decision API. Requires decisions permission and decisions-v1 host capability. */
+export type DecisionJsonValue = null | boolean | number | string | DecisionJsonValue[] | {
+    [key: string]: DecisionJsonValue;
+};
+export type DecisionDescription = string | DecisionJsonValue[] | {
+    [key: string]: DecisionJsonValue;
+};
+export type DecisionState = DecisionDescription;
+export type DecisionQuestion = {
+    type: "choice";
+    instructions: DecisionDescription;
+    criteria: Record<string, DecisionDescription | null>;
+} | {
+    type: "score";
+    instructions: DecisionDescription;
+    criteria: DecisionDescription[];
+} | {
+    type: "noul";
+    instructions: DecisionDescription;
+    criteria?: {
+        true: DecisionDescription;
+        false: DecisionDescription;
+    };
+};
+export type DecisionAnswer = {
+    type: "choice";
+    choice: string;
+    probabilities: Record<string, number>;
+    confidence: number;
+} | {
+    type: "score";
+    score: number;
+    probabilities: Record<string, number>;
+    confidence: number;
+    legend: Record<string, DecisionDescription>;
+} | {
+    type: "noul";
+    noul: number;
+};
+export type DecisionAnswerFor<Q extends DecisionQuestion> = Q extends {
+    type: "choice";
+    criteria: infer C;
+} ? Omit<Extract<DecisionAnswer, {
+    type: "choice";
+}>, "choice" | "probabilities"> & {
+    choice: Extract<keyof C, string>;
+    probabilities: Record<Extract<keyof C, string>, number>;
+} : Q extends {
+    type: "score";
+} ? Extract<DecisionAnswer, {
+    type: "score";
+}> : Extract<DecisionAnswer, {
+    type: "noul";
+}>;
+export type DecisionAnswers<Q extends Record<string, DecisionQuestion>> = {
+    [K in keyof Q]: DecisionAnswerFor<Q[K]>;
+};
+export interface DecisionResult<Q extends Record<string, DecisionQuestion> = Record<string, DecisionQuestion>> {
+    model: string;
+    answers: DecisionAnswers<Q>;
+    usage?: {
+        input_tokens?: number | null;
+        output_tokens?: number | null;
+        cost?: number | null;
+        [key: string]: unknown;
+    };
+    id?: string;
+    provider?: string;
+}
+export interface DecisionEvaluationInput<Q extends Record<string, DecisionQuestion> = Record<string, DecisionQuestion>> {
+    connection_id?: string;
+    model?: string;
+    state: DecisionState;
+    questions: Q;
+    userId?: string;
+}
+export interface DecisionConnectionProfileDTO {
+    id: string;
+    name: string;
+    provider: string;
+    api_url: string;
+    model: string;
+    is_default: boolean;
+    has_api_key: boolean;
+    default_parameters: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    created_at: number;
+    updated_at: number;
+}
+export interface DecisionModelDTO {
+    id: string;
+    label: string;
+    description?: string;
+    input_modalities?: string[];
+    output_modalities?: string[];
+    context_length?: number;
+    pricing?: Record<string, string>;
+    protocol: "supported" | "unsupported" | "unverified";
+}
+export interface DecisionProviderDTO {
+    id: string;
+    name: string;
+    capabilities: {
+        apiKeyRequired: boolean;
+        defaultUrl: string;
+        suggestedModel: string;
+        modelListStyle: "dynamic";
+    };
+}
+export interface SpindleDecisionsAPI {
+    listProviders(options?: {
+        userId?: string;
+    }): Promise<DecisionProviderDTO[]>;
+    listConnections(options?: {
+        userId?: string;
+    }): Promise<DecisionConnectionProfileDTO[]>;
+    getConnection(id: string, options?: {
+        userId?: string;
+    }): Promise<DecisionConnectionProfileDTO | null>;
+    getModels(id: string, options?: {
+        userId?: string;
+    }): Promise<DecisionModelDTO[]>;
+    evaluate<const Q extends Record<string, DecisionQuestion>>(input: DecisionEvaluationInput<Q>, options?: {
+        signal?: AbortSignal;
+    }): Promise<DecisionResult<Q>>;
+}
+export type DecisionWorkerMessage = {
+    type: "decisions_providers" | "decisions_connections_list";
+    requestId: string;
+    userId?: string;
+} | {
+    type: "decisions_connection_get" | "decisions_models";
+    requestId: string;
+    connectionId: string;
+    userId?: string;
+} | {
+    type: "decisions_evaluate";
+    requestId: string;
+    input: DecisionEvaluationInput;
+} | {
+    type: "decisions_cancel";
+    requestId: string;
+};

package/dist/decisions.js

@@ -0,0 +1 @@
+export {};

package/dist/host.js

@@ -11,6 +11,7 @@ export const SPINDLE_HOST_CAPABILITIES = Object.freeze({
     "frontend-extensibility-v2": 1,
     "frontend-runtime-capabilities-v1": 1,
     "mcp-servers-v1": 1,
+    "decisions-v1": 1,
     "file-transfers-v1": 1,
 });
 /** Structured error code returned when host compatibility validation fails. */

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export type { DecisionJsonValue, DecisionDescription, DecisionState, DecisionQuestion, DecisionAnswer, DecisionAnswerFor, DecisionAnswers, DecisionResult, DecisionEvaluationInput, DecisionConnectionProfileDTO, DecisionModelDTO, DecisionProviderDTO, SpindleDecisionsAPI, DecisionWorkerMessage } from "./decisions.js";
 export type { SpindleManifest, SpindlePermission, SpindleCapability, } from "./manifest.js";
 export { IDENTIFIER_PATTERN, validateIdentifier, } from "./manifest.js";
 export type { SpindleHostDescriptorV1, SpindleHostLocale, SpindleHostLocaleAPI, } from "./host.js";

package/dist/permissions.d.ts

@@ -4,6 +4,7 @@
  * Free tier (no declaration needed): events, storage, macros, dom, variables
  *
  * Gated tier (must declare):
+ * - "decisions"            — inspect and invoke saved Decision model connections
  * - "generation"           — fire generations on behalf of user
  * - "interceptor"          — pre-generation prompt modification
  * - "tools"                — register LLM tools
@@ -41,6 +42,6 @@
  *                            device is playing (never samples), desktop client only. Privileged;
  *                            the host asks the user on every start.
  */
-export type SpindlePermission = "screen_capture" | "screen_recording" | "system_audio" | "generation" | "interceptor" | "tools" | "cors_proxy" | "context_handler" | "ephemeral_storage" | "chat_mutation" | "event_tracking" | "ui_panels" | "app_manipulation" | "oauth" | "characters" | "chats" | "presets" | "world_books" | "regex_scripts" | "regex_scripts_unrestricted" | "databanks" | "memories" | "media" | "personas" | "push_notification" | "image_gen" | "images" | "generation_parameters" | "macro_interceptor" | "web_search" | "unsafe_eval" | "final_response" | "providers.embedding.register" | "providers.tts.register" | "providers.stt.register" | "providers.sidecar.register" | "mcp_servers" | "mcp_servers.create";
+export type SpindlePermission = "screen_capture" | "screen_recording" | "system_audio" | "generation" | "interceptor" | "tools" | "cors_proxy" | "context_handler" | "ephemeral_storage" | "chat_mutation" | "event_tracking" | "ui_panels" | "app_manipulation" | "oauth" | "characters" | "chats" | "presets" | "world_books" | "regex_scripts" | "regex_scripts_unrestricted" | "databanks" | "memories" | "media" | "personas" | "push_notification" | "decisions" | "image_gen" | "images" | "generation_parameters" | "macro_interceptor" | "web_search" | "unsafe_eval" | "final_response" | "providers.embedding.register" | "providers.tts.register" | "providers.stt.register" | "providers.sidecar.register" | "mcp_servers" | "mcp_servers.create";
 export declare const ALL_PERMISSIONS: readonly SpindlePermission[];
 export declare function isValidPermission(p: string): p is SpindlePermission;

package/dist/permissions.js

@@ -24,6 +24,7 @@ export const ALL_PERMISSIONS = [
     "media",
     "personas",
     "push_notification",
+    "decisions",
     "image_gen",
     "images",
     "generation_parameters",

package/dist/spindle-api.d.ts

@@ -134,6 +134,8 @@ export interface SpindleConnectionsAPI {
 }
 /** The global `spindle` object available in backend extension workers */
 export interface SpindleAPI {
+    /** Typed Decision models (permission: decisions; host capability: decisions-v1). */
+    decisions: import("./decisions.js").SpindleDecisionsAPI;
     /** Disk-backed downloads and bounded reads/writes. Available with file-transfers-v1. */
     readonly files: SpindleFilesAPI;
     /** Streaming ZIP64 creation and validated disk-backed extraction. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.6.44",
+  "version": "0.6.45",
   "type": "module",
   "types": "./dist/index.d.ts",
   "keywords": [
@@ -26,6 +26,7 @@
     }
   },
   "scripts": {
+    "prepack": "npm run build",
     "build": "tsc -p tsconfig.json",
     "build:consumer": "tsc -p tsconfig.consumer.json --noEmit && node test/scripts/verify-packed-consumer.mjs",
     "test": "bun test"