@capybara-hq/kernel 0.1.0-rc.0 → 0.1.0-rc.2

package/dist/http/health.controller.js

@@ -1,79 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
-import { Controller, Get, Inject, Res } from "@nestjs/common";
-import { Public } from "../identity/principal.js";
-import { HEALTH_OPTIONS } from "./tokens.js";
-/** 单项检查的超时：依赖挂起（如 Redis 正在重连、命令进了离线队列）时也要尽快给出 503。 */
-const CHECK_TIMEOUT_MS = 2_000;
-function withTimeout(p, ms) {
-    let timer;
-    const timeout = new Promise((_, reject) => {
-        timer = setTimeout(() => reject(new Error(`timed out after ${ms}ms`)), ms);
-        timer.unref();
-    });
-    return Promise.race([p, timeout]).finally(() => clearTimeout(timer));
-}
-/**
- * `GET /healthz`（进程存活，恒 200）与 `GET /readyz`（依赖就绪）。
- * readyz 的 body 只给出每项检查的 `"ok"` / `"error"`，失败原因只进日志（已打码），不进响应——
- * 驱动的错误信息可能带连接串。停机开始后 readyz 立即 503，不再执行检查。
- * 标为 `@Public()`：挂载内核 API 时全局 AuthGuard 也作用于这里。
- */
-let HealthController = class HealthController {
-    opts;
-    constructor(opts) {
-        this.opts = opts;
-    }
-    healthz() {
-        return { ok: true };
-    }
-    async readyz(reply) {
-        const { opts } = this;
-        const stopping = () => {
-            reply.code(503);
-            return { ok: false, stopping: true };
-        };
-        if (opts.isStopping())
-            return stopping();
-        const timeoutMs = opts.timeoutMs ?? CHECK_TIMEOUT_MS;
-        const names = Object.keys(opts.checks);
-        const results = await Promise.allSettled(names.map((n) => withTimeout(opts.checks[n](), timeoutMs)));
-        const body = {};
-        let ok = true;
-        results.forEach((r, i) => {
-            const name = names[i];
-            if (r.status === "fulfilled") {
-                body[name] = "ok";
-            }
-            else {
-                ok = false;
-                body[name] = "error";
-                opts.log.warn("readiness check failed", { check: name, err: r.reason });
-            }
-        });
-        if (opts.isStopping())
-            return stopping();
-        reply.code(ok ? 200 : 503);
-        return { ok, ...body };
-    }
-};
-__decorate([
-    Get("healthz")
-], HealthController.prototype, "healthz", null);
-__decorate([
-    Get("readyz"),
-    __param(0, Res({ passthrough: true }))
-], HealthController.prototype, "readyz", null);
-HealthController = __decorate([
-    Controller(),
-    Public(),
-    __param(0, Inject(HEALTH_OPTIONS))
-], HealthController);
-export { HealthController };

package/dist/http/tokens.d.ts

