oh-my-opencode-lite 0.1.0

package/dist/delegation/paths.d.ts

@@ -0,0 +1,15 @@
+import type { DelegationConfig } from '../config';
+export interface DelegationPaths {
+    storageDir: string;
+    projectDir: string;
+    sessionDir: string;
+    taskFile: string;
+}
+export declare function resolveStorageDir(config?: DelegationConfig): string;
+export declare function resolvePaths(input: {
+    config?: DelegationConfig;
+    projectId: string;
+    rootSessionId: string;
+    taskId: string;
+}): DelegationPaths;
+export declare function ensureDelegationDirectories(paths: Pick<DelegationPaths, 'projectDir' | 'sessionDir'>): Promise<void>;

package/dist/delegation/project-id.d.ts

@@ -0,0 +1 @@
+export declare function getProjectId(directory: string, timeoutMs?: number): Promise<string | null>;

package/dist/delegation/types.d.ts

@@ -0,0 +1,39 @@
+export declare const DELEGATION_STATUSES: readonly ["running", "complete", "error", "timeout", "cancelled"];
+export type DelegationStatus = (typeof DELEGATION_STATUSES)[number];
+export interface DelegationRecord {
+    id: string;
+    agent: string;
+    status: DelegationStatus;
+    title: string;
+    summary: string;
+    startedAt: string;
+    completedAt: string | null;
+    content: string;
+}
+export type DelegationHeader = {
+    id: string;
+    title: string;
+    summary: string;
+    agent: string;
+    status: DelegationStatus;
+    projectId: string;
+    rootSessionId: string;
+    startedAt: string;
+    completedAt: string | null;
+    persistedAt: string;
+};
+export interface PersistedDelegationRecord {
+    path: string;
+    header: DelegationHeader;
+    record: DelegationRecord;
+}
+export interface DelegationListEntry {
+    path: string;
+    id: string;
+    agent: string;
+    status: DelegationStatus;
+    title: string;
+    summary: string;
+    startedAt: string;
+    completedAt: string | null;
+}

package/dist/hooks/auto-update-checker/cache.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Invalidates the current package by removing its directory and dependency entries.
+ * This forces a clean state before running a fresh install.
+ * @param packageName The name of the package to invalidate.
+ */
+export declare function invalidatePackage(packageName?: string): boolean;

package/dist/hooks/auto-update-checker/checker.d.ts

@@ -0,0 +1,28 @@
+import type { PluginEntryInfo } from './types';
+/**
+ * Extracts the update channel (latest, alpha, beta, etc.) from a version string.
+ * @param version The version or tag to analyze.
+ * @returns The channel name.
+ */
+export declare function extractChannel(version: string | null): string;
+/**
+ * Resolves the version of the plugin when running in local development mode.
+ */
+export declare function getLocalDevVersion(directory: string): string | null;
+/**
+ * Searches across all config locations to find the current installation entry for this plugin.
+ */
+export declare function findPluginEntry(directory: string): PluginEntryInfo | null;
+/**
+ * Resolves the installed version from node_modules, with memoization.
+ */
+export declare function getCachedVersion(): string | null;
+/**
+ * Safely updates a pinned version in the configuration file.
+ * It attempts to replace the exact plugin string to preserve comments and formatting.
+ */
+export declare function updatePinnedVersion(configPath: string, oldEntry: string, newVersion: string): boolean;
+/**
+ * Fetches the latest version for a specific channel from the NPM registry.
+ */
+export declare function getLatestVersion(channel?: string): Promise<string | null>;

package/dist/hooks/auto-update-checker/constants.d.ts

@@ -0,0 +1,11 @@
+export declare const PACKAGE_NAME = "oh-my-opencode-lite";
+export declare const NPM_REGISTRY_URL = "https://registry.npmjs.org/-/package/oh-my-opencode-lite/dist-tags";
+export declare const NPM_FETCH_TIMEOUT = 5000;
+/** The directory used by OpenCode to cache node_modules for plugins. */
+export declare const CACHE_DIR: string;
+/** Path to this plugin's package.json within the OpenCode cache. */
+export declare const INSTALLED_PACKAGE_JSON: string;
+/** Primary OpenCode configuration file path (standard JSON). */
+export declare const USER_OPENCODE_CONFIG: string;
+/** Alternative OpenCode configuration file path (JSON with Comments). */
+export declare const USER_OPENCODE_CONFIG_JSONC: string;

package/dist/hooks/auto-update-checker/index.d.ts

