@zaflun/lumio-agent-skill 0.1.0 → 0.2.0

package/dist/bin/lumio-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   installSkillFiles
-} from "../chunk-I2USQPPS.js";
+} from "../chunk-5NNQDQNL.js";
 
 // src/bin/lumio-skills.ts
 import { resolve } from "path";

package/dist/{chunk-I2USQPPS.js → chunk-5NNQDQNL.js}

@@ -61,9 +61,8 @@ All three surfaces share storage via \`useExtensionStorage()\` \u2014 changes in
 
 \`\`\`json
 {
-  "$schema": "https://docs.lumio.vision/schemas/lumio.config.schema.json",
+  "$schema": "https://lumio.vision/schemas/lumio.config.schema.json",
   "extensionId": "uuid",
-  "slug": "k8f2x-my-extension",
   "name": "My Extension",
   "description": "Description",
   "category": "widget",
@@ -77,12 +76,10 @@ All three surfaces share storage via \`useExtensionStorage()\` \u2014 changes in
   },
   "visibility": "public",
   "pricing": { "type": "free" },
-  "config_schema": {
-    "fields": [
-      { "key": "title", "type": "string", "label": "Widget Title", "default": "My Widget" },
-      { "key": "showBorder", "type": "boolean", "label": "Show Border", "default": true }
-    ]
-  }
+  "config_schema": [
+    { "key": "title", "type": "string", "label": "Widget Title", "default_value": "My Widget", "required": true },
+    { "key": "showBorder", "type": "boolean", "label": "Show Border", "default_value": true, "required": false }
+  ]
 }
 \`\`\`
 
@@ -164,7 +161,7 @@ See \`components.md\` for full props and examples.
 | \`useLumioConfig()\` | \`[config, setConfig]\` | Extension config read/write (uses config_schema fields) |
 | \`useLumioTheme()\` | \`theme\` | Current theme (dark/light/custom) |
 | \`useLumioIdentity()\` | \`{ userId, accountId, role }\` | Current user context |
-| \`useLumioAction(action, params)\` | \`{ execute, data, isLoading, error }\` | Trigger Lumio actions \u2014 type-safe: \`action\` is \`LumioActionType\` |
+| \`useLumioAction(action)\` | \`{ execute, data, isLoading, error }\` | Trigger Lumio actions \u2014 type-safe: \`action\` is \`LumioActionType\` |
 | \`useQuery(fn, params?)\` | \`{ data, isLoading, error, refetch }\` | Call server query |
 | \`useMutation(fn)\` | \`{ mutate, mutateAsync, data, isLoading, error }\` | Call server mutation/action |
 | \`useAnimation(preset, options?)\` | \`animationProps\` | SDK animation presets for \`Animated\` component |
@@ -200,23 +197,23 @@ export const fetchScores = action({
 **Extension Actions** via \`useLumioAction()\` (21 total, \`action\` is \`LumioActionType\`):
 \`\`\`tsx
 // Trigger platform actions (requires matching permission in lumio.config.json)
-const { execute: sendChat } = useLumioAction("chat:send", {});
-const { execute: banUser } = useLumioAction("chat:ban", {});
-const { execute: unbanUser } = useLumioAction("chat:unban", {});
-const { execute: timeoutUser } = useLumioAction("chat:timeout", {});
-const { execute: setScene } = useLumioAction("obs:set_scene", {});
-const { execute: startRecording } = useLumioAction("obs:start_recording", {});
-const { execute: stopRecording } = useLumioAction("obs:stop_recording", {});
-const { execute: emitEvent } = useLumioAction("events:emit", {});
-const { execute: updateLayer } = useLumioAction("overlay:update_layer", {});
-const { execute: spotifyPlay } = useLumioAction("spotify:play", {});
-const { execute: spotifyPause } = useLumioAction("spotify:pause", {});
-const { execute: spotifySkip } = useLumioAction("spotify:skip", {});
-const { execute: spotifySeek } = useLumioAction("spotify:seek", {});
-const { execute: spotifyVolume } = useLumioAction("spotify:volume", {});
-const { execute: spotifyShuffle } = useLumioAction("spotify:shuffle", {});
-const { execute: spotifyRepeat } = useLumioAction("spotify:repeat", {});
-const { execute: spotifyQueueAdd } = useLumioAction("spotify:queue_add", {});
+const { execute: sendChat } = useLumioAction("chat:send");
+const { execute: banUser } = useLumioAction("chat:ban");
+const { execute: unbanUser } = useLumioAction("chat:unban");
+const { execute: timeoutUser } = useLumioAction("chat:timeout");
+const { execute: setScene } = useLumioAction("obs:set_scene");
+const { execute: startRecording } = useLumioAction("obs:start_recording");
+const { execute: stopRecording } = useLumioAction("obs:stop_recording");
+const { execute: emitEvent } = useLumioAction("events:emit");
+const { execute: updateLayer } = useLumioAction("overlay:update_layer");
+const { execute: spotifyPlay } = useLumioAction("spotify:play");
+const { execute: spotifyPause } = useLumioAction("spotify:pause");
+const { execute: spotifySkip } = useLumioAction("spotify:skip");
+const { execute: spotifySeek } = useLumioAction("spotify:seek");
+const { execute: spotifyVolume } = useLumioAction("spotify:volume");
+const { execute: spotifyShuffle } = useLumioAction("spotify:shuffle");
+const { execute: spotifyRepeat } = useLumioAction("spotify:repeat");
+const { execute: spotifyQueueAdd } = useLumioAction("spotify:queue_add");
 \`\`\`
 
 See \`server-functions.md\` for schema definition, storage scoping, and advanced patterns.
@@ -307,7 +304,7 @@ addItem({ text: "New item" });
 
 ### Lumio actions
 \`\`\`tsx
-const { execute } = useLumioAction("chat:send", {});
+const { execute } = useLumioAction("chat:send");
 execute({ message: "Hello from my extension!" });
 \`\`\`
 
@@ -775,15 +772,12 @@ For complex logic that cannot be expressed declaratively. Runs in V8 isolate san
 \`\`\`typescript
 import { query, mutation, action, v } from "@zaflun/lumio-sdk/server";
 
-// Read-only query
-export const getLeaderboard = query({
-  args: { limit: v.number().optional() },
+// Read-only query \u2014 look up a single row by ID
+export const getScore = query({
+  args: { id: v.string() },
   handler: async (ctx, args) => {
-    const rows = await ctx.db.get("scores", {
-      order: { score: "desc" },
-      limit: args.limit ?? 10,
-    });
-    return rows;
+    const row = await ctx.db.get("scores", args.id);
+    return row;
   },
 });
 
@@ -820,7 +814,7 @@ Handler-based functions run inside a V8 isolate Web Worker. The \`ctx\` object p
 
 | Property | Description |
 |----------|-------------|
-| \`ctx.db.get(table, options?)\` | Read rows from extension DB schema |
+| \`ctx.db.get(table, id)\` | Read a single row by ID from extension DB schema |
 | \`ctx.db.insert(table, data)\` | Insert row |
 | \`ctx.db.patch(table, id, data)\` | Update row |
 | \`ctx.db.delete(table, id)\` | Delete row |
@@ -856,19 +850,19 @@ Extension Actions let extensions trigger Lumio platform capabilities on behalf o
 import { useLumioAction } from "@zaflun/lumio-sdk";
 
 // Send a chat message on the connected platform
-const { execute: sendChat, isLoading, error } = useLumioAction("chat:send", {});
+const { execute: sendChat, isLoading, error } = useLumioAction("chat:send");
 sendChat({ message: "Hello from the extension!" });
 
 // Switch OBS scene (requires OBS WebSocket integration)
-const { execute: setScene } = useLumioAction("obs:set_scene", {});
+const { execute: setScene } = useLumioAction("obs:set_scene");
 setScene({ sceneName: "Main Scene" });
 
 // Emit a custom event into the Lumio event bus
-const { execute: emitEvent } = useLumioAction("events:emit", {});
+const { execute: emitEvent } = useLumioAction("events:emit");
 emitEvent({ type: "extension:custom", payload: { score: 42 } });
 
 // Update a specific layer in the overlay
-const { execute: updateLayer } = useLumioAction("overlay:update_layer", {});
+const { execute: updateLayer } = useLumioAction("overlay:update_layer");
 updateLayer({ layerId: "uuid", visible: true });
 \`\`\`
 
@@ -877,10 +871,14 @@ updateLayer({ layerId: "uuid", visible: true });
 | Action | Permission required | Description |
 |--------|--------------------|----|
 | \`chat:send\` | \`chat:send\` | Send chat message on connected platform |
+| \`chat:delete\` | \`chat:delete\` | Delete a chat message |
 | \`chat:ban\` | \`chat:ban\` | Ban a user from chat |
 | \`chat:unban\` | \`chat:ban\` | Unban a user from chat |
 | \`chat:timeout\` | \`chat:ban\` | Timeout a user from chat |
 | \`obs:set_scene\` | \`obs:control\` | Switch OBS scene |
+| \`obs:set_source_visible\` | \`obs:control\` | Show or hide an OBS source |
+| \`obs:start_stream\` | \`obs:control\` | Start OBS streaming |
+| \`obs:stop_stream\` | \`obs:control\` | Stop OBS streaming |
 | \`obs:start_recording\` | \`obs:control\` | Start OBS recording |
 | \`obs:stop_recording\` | \`obs:control\` | Stop OBS recording |
 | \`events:emit\` | \`events:write\` | Emit event into Lumio event bus |
@@ -1325,7 +1323,7 @@ Data is scoped to a specific extension installation within a specific overlay.
 defineTable({...}).storage("instance")
 \`\`\`
 
-- Filtered by: \`_account_id\` + \`_overlay_id\`
+- Filtered by: \`_account_id\` + \`_overlay_id\` + \`_install_id\`
 - Use for: per-widget data (scoreboard scores, timer state, per-overlay config)
 - Example: A "Sports Scoreboard" widget has different scores in each overlay it appears in
 
@@ -1383,7 +1381,7 @@ Each scope maps to automatic WHERE clauses:
 
 \`\`\`sql
 -- instance scope:
-SELECT * FROM ext_{id}.items WHERE _account_id = $1 AND _overlay_id = $2
+SELECT * FROM ext_{id}.items WHERE _account_id = $1 AND _overlay_id = $2 AND _install_id = $3
 
 -- overlay scope:
 SELECT * FROM ext_{id}.items WHERE _account_id = $1 AND _overlay_id = $2
@@ -1485,23 +1483,19 @@ Use \`config_schema\` in \`lumio.config.json\` for user-customizable settings. T
 
 \`\`\`json
 {
-  "config_schema": {
-    "fields": [
-      { "key": "title", "type": "string", "label": "Widget Title", "default": "My Widget" },
-      { "key": "maxItems", "type": "number", "label": "Max Items", "default": 10 },
-      { "key": "showBorder", "type": "boolean", "label": "Show Border", "default": true },
-      {
-        "key": "theme",
-        "type": "select",
-        "label": "Color Theme",
-        "options": [
-          { "label": "Dark", "value": "dark" },
-          { "label": "Light", "value": "light" }
-        ],
-        "default": "dark"
-      }
-    ]
-  }
+  "config_schema": [
+    { "key": "title", "type": "string", "label": "Widget Title", "default_value": "My Widget", "required": true },
+    { "key": "maxItems", "type": "number", "label": "Max Items", "default_value": 10, "required": false },
+    { "key": "showBorder", "type": "boolean", "label": "Show Border", "default_value": true, "required": false },
+    {
+      "key": "theme",
+      "type": "select",
+      "label": "Color Theme",
+      "options": ["dark", "light"],
+      "default_value": "dark",
+      "required": false
+    }
+  ]
 }
 \`\`\`
 

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   ROOT_FILES,
   SKILL_FILES,
   installSkillFiles
-} from "./chunk-I2USQPPS.js";
+} from "./chunk-5NNQDQNL.js";
 export {
   ROOT_FILES,
   SKILL_FILES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaflun/lumio-agent-skill",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "AI agent skill files for building Lumio Extensions",
   "type": "module",
   "main": "dist/index.js",