@@ -1,131 +0,0 @@
-/** 内核 logger（`Logger`）的注入令牌。 */
-export declare const KERNEL_LOG: unique symbol;
-/** 健康检查参数（`HealthOptions`）的注入令牌。 */
-export declare const HEALTH_OPTIONS: unique symbol;
-/** 内核 schema 视图（`KernelDb`）的注入令牌。 */
-export declare const KERNEL_DB: unique symbol;
-/** 内核共享 Redis 连接（ioredis `Redis`）的注入令牌。 */
-export declare const KERNEL_REDIS: unique symbol;
-/** 当前配置的取值函数（`() => KernelConfig`，热更新后返回新配置）的注入令牌。 */
-export declare const KERNEL_CONFIG: unique symbol;
-/** `AccountsService` 的注入令牌。 */
-export declare const ACCOUNTS: unique symbol;
-/** `SessionService` 的注入令牌。 */
-export declare const SESSIONS: unique symbol;
-/** `ApiTokenService` 的注入令牌。 */
-export declare const API_TOKENS: unique symbol;
-/** `SettingsService` 的注入令牌。 */
-export declare const SETTINGS: unique symbol;
-/** `LoginRateLimiter` 的注入令牌。 */
-export declare const RATE_LIMITER: unique symbol;
-/** `OrgsService` 的注入令牌。 */
-export declare const ORGS: unique symbol;
-/** `OrgSettingsService`（组织设置）的注入令牌。 */
-export declare const ORG_SETTINGS: unique symbol;
-/** `MembersService` 的注入令牌。 */
-export declare const MEMBERS: unique symbol;
-/** `InvitationsService` 的注入令牌。 */
-export declare const INVITATIONS: unique symbol;
-/** `SetupService` 的注入令牌。 */
-export declare const SETUP: unique symbol;
-/** Injection token for `OrgExtensionConfigs`. */
-export declare const ORG_EXTENSION_CONFIGS: unique symbol;
-/** `ProviderRegistry` 的注入令牌。 */
-export declare const PROVIDER_REGISTRY: unique symbol;
-/** `AgentsService` 的注入令牌。 */
-export declare const AGENTS: unique symbol;
-/** `AgentTemplatesService` (agent templates from plugins). */
-export declare const AGENT_TEMPLATES: unique symbol;
-/** 内核总线（`createBus(..., "kernel")`，`ExtensionContext["bus"]`）的注入令牌。 */
-export declare const KERNEL_BUS: unique symbol;
-/** `EventLog` 的注入令牌。 */
-export declare const EVENT_LOG: unique symbol;
-/** `ConversationsService` 的注入令牌。 */
-export declare const CONVERSATIONS: unique symbol;
-/** `AttachmentsService`（对话附件）的注入令牌。 */
-export declare const ATTACHMENTS: unique symbol;
-/** `SkillsService`（技能库）的注入令牌。 */
-export declare const SKILLS: unique symbol;
-/** `SkillInvoker` (a person's skill invocation, phase D). */
-export declare const SKILL_INVOKER: unique symbol;
-/** `SkillChangesService`（agent 自写技能与技能变更审批）的注入令牌。 */
-export declare const SKILL_CHANGES: unique symbol;
-/** `InboxService`（收件箱汇总）的注入令牌。 */
-export declare const INBOX: unique symbol;
-/** `ConversationOutputs`（网页读工具输出存档）的注入令牌。 */
-export declare const CONVERSATION_OUTPUTS: unique symbol;
-/** `ConversationArtifacts`（产物下载）的注入令牌。 */
-export declare const CONVERSATION_ARTIFACTS: unique symbol;
-/** `ConversationFiles` (file outputs list and text content, UI refresh B). */
-export declare const CONVERSATION_FILES: unique symbol;
-export declare const FILE_PREVIEWERS: unique symbol;
-/** `ConversationQueue` (queued messages, UI refresh B). */
-export declare const CONVERSATION_QUEUE: unique symbol;
-/** `ConversationSandboxStatus`（对话沙箱状态）的注入令牌。 */
-export declare const CONVERSATION_SANDBOX: unique symbol;
-/** `ConversationToolInfo` (tool titles, kinds and key arguments for the conversation page). */
-export declare const CONVERSATION_TOOLS: unique symbol;
-/** `ConversationStreams`（本进程持有的会话 SSE 连接）的注入令牌。 */
-export declare const CONVERSATION_STREAMS: unique symbol;
-/** 连接器凭据（`Credentials`）的注入令牌。 */
-export declare const CREDENTIALS: unique symbol;
-/** `ToolRegistry` 的注入令牌。 */
-export declare const TOOL_REGISTRY: unique symbol;
-/** `ConnectorsService` 的注入令牌。 */
-export declare const CONNECTORS: unique symbol;
-/** `ConnectorContent`（连接器的 prompts / resources，供斜杠命令与 @ 引用）的注入令牌。 */
-export declare const CONNECTOR_CONTENT: unique symbol;
-/** `ApprovalsService`（工具调用审批与授权）的注入令牌。 */
-export declare const APPROVALS: unique symbol;
-/** `QuestionsService`（工具调用的输入请求）的注入令牌。 */
-export declare const QUESTIONS: unique symbol;
-/** `OAuthFlow`（OAuth 授权码连接流程）的注入令牌。 */
-export declare const OAUTH_FLOW: unique symbol;
-/** `ExternalIdentities`（外部身份 ↔ 账号）的注入令牌。 */
-export declare const EXTERNAL_IDENTITIES: unique symbol;
-/** `IdentityBinding`（IM 身份的一次性绑定链接）的注入令牌。 */
-export declare const IDENTITY_BINDING: unique symbol;
-/** `SsoFlow`（第三方登录）的注入令牌。 */
-export declare const SSO_FLOW: unique symbol;
-/** `Offboarding`（成员离职处理）的注入令牌。 */
-export declare const OFFBOARDING: unique symbol;
-/** `ChannelConnections`（组织的渠道连接）的注入令牌。 */
-export declare const CHANNEL_CONNECTIONS: unique symbol;
-/** `DirectorySync`（通讯录同步）的注入令牌。 */
-export declare const DIRECTORY_SYNC: unique symbol;
-/** `UiViews`（插件视图：列出贡献、render / action）的注入令牌。 */
-export declare const UI_VIEWS: unique symbol;
-/** `EmbedTokens`（嵌入应用的短期令牌，签发 / 校验）的注入令牌。 */
-export declare const EMBED_TOKENS: unique symbol;
-/** `OrgUiStreams`（组织级界面刷新 SSE）的注入令牌。 */
-export declare const ORG_UI_STREAMS: unique symbol;
-/** `PricesService`（模型价格表）的注入令牌。 */
-export declare const PRICES: unique symbol;
-/** `TrajectoryService`（轨迹查看器）的注入令牌。 */
-export declare const TRAJECTORIES: unique symbol;
-/** `EvalSetsService`（评测集与用例）的注入令牌。 */
-export declare const EVAL_SETS: unique symbol;
-/** `EvalRunsService`（评测运行）的注入令牌。 */
-export declare const EVAL_RUNS: unique symbol;
-/** `ModelPurposesService`（模型用途映射）的注入令牌。 */
-export declare const MODEL_PURPOSES: unique symbol;
-/** Injection token for `ExtensionInstalls` (extension package imports and install records). */
-export declare const EXTENSION_INSTALLS: unique symbol;
-/** Injection token for `ExtensionAdmin` (deployment-level extension list, status and web approval, enterprise admins). */
-export declare const EXTENSION_ADMIN: unique symbol;
-/** Deployment-level extension install / enable / disable / uninstall (`ExtensionAdminOps`). */
-export declare const EXTENSION_ADMIN_OPS: unique symbol;
-/** Deployment-level extension config (`ExtensionDeploymentConfigService`). */
-export declare const EXTENSION_DEPLOYMENT_CONFIGS: unique symbol;
-/** The enterprise catalog (`CatalogService`). */
-export declare const CATALOG: unique symbol;
-/** Plugin (app bundle) import: prepare / confirm and staging cleanup (`PluginImport`). */
-export declare const PLUGIN_IMPORT: unique symbol;
-/** Marketplaces (`MarketplacesService`). */
-export declare const MARKETPLACES: unique symbol;
-/** Organizations browse and install from the enterprise catalog (`OrgCatalogService`). */
-export declare const ORG_CATALOG: unique symbol;
-/** Catalog requests and approvals (`CatalogRequestsService`). */
-export declare const CATALOG_REQUESTS: unique symbol;
-/** Org install and uninstall of plugins (app bundles) (`PluginInstaller`). */
-export declare const PLUGIN_INSTALLER: unique symbol;

