subconscious-cli 6.0.1 → 6.2.0

package/bin/runbook/lib.sh

@@ -0,0 +1,41 @@
+# shellcheck shell=bash
+# subc sets every value a runbook reads, so a runbook declares no defaults
+# of its own.
+
+# Exact IDs only: similarly named models do not inherit capabilities.
+subc_model_supports_vision() {
+  local model
+  while IFS= read -r model; do
+    [[ -n "$model" && "$model" == "${1:-}" ]] && return 0
+  done <<< "${SUBC_VISION_MODELS:-}"
+  return 1
+}
+
+# Replace this shell with the agent argv subc built:
+#   subc_exec [PLACEHOLDER VALUE]... -- ARGV...
+# Only the first SUBC_TEMPLATE_WORDS words came from the agent's argv
+# template; passed-through arguments and the prompt after them are never
+# rewritten, whatever they contain.
+subc_exec() {
+  local names=() values=() argv=() word index=0 i
+  while [[ $# -gt 0 && "$1" != "--" ]]; do
+    names+=("$1")
+    values+=("$2")
+    shift 2
+  done
+  shift
+  local limit="${SUBC_TEMPLATE_WORDS:-0}"
+  unset SUBC_TEMPLATE_WORDS SUBC_MODEL_IDS SUBC_VISION_MODELS
+  for word in "$@"; do
+    if [[ "$index" -lt "$limit" ]]; then
+      for ((i = 0; i < ${#names[@]}; i++)); do
+        if [[ "$word" == *"${names[i]}"* ]]; then
+          word="${word%%"${names[i]}"*}${values[i]}${word#*"${names[i]}"}"
+        fi
+      done
+    fi
+    argv+=("$word")
+    index=$((index + 1))
+  done
+  exec "${argv[@]}"
+}

package/bin/runbook/opencode/agent.json

@@ -0,0 +1,159 @@
+{
+  "id": "opencode",
+  "command": "opencode",
+  "aliases": ["open-code"],
+  "name": "OpenCode",
+  "description": "Run OpenCode on your hosted Subconscious model with the Subconscious provider and context settings.",
+  "protocol": "openai",
+  "homepage": "https://opencode.ai",
+  "install": {
+    "commands": {
+      "darwin": "npm i -g {package}",
+      "linux": "npm i -g {package}",
+      "win32": "npm i -g {package}"
+    },
+    "url": "https://opencode.ai/docs",
+    "method": "npm",
+    "package": "opencode-ai",
+    "version": null,
+    "channel": "latest (unpinned)",
+    "install_dir": "~/.opencode/bin",
+    "minimum_version": null,
+    "verified": true
+  },
+  "runbook": {
+    "mode": "launch",
+    "setup_script": "install.sh",
+    "setup_actions": ["status", "uninstall"]
+  },
+  "help": {
+    "usage": "subc [-p NAME] opencode [help|status|uninstall] [OpenCode arguments...]",
+    "behavior": "Launches OpenCode with an ephemeral provider containing every Subconscious model. Persistent files are leftover-only: subc opencode uninstall.",
+    "options": [
+      ["help", "Show this help"],
+      ["status", "Inspect leftover OpenCode Subconscious config"],
+      [
+        "uninstall",
+        "Remove only the Subconscious OpenCode provider and plugin"
+      ],
+      ["--model MODEL", "Override the profile model for this launch"]
+    ],
+    "args": ["ARGS...", "Pass arguments directly to OpenCode"]
+  },
+  "sessions": { "key": "opencode", "portable": true },
+  "prerequisites": [],
+  "launch": {
+    "argv": ["opencode", "{args}"],
+    "headless_argv": ["opencode", "run", "{args}"],
+    "headless_stdin": "{prompt}",
+    "headless_platforms": ["darwin", "linux"],
+    "resume": ["--session", "{sessionId}"],
+    "handoff": ["--prompt", "{prompt}"],
+    "persistent_setup": false
+  },
+  "inputs": [
+    {
+      "name": "OPENCODE_API_KEY",
+      "label": "OpenCode API key",
+      "description": "OpenCode-specific credential override; blank uses API_KEY.",
+      "type": "secret"
+    },
+    {
+      "name": "OPENCODE_CONTEXT_LIMIT",
+      "default": 5000000,
+      "label": "Context limit",
+      "description": "OpenCode provider context limit used for compaction.",
+      "type": "integer",
+      "min": 1
+    },
+    {
+      "name": "OPENCODE_OUTPUT_LIMIT",
+      "default": 65536,
+      "label": "Output limit",
+      "description": "Maximum output tokens advertised to OpenCode.",
+      "type": "integer",
+      "min": 1
+    }
+  ],
+  "env": [
+    {
+      "name": "SUBCONSCIOUS_API_KEY",
+      "value": "{apiKey}",
+      "description": "Credential, referenced as {env:SUBCONSCIOUS_API_KEY} in the provider config."
+    },
+    {
+      "name": "SUBCONSCIOUS_GATEWAY_URL",
+      "value": "{baseUrl}",
+      "description": "Gateway origin for the compaction plugin, when one is installed."
+    },
+    {
+      "name": "OPENCODE_CONFIG_CONTENT",
+      "value": "{opencodeConfig}",
+      "description": "Whole OpenCode config for this launch; see the config entry. Nothing is written to disk."
+    }
+  ],
+  "config": [
+    {
+      "kind": "env-json",
+      "name": "OPENCODE_CONFIG_CONTENT",
+      "lifetime": "launch",
+      "value": "{opencodeConfig}",
+      "description": "Provider, models, limits and image-window plugin, built for every catalog model."
+    },
+    {
+      "kind": "file",
+      "path": "~/.config/opencode/plugins/subconscious-compaction.ts",
+      "lifetime": "legacy",
+      "description": "Compaction plugin from older persistent setup. Launch never writes it; subc opencode uninstall removes it."
+    }
+  ],
+  "capabilities": {
+    "compaction": {
+      "default": "on",
+      "on": {
+        "set_by_subc": true,
+        "kind": "config-field",
+        "name": "provider.subconscious.models.<id>.limit.context",
+        "value": "${OPENCODE_CONTEXT_LIMIT}",
+        "verified": false,
+        "note": "subc sets limit.context. That auto-compaction keys off it comes only from an install.sh comment and the profile setting description.",
+        "config": "OPENCODE_CONFIG_CONTENT"
+      },
+      "off": {
+        "set_by_subc": false,
+        "kind": "config-field",
+        "name": "compaction.auto",
+        "value": false,
+        "verified": false,
+        "note": "Upstream OpenCode setting. subc never sets it, and this repo does not confirm its name or behaviour.",
+        "config": "OpenCode config"
+      },
+      "threshold": {
+        "set_by_subc": true,
+        "kind": "config-field",
+        "name": "provider.subconscious.models.<id>.limit.context",
+        "value": "${OPENCODE_CONTEXT_LIMIT}",
+        "verified": false,
+        "semantics": "window",
+        "config": "OPENCODE_CONFIG_CONTENT",
+        "note": "subc sets limit.context. That auto-compaction keys off it comes only from an install.sh comment and the profile setting description."
+      }
+    },
+    "mcp": {
+      "configured_by_subc": false,
+      "transports": null,
+      "verified": false,
+      "note": "OPENCODE_CONFIG_CONTENT carries no mcp block. Whether OpenCode merges user MCP config with it is not confirmed here."
+    },
+    "headers": [
+      {
+        "name": "x-subconscious-client",
+        "value": "opencode",
+        "on": "model requests",
+        "set_by_subc": true,
+        "verified": true
+      }
+    ],
+    "hooks": []
+  }
+}

package/bin/runbook/opencode/install.sh

@@ -1,75 +1,17 @@
 #!/usr/bin/env bash
-# ── Subconscious API Gateway — OpenCode setup ─────────────────────────────────
-# Point OpenCode at your gateway. Writes a provider config with session headers
-# so the gateway can correlate OpenCode requests into Conversations.
+# ── Subconscious API Gateway — OpenCode leftovers ─────────────────────────────
+# OpenCode is launch-only: `subc opencode` passes the provider config in
+# OPENCODE_CONFIG_CONTENT and writes nothing. Older persistent setups wrote a
+# provider into ~/.opencode/opencode.json, an env file, and a compaction
+# plugin; this script reports and removes those.
 #
-# Quick start:
-#   ./install.sh --gateway-url https://your-gateway.example --api-key sk-gw-...
-#   ./install.sh status                 # show current config
-#   ./install.sh uninstall              # revert to default opencode config
-#
-# Writes ~/.opencode/opencode.json (user config). Does not touch project-level
-# opencode.json files. Restart opencode after install.
-#
-# ── What this does under the hood ────────────────────────────────────────────
-# Equivalent manual setup (writes ~/.opencode/opencode.json + env var):
-#
-#   export SUBCONSCIOUS_API_KEY=sk-gw-...
-#   cat > ~/.opencode/opencode.json <<'EOF'
-#   {
-#     "$schema": "https://opencode.ai/config.json",
-#     "provider": {
-#       "subconscious": {
-#         "npm": "@ai-sdk/openai-compatible",
-#         "name": "Subconscious Gateway",
-#         "options": {
-#           "baseURL": "https://your-gateway.example/v1",
-#           "apiKey": "{env:SUBCONSCIOUS_API_KEY}",
-#           "headers": { "x-subconscious-client": "opencode" }
-#         },
-#         "models": {
-#           "subconscious/glm-5.3-marathon": {
-#             "name": "subconscious/glm-5.3-marathon",
-#             "tools": true,
-#             "limit": { "context": 5000000, "output": 65536 }
-#           }
-#         }
-#       }
-#     },
-#     "model": "subconscious/subconscious/glm-5.3-marathon"
-#   }
-#   EOF
-#   opencode
-#
-# The x-subconscious-client header tells the gateway to classify traffic as
-# OpenCode. OpenCode also sends native x-session-affinity / x-session-id
-# headers for conversation correlation. Model limit.context drives auto
-# compaction (default on); custom providers do not inherit models.dev limits.
-#
-# Also installs a plugin that reports compactions to the gateway. OpenCode
-# summarizes through the configured provider, so without it the gateway counts
-# that summarization as a normal main-thread turn.
+#   subc opencode status
+#   subc opencode uninstall
 # ─────────────────────────────────────────────────────────────────────────────
 
 set -euo pipefail
 
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "${SCRIPT_DIR}/../model-capabilities.generated.sh"
-source "${SCRIPT_DIR}/provider.sh"
-
-# 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
-
-COMMAND="install"
-GATEWAY_URL="${GATEWAY_URL:-}"
-API_KEY="${OPENCODE_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
-# OpenCode auto-compaction uses model limit.context. Custom openai-compatible
-# providers do not get that from baseURL/models.dev; set it explicitly.
-CONTEXT_LIMIT="${OPENCODE_CONTEXT_LIMIT:-5000000}"
-OUTPUT_LIMIT="${OPENCODE_OUTPUT_LIMIT:-65536}"
+COMMAND="status"
 
 usage() {
   cat <<'EOF'
@@ -85,30 +27,10 @@ EOF
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    install|uninstall|status)
+    uninstall|status)
       COMMAND="$1"
       shift
       ;;
-    --gateway-url)
-      GATEWAY_URL="${2:-}"
-      shift 2
-      ;;
-    --api-key)
-      API_KEY="${2:-}"
-      shift 2
-      ;;
-    --model)
-      MODEL="${2:-}"
-      shift 2
-      ;;
-    --context-limit)
-      CONTEXT_LIMIT="${2:-}"
-      shift 2
-      ;;
-    --output-limit)
-      OUTPUT_LIMIT="${2:-}"
-      shift 2
-      ;;
     -h|--help)
       usage
       exit 0
