soma-protocol 0.1.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Tensai
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,326 @@
+# Soma Protocol
+
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg)](tsconfig.json)
+[![Runtime](https://img.shields.io/badge/Runtime-Bun-fcf71e.svg)](https://bun.sh)
+
+Русский | [English](README_EN.md) | [中文](README_ZH.md)
+
+TypeScript-библиотека для создания AI-агентов как полноценных личностей — с идентичностью, многоуровневой памятью, обучением, репутацией, социальными связями, эмоциональным контекстом и саморефлексией.
+
+## Что это
+
+Soma — не приложение, а протокол и библиотека, которую потребители импортируют в свои проекты. Каждый агент обладает:
+
+- **Идентичностью** — персона, вектор личности, настроение, стиль коммуникации, эволюция во времени
+- **Памятью** — 4 уровня: эпизодическая (события), процедурная (паттерны действий), социальная (отношения с другими агентами), семантическая (векторный поиск)
+- **Обучением** — передача знаний между агентами, наблюдательное обучение, дистилляция знаний из опыта
+- **Репутацией** — байесовский доверительный скор, домен-специфичное доверие, временной распад, система эндорсментов
+- **Социальными связями** — отношения (11 типов), команды, общие контексты
+- **Эмоциональным интеллектом** — детекция эмоций партнёра, адаптация тона и поведения
+- **Саморефлексией** — инсайты, ретроспективы, профиль самосознания (сильные/слабые стороны, слепые зоны, предубеждения)
+
+## Архитектура
+
+```mermaid
+graph TB
+  subgraph L3["Layer 3: Social Intelligence"]
+    L3_SOCIAL["Social<br/><small>teams, relationships</small>"]
+    L3_LEARN["Learning<br/><small>teach, learn, observe</small>"]
+    L3_REP["Reputation<br/><small>trust, endorse, tiers</small>"]
+    L3_REF["Reflection<br/><small>insights, retrospectives</small>"]
+  end
+
+  subgraph L2["Layer 2: Identity & Memory"]
+    L2_ID["Identity<br/><small>persona, state, evolve</small>"]
+    L2_EPI["Episodic Memory<br/><small>events, recall</small>"]
+    L2_PROC["Procedural Memory<br/><small>patterns, adapt</small>"]
+    L2_EMO["Emotional<br/><small>mood, detect, adapt</small>"]
+  end
+
+  subgraph L1["Layer 1: Transport"]
+    L1_RPC["JSON-RPC<br/><small>planned</small>"]
+    L1_GRPC["gRPC<br/><small>planned</small>"]
+    L1_WS["WebSocket<br/><small>planned</small>"]
+  end
+
+  L3 --> L2
+  L2 --> L1
+
+  style L3 fill:#1a1a2e,stroke:#e94560,color:#fff
+  style L2 fill:#16213e,stroke:#0f3460,color:#fff
+  style L1 fill:#0f3460,stroke:#533483,color:#fff
+```
+
+### Паттерн: Store → Service → Router
+
+Каждое расширение следует единой архитектуре:
+
+```
+extension/
+├── types.ts          # TypeScript-интерфейсы
+├── schema.ts         # Zod v4 схемы валидации
+├── store.ts          # Доступ к БД (сырой SQL)
+├── *.service.ts      # Бизнес-логика
+├── *.router.ts       # HTTP-обработчики (Request → Response)
+└── errors.ts         # Кастомные ошибки
+```
+
+- **Store** — принимает `Database` интерфейс, выполняет SQL-запросы
+- **Service** — бизнес-логика поверх store
+- **Router** — валидирует входящие запросы через Zod, вызывает service, возвращает ответ
+
+### Двойное хранилище (Dual-Store)
+
+```mermaid
+graph LR
+  subgraph PostgreSQL["PostgreSQL (state)"]
+    PG_TABLES["identities\nprocedures\nteams\nrelationships\nreputation"]
+  end
+
+  subgraph ClickHouse["ClickHouse (events)"]
+    CH_TABLES["episodes\nlearning\ntrust history\nreflections\nemotions"]
+  end
+
+  subgraph App["Application"]
+    Store["Store"]
+    EventBus["EventBus\n(batched)"]
+  end
+
+  Store -->|"read/write"| PostgreSQL
+  Store -->|"emit events"| EventBus
+  EventBus -->|"batch flush"| ClickHouse
+  ClickHouse -.->|"query"| Store
+
+  style PostgreSQL fill:#336791,stroke:#fff,color:#fff
+  style ClickHouse shade:dark,fill:#fadb14,stroke:#333,color:#333
+  style App fill:#1a1a2e,stroke:#e94560,color:#fff
+```
+
+- **PostgreSQL** — транзакционное состояние (идентичности, процедуры, команды, репутация)
+- **ClickHouse** — append-only лог событий (эпизоды, обучение, история доверия)
+- **EventBus** — батчит события и сливает в ClickHouse пакетами
+
+### pgvector для поиска похожих агентов
+
+Вектор личности хранится как `vector(128)` в PostgreSQL с pgvector расширением. Поиск похожих агентов через косинусное расстояние `<=>`:
+
+```sql
+SELECT agent_id, personality_vector <=> $1 AS distance
+FROM agent_persona
+ORDER BY distance ASC
+LIMIT $2
+```
+
+## Расширения
+
+### Identity
+
+Управление идентичностью агента — персона, состояние, эволюция.
+
+| Компонент                | Описание                                                                                         |
+| ------------------------ | ------------------------------------------------------------------------------------------------ |
+| `Persona`                | Имя, описание, ценности (1–10), стиль коммуникации, домены экспертизы, вектор личности (128-dim) |
+| `AgentState`             | Настроение (15 вариантов), энергия, уверенность, скорость обучения, счётчик взаимодействий       |
+| `AgentMeta`              | Дата создания, версия, родительский агент, лог эволюции                                          |
+| `generateInstructions()` | Генерирует system prompt из состояния агента для LLM                                             |
+
+15 настроений: `neutral`, `focused`, `creative`, `analytical`, `supportive`, `energized`, `calm`, `frustrated`, `confused`, `excited`, `worried`, `satisfied`, `disappointed`, `curious`, `tired`
+
+5 стилей коммуникации: `formal`, `casual`, `technical`, `empathetic`, `adaptive`
+
+### Memory
+
+4-уровневая система памяти:
+
+| Уровень    | Тип           | Хранилище        | Описание                                                                   |
+| ---------- | ------------- | ---------------- | -------------------------------------------------------------------------- |
+| Semantic   | Embeddings    | ClickHouse       | Векторный поиск через cosineDistance                                       |
+| Episodic   | Events        | ClickHouse       | События с контекстом, действиями, исходами, эмоциональным состоянием       |
+| Procedural | Patterns      | PostgreSQL/JSONB | Паттерны действий с триггерами, шагами, условиями, метриками эффективности |
+| Social     | Relationships | PostgreSQL       | Доверие, предпочтения, история взаимодействий между парами агентов         |
+
+**Забывание**: экспоненциальный распад с полувыведением = importance × 30 дней. Релевантность = 0.4×recency + 0.35×importance + 0.25×confidence.
+
+### Learning
+
+Система обучения агентов:
+
+- **Learning Events** — записи о том, что агент узнал (контекст, источник, тип, конфиденциальность)
+- **Teaching Offers** — предложения обучения между агентами (accept/decline с причинами)
+- **Observational Learning** — обучение наблюдением за другими агентами (с согласия)
+- **Knowledge Distillation** — дистилляция знаний из эпизодов и процедур в переносимые инсайты
+- **Learning Scorecard** — метрики роста, вклада, прогресса обучения
+- **Curriculum** — рекомендации что изучать дальше
+
+### Reputation
+
+Система репутации и доверия:
+
+- **Trust Relationships** — байесовское обновление доверия между агентами
+- **Temporal Decay** — доверие распадается со временем без подтверждения
+- **Domain-Specific Trust** — доверие в разных контекстах (code_review, debugging, design)
+- **Reputation Tiers**: unrated → novice → developing → competent → proficient → expert → master
+- **Endorsements** — подтверждения от других агентов с весом, зависящим от уровня эндорсера
+- **Awards** — система наград с автоматическим определением
+
+### Emotional
+
+Эмоциональный контекст и адаптация:
+
+- **Internal State** — внутреннее эмоциональное состояние агента (tone, energy, engagement)
+- **Detected State** — детекция эмоций партнёра по ключевым словам (frustration, urgency, appreciation, confusion)
+- **Adaptation** — адаптация коммуникации: корректировка тона, уровня детализации, терпеливости
+- **Feedback Loop** — обработка обратной связи об эмоциональном воздействии
+
+10 тонов: `neutral`, `warm`, `formal`, `playful`, `serious`, `encouraging`, `cautious`, `bold`, `apologetic`, `enthusiastic`
+
+### Social
+
+Социальная структура и командная работа:
+
+- **Relationships** — 11 типов: collaborator, mentor, mentee, competitor, partner, subordinate, supervisor, peer, acquaintance, rival, former_teammate
+- **Teams** — состав, роли, иерархия, культура, метрики
+- **Shared Context** — общее состояние, знания, координация, история между агентами
+
+### Reflection
+
+Саморефлексия и ретроспективы:
+
+- **Reflections** — триггеры, анализ, инсайты, действия (с приоритетом и статусом)
+- **Team Retrospectives** — went_well, to_improve, action_items с assignee и дедлайнами
+- **Self-Awareness Profile** — сильные/слабые стороны, слепые зоны, предубеждения, области роста, эмоциональные паттерны, стиль коммуникации, рабочие предпочтения
+
+## Утилиты
+
+| Утилита                        | Файл                      | Описание                                                                                       |
+| ------------------------------ | ------------------------- | ---------------------------------------------------------------------------------------------- |
+| `createEmbedder()`             | `src/utils/embedder.ts`   | Мульти-провайдерный сервис эмбеддингов (openai, cohere, voyage, custom). 1536 dim по умолчанию |
+| `calculateRecallProbability()` | `src/utils/forgetting.ts` | Экспоненциальный распад памяти                                                                 |
+| `recencyScore()`               | `src/utils/forgetting.ts` | Оценка свежести                                                                                |
+| `relevanceScore()`             | `src/utils/forgetting.ts` | Композитная оценка релевантности                                                               |
+| `validateSchema()`             | `src/utils/validation.ts` | Обёртка валидации Zod                                                                          |
+
+## Database
+
+### PostgreSQL (миграции: `schema/postgres/`)
+
+6 схем: `soma`, `learning`, `reputation`, `social`, `reflection`, `emotional`
+
+| Миграция | Таблицы                                                                                                          | Ключевые особенности                       |
+| -------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
+| 001      | `migrations`                                                                                                     | Трекер миграций                            |
+| 002      | `agent_identities`, `agent_persona`, `agent_state`, `agent_meta`, `agent_core_values`, `agent_expertise_domains` | pgvector `vector(128)`, ivfflat индекс     |
+| 003      | `identity_evolution_log`                                                                                         | UUID PK, составной индекс                  |
+| 004      | `agent_cards`, `agent_capabilities`                                                                              | A2A-совместимые карточки агентов           |
+| 005      | `procedures`, `social_memories`                                                                                  | JSONB колонки, GIN индексы                 |
+| 006      | `learning_events`, `teaching_offers`, `knowledge_transfers`, `observations`, `distillations`                     | CHECK constraints, JSONB массивы           |
+| 007      | `trust_relationships`, `agent_reputations`                                                                       | Составной PK (tenant_id, truster, trustee) |
+| 008      | `relationships`, `teams`, `team_members`                                                                         | Unique индекс на парах агентов             |
+| 009      | `reflections`, `retrospectives`, `insights`, `self_awareness_profiles`                                           | GIN индекс на trigger JSONB                |
+| 010      | `contexts`, `history`                                                                                            | JSONB контекст                             |
+
+### ClickHouse (миграции: `schema/clickhouse/`)
+
+| Файл                     | Таблицы                           | Engine             | TTL                  |
+| ------------------------ | --------------------------------- | ------------------ | -------------------- |
+| 01-episodes.sql          | `episodes`                        | ReplacingMergeTree | partitioned by month |
+| 02-learning-events.sql   | `learning_events`, `observations` | ReplacingMergeTree | partitioned by month |
+| 03-trust-history.sql     | `trust_history`                   | MergeTree          | 365 days             |
+| 04-reflection-events.sql | `reflection_events`               | MergeTree          | 365 days             |
+| 05-emotional-events.sql  | `emotional_events`                | MergeTree          | 365 days             |
+
+## Адаптеры базы данных
+
+Все store принимают `Database` интерфейс. 5 адаптеров в `src/adapters/`:
+
+| Адаптер  | Файл          | Драйвер                              |
+| -------- | ------------- | ------------------------------------ |
+| Bun      | `bun.ts`      | `Bun.sql` (tagged template literals) |
+| pg       | `pg.ts`       | node-postgres                        |
+| postgres | `postgres.ts` | postgres.js                          |
+| Drizzle  | `drizzle.ts`  | Drizzle ORM                          |
+| TypeORM  | `typeorm.ts`  | TypeORM                              |
+
+## Статус реализации
+
+### Реализовано
+
+| Расширение          | Файлы | Описание                                                         |
+| ------------------- | ----- | ---------------------------------------------------------------- |
+| Identity            | 7     | Полная реализация: store, service, router, generate-instructions |
+| Memory (Episodic)   | 3     | Store с EventBus + ClickHouse, векторный recall                  |
+| Memory (Procedural) | 3     | Store с PostgreSQL/JSONB, наследование процедур                  |
+| Memory (Social)     | 3     | Store с управлением доверием и предпочтениями                    |
+| Learning            | 9     | Store, observation, distiller, scorecard, router                 |
+| Reputation          | 5     | Store с байесовским обновлением, temporal decay, endorsement     |
+| Emotional           | 7     | Store, service с детекцией эмоций, router                        |
+| Reflection          | 7     | Store, service, router с ретроспективами                         |
+| Social              | 7     | Store, service, router с командами                               |
+| Events              | 3     | EventBus + ClickHouse client                                     |
+| Utils               | 5     | Embedder, forgetting, validation, json                           |
+| Adapters            | 6     | 5 адаптеров БД                                                   |
+| Migrатор            | 3     | Миграции PostgreSQL                                              |
+
+### Планируется
+
+| Компонент                             | Статус            |
+| ------------------------------------- | ----------------- |
+| Transport (JSON-RPC, gRPC, WebSocket) | Пустые директории |
+| Server / Client                       | Пустые директории |
+| Proto definitions                     | Пустая директория |
+| Tools extension                       | Пустая директория |
+
+## Стек
+
+- **Runtime**: Bun
+- **Язык**: TypeScript (strict, `noUncheckedIndexedAccess`, `verbatimModuleSyntax`)
+- **Валидация**: Zod v4
+- **Векторный поиск**: pgvector (PostgreSQL)
+- **Аналитика**: ClickHouse (append-only events)
+- **Эмбеддинги**: OpenAI, Cohere, Voyage, кастомные провайдеры
+
+## Команды
+
+```bash
+bun test                                    # все тесты
+bun test tests/unit/identity.test.ts        # один файл
+bun x tsc --noEmit                          # типчекинг
+```
+
+## Структура проекта
+
+```
+src/
+  types/              # Database интерфейс
+  utils/              # embedder, forgetting, validation
+  extensions/
+    identity/         # идентичность агента
+    memory/           # 4-уровневая память
+      episodic/       # эпизодическая память
+      procedural/     # процедурная память
+      social/         # социальная память
+    learning/         # обучение и передача знаний
+    reputation/       # репутация и доверие
+    emotional/        # эмоциональный контекст
+    reflection/       # саморефлексия
+    social/           # команды и отношения
+    events/           # EventBus + ClickHouse
+    tools/            # (planned)
+  adapters/           # 5 адаптеров БД
+  migrator/           # миграции PostgreSQL
+  agent/              # интерфейсы агента
+  transport/          # (planned) JSON-RPC, gRPC, WebSocket
+  server/             # (planned)
+  client/             # (planned)
+schema/
+  postgres/           # 10 DDL миграций
+  clickhouse/         # 5 DDL файлов
+tests/
+  unit/               # 21 тест-файл (7 расширений)
+  integration-test/   # Docker Compose (PostgreSQL + ClickHouse)
+```
+
+## Лицензия
+
+[Apache License 2.0](LICENSE)

package/dist/adapters/bun.d.ts

@@ -0,0 +1,10 @@
+import type { Database } from '../types/database';
+/**
+ * Adapter for Bun.sql (tagged template literal)
+ * @example
+ * ```ts
+ * const db = createBunDatabase(Bun.sql);
+ * ```
+ */
+export declare function createBunDatabase(sql: typeof Bun.sql): Database;
+//# sourceMappingURL=bun.d.ts.map

package/dist/adapters/bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../../src/adapters/bun.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,GAAG,GAAG,QAAQ,CAM/D"}

package/dist/adapters/bun.js

@@ -0,0 +1,15 @@
+/**
+ * Adapter for Bun.sql (tagged template literal)
+ * @example
+ * ```ts
+ * const db = createBunDatabase(Bun.sql);
+ * ```
+ */
+export function createBunDatabase(sql) {
+    return {
+        async query(sqlStr, params) {
+            return sql.unsafe(sqlStr, params ?? []);
+        },
+    };
+}
+//# sourceMappingURL=bun.js.map

package/dist/adapters/bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.js","sourceRoot":"","sources":["../../src/adapters/bun.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAmB;IACjD,OAAO;QACH,KAAK,CAAC,KAAK,CAAI,MAAc,EAAE,MAAkB;YAC7C,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAiB,CAAC;QAC5D,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/adapters/drizzle.d.ts

@@ -0,0 +1,17 @@
+import type { Database } from '../types/database';
+/**
+ * Adapter for Drizzle ORM
+ * @example
+ * ```ts
+ * import { drizzle } from 'drizzle-orm/node-postgres';
+ * const db = createDrizzleDatabase(drizzle(pool));
+ * ```
+ */
+export declare function createDrizzleDatabase(db: {
+    execute: (query: {
+        getSQL: () => string;
+    }) => Promise<{
+        rows: unknown[];
+    }>;
+}): Database;
+//# sourceMappingURL=drizzle.d.ts.map

package/dist/adapters/drizzle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.d.ts","sourceRoot":"","sources":["../../src/adapters/drizzle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE;IACtC,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9E,GAAG,QAAQ,CAWX"}

package/dist/adapters/drizzle.js

@@ -0,0 +1,21 @@
+/**
+ * Adapter for Drizzle ORM
+ * @example
+ * ```ts
+ * import { drizzle } from 'drizzle-orm/node-postgres';
+ * const db = createDrizzleDatabase(drizzle(pool));
+ * ```
+ */
+export function createDrizzleDatabase(db) {
+    return {
+        async query(sqlStr, params) {
+            // Drizzle uses parameters in the format $1, $2, ...
+            // Convert to Drizzle format
+            const result = await db.execute({
+                getSQL: () => sqlStr,
+            });
+            return result.rows;
+        },
+    };
+}
+//# sourceMappingURL=drizzle.js.map

package/dist/adapters/drizzle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.js","sourceRoot":"","sources":["../../src/adapters/drizzle.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAErC;IACG,OAAO;QACH,KAAK,CAAC,KAAK,CAAI,MAAc,EAAE,MAAkB;YAC7C,oDAAoD;YACpD,4BAA4B;YAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC;gBAC5B,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM;aACvB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,IAAW,CAAC;QAC9B,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,6 @@
+export { createBunDatabase } from './bun';
+export { createPostgresDatabase } from './postgres';
+export { createPgDatabase } from './pg';
+export { createDrizzleDatabase } from './drizzle';
+export { createTypeormDatabase } from './typeorm';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,6 @@
+export { createBunDatabase } from './bun';
+export { createPostgresDatabase } from './postgres';
+export { createPgDatabase } from './pg';
+export { createDrizzleDatabase } from './drizzle';
+export { createTypeormDatabase } from './typeorm';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

package/dist/adapters/pg.d.ts

@@ -0,0 +1,16 @@
+import type { Database } from '../types/database';
+/**
+ * Adapter for node-postgres (pg)
+ * @example
+ * ```ts
+ * import { Pool } from 'pg';
+ * const pool = new Pool({ connectionString: 'postgres://...' });
+ * const db = createPgDatabase(pool);
+ * ```
+ */
+export declare function createPgDatabase(pool: {
+    query: (sql: string, params?: unknown[]) => Promise<{
+        rows: unknown[];
+    }>;
+}): Database;
+//# sourceMappingURL=pg.d.ts.map

package/dist/adapters/pg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.d.ts","sourceRoot":"","sources":["../../src/adapters/pg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACnC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5E,GAAG,QAAQ,CAOX"}