@hung319/opencode-hive 1.3.1

package/dist/mcp/ast-grep.d.ts

@@ -0,0 +1,2 @@
+import type { LocalMcpConfig } from './types';
+export declare const astGrepMcp: LocalMcpConfig;

package/dist/mcp/context7.d.ts

@@ -0,0 +1,2 @@
+import type { RemoteMcpConfig } from './types';
+export declare const context7Mcp: RemoteMcpConfig;

package/dist/mcp/grep-app.d.ts

@@ -0,0 +1,2 @@
+import type { RemoteMcpConfig } from './types';
+export declare const grepAppMcp: RemoteMcpConfig;

package/dist/mcp/index.d.ts

@@ -0,0 +1,2 @@
+import type { McpConfig } from './types';
+export declare const createBuiltinMcps: (disabledMcps?: string[]) => Record<string, McpConfig>;

package/dist/mcp/types.d.ts

@@ -0,0 +1,12 @@
+export type RemoteMcpConfig = {
+    type: 'remote';
+    url: string;
+    headers?: Record<string, string>;
+    oauth?: boolean;
+};
+export type LocalMcpConfig = {
+    type: 'local';
+    command: string[];
+    environment?: Record<string, string>;
+};
+export type McpConfig = RemoteMcpConfig | LocalMcpConfig;

package/dist/mcp/websearch.d.ts

@@ -0,0 +1,2 @@
+import type { RemoteMcpConfig } from './types';
+export declare const websearchMcp: RemoteMcpConfig;

package/dist/skills/builtin.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Builtin Skills for Hive
+ *
+ * Skills are loaded from the generated registry.
+ * This file provides the infrastructure to load builtin skills.
+ */
+import type { SkillDefinition, SkillLoadResult } from './types.js';
+import { BUILTIN_SKILL_NAMES, BUILTIN_SKILLS } from './registry.generated.js';
+export { BUILTIN_SKILL_NAMES, BUILTIN_SKILLS };
+/**
+ * Type for builtin skill names.
+ */
+export type BuiltinSkillName = typeof BUILTIN_SKILL_NAMES[number];
+/**
+ * Load a builtin skill by name.
+ */
+export declare function loadBuiltinSkill(name: string): SkillLoadResult;
+/**
+ * Get all builtin skills.
+ */
+export declare function getBuiltinSkills(): SkillDefinition[];
+/**
+ * Get filtered skills based on global disable list and optional per-agent enable list.
+ *
+ * Logic:
+ * 1. Start with all builtin skills
+ * 2. Remove globally disabled skills
+ * 3. If agentSkills is provided and non-empty, intersect with that list
+ *
+ * @param disabledSkills - Skills to globally disable
+ * @param agentSkills - If provided, only these skills are enabled for the agent (intersection)
+ */
+export declare function getFilteredSkills(disabledSkills?: string[], agentSkills?: string[]): SkillDefinition[];
+/**
+ * Get skill metadata for tool description (XML format).
+ * Uses (hive - Skill) prefix for consistency with formatSkillsXml in index.ts.
+ */
+export declare function getBuiltinSkillsXml(): string;

package/dist/skills/file-loader.d.ts

@@ -0,0 +1,22 @@
+/**
+ * File-based Skill Loader
+ *
+ * Resolves and loads skill files from OpenCode and Claude-compatible paths.
+ * Implements strict skill ID validation and deterministic search order.
+ */
+import type { SkillLoadResult } from './types.js';
+/**
+ * Load a skill from file-based locations.
+ *
+ * Searches for skill files in the following order:
+ * 1. Project OpenCode: `<projectRoot>/.opencode/skills/<skillId>/SKILL.md`
+ * 2. Global OpenCode: `~/.config/opencode/skills/<skillId>/SKILL.md`
+ * 3. Project Claude-compatible: `<projectRoot>/.claude/skills/<skillId>/SKILL.md`
+ * 4. Global Claude-compatible: `~/.claude/skills/<skillId>/SKILL.md`
+ *
+ * @param skillId - The skill ID to load
+ * @param projectRoot - The project root directory
+ * @param homeDir - The user's home directory
+ * @returns The skill load result
+ */
+export declare function loadFileSkill(skillId: string, projectRoot: string, homeDir: string): Promise<SkillLoadResult>;

package/dist/skills/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hive Skills System
+ *
+ * Export skill infrastructure for use in hive_skill tool.
+ */
+export type { SkillDefinition, SkillLoadResult } from './types.js';
+export { BUILTIN_SKILLS, loadBuiltinSkill, getBuiltinSkills, getFilteredSkills, getBuiltinSkillsXml, type BuiltinSkillName } from './builtin.js';
+export { loadFileSkill } from './file-loader.js';

