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

package/llm.txt

@@ -50,7 +50,7 @@ ask before cloning.
 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.
+opening the account menu.
 
 ```bash
 mkdir -p ~/.config/sogni
@@ -63,12 +63,22 @@ chmod 600 ~/.config/sogni/credentials
 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
+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.
-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.
+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

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "sogni-creative-agent-skill",
   "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",
+  "version": "2.3.0",
   "skills": [
     "."
   ],
@@ -73,12 +73,35 @@
         "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", "rich", "hosted", "none"],
+        "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"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sogni-ai/sogni-creative-agent-skill",
-  "version": "2.2.0",
+  "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",
@@ -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",
@@ -50,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}).`,
+);