octto 0.1.0

package/README.md

@@ -0,0 +1,136 @@
+# octto
+
+An interactive browser UI for AI brainstorming. Stop typing in terminals. Start clicking in browsers.
+
+## The Problem
+
+AI brainstorming today happens in the terminal:
+```
+Agent: What framework do you want?
+You: *types* React
+Agent: *thinks for 10 seconds*
+Agent: What about styling?
+You: *types* Tailwind
+Agent: *thinks*
+...repeat for 10 minutes...
+```
+
+Slow. Tedious. One question at a time.
+
+## The Solution
+
+**A browser window with visual questions you can answer in seconds.**
+
+When you describe your idea, octto opens an interactive UI:
+
+- Click options instead of typing
+- See all questions at once
+- Answer in any order
+- Watch follow-ups appear instantly
+- Review the final plan visually
+
+**10 minutes of terminal typing → 2 minutes of clicking.**
+
+## Quick Start
+
+Add to `~/.config/opencode/opencode.json`:
+
+```json
+{ "plugin": ["/path/to/octto"] }
+```
+
+Select the **octto** agent:
+
+```
+I want to add a caching layer to the API
+```
+
+A browser window opens. Click your answers. Done.
+
+## The Interactive UI
+
+### Rich Question Types
+
+No more typing everything. Pick from 14 visual input types:
+
+| Type | What You See |
+|------|--------------|
+| `pick_one` | Radio buttons |
+| `pick_many` | Checkboxes |
+| `confirm` | Yes/No buttons |
+| `slider` | Draggable range |
+| `rank` | Drag to reorder |
+| `rate` | Star rating |
+| `thumbs` | Thumbs up/down |
+| `show_options` | Cards with pros/cons |
+| `show_diff` | Side-by-side code diff |
+| `ask_code` | Syntax-highlighted editor |
+| `ask_text` | Text input (when needed) |
+| `ask_image` | Image upload |
+| `ask_file` | File upload |
+| `emoji_react` | Emoji picker |
+
+### Live Updates
+
+- Questions appear as you answer previous ones
+- Progress indicator shows remaining questions
+- Completed answers visible for context
+- Final plan rendered as reviewable sections
+
+### Parallel Branches
+
+Your request is split into 2-4 exploration branches. All initial questions appear at once:
+
+```
+         ┌─ Branch 1: [question card]
+Request ─┼─ Branch 2: [question card]
+         └─ Branch 3: [question card]
+                ↓
+        Answer any, in any order
+```
+
+Each branch goes as deep as needed. Some finish in 2 questions, others take 4.
+
+## How It Works Behind the Scenes
+
+### 3 Agents
+
+| Agent | Job |
+|-------|-----|
+| **bootstrapper** | Splits your request into branches |
+| **probe** | Decides if a branch needs more questions |
+| **octto** | Orchestrates the session |
+
+### The Flow
+
+1. Bootstrapper creates 2-4 branches from your request
+2. Each branch gets an initial question → all shown in browser
+3. You answer (click, not type)
+4. Probe agent evaluates: more questions or done?
+5. Repeat until all branches complete
+6. Final plan shown for approval
+7. Design saved to `docs/plans/`
+
+## Configuration
+
+Optional `~/.config/opencode/octto.json`:
+
+```json
+{
+  "agents": {
+    "probe": { "model": "anthropic/claude-sonnet-4" }
+  }
+}
+```
+
+## Development
+
+```bash
+bun install
+bun run build
+bun test
+```
+
+## License
+
+MIT

package/dist/agents/bootstrapper.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const agent: AgentConfig;

package/dist/agents/index.d.ts

@@ -0,0 +1,11 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import { agent as bootstrapper } from "./bootstrapper";
+import { agent as octto } from "./octto";
+import { agent as probe } from "./probe";
+export declare enum AGENTS {
+    octto = "octto",
+    bootstrapper = "bootstrapper",
+    probe = "probe"
+}
+export declare const agents: Record<AGENTS, AgentConfig>;
+export { octto, bootstrapper, probe };

package/dist/agents/octto.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const agent: AgentConfig;

package/dist/agents/probe.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare const agent: AgentConfig;

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export { loadCustomConfig } from "./loader";
+export type { AgentOverride, OcttoConfig } from "./schema";
+export { AgentOverrideSchema, OcttoConfigSchema } from "./schema";