package/dist/skills/registry.generated.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ * Generated by: scripts/generate-skills.ts
+ * Run: bun run scripts/generate-skills.ts
+ */
+import type { SkillDefinition } from './types.js';
+/**
+ * List of builtin skill names.
+ */
+export declare const BUILTIN_SKILL_NAMES: readonly ["agents-md-mastery", "brainstorming", "code-reviewer", "dispatching-parallel-agents", "docker-mastery", "executing-plans", "parallel-exploration", "systematic-debugging", "test-driven-development", "verification-before-completion", "writing-plans"];
+/**
+ * All builtin skill definitions.
+ */
+export declare const BUILTIN_SKILLS: SkillDefinition[];

package/dist/skills/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Hive Skill System Types
+ *
+ * Skill definitions for Hive.
+ */
+/**
+ * Definition of a skill that can be loaded by agents.
+ */
+export interface SkillDefinition {
+    /** Unique identifier for the skill */
+    name: string;
+    /** Brief description shown in available_skills list */
+    description: string;
+    /** Markdown content with detailed instructions */
+    template: string;
+}
+/**
+ * Result returned when loading a skill.
+ */
+export interface SkillLoadResult {
+    /** Whether the skill was found */
+    found: boolean;
+    /** The loaded skill definition if found */
+    skill?: SkillDefinition;
+    /** Error message if not found */
+    error?: string;
+    /** Source of the skill (builtin or file path) */
+    source?: 'builtin' | string;
+}

package/dist/utils/compaction-prompt.d.ts

@@ -0,0 +1 @@
+export declare function buildCompactionPrompt(): string;

package/dist/utils/format.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Time formatting utilities.
+ */
+/**
+ * Format elapsed time in milliseconds.
+ *
+ * Rules:
+ * - < 60s → "Xs"
+ * - < 60m → "Xm Ys"
+ * - ≥ 60m → "Xh Ym"
+ */
+export declare function formatElapsed(ms: number): string;
+/**
+ * Format relative time from an ISO date string to now.
+ */
+export declare function formatRelativeTime(isoDate: string): string;

package/dist/utils/prompt-budgeting.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Deterministic prompt budgeting utilities for Hive.
+ *
+ * Limits history/context included in prompts to bound growth:
+ * - Include only last N completed tasks
+ * - Truncate each task summary to max M chars (with clear truncation marker)
+ * - Apply max budget for inlined context (or switch to file references / name-only listing past a cap)
+ * - Emit warnings when any budget causes truncation so it's never silent
+ *
+ * IMPORTANT: Never removes access to full info - always provides file paths the worker can read.
+ */
+/**
+ * Input task for budgeting.
+ */
+export interface TaskInput {
+    name: string;
+    summary: string;
+}
+/**
+ * Budgeted task with truncation info.
+ */
+export interface BudgetedTask {
+    name: string;
+    summary: string;
+    truncated: boolean;
+    originalLength?: number;
+}
+/**
+ * Input context file for budgeting.
+ */
+export interface ContextInput {
+    name: string;
+    content: string;
+}
+/**
+ * Budgeted context file with truncation info.
+ */
+export interface BudgetedContext {
+    name: string;
+    content: string;
+    truncated: boolean;
+    originalLength?: number;
+    /** Hint for where to find full content */
+    pathHint?: string;
+}
+/**
+ * Truncation event for observability.
+ */
+export interface TruncationEvent {
+    type: 'tasks_dropped' | 'summary_truncated' | 'context_truncated' | 'context_names_only';
+    message: string;
+    count?: number;
+    /** Names of affected items */
+    affected?: string[];
+}
+/**
+ * Budget configuration.
+ */
+export interface BudgetConfig {
+    /** Max number of previous tasks to include (default: 10) */
+    maxTasks?: number;
+    /** Max chars per task summary (default: 2000) */
+    maxSummaryChars?: number;
+    /** Max chars per context file (default: 20000) */
+    maxContextChars?: number;
+    /** Max total chars for all context files combined (default: 60000) */
+    maxTotalContextChars?: number;
+    /** Feature name for generating file path hints */
+    feature?: string;
+}
+/**
+ * Result of applying task budget.
+ */
+export interface TaskBudgetResult {
+    tasks: BudgetedTask[];
+    truncationEvents: TruncationEvent[];
+    /** Hint about dropped tasks and where to find them */
+    droppedTasksHint?: string;
+}
+/**
+ * Result of applying context budget.
+ */
+export interface ContextBudgetResult {
+    files: BudgetedContext[];
+    truncationEvents: TruncationEvent[];
+    /** Names of files that were converted to name-only */
+    namesOnlyFiles?: string[];
+}
+/**
+ * Default budget configuration.
+ *
+ * Conservative defaults that balance context richness with bounded growth.
+ */
+export declare const DEFAULT_BUDGET: Required<Omit<BudgetConfig, 'feature'>>;
+/**
+ * Apply budget limits to previous tasks.
+ *
+ * - Keeps only the last N tasks (most recent)
+ * - Truncates summaries exceeding max chars
+ * - Emits truncation events for observability
+ * - Provides hints for accessing full info
+ */
+export declare function applyTaskBudget(tasks: TaskInput[], config?: BudgetConfig): TaskBudgetResult;
+/**
+ * Apply budget limits to context files.
+ *
+ * - Truncates individual files exceeding max chars
+ * - Switches to name-only listing when total exceeds budget
+ * - Emits truncation events for observability
+ * - Provides file path hints for accessing full content
+ */
+export declare function applyContextBudget(files: ContextInput[], config?: BudgetConfig): ContextBudgetResult;

