@sogni-ai/sogni-creative-agent-skill 2.1.2 → 2.2.0

package/llm.txt

@@ -7,6 +7,10 @@ runtimes.
 ## Install (pick the integration that matches your environment)
 
 ```bash
+# Agent-safe CLI install or upgrade
+npm install -g @sogni-ai/sogni-creative-agent-skill@latest
+sogni-agent --version
+
 # OpenClaw plugin
 openclaw plugins install sogni-creative-agent-skill
 
@@ -26,36 +30,55 @@ npm link
 npm run openclaw:sync
 openclaw gateway restart
 
-# Hermes Agent / Manus / other agent frameworks
-# Point the agent at https://github.com/Sogni-AI/sogni-creative-agent-skill — use SKILL.md as
-# the behavior source and invoke the CLI.
+# Agent-safe existing checkout update
+DEST="$HOME/Documents/git/sogni/sogni-creative-agent-skill"
+git -C "$DEST" pull --ff-only
+npm --prefix "$DEST" install
 
-# Standalone Node CLI
-npm install -g @sogni-ai/sogni-creative-agent-skill
+# Hermes Agent / Manus / other agent frameworks
+# Point the agent at the Sogni-AI/sogni-creative-agent-skill repository.
+# Use SKILL.md as the behavior source and invoke the CLI.
 ```
 
-## Configure Sogni credentials
+When operating inside an agent runtime, do not generate clone-or-pull shell
+bootstrap scripts with `set -e`, `bash -c`, `sh -c`, or inline repository URLs.
+Use the npm upgrade command above, update an existing checkout with `git -C`, or
+ask before cloning.
+
+## Configure Sogni API key
 
 Once-only setup, used by every integration above:
 
+The API key can always be found by logging into https://dashboard.sogni.ai and
+clicking your username.
+
 ```bash
 mkdir -p ~/.config/sogni
 cat > ~/.config/sogni/credentials << 'EOF'
 SOGNI_API_KEY=your_api_key
-# or:
-# SOGNI_USERNAME=your_username
-# SOGNI_PASSWORD=your_password
 EOF
 chmod 600 ~/.config/sogni/credentials
 ```
 
-You can also export `SOGNI_API_KEY`, or `SOGNI_USERNAME` + `SOGNI_PASSWORD`,
-instead of writing the file. Sign up at https://app.sogni.ai/ if you do not
-have an account.
+You can also export `SOGNI_API_KEY` instead of writing the file.
+
+Hosted API modes require `SOGNI_API_KEY`: use `sogni-agent --api-chat "prompt"`
+for `/v1/chat/completions` with rich creative-agent tools, or
+`sogni-agent --api-workflow image-to-video --video-prompt "motion" "image prompt"`
+for durable `/v1/creative-agent/workflows` execution.
+Use the direct CLI path for uploaded media (`-c`, `--ref`, `--ref-audio`,
+`--ref-video`); hosted API modes do not accept those media flags for server-side
+tool execution.
+
+Reusable hosted workflow behavior belongs in `../sogni-creative-agent` before it
+is synced into this public skill. Use typed planner/runtime contracts for media
+routing and repair decisions; keep skill-local regex limited to CLI fact
+extraction such as paths, URLs, extensions, dimensions, durations, and explicit
+positions.
 
 ## Repo
 
-https://github.com/Sogni-AI/sogni-creative-agent-skill
+Sogni-AI/sogni-creative-agent-skill
 
 ## Key files
 

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "sogni-creative-agent-skill",
-  "name": "Sogni Creative Agent Skill — Image & Video Generation",
-  "description": "Agent skill and CLI for Sogni AI image and video generation.",
-  "version": "2.1.2",
+  "name": "Sogni Creative Agent Skill — Image, Video & Music Generation",
+  "description": "Agent skill and CLI for Sogni AI image, video, and music generation.",
+  "version": "2.2.0",
   "skills": [
     "."
   ],
@@ -25,6 +25,11 @@
         "default": "coreml-sogniXLturbo_alpha1_ad",
         "description": "Default model for photobooth face transfer."
       },
+      "defaultMusicModel": {
+        "type": "string",
+        "default": "ace_step_1.5_turbo",
+        "description": "Default model for direct music/audio generation."
+      },
       "videoModels": {
         "type": "object",
         "additionalProperties": false,
@@ -58,6 +63,22 @@
         "default": "spark",
         "description": "Default token balance to use."
       },
+      "apiBaseUrl": {
+        "type": "string",
+        "default": "https://api.sogni.ai",
+        "description": "Default Sogni API base URL for --api-chat and --api-workflow modes."
+      },
+      "defaultLlmModel": {
+        "type": "string",
+        "default": "qwen3.6-35b-a3b-gguf-iq4xs",
+        "description": "Default LLM model for --api-chat."
+      },
+      "defaultApiToolMode": {
+        "type": "string",
+        "enum": ["creative-agent", "rich", "hosted", "none"],
+        "default": "creative-agent",
+        "description": "Default Sogni tool family injected into --api-chat requests."
+      },
       "seedStrategy": {
         "type": "string",
         "enum": ["random", "prompt-hash"],
@@ -116,10 +137,21 @@
         "minimum": 30,
         "default": 300
       },
+      "defaultMusicDurationSec": {
+        "type": "integer",
+        "minimum": 10,
+        "maximum": 600,
+        "default": 30
+      },
+      "defaultMusicTimeoutSec": {
+        "type": "integer",
+        "minimum": 30,
+        "default": 600
+      },
       "credentialsPath": {
         "type": "string",
         "default": "~/.config/sogni/credentials",
-        "description": "Optional path to Sogni credentials file (can also set SOGNI_CREDENTIALS_PATH)."
+        "description": "Optional path to Sogni API key credentials file (can also set SOGNI_CREDENTIALS_PATH)."
       },
       "lastRenderPath": {
         "type": "string",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sogni-ai/sogni-creative-agent-skill",
-  "version": "2.1.2",
-  "description": "Sogni Creative Agent Skill: agent skill and CLI for Sogni AI image and video generation.",
+  "version": "2.2.0",
+  "description": "Sogni Creative Agent Skill: agent skill and CLI for Sogni AI image, video, and music generation.",
   "type": "module",
   "main": "sogni-agent.mjs",
   "bin": {
@@ -22,6 +22,8 @@
     "agent",
     "image-generation",
     "video-generation",
+    "music-generation",
+    "audio-generation",
     "openclaw",
     "hermes-agent",
     "manus",
@@ -39,7 +41,7 @@
   },
   "homepage": "https://github.com/Sogni-AI/sogni-creative-agent-skill#readme",
   "engines": {
-    "node": ">=22.11.0"
+    "node": ">=22"
   },
   "files": [
     "LICENSE",