@gt-fe/eap-runtime 0.0.8

package/dist/token/context-window-budget.js

@@ -0,0 +1,134 @@
+/**
+ * ContextWindowBudget — 上下文窗口预算分配
+ *
+ * 管理上下文窗口的 Token 分配，防止单一来源占满上下文。
+ * 支持配置历史消息、RAG 结果、Tool Schema 各占上下文窗口的比例上限。
+ *
+ * @see requirements.md Requirement 12.5
+ * @see token/token-budget.service.ts Token Budget 控制
+ */
+/**
+ * 默认上下文窗口预算配置
+ */
+export const DEFAULT_CONTEXT_BUDGET_CONFIG = {
+    totalTokens: 128000,
+    sourceRatios: {
+        history: 0.5, // 历史消息最多占 50%
+        rag: 0.2, // RAG 结果最多占 20%
+        tools: 0.1, // Tool Schema 最多占 10%
+        system: 0.1, // 系统提示最多占 10%
+        memory: 0.1, // 长期记忆最多占 10%
+    },
+    outputReserve: 0.2, // 预留 20% 给模型输出
+};
+// ─────────────────────────────────────────────
+// ContextWindowBudget 服务
+// ─────────────────────────────────────────────
+/**
+ * ContextWindowBudget — 上下文窗口预算管理
+ */
+export class ContextWindowBudget {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONTEXT_BUDGET_CONFIG, ...config };
+    }
+    /**
+     * 获取指定来源的 Token 上限
+     *
+     * @param source - 来源类型
+     * @returns Token 上限
+     */
+    getMaxTokens(source) {
+        const ratio = this.config.sourceRatios[source] ?? 0;
+        return Math.floor(this.config.totalTokens * ratio);
+    }
+    /**
+     * 检查指定来源是否超限
+     *
+     * @param source - 来源类型
+     * @param usedTokens - 已使用的 Token 数
+     * @returns 是否超限
+     */
+    isExceeded(source, usedTokens) {
+        const maxTokens = this.getMaxTokens(source);
+        return usedTokens > maxTokens;
+    }
+    /**
+     * 计算预算分配
+     *
+     * @param usage - 各来源的已使用 Token 数
+     * @returns 预算分配结果
+     */
+    calculateAllocation(usage) {
+        const availableTokens = Math.floor(this.config.totalTokens * (1 - this.config.outputReserve));
+        const sources = [];
+        const exceededSources = [];
+        for (const source of Object.keys(this.config.sourceRatios)) {
+            const maxTokens = this.getMaxTokens(source);
+            const usedTokens = usage[source] ?? 0;
+            const remainingTokens = Math.max(0, maxTokens - usedTokens);
+            const usageRatio = maxTokens > 0 ? usedTokens / maxTokens : 0;
+            sources.push({
+                source,
+                maxTokens,
+                usedTokens,
+                remainingTokens,
+                usageRatio,
+            });
+            if (usedTokens > maxTokens) {
+                exceededSources.push(source);
+            }
+        }
+        return {
+            totalTokens: this.config.totalTokens,
+            availableTokens,
+            sources,
+            isExceeded: exceededSources.length > 0,
+            exceededSources,
+        };
+    }
+    /**
+     * 裁剪消息以符合预算
+     *
+     * 如果历史消息超出预算，从前面开始删除旧消息。
+     *
+     * @param messages - 原始消息列表
+     * @param maxTokens - Token 上限
+     * @param estimateFn - Token 估算函数
+     * @returns 裁剪后的消息列表
+     */
+    trimMessages(messages, maxTokens, estimateFn) {
+        const currentTokens = estimateFn(messages);
+        if (currentTokens <= maxTokens) {
+            return messages;
+        }
+        // 从前面开始删除旧消息
+        let trimmed = [...messages];
+        while (trimmed.length > 1 && estimateFn(trimmed) > maxTokens) {
+            trimmed.shift();
+        }
+        return trimmed;
+    }
+    /**
+     * 获取配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+// ─────────────────────────────────────────────
+// 工厂函数
+// ─────────────────────────────────────────────
+/**
+ * 创建上下文窗口预算实例
+ *
+ * @param modelContextWindow - 模型的 context window 大小
+ * @param config - 可选的自定义配置
+ * @returns ContextWindowBudget 实例
+ */
+export function createContextBudget(modelContextWindow, config) {
+    return new ContextWindowBudget({
+        ...config,
+        totalTokens: modelContextWindow,
+    });
+}