package/dist/utils/prompt-file.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Prompt file utilities for preventing tool output truncation.
+ *
+ * Instead of inlining large prompts in tool outputs, we write them to files
+ * and pass file references. This keeps tool output sizes bounded while
+ * preserving full prompt content for workers.
+ *
+ * Security: All file operations are restricted to workspace/.hive paths.
+ */
+/**
+ * Result of resolving prompt content from a file.
+ */
+export interface PromptFileResult {
+    /** The prompt content if successfully read */
+    content?: string;
+    /** Error message if reading failed */
+    error?: string;
+}
+/**
+ * Find the workspace root by walking up from a start directory.
+ *
+ * The workspace root is identified as the directory that contains a .hive folder.
+ * Returns null if no .hive directory is found.
+ */
+export declare function findWorkspaceRoot(startDir: string): string | null;
+/**
+ * Check if a file path is valid for prompt file operations.
+ *
+ * Security: Only allows paths within the workspace directory.
+ * Rejects path traversal attempts (../).
+ *
+ * @param filePath - The path to validate
+ * @param workspaceRoot - The workspace root directory
+ * @returns true if the path is valid and safe
+ */
+export declare function isValidPromptFilePath(filePath: string, workspaceRoot: string): boolean;
+/**
+ * Resolve prompt content from a file.
+ *
+ * Security: Validates that the file path is within the workspace.
+ *
+ * @param promptFilePath - Path to the prompt file
+ * @param workspaceRoot - The workspace root directory for security validation
+ * @returns The prompt content or an error
+ */
+export declare function resolvePromptFromFile(promptFilePath: string, workspaceRoot: string): Promise<PromptFileResult>;
+/**
+ * Write worker prompt to a file and return the path.
+ *
+ * Creates the directory structure if it doesn't exist.
+ *
+ * @param feature - Feature name
+ * @param task - Task folder name
+ * @param prompt - The full worker prompt content
+ * @param hiveDir - The .hive directory path
+ * @returns The path to the written prompt file
+ */
+export declare function writeWorkerPromptFile(feature: string, task: string, prompt: string, hiveDir: string): string;

