@llblab/pi-actors 0.48.0 → 0.49.0

package/dist/skills/media/SKILL.md

@@ -1,44 +0,0 @@
----
-name: media
-description: Use for local media discovery, filtering, library summaries, playlist construction, or controllable playback.
----
-
-# Media
-
-Use this Skill for caller-selected local media. For generic Recipe execution, persistent-tool setup, Run lifecycle, or diagnosis, follow `actors`; this Skill only selects media behavior.
-
-## Choose the operation
-
-| Intent | Recipe | Use when |
-| --- | --- | --- |
-| Start or control playback | `media/player` | A local file, directory, or playlist should become a controlled service |
-| Build a library summary | `media/library` | A filtered playlist should feed bounded report content |
-| Build a filtered playlist | `media/playlist-build` | Extension filtering and `paths`, `m3u`, or `inline` output are required |
-| Scan a directory for raw file paths | `media/playlist-scan` | A shallow unfiltered inventory is intentionally sufficient |
-
-Use `playlist-build` rather than `playlist-scan` for normal media selection. `library` composes playlist output into report content; its `artifact_path` identifies the intended report target but does not by itself prove a durable write.
-
-## Controlled playback
-
-`media/player` is an async controlled service. Start one owned Run, then use only its declared actions: `play`, `pause`, `resume`, `toggle`, `next`, `previous`, `stop`, and `status`.
-
-```text
-spawn recipe=media/player as=run:music values={"source":"~/Music","player":"auto"}
-message target=run:music action=pause
-inspect target=run:music view=control
-```
-
-For recurring playback as a persistent callable tool, use the persistent-capability workflow in `actors` with `from=media/player`; do not copy the player contract.
-
-## Paths and selection
-
-- `source` for playback must name caller-approved local media; do not broaden it to unrelated directories.
-- `source_dir` must be an intended readable directory. `~` is accepted by maintained media helpers.
-- Keep `max_depth` bounded. Use explicit comma-separated extensions for `playlist-build` and `library`.
-- Choose `output_mode=m3u` only when playlist text is wanted; it does not create a playlist file.
-- Choose an explicit `artifact_path` and model for `library` report generation.
-- `player=auto` selects an available supported backend; do not install or substitute a player silently.
-
-## Stop rules
-
-Stop if the source is missing, unreadable, contains no selected media, or no supported player is available. Do not claim playback from process start alone; confirm through Run evidence or `status`. Prefer the declared `stop` action for a responsive player. If the service is unresponsive, return to `actors` for bounded Run recovery rather than shell process control.

package/dist/skills/media/recipes/library.json

@@ -1,45 +0,0 @@
-{
-  "async": true,
-  "imports": {
-    "playlist": "media/playlist-build",
-    "artifact": "artifacts/report"
-  },
-  "args": [
-    "source_dir:path",
-    "extensions:string",
-    "max_depth:int",
-    "output_mode:enum(paths,m3u,inline)",
-    "artifact_path:path",
-    "model:string",
-    "tools:string"
-  ],
-  "defaults": {
-    "source_dir": "~/Music",
-    "extensions": ".mp3,.ogg,.wav,.flac,.m4a",
-    "max_depth": "2",
-    "output_mode": "m3u",
-    "artifact_path": "./media-library.md",
-    "tools": ""
-  },
-  "template": [
-    {
-      "name": "playlist",
-      "values": {
-        "source_dir": "{source_dir}",
-        "extensions": "{extensions}",
-        "max_depth": "{max_depth}",
-        "output_mode": "{output_mode}"
-      }
-    },
-    {
-      "name": "artifact",
-      "values": {
-        "input": "Use playlist/media listing from stdin. Source directory: {source_dir}. Output mode: {output_mode}.",
-        "artifact_path": "{artifact_path}",
-        "artifact_format": "Markdown sections: Source, Playlist Output, Playback Notes, Next Actions.",
-        "model": "{model}",
-        "tools": "{tools}"
-      }
-    }
-  ]
-}

package/dist/skills/media/recipes/playlist-build.json

@@ -1,15 +0,0 @@
-{
-  "args": [
-    "source_dir:path",
-    "extensions:string",
-    "max_depth:int",
-    "output_mode:enum(paths,m3u,inline)"
-  ],
-  "defaults": {
-    "source_dir": "~/Music",
-    "extensions": ".mp3,.ogg,.wav,.flac,.m4a",
-    "max_depth": "2",
-    "output_mode": "paths"
-  },
-  "template": "{skill_dir}/scripts/media-utils.mjs playlist {source_dir} {extensions} {max_depth} {output_mode}"
-}

package/dist/skills/media/recipes/playlist-scan.json