@@ -0,0 +1,17 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { AutoUpdateCheckerOptions } from './types';
+/**
+ * Creates an OpenCode hook that checks for plugin updates when a new session is created.
+ * @param ctx The plugin input context.
+ * @param options Configuration options for the update checker.
+ * @returns A hook object for the session.created event.
+ */
+export declare function createAutoUpdateCheckerHook(ctx: PluginInput, options?: AutoUpdateCheckerOptions): {
+    event: ({ event }: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => void;
+};
+export type { AutoUpdateCheckerOptions } from './types';

package/dist/hooks/auto-update-checker/types.d.ts

@@ -0,0 +1,23 @@
+export interface NpmDistTags {
+    latest: string;
+    [key: string]: string;
+}
+export interface OpencodeConfig {
+    plugin?: string[];
+    [key: string]: unknown;
+}
+export interface PackageJson {
+    version: string;
+    name?: string;
+    [key: string]: unknown;
+}
+export interface AutoUpdateCheckerOptions {
+    showStartupToast?: boolean;
+    autoUpdate?: boolean;
+}
+export interface PluginEntryInfo {
+    entry: string;
+    isPinned: boolean;
+    pinnedVersion: string | null;
+    configPath: string;
+}

package/dist/hooks/chat-headers.d.ts

@@ -0,0 +1,16 @@
+import type { PluginInput, ProviderContext } from '@opencode-ai/plugin';
+import type { Model, UserMessage } from '@opencode-ai/sdk';
+interface ChatHeadersInput {
+    sessionID: string;
+    model: Model;
+    provider: ProviderContext;
+    message: UserMessage;
+}
+interface ChatHeadersOutput {
+    headers: Record<string, string>;
+}
+export declare function __resetInternalMarkerCacheForTesting(): void;
+export declare function createChatHeadersHook(ctx: PluginInput): {
+    'chat.headers': (input: ChatHeadersInput, output: ChatHeadersOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/clarification-gate/index.d.ts

@@ -0,0 +1,30 @@
+import { type ClarificationGateConfig } from '../../config';
+export declare const CLARIFICATION_GATE_TAG = "clarification-gate";
+interface MessageInfo {
+    role: string;
+    agent?: string;
+    sessionID?: string;
+}
+interface MessagePart {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}
+interface MessageWithParts {
+    info: MessageInfo;
+    parts: MessagePart[];
+}
+export interface CreateClarificationGateHookOptions {
+    clarificationGate?: Partial<ClarificationGateConfig>;
+}
+/**
+ * Creates the experimental.chat.messages.transform hook for clarification gate injection.
+ * This hook runs right before sending to API, so it doesn't affect UI display.
+ * Only injects for the orchestrator agent.
+ */
+export declare function createClarificationGateHook(options?: CreateClarificationGateHookOptions): {
+    'experimental.chat.messages.transform': (_input: Record<string, never>, output: {
+        messages: MessageWithParts[];
+    }) => Promise<void>;
+};
+export {};

package/dist/hooks/delegate-task-retry/guidance.d.ts

@@ -0,0 +1,2 @@
+import { type DetectedError } from './patterns';
+export declare function buildRetryGuidance(errorInfo: DetectedError): string;

package/dist/hooks/delegate-task-retry/hook.d.ts

@@ -0,0 +1,8 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+export declare function createDelegateTaskRetryHook(_ctx: PluginInput): {
+    'tool.execute.after': (input: {
+        tool: string;
+    }, output: {
+        output: unknown;
+    }) => Promise<void>;
+};

package/dist/hooks/delegate-task-retry/index.d.ts

@@ -0,0 +1,4 @@
+export { buildRetryGuidance } from './guidance';
+export { createDelegateTaskRetryHook } from './hook';
+export type { DelegateTaskErrorPattern, DetectedError } from './patterns';
+export { DELEGATE_TASK_ERROR_PATTERNS, detectDelegateTaskError, } from './patterns';

package/dist/hooks/delegate-task-retry/patterns.d.ts

@@ -0,0 +1,11 @@
+export interface DelegateTaskErrorPattern {
+    pattern: string;
+    errorType: string;
+    fixHint: string;
+}
+export declare const DELEGATE_TASK_ERROR_PATTERNS: DelegateTaskErrorPattern[];
+export interface DetectedError {
+    errorType: string;
+    originalOutput: string;
+}
+export declare function detectDelegateTaskError(output: string): DetectedError | null;

package/dist/hooks/foreground-fallback/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Runtime model fallback for foreground (interactive) agent sessions.
+ *
+ * When OpenCode fires a session.error, message.updated, or session.status
+ * event containing a rate-limit signal, this manager:
+ *   1. Looks up the next untried model in the agent's configured chain
+ *   2. Aborts the rate-limited prompt via client.session.abort()
+ *   3. Re-queues the last user message via client.session.promptAsync()
+ *      with the new model — promptAsync returns immediately so we never
+ *      block the event handler waiting for a full LLM response.
+ *
+ * This mirrors the BackgroundTaskManager's fallback loop but operates
+ * reactively through the event system instead of wrapping prompt() in a
+ * try/catch, which is not possible for interactive (foreground) sessions.
+ */
+import type { PluginInput } from '@opencode-ai/plugin';
+type OpencodeClient = PluginInput['client'];
+export declare function isRateLimitError(error: unknown): boolean;
+/**
+ * Manages runtime model fallback for foreground agent sessions.
+ *
+ * Constructed at plugin init with the ordered fallback chains for each agent
+ * (built from _modelArray entries merged with fallback.chains config).
+ */
+export declare class ForegroundFallbackManager {
+    private readonly client;
+    /**
+     * Ordered fallback chains per agent.
+     * e.g. { orchestrator: ['anthropic/claude-opus-4-5', 'openai/gpt-4o'] }
+     * The first model that hasn't been tried yet is selected on each fallback.
+     */
+    private readonly chains;
+    private readonly enabled;
+    /** sessionID → last observed model string ("providerID/modelID") */
+    private readonly sessionModel;
+    /** sessionID → agent name (populated from message.updated info.agent field) */
+    private readonly sessionAgent;
+    /** sessionID → set of models already attempted this session */
+    private readonly sessionTried;
+    /** Sessions with an active fallback switch in flight */
+    private readonly inProgress;
+    /** sessionID → timestamp of last trigger (for deduplication) */
+    private readonly lastTrigger;
+    constructor(client: OpencodeClient, 
+    /**
+     * Ordered fallback chains per agent.
+     * e.g. { orchestrator: ['anthropic/claude-opus-4-5', 'openai/gpt-4o'] }
+     * The first model that hasn't been tried yet is selected on each fallback.
+     */
+    chains: Record<string, string[]>, enabled: boolean);
+    /**
+     * Process an OpenCode plugin event.
+     * Call this from the plugin's `event` hook for every event received.
+     */
+    handleEvent(rawEvent: unknown): Promise<void>;
+    private tryFallback;
+    /**
+     * Determine the fallback chain to use for a session.
+     *
+     * Priority:
+     * 1. Agent name known AND has a configured chain → return it directly
+     * 2. Agent name known but NO chain configured → return [] (no fallback;
+     *    do NOT bleed into other agents' chains which would re-prompt the
+     *    session with a model belonging to a completely different agent)
+     * 3. Agent name unknown, current model known → search all chains for
+     *    the model to infer which chain to use
+     * 4. Nothing matches → flatten all chains as a last resort (only
+     *    reached when both agent name and current model are unavailable)
+     */
+    private resolveChain;
+}
+export {};

package/dist/hooks/index.d.ts

@@ -0,0 +1,11 @@
+export type { AutoUpdateCheckerOptions } from './auto-update-checker';
+export { createAutoUpdateCheckerHook } from './auto-update-checker';
+export { createChatHeadersHook } from './chat-headers';
+export { createClarificationGateHook } from './clarification-gate';
+export { createDelegateTaskRetryHook } from './delegate-task-retry';
+export { ForegroundFallbackManager, isRateLimitError, } from './foreground-fallback';
+export { createJsonErrorRecoveryHook } from './json-error-recovery';
+export { createPhaseReminderHook } from './phase-reminder';
+export { createPostReadNudgeHook } from './post-read-nudge';
+export { syncSkillsOnStartup } from './skill-sync';
+export { createThothMemHook } from './thoth-mem';

package/dist/hooks/json-error-recovery/hook.d.ts

@@ -0,0 +1,18 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+export declare const JSON_ERROR_TOOL_EXCLUDE_LIST: readonly ["bash", "read", "glob", "webfetch", "grep_app_searchgithub", "websearch_web_search_exa"];
+export declare const JSON_ERROR_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+export declare const JSON_ERROR_REMINDER = "\n[JSON PARSE ERROR - IMMEDIATE ACTION REQUIRED]\n\nYou sent invalid JSON arguments. The system could not parse your tool call.\nSTOP and do this NOW:\n\n1. LOOK at the error message above to see what was expected vs what you sent.\n2. CORRECT your JSON syntax (missing braces, unescaped quotes, trailing commas, etc).\n3. RETRY the tool call with valid JSON.\n\nDO NOT repeat the exact same invalid call.\n";
+interface ToolExecuteAfterInput {
+    tool: string;
+    sessionID: string;
+    callID: string;
+}
+interface ToolExecuteAfterOutput {
+    title: string;
+    output: unknown;
+    metadata: unknown;
+}
+export declare function createJsonErrorRecoveryHook(_ctx: PluginInput): {
+    'tool.execute.after': (input: ToolExecuteAfterInput, output: ToolExecuteAfterOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/json-error-recovery/index.d.ts

@@ -0,0 +1 @@
+export { createJsonErrorRecoveryHook, JSON_ERROR_PATTERNS, JSON_ERROR_REMINDER, JSON_ERROR_TOOL_EXCLUDE_LIST, } from './hook';

package/dist/hooks/phase-reminder/index.d.ts

@@ -0,0 +1,26 @@
+export declare const PHASE_REMINDER = "<reminder>Recall Workflow Rules:\nUnderstand \u2192 find the best path (delegate based on rules and parallelize independent work) \u2192 execute \u2192 verify.\nIf delegating, launch the specialist in the same turn you mention it.</reminder>";
+interface MessageInfo {
+    role: string;
+    agent?: string;
+    sessionID?: string;
+}
+interface MessagePart {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}
+interface MessageWithParts {
+    info: MessageInfo;
+    parts: MessagePart[];
+}
+/**
+ * Creates the experimental.chat.messages.transform hook for phase reminder injection.
+ * This hook runs right before sending to API, so it doesn't affect UI display.
+ * Only injects for the orchestrator agent.
+ */
+export declare function createPhaseReminderHook(): {
+    'experimental.chat.messages.transform': (_input: Record<string, never>, output: {
+        messages: MessageWithParts[];
+    }) => Promise<void>;
+};
+export {};

package/dist/hooks/post-read-nudge/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Post-Read nudge - appends a delegation reminder after file reads.
+ * Catches the "read files → implement myself" anti-pattern.
+ */
+interface ToolExecuteAfterInput {
+    tool: string;
+    sessionID?: string;
+    callID?: string;
+}
+interface ToolExecuteAfterOutput {
+    title: string;
+    output: string;
+    metadata: Record<string, unknown>;
+}
+export declare function createPostReadNudgeHook(): {
+    'tool.execute.after': (input: ToolExecuteAfterInput, output: ToolExecuteAfterOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/skill-sync.d.ts

@@ -0,0 +1,10 @@
+import { installCustomSkills } from '../cli/custom-skills';
+import { log } from '../utils/logger';
+interface SkillSyncDependencies {
+    install?: typeof installCustomSkills;
+    logger?: typeof log;
+    warn?: typeof console.warn;
+    error?: typeof console.error;
+}
+export declare function syncSkillsOnStartup(dependencies?: SkillSyncDependencies): void;
+export {};

package/dist/hooks/thoth-mem/index.d.ts

@@ -0,0 +1,46 @@
+import type { Event, Model, Part } from '@opencode-ai/sdk';
+import type { ThothConfig } from '../../config';
+export interface CreateThothMemHookOptions {
+    project: string;
+    directory?: string;
+    thoth?: ThothConfig;
+    enabled?: boolean;
+}
+export declare function createThothMemHook(options: CreateThothMemHookOptions): {
+    event: ({ event }: {
+        event: Event;
+    }) => Promise<void>;
+    'chat.message': (input: {
+        sessionID: string;
+    }, output: {
+        parts: Part[];
+        message: {
+            summary?: {
+                title?: string;
+                body?: string;
+            };
+        };
+    }) => Promise<void>;
+    'experimental.chat.system.transform': (input: {
+        sessionID?: string;
+        model: Model;
+    }, output: {
+        system: string[];
+    }) => Promise<void>;
+    'experimental.session.compacting': (input: {
+        sessionID: string;
+    }, output: {
+        context: string[];
+        prompt?: string;
+    }) => Promise<void>;
+    'tool.execute.after': (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+        args: unknown;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+};

package/dist/hooks/thoth-mem/protocol.d.ts

@@ -0,0 +1,6 @@
+export declare const SDD_TOPIC_KEY_FORMAT = "sdd/{change}/{artifact}";
+export declare const FIRST_ACTION_INSTRUCTION = "FIRST ACTION REQUIRED: Call mem_session_summary with the content of the compacted summary. This preserves what was accomplished before compaction. Do this BEFORE any other work. Then call mem_context to recover additional context from previous sessions.";
+export declare const SESSION_SUMMARY_TEMPLATE = "Use this exact structure for `mem_session_summary` content:\n\n## Goal\n[What we were working on this session]\n\n## Instructions\n[User preferences or constraints discovered during this session]\n\n## Discoveries\n- [Technical findings, gotchas, non-obvious learnings]\n\n## Accomplished\n- [Completed items with key details]\n\n## Next Steps\n- [What remains to be done]\n\n## Relevant Files\n- path/to/file.ts - [what it does or what changed]";
+export declare function buildCompactionReminder(sessionID: string): string;
+export declare function buildCompactorInstruction(project: string): string;
+export declare function buildMemoryInstructions(sessionID: string, project: string): string;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from '@opencode-ai/plugin';
+declare const OhMyOpenCodeLite: Plugin;
+export default OhMyOpenCodeLite;
+export type { AgentName, AgentOverrideConfig, McpName, PluginConfig, TmuxConfig, TmuxLayout, } from './config';
+export type { RemoteMcpConfig } from './mcp';