loki-mode 8.0.3 → 8.2.0

package/providers/opencode.sh

@@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+# opencode Provider Configuration
+# Shell-sourceable config for loki-mode multi-provider support.
+#
+# WHY THIS PROVIDER EXISTS
+#   opencode is the model-agnostic route. It reaches 75+ providers through the
+#   AI SDK + Models.dev registry, supports ANY OpenAI-compatible endpoint via
+#   `@ai-sdk/openai-compatible`, and runs local models (Ollama, LM Studio,
+#   llama.cpp). Users can add providers that are NOT in its built-in list -- it
+#   is a registry, not a hardcoded table.
+#
+#   That matters because our own catalog is a fixed four-key file. Driving
+#   opencode gives users every cheap open model without us maintaining a model
+#   list per vendor.
+#
+#   Verified 2026-07-29/30:
+#     - opencode.ai/docs/providers documents 75+ providers and custom
+#       OpenAI-compatible endpoints.
+#     - anomalyco/opencode: 190,871 stars, release v1.18.9 (2026-07-28), pushed
+#       same week. Actively developed. (By contrast aider's last release is
+#       v0.86.0 from 2025-08-09, and Roo Code is archived, Continue read-only --
+#       so opencode, not aider, is the durable cheap-model route.)
+#
+#   Cost context (SWE-bench uniform scaffold, mini-swe-agent v2.0.0, 2026-02-17):
+#   MiniMax M2.5 resolved 75.8 at $36.64 total vs Claude Opus 4.6 at 75.6 for
+#   $275.76 -- an open model matching frontier accuracy at ~7.5x lower cost.
+#
+# CLI SURFACE (verified against the installed binary, v1.17.9, not assumed):
+#   opencode run [message..]     non-interactive run
+#     -m, --model provider/model model selection
+#     --agent NAME               agent selection
+#     --print-logs               logs to stderr
+#   opencode models [provider]   list available models
+#   opencode providers           manage providers/credentials
+#
+# Usage:
+#   source providers/opencode.sh
+#   if provider_detect; then provider_invoke "Your prompt here"; fi
+# =====================================
+
+# Provider Identity
+PROVIDER_NAME="opencode"
+PROVIDER_DISPLAY_NAME="opencode (75+ providers, model-agnostic)"
+PROVIDER_CLI="opencode"
+
+# CLI Invocation
+# `run` takes the prompt POSITIONALLY; there is no -p/--prompt flag.
+PROVIDER_SUBCOMMAND="run"
+PROVIDER_AUTONOMOUS_FLAG=""
+PROVIDER_PROMPT_FLAG=""
+PROVIDER_PROMPT_POSITIONAL=true
+
+# Skill System
+PROVIDER_SKILL_DIR="${HOME}/.config/opencode"
+PROVIDER_SKILL_FORMAT="markdown"
+
+# Capability Flags
+# Ranked by MODELS UNLOCKED, not by how Claude-like the CLI is. opencode has no
+# Task tool, but it reaches every cheap model, which is the axis that matters
+# for cost. It is not "degraded" -- it is differently capable.
+PROVIDER_HAS_SUBAGENTS=false
+PROVIDER_HAS_PARALLEL=false
+PROVIDER_HAS_TASK_TOOL=false
+PROVIDER_HAS_MCP=true          # `opencode mcp` manages MCP servers
+PROVIDER_MAX_PARALLEL=1
+PROVIDER_DEGRADED=false
+PROVIDER_MAX_OUTPUT_TOKENS=128000
+
+# Model defaults. opencode names models "provider/model"; the catalog supplies
+# the value and the standard LOKI_<PROVIDER>_MODEL_<TIER> chain overrides it.
+_opencode_default_from_catalog() {
+    if type loki_latest_model >/dev/null 2>&1; then
+        loki_latest_model opencode development 2>/dev/null && return 0
+    fi
+    printf 'openrouter/deepseek/deepseek-v3.2'
+}
+OPENCODE_DEFAULT_MODEL="${LOKI_OPENCODE_MODEL:-${LOKI_MODEL_DEVELOPMENT:-$(_opencode_default_from_catalog)}}"
+PROVIDER_MODEL_PLANNING="$OPENCODE_DEFAULT_MODEL"
+PROVIDER_MODEL_DEVELOPMENT="$OPENCODE_DEFAULT_MODEL"
+PROVIDER_MODEL_FAST="$OPENCODE_DEFAULT_MODEL"
+
+# provider_detect -- is the CLI installed?
+provider_detect() {
+    command -v opencode >/dev/null 2>&1
+}
+
+# provider_version -- CLI version string (empty when absent).
+provider_version() {
+    command -v opencode >/dev/null 2>&1 || return 1
+    opencode --version 2>/dev/null | head -1
+}
+
+# provider_get_tier_param -- map a loki tier to an opencode model id.
+# opencode has no opus/sonnet/haiku tier concept, so all three tiers resolve to
+# one model unless the operator overrides per tier. This mirrors the codex
+# provider, where tier flattening is already an accepted shape.
+provider_get_tier_param() {
+    local tier="${1:-development}"
+    case "$tier" in
+        planning)    printf '%s' "$PROVIDER_MODEL_PLANNING" ;;
+        fast)        printf '%s' "$PROVIDER_MODEL_FAST" ;;
+        *)           printf '%s' "$PROVIDER_MODEL_DEVELOPMENT" ;;
+    esac
+}
+
+# provider_invoke <prompt> -- run one non-interactive turn.
+provider_invoke() {
+    # CONTRACT: prompt is $1, and EXTRA ARGS MUST PASS THROUGH. The first cut of
+    # this provider used `local prompt="${1:-}"` with no `shift`, which silently
+    # DROPPED every caller-supplied flag -- callers pass model overrides and
+    # per-invocation flags positionally after the prompt. Dropping them fails
+    # quietly: opencode still runs, just not with what the caller asked for,
+    # which is the worst shape for a provider-agnostic route to fail in.
+    # tests/test-provider-invocation.sh asserts this signature for EVERY
+    # provider precisely so a new one cannot skip it.
+    local prompt="$1"
+    shift
+    [ -n "$prompt" ] || return 1
+    command -v opencode >/dev/null 2>&1 || return 127
+    opencode run --model "$PROVIDER_MODEL_DEVELOPMENT" "$prompt" "$@"
+}
+
+# provider_invoke_with_tier <tier> <prompt>
+provider_invoke_with_tier() {
+    # Same contract as provider_invoke, with the tier ahead of the prompt:
+    # tier=$1, prompt=$2, `shift 2`, remainder forwarded verbatim.
+    local tier="$1"
+    local prompt="$2"
+    shift 2
+    [ -n "$tier" ] || tier="development"
+    [ -n "$prompt" ] || return 1
+    command -v opencode >/dev/null 2>&1 || return 127
+    local model
+    model="$(provider_get_tier_param "$tier")"
+    opencode run --model "$model" "$prompt" "$@"
+}
+
+# provider_invoke_argv <tier> <prompt> -- see providers/claude.sh for rationale.
+provider_invoke_argv() {
+    local tier="${1:-development}"
+    local prompt="${2:-}"
+    local model
+    model="$(provider_get_tier_param "$tier")"
+    _LOKI_INVOKE_ARGV=(opencode run --model "$model" "$prompt")
+}

