openrouter-genimage-kote-opencode 0.1.0

package/README.ru.md

@@ -0,0 +1,229 @@
+# openrouter-genimage-kote-opencode
+
+Инструменты генерации и редактирования изображений через OpenRouter для OpenCode с опциональной fail-closed-маршрутизацией через KoteGateway. Основной сценарий — image-to-image: вложения, файлы проекта и публичные HTTPS URL передаются настроенной image-модели OpenRouter как упорядоченные `input_references`. Text-to-image доступен как дополнительный режим без визуальных референсов.
+
+Плагин регистрирует:
+
+- `openrouter_edit_image` — редактирование или создание по одному или нескольким визуальным референсам;
+- `openrouter_generate_image` — новое изображение только по тексту;
+- `openrouter_balance` — usage текущего ключа и, при наличии прав, credits аккаунта;
+- `/openrouter-balance` — вызов balance tool без генерации изображения.
+
+Операция может расходовать средства OpenRouter. Модель, API keys и режим маршрутизации задаются только в конфигурации и не являются аргументами tools.
+
+## Установка
+
+Добавьте npm-пакет tuple-записью в массив `plugin` файла `opencode.jsonc`, как показано ниже. OpenCode устанавливает npm-плагины из своей конфигурации.
+
+Рекомендуемые permissions запрашивают подтверждение платной генерации, но разрешают проверку баланса:
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "openrouter_edit_image": "ask",
+    "openrouter_generate_image": "ask",
+    "openrouter_balance": "allow"
+  }
+}
+```
+
+## Direct-конфигурация
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    [
+      "openrouter-genimage-kote-opencode@0.1.0",
+      {
+        "routing": "direct",
+        "model": "openai/gpt-image-1",
+        "apiKey": "{env:OPENROUTER_API_KEY}",
+        "managementApiKey": "{env:OPENROUTER_MANAGEMENT_API_KEY}",
+        "outputDirectory": "assets/generated",
+        "defaults": {
+          "n": 1,
+          "output_format": "png"
+        }
+      }
+    ]
+  ]
+}
+```
+
+Direct mode отправляет HTTPS-запросы прямо на фиксированный OpenRouter API origin. Он не получает descriptor KoteGateway и не использует gateway как fallback.
+
+## Proxy-конфигурация
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    [
+      "openrouter-genimage-kote-opencode@0.1.0",
+      {
+        "routing": "proxy",
+        "model": "openai/gpt-image-1",
+        "apiKey": "{env:OPENROUTER_API_KEY}",
+        "outputDirectory": "assets/generated",
+        "input": {
+          "maxReferences": 16,
+          "maxFileBytes": 20971520,
+          "maxTotalBytes": 52428800
+        },
+        "requestTimeoutMs": 300000
+      }
+    ]
+  ]
+}
+```
+
+Proxy mode получает подписанный descriptor KoteGateway и использует HTTPS CONNECT для каждого OpenRouter endpoint плагина. Режим fail-closed: ошибки bootstrap, подписи, CONNECT или timeout завершают запрос без прямого retry. OpenRouter keys, prompt, references и результат остаются внутри TLS-соединения до OpenRouter и не передаются как proxy headers.
+
+## API keys
+
+Создайте generation key OpenRouter и передайте его как `OPENROUTER_API_KEY`. Порядок разрешения: `apiKey` в options, затем environment variable. Отсутствующий ключ даёт `GENIMAGE_OPENROUTER_KEY_MISSING` до платного запроса.
+
+Для полных credits аккаунта нужен management key: `managementApiKey` или `OPENROUTER_MANAGEMENT_API_KEY`. Generation key можно использовать для credits только если `/key` явно сообщает, что это management key. Не коммитьте ключи в `opencode.jsonc`; используйте подстановку OpenCode `{env:NAME}`.
+
+## Выбор image-модели
+
+Укажите OpenRouter model ID в `model`. Модель намеренно недоступна в arguments tools, поэтому агент не может незаметно выбрать другую или более дорогую модель. Перед первым платным запросом плагин получает capabilities и проверяет image output, image input для edit и переданные параметры. Автоматической подмены модели нет.
+
+Конкретный provider endpoint может поддерживать меньше параметров или результатов, чем общие лимиты OpenRouter Images API.
+
+## Image-to-image — основной сценарий
+
+`openrouter_edit_image` требует хотя бы одно изображение и никогда не переходит в text-to-image. Если `references` не передан, используются все image attachments родительского user message с сохранением порядка. При их отсутствии возвращается `GENIMAGE_REFERENCE_REQUIRED`.
+
+### Attached images
+
+Приложите изображения к текущему user message и попросите OpenCode изменить их. Для явного выбора используется нумерация с единицы только среди image attachments:
+
+```json
+{
+  "prompt": "Reference image 1 defines the character. Reference image 2 defines clothing only. Preserve the face and illustration style.",
+  "references": [
+    { "type": "message_attachment", "index": 1 },
+    { "type": "message_attachment", "index": 2 }
+  ]
+}
+```
+
+Поддерживаются доверенные представления attachments, полученные от OpenCode. Произвольные `file:`, `data:` и `blob:` URL в tool arguments запрещены.
+
+### Project files
+
+Пути задаются относительно текущего OpenCode worktree:
+
+```json
+{
+  "prompt": "Preserve the isometric angle, proportions, and palette. Create a damaged version with broken boards.",
+  "references": [
+    { "type": "project_file", "path": "assets/props/crate.png" }
+  ],
+  "output_path": "assets/props/crate-damaged.png"
+}
+```
+
+PNG, JPEG и WebP принимаются после проверки размера и magic bytes. Абсолютные пути, traversal, symlink escape, директории и файлы за пределами worktree отклоняются. Исходники и существующие результаты не перезаписываются.
+
+### Несколько references и HTTPS URL
+
+Порядок references сохраняется точно. Первый считается основным; роль каждого изображения нужно описать в prompt — плагин не сортирует, не склеивает и не придумывает роли.
+
+```json
+{
+  "prompt": "Reference 1 defines identity and face. Reference 2 defines clothing only. Reference 3 defines palette and lighting.",
+  "references": [
+    { "type": "project_file", "path": "assets/character.png" },
+    { "type": "message_attachment", "index": 1 },
+    { "type": "https_url", "url": "https://example.com/palette.webp" }
+  ]
+}
+```
+
+Разрешены только публичные HTTPS URL без credentials. Явные HTTPS references передаются OpenRouter без изменения; локальные изображения кодируются в памяти как base64 data URL. Внешнее хранилище не требуется.
+
+Подробнее: [Image-to-image](docs/image-to-image.md).
+
+## Text-to-image
+
+`openrouter_generate_image` используется только для полностью нового изображения без визуального референса. Он принимает prompt и output parameters, но не references, paths, attachment indexes, base64 или URL.
+
+## Установка skill
+
+Skill входит в npm tarball, но OpenCode ищет skills в директориях проекта или пользователя. Поэтому установите его явно:
+
+```bash
+npx openrouter-genimage-kote-opencode install-skill
+npx openrouter-genimage-kote-opencode check-skill
+```
+
+Глобально для пользователя:
+
+```bash
+npx openrouter-genimage-kote-opencode install-skill --global
+npx openrouter-genimage-kote-opencode check-skill --global
+```
+
+Project install пишет `.opencode/skills/openrouter-image-generation/SKILL.md`; global install всегда пишет `~/.config/opencode/skills/openrouter-image-generation/SKILL.md`, в том числе на Windows. Одинаковый SHA-256 означает no-op. `check-skill` завершается с nonzero code для отсутствующего или изменённого skill. `--force` нужен только для атомарной замены локально изменённого skill. CLI не использует postinstall, не требует API key и не обращается в сеть.
+
+## Balance и usage
+
+Запустите `/openrouter-balance` или `openrouter_balance`. Результат разделяет два понятия:
+
+- `/key` возвращает usage и spending limit настроенного API key, включая remaining API-key limit;
+- `/credits` возвращает total credits и total usage аккаунта и требует management key.
+
+Оставшийся лимит отдельного ключа — не баланс аккаунта OpenRouter. Без management authorization account credits показываются как unavailable. Если `/credits` упал, успешные данные `/key` всё равно возвращаются.
+
+## Безопасность
+
+- Production origin фиксирован: `https://openrouter.ai/api/v1`; пользовательские base URLs запрещены.
+- Redirects отклоняются. Платный `POST /images` автоматически не повторяется.
+- Proxy mode работает fail-closed и не повторяет запрос напрямую.
+- Плагин не заменяет `globalThis.fetch` и не перехватывает другие providers.
+- Keys, полный prompt, base64, binary data, полный upstream body и URL с query не попадают в logs/metadata.
+- Input/output paths ограничены worktree; real paths проверяются против symlink escape.
+- Результаты пишутся атомарно и не перезаписывают исходники или существующие файлы.
+
+Подробнее: [Безопасность](docs/security.md) и [SECURITY.md](SECURITY.md).
+
+## Ограничения версии 0.1.0
+
+Нет masks и гарантированного локального inpainting, интерактивного редактора, LoRA, video, streaming, SVG, provider-specific options, автоматической покупки credits, автоматического выбора модели, скрытых fallback и внешнего object storage. Поддерживаются только PNG, JPEG и WebP. Seed не гарантирует воспроизводимость между providers. OpenRouter может вернуть меньше изображений, чем запрошено; валидные partial results сохраняются с warning.
+
+## Troubleshooting
+
+- `GENIMAGE_REFERENCE_REQUIRED`: приложите изображение или передайте минимум один ordered reference в `openrouter_edit_image`.
+- `GENIMAGE_MODEL_DOES_NOT_SUPPORT_IMAGE_INPUT`: настройте image-to-image capable model; плагин не сменит её сам.
+- `GENIMAGE_PARAMETER_UNSUPPORTED`: уберите неподдерживаемый argument/default либо настройте совместимую модель.
+- `GENIMAGE_OPENROUTER_KEY_MISSING`: передайте `OPENROUTER_API_KEY` процессу OpenCode либо задайте `apiKey` через environment substitution.
+- `GENIMAGE_*_TOO_LARGE` / `GENIMAGE_TOTAL_REFERENCE_SIZE_EXCEEDED`: сожмите/уменьшите inputs, сократите references или используйте публичный HTTPS URL.
+- `GENIMAGE_GATEWAY_*`: исправьте KoteGateway/bootstrap/connectivity; proxy mode намеренно не использует direct fallback.
+- Ошибка output path: используйте относительный путь внутри worktree, который не существует и не совпадает с source image.
+
+Полная таблица: [Troubleshooting](docs/troubleshooting.md). Также см. [Configuration](docs/configuration.md) и [Testing](docs/testing.md).
+
+## Статус совместимости
+
+- Baseline OpenCode smoke tests: **1.18.21**. CI проверяет установленный npm tarball на baseline и latest stable. Attachments в TUI и Desktop всё ещё требуют ручной release-проверки; Web — если доступен.
+- Этот пакет использует только reusable export `/core` из `@koteye/kote-gateway-opencode` **0.1.1**. Gateway adapter объявляет потолок OpenCode/SDK **1.18.18**, поэтому здесь зафиксирован `@opencode-ai/plugin` **1.18.18**, удовлетворяющий peer metadata. Core export не импортирует OpenCode adapter во время выполнения, а полный установленный tarball проходит smoke tests на OpenCode **1.18.21** и latest.
+- Synthetic TLS/CONNECT tests проходят для signed bootstrap, fail-closed routing, одного CONNECT и обоих порядков загрузки. Они дополняют реальные OpenCode registration smokes; платный OpenRouter E2E и отображение attachments в клиентском UI остаются отдельными opt-in/manual проверками.
+- Package объявляет Node.js 20+. Реализация рассчитана на Bun и Windows/macOS/Linux, но release artifacts должны быть проверены на поддерживаемой матрице.
+
+## Документация
+
+- [Архитектура](docs/architecture.md)
+- [Конфигурация](docs/configuration.md)
+- [Image-to-image](docs/image-to-image.md)
+- [Безопасность](docs/security.md)
+- [Тестирование](docs/testing.md)
+- [Troubleshooting](docs/troubleshooting.md)
+- [English README](README.md)
+
+## Лицензия
+
+MIT. См. [LICENSE](LICENSE) и [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

package/SECURITY.md

@@ -0,0 +1,31 @@
+# Security Policy
+
+## Supported versions
+
+Security fixes are provided for the latest published release. Version `0.1.0` targets the initial public release. Older prerelease/source snapshots are not supported unless a maintainer explicitly says otherwise.
+
+## Reporting a vulnerability
+
+Report vulnerabilities privately through the repository owner's private security-reporting channel (for example, GitHub Security Advisories when enabled). If no private channel is visible, contact the package owner through the contact information published on the npm package profile and ask for a secure reporting address before sending sensitive details.
+
+Do not open a public issue with:
+
+- an OpenRouter or management API key;
+- authorization/proxy headers;
+- a full prompt, private reference, or generated image;
+- base64 or binary payloads;
+- an unredacted upstream response;
+- a gateway bootstrap document or descriptor;
+- a private URL or query string.
+
+Include the affected version, OpenCode/runtime version, OS, routing mode, impact, minimal redacted reproduction, and whether a key or private asset may have been exposed. Maintainers should acknowledge receipt, coordinate remediation and disclosure, and avoid asking for production secrets.
+
+If a key may have been exposed, revoke it in OpenRouter immediately and replace the environment value before further testing.
+
+## Security boundaries
+
+Production OpenRouter origin is fixed; redirects fail; paid image POSTs are not retried; proxy mode is fail-closed; and the plugin must not install a global fetch interceptor. Project input/output is confined to the OpenCode worktree with lexical and realpath checks. Source and existing output files are never overwritten. PNG/JPEG/WebP content is checked by size and magic bytes.
+
+The plugin must not persist or log keys, full prompts, base64, binary data, unredacted request/response bodies, full external URLs with query strings, or gateway bootstrap data. In proxy mode, keys and image content remain inside TLS to OpenRouter and are not proxy credentials.
+
+See [`docs/security.md`](docs/security.md) for the detailed threat model and controls.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,16 @@
+# Third-Party Notices
+
+This project depends on third-party software. The authoritative license texts and copyright notices are the files distributed with each installed package and its source repository; those notices remain in force and are not replaced by this summary.
+
+Runtime dependencies declared for version 0.1.0:
+
+| Package | Pinned version | Manifest license | Project |
+|---|---:|---|---|
+| `@koteye/kote-gateway-opencode` | `0.1.1` | MIT | KoteGateway integration/core ([source](https://github.com/koteyye/opencode-kote-gateway)) |
+| `@opencode-ai/plugin` | `1.18.18` | MIT | OpenCode plugin API |
+| `undici` | `6.28.0` | MIT | HTTP client primitives |
+| `zod` | `4.1.8` | MIT | Runtime schema validation |
+
+Development dependencies include `@eslint/js`, `@types/bun`, `eslint`, `typescript`, and `typescript-eslint` at the exact versions recorded in `package.json` and the package lock.
+
+Binary distributions and npm tarballs should retain license/notice files required by these dependencies. Before release, generate or audit the production dependency inventory from the resolved lockfile and verify every dependency's license metadata. This document does not claim compatibility or certification by any third-party project.

package/dist/cli.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+export interface CliRuntime {
+    cwd?: string;
+    homeDirectory?: string;
+    packageRoot?: string;
+    stderr?: (line: string) => void;
+    stdout?: (line: string) => void;
+}
+export interface SkillPaths {
+    source: string;
+    target: string;
+    targetRoot: string;
+}
+export type InstallSkillResult = "current" | "installed" | "updated";
+export type CheckSkillResult = "current" | "missing" | "modified";
+export declare function resolveSkillPaths(global: boolean, runtime?: Pick<CliRuntime, "cwd" | "homeDirectory" | "packageRoot">): SkillPaths;
+export declare function installSkill(paths: SkillPaths, force: boolean): Promise<InstallSkillResult>;
+export declare function checkSkill(paths: SkillPaths): Promise<CheckSkillResult>;
+export declare function runCli(arguments_: readonly string[], runtime?: CliRuntime): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAkDA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;AACpE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;AAYjE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,eAAe,GAAG,aAAa,CAAM,GACtE,UAAU,CAcZ;AA2ID,wBAAsB,YAAY,CAChC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,kBAAkB,CAAC,CAyB7B;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAc7E;AA0CD,wBAAsB,MAAM,CAC1B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,MAAM,CAAC,CAoDjB"}

package/dist/cli.js

@@ -0,0 +1,277 @@
+#!/usr/bin/env node
+import { createHash, randomUUID } from "node:crypto";
+import { constants, realpathSync } from "node:fs";
+import { copyFile, lstat, mkdir, readFile, realpath, rename, unlink, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const SKILL_NAME = "openrouter-image-generation";
+const SKILL_RELATIVE_PATH = join(".opencode", "skills", SKILL_NAME, "SKILL.md");
+const GLOBAL_SKILL_RELATIVE_PATH = join(".config", "opencode", "skills", SKILL_NAME, "SKILL.md");
+const USAGE = `Usage:
+  openrouter-genimage-kote-opencode install-skill [--global] [--force]
+  openrouter-genimage-kote-opencode check-skill [--global]
+
+Options:
+  --global  Use ~/.config/opencode instead of the current project.
+  --force   Replace a modified installed skill (install-skill only).
+  -h, --help  Show this help.`;
+class UsageError extends Error {
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+function packageRootFromModule() {
+    return fileURLToPath(new URL("../", import.meta.url));
+}
+export function resolveSkillPaths(global, runtime = {}) {
+    const packageRoot = resolve(runtime.packageRoot ?? packageRootFromModule());
+    const targetRoot = global
+        ? resolve(runtime.homeDirectory ?? homedir())
+        : resolve(runtime.cwd ?? process.cwd());
+    return {
+        source: join(packageRoot, SKILL_RELATIVE_PATH),
+        target: join(targetRoot, global ? GLOBAL_SKILL_RELATIVE_PATH : SKILL_RELATIVE_PATH),
+        targetRoot,
+    };
+}
+function isPathInside(root, candidate) {
+    const difference = relative(root, candidate);
+    return (difference === "" ||
+        (difference !== ".." &&
+            !difference.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) &&
+            !isAbsolute(difference)));
+}
+async function nearestExistingAncestor(candidate) {
+    let current = resolve(candidate);
+    for (;;) {
+        try {
+            await lstat(current);
+            return current;
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== "ENOENT")
+                throw error;
+            const parent = dirname(current);
+            if (parent === current)
+                throw error;
+            current = parent;
+        }
+    }
+}
+async function secureTargetPath(paths, createParent) {
+    const lexicalRoot = resolve(paths.targetRoot);
+    const lexicalTarget = resolve(paths.target);
+    if (!isPathInside(lexicalRoot, lexicalTarget)) {
+        throw new Error("The skill destination escapes its configured root.");
+    }
+    const canonicalRoot = await realpath(lexicalRoot);
+    const targetParent = dirname(lexicalTarget);
+    const existingAncestor = await nearestExistingAncestor(targetParent);
+    const canonicalAncestor = await realpath(existingAncestor);
+    if (!isPathInside(canonicalRoot, canonicalAncestor)) {
+        throw new Error("The skill destination resolves outside its configured root through a symbolic link or junction.");
+    }
+    if (createParent)
+        await mkdir(targetParent, { recursive: true });
+    try {
+        const canonicalParent = await realpath(targetParent);
+        if (!isPathInside(canonicalRoot, canonicalParent)) {
+            throw new Error("The skill destination resolves outside its configured root through a symbolic link or junction.");
+        }
+        const secureTarget = join(canonicalParent, basename(lexicalTarget));
+        try {
+            const targetStats = await lstat(secureTarget);
+            if (targetStats.isSymbolicLink()) {
+                throw new Error("Refusing to read or replace a symbolic-link skill destination.");
+            }
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== "ENOENT")
+                throw error;
+        }
+        return secureTarget;
+    }
+    catch (error) {
+        if (!isNodeError(error) || error.code !== "ENOENT" || createParent)
+            throw error;
+        return lexicalTarget;
+    }
+}
+function sha256(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+async function readOptional(path) {
+    try {
+        return await readFile(path);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+}
+async function copyWithoutOverwrite(source, target) {
+    try {
+        await copyFile(source, target, constants.COPYFILE_EXCL);
+    }
+    catch (error) {
+        if (!isNodeError(error) || error.code !== "EEXIST") {
+            throw error;
+        }
+        const [sourceContent, targetContent] = await Promise.all([
+            readFile(source),
+            readFile(target),
+        ]);
+        if (sha256(sourceContent) !== sha256(targetContent)) {
+            throw new Error("The destination appeared during installation and differs from the packaged skill. Run the command again after reviewing it.");
+        }
+    }
+}
+async function replaceAtomically(target, content) {
+    const temporary = join(dirname(target), `.${SKILL_NAME}-${process.pid}-${randomUUID()}.tmp`);
+    try {
+        await writeFile(temporary, content, { flag: "wx", mode: 0o644 });
+        await rename(temporary, target);
+    }
+    catch (error) {
+        try {
+            await unlink(temporary);
+        }
+        catch (cleanupError) {
+            if (!isNodeError(cleanupError) || cleanupError.code !== "ENOENT") {
+                throw new AggregateError([error, cleanupError], "Failed to replace the skill and clean up its temporary file.");
+            }
+        }
+        throw error;
+    }
+}
+export async function installSkill(paths, force) {
+    const sourceContent = await readFile(paths.source);
+    const target = await secureTargetPath(paths, true);
+    const targetContent = await readOptional(target);
+    if (targetContent !== undefined &&
+        sha256(sourceContent) === sha256(targetContent)) {
+        return "current";
+    }
+    if (targetContent !== undefined && !force) {
+        throw new Error("The destination contains a modified skill. Refusing to overwrite it without --force.");
+    }
+    if (targetContent === undefined) {
+        await copyWithoutOverwrite(paths.source, target);
+        return "installed";
+    }
+    await replaceAtomically(target, sourceContent);
+    return "updated";
+}
+export async function checkSkill(paths) {
+    const target = await secureTargetPath(paths, false);
+    const [sourceContent, targetContent] = await Promise.all([
+        readFile(paths.source),
+        readOptional(target),
+    ]);
+    if (targetContent === undefined) {
+        return "missing";
+    }
+    return sha256(sourceContent) === sha256(targetContent)
+        ? "current"
+        : "modified";
+}
+function parseArguments(arguments_) {
+    if (arguments_.includes("--help") || arguments_.includes("-h")) {
+        return null;
+    }
+    const [command, ...flags] = arguments_;
+    if (command !== "install-skill" && command !== "check-skill") {
+        throw new UsageError(command === undefined
+            ? "A command is required."
+            : `Unknown command: ${command}`);
+    }
+    for (const flag of flags) {
+        if (flag !== "--global" && flag !== "--force") {
+            throw new UsageError(`Unknown option: ${flag}`);
+        }
+    }
+    const force = flags.includes("--force");
+    if (command === "check-skill" && force) {
+        throw new UsageError("--force is only valid with install-skill.");
+    }
+    return {
+        command,
+        force,
+        global: flags.includes("--global"),
+    };
+}
+function formatFailure(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return "Unknown CLI error.";
+}
+export async function runCli(arguments_, runtime = {}) {
+    const stdout = runtime.stdout ?? ((line) => console.log(line));
+    const stderr = runtime.stderr ?? ((line) => console.error(line));
+    try {
+        const parsed = parseArguments(arguments_);
+        if (parsed === null) {
+            stdout(USAGE);
+            return 0;
+        }
+        const paths = resolveSkillPaths(parsed.global, runtime);
+        stdout(`Source: ${paths.source}`);
+        stdout(`Destination: ${paths.target}`);
+        if (parsed.command === "install-skill") {
+            const result = await installSkill(paths, parsed.force);
+            if (result === "current") {
+                stdout("Skill is already current; no files were changed.");
+            }
+            else if (result === "installed") {
+                stdout("Skill installed.");
+            }
+            else {
+                stdout("Skill updated with --force.");
+            }
+            return 0;
+        }
+        const result = await checkSkill(paths);
+        if (result === "current") {
+            stdout("Skill status: current (SHA-256 matches the packaged skill).");
+            return 0;
+        }
+        if (result === "missing") {
+            stderr("Skill status: missing. Run install-skill to install it.");
+        }
+        else {
+            stderr("Skill status: modified. Review it or run install-skill --force to restore the packaged version.");
+        }
+        return 1;
+    }
+    catch (error) {
+        stderr(`Error: ${formatFailure(error)}`);
+        if (error instanceof UsageError) {
+            stderr(USAGE);
+            return 2;
+        }
+        return 1;
+    }
+}
+function isDirectExecution() {
+    const entrypoint = process.argv[1];
+    if (entrypoint === undefined) {
+        return false;
+    }
+    const modulePath = fileURLToPath(import.meta.url);
+    try {
+        return realpathSync(entrypoint) === realpathSync(modulePath);
+    }
+    catch {
+        return resolve(entrypoint) === resolve(modulePath);
+    }
+}
+if (isDirectExecution()) {
+    void runCli(process.argv.slice(2)).then((exitCode) => {
+        process.exitCode = exitCode;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/balance-command.d.ts

@@ -0,0 +1,5 @@
+export declare const OPENROUTER_BALANCE_COMMAND: {
+    readonly description: "Show OpenRouter usage, key limits, and account credits when available";
+    readonly template: string;
+};
+//# sourceMappingURL=balance-command.d.ts.map

package/dist/commands/balance-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-command.d.ts","sourceRoot":"","sources":["../../src/commands/balance-command.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B;;;CAmB7B,CAAA"}

package/dist/commands/balance-command.js

@@ -0,0 +1,20 @@
+export const OPENROUTER_BALANCE_COMMAND = {
+    description: "Show OpenRouter usage, key limits, and account credits when available",
+    template: `
+Call the openrouter_balance tool exactly once.
+
+Present the returned values in the user's language.
+
+Clearly distinguish:
+- API-key usage;
+- API-key spending limit;
+- remaining API-key spending limit;
+- full account credits.
+
+Do not treat the remaining key limit as the full account balance.
+Do not invent unavailable values.
+Do not call image generation tools.
+Show monetary values with at least six decimal places and do not round a small non-zero value to zero.
+  `.trim(),
+};
+//# sourceMappingURL=balance-command.js.map

package/dist/commands/balance-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance-command.js","sourceRoot":"","sources":["../../src/commands/balance-command.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,WAAW,EACT,uEAAuE;IACzE,QAAQ,EAAE;;;;;;;;;;;;;;;GAeT,CAAC,IAAI,EAAE;CACA,CAAA"}

package/dist/config/resolve.d.ts

@@ -0,0 +1,5 @@
+import type { ConfigEnvironment, PluginConfigState, ResolvedPluginOptions } from "./types.js";
+export declare function resolvePluginOptions(rawOptions: unknown, environment?: ConfigEnvironment): ResolvedPluginOptions;
+export declare function resolvePluginConfig(rawOptions: unknown, environment?: ConfigEnvironment): PluginConfigState;
+export declare function requireResolvedPluginOptions(state: PluginConfigState): ResolvedPluginOptions;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/config/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,YAAY,CAAA;AAmCnB,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,OAAO,EACnB,WAAW,GAAE,iBAIZ,GACA,qBAAqB,CAiFvB;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,OAAO,EACnB,WAAW,GAAE,iBAIZ,GACA,iBAAiB,CAanB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iBAAiB,GACvB,qBAAqB,CAMvB"}