opencode-pair-autonomy 1.0.0

package/dist/commands.d.ts

@@ -0,0 +1,2 @@
+import type { HarnessConfig } from "./types";
+export declare function createHarnessCommands(config: HarnessConfig): Record<string, Record<string, unknown>>;

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessConfig } from "./types";
+export declare function loadHarnessConfig(projectDirectory: string): HarnessConfig;
+export declare const SAMPLE_PROJECT_CONFIG = "{\n  // Project-level overrides for opencode-pair-autonomy\n  \"default_mode\": \"coordinator\",\n  \"credentials\": {\n    \"jina_api_key\": \"\",\n    \"figma_access_token\": \"\"\n  },\n  \"figma_console\": {\n    \"ssh_host\": \"\"\n  },\n  \"hooks\": {\n    \"profile\": \"standard\",\n    \"comment_guard\": true,\n    \"session_start\": true,\n    \"pre_tool_use\": true,\n    \"post_tool_use\": true,\n    \"pre_compact\": true,\n    \"stop\": true,\n    \"session_end\": true,\n    \"file_edited\": true,\n    \"prompt_refiner\": false\n  },\n  \"memory\": {\n    \"enabled\": true,\n    \"lookback_days\": 7,\n    \"max_injected_chars\": 3500\n  },\n  \"learning\": {\n    \"enabled\": true,\n    \"min_observations\": 6,\n    \"auto_promote\": true,\n    \"max_patterns\": 24,\n    \"max_injected_patterns\": 5\n  },\n  \"mcps\": {\n    \"context7\": true,\n    \"grep_app\": true,\n    \"websearch\": true,\n    \"fff\": true,\n    \"web_agent_mcp\": true,\n    \"pg_mcp\": true,\n    \"ssh_mcp\": true,\n    \"sudo_mcp\": false,\n    \"jina\": true,\n    \"figma_console\": true,\n    \"mariadb\": true\n  },\n  \"agents\": {}\n}";

package/dist/hooks/comment-guard.d.ts