@@ -121,35 +43,6 @@ 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}"
-
-subc_opencode_build_models_json
-
 OPENCODE_DIR="${HOME}/.opencode"
 OPENCODE_CONFIG="${OPENCODE_DIR}/opencode.json"
 MARKER='x-subconscious-client'
@@ -157,59 +50,6 @@ MARKER='x-subconscious-client'
 # config path above. Docs: https://opencode.ai/docs/plugins/
 PLUGIN_DIR="${XDG_CONFIG_HOME:-${HOME}/.config}/opencode/plugins"
 PLUGIN_FILE="${PLUGIN_DIR}/subconscious-compaction.ts"
-PLUGIN_SOURCE="${SCRIPT_DIR}/subconscious-compaction.ts"
-
-require_cmds() {
-  local missing=0
-  for c in jq; do
-    if ! command -v "$c" >/dev/null 2>&1; then
-      echo "missing required command: $c" >&2
-      missing=1
-    fi
-  done
-  if [[ "$missing" -ne 0 ]]; then
-    exit 1
-  fi
-}
-
-write_config() {
-  mkdir -p "$OPENCODE_DIR"
-  local base_url="${GATEWAY_URL%/}/v1"
-  local provider selected_model
-  provider="$(subc_opencode_build_provider_json "$base_url")"
-  selected_model="${SUBC_OPENCODE_PROVIDER_ID}/${MODEL}"
-  if [[ -f "$OPENCODE_CONFIG" ]]; then
-    local tmp
-    tmp="$(mktemp)"
-    jq --argjson provider "$provider" --arg model "$selected_model" --arg provider_id "$SUBC_OPENCODE_PROVIDER_ID" '
-      .provider = (.provider // {})
-      | .provider[$provider_id] = $provider
-      | .model = $model
-    ' "$OPENCODE_CONFIG" >"$tmp"
-    mv "$tmp" "$OPENCODE_CONFIG"
-  else
-    jq -n --argjson provider "$provider" --arg model "$selected_model" --arg provider_id "$SUBC_OPENCODE_PROVIDER_ID" \
-      '{ "$schema": "https://opencode.ai/config.json", provider: {($provider_id): $provider}, model: $model }' \
-      >"$OPENCODE_CONFIG"
-  fi
-  local env_file="${OPENCODE_DIR}/subconscious.env"
-  umask 077
-  cat >"$env_file" <<EOF
-# Generated by subc — do not commit secrets.
-export SUBCONSCIOUS_API_KEY='${API_KEY}'
-export SUBCONSCIOUS_GATEWAY_URL='${GATEWAY_URL%/}'
-EOF
-  chmod 600 "$env_file"
-}
-
-write_plugin() {
-  if [[ ! -f "$PLUGIN_SOURCE" ]]; then
-    echo "warning: ${PLUGIN_SOURCE} missing; skipping compaction plugin" >&2
-    return
-  fi
-  mkdir -p "$PLUGIN_DIR"
-  cp "$PLUGIN_SOURCE" "$PLUGIN_FILE"
-}
 
 uninstall_config() {
   if [[ -f "$OPENCODE_CONFIG" ]]; then
@@ -257,20 +97,6 @@ status() {
 }
 
 case "$COMMAND" in
-  install)
-    require_cmds
-    if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
-      echo "--gateway-url and --api-key are required for install" >&2
-      exit 1
-    fi
-    write_config
-    write_plugin
-    echo "Merged Subconscious OpenCode provider into $OPENCODE_CONFIG"
-    if [[ -f "$PLUGIN_FILE" ]]; then
-      echo "Installed compaction reporting plugin at $PLUGIN_FILE"
-    fi
-    echo "Launch OpenCode with: subc opencode"
-    ;;
   uninstall)
     uninstall_config
     echo "Removed Subconscious OpenCode files; left $OPENCODE_CONFIG in place"