package/dist/token/contracts/index.d.ts

@@ -0,0 +1 @@
+export type { ITokenBudgetService, BudgetScope, BudgetPeriod, BudgetCheckResult, } from './token-budget.contract.js';

package/dist/token/contracts/index.js

@@ -0,0 +1 @@
+export {};

package/dist/token/contracts/token-budget.contract.d.ts

@@ -0,0 +1,77 @@
+/**
+ * ITokenBudgetService — Token 配额控制服务接口
+ *
+ * 定义三级配额体系：per-Task 上限 / per-Session 日预算 / per-Agent 单次 cap。
+ * 每次 LLM/Tool 调用后累加 Token 消耗并检查配额，超限时立即终止 Graph，
+ * Task 标记 token_exhausted。
+ *
+ * @see design.md §1.3 token_budgets 数据模型
+ * @see requirements.md Requirement 12 AC1-AC3
+ */
+/**
+ * BudgetScope — 配额作用域
+ *
+ * - task: 单次 Task 执行的 Token 上限
+ * - session: 会话级日预算（daily）
+ * - agent: 单次 Agent 执行 cap
+ */
+export type BudgetScope = 'task' | 'session' | 'agent';
+/**
+ * BudgetPeriod — 配额周期
+ *
+ * - daily: 每日重置
+ * - per-execution: 每次执行独立计算
+ */
+export type BudgetPeriod = 'daily' | 'per-execution';
+/**
+ * BudgetCheckResult — 配额检查结果
+ *
+ * 调用 check() 返回当前配额状态，包含配额上限、已消耗、剩余量和是否耗尽。
+ */
+export interface BudgetCheckResult {
+    /** 配额上限 */
+    quota: number;
+    /** 已消耗 Token 数 */
+    consumed: number;
+    /** 剩余可用 Token 数 */
+    remaining: number;
+    /** 是否已耗尽（consumed >= quota） */
+    isExhausted: boolean;
+    /** 配额周期 */
+    period: BudgetPeriod;
+}
+/**
+ * ITokenBudgetService — Token 配额控制接口
+ *
+ * 负责三级配额的检查、消耗和耗尽判断。
+ * 由 TokenBudgetService 实现，贯穿 Graph 执行全过程。
+ */
+export interface ITokenBudgetService {
+    /**
+     * 检查指定 scope 的当前配额状态
+     *
+     * @param scope - 配额作用域（task/session/agent）
+     * @param scopeId - 对应作用域的实体 ID（taskId/sessionId/agentId）
+     * @returns 配额检查结果（含 quota、consumed、remaining、isExhausted、period）
+     */
+    check(scope: BudgetScope, scopeId: string): Promise<BudgetCheckResult>;
+    /**
+     * 消耗指定 scope 的 Token 配额
+     *
+     * 每次 LLM/Tool 调用后调用此方法累加消耗。
+     * 若消耗后超出配额，应由调用方触发 Graph 终止流程。
+     *
+     * @param scope - 配额作用域
+     * @param scopeId - 对应作用域的实体 ID
+     * @param amount - 本次消耗的 Token 数量
+     */
+    consume(scope: BudgetScope, scopeId: string, amount: number): Promise<void>;
+    /**
+     * 判断指定 scope 的配额是否已耗尽
+     *
+     * @param scope - 配额作用域
+     * @param scopeId - 对应作用域的实体 ID
+     * @returns true 表示配额已耗尽，应终止执行
+     */
+    isExhausted(scope: BudgetScope, scopeId: string): Promise<boolean>;
+}

package/dist/token/contracts/token-budget.contract.js

@@ -0,0 +1,11 @@
+/**
+ * ITokenBudgetService — Token 配额控制服务接口
+ *
+ * 定义三级配额体系：per-Task 上限 / per-Session 日预算 / per-Agent 单次 cap。
+ * 每次 LLM/Tool 调用后累加 Token 消耗并检查配额，超限时立即终止 Graph，
+ * Task 标记 token_exhausted。
+ *
+ * @see design.md §1.3 token_budgets 数据模型
+ * @see requirements.md Requirement 12 AC1-AC3
+ */
+export {};

