@harrylabsj/kiwi 0.6.0

package/dist/tui/theme.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * TUI 主题原语（Neural Awakening，参照 hermes ui-tui theme.ts）——纯函数、
+ * 零状态、零依赖。
+ *
+ * - PALETTE：深黑蓝底 + 蓝/青语义色（primary/accent/ok/warn/error/muted）；
+ * - ColorMode 三档：off（非 TTY / NO_COLOR / TERM=dumb → 字节直通，测试与
+ *   管道输出不变）、basic（16 色退化映射，老终端）、24bit（COLORTERM 或
+ *   现代 TERM）；
+ * - paint() 是唯一着色入口；visibleWidth() 用字符扫描剥离 ANSI 并计入 CJK
+ *   双宽（**不用正则**——eslint no-control-regex 禁 ESC 字面量进正则）。
+ */
+/** ESC 转义前缀（字符串字面量，不进正则）。 */
+export declare const ESC = "\u001B";
+export declare const PALETTE: {
+    readonly bg: "#0A0E14";
+    readonly primary: "#4FC3F7";
+    readonly accent: "#00BCD4";
+    readonly ok: "#81C784";
+    readonly warn: "#FFD54F";
+    readonly error: "#EF5350";
+    readonly muted: "#8FA3BF";
+    readonly text: "#E6EDF3";
+};
+export type ColorKey = keyof typeof PALETTE;
+export type ColorMode = "off" | "basic" | "24bit";
+export interface PaintOpts {
+    bold?: boolean;
+    dim?: boolean;
+}
+export declare function hexToRgb(hex: string): [number, number, number];
+/** 24-bit 前景色 SGR：\x1b[38;2;R;G;Bm */
+export declare function rgb(hex: string): string;
+/** 16 色退化映射（basic 模式）：按语义色就近映射到标准前景色。 */
+export declare function rgbFg256(color: ColorKey): string;
+/** 完整样式前缀（bold/dim 修饰 + 前景色 SGR，不含 reset）；off 返回空串。 */
+export declare function sgr(mode: ColorMode, color: ColorKey, opts?: PaintOpts): string;
+/** 语义色 → 着色文本（sgr + reset）；off 模式直通原文。 */
+export declare function paint(text: string, mode: ColorMode, color: ColorKey, opts?: PaintOpts): string;
+/** CJK 宽字符区间（Unicode East Asian Wide/Fullwidth 主要区段，零依赖表）。 */
+export declare function isWide(ch: string): boolean;
+/** 可见宽度：剥离 ANSI（本包产出的 CSI SGR 序列）后计数，CJK 记 2。 */
+export declare function visibleWidth(text: string): number;
+/**
+ * 颜色模式判定：off = 非 TTY / NO_COLOR / TERM=dumb；24bit = COLORTERM 声明
+ * truecolor/24bit，或 TERM 为现代终端（xterm/screen/tmux/kitty/alacritty/
+ * wezterm）且不带 -256color 后缀；其余（WSL 老终端/cmd）basic 16 色退化。
+ */
+export declare function detectColorMode(env: Record<string, string | undefined>, outputIsTty: boolean): ColorMode;

package/dist/tui/theme.js