package/dist/http/tokens.js

@@ -1,131 +0,0 @@
-/** 内核 logger（`Logger`）的注入令牌。 */
-export const KERNEL_LOG = Symbol("KERNEL_LOG");
-/** 健康检查参数（`HealthOptions`）的注入令牌。 */
-export const HEALTH_OPTIONS = Symbol("HEALTH_OPTIONS");
-/** 内核 schema 视图（`KernelDb`）的注入令牌。 */
-export const KERNEL_DB = Symbol("KERNEL_DB");
-/** 内核共享 Redis 连接（ioredis `Redis`）的注入令牌。 */
-export const KERNEL_REDIS = Symbol("KERNEL_REDIS");
-/** 当前配置的取值函数（`() => KernelConfig`，热更新后返回新配置）的注入令牌。 */
-export const KERNEL_CONFIG = Symbol("KERNEL_CONFIG");
-/** `AccountsService` 的注入令牌。 */
-export const ACCOUNTS = Symbol("ACCOUNTS");
-/** `SessionService` 的注入令牌。 */
-export const SESSIONS = Symbol("SESSIONS");
-/** `ApiTokenService` 的注入令牌。 */
-export const API_TOKENS = Symbol("API_TOKENS");
-/** `SettingsService` 的注入令牌。 */
-export const SETTINGS = Symbol("SETTINGS");
-/** `LoginRateLimiter` 的注入令牌。 */
-export const RATE_LIMITER = Symbol("RATE_LIMITER");
-/** `OrgsService` 的注入令牌。 */
-export const ORGS = Symbol("ORGS");
-/** `OrgSettingsService`（组织设置）的注入令牌。 */
-export const ORG_SETTINGS = Symbol("ORG_SETTINGS");
-/** `MembersService` 的注入令牌。 */
-export const MEMBERS = Symbol("MEMBERS");
-/** `InvitationsService` 的注入令牌。 */
-export const INVITATIONS = Symbol("INVITATIONS");
-/** `SetupService` 的注入令牌。 */
-export const SETUP = Symbol("SETUP");
-/** Injection token for `OrgExtensionConfigs`. */
-export const ORG_EXTENSION_CONFIGS = Symbol("ORG_EXTENSION_CONFIGS");
-/** `ProviderRegistry` 的注入令牌。 */
-export const PROVIDER_REGISTRY = Symbol("PROVIDER_REGISTRY");
-/** `AgentsService` 的注入令牌。 */
-export const AGENTS = Symbol("AGENTS");
-/** `AgentTemplatesService` (agent templates from plugins). */
-export const AGENT_TEMPLATES = Symbol("AGENT_TEMPLATES");
-/** 内核总线（`createBus(..., "kernel")`，`ExtensionContext["bus"]`）的注入令牌。 */
-export const KERNEL_BUS = Symbol("KERNEL_BUS");
-/** `EventLog` 的注入令牌。 */
-export const EVENT_LOG = Symbol("EVENT_LOG");
-/** `ConversationsService` 的注入令牌。 */
-export const CONVERSATIONS = Symbol("CONVERSATIONS");
-/** `AttachmentsService`（对话附件）的注入令牌。 */
-export const ATTACHMENTS = Symbol("ATTACHMENTS");
-/** `SkillsService`（技能库）的注入令牌。 */
-export const SKILLS = Symbol("SKILLS");
-/** `SkillInvoker` (a person's skill invocation, phase D). */
-export const SKILL_INVOKER = Symbol("SKILL_INVOKER");
-/** `SkillChangesService`（agent 自写技能与技能变更审批）的注入令牌。 */
-export const SKILL_CHANGES = Symbol("SKILL_CHANGES");
-/** `InboxService`（收件箱汇总）的注入令牌。 */
-export const INBOX = Symbol("INBOX");
-/** `ConversationOutputs`（网页读工具输出存档）的注入令牌。 */
-export const CONVERSATION_OUTPUTS = Symbol("CONVERSATION_OUTPUTS");
-/** `ConversationArtifacts`（产物下载）的注入令牌。 */
-export const CONVERSATION_ARTIFACTS = Symbol("CONVERSATION_ARTIFACTS");
-/** `ConversationFiles` (file outputs list and text content, UI refresh B). */
-export const CONVERSATION_FILES = Symbol("CONVERSATION_FILES");
-export const FILE_PREVIEWERS = Symbol("FILE_PREVIEWERS");
-/** `ConversationQueue` (queued messages, UI refresh B). */
-export const CONVERSATION_QUEUE = Symbol("CONVERSATION_QUEUE");
-/** `ConversationSandboxStatus`（对话沙箱状态）的注入令牌。 */
-export const CONVERSATION_SANDBOX = Symbol("CONVERSATION_SANDBOX");
-/** `ConversationToolInfo` (tool titles, kinds and key arguments for the conversation page). */
-export const CONVERSATION_TOOLS = Symbol("CONVERSATION_TOOLS");
-/** `ConversationStreams`（本进程持有的会话 SSE 连接）的注入令牌。 */
-export const CONVERSATION_STREAMS = Symbol("CONVERSATION_STREAMS");
-/** 连接器凭据（`Credentials`）的注入令牌。 */
-export const CREDENTIALS = Symbol("CREDENTIALS");
-/** `ToolRegistry` 的注入令牌。 */
-export const TOOL_REGISTRY = Symbol("TOOL_REGISTRY");
-/** `ConnectorsService` 的注入令牌。 */
-export const CONNECTORS = Symbol("CONNECTORS");
-/** `ConnectorContent`（连接器的 prompts / resources，供斜杠命令与 @ 引用）的注入令牌。 */
-export const CONNECTOR_CONTENT = Symbol("CONNECTOR_CONTENT");
-/** `ApprovalsService`（工具调用审批与授权）的注入令牌。 */
-export const APPROVALS = Symbol("APPROVALS");
-/** `QuestionsService`（工具调用的输入请求）的注入令牌。 */
-export const QUESTIONS = Symbol("QUESTIONS");
-/** `OAuthFlow`（OAuth 授权码连接流程）的注入令牌。 */
-export const OAUTH_FLOW = Symbol("OAUTH_FLOW");
-/** `ExternalIdentities`（外部身份 ↔ 账号）的注入令牌。 */
-export const EXTERNAL_IDENTITIES = Symbol("EXTERNAL_IDENTITIES");
-/** `IdentityBinding`（IM 身份的一次性绑定链接）的注入令牌。 */
-export const IDENTITY_BINDING = Symbol("IDENTITY_BINDING");
-/** `SsoFlow`（第三方登录）的注入令牌。 */
-export const SSO_FLOW = Symbol("SSO_FLOW");
-/** `Offboarding`（成员离职处理）的注入令牌。 */
-export const OFFBOARDING = Symbol("OFFBOARDING");
-/** `ChannelConnections`（组织的渠道连接）的注入令牌。 */
-export const CHANNEL_CONNECTIONS = Symbol("CHANNEL_CONNECTIONS");
-/** `DirectorySync`（通讯录同步）的注入令牌。 */
-export const DIRECTORY_SYNC = Symbol("DIRECTORY_SYNC");
-/** `UiViews`（插件视图：列出贡献、render / action）的注入令牌。 */
-export const UI_VIEWS = Symbol("UI_VIEWS");
-/** `EmbedTokens`（嵌入应用的短期令牌，签发 / 校验）的注入令牌。 */
-export const EMBED_TOKENS = Symbol("EMBED_TOKENS");
-/** `OrgUiStreams`（组织级界面刷新 SSE）的注入令牌。 */
-export const ORG_UI_STREAMS = Symbol("ORG_UI_STREAMS");
-/** `PricesService`（模型价格表）的注入令牌。 */
-export const PRICES = Symbol("PRICES");
-/** `TrajectoryService`（轨迹查看器）的注入令牌。 */
-export const TRAJECTORIES = Symbol("TRAJECTORIES");
-/** `EvalSetsService`（评测集与用例）的注入令牌。 */
-export const EVAL_SETS = Symbol("EVAL_SETS");
-/** `EvalRunsService`（评测运行）的注入令牌。 */
-export const EVAL_RUNS = Symbol("EVAL_RUNS");
-/** `ModelPurposesService`（模型用途映射）的注入令牌。 */
-export const MODEL_PURPOSES = Symbol("MODEL_PURPOSES");
-/** Injection token for `ExtensionInstalls` (extension package imports and install records). */
-export const EXTENSION_INSTALLS = Symbol("EXTENSION_INSTALLS");
-/** Injection token for `ExtensionAdmin` (deployment-level extension list, status and web approval, enterprise admins). */
-export const EXTENSION_ADMIN = Symbol("EXTENSION_ADMIN");
-/** Deployment-level extension install / enable / disable / uninstall (`ExtensionAdminOps`). */
-export const EXTENSION_ADMIN_OPS = Symbol("EXTENSION_ADMIN_OPS");
-/** Deployment-level extension config (`ExtensionDeploymentConfigService`). */
-export const EXTENSION_DEPLOYMENT_CONFIGS = Symbol("EXTENSION_DEPLOYMENT_CONFIGS");
-/** The enterprise catalog (`CatalogService`). */
-export const CATALOG = Symbol("CATALOG");
-/** Plugin (app bundle) import: prepare / confirm and staging cleanup (`PluginImport`). */
-export const PLUGIN_IMPORT = Symbol("PLUGIN_IMPORT");
-/** Marketplaces (`MarketplacesService`). */
-export const MARKETPLACES = Symbol("MARKETPLACES");
-/** Organizations browse and install from the enterprise catalog (`OrgCatalogService`). */
-export const ORG_CATALOG = Symbol("ORG_CATALOG");
-/** Catalog requests and approvals (`CatalogRequestsService`). */
-export const CATALOG_REQUESTS = Symbol("CATALOG_REQUESTS");
-/** Org install and uninstall of plugins (app bundles) (`PluginInstaller`). */
-export const PLUGIN_INSTALLER = Symbol("PLUGIN_INSTALLER");

