stackone-ai 2.10.1__tar.gz → 3.1.0__tar.gz

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.
Files changed (188) hide show
  1. stackone_ai-3.1.0/.gitignore +23 -0
  2. stackone_ai-3.1.0/CHANGELOG.md +378 -0
  3. stackone_ai-3.1.0/MIGRATION.md +457 -0
  4. stackone_ai-3.1.0/PKG-INFO +466 -0
  5. stackone_ai-3.1.0/README.md +424 -0
  6. stackone_ai-3.1.0/pyproject.toml +102 -0
  7. stackone_ai-3.1.0/stackone_ai/__init__.py +40 -0
  8. stackone_ai-3.1.0/stackone_ai/tools.py +1794 -0
  9. stackone_ai-3.1.0/stackone_ai/toolset.py +1239 -0
  10. stackone_ai-3.1.0/stackone_ai/types.py +181 -0
  11. stackone_ai-3.1.0/tests/vectors/README.md +144 -0
  12. stackone_ai-2.10.1/.claude/rules/development-workflow.md +0 -63
  13. stackone_ai-2.10.1/.claude/rules/examples-standards.md +0 -75
  14. stackone_ai-2.10.1/.claude/rules/git-workflow.md +0 -97
  15. stackone_ai-2.10.1/.claude/rules/nix-workflow.md +0 -84
  16. stackone_ai-2.10.1/.claude/rules/no-relative-imports.md +0 -27
  17. stackone_ai-2.10.1/.claude/rules/package-installation.md +0 -59
  18. stackone_ai-2.10.1/.claude/rules/release-please-standards.md +0 -63
  19. stackone_ai-2.10.1/.claude/rules/uv-scripts.md +0 -66
  20. stackone_ai-2.10.1/.cursor/rules/development-workflow.mdc +0 -1
  21. stackone_ai-2.10.1/.cursor/rules/examples-standards.mdc +0 -1
  22. stackone_ai-2.10.1/.cursor/rules/git-workflow.mdc +0 -1
  23. stackone_ai-2.10.1/.cursor/rules/no-relative-imports.mdc +0 -1
  24. stackone_ai-2.10.1/.cursor/rules/package-installation.mdc +0 -1
  25. stackone_ai-2.10.1/.cursor/rules/release-please-standards.mdc +0 -1
  26. stackone_ai-2.10.1/.cursor/rules/uv-scripts.mdc +0 -1
  27. stackone_ai-2.10.1/.env.example +0 -6
  28. stackone_ai-2.10.1/.envrc +0 -2
  29. stackone_ai-2.10.1/.github/actions/setup-nix/action.yaml +0 -50
  30. stackone_ai-2.10.1/.github/dependabot.yaml +0 -46
  31. stackone_ai-2.10.1/.github/workflows/ci.yaml +0 -100
  32. stackone_ai-2.10.1/.github/workflows/nix-flake-update.yaml +0 -63
  33. stackone_ai-2.10.1/.github/workflows/nix-flake.yaml +0 -35
  34. stackone_ai-2.10.1/.github/workflows/release.yaml +0 -66
  35. stackone_ai-2.10.1/.gitignore +0 -24
  36. stackone_ai-2.10.1/.gitleaks.toml +0 -9
  37. stackone_ai-2.10.1/.gitmodules +0 -3
  38. stackone_ai-2.10.1/.mcp.json +0 -12
  39. stackone_ai-2.10.1/.release-please-config.json +0 -15
  40. stackone_ai-2.10.1/.release-please-manifest.json +0 -3
  41. stackone_ai-2.10.1/CHANGELOG.md +0 -250
  42. stackone_ai-2.10.1/CLAUDE.md +0 -106
  43. stackone_ai-2.10.1/PKG-INFO +0 -541
  44. stackone_ai-2.10.1/README.md +0 -506
  45. stackone_ai-2.10.1/examples/auth_management.py +0 -103
  46. stackone_ai-2.10.1/examples/crewai_integration.py +0 -69
  47. stackone_ai-2.10.1/examples/langchain_integration.py +0 -69
  48. stackone_ai-2.10.1/examples/langgraph_integration.py +0 -62
  49. stackone_ai-2.10.1/examples/openai_integration.py +0 -113
  50. stackone_ai-2.10.1/examples/pydantic_ai_integration.py +0 -53
  51. stackone_ai-2.10.1/examples/search_tools.py +0 -171
  52. stackone_ai-2.10.1/examples/test_examples.py +0 -61
  53. stackone_ai-2.10.1/flake.lock +0 -230
  54. stackone_ai-2.10.1/flake.nix +0 -153
  55. stackone_ai-2.10.1/justfile +0 -47
  56. stackone_ai-2.10.1/pyproject.toml +0 -113
  57. stackone_ai-2.10.1/scripts/benchmark_search.py +0 -134
  58. stackone_ai-2.10.1/stackone_ai/__init__.py +0 -26
  59. stackone_ai-2.10.1/stackone_ai/constants.py +0 -8
  60. stackone_ai-2.10.1/stackone_ai/feedback/__init__.py +0 -5
  61. stackone_ai-2.10.1/stackone_ai/feedback/tool.py +0 -226
  62. stackone_ai-2.10.1/stackone_ai/integrations/__init__.py +0 -20
  63. stackone_ai-2.10.1/stackone_ai/integrations/langgraph.py +0 -86
  64. stackone_ai-2.10.1/stackone_ai/local_search.py +0 -170
  65. stackone_ai-2.10.1/stackone_ai/models.py +0 -685
  66. stackone_ai-2.10.1/stackone_ai/semantic_search.py +0 -205
  67. stackone_ai-2.10.1/stackone_ai/toolset.py +0 -1341
  68. stackone_ai-2.10.1/stackone_ai/utils/__init__.py +0 -1
  69. stackone_ai-2.10.1/stackone_ai/utils/normalize.py +0 -17
  70. stackone_ai-2.10.1/stackone_ai/utils/tfidf_index.py +0 -242
  71. stackone_ai-2.10.1/tests/conftest.py +0 -113
  72. stackone_ai-2.10.1/tests/mocks/serve.ts +0 -134
  73. stackone_ai-2.10.1/tests/test_agent_tools.py +0 -541
  74. stackone_ai-2.10.1/tests/test_feedback.py +0 -397
  75. stackone_ai-2.10.1/tests/test_fetch_tools.py +0 -682
  76. stackone_ai-2.10.1/tests/test_integrations_langgraph.py +0 -217
  77. stackone_ai-2.10.1/tests/test_integrations_pydantic_ai.py +0 -183
  78. stackone_ai-2.10.1/tests/test_local_search.py +0 -254
  79. stackone_ai-2.10.1/tests/test_models.py +0 -962
  80. stackone_ai-2.10.1/tests/test_semantic_search.py +0 -1039
  81. stackone_ai-2.10.1/tests/test_tfidf_index.py +0 -452
  82. stackone_ai-2.10.1/tests/test_tool_calling.py +0 -536
  83. stackone_ai-2.10.1/tests/test_toolset.py +0 -356
  84. stackone_ai-2.10.1/uv.lock +0 -5881
  85. stackone_ai-2.10.1/vendor/stackone-ai-node/.claude/rules/development-workflow.md +0 -29
  86. stackone_ai-2.10.1/vendor/stackone-ai-node/.claude/rules/file-operations.md +0 -134
  87. stackone_ai-2.10.1/vendor/stackone-ai-node/.claude/rules/git-workflow.md +0 -97
  88. stackone_ai-2.10.1/vendor/stackone-ai-node/.claude/rules/pnpm-usage.md +0 -54
  89. stackone_ai-2.10.1/vendor/stackone-ai-node/.claude/rules/typescript-patterns.md +0 -246
  90. stackone_ai-2.10.1/vendor/stackone-ai-node/.claude/rules/typescript-testing.md +0 -132
  91. stackone_ai-2.10.1/vendor/stackone-ai-node/.claude/skills/orama-integration/SKILL.md +0 -25
  92. stackone_ai-2.10.1/vendor/stackone-ai-node/.cursor/rules/development-workflow.mdc +0 -1
  93. stackone_ai-2.10.1/vendor/stackone-ai-node/.cursor/rules/file-operations.mdc +0 -1
  94. stackone_ai-2.10.1/vendor/stackone-ai-node/.cursor/rules/git-workflow.mdc +0 -1
  95. stackone_ai-2.10.1/vendor/stackone-ai-node/.cursor/rules/orama-integration.mdc +0 -1
  96. stackone_ai-2.10.1/vendor/stackone-ai-node/.cursor/rules/pnpm-usage.mdc +0 -1
  97. stackone_ai-2.10.1/vendor/stackone-ai-node/.cursor/rules/typescript-patterns.mdc +0 -1
  98. stackone_ai-2.10.1/vendor/stackone-ai-node/.cursor/rules/typescript-testing.mdc +0 -1
  99. stackone_ai-2.10.1/vendor/stackone-ai-node/.envrc +0 -1
  100. stackone_ai-2.10.1/vendor/stackone-ai-node/.github/CODEOWNERS +0 -6
  101. stackone_ai-2.10.1/vendor/stackone-ai-node/.github/actions/setup-nix/action.yaml +0 -19
  102. stackone_ai-2.10.1/vendor/stackone-ai-node/.github/workflows/check-title.yaml +0 -25
  103. stackone_ai-2.10.1/vendor/stackone-ai-node/.github/workflows/ci.yaml +0 -87
  104. stackone_ai-2.10.1/vendor/stackone-ai-node/.github/workflows/claude.yaml +0 -39
  105. stackone_ai-2.10.1/vendor/stackone-ai-node/.github/workflows/dry-publish.yaml +0 -17
  106. stackone_ai-2.10.1/vendor/stackone-ai-node/.github/workflows/nix-flake.yaml +0 -33
  107. stackone_ai-2.10.1/vendor/stackone-ai-node/.github/workflows/release.yaml +0 -52
  108. stackone_ai-2.10.1/vendor/stackone-ai-node/.gitignore +0 -183
  109. stackone_ai-2.10.1/vendor/stackone-ai-node/.gitleaks.toml +0 -11
  110. stackone_ai-2.10.1/vendor/stackone-ai-node/.mcp.json +0 -12
  111. stackone_ai-2.10.1/vendor/stackone-ai-node/.oxfmtrc.jsonc +0 -7
  112. stackone_ai-2.10.1/vendor/stackone-ai-node/.oxlintrc.jsonc +0 -179
  113. stackone_ai-2.10.1/vendor/stackone-ai-node/AGENTS.md +0 -1
  114. stackone_ai-2.10.1/vendor/stackone-ai-node/CHANGELOG.md +0 -373
  115. stackone_ai-2.10.1/vendor/stackone-ai-node/CLAUDE.md +0 -26
  116. stackone_ai-2.10.1/vendor/stackone-ai-node/LICENSE +0 -201
  117. stackone_ai-2.10.1/vendor/stackone-ai-node/README.md +0 -614
  118. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/README.md +0 -295
  119. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/ai-sdk-integration.test.ts +0 -52
  120. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/ai-sdk-integration.ts +0 -52
  121. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/anthropic-integration.ts +0 -63
  122. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/claude-agent-sdk-integration.test.ts +0 -140
  123. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/claude-agent-sdk-integration.ts +0 -88
  124. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/fetch-tools-debug.ts +0 -297
  125. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/fetch-tools.test.ts +0 -102
  126. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/fetch-tools.ts +0 -82
  127. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/meta-tools.ts +0 -280
  128. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/openai-integration.test.ts +0 -72
  129. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/openai-integration.ts +0 -69
  130. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/openai-responses-integration.test.ts +0 -64
  131. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/openai-responses-integration.ts +0 -63
  132. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/package.json +0 -30
  133. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/tanstack-ai-integration.test.ts +0 -77
  134. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/tanstack-ai-integration.ts +0 -83
  135. stackone_ai-2.10.1/vendor/stackone-ai-node/examples/tsconfig.json +0 -16
  136. stackone_ai-2.10.1/vendor/stackone-ai-node/flake.lock +0 -61
  137. stackone_ai-2.10.1/vendor/stackone-ai-node/flake.nix +0 -49
  138. stackone_ai-2.10.1/vendor/stackone-ai-node/knip.config.ts +0 -21
  139. stackone_ai-2.10.1/vendor/stackone-ai-node/lefthook.yaml +0 -22
  140. stackone_ai-2.10.1/vendor/stackone-ai-node/mocks/handlers.example-api.ts +0 -59
  141. stackone_ai-2.10.1/vendor/stackone-ai-node/mocks/handlers.mcp.ts +0 -35
  142. stackone_ai-2.10.1/vendor/stackone-ai-node/mocks/handlers.openai.ts +0 -214
  143. stackone_ai-2.10.1/vendor/stackone-ai-node/mocks/handlers.stackone-ai.ts +0 -97
  144. stackone_ai-2.10.1/vendor/stackone-ai-node/mocks/handlers.stackone-rpc.ts +0 -85
  145. stackone_ai-2.10.1/vendor/stackone-ai-node/mocks/handlers.ts +0 -13
  146. stackone_ai-2.10.1/vendor/stackone-ai-node/mocks/handlers.utils.ts +0 -30
  147. stackone_ai-2.10.1/vendor/stackone-ai-node/mocks/mcp-server.ts +0 -275
  148. stackone_ai-2.10.1/vendor/stackone-ai-node/mocks/node.ts +0 -4
  149. stackone_ai-2.10.1/vendor/stackone-ai-node/package.json +0 -118
  150. stackone_ai-2.10.1/vendor/stackone-ai-node/pnpm-lock.yaml +0 -4506
  151. stackone_ai-2.10.1/vendor/stackone-ai-node/pnpm-workspace.yaml +0 -66
  152. stackone_ai-2.10.1/vendor/stackone-ai-node/src/consts.ts +0 -20
  153. stackone_ai-2.10.1/vendor/stackone-ai-node/src/feedback.test.ts +0 -300
  154. stackone_ai-2.10.1/vendor/stackone-ai-node/src/feedback.ts +0 -230
  155. stackone_ai-2.10.1/vendor/stackone-ai-node/src/headers.test.ts +0 -69
  156. stackone_ai-2.10.1/vendor/stackone-ai-node/src/headers.ts +0 -46
  157. stackone_ai-2.10.1/vendor/stackone-ai-node/src/index.ts +0 -29
  158. stackone_ai-2.10.1/vendor/stackone-ai-node/src/mcp-client.test.ts +0 -68
  159. stackone_ai-2.10.1/vendor/stackone-ai-node/src/mcp-client.ts +0 -55
  160. stackone_ai-2.10.1/vendor/stackone-ai-node/src/requestBuilder.test.ts +0 -778
  161. stackone_ai-2.10.1/vendor/stackone-ai-node/src/requestBuilder.ts +0 -377
  162. stackone_ai-2.10.1/vendor/stackone-ai-node/src/rpc-client.test.ts +0 -122
  163. stackone_ai-2.10.1/vendor/stackone-ai-node/src/rpc-client.ts +0 -107
  164. stackone_ai-2.10.1/vendor/stackone-ai-node/src/schema.ts +0 -64
  165. stackone_ai-2.10.1/vendor/stackone-ai-node/src/tool.test-d.ts +0 -53
  166. stackone_ai-2.10.1/vendor/stackone-ai-node/src/tool.test.ts +0 -1453
  167. stackone_ai-2.10.1/vendor/stackone-ai-node/src/tool.ts +0 -743
  168. stackone_ai-2.10.1/vendor/stackone-ai-node/src/toolsets.test-d.ts +0 -44
  169. stackone_ai-2.10.1/vendor/stackone-ai-node/src/toolsets.test.ts +0 -712
  170. stackone_ai-2.10.1/vendor/stackone-ai-node/src/toolsets.ts +0 -558
  171. stackone_ai-2.10.1/vendor/stackone-ai-node/src/types.ts +0 -203
  172. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/array.test.ts +0 -48
  173. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/array.ts +0 -13
  174. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/error-stackone-api.test.ts +0 -208
  175. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/error-stackone-api.ts +0 -130
  176. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/error-stackone.test.ts +0 -15
  177. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/error-stackone.ts +0 -9
  178. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/tfidf-index.test.ts +0 -206
  179. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/tfidf-index.ts +0 -192
  180. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/try-import.test.ts +0 -23
  181. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/try-import.ts +0 -25
  182. stackone_ai-2.10.1/vendor/stackone-ai-node/src/utils/type.ts +0 -4
  183. stackone_ai-2.10.1/vendor/stackone-ai-node/tsconfig.json +0 -28
  184. stackone_ai-2.10.1/vendor/stackone-ai-node/tsdown.config.ts +0 -20
  185. stackone_ai-2.10.1/vendor/stackone-ai-node/vitest.config.ts +0 -46
  186. stackone_ai-2.10.1/vendor/stackone-ai-node/vitest.setup.ts +0 -5
  187. {stackone_ai-2.10.1 → stackone_ai-3.1.0}/LICENSE +0 -0
  188. {stackone_ai-2.10.1 → stackone_ai-3.1.0}/stackone_ai/py.typed +0 -0
