@myrialabs/clopen 0.0.1

package/scripts/pre-publish-check.sh

@@ -0,0 +1,142 @@
+#!/bin/bash
+
+##############################################
+# Pre-Publish Validation
+#
+# Run this before publishing to npm:
+#   bash scripts/pre-publish-check.sh
+#
+# Validates:
+# - On main/dev branch
+# - No uncommitted changes
+# - Type check passes
+# - Lint passes
+# - Build succeeds
+##############################################
+
+echo ""
+echo "┌─────────────────────────────────────────────┐"
+echo "│                                             │"
+echo "│        🔍 Pre-Publish Validation            │"
+echo "│                                             │"
+echo "└─────────────────────────────────────────────┘"
+echo ""
+
+# ============================================
+# CHECK 1: Current Branch
+# ============================================
+echo "1️⃣  Checking branch..."
+
+BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+if [ "$BRANCH" != "main" ] && [ "$BRANCH" != "dev" ]; then
+    echo "   ❌ Must publish from main or dev branch"
+    echo "   Current: $BRANCH"
+    echo ""
+    exit 1
+fi
+
+echo "   ✅ Branch: $BRANCH"
+echo ""
+
+# ============================================
+# CHECK 2: Uncommitted Changes
+# ============================================
+echo "2️⃣  Checking for uncommitted changes..."
+
+if ! git diff-index --quiet HEAD --; then
+    echo "   ❌ You have uncommitted changes"
+    echo ""
+    git status --short
+    echo ""
+    echo "   Commit or stash changes first"
+    echo ""
+    exit 1
+fi
+
+if [ -n "$(git status --porcelain)" ]; then
+    echo "   ❌ Working directory not clean"
+    echo ""
+    git status --short
+    echo ""
+    exit 1
+fi
+
+echo "   ✅ No uncommitted changes"
+echo ""
+
+# ============================================
+# CHECK 3: Type Check
+# ============================================
+echo "3️⃣  Running type check..."
+
+bun run check > /dev/null 2>&1
+
+if [ $? -ne 0 ]; then
+    echo "   ❌ Type check failed"
+    echo ""
+    bun run check
+    echo ""
+    exit 1
+fi
+
+echo "   ✅ Type check passed"
+echo ""
+
+# ============================================
+# CHECK 4: Lint
+# ============================================
+echo "4️⃣  Running lint..."
+
+bun run lint > /dev/null 2>&1
+
+if [ $? -ne 0 ]; then
+    echo "   ❌ Lint failed"
+    echo ""
+    bun run lint
+    echo ""
+    exit 1
+fi
+
+echo "   ✅ Lint passed"
+echo ""
+
+# ============================================
+# CHECK 5: Build
+# ============================================
+echo "5️⃣  Testing build..."
+
+bun run build > /dev/null 2>&1
+
+if [ $? -ne 0 ]; then
+    echo "   ❌ Build failed"
+    echo ""
+    bun run build
+    echo ""
+    exit 1
+fi
+
+# Verify dist exists
+if [ ! -d "dist" ]; then
+    echo "   ❌ dist/ directory not found"
+    echo ""
+    exit 1
+fi
+
+echo "   ✅ Build successful"
+echo ""
+
+# ============================================
+# All Checks Passed!
+# ============================================
+echo "┌─────────────────────────────────────────────┐"
+echo "│                                             │"
+echo "│        ✅ All Checks Passed!                │"
+echo "│                                             │"
+echo "└─────────────────────────────────────────────┘"
+echo ""
+echo "Ready to publish:"
+echo ""
+echo "  bun publish --dry-run    # Preview what will be published"
+echo "  bun publish              # Publish to npm"
+echo ""

package/scripts/setup-hooks.sh