package/dist/http/zod.pipe.d.ts

@@ -1,8 +0,0 @@
-import type { PipeTransform } from "@nestjs/common";
-import type { z } from "zod";
-/** 用 Zod schema 校验请求参数（通常是 body）；失败抛 `validation_failed`，details 逐条给出路径与原因。 */
-export declare class ZodPipe<S extends z.ZodType> implements PipeTransform<unknown, z.infer<S>> {
-    private readonly schema;
-    constructor(schema: S);
-    transform(value: unknown): z.infer<S>;
-}

package/dist/http/zod.pipe.js

@@ -1,14 +0,0 @@
-import { ApiError } from "../errors.js";
-/** 用 Zod schema 校验请求参数（通常是 body）；失败抛 `validation_failed`，details 逐条给出路径与原因。 */
-export class ZodPipe {
-    schema;
-    constructor(schema) {
-        this.schema = schema;
-    }
-    transform(value) {
-        const r = this.schema.safeParse(value);
-        if (r.success)
-            return r.data;
-        throw new ApiError("validation_failed", "Request validation failed", r.error.issues.map((i) => ({ path: i.path.map(String).join("."), message: i.message })));
-    }
-}

package/dist/identity/rate-limit.d.ts

@@ -1,55 +0,0 @@
-import type { Redis } from "ioredis";
-/** 计数窗口（秒）：首次尝试起算，窗口内累计。 */
-export declare const LOGIN_FAIL_WINDOW_SECONDS = 900;
-/** 同一（登录名, 客户端 IP）在窗口内允许的尝试次数（成功登录会清零）。 */
-export declare const LOGIN_FAIL_LIMIT_PER_LOGIN_IP = 10;
-/** 同一客户端 IP 在窗口内允许的尝试次数（跨登录名，防撞库；成功登录退还一次）。 */
-export declare const LOGIN_FAIL_LIMIT_PER_IP = 50;
-/** 同一登录名在窗口内跨所有 IP 允许的尝试次数（防分布式爆破单个账号；成功登录会清零）。 */
-export declare const LOGIN_FAIL_LIMIT_PER_LOGIN = 100;
-export type RateLimitResult = {
-    allowed: true;
-} | {
-    allowed: false;
-    retryAfterSeconds: number;
-};
-/** 登录计数键。 */
-export declare const loginFailKey: {
-    /** （登录名, IP）：阈值 10。 */
-    loginIp: (login: string, ip: string) => string;
-    /** 客户端 IP（跨登录名）：阈值 50。 */
-    ip: (ip: string) => string;
-    /** 单登录名全局（跨 IP）：阈值 100。 */
-    login: (login: string) => string;
-};
-/** 其他凭据核对接口（改密码 `acct`、初始化令牌 `setup`、接受邀请 `inv`）的计数键，与登录的额度分开。 */
-export declare const scopedKey: {
-    key: (scope: string, key: string) => string;
-    ip: (scope: string, ip: string) => string;
-};
-/**
- * 凭据尝试限流，计数在 Redis 中、所有副本共享，窗口 900s。
- *
- * 登录（`reserve`）按三个键计数，任一超限即拒绝：
- * - （登录名, IP）10 次——攻击者从一个 IP 打满某登录名的额度，不影响本人从别的 IP 登录（R25）；
- * - 客户端 IP 50 次（跨登录名，防撞库）；
- * - 单登录名 100 次（跨 IP，防分布式爆破）。
- * 校验密码**之前**先原子地占用一次尝试，并发请求也无法绕过上限；登录成功后 `succeeded`
- * 清掉该登录名的两个计数并退还一次 IP 额度（成功登录不消耗 IP 预算）。
- *
- * `reserveScoped` 供其他核对凭据的接口复用：按 `(scope, key)`（上限 `limit`）与 scope 内的 IP
- * （上限 `ipLimit`，默认同登录的 50）两个键计数；IP 计数与登录的 IP 额度分开
- * （改密码失败不会挤占同 NAT 下他人的登录额度）。
- *
- * 被拒绝的尝试不递增任何计数（攻击者在一个维度上被拒后，无法继续推高其他维度的计数），窗口到期自然清零。
- */
-export declare class LoginRateLimiter {
-    private readonly redis;
-    constructor(redis: Redis);
-    reserve(login: string, ip: string): Promise<RateLimitResult>;
-    succeeded(login: string, ip: string): Promise<void>;
-    reserveScoped(scope: string, key: string, ip: string, limit: number, ipLimit?: number): Promise<RateLimitResult>;
-    /** 核对成功：删 `(scope, key)` 计数，scope 内 IP 计数减一。 */
-    succeededScoped(scope: string, key: string, ip: string): Promise<void>;
-    private reserveKeys;
-}