package/dist/utils/prompt-observability.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Prompt and payload observability utilities for Hive.
+ *
+ * Provides visibility into prompt/payload sizes to detect when
+ * thresholds are exceeded, preventing silent truncation risks.
+ */
+/**
+ * Metadata about prompt component sizes (in characters).
+ */
+export interface PromptMeta {
+    /** Size of the plan content in characters */
+    planChars: number;
+    /** Size of all context files combined in characters */
+    contextChars: number;
+    /** Size of previous task summaries in characters */
+    previousTasksChars: number;
+    /** Size of the task spec in characters */
+    specChars: number;
+    /** Size of the final worker prompt in characters */
+    workerPromptChars: number;
+}
+/**
+ * Metadata about the JSON payload.
+ */
+export interface PayloadMeta {
+    /** Size of the full JSON payload in characters */
+    jsonPayloadChars: number;
+    /** Whether the prompt is inlined in the payload */
+    promptInlined: boolean;
+    /** Whether the prompt is referenced by file path */
+    promptReferencedByFile: boolean;
+}
+/**
+ * Warning about threshold exceedance.
+ */
+export interface PromptWarning {
+    /** Type of warning */
+    type: 'workerPromptSize' | 'jsonPayloadSize' | 'contextSize' | 'previousTasksSize' | 'planSize';
+    /** Severity level */
+    severity: 'info' | 'warning' | 'critical';
+    /** Human-readable message */
+    message: string;
+    /** Current value */
+    currentValue: number;
+    /** Threshold that was exceeded */
+    threshold: number;
+}
+/**
+ * Configurable thresholds for warnings.
+ */
+export interface PromptThresholds {
+    /** Max chars for worker prompt before warning (default: 100KB) */
+    workerPromptMaxChars: number;
+    /** Max chars for JSON payload before warning (default: 150KB) */
+    jsonPayloadMaxChars: number;
+    /** Max chars for context before warning (default: 50KB) */
+    contextMaxChars: number;
+    /** Max chars for previous tasks before warning (default: 20KB) */
+    previousTasksMaxChars: number;
+    /** Max chars for plan before warning (default: 30KB) */
+    planMaxChars?: number;
+}
+/**
+ * Default thresholds for prompt/payload size warnings.
+ *
+ * These are conservative defaults based on typical LLM context limits
+ * and tool output size restrictions.
+ */
+export declare const DEFAULT_THRESHOLDS: PromptThresholds;
+/**
+ * Calculate metadata about prompt component sizes.
+ */
+export declare function calculatePromptMeta(inputs: {
+    plan: string;
+    context: string;
+    previousTasks: string;
+    spec: string;
+    workerPrompt: string;
+}): PromptMeta;
+/**
+ * Calculate metadata about the JSON payload.
+ */
+export declare function calculatePayloadMeta(inputs: {
+    jsonPayload: string;
+    promptInlined: boolean;
+    promptReferencedByFile?: boolean;
+}): PayloadMeta;
+/**
+ * Check for threshold exceedances and generate warnings.
+ *
+ * Returns an array of warnings. Empty array means all sizes are within limits.
+ */
+export declare function checkWarnings(promptMeta: PromptMeta, payloadMeta: PayloadMeta, thresholds?: Partial<PromptThresholds>): PromptWarning[];

package/dist/utils/worker-prompt.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Worker prompt builder for Hive delegated execution.
+ * Builds context-rich prompts for worker agents with all Hive context.
+ */
+export interface ContextFile {
+    name: string;
+    content: string;
+}
+export interface CompletedTask {
+    name: string;
+    summary: string;
+}
+export interface ContinueFromBlocked {
+    status: 'blocked';
+    previousSummary: string;
+    decision: string;
+}
+export interface WorkerPromptParams {
+    feature: string;
+    task: string;
+    taskOrder: number;
+    worktreePath: string;
+    branch: string;
+    plan: string;
+    contextFiles: ContextFile[];
+    spec: string;
+    previousTasks?: CompletedTask[];
+    continueFrom?: ContinueFromBlocked;
+}
+/**
+ * Build a context-rich prompt for a worker agent.
+ *
+ * Includes:
+ * - Assignment details (feature, task, worktree, branch)
+ * - Mission (spec) - contains plan section, context, and completed tasks
+ * - Blocker protocol (NOT question tool)
+ * - Completion protocol
+ *
+ * NOTE: Plan, context files, and previous tasks are NOT included separately
+ * because they are already embedded in the spec. This prevents duplication
+ * and keeps the prompt size bounded.
+ */
+export declare function buildWorkerPrompt(params: WorkerPromptParams): string;

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@hung319/opencode-hive",
+  "version": "1.3.1",
+  "type": "module",
+  "description": "OpenCode plugin for Agent Hive - from vibe coding to hive coding",
+  "license": "MIT WITH Commons-Clause",
+  "author": "hung319",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hung319/agent-hive.git",
+    "directory": "packages/opencode-hive"
+  },
+  "homepage": "https://github.com/hung319/agent-hive#readme",
+  "bugs": {
+    "url": "https://github.com/hung319/agent-hive/issues"
+  },
+  "keywords": [
+    "opencode",
+    "ai",
+    "hive",
+    "vibe-coding",
+    "workflow",
+    "planning",
+    "agent"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "clean": "rm -rf dist",
+    "generate-skills": "bun run scripts/generate-skills.ts",
+    "build": "npm run clean && npm run generate-skills && bun build src/index.ts --outdir dist --target node --format esm --packages=bundle && tsc --emitDeclarationOnly",
+    "dev": "opencode plugin dev",
+    "test": "bun test"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=0.13.7"
+  },
+  "dependencies": {
+    "simple-git": "^3.27.0"
+  },
+  "optionalDependencies": {
+    "grep-mcp": "^1.1.0",
+    "@notprolands/ast-grep-mcp": "^1.1.1",
+    "@upstash/context7-mcp": "^2.1.0",
+    "exa-mcp-server": "^3.1.5"
+  },
+  "devDependencies": {
+    "hive-core": "workspace:*",
+    "@opencode-ai/plugin": "^1.0.143",
+    "@opencode-ai/sdk": "^0.13.0",
+    "@types/bun": "^1.2.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist/",
+    "skills/",
+    "README.md"
+  ]
+}