@@ -0,0 +1,134 @@
+#!/bin/bash
+
+##############################################
+# Setup Git Hooks for Clopen
+#
+# This script installs git hooks to validate:
+# - Commit message format
+# - Code quality (type check + lint)
+# - Branch naming
+# - Build success (on main/dev push)
+##############################################
+
+echo ""
+echo "🔧 Installing Git Hooks..."
+echo ""
+
+HOOKS_DIR=".git/hooks"
+
+# ============================================
+# HOOK 1: Validate Commit Message Format
+# ============================================
+echo "📝 Creating commit-msg hook..."
+
+cat > "$HOOKS_DIR/commit-msg" << 'EOF'
+#!/bin/bash
+# Validates commit message follows convention
+bash scripts/validate-commit-msg.sh "$1"
+exit $?
+EOF
+
+chmod +x "$HOOKS_DIR/commit-msg"
+echo "   ✅ commit-msg hook created"
+
+# ============================================
+# HOOK 2: Type Check + Lint Before Commit
+# ============================================
+echo "🔍 Creating pre-commit hook..."
+
+cat > "$HOOKS_DIR/pre-commit" << 'EOF'
+#!/bin/bash
+echo ""
+echo "🔍 Running pre-commit checks..."
+
+# Type check with Bun
+echo "   📝 Type checking..."
+bun run check
+if [ $? -ne 0 ]; then
+    echo ""
+    echo "   ❌ Type check failed"
+    exit 1
+fi
+
+# Lint with Bun
+echo "   🔍 Linting..."
+bun run lint
+if [ $? -ne 0 ]; then
+    echo ""
+    echo "   ❌ Lint failed"
+    exit 1
+fi
+
+echo "   ✅ All checks passed"
+echo ""
+exit 0
+EOF
+
+chmod +x "$HOOKS_DIR/pre-commit"
+echo "   ✅ pre-commit hook created"
+
+# ============================================
+# HOOK 3: Branch Name + Build Test
+# ============================================
+echo "🚀 Creating pre-push hook..."
+
+cat > "$HOOKS_DIR/pre-push" << 'EOF'
+#!/bin/bash
+echo ""
+echo "🚀 Running pre-push checks..."
+
+# Validate branch name
+echo "   🌿 Checking branch name..."
+bash scripts/validate-branch-name.sh
+if [ $? -ne 0 ]; then
+    exit 1
+fi
+
+# Get current branch
+BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+# Build test for protected branches
+if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "dev" ]; then
+    echo "   🔨 Testing build (protected branch)..."
+    bun run build
+    if [ $? -ne 0 ]; then
+        echo ""
+        echo "   ❌ Build failed"
+        exit 1
+    fi
+fi
+
+echo "   ✅ All checks passed"
+echo ""
+exit 0
+EOF
+
+chmod +x "$HOOKS_DIR/pre-push"
+echo "   ✅ pre-push hook created"
+
+# ============================================
+# Make Validation Scripts Executable
+# ============================================
+chmod +x scripts/validate-commit-msg.sh
+chmod +x scripts/validate-branch-name.sh
+
+# ============================================
+# Done!
+# ============================================
+echo ""
+echo "✅ Git hooks installed successfully!"
+echo ""
+echo "┌─────────────────────────────────────────────┐"
+echo "│ Hooks Installed:                            │"
+echo "├─────────────────────────────────────────────┤"
+echo "│ • commit-msg  → Validate message format     │"
+echo "│ • pre-commit  → Type check + Lint           │"
+echo "│ • pre-push    → Branch name + Build test    │"
+echo "└─────────────────────────────────────────────┘"
+echo ""
+echo "📚 See CONTRIBUTING.md for commit/branch conventions"
+echo ""
+echo "⚠️  To bypass (not recommended):"
+echo "   git commit --no-verify"
+echo "   git push --no-verify"
+echo ""

