@jasonews/agent-squad-gateway 1.0.0

package/dist/web/assets/index-C5nnaBfZ.css

@@ -0,0 +1 @@
+:root{--bg: #f5f7f8;--surface: #ffffff;--surface-muted: #eef1f2;--text: #172025;--muted: #647078;--border: #d5dbde;--accent: #087f8c;--success: #18794e;--warning: #a15c00;--danger: #c9372c;--radius-control: 4px;--radius-panel: 6px;--sidebar-width: 224px;--topbar-height: 52px;--control-height: 32px;--control-height-large: 36px;--body-size: 14px;--body-line-height: 20px;--page-heading-size: 22px;--page-heading-line-height: 28px}*{box-sizing:border-box;letter-spacing:0}html,body,#root{min-width:320px;min-height:100%;margin:0}body{min-height:100vh;background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;font-size:var(--body-size);line-height:var(--body-line-height)}button,a,select,input,textarea{font:inherit}button:focus-visible,a:focus-visible,select:focus-visible{outline:2px solid var(--accent);outline-offset:2px}button{min-height:var(--control-height);border:1px solid var(--border);border-radius:var(--radius-control);background:var(--surface);color:var(--text)}select{height:var(--control-height);border:1px solid var(--border);border-radius:var(--radius-control);background:var(--surface);color:var(--text);padding:0 28px 0 9px}input:not([type=checkbox]){width:100%;height:var(--control-height);border:1px solid var(--border);border-radius:var(--radius-control);background:var(--surface);color:var(--text);padding:0 9px}input:focus-visible{outline:2px solid var(--accent);outline-offset:2px}textarea{width:100%;resize:vertical;border:1px solid var(--border);border-radius:var(--radius-control);background:var(--surface);color:var(--text);padding:8px 9px;font:inherit}textarea:focus-visible{outline:2px solid var(--accent);outline-offset:2px}button:disabled{background:var(--surface-muted);color:var(--muted);cursor:not-allowed}.toggle-control{display:inline-flex;min-width:36px;min-height:28px;align-items:center;gap:8px;border:0;padding:4px 0;background:transparent;color:var(--text);cursor:pointer}.toggle-control:hover:not(:disabled) .toggle-control__track{border-color:var(--accent)}.toggle-control:disabled{background:transparent;color:var(--muted);cursor:not-allowed;opacity:.62}.toggle-control__track{position:relative;width:36px;height:20px;flex:0 0 36px;border:1px solid var(--border);border-radius:999px;background:var(--surface-muted)}.toggle-control__thumb{position:absolute;top:2px;left:2px;width:14px;height:14px;border-radius:50%;background:var(--muted);transition:transform .14s ease}.toggle-control[aria-checked=true] .toggle-control__track{border-color:var(--accent);background:var(--accent)}.toggle-control[aria-checked=true] .toggle-control__thumb{background:var(--surface);transform:translate(16px)}.toggle-control--labelled{min-width:0}.toggle-control__label{text-align:left}.gateway-mark{display:inline-grid;width:28px;height:28px;flex:0 0 28px;place-items:center;border-radius:var(--radius-control);background:var(--accent);color:var(--surface);font-size:15px;font-weight:700;line-height:1}.session-state{display:grid;min-height:100vh;place-items:center;padding:24px}.session-state__panel{width:min(100%,340px);padding:24px;border:1px solid var(--border);border-radius:var(--radius-panel);background:var(--surface);text-align:center}.session-state__panel .gateway-mark{margin:0 auto 12px}.session-state__panel h1{margin:0;font-size:20px;line-height:28px}.session-state__panel p{margin:4px 0 16px;color:var(--muted)}.session-state__panel button{width:100%;min-height:var(--control-height-large);padding:7px 12px}.app-shell{display:grid;min-height:100vh;grid-template-columns:var(--sidebar-width) minmax(0,1fr)}.sidebar{position:fixed;z-index:30;inset:0 auto 0 0;width:var(--sidebar-width);min-width:0;border-right:1px solid var(--border);background:var(--surface);padding:12px;overflow-y:auto}.identity{display:flex;min-height:40px;align-items:center;gap:10px;padding:0 8px 12px;border-bottom:1px solid var(--border);font-size:15px;font-weight:650}.identity>span:nth-child(2){flex:1}.nav-list{display:grid;gap:2px;padding-top:10px}.nav-item{display:flex;height:var(--control-height);align-items:center;gap:9px;padding:0 10px;border-radius:var(--radius-control);color:var(--muted);text-decoration:none}.nav-item:hover:not(.nav-item--disabled){background:var(--surface-muted);color:var(--text)}.nav-item--active{background:var(--surface-muted);color:var(--text);font-weight:600}.nav-item--active svg{color:var(--accent)}.nav-item--disabled{color:color-mix(in srgb,var(--muted) 62%,var(--surface));cursor:not-allowed}.nav-item--degraded{color:var(--warning)}.nav-status-dot{width:6px;height:6px;margin-left:auto;border-radius:50%;background:var(--warning)}.workspace{grid-column:2;min-width:0}.topbar{position:sticky;z-index:20;top:0;height:var(--topbar-height);border-bottom:1px solid var(--border);background:var(--surface)}.topbar__content{display:flex;width:min(100%,1440px);height:100%;align-items:center;justify-content:space-between;margin-inline:auto;padding:0 28px}.topbar__leading{display:flex;align-items:center;gap:10px}.topbar__actions{display:flex;align-items:center;gap:8px}.language-select{display:inline-flex;height:32px;align-items:center;gap:6px;padding:0 7px;border:1px solid var(--border);border-radius:6px;background:var(--surface);color:var(--muted)}.language-select:focus-within{border-color:var(--accent);outline:2px solid color-mix(in srgb,var(--accent) 20%,transparent);outline-offset:1px}.language-select select{width:auto;min-width:72px;height:30px;min-height:30px;padding:0 20px 0 0;border:0;outline:0;background-color:transparent;color:var(--text);font-size:12px}.connection-status{display:inline-flex;align-items:center;gap:8px;color:var(--muted);font-variant-numeric:tabular-nums}.status-dot{width:7px;height:7px;border-radius:50%;background:var(--success)}.core-event-status{display:inline-flex;align-items:center;gap:6px;color:var(--muted);font-size:12px}.core-event-status:before{width:6px;height:6px;border-radius:50%;background:currentColor;content:""}.core-event-status--connected{color:var(--success)}.core-event-status--reconnecting{color:var(--warning)}.core-event-status--offline{color:var(--danger)}.icon-button{display:inline-grid;width:var(--control-height);height:var(--control-height);min-height:var(--control-height);place-items:center;padding:0;cursor:pointer}.icon-button:hover{border-color:var(--muted);background:var(--surface-muted)}.menu-button,.drawer-close,.drawer-backdrop{display:none}.page{width:min(100%,1440px);margin-inline:auto;padding:24px 28px}.page-heading{display:flex;align-items:flex-start;justify-content:space-between;gap:20px;padding-bottom:18px;border-bottom:1px solid var(--border)}.page-heading h1{margin:0;font-size:var(--page-heading-size);line-height:var(--page-heading-line-height)}.page-heading p{margin:2px 0 0;color:var(--muted)}.record-count{color:var(--muted);font-variant-numeric:tabular-nums;white-space:nowrap}.metric-band{display:grid;grid-template-columns:repeat(4,minmax(140px,1fr));margin-top:20px;border-top:1px solid var(--border);border-bottom:1px solid var(--border);background:var(--surface)}.metric-cell{display:grid;gap:2px;min-height:88px;align-content:center;padding:14px 18px}.metric-cell+.metric-cell{border-left:1px solid var(--border)}.metric-cell>span,.metric-cell small{color:var(--muted);font-size:12px;line-height:16px}.metric-cell strong{font-weight:600;font-variant-numeric:tabular-nums}.metric-value{font-size:20px;line-height:24px}.semantic-status{display:inline-flex;align-items:center;gap:6px;font-size:12px;font-weight:650;line-height:18px;text-transform:capitalize}.semantic-status:before{width:6px;height:6px;border-radius:50%;background:currentColor;content:""}.semantic-status--success{color:var(--success)}.semantic-status--warning{color:var(--warning)}.semantic-status--danger{color:var(--danger)}.semantic-status--accent{color:var(--accent)}.semantic-status--muted{color:var(--muted)}.operations-section,.table-section{margin-top:26px}.section-heading{display:flex;min-height:34px;align-items:center;justify-content:space-between;gap:16px;border-bottom:1px solid var(--border);padding-bottom:8px}.section-heading h2{margin:0;font-size:15px;line-height:22px}.section-heading span,.section-heading a{color:var(--muted);font-size:12px}.pressure-list{background:var(--surface)}.pressure-row{display:grid;min-height:36px;grid-template-columns:minmax(180px,1fr) 90px 90px;align-items:center;border-bottom:1px solid var(--border);padding:0 12px;font-variant-numeric:tabular-nums}.pressure-row--header{min-height:32px;background:var(--surface-muted);color:var(--muted);font-size:12px;font-weight:600}.filter-bar{display:grid;grid-template-columns:repeat(4,minmax(150px,220px));gap:12px;margin-top:18px;border-bottom:1px solid var(--border);padding-bottom:18px}.filter-bar label{display:grid;gap:4px;color:var(--muted);font-size:12px}.filter-bar select{width:100%;color:var(--text);font-size:var(--body-size)}.data-table-wrap{width:100%;overflow-x:auto;border-bottom:1px solid var(--border);background:var(--surface)}.data-table{width:100%;min-width:1076px;border-collapse:collapse;table-layout:fixed}.data-table th,.data-table td{height:38px;border-bottom:1px solid var(--border);padding:0 10px;overflow:hidden;text-align:left;text-overflow:ellipsis;white-space:nowrap}.data-table th{height:34px;background:var(--surface-muted);color:var(--muted);font-size:12px;font-weight:650}.data-table tbody tr:hover{background:color-mix(in srgb,var(--accent) 4%,var(--surface))}.data-table tbody tr:last-child td{border-bottom:0}.numeric{font-variant-numeric:tabular-nums}.code-cell{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}.actions-cell{text-align:center!important}.button{display:inline-flex;min-height:var(--control-height);align-items:center;justify-content:center;gap:7px;padding:0 11px;cursor:pointer}.button.icon-button{padding:0}.button.menu-button,.button.drawer-close{display:none}.button--danger{border-color:var(--danger);background:var(--danger);color:var(--surface)}.button--quiet{background:transparent}.empty-state{display:grid;min-height:76px;place-content:center;gap:2px;color:var(--muted);text-align:center}.empty-state strong{color:var(--text);font-weight:600}.dialog-layer{position:fixed;z-index:50;top:0;right:0;bottom:0;left:0;display:grid;place-items:center;padding:20px;background:#1720255c}.dialog{width:min(100%,420px);border:1px solid var(--border);border-radius:var(--radius-panel);background:var(--surface);box-shadow:0 16px 42px #17202533;padding:20px}.dialog--wide{width:min(100%,760px);max-height:calc(100vh - 40px);overflow-y:auto}.target-form{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px 16px}.field,.field label{display:grid;gap:4px}.field label>span,.field>small{color:var(--muted);font-size:12px}.field__label--required:after{content:" (required)"}.field__label--optional:after{content:" (optional)"}html[lang=zh-CN] .field__label--required:after{content:"（必填）"}html[lang=zh-CN] .field__label--optional:after{content:"（可选）"}.field select{width:100%}.target-validation{margin:12px 0 0;font-size:13px}.acknowledgements{display:grid;gap:8px;margin-top:16px;border-top:1px solid var(--border);padding-top:12px}.acknowledgements label{display:flex;align-items:center;gap:8px}.table-actions{display:flex;align-items:center;justify-content:center;gap:4px}.dialog h2{margin:0 0 16px;font-size:17px;line-height:24px}.dialog-facts{margin:0;border-top:1px solid var(--border)}.dialog-facts div{display:grid;grid-template-columns:72px minmax(0,1fr);border-bottom:1px solid var(--border);padding:8px 0}.dialog-facts dt{color:var(--muted)}.dialog-facts dd{margin:0;overflow-wrap:anywhere}.dialog-error{color:var(--danger)}.choice-form{display:grid;gap:16px}.choice-form fieldset{display:grid;gap:8px;margin:0;border:0;padding:0}.choice-form legend{margin-bottom:6px;color:var(--muted);font-size:12px}.choice-option{display:grid;grid-template-columns:18px minmax(0,1fr);align-items:start;gap:8px;border:1px solid var(--border);border-radius:var(--radius-control);padding:10px;cursor:pointer}.choice-option input{width:16px;height:16px;margin:2px 0 0}.choice-option>span,.choice-cell-detail{display:grid;min-width:0}.choice-option small,.choice-cell-detail small,.choice-rationale>span,.choice-rationale>small{color:var(--muted);font-size:12px}.choice-recommendation{display:grid;gap:2px;margin:0;border-left:3px solid var(--accent);padding-left:10px}.choice-recommendation span{color:var(--muted)}.choice-rationale{display:grid;gap:4px}.muted{color:var(--muted)}.client-section{margin-top:26px}.operation-notice{margin:14px 0 0;color:var(--success)}.operation-status{display:flex;align-items:center;gap:7px;margin:12px 0 0;color:var(--accent)}.verification-status{display:flex;align-items:flex-start;gap:9px;margin-top:14px;border-left:3px solid var(--accent);padding:8px 10px;background:var(--surface-muted)}.verification-status>span{display:grid;gap:2px}.verification-status small{color:var(--muted)}.dialog-toggle{margin-top:12px}.icon-spin{animation:icon-spin .9s linear infinite}@keyframes icon-spin{to{transform:rotate(360deg)}}.credential-list{border-bottom:1px solid var(--border);background:var(--surface)}.credential-row{display:grid;min-height:58px;grid-template-columns:minmax(160px,220px) minmax(300px,1fr) 80px;align-items:center;gap:14px;border-bottom:1px solid var(--border);padding:8px 10px}.credential-row:last-child{border-bottom:0}.credential-row>div:first-child{display:grid}.credential-row small,.grant-row small{color:var(--muted)}.secret-field{display:grid;grid-template-columns:minmax(0,1fr) 32px 32px;align-items:center;gap:4px}.secret-field__mask{overflow:hidden;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px;text-overflow:ellipsis;white-space:nowrap}.secret-field input{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}.secret-field__error{grid-column:1 / -1;color:var(--danger);font-size:12px}.grant-matrix{display:grid;gap:18px;padding-top:12px}.grant-group{border-bottom:1px solid var(--border)}.grant-group h3{margin:0;padding:7px 10px;background:var(--surface-muted);font-size:13px}.grant-row{display:grid;width:100%;min-height:46px;grid-template-columns:42px minmax(0,1fr);align-items:center;border-bottom:1px solid var(--border);padding:5px 10px;background:var(--surface);text-align:left}.grant-row>.toggle-control__label{display:grid}.grant-row:disabled{color:var(--text);opacity:1}.grant-row:disabled .toggle-control__track{opacity:.62}.credential-form{display:grid;gap:12px}.settings-section{margin-top:24px}.settings-core-row,.setup-inline{display:grid;grid-template-columns:minmax(240px,1fr) auto auto;align-items:end;gap:10px;padding-top:12px}.definition-list{margin:0}.definition-list>div{display:grid;grid-template-columns:180px minmax(0,1fr);min-height:38px;align-items:center;border-bottom:1px solid var(--border)}.definition-list dt{color:var(--muted)}.definition-list dd{margin:0;overflow-wrap:anywhere;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}.setup-steps{margin-top:8px}.setup-step{display:grid;grid-template-columns:36px minmax(0,1fr);gap:12px;border-bottom:1px solid var(--border);padding:16px 0}.setup-step__index{display:grid;width:30px;height:30px;place-items:center;border:1px solid var(--border);border-radius:var(--radius-control);color:var(--accent)}.setup-step__body{min-width:0}.setup-actions{display:flex;align-items:center;gap:10px;padding-top:12px}.setup-actions>span{color:var(--muted);font-size:12px}.suggestion-list{display:grid;margin:10px 0;border-top:1px solid var(--border)}.suggestion-row{display:grid;width:100%;min-height:46px;grid-template-columns:42px minmax(0,1fr);align-items:center;border-bottom:1px solid var(--border);text-align:left}.suggestion-row>.toggle-control__label{display:grid}.suggestion-list small{color:var(--muted)}.setup-finish{display:flex;justify-content:flex-end;padding-top:16px}@media(max-width:680px){.settings-core-row,.setup-inline{grid-template-columns:1fr;align-items:stretch}.definition-list>div{grid-template-columns:1fr;gap:2px;padding:7px 0}}.core-detail-heading code,.native-session code{overflow-wrap:anywhere;white-space:normal}.core-back-link{display:inline-block;margin-bottom:4px;color:var(--accent);font-size:12px}.core-tabs{display:flex;gap:2px;margin-top:18px;border-bottom:1px solid var(--border)}.core-tabs button{min-width:112px;border-color:transparent;border-bottom:2px solid transparent;border-radius:0;background:transparent}.core-tabs button[aria-selected=true]{border-bottom-color:var(--accent);color:var(--accent)}.core-detail-grid{display:grid;grid-template-columns:minmax(0,1fr) 360px;gap:20px;margin-top:14px}.core-panel{min-width:0;border-top:1px solid var(--border);background:var(--surface)}.core-panel__title{margin:0;border-bottom:1px solid var(--border);padding:10px 12px;background:var(--surface-muted);font-size:13px}.core-message,.core-subagent,.core-choice{min-width:0;border-bottom:1px solid var(--border);padding:12px}.core-message__meta,.core-subagent__heading,.core-choice__heading{display:flex;min-width:0;align-items:center;justify-content:space-between;gap:10px;color:var(--muted);font-size:12px}.core-message__meta strong,.core-subagent__heading strong,.core-choice__heading strong{color:var(--text)}.core-message p,.core-choice p{margin:8px 0 0;overflow-wrap:anywhere;white-space:pre-wrap}.core-facts{margin:10px 0}.core-facts>div{display:grid;grid-template-columns:96px minmax(0,1fr);gap:8px;padding:3px 0}.core-facts dt{color:var(--muted)}.core-facts dd{min-width:0;margin:0;overflow-wrap:anywhere}.core-choice__facts{margin:10px 0 0}.core-choice__facts>div{display:grid;grid-template-columns:72px minmax(0,1fr);gap:8px;padding:3px 0}.core-choice__facts dt{color:var(--muted)}.core-choice__facts dd{min-width:0;margin:0;overflow-wrap:anywhere}.native-session{display:flex;min-width:0;align-items:center;gap:4px}.native-session code{min-width:0;flex:1}.core-empty{padding:12px;color:var(--muted)}.dialog--wide:has(.raw-tail){display:grid;grid-template-rows:auto minmax(0,1fr) auto;overflow:hidden}.raw-tail{min-height:0;overflow:auto}.raw-tail__content{min-height:240px;max-height:60vh;margin:0;overflow:auto;padding:12px;background:var(--surface-muted);font:12px/18px ui-monospace,SFMono-Regular,Menlo,monospace;overflow-wrap:anywhere;white-space:pre-wrap}.raw-tail__empty{min-height:160px;margin:0;display:grid;place-content:center;color:var(--muted)}.core-unavailable{max-width:520px}.core-unavailable h1{font-size:var(--page-heading-size)}.core-unavailable{margin-top:24px}.core-session-link{color:var(--accent);font-weight:600}.data-table td.core-wrap-cell{overflow-wrap:anywhere;white-space:normal}@media(max-width:760px){.credential-row{grid-template-columns:minmax(0,1fr)}.secret-field{width:100%}}@media(max-width:959px){.core-detail-grid{grid-template-columns:minmax(0,1fr)}}@media(max-width:420px){.connection-status,.core-event-status{display:none}}.dialog-actions{display:flex;justify-content:flex-end;gap:8px;margin-top:18px}.visually-hidden{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}@media(prefers-reduced-motion:reduce){.toggle-control__thumb{transition:none}.icon-spin{animation:none}}@media(max-width:759px){.app-shell{grid-template-columns:1fr}.sidebar{transform:translate(-100%);visibility:hidden;transition:transform .16s ease;box-shadow:12px 0 32px #1720252e}.sidebar--open{transform:translate(0);visibility:visible}.workspace{grid-column:1}.button.menu-button,.button.drawer-close{display:inline-grid}.drawer-backdrop{position:fixed;z-index:25;top:0;right:0;bottom:0;left:0;display:block;width:100%;height:100%;min-height:0;border:0;border-radius:0;background:#17202547;padding:0}.page{padding:20px 16px}.topbar__content{padding-inline:16px}.metric-band{grid-template-columns:1fr}.metric-cell+.metric-cell{border-top:1px solid var(--border);border-left:0}.filter-bar,.target-form{grid-template-columns:1fr}.pressure-row{grid-template-columns:minmax(120px,1fr) 64px 64px}}

package/dist/web/index.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="color-scheme" content="light" />
+    <title>Gateway</title>
+    <script type="module" crossorigin src="/assets/index-BhqNoPpE.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-C5nnaBfZ.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@jasonews/agent-squad-gateway",
+  "version": "1.0.0",
+  "description": "Local control plane and OpenAI-compatible API gateway for coding CLI models.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JASONews/agent-squad-gateway.git"
+  },
+  "homepage": "https://github.com/JASONews/agent-squad-gateway#readme",
+  "bugs": {
+    "url": "https://github.com/JASONews/agent-squad-gateway/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "bin": {
+    "agent-squad-gateway": "./dist/bin/agent-squad-gateway.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "translations/",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.node.json && tsc -p web/tsconfig.json && vite build",
+    "prepack": "npm run build",
+    "dev": "vite --config vite.config.ts",
+    "dev:server": "tsx watch src/bin/agent-squad-gateway.ts start --foreground",
+    "test": "vitest run",
+    "test:all": "vitest run && playwright test",
+    "test:browser": "playwright test",
+    "test:real-providers": "GATEWAY_REAL_CLI_TEST=1 vitest run tests/integration/real-providers.test.ts",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^1.2.1",
+    "@fastify/static": "^9.1.1",
+    "@opencode-ai/sdk": "1.17.15",
+    "@tanstack/react-query": "^5.66.0",
+    "ajv": "^8.20.0",
+    "better-sqlite3": "^11.7.0",
+    "commander": "^12.1.0",
+    "fastify": "^5.2.0",
+    "lucide-react": "^0.468.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.49.1",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.1.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22.10.0",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@vitejs/plugin-react": "^4.3.4",
+    "jsdom": "^25.0.1",
+    "openai": "^6.46.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vite": "^6.0.7",
+    "vitest": "^4.1.10"
+  }
+}

