@simonesiega/codex-limits 1.0.0 → 1.1.0

package/docs/readme/agents/copilot.md

@@ -39,7 +39,7 @@ The installer writes one user-scoped extension entry point:
 
 When `COPILOT_HOME` is set, the installer uses `extensions/codex-limits/extension.mjs` under that directory instead. The `codex-limits` subdirectory gives the extension its host-visible name.
 
-The published package contains the bundled source at `dist/copilot.mjs`. The installer copies that bundle to the ESM `extension.mjs` entry point. GitHub Copilot CLI starts it as a separate Node.js process and supplies `@github/copilot-sdk/extension` through its extension module resolver; users do not install the SDK separately.
+The published package contains the bundled source at `dist/copilot.mjs` and exposes that host module as `@simonesiega/codex-limits/copilot`. The installer copies the same bundle to the ESM `extension.mjs` entry point. GitHub Copilot CLI starts it as a separate Node.js process and supplies `@github/copilot-sdk/extension` through its extension module resolver; users do not install the SDK separately. The package subpath is a host entry point, not an alternative installation command or a general-purpose JavaScript API.
 
 The installer:
 

package/docs/readme/agents/opencode.md

@@ -40,6 +40,8 @@ It adds the following package to each file's `plugin` array:
 "@simonesiega/codex-limits"
 ```
 
+The package root and the explicit `@simonesiega/codex-limits/opencode` host subpath resolve to the same bundled plugin. The installer uses the root package name for OpenCode plugin-loader compatibility; the subpath is not a separate installation method.
+
 Both files are updated because compatible OpenCode versions discover TUI plugins through different global configuration files. The installer:
 
 - creates a missing configuration as a JSON object with the appropriate OpenCode schema;

package/docs/readme/agents/pi.md

@@ -44,7 +44,7 @@ When `PI_CODING_AGENT_DIR` is set, the installer uses `settings.json` under that
 }
 ```
 
-Registering the local package root avoids another download and keeps the extension synchronized with the globally installed `codex-limits` package. The installer also recognizes existing unversioned, tagged, or pinned `npm:@simonesiega/codex-limits` pi package registrations. If a matching object registration filters out the bundled extension, the named installer force-enables only `dist/pi.js` while preserving unrelated resource filters.
+Registering the local package root avoids another download and keeps the extension synchronized with the globally installed `codex-limits` package. The same host module is exposed explicitly as `@simonesiega/codex-limits/pi`, but pi installation continues to use the package manifest rather than that subpath directly. The installer also recognizes existing unversioned, tagged, or pinned `npm:@simonesiega/codex-limits` pi package registrations. If a matching object registration filters out the bundled extension, the named installer force-enables only `dist/pi.js` while preserving unrelated resource filters.
 
 The installer:
 

package/docs/readme/compatibility.md

@@ -16,22 +16,24 @@ This page describes the runtime, operating-system, Codex data, network, terminal
 
 Bun is used for dependency management, tests, development commands, and production builds. It is not required to run the published CLI. Runtime dependencies are bundled into `dist`, so the published package does not declare separate production dependencies.
 
-The root package module resolves to the agent-specific `dist/opencode.js` bundle for the OpenCode plugin loader. Its public module contract consists of a default plugin export and the named `tui` export; the internal core modules are not public package exports. Pi loads the separate `dist/pi.js` extension declared in the package's `pi.extensions` manifest. The GitHub Copilot CLI installer copies the separate `dist/copilot.mjs` bundle to a recognized user extension entry point.
+The root package module resolves to the agent-specific `dist/opencode.js` bundle for OpenCode plugin-loader compatibility. The explicit `@simonesiega/codex-limits/opencode` subpath resolves to the same module; both expose a default plugin and the named `tui` export. The host-only `@simonesiega/codex-limits/pi` subpath resolves to the separate `dist/pi.js` extension also declared in the package's `pi.extensions` manifest. The host-only `@simonesiega/codex-limits/copilot` subpath resolves to the executable `dist/copilot.mjs` extension, which the GitHub Copilot CLI installer also copies to its recognized user extension entry point.
+
+These agent-host exports are not a general-purpose JavaScript API and do not install an integration by themselves. The supported general interfaces are the CLI and its documented [JSON output](json-output.md). There is intentionally no `@simonesiega/codex-limits/core` export; internal core modules may change without a public API compatibility guarantee.
 
 ## Tested environments
 
 The following environments are covered by the repository's automated checks or current local validation. Other compatible environments may also work, but they are not tested for every release.
 