@@ -0,0 +1,23 @@
1
+ .env
2
+ .env.*
3
+ !.env.example
4
+ .venv
5
+
6
+ .pytest_cache
7
+ .python-version
8
+ __pycache__
9
+ .coverage
10
+ coverage/
11
+
12
+ .DS_Store
13
+
14
+
15
+ *.egg-info
16
+ dist/
17
+ build/
18
+
19
+ # Node tooling for the MCP mock server
20
+ node_modules/
21
+
22
+ # Hypothesis test database
23
+ .hypothesis/
@@ -0,0 +1,378 @@
1
+ # Changelog
2
+
3
+ ## [3.1.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v3.0.0...stackone-ai-v3.1.0) (2026-11-17)
4
+
5
+
6
+ ### Features
7
+
8
+ * **deps:** support mcp 2 alongside mcp 1 ([#274](https://github.com/StackOneHQ/stackone-ai-python/issues/274)) ([7dfbf28](https://github.com/StackOneHQ/stackone-ai-python/commit/7dfbf28977f227e603d66f9a27faf545fe9456d0))
9
+
10
+
11
+ ### Bug Fixes
12
+
13
+ * **deps:** clear open security alerts with lockfile bumps ([#264](https://github.com/StackOneHQ/stackone-ai-python/issues/264)) ([2ca1845](https://github.com/StackOneHQ/stackone-ai-python/commit/2ca1845036f846b5dc276871dd2347d78d09706b))
14
+ * **deps:** require the patched mcp and python-dotenv releases ([#265](https://github.com/StackOneHQ/stackone-ai-python/issues/265)) ([43ebf5e](https://github.com/StackOneHQ/stackone-ai-python/commit/43ebf5eaed9e23e65024bd428209ae05a8ec3d63))
15
+ * **examples:** exit non-zero when credentials are missing or nothing is listed ([#258](https://github.com/StackOneHQ/stackone-ai-python/issues/258)) ([9818a04](https://github.com/StackOneHQ/stackone-ai-python/commit/9818a042cfe5a40179d23cf05bdb0be60b5aab92))
16
+ * **packaging:** declare the Apache 2.0 licence and use absolute README links ([#255](https://github.com/StackOneHQ/stackone-ai-python/issues/255)) ([dc214cb](https://github.com/StackOneHQ/stackone-ai-python/commit/dc214cba11f664fcc6ef34d42cc764bcea928d22))
17
+ * **tools:** warn about duplicate tool names once, when a collection is built ([#266](https://github.com/StackOneHQ/stackone-ai-python/issues/266)) ([67e6973](https://github.com/StackOneHQ/stackone-ai-python/commit/67e6973f2d152b3d262a20c949483780ce1d4eab))
18
+
19
+
20
+ ### Performance Improvements
21
+
22
+ * share one SSL context across MCP calls ([#263](https://github.com/StackOneHQ/stackone-ai-python/issues/263)) ([751a60e](https://github.com/StackOneHQ/stackone-ai-python/commit/751a60e1c21fd6add56ddb483a4f510f50e3c23e))
23
+
24
+
25
+ ### Documentation
26
+
27
+ * align CLAUDE.md and make format with the code and CI ([#256](https://github.com/StackOneHQ/stackone-ai-python/issues/256)) ([7fb0139](https://github.com/StackOneHQ/stackone-ai-python/commit/7fb013969ce84b31e37a4450ab173a442aba6a4d))
28
+
29
+ ## [3.0.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.10.1...stackone-ai-v3.0.0) (2026-10-29)
30
+
31
+
32
+ ### ⚠ BREAKING CHANGES
33
+
34
+ * one search tool and one execute tool spanning the account scope (ENG-3175) ([#231](https://github.com/StackOneHQ/stackone-ai-python/issues/231))
35
+ * StackOneRpcTool, MCP_PARAM_STYLE, ParameterLocation, validate_method, is_json_content_type and filename_from_content_disposition are removed. Every tool fetch_tools() returns is a StackOneMcpTool that executes over MCP tools/call on the endpoint and account that listed it, with its arguments sent unchanged; nothing posts to /actions/rpc.
36
+ * **tools:** StackOneTool.execute() no longer makes HTTP requests. On the base class it raises StackOneError, so a hand-built tool must override execute().
37
+ * **types:** ExecuteConfig is extra="forbid" and keeps only name, headers and timeout. Passing method, url, body_type or parameter_locations raises a pydantic ValidationError.
38
+ * **toolset:** StackOneToolSet.execute() and tool.execute() return the server's {isError, result, defenderMetadata?, policyMetadata?} object rather than the unwrapped payload or the /actions/rpc body, so result["data"] becomes result["result"]["data"].
39
+ * **tools:** a file action returns {download_url, expires_at, file} as `result` instead of {content, content_type, status_code, headers, file_name}, and raises StackOneAPIError with status 501 when no link can be issued. Tools.execute_openai_tool_calls() no longer base64-encodes bytes.
40
+ * **toolset:** the /mcp URL no longer carries ?param-style=flat_prefixed, so per-action tools from fetch_tools() take whichever argument style the server serves by default instead of flat, prefixed keys such as body_variables.
41
+ * **tools:** StackOneMcpTool(headers=...) is now optional and means extra request headers, not the full header set. The SDK always sets Authorization, x-account-id and User-Agent itself, after them.
42
+ * **tools:** to_openai_function() no longer derives `required` from the per-property nullable markers. It emits the served root `required` list verbatim, in the served order, and omits it when absent or empty, so a hand-built ToolParameters without `required` now has no required fields.
43
+ * **toolset:** fetch_tools(), openai(), langchain() and pydantic_ai() include the stackone_submit_feedback tool, once, whenever the server serves it.
44
+ * **tools:** a top-level `headers_<name>` argument is dropped unless the tool's schema declares that property, and always for Authorization, x-account-id and User-Agent. A declared flat `headers_<name>` property no longer admits the same name inside a nested `headers` object. An open `headers` object, as `*_execute_action` serves it, forwards any other header, so StackOneToolSet.execute(..., {"headers": {...}}) passes host-set headers through where it previously dropped them all. A top-level `headers` argument that isn't a plain object is dropped too, unless the schema declares `headers` itself as a non-object field, in which case it is an ordinary argument sent as given. A declared flat `headers_<name>` argument whose value is a list or dict is dropped as well; only a string, number or boolean can be a header value.
45
+ * **tools:** when more than one account serves a tool name, Tools.get_tool() returns the first one listed (listings merge in sorted account order) rather than the last.
46
+ * Python 3.10 is no longer supported. stackone-ai requires Python 3.11 or later.
47
+ * the `stackone-ai[mcp]` extra no longer exists. mcp is a core dependency, so install plain `stackone-ai`.
48
+ * langchain-core is no longer installed with stackone-ai. StackOneTool.to_langchain(), Tools.to_langchain() and StackOneToolSet.langchain() need the `stackone-ai[langchain]` extra, which requires langchain-core 0.3.36 or later, and raise an ImportError that names it without it.
49
+ * stackone_ai.models, stackone_ai.constants and stackone_ai.utils no longer exist. Import StackOneTool and Tools from stackone_ai.tools; ToolParameters, ExecuteConfig, DEFAULT_BASE_URL and the errors from stackone_ai.types; or any public name from stackone_ai. ToolDefinition and DEFAULT_HYBRID_ALPHA are removed.
50
+ * **toolset:** client-side search is removed: SearchConfig, SearchMode, SearchTool, SemanticSearchClient, SemanticSearchResult, SemanticSearchResponse and SemanticSearchError, the `search=` constructor argument, search_tools(), search_action_names(), get_search_tool(), semantic_client, the tool_search and tool_execute meta tools, and the bm25s and numpy dependencies. StackOneToolSet.search() runs the server's *_search_actions tools instead.
51
+ * stackone_ai.integrations, with to_tool_node(), to_tool_executor(), bind_model_with_tools() and create_react_agent(), is removed. Pass tools.to_langchain() to LangGraph's own ToolNode and bind_tools().
52
+ * **tools:** the tool_feedback tool, stackone_ai.feedback, create_feedback_tool() and the implicit feedback_* execution options are removed, and StackOneTool.execute() and call() no longer take options=. Use StackOneToolSet.submit_feedback() and a search hit's session_id instead.
53
+ * **toolset:** StackOneToolSet.execute() takes (action_id, arguments=None, *, account_ids=None, session_id=None) instead of a meta tool name with arguments as a JSON string or dict. arguments must be a dict in the nested form an action's example_request shows, and a failure raises (ToolsetConfigError, ToolArgumentsError, ToolsetLoadError or StackOneAPIError) instead of returning {"error": ...}.
54
+ * **tools:** to_openai_function(), to_langchain() and to_pydantic_ai_tool() give the model the served JSON Schema instead of only type, description, enum and a shallow copy of items and properties, so format, pattern, default, bounds, oneOf/anyOf and nested required reach it. to_langchain() sets that schema as args_schema instead of a pydantic model built from it.
55
+ * **toolset:** openai(), langchain() and pydantic_ai() no longer take mode=. Set tool_mode="search_execute" on StackOneToolSet to give a model the server's search and execute tools.
56
+ * **toolset:** StackOneToolSet(account_id="") raises ToolsetConfigError instead of being treated as no account, which now lists every active account, so an account id read from an environment variable that is set but empty raises. An empty or non-string entry in account_ids, set_accounts() or execute={"account_ids": [...]} raises too, instead of being sent with no x-account-id.
57
+ * **toolset:** account_ids, set_accounts() and execute={"account_ids": ...} accept only a list of strings. A tuple or any other non-list, which 2.10.1 accepted, raises ToolsetConfigError; pass list(ids) instead.
58
+ * removed StackOneTool.connector property and Tools.get_connectors().
59
+
60
+ ### Features
61
+
62
+ * export the feedback types and StackOneMcpTool, and take any sequence of tool names ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
63
+ * one search tool and one execute tool spanning the account scope (ENG-3175) ([#231](https://github.com/StackOneHQ/stackone-ai-python/issues/231)) ([691d13a](https://github.com/StackOneHQ/stackone-ai-python/commit/691d13a9c2021bcd6d1645bce7a489d0e705b2fc))
64
+ * retry HTTP 429 on every request, honouring Retry-After, and raise a 429 that outlasts the retries or the timeout instead of skipping the account ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
65
+ * **toolset:** add a headers option sent on every request ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
66
+ * **toolset:** add action_run_id to submit_feedback(), and send feedback through the lowest account id ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
67
+ * **toolset:** link calls with session_id and add submit_feedback() ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
68
+ * **toolset:** read STACKONE_BASE_URL ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
69
+ * **toolset:** send x-end-user-id for non-shared accounts ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
70
+ * **toolset:** skip non-shared accounts during discovery unless include_non_shared ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
71
+ * **toolset:** tag each search hit with its account_id and apply top_k to the merged ranking ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
72
+ * **toolset:** warn when STACKONE_ACCOUNT_ID is set but ignored ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
73
+ * **tools:** raise ToolArgumentsError, a StackOneError and a ValueError, for unusable tool arguments ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
74
+
75
+
76
+ ### Bug Fixes
77
+
78
+ * **tools:** build every adapter from the first tool of each name ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
79
+ * **tools:** emit the served required list in served order ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
80
+ * **toolset:** accept account ids only as a list ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
81
+ * **toolset:** cache the healthy accounts when one fails, and retry a failed one after 30 seconds ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
82
+ * **toolset:** chain a failed end-user lookup onto the 400 it was looking up for ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
83
+ * **toolset:** hold a provider lookup's miss for the failed-account window in execute() ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
84
+ * **toolset:** learn a failed account's provider with one GET /accounts before execute() refuses ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
85
+ * **toolset:** look up a non-shared account's end user when the API asks for it ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
86
+ * **toolset:** move a pinned action_id and session_id to the end of the arguments ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
87
+ * **toolset:** name shared accounts in the STACKONE_ACCOUNT_ID warning ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
88
+ * **toolset:** raise the shared error when every account fails, and keep each failure ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
89
+ * **toolset:** raise when every active account on the key is non-shared and not opted in ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
90
+ * **toolset:** re-list only the failed accounts that could serve the action in execute() ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
91
+ * **toolset:** refuse an action whose connector is linked on more than one account ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
92
+ * **toolset:** refuse to execute while a matching account failed to list ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
93
+ * **toolset:** reject an empty or non-string account id ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
94
+ * **toolset:** route stackone_submit_feedback over MCP and list it once ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
95
+ * **toolset:** send feedback once, through the first account ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
96
+ * **tools:** guard every header argument by its own declaration ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
97
+ * **tools:** keep a retried 429 on record while another request in the exchange is answered ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
98
+ * **tools:** report an MCP timeout as a timeout ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
99
+ * **tools:** return structuredContent from a tools/call result with no text ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
100
+ * **tools:** return the first listing from get_tool(), as Node does ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
101
+ * **tools:** send tools/call without relisting the catalog first ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
102
+ * **tools:** write nested header values as Node writes them ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
103
+ * **types:** declare ToolParameters.required so a hand-built tool type-checks ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
104
+
105
+
106
+ ### Code Refactoring
107
+
108
+ * execute every tool over MCP tools/call ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
109
+ * MCP-only toolset with account discovery, search/execute, and hardened security ([#199](https://github.com/StackOneHQ/stackone-ai-python/issues/199)) ([e53edf0](https://github.com/StackOneHQ/stackone-ai-python/commit/e53edf0c7cc1da6cc5376df9ca27c6b845597e22))
110
+ * remove stackone_ai.integrations ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
111
+ * split stackone_ai.models into stackone_ai.tools and stackone_ai.types ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
112
+ * **toolset:** remove client-side search ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
113
+ * **toolset:** remove mode= from openai(), langchain() and pydantic_ai() ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
114
+ * **toolset:** return every result exactly as the server wrote it ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
115
+ * **toolset:** run an action by id with execute() ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
116
+ * **toolset:** stop pinning param-style=flat_prefixed on the MCP endpoint ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
117
+ * **tools:** pass the served schema through to every adapter ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
118
+ * **tools:** remove the client-side feedback tool ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
119
+ * **tools:** remove the HTTP executor from the base StackOneTool ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
120
+ * **tools:** return a download link from file actions ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
121
+ * **tools:** treat StackOneMcpTool headers as extra headers ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
122
+ * **types:** reduce ExecuteConfig to name, headers and timeout ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
123
+
124
+
125
+ ### Build System
126
+
127
+ * make langchain-core an optional dependency ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
128
+ * make mcp a core dependency and remove the mcp extra ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
129
+ * require Python 3.11 or later ([049abf5](https://github.com/StackOneHQ/stackone-ai-python/commit/049abf548c7f5448a89e7999e95336980d23afc3))
130
+
131
+ ## [2.10.1](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.10.0...stackone-ai-v2.10.1) (2026-07-28)
132
+
133
+
134
+ ### Bug Fixes
135
+
136
+ * **deps:** cap pydantic-ai in examples extra below 2.0 ([#195](https://github.com/StackOneHQ/stackone-ai-python/issues/195)) ([66f3f2b](https://github.com/StackOneHQ/stackone-ai-python/commit/66f3f2b8d2d41989852b850a0555c94c977e6afc))
137
+
138
+ ## [2.10.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.9.1...stackone-ai-v2.10.0) (2026-07-27)
139
+
140
+
141
+ ### Features
142
+
143
+ * **ENG-733:** support flat_prefixed MCP param style ([#192](https://github.com/StackOneHQ/stackone-ai-python/issues/192)) ([ff8fb9a](https://github.com/StackOneHQ/stackone-ai-python/commit/ff8fb9a41add55e9c31bd84e04447bb3685ab024))
144
+
145
+ ## [2.9.1](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.9.0...stackone-ai-v2.9.1) (2026-06-03)
146
+
147
+
148
+ ### Bug Fixes
149
+
150
+ * **models:** handle binary file downloads in tool execution ([#190](https://github.com/StackOneHQ/stackone-ai-python/issues/190)) ([8983c68](https://github.com/StackOneHQ/stackone-ai-python/commit/8983c68dd2fdbdbdd52af531a9a9f1de6d72e1b8))
151
+ * **search:** make ToolsetConfigError actionable and fix misleading docs ([#188](https://github.com/StackOneHQ/stackone-ai-python/issues/188)) ([d332c27](https://github.com/StackOneHQ/stackone-ai-python/commit/d332c27d2f7b827e7ca043f60c37cb0831a92361))
152
+
153
+ ## [2.9.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.8.0...stackone-ai-v2.9.0) (2026-04-30)
154
+
155
+
156
+ ### Features
157
+
158
+ * **integrations:** add native Pydantic AI support ([#184](https://github.com/StackOneHQ/stackone-ai-python/issues/184)) ([8216ab6](https://github.com/StackOneHQ/stackone-ai-python/commit/8216ab6c0776b0753cf3e68461bf5e8a9b044b06))
159
+
160
+ ## [2.8.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.7.0...stackone-ai-v2.8.0) (2026-04-20)
161
+
162
+
163
+ ### Features
164
+
165
+ * **examples:** streamline examples, standardize auth patterns and migrate examples to Workday ([#179](https://github.com/StackOneHQ/stackone-ai-python/issues/179)) ([0bdc939](https://github.com/StackOneHQ/stackone-ai-python/commit/0bdc939e2844a0dae6bf527c8c8209df0a90d1f7))
166
+
167
+ ## [2.7.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.6.0...stackone-ai-v2.7.0) (2026-04-14)
168
+
169
+
170
+ ### Features
171
+
172
+ * **search-optimization:** cache tool catalog and parallelize per-account MCP fetches ([#173](https://github.com/StackOneHQ/stackone-ai-python/issues/173)) ([cd635e6](https://github.com/StackOneHQ/stackone-ai-python/commit/cd635e65621e4e84da270a57e4e1453a3734ad95))
173
+
174
+ ## [2.6.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.5.1...stackone-ai-v2.6.0) (2026-04-07)
175
+
176
+
177
+ ### Features
178
+
179
+ * include available connectors in search/execute tool descriptions ([#165](https://github.com/StackOneHQ/stackone-ai-python/issues/165)) ([544f41e](https://github.com/StackOneHQ/stackone-ai-python/commit/544f41ef1340d11f58be1a34e627aa8e81f1102d))
180
+
181
+ ## [2.5.1](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.5.0...stackone-ai-v2.5.1) (2026-03-26)
182
+
183
+
184
+ ### Bug Fixes
185
+
186
+ * **search:** fall back to local search when semantic results don't match MCP tools ([#159](https://github.com/StackOneHQ/stackone-ai-python/issues/159)) ([2c86475](https://github.com/StackOneHQ/stackone-ai-python/commit/2c864759f43dc701d1bfa8407badf4a10f608332))
187
+
188
+ ## [2.5.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.4.0...stackone-ai-v2.5.0) (2026-03-25)
189
+
190
+
191
+ ### Features
192
+
193
+ * **search-tools:** LLM-driven search and execute and new API ([#151](https://github.com/StackOneHQ/stackone-ai-python/issues/151)) ([a5e5723](https://github.com/StackOneHQ/stackone-ai-python/commit/a5e5723689d702ce4d176194a0d6a43486bcdff7))
194
+
195
+ ## [2.4.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.3.1...stackone-ai-v2.4.0) (2026-03-06)
196
+
197
+
198
+ ### Features
199
+
200
+ * **search:** Semantic Tool Search ([#149](https://github.com/StackOneHQ/stackone-ai-python/issues/149)) ([ac76d1b](https://github.com/StackOneHQ/stackone-ai-python/commit/ac76d1b12734f81ad29c2e30cf968ff2f1a1326c))
201
+ * **skills:** add just-commands skill with dynamic context injection ([#133](https://github.com/StackOneHQ/stackone-ai-python/issues/133)) ([bf9f3fb](https://github.com/StackOneHQ/stackone-ai-python/commit/bf9f3fb46c4a6dbb55e76c83ceef0eb465b481fb))
202
+
203
+ ## [2.3.1](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.3.0...stackone-ai-v2.3.1) (2026-01-29)
204
+
205
+
206
+ ### Documentation
207
+
208
+ * fix Python version requirement to 3.10+ ([#131](https://github.com/StackOneHQ/stackone-ai-python/issues/131)) ([ef2b4e3](https://github.com/StackOneHQ/stackone-ai-python/commit/ef2b4e3d06290d4fdc638bc66eec0c48b177c4f0))
209
+
210
+ ## [2.3.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.1.1...stackone-ai-v2.3.0) (2026-01-29)
211
+
212
+
213
+ ### Bug Fixes
214
+
215
+ * **nix:** replace deprecated nixfmt-rfc-style with nixfmt ([#114](https://github.com/StackOneHQ/stackone-ai-python/issues/114)) ([10627b4](https://github.com/StackOneHQ/stackone-ai-python/commit/10627b441745806f3b57a7b1cdba296ef722b00f))
216
+
217
+
218
+ ### Miscellaneous Chores
219
+
220
+ * trigger release 2.3.0 ([#130](https://github.com/StackOneHQ/stackone-ai-python/issues/130)) ([a28d0a6](https://github.com/StackOneHQ/stackone-ai-python/commit/a28d0a6fbcf703dd640d3255fa4171046ea225c7))
221
+
222
+ ## [2.1.1](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.1.0...stackone-ai-v2.1.1) (2026-01-22)
223
+
224
+
225
+ ### Bug Fixes
226
+
227
+ * **ci:** skip mock server install in release workflow [ENG-11910] ([#111](https://github.com/StackOneHQ/stackone-ai-python/issues/111)) ([377d766](https://github.com/StackOneHQ/stackone-ai-python/commit/377d766a276b444e84fee5af95f3d56db7e0b89b))
228
+
229
+ ## [2.1.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v2.0.0...stackone-ai-v2.1.0) (2026-01-22)
230
+
231
+
232
+ ### Features
233
+
234
+ * **nix:** integrate uv2nix for Python dependency management ([#88](https://github.com/StackOneHQ/stackone-ai-python/issues/88)) ([ee67062](https://github.com/StackOneHQ/stackone-ai-python/commit/ee67062d1a6628c9b549f2ad69c0c1d7bdde6d97))
235
+
236
+
237
+ ### Bug Fixes
238
+
239
+ * **ci:** add submodules checkout to coverage job ([#85](https://github.com/StackOneHQ/stackone-ai-python/issues/85)) ([4cf907a](https://github.com/StackOneHQ/stackone-ai-python/commit/4cf907a49ac288f368ebbfa3a5dc59a0194bf54a))
240
+
241
+
242
+ ### Documentation
243
+
244
+ * deepwiki badge ([#97](https://github.com/StackOneHQ/stackone-ai-python/issues/97)) ([d8b0234](https://github.com/StackOneHQ/stackone-ai-python/commit/d8b02346b6a77377b7c0356e636edcf2eac47096))
245
+ * **readme:** improve Nix development environment setup instructions ([#94](https://github.com/StackOneHQ/stackone-ai-python/issues/94)) ([2d6f6c2](https://github.com/StackOneHQ/stackone-ai-python/commit/2d6f6c224d1119a5a0254934ff542a0572f44c06))
246
+ * **readme:** reorganise installation section ([#72](https://github.com/StackOneHQ/stackone-ai-python/issues/72)) ([3cde479](https://github.com/StackOneHQ/stackone-ai-python/commit/3cde4794739e95479409396adc3b6e3b01eb3d33))
247
+ * **rules:** add nix-workflow rule ([#106](https://github.com/StackOneHQ/stackone-ai-python/issues/106)) ([b10c164](https://github.com/StackOneHQ/stackone-ai-python/commit/b10c164142ede3ce37b96a27b0e73452d6de50e6))
248
+
249
+ ## [2.0.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v0.3.4...stackone-ai-v2.0.0) (2025-12-29)
250
+
251
+
252
+ ### ⚠ BREAKING CHANGES
253
+
254
+ * Drop support for Python 3.9 and 3.10.
255
+ * Error handling now uses httpx exceptions instead of requests exceptions. Code catching RequestException should be updated to catch httpx.HTTPStatusError or httpx.RequestError.
256
+ * migrate examples and tests to connector-based tool naming ([#51](https://github.com/StackOneHQ/stackone-ai-python/issues/51))
257
+ * The `docs` optional dependency group and related commands (`make docs-serve`, `make docs-build`) are no longer available.
258
+ * remove MCP server implementation ([#45](https://github.com/StackOneHQ/stackone-ai-python/issues/45))
259
+ * remove deprecated OAS-based getTools, migrate to fetchTools only ([#42](https://github.com/StackOneHQ/stackone-ai-python/issues/42))
260
+
261
+ ### Features
262
+
263
+ * add test coverage reporting with GitHub Pages badge ([#62](https://github.com/StackOneHQ/stackone-ai-python/issues/62)) ([0ef05cf](https://github.com/StackOneHQ/stackone-ai-python/commit/0ef05cf8746e3ca113e6fd6d33bc62fc91711f77))
264
+ * **security:** add gitleaks for secret detection ([#63](https://github.com/StackOneHQ/stackone-ai-python/issues/63)) ([1a31baa](https://github.com/StackOneHQ/stackone-ai-python/commit/1a31baa489882da9fc12684d1a060e48928288a9))
265
+
266
+
267
+ ### Bug Fixes
268
+
269
+ * **ci:** use just commands in CI and release workflows ([#57](https://github.com/StackOneHQ/stackone-ai-python/issues/57)) ([38a9dd6](https://github.com/StackOneHQ/stackone-ai-python/commit/38a9dd6cc0b0deea53d1dfb6472686e151df53e4))
270
+ * migrate examples and tests to connector-based tool naming ([#51](https://github.com/StackOneHQ/stackone-ai-python/issues/51)) ([c365dbd](https://github.com/StackOneHQ/stackone-ai-python/commit/c365dbd98e8084eea45857292eee90a1798bce16))
271
+ * migrate HTTP client from requests to httpx ([#52](https://github.com/StackOneHQ/stackone-ai-python/issues/52)) ([9d180ef](https://github.com/StackOneHQ/stackone-ai-python/commit/9d180efb42647a573e3055ee47ea361dad2dec07))
272
+ * remove MCP server implementation ([#45](https://github.com/StackOneHQ/stackone-ai-python/issues/45)) ([bcb12b4](https://github.com/StackOneHQ/stackone-ai-python/commit/bcb12b4ee50e055c4cb29f3aa9baf81352683415))
273
+ * **scripts:** add uv lock refresh to version update script ([#50](https://github.com/StackOneHQ/stackone-ai-python/issues/50)) ([bde6d88](https://github.com/StackOneHQ/stackone-ai-python/commit/bde6d88a5688790ada366ed76563092aba0effe4))
274
+
275
+
276
+ ### Documentation
277
+
278
+ * remove meta tools implementation details from README ([#40](https://github.com/StackOneHQ/stackone-ai-python/issues/40)) ([10510d4](https://github.com/StackOneHQ/stackone-ai-python/commit/10510d4b93fc4e20aa51a706541a649115900e6d))
279
+ * remove obsolete migration section from README ([#56](https://github.com/StackOneHQ/stackone-ai-python/issues/56)) ([bdcf90d](https://github.com/StackOneHQ/stackone-ai-python/commit/bdcf90d07cd29236f1372d53872689ef624f8e03))
280
+
281
+
282
+ ### Miscellaneous Chores
283
+
284
+ * bump minimum Python version to 3.11 ([#81](https://github.com/StackOneHQ/stackone-ai-python/issues/81)) ([527e828](https://github.com/StackOneHQ/stackone-ai-python/commit/527e8284a73f47af741454610f71d462d095f79c))
285
+ * remove MkDocs documentation generation feature ([#46](https://github.com/StackOneHQ/stackone-ai-python/issues/46)) ([947863e](https://github.com/StackOneHQ/stackone-ai-python/commit/947863e91160a07fcd60d8ee837fb79a35abf0b0))
286
+ * trigger release 2.0.0 ([#82](https://github.com/StackOneHQ/stackone-ai-python/issues/82)) ([daa963b](https://github.com/StackOneHQ/stackone-ai-python/commit/daa963bacda5d79ad1bc7773d6432507c2ebfdb1))
287
+
288
+
289
+ ### Code Refactoring
290
+
291
+ * remove deprecated OAS-based getTools, migrate to fetchTools only ([#42](https://github.com/StackOneHQ/stackone-ai-python/issues/42)) ([d50d5fb](https://github.com/StackOneHQ/stackone-ai-python/commit/d50d5fb20402dd625217b2900287ae7d9e4cb98c))
292
+
293
+ ## [0.3.4](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v0.3.3...stackone-ai-v0.3.4) (2025-11-12)
294
+
295
+
296
+ ### Features
297
+
298
+ * Add MCP-backed dynamic tool fetching to Python SDK ([#39](https://github.com/StackOneHQ/stackone-ai-python/issues/39)) ([d72ca80](https://github.com/StackOneHQ/stackone-ai-python/commit/d72ca808233600bd32374c7e2028232eb54167de))
299
+ * add provider/action filtering and hybrid BM25 + TF-IDF search ([#37](https://github.com/StackOneHQ/stackone-ai-python/issues/37)) ([a1c688b](https://github.com/StackOneHQ/stackone-ai-python/commit/a1c688b4efaef9257ecec9827baa7ef90529b9f7))
300
+
301
+ ## [0.3.3](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v0.3.2...stackone-ai-v0.3.3) (2025-10-17)
302
+
303
+
304
+ ### Features
305
+
306
+ * feedback tool ([#36](https://github.com/StackOneHQ/stackone-ai-python/issues/36)) ([9179918](https://github.com/StackOneHQ/stackone-ai-python/commit/9179918104c0ec4cfe0488713ca325f0e8e7c6f1))
307
+ * LangGraph integration helpers and example ([#33](https://github.com/StackOneHQ/stackone-ai-python/issues/33)) ([983e2f7](https://github.com/StackOneHQ/stackone-ai-python/commit/983e2f7e6551e3722f235ea534ae61f24644350e))
308
+
309
+
310
+ ### Bug Fixes
311
+
312
+ * remove async method ([#31](https://github.com/StackOneHQ/stackone-ai-python/issues/31)) ([370699e](https://github.com/StackOneHQ/stackone-ai-python/commit/370699e390e4a46d8b4ae664fed8f5de6395eb9d))
313
+
314
+
315
+ ### Documentation
316
+
317
+ * use uv for installing ([#30](https://github.com/StackOneHQ/stackone-ai-python/issues/30)) ([3c5d8fb](https://github.com/StackOneHQ/stackone-ai-python/commit/3c5d8fb54e61f8f730098e97f8bf2dfc78cf3bec))
318
+
319
+ ## [0.3.2](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v0.3.1...stackone-ai-v0.3.2) (2025-08-26)
320
+
321
+
322
+ ### Features
323
+
324
+ * support Python 3.9+ with optional MCP server support ([#28](https://github.com/StackOneHQ/stackone-ai-python/issues/28)) ([1a37776](https://github.com/StackOneHQ/stackone-ai-python/commit/1a377768c15223e25dbaf1e0bcd0c0e8bb0df2e8))
325
+
326
+ ## [0.3.1](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v0.3.0...stackone-ai-v0.3.1) (2025-08-19)
327
+
328
+
329
+ ### Documentation
330
+
331
+ * add comprehensive LangChain integration section to README ([#20](https://github.com/StackOneHQ/stackone-ai-python/issues/20)) ([cbf7f68](https://github.com/StackOneHQ/stackone-ai-python/commit/cbf7f68e889839f9a501ad8f2cd47c468ffff47e))
332
+ * rename meta tools ([#27](https://github.com/StackOneHQ/stackone-ai-python/issues/27)) ([a9ebc03](https://github.com/StackOneHQ/stackone-ai-python/commit/a9ebc032f784863913b28d4ad3850b80bafee5f4))
333
+
334
+ ## [0.3.0](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v0.0.4...stackone-ai-v0.3.0) (2025-08-19)
335
+
336
+
337
+ ### Features
338
+
339
+ * add CLAUDE.md for Claude Code guidance ([#15](https://github.com/StackOneHQ/stackone-ai-python/issues/15)) ([ac9fe98](https://github.com/StackOneHQ/stackone-ai-python/commit/ac9fe9857f44c19394654dfcbe23fecc5cf9fbb0))
340
+ * bring Python SDK to feature parity with Node SDK ([#17](https://github.com/StackOneHQ/stackone-ai-python/issues/17)) ([8b6de99](https://github.com/StackOneHQ/stackone-ai-python/commit/8b6de99184227cb7f1580964dc3eae14f8f60fc1))
341
+ * remove automatic STACKONE_ACCOUNT_ID environment variable loading ([#23](https://github.com/StackOneHQ/stackone-ai-python/issues/23)) ([aa0aaf6](https://github.com/StackOneHQ/stackone-ai-python/commit/aa0aaf6d6bf528f8e29def9b008db23cf94b97c7))
342
+ * simplify meta tool function names to match Node SDK ([#19](https://github.com/StackOneHQ/stackone-ai-python/issues/19)) ([4572609](https://github.com/StackOneHQ/stackone-ai-python/commit/4572609a9b85a88fc3067be12f821ec0bc54e769))
343
+
344
+
345
+ ### Miscellaneous Chores
346
+
347
+ * release 0.3.0 ([#24](https://github.com/StackOneHQ/stackone-ai-python/issues/24)) ([beea911](https://github.com/StackOneHQ/stackone-ai-python/commit/beea91165ed2ba3eb5f5ad6ca8656344561b0b43))
348
+
349
+ ## [0.0.4](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v0.0.3...stackone-ai-v0.0.4) (2025-03-05)
350
+
351
+
352
+ ### Bug Fixes
353
+
354
+ * ci ([#14](https://github.com/StackOneHQ/stackone-ai-python/issues/14)) ([08aba6e](https://github.com/StackOneHQ/stackone-ai-python/commit/08aba6e96e55b4bedc7272e3adc91a1745d7859a))
355
+ * script dependencies ([#12](https://github.com/StackOneHQ/stackone-ai-python/issues/12)) ([960c5d8](https://github.com/StackOneHQ/stackone-ai-python/commit/960c5d86f33fcda8bae72d58166ee5991e08f4d5))
356
+
357
+ ## [0.0.3](https://github.com/StackOneHQ/stackone-ai-python/compare/stackone-ai-v0.0.2...stackone-ai-v0.0.3) (2025-03-05)
358
+
359
+
360
+ ### Features
361
+
362
+ * create operations and file upload. ([#4](https://github.com/StackOneHQ/stackone-ai-python/issues/4)) ([c8469e3](https://github.com/StackOneHQ/stackone-ai-python/commit/c8469e3e0f7d7d35aee88edd0585a76411dcfba1))
363
+ * docs ([#3](https://github.com/StackOneHQ/stackone-ai-python/issues/3)) ([13575ea](https://github.com/StackOneHQ/stackone-ai-python/commit/13575eacede3c96ee3861611cdac6fca5663d7e9))
364
+ * docs site ([7a2984c](https://github.com/StackOneHQ/stackone-ai-python/commit/7a2984c33deb748abe3f282a449075631da80aef))
365
+ * langchain tools ([#2](https://github.com/StackOneHQ/stackone-ai-python/issues/2)) ([c2dc5aa](https://github.com/StackOneHQ/stackone-ai-python/commit/c2dc5aadda1104117c60703ccca6ceb63f8fd68d))
366
+ * licence ([#7](https://github.com/StackOneHQ/stackone-ai-python/issues/7)) ([feebc08](https://github.com/StackOneHQ/stackone-ai-python/commit/feebc08ee61f9e4569cbc44c4bac4d1060c036ef))
367
+ * openai compat tools ([64ac1da](https://github.com/StackOneHQ/stackone-ai-python/commit/64ac1da8f1d4fad090a1822d751e003a2cca2e52))
368
+ * release please ([2946dfb](https://github.com/StackOneHQ/stackone-ai-python/commit/2946dfbdaf2d27bdcfa49925c6aeaa59ea1a9a5e))
369
+
370
+
371
+ ### Bug Fixes
372
+
373
+ * all extras ([235b5e3](https://github.com/StackOneHQ/stackone-ai-python/commit/235b5e32da6a0495d9ef082403ab2898c42a1976))
374
+ * Andres comments ([#9](https://github.com/StackOneHQ/stackone-ai-python/issues/9)) ([c97f0b7](https://github.com/StackOneHQ/stackone-ai-python/commit/c97f0b75959f556b94049fc2b65e51172339b718))
375
+ * ci ([6aae7fa](https://github.com/StackOneHQ/stackone-ai-python/commit/6aae7fafedebf48a86f6940c479463e1daf4bf93))
376
+ * clean up docs ([9186ec3](https://github.com/StackOneHQ/stackone-ai-python/commit/9186ec36937dd4d8cae1fe7367a686aeb01a0459))
377
+ * docs formatting ([#6](https://github.com/StackOneHQ/stackone-ai-python/issues/6)) ([2ac9a87](https://github.com/StackOneHQ/stackone-ai-python/commit/2ac9a8792bc630e60bed560102ad55e12f4cc7c5))
378
+ * type stubs in python packaging ([#11](https://github.com/StackOneHQ/stackone-ai-python/issues/11)) ([97c6ffe](https://github.com/StackOneHQ/stackone-ai-python/commit/97c6ffed7c6aaaef2834a503013805a6d31836d0))