package/translations/README.zh-CN.md

@@ -0,0 +1,175 @@
+# Agent Squad Gateway
+
+**面向本地编程 CLI 模型的控制平面与 OpenAI 兼容 API Gateway。**
+
+[English](https://github.com/JASONews/agent-squad-gateway/blob/main/README.md) | **简体中文**
+
+Agent Squad Gateway 将本机已安装并登录的编程 CLI 模型，通过 Web 管理界面和 OpenAI
+兼容接口提供给 LiteLLM、IDE 或其他 API 客户端。Gateway 负责模型别名、API Key、访问授权、
+并发控制、流式输出与能力验证；各 CLI 继续使用自己的本地登录状态。
+
+Agent Squad Core 是可选且独立的。Gateway 可以读取 Core 会话和待处理选择用于调试，但 Core
+不依赖 Gateway，Gateway 的 provider runtime 也可以在没有 Core 时独立运行。
+
+```text
+OpenAI 客户端 / LiteLLM / IDE
+            |
+       /v1 API + SSE
+            |
+  Agent Squad Gateway + Web UI
+            |
+ Codex / Claude Code / Cursor Agent / OpenCode / Antigravity / Kimi Code
+```
+
+## 主要功能
+
+- 兼容 `GET /v1/models`、`POST /v1/chat/completions` 和 `POST /v1/responses`。
+- 通过 SSE 返回流式响应；Responses API 可使用 `previous_response_id` 恢复会话。
+- 客户端工具调用：Gateway 返回 tool call，实际函数由 API 客户端执行。
+- 支持在 Web UI 中管理 CLI、调用目标、验证、客户端、可恢复的本地 API Key、授权、运行元数据、
+  extension、设置和可选的 Core 调试信息。
+- 每个 target 可配置模型、reasoning effort、隔离级别、流式模式、队列、并发、超时与 workspace。
+- CLI 版本变化后 provider 仍保持 Available，只要求受影响的 target 重新验证。
+- Gateway 数据库只保存元数据，不保存 prompt、completion、tool payload 或 provider 原始事件。
+
+## 环境要求
+
+- Node.js 20 或更新版本
+- npm
+- 至少安装并登录一个 provider CLI：
+  - Codex：`codex`
+  - Claude Code：`claude`
+  - Cursor Agent：`cursor-agent`
+  - OpenCode：`opencode`
+  - Antigravity：`agy`
+  - Kimi Code：`kimi`
+
+## 安装
+
+### npm
+
+Agent Squad Gateway 已作为公开 package 发布到 npm registry，无需配置 registry token：
+
+```bash
+npm install -g @jasonews/agent-squad-gateway
+
+agent-squad-gateway --help
+```
+
+### 从源码构建
+
+```bash
+git clone https://github.com/JASONews/agent-squad-gateway.git
+cd agent-squad-gateway
+npm ci
+npm run build
+npm link
+```
+
+## 快速开始
+
+```bash
+agent-squad-gateway start
+agent-squad-gateway open
+```
+
+默认监听 `0.0.0.0:28772`，因此本地容器可以访问。首次启动会创建
+`~/.agent-squad/gateway/config.json`：
+
+```json
+{
+  "address": "0.0.0.0",
+  "port": 28772,
+  "web_ui_auth": "disabled"
+}
+```
+
+只允许本机访问时，请把 `address` 改为 `127.0.0.1`。当管理界面可能被不可信网络访问时，
+请把 `web_ui_auth` 改为 `token`。修改后需要重启 Gateway。
+
+在 Web UI 中依次完成：
+
+1. 扫描本机 CLI。
+2. 创建并验证 invocation target。验证会真实调用模型，可能消耗额度。
+3. 启用验证成功的 target。
+4. 创建 client 和 API Key。
+5. 启用 OpenAI extension，并授权 client 使用指定 target。
+
+## OpenAI 兼容接口
+
+本机使用 `http://127.0.0.1:28772/v1`；Docker Desktop 容器可使用
+`http://host.docker.internal:28772/v1`。
+
+```bash
+export AGENT_SQUAD_BASE_URL=http://127.0.0.1:28772/v1
+export AGENT_SQUAD_API_KEY=asqsk_your_key
+
+curl "$AGENT_SQUAD_BASE_URL/models" \
+  -H "Authorization: Bearer $AGENT_SQUAD_API_KEY"
+
+curl "$AGENT_SQUAD_BASE_URL/chat/completions" \
+  -H "Authorization: Bearer $AGENT_SQUAD_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "codex-gpt56-max",
+    "messages": [{"role":"user","content":"解释这个仓库。"}],
+    "stream": true
+  }'
+```
+
+请求中的 model 是已启用 target 的 ID 或其 alias。未配置的模型会被拒绝。
+
+## 工具调用边界
+
+API tool call 属于客户端：客户端在请求中提交 OpenAI function 定义，执行 Gateway 返回的调用，
+再在下一轮提交工具结果。Gateway 不会把 provider CLI 的个人工具、MCP server、skill 或 workspace
+作为 API 工具暴露。
+
+## CLI
+
+```bash
+agent-squad-gateway start [--foreground] [--address ADDRESS] [--port PORT]
+agent-squad-gateway stop
+agent-squad-gateway status
+agent-squad-gateway open
+agent-squad-gateway doctor
+```
+
+配置优先级从低到高为：内置默认值、`config.json`、环境变量、CLI 参数。支持的环境变量包括：
+
+```bash
+AGENT_SQUAD_GATEWAY_ADDRESS=127.0.0.1
+AGENT_SQUAD_GATEWAY_PORT=28772
+AGENT_SQUAD_GATEWAY_WEB_UI_AUTH=token
+```
+
+## 本地状态
+
+Gateway 状态保存在 `~/.agent-squad/gateway/`。其中 `gateway.db` 保存 target、client、加密凭据、
+授权和运行元数据；`master.key` 用于解密可恢复的 API Key；`workspaces/` 保存 Gateway 管理的
+provider workspace。API Key 可以在本地管理界面中重新显示，因此必须同时保护 `gateway.db` 和
+`master.key`。
+
+## 安全
+
+Gateway 是本地开发基础设施，不是公网服务。不要通过公网路由器或反向代理暴露它。启用局域网或
+容器访问、使用固定 workspace、或处理敏感内容前，请阅读 [SECURITY.md](../SECURITY.md)。
+
+## 开发与测试
+
+```bash
+npm ci
+npm run build
+npm test
+```
+
+默认测试使用 fake provider，不会调用真实模型。真实 provider 测试必须显式指定 target，且可能
+消耗额度：
+
+```bash
+GATEWAY_REAL_TARGETS=target_a,target_b npm run test:real-providers
+```
+
+## License
+
+[MIT](../LICENSE)