package/dist/token/index.d.ts

@@ -0,0 +1,12 @@
+export type { ITokenBudgetService, BudgetScope, BudgetPeriod, BudgetCheckResult, } from './contracts/index.js';
+export type { BudgetRecord, ITokenBudgetRepository, TokenBudgetServiceOptions, } from './token-budget.service.js';
+export { InMemoryTokenBudgetRepository, TokenBudgetService, } from './token-budget.service.js';
+export { PostgresTokenBudgetRepository } from './pg-token-budget.repository.js';
+export { TokenBudgetGuard, TokenBudgetExhaustedError, } from './token-budget-guard.js';
+export { SessionBudgetChecker, SessionBudgetExhaustedError, } from './session-budget-checker.js';
+export type { NodeTokenUsage, TokenBreakdown, TaskTokenSummary, } from './token-stats.service.js';
+export { TokenStatsService } from './token-stats.service.js';
+export type { TokenDetailMode } from './token-detail-mode.js';
+export { TokenStatsEmitter } from './token-detail-mode.js';
+export { ContextWindowBudget, createContextBudget, type ContextWindowBudgetConfig, type ContextSource, type SourceAllocation, type BudgetAllocation, DEFAULT_CONTEXT_BUDGET_CONFIG, } from './context-window-budget.js';
+export { CharBasedTokenEstimator, ModelBasedTokenEstimator, createTokenEstimator, type ITokenEstimator, } from './token-estimator.js';

package/dist/token/index.js

@@ -0,0 +1,10 @@
+export { InMemoryTokenBudgetRepository, TokenBudgetService, } from './token-budget.service.js';
+export { PostgresTokenBudgetRepository } from './pg-token-budget.repository.js';
+export { TokenBudgetGuard, TokenBudgetExhaustedError, } from './token-budget-guard.js';
+export { SessionBudgetChecker, SessionBudgetExhaustedError, } from './session-budget-checker.js';
+export { TokenStatsService } from './token-stats.service.js';
+export { TokenStatsEmitter } from './token-detail-mode.js';
+// 上下文窗口预算分配
+export { ContextWindowBudget, createContextBudget, DEFAULT_CONTEXT_BUDGET_CONFIG, } from './context-window-budget.js';
+// Token 估算器
+export { CharBasedTokenEstimator, ModelBasedTokenEstimator, createTokenEstimator, } from './token-estimator.js';

package/dist/token/pg-token-budget.repository.d.ts

@@ -0,0 +1,39 @@
+/**
+ * PostgresTokenBudgetRepository — Token 配额持久化 PostgreSQL 实现
+ *
+ * 基于 pg 连接池实现 ITokenBudgetRepository 接口。
+ * getOrCreate 采用 SELECT + INSERT 模式，update 仅更新 consumed/status/updated_at。
+ * 支持审计字段和软删除。
+ *
+ * @see design.md §1.3 数据模型 — token_budgets 表
+ * @see token-budget.service.ts ITokenBudgetRepository 接口定义
+ */
+import type { BudgetScope, BudgetPeriod } from './contracts/index.js';
+import type { BudgetRecord, ITokenBudgetRepository } from './token-budget.service.js';
+/** pg Pool 抽象接口 */
+export interface IPgPool {
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<{
+        rows: T[];
+    }>;
+}
+export declare class PostgresTokenBudgetRepository implements ITokenBudgetRepository {
+    private readonly pool;
+    constructor(pool: IPgPool);
+    /**
+     * SELECT by scope + scopeId; if not found, INSERT with defaults and return.
+     * Excludes soft-deleted records
+     */
+    getOrCreate(scope: BudgetScope, scopeId: string, defaultQuota: number, period: BudgetPeriod): Promise<BudgetRecord>;
+    /**
+     * UPDATE consumed, status, updated_by, updated_at WHERE id = ?
+     */
+    update(record: BudgetRecord): Promise<void>;
+    /**
+     * Soft delete budget record
+     */
+    softDelete(id: string, deletedBy: string): Promise<void>;
+    /**
+     * 将 PostgreSQL 行数据转换为 BudgetRecord
+     */
+    private rowToRecord;
+}

package/dist/token/pg-token-budget.repository.js

