cognite-function-apps 0.13.0__tar.gz → 0.14.0__tar.gz

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/.github/agents/agentic-workflows.agent.md

@@ -19,7 +19,13 @@ This is a **dispatcher agent** that routes your request to the appropriate speci
 - **Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
 - **Fixing Dependabot PRs**: Routes to `dependabot` prompt — use this when Dependabot opens PRs that modify generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`). Never merge those PRs directly; instead update the source `.md` files and rerun `gh aw compile --dependabot` to bundle all fixes
 - **Analyzing test coverage**: Routes to `test-coverage` prompt — consult this whenever the workflow reads, analyzes, or reports on test coverage data from PRs or CI runs
+- **Rendering ASCII charts in markdown**: Routes to `asciicharts` guide — consult this whenever the workflow needs compact charts that render reliably in GitHub issues, comments, or discussions
 - **CLI commands and triggering workflows**: Routes to `cli-commands` guide — consult this whenever the user asks how to run, compile, debug, or manage workflows from the command line, or when they need the MCP tool equivalent of a `gh aw` command
+- **Reducing token consumption / cost optimization**: Routes to `token-optimization` guide — consult this whenever the user asks how to reduce token usage, lower costs, speed up workflows, or measure the impact of prompt changes with experiments
+- **Choosing workflow architectures and design patterns**: Routes to `patterns` guide — consult this whenever the user asks for strategy, architecture, operating models, or pattern selection for agentic workflows
+
+> [!IMPORTANT]
+> For architecture/pattern-selection requests, load `https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/patterns.md` first.
 
 Workflows may optionally include:
 
@@ -31,7 +37,7 @@ Workflows may optionally include:
 - Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
 - Workflow lock files: `.github/workflows/*.lock.yml`
 - Shared components: `.github/workflows/shared/*.md`
-- Configuration: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/github-agentic-workflows.md
+- Configuration: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/github-agentic-workflows.md
 
 ## Problems This Solves
 
@@ -53,7 +59,7 @@ When you interact with this agent, it will:
 ### Create New Workflow
 **Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet
 
-**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/create-agentic-workflow.md
+**Prompt file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/create-agentic-workflow.md
 
 **Use cases**:
 - "Create a workflow that triages issues"
@@ -63,7 +69,7 @@ When you interact with this agent, it will:
 ### Update Existing Workflow  
 **Load when**: User wants to modify, improve, or refactor an existing workflow
 
-**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/update-agentic-workflow.md
+**Prompt file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/update-agentic-workflow.md
 
 **Use cases**:
 - "Add web-fetch tool to the issue-classifier workflow"
@@ -73,7 +79,7 @@ When you interact with this agent, it will:
 ### Debug Workflow  
 **Load when**: User needs to investigate, audit, debug, or understand a workflow, troubleshoot issues, analyze logs, or fix errors
 
-**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/debug-agentic-workflow.md
+**Prompt file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/debug-agentic-workflow.md
 
 **Use cases**:
 - "Why is this workflow failing?"
@@ -83,7 +89,7 @@ When you interact with this agent, it will:
 ### Upgrade Agentic Workflows
 **Load when**: User wants to upgrade workflows to a new gh-aw version or fix deprecations
 
-**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/upgrade-agentic-workflows.md
+**Prompt file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/upgrade-agentic-workflows.md
 
 **Use cases**:
 - "Upgrade all workflows to the latest version"
@@ -93,7 +99,7 @@ When you interact with this agent, it will:
 ### Create a Report-Generating Workflow
 **Load when**: The workflow being created or updated produces reports — recurring status updates, audit summaries, analyses, or any structured output posted as a GitHub issue, discussion, or comment
 
-**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/report.md
+**Prompt file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/report.md
 
 **Use cases**:
 - "Create a weekly CI health report"
@@ -103,7 +109,7 @@ When you interact with this agent, it will:
 ### Create Shared Agentic Workflow
 **Load when**: User wants to create a reusable workflow component or wrap an MCP server
 
-**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/create-shared-agentic-workflow.md
+**Prompt file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/create-shared-agentic-workflow.md
 
 **Use cases**:
 - "Create a shared component for Notion integration"
@@ -113,7 +119,7 @@ When you interact with this agent, it will:
 ### Fix Dependabot PRs
 **Load when**: User needs to close or fix open Dependabot PRs that update dependencies in generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`)
 
-**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/dependabot.md
+**Prompt file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/dependabot.md
 
 **Use cases**:
 - "Fix the open Dependabot PRs for npm dependencies"
@@ -123,17 +129,27 @@ When you interact with this agent, it will:
 ### Analyze Test Coverage
 **Load when**: The workflow reads, analyzes, or reports test coverage — whether triggered by a PR, a schedule, or a slash command. Always consult this prompt before designing the coverage data strategy.
 
-**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/test-coverage.md
+**Prompt file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/test-coverage.md
 
 **Use cases**:
 - "Create a workflow that comments coverage on PRs"
 - "Analyze coverage trends over time"
 - "Add a coverage gate that blocks PRs below a threshold"
 
+### Render ASCII Charts in Markdown
+**Load when**: The workflow needs in-markdown charts (sparklines, bars, table+trend views) that must align cleanly and render reliably across GitHub surfaces, including mobile.
+
+**Reference file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/asciicharts.md
+
+**Use cases**:
+- "Show a compact trend chart in an issue comment"
+- "Render a dashboard table with sparkline trends"
+- "Generate aligned ASCII bars for service metrics"
+
 ### CLI Commands Reference
 **Load when**: The user asks how to run, compile, debug, or manage workflows from the command line; needs the MCP tool equivalent of a `gh aw` command; or is in a restricted environment (e.g., Copilot Cloud) without direct CLI access.
 
-**Reference file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/cli-commands.md
+**Reference file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/cli-commands.md
 
 **Use cases**:
 - "How do I trigger workflow X on the main branch?"
@@ -141,6 +157,30 @@ When you interact with this agent, it will:
 - "I'm in Copilot Cloud — how do I compile a workflow?"
 - "Show me all available gh aw commands"
 
+### Token Consumption Optimization
+**Load when**: The user asks how to reduce token usage, lower workflow costs, make a workflow faster or cheaper, or measure the impact of prompt or configuration changes.
+
+**Reference file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/token-optimization.md
+
+**Use cases**:
+- "How do I reduce the token cost of this workflow?"
+- "My workflow is too expensive — how do I optimize it?"
+- "How do I compare token usage between two runs?"
+- "Should I use gh-proxy or the MCP server?"
+- "How do I use sub-agents to reduce costs?"
+- "How do I measure the impact of a prompt change?"
+
+### Workflow Pattern Selection
+**Load when**: The user asks for architecture, strategy, operating model selection, or pattern recommendations for building agentic workflows.
+
+**Reference file**: https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/patterns.md
+
+**Use cases**:
+- "Which pattern should I use for multi-repo rollout?"
+- "How should I structure this workflow architecture?"
+- "What pattern fits slash-command triage?"
+- "Should this be DispatchOps or DailyOps?"
+
 ## Instructions
 
 When a user interacts with you:
@@ -185,12 +225,12 @@ gh aw compile --validate
 
 ## Important Notes
 
-- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/github-agentic-workflows.md for complete documentation
+- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/github-agentic-workflows.md for complete documentation
 - Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
 - Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
 - **Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF
 - Follow security best practices: minimal permissions, explicit network access, no template injection
-- **Network configuration**: Use ecosystem identifiers (`node`, `python`, `go`, etc.) or explicit FQDNs in `network.allowed`. Bare shorthands like `npm` or `pypi` are **not** valid. See https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/network.md for the full list of valid ecosystem identifiers and domain patterns.
+- **Network configuration**: Use ecosystem identifiers (`node`, `python`, `go`, etc.) or explicit FQDNs in `network.allowed`. Bare shorthands like `npm` or `pypi` are **not** valid. See https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/network.md for the full list of valid ecosystem identifiers and domain patterns.
 - **Single-file output**: When creating a workflow, produce exactly **one** workflow `.md` file. Do not create separate documentation files (architecture docs, runbooks, usage guides, etc.). If documentation is needed, add a brief `## Usage` section inside the workflow file itself.
 - **Triggering runs**: Always use `gh aw run <workflow-name>` to trigger a workflow on demand — not `gh workflow run <file>.lock.yml`. `gh aw run` handles workflow resolution by short name, input parsing and validation, and correct run-tracking for agentic workflows. Use `--ref <branch>` to run on a specific branch.
-- **CLI commands reference**: For a complete guide on all `gh aw` commands and their MCP tool equivalents (for restricted environments), see https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/cli-commands.md
+- **CLI commands reference**: For a complete guide on all `gh aw` commands and their MCP tool equivalents (for restricted environments), see https://github.com/github/gh-aw/blob/v0.76.1/.github/aw/cli-commands.md

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/.github/aw/actions-lock.json

@@ -25,10 +25,10 @@
       "version": "v7.0.1",
       "sha": "043fb46d1a93c77aae656e7c1c64a875d1fc6a0a"
     },
-    "github/gh-aw-actions/setup@v0.71.5": {
+    "github/gh-aw-actions/setup@v0.76.1": {
       "repo": "github/gh-aw-actions/setup",
-      "version": "v0.71.5",
-      "sha": "b8068426813005612b960b5ab0b8bd2c27142323"
+      "version": "v0.76.1",
+      "sha": "46d564922b082d0db93244972e8005ea6904ee5f"
     }
   }
 }

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/.github/renovate.json

@@ -16,6 +16,13 @@
       ],
       "enabled": false,
       "description": "Disable Python version updates - we need to support Function runtimes from 3.10 to 3.12"
+    },
+    {
+      "matchDepNames": [
+        "github/gh-aw-actions"
+      ],
+      "enabled": false,
+      "description": "Disable gh-aw-actions updates - must be upgraded manually via 'gh aw upgrade' which runs codemods and recompiles workflows"
     }
   ]
 }

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/.github/workflows/copilot-setup-steps.yml

@@ -21,6 +21,6 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
       - name: Install gh-aw extension
-        uses: github/gh-aw-actions/setup-cli@23453ecc01928d28ee1e773e403b216b29e89a5b # v0.74.2
+        uses: github/gh-aw-actions/setup-cli@46d564922b082d0db93244972e8005ea6904ee5f # v0.76.1
         with:
-          version: v0.71.5
+          version: v0.76.1

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/.github/workflows/python-package.yml

@@ -16,27 +16,21 @@ permissions:
   pull-requests: write  # Allow posting test results as PR comments
 
 jobs:
-  build:
+  lint:
     runs-on: ubuntu-latest
     if: ${{ github.actor != 'github-actions[bot]' }}
-    strategy:
-      matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-        with:
-          fetch-depth: 0
 
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version: "3.13"
+          enable-cache: true
 
       - name: Install dependencies
-        run: |
-          pipx install uv
-          uv sync --all-extras
+        run: uv sync --all-extras
 
       - name: Check formatting
         run: |
@@ -46,13 +40,34 @@ jobs:
         run: |
           SKIP=ruff-format uv run pre-commit run --all-files --show-diff-on-failure
 
+  test:
+    runs-on: ubuntu-latest
+    if: ${{ github.actor != 'github-actions[bot]' }}
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          fetch-depth: 0
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
       - name: Test with pytest
         run: |
           uv run pytest --cov=src/cognite_function_apps --cov-report=xml --cov-report=term
 
       - name: Upload coverage reports to Codecov
-        if: matrix.python-version == '3.13'
         uses: codecov/codecov-action@e79a6962e0d4c0c17b229090214935d2e33f8354 # v6
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           slug: cognitedata/cognite-function-apps
+          flags: python${{ matrix.python-version }}

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/.pre-commit-config.yaml

@@ -20,5 +20,5 @@ repos:
         language: node
         pass_filenames: false
         types: [python]
-        additional_dependencies: ["pyright@1.1.409"]
+        additional_dependencies: ["pyright@1.1.410"]
     repo: local

cognite_function_apps-0.14.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.14.0"
+}

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [0.14.0](https://github.com/cognitedata/cognite-function-apps/compare/cognite-function-apps-v0.13.1...cognite-function-apps-v0.14.0) (2026-09-03)
+
+
+### Features
+
+* return 405 MethodNotAllowed when path exists but method is wrong [Repo Assist]  ([#195](https://github.com/cognitedata/cognite-function-apps/issues/195)) ([4b162b1](https://github.com/cognitedata/cognite-function-apps/commit/4b162b19bd40fce049ec2fe737b782a8e019007b))
+
+
+### Bug Fixes
+
+* declare pydantic-settings in the cli extra ([#221](https://github.com/cognitedata/cognite-function-apps/issues/221)) ([e2dcee1](https://github.com/cognitedata/cognite-function-apps/commit/e2dcee1d05c5efef1fb5f62c3e752603b7e49b4c))
+* handle HTTP 204 No Content in BaseFunctionClient._call_method [Repo Assist] ([#181](https://github.com/cognitedata/cognite-function-apps/issues/181)) ([130ffe0](https://github.com/cognitedata/cognite-function-apps/commit/130ffe059c1feff350b9b71b317221496fe4e649))
+* include items schema for list/sequence-type query parameters [Repo Assist] ([#205](https://github.com/cognitedata/cognite-function-apps/issues/205)) ([cbec617](https://github.com/cognitedata/cognite-function-apps/commit/cbec6172d2feffd5ecdf4e7bcab4e74d79045d57))
+* **mcp:** handle Optional and union types in MCP input schema [Repo Assist] ([#209](https://github.com/cognitedata/cognite-function-apps/issues/209)) ([7fddf87](https://github.com/cognitedata/cognite-function-apps/commit/7fddf8730aa61fbaf5ad7e603bbe1b4d271acfaf))
+* use eu.honeycomb backend in handler example ([#200](https://github.com/cognitedata/cognite-function-apps/issues/200)) ([61ed4a6](https://github.com/cognitedata/cognite-function-apps/commit/61ed4a6c125504e3e8e401fdfde3c7248939aee8))
+
+
+### Code Refactoring
+
+* pre-compile regex patterns in formatting.py ([#192](https://github.com/cognitedata/cognite-function-apps/issues/192)) ([c10e895](https://github.com/cognitedata/cognite-function-apps/commit/c10e8958fc99e95d7b36f664d21656a3f0b31526))
+
+## [0.13.1](https://github.com/cognitedata/cognite-function-apps/compare/cognite-function-apps-v0.13.0...cognite-function-apps-v0.13.1) (2026-06-05)
+
+
+### Bug Fixes
+
+* guard get_type_hints in MCPApp.tool decorator against NameError [Repo Assist] ([#164](https://github.com/cognitedata/cognite-function-apps/issues/164)) ([f6a520a](https://github.com/cognitedata/cognite-function-apps/commit/f6a520a56d81223e5c27af65fd2921e0bb9cb45e))
+* guard isinstance against subscripted generics for Python 3.10 compatibility ([#188](https://github.com/cognitedata/cognite-function-apps/issues/188)) ([438118b](https://github.com/cognitedata/cognite-function-apps/commit/438118b5e67512c516189ac29d96c07fceebc6b3))
+* use inspect.cleandoc() for docstring descriptions to prevent empty OpenAPI summary [Repo Assist] ([#184](https://github.com/cognitedata/cognite-function-apps/issues/184)) ([6b95700](https://github.com/cognitedata/cognite-function-apps/commit/6b957001f0b60969d9a4dcb33a38ac64fabe9b52))
+
+
+### Performance Improvements
+
+* cache has_var_keyword in RouteInfo and pre-compile Accept header regex [Repo Assist] ([#147](https://github.com/cognitedata/cognite-function-apps/issues/147)) ([c453c90](https://github.com/cognitedata/cognite-function-apps/commit/c453c905854b0517af64a131436f8789bab19f7b))
+
+
+### Code Refactoring
+
+* extract _convert_union and _convert_basemodel from convert_value_to_type ([#194](https://github.com/cognitedata/cognite-function-apps/issues/194)) ([23e6150](https://github.com/cognitedata/cognite-function-apps/commit/23e6150eaa4ac85ff31fe6e939b95afbb0af5408))
+
 ## [0.13.0](https://github.com/cognitedata/cognite-function-apps/compare/cognite-function-apps-v0.12.0...cognite-function-apps-v0.13.0) (2026-05-22)
 
 

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: cognite-function-apps
-Version: 0.13.0
+Version: 0.14.0
 Summary: FastAPI-style framework for building composable Function Apps for Cognite Functions with automatic OpenAPI schema generation and MCP integration
 Project-URL: Repository, https://github.com/cognitedata/cognite-function-apps
 Project-URL: Changelog, https://github.com/cognitedata/cognite-function-apps/releases
@@ -10,6 +10,7 @@ Requires-Dist: cognite-sdk>=7.87.0
 Requires-Dist: pydantic>=2.10.5
 Requires-Dist: typing-extensions>=4.11.0
 Provides-Extra: cli
+Requires-Dist: pydantic-settings>=2.0.0; extra == 'cli'
 Requires-Dist: typer>=0.9.0; extra == 'cli'
 Requires-Dist: uvicorn>=0.37.0; extra == 'cli'
 Provides-Extra: tracing

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/docs/dev-server.md

@@ -15,7 +15,7 @@ The dev server allows you to test your Cognite Functions locally before deployin
 
 ### 1. Install CLI Support
 
-Install cognite-function-apps with CLI support to get the `fun` command and uvicorn:
+Install cognite-function-apps with CLI support to get the `fun` command and the local server dependencies:
 
 ```bash
 pip install cognite-function-apps[cli]
@@ -23,7 +23,7 @@ pip install cognite-function-apps[cli]
 uv add cognite-function-apps --extra cli
 ```
 
-This installs both the framework and uvicorn (the development server).
+This installs the framework plus typer, uvicorn, and pydantic-settings.
 
 ### 2. Set Environment Variables
 

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/examples/handler.py

@@ -49,8 +49,8 @@ app = FunctionApp(title="Asset Management API", version="1.0.0")
 mcp = create_mcp_app("asset-management-tools")
 
 # Tracing with backend presets:
-# - Production: backend="honeycomb" or "lightstep" (requires tracing-api-key secret)
-tracing = create_tracing_app(backend="honeycomb")  # Free tier available at https://ui.honeycomb.io/
+# - Production: backend="eu.honeycomb" or "lightstep" (requires tracing-api-key secret)
+tracing = create_tracing_app(backend="eu.honeycomb")  # Free tier available at https://ui.eu1.honeycomb.io/
 
 # - Local dev: Use TracingConfig for Jaeger (no auth)
 # from cognite_function_apps import TracingConfig

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/pyproject.toml

@@ -24,6 +24,7 @@ Changelog = "https://github.com/cognitedata/cognite-function-apps/releases"
 cli = [
     "uvicorn>=0.37.0",
     "typer>=0.9.0",
+    "pydantic-settings>=2.0.0",
 ]
 
 tracing = [
@@ -47,7 +48,7 @@ dev = [
     "pytest-cov>=6.0.0",
     "openapi-spec-validator>=0.7.0",
     "pre-commit>=4.3.0",
-    "pyright>=1.1.406",
+    "pyright>=1.1.410",
     "ruff>=0.14.1",
     "hypothesis>=6.138.15",
     "uvicorn>=0.37.0",

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/src/cognite_function_apps/__init__.py

@@ -27,6 +27,7 @@ from .models import (
     FunctionCallInfo,
     FunctionCallRuntimeError,
     HTTPMethod,
+    MethodNotAllowedError,
     NotAcceptableError,
     RequestHeaders,
     Response,
@@ -53,6 +54,7 @@ __all__ = [
     "FunctionTracer",
     "HTTPMethod",
     "MCPApp",
+    "MethodNotAllowedError",
     "NotAcceptableError",
     "ProviderFunction",
     "RequestHeaders",

cognite_function_apps-0.14.0/src/cognite_function_apps/_type_utils.py

@@ -0,0 +1,10 @@
+"""Shared type introspection utilities."""
+
+import types
+from typing import Any, Union, get_origin
+
+
+def is_union_type(python_type: Any) -> bool:
+    """Return True if python_type is a union (Union[X, Y] / Optional[X] / X | Y)."""
+    origin = get_origin(python_type)
+    return origin is Union or origin is types.UnionType

cognite_function_apps-0.14.0/src/cognite_function_apps/_version.py

@@ -0,0 +1 @@
+__version__ = "0.14.0"  # x-release-please-version

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/src/cognite_function_apps/app.py

@@ -265,6 +265,26 @@ class FunctionApp:
         # Set the next app in the middleware chain
         self.next_app = next_app
 
+    def get_allowed_methods(self, path: str) -> list[HTTPMethod]:
+        """Return HTTP methods allowed for the given path across this app and all downstream apps.
+
+        Aggregates results from every app in the middleware chain, so a composed service
+        correctly reflects methods registered in any of the composed apps.
+
+        Args:
+            path: The request path to check (e.g., "/items/123")
+
+        Returns:
+            Sorted list of HTTPMethod values registered for this path across all apps,
+            or an empty list if no route matches the path at all.
+        """
+        allowed: set[HTTPMethod] = set()
+        current: FunctionApp | None = self
+        while current is not None:
+            allowed.update(current.router.get_allowed_methods(path))
+            current = current.next_app
+        return sorted(allowed, key=lambda m: m.value)
+
     def extract_path_params(self, path: str) -> Sequence[str]:
         """Extract parameter names from path like /items/{item_id}."""
         return self.router.extract_path_params(path)
@@ -323,7 +343,7 @@ class FunctionApp:
             parameters=params,
             type_hints=type_hints,
             path_params=self.extract_path_params(path),
-            description=description or func.__doc__ or f"{method} {path}",
+            description=description or (inspect.cleandoc(func.__doc__) if func.__doc__ else "") or f"{method} {path}",
             content_type=content_type,
             accept=accept,
             status_code=status_code,
@@ -502,9 +522,10 @@ class FunctionApp:
         body_mapping: DataDict = body if (has_body and isinstance(body, Mapping)) else {}
         sig_params = route_match.signature.parameters
         combined_params = {**query, **body_mapping, **path_params}
-        has_var_keyword = any(p.kind == inspect.Parameter.VAR_KEYWORD for p in sig_params.values())
         all_params = (
-            combined_params if has_var_keyword else {k: v for k, v in combined_params.items() if k in sig_params}
+            combined_params
+            if route_match.has_var_keyword
+            else {k: v for k, v in combined_params.items() if k in sig_params}
         )
 
         func = route_match.endpoint

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/src/cognite_function_apps/base_client.py

@@ -304,7 +304,7 @@ class BaseFunctionClient:
             params: Query parameters
 
         Returns:
-            Unwrapped response data from the completed function call
+            Unwrapped response data from the completed function call, or None for HTTP 204 No Content.
 
         Raises:
             RuntimeError: If the function call failed or the response is malformed
@@ -314,6 +314,10 @@ class BaseFunctionClient:
         else:
             result = self._call_devserver(path, method, body, params)
 
+        # A None result means the server returned HTTP 204 No Content — treat as success with no data.
+        if result is None:
+            return None
+
         # Unwrap the outer runtime_status envelope.
         # Accept both camelCase (new infra) and snake_case (old infra) during the migration grace period.
         if isinstance(result, dict) and ("runtimeStatus" in result or "runtime_status" in result):
@@ -353,6 +357,9 @@ class BaseFunctionClient:
         Returns:
             Deserialized data if a Pydantic model, otherwise raw data
         """
+        if data is None:
+            return None
+
         # Get the module namespace where the actual client class is defined
         # This allows us to find models defined in generated clients
         module_namespace = sys.modules[type(self).__module__].__dict__

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/src/cognite_function_apps/cli.py

@@ -3,8 +3,8 @@
 This module provides CLI commands for working with Function Apps,
 including a development server for local testing.
 
-Note: This module can be safely imported even if CLI dependencies (typer, uvicorn)
-are not installed. Dependency checking only occurs when main() is executed.
+Note: This module can be safely imported even if CLI dependencies (typer, uvicorn,
+pydantic-settings) are not installed. Dependency checking only occurs when main() is executed.
 """
 
 import importlib.util
@@ -16,7 +16,6 @@ import tempfile
 from pathlib import Path
 from typing import Annotated
 
-from cognite_function_apps.devserver import create_asgi_app
 from cognite_function_apps.service import FunctionService
 
 logger = logging.getLogger(__name__)
@@ -121,6 +120,8 @@ def main() -> None:
     try:
         import typer  # noqa: PLC0415
         import uvicorn  # noqa: PLC0415
+
+        from cognite_function_apps.devserver import create_asgi_app  # noqa: PLC0415
     except ImportError as e:
         logger.error(
             """Error: CLI dependencies not installed. Missing: %s

{cognite_function_apps-0.13.0 → cognite_function_apps-0.14.0}/src/cognite_function_apps/client.py

@@ -987,7 +987,7 @@ class FunctionClient(BaseFunctionClient):
                         if isinstance(data, list):
                             data = cast(list[object], data)
                             return [model_class.model_validate(item) for item in data]
-                    else:
+                    elif data is not None:
                         # Single model response
                         return model_class.model_validate(data)