Merge pull request #45 from isaacus-dev/release-please--branches--main--changes--next--components--isaacus

release: 0.8.0

Author: umarbutler

.github/workflows/ci.yml

@@ -1,17 +1,18 @@
 name: CI
 on:
   push:
-    branches:
-      - main
-  pull_request:
-    branches:
-      - main
-      - next
+    branches-ignore:
+      - 'generated'
+      - 'codegen/**'
+      - 'integrated/**'
+      - 'stl-preview-head/**'
+      - 'stl-preview-base/**'
 
 jobs:
   lint:
+    timeout-minutes: 10
     name: lint
-    runs-on: ubuntu-latest
+    runs-on: ${{ github.repository == 'stainless-sdks/isaacus-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
       - uses: actions/checkout@v4
 
@@ -27,8 +28,9 @@ jobs:
         run: ./scripts/lint
 
   build:
+    timeout-minutes: 5
     name: build
-    runs-on: ubuntu-latest
+    runs-on: ${{ github.repository == 'stainless-sdks/isaacus-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     permissions:
       contents: read
       id-token: write
@@ -44,7 +46,7 @@ jobs:
         run: ./scripts/bootstrap
 
       - name: Check build
-        run: ./scripts/build
+        run: ./scripts/build-all
 
       - name: Get GitHub OIDC Token
         if: github.repository == 'stainless-sdks/isaacus-typescript'
@@ -61,8 +63,9 @@ jobs:
           SHA: ${{ github.sha }}
         run: ./scripts/utils/upload-artifact.sh
   test:
+    timeout-minutes: 10
     name: test
-    runs-on: ubuntu-latest
+    runs-on: ${{ github.repository == 'stainless-sdks/isaacus-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
       - uses: actions/checkout@v4
 

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.7.0"
+  ".": "0.8.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 2
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-f1ac3a46ba560544c348931204998163a9c5e35c40d6096f4b078e38c2714756.yml
-openapi_spec_hash: c9ba9f53c0dabdb703461d772020952f
-config_hash: 1d15d860383a3f6da1ac388297687cc9
+configured_endpoints: 3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/isaacus%2Fisaacus-bc0272bf0a53ec37ca25f4a8b76bca4b90cf33c5f41816edf460daa642a5a84a.yml
+openapi_spec_hash: 79f28fedf89e1b719f464c064847a630
+config_hash: bfe30148ec88e8bbbf4a348a9fdfc00a

CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.8.0 (2025-04-30)
+
+Full Changelog: [v0.7.0...v0.8.0](https://github.com/isaacus-dev/isaacus-typescript/compare/v0.7.0...v0.8.0)
+
+### Features
+
+* more gracefully handle $refs and work around schema limitations ([9f4e65c](https://github.com/isaacus-dev/isaacus-typescript/commit/9f4e65cf5e6d35239ba3fea7beaa73e25492c13c))
+
+
+### Chores
+
+* **ci:** add timeout thresholds for CI jobs ([61c6004](https://github.com/isaacus-dev/isaacus-typescript/commit/61c600488944a696c6a5895c0f95d78f9c5738b6))
+* **ci:** only use depot for staging repos ([afd5100](https://github.com/isaacus-dev/isaacus-typescript/commit/afd51000ca1f48413b7cd79ef2f3f63a831b8f89))
+* **internal:** codegen related update ([bc21b09](https://github.com/isaacus-dev/isaacus-typescript/commit/bc21b09f139eadebd6e6fa1aa724cd116483e41b))
+* **internal:** refactor utils ([777d66c](https://github.com/isaacus-dev/isaacus-typescript/commit/777d66c9dbd6ee13c20ef62c165a44c96f6aa7ca))
+* **perf:** faster base64 decoding ([893c735](https://github.com/isaacus-dev/isaacus-typescript/commit/893c73501b1aef055e1a079a4e0ac8b474b1c46a))
+
 ## 0.7.0 (2025-04-19)
 
 Full Changelog: [v0.6.0...v0.7.0](https://github.com/isaacus-dev/isaacus-typescript/compare/v0.6.0...v0.7.0)

api.md

@@ -19,3 +19,15 @@ Types:
 Methods:
 
 - <code title="post /rerankings">client.rerankings.<a href="./src/resources/rerankings.ts">create</a>({ ...params }) -> Reranking</code>
+
+# Extractions
+
+## Qa
+
+Types:
+
+- <code><a href="./src/resources/extractions/qa.ts">AnswerExtraction</a></code>
+
+Methods:
+
+- <code title="post /extractions/qa">client.extractions.qa.<a href="./src/resources/extractions/qa.ts">create</a>({ ...params }) -> AnswerExtraction</code>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacus",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "The official TypeScript library for the Isaacus API",
   "author": "Isaacus <[email protected]>",
   "types": "dist/index.d.ts",

packages/mcp-server/README.md

@@ -25,7 +25,7 @@ For clients with a configuration JSON, it might look something like this:
   "mcpServers": {
     "isaacus_api": {
       "command": "npx",
-      "args": ["-y", "isaacus-mcp"],
+      "args": ["-y", "isaacus-mcp", "--client=claude"],
       "env": {
         "ISAACUS_API_KEY": "My API Key"
       }
@@ -52,6 +52,58 @@ All of these command-line options can be repeated, combined together, and have c
 
 Use `--list` to see the list of available tools, or see below.
 
+### Specifying the MCP Client
+
+Different clients have varying abilities to handle arbitrary tools and schemas.
+
+You can specify the client you are using with the `--client` argument, and the MCP server will automatically
+serve tools and schemas that are more compatible with that client.
+
+- `--client=<type>`: Set all capabilities based on a known MCP client
+
+  - Valid values: `openai-agents`, `claude`, `claude-code`, `cursor`
+  - Example: `--client=cursor`
+
+Additionally, if you have a client not on the above list, or the client has gotten better
+over time, you can manually enable or disable certain capabilities:
+
+- `--capability=<name>`: Specify individual client capabilities
+  - Available capabilities:
+    - `top-level-unions`: Enable support for top-level unions in tool schemas
+    - `valid-json`: Enable JSON string parsing for arguments
+    - `refs`: Enable support for $ref pointers in schemas
+    - `unions`: Enable support for union types (anyOf) in schemas
+    - `formats`: Enable support for format validations in schemas (e.g. date-time, email)
+    - `tool-name-length=N`: Set maximum tool name length to N characters
+  - Example: `--capability=top-level-unions --capability=tool-name-length=40`
+  - Example: `--capability=top-level-unions,tool-name-length=40`
+
+### Examples
+
+1. Filter for read operations on cards:
+
+```bash
+--resource=cards --operation=read
+```
+
+2. Exclude specific tools while including others:
+
+```bash
+--resource=cards --no-tool=create_cards
+```
+
+3. Configure for Cursor client with custom max tool name length:
+
+```bash
+--client=cursor --capability=tool-name-length=40
+```
+
+4. Complex filtering with multiple criteria:
+
+```bash
+--resource=cards,accounts --operation=read --tag=kyc --no-tool=create_cards
+```
+
 ## Importing the tools and server individually
 
 ```js
@@ -98,3 +150,7 @@ The following tools are available in this MCP server.
 ### Resource `rerankings`:
 
 - `create_rerankings` (`write`): Rerank legal documents by their relevance to a query with an Isaacus legal AI reranker.
+
+### Resource `extractions.qa`:
+
+- `create_extractions_qa` (`write`): Extract answers to questions from legal documents with an Isaacus legal AI answer extractor.

packages/mcp-server/package.json

@@ -1,12 +1,17 @@
 {
   "name": "isaacus-mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "The official MCP Server for the Isaacus API",
   "author": "Isaacus <[email protected]>",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "type": "commonjs",
-  "repository": "github:isaacus-dev/isaacus-typescript",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/isaacus-dev/isaacus-typescript.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://github.com/isaacus-dev/isaacus-typescript/tree/main/packages/mcp-server#readme",
   "license": "Apache-2.0",
   "packageManager": "[email protected]",
   "private": false,
@@ -24,7 +29,8 @@
   "dependencies": {
     "isaacus": "file:../../dist/",
     "@modelcontextprotocol/sdk": "^1.6.1",
-    "yargs": "^17.7.2"
+    "yargs": "^17.7.2",
+    "ajv": "^8.17.1"
   },
   "bin": {
     "mcp-server": "dist/index.js"