@@ -1,11 +0,0 @@
-{
-  "args": [
-    "source_dir:path",
-    "max_depth:int"
-  ],
-  "defaults": {
-    "source_dir": "~/Music",
-    "max_depth": "2"
-  },
-  "template": "find {source_dir} -maxdepth {max_depth} -type f -print"
-}

package/dist/skills/media/scripts/media-utils.mjs

@@ -1,47 +0,0 @@
-#!/usr/bin/env node
-
-/** Media-owned playlist construction helper. */
-
-import { existsSync, readdirSync, statSync } from "node:fs";
-import { extname, join, resolve } from "node:path";
-
-function fail(message) {
-  console.error(message);
-  process.exit(1);
-}
-
-function walkFiles(dir, maxDepth = 2, depth = 0, out = []) {
-  if (depth > maxDepth || !existsSync(dir)) return out;
-  for (const entry of readdirSync(dir)) {
-    const path = join(dir, entry);
-    const stat = statSync(path);
-    if (stat.isDirectory()) walkFiles(path, maxDepth, depth + 1, out);
-    else if (stat.isFile()) out.push(path);
-  }
-  return out;
-}
-
-function playlist(
-  sourceValue,
-  extensionsValue = ".mp3,.ogg,.wav,.flac,.m4a",
-  maxDepthValue = "2",
-  outputMode = "paths",
-) {
-  const source = resolve(String(sourceValue).replace(/^~(?=\/|$)/, process.env.HOME ?? "~"));
-  const maxDepth = Number.parseInt(maxDepthValue, 10);
-  const extensions = new Set(extensionsValue.split(",").map((item) => item.trim().toLowerCase()).filter(Boolean));
-  const files = walkFiles(source, Number.isFinite(maxDepth) ? maxDepth : 2)
-    .filter((file) => extensions.has(extname(file).toLowerCase()))
-    .sort((a, b) => a.localeCompare(b));
-  if (outputMode === "m3u") console.log(["#EXTM3U", ...files].join("\n"));
-  else if (outputMode === "inline") console.log(files.join("|"));
-  else console.log(files.join("\n"));
-}
-
-const [command, ...args] = process.argv.slice(2);
-try {
-  if (command === "playlist") playlist(args[0] ?? "~/Music", args[1], args[2], args[3]);
-  else fail(`Unknown media command: ${command ?? ""}`);
-} catch (error) {
-  fail(error instanceof Error ? error.message : String(error));
-}

package/skills/media/SKILL.md

@@ -1,44 +0,0 @@
----
-name: media
-description: Use for local media discovery, filtering, library summaries, playlist construction, or controllable playback.
----
-
-# Media
-
-Use this Skill for caller-selected local media. For generic Recipe execution, persistent-tool setup, Run lifecycle, or diagnosis, follow `actors`; this Skill only selects media behavior.
-
-## Choose the operation
-
-| Intent | Recipe | Use when |
-| --- | --- | --- |
-| Start or control playback | `media/player` | A local file, directory, or playlist should become a controlled service |
-| Build a library summary | `media/library` | A filtered playlist should feed bounded report content |
-| Build a filtered playlist | `media/playlist-build` | Extension filtering and `paths`, `m3u`, or `inline` output are required |
-| Scan a directory for raw file paths | `media/playlist-scan` | A shallow unfiltered inventory is intentionally sufficient |
-
-Use `playlist-build` rather than `playlist-scan` for normal media selection. `library` composes playlist output into report content; its `artifact_path` identifies the intended report target but does not by itself prove a durable write.
-
-## Controlled playback
-
-`media/player` is an async controlled service. Start one owned Run, then use only its declared actions: `play`, `pause`, `resume`, `toggle`, `next`, `previous`, `stop`, and `status`.
-
-```text
-spawn recipe=media/player as=run:music values={"source":"~/Music","player":"auto"}
-message target=run:music action=pause
-inspect target=run:music view=control
-```
-
-For recurring playback as a persistent callable tool, use the persistent-capability workflow in `actors` with `from=media/player`; do not copy the player contract.
-
-## Paths and selection
-
-- `source` for playback must name caller-approved local media; do not broaden it to unrelated directories.
-- `source_dir` must be an intended readable directory. `~` is accepted by maintained media helpers.
-- Keep `max_depth` bounded. Use explicit comma-separated extensions for `playlist-build` and `library`.
-- Choose `output_mode=m3u` only when playlist text is wanted; it does not create a playlist file.
-- Choose an explicit `artifact_path` and model for `library` report generation.
-- `player=auto` selects an available supported backend; do not install or substitute a player silently.
-
-## Stop rules
-
-Stop if the source is missing, unreadable, contains no selected media, or no supported player is available. Do not claim playback from process start alone; confirm through Run evidence or `status`. Prefer the declared `stop` action for a responsive player. If the service is unresponsive, return to `actors` for bounded Run recovery rather than shell process control.

