@nativemind108/mcp 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +28 -0
- package/LICENSE +289 -0
- package/NOTICE +5 -0
- package/README.md +53 -2
- package/dist/cjs/access.d.ts +41 -0
- package/dist/cjs/access.js +28 -0
- package/dist/cjs/access.js.map +1 -0
- package/dist/cjs/catalog.d.ts +21 -0
- package/dist/cjs/catalog.js +54 -0
- package/dist/cjs/catalog.js.map +1 -0
- package/dist/cjs/client.d.ts +67 -0
- package/dist/cjs/client.js +123 -0
- package/dist/cjs/client.js.map +1 -0
- package/dist/cjs/define.d.ts +50 -0
- package/dist/cjs/define.js +27 -0
- package/dist/cjs/define.js.map +1 -0
- package/dist/cjs/feedback.d.ts +21 -0
- package/dist/cjs/feedback.js +93 -0
- package/dist/cjs/feedback.js.map +1 -0
- package/dist/cjs/http.d.ts +15 -0
- package/dist/cjs/http.js +213 -0
- package/dist/cjs/http.js.map +1 -0
- package/dist/cjs/hub.d.ts +51 -0
- package/dist/cjs/hub.js +346 -0
- package/dist/cjs/hub.js.map +1 -0
- package/dist/cjs/index.d.ts +11 -0
- package/dist/cjs/index.js +29 -0
- package/dist/cjs/index.js.map +1 -0
- package/dist/cjs/options.d.ts +168 -0
- package/dist/cjs/options.js +3 -0
- package/dist/cjs/options.js.map +1 -0
- package/dist/cjs/output.d.ts +23 -0
- package/dist/cjs/output.js +88 -0
- package/dist/cjs/output.js.map +1 -0
- package/dist/cjs/package.json +3 -0
- package/dist/cjs/service.d.ts +68 -0
- package/dist/cjs/service.js +98 -0
- package/dist/cjs/service.js.map +1 -0
- package/dist/cjs/tools.d.ts +31 -0
- package/dist/cjs/tools.js +124 -0
- package/dist/cjs/tools.js.map +1 -0
- package/dist/esm/access.d.ts +42 -0
- package/dist/esm/access.d.ts.map +1 -0
- package/dist/esm/access.js +24 -0
- package/dist/esm/access.js.map +1 -0
- package/dist/esm/catalog.d.ts +22 -0
- package/dist/esm/catalog.d.ts.map +1 -0
- package/dist/esm/catalog.js +50 -0
- package/dist/esm/catalog.js.map +1 -0
- package/dist/esm/client.d.ts +68 -0
- package/dist/esm/client.d.ts.map +1 -0
- package/dist/esm/client.js +118 -0
- package/dist/esm/client.js.map +1 -0
- package/dist/esm/define.d.ts +51 -0
- package/dist/esm/define.d.ts.map +1 -0
- package/dist/esm/define.js +23 -0
- package/dist/esm/define.js.map +1 -0
- package/dist/esm/feedback.d.ts +22 -0
- package/dist/esm/feedback.d.ts.map +1 -0
- package/dist/esm/feedback.js +89 -0
- package/dist/esm/feedback.js.map +1 -0
- package/dist/esm/http.d.ts +16 -0
- package/dist/esm/http.d.ts.map +1 -0
- package/dist/esm/http.js +206 -0
- package/dist/esm/http.js.map +1 -0
- package/dist/esm/hub.d.ts +52 -0
- package/dist/esm/hub.d.ts.map +1 -0
- package/dist/esm/hub.js +337 -0
- package/dist/esm/hub.js.map +1 -0
- package/dist/esm/index.d.ts +12 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +13 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/options.d.ts +169 -0
- package/dist/esm/options.d.ts.map +1 -0
- package/dist/esm/options.js +2 -0
- package/dist/esm/options.js.map +1 -0
- package/dist/esm/output.d.ts +24 -0
- package/dist/esm/output.d.ts.map +1 -0
- package/dist/esm/output.js +79 -0
- package/dist/esm/output.js.map +1 -0
- package/dist/esm/service.d.ts +69 -0
- package/dist/esm/service.d.ts.map +1 -0
- package/dist/esm/service.js +93 -0
- package/dist/esm/service.js.map +1 -0
- package/dist/esm/tools.d.ts +32 -0
- package/dist/esm/tools.d.ts.map +1 -0
- package/dist/esm/tools.js +118 -0
- package/dist/esm/tools.js.map +1 -0
- package/package.json +59 -4
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 1.1.0 — 2026-11-15 (not published yet; SDD `sdd-konsilium-mcp-local`, Konsilium tasks #397/#398/#399)
|
|
4
|
+
|
|
5
|
+
All additive; 1.0.x code keeps working unchanged.
|
|
6
|
+
|
|
7
|
+
- **Access policy** (`AccessPolicy`, `ToolRequirement`, `ToolDefinition.requires`, `McpRoute.access` / `options.access`):
|
|
8
|
+
hand-written tools the policy refuses are hidden from tools/list and refused on call with `ACCESS_DENIED` and a hint for
|
|
9
|
+
clients that cache tools/list (`accessDeniedResult`); evaluated live on every list/call. Hiding is not protection —
|
|
10
|
+
the product API still checks every call. `ToolCallContext.hidden()` lists hidden tools with what they need.
|
|
11
|
+
- **`toolsChanged(match?)`** on the service (and `KeyHub` / `HubPool.notifyToolsChanged`): rights changed → matching open
|
|
12
|
+
sessions (`SessionInfo`: route, params, session, keyHash) get notifications/tools/list_changed.
|
|
13
|
+
- **`runCli(build, opts)`**: one `bin` runner — NM_MCP_* config, stdio or `--http`, `--help`, config errors → stderr + exit 2,
|
|
14
|
+
clean shutdown via core `onShutdown`. `mcpConfigFromEnv(..., { allowNoKey })`: stdio without a key (local-only tools).
|
|
15
|
+
- Feedback tools validate their arguments (JSON Schema of the contract) before calling the API.
|
|
16
|
+
- Tests: access policy and toolsChanged, stdio over a real pipe (runCli, no key), prompts, resources, config parsing.
|
|
17
|
+
|
|
18
|
+
## 1.0.1 — 2026-11-14 (not published yet)
|
|
19
|
+
|
|
20
|
+
- **Security:** on a session key mismatch the OAuth grant of the new token is checked with a standalone client; the shared hub client is re-keyed only after the check passed (before, a refused token stayed on the hub client).
|
|
21
|
+
- Per-session API clients (`ApiClient.withHeaders`, `withKey`): `X-NM-MCP-Client` no longer races between sessions sharing a key or the anonymous hub.
|
|
22
|
+
- `McpRoute.authorize` (session data / custom refusal), `serverName`, `filterAll`; `ToolCallContext.request`, `extra` = session data.
|
|
23
|
+
- `api.envelope: 'none'` for APIs without `{data, meta}`; string `error` bodies.
|
|
24
|
+
- `transports.http.resourceMetadata`, `lenientJson`; `resources.subscribe`; `ToolDefinition.listFields`; `CallRecord.client`, `errorCode`, `session`.
|
|
25
|
+
|
|
26
|
+
## 1.0.0 — 2026-11-14
|
|
27
|
+
|
|
28
|
+
- First release of `@nativemind108/mcp` (SDD `sdd-nativemind-backend-handmade`, 2026-11-14).
|
package/LICENSE
ADDED
|
@@ -0,0 +1,289 @@
|
|
|
1
|
+
# ข้อตกลงสิทธิการใช้งาน NativeMindNONC (ประเทศไทย)
|
|
2
|
+
|
|
3
|
+
### 1. ข้อกำหนดทั่วไป
|
|
4
|
+
|
|
5
|
+
ข้อตกลงนี้อยู่ภายใต้บังคับของพระราชบัญญัติลิขสิทธิ์ พ.ศ. 2537 และแก้ไขเพิ่มเติม รวมถึงประมวลกฎหมายแพ่งและพาณิชย์แห่งราชอาณาจักรไทย
|
|
6
|
+
|
|
7
|
+
ผู้ถือลิขสิทธิ์: บริษัทผู้พัฒนาซอฟต์แวร์
|
|
8
|
+
|
|
9
|
+
เครื่องหมายการค้าของผลิตภัณฑ์ได้รับการจดทะเบียนและถือครองโดยผู้ถือลิขสิทธิ์
|
|
10
|
+
|
|
11
|
+
ลิขสิทธิ์ © 2010-2025 ผู้ถือลิขสิทธิ์ สงวนลิขสิทธิ์
|
|
12
|
+
|
|
13
|
+
### 2. เงื่อนไขการใช้งาน
|
|
14
|
+
|
|
15
|
+
การใช้งานโปรแกรมซอฟต์แวร์ ("ผลิตภัณฑ์") ถือว่าท่านยอมรับข้อกำหนดและเงื่อนไขตามข้อตกลงฉบับนี้ หากท่านไม่ยอมรับ โปรดหยุดใช้งานผลิตภัณฑ์โดยทันที
|
|
16
|
+
|
|
17
|
+
#### 2.1. การเผยแพร่ซอร์สโค้ด
|
|
18
|
+
|
|
19
|
+
เมื่อท่านใช้งานซอร์สโค้ดของผลิตภัณฑ์ ท่านมีหน้าที่:
|
|
20
|
+
|
|
21
|
+
- เผยแพร่ซอร์สโค้ดของท่านผ่าน GitHub โดยทำเป็น Fork ของ Repository อย่างเป็นทางการ
|
|
22
|
+
- ปรับปรุงให้เป็นปัจจุบันอยู่เสมอเพื่อสะท้อนการเปลี่ยนแปลงจากต้นฉบับ
|
|
23
|
+
- ระบุให้ชัดเจนว่าซอร์สโค้ดของท่านเป็น Fork ของ Repository ดั้งเดิม
|
|
24
|
+
|
|
25
|
+
#### 2.2. การเผยแพร่อัตโนมัติ
|
|
26
|
+
|
|
27
|
+
การเผยแพร่ทุกครั้งต้องดำเนินการผ่าน GitHub Actions เท่านั้น
|
|
28
|
+
|
|
29
|
+
#### 2.3. การให้เครดิต (Attribution)
|
|
30
|
+
|
|
31
|
+
เมื่อเผยแพร่ผลิตภัณฑ์ที่ดัดแปลงจากผลิตภัณฑ์ต้นฉบับ ท่านต้อง:
|
|
32
|
+
|
|
33
|
+
- ระบุเครดิตของผู้ถือลิขสิทธิ์พร้อมลิงก์ไปที่ Repository ดั้งเดิม
|
|
34
|
+
- แสดงลิงก์ไปยังข้อตกลงสิทธิ์ดั้งเดิม
|
|
35
|
+
- บันทึกการเปลี่ยนแปลงใน README ของ Repository ของท่าน
|
|
36
|
+
|
|
37
|
+
#### 2.4. ห้ามการใส่มัลแวร์
|
|
38
|
+
|
|
39
|
+
ห้ามอย่างเด็ดขาดที่จะเพิ่มมัลแวร์หรือรหัสอันตรายใด ๆ ลงในผลิตภัณฑ์
|
|
40
|
+
|
|
41
|
+
#### 2.5. ข้อจำกัดการใช้ชื่อและอินเทอร์เฟซ
|
|
42
|
+
|
|
43
|
+
ห้ามเผยแพร่แอปพลิเคชันในร้านค้าแอปใดๆ เช่น Google Play, App Store, F-Droid, Microsoft Store, Huawei AppGallery หรือแพลตฟอร์มอื่นใดด้วยชื่อหรือหน้าตาที่คล้ายกับผลิตภัณฑ์ต้นฉบับจนอาจทำให้เกิดความเข้าใจผิด
|
|
44
|
+
|
|
45
|
+
#### 2.6. การใช้งานเชิงพาณิชย์
|
|
46
|
+
|
|
47
|
+
**ฟรีสำหรับการใช้งานที่ไม่ใช่เชิงพาณิชย์**: ผลิตภัณฑ์นี้ฟรีสำหรับการใช้งานที่ไม่ใช่เชิงพาณิชย์ รวมถึง:
|
|
48
|
+
- สถาบันการศึกษา (โรงเรียน มหาวิทยาลัย วิทยาลัย)
|
|
49
|
+
- วัตถุประสงค์ทางการศึกษาและการฝึกอบรม
|
|
50
|
+
- การวิจัยและพัฒนาสำหรับโครงการที่ไม่ใช่เชิงพาณิชย์
|
|
51
|
+
- การเรียนรู้และการพัฒนาส่วนบุคคล
|
|
52
|
+
|
|
53
|
+
**การใช้งานเชิงพาณิชย์ต้องมีใบอนุญาต**: การใช้งานเชิงพาณิชย์ของผลิตภัณฑ์นี้ต้องได้รับอนุญาตเป็นลายลักษณ์อักษรจากผู้ถือลิขสิทธิ์ก่อนดำเนินการเชิงพาณิชย์ใดๆ รวมถึง:
|
|
54
|
+
- การขายหรือจำหน่ายเพื่อหากำไร
|
|
55
|
+
- การใช้งานในผลิตภัณฑ์หรือบริการเชิงพาณิชย์
|
|
56
|
+
- แอปพลิเคชันทางธุรกิจ
|
|
57
|
+
- กิจกรรมใดๆ ที่สร้างรายได้
|
|
58
|
+
|
|
59
|
+
#### 2.7. สิทธิของนักพัฒนาและโครงสร้างบริษัท
|
|
60
|
+
|
|
61
|
+
สิทธิทั้งหมดเป็นของนักพัฒนาที่เฉพาะเจาะจงซึ่งเป็นส่วนหนึ่งของบริษัทที่พัฒนาซอฟต์แวร์นี้ นักพัฒนาอาจ:
|
|
62
|
+
- นำเสนอโค้ดและผลงานในงานแสดงสินค้าและงานประชุม
|
|
63
|
+
- แสดงความสำเร็จทางเทคนิคของตนต่อสาธารณะ
|
|
64
|
+
- ใช้ผลงานของตนเพื่อพอร์ตโฟลิโอทางวิชาชีพและการพัฒนาอาชีพ
|
|
65
|
+
|
|
66
|
+
อย่างไรก็ตาม นักพัฒนาไม่สามารถ:
|
|
67
|
+
- ใช้โค้ดหรือผลงานเพื่อวัตถุประสงค์เชิงพาณิชย์ส่วนตัว
|
|
68
|
+
- อนุญาตให้ใช้ซอฟต์แวร์อย่างอิสระนอกเหนือจากโครงสร้างบริษัท
|
|
69
|
+
- โอนสิทธิเชิงพาณิชย์โดยไม่ได้รับอนุญาตจากบริษัท
|
|
70
|
+
|
|
71
|
+
การอนุญาตเชิงพาณิชย์ทั้งหมดต้องดำเนินการผ่านบริษัทที่จ้างนักพัฒนาเหล่านี้
|
|
72
|
+
|
|
73
|
+
#### 2.8. การเผยแพร่ภายใต้เงื่อนไขเดียวกัน (ShareAlike)
|
|
74
|
+
|
|
75
|
+
ผลงานที่สร้างจากผลิตภัณฑ์นี้ต้องถูกเผยแพร่ภายใต้ข้อตกลงสิทธิ์เดียวกันและในรูปแบบ Open Source ผ่านการ Fork จาก Repository ดั้งเดิม
|
|
76
|
+
|
|
77
|
+
### 3. การใช้งานส่วนประกอบ Open Source
|
|
78
|
+
|
|
79
|
+
ผลิตภัณฑ์ประกอบด้วยส่วนประกอบ Open Source ที่ได้รับอนุญาตตามเงื่อนไขอื่นๆ การใช้งานผลิตภัณฑ์หมายถึงท่านยอมรับเงื่อนไขของแต่ละส่วนประกอบด้วย รายละเอียดระบุไว้ในไฟล์ LICENSE.md ที่แนบมาพร้อมผลิตภัณฑ์
|
|
80
|
+
|
|
81
|
+
### 4. การปฏิเสธความรับผิด
|
|
82
|
+
|
|
83
|
+
ผลิตภัณฑ์นี้ให้บริการ "ตามสภาพ" โดยไม่มีการรับประกันใดๆ ทั้งสิ้น ไม่ว่าจะแจ้งชัดหรือโดยนัย รวมถึงการรับประกันด้านความเหมาะสมกับวัตถุประสงค์เฉพาะใดๆ และผู้ถือลิขสิทธิ์จะไม่รับผิดชอบต่อความเสียหายใดๆ อันเกิดจากการใช้งานผลิตภัณฑ์นี้
|
|
84
|
+
|
|
85
|
+
### 5. การละเมิดข้อตกลง
|
|
86
|
+
|
|
87
|
+
ในกรณีที่มีการละเมิดข้อตกลงนี้ ผู้ถือลิขสิทธิ์มีสิทธิ์ขอให้หยุดเผยแพร่ผลิตภัณฑ์ และอาจดำเนินการทางกฎหมายหรือแจ้งไปยังร้านค้าแอปพลิเคชันเพื่อให้มีการลบหรือระงับการเผยแพร่ผลิตภัณฑ์ที่ละเมิด
|
|
88
|
+
|
|
89
|
+
ข้อพิพาทใดๆ จะต้องได้รับการตัดสินตามกฎหมายแห่งราชอาณาจักรไทย
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
การใช้งานผลิตภัณฑ์หมายถึงท่านได้อ่าน เข้าใจ และยอมรับข้อกำหนดและเงื่อนไขทั้งหมดตามข้อตกลงนี้แล้ว
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## Лицензионное соглашение (Российская Федерация)
|
|
98
|
+
|
|
99
|
+
### 1. Общие положения
|
|
100
|
+
|
|
101
|
+
Настоящая лицензия регулируется нормами Гражданского кодекса Российской Федерации (часть IV, статьи 1225-1301) и иных применимых законодательных актов РФ.
|
|
102
|
+
|
|
103
|
+
Правообладатель: Компания-разработчик программного обеспечения
|
|
104
|
+
|
|
105
|
+
Товарный знак продукта зарегистрирован и принадлежит правообладателю.
|
|
106
|
+
|
|
107
|
+
© 2010-2025 Правообладатель. Все права защищены.
|
|
108
|
+
|
|
109
|
+
### 2. Условия использования
|
|
110
|
+
|
|
111
|
+
Используя программный продукт ("Продукт"), вы подтверждаете согласие с условиями настоящей лицензии. В случае несогласия вы обязаны немедленно прекратить использование и распространение Продукта.
|
|
112
|
+
|
|
113
|
+
#### 2.1. Доступность исходного кода
|
|
114
|
+
|
|
115
|
+
При использовании исходного кода Продукта вы обязаны:
|
|
116
|
+
|
|
117
|
+
- Опубликовать производный код исключительно в виде публичного репозитория на платформе GitHub в виде форка официального репозитория
|
|
118
|
+
- Своевременно обновлять свой репозиторий, отражая изменения в официальных релизах
|
|
119
|
+
- Указывать в репозитории, что он является форком официального репозитория
|
|
120
|
+
|
|
121
|
+
#### 2.2. Автоматизация релизов
|
|
122
|
+
|
|
123
|
+
Все релизы Продукта должны осуществляться исключительно через GitHub Actions.
|
|
124
|
+
|
|
125
|
+
#### 2.3. Обязательная атрибуция
|
|
126
|
+
|
|
127
|
+
При распространении производного Продукта вы обязаны:
|
|
128
|
+
|
|
129
|
+
- Указывать автора и давать соответствующую ссылку на официальный репозиторий
|
|
130
|
+
- Размещать ссылку на оригинальную лицензию
|
|
131
|
+
- Документировать изменения, сделанные вами в README вашего репозитория
|
|
132
|
+
|
|
133
|
+
#### 2.4. Запрет вредоносного ПО
|
|
134
|
+
|
|
135
|
+
Категорически запрещается встраивать любое вредоносное программное обеспечение (вирусы, трояны и т.п.).
|
|
136
|
+
|
|
137
|
+
#### 2.5. Ограничения на использование имени и интерфейса
|
|
138
|
+
|
|
139
|
+
Запрещается публикация производных продуктов под названием или с пользовательским интерфейсом, сходным до степени смешения с оригинальным продуктом, на любых площадках распространения программного обеспечения (например, Google Play, App Store, RuStore, NashStore, AppGallery, VK Play и других площадках).
|
|
140
|
+
|
|
141
|
+
#### 2.6. Некоммерческое использование
|
|
142
|
+
|
|
143
|
+
**Бесплатно для некоммерческого использования**: Данный продукт бесплатен для некоммерческого использования, включая:
|
|
144
|
+
- Образовательные учреждения (школы, университеты, колледжи)
|
|
145
|
+
- Образовательные и обучающие цели
|
|
146
|
+
- Исследования и разработки для некоммерческих проектов
|
|
147
|
+
- Личное обучение и развитие
|
|
148
|
+
|
|
149
|
+
**Коммерческое использование требует лицензии**: Использование Продукта в коммерческих целях (продажа, реклама, иные коммерческие операции) допускается исключительно после письменного согласия правообладателя.
|
|
150
|
+
|
|
151
|
+
#### 2.7. Права разработчиков и структура компании
|
|
152
|
+
|
|
153
|
+
Все права принадлежат конкретным разработчикам, которые входят в состав компании, разрабатывающей данное программное обеспечение. Разработчики могут:
|
|
154
|
+
- Представлять код и результаты работы на выставках и конференциях
|
|
155
|
+
- Демонстрировать свои технические достижения публично
|
|
156
|
+
- Использовать свою работу для профессионального портфолио и развития карьеры
|
|
157
|
+
|
|
158
|
+
Однако разработчики не могут:
|
|
159
|
+
- Использовать код или результаты работы для личных коммерческих целей
|
|
160
|
+
- Лицензировать программное обеспечение независимо вне структуры компании
|
|
161
|
+
- Передавать коммерческие права без разрешения компании
|
|
162
|
+
|
|
163
|
+
Все коммерческое лицензирование должно проводиться через компанию, которая нанимает этих разработчиков.
|
|
164
|
+
|
|
165
|
+
#### 2.8. Условие аналогичного распространения (ShareAlike)
|
|
166
|
+
|
|
167
|
+
Любое изменение, адаптация или создание производных работ на основе Продукта должно распространяться исключительно на условиях настоящей лицензии и с открытым исходным кодом через форк официального репозитория.
|
|
168
|
+
|
|
169
|
+
### 3. Использование компонентов с открытым исходным кодом
|
|
170
|
+
|
|
171
|
+
Продукт содержит компоненты с открытым исходным кодом, лицензируемые отдельно. Пользуясь Продуктом, вы принимаете условия лицензий каждого компонента. Подробности указаны в файле LICENSE.md, входящем в комплект поставки.
|
|
172
|
+
|
|
173
|
+
### 4. Ответственность сторон
|
|
174
|
+
|
|
175
|
+
Продукт предоставляется «как есть», без каких-либо гарантий, явных или подразумеваемых, в том числе гарантий пригодности для определённых целей и отсутствия нарушений прав третьих лиц. Правообладатель не несёт ответственности за убытки, возникающие вследствие использования или невозможности использования Продукта.
|
|
176
|
+
|
|
177
|
+
### 5. Нарушение условий лицензии
|
|
178
|
+
|
|
179
|
+
При нарушении условий настоящей лицензии правообладатель вправе требовать прекращения распространения Продукта, а также обратиться в суд или обратиться с жалобой в соответствующие площадки распространения программного обеспечения для удаления или ограничения доступа к нарушающим продуктам.
|
|
180
|
+
|
|
181
|
+
Споры разрешаются в порядке, установленном законодательством Российской Федерации.
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
Используя Продукт, вы подтверждаете, что прочитали, поняли и полностью принимаете условия настоящей лицензии.
|
|
186
|
+
|
|
187
|
+
---
|
|
188
|
+
|
|
189
|
+
## License Agreement (English)
|
|
190
|
+
|
|
191
|
+
### 1. General Provisions
|
|
192
|
+
|
|
193
|
+
This agreement is governed by copyright laws and intellectual property regulations of the jurisdiction where the software is used.
|
|
194
|
+
|
|
195
|
+
Copyright Holder: Software Development Company
|
|
196
|
+
|
|
197
|
+
The product trademark is registered and owned by the copyright holder.
|
|
198
|
+
|
|
199
|
+
Copyright © 2010-2025 Copyright Holder. All rights reserved.
|
|
200
|
+
|
|
201
|
+
### 2. Usage Terms
|
|
202
|
+
|
|
203
|
+
By using the software product ("Product"), you agree to accept the terms and conditions of this agreement. If you do not agree, please stop using the product immediately.
|
|
204
|
+
|
|
205
|
+
#### 2.1. Source Code Publication
|
|
206
|
+
|
|
207
|
+
When using the source code of the Product, you are obligated to:
|
|
208
|
+
|
|
209
|
+
- Publish your source code through GitHub by creating a Fork of the official Repository
|
|
210
|
+
- Keep it updated to reflect changes from the original
|
|
211
|
+
- Clearly indicate that your source code is a Fork of the original Repository
|
|
212
|
+
|
|
213
|
+
#### 2.2. Automatic Publication
|
|
214
|
+
|
|
215
|
+
All publications must be conducted through GitHub Actions only.
|
|
216
|
+
|
|
217
|
+
#### 2.3. Attribution
|
|
218
|
+
|
|
219
|
+
When publishing products derived from the original Product, you must:
|
|
220
|
+
|
|
221
|
+
- Credit the copyright holder with a link to the original Repository
|
|
222
|
+
- Display a link to the original license agreement
|
|
223
|
+
- Record changes in the README of your Repository
|
|
224
|
+
|
|
225
|
+
#### 2.4. Malware Prohibition
|
|
226
|
+
|
|
227
|
+
It is strictly prohibited to add malware or any dangerous code to the product.
|
|
228
|
+
|
|
229
|
+
#### 2.5. Name and Interface Usage Restrictions
|
|
230
|
+
|
|
231
|
+
It is prohibited to publish applications in any app store (Google Play, App Store, F-Droid, Microsoft Store, Huawei AppGallery, or other platforms) with names or interfaces similar to the original product that may cause confusion.
|
|
232
|
+
|
|
233
|
+
#### 2.6. Commercial Use
|
|
234
|
+
|
|
235
|
+
**Free for Non-Commercial Use**: This product is free for non-commercial use including:
|
|
236
|
+
- Educational institutions (schools, universities, colleges)
|
|
237
|
+
- Educational and training purposes
|
|
238
|
+
- Research and development for non-commercial projects
|
|
239
|
+
- Personal learning and development
|
|
240
|
+
|
|
241
|
+
**Commercial Use Requires License**: Commercial use of this product requires a written license agreement from the copyright holder before any commercial activities including:
|
|
242
|
+
- Selling or distributing for profit
|
|
243
|
+
- Using in commercial products or services
|
|
244
|
+
- Business applications
|
|
245
|
+
- Any revenue-generating activities
|
|
246
|
+
|
|
247
|
+
#### 2.7. Developer Rights and Company Structure
|
|
248
|
+
|
|
249
|
+
All rights belong to specific developers who are part of the company that develops this software. Developers may:
|
|
250
|
+
- Present code and work results at exhibitions and conferences
|
|
251
|
+
- Showcase their technical achievements publicly
|
|
252
|
+
- Use their work for professional portfolio and career development
|
|
253
|
+
|
|
254
|
+
However, developers cannot:
|
|
255
|
+
- Use the code or work results for personal commercial purposes
|
|
256
|
+
- License the software independently outside the company structure
|
|
257
|
+
- Transfer commercial rights without company authorization
|
|
258
|
+
|
|
259
|
+
All commercial licensing must be conducted through the company that employs these developers.
|
|
260
|
+
|
|
261
|
+
#### 2.8. License Standardization
|
|
262
|
+
|
|
263
|
+
This license may become a standard and other companies may copy the license text for their own use, similar to MIT, Apache, or GPL licenses.
|
|
264
|
+
|
|
265
|
+
#### 2.9. ShareAlike Requirement
|
|
266
|
+
|
|
267
|
+
Any work created from this product must be published under the same license terms and in open source format through a Fork from the original Repository.
|
|
268
|
+
|
|
269
|
+
### 3. Open Source Components
|
|
270
|
+
|
|
271
|
+
The Product includes Open Source components licensed under different terms. Using the Product means you accept the terms of each component as well. Details are specified in the LICENSE.md file included with the product.
|
|
272
|
+
|
|
273
|
+
### 4. Disclaimer
|
|
274
|
+
|
|
275
|
+
This product is provided "as is" without any warranties, whether express or implied, including warranties of merchantability, fitness for a particular purpose, and non-infringement. The copyright holder shall not be liable for any damages arising from the use of this product.
|
|
276
|
+
|
|
277
|
+
### 5. License Violations
|
|
278
|
+
|
|
279
|
+
In case of violation of this agreement, the copyright holder has the right to request cessation of product distribution and may take legal action or notify app stores to remove or suspend distribution of violating products.
|
|
280
|
+
|
|
281
|
+
Any disputes shall be resolved according to the laws of the jurisdiction where the copyright holder is incorporated.
|
|
282
|
+
|
|
283
|
+
---
|
|
284
|
+
|
|
285
|
+
Using the Product means you have read, understood, and accepted all terms and conditions of this agreement.
|
|
286
|
+
|
|
287
|
+
---
|
|
288
|
+
|
|
289
|
+
# NativeMindNONC License Agreement
|
package/NOTICE
ADDED
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
@nativemind108/mcp
|
|
2
|
+
Copyright (c) NativeMind. Licensed under the NativeMindNONC License (see LICENSE).
|
|
3
|
+
|
|
4
|
+
Hand-written code by people is marked in the source with "written by <Author> (without AI), <date>".
|
|
5
|
+
Code written with AI tools is marked "generated by <tool> (<model>), <date>".
|
package/README.md
CHANGED
|
@@ -1,3 +1,54 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @nativemind108/mcp
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
The MCP server of a NativeMind product as a **separate service**. It never touches a database: it calls the product API over
|
|
4
|
+
HTTP with the caller's bearer (`X-NM-Client: mcp`). Streamable HTTP (with RFC 9728 OAuth metadata) or stdio; optional legacy
|
|
5
|
+
HTTP+SSE.
|
|
6
|
+
|
|
7
|
+
Tools come from three places:
|
|
8
|
+
|
|
9
|
+
1. **The API catalog** — `GET {basePath}/meta/operations?mcpOnly=true` (see `@nativemind108/api` `catalogOperation`), refreshed
|
|
10
|
+
every minute; `tools/list_changed` when the key policy changes.
|
|
11
|
+
2. **Hand-written tools** of the product — `defineTool({ name, input: { …zod… }, call: (args, { api }) => api.request(…) })`.
|
|
12
|
+
3. **Feedback tools**, always on: `report_bug`, `suggest_improvement`, `leave_review`, `add_feedback_note`, `my_feedback`.
|
|
13
|
+
|
|
14
|
+
```ts
|
|
15
|
+
import { mcpConfigFromEnv, startMcpService } from '@nativemind108/mcp';
|
|
16
|
+
|
|
17
|
+
const cfg = mcpConfigFromEnv(process.env, process.argv.slice(2), { prefix: 'DX_MCP' }); // NM_MCP_* (+ old DX_MCP_* names)
|
|
18
|
+
await startMcpService({
|
|
19
|
+
product: { name: 'demo-mcp', title: 'Demo', instructions: 'Demo tools …' },
|
|
20
|
+
api: { url: cfg.apiUrl, basePath: '/v1' },
|
|
21
|
+
transports: cfg.http ? { http: { ...cfg.http, publicUrl: cfg.publicUrl, authServers: cfg.authServers } } : { stdio: { apiKey: cfg.apiKey } },
|
|
22
|
+
catalog: { enabled: true, toolsets: cfg.toolsets, jobs: { path: '/v1/jobs' } },
|
|
23
|
+
limits: { maxRows: cfg.maxRows, maxBytes: cfg.maxBytes },
|
|
24
|
+
});
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Environment: `NM_MCP_API_URL`, `NM_MCP_TRANSPORT=http` (or `--http`), `NM_MCP_HTTP_HOST`, `NM_MCP_HTTP_PORT`, `NM_MCP_PUBLIC_URL`,
|
|
28
|
+
`NM_MCP_AUTH_SERVER`, `NM_MCP_API_KEY` (stdio), `NM_MCP_TOOLSETS`, `NM_MCP_MAX_ROWS`, `NM_MCP_MAX_BYTES`, `NM_MCP_REFRESH_MS`.
|
|
29
|
+
|
|
30
|
+
License: NativeMindNONC (see LICENSE).
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
## Access policy and local runner (1.1)
|
|
34
|
+
|
|
35
|
+
```ts
|
|
36
|
+
import { runCli, defineTool, type AccessPolicy } from '@nativemind108/mcp';
|
|
37
|
+
|
|
38
|
+
const policy: AccessPolicy = {
|
|
39
|
+
allowed: (req, _tool, ctx) => !req || rightsOf(ctx.session).includes(req.scope), // the product's rules
|
|
40
|
+
refusal: (tool) => `No access to ${tool}. The person changes access at https://…`,
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
await runCli((cfg) => ({
|
|
44
|
+
product: { name: 'my-mcp', title: 'My product' },
|
|
45
|
+
api: { url: cfg.apiUrl, basePath: '/api' },
|
|
46
|
+
transports: cfg.http ? { http: cfg.http } : { stdio: { apiKey: cfg.apiKey } },
|
|
47
|
+
access: policy,
|
|
48
|
+
routes: [{ path: '/mcp', tools: () => [defineTool({ name: 'next_task', title: 'Next task', description: '…', input: {}, requires: { scope: 'tasks:work' }, call: async (_a, ctx) => (await ctx.api.request('GET', '/api/tasks/next')).body })] }],
|
|
49
|
+
}), { allowNoKey: true });
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
- Tools without `requires` are always listed (feedback tools, «my access»).
|
|
53
|
+
- When rights change, call `service.toolsChanged((s) => s.session.userId === id)` — open sessions re-list.
|
|
54
|
+
- A tool hidden after the client cached tools/list is refused with `ACCESS_DENIED` and a re-list hint.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
|
|
2
|
+
import type { RouteContext } from './options.js';
|
|
3
|
+
/**
|
|
4
|
+
* What a tool needs. The package does not interpret it: `scope` / `kind` are the product's words (Konsilium:
|
|
5
|
+
* kind 'project' | 'me' | 'global', scope 'tasks:work' …). `also` = a second requirement that must hold too.
|
|
6
|
+
*/
|
|
7
|
+
export interface ToolRequirement {
|
|
8
|
+
scope: string;
|
|
9
|
+
kind?: string;
|
|
10
|
+
also?: ToolRequirement;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* The product's access policy (Konsilium: @consilium108/mcp). Evaluated live on every tools/list and tools/call, so a
|
|
14
|
+
* changed right applies at once; hiding is not protection — the API still checks every call.
|
|
15
|
+
*/
|
|
16
|
+
export interface AccessPolicy {
|
|
17
|
+
/** May this session use the tool now? `requires` undefined = a tool without a right (always allowed by default). */
|
|
18
|
+
allowed(requires: ToolRequirement | undefined, tool: string, ctx: RouteContext): boolean;
|
|
19
|
+
/** Refusal text for a hidden tool called anyway (where the person changes access). Default: a generic text. */
|
|
20
|
+
refusal?(tool: string, requires: ToolRequirement | undefined, ctx: RouteContext): string;
|
|
21
|
+
}
|
|
22
|
+
/** A tool hidden from this session and what it needs — for an «access» tool, so the model can tell the person what to ask for. */
|
|
23
|
+
export interface HiddenTool {
|
|
24
|
+
name: string;
|
|
25
|
+
needs: string[];
|
|
26
|
+
kind: string | null;
|
|
27
|
+
}
|
|
28
|
+
/** Session descriptor passed to `toolsChanged(match)` — choose which open sessions re-list their tools. */
|
|
29
|
+
export interface SessionInfo {
|
|
30
|
+
route: string;
|
|
31
|
+
params: Record<string, string>;
|
|
32
|
+
session: Record<string, unknown>;
|
|
33
|
+
keyHash: string | null;
|
|
34
|
+
}
|
|
35
|
+
/** Flattened scope list of a requirement (`also` chain). */
|
|
36
|
+
export declare function needsOf(requires: ToolRequirement | undefined): string[];
|
|
37
|
+
/**
|
|
38
|
+
* The refusal returned for a tool the policy hides (the client may still have it in a cached tools/list). It tells
|
|
39
|
+
* caching clients to re-list; `ACCESS_DENIED` is the error code in structuredContent.
|
|
40
|
+
*/
|
|
41
|
+
export declare function accessDeniedResult(tool: string, requires: ToolRequirement | undefined, text?: string): CallToolResult;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.needsOf = needsOf;
|
|
4
|
+
exports.accessDeniedResult = accessDeniedResult;
|
|
5
|
+
// generated by Claude (Opus 5.5), 2026-11-15; SDD sdd-konsilium-mcp-local
|
|
6
|
+
/** Flattened scope list of a requirement (`also` chain). */
|
|
7
|
+
function needsOf(requires) {
|
|
8
|
+
const out = [];
|
|
9
|
+
for (let r = requires; r; r = r.also)
|
|
10
|
+
out.push(r.scope);
|
|
11
|
+
return out;
|
|
12
|
+
}
|
|
13
|
+
// generated by Claude (Opus 5.5), 2026-11-15; SDD sdd-konsilium-mcp-local
|
|
14
|
+
/**
|
|
15
|
+
* The refusal returned for a tool the policy hides (the client may still have it in a cached tools/list). It tells
|
|
16
|
+
* caching clients to re-list; `ACCESS_DENIED` is the error code in structuredContent.
|
|
17
|
+
*/
|
|
18
|
+
function accessDeniedResult(tool, requires, text) {
|
|
19
|
+
const needs = needsOf(requires);
|
|
20
|
+
const message = text ?? `Tool ${tool} is not available to this connection now${needs.length ? ` (needs: ${needs.join(', ')})` : ''}. Only the person can change access.`;
|
|
21
|
+
const hint = 'If your tool list is cached, request tools/list again.';
|
|
22
|
+
return {
|
|
23
|
+
isError: true,
|
|
24
|
+
content: [{ type: 'text', text: `${message} ${hint}` }],
|
|
25
|
+
structuredContent: { error: { code: 'ACCESS_DENIED', message, needs, hint } },
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=access.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"access.js","sourceRoot":"","sources":["../../src/access.ts"],"names":[],"mappings":";;AA6CA,0BAIC;AAOD,gDASC;AAtBD,0EAA0E;AAC1E,4DAA4D;AAC5D,SAAgB,OAAO,CAAC,QAAqC;IAC3D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,IAAY,EAAE,QAAqC,EAAE,IAAa;IACnG,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,IAAI,QAAQ,IAAI,2CAA2C,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,sCAAsC,CAAC;IACzK,MAAM,IAAI,GAAG,wDAAwD,CAAC;IACtE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,IAAI,IAAI,EAAE,EAAE,CAAC;QACvD,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;KAC9E,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { ApiClient, CatalogOperation } from './client.js';
|
|
2
|
+
/**
|
|
3
|
+
* The operations one key may use over MCP: the API catalog (already filtered by the key policy) narrowed by the
|
|
4
|
+
* configured toolsets, without 501 stubs. `refresh()` reports whether the set changed (→ tools/list_changed).
|
|
5
|
+
*/
|
|
6
|
+
export declare class Catalog {
|
|
7
|
+
private readonly client;
|
|
8
|
+
private readonly toolsets;
|
|
9
|
+
private ops;
|
|
10
|
+
private fingerprint;
|
|
11
|
+
private loaded;
|
|
12
|
+
private inflight;
|
|
13
|
+
/** Epoch ms of the last successful fetch (0 = never). */
|
|
14
|
+
loadedAt: number;
|
|
15
|
+
constructor(client: ApiClient, toolsets: Set<string> | null);
|
|
16
|
+
get operations(): CatalogOperation[];
|
|
17
|
+
get isLoaded(): boolean;
|
|
18
|
+
byToolName(name: string): CatalogOperation | undefined;
|
|
19
|
+
/** Re-reads the catalog; resolves true when the exposed operation set changed. Concurrent calls share one fetch. */
|
|
20
|
+
refresh(): Promise<boolean>;
|
|
21
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.Catalog = void 0;
|
|
4
|
+
// generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade (from dropexpired services/mcp/src/catalog.ts)
|
|
5
|
+
/**
|
|
6
|
+
* The operations one key may use over MCP: the API catalog (already filtered by the key policy) narrowed by the
|
|
7
|
+
* configured toolsets, without 501 stubs. `refresh()` reports whether the set changed (→ tools/list_changed).
|
|
8
|
+
*/
|
|
9
|
+
class Catalog {
|
|
10
|
+
client;
|
|
11
|
+
toolsets;
|
|
12
|
+
ops = [];
|
|
13
|
+
fingerprint = '';
|
|
14
|
+
loaded = false;
|
|
15
|
+
inflight = null;
|
|
16
|
+
/** Epoch ms of the last successful fetch (0 = never). */
|
|
17
|
+
loadedAt = 0;
|
|
18
|
+
constructor(client, toolsets) {
|
|
19
|
+
this.client = client;
|
|
20
|
+
this.toolsets = toolsets;
|
|
21
|
+
}
|
|
22
|
+
get operations() {
|
|
23
|
+
return this.ops;
|
|
24
|
+
}
|
|
25
|
+
get isLoaded() {
|
|
26
|
+
return this.loaded;
|
|
27
|
+
}
|
|
28
|
+
byToolName(name) {
|
|
29
|
+
return this.ops.find((op) => op.mcp?.name === name);
|
|
30
|
+
}
|
|
31
|
+
/** Re-reads the catalog; resolves true when the exposed operation set changed. Concurrent calls share one fetch. */
|
|
32
|
+
refresh() {
|
|
33
|
+
this.inflight ??= (async () => {
|
|
34
|
+
try {
|
|
35
|
+
const all = await this.client.catalog();
|
|
36
|
+
const next = all.filter((op) => op.mcp && op.rest && op.implemented !== false && (!this.toolsets || this.toolsets.has(op.toolset)));
|
|
37
|
+
next.sort((a, b) => a.id.localeCompare(b.id));
|
|
38
|
+
const fingerprint = next.map((op) => `${op.id}:${op.safety}`).join('|');
|
|
39
|
+
const changed = this.loaded && fingerprint !== this.fingerprint;
|
|
40
|
+
this.ops = next;
|
|
41
|
+
this.fingerprint = fingerprint;
|
|
42
|
+
this.loaded = true;
|
|
43
|
+
this.loadedAt = Date.now();
|
|
44
|
+
return changed;
|
|
45
|
+
}
|
|
46
|
+
finally {
|
|
47
|
+
this.inflight = null;
|
|
48
|
+
}
|
|
49
|
+
})();
|
|
50
|
+
return this.inflight;
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
exports.Catalog = Catalog;
|
|
54
|
+
//# sourceMappingURL=catalog.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/catalog.ts"],"names":[],"mappings":";;;AAEA,iIAAiI;AACjI;;;GAGG;AACH,MAAa,OAAO;IAQW;IAAoC;IAPzD,GAAG,GAAuB,EAAE,CAAC;IAC7B,WAAW,GAAG,EAAE,CAAC;IACjB,MAAM,GAAG,KAAK,CAAC;IACf,QAAQ,GAA4B,IAAI,CAAC;IACjD,yDAAyD;IACzD,QAAQ,GAAG,CAAC,CAAC;IAEb,YAA6B,MAAiB,EAAmB,QAA4B;QAAhE,WAAM,GAAN,MAAM,CAAW;QAAmB,aAAQ,GAAR,QAAQ,CAAoB;IAAG,CAAC;IAEjG,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,oHAAoH;IACpH,OAAO;QACL,IAAI,CAAC,QAAQ,KAAK,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACpI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,KAAK,IAAI,CAAC,WAAW,CAAC;gBAChE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;gBAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC3B,OAAO,OAAO,CAAC;YACjB,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AA1CD,0BA0CC"}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import type { CatalogOperation } from '@nativemind108/api';
|
|
2
|
+
export type { CatalogOperation } from "@nativemind108/api";
|
|
3
|
+
export interface ApiEnvelope<T = unknown> {
|
|
4
|
+
data: T;
|
|
5
|
+
meta?: {
|
|
6
|
+
requestId?: string;
|
|
7
|
+
page?: {
|
|
8
|
+
nextCursor: string | null;
|
|
9
|
+
hasMore?: boolean;
|
|
10
|
+
total?: number;
|
|
11
|
+
totalEstimate?: number;
|
|
12
|
+
};
|
|
13
|
+
refresh?: {
|
|
14
|
+
id: string;
|
|
15
|
+
status: string;
|
|
16
|
+
kinds?: string[];
|
|
17
|
+
eta?: string | null;
|
|
18
|
+
reason?: string;
|
|
19
|
+
};
|
|
20
|
+
[extra: string]: unknown;
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
export declare class ApiCallError extends Error {
|
|
24
|
+
readonly status: number;
|
|
25
|
+
readonly code: string;
|
|
26
|
+
readonly details: unknown;
|
|
27
|
+
readonly preview?: unknown | undefined;
|
|
28
|
+
readonly requestId?: string | undefined;
|
|
29
|
+
constructor(status: number, code: string, message: string, details?: unknown, preview?: unknown | undefined, requestId?: string | undefined);
|
|
30
|
+
}
|
|
31
|
+
export interface ApiClientOptions {
|
|
32
|
+
/** Prefix of catalog and generic paths ('/v1', '/api/v1', '/api'). */
|
|
33
|
+
basePath: string;
|
|
34
|
+
/** Success body shape: 'data' = `{data, meta}` envelope (default), 'none' = the body itself is the data (Konsilium). */
|
|
35
|
+
envelope?: 'data' | 'none';
|
|
36
|
+
/** Headers marking the MCP service as the caller (default `X-NM-Client: mcp`; dx adds `X-DX-Client: mcp`). */
|
|
37
|
+
clientHeaders?: Record<string, string>;
|
|
38
|
+
userAgent?: string;
|
|
39
|
+
fetch?: typeof fetch;
|
|
40
|
+
/** Request timeout, ms (default 60 s). */
|
|
41
|
+
timeoutMs?: number;
|
|
42
|
+
}
|
|
43
|
+
/** Thin REST client of the product API (`{data, meta}` / `{error}`); every request carries the caller's bearer. */
|
|
44
|
+
export declare class ApiClient {
|
|
45
|
+
readonly baseUrl: string;
|
|
46
|
+
readonly options: ApiClientOptions;
|
|
47
|
+
private extra;
|
|
48
|
+
private readonly keyRef;
|
|
49
|
+
constructor(baseUrl: string, apiKey: string | null, options: ApiClientOptions, keyRef?: {
|
|
50
|
+
key: string | null;
|
|
51
|
+
});
|
|
52
|
+
/** OAuth access tokens rotate: a session of the same grant continues with the new token (shared by derived clients). */
|
|
53
|
+
setKey(apiKey: string | null): void;
|
|
54
|
+
/** Headers added to every request of this client. Prefer withHeaders() for per-session values. */
|
|
55
|
+
setHeaders(headers: Record<string, string>): void;
|
|
56
|
+
/** A client sharing this one's key (and key rotation) with extra headers of its own — one per MCP session. */
|
|
57
|
+
withHeaders(headers: Record<string, string>): ApiClient;
|
|
58
|
+
/** A standalone client with another key (identity checks must not touch shared clients). */
|
|
59
|
+
withKey(apiKey: string | null): ApiClient;
|
|
60
|
+
get basePath(): string;
|
|
61
|
+
request<T = unknown>(method: string, path: string, args?: Record<string, unknown>, headers?: Record<string, string>): Promise<{
|
|
62
|
+
status: number;
|
|
63
|
+
body: ApiEnvelope<T>;
|
|
64
|
+
headers: Headers;
|
|
65
|
+
}>;
|
|
66
|
+
catalog(): Promise<CatalogOperation[]>;
|
|
67
|
+
}
|