package/dist/identity/rate-limit.js

@@ -1,121 +0,0 @@
-import { createHash } from "node:crypto";
-/** 计数窗口（秒）：首次尝试起算，窗口内累计。 */
-export const LOGIN_FAIL_WINDOW_SECONDS = 900;
-/** 同一（登录名, 客户端 IP）在窗口内允许的尝试次数（成功登录会清零）。 */
-export const LOGIN_FAIL_LIMIT_PER_LOGIN_IP = 10;
-/** 同一客户端 IP 在窗口内允许的尝试次数（跨登录名，防撞库；成功登录退还一次）。 */
-export const LOGIN_FAIL_LIMIT_PER_IP = 50;
-/** 同一登录名在窗口内跨所有 IP 允许的尝试次数（防分布式爆破单个账号；成功登录会清零）。 */
-export const LOGIN_FAIL_LIMIT_PER_LOGIN = 100;
-/**
- * 原子地「先查后增」：ARGV[1] 为窗口秒数，ARGV[i + 1] 为 KEYS[i] 的上限。
- * 先读全部计数，任一已达上限即拒绝，且**不递增任何键**（被拒绝的尝试不消耗其他计数，
- * 否则从一个 IP 被拒的请求会继续推高单登录名全局计数，把本人从别的 IP 也锁住）；
- * 都未达上限才逐个 INCR，并在首次计数或键没有 TTL 时设 EXPIRE（保证计数键一定带 TTL）。
- * 返回 `{1}`（放行）或 `{0, retryTtl}`（拒绝；retryTtl 为已达上限的键中最大的剩余 TTL）。
- */
-const RESERVE = `
-local retry = -1
-for i, key in ipairs(KEYS) do
-  local n = tonumber(redis.call('GET', key) or '0')
-  if n >= tonumber(ARGV[i + 1]) then
-    local ttl = redis.call('TTL', key)
-    if ttl > retry then retry = ttl end
-    if retry < 1 then retry = 1 end
-  end
-end
-if retry > 0 then
-  return {0, retry}
-end
-for i, key in ipairs(KEYS) do
-  local n = redis.call('INCR', key)
-  if n == 1 or redis.call('TTL', key) < 0 then
-    redis.call('EXPIRE', key, ARGV[1])
-  end
-end
-return {1}
-`;
-/**
- * 删除除最后一个之外的全部键；最后一个（IP 计数）存在时减一，减到 0 及以下即删除
- * （不会凭空建出无 TTL 的负数键）。
- */
-const SUCCEEDED = `
-for i = 1, #KEYS - 1 do
-  redis.call('DEL', KEYS[i])
-end
-local ip = KEYS[#KEYS]
-if redis.call('EXISTS', ip) == 1 then
-  if redis.call('DECR', ip) <= 0 then
-    redis.call('DEL', ip)
-  end
-end
-return 0
-`;
-const sha256 = (s) => createHash("sha256").update(s).digest("hex");
-/** 登录名按与本地账号相同的方式粗规范化（不校验格式），使大小写 / 空白变体共用计数。 */
-const loginHash = (login) => sha256(login.normalize("NFKC").trim().toLowerCase());
-/** 登录计数键。 */
-export const loginFailKey = {
-    /** （登录名, IP）：阈值 10。 */
-    loginIp: (login, ip) => `capk:login-fail:li:${loginHash(login)}:${sha256(ip)}`,
-    /** 客户端 IP（跨登录名）：阈值 50。 */
-    ip: (ip) => `capk:login-fail:ip:${ip}`,
-    /** 单登录名全局（跨 IP）：阈值 100。 */
-    login: (login) => `capk:login-fail:l:${loginHash(login)}`,
-};
-/** 其他凭据核对接口（改密码 `acct`、初始化令牌 `setup`、接受邀请 `inv`）的计数键，与登录的额度分开。 */
-export const scopedKey = {
-    key: (scope, key) => `capk:rl:${scope}:k:${sha256(key)}`,
-    ip: (scope, ip) => `capk:rl:${scope}:ip:${ip}`,
-};
-/**
- * 凭据尝试限流，计数在 Redis 中、所有副本共享，窗口 900s。
- *
- * 登录（`reserve`）按三个键计数，任一超限即拒绝：
- * - （登录名, IP）10 次——攻击者从一个 IP 打满某登录名的额度，不影响本人从别的 IP 登录（R25）；
- * - 客户端 IP 50 次（跨登录名，防撞库）；
- * - 单登录名 100 次（跨 IP，防分布式爆破）。
- * 校验密码**之前**先原子地占用一次尝试，并发请求也无法绕过上限；登录成功后 `succeeded`
- * 清掉该登录名的两个计数并退还一次 IP 额度（成功登录不消耗 IP 预算）。
- *
- * `reserveScoped` 供其他核对凭据的接口复用：按 `(scope, key)`（上限 `limit`）与 scope 内的 IP
- * （上限 `ipLimit`，默认同登录的 50）两个键计数；IP 计数与登录的 IP 额度分开
- * （改密码失败不会挤占同 NAT 下他人的登录额度）。
- *
- * 被拒绝的尝试不递增任何计数（攻击者在一个维度上被拒后，无法继续推高其他维度的计数），窗口到期自然清零。
- */
-export class LoginRateLimiter {
-    redis;
-    constructor(redis) {
-        this.redis = redis;
-    }
-    async reserve(login, ip) {
-        return this.reserveKeys([
-            [loginFailKey.loginIp(login, ip), LOGIN_FAIL_LIMIT_PER_LOGIN_IP],
-            [loginFailKey.ip(ip), LOGIN_FAIL_LIMIT_PER_IP],
-            [loginFailKey.login(login), LOGIN_FAIL_LIMIT_PER_LOGIN],
-        ]);
-    }
-    async succeeded(login, ip) {
-        await this.redis.eval(SUCCEEDED, 3, loginFailKey.loginIp(login, ip), loginFailKey.login(login), loginFailKey.ip(ip));
-    }
-    async reserveScoped(scope, key, ip, limit, ipLimit = LOGIN_FAIL_LIMIT_PER_IP) {
-        return this.reserveKeys([
-            [scopedKey.key(scope, key), limit],
-            [scopedKey.ip(scope, ip), ipLimit],
-        ]);
-    }
-    /** 核对成功：删 `(scope, key)` 计数，scope 内 IP 计数减一。 */
-    async succeededScoped(scope, key, ip) {
-        await this.redis.eval(SUCCEEDED, 2, scopedKey.key(scope, key), scopedKey.ip(scope, ip));
-    }
-    async reserveKeys(keys) {
-        const out = (await this.redis.eval(RESERVE, keys.length, ...keys.map(([k]) => k), LOGIN_FAIL_WINDOW_SECONDS, ...keys.map(([, limit]) => limit)));
-        if (out[0] === 1)
-            return { allowed: true };
-        return { allowed: false, retryAfterSeconds: clampTtl(out[1] ?? LOGIN_FAIL_WINDOW_SECONDS) };
-    }
-}
-function clampTtl(ttl) {
-    return Math.min(Math.max(ttl, 1), LOGIN_FAIL_WINDOW_SECONDS);
-}

