homer-simpson 0.1.0

package/dist/hooks/session-recovery/types.d.ts

@@ -0,0 +1,90 @@
+export type ThinkingPartType = "thinking" | "redacted_thinking" | "reasoning";
+export type MetaPartType = "step-start" | "step-finish";
+export type ContentPartType = "text" | "tool" | "tool_use" | "tool_result";
+export interface StoredMessageMeta {
+    id: string;
+    sessionID: string;
+    role: "user" | "assistant";
+    parentID?: string;
+    time?: {
+        created: number;
+        completed?: number;
+    };
+    error?: unknown;
+}
+export interface StoredTextPart {
+    id: string;
+    sessionID: string;
+    messageID: string;
+    type: "text";
+    text: string;
+    synthetic?: boolean;
+    ignored?: boolean;
+}
+export interface StoredToolPart {
+    id: string;
+    sessionID: string;
+    messageID: string;
+    type: "tool";
+    callID: string;
+    tool: string;
+    state: {
+        status: "pending" | "running" | "completed" | "error";
+        input: Record<string, unknown>;
+        output?: string;
+        error?: string;
+    };
+}
+export interface StoredReasoningPart {
+    id: string;
+    sessionID: string;
+    messageID: string;
+    type: "reasoning";
+    text: string;
+}
+export interface StoredStepPart {
+    id: string;
+    sessionID: string;
+    messageID: string;
+    type: "step-start" | "step-finish";
+}
+export type StoredPart = StoredTextPart | StoredToolPart | StoredReasoningPart | StoredStepPart | {
+    id: string;
+    sessionID: string;
+    messageID: string;
+    type: string;
+    [key: string]: unknown;
+};
+export interface MessageData {
+    info?: {
+        id?: string;
+        role?: string;
+        sessionID?: string;
+        parentID?: string;
+        error?: unknown;
+        agent?: string;
+        model?: {
+            providerID: string;
+            modelID: string;
+        };
+        system?: string;
+        tools?: Record<string, boolean>;
+    };
+    parts?: Array<{
+        type: string;
+        id?: string;
+        text?: string;
+        thinking?: string;
+        name?: string;
+        input?: Record<string, unknown>;
+        callID?: string;
+    }>;
+}
+export interface ResumeConfig {
+    sessionID: string;
+    agent?: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+}

package/dist/hooks/start-work/index.d.ts