@@ -0,0 +1,136 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * TUI 主题原语（Neural Awakening，参照 hermes ui-tui theme.ts）——纯函数、
+ * 零状态、零依赖。
+ *
+ * - PALETTE：深黑蓝底 + 蓝/青语义色（primary/accent/ok/warn/error/muted）；
+ * - ColorMode 三档：off（非 TTY / NO_COLOR / TERM=dumb → 字节直通，测试与
+ *   管道输出不变）、basic（16 色退化映射，老终端）、24bit（COLORTERM 或
+ *   现代 TERM）；
+ * - paint() 是唯一着色入口；visibleWidth() 用字符扫描剥离 ANSI 并计入 CJK
+ *   双宽（**不用正则**——eslint no-control-regex 禁 ESC 字面量进正则）。
+ */
+/** ESC 转义前缀（字符串字面量，不进正则）。 */
+export const ESC = "\u001b";
+export const PALETTE = {
+    bg: "#0A0E14", // 深黑蓝底
+    primary: "#4FC3F7", // 蓝：a2a/discover/记忆/模式/角色
+    accent: "#00BCD4", // 青：磋商/handoff/negotiate/prompt
+    ok: "#81C784", // 绿：已发送/注册
+    warn: "#FFD54F", // 黄：通知/建议
+    error: "#EF5350", // 红：任务失败
+    muted: "#8FA3BF", // 灰蓝：dim 文本/私有/系统记录/边框
+    text: "#E6EDF3", // 主文本
+};
+export function hexToRgb(hex) {
+    const value = hex.replace(/^#/, "");
+    const parsed = Number.parseInt(value, 16);
+    if (value.length !== 6 || Number.isNaN(parsed)) {
+        throw new TypeError(`invalid hex color: ${hex}`);
+    }
+    return [(parsed >> 16) & 0xff, (parsed >> 8) & 0xff, parsed & 0xff];
+}
+/** 24-bit 前景色 SGR：\x1b[38;2;R;G;Bm */
+export function rgb(hex) {
+    const [r, g, b] = hexToRgb(hex);
+    return `${ESC}[38;2;${r};${g};${b}m`;
+}
+/** 16 色退化映射（basic 模式）：按语义色就近映射到标准前景色。 */
+export function rgbFg256(color) {
+    const table = {
+        bg: 40, // 黑底
+        primary: 34, // 蓝
+        accent: 36, // 青
+        ok: 32, // 绿
+        warn: 33, // 黄
+        error: 31, // 红
+        muted: 90, // 亮黑（灰）
+        text: 37, // 白
+    };
+    return `${ESC}[${table[color]}m`;
+}
+/** 完整样式前缀（bold/dim 修饰 + 前景色 SGR，不含 reset）；off 返回空串。 */
+export function sgr(mode, color, opts = {}) {
+    if (mode === "off")
+        return "";
+    const prefix = mode === "24bit" ? rgb(PALETTE[color]) : rgbFg256(color);
+    const style = `${opts.bold === true ? `${ESC}[1m` : ""}${opts.dim === true ? `${ESC}[2m` : ""}`;
+    return `${style}${prefix}`;
+}
+/** 语义色 → 着色文本（sgr + reset）；off 模式直通原文。 */
+export function paint(text, mode, color, opts = {}) {
+    if (mode === "off")
+        return text;
+    return `${sgr(mode, color, opts)}${text}${ESC}[0m`;
+}
+/** CJK 宽字符区间（Unicode East Asian Wide/Fullwidth 主要区段，零依赖表）。 */
+export function isWide(ch) {
+    const code = ch.codePointAt(0) ?? 0;
+    return ((code >= 0x1100 && code <= 0x115f) ||
+        (code >= 0x2e80 && code <= 0x303e) ||
+        (code >= 0x3041 && code <= 0x33ff) ||
+        (code >= 0x3400 && code <= 0x4dbf) ||
+        (code >= 0x4e00 && code <= 0x9fff) ||
+        (code >= 0xf900 && code <= 0xfaff) ||
+        (code >= 0xfe30 && code <= 0xfe4f) ||
+        (code >= 0xff00 && code <= 0xff60) ||
+        (code >= 0xffe0 && code <= 0xffe6));
+}
+/** 可见宽度：剥离 ANSI（本包产出的 CSI SGR 序列）后计数，CJK 记 2。 */
+export function visibleWidth(text) {
+    let width = 0;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === ESC) {
+            // 跳过 \x1b[…m（仅本包产出的 SGR 序列；遇非 m 终止符保守按字符继续）
+            const end = text.indexOf("m", i + 1);
+            if (end !== -1) {
+                i = end;
+                continue;
+            }
+            continue;
+        }
+        width += isWide(ch) ? 2 : 1;
+    }
+    return width;
+}
+/**
+ * 颜色模式判定：off = 非 TTY / NO_COLOR / TERM=dumb；24bit = COLORTERM 声明
+ * truecolor/24bit，或 TERM 为现代终端（xterm/screen/tmux/kitty/alacritty/
+ * wezterm）且不带 -256color 后缀；其余（WSL 老终端/cmd）basic 16 色退化。
+ */
+export function detectColorMode(env, outputIsTty) {
+    if (!outputIsTty)
+        return "off";
+    if (env.NO_COLOR !== undefined && env.NO_COLOR !== "")
+        return "off";
+    const term = env.TERM ?? "";
+    if (term === "dumb")
+        return "off";
+    const colorTerm = env.COLORTERM ?? "";
+    if (colorTerm === "truecolor" || colorTerm === "24bit")
+        return "24bit";
+    // tmux/kitty/alacritty/wezterm 原生透传 truecolor（tmux-256color 亦然）；
+    // xterm/screen 只有不带 -256color 后缀才算现代（否则 16 色退化）。
+    const truecolorTerminals = ["tmux", "kitty", "alacritty", "wezterm"];
+    if (truecolorTerminals.some((name) => term.startsWith(name)))
+        return "24bit";
+    if (/^(xterm|screen)/.test(term) && !term.includes("-256color"))
+        return "24bit";
+    return "basic";
+}
+//# sourceMappingURL=theme.js.map

package/dist/tui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/tui/theme.ts"],"names":[],"mappings":"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"}

package/examples/profiles/buyer.deepseek.yaml

@@ -0,0 +1,34 @@
+# Buyer profile — real model (deepseek-v4-flash) against a local shopping-cli.
+# Requires: SHOPPING_BUYER_TOKEN set (conversation-scoped buyer token) 与
+# DEEPSEEK_API_KEY 环境变量（模型 key，可从 Hermes 环境继承）。
+runtime_version: 0.6.0
+protocol_version: shopping.negotiation/0.1
+agent_id: buyer-agent:buyer-001
+role: buyer
+owner_id: buyer-001
+commerce:
+  base_url: http://127.0.0.1:8765
+  token_env: SHOPPING_BUYER_TOKEN
+  backend: local_marketplace
+model:
+  provider: deepseek
+  model: deepseek-v4-flash
+  api_key_env: DEEPSEEK_API_KEY
+runtime:
+  mode: once
+  poll_interval_seconds: 5
+  turn_timeout_seconds: 90
+  max_model_steps: 4
+  max_retries: 2
+buyer_policy:
+  target_skus:
+    - sku-001
+  quantity: 2
+  max_total_price_private: 200.00
+  acceptable_eta_latest: "2099-12-31T23:59:59+08:00"
+  required_after_sales_terms:
+    - policy:return-7d
+  auto_negotiate: true
+  human_review_on:
+    - budget_exceeded
+    - ambiguous_after_sales

package/examples/profiles/buyer.fake.yaml

@@ -0,0 +1,36 @@
+# Buyer profile — deterministic fake model against a local shopping-cli.
+# Requires: SHOPPING_BUYER_TOKEN set (conversation-scoped buyer token).
+# buyer_policy is PRIVATE: the marketplace never sees these values; the
+# local policy gate enforces them inside the submit tool before any write.
+runtime_version: 0.6.0
+protocol_version: shopping.negotiation/0.1
+agent_id: buyer-agent:buyer-001
+role: buyer
+owner_id: buyer-001
+commerce:
+  base_url: http://127.0.0.1:8765
+  token_env: SHOPPING_BUYER_TOKEN
+  backend: local_marketplace
+model:
+  provider: fake
+  model: fake-buyer-model
+runtime:
+  mode: once
+  poll_interval_seconds: 5
+  turn_timeout_seconds: 90
+  max_model_steps: 4
+  max_retries: 2
+buyer_policy:
+  target_skus:
+    - sku-001
+  quantity: 2
+  max_total_price_private: 200.00
+  # Far-future deadline keeps the shipped example durable; the local gate
+  # still rejects anything later than this RFC3339 (timezone-required) time.
+  acceptable_eta_latest: "2099-12-31T23:59:59+08:00"
+  required_after_sales_terms:
+    - policy:return-7d
+  auto_negotiate: true
+  human_review_on:
+    - budget_exceeded
+    - ambiguous_after_sales

package/examples/profiles/buyer.local.yaml

@@ -0,0 +1,40 @@
+# Buyer profile — real model (OpenAI-compatible) against a local shopping-cli.
+# Requires: SHOPPING_BUYER_TOKEN and MODEL_API_KEY set in the environment.
+# Secrets are NEVER written into this file — only env var names.
+# buyer_policy is PRIVATE: the marketplace never sees these values; the
+# local policy gate enforces them inside the submit tool before any write.
+runtime_version: 0.6.0
+protocol_version: shopping.negotiation/0.1
+agent_id: buyer-agent:buyer-001
+role: buyer
+owner_id: buyer-001
+commerce:
+  base_url: http://127.0.0.1:8765
+  token_env: SHOPPING_BUYER_TOKEN
+  backend: local_marketplace
+model:
+  provider: openai
+  model: gpt-4o-mini
+  api_key_env: MODEL_API_KEY
+  # api: openai-completions        # optional override
+  # base_url: http://127.0.0.1:11434/v1  # optional OpenAI-compatible endpoint
+runtime:
+  mode: once
+  poll_interval_seconds: 5
+  turn_timeout_seconds: 90
+  max_model_steps: 4
+  max_retries: 2
+buyer_policy:
+  target_skus:
+    - sku-001
+  quantity: 2
+  max_total_price_private: 200.00
+  # Far-future deadline keeps the shipped example durable; the local gate
+  # still rejects anything later than this RFC3339 (timezone-required) time.
+  acceptable_eta_latest: "2099-12-31T23:59:59+08:00"
+  required_after_sales_terms:
+    - policy:return-7d
+  auto_negotiate: true
+  human_review_on:
+    - budget_exceeded
+    - ambiguous_after_sales

package/examples/profiles/merchant.deepseek.yaml

@@ -0,0 +1,32 @@
+# Merchant profile — real model (deepseek-v4-flash) against a local shopping-cli.
+# Requires: SHOPPING_AGENT_TOKEN set (agent token for merchant-001) 与
+# DEEPSEEK_API_KEY 环境变量（模型 key，可从 Hermes 环境继承）。
+runtime_version: 0.6.0
+protocol_version: shopping.negotiation/0.1
+agent_id: merchant-agent:merchant-001
+role: merchant
+owner_id: merchant-001
+commerce:
+  base_url: http://127.0.0.1:8765
+  token_env: SHOPPING_AGENT_TOKEN
+  backend: local_marketplace
+model:
+  provider: deepseek
+  model: deepseek-v4-flash
+  api_key_env: DEEPSEEK_API_KEY
+runtime:
+  mode: once
+  poll_interval_seconds: 5
+  turn_timeout_seconds: 90
+  max_model_steps: 4
+  max_retries: 2
+merchant_policy:
+  min_unit_price_private: 80.00
+  max_auto_discount_percent: 10
+  inventory_source: marketplace
+  quote_ttl_seconds: 300
+  auto_negotiate: true
+  human_review_on:
+    - below_floor
+    - exceptional_warranty
+    - suspicious_content

package/examples/profiles/merchant.fake.yaml

@@ -0,0 +1,31 @@
+# Merchant profile — deterministic fake model against a local shopping-cli.
+# Runs the full single-turn slice with zero model dependency.
+# Requires: SHOPPING_AGENT_TOKEN set (agent token for merchant-001).
+runtime_version: 0.6.0
+protocol_version: shopping.negotiation/0.1
+agent_id: merchant-agent:merchant-001
+role: merchant
+owner_id: merchant-001
+commerce:
+  base_url: http://127.0.0.1:8765
+  token_env: SHOPPING_AGENT_TOKEN
+  backend: local_marketplace
+model:
+  provider: fake
+  model: fake-merchant-model
+runtime:
+  mode: once
+  poll_interval_seconds: 5
+  turn_timeout_seconds: 90
+  max_model_steps: 4
+  max_retries: 2
+merchant_policy:
+  min_unit_price_private: 80.00
+  max_auto_discount_percent: 10
+  inventory_source: marketplace
+  quote_ttl_seconds: 300
+  auto_negotiate: true
+  human_review_on:
+    - below_floor
+    - exceptional_warranty
+    - suspicious_content

package/examples/profiles/merchant.local.yaml

@@ -0,0 +1,34 @@
+# Merchant profile — real model (OpenAI-compatible) against a local shopping-cli.
+# Requires: SHOPPING_AGENT_TOKEN and MODEL_API_KEY set in the environment.
+# Secrets are NEVER written into this file — only env var names.
+runtime_version: 0.6.0
+protocol_version: shopping.negotiation/0.1
+agent_id: merchant-agent:merchant-001
+role: merchant
+owner_id: merchant-001
+commerce:
+  base_url: http://127.0.0.1:8765
+  token_env: SHOPPING_AGENT_TOKEN
+  backend: local_marketplace
+model:
+  provider: openai
+  model: gpt-4o-mini
+  api_key_env: MODEL_API_KEY
+  # api: openai-completions        # optional override
+  # base_url: http://127.0.0.1:11434/v1  # optional OpenAI-compatible endpoint
+runtime:
+  mode: once
+  poll_interval_seconds: 5
+  turn_timeout_seconds: 90
+  max_model_steps: 4
+  max_retries: 2
+merchant_policy:
+  min_unit_price_private: 80.00
+  max_auto_discount_percent: 10
+  inventory_source: marketplace
+  quote_ttl_seconds: 300
+  auto_negotiate: true
+  human_review_on:
+    - below_floor
+    - exceptional_warranty
+    - suspicious_content

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@harrylabsj/kiwi",
+  "version": "0.6.0",
+  "description": "Kiwi: standalone A2A commerce negotiation agent runtime (Pi Agent Core + shopping-cli Commerce API)",
+  "type": "module",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "bin": {
+    "kiwi": "dist/cli.js"
+  },
+  "exports": {
+    ".": "./dist/cli.js",
+    "./package.json": "./package.json",
+    "./dist/*": "./dist/*"
+  },
+  "files": [
+    "dist",
+    "contracts",
+    "examples"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint . --max-warnings=0",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "verify:package": "bash scripts/verify-package.sh",
+    "verify": "npm run lint && npm run typecheck && npm run build && npm run test && npm run verify:package",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@earendil-works/pi-agent-core": "0.83.0",
+    "@earendil-works/pi-ai": "0.83.0",
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "yaml": "2.9.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.29.0",
+    "@types/node": "^24.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.34.0",
+    "@typescript-eslint/parser": "^8.34.0",
+    "eslint": "^9.29.0",
+    "globals": "^17.9.0",
+    "prettier": "^3.5.3",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}