package/scripts/validate-branch-name.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+
+# Validate branch name format
+# Called by pre-push hook
+
+BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+# Allowed branch patterns:
+# - main, dev (protected branches)
+# - feature/*, fix/*, docs/*, chore/*
+PATTERN="^(main|dev|feature|fix|docs|chore)/[a-z0-9-]+$"
+
+# Allow protected branches
+if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "dev" ]; then
+    exit 0
+fi
+
+# Validate branch name
+if ! echo "$BRANCH" | grep -qE "$PATTERN"; then
+    echo ""
+    echo "❌ Invalid branch name: $BRANCH"
+    echo ""
+    echo "Expected format:"
+    echo "  <type>/<short-description>"
+    echo ""
+    echo "Types:"
+    echo "  feature  - New feature"
+    echo "  fix      - Bug fix"
+    echo "  docs     - Documentation"
+    echo "  chore    - Other changes"
+    echo ""
+    echo "Rules:"
+    echo "  - All lowercase"
+    echo "  - Use hyphens (not spaces or underscores)"
+    echo "  - Short and descriptive"
+    echo ""
+    echo "Examples:"
+    echo "  feature/add-git-management"
+    echo "  fix/terminal-crash"
+    echo "  docs/update-readme"
+    echo "  chore/update-deps"
+    echo ""
+    echo "See CONTRIBUTING.md for full guidelines"
+    exit 1
+fi
+
+exit 0

package/scripts/validate-commit-msg.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+
+# Validate commit message format
+# Called by commit-msg hook
+
+COMMIT_MSG_FILE=$1
+COMMIT_MSG=$(cat "$COMMIT_MSG_FILE")
+
+# Regex for conventional commits
+# Format: type(scope): subject
+# Examples: feat: add feature, fix(api): resolve bug
+PATTERN="^(feat|fix|docs|chore|release)(\(.+\))?: .{1,72}"
+
+if ! echo "$COMMIT_MSG" | grep -qE "$PATTERN"; then
+    echo ""
+    echo "❌ Invalid commit message format!"
+    echo ""
+    echo "Expected format:"
+    echo "  <type>(<scope>): <subject>"
+    echo ""
+    echo "Types:"
+    echo "  feat     - New feature"
+    echo "  fix      - Bug fix"
+    echo "  docs     - Documentation"
+    echo "  chore    - Other changes (refactor, test, build, etc)"
+    echo "  release  - Version release"
+    echo ""
+    echo "Examples:"
+    echo "  feat: add database management"
+    echo "  fix(terminal): resolve crash issue"
+    echo "  docs(readme): update installation guide"
+    echo "  chore: update dependencies"
+    echo "  release: v0.0.2"
+    echo ""
+    echo "Your message:"
+    echo "  $COMMIT_MSG"
+    echo ""
+    echo "See CONTRIBUTING.md for full guidelines"
+    exit 1
+fi
+
+exit 0

package/shared/constants/engines.ts

