@bolloon/bolloon-agent 0.3.8 → 0.3.10

package/dist/agents/pi-sdk-tools.js

@@ -8,6 +8,7 @@ import { checkWritePath } from './shell-guard.js';
 import { p2pDocumentTools } from './p2p-document-tools.js';
 import { runSelfImproveLoop } from './pi-sdk-session-factory.js';
 import { getMinimax } from '../constraints/index.js';
+import { delegateToEngine } from '../external-engines/delegate.js';
 /**
  * Tools 模块 — 从 pi-sdk.ts 抽出的 registerTools() / _registerWalletTools() / _setupInboxListener()
  * / wrapToolsWithIdempotency() (2026-07-06).
@@ -267,6 +268,37 @@ export function registerBuiltinTools(ctx) {
             return { success: true, output: `📞 RPC 任务已发送给 ${peerId.substring(0, 16)}...\n   requestId=${requestId}` };
         }
     });
+    // delegate_to_engine — 把编码任务委派给本机已安装的其他 AI 编码智能体 CLI
+    // (codex / claude-code / opencode / openclaw / hermes). 它们必须已安装且可达 PATH.
+    // 实验 API 引擎 (experiment:xxx) 是供应商不是 CLI, 不支持委派, 工具会提示改用 import.
+    ctx.tools.set('delegate_to_engine', {
+        name: 'delegate_to_engine',
+        description: '把编码任务委派给本机已安装的其他 AI 编码智能体 (子智能体) 执行: codex / claude-code / opencode / openclaw / hermes. 引擎需已安装且在 PATH 上. 返回其执行输出. 注意: 各工具 CLI 的非交互参数随版本变化, 若报错请检查该工具版本对应 flag.',
+        parameters: {
+            engine: "引擎 id: codex / claude-code / opencode / openclaw / hermes (实验 API 不支持委派)",
+            prompt: '派发的任务描述 (作为单参数传给该引擎 CLI)',
+            model: '可选, 强制指定模型 (如 deepseek/deepseek-v4-flash), 需引擎支持',
+            cwd: '可选, 工作目录, 默认当前目录'
+        },
+        execute: async (args) => {
+            const engine = String(args.engine || '').trim();
+            const prompt = String(args.prompt || '').trim();
+            if (!engine)
+                return { success: false, error: 'engine 必填' };
+            if (!prompt)
+                return { success: false, error: 'prompt 必填' };
+            const cwd = args.cwd ? String(args.cwd).trim() : undefined;
+            const model = args.model ? String(args.model).trim() : undefined;
+            const result = await delegateToEngine(engine, prompt, { cwd: cwd || undefined, ...(model ? { model } : {}) });
+            if (!result.success) {
+                return { success: false, error: result.error, output: result.output };
+            }
+            return {
+                success: true,
+                output: `🤖 ${engine} 执行结果 (exitCode=${result.exitCode}):\n${result.output || '(无输出)'}`
+            };
+        }
+    });
     ctx.tools.set('get_identity', {
         name: 'get_identity',
         description: '获取当前智能体身份信息',
@@ -1217,12 +1249,26 @@ export function registerWalletTools(ctx) {
     });
     ctx.tools.set('polymarket_get_orders', {
         name: 'polymarket_get_orders',
-        description: '查询 Polymarket 订单.',
-        parameters: { marketId: '可选 按市场 ID 过滤' },
+        description: '查询 Polymarket 开放订单. 需要钱包私钥 privateKey 做 API key 鉴权.',
+        parameters: {
+            privateKey: '钱包私钥 0x... (必填)',
+            marketId: '可选 按市场 ID 过滤',
+            apiKey: '可选, 已存在的 API key',
+            apiSecret: '可选, API secret',
+            apiPassphrase: '可选, API passphrase',
+            funder: '可选, 资金地址',
+        },
         execute: async (args) => {
             try {
                 const { getOrders } = await import('../constraint-runtime/dist/tools/PolymarketSDK/getOrders.js').catch(() => import('../constraint-runtime/src/tools/PolymarketSDK/getOrders.js'));
-                const orders = await getOrders(args.marketId ? { marketId: String(args.marketId) } : {});
+                const orders = await getOrders({
+                    privateKey: String(args.privateKey),
+                    marketId: args.marketId ? String(args.marketId) : undefined,
+                    apiKey: args.apiKey ? String(args.apiKey) : undefined,
+                    apiSecret: args.apiSecret ? String(args.apiSecret) : undefined,
+                    apiPassphrase: args.apiPassphrase ? String(args.apiPassphrase) : undefined,
+                    funder: args.funder ? String(args.funder) : undefined,
+                });
                 return { success: true, output: `📋 订单列表: ${JSON.stringify(orders, null, 2).substring(0, 1500)}` };
             }
             catch (e) {
@@ -1232,19 +1278,40 @@ export function registerWalletTools(ctx) {
     });
     ctx.tools.set('polymarket_create_order', {
         name: 'polymarket_create_order',
-        description: '在 Polymarket 下单 (BUY/SELL).',
-        parameters: { marketId: '市场 ID (必填)', side: 'BUY 或 SELL (必填)', price: '价格 0-1 (必填)', size: '数量 USDC (必填)' },
+        description: '在 Polymarket 下单 (BUY/SELL). 需要钱包私钥 privateKey 做 EIP-712 订单签名与 API key 派生.',
+        parameters: {
+            privateKey: '下单钱包私钥 0x... (必填)',
+            marketId: '市场 ID (必填)',
+            side: 'BUY 或 SELL (必填)',
+            price: '价格 0-1 (必填, 需符合 tickSize)',
+            size: '数量 USDC (必填)',
+            outcome: '可选, Yes/No 或索引 0/1, 默认第一个 (通常 Yes)',
+            tokenId: '可选, 显式条件代币 tokenID (优先于 outcome)',
+            orderType: '可选, GTC (默认) 或 GTD',
+            apiKey: '可选, 已存在的 API key (需配合 apiSecret/apiPassphrase)',
+            apiSecret: '可选, API secret',
+            apiPassphrase: '可选, API passphrase',
+            funder: '可选, 资金地址 (默认=私钥地址)',
+        },
         execute: async (args) => {
             try {
                 const { createOrder } = await import('../constraint-runtime/dist/tools/PolymarketSDK/createOrder.js').catch(() => import('../constraint-runtime/src/tools/PolymarketSDK/createOrder.js'));
                 const r = await createOrder({
+                    privateKey: String(args.privateKey),
                     marketId: String(args.marketId),
                     side: String(args.side).toUpperCase() === 'SELL' ? 'SELL' : 'BUY',
                     price: Number(args.price),
                     size: Number(args.size),
+                    outcome: args.outcome !== undefined ? args.outcome : undefined,
+                    tokenId: args.tokenId ? String(args.tokenId) : undefined,
+                    orderType: args.orderType ? String(args.orderType) : undefined,
+                    apiKey: args.apiKey ? String(args.apiKey) : undefined,
+                    apiSecret: args.apiSecret ? String(args.apiSecret) : undefined,
+                    apiPassphrase: args.apiPassphrase ? String(args.apiPassphrase) : undefined,
+                    funder: args.funder ? String(args.funder) : undefined,
                 });
                 if (r.success)
-                    return { success: true, output: `✅ 订单: ${r.message}` };
+                    return { success: true, output: `✅ 订单已提交: orderId=${r.orderId} status=${r.status}` };
                 return { success: false, error: r.message, output: r.message };
             }
             catch (e) {
@@ -1254,12 +1321,26 @@ export function registerWalletTools(ctx) {
     });
     ctx.tools.set('polymarket_cancel_order', {
         name: 'polymarket_cancel_order',
-        description: '取消 Polymarket 订单.',
-        parameters: { orderId: '订单 ID (必填)' },
+        description: '取消 Polymarket 订单. 需要钱包私钥 privateKey 做 API key 鉴权.',
+        parameters: {
+            privateKey: '钱包私钥 0x... (必填)',
+            orderId: '订单 ID (必填)',
+            apiKey: '可选, 已存在的 API key',
+            apiSecret: '可选, API secret',
+            apiPassphrase: '可选, API passphrase',
+            funder: '可选, 资金地址',
+        },
         execute: async (args) => {
             try {
                 const { cancelOrder } = await import('../constraint-runtime/dist/tools/PolymarketSDK/cancelOrder.js').catch(() => import('../constraint-runtime/src/tools/PolymarketSDK/cancelOrder.js'));
-                const r = await cancelOrder({ orderId: String(args.orderId) });
+                const r = await cancelOrder({
+                    privateKey: String(args.privateKey),
+                    orderId: String(args.orderId),
+                    apiKey: args.apiKey ? String(args.apiKey) : undefined,
+                    apiSecret: args.apiSecret ? String(args.apiSecret) : undefined,
+                    apiPassphrase: args.apiPassphrase ? String(args.apiPassphrase) : undefined,
+                    funder: args.funder ? String(args.funder) : undefined,
+                });
                 if (r.success)
                     return { success: true, output: `✅ 取消订单: ${r.message}` };
                 return { success: false, error: r.message, output: r.message };

package/dist/agents/pi-sdk.js

@@ -31,7 +31,8 @@ import { registerBuiltinTools, registerWalletTools, setupInboxListener, Idempote
 export { createAgentSession, getAgentSession, resetAgentSession, runSelfImproveLoop, } from './pi-sdk-session-factory.js';
 // Judgment 注入门 (P0): 在主对话 LLM 调起前自动拼入 Top 3 判断力
 // 失败静默, 不阻塞主对话
-import { injectJudgmentGate, recordJudgmentUsage } from '../pi-ecosystem-judgment/injection-gate.js';
+import { injectJudgmentGate, injectNegativeGuard, recordJudgmentUsage } from '../pi-ecosystem-judgment/injection-gate.js';
+import { getInjectionMaxChars } from '../bootstrap/exhaust-scrubber.js';
 // 持续监控门 (P3): AI 回复后审计是否违反原则
 import { monitorAfterReply } from '../pi-ecosystem-judgment/monitor-gate.js';
 // Bootstrap 生命周期 hook (SessionStart / Stop / PreToolUse)
@@ -109,6 +110,8 @@ export class PiAgentSession {
      */
     judgmentGateAddition = '';
     judgmentGateUsedIds = [];