package/skills/media/recipes/library.json

@@ -1,45 +0,0 @@
-{
-  "async": true,
-  "imports": {
-    "playlist": "media/playlist-build",
-    "artifact": "artifacts/report"
-  },
-  "args": [
-    "source_dir:path",
-    "extensions:string",
-    "max_depth:int",
-    "output_mode:enum(paths,m3u,inline)",
-    "artifact_path:path",
-    "model:string",
-    "tools:string"
-  ],
-  "defaults": {
-    "source_dir": "~/Music",
-    "extensions": ".mp3,.ogg,.wav,.flac,.m4a",
-    "max_depth": "2",
-    "output_mode": "m3u",
-    "artifact_path": "./media-library.md",
-    "tools": ""
-  },
-  "template": [
-    {
-      "name": "playlist",
-      "values": {
-        "source_dir": "{source_dir}",
-        "extensions": "{extensions}",
-        "max_depth": "{max_depth}",
-        "output_mode": "{output_mode}"
-      }
-    },
-    {
-      "name": "artifact",
-      "values": {
-        "input": "Use playlist/media listing from stdin. Source directory: {source_dir}. Output mode: {output_mode}.",
-        "artifact_path": "{artifact_path}",
-        "artifact_format": "Markdown sections: Source, Playlist Output, Playback Notes, Next Actions.",
-        "model": "{model}",
-        "tools": "{tools}"
-      }
-    }
-  ]
-}

package/skills/media/recipes/playlist-build.json

@@ -1,15 +0,0 @@
-{
-  "args": [
-    "source_dir:path",
-    "extensions:string",
-    "max_depth:int",
-    "output_mode:enum(paths,m3u,inline)"
-  ],
-  "defaults": {
-    "source_dir": "~/Music",
-    "extensions": ".mp3,.ogg,.wav,.flac,.m4a",
-    "max_depth": "2",
-    "output_mode": "paths"
-  },
-  "template": "{skill_dir}/scripts/media-utils.mjs playlist {source_dir} {extensions} {max_depth} {output_mode}"
-}

package/skills/media/recipes/playlist-scan.json

@@ -1,11 +0,0 @@
-{
-  "args": [
-    "source_dir:path",
-    "max_depth:int"
-  ],
-  "defaults": {
-    "source_dir": "~/Music",
-    "max_depth": "2"
-  },
-  "template": "find {source_dir} -maxdepth {max_depth} -type f -print"
-}

package/skills/media/scripts/media-utils.mjs

@@ -1,47 +0,0 @@
-#!/usr/bin/env node
-
-/** Media-owned playlist construction helper. */
-
-import { existsSync, readdirSync, statSync } from "node:fs";
-import { extname, join, resolve } from "node:path";
-
-function fail(message) {
-  console.error(message);
-  process.exit(1);
-}
-
-function walkFiles(dir, maxDepth = 2, depth = 0, out = []) {
-  if (depth > maxDepth || !existsSync(dir)) return out;
-  for (const entry of readdirSync(dir)) {
-    const path = join(dir, entry);
-    const stat = statSync(path);
-    if (stat.isDirectory()) walkFiles(path, maxDepth, depth + 1, out);
-    else if (stat.isFile()) out.push(path);
-  }
-  return out;
-}
-
-function playlist(
-  sourceValue,
-  extensionsValue = ".mp3,.ogg,.wav,.flac,.m4a",
-  maxDepthValue = "2",
-  outputMode = "paths",
-) {
-  const source = resolve(String(sourceValue).replace(/^~(?=\/|$)/, process.env.HOME ?? "~"));
-  const maxDepth = Number.parseInt(maxDepthValue, 10);
-  const extensions = new Set(extensionsValue.split(",").map((item) => item.trim().toLowerCase()).filter(Boolean));
-  const files = walkFiles(source, Number.isFinite(maxDepth) ? maxDepth : 2)
-    .filter((file) => extensions.has(extname(file).toLowerCase()))
-    .sort((a, b) => a.localeCompare(b));
-  if (outputMode === "m3u") console.log(["#EXTM3U", ...files].join("\n"));
-  else if (outputMode === "inline") console.log(files.join("|"));
-  else console.log(files.join("\n"));
-}
-
-const [command, ...args] = process.argv.slice(2);
-try {
-  if (command === "playlist") playlist(args[0] ?? "~/Music", args[1], args[2], args[3]);
-  else fail(`Unknown media command: ${command ?? ""}`);
-} catch (error) {
-  fail(error instanceof Error ? error.message : String(error));
-}