@bolloon/bolloon-agent 0.3.30 → 0.3.32

package/dist/cli/mention-data.js

@@ -0,0 +1,238 @@
+/**
+ * mention-data.ts — CLI @ / # 弹出窗数据源 (2026-08-05)
+ *
+ * 弹出窗三路命中:
+ *   @ → 智能体 (本地 channels + 远端 channel 缓存)
+ *   / → 命令 (CLI 内置 + Web 斜杠命令) + 技能 (3 个 skill 目录) + 插件 (MCP servers)
+ *   # → 文件 (cwd 有限深度遍历)
+ *
+ * 全部走本地文件读取, 不依赖 web server 是否在跑 (CLI 模式 server 不启动).
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+const HOME = () => process.env.HOME || os.homedir() || '/tmp';
+// ─── 命令 (CLI 内置) ─────────────────────────────────────────────────────────
+const CLI_COMMANDS = [
+    { kind: 'command', label: 'queue', hint: '切换队列模式', insert: 'queue' },
+    { kind: 'command', label: 'dequeue', hint: '出队一条', insert: 'dequeue' },
+    { kind: 'command', label: 'help', hint: '显示帮助', insert: 'help' },
+    { kind: 'command', label: 'exit', hint: '退出', insert: 'exit' },
+    { kind: 'command', label: 'peers', hint: '查看 P2P 节点', insert: 'peers' },
+    { kind: 'command', label: 'iroh', hint: '查看 iroh 状态', insert: 'iroh' },
+    { kind: 'command', label: 'add_friend', hint: '添加好友 <64位hex公钥>', insert: 'add_friend' },
+];
+/** Web 端斜杠命令 (server /message 路由 → LLM 工具) */
+const WEB_COMMANDS = [
+    { kind: 'command', label: 'plan', hint: '创建计划', insert: 'plan' },
+    { kind: 'command', label: 'todo', hint: '勾选步骤', insert: 'todo' },
+    { kind: 'command', label: 'review', hint: '审查计划', insert: 'review' },
+    { kind: 'command', label: 'task', hint: '创建任务', insert: 'task' },
+    { kind: 'command', label: 'goal', hint: '暂停目标', insert: 'goal' },
+    { kind: 'command', label: 'skill', hint: '沉淀技能', insert: 'skill' },
+    { kind: 'command', label: 'add-friend', hint: '添加好友 (智能体工具)', insert: 'add-friend' },
+];
+export function loadCommands() {
+    return [...CLI_COMMANDS, ...WEB_COMMANDS];
+}
+// ─── 智能体 (@) ──────────────────────────────────────────────────────────────
+/** 本地 channels.json (server-types.ts CHANNELS_PATH) + 远端 channel 缓存 */
+export async function loadAgents() {
+    const out = [];
+    // 本地 channels: 优先 ~/.bolloon/sessions/channels.json, 兜底 ~/.bolloon/channels.json
+    const channelsPaths = [
+        path.join(HOME(), '.bolloon', 'sessions', 'channels.json'),
+        path.join(HOME(), '.bolloon', 'channels.json'),
+    ];
+    for (const p of channelsPaths) {
+        try {
+            const chs = JSON.parse(await fs.readFile(p, 'utf-8'));
+            if (Array.isArray(chs)) {
+                for (const c of chs) {
+                    const name = c?.name;
+                    if (typeof name === 'string' && name.trim()) {
+                        out.push({ kind: 'agent', label: name.trim(), hint: '本地智能体', insert: name.trim() });
+                    }
+                }
+                break;
+            }
+        }
+        catch { /* 尝试下一个路径 */ }
+    }
+    // 远端 channel 缓存: { peerPublicKey: Channel[] }
+    try {
+        const remote = JSON.parse(await fs.readFile(path.join(HOME(), '.bolloon', 'remote-channels-cache.json'), 'utf-8'));
+        if (remote && typeof remote === 'object') {
+            for (const [peerPk, channels] of Object.entries(remote)) {
+                if (!Array.isArray(channels))
+                    continue;
+                for (const c of channels) {
+                    const name = c?.name;
+                    if (typeof name === 'string' && name.trim()) {
+                        out.push({ kind: 'agent', label: name.trim(), hint: `远端 · ${peerPk.slice(0, 8)}…`, insert: name.trim() });
+                    }
+                }
+            }
+        }
+    }
+    catch { /* 无远端缓存 */ }
+    // 去重 (本地优先)
+    const seen = new Set();
+    return out.filter(i => {
+        if (seen.has(i.label))
+            return false;
+        seen.add(i.label);
+        return true;
+    });
+}
+// ─── 技能 (/ 弹窗的一部分) ───────────────────────────────────────────────────
+/** 3 个 skill 目录 (与 skill-loader.defaultSkillPaths 一致) */
+export async function loadSkills() {
+    const out = [];
+    const dirs = [
+        path.join(HOME(), '.bolloon', 'skills'),
+        path.join(process.cwd(), '.bolloon', 'skills'),
+        path.join(HOME(), '.boll', 'skills'),
+    ];
+    for (const d of dirs) {
+        let entries;
+        try {
+            entries = await fs.readdir(d, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            if (!e.isDirectory() || e.name.startsWith('.'))
+                continue;
+            // 读 frontmatter description 作为提示 (轻量, 不引 skill-loader 依赖)
+            let desc = '';
+            try {
+                const raw = (await fs.readFile(path.join(d, e.name, 'SKILL.md'), 'utf-8')).slice(0, 800);
+                const m = raw.match(/^---\r?\n[\s\S]*?^description:\s*(.+)$/m);
+                if (m)
+                    desc = m[1].trim().replace(/^["']|["']$/g, '').slice(0, 50);
+            }
+            catch { /* 无 SKILL.md → 仅目录名 */ }
+            out.push({ kind: 'skill', label: e.name, hint: desc || '技能', insert: e.name });
+        }
+    }
+    const seen = new Set();
+    return out.filter(i => {
+        if (seen.has(i.label))
+            return false;
+        seen.add(i.label);
+        return true;
+    });
+}
+// ─── 插件 (/ 弹窗的一部分) — MCP servers ─────────────────────────────────────
+/** ~/.mcp.json / cwd/.mcp.json 的 mcpServers 键名 */
+export async function loadPlugins() {
+    const out = [];
+    const paths = [path.join(HOME(), '.mcp.json'), path.join(process.cwd(), '.mcp.json')];
+    for (const p of paths) {
+        try {
+            const data = JSON.parse(await fs.readFile(p, 'utf-8'));
+            const servers = data?.mcpServers;
+            if (servers && typeof servers === 'object') {
+                for (const name of Object.keys(servers)) {
+                    out.push({ kind: 'plugin', label: name, hint: 'MCP 插件', insert: name });
+                }
+                break;
+            }
+        }
+        catch { /* 下一个路径 */ }
+    }
+    return out;
+}
+// ─── 文件 (#) ────────────────────────────────────────────────────────────────
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', 'out', 'target', '.cache', '.hermes',
+    'coverage', '.next', '.nuxt', '.venv', 'venv', '__pycache__', 'tmp', 'release',
+    '.bolloon', '.boll', '.turbo', '.idea', '.vscode', 'bin', 'lib', 'assets',
+]);
+/** cwd 有限深度 BFS, 只收文件, 上限 cap 个, 排序稳定 */
+export async function loadFiles(_query, base = process.cwd(), maxDepth = 3, cap = 400) {
+    const out = [];
+    const stack = [{ dir: base, depth: 0 }];
+    while (stack.length > 0 && out.length < cap) {
+        const { dir, depth } = stack.pop();
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        // 目录优先入栈, 文件直接收集; 同层排序保证稳定
+        const dirs = [];
+        for (const e of entries) {
+            if (out.length >= cap)
+                break;
+            if (e.name.startsWith('.'))
+                continue;
+            const full = path.join(dir, e.name);
+            if (e.isDirectory()) {
+                if (depth < maxDepth && !SKIP_DIRS.has(e.name))
+                    dirs.push({ dir: full, depth: depth + 1 });
+            }
+            else if (e.isFile()) {
+                const rel = path.relative(base, full);
+                out.push({ kind: 'file', label: rel, hint: '', insert: rel });
+            }
+        }
+        dirs.reverse(); // 保证 pop 顺序按字母序
+        for (const d of dirs)
+            stack.push(d);
+    }
+    out.sort((a, b) => a.label.localeCompare(b.label));
+    return out;
+}
+/** 文件匹配评分: basename 前缀 > 全路径前缀 > basename 包含 > 全路径包含 */
+export function matchFileScore(label, q) {
+    const base = label.split('/').pop() || label;
+    if (base.startsWith(q))
+        return 0;
+    if (label.startsWith(q))
+        return 1;
+    if (base.includes(q))
+        return 2;
+    if (label.includes(q))
+        return 3;
+    return -1;
+}
+/**
+ * 从输入里检测当前 mention token (最后一个以 @ / # 开头的 token).
+ * 返回 { kind, query, start, trigger } — start 是触发符在 input 里的下标.
+ *
+ * 规则:
+ *   @ → agent: token 里最后一个 @, 且 @ 前一个字符不是 ascii 字母数字 (防 email a@b.com)
+ *   # → file:  token 里最后一个 #, 允许路径含 / (如 #src/cli/), 前字符非 ascii 字母数字
+ *   / → command: 必须是 token 第一个字符 (防 "看看 src/" 误触发), 如 /queue
+ */
+export function getMention(input) {
+    // 最后一个 token 的起始下标 (最后一个空白之后)
+    let tokenStart = input.length;
+    while (tokenStart > 0 && !/\s/.test(input[tokenStart - 1]))
+        tokenStart--;
+    const token = input.slice(tokenStart);
+    // 从后往前找触发符
+    for (let i = token.length - 1; i >= 0; i--) {
+        const ch = token[i];
+        if (ch !== '@' && ch !== '/' && ch !== '#')
+            continue;
+        if (ch === '/') {
+            // 命令: 只认 token 第一个字符
+            if (i !== 0)
+                continue;
+        }
+        else {
+            // @ / #: 前一个字符是 ascii 字母数字 → email/url 场景, 跳过
+            if (i > 0 && /[A-Za-z0-9]/.test(token[i - 1]))
+                continue;
+        }
+        const kind = ch === '@' ? 'agent' : ch === '#' ? 'file' : 'command';
+        return { kind, query: token.slice(i + 1), start: tokenStart + i, trigger: ch };
+    }
+    return null;
+}

package/dist/constraint-runtime/_archive_helper.d.ts

@@ -0,0 +1 @@
+export declare function loadArchiveMetadata(packageName: string): Record<string, unknown>;

package/dist/constraint-runtime/_archive_helper.js

@@ -0,0 +1,9 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export function loadArchiveMetadata(packageName) {
+    const snapshotPath = path.join(__dirname, 'reference_data', 'subsystems', `${packageName}.json`);
+    return JSON.parse(fs.readFileSync(snapshotPath, 'utf-8'));
+}

package/dist/constraint-runtime/agent/coordinator.d.ts

@@ -0,0 +1,19 @@
+export interface SubTask {
+    id: string;
+    description: string;
+    priority: number;
+}
+export interface AgentResult {
+    taskId: string;
+    output: string;
+    success: boolean;
+    metadata?: Record<string, unknown>;
+}
+export declare class AgentCoordinator {
+    private engine;
+    constructor(maxDepth?: number);
+    dispatch(prompt: string, parallelCount?: number): Promise<AgentResult[]>;
+    private splitTask;
+    private executeTask;
+    private aggregate;
+}

package/dist/constraint-runtime/agent/coordinator.js

@@ -0,0 +1,48 @@
+import { DeepThinkingEngine } from '../thinking/engine.js';
+export class AgentCoordinator {
+    engine;
+    constructor(maxDepth = 3) {
+        this.engine = new DeepThinkingEngine(maxDepth);
+    }
+    async dispatch(prompt, parallelCount = 3) {
+        const tasks = this.splitTask(prompt, parallelCount);
+        const results = await Promise.all(tasks.map(task => this.executeTask(task)));
+        return this.aggregate(results);
+    }
+    splitTask(prompt, count) {
+        const words = prompt.split(/\s+/);
+        const chunkSize = Math.ceil(words.length / count);
+        const chunks = [];
+        for (let i = 0; i < count; i++) {
+            const chunk = words.slice(i * chunkSize, (i + 1) * chunkSize).join(' ');
+            if (chunk) {
+                chunks.push({
+                    id: `task-${i}`,
+                    description: chunk,
+                    priority: i
+                });
+            }
+        }
+        return chunks;
+    }
+    async executeTask(task) {
+        try {
+            const thinkResult = await this.engine.think(task.description);
+            return {
+                taskId: task.id,
+                output: thinkResult.finalOutput,
+                success: true
+            };
+        }
+        catch (error) {
+            return {
+                taskId: task.id,
+                output: String(error),
+                success: false
+            };
+        }
+    }
+    aggregate(results) {
+        return results.sort((a, b) => a.taskId.localeCompare(b.taskId));
+    }
+}

package/dist/constraint-runtime/agent/index.d.ts

@@ -0,0 +1 @@
+export { AgentCoordinator, type SubTask, type AgentResult } from './coordinator.js';

package/dist/constraint-runtime/agent/index.js

@@ -0,0 +1 @@
+export { AgentCoordinator } from './coordinator.js';

package/dist/constraint-runtime/assistant/index.d.ts

@@ -0,0 +1,11 @@
+export declare const ARCHIVE_NAME: string;
+export declare const MODULE_COUNT: number;
+export declare const SAMPLE_FILES: string[];
+export declare const PORTING_NOTE: string;
+declare const _default: {
+    ARCHIVE_NAME: string;
+    MODULE_COUNT: number;
+    PORTING_NOTE: string;
+    SAMPLE_FILES: string[];
+};
+export default _default;

package/dist/constraint-runtime/assistant/index.js

@@ -0,0 +1,12 @@
+import { loadArchiveMetadata } from '../_archive_helper.js';
+const SNAPSHOT = loadArchiveMetadata('assistant');
+export const ARCHIVE_NAME = SNAPSHOT['archive_name'];
+export const MODULE_COUNT = SNAPSHOT['module_count'];
+export const SAMPLE_FILES = SNAPSHOT['sample_files'];
+export const PORTING_NOTE = `Python placeholder package for '${ARCHIVE_NAME}' with ${MODULE_COUNT} archived module references.`;
+export default {
+    ARCHIVE_NAME,
+    MODULE_COUNT,
+    PORTING_NOTE,
+    SAMPLE_FILES,
+};

package/dist/constraint-runtime/bootstrap/index.d.ts

@@ -0,0 +1,11 @@
+export declare const ARCHIVE_NAME: string;
+export declare const MODULE_COUNT: number;
+export declare const SAMPLE_FILES: string[];
+export declare const PORTING_NOTE: string;
+declare const _default: {
+    ARCHIVE_NAME: string;
+    MODULE_COUNT: number;
+    PORTING_NOTE: string;
+    SAMPLE_FILES: string[];
+};
+export default _default;

package/dist/constraint-runtime/bootstrap/index.js

@@ -0,0 +1,12 @@
+import { loadArchiveMetadata } from '../_archive_helper.js';
+const SNAPSHOT = loadArchiveMetadata('bootstrap');
+export const ARCHIVE_NAME = SNAPSHOT['archive_name'];
+export const MODULE_COUNT = SNAPSHOT['module_count'];
+export const SAMPLE_FILES = SNAPSHOT['sample_files'];
+export const PORTING_NOTE = `Python placeholder package for '${ARCHIVE_NAME}' with ${MODULE_COUNT} archived module references.`;
+export default {
+    ARCHIVE_NAME,
+    MODULE_COUNT,
+    PORTING_NOTE,
+    SAMPLE_FILES,
+};

package/dist/constraint-runtime/bootstrap_graph.d.ts

@@ -0,0 +1,4 @@
+export interface BootstrapGraph {
+    stages: string[];
+}
+export declare function buildBootstrapGraph(): BootstrapGraph;

package/dist/constraint-runtime/bootstrap_graph.js

@@ -0,0 +1,13 @@
+export function buildBootstrapGraph() {
+    return {
+        stages: [
+            'top-level prefetch side effects',
+            'warning handler and environment guards',
+            'CLI parser and pre-action trust gate',
+            'setup() + commands/agents parallel load',
+            'deferred init after trust',
+            'mode routing: local / remote / ssh / teleport / direct-connect / deep-link',
+            'query engine submit loop',
+        ],
+    };
+}

package/dist/constraint-runtime/bridge/index.d.ts

@@ -0,0 +1,11 @@
+export declare const ARCHIVE_NAME: string;
+export declare const MODULE_COUNT: number;
+export declare const SAMPLE_FILES: string[];
+export declare const PORTING_NOTE: string;
+declare const _default: {
+    ARCHIVE_NAME: string;
+    MODULE_COUNT: number;
+    PORTING_NOTE: string;
+    SAMPLE_FILES: string[];
+};
+export default _default;

package/dist/constraint-runtime/bridge/index.js

@@ -0,0 +1,12 @@
+import { loadArchiveMetadata } from '../_archive_helper.js';
+const SNAPSHOT = loadArchiveMetadata('bridge');
+export const ARCHIVE_NAME = SNAPSHOT['archive_name'];
+export const MODULE_COUNT = SNAPSHOT['module_count'];
+export const SAMPLE_FILES = SNAPSHOT['sample_files'];
+export const PORTING_NOTE = `Python placeholder package for '${ARCHIVE_NAME}' with ${MODULE_COUNT} archived module references.`;
+export default {
+    ARCHIVE_NAME,
+    MODULE_COUNT,
+    PORTING_NOTE,
+    SAMPLE_FILES,
+};

package/dist/constraint-runtime/buddy/index.d.ts

@@ -0,0 +1,11 @@
+export declare const ARCHIVE_NAME: string;
+export declare const MODULE_COUNT: number;
+export declare const SAMPLE_FILES: string[];
+export declare const PORTING_NOTE: string;
+declare const _default: {
+    ARCHIVE_NAME: string;
+    MODULE_COUNT: number;
+    PORTING_NOTE: string;
+    SAMPLE_FILES: string[];
+};
+export default _default;

package/dist/constraint-runtime/buddy/index.js

@@ -0,0 +1,12 @@
+import { loadArchiveMetadata } from '../_archive_helper.js';
+const SNAPSHOT = loadArchiveMetadata('buddy');
+export const ARCHIVE_NAME = SNAPSHOT['archive_name'];
+export const MODULE_COUNT = SNAPSHOT['module_count'];
+export const SAMPLE_FILES = SNAPSHOT['sample_files'];
+export const PORTING_NOTE = `Python placeholder package for '${ARCHIVE_NAME}' with ${MODULE_COUNT} archived module references.`;
+export default {
+    ARCHIVE_NAME,
+    MODULE_COUNT,
+    PORTING_NOTE,
+    SAMPLE_FILES,
+};

package/dist/constraint-runtime/cli/index.d.ts

@@ -0,0 +1,11 @@
+export declare const ARCHIVE_NAME: string;
+export declare const MODULE_COUNT: number;
+export declare const SAMPLE_FILES: string[];
+export declare const PORTING_NOTE: string;
+declare const _default: {
+    ARCHIVE_NAME: string;
+    MODULE_COUNT: number;
+    PORTING_NOTE: string;
+    SAMPLE_FILES: string[];
+};
+export default _default;

package/dist/constraint-runtime/cli/index.js

@@ -0,0 +1,12 @@
+import { loadArchiveMetadata } from '../_archive_helper.js';
+const SNAPSHOT = loadArchiveMetadata('cli');
+export const ARCHIVE_NAME = SNAPSHOT['archive_name'];
+export const MODULE_COUNT = SNAPSHOT['module_count'];
+export const SAMPLE_FILES = SNAPSHOT['sample_files'];
+export const PORTING_NOTE = `Python placeholder package for '${ARCHIVE_NAME}' with ${MODULE_COUNT} archived module references.`;
+export default {
+    ARCHIVE_NAME,
+    MODULE_COUNT,
+    PORTING_NOTE,
+    SAMPLE_FILES,
+};

package/dist/constraint-runtime/command_graph.d.ts

@@ -0,0 +1,7 @@
+import { PortingModule } from './models.js';
+export interface CommandGraph {
+    builtins: PortingModule[];
+    pluginLike: PortingModule[];
+    skillLike: PortingModule[];
+}
+export declare function buildCommandGraph(): CommandGraph;

package/dist/constraint-runtime/command_graph.js

@@ -0,0 +1,10 @@
+import { getCommands } from './commands.js';
+export function buildCommandGraph() {
+    const commands = getCommands();
+    return {
+        builtins: commands.filter(m => !m.sourceHint.toLowerCase().includes('plugin') &&
+            !m.sourceHint.toLowerCase().includes('skills')),
+        pluginLike: commands.filter(m => m.sourceHint.toLowerCase().includes('plugin')),
+        skillLike: commands.filter(m => m.sourceHint.toLowerCase().includes('skills')),
+    };
+}

package/dist/constraint-runtime/commands.d.ts

@@ -0,0 +1,15 @@
+import { PortingModule } from './models.js';
+export interface CommandExecution {
+    name: string;
+    sourceHint: string;
+    prompt: string;
+    handled: boolean;
+    message: string;
+}
+export declare const PORTED_COMMANDS: PortingModule[];
+export { PortingModule };
+export declare function builtInCommandNames(): Set<string>;
+export declare function getCommand(name: string): PortingModule | undefined;
+export declare function getCommands(includePluginCommands?: boolean, includeSkillCommands?: boolean): PortingModule[];
+export declare function findCommands(query: string, limit?: number): PortingModule[];
+export declare function executeCommand(name: string, prompt?: string): CommandExecution;

package/dist/constraint-runtime/commands.js

@@ -0,0 +1,60 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const SNAPSHOT_PATH = path.join(__dirname, 'reference_data', 'commands_snapshot.json');
+function loadCommandSnapshot() {
+    try {
+        if (!fs.existsSync(SNAPSHOT_PATH)) {
+            console.warn(`[commands] Snapshot not found: ${SNAPSHOT_PATH}, using empty list`);
+            return [];
+        }
+        const raw = JSON.parse(fs.readFileSync(SNAPSHOT_PATH, 'utf-8'));
+        return raw.map((e) => ({
+            name: e.name,
+            responsibility: e.responsibility,
+            sourceHint: e.source_hint,
+            status: 'mirrored',
+        }));
+    }
+    catch (error) {
+        console.warn(`[commands] Failed to load snapshot: ${error}, using empty list`);
+        return [];
+    }
+}
+export const PORTED_COMMANDS = loadCommandSnapshot();
+export function builtInCommandNames() {
+    return new Set(PORTED_COMMANDS.map(m => m.name));
+}
+export function getCommand(name) {
+    const needle = name.toLowerCase();
+    return PORTED_COMMANDS.find(m => m.name.toLowerCase() === needle);
+}
+export function getCommands(includePluginCommands = true, includeSkillCommands = true) {
+    let commands = [...PORTED_COMMANDS];
+    if (!includePluginCommands) {
+        commands = commands.filter(m => !m.sourceHint.toLowerCase().includes('plugin'));
+    }
+    if (!includeSkillCommands) {
+        commands = commands.filter(m => !m.sourceHint.toLowerCase().includes('skills'));
+    }
+    return commands;
+}
+export function findCommands(query, limit = 20) {
+    const needle = query.toLowerCase();
+    return PORTED_COMMANDS.filter(m => m.name.toLowerCase().includes(needle) || m.sourceHint.toLowerCase().includes(needle)).slice(0, limit);
+}
+export function executeCommand(name, prompt = '') {
+    const module = getCommand(name);
+    if (!module) {
+        return { name, sourceHint: '', prompt, handled: false, message: `Unknown mirrored command: ${name}` };
+    }
+    return {
+        name: module.name,
+        sourceHint: module.sourceHint,
+        prompt,
+        handled: true,
+        message: `Mirrored command '${module.name}' from ${module.sourceHint} would handle prompt.`,
+    };
+}

package/dist/constraint-runtime/components/index.d.ts

@@ -0,0 +1,11 @@
+export declare const ARCHIVE_NAME: string;
+export declare const MODULE_COUNT: number;
+export declare const SAMPLE_FILES: string[];
+export declare const PORTING_NOTE: string;
+declare const _default: {
+    ARCHIVE_NAME: string;
+    MODULE_COUNT: number;
+    PORTING_NOTE: string;
+    SAMPLE_FILES: string[];
+};
+export default _default;

package/dist/constraint-runtime/components/index.js

@@ -0,0 +1,12 @@
+import { loadArchiveMetadata } from '../_archive_helper.js';
+const SNAPSHOT = loadArchiveMetadata('components');
+export const ARCHIVE_NAME = SNAPSHOT['archive_name'];
+export const MODULE_COUNT = SNAPSHOT['module_count'];
+export const SAMPLE_FILES = SNAPSHOT['sample_files'];
+export const PORTING_NOTE = `Python placeholder package for '${ARCHIVE_NAME}' with ${MODULE_COUNT} archived module references.`;
+export default {
+    ARCHIVE_NAME,
+    MODULE_COUNT,
+    PORTING_NOTE,
+    SAMPLE_FILES,
+};

package/dist/constraint-runtime/constants/index.d.ts

@@ -0,0 +1,11 @@
+export declare const ARCHIVE_NAME: string;
+export declare const MODULE_COUNT: number;
+export declare const SAMPLE_FILES: string[];
+export declare const PORTING_NOTE: string;
+declare const _default: {
+    ARCHIVE_NAME: string;
+    MODULE_COUNT: number;
+    PORTING_NOTE: string;
+    SAMPLE_FILES: string[];
+};
+export default _default;

package/dist/constraint-runtime/constants/index.js

@@ -0,0 +1,12 @@
+import { loadArchiveMetadata } from '../_archive_helper.js';
+const SNAPSHOT = loadArchiveMetadata('constants');
+export const ARCHIVE_NAME = SNAPSHOT['archive_name'];
+export const MODULE_COUNT = SNAPSHOT['module_count'];
+export const SAMPLE_FILES = SNAPSHOT['sample_files'];
+export const PORTING_NOTE = `Python placeholder package for '${ARCHIVE_NAME}' with ${MODULE_COUNT} archived module references.`;
+export default {
+    ARCHIVE_NAME,
+    MODULE_COUNT,
+    PORTING_NOTE,
+    SAMPLE_FILES,
+};

package/dist/constraint-runtime/constraint/budget.d.ts

@@ -0,0 +1,11 @@
+import { UsageSummary } from '../models.js';
+export declare class BudgetTracker {
+    maxBudgetTokens: number;
+    maxTurns: number;
+    compactAfterTurns: number;
+    constructor(maxBudgetTokens?: number, maxTurns?: number, compactAfterTurns?: number);
+    addTurn(inputTokens: number, outputTokens: number): UsageSummary;
+    isBudgetExceeded(usage: UsageSummary): boolean;
+    isTurnLimitExceeded(currentTurns: number): boolean;
+    shouldCompact(turnCount: number): boolean;
+}