-| Area                   | Tested environments                                                                                                |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------------ |
-| Automated packaged CLI | GitHub Actions on `ubuntu-latest` with Node.js 20, 22, and 24, plus `windows-latest` with Node.js 20               |
-| Current local checks   | Windows build `10.0.26200.8875` with Node.js 22.20.0 and Bun 1.3.14 (verified 2026-07-23)                          |
-| Terminal rendering     | Automated Ink rendering and layout tests; no named terminal application is included in the per-release test matrix |
-| OpenCode agent adapter | Mocked current keymap and legacy command API shapes; no exact OpenCode host release is tested end-to-end           |
-| pi agent adapter       | Mocked command/UI APIs with real TUI components; package discovery validated in pi 0.81.1 print mode               |
-| Copilot CLI adapter    | Mocked SDK command/timeline APIs and packed installation; typed against `@github/copilot-sdk` 1.0.8                |
+| Area                   | Tested environments                                                                                                                 |
+| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| Automated packaged CLI | GitHub Actions on `ubuntu-latest` with Node.js 20, 22, and 24, `windows-latest` with Node.js 20, and `macos-latest` with Node.js 22 |
+| Current local checks   | Windows build `10.0.26200.8875` with Node.js 22.20.0 and Bun 1.3.14 (verified 2026-07-23)                                           |
+| Terminal rendering     | Automated Ink rendering and layout tests; no named terminal application is included in the per-release test matrix                  |
+| OpenCode agent adapter | Mocked current keymap and legacy command API shapes; no exact OpenCode host release is tested end-to-end                            |
+| pi agent adapter       | Mocked command/UI APIs with real TUI components; package discovery validated in pi 0.81.1 print mode                                |
+| Copilot CLI adapter    | Mocked SDK command/timeline APIs and packed installation; typed against `@github/copilot-sdk` 1.0.8                                 |
 
-The supported runtime and operating-system ranges are broader than this test matrix. In particular, macOS compatibility follows the cross-platform implementation but is not currently covered by the repository's automated workflow.
+The supported runtime and operating-system ranges are broader than this test matrix. Automated checks sample each supported operating system but do not test every supported Node.js version on every platform.
 
 ## Operating systems
 

package/docs/readme/json-output.md

@@ -166,7 +166,7 @@ Example:
 
 ```json
 {
-  "packageVersion": "1.0.0",
+  "packageVersion": "1.1.0",
   "nodeVersion": "22.0.0",
   "operatingSystem": "Windows",
   "codexHomeDetected": true,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@simonesiega/codex-limits",
-  "version": "1.0.0",
-  "description": "Check Codex usage limits, reset times, and reset-credit coupons from a fast, read-only terminal dashboard.",
+  "version": "1.1.0",
+  "description": "Inspect Codex usage limits, reset times, and reset-credit coupons from the terminal, or explicitly confirm a remote usage reset.",
   "type": "module",
   "bin": {
     "codex-limits": "dist/cli.js"
@@ -13,11 +13,23 @@
   },
   "exports": {
     ".": {
-      "types": "./types/index.d.ts",
+      "types": "./types/opencode.d.ts",
       "import": "./dist/opencode.js"
+    },
+    "./opencode": {
+      "types": "./types/opencode.d.ts",
+      "import": "./dist/opencode.js"
+    },
+    "./pi": {
+      "types": "./types/pi.d.ts",
+      "import": "./dist/pi.js"
+    },
+    "./copilot": {
+      "types": "./types/copilot.d.ts",
+      "import": "./dist/copilot.mjs"
     }
   },
-  "types": "./types/index.d.ts",
+  "types": "./types/opencode.d.ts",
   "files": [
     "dist",
     "types",
@@ -74,6 +86,7 @@
   },
   "packageManager": "bun@1.3.14",
   "overrides": {
+    "brace-expansion": "5.0.9",
     "fast-uri": "3.1.4"
   },
   "peerDependencies": {

package/types/copilot.d.ts

@@ -0,0 +1,6 @@
+/** Public host-module contract exported from the Copilot-specific package subpath. */
+export type CodexLimitsCopilotExtension = () => Promise<void>;
+declare const plugin: CodexLimitsCopilotExtension;
+export declare const COPILOT_EXTENSION_MARKER: "codex-limits-copilot-extension-v1";
+export declare const startCopilotExtension: CodexLimitsCopilotExtension;
+export default plugin;

package/types/opencode.d.ts

@@ -0,0 +1,10 @@
+/** Public host-module contract exported from the OpenCode package entry points. */
+export interface CodexLimitsTuiPluginModule {
+  id: "codex-limits";
+  tui: (api: unknown) => void | Promise<void>;
+}
+/** Agent-specific name for the original package-root contract. */
+export type CodexLimitsOpencodeExtension = CodexLimitsTuiPluginModule;
+declare const plugin: CodexLimitsTuiPluginModule;
+export default plugin;
+export declare const tui: CodexLimitsOpencodeExtension["tui"];

package/types/pi.d.ts

@@ -0,0 +1,4 @@
+/** Public host-module contract exported from the pi-specific package subpath. */
+export type CodexLimitsPiExtension = (api: unknown) => void;
+declare const plugin: CodexLimitsPiExtension;
+export default plugin;

package/types/index.d.ts

@@ -1,8 +0,0 @@
-/** Public root-module contract loaded by OpenCode. */
-export interface CodexLimitsTuiPluginModule {
-  id: "codex-limits";
-  tui: (api: unknown) => void | Promise<void>;
-}
-declare const plugin: CodexLimitsTuiPluginModule;
-export default plugin;
-export declare const tui: CodexLimitsTuiPluginModule["tui"];