qlogicagent-orchestration

qlogicagent-orchestration 鏄皬鏅?Claw 浣撶郴閲岀殑鍏变韩绾紪鎺掑眰锛屾壙杞?provider 鏃犲叧鐨?agent orchestration 璇箟銆?

瀹冨綋鍓嶄笉鏄繍琛屾椂锛屼笉鏄?Hub/Gateway side-effect 澹筹紝涔熶笉鏄?provider SDK 閫傞厤灞傦紱瀹冪殑鑱岃矗鏄妸澶氫釜娑堣垂鑰呴兘闇€瑕佺殑绾嚱鏁扮瓥鐣ユ矇娣€鎴愮ǔ瀹?contract銆?

褰撳墠鑱岃矗

1. Tool schema normalization 涓?function tool definition 杞崲銆?
2. Tool choice policy 涓?provider compatibility downgrade銆?
3. Conversation repair锛屽寘鎷?chat replay銆丷esponses replay銆乫orced-stop cleanup銆乨angling tool-result repair銆?
4. Parallel tool-call normalization 涓?approval-aware scheduling batches銆?
5. Tool Loop State 鐨勭函鏁版嵁妯″瀷銆乺ecovery 涓?replay coordination銆?
6. Bounded retry-loop orchestration 涓?retry-budget scaling銆?
7. Memory flush transcript read-plan銆乼oken projection 涓?compaction flush gating policy銆?
8. Embedded run prompt-error銆乤ssistant-failure 涓?auth-profile failover decision policy銆?
9. Failover error normalization銆乼imeout detection 涓?failover-status projection 绾涔夈€?

鏄庣‘涓嶈礋璐?

1. Planner state銆?
2. Todo state銆?
3. Session persistence銆?
4. Runtime registries銆?
5. Subagent registries銆?
6. Transport clients銆?
7. Hub / Gateway / Admin side effects銆?
8. Provider API 鍙戝寘閫昏緫銆?
9. 閴存潈銆佽璐广€侀厤棰濄€佸璁°€?

鏂囨。鍏ュ彛

椤圭洰鍐?canonical 鏂囨。锛?

1. docs/package-contract.md
2. docs/api-surface-map.md
3. CONTRIBUTING.md
4. docs/releasing.md

璇存槑锛?

1. 璇ュ寘鐨?contract 鐪熸簮宸茬粡杩佸叆鏈瓙椤圭洰 docs锛屼笉鍐嶄互鐖朵粨 steup/docs 姝ｆ枃涓哄噯銆?
2. 鐖朵粨淇濈暀鐨勫悓鍚嶆枃妗ｅ彧浣滀负璺ㄩ」鐩鑸叆鍙ｏ紝涓嶅啀鎵挎媴姝ｆ枃鐪熸簮鑱岃矗銆?
3. 瀵煎嚭闈€乥reaking-change 瑙勫垯銆佸紑鍙戣竟鐣岄兘搴斾互鏈洰褰曟枃妗ｄ负鍑嗐€?

瀵煎叆瑙勫垯

鍏佽锛?

import {
  applyToolChoicePolicy,
  repairOpenAiResponsesItems,
  resolveParallelToolCallScheduling,
} from "qlogicagent-orchestration";

绂佹鎶婁互涓嬭矾寰勫綋浣滅ǔ瀹?contract锛?

import { applyToolChoicePolicy } from "qlogicagent-orchestration/src/tool-choice-policy.js";
import { applyToolChoicePolicy } from "qlogicagent-orchestration/dist/index.js";

寮€鍙戝懡浠?

1. 瀹夎锛歚npm install`
2. 鏋勫缓锛歚npm run build`
3. 绫诲瀷妫€鏌ワ細npm run check
4. 鎵撳寘妫€鏌ワ細npm run pack:check

鏈湴寮€鍙戣鏄?

1. 娑堣垂鏂瑰綋鍓嶉€氳繃鏈粨鏈湴渚濊禆娑堣垂璇ュ寘銆?
2. package contract 浠?dist/index.js 涓?dist/index.d.ts 涓哄噯锛屽洜姝ゆ敼鍔ㄥ叡浜唬鐮佸悗瑕佸厛鍦ㄦ湰鍖呮墽琛?build銆?
3. 鎺ㄨ崘椤哄簭锛氬厛鍦ㄦ湰鍖呮墽琛?npm run build 鎴?npm run check锛屽啀鍥炲埌娑堣垂鑰呭伐绋嬪埛鏂颁緷璧栧苟鎵ц build/typecheck銆?
4. openclaw 閲屽瓨鍦ㄥ皯閲?TypeScript path fallback 浠呯敤浜庝粨鍐呭紑鍙戜究鍒╋紝涓嶅睘浜庢湰鍖呭澶?contract銆?

AI Coding 瑙勫垯

椤圭洰绾?AI coding 瑙勫垯浣嶄簬锛?

1. .github/copilot-instructions.md

鏍稿績瑕佹眰锛?

1. 鍙湪鏈寘娌夋穩绾嚱鏁?绾暟鎹?contract锛屼笉寮曞叆杩愯鏃跺壇浣滅敤銆?
2. 涓嶄慨鏀?dist/ 浜х墿锛屽缁堟敼 src/ 骞堕噸鏂版瀯寤恒€?
3. 瀵煎嚭闈㈠彉鍖栧繀椤诲悓姝ユ洿鏂?package contract銆乻urface map 涓?CHANGELOG銆?

浠撳簱缁存姢鍩虹嚎

1. CI 浣嶄簬 .github/workflows/ci.yml锛岄粯璁ゆ墽琛?npm ci銆乣npm run check銆乣npm run build銆乣npm run pack:check`銆?
2. GitHub tag release workflow 浣嶄簬 .github/workflows/release.yml銆?
3. Gitee tag release workflow 浣嶄簬 .gitee/workflows/release.yml锛屼娇鐢?Gitee Go 鍘熺敓 build@nodejs 涓?release@gitee 鎻掍欢鑷姩鏋勫缓骞跺彂甯?release銆?
4. 宸蹭簬 2026-04-23 鍦?Gitee Go 瀹炴祴璺戦€?v0.1.0 鍙戝竷閾撅紝release 椤甸潰宸茬敓鎴愬苟鎸傚嚭 release-package.tgz 闄勪欢銆?
5. Issue 妯℃澘浣嶄簬 .github/ISSUE_TEMPLATE锛岀敤浜?bug 涓庤兘鍔涜姹傛敹鍙ｃ€?
6. 鍙戝竷璇存槑浣嶄簬 docs/releasing.md锛岀敤浜庣害鏉熺増鏈€佸彉鏇磋鏄庡拰娑堣垂鑰呰仈鍔ㄩ獙璇併€?