opencode-titan 0.1.0

package/dist/utils/provider-lock.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Per-provider, model-aware async scheduler.
+ *
+ * Enforces the provider constraint at runtime: a provider represents a physical
+ * backend (machine/host) that can only fit ONE model in VRAM at a time.
+ * Therefore:
+ *
+ *   - Two tasks running *different models* on the same provider must be
+ *     serialized (one must finish before the other's model can be loaded).
+ *   - Two tasks running the *same model* on the same provider may run
+ *     concurrently, up to that model's `maxInstances` — the model is already
+ *     resident in VRAM, so extra instances add no load/unload cost.
+ *
+ * Tasks on *different* providers never block each other, preserving
+ * cross-machine parallelism.
+ *
+ * Usage:
+ *   const release = await locks.acquire('provider-a', 'provider-a/model-x', 2);
+ *   try { ...run task... } finally { release(); }
+ *
+ * Grants are FIFO per provider (the queue head is considered first), which
+ * prevents a stream of same-model tasks from starving a waiting different-model
+ * task.
+ */
+export declare class ProviderLockManager {
+    private readonly providers;
+    /**
+     * Acquire a slot for `model` on `provider`. Resolves with an idempotent
+     * release function once a slot is available.
+     *
+     * @param provider      Logical provider (physical backend) identifier.
+     * @param model         The model to load — same-model acquisitions can share
+     *                      the provider concurrently.
+     * @param maxConcurrent Maximum concurrent instances of this model (>= 1).
+     */
+    acquire(provider: string, model: string, maxConcurrent?: number): Promise<() => void>;
+    private getState;
+    /**
+     * Grant as many queued waiters as the current provider state allows. Only the
+     * queue head is considered each step to preserve FIFO fairness (a different
+     * model cannot be skipped by later same-model waiters).
+     */
+    private pump;
+    private makeRelease;
+}

package/opencode-titan.schema.json

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "titan": {
+      "type": "object",
+      "description": "Configuration for the Titan orchestrator agent",
+      "properties": {
+        "model": {
+          "type": "string",
+          "description": "Model ID for Titan (provider/model format)"
+        },
+        "temperature": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 2
+        },
+        "variant": {
+          "type": "string"
+        },
+        "prompt": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Custom system prompt to replace the default Titan prompt"
+        }
+      },
+      "additionalProperties": false
+    },
+    "myrmidons": {
+      "type": "array",
+      "description": "Myrmidon configurations. Each Myrmidon is a faster but more limited agent that Titan delegates work to.",
+      "items": {
+        "$ref": "#/$defs/myrmidon"
+      }
+    },
+    "children": {
+      "type": "array",
+      "deprecated": true,
+      "description": "DEPRECATED: use `myrmidons` instead. Retained for backwards compatibility. If both are set, `myrmidons` takes precedence.",
+      "items": {
+        "$ref": "#/$defs/myrmidon"
+      }
+    },
+    "disabled_tools": {
+      "type": "array",
+      "description": "Tool names to disable completely. Disabled tools are not registered with OpenCode.",
+      "items": {
+        "type": "string"
+      }
+    },
+    "backgroundJobs": {
+      "type": "object",
+      "properties": {
+        "maxSessionsPerAgent": {
+          "default": 2,
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "description": "Maximum concurrent background sessions per Myrmidon"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "myrmidon": {
+      "type": "object",
+      "properties": {
+        "model": {
+          "type": "string",
+          "description": "Model ID for this Myrmidon (provider/model format)"
+        },
+        "speed": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "description": "Relative speed of this agent (1=slowest, 10=fastest). Used by Titan to prioritize dispatch."
+        },
+        "intelligence": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "description": "Reasoning capability of this agent (1=limited, 10=strong). Used by Titan to match task complexity."
+        },
+        "modelType": {
+          "type": "string",
+          "enum": ["dense", "sparse"],
+          "description": "Model architecture type. 'dense' = slower but better at logic and complex reasoning. 'sparse' = faster, better at information gathering and broad search."
+        },
+        "maxInstances": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum number of parallel instances Titan may run for this Myrmidon. Since instances share the same model (already loaded in the provider's VRAM), they can run concurrently on the same provider. Defaults to 1."
+        },
+        "temperature": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 2
+        },
+        "variant": {
+          "type": "string"
+        },
+        "displayName": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Human-readable display name for this Myrmidon"
+        },
+        "provider": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Provider identifier for this Myrmidon. Titan will not dispatch parallel tasks to Myrmidons sharing the same provider."
+        }
+      },
+      "required": ["model", "speed", "intelligence", "modelType"],
+      "additionalProperties": false
+    }
+  },
+  "title": "opencode-titan",
+  "description": "Configuration schema for opencode-titan plugin — Titan orchestrator with parallel Myrmidons"
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "opencode-titan",
+  "version": "0.1.0",
+  "description": "Distributed delegation plugin for OpenCode — Titan orchestrator with parallel Myrmidons",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "type": "module",
+  "license": "MIT",
+  "author": "Zack Duford <z.duford@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DEV-DUFORD/opencode-titan.git"
+  },
+  "bugs": {
+    "url": "https://github.com/DEV-DUFORD/opencode-titan/issues"
+  },
+  "homepage": "https://github.com/DEV-DUFORD/opencode-titan#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "agents",
+    "delegation",
+    "titan",
+    "parallel"
+  ],
+  "files": [
+    "dist",
+    "!dist/meta.json",
+    "opencode-titan.schema.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean:dist": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "npm run clean:dist && node_modules/.bin/esbuild src/index.ts --bundle --format=esm --platform=node --outdir=dist --external:@opencode-ai/plugin --external:@opencode-ai/plugin/* --external:@opencode-ai/sdk --external:@opencode-ai/sdk/* --external:zod --metafile=dist/meta.json && tsc --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint .",
+    "format": "biome format . --write",
+    "check": "biome check --write .",
+    "check:ci": "biome check ."
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.3.17",
+    "@opencode-ai/sdk": "^1.3.17",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.11",
+    "@types/node": "^24.6.1",
+    "esbuild": "^0.28.1",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0"
+  }
+}