@@ -0,0 +1,134 @@
+import type { EngineType, EngineModel, EngineInfo } from '$shared/types/engine';
+
+// Re-export engine types for convenience
+export type { EngineModel, EngineType, EngineInfo };
+
+// ============================================================================
+// Engine Definitions
+// ============================================================================
+
+export const ENGINES: EngineInfo[] = [
+	{
+		type: 'claude-code',
+		name: 'Claude Code',
+		description: 'Anthropic Claude models',
+		icon: {
+			light: '<svg width="1200" height="1200" viewBox="0 0 1200 1200" xmlns="http://www.w3.org/2000/svg"><g id="g314"><path id="path147" fill="#d97757" stroke="none" d="M 233.959793 800.214905 L 468.644287 668.536987 L 472.590637 657.100647 L 468.644287 650.738403 L 457.208069 650.738403 L 417.986633 648.322144 L 283.892639 644.69812 L 167.597321 639.865845 L 54.926208 633.825623 L 26.577238 627.785339 L 3.3e-05 592.751709 L 2.73832 575.27533 L 26.577238 559.248352 L 60.724873 562.228149 L 136.187973 567.382629 L 249.422867 575.194763 L 331.570496 580.026978 L 453.261841 592.671082 L 472.590637 592.671082 L 475.328857 584.859009 L 468.724915 580.026978 L 463.570557 575.194763 L 346.389313 495.785217 L 219.543671 411.865906 L 153.100723 363.543762 L 117.181267 339.060425 L 99.060455 316.107361 L 91.248367 266.01355 L 123.865784 230.093994 L 167.677887 233.073853 L 178.872513 236.053772 L 223.248367 270.201477 L 318.040283 343.570496 L 441.825592 434.738342 L 459.946411 449.798706 L 467.194672 444.64447 L 468.080597 441.020203 L 459.946411 427.409485 L 392.617493 305.718323 L 320.778564 181.932983 L 288.80542 130.630859 L 280.348999 99.865845 C 277.369171 87.221436 275.194641 76.590698 275.194641 63.624268 L 312.322174 13.20813 L 332.8591 6.604126 L 382.389313 13.20813 L 403.248352 31.328979 L 434.013519 101.71814 L 483.865753 212.537048 L 561.181274 363.221497 L 583.812134 407.919434 L 595.892639 449.315491 L 600.40271 461.959839 L 608.214783 461.959839 L 608.214783 454.711609 L 614.577271 369.825623 L 626.335632 265.61084 L 637.771851 131.516846 L 641.718201 93.745117 L 660.402832 48.483276 L 697.530334 24.000122 L 726.52356 37.852417 L 750.362549 72 L 747.060486 94.067139 L 732.886047 186.201416 L 705.100708 330.52356 L 686.979919 427.167847 L 697.530334 427.167847 L 709.61084 415.087341 L 758.496704 350.174561 L 840.644348 247.490051 L 876.885925 206.738342 L 919.167847 161.71814 L 946.308838 140.29541 L 997.61084 140.29541 L 1035.38269 196.429626 L 1018.469849 254.416199 L 965.637634 321.422852 L 921.825562 378.201538 L 859.006714 462.765259 L 819.785278 530.41626 L 823.409424 535.812073 L 832.75177 534.92627 L 974.657776 504.724915 L 1051.328979 490.872559 L 1142.818848 475.167786 L 1184.214844 494.496582 L 1188.724854 514.147644 L 1172.456421 554.335693 L 1074.604126 578.496765 L 959.838989 601.449829 L 788.939636 641.879272 L 786.845764 643.409485 L 789.261841 646.389343 L 866.255127 653.637634 L 899.194702 655.409424 L 979.812134 655.409424 L 1129.932861 666.604187 L 1169.154419 692.537109 L 1192.671265 724.268677 L 1188.724854 748.429688 L 1128.322144 779.194641 L 1046.818848 759.865845 L 856.590759 714.604126 L 791.355774 698.335754 L 782.335693 698.335754 L 782.335693 703.731567 L 836.69812 756.885986 L 936.322205 846.845581 L 1061.073975 962.81897 L 1067.436279 991.490112 L 1051.409424 1014.120911 L 1034.496704 1011.704712 L 924.885986 929.234924 L 882.604126 892.107544 L 786.845764 811.48999 L 780.483276 811.48999 L 780.483276 819.946289 L 802.550415 852.241699 L 919.087341 1027.409424 L 925.127625 1081.127686 L 916.671204 1098.604126 L 886.469849 1109.154419 L 853.288696 1103.114136 L 785.073914 1007.355835 L 714.684631 899.516785 L 657.906067 802.872498 L 650.979858 806.81897 L 617.476624 1167.704834 L 601.771851 1186.147705 L 565.530212 1200 L 535.328857 1177.046997 L 519.302124 1139.919556 L 535.328857 1066.550537 L 554.657776 970.792053 L 570.362488 894.68457 L 584.536926 800.134277 L 592.993347 768.724976 L 592.429626 766.630859 L 585.503479 767.516968 L 514.22821 865.369263 L 405.825531 1011.865906 L 320.053711 1103.677979 L 299.516815 1111.812256 L 263.919525 1093.369263 L 267.221497 1060.429688 L 287.114136 1031.114136 L 405.825531 880.107361 L 477.422913 786.52356 L 523.651062 732.483276 L 523.328918 724.671265 L 520.590698 724.671265 L 205.288605 929.395935 L 149.154434 936.644409 L 124.993355 914.01355 L 127.973183 876.885986 L 139.409409 864.80542 L 234.201385 799.570435 L 233.879227 799.8927 Z"/></g></svg>',
+			dark: '<svg width="1200" height="1200" viewBox="0 0 1200 1200" xmlns="http://www.w3.org/2000/svg"><g id="g314"><path id="path147" fill="#d97757" stroke="none" d="M 233.959793 800.214905 L 468.644287 668.536987 L 472.590637 657.100647 L 468.644287 650.738403 L 457.208069 650.738403 L 417.986633 648.322144 L 283.892639 644.69812 L 167.597321 639.865845 L 54.926208 633.825623 L 26.577238 627.785339 L 3.3e-05 592.751709 L 2.73832 575.27533 L 26.577238 559.248352 L 60.724873 562.228149 L 136.187973 567.382629 L 249.422867 575.194763 L 331.570496 580.026978 L 453.261841 592.671082 L 472.590637 592.671082 L 475.328857 584.859009 L 468.724915 580.026978 L 463.570557 575.194763 L 346.389313 495.785217 L 219.543671 411.865906 L 153.100723 363.543762 L 117.181267 339.060425 L 99.060455 316.107361 L 91.248367 266.01355 L 123.865784 230.093994 L 167.677887 233.073853 L 178.872513 236.053772 L 223.248367 270.201477 L 318.040283 343.570496 L 441.825592 434.738342 L 459.946411 449.798706 L 467.194672 444.64447 L 468.080597 441.020203 L 459.946411 427.409485 L 392.617493 305.718323 L 320.778564 181.932983 L 288.80542 130.630859 L 280.348999 99.865845 C 277.369171 87.221436 275.194641 76.590698 275.194641 63.624268 L 312.322174 13.20813 L 332.8591 6.604126 L 382.389313 13.20813 L 403.248352 31.328979 L 434.013519 101.71814 L 483.865753 212.537048 L 561.181274 363.221497 L 583.812134 407.919434 L 595.892639 449.315491 L 600.40271 461.959839 L 608.214783 461.959839 L 608.214783 454.711609 L 614.577271 369.825623 L 626.335632 265.61084 L 637.771851 131.516846 L 641.718201 93.745117 L 660.402832 48.483276 L 697.530334 24.000122 L 726.52356 37.852417 L 750.362549 72 L 747.060486 94.067139 L 732.886047 186.201416 L 705.100708 330.52356 L 686.979919 427.167847 L 697.530334 427.167847 L 709.61084 415.087341 L 758.496704 350.174561 L 840.644348 247.490051 L 876.885925 206.738342 L 919.167847 161.71814 L 946.308838 140.29541 L 997.61084 140.29541 L 1035.38269 196.429626 L 1018.469849 254.416199 L 965.637634 321.422852 L 921.825562 378.201538 L 859.006714 462.765259 L 819.785278 530.41626 L 823.409424 535.812073 L 832.75177 534.92627 L 974.657776 504.724915 L 1051.328979 490.872559 L 1142.818848 475.167786 L 1184.214844 494.496582 L 1188.724854 514.147644 L 1172.456421 554.335693 L 1074.604126 578.496765 L 959.838989 601.449829 L 788.939636 641.879272 L 786.845764 643.409485 L 789.261841 646.389343 L 866.255127 653.637634 L 899.194702 655.409424 L 979.812134 655.409424 L 1129.932861 666.604187 L 1169.154419 692.537109 L 1192.671265 724.268677 L 1188.724854 748.429688 L 1128.322144 779.194641 L 1046.818848 759.865845 L 856.590759 714.604126 L 791.355774 698.335754 L 782.335693 698.335754 L 782.335693 703.731567 L 836.69812 756.885986 L 936.322205 846.845581 L 1061.073975 962.81897 L 1067.436279 991.490112 L 1051.409424 1014.120911 L 1034.496704 1011.704712 L 924.885986 929.234924 L 882.604126 892.107544 L 786.845764 811.48999 L 780.483276 811.48999 L 780.483276 819.946289 L 802.550415 852.241699 L 919.087341 1027.409424 L 925.127625 1081.127686 L 916.671204 1098.604126 L 886.469849 1109.154419 L 853.288696 1103.114136 L 785.073914 1007.355835 L 714.684631 899.516785 L 657.906067 802.872498 L 650.979858 806.81897 L 617.476624 1167.704834 L 601.771851 1186.147705 L 565.530212 1200 L 535.328857 1177.046997 L 519.302124 1139.919556 L 535.328857 1066.550537 L 554.657776 970.792053 L 570.362488 894.68457 L 584.536926 800.134277 L 592.993347 768.724976 L 592.429626 766.630859 L 585.503479 767.516968 L 514.22821 865.369263 L 405.825531 1011.865906 L 320.053711 1103.677979 L 299.516815 1111.812256 L 263.919525 1093.369263 L 267.221497 1060.429688 L 287.114136 1031.114136 L 405.825531 880.107361 L 477.422913 786.52356 L 523.651062 732.483276 L 523.328918 724.671265 L 520.590698 724.671265 L 205.288605 929.395935 L 149.154434 936.644409 L 124.993355 914.01355 L 127.973183 876.885986 L 139.409409 864.80542 L 234.201385 799.570435 L 233.879227 799.8927 Z"/></g></svg>'
+		}
+	},
+	{
+		type: 'opencode',
+		name: 'Open Code',
+		description: 'Multi-provider AI models',
+		icon: {
+			light: '<svg width="240" height="300" viewBox="0 0 240 300" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#clip0_1401_86274)"><mask id="mask0_1401_86274" style="mask-type:luminance" maskUnits="userSpaceOnUse" x="0" y="0" width="240" height="300"><path d="M240 0H0V300H240V0Z" fill="white"/></mask><g mask="url(#mask0_1401_86274)"><path d="M180 240H60V120H180V240Z" fill="#CFCECD"/><path d="M180 60H60V240H180V60ZM240 300H0V0H240V300Z" fill="#211E1E"/></g></g><defs><clipPath id="clip0_1401_86274"><rect width="240" height="300" fill="white"/></clipPath></defs></svg>',
+			dark: '<svg width="240" height="300" viewBox="0 0 240 300" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#clip0_1401_86283)"><mask id="mask0_1401_86283" style="mask-type:luminance" maskUnits="userSpaceOnUse" x="0" y="0" width="240" height="300"><path d="M240 0H0V300H240V0Z" fill="white"/></mask><g mask="url(#mask0_1401_86283)"><path d="M180 240H60V120H180V240Z" fill="#4B4646"/><path d="M180 60H60V240H180V60ZM240 300H0V0H240V300Z" fill="#F1ECEC"/></g></g><defs><clipPath id="clip0_1401_86283"><rect width="240" height="300" fill="white"/></clipPath></defs></svg>'
+		}
+	}
+];
+
+export const getEngineInfo = (engineType: EngineType): EngineInfo | undefined => {
+	return ENGINES.find(e => e.type === engineType);
+};
+
+// ============================================================================
+// Claude Code Models (static)
+// ============================================================================
+
+export const CLAUDE_CODE_MODELS: EngineModel[] = [
+	{
+		id: 'claude-code:opus',
+		engine: 'claude-code',
+		modelId: 'opus',
+		name: 'Opus 4.6',
+		provider: 'anthropic',
+		description: 'Most capable model with sustained performance for complex, long-running tasks',
+		capabilities: ['Reasoning', 'Attachments'],
+		contextWindow: 200000,
+		category: 'latest'
+	},
+	{
+		id: 'claude-code:sonnet',
+		engine: 'claude-code',
+		modelId: 'sonnet',
+		name: 'Sonnet 4.5',
+		provider: 'anthropic',
+		description: 'High-performance model with excellent coding capabilities and extended thinking',
+		capabilities: ['Reasoning', 'Attachments'],
+		contextWindow: 200000,
+		category: 'latest',
+		recommended: true
+	},
+	{
+		id: 'claude-code:haiku',
+		engine: 'claude-code',
+		modelId: 'haiku',
+		name: 'Haiku 4.5',
+		provider: 'anthropic',
+		description: 'Fast and efficient model for quick tasks and responses',
+		capabilities: ['Reasoning', 'Attachments'],
+		contextWindow: 200000,
+		category: 'latest'
+	}
+];
+
+// ============================================================================
+// Model Registry (mutable — dynamic engines can register models at runtime)
+// ============================================================================
+
+/** All registered models. Claude Code models are static; Open Code models are fetched dynamically. */
+const modelRegistry: EngineModel[] = [...CLAUDE_CODE_MODELS];
+
+/** Register models for a specific engine (replaces any existing models for that engine) */
+export const registerModels = (engine: EngineType, models: EngineModel[]): void => {
+	// Remove existing models for this engine
+	const filtered = modelRegistry.filter(m => m.engine !== engine);
+	modelRegistry.length = 0;
+	modelRegistry.push(...filtered, ...models);
+};
+
+/** Get all registered models (snapshot) */
+export const getAllModels = (): EngineModel[] => [...modelRegistry];
+
+
+// ============================================================================
+// Defaults
+// ============================================================================
+
+export const DEFAULT_ENGINE: EngineType = 'claude-code';
+export const DEFAULT_MODEL = 'claude-code:sonnet';
+
+// ============================================================================
+// Lookup Helpers
+// ============================================================================
+
+export const getModelById = (modelId: string): EngineModel | undefined => {
+	return modelRegistry.find(model => model.id === modelId);
+};
+
+export const getModelsByEngine = (engine: EngineType): EngineModel[] => {
+	return modelRegistry.filter(model => model.engine === engine);
+};
+
+/**
+ * Parse a compound model ID into engine + modelId
+ * e.g. "claude-code:sonnet" → { engine: "claude-code", modelId: "sonnet" }
+ */
+export const parseModelId = (compoundId: string): { engine: EngineType; modelId: string } => {
+	const colonIndex = compoundId.indexOf(':');
+	if (colonIndex !== -1) {
+		const engine = compoundId.slice(0, colonIndex) as EngineType;
+		const modelId = compoundId.slice(colonIndex + 1);
+		return { engine, modelId };
+	}
+	return { engine: 'claude-code', modelId: compoundId };
+};
+
+// SDK Configuration - NO LIMITS FOR LOCAL PROJECT
+export const SDK_CONFIG = {
+	DEFAULT_MAX_TURNS: undefined, // No limit - unlimited conversation
+	DEFAULT_TEMPERATURE: 0.7,
+	DEFAULT_MAX_TOKENS: undefined, // No limit - unlimited tokens
+	TIMEOUT_MS: undefined, // No timeout - unlimited duration
+} as const;

