subconscious-cli 6.0.1 → 6.1.0

package/bin/runbook/pi/agent.json

@@ -0,0 +1,216 @@
+{
+  "id": "pi",
+  "command": "pi",
+  "aliases": [],
+  "name": "Pi",
+  "description": "Refresh Pi with the live Subconscious model catalog and launch the active profile model.",
+  "protocol": "openai",
+  "homepage": "https://pi.dev",
+  "install": {
+    "commands": null,
+    "method": null,
+    "package": null,
+    "version": null,
+    "minimum_version": null,
+    "verified": false,
+    "note": "No install command is defined; subc expects pi on PATH."
+  },
+  "runbook": {
+    "mode": "launch",
+    "script": "run.sh",
+    "setup_script": "install.sh",
+    "setup_actions": ["install", "status", "uninstall"],
+    "after_install": "Start a fresh session with subc pi."
+  },
+  "help": {
+    "usage": "subc [-p NAME] pi [help|install|status|uninstall] [Pi arguments...]",
+    "behavior": "Refreshes the persistent Subconscious provider from the live catalog, then launches Pi.",
+    "options": [
+      ["help", "Show this help"],
+      ["install", "Refresh the Subconscious provider without launching Pi"],
+      ["status", "Inspect the persistent Pi provider"],
+      ["uninstall", "Remove only the Subconscious Pi provider and extension"],
+      ["--model MODEL", "Override the profile model for this launch"]
+    ],
+    "args": ["ARGS...", "Pass arguments directly to Pi"]
+  },
+  "sessions": { "key": "pi", "portable": true },
+  "prerequisites": [
+    {
+      "command": "jq",
+      "needed_for": "install and every launch",
+      "required": true
+    }
+  ],
+  "launch": {
+    "argv": [
+      "pi",
+      "--provider",
+      "subconscious",
+      "--model",
+      "{model}",
+      "{args}"
+    ],
+    "headless_argv": [
+      "pi",
+      "--provider",
+      "subconscious",
+      "--model",
+      "{model}",
+      "--print",
+      "{args}"
+    ],
+    "headless_stdin": "{prompt}",
+    "headless_platforms": ["darwin", "linux"],
+    "resume": ["--session", "{sessionFile}"],
+    "handoff": ["{prompt}"],
+    "persistent_setup": true,
+    "note": "Each launch first runs install.sh install, which rewrites the persistent files below."
+  },
+  "inputs": [
+    {
+      "name": "PI_API_KEY",
+      "label": "Pi API key",
+      "description": "Pi-specific credential override; blank uses API_KEY.",
+      "type": "secret"
+    },
+    {
+      "name": "PI_CONTEXT_WINDOW",
+      "default": 5000000,
+      "label": "Context window",
+      "description": "Pi context window used to determine compaction.",
+      "type": "integer",
+      "min": 1
+    },
+    {
+      "name": "PI_MAX_TOKENS",
+      "default": 65536,
+      "label": "Maximum output tokens",
+      "description": "Maximum output tokens advertised to Pi.",
+      "type": "integer",
+      "min": 1
+    }
+  ],
+  "env": [],
+  "config": [
+    {
+      "kind": "file",
+      "path": "~/.pi/agent/models.json",
+      "lifetime": "persistent",
+      "value": {
+        "providers.subconscious.baseUrl": "{baseUrlV1}",
+        "providers.subconscious.api": "openai-completions",
+        "providers.subconscious.apiKey": "{apiKey}",
+        "providers.subconscious.headers": {
+          "x-subconscious-client": "pi"
+        },
+        "providers.subconscious.models[].contextWindow": "${PI_CONTEXT_WINDOW}",
+        "providers.subconscious.models[].maxTokens": "${PI_MAX_TOKENS}",
+        "providers.subconscious.models[].compat": {
+          "sendSessionAffinityHeaders": true,
+          "sessionAffinityFormat": "openai-nosession"
+        }
+      },
+      "description": "Subconscious provider, written by install.sh and merged in; other providers are kept. Mode 600; holds the key in plain text."
+    },
+    {
+      "kind": "file",
+      "path": "~/.pi/agent/subconscious.env",
+      "lifetime": "persistent",
+      "description": "SUBCONSCIOUS_GATEWAY_URL and SUBCONSCIOUS_API_KEY for the compaction extension (mode 600)."
+    },
+    {
+      "kind": "file",
+      "path": "~/.pi/agent/extensions/subconscious-compaction.ts",
+      "lifetime": "persistent",
+      "description": "Compaction reporting extension."
+    },
+    {
+      "kind": "dir",
+      "path": "~/.pi/agent/extensions/subconscious-image-window",
+      "lifetime": "persistent",
+      "description": "Extension that keeps requests to the newest 30 images."
+    }
+  ],
+  "capabilities": {
+    "compaction": {
+      "default": "on",
+      "on": {
+        "set_by_subc": true,
+        "kind": "config-field",
+        "name": "providers.subconscious.models[].contextWindow",
+        "value": "${PI_CONTEXT_WINDOW}",
+        "verified": false,
+        "note": "subc sets contextWindow. That Pi compacts relative to it comes only from the profile setting description.",
+        "config": "~/.pi/agent/models.json"
+      },
+      "off": {
+        "set_by_subc": false,
+        "kind": "config-field",
+        "name": "compaction.enabled",
+        "value": false,
+        "verified": false,
+        "note": "Upstream Pi setting. subc never sets it, and this repo does not confirm its location or behaviour.",
+        "config": "Pi settings (location unverified)"
+      },
+      "threshold": {
+        "set_by_subc": true,
+        "kind": "config-field",
+        "name": "providers.subconscious.models[].contextWindow",
+        "value": "${PI_CONTEXT_WINDOW}",
+        "verified": false,
+        "note": "subc sets contextWindow. That Pi compacts relative to it comes only from the profile setting description. Pi's reserveTokens also moves the trigger; subc never sets it.",
+        "semantics": "window",
+        "config": "~/.pi/agent/models.json"
+      }
+    },
+    "mcp": {
+      "configured_by_subc": false,
+      "transports": null,
+      "verified": false,
+      "note": "subc configures no MCP servers."
+    },
+    "headers": [
+      {
+        "name": "x-subconscious-client",
+        "value": "pi",
+        "on": "model requests",
+        "set_by_subc": true,
+        "verified": true
+      },
+      {
+        "name": "x-session-affinity",
+        "value": "session ID",
+        "on": "model requests",
+        "set_by_subc": true,
+        "verified": false,
+        "note": "Enabled by compat.sendSessionAffinityHeaders; the header name comes from an install.sh comment."
+      },
+      {
+        "name": "Authorization",
+        "value": "Bearer {apiKey}",
+        "on": "extension POSTs to {baseUrl}/v1/agent-hooks",
+        "set_by_subc": true,
+        "verified": true
+      }
+    ],
+    "hooks": [
+      {
+        "event": "session_before_compact",
+        "posts": "conversation_compaction phase=start",
+        "endpoint": "{baseUrl}/v1/agent-hooks",
+        "config": "~/.pi/agent/extensions/subconscious-compaction.ts",
+        "installed_by": ["launch", "install"],
+        "verified": true
+      },
+      {
+        "event": "session_compact",
+        "posts": "conversation_compaction phase=end",
+        "endpoint": "{baseUrl}/v1/agent-hooks",
+        "config": "~/.pi/agent/extensions/subconscious-compaction.ts",
+        "installed_by": ["launch", "install"],
+        "verified": true
+      }
+    ]
+  }
+}

