# Runic

> Runic is a cross-session cache and token ledger for an agent's already-resolved decisions. Ask once. Pay once.

## Docs

- [Introduction](https://docs.runic-labs.lol/): Runic is a cross-session cache and token ledger for an agent's already-resolved decisions.
- [Quickstart](https://docs.runic-labs.lol/quickstart): Wire askRunic and storeResult into an existing agent in a few minutes.
- [How it works](https://docs.runic-labs.lol/how-it-works): The signature algorithm, why matching is exact, and what the ledger actually records.
- [Sdk](https://docs.runic-labs.lol/sdk): askRunic and storeResult — the entire agent-facing contract.
- [Cache](https://docs.runic-labs.lol/cache): Signature-keyed artifact storage — in-memory and file-backed.
- [Ledger](https://docs.runic-labs.lol/ledger): Append-only accounting of tokens spent vs. tokens saved.
- [Cli](https://docs.runic-labs.lol/cli): Inspect the cache and ledger from the command line.
- [Benchmarks](https://docs.runic-labs.lol/benchmarks): Two benchmarks that answer two different questions — real API savings, and mechanism correctness at scale.
- [Scope](https://docs.runic-labs.lol/scope): What v1 is, what got cut from the earlier execution-layer plan, and why.

## Español

### Docs

- [Introducción](https://docs.runic-labs.lol/es): Runic es una caché entre sesiones y un libro mayor de tokens para las decisiones ya resueltas de un agente.
- [Inicio rápido](https://docs.runic-labs.lol/es/quickstart): Conecta askRunic y storeResult a un agente existente en unos minutos.
- [Cómo funciona](https://docs.runic-labs.lol/es/how-it-works): El algoritmo de firma, por qué la coincidencia es exacta y qué registra realmente el libro mayor.
- [@runic-labs/sdk](https://docs.runic-labs.lol/es/sdk): askRunic y storeResult — todo el contrato de cara al agente.
- [@runic-labs/cache](https://docs.runic-labs.lol/es/cache): Almacenamiento de artefactos con claves de firma, en memoria y basado en archivos.
- [@runic-labs/ledger](https://docs.runic-labs.lol/es/ledger): Contabilidad de solo anexado de tokens gastados frente a tokens ahorrados.
- [@runic-labs/cli](https://docs.runic-labs.lol/es/cli): Inspecciona la caché y el libro mayor desde la línea de comandos.
- [Alcance](https://docs.runic-labs.lol/es/scope): Qué es v1, qué se eliminó del plan anterior de capa de ejecución y por qué.

## Français

### Docs

- [Introduction](https://docs.runic-labs.lol/fr): Runic est un cache inter-session et un registre de jetons pour les décisions déjà résolues d'un agent.
- [Démarrage rapide](https://docs.runic-labs.lol/fr/quickstart): Intégrez askRunic et storeResult dans un agent existant en quelques minutes.
- [Comment ça marche](https://docs.runic-labs.lol/fr/how-it-works): L’algorithme de signature, pourquoi la correspondance est exacte et ce que le registre enregistre réellement.
- [@runic-labs/sdk](https://docs.runic-labs.lol/fr/sdk): askRunic et storeResult — l’intégralité du contrat destiné aux agents.
- [@runic-labs/cache](https://docs.runic-labs.lol/fr/cache): Stockage d’artefacts indexé par signature — en mémoire et sur fichier.
- [@runic-labs/ledger](https://docs.runic-labs.lol/fr/ledger): Comptabilité en ajout seul des jetons dépensés et économisés.
- [@runic-labs/cli](https://docs.runic-labs.lol/fr/cli): Inspectez le cache et le registre depuis la ligne de commande.
- [Benchmarks](https://docs.runic-labs.lol/fr/benchmarks): Deux benchmarks qui répondent à deux questions différentes — économies réelles d’API et exactitude du mécanisme à grande échelle.
- [Périmètre](https://docs.runic-labs.lol/fr/scope): Ce qu’est la v1, ce qui a été retiré du précédent plan de couche d’exécution, et pourquoi.

## Deutsch

### Docs

- [Einführung](https://docs.runic-labs.lol/de): Runic ist ein sitzungsübergreifender Cache und Token-Ledger für bereits gelöste Entscheidungen eines Agenten.
- [Schnellstart](https://docs.runic-labs.lol/de/quickstart): Binde askRunic und storeResult in wenigen Minuten in einen bestehenden Agenten ein.
- [So funktioniert es](https://docs.runic-labs.lol/de/how-it-works): Der Signaturalgorithmus, warum der Abgleich exakt ist und was das Ledger tatsächlich protokolliert.
- [@runic-labs/sdk](https://docs.runic-labs.lol/de/sdk): askRunic und storeResult — der gesamte agentenseitige Vertrag.
- [@runic-labs/cache](https://docs.runic-labs.lol/de/cache): Signaturbasierter Artefaktspeicher – im Arbeitsspeicher und dateibasiert.
- [@runic-labs/ledger](https://docs.runic-labs.lol/de/ledger): Anhangsbasierte Buchführung über ausgegebene und eingesparte Tokens.
- [@runic-labs/cli](https://docs.runic-labs.lol/de/cli): Untersuche den Cache und das Ledger über die Befehlszeile.
- [Benchmarks](https://docs.runic-labs.lol/de/benchmarks): Zwei Benchmarks, die zwei verschiedene Fragen beantworten — echte API-Einsparungen und Korrektheit des Mechanismus im großen Maßstab.
- [Geltungsbereich](https://docs.runic-labs.lol/de/scope): Was v1 ist, was aus dem früheren Plan für die Ausführungsebene gestrichen wurde und warum.

## Português

### Docs

- [Introdução](https://docs.runic-labs.lol/pt): Runic é um cache entre sessões e um livro-razão de tokens para decisões que um agente já resolveu.
- [Início rápido](https://docs.runic-labs.lol/pt/quickstart): Conecte askRunic e storeResult a um agente existente em poucos minutos.
- [Como funciona](https://docs.runic-labs.lol/pt/how-it-works): O algoritmo de assinatura, por que a correspondência é exata e o que o registro realmente grava.
- [@runic-labs/sdk](https://docs.runic-labs.lol/pt/sdk): askRunic e storeResult — todo o contrato voltado para o agente.
- [@runic-labs/cache](https://docs.runic-labs.lol/pt/cache): Armazenamento de artefatos indexado por assinatura — em memória e baseado em arquivos.
- [@runic-labs/ledger](https://docs.runic-labs.lol/pt/ledger): Contabilidade somente de acréscimo dos tokens gastos versus os tokens economizados.
- [@runic-labs/cli](https://docs.runic-labs.lol/pt/cli): Inspecione o cache e o ledger pela linha de comando.
- [Benchmarks](https://docs.runic-labs.lol/pt/benchmarks): Dois benchmarks que respondem a duas perguntas diferentes — economia real de API e correção do mecanismo em escala.
- [Escopo](https://docs.runic-labs.lol/pt/scope): O que é a v1, o que foi removido do plano anterior da camada de execução e por quê.

## 日本語

### Docs

- [はじめに](https://docs.runic-labs.lol/ja): Runic は、エージェントがすでに解決済みの判断のための、セッション内キャッシュおよびトークン台帳です。
- [クイックスタート](https://docs.runic-labs.lol/ja/quickstart): 数分で既存のエージェントに askRunic と storeResult を組み込みます。
- [仕組み](https://docs.runic-labs.lol/ja/how-it-works): 署名アルゴリズム、なぜ一致判定が厳密なのか、そして台帳が実際に記録する内容。
- [@runic-labs/sdk](https://docs.runic-labs.lol/ja/sdk): askRunic と storeResult — エージェント向け契約のすべて。
- [@runic-labs/cache](https://docs.runic-labs.lol/ja/cache): 署名キー付きアーティファクトストレージ — メモリ内およびファイルバックエンド。
- [@runic-labs/ledger](https://docs.runic-labs.lol/ja/ledger): 使用したトークンと節約したトークンの追記専用の集計。
- [@runic-labs/cli](https://docs.runic-labs.lol/ja/cli): コマンドラインからキャッシュと台帳を確認します。
- [ベンチマーク](https://docs.runic-labs.lol/ja/benchmarks): 異なる2つの問いに答える2種類のベンチマーク — 実際のAPI節約量と、大規模環境における仕組みの正しさ。
- [スコープ](https://docs.runic-labs.lol/ja/scope): v1の対象範囲、以前の実行レイヤー計画から削除されたもの、その理由。

## 中文

### Docs

- [简介](https://docs.runic-labs.lol/zh): Runic 是一个跨会话缓存和令牌账本，用于记录代理已经解决过的决策。
- [快速入门](https://docs.runic-labs.lol/zh/quickstart): 在几分钟内将 askRunic 和 storeResult 接入现有智能体。
- [工作原理](https://docs.runic-labs.lol/zh/how-it-works): 签名算法、为何匹配必须精确，以及账本实际记录的内容。
- [@runic-labs/sdk](https://docs.runic-labs.lol/zh/sdk): askRunic 和 storeResult —— 面向代理的完整契约。
- [@runic-labs/cache](https://docs.runic-labs.lol/zh/cache): 以签名为键的制品存储——内存与文件后端。
- [@runic-labs/ledger](https://docs.runic-labs.lol/zh/ledger): 追加式记录已花费的令牌与通过复用节省的令牌。
- [@runic-labs/cli](https://docs.runic-labs.lol/zh/cli): 从命令行检查缓存和账本。
- [基准测试](https://docs.runic-labs.lol/zh/benchmarks): 两项基准测试回答两个不同的问题——真实 API 节省，以及大规模机制正确性。
- [范围](https://docs.runic-labs.lol/zh/scope): v1 包含什么、从早期执行层计划中删去了什么，以及原因。

## हिन्दी

### Docs

- [परिचय](https://docs.runic-labs.lol/hi): Runic किसी एजेंट के पहले से हल किए गए निर्णयों के लिए एक क्रॉस-सेशन कैश और टोकन लेजर है।
- [क्विकस्टार्ट](https://docs.runic-labs.lol/hi/quickstart): कुछ ही मिनटों में askRunic और storeResult को किसी मौजूदा एजेंट में जोड़ें।
- [यह कैसे काम करता है](https://docs.runic-labs.lol/hi/how-it-works): सिग्नेचर एल्गोरिदम, मिलान सटीक क्यों है, और लेजर वास्तव में क्या रिकॉर्ड करता है।
- [@runic-labs/sdk](https://docs.runic-labs.lol/hi/sdk): askRunic और storeResult — एजेंट-उन्मुख पूरा अनुबंध।
- [@runic-labs/cache](https://docs.runic-labs.lol/hi/cache): सिग्नेचर-कुंजीबद्ध आर्टिफैक्ट स्टोरेज — इन-मेमोरी और फ़ाइल-आधारित।
- [@runic-labs/ledger](https://docs.runic-labs.lol/hi/ledger): खर्च किए गए टोकनों बनाम बचाए गए टोकनों का केवल-परिशिष्ट लेखांकन।
- [@runic-labs/cli](https://docs.runic-labs.lol/hi/cli): कमांड लाइन से कैश और लेजर का निरीक्षण करें।
- [बेंचमार्क](https://docs.runic-labs.lol/hi/benchmarks): दो बेंचमार्क जो दो अलग-अलग प्रश्नों का उत्तर देते हैं — वास्तविक API बचत, और बड़े पैमाने पर तंत्र की शुद्धता।
- [दायरा](https://docs.runic-labs.lol/hi/scope): v1 क्या है, पहले की निष्पादन-स्तर योजना से क्या हटाया गया, और क्यों।