@axon-assistant/core 2026.8.23

package/README.md

@@ -0,0 +1,52 @@
+# @axon-assistant/core
+
+Ядро [Axon](https://github.com/bigtaed-sys/axon) — персонального AI-агента,
+который живёт на вашей машине, а не в чужом облаке.
+
+Ядро владеет всем: историей, памятью, инструментами, контекстом, вызовами
+моделей. Приложения (десктоп, Telegram) подключаются к нему и синхронизируются
+через журнал событий. Сколько бы устройств ни было подключено, контекст один,
+кэш промпта один, и расход токенов не умножается на число экранов.
+
+## Установка
+
+Node 22.5+. Нативных модулей нет, компилятор не нужен.
+
+```bash
+npm install -g @axon-assistant/core
+axon start                      # слушает 127.0.0.1:8787
+axon start --host 0.0.0.0       # ещё и для устройств из сети
+```
+
+При первом запуске ядро печатает код для подключения первого устройства и
+кладёт его в `bootstrap.code` рядом с данными — код сгорает после первого
+использования.
+
+```bash
+axon status                                     # запущено ли и где
+axon secret set provider.anthropic.apiKey sk-…  # ключ провайдера
+axon devices                                    # подключённые устройства
+axon plugin catalog                             # что можно поставить
+axon backup create                              # архив с базой и блобами
+axon stop
+```
+
+Папка данных задаётся переменной `AXON_DATA_DIR`; по умолчанию — стандартная
+папка приложений вашей ОС. Внутри лежит всё: база, блобы и ключ шифрования
+секретов. Переносится копированием.
+
+## Что уходит наружу
+
+К провайдеру модели — то, что вы видите в разборе контекста. Есть ровно одно
+исключение, и оно по вашему действию: открытая вкладка «Каталог» в плагинах
+тянет список из публичного репозитория, без каких-либо сведений о вас. Само по
+себе ядро в сеть не ходит: обновлений, телеметрии и «анонимной статистики» нет.
+
+## Плагины
+
+Свои инструменты, скиллы, работа по расписанию и провайдеры моделей пишутся на
+[@axon-assistant/plugin-sdk](https://www.npmjs.com/package/@axon-assistant/plugin-sdk).
+Заготовка — `axon plugin new мой-плагин`. Чужие MCP-серверы подключаются
+конфигурацией из их README, без обёрток.
+
+MIT.

package/dist/Daemon.d.ts

@@ -0,0 +1,119 @@
+import type { CoreConfig, Runtime } from '@axon/core';
+import { Userbot } from '@axon/telegram';
+export declare const DAEMON_VERSION: string;
+export interface DaemonOptions {
+    config?: Partial<CoreConfig>;
+    host?: string;
+    port?: number;
+    /** `embedded` — ядро внутри десктопа, `standalone` — отдельный сервис. */
+    mode?: 'embedded' | 'standalone';
+}
+export interface DaemonAddress {
+    host: string;
+    port: number;
+    url: string;
+}
+/**
+ * Демон: тонкая обвязка вокруг ядра.
+ *
+ * Живой канал — один WebSocket, по нему идёт всё, кроме блобов: файлы
+ * качаются обычным HTTP, чтобы не забивать канал и не терять докачку с
+ * кэшированием на стороне клиента.
+ *
+ * TLS здесь намеренно нет. Локально он не нужен, а для доступа снаружи
+ * правильный слой — туннель или обратный прокси: самоподписанный сертификат
+ * внутри демона дал бы иллюзию защиты и кучу проблем с доверием.
+ */
+export declare class Daemon {
+    private readonly options;
+    readonly runtime: Runtime;
+    private readonly sessions;
+    private readonly pairing;
+    private readonly permissions;
+    private readonly server;
+    private readonly wss;
+    private address;
+    private telegram;
+    /** Агент под аккаунтом владельца. Поднимается, когда в секретах есть сессия. */
+    readonly userbot: Userbot;
+    /** Незавершённый вход: живёт между шагами «телефон → код → пароль». */
+    private auth;
+    /**
+     * Кто ещё слушает эфемерику, кроме сокетов.
+     *
+     * Сигналы — куски ответа, фазы, расход — не журналируются и до сих пор
+     * уходили только в WS-сессии. Телеграм живёт в этом же процессе и обычно без
+     * единого открытого сокета: без такой подписки он не увидел бы, как растёт
+     * ответ, и мог бы показать его только целиком в самом конце.
+     */
+    private readonly signalListeners;
+    /** Разрешается, когда все установленные плагины отработали запуск. */
+    pluginsReady: Promise<void>;
+    constructor(options?: DaemonOptions);
+    start(): Promise<{
+        address: DaemonAddress;
+        bootstrapCode: string | null;
+    }>;
+    /**
+     * Поднять или погасить телеграм по наличию токена.
+     *
+     * Токен есть — бот работает, токена нет — не работает. Отдельного
+     * переключателя «включить телеграм» нет намеренно: он был бы вторым
+     * источником правды, и рано или поздно человек оказался бы с введённым
+     * токеном и выключенным ботом, не понимая почему.
+     */
+    private syncTelegram;
+    /**
+     * Поднять или погасить юзербота по наличию сессии.
+     *
+     * Отдельно от бота: это разные вещи, и одна работает без другой. Бот —
+     * канал к агенту, юзербот — команда `.axon` в чужих чатах от твоего имени.
+     */
+    private syncUserbot;
+    /**
+     * Шаг входа в аккаунт.
+     *
+     * Состояние живёт между вызовами в `this.auth`: телеграм присылает код между
+     * первым шагом и вторым, и всё это время соединение должно оставаться тем же.
+     */
+    telegramLogin(step: 'phone' | 'code' | 'password' | 'cancel', value: string): Promise<{
+        state: "cancelled";
+        hint?: never;
+        name?: never;
+    } | {
+        state: "code_sent";
+        hint: string;
+        name?: never;
+    } | {
+        state: "password_needed";
+        hint?: never;
+        name?: never;
+    } | {
+        state: "done";
+        name: string;
+        hint?: never;
+    }>;
+    telegramLogout(): Promise<void>;
+    telegramStatus(): {
+        bot: boolean;
+        user: boolean;
+    };
+    /**
+     * Заявка о себе рядом с данными.
+     *
+     * Ядро — самостоятельная программа, и запустить его может кто угодно:
+     * автозагрузка, systemd, рука в терминале, приложение. Чтобы клиент на этой
+     * же машине мог его найти, не завися от того, кто его поднял, адрес и pid
+     * кладутся в файл рядом с базой.
+     */
+    private announce;
+    private withdraw;
+    stop(): Promise<void>;
+    get url(): string;
+    /** Есть ли на связи устройство, способное ответить на запрос разрешения. */
+    private hasAudience;
+    private onRequest;
+    private sendBlob;
+    private onUpgrade;
+}
+//# sourceMappingURL=Daemon.d.ts.map

package/dist/Daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Daemon.d.ts","sourceRoot":"","sources":["../src/Daemon.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAKtD,OAAO,EAML,OAAO,EAER,MAAM,gBAAgB,CAAC;AAKxB,eAAO,MAAM,cAAc,QAC4C,CAAC;AAIxE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;GAUG;AACH,qBAAa,MAAM;IAyBL,OAAO,CAAC,QAAQ,CAAC,OAAO;IAxBpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,QAAQ,CAAgC;IAChD,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,OAAO,CAAC,IAAI,CAA4B;IACxC;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuC;IACvE,sEAAsE;IACtE,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAqB;gBAEnB,OAAO,GAAE,aAAkB;IAsClD,KAAK,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IA+ChF;;;;;;;OAOG;YACW,YAAY;IAmC1B;;;;;OAKG;YACW,WAAW;IAkBzB;;;;;OAKG;IACG,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;;;IAoC3E,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC,cAAc;;;;IAOd;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,QAAQ;IAIV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,IAAI,GAAG,IAAI,MAAM,CAGhB;IAED,4EAA4E;IAC5E,OAAO,CAAC,WAAW;YAWL,SAAS;IAsDvB,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,SAAS;CA+BlB"}

package/dist/PermissionHub.d.ts

@@ -0,0 +1,23 @@
+import type { PermissionDecision, PermissionRequest } from '@axon/protocol';
+import type { PermissionBroker } from '@axon/core';
+/**
+ * Ожидание ответа на запрос разрешения.
+ *
+ * Тонкость, из-за которой это отдельный класс: если ответить некому, ждать
+ * пять минут бессмысленно и вредно — прогон висит, пользователь смотрит на
+ * «выполняется». Поэтому сначала проверяем, есть ли вообще кто-то на связи с
+ * правом отвечать, и только потом ждём.
+ */
+export declare class PermissionHub implements PermissionBroker {
+    private readonly hasAudience;
+    private readonly pending;
+    constructor(hasAudience: () => boolean);
+    request(request: PermissionRequest): Promise<PermissionDecision>;
+    /** Ответ пришёл командой от устройства. */
+    resolve(requestId: string, decision: PermissionDecision): boolean;
+    /** Есть ли незакрытые запросы — демон показывает это в /health. */
+    get pendingCount(): number;
+    /** Снять все ожидания при остановке демона. */
+    shutdown(): void;
+}
+//# sourceMappingURL=PermissionHub.d.ts.map

package/dist/PermissionHub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionHub.d.ts","sourceRoot":"","sources":["../src/PermissionHub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IAMxC,OAAO,CAAC,QAAQ,CAAC,WAAW;IALxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGpB;gBAEyB,WAAW,EAAE,MAAM,OAAO;IAEjD,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmBtE,2CAA2C;IAC3C,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO;IAUjE,mEAAmE;IACnE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,+CAA+C;IAC/C,QAAQ,IAAI,IAAI;CAOjB"}

package/dist/WsSession.d.ts

@@ -0,0 +1,32 @@
+import type { WebSocket } from 'ws';
+import { type Device, type Signal } from '@axon/protocol';
+import { type Runtime } from '@axon/core';
+import type { PairingService } from './auth.js';
+import { type TelegramControl } from './commands.js';
+import type { PermissionHub } from './PermissionHub.js';
+export interface SessionDeps {
+    runtime: Runtime;
+    pairing: PairingService;
+    permissions: PermissionHub;
+    telegram: TelegramControl;
+    version: string;
+    mode: 'embedded' | 'standalone';
+}
+export declare class WsSession {
+    private readonly socket;
+    private readonly device;
+    private readonly deps;
+    private readonly unsubscribe;
+    private droppedSignals;
+    constructor(socket: WebSocket, device: Device, deps: SessionDeps);
+    get deviceId(): string;
+    canReceiveSignals(): boolean;
+    /** Эфемерика: доставляется по возможности. */
+    emitSignal(signal: Signal): void;
+    close(): void;
+    private onJournal;
+    private onMessage;
+    private handleRequest;
+    private send;
+}
+//# sourceMappingURL=WsSession.d.ts.map

package/dist/WsSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WsSession.d.ts","sourceRoot":"","sources":["../src/WsSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAIL,KAAK,MAAM,EAGX,KAAK,MAAM,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYxD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,aAAa,CAAC;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;CACjC;AAED,qBAAa,SAAS;IAKlB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,cAAc,CAAK;gBAGR,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW;IAuBpC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,iBAAiB,IAAI,OAAO;IAI5B,8CAA8C;IAC9C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAShC,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,SAAS;YAKH,SAAS;YAwCT,aAAa;IA4B3B,OAAO,CAAC,IAAI;CAIb"}

package/dist/auth.d.ts

@@ -0,0 +1,49 @@
+import type { Device, DevicePlatform, Scope } from '@axon/protocol';
+import type { Runtime } from '@axon/core';
+/**
+ * Токен устройства выдаётся один раз и больше не показывается. В базе лежит
+ * только его sha256 — утёкший файл БД не даёт войти в ядро.
+ */
+export declare function hashToken(token: string): string;
+export declare function generateToken(): string;
+export interface PendingPairing {
+    name: string;
+    platform: DevicePlatform;
+    scopes: Scope[];
+    expiresAt: number;
+}
+/**
+ * Пейринг устройств.
+ *
+ * Обычный путь: уже доверенное устройство просит код, новое устройство меняет
+ * код на токен. Проблема курицы и яйца — первое устройство — решается так же,
+ * как в Jupyter: при первом запуске ядро пишет одноразовый код в файл рядом с
+ * данными. У кого есть доступ к машине, тот и заводит первое устройство; по
+ * сети код не улетает.
+ */
+export declare class PairingService {
+    private readonly runtime;
+    private readonly bootstrapPath;
+    private readonly pending;
+    constructor(runtime: Runtime, bootstrapPath: string);
+    /** Код первого устройства. Пишется только если устройств ещё нет. */
+    ensureBootstrapCode(): string | null;
+    begin(input: {
+        name: string;
+        platform: DevicePlatform;
+        scopes: Scope[];
+        ttlSeconds: number;
+    }): {
+        code: string;
+        expiresInSeconds: number;
+    };
+    /** Обменять код на токен. Код одноразовый. */
+    complete(code: string, deviceName?: string): {
+        device: Device;
+        token: string;
+    } | null;
+    private sweep;
+}
+/** Найти устройство по предъявленному токену. */
+export declare function authenticate(runtime: Runtime, token: string | null): Device | null;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;gBAG1C,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,MAAM;IAGxC,qEAAqE;IACrE,mBAAmB,IAAI,MAAM,GAAG,IAAI;IA8BpC,KAAK,CAAC,KAAK,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,cAAc,CAAC;QACzB,MAAM,EAAE,KAAK,EAAE,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAW9C,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAoBrF,OAAO,CAAC,KAAK;CAMd;AAcD,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAGlF"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}