@@ -0,0 +1,116 @@
+/**
+ * PostgresTokenBudgetRepository — Token 配额持久化 PostgreSQL 实现
+ *
+ * 基于 pg 连接池实现 ITokenBudgetRepository 接口。
+ * getOrCreate 采用 SELECT + INSERT 模式，update 仅更新 consumed/status/updated_at。
+ * 支持审计字段和软删除。
+ *
+ * @see design.md §1.3 数据模型 — token_budgets 表
+ * @see token-budget.service.ts ITokenBudgetRepository 接口定义
+ */
+// ─────────────────────────────────────────────
+// PostgresTokenBudgetRepository
+// ─────────────────────────────────────────────
+export class PostgresTokenBudgetRepository {
+    pool;
+    constructor(pool) {
+        this.pool = pool;
+    }
+    /**
+     * SELECT by scope + scopeId; if not found, INSERT with defaults and return.
+     * Excludes soft-deleted records
+     */
+    async getOrCreate(scope, scopeId, defaultQuota, period) {
+        const selectSql = `SELECT * FROM token_budgets WHERE scope = $1 AND scope_id = $2 AND is_deleted = FALSE`;
+        const { rows } = await this.pool.query(selectSql, [scope, scopeId]);
+        if (rows.length > 0) {
+            return this.rowToRecord(rows[0]);
+        }
+        // Not found — insert new record
+        const now = new Date();
+        const id = `budget_${scope}_${scopeId}_${now.getTime()}`;
+        const insertSql = `
+      INSERT INTO token_budgets (id, scope, scope_id, quota, consumed, period, status, created_by, created_at, updated_by, updated_at)
+      VALUES ($1, $2, $3, $4, 0, $5, 'active', $6, $7, $8, $9)
+    `;
+        await this.pool.query(insertSql, [
+            id,
+            scope,
+            scopeId,
+            defaultQuota,
+            period,
+            'system',
+            now,
+            'system',
+            now,
+        ]);
+        return {
+            id,
+            scope,
+            scopeId,
+            quota: defaultQuota,
+            consumed: 0,
+            period,
+            status: 'active',
+            createdBy: 'system',
+            createdAt: now.toISOString(),
+            updatedBy: 'system',
+            updatedAt: now.toISOString(),
+            isDeleted: false,
+        };
+    }
+    /**
+     * UPDATE consumed, status, updated_by, updated_at WHERE id = ?
+     */
+    async update(record) {
+        const sql = `
+      UPDATE token_budgets
+      SET consumed = $1, status = $2, updated_by = $3, updated_at = $4
+      WHERE id = $5 AND is_deleted = FALSE
+    `;
+        const now = new Date();
+        record.updatedAt = now.toISOString();
+        await this.pool.query(sql, [
+            record.consumed,
+            record.status,
+            record.updatedBy || 'system',
+            now,
+            record.id,
+        ]);
+    }
+    /**
+     * Soft delete budget record
+     */
+    async softDelete(id, deletedBy) {
+        const sql = `
+      UPDATE token_budgets
+      SET is_deleted = TRUE, deleted_by = $1, deleted_at = NOW()
+      WHERE id = $2 AND is_deleted = FALSE
+    `;
+        await this.pool.query(sql, [deletedBy, id]);
+    }
+    // ─────────────────────────────────────────────
+    // Private Helpers
+    // ─────────────────────────────────────────────
+    /**
+     * 将 PostgreSQL 行数据转换为 BudgetRecord
+     */
+    rowToRecord(row) {
+        return {
+            id: row.id,
+            scope: row.scope,
+            scopeId: row.scope_id,
+            quota: row.quota,
+            consumed: row.consumed,
+            period: row.period,
+            status: row.status,
+            createdBy: row.created_by,
+            createdAt: row.created_at.toISOString(),
+            updatedBy: row.updated_by,
+            updatedAt: row.updated_at.toISOString(),
+            isDeleted: row.is_deleted,
+            deletedBy: row.deleted_by,
+            deletedAt: row.deleted_at?.toISOString(),
+        };
+    }
+}

package/dist/token/session-budget-checker.d.ts