@@ -0,0 +1,15 @@
+type ToolAfterInput = {
+    tool: string;
+    sessionID: string;
+    callID: string;
+    args: Record<string, unknown>;
+};
+type ToolAfterOutput = {
+    title: string;
+    output: string;
+    metadata: unknown;
+};
+export declare function createCommentGuardHook(): {
+    "tool.execute.after": (input: ToolAfterInput, output: ToolAfterOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/file-edited.d.ts

@@ -0,0 +1,7 @@
+import type { HookRuntime } from "./runtime";
+export declare function createFileEditedHook(runtime: HookRuntime): {
+    "file.edited": (event: {
+        path: string;
+        sessionID?: string;
+    }) => Promise<void>;
+};

package/dist/hooks/index.d.ts

@@ -0,0 +1,46 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { HarnessConfig } from "../types";
+export declare function createHarnessHooks(ctx: PluginInput, config: HarnessConfig): Promise<{
+    config: ((config: any) => Promise<void>) | undefined;
+    "chat.message": ((input: any, output: any) => Promise<void>) | undefined;
+    "chat.headers": undefined;
+    event: ((input: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>) | undefined;
+    "tool.execute.before": ((input: any) => Promise<void>) | undefined;
+    "tool.execute.after": ((input: any, output: any) => Promise<void>) | undefined;
+    "file.edited": ((input: any) => Promise<void>) | undefined;
+    "session.created": ((input: any) => Promise<void>) | undefined;
+    "session.idle": ((input: any) => Promise<void>) | undefined;
+    "session.deleted": ((input: any) => Promise<void>) | undefined;
+    "experimental.session.compacting": ((input: any) => Promise<void>) | undefined;
+    "experimental.chat.messages.transform": ((_input: unknown, output: {
+        messages?: {
+            info?: {
+                id?: string;
+                role?: string;
+                sessionID?: string;
+            };
+            parts?: {
+                id?: string;
+                sessionID?: string;
+                messageID?: string;
+                type: string;
+                text?: string;
+                mime?: string;
+                filename?: string;
+                ignored?: boolean;
+                synthetic?: boolean;
+                metadata?: Record<string, unknown>;
+            }[];
+        }[];
+    }) => Promise<void>) | undefined;
+    "experimental.text.complete": ((input: {
+        sessionID?: string;
+    }, output: {
+        text?: string;
+    }) => Promise<void>) | undefined;
+}>;

package/dist/hooks/post-tool-use.d.ts

@@ -0,0 +1,5 @@
+import type { HarnessConfig, HookProfile } from "../types";
+import type { HookRuntime } from "./runtime";
+export declare function createPostToolUseHook(config: HarnessConfig, runtime: HookRuntime, profile: HookProfile): {
+    "tool.execute.after": (input: unknown, output: unknown) => Promise<void>;
+};

package/dist/hooks/pre-compact.d.ts

@@ -0,0 +1,4 @@
+import type { HookRuntime } from "./runtime";
+export declare function createPreCompactHook(runtime: HookRuntime): {
+    "experimental.session.compacting": (input?: unknown) => Promise<void>;
+};

package/dist/hooks/pre-tool-use.d.ts

@@ -0,0 +1,5 @@
+import type { HarnessConfig } from "../types";
+import type { HookRuntime } from "./runtime";
+export declare function createPreToolUseHook(config: HarnessConfig, runtime: HookRuntime, profile: import("../types").HookProfile): {
+    "tool.execute.before": (input: unknown) => Promise<void>;
+};

package/dist/hooks/prompt-refiner.d.ts

@@ -0,0 +1,38 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+type MessagePart = {
+    id?: string;
+    sessionID?: string;
+    messageID?: string;
+    type: string;
+    text?: string;
+    mime?: string;
+    filename?: string;
+    ignored?: boolean;
+    synthetic?: boolean;
+    metadata?: Record<string, unknown>;
+};
+type Message = {
+    info?: {
+        id?: string;
+        role?: string;
+        sessionID?: string;
+    };
+    parts?: MessagePart[];
+};
+export declare function createPromptRefinerHook(ctx: PluginInput): {
+    "experimental.chat.messages.transform": (_input: unknown, output: {
+        messages?: Message[];
+    }) => Promise<void>;
+    "experimental.text.complete": (input: {
+        sessionID?: string;
+    }, output: {
+        text?: string;
+    }) => Promise<void>;
+    "experimental.session.compacting": (_input: {
+        sessionID: string;
+    }, output: {
+        context: string[];
+        prompt?: string;
+    }) => Promise<void>;
+};
+export {};

package/dist/hooks/runtime.d.ts

@@ -0,0 +1,91 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import { type SupportedLocale } from "../i18n";
+import type { HarnessConfig, HookProfile } from "../types";
+import { readText } from "../utils";
+import type { LearnedPattern } from "../learning/types";
+import { type ProjectFacts } from "../project-facts";
+export type PersistedSessionSummary = {
+    sessionID: string;
+    savedAt: string;
+    locale?: SupportedLocale;
+    packageManager: string;
+    languages: string[];
+    frameworks: string[];
+    changedFiles: string[];
+    incompleteTodos: string[];
+    lastUserMessage: string;
+    lastAssistantMessage: string;
+    approxTokens: number;
+};
+export type Observation = {
+    timestamp: string;
+    phase: "pre" | "post" | "idle";
+    sessionID?: string;
+    agent?: string;
+    tool?: string;
+    note?: string;
+};
+declare function estimateTokens(chunks: string[]): number;
+export declare function resolveHookProfile(config: HarnessConfig): HookProfile;
+export declare function profileMatches(profile: HookProfile, allowed: HookProfile | HookProfile[]): boolean;
+/**
+ * Primary (user-facing) agents that should receive session-context injection.
+ * Subagents spawned via Task tool should NOT get previous-session context
+ * injected into their system prompt — it causes session mixing.
+ */
+export declare const PRIMARY_AGENTS: Set<string>;
+/**
+ * Resolve a session ID from a hook input object.
+ *
+ * IMPORTANT: Does NOT fall back to bare `candidate.id` because tool-execution
+ * inputs often carry a tool-call / message `id` that is not a session ID.
+ * Use {@link resolveSessionOrEntityID} in session-lifecycle hooks where the
+ * input object IS the session itself and `.id` is the session ID.
+ */
+export declare function resolveSessionID(value: unknown): string | undefined;
+/**
+ * Like {@link resolveSessionID} but also falls back to bare `.id`.
+ * Use ONLY for session-lifecycle hooks (session.created, session.idle,
+ * session.deleted) where the input object represents the session itself.
+ */
+export declare function resolveSessionOrEntityID(value: unknown): string | undefined;
+export declare function resolveAgentName(value: unknown): string | undefined;
+export declare function resolveToolName(value: unknown): string | undefined;
+export declare function resolveToolArgs(value: unknown): Record<string, unknown>;
+export declare function resolveFilePathFromArgs(args: Record<string, unknown>): string | undefined;
+export declare function stringifyToolOutput(output: unknown): string;
+export declare function createHookRuntime(ctx: PluginInput, config: HarnessConfig): {
+    detectProjectFacts: () => ProjectFacts;
+    estimateTokens: typeof estimateTokens;
+    loadLatestSummary: () => PersistedSessionSummary | undefined;
+    loadLearnedPatterns: () => LearnedPattern[];
+    prepareSessionContext: (sessionID: string) => void;
+    consumePendingInjection: (sessionID: string, locale?: SupportedLocale) => string | undefined;
+    saveSessionSummary: (summary: PersistedSessionSummary) => void;
+    appendObservation: (observation: Observation) => void;
+    promoteLearning: (summary: PersistedSessionSummary) => LearnedPattern[];
+    setSessionAgent: (sessionID: string, agent: string | undefined) => void;
+    getSessionAgent: (sessionID: string) => string | undefined;
+    setSessionLocale: (sessionID: string, locale: SupportedLocale | undefined) => void;
+    getSessionLocale: (sessionID: string) => SupportedLocale | undefined;
+    resolveLocale: (sessionID?: string, ...texts: Array<string | undefined>) => SupportedLocale;
+    rememberEditedFile: (sessionID: string, filePath: string) => void;
+    getEditedFiles: (sessionID: string) => string[];
+    incrementToolCount: (sessionID: string) => number;
+    shouldSuggestCompact: (sessionID: string, threshold?: number, repeat?: number) => boolean;
+    clearSession: (sessionID: string) => void;
+    readText: typeof readText;
+    getPlanMode: (sessionID: string) => "planning" | "executing";
+    setPlanMode: (sessionID: string, mode: "planning" | "executing") => void;
+    incrementPlanModeBlock: (sessionID: string) => number;
+    resetPlanModeBlockCount: (sessionID: string) => void;
+    incrementWorkerMessages: (workerID: string) => number;
+    shouldSpawnFresh: (workerID: string) => boolean;
+    incrementReviewCycle: (sessionID: string) => number;
+    getReviewCycleCount: (sessionID: string) => number;
+    isWsl: () => boolean;
+    getWslWinPath: () => string;
+    buildModeInjection: (sessionID: string) => string;
+};
+export type HookRuntime = ReturnType<typeof createHookRuntime>;
+export {};

package/dist/hooks/sdk.d.ts

@@ -0,0 +1,6 @@
+export declare class BlockingHookError extends Error {
+    constructor(message: string);
+}
+export declare function unwrapData<T>(value: unknown, fallback: T): T;
+export declare function safeCreateHook<T>(name: string, factory: () => T): T | undefined;
+export declare function safeHook<T extends (...args: any[]) => Promise<void> | void>(name: string, hook?: T): T | undefined;

package/dist/hooks/session-end.d.ts

@@ -0,0 +1,4 @@
+import type { HookRuntime } from "./runtime";
+export declare function createSessionEndHook(runtime: HookRuntime): {
+    "session.deleted": (input?: unknown) => Promise<void>;
+};

package/dist/hooks/session-start.d.ts

@@ -0,0 +1,19 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { HarnessConfig } from "../types";
+import type { HookRuntime } from "./runtime";
+type ChatMessageInput = {
+    sessionID: string;
+    agent?: string;
+};
+type ChatMessageOutput = {
+    message: Record<string, unknown>;
+    parts?: Array<{
+        type?: string;
+        text?: string;
+    }>;
+};
+export declare function createSessionStartHook(ctx: PluginInput, config: HarnessConfig, runtime: HookRuntime): {
+    "session.created": (input?: unknown) => Promise<void>;
+    "chat.message": (input: ChatMessageInput, output: ChatMessageOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/stop.d.ts

@@ -0,0 +1,5 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { HookRuntime } from "./runtime";
+export declare function createStopHook(ctx: PluginInput, runtime: HookRuntime): {
+    "session.idle": (input?: unknown) => Promise<void>;
+};

package/dist/i18n/index.d.ts

@@ -0,0 +1,15 @@
+import en from "./en.json";
+export type SupportedLocale = "en" | "tr";
+type Catalog = typeof en;
+export declare function getCatalog(locale: SupportedLocale): Catalog;
+export declare function normalizeText(text: string): string;
+export declare function getSignals(locale: SupportedLocale, group: "intent" | "preferences", key: string): string[];
+export declare function getLanguageHints(locale: SupportedLocale): string[];
+export declare function matchesAnySignal(text: string, phrases: string[]): boolean;
+export declare function detectLocaleFromTexts(...texts: Array<string | undefined>): SupportedLocale;
+export declare function extractTextParts(parts: Array<{
+    type?: string;
+    text?: string;
+}>): string;
+export declare function getAllSignals(group: "intent" | "preferences", key: string): string[];
+export {};

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const PairAutonomyPlugin: Plugin;
+export default PairAutonomyPlugin;