package/shared/types/database/connection.ts

@@ -0,0 +1,16 @@
+export interface DatabaseConnection {
+	query(sql: string): {
+		all(...params: unknown[]): unknown[];
+		get(...params: unknown[]): unknown;
+		run(...params: unknown[]): unknown;
+		finalize(): void;
+	};
+	prepare(query: string): {
+		all(...params: unknown[]): unknown[];
+		get(...params: unknown[]): unknown;
+		run(...params: unknown[]): unknown;
+		finalize(): void;
+	};
+	exec(query: string): unknown;
+	close(): void;
+}

package/shared/types/database/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Database types barrel export
+ */
+
+export * from './schema';
+export * from './connection';

package/shared/types/database/schema.ts

@@ -0,0 +1,141 @@
+/**
+ * Database-specific types
+ *
+ * Uses official @anthropic-ai/claude-agent-sdk types for consistency
+ */
+
+import type { SDKMessage, EngineSDKMessage } from '../messaging';
+import type { EngineType } from '../engine';
+
+// Core database entities moved from core folder
+export interface Project {
+	id: string;
+	name: string;
+	path: string;
+	created_at: string;
+	last_opened_at: string;
+}
+
+export interface ChatSession {
+	id: string;
+	project_id: string;
+	title?: string;
+	engine?: EngineType; // AI engine used for this session
+	model?: string; // Compound model ID (e.g., 'claude-code:haiku', 'opencode:gpt-5.2')
+	claude_account_id?: number; // Per-session Claude account override (references claude_accounts.id)
+	latest_sdk_session_id?: string; // Latest SDK session_id from responses
+	current_head_message_id?: string; // Git-like HEAD pointer to current branch tip
+	started_at: string;
+	ended_at?: string;
+}
+
+export interface Settings {
+	key: string;
+	value: string;
+	updated_at: string;
+}
+
+
+/**
+ * Database Message interface
+ * Stores official SDKMessage as JSON with additional metadata
+ */
+export interface DatabaseMessage {
+	id: string;
+	session_id: string;
+	timestamp: string;
+	// Store the complete SDKMessage as JSON for full fidelity
+	sdk_message: string; // JSON string of SDKMessage
+	// User identification for shared chat
+	sender_id?: string | null;
+	sender_name?: string | null;
+	// Git-like commit graph support
+	parent_message_id?: string | null; // Parent message (like git parent commit)
+	// Soft delete and branch support for undo/redo (deprecated, kept for backward compatibility)
+	is_deleted?: number; // 0 = active, 1 = soft deleted
+	branch_id?: string | null; // Branch identifier (now used as branch name)
+}
+
+/**
+ * SDK Message with database timestamp and user info for UI display
+ */
+export type SDKMessageFormatter = EngineSDKMessage & {
+	partialText?: string; // Accumulated partial text for streaming messages (transient, not persisted)
+	metadata?: { // System-added info (not part of official SDK response)
+		message_id?: string; // Database message ID
+		created_at?: string; // Message creation timestamp
+		sender_id?: string | null; // User ID who submitted the chat (user messages only)
+		sender_name?: string | null; // Display name of who submitted the chat (user messages only)
+		parent_message_id?: string | null; // Git-like parent pointer
+		engine?: string; // Engine type that produced this message (claude-code, opencode)
+		reasoning?: boolean; // Whether this message is a reasoning/thinking message
+	};
+};
+
+/**
+ * Database-specific Setting interface
+ * Different from core Settings which might have different structure
+ */
+export interface Setting {
+	key: string;
+	value: string;
+	updated_at: string;
+}
+
+/**
+ * Message Snapshot for time travel feature
+ * Supports both full snapshots and delta (incremental) snapshots
+ */
+export interface MessageSnapshot {
+	id: string;
+	message_id: string;
+	session_id: string;
+	project_id: string;
+	files_snapshot: string; // JSON string of {[filepath]: fileContent} (legacy) or '{}' (blob-store format)
+	project_metadata?: string; // JSON string with project metadata
+	created_at: string;
+	snapshot_type?: 'full' | 'delta'; // Type of snapshot (default: 'full')
+	parent_snapshot_id?: string; // Reference to parent snapshot (for delta snapshots)
+	delta_changes?: string; // JSON string of delta changes (legacy: full content, blob-store: hash references)
+	// File change statistics (git-like)
+	files_changed?: number; // Number of files changed
+	insertions?: number; // Number of lines inserted
+	deletions?: number; // Number of lines deleted
+	// Soft delete and branch support for undo/redo
+	is_deleted?: number; // 0 = active, 1 = soft deleted
+	branch_id?: string | null; // Branch identifier for multi-branch redo
+	// Blob store format (new): tree hash for content-addressable storage
+	tree_hash?: string | null; // When set, snapshot uses blob store (files in ~/.clopen/snapshots/)
+}
+
+/**
+ * Delta changes structure for incremental snapshots
+ */
+export interface DeltaChanges {
+	added: { [filepath: string]: string }; // New files
+	modified: { [filepath: string]: string }; // Changed files with new content
+	deleted: string[]; // Deleted file paths
+}
+
+/**
+ * Session Relationship for tracking session branching
+ */
+export interface SessionRelationship {
+	id: string;
+	parent_session_id: string;
+	child_session_id: string;
+	branched_from_message_id?: string;
+	created_at: string;
+}
+
+/**
+ * Branch tracking for git-like version control
+ * Each branch has a name and points to a HEAD message
+ */
+export interface Branch {
+	id: string;
+	session_id: string;
+	branch_name: string; // Human-readable branch name (e.g., "version_1", "version_2")
+	head_message_id: string; // Points to the tip of this branch
+	created_at: string;
+}