+    /** 2026-07-22 设计 B: 负向判断力 (避免清单) 注入用到的 judgment id */
+    judgmentGateNegativeUsedIds = [];
     // 2026-06-18: 来自 web server markedPrompt 外的 contextHint (channel/judgment/distill/remote channels),
     //   拼到 systemPrompt 末尾, 别再混进 user message
     contextHintAddition = '';
@@ -147,11 +150,25 @@ export class PiAgentSession {
         try {
             // P-Action 4 (2026-06-15) 路径 1 整合: 透传 maxChars=1500 (≈ 375 tokens 硬上限)
             // 路径 2/3 检测由 injection-gate 内部 alreadyInjectedSources 处理 (目前 assembleSystemPrompt 还没注入 value-store 标记, 所以这里不传)
-            const gate = await injectJudgmentGate(input, {}, { maxChars: 1500 });
+            // 2026-07-22 设计 C: maxChars 读背压动态值 (涡轮增压进气调参)
+            //   上下文紧张 (high) → 收紧 800; 宽裕 (idle/low) → 放宽 1800; 默认 medium 1500
+            const gate = await injectJudgmentGate(input, {}, { maxChars: getInjectionMaxChars() });
             this.judgmentGateAddition = gate.systemAddition;
             this.judgmentGateUsedIds = gate.usedIds;
-            if (gate.usedIds.length > 0) {
-                safePhase('gate_done', { usedCount: gate.usedIds.length, didInject: gate.didInject, skipReason: gate.skipReason });
+            // 2026-07-22 设计 B: 负向判断力回收 — "避免清单"注入 (显式, 进 prompt)
+            //   判断力负向是"判断力"非"废气", 可进 prompt 作为约束 (精准 = 正向指引 + 负向避免)
+            try {
+                const neg = await injectNegativeGuard(input, {}, { maxChars: 300 });
+                if (neg.didInject && neg.systemAddition) {
+                    this.judgmentGateAddition += '\n' + neg.systemAddition;
+                    this.judgmentGateNegativeUsedIds = neg.usedIds;
+                }
+            }
+            catch (negErr) {
+                console.warn('[PiAgent] negative guard failed (non-fatal):', negErr);
+            }
+            if (this.judgmentGateUsedIds.length > 0 || this.judgmentGateNegativeUsedIds.length > 0) {
+                safePhase('gate_done', { usedCount: this.judgmentGateUsedIds.length, negativeCount: this.judgmentGateNegativeUsedIds.length, didInject: gate.didInject, skipReason: gate.skipReason });
             }
         }
         catch (err) {
@@ -163,6 +180,7 @@ export class PiAgentSession {
     clearJudgmentGate() {
         this.judgmentGateAddition = '';
         this.judgmentGateUsedIds = [];
+        this.judgmentGateNegativeUsedIds = [];
     }
     constructor(config) {
         this.cwd = config.cwd;
@@ -491,7 +509,10 @@ export class PiAgentSession {
         }
         finally {
             if (this.judgmentGateUsedIds.length > 0) {
-                recordJudgmentUsage(this.judgmentGateUsedIds, { userInput: input }).catch((err) => console.warn('[PiAgent] recordJudgmentUsage failed:', err));
+                recordJudgmentUsage(this.judgmentGateUsedIds, { userInput: input, polarity: 'positive' }).catch((err) => console.warn('[PiAgent] recordJudgmentUsage failed:', err));
+            }
+            if (this.judgmentGateNegativeUsedIds.length > 0) {
+                recordJudgmentUsage(this.judgmentGateNegativeUsedIds, { userInput: input, polarity: 'negative' }).catch((err) => console.warn('[PiAgent] recordJudgmentUsage (negative) failed:', err));
             }
             this.clearJudgmentGate();
             this.currentSignal = null;

package/dist/bootstrap/exhaust-scrubber.js

@@ -0,0 +1,233 @@
+/**
+ * exhaust-scrubber.ts — 上下文废气涡轮 (2026-07-22 设计 C)
+ *
+ * 思想锚点: 涡轮增压 (Turbocharger)
+ *   排气 (废气) = session-window dropped / memory-compressor skipped / compaction stage drops / truncation
+ *   涡轮 (本模块) = 采样丢弃事件, 聚合成"背压"指标
+ *   进气增压 = 背压反向调进气侧参数 (压缩阈值 / 检索 top-k / judgment 注入 maxChars)
+ *   燃烧室 (prompt) = 废气**不进**这里 (保持精准), 只让压力调参
+ *
+ * 拍板: 上下文废气 → 不进 prompt, 只调参, 进 log/memory, 隐式
+ *
+ * 三个职责:
+ *   1. recordExhaust(event): 采样丢弃事件 → 环形缓冲 + 落盘 ~/.bolloon/engine/backpressure.jsonl (log)
+ *   2. getBackpressure(): 算背压等级 (idle/low/medium/high) — 进气侧读它调参
+ *   3. getInjectionMaxChars(level): 背压 → judgment 注入 maxChars 映射 (进气增压)
+ *   4. maybeWriteExhaustMemory(): 背压高峰持续 → 模板摘要写 memory (月度滚动, 不调 LLM)
+ *
+ * 设计原则:
+ *   - 零新数据源: 只订阅已有丢弃事件
+ *   - 隐式: 用户看不到废气内容, 只看到压力等级 (可选背压表)
+ *   - 静默: 任何失败 console.warn 不阻塞主流程
+ *   - 不存原文: 只存 source + reason + 估算 token 数 (防隐私/膨胀)
+ */
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+// ============== 路径 ==============
+function getEngineDir(home) {
+    return path.join(home || os.homedir(), '.bolloon', 'engine');
+}
+function getBackpressureLogPath(home) {
+    return path.join(getEngineDir(home), 'backpressure.jsonl');
+}
+function getMemoryEngineDir(agentId, home) {
+    // 跟 memory-compressor.ts 一致: ~/.bolloon/memory/<agentId>/engine/
+    const safe = agentId.replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 64);
+    return path.join(home || os.homedir(), '.bolloon', 'memory', safe, 'engine');
+}
+// ============== 状态 (模块级单例, 跟 chat-archiver 同模式) ==============
+const RING_CAPACITY = 100;
+const ringBuffer = [];
+let droppedTokensTotal = 0;
+const bySource = {};
+let monthlyHighCount = 0; // 当月 high 事件累计 (触发 memory 摘要用)
+// ============== 采样 (涡轮入口) ==============
+/**
+ * 记录一个废气事件. 推入环形缓冲 + 落盘 jsonl (log). 静默失败.
+ *
+ * @param event  废气事件 (source + reason + 可选 droppedTokens; ts 不传则自动填)
+ * @param home   可选 home 目录 (测试注入)
+ */
+export async function recordExhaust(event, home) {
+    try {
+        const full = {
+            ts: event.ts || new Date().toISOString(),
+            source: event.source,
+            reason: event.reason,
+            droppedTokens: event.droppedTokens,
+        };
+        // 环形缓冲
+        ringBuffer.push(full);
+        if (ringBuffer.length > RING_CAPACITY) {
+            ringBuffer.shift();
+        }
+        // 计数
+        if (full.droppedTokens && full.droppedTokens > 0) {
+            droppedTokensTotal += full.droppedTokens;
+        }
+        bySource[full.source] = (bySource[full.source] || 0) + 1;
+        // 落盘 jsonl (log) — append 模式, 跟 chat-archiver 同
+        const logPath = getBackpressureLogPath(home);
+        await fs.mkdir(path.dirname(logPath), { recursive: true });
+        await fs.appendFile(logPath, JSON.stringify(full) + '\n', 'utf-8');
+        // high 事件累计 → 触发 memory 摘要 (火忘)
+        const snap = getBackpressure(home);
+        if (snap.level === 'high') {
+            monthlyHighCount++;
+            // 每 10 次 high 触发一次 memory 摘要 (节流, 防频繁写盘)
+            if (monthlyHighCount % 10 === 0) {
+                maybeWriteExhaustMemorySummary('default', home).catch(() => { });
+            }
+        }
+    }
+    catch (err) {
+        console.warn('[exhaust-scrubber] recordExhaust failed (non-fatal):', err);
+    }
+}
+/**
+ * 同步版本 (供不方便 await 的调用方; 只更新内存环形缓冲, 不落盘).
+ * 落盘由下次 async recordExhaust 或显式 flush 触发.
+ */
+export function recordExhaustSync(event) {
+    try {
+        const full = {
+            ts: event.ts || new Date().toISOString(),
+            source: event.source,
+            reason: event.reason,
+            droppedTokens: event.droppedTokens,
+        };
+        ringBuffer.push(full);
+        if (ringBuffer.length > RING_CAPACITY)
+            ringBuffer.shift();
+        if (full.droppedTokens && full.droppedTokens > 0)
+            droppedTokensTotal += full.droppedTokens;
+        bySource[full.source] = (bySource[full.source] || 0) + 1;
+    }
+    catch { /* 静默 */ }
+}
+// ============== 聚合 (背压等级) ==============
+/**
+ * 算当前背压快照. 基于环形缓冲 + 最近 60s 事件速率.
+ *
+ * 等级映射 (dropRatePerMin = 最近 60s 内事件数 / 60 * 60... 简化为最近 60s 事件数本身):
+ *   0       → idle
+ *   1-2     → low
+ *   3-10    → medium
+ *   > 10    → high
+ */
+export function getBackpressure(_home) {
+    const now = Date.now();
+    const recent = ringBuffer.filter((e) => {
+        const t = Date.parse(e.ts);
+        return Number.isFinite(t) && now - t < 60_000; // 最近 60s
+    });
+    const dropRatePerMin = recent.length;
+    let level;
+    if (dropRatePerMin === 0)
+        level = 'idle';
+    else if (dropRatePerMin <= 2)
+        level = 'low';
+    else if (dropRatePerMin <= 10)
+        level = 'medium';
+    else
+        level = 'high';
+    const srcCount = {};
+    for (const e of ringBuffer) {
+        srcCount[e.source] = (srcCount[e.source] || 0) + 1;
+    }
+    return {
+        level,
+        dropCount: ringBuffer.length,
+        droppedTokensTotal,
+        dropRatePerMin,
+        lastTs: ringBuffer.length > 0 ? ringBuffer[ringBuffer.length - 1].ts : '',
+        bySource: srcCount,
+    };
+}
+export function getPressureLevel(home) {
+    return getBackpressure(home).level;
+}
+// ============== 进气增压 (背压 → 调参) ==============
+/**
+ * 背压 → judgment 注入 maxChars 映射 (进气增压核心).
+ *
+ *   idle/low   → 1800 (放宽注入, 上下文宽裕)
+ *   medium     → 1500 (默认, 现状)
+ *   high       → 800  (收紧注入, 上下文紧张, 留空间给主任务)
+ *
+ * 调用方: pi-sdk.ts computeJudgmentGate 的 maxChars 从固定 1500 改为读这个.
+ */
+export function getInjectionMaxChars(level, home) {
+    const lvl = level ?? getPressureLevel(home);
+    switch (lvl) {
+        case 'idle':
+        case 'low':
+            return 1800;
+        case 'medium':
+            return 1500;
+        case 'high':
+            return 800;
+        default:
+            return 1500;
+    }
+}
+/**
+ * 背压 → 检索 top-k 映射 (进气增压, 检索侧).
+ *   idle/low → 8, medium → 5, high → 3
+ */
+export function getRetrievalTopK(level, home) {
+    const lvl = level ?? getPressureLevel(home);
+    switch (lvl) {
+        case 'idle':
+        case 'low':
+            return 8;
+        case 'medium':
+            return 5;
+        case 'high':
+            return 3;
+        default:
+            return 5;
+    }
+}
+// ============== memory 落地 (月度摘要, 拍板要求"进 memory") ==============
+/**
+ * 背压高峰持续 → 模板摘要写 memory (月度滚动, 不调 LLM).
+ *   ~/.bolloon/memory/<agentId>/engine/exhaust-<YYYY-MM>.summary.md (append)
+ *
+ * 让"为什么这段时间上下文一直紧张"沉淀进 memory 供 agent 回看.
+ * 节流: 每 10 次 high 触发一次 (recordExhaust 内控制).
+ */
+export async function maybeWriteExhaustMemorySummary(agentId, home) {
+    try {
+        const snap = getBackpressure(home);
+        if (snap.level !== 'high')
+            return { written: false };
+        const now = new Date();
+        const yearMonth = `${now.getUTCFullYear()}-${String(now.getUTCMonth() + 1).padStart(2, '0')}`;
+        const dir = getMemoryEngineDir(agentId, home);
+        const file = path.join(dir, `exhaust-${yearMonth}.summary.md`);
+        await fs.mkdir(dir, { recursive: true });
+        const block = `\n\n---\n\n## 引擎背压高峰 @ ${now.toISOString()} (level=high)\n\n` +
+            `- 最近 60s 丢弃事件: ${snap.dropRatePerMin} 次/min\n` +
+            `- 环形缓冲事件总数: ${snap.dropCount}\n` +
+            `- 估算丢弃 token 累计: ${snap.droppedTokensTotal}\n` +
+            `- 按 source 分布: ${Object.entries(snap.bySource).map(([k, v]) => `${k}=${v}`).join(', ') || '(无)'}\n` +
+            `- 含义: 上下文持续紧张, 进气侧已自动收紧 (judgment 注入 maxChars=800, 检索 top-k=3)\n`;
+        await fs.appendFile(file, block, 'utf-8');
+        return { written: true, path: file };
+    }
+    catch (err) {
+        console.warn('[exhaust-scrubber] maybeWriteExhaustMemorySummary failed (non-fatal):', err);
+        return { written: false };
+    }
+}
+// ============== 测试辅助 ==============
+/** 重置模块状态 (仅测试用) */
+export function __resetForTest() {
+    ringBuffer.length = 0;
+    droppedTokensTotal = 0;
+    for (const k of Object.keys(bySource))
+        delete bySource[k];
+    monthlyHighCount = 0;
+}

package/dist/bootstrap/memory-compressor.js

@@ -161,6 +161,17 @@ export async function compressSessionToMemory(opts) {
     await fs.mkdir(path.dirname(summaryPath), { recursive: true });
     await fs.appendFile(summaryPath, block, 'utf-8');
     await writeCursor(cursorPath, allMessages.length);
+    // 2026-07-22 设计 C: 废气采样 — 压缩成功 = 上下文需要压缩的信号, 记入涡轮 (隐式)
+    //   废气不进 prompt, 只调参 (背压高 → judgment 注入收紧). 落 log/memory.
+    try {
+        const { recordExhaust } = await import('./exhaust-scrubber.js');
+        recordExhaust({
+            source: 'memory-compressor',
+            reason: 'compress-summary-written',
+            droppedTokens: newMessages.length * 200, // 粗估 200 tokens/msg
+        }, opts.home).catch(() => { });
+    }
+    catch { /* 静默 */ }
     return {
         summaryPath,
         cursorPath,

package/dist/constraint-runtime/src/tools/PolymarketSDK/cancelOrder.js

@@ -1,6 +1,21 @@
+import { buildClobClient } from './clobShared';
 export async function cancelOrder(params) {
-    return {
-        success: false,
-        message: 'Polymarket order cancellation requires CLOB client with authentication. Use the Polymarket web interface to cancel orders.',
-    };
+    if (!params.privateKey) {
+        return { success: false, message: '取消订单需要提供钱包私钥 privateKey' };
+    }
+    if (!params.orderId) {
+        return { success: false, message: 'orderId 必填' };
+    }
+    try {
+        const { client } = await buildClobClient({
+            privateKey: params.privateKey,
+            creds: { apiKey: params.apiKey, apiSecret: params.apiSecret, apiPassphrase: params.apiPassphrase },
+            funder: params.funder,
+        });
+        const resp = await client.cancelOrder({ orderID: params.orderId });
+        return { success: true, message: '已提交取消', raw: resp };
+    }
+    catch (e) {
+        return { success: false, message: `取消失败: ${e?.message || e}` };
+    }
 }

package/dist/constraint-runtime/src/tools/PolymarketSDK/clobShared.js

@@ -0,0 +1,104 @@
+/**
+ * Polymarket CLOB 下单/查单/撤单 共享依赖
+ *
+ * 真实实现基于 @polymarket/clob-client (ClobClient):
+ *   - 签名用 viem WalletClient (privateKeyToAccount + polygon + http transport)
+ *   - 下单前需 ApiKeyCreds (key/secret/passphrase), 由 createOrDeriveApiKey() 从签名派生
+ *   - tokenID / tickSize / negRisk 来自 Gamma 市场元数据 (https://gamma-api.polymarket.com/markets/:id)
+ *
+ * chainId = 137 (Polygon), host = https://clob.polymarket.com
+ */
+import { ClobClient, OrderType, Side } from '@polymarket/clob-client';
+import { createWalletClient, http } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { polygon } from 'viem/chains';
+export const CLOB_HOST = 'https://clob.polymarket.com';
+export const CHAIN_ID = 137;
+export function normalizePrivateKey(pk) {
+    const s = pk.startsWith('0x') ? pk : `0x${pk}`;
+    return s;
+}
+function safeParseArray(v) {
+    if (Array.isArray(v))
+        return v;
+    if (typeof v === 'string') {
+        try {
+            const parsed = JSON.parse(v);
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+/**
+ * 从 Gamma 取市场元数据: clobTokenIds / outcomes / tickSize / negRisk.
+ * 优先用 Gamma 路径端点 (带 tickSize/negRisk), 失败回退 polymarket-sdk listMarkets({id}).
+ */
+export async function fetchMarketMeta(marketId) {
+    try {
+        const res = await fetch(`https://gamma-api.polymarket.com/markets/${encodeURIComponent(marketId)}`);
+        if (res.ok) {
+            const m = await res.json();
+            return {
+                clobTokenIds: safeParseArray(m.clobTokenIds),
+                outcomes: safeParseArray(m.outcomes),
+                tickSize: typeof m.tickSize === 'string' ? m.tickSize : '0.01',
+                negRisk: !!m.negRisk,
+            };
+        }
+    }
+    catch {
+        // fall through to sdk
+    }
+    const { listMarkets } = await import('polymarket-sdk').catch(() => ({ listMarkets: async () => [] }));
+    const ms = await listMarkets({ id: marketId });
+    const m = ms?.[0];
+    if (!m)
+        throw new Error(`未找到市场: ${marketId}`);
+    return {
+        clobTokenIds: safeParseArray(m.clobTokenIds),
+        outcomes: safeParseArray(m.outcomes),
+        tickSize: '0.01',
+        negRisk: false,
+    };
+}
+/**
+ * 由 outcome (如 "Yes"/"No" 或索引 0/1) 或显式 tokenId 解析出要交易的 tokenID.
+ * 都不给 → 默认取第一个 clobTokenId (通常是 "Yes").
+ */
+export function resolveTokenId(meta, tokenId, outcome) {
+    if (tokenId)
+        return tokenId;
+    if (!meta.clobTokenIds || meta.clobTokenIds.length === 0)
+        return undefined;
+    if (outcome === undefined || outcome === null)
+        return meta.clobTokenIds[0];
+    if (typeof outcome === 'number')
+        return meta.clobTokenIds[outcome];
+    const idx = meta.outcomes.findIndex((o) => String(o).toLowerCase() === String(outcome).toLowerCase());
+    return idx >= 0 ? meta.clobTokenIds[idx] : undefined;
+}
+/**
+ * 构造已鉴权的 ClobClient.
+ *  - 若提供完整 apiKey/apiSecret/apiPassphrase → 直接用
+ *  - 否则用签名派生 ApiKey (createOrDeriveApiKey, 需联网)
+ * signatureType = 0 (EOA / 浏览器钱包, 对应原始私钥签名)
+ */
+export async function buildClobClient(params) {
+    const account = privateKeyToAccount(normalizePrivateKey(params.privateKey));
+    const signer = createWalletClient({ account, chain: polygon, transport: http() });
+    const address = account.address;
+    let creds;
+    if (params.creds?.apiKey && params.creds?.apiSecret && params.creds?.apiPassphrase) {
+        creds = { key: params.creds.apiKey, secret: params.creds.apiSecret, passphrase: params.creds.apiPassphrase };
+    }
+    if (!creds) {
+        const tmp = new ClobClient(CLOB_HOST, CHAIN_ID, signer);
+        creds = await tmp.createOrDeriveApiKey();
+    }
+    const client = new ClobClient(CLOB_HOST, CHAIN_ID, signer, creds, 0, params.funder ?? address);
+    return { client, address };
+}
+export { OrderType, Side };

package/dist/constraint-runtime/src/tools/PolymarketSDK/createOrder.js

@@ -1,6 +1,36 @@
+import { buildClobClient, fetchMarketMeta, resolveTokenId } from './clobShared';
 export async function createOrder(params) {
-    return {
-        success: false,
-        message: 'Polymarket order creation requires CLOB client with authentication. Use the Polymarket web interface to create orders.',
-    };
+    if (!params.privateKey) {
+        return { success: false, message: '下单需要提供钱包私钥 privateKey (用于 EIP-712 订单签名)' };
+    }
+    if (!params.marketId) {
+        return { success: false, message: 'marketId 必填' };
+    }
+    try {
+        const meta = await fetchMarketMeta(params.marketId);
+        const tokenID = resolveTokenId(meta, params.tokenId, params.outcome);
+        if (!tokenID) {
+            return { success: false, message: '无法解析 tokenID (outcome 不匹配或市场无 clobTokenIds)' };
+        }
+        const { client } = await buildClobClient({
+            privateKey: params.privateKey,
+            creds: { apiKey: params.apiKey, apiSecret: params.apiSecret, apiPassphrase: params.apiPassphrase },
+            funder: params.funder,
+        });
+        const resp = await client.createAndPostOrder({
+            tokenID,
+            price: Number(params.price),
+            size: Number(params.size),
+            side: params.side,
+        }, { tickSize: meta.tickSize, negRisk: meta.negRisk }, (params.orderType ?? 'GTC'));
+        return {
+            success: true,
+            orderId: resp?.orderID ?? resp?.id,
+            status: resp?.status,
+            raw: resp,
+        };
+    }
+    catch (e) {
+        return { success: false, message: `下单失败: ${e?.message || e}` };
+    }
 }

package/dist/constraint-runtime/src/tools/PolymarketSDK/getOrders.js

@@ -1,6 +1,19 @@
+import { buildClobClient } from './clobShared';
 export async function getOrders(params = {}) {
-    return {
-        orders: [],
-        message: 'Polymarket order retrieval requires CLOB client with authentication. Use the Polymarket web interface to view orders.',
-    };
+    if (!params.privateKey) {
+        return { orders: [], message: '查询订单需要提供钱包私钥 privateKey' };
+    }
+    try {
+        const { client } = await buildClobClient({
+            privateKey: params.privateKey,
+            creds: { apiKey: params.apiKey, apiSecret: params.apiSecret, apiPassphrase: params.apiPassphrase },
+            funder: params.funder,
+        });
+        const resp = await client.getOpenOrders(params.marketId ? { market: params.marketId } : {});
+        const orders = Array.isArray(resp) ? resp : resp?.orders ?? [];
+        return { orders, message: 'OK' };
+    }
+    catch (e) {
+        return { orders: [], message: `查询失败: ${e?.message || e}` };
+    }
 }