@@ -0,0 +1,16 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare const HOOK_NAME = "start-work";
+interface StartWorkHookInput {
+    sessionID: string;
+    messageID?: string;
+}
+interface StartWorkHookOutput {
+    parts: Array<{
+        type: string;
+        text?: string;
+    }>;
+}
+export declare function createStartWorkHook(ctx: PluginInput): {
+    "chat.message": (input: StartWorkHookInput, output: StartWorkHookOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/start-work/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/status-recorder/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Status Recorder Hook
+ * 현재 세션 내 시도 기록 및 실패 분석을 위한 훅
+ */
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { ContextCollector } from "../../features/context-injector";
+export interface StatusRecorderOptions {
+    /** Project root path */
+    projectRoot: string;
+    /** Enable status recording */
+    enabled?: boolean;
+}
+/**
+ * Creates the status recorder hook
+ */
+export declare function createStatusRecorderHook(_ctx: PluginInput, collector?: ContextCollector, options?: StatusRecorderOptions): {
+    /**
+     * When a new task starts, create status file
+     */
+    "task.start": (input: {
+        sessionID: string;
+        task: string;
+        specFile?: string;
+    }) => Promise<void>;
+    /**
+     * When an attempt is made (success or failure)
+     */
+    "task.attempt": (input: {
+        sessionID: string;
+        method: string;
+        result: "success" | "failed" | "partial";
+        reason?: string;
+        files?: string[];
+    }) => Promise<void>;
+    /**
+     * Add a lesson learned
+     */
+    "task.lesson": (input: {
+        sessionID: string;
+        lesson: string;
+    }) => Promise<void>;
+    /**
+     * Inject status summary at the start of a message
+     */
+    "chat.message": (input: {
+        sessionID: string;
+    }, _output: {
+        message: Record<string, unknown>;
+    }) => Promise<void>;
+};
+export { createStatus, recordAttempt, addLesson, getStatus } from "../../tools/status-recorder";

package/dist/hooks/task-resume-info/index.d.ts

@@ -0,0 +1,11 @@
+export declare function createTaskResumeInfoHook(): {
+    "tool.execute.after": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+};

package/dist/hooks/think-mode/detector.d.ts

@@ -0,0 +1,5 @@
+export declare function detectThinkKeyword(text: string): boolean;
+export declare function extractPromptText(parts: Array<{
+    type: string;
+    text?: string;
+}>): string;

package/dist/hooks/think-mode/index.d.ts

@@ -0,0 +1,14 @@
+import type { ThinkModeInput } from "./types";
+export * from "./detector";
+export * from "./switcher";
+export * from "./types";
+export declare function clearThinkModeState(sessionID: string): void;
+export declare function createThinkModeHook(): {
+    "chat.params": (output: ThinkModeInput, sessionID: string) => Promise<void>;
+    event: ({ event }: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+};

package/dist/hooks/think-mode/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/think-mode/switcher.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Think Mode Switcher
+ *
+ * This module handles "thinking mode" activation for reasoning-capable models.
+ * When a user includes "think" keywords in their prompt, models are upgraded to
+ * their high-reasoning variants with extended thinking budgets.
+ *
+ * PROVIDER ALIASING:
+ * GitHub Copilot acts as a proxy provider that routes to underlying providers
+ * (Anthropic, Google, OpenAI). We resolve the proxy to the actual provider
+ * based on model name patterns, allowing GitHub Copilot to inherit thinking
+ * configurations without duplication.
+ *
+ * NORMALIZATION:
+ * Model IDs are normalized (dots → hyphens in version numbers) to handle API
+ * inconsistencies defensively while maintaining backwards compatibility.
+ */
+export declare const THINKING_CONFIGS: {
+    readonly anthropic: {
+        readonly thinking: {
+            readonly type: "enabled";
+            readonly budgetTokens: 64000;
+        };
+        readonly maxTokens: 128000;
+    };
+    readonly "amazon-bedrock": {
+        readonly reasoningConfig: {
+            readonly type: "enabled";
+            readonly budgetTokens: 32000;
+        };
+        readonly maxTokens: 64000;
+    };
+    readonly google: {
+        readonly providerOptions: {
+            readonly google: {
+                readonly thinkingConfig: {
+                    readonly thinkingLevel: "HIGH";
+                };
+            };
+        };
+    };
+    readonly "google-vertex": {
+        readonly providerOptions: {
+            readonly "google-vertex": {
+                readonly thinkingConfig: {
+                    readonly thinkingLevel: "HIGH";
+                };
+            };
+        };
+    };
+    readonly openai: {
+        readonly reasoning_effort: "high";
+    };
+};
+export declare function getHighVariant(modelID: string): string | null;
+export declare function isAlreadyHighVariant(modelID: string): boolean;
+export declare function getThinkingConfig(providerID: string, modelID: string): Record<string, unknown> | null;

package/dist/hooks/think-mode/switcher.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/think-mode/types.d.ts

@@ -0,0 +1,21 @@
+export interface ThinkModeState {
+    requested: boolean;
+    modelSwitched: boolean;
+    thinkingConfigInjected: boolean;
+    providerID?: string;
+    modelID?: string;
+}
+export interface ModelRef {
+    providerID: string;
+    modelID: string;
+}
+export interface MessageWithModel {
+    model?: ModelRef;
+}
+export interface ThinkModeInput {
+    parts: Array<{
+        type: string;
+        text?: string;
+    }>;
+    message: MessageWithModel;
+}

package/dist/hooks/thinking-block-validator/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Proactive Thinking Block Validator Hook
+ *
+ * Prevents "Expected thinking/redacted_thinking but found tool_use" errors
+ * by validating and fixing message structure BEFORE sending to Anthropic API.
+ *
+ * This hook runs on the "experimental.chat.messages.transform" hook point,
+ * which is called before messages are converted to ModelMessage format and
+ * sent to the API.
+ *
+ * Key differences from session-recovery hook:
+ * - PROACTIVE (prevents error) vs REACTIVE (fixes after error)
+ * - Runs BEFORE API call vs AFTER API error
+ * - User never sees the error vs User sees error then recovery
+ */
+import type { Message, Part } from "@opencode-ai/sdk";
+interface MessageWithParts {
+    info: Message;
+    parts: Part[];
+}
+type MessagesTransformHook = {
+    "experimental.chat.messages.transform"?: (input: Record<string, never>, output: {
+        messages: MessageWithParts[];
+    }) => Promise<void>;
+};
+/**
+ * Validate and fix assistant messages that have tool_use but no thinking block
+ */
+export declare function createThinkingBlockValidatorHook(): MessagesTransformHook;
+export {};

package/dist/hooks/todo-continuation-enforcer.d.ts

@@ -0,0 +1,17 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { BackgroundManager } from "../features/background-agent";
+export interface TodoContinuationEnforcerOptions {
+    backgroundManager?: BackgroundManager;
+    skipAgents?: string[];
+}
+export interface TodoContinuationEnforcer {
+    handler: (input: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+    markRecovering: (sessionID: string) => void;
+    markRecoveryComplete: (sessionID: string) => void;
+}
+export declare function createTodoContinuationEnforcer(ctx: PluginInput, options?: TodoContinuationEnforcerOptions): TodoContinuationEnforcer;

package/dist/hooks/todo-continuation-enforcer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/tool-output-truncator.d.ts

@@ -0,0 +1,17 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { ExperimentalConfig } from "../config/schema";
+interface ToolOutputTruncatorOptions {
+    experimental?: ExperimentalConfig;
+}
+export declare function createToolOutputTruncatorHook(ctx: PluginInput, options?: ToolOutputTruncatorOptions): {
+    "tool.execute.after": (input: {
+        tool: string;
+        sessionID: string;
+        callID: string;
+    }, output: {
+        title: string;
+        output: string;
+        metadata: unknown;
+    }) => Promise<void>;
+};
+export {};

package/dist/hooks/tool-output-truncator.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const HomerSimpsonPlugin: Plugin;
+export default HomerSimpsonPlugin;
+export type { HomerSimpsonConfig, AgentName, AgentOverrideConfig, AgentOverrides, McpName, HookName, BuiltinCommandName, } from "./config";
+export type { ConfigLoadError } from "./shared/config-errors";