@anthonyhaussman/opencode-agy-auth 1.2.17 → 1.3.0

package/README.md

@@ -14,6 +14,7 @@ An [OpenCode](https://opencode.ai/) authentication plugin that enables seamless
 - **Dynamic Model Retrieval**: Fetches available models based on user tier and current allocations.
 - **Quota Tracking**: Injects the `agy_quota` tool into OpenCode to check usage limits directly.
 - **Traffic Simulation**: Maintains background heartbeat with `agy` servers.
+- **Dual OpenCode Compatibility**: Natively supports both OpenCode v1 (>= 1.18.29) and OpenCode v2 out of the box without breaking changes.
 
 ## Installation
 
@@ -144,9 +145,18 @@ To test and develop the plugin locally with OpenCode before publishing:
 3. **Verify the plugin**:
    Launch OpenCode in your target project. OpenCode will automatically resolve and load your local plugin directory. You can test your changes by running `npm run build` in the plugin directory and restarting your OpenCode session.
 
-## Alpha Channel (Pre-release)
+## OpenCode Runtime Compatibility
 
-To test bleeding-edge features, upcoming changes, or [OpenCode v2](https://opencode.ai/v2/docs) compatibility before official releases, configure the `@alpha` distribution tag:
+The plugin natively supports both OpenCode v1 (>= 1.18.29) and [OpenCode v2](https://opencode.ai/v2/docs) out of the box through a dual-compatibility architecture:
+
+- **OpenCode v1**: Loaded via the `server(options)` hook with custom OAuth flow and provider setup.
+- **OpenCode v2**: Loaded via `Plugin.define` / `setup(ctx)` with native catalog transformations, AI SDK hooks, session interception, and PKCE OAuth integration.
+
+No special flags or configurations are required - the plugin detects runtime automatically.
+
+## Pre-release Channel
+
+To test bleeding-edge features or upcoming changes before official releases, configure the `@alpha` distribution tag:
 
 ```bash
 npm install @anthonyhaussman/opencode-agy-auth@alpha
@@ -160,12 +170,8 @@ Or configure it directly in your `opencode.json`:
 }
 ```
 
-### OpenCode v2 Compatibility
-
-The `@alpha` channel provides dual compatibility with both OpenCode v1 and [OpenCode v2](https://opencode.ai/v2/docs), supporting the new v2 plugin architecture, unified hooks, and OAuth credential handling while maintaining full backward compatibility.
-
 > [!WARNING]
-> **Instability Warning**: The `@alpha` release contains experimental features, active development builds, and potential breaking protocol changes. It may be unstable, break unexpectedly, or cause disruptions in session authentication and model requests. Use only for testing and development. For day-to-day work, use the stable release.
+> **Instability Warning**: The `@alpha` release contains experimental features and active development builds. It may be unstable or cause disruptions in session authentication and model requests. Use only for testing and development. For day-to-day work, use the stable release.
 
 ## Star History & Support
 

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { AgyCLIOAuthPlugin, GoogleOAuthPlugin } from "./src/plugin";
+import { setupOpenCodeV2, v2PluginDefinition } from "./src/plugin/v2";
+import type { DualOpenCodePlugin } from "./src/plugin/types";
 export { AgyCLIOAuthPlugin, GoogleOAuthPlugin };
-declare const _default: {
-    id: string;
-    server: typeof AgyCLIOAuthPlugin;
-};
-export default _default;
+export { setupOpenCodeV2, v2PluginDefinition };
+export * from "./src/plugin/types";
+declare const dualPlugin: DualOpenCodePlugin;
+export default dualPlugin;