package/dist/sandbox/lifecycle.d.ts

@@ -1,21 +0,0 @@
-import type { Logger } from "@capybara-hq/plugin-sdk";
-import type { Maintenance } from "../runtime/maintenance.js";
-import type { SandboxService } from "./sandbox.service.js";
-/** 空闲休眠扫描：任务名、job scheduler id（不含 `:`）与周期。 */
-export declare const SANDBOX_SUSPEND_JOB = "sandbox-suspend-idle";
-export declare const SANDBOX_SUSPEND_SCHEDULER_ID = "sandbox-suspend-idle-every-minute";
-export declare const SANDBOX_SUSPEND_EVERY_MS = 60000;
-/** 不活跃销毁扫描：任务名、job scheduler id（不含 `:`）与周期。 */
-export declare const SANDBOX_DESTROY_JOB = "sandbox-destroy-inactive";
-export declare const SANDBOX_DESTROY_SCHEDULER_ID = "sandbox-destroy-inactive-hourly";
-export declare const SANDBOX_DESTROY_EVERY_MS = 3600000;
-/** 一次性任务：立即销毁一批对话的沙箱（成员离职后投递，数据 `{ conversationIds }`）。 */
-export declare const SANDBOX_DESTROY_FOR_JOB = "sandbox-destroy-for";
-/** 投递 {@link SANDBOX_DESTROY_FOR_JOB}：失败的整批重试（已销毁的再调一次什么也不做）。 */
-export declare function scheduleSandboxDestroy(maintenance: Pick<Maintenance, "add">, conversationIds: string[]): Promise<void>;
-/**
- * 在维护队列（`cap-kernel-maintenance`）登记沙箱的两个周期任务（worker 角色执行）：
- * 每分钟休眠空闲 / 连续运行超时的沙箱，每小时销毁不活跃、组织已删除或对话已删除的沙箱。
- * 没有沙箱提供方时两个任务什么也不做。另登记一次性任务 {@link SANDBOX_DESTROY_FOR_JOB}（成员离职）。
- */
-export declare function registerSandboxMaintenance(maintenance: Maintenance, sandbox: SandboxService, log: Pick<Logger, "info" | "warn">): void;