@@ -0,0 +1,54 @@
+/**
+ * SessionBudgetChecker — Session 级每日 Token 预算前置检查
+ *
+ * 在创建新 Task 前调用，检查该 Session 的每日 Token 预算是否已耗尽。
+ * 若已耗尽，抛出 SessionBudgetExhaustedError，拒绝新请求。
+ *
+ * 与 TokenBudgetGuard 的区别：
+ * - TokenBudgetGuard: 每次 LLM/Tool 调用后检查，超限终止当前 Graph
+ * - SessionBudgetChecker: 新请求入口前检查，超限直接拒绝（不创建 Task）
+ *
+ * @see design.md §1.2 per-Session日预算 → 超限则拒绝后续请求
+ * @see requirements.md Requirement 12 AC3
+ */
+import type { ITokenBudgetService } from './contracts/index.js';
+/**
+ * SessionBudgetExhaustedError — 当 Session 的每日 Token 配额已用完时抛出
+ *
+ * API 层捕获此错误后应返回明确的拒绝响应，提示用户次日再试或联系管理员。
+ */
+export declare class SessionBudgetExhaustedError extends Error {
+    /** Session ID */
+    readonly sessionId: string;
+    /** 已消耗 Token 数 */
+    readonly consumed: number;
+    /** 配额上限 */
+    readonly quota: number;
+    constructor(sessionId: string, consumed: number, quota: number);
+}
+/**
+ * SessionBudgetChecker — 在新请求入口（Task 创建前）执行 Session 日预算检查
+ *
+ * @example
+ * ```ts
+ * const checker = new SessionBudgetChecker(budgetService);
+ *
+ * // 在 API handler 中，创建 Task 前调用
+ * await checker.assertBudgetAvailable(sessionId);
+ * // 若未抛出异常，表示预算充足，可继续创建 Task
+ * ```
+ */
+export declare class SessionBudgetChecker {
+    private readonly budgetService;
+    constructor(budgetService: ITokenBudgetService);
+    /**
+     * 断言 Session 的每日 Token 预算仍有余量
+     *
+     * 若预算已耗尽，抛出 SessionBudgetExhaustedError。
+     * 调用方应在创建新 Task 之前调用此方法。
+     *
+     * @param sessionId - 待检查的 Session ID
+     * @throws {SessionBudgetExhaustedError} 当 Session 每日预算已耗尽时
+     */
+    assertBudgetAvailable(sessionId: string): Promise<void>;
+}

package/dist/token/session-budget-checker.js

@@ -0,0 +1,72 @@
+/**
+ * SessionBudgetChecker — Session 级每日 Token 预算前置检查
+ *
+ * 在创建新 Task 前调用，检查该 Session 的每日 Token 预算是否已耗尽。
+ * 若已耗尽，抛出 SessionBudgetExhaustedError，拒绝新请求。
+ *
+ * 与 TokenBudgetGuard 的区别：
+ * - TokenBudgetGuard: 每次 LLM/Tool 调用后检查，超限终止当前 Graph
+ * - SessionBudgetChecker: 新请求入口前检查，超限直接拒绝（不创建 Task）
+ *
+ * @see design.md §1.2 per-Session日预算 → 超限则拒绝后续请求
+ * @see requirements.md Requirement 12 AC3
+ */
+// ─────────────────────────────────────────────
+// SessionBudgetExhaustedError — Session 日预算耗尽错误
+// ─────────────────────────────────────────────
+/**
+ * SessionBudgetExhaustedError — 当 Session 的每日 Token 配额已用完时抛出
+ *
+ * API 层捕获此错误后应返回明确的拒绝响应，提示用户次日再试或联系管理员。
+ */
+export class SessionBudgetExhaustedError extends Error {
+    /** Session ID */
+    sessionId;
+    /** 已消耗 Token 数 */
+    consumed;
+    /** 配额上限 */
+    quota;
+    constructor(sessionId, consumed, quota) {
+        super(`Token预算已耗尽：Session ${sessionId} 的每日Token配额已用完，请明天再试或联系管理员提高配额。`);
+        this.name = 'SessionBudgetExhaustedError';
+        this.sessionId = sessionId;
+        this.consumed = consumed;
+        this.quota = quota;
+    }
+}
+// ─────────────────────────────────────────────
+// SessionBudgetChecker — 前置预算检查器
+// ─────────────────────────────────────────────
+/**
+ * SessionBudgetChecker — 在新请求入口（Task 创建前）执行 Session 日预算检查
+ *
+ * @example
+ * ```ts
+ * const checker = new SessionBudgetChecker(budgetService);
+ *
+ * // 在 API handler 中，创建 Task 前调用
+ * await checker.assertBudgetAvailable(sessionId);
+ * // 若未抛出异常，表示预算充足，可继续创建 Task
+ * ```
+ */
+export class SessionBudgetChecker {
+    budgetService;
+    constructor(budgetService) {
+        this.budgetService = budgetService;
+    }
+    /**
+     * 断言 Session 的每日 Token 预算仍有余量
+     *
+     * 若预算已耗尽，抛出 SessionBudgetExhaustedError。
+     * 调用方应在创建新 Task 之前调用此方法。
+     *
+     * @param sessionId - 待检查的 Session ID
+     * @throws {SessionBudgetExhaustedError} 当 Session 每日预算已耗尽时
+     */
+    async assertBudgetAvailable(sessionId) {
+        const result = await this.budgetService.check('session', sessionId);
+        if (result.isExhausted) {
+            throw new SessionBudgetExhaustedError(sessionId, result.consumed, result.quota);
+        }
+    }
+}