package/bin/runbook/pi/install.sh

@@ -47,26 +47,21 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "${SCRIPT_DIR}/../model-capabilities.generated.sh"
+source "${SCRIPT_DIR}/../lib.sh"
 EXTENSION_SRC="${SCRIPT_DIR}/subconscious-compaction.ts"
-
-# Load shared env from SUBC_ENV_FILE, or a sibling .env / env.example.
-SHARED_ENV="${SUBC_ENV_FILE:-${SCRIPT_DIR}/../.env}"
-[[ -f "$SHARED_ENV" ]] || SHARED_ENV="${SCRIPT_DIR}/../env.example"
-if [[ -f "$SHARED_ENV" ]]; then set -a; source "$SHARED_ENV"; set +a; fi
+IMAGE_WINDOW_SRC="${SCRIPT_DIR}/../image-window"
 
 COMMAND="install"
 GATEWAY_URL="${GATEWAY_URL:-}"
 API_KEY="${PI_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
-CONTEXT_WINDOW="${PI_CONTEXT_WINDOW:-5000000}"
-MAX_TOKENS="${PI_MAX_TOKENS:-65536}"
+CONTEXT_WINDOW="${PI_CONTEXT_WINDOW:-}"
+MAX_TOKENS="${PI_MAX_TOKENS:-}"
 
 usage() {
   cat <<'EOF'
 Usage:
-  subc pi install [--gateway-url URL] [--api-key KEY] [--model MODEL]
-             [--context-window N] [--max-tokens N]
+  subc pi install [--gateway-url URL] [--api-key KEY] [--context-window N]
+             [--max-tokens N]
   subc pi uninstall
   subc pi status
 
@@ -91,10 +86,6 @@ while [[ $# -gt 0 ]]; do
       API_KEY="${2:-}"
       shift 2
       ;;
-    --model)
-      MODEL="${2:-}"
-      shift 2
-      ;;
     --context-window)
       CONTEXT_WINDOW="${2:-}"
       shift 2
@@ -115,35 +106,8 @@ while [[ $# -gt 0 ]]; do
   esac
 done
 
-DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.3-marathon
-subconscious/glm-5.2
-subconscious/tim-qwen3.6-27b
-subconscious/deepseek-v4-flash-marathon
-subconscious/deepseek-v4.1-flash-marathon"
-SUPPORTED_MODELS=()
-
-add_supported_model() {
-  local model_id="$1" existing
-  [[ -n "$model_id" ]] || return 0
-  if [[ ! "$model_id" =~ ^[-A-Za-z0-9._:/+]+$ ]]; then
-    echo "error: invalid model id: $model_id" >&2
-    exit 1
-  fi
-  if [[ "${#SUPPORTED_MODELS[@]}" -gt 0 ]]; then
-    for existing in "${SUPPORTED_MODELS[@]}"; do
-      [[ "$existing" == "$model_id" ]] && return 0
-    done
-  fi
-  SUPPORTED_MODELS+=("$model_id")
-}
-
-add_supported_model "$MODEL"
-while IFS= read -r model_id; do
-  add_supported_model "$model_id"
-done <<< "${SUBCONSCIOUS_MODELS:-$DEFAULT_SUBCONSCIOUS_MODELS}"
-
 MODEL_ENTRIES_JSON=""
-for model_id in "${SUPPORTED_MODELS[@]}"; do
+while IFS= read -r model_id; do
   vision_fields=""
   if subc_model_supports_vision "$model_id"; then
     vision_fields=',"input":["text","image"]'
@@ -154,12 +118,14 @@ for model_id in "${SUPPORTED_MODELS[@]}"; do
   else
     MODEL_ENTRIES_JSON="$model_json"
   fi
-done
+done <<< "${SUBC_MODEL_IDS:-}"
 
 PI_DIR="${PI_CODING_AGENT_DIR:-${HOME}/.pi/agent}"
 MODELS_JSON="${PI_DIR}/models.json"
 EXTENSIONS_DIR="${PI_DIR}/extensions"
 EXTENSION_DST="${EXTENSIONS_DIR}/subconscious-compaction.ts"
+# Keeps requests at the newest 30 images so a long session's upload stops growing.
+IMAGE_WINDOW_DST="${EXTENSIONS_DIR}/subconscious-image-window"
 ENV_FILE="${PI_DIR}/subconscious.env"
 MARKER='x-subconscious-client'
 
@@ -222,6 +188,8 @@ write_extension() {
   fi
   mkdir -p "$EXTENSIONS_DIR"
   cp "$EXTENSION_SRC" "$EXTENSION_DST"
+  rm -rf "$IMAGE_WINDOW_DST"
+  cp -R "$IMAGE_WINDOW_SRC" "$IMAGE_WINDOW_DST"
 }
 
 uninstall_config() {
@@ -235,6 +203,7 @@ uninstall_config() {
     echo "No Pi models.json at $MODELS_JSON"
   fi
   rm -f "$EXTENSION_DST" "$ENV_FILE"
+  rm -rf "$IMAGE_WINDOW_DST"
 }
 
 status() {
@@ -253,6 +222,11 @@ status() {
   else
     echo "compaction extension: not installed"
   fi
+  if [[ -d "$IMAGE_WINDOW_DST" ]]; then
+    echo "image window extension: $IMAGE_WINDOW_DST (installed)"
+  else
+    echo "image window extension: not installed"
+  fi
   if [[ -f "$ENV_FILE" ]]; then
     echo "env: $ENV_FILE (present)"
   else

package/bin/runbook/pi/run.sh

@@ -1,25 +1,13 @@
 #!/usr/bin/env bash
-# Refresh the Subconscious provider from the live catalog, then launch Pi.
-# Other providers in models.json are preserved.
+# Refresh the Subconscious provider from the live catalog, then start the pi
+# argv subc built. Other providers in models.json are preserved.
 
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-GATEWAY_URL="${GATEWAY_URL:-}"
-API_KEY="${PI_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
-PI_DIR="${PI_CODING_AGENT_DIR:-${HOME}/.pi/agent}"
-MODELS_JSON="${PI_DIR}/models.json"
+source "${SCRIPT_DIR}/../lib.sh"
 
-if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
-  echo "error: GATEWAY_URL and API_KEY are required to configure Pi" >&2
-  exit 1
-fi
+# stdin can hold a headless prompt, which belongs to Pi.
+"${SCRIPT_DIR}/install.sh" install </dev/null >/dev/null
 
-"${SCRIPT_DIR}/install.sh" install \
-  --gateway-url "$GATEWAY_URL" \
-  --api-key "$API_KEY" \
-  --model "$MODEL" \
-  >/dev/null
-
-exec pi --provider subconscious --model "$MODEL" "$@"
+subc_exec -- "$@"

package/bin/runbook/pi/subconscious-compaction.ts

@@ -51,7 +51,9 @@ function loadSubconsciousEnvFile(): void {
     return;
   }
   try {
-    const path = join(homedir(), '.pi', 'agent', 'subconscious.env');
+    const directory =
+      process.env.PI_CODING_AGENT_DIR || join(homedir(), '.pi', 'agent');
+    const path = join(directory, 'subconscious.env');
     const text = readFileSync(path, 'utf8');
     for (const line of text.split('\n')) {
       const trimmed = line.trim();

package/bin/runbook/shared.json

@@ -0,0 +1,58 @@
+{
+  "agents": [
+    "subconscious-code",
+    "claude-code",
+    "codex",
+    "opencode",
+    "cursor",
+    "copilot",
+    "pi",
+    "deepseek-harness"
+  ],
+  "defaults": {
+    "model": "subconscious/glm-5.3-marathon",
+    "models": [
+      "subconscious/glm-5.3-marathon",
+      "subconscious/glm-5.2",
+      "subconscious/tim-qwen3.6-27b",
+      "subconscious/deepseek-v4-flash-marathon",
+      "subconscious/deepseek-v4.1-flash-marathon"
+    ],
+    "baseUrl": "https://api.subconscious.dev"
+  },
+  "model_capabilities": {
+    "subconscious/deepseek-v4.1-flash-marathon": { "vision": true }
+  },
+  "inputs": [
+    {
+      "name": "GATEWAY_URL",
+      "group": "shared",
+      "label": "Gateway URL",
+      "description": "Subconscious gateway origin shared by every integration.",
+      "type": "url",
+      "required": true
+    },
+    {
+      "name": "API_KEY",
+      "group": "shared",
+      "label": "Shared API key",
+      "description": "Default credential used when an agent-specific key is blank.",
+      "type": "secret"
+    },
+    {
+      "name": "MODEL",
+      "group": "shared",
+      "label": "Default model",
+      "description": "Initial model used by coding-agent launches and setup. UNSET uses the first live catalog model.",
+      "type": "model"
+    },
+    {
+      "name": "MAX_CONCURRENT_SUBAGENTS",
+      "default": 4,
+      "label": "Concurrent subagents",
+      "description": "Maximum concurrent Claude/Codex subagent threads.",
+      "type": "integer",
+      "min": 1
+    }
+  ]
+}

package/bin/runbook/subconscious-code/agent.json

@@ -0,0 +1,156 @@
+{
+  "id": "subconscious-code",
+  "command": "marathon",
+  "aliases": ["sc", "subconscious-code"],
+  "name": "Marathon",
+  "description": "Launch the native Subconscious coding agent with the active profile, gateway, and model.",
+  "protocol": "openai",
+  "homepage": "https://github.com/subconscious-systems/subconscious-code",
+  "install": {
+    "commands": {
+      "darwin": "subc marathon install",
+      "linux": "subc marathon install",
+      "win32": "subc marathon install"
+    },
+    "method": "github-release",
+    "repository": "subconscious-systems/subconscious-code",
+    "version": "latest",
+    "pin_env": "SC_CODE_VERSION",
+    "asset": "marathon-{target}.tar.gz",
+    "checksum": "marathon-{target}.tar.gz.sha256",
+    "legacy_asset": "sc-{target}.tar.gz",
+    "targets": [
+      "aarch64-apple-darwin",
+      "x86_64-apple-darwin",
+      "aarch64-unknown-linux-musl",
+      "x86_64-unknown-linux-musl"
+    ],
+    "install_dir": "~/.local/bin",
+    "install_dir_env": "SC_INSTALL_DIR",
+    "minimum_version": null,
+    "verified": true,
+    "windows_targets": ["x86_64-pc-windows-msvc", "aarch64-pc-windows-msvc"],
+    "windows_assets": [
+      "marathon-{target}.zip",
+      "marathon-{target}.exe",
+      "sc-{target}.zip",
+      "sc-{target}.exe"
+    ],
+    "note": "Windows installs come from the native launcher, which takes the first asset in windows_assets that the release has, plus its .sha256."
+  },
+  "runbook": {
+    "mode": "launch",
+    "setup_script": "install.sh",
+    "setup_actions": ["install"],
+    "setup_needs_auth": false,
+    "binary_install_script": "install.sh"
+  },
+  "help": {
+    "usage": "subc [-p NAME] marathon [help|install] [Marathon arguments...]",
+    "behavior": "Launches the native Subconscious coding agent with the selected profile gateway, credential, and model.",
+    "options": [
+      ["help", "Show this help"],
+      [
+        "install",
+        {
+          "win32": "Install a verified Windows release, when published upstream",
+          "default": "Install the latest precompiled Linux or macOS release"
+        }
+      ],
+      ["--model MODEL", "Override the profile model for this launch"]
+    ],
+    "args": ["ARGS...", "Pass arguments directly to Marathon"]
+  },
+  "sessions": { "key": "sc", "portable": false },
+  "prerequisites": [
+    { "command": "gh|curl", "needed_for": "install", "required": true },
+    {
+      "command": "sha256sum|shasum",
+      "needed_for": "install",
+      "required": true
+    },
+    { "command": "tar", "needed_for": "install", "required": true }
+  ],
+  "launch": {
+    "argv": ["marathon", "{args}"],
+    "headless_argv": ["marathon", "--print={prompt}", "{args}"],
+    "headless_platforms": ["darwin", "linux"],
+    "resume": ["--resume", "{sessionFile}"],
+    "persistent_setup": false
+  },
+  "inputs": [
+    {
+      "name": "SC_API_KEY",
+      "label": "Subconscious Code API key",
+      "description": "Subconscious Code credential override; blank uses API_KEY.",
+      "type": "secret"
+    }
+  ],
+  "env": [
+    {
+      "name": "SC_API_KEY",
+      "value": "{apiKey}",
+      "description": "Gateway credential."
+    },
+    {
+      "name": "SC_BASE_URL",
+      "value": "{baseUrlV1}",
+      "description": "OpenAI-compatible base URL for model requests."
+    },
+    {
+      "name": "SC_DLR_URL",
+      "value": "{baseUrl}",
+      "description": "Gateway origin for Marathon's DLR feature.",
+      "note": "What DLR does is defined in the Marathon binary, not in this repo."
+    },
+    {
+      "name": "SC_DLR_ENABLED",
+      "value": "true",
+      "description": "Turns Marathon's DLR feature on.",
+      "note": "What DLR does is defined in the Marathon binary, not in this repo."
+    },
+    {
+      "name": "SC_MODEL",
+      "value": "{model}",
+      "description": "Model for the session."
+    }
+  ],
+  "config": [],
+  "capabilities": {
+    "compaction": {
+      "default": "unknown",
+      "on": {
+        "set_by_subc": false,
+        "kind": null,
+        "name": null,
+        "value": null,
+        "verified": false,
+        "note": "subc sets no compaction knob; Marathon's built-in behaviour applies."
+      },
+      "off": {
+        "set_by_subc": false,
+        "kind": null,
+        "name": null,
+        "value": null,
+        "verified": false,
+        "note": "No off knob is set or documented by subc."
+      },
+      "threshold": {
+        "set_by_subc": false,
+        "kind": null,
+        "name": null,
+        "value": null,
+        "verified": false,
+        "note": "No threshold knob is set or documented by subc."
+      }
+    },
+    "mcp": {
+      "configured_by_subc": false,
+      "transports": null,
+      "verified": false,
+      "note": "subc configures no MCP servers. Transports Marathon supports are not described in this repo."
+    },
+    "headers": [],
+    "hooks": []
+  }
+}