package/references/design-archetypes.md

@@ -0,0 +1,85 @@
+# DESIGN ARCHETYPES (pick exactly ONE)
+
+Do not average these together and do not invent a fourth palette hue. Choose the
+single archetype whose mood matches the product domain, then hold it on every
+surface: palette, type pairing, spacing rhythm, and layout skeleton. A build that
+commits fully to the "wrong" archetype still looks designed; a build that blends
+two looks generated.
+
+Every hex below is a real Radix Colors step. Every font below is real and served
+by Google Fonts, so `@import` / `next/font` resolves at build time. Steps map to
+roles: 2 = page background, 3 = raised surface, 6 = border, 9 = solid accent,
+11 = accent text on light, 12 = body text.
+
+## 1. EDITORIAL (publishing, long-form, research, journalism, docs)
+- Palette: bg #f9f9f8, surface #f1f0ef, border #dad9d6, accent #d13415, text #21201c
+- Type: Newsreader (display, 600) + Public Sans (body, 400). Headline 3.5rem, leading 1.05, tracking -0.02em.
+- Layout: single measured column, 68ch max. Asymmetric: text left, wide margin right for notes and pull quotes. Rules (1px, border color) separate sections, not cards.
+- Signature move: an oversized drop-cap or a hanging marginal note. Body text at 1.125rem with 1.7 leading.
+
+## 2. BRUTALIST (developer tools, infra, dashboards, technical products)
+- Palette: bg #f0f0f0, surface #f9f9f9, border #202020, accent #e54d2e, text #202020
+- Type: Space Grotesk (display, 700) + JetBrains Mono (body/UI, 400). Headline 4rem, leading 0.95, tracking -0.03em.
+- Layout: hard 2px black borders, zero border-radius, zero shadows. Visible grid lines. Elements butt directly against each other with no gap.
+- Signature move: monospace labels in UPPERCASE with 0.1em tracking. Offset/stacked blocks instead of centered ones.
+
+## 3. LUXURY (hospitality, jewelry, real estate, private services, fine dining)
+- Palette: bg #faf9f2, surface #f2f0e7, border #d8d0bf, accent #71624b, text #3b352b
+- Type: Playfair Display (display, 400) + Lora (body, 400). Headline 4.5rem, leading 1.1, tracking 0.01em.
+- Layout: enormous whitespace, generous 8rem+ section padding. Full-bleed imagery. Content sits low and left, never centered in a card.
+- Signature move: letterspaced small-caps eyebrow text above headings. Thin 1px gold rules. No shadows at all.
+
+## 4. RETRO-FUTURE (music, gaming, crypto, creative tools, events)
+- Palette: bg #1c2024, surface #21201c, border #43302b, accent #ffc53d, text #f1f0ef
+- Type: Syne (display, 800) + Chivo (body, 400). Headline 4rem, leading 1.0, tracking -0.02em.
+- Layout: deliberate dark ground (this is the one archetype where dark is the point, not a reflex). Amber accent used sparingly on one element per viewport.
+- Signature move: thin amber outline on interactive elements. Slight text glow via text-shadow on the hero only.
+
+## 5. SOFT / PASTEL (wellness, education, kids, community, journaling)
+- Palette: bg #f2fbf9, surface #ddf9f2, border #9ce0d0, accent #027864, text #16433c
+- Type: Fraunces (display, 600, opsz soft) + DM Sans (body, 400). Headline 3.25rem, leading 1.15.
+- Layout: large border-radius (24px+) used consistently, never mixed with sharp corners. Rounded blob or arc shapes in the background.
+- Signature move: overlapping soft shapes behind content. Illustrative, generous line-height (1.75) body text.
+
+## 6. INDUSTRIAL (logistics, manufacturing, field ops, B2B operations)
+- Palette: bg #f8faf8, surface #eff1ef, border #d7dad7, accent #cc4e00, text #1d211c
+- Type: Archivo (display, 700, condensed-leaning) + IBM Plex Sans (body, 400). Headline 3rem, leading 1.05.
+- Layout: dense information grid, tight 4px/8px spacing scale. Tables are first-class, not an afterthought. Status uses the orange accent only for exceptions.
+- Signature move: numeric data in tabular-nums. Thin dividers over cards. High information density is the aesthetic.
+
+## 7. CLINICAL (health, finance, legal, compliance, insurance)
+- Palette: bg #f9f9fb, surface #f0f0f3, border #d9d9e0, accent #208368, text #1c2024
+- Type: Source Serif 4 (display, 600) + Work Sans (body, 400). Headline 2.75rem, leading 1.2.
+- Layout: calm, restrained, strictly aligned to a 12-column grid. Nothing decorative. Whitespace does all the separation work.
+- Signature move: serif headings over sans body signals authority without ornament. One accent hue, used only for confirm/positive state.
+
+## 8. ARTISANAL (food, craft, retail, local business, marketplace)
+- Palette: bg #fcf9f6, surface #f6eee7, border #e4cdb7, accent #815e46, text #3e332e
+- Type: Instrument Serif (display, 400) + Manrope (body, 400). Headline 4rem, leading 1.05.
+- Layout: warm paper ground, photography-forward, imagery bleeds past its container. Text overlaps images slightly.
+- Signature move: a hand-drawn-feeling asymmetry. Sections alternate image-left / image-right rather than stacking identical cards.
+
+## SPACING AND SHAPE (Open Props scale; pick one row, hold it)
+- Tight: 4 8 12 16 24 32 48 -- pairs with BRUTALIST, INDUSTRIAL, CLINICAL
+- Standard: 8 16 24 32 48 64 96 -- pairs with EDITORIAL, ARTISANAL, RETRO-FUTURE
+- Generous: 16 32 48 64 96 128 192 -- pairs with LUXURY, SOFT
+
+Radius is an archetype property, not a per-component choice: BRUTALIST 0px,
+INDUSTRIAL/CLINICAL 4px, EDITORIAL/LUXURY 2px, ARTISANAL 8px, RETRO-FUTURE 6px,
+SOFT 24px. Use that ONE value everywhere.
+
+## LAYOUT SKELETONS (choose one; not all three-card rows)
+- Split hero: 55/45 asymmetric, content left, single large visual right, no centering.
+- Editorial stack: full-width measured column with alternating margin notes.
+- Data-first: compact header, then the real table or list immediately, no marketing block.
+- Staggered: sections alternate left/right emphasis with unequal widths (60/40, then 40/60).
+- Gallery: one dominant item plus a differently-sized supporting grid, never uniform tiles.
+
+## LICENSE ATTRIBUTION
+Palette values are steps from Radix Colors, MIT License, Copyright (c) 2021-2022
+Modulz, Copyright (c) 2022-Present WorkOS.
+Spacing scale is derived from Open Props, MIT License, Copyright (c) 2021 Adam Argyle.
+Theme structure and role naming follow daisyUI, MIT License, Copyright (c) 2020
+Pouya Saadeghi.
+All named fonts are served by Google Fonts under the SIL Open Font License and
+are free to embed and redistribute.