@stigg/typescript-mcp 0.1.0-alpha.33 → 0.1.0-alpha.34

package/instructions.js

@@ -56,6 +56,8 @@ async function fetchLatestInstructionsFromApi(stainlessApiKey) {
             '\n  This is the stigg MCP server.\n\n  Available tools:\n  - search_docs: Search SDK documentation to find the right methods and parameters.\n  - execute: Run TypeScript code against a pre-authenticated SDK client. Define an async run(client) function.\n\n  Workflow:\n  - If unsure about the API, call search_docs first.\n  - Write complete solutions in a single execute call when possible. For large datasets, use API filters to narrow results or paginate within a single execute block.\n  - If execute returns an error, read the error and fix your code rather than retrying the same approach.\n  - Variables do not persist between execute calls. Return or log all data you need.\n  - Individual HTTP requests to the API have a 30-second timeout. If a request times out, try a smaller query or add filters.\n  - Code execution has a total timeout of approximately 5 minutes. If your code times out, simplify it or break it into smaller steps.\n  ';
     }
     instructions ??= (await response.json()).instructions;
+    instructions +=
+        '\n# Stigg — entitlements, metering, subscriptions\n\nFor **setup, admin, exploration**. Not for hot-path gating — use the Stigg Server SDK or Sidecar for runtime checks.\n\n## Tools\n- `search_docs(query, language)` — method/param/response shapes. **Call for per-endpoint specifics.**\n- `execute(code)` — TS in `async function run(client) { ... return ... }`. `client` = `@stigg/typescript`, env via `STIGG_API_KEY`.\n\n## Model\nEnvironment → Product → (Plan | Addon) → Entitlements. A Customer holds a Subscription = plan + zero-or-more addons.\n\n- Entitlements: `FEATURE` (Feature access/limit; `featureType: BOOLEAN|NUMBER|ENUM`) or `CREDIT` (custom-currency wallet).\n- Plans/Addons lifecycle: `DRAFT → PUBLISHED → ARCHIVED`. Subscriptions use only `PUBLISHED`.\n- You supply the `id` for customers, products, features, plans, addons, coupons — stable, immutable. Duplicate returns 409; PATCH to update.\n\n## Editing published plans/addons\n`createDraft` → mutate → `publish` with `migrationType: NEW_CUSTOMERS` or `ALL_CUSTOMERS` (migrates active subs async). Migrate one subscription with `subscriptions.migrate`.\n\n## Subscriptions\n`provision` always creates a *new* subscription. **The new id is `data.subscription.id` — `data.id` is the provisioning operation id, not the subscription.** `preview` is non-mutating. `cancel` takes `cancellationTime: IMMEDIATE|END_OF_BILLING_PERIOD|SPECIFIC_DATE`.\n\n## Credits\n`grantType`: `PROMOTIONAL` | `PAID` | `RECURRING` | `OVERDRAFT`. Consumed via `events.report`. **Voiding does not refund** — refund `PAID` grants through the billing provider separately.\n\n## Metering\n- `events.report({events:[{customerId,eventName,idempotencyKey,dimensions?}]})` — **primary**: async, idempotent via `idempotencyKey`, drives credit consumption. Attributes in `dimensions` (not `properties`).\n- `usage.report` — pre-aggregated values, low-volume. `updateBehavior: SET` is idempotent; `DELTA` is not.\n\nFor per-endpoint specifics, `search_docs`.\n';
     return instructions;
 }
 //# sourceMappingURL=instructions.js.map

