subconscious-cli 6.0.0 → 6.1.0

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

@@ -31,40 +31,45 @@
  *       https://pi.dev/docs/latest/extensions
  */
 
-import { readFileSync } from "node:fs"
-import { homedir } from "node:os"
-import { join } from "node:path"
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
 
-const TIMEOUT_MS = 2000
+const TIMEOUT_MS = 2000;
 
-type CompactPhase = "start" | "end"
+type CompactPhase = 'start' | 'end';
 
-let envFileLoaded = false
+let envFileLoaded = false;
 
 function loadSubconsciousEnvFile(): void {
-  if (envFileLoaded) return
-  envFileLoaded = true
-  if (process.env.SUBCONSCIOUS_GATEWAY_URL && process.env.SUBCONSCIOUS_API_KEY) {
-    return
+  if (envFileLoaded) return;
+  envFileLoaded = true;
+  if (
+    process.env.SUBCONSCIOUS_GATEWAY_URL &&
+    process.env.SUBCONSCIOUS_API_KEY
+  ) {
+    return;
   }
   try {
-    const path = join(homedir(), ".pi", "agent", "subconscious.env")
-    const text = readFileSync(path, "utf8")
-    for (const line of text.split("\n")) {
-      const trimmed = line.trim()
-      if (!trimmed || trimmed.startsWith("#")) continue
-      const m = trimmed.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=(.*)$/)
-      if (!m) continue
-      const key = m[1]
-      let val = m[2]
+    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();
+      if (!trimmed || trimmed.startsWith('#')) continue;
+      const m = trimmed.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
+      if (!m) continue;
+      const key = m[1];
+      let val = m[2];
       if (
         (val.startsWith('"') && val.endsWith('"')) ||
         (val.startsWith("'") && val.endsWith("'"))
       ) {
-        val = val.slice(1, -1)
+        val = val.slice(1, -1);
       }
       if (process.env[key] === undefined) {
-        process.env[key] = val
+        process.env[key] = val;
       }
     }
   } catch {
@@ -73,14 +78,18 @@ function loadSubconsciousEnvFile(): void {
 }
 
 function gatewayUrl(): string | undefined {
-  loadSubconsciousEnvFile()
-  const raw = process.env.SUBCONSCIOUS_GATEWAY_URL ?? process.env.GATEWAY_URL
-  return raw ? raw.replace(/\/+$/, "") : undefined
+  loadSubconsciousEnvFile();
+  const raw = process.env.SUBCONSCIOUS_GATEWAY_URL ?? process.env.GATEWAY_URL;
+  return raw ? raw.replace(/\/+$/, '') : undefined;
 }
 
 function apiKey(): string | undefined {
-  loadSubconsciousEnvFile()
-  return process.env.SUBCONSCIOUS_API_KEY ?? process.env.API_KEY ?? process.env.PI_API_KEY
+  loadSubconsciousEnvFile();
+  return (
+    process.env.SUBCONSCIOUS_API_KEY ??
+    process.env.API_KEY ??
+    process.env.PI_API_KEY
+  );
 }
 
 async function report(
@@ -89,25 +98,25 @@ async function report(
   hookEventName: string,
   metadata?: Record<string, unknown>,
 ): Promise<void> {
-  const url = gatewayUrl()
-  const key = apiKey()
-  if (!url || !key || !sessionID) return
+  const url = gatewayUrl();
+  const key = apiKey();
+  if (!url || !key || !sessionID) return;
 
   // Unique per event, stable for a transport-level retry of this same POST.
-  const dedupeKey = `${sessionID}:${phase}:${Date.now()}`
+  const dedupeKey = `${sessionID}:${phase}:${Date.now()}`;
 
-  const controller = new AbortController()
-  const timer = setTimeout(() => controller.abort(), TIMEOUT_MS)
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
   try {
     await fetch(`${url}/v1/agent-hooks`, {
-      method: "POST",
+      method: 'POST',
       headers: {
-        "content-type": "application/json",
+        'content-type': 'application/json',
         authorization: `Bearer ${key}`,
-        "x-subconscious-client": "pi",
+        'x-subconscious-client': 'pi',
       },
       body: JSON.stringify({
-        event: "conversation_compaction",
+        event: 'conversation_compaction',
         conversation_id: sessionID,
         phase,
         hook_event_name: hookEventName,
@@ -115,37 +124,50 @@ async function report(
         metadata: metadata ?? undefined,
       }),
       signal: controller.signal,
-    })
+    });
   } catch {
     // Fail open on timeout, offline gateway, or auth failure.
   } finally {
-    clearTimeout(timer)
+    clearTimeout(timer);
   }
 }
 
+type PiCompactEvent = {
+  reason?: unknown;
+  preparation?: { tokensBefore?: unknown };
+  fromExtension?: unknown;
+};
+
+type PiContext = {
+  sessionManager?: { getSessionId?: () => string | undefined };
+};
+
 // Pi auto-discovers default-exported extension factories from
 // ~/.pi/agent/extensions/*.ts. See https://pi.dev/docs/latest/extensions
 export default function (pi: {
-  on: (event: string, handler: (...args: any[]) => any) => void
+  on: (
+    event: string,
+    handler: (event: PiCompactEvent, ctx: PiContext) => Promise<void>,
+  ) => void;
 }) {
-  pi.on("session_before_compact", async (event: any, ctx: any) => {
-    const sessionID = ctx?.sessionManager?.getSessionId?.()
+  pi.on('session_before_compact', async (event, ctx) => {
+    const sessionID = ctx?.sessionManager?.getSessionId?.();
     if (sessionID) {
-      await report(sessionID, "start", "session_before_compact", {
+      await report(sessionID, 'start', 'session_before_compact', {
         reason: event?.reason ?? null,
         tokens_before: event?.preparation?.tokensBefore ?? null,
-      })
+      });
     }
     // Deliberately return nothing: do not cancel or replace summarization.
-  })
+  });
 
-  pi.on("session_compact", async (event: any, ctx: any) => {
-    const sessionID = ctx?.sessionManager?.getSessionId?.()
+  pi.on('session_compact', async (event, ctx) => {
+    const sessionID = ctx?.sessionManager?.getSessionId?.();
     if (sessionID) {
-      await report(sessionID, "end", "session_compact", {
+      await report(sessionID, 'end', 'session_compact', {
         reason: event?.reason ?? null,
         from_extension: event?.fromExtension ?? null,
-      })
+      });
     }
-  })
+  });
 }

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": []
+  }
+}