package/dist/config/loader.d.ts

@@ -0,0 +1,8 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { AGENTS } from "@/agents";
+export type { AgentOverride, OcttoConfig } from "./schema";
+/**
+ * Load user configuration and merge with plugin agents.
+ * Returns merged agent configs with user overrides applied.
+ */
+export declare function loadCustomConfig(agents: Record<AGENTS, AgentConfig>, configDir?: string): Promise<Record<AGENTS, AgentConfig>>;

package/dist/config/schema.d.ts

@@ -0,0 +1,82 @@
+import * as v from "valibot";
+import { AGENTS } from "@/agents";
+export declare const AgentOverrideSchema: Omit<v.ObjectSchema<{
+    readonly model: v.StringSchema<undefined>;
+    readonly temperature: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 2, undefined>]>;
+    readonly maxSteps: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
+}, undefined>, "~types" | "~run" | "~standard" | "entries"> & {
+    readonly entries: {
+        readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly temperature: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 2, undefined>]>, undefined>;
+        readonly maxSteps: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
+    };
+    readonly "~standard": v.StandardProps<{
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxSteps?: number | undefined;
+    }, {
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxSteps?: number | undefined;
+    }>;
+    readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+        model?: string | undefined;
+        temperature?: number | undefined;
+        maxSteps?: number | undefined;
+    }, v.ObjectIssue | v.StringIssue | v.NumberIssue | v.MinValueIssue<number, 0> | v.MaxValueIssue<number, 2> | v.IntegerIssue<number> | v.MinValueIssue<number, 1>>;
+    readonly "~types"?: {
+        readonly input: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxSteps?: number | undefined;
+        };
+        readonly output: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxSteps?: number | undefined;
+        };
+        readonly issue: v.ObjectIssue | v.StringIssue | v.NumberIssue | v.MinValueIssue<number, 0> | v.MaxValueIssue<number, 2> | v.IntegerIssue<number> | v.MinValueIssue<number, 1>;
+    } | undefined;
+};
+export declare const OcttoConfigSchema: v.ObjectSchema<{
+    readonly agents: v.OptionalSchema<v.RecordSchema<v.EnumSchema<typeof AGENTS, undefined>, Omit<v.ObjectSchema<{
+        readonly model: v.StringSchema<undefined>;
+        readonly temperature: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 2, undefined>]>;
+        readonly maxSteps: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
+    }, undefined>, "~types" | "~run" | "~standard" | "entries"> & {
+        readonly entries: {
+            readonly model: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly temperature: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 2, undefined>]>, undefined>;
+            readonly maxSteps: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>, undefined>;
+        };
+        readonly "~standard": v.StandardProps<{
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxSteps?: number | undefined;
+        }, {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxSteps?: number | undefined;
+        }>;
+        readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxSteps?: number | undefined;
+        }, v.ObjectIssue | v.StringIssue | v.NumberIssue | v.MinValueIssue<number, 0> | v.MaxValueIssue<number, 2> | v.IntegerIssue<number> | v.MinValueIssue<number, 1>>;
+        readonly "~types"?: {
+            readonly input: {
+                model?: string | undefined;
+                temperature?: number | undefined;
+                maxSteps?: number | undefined;
+            };
+            readonly output: {
+                model?: string | undefined;
+                temperature?: number | undefined;
+                maxSteps?: number | undefined;
+            };
+            readonly issue: v.ObjectIssue | v.StringIssue | v.NumberIssue | v.MinValueIssue<number, 0> | v.MaxValueIssue<number, 2> | v.IntegerIssue<number> | v.MinValueIssue<number, 1>;
+        } | undefined;
+    }, undefined>, undefined>;
+}, undefined>;
+export type AgentOverride = v.InferOutput<typeof AgentOverrideSchema>;
+export type OcttoConfig = v.InferOutput<typeof OcttoConfigSchema>;

package/dist/constants.d.ts

@@ -0,0 +1,4 @@
+/** Default timeout for waiting for user answers (5 minutes) */
+export declare const DEFAULT_ANSWER_TIMEOUT_MS = 300000;
+/** Default maximum number of follow-up questions per branch */
+export declare const DEFAULT_MAX_QUESTIONS = 15;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const Octto: Plugin;
+export default Octto;
+export type * from "./types";