package/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["src/instructions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;AAetF,0CAgCC;AA7CD,2DAA6B;AAC7B,wCAAqC;AACrC,oCAAiC;AAEjC,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAO/D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkC,CAAC;AAE7D,KAAK,UAAU,eAAe,CAAC,EACpC,eAAe,EACf,sBAAsB,GAIvB;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,sBAAsB,IAAI,eAAe,IAAI,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,yBAAyB,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC,mBAAmB,CAAC;IACpC,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAC7C,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,yBAAyB,EAAE,CAAC;YACtD,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,mBAA2B,CAAC;IAEhC,IAAI,sBAAsB,EAAE,CAAC;QAC3B,mBAAmB,GAAG,MAAM,+BAA+B,CAAC,sBAAsB,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,mBAAmB,GAAG,MAAM,8BAA8B,CAAC,eAAe,CAAC,CAAC;IAC9E,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,+BAA+B,CAAC,IAAY;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,kBAAS,GAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,uCAAuC,CAAC,CAAC;QAC5E,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,8BAA8B,CAAC,eAAmC;IAC/E,iEAAiE;IACjE,iDAAiD;IACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,IAAA,cAAO,EAAC,4BAA4B,CAAC,IAAI,qDAAqD,EAC9F;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC,EAAE;KACxE,CACF,CAAC;IAEF,IAAI,YAAgC,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IAAA,kBAAS,GAAE,CAAC,IAAI,CACd,8FAA8F,CAC/F,CAAC;QAEF,YAAY;YACV,s7BAAs7B,CAAC;IAC37B,CAAC;IAED,YAAY,KAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA8B,CAAC,YAAY,CAAC;IAEpF,OAAO,YAAY,CAAC;AACtB,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["src/instructions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;AAetF,0CAgCC;AA7CD,2DAA6B;AAC7B,wCAAqC;AACrC,oCAAiC;AAEjC,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAO/D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkC,CAAC;AAE7D,KAAK,UAAU,eAAe,CAAC,EACpC,eAAe,EACf,sBAAsB,GAIvB;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,sBAAsB,IAAI,eAAe,IAAI,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,yBAAyB,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC,mBAAmB,CAAC;IACpC,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAC7C,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,yBAAyB,EAAE,CAAC;YACtD,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,mBAA2B,CAAC;IAEhC,IAAI,sBAAsB,EAAE,CAAC;QAC3B,mBAAmB,GAAG,MAAM,+BAA+B,CAAC,sBAAsB,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,mBAAmB,GAAG,MAAM,8BAA8B,CAAC,eAAe,CAAC,CAAC;IAC9E,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,+BAA+B,CAAC,IAAY;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,kBAAS,GAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,uCAAuC,CAAC,CAAC;QAC5E,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,8BAA8B,CAAC,eAAmC;IAC/E,iEAAiE;IACjE,iDAAiD;IACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,IAAA,cAAO,EAAC,4BAA4B,CAAC,IAAI,qDAAqD,EAC9F;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC,EAAE;KACxE,CACF,CAAC;IAEF,IAAI,YAAgC,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,IAAA,kBAAS,GAAE,CAAC,IAAI,CACd,8FAA8F,CAC/F,CAAC;QAEF,YAAY;YACV,s7BAAs7B,CAAC;IAC37B,CAAC;IAED,YAAY,KAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA8B,CAAC,YAAY,CAAC;IAEpF,YAAY;QACV,48DAA48D,CAAC;IAC/8D,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/instructions.mjs

@@ -50,6 +50,8 @@ async function fetchLatestInstructionsFromApi(stainlessApiKey) {
             '\n  This is the stigg MCP server.\n\n  Available tools:\n  - search_docs: Search SDK documentation to find the right methods and parameters.\n  - execute: Run TypeScript code against a pre-authenticated SDK client. Define an async run(client) function.\n\n  Workflow:\n  - If unsure about the API, call search_docs first.\n  - Write complete solutions in a single execute call when possible. For large datasets, use API filters to narrow results or paginate within a single execute block.\n  - If execute returns an error, read the error and fix your code rather than retrying the same approach.\n  - Variables do not persist between execute calls. Return or log all data you need.\n  - Individual HTTP requests to the API have a 30-second timeout. If a request times out, try a smaller query or add filters.\n  - Code execution has a total timeout of approximately 5 minutes. If your code times out, simplify it or break it into smaller steps.\n  ';
     }
     instructions ??= (await response.json()).instructions;
+    instructions +=
+        '\n# Stigg — entitlements, metering, subscriptions\n\nFor **setup, admin, exploration**. Not for hot-path gating — use the Stigg Server SDK or Sidecar for runtime checks.\n\n## Tools\n- `search_docs(query, language)` — method/param/response shapes. **Call for per-endpoint specifics.**\n- `execute(code)` — TS in `async function run(client) { ... return ... }`. `client` = `@stigg/typescript`, env via `STIGG_API_KEY`.\n\n## Model\nEnvironment → Product → (Plan | Addon) → Entitlements. A Customer holds a Subscription = plan + zero-or-more addons.\n\n- Entitlements: `FEATURE` (Feature access/limit; `featureType: BOOLEAN|NUMBER|ENUM`) or `CREDIT` (custom-currency wallet).\n- Plans/Addons lifecycle: `DRAFT → PUBLISHED → ARCHIVED`. Subscriptions use only `PUBLISHED`.\n- You supply the `id` for customers, products, features, plans, addons, coupons — stable, immutable. Duplicate returns 409; PATCH to update.\n\n## Editing published plans/addons\n`createDraft` → mutate → `publish` with `migrationType: NEW_CUSTOMERS` or `ALL_CUSTOMERS` (migrates active subs async). Migrate one subscription with `subscriptions.migrate`.\n\n## Subscriptions\n`provision` always creates a *new* subscription. **The new id is `data.subscription.id` — `data.id` is the provisioning operation id, not the subscription.** `preview` is non-mutating. `cancel` takes `cancellationTime: IMMEDIATE|END_OF_BILLING_PERIOD|SPECIFIC_DATE`.\n\n## Credits\n`grantType`: `PROMOTIONAL` | `PAID` | `RECURRING` | `OVERDRAFT`. Consumed via `events.report`. **Voiding does not refund** — refund `PAID` grants through the billing provider separately.\n\n## Metering\n- `events.report({events:[{customerId,eventName,idempotencyKey,dimensions?}]})` — **primary**: async, idempotent via `idempotencyKey`, drives credit consumption. Attributes in `dimensions` (not `properties`).\n- `usage.report` — pre-aggregated values, low-volume. `updateBehavior: SET` is idempotent; `DELTA` is not.\n\nFor per-endpoint specifics, `search_docs`.\n';
     return instructions;
 }
 //# sourceMappingURL=instructions.mjs.map

