@sogni-ai/sogni-creative-agent-skill 2.1.3 → 2.3.0

package/llm.txt

@@ -45,24 +45,46 @@ 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 credentials
+## 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
+opening the account menu.
+
 ```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 and sanitized
+message forwarding, or
+`sogni-agent --api-workflow image-to-video --video-prompt "motion" "image prompt"`
+for durable `/v1/creative-agent/workflows` execution.
+Sogni Intelligence utilities are available with `--list-api-models`,
+`--get-api-model <id>`, `--task-profile general|coding|reasoning`,
+`--max-tokens <n>`, `--thinking` / `--no-thinking`, `--list-replays [n]`,
+`--get-replay <id>`, and `--ingest-replay <json|path|@path>`.
+Hosted API modes forward media references from `-c`, `--ref`, `--ref-end`,
+`--ref-audio`, `--reference-audio-identity`, and `--ref-video` as
+`media_references`; API chat also attaches image refs as vision inputs. Local
+file references are uploaded to Sogni media storage first and then forwarded as
+retrievable URLs. Workflow JSON can bind those refs with
+`sourceStepId: "$input_media"`. Use `--workflow-max-cost`, `--confirm-cost`,
+or `--no-confirm-cost` for durable workflow cost policy. JSON errors include
+canonical `errorType`, `errorCategory`, and retryability when classified.
+
+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
 

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.3",
+  "name": "Sogni Creative Agent Skill — Image, Video & Music Generation",
+  "description": "Agent skill and CLI for Sogni AI image, video, and music generation.",
+  "version": "2.3.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,45 @@
         "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."
+      },
+      "defaultTaskProfile": {
+        "type": "string",
+        "enum": ["general", "coding", "reasoning"],
+        "description": "Optional default Sogni Intelligence task profile forwarded as task_profile for --api-chat."
+      },
+      "defaultApiMaxTokens": {
+        "type": "integer",
+        "minimum": 1,
+        "description": "Optional default max_tokens value for --api-chat and storyboard planning chat calls."
+      },
+      "defaultApiThinking": {
+        "type": "boolean",
+        "description": "Optional default chat_template_kwargs.enable_thinking value for hosted chat requests."
+      },
+      "defaultApiToolMode": {
+        "type": "string",
+        "enum": ["creative-agent", "creative-tools", "none"],
+        "default": "creative-agent",
+        "description": "Default Sogni tool family injected into --api-chat requests."
+      },
+      "defaultWorkflowMaxCost": {
+        "type": "number",
+        "minimum": 0,
+        "description": "Optional default capacity-unit ceiling forwarded to --api-workflow requests unless --workflow-max-cost is provided."
+      },
+      "defaultWorkflowConfirmCost": {
+        "type": "boolean",
+        "description": "Optional default explicit cost confirmation forwarded to --api-workflow requests unless --confirm-cost or --no-confirm-cost is provided."
+      },
       "seedStrategy": {
         "type": "string",
         "enum": ["random", "prompt-hash"],
@@ -116,10 +160,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.3",
-  "description": "Sogni Creative Agent Skill: agent skill and CLI for Sogni AI image and video generation.",
+  "version": "2.3.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": {
@@ -10,11 +10,14 @@
   "scripts": {
     "openclaw:sync": "node scripts/sync-openclaw-plugin.mjs",
     "sync:creative-agent-runtime": "node ../sogni-creative-agent/scripts/sync-skill-runtime.mjs",
+    "check:creative-agent-source": "node scripts/check-creative-agent-source.mjs",
+    "check:creative-agent-source:strict": "node scripts/check-creative-agent-source.mjs --strict-network",
     "check:creative-agent-runtime": "node scripts/check-creative-agent-runtime.mjs",
     "test": "npm run check:creative-agent-runtime && node --test test/*.test.mjs test/*.integration.mjs",
     "test:integration": "npm run check:creative-agent-runtime && node --test test/*.integration.mjs",
     "test:coverage": "npm run check:creative-agent-runtime && node --test --experimental-test-coverage --test-coverage-include=sogni-agent.mjs --test-coverage-lines=50 --test-coverage-branches=35 --test-coverage-functions=50 test/sogni-agent.test.mjs",
-    "test:coverage:full": "npm run check:creative-agent-runtime && node --test --experimental-test-coverage --test-coverage-include=sogni-agent.mjs --test-coverage-lines=50 --test-coverage-branches=35 --test-coverage-functions=50 test/*.test.mjs test/*.integration.mjs"
+    "test:coverage:full": "npm run check:creative-agent-runtime && node --test --experimental-test-coverage --test-coverage-include=sogni-agent.mjs --test-coverage-lines=50 --test-coverage-branches=35 --test-coverage-functions=50 test/*.test.mjs test/*.integration.mjs",
+    "prepack": "npm run check:creative-agent-source:strict && npm run check:creative-agent-runtime"
   },
   "keywords": [
     "sogni",
@@ -22,6 +25,8 @@
     "agent",
     "image-generation",
     "video-generation",
+    "music-generation",
+    "audio-generation",
     "openclaw",
     "hermes-agent",
     "manus",
@@ -39,7 +44,7 @@
   },
   "homepage": "https://github.com/Sogni-AI/sogni-creative-agent-skill#readme",
   "engines": {
-    "node": ">=22.11.0"
+    "node": ">=22"
   },
   "files": [
     "LICENSE",
@@ -48,6 +53,7 @@
     "llm.txt",
     "skill-package.json",
     "scripts/check-creative-agent-runtime.mjs",
+    "scripts/check-creative-agent-source.mjs",
     "version.mjs",
     "scripts/sync-openclaw-plugin.mjs",
     "openclaw-plugin.mjs",

package/scripts/check-creative-agent-source.mjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * Verify that the private sibling repo used to generate the public runtime is
+ * a clean checkout of its remote default branch HEAD.
+ *
+ * The generated runtime check can only prove "fresh relative to this local
+ * checkout"; this script prevents publish/pack from validating against stale
+ * or uncommitted private source.
+ */
+import { existsSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const repoRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const args = new Set(process.argv.slice(2));
+const strictNetwork = args.has('--strict-network');
+const allowDirty = process.env.SOGNI_CREATIVE_AGENT_ALLOW_DIRTY === '1';
+const creativeAgentRoot = resolve(
+  repoRoot,
+  process.env.SOGNI_CREATIVE_AGENT_DIR || join('..', 'sogni-creative-agent'),
+);
+
+function runGit(gitArgs, options = {}) {
+  const result = spawnSync('git', gitArgs, {
+    cwd: creativeAgentRoot,
+    encoding: 'utf8',
+    timeout: options.timeout,
+  });
+  if (result.error || result.status !== 0) {
+    const reason = result.error?.message || result.stderr?.trim() || `exit ${result.status}`;
+    throw new Error(`git ${gitArgs.join(' ')} failed in ${creativeAgentRoot}: ${reason}`);
+  }
+  return result.stdout.trim();
+}
+
+function resolveRemoteDefaultHead() {
+  const result = spawnSync('git', ['ls-remote', '--symref', 'origin', 'HEAD'], {
+    cwd: creativeAgentRoot,
+    encoding: 'utf8',
+    timeout: Number(process.env.SOGNI_CREATIVE_AGENT_LS_REMOTE_TIMEOUT_MS || 10000),
+  });
+  if (result.error || result.status !== 0) {
+    const reason = result.error?.message || result.stderr?.trim() || `exit ${result.status}`;
+    throw new Error(`git ls-remote --symref origin HEAD failed: ${reason}`);
+  }
+
+  let branch = '(default)';
+  let sha;
+  for (const line of result.stdout.split('\n')) {
+    const symrefMatch = line.match(/^ref:\s+refs\/heads\/(\S+)\s+HEAD$/);
+    if (symrefMatch) {
+      branch = symrefMatch[1];
+      continue;
+    }
+    const headMatch = line.match(/^([0-9a-f]{40})\s+HEAD$/i);
+    if (headMatch) sha = headMatch[1].toLowerCase();
+  }
+  if (!sha) {
+    throw new Error('Could not parse remote default HEAD SHA.');
+  }
+  return { branch, sha };
+}
+
+if (!existsSync(join(creativeAgentRoot, '.git'))) {
+  console.error(`Missing sibling sogni-creative-agent checkout at ${creativeAgentRoot}`);
+  console.error('Set SOGNI_CREATIVE_AGENT_DIR if the private repo lives elsewhere.');
+  process.exit(1);
+}
+
+const localSha = runGit(['rev-parse', 'HEAD']).toLowerCase();
+const status = runGit(['status', '--porcelain']);
+if (status && !allowDirty) {
+  console.error(`sogni-creative-agent has uncommitted changes at ${creativeAgentRoot}.`);
+  console.error('Public runtime publishing must be generated from committed private source.');
+  console.error(status);
+  console.error('Set SOGNI_CREATIVE_AGENT_ALLOW_DIRTY=1 only for intentional local validation.');
+  process.exit(1);
+}
+
+let remoteHead;
+try {
+  remoteHead = resolveRemoteDefaultHead();
+} catch (error) {
+  const message = `Could not resolve sogni-creative-agent remote default HEAD: ${error.message}`;
+  if (strictNetwork) {
+    console.error(`${message}. Refusing to continue in strict-network mode.`);
+    process.exit(1);
+  }
+  console.warn(`${message}. Skipping remote freshness check.`);
+}
+
+if (remoteHead && localSha !== remoteHead.sha) {
+  console.error('sogni-creative-agent checkout is not at the remote default branch HEAD.');
+  console.error(`Remote ${remoteHead.branch}: ${remoteHead.sha}`);
+  console.error(`Local HEAD:      ${localSha}`);
+  console.error(`Fix: git -C ${creativeAgentRoot} fetch origin && git -C ${creativeAgentRoot} checkout ${remoteHead.sha}`);
+  process.exit(1);
+}
+
+const dirtySuffix = status ? ' with allowed local changes' : '';
+console.log(
+  `sogni-creative-agent source OK (${localSha.slice(0, 12)}${remoteHead ? ` matches origin/${remoteHead.branch}` : ''}${dirtySuffix}).`,
+);