package/dist/sandbox/lifecycle.js

@@ -1,68 +0,0 @@
-/** 空闲休眠扫描：任务名、job scheduler id（不含 `:`）与周期。 */
-export const SANDBOX_SUSPEND_JOB = "sandbox-suspend-idle";
-export const SANDBOX_SUSPEND_SCHEDULER_ID = "sandbox-suspend-idle-every-minute";
-export const SANDBOX_SUSPEND_EVERY_MS = 60_000;
-/** 不活跃销毁扫描：任务名、job scheduler id（不含 `:`）与周期。 */
-export const SANDBOX_DESTROY_JOB = "sandbox-destroy-inactive";
-export const SANDBOX_DESTROY_SCHEDULER_ID = "sandbox-destroy-inactive-hourly";
-export const SANDBOX_DESTROY_EVERY_MS = 3_600_000;
-/** 一次性任务：立即销毁一批对话的沙箱（成员离职后投递，数据 `{ conversationIds }`）。 */
-export const SANDBOX_DESTROY_FOR_JOB = "sandbox-destroy-for";
-/** 投递 {@link SANDBOX_DESTROY_FOR_JOB}：失败的整批重试（已销毁的再调一次什么也不做）。 */
-export async function scheduleSandboxDestroy(maintenance, conversationIds) {
-    await maintenance.add(SANDBOX_DESTROY_FOR_JOB, { conversationIds }, {
-        attempts: 5,
-        backoff: { type: "exponential", delay: 30_000 },
-        removeOnComplete: true,
-        removeOnFail: 100,
-    });
-}
-/**
- * 在维护队列（`cap-kernel-maintenance`）登记沙箱的两个周期任务（worker 角色执行）：
- * 每分钟休眠空闲 / 连续运行超时的沙箱，每小时销毁不活跃、组织已删除或对话已删除的沙箱。
- * 没有沙箱提供方时两个任务什么也不做。另登记一次性任务 {@link SANDBOX_DESTROY_FOR_JOB}（成员离职）。
- */
-export function registerSandboxMaintenance(maintenance, sandbox, log) {
-    maintenance.handle(SANDBOX_DESTROY_FOR_JOB, async (job) => {
-        const ids = job.data.conversationIds;
-        if (!Array.isArray(ids))
-            return;
-        let failed = 0;
-        for (const id of ids) {
-            if (typeof id !== "string")
-                continue;
-            try {
-                await sandbox.destroyFor(id);
-            }
-            catch (err) {
-                failed++;
-                log.warn("cannot destroy sandbox of an offboarded member; will retry", {
-                    conversationId: id,
-                    err,
-                });
-            }
-        }
-        if (failed > 0)
-            throw new Error(`${failed} of ${ids.length} sandboxes could not be destroyed`);
-    });
-    maintenance.handle(SANDBOX_SUSPEND_JOB, async () => {
-        const n = await sandbox.suspendIdle(new Date());
-        if (n > 0)
-            log.info("idle sandboxes suspended", { count: n });
-    });
-    maintenance.schedule({
-        id: SANDBOX_SUSPEND_SCHEDULER_ID,
-        name: SANDBOX_SUSPEND_JOB,
-        everyMs: () => SANDBOX_SUSPEND_EVERY_MS,
-    });
-    maintenance.handle(SANDBOX_DESTROY_JOB, async () => {
-        const n = await sandbox.destroyInactive(new Date());
-        if (n > 0)
-            log.info("inactive sandboxes destroyed", { count: n });
-    });
-    maintenance.schedule({
-        id: SANDBOX_DESTROY_SCHEDULER_ID,
-        name: SANDBOX_DESTROY_JOB,
-        everyMs: () => SANDBOX_DESTROY_EVERY_MS,
-    });
-}