package/instructions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.mjs","sourceRoot":"","sources":["src/instructions.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,MAAM,aAAa;OACrB,EAAE,SAAS,EAAE;OACb,EAAE,OAAO,EAAE;AAElB,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAO/D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EACpC,eAAe,EACf,sBAAsB,GAIvB;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,sBAAsB,IAAI,eAAe,IAAI,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,yBAAyB,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC,mBAAmB,CAAC;IACpC,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAC7C,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,yBAAyB,EAAE,CAAC;YACtD,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,mBAA2B,CAAC;IAEhC,IAAI,sBAAsB,EAAE,CAAC;QAC3B,mBAAmB,GAAG,MAAM,+BAA+B,CAAC,sBAAsB,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,mBAAmB,GAAG,MAAM,8BAA8B,CAAC,eAAe,CAAC,CAAC;IAC9E,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,+BAA+B,CAAC,IAAY;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,uCAAuC,CAAC,CAAC;QAC5E,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,8BAA8B,CAAC,eAAmC;IAC/E,iEAAiE;IACjE,iDAAiD;IACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,OAAO,CAAC,4BAA4B,CAAC,IAAI,qDAAqD,EAC9F;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC,EAAE;KACxE,CACF,CAAC;IAEF,IAAI,YAAgC,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,SAAS,EAAE,CAAC,IAAI,CACd,8FAA8F,CAC/F,CAAC;QAEF,YAAY;YACV,s7BAAs7B,CAAC;IAC37B,CAAC;IAED,YAAY,KAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA8B,CAAC,YAAY,CAAC;IAEpF,OAAO,YAAY,CAAC;AACtB,CAAC"}
+{"version":3,"file":"instructions.mjs","sourceRoot":"","sources":["src/instructions.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,MAAM,aAAa;OACrB,EAAE,SAAS,EAAE;OACb,EAAE,OAAO,EAAE;AAElB,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAO/D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EACpC,eAAe,EACf,sBAAsB,GAIvB;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,sBAAsB,IAAI,eAAe,IAAI,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,yBAAyB,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC,mBAAmB,CAAC;IACpC,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,iBAAiB,EAAE,CAAC;QAC7C,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,yBAAyB,EAAE,CAAC;YACtD,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,mBAA2B,CAAC;IAEhC,IAAI,sBAAsB,EAAE,CAAC;QAC3B,mBAAmB,GAAG,MAAM,+BAA+B,CAAC,sBAAsB,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,mBAAmB,GAAG,MAAM,8BAA8B,CAAC,eAAe,CAAC,CAAC;IAC9E,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,+BAA+B,CAAC,IAAY;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,uCAAuC,CAAC,CAAC;QAC5E,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,8BAA8B,CAAC,eAAmC;IAC/E,iEAAiE;IACjE,iDAAiD;IACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,OAAO,CAAC,4BAA4B,CAAC,IAAI,qDAAqD,EAC9F;QACE,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC,EAAE;KACxE,CACF,CAAC;IAEF,IAAI,YAAgC,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,SAAS,EAAE,CAAC,IAAI,CACd,8FAA8F,CAC/F,CAAC;QAEF,YAAY;YACV,s7BAAs7B,CAAC;IAC37B,CAAC;IAED,YAAY,KAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA8B,CAAC,YAAY,CAAC;IAEpF,YAAY;QACV,48DAA48D,CAAC;IAC/8D,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigg/typescript-mcp",
-  "version": "0.1.0-alpha.33",
+  "version": "0.1.0-alpha.34",
   "description": "The official MCP Server for the Stigg API",
   "author": "Stigg <>",
   "types": "./index.d.ts",
@@ -27,7 +27,7 @@
     "fix": "eslint --fix ."
   },
   "dependencies": {
-    "@stigg/typescript": "^0.1.0-alpha.33",
+    "@stigg/typescript": "^0.1.0-alpha.34",
     "ajv": "^8.18.0",
     "@cloudflare/cabidela": "^0.2.4",
     "@hono/node-server": "^1.19.10",

package/server.js

@@ -19,7 +19,7 @@ const instructions_1 = require("./instructions.js");
 const methods_1 = require("./methods.js");
 const newMcpServer = async ({ stainlessApiKey, customInstructionsPath, }) => new mcp_js_1.McpServer({
     name: 'stigg_typescript_api',
-    version: '0.1.0-alpha.33',
+    version: '0.1.0-alpha.34',
 }, {
     instructions: await (0, instructions_1.getInstructions)({ stainlessApiKey, customInstructionsPath }),
     capabilities: { tools: {}, logging: {} },

package/server.mjs

@@ -10,7 +10,7 @@ import { getInstructions } from "./instructions.mjs";
 import { blockedMethodsForCodeTool } from "./methods.mjs";
 export const newMcpServer = async ({ stainlessApiKey, customInstructionsPath, }) => new McpServer({
     name: 'stigg_typescript_api',
-    version: '0.1.0-alpha.33',
+    version: '0.1.0-alpha.34',
 }, {
     instructions: await getInstructions({ stainlessApiKey, customInstructionsPath }),
     capabilities: { tools: {}, logging: {} },

package/src/instructions.ts

@@ -79,5 +79,7 @@ async function fetchLatestInstructionsFromApi(stainlessApiKey: string | undefine
 
   instructions ??= ((await response.json()) as { instructions: string }).instructions;
 
+  instructions +=
+    '\n# Stigg — entitlements, metering, subscriptions\n\nFor **setup, admin, exploration**. Not for hot-path gating — use the Stigg Server SDK or Sidecar for runtime checks.\n\n## Tools\n- `search_docs(query, language)` — method/param/response shapes. **Call for per-endpoint specifics.**\n- `execute(code)` — TS in `async function run(client) { ... return ... }`. `client` = `@stigg/typescript`, env via `STIGG_API_KEY`.\n\n## Model\nEnvironment → Product → (Plan | Addon) → Entitlements. A Customer holds a Subscription = plan + zero-or-more addons.\n\n- Entitlements: `FEATURE` (Feature access/limit; `featureType: BOOLEAN|NUMBER|ENUM`) or `CREDIT` (custom-currency wallet).\n- Plans/Addons lifecycle: `DRAFT → PUBLISHED → ARCHIVED`. Subscriptions use only `PUBLISHED`.\n- You supply the `id` for customers, products, features, plans, addons, coupons — stable, immutable. Duplicate returns 409; PATCH to update.\n\n## Editing published plans/addons\n`createDraft` → mutate → `publish` with `migrationType: NEW_CUSTOMERS` or `ALL_CUSTOMERS` (migrates active subs async). Migrate one subscription with `subscriptions.migrate`.\n\n## Subscriptions\n`provision` always creates a *new* subscription. **The new id is `data.subscription.id` — `data.id` is the provisioning operation id, not the subscription.** `preview` is non-mutating. `cancel` takes `cancellationTime: IMMEDIATE|END_OF_BILLING_PERIOD|SPECIFIC_DATE`.\n\n## Credits\n`grantType`: `PROMOTIONAL` | `PAID` | `RECURRING` | `OVERDRAFT`. Consumed via `events.report`. **Voiding does not refund** — refund `PAID` grants through the billing provider separately.\n\n## Metering\n- `events.report({events:[{customerId,eventName,idempotencyKey,dimensions?}]})` — **primary**: async, idempotent via `idempotencyKey`, drives credit consumption. Attributes in `dimensions` (not `properties`).\n- `usage.report` — pre-aggregated values, low-volume. `updateBehavior: SET` is idempotent; `DELTA` is not.\n\nFor per-endpoint specifics, `search_docs`.\n';
   return instructions;
 }

package/src/server.ts

@@ -28,7 +28,7 @@ export const newMcpServer = async ({
   new McpServer(
     {
       name: 'stigg_typescript_api',
-      version: '0.1.0-alpha.33',
+      version: '0.1.0-alpha.34',
     },
     {
       instructions: await getInstructions({ stainlessApiKey, customInstructionsPath }),