package/bin/runbook/opencode/opencode-plugin.d.ts

@@ -1,9 +1,16 @@
-// OpenCode loads this plugin. The host package is not a dependency of the CLI.
+// OpenCode loads these plugins. The host package is not a dependency of the CLI,
+// so only the hooks our plugins use are declared.
 declare module '@opencode-ai/plugin' {
+  type ProviderConfig = {
+    options?: Record<string, unknown> & { fetch?: typeof fetch };
+  };
   export type Plugin = () => Promise<{
-    'experimental.session.compacting': (input: {
+    'experimental.session.compacting'?: (input: {
       sessionID: string;
     }) => Promise<void>;
-    event: (args: { event: { type: string } }) => Promise<void>;
+    event?: (args: { event: { type: string } }) => Promise<void>;
+    config?: (config: {
+      provider?: Record<string, ProviderConfig>;
+    }) => Promise<void>;
   }>;
 }

package/bin/runbook/opencode/subconscious-image-window.ts

@@ -0,0 +1,24 @@
+/**
+ * Keep OpenCode's requests to Subconscious at the newest 30 images.
+ *
+ * OpenCode resends every screenshot on every turn, so a long session's upload
+ * grows until the gateway refuses it. This gives the `subconscious` provider a
+ * fetch that trims the request body before it leaves (bin/runbook/image-window),
+ * the same rule the gateway applies, so Subconscious Cache still reuses the
+ * rest. OpenCode reads provider settings after plugins' config hooks run, so a
+ * function set here becomes the provider's fetch.
+ *
+ * Loaded by path from the launch config; nothing is written to disk.
+ */
+
+import type { Plugin } from '@opencode-ai/plugin';
+import { windowFetch } from '../image-window/window.js';
+
+export const SubconsciousImageWindow: Plugin = async () => ({
+  config: async (config) => {
+    const provider = config.provider?.subconscious;
+    if (!provider) return;
+    const base = provider.options?.fetch ?? fetch;
+    provider.options = { ...provider.options, fetch: windowFetch(base) };
+  },
+});