package/dist/token/token-budget-guard.d.ts

@@ -0,0 +1,66 @@
+/**
+ * TokenBudgetGuard — Token 配额守卫
+ *
+ * 在每次 LLM/Tool 调用后执行配额检查：
+ * 1. 累加消耗到 task / session / agent 三级 scope
+ * 2. 检查三级配额是否耗尽
+ * 3. 若任一级耗尽，抛出 TokenBudgetExhaustedError，Graph 执行循环捕获后标记 Task 为 token_exhausted
+ *
+ * @see design.md §1.2 Token Budget检查（贯穿执行过程）
+ * @see requirements.md Requirement 12 AC2
+ */
+import type { BudgetScope, ITokenBudgetService } from './contracts/index.js';
+/**
+ * TokenBudgetExhaustedError — Token 配额耗尽时抛出
+ *
+ * Graph 执行循环应捕获此错误并将 Task 标记为 token_exhausted。
+ */
+export declare class TokenBudgetExhaustedError extends Error {
+    /** 耗尽的配额作用域 */
+    readonly scope: BudgetScope;
+    /** 对应 scope 的实体 ID */
+    readonly scopeId: string;
+    /** 已消耗 Token 数 */
+    readonly consumed: number;
+    /** 配额上限 */
+    readonly quota: number;
+    constructor(scope: BudgetScope, scopeId: string, consumed: number, quota: number);
+}
+/**
+ * TokenBudgetGuard — 每次 LLM/Tool 调用后的配额检查守卫
+ *
+ * 使用方式：在 Graph 执行循环中，每次 LLM/Tool 调用完成后调用 checkAndConsume。
+ * 若配额耗尽，将抛出 TokenBudgetExhaustedError，Graph 循环捕获后终止执行。
+ *
+ * @example
+ * ```ts
+ * const guard = new TokenBudgetGuard(budgetService);
+ * try {
+ *   // ... LLM/Tool 调用 ...
+ *   await guard.checkAndConsume(taskId, sessionId, agentCode, tokensUsed);
+ * } catch (e) {
+ *   if (e instanceof TokenBudgetExhaustedError) {
+ *     await taskService.updateStatus(taskId, 'token_exhausted');
+ *   }
+ * }
+ * ```
+ */
+export declare class TokenBudgetGuard {
+    private readonly budgetService;
+    constructor(budgetService: ITokenBudgetService);
+    /**
+     * 消耗并检查三级配额
+     *
+     * 执行顺序：
+     * 1. 对 task / session / agent 三个 scope 依次调用 consume 累加消耗
+     * 2. 按优先级 task → session → agent 检查是否耗尽
+     * 3. 任一级耗尽即抛出 TokenBudgetExhaustedError
+     *
+     * @param taskId - 当前 Task ID
+     * @param sessionId - 当前 Session ID
+     * @param agentCode - 当前 Agent ID
+     * @param amount - 本次调用消耗的 Token 数量
+     * @throws {TokenBudgetExhaustedError} 当任一级配额耗尽时
+     */
+    checkAndConsume(taskId: string, sessionId: string, agentCode: string, amount: number): Promise<void>;
+}