Add memory support, release automation, and full test coverage

.env.example

@@ -1,25 +1,25 @@
 # Example environment for the Cominty SDK.
 #
 # The SDK reads these from the real process environment. It does NOT auto-load
-# .env — either export them, or load this file yourself, e.g.:
+# .env: either export them, or load this file yourself, e.g.:
 #   set -a; source .env; set +a                       # shell
 #   from dotenv import load_dotenv; load_dotenv()      # python-dotenv (not a dependency)
 
 # Your API key (required). Create one at https://platform.cominty.ai/api-keys
 COMINTY_API_KEY=
 
-# End-user identifier (required) — the user every request acts on behalf of.
+# End-user identifier (required): the user every request acts on behalf of.
 # Looks like user_xxxxxxxxxxxxxxxxxxxxxxxx. Find yours at
 # https://platform.cominty.ai -> avatar (top right) -> Profile
 COMINTY_USER_ID=
 
 # --- Optional ------------------------------------------------------------
 # Override the API base URL (default: https://ds.cominty.com).
-#   dev -> https://ds-dev.cominty.com
-# COMINTY_BASE_URL=https://ds-dev.cominty.com
+#   staging -> https://ds-staging.cominty.com
+# COMINTY_BASE_URL=https://ds-staging.cominty.com
 
 # Used only by the example scripts (the SDK itself has no agent default).
 # Find agent ids at https://platform.cominty.ai/agents
 # COMINTY_AGENT_ID=__cominty_agents::agent.chat
-# A custom agent you created on the platform — used by 07_custom_agent.py
+# A custom agent you created on the platform, used by 07_custom_agent.py
 # COMINTY_CUSTOM_AGENT_ID=

.github/workflows/ci.yml

@@ -33,5 +33,10 @@ jobs:
       - name: Pyright
         run: uv run pyright
 
-      - name: Pytest
-        run: uv run pytest
+      - name: Pytest with coverage
+        run: >
+          uv run pytest --cov --cov-report=term-missing --cov-fail-under=100
+
+      - name: Coverage summary
+        if: always()
+        run: uv run coverage report --format=markdown >> "$GITHUB_STEP_SUMMARY"

.github/workflows/merge.yml

@@ -0,0 +1,30 @@
+# This is to address https://github.com/orgs/community/discussions/5524
+name: Fast Forward Merge
+on:
+  issue_comment:
+    types: [created]
+
+jobs:
+  merge:
+    name: Fast Forward
+    if: github.event.issue.pull_request != '' && contains(github.event.comment.body, '/merge')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Fast Forward PR
+        uses: cominty/fast-forward-js-action@d2e1f31b37078f9f1be14aa4b6ca7dca1b1544c2
+        with:
+          # We use a PAT so pushing the fast-forwarded commits to main still
+          # triggers ci.yml (the GITHUB_TOKEN's own pushes never re-trigger
+          # workflows). /merge-no-deploy fast-forwards without that PAT, so
+          # it does not re-trigger anything.
+          # Links:
+          #     - https://github.com/endre-spotlab/fast-forward-js-action/issues/36#issuecomment-1493006429
+          #     - https://docs.github.com/en/actions/writing-workflows/choosing-when-your-workflow-runs/triggering-a-workflow#triggering-a-workflow-from-a-workflow
+          GITHUB_TOKEN: ${{ contains(github.event.comment.body, '/merge-no-deploy') && secrets.GITHUB_TOKEN || secrets.FAST_FORWARD_MERGE_PAT }}
+          success_message: "Success! Fast forwarded ***target_base*** to ***source_head***! ```git checkout target_base && git merge source_head --ff-only```"
+          failure_message: "Failed! Cannot do fast forward!"
+          status_name: fast-forward-merge
+          update_status: true

.github/workflows/release.yml

@@ -1,7 +1,7 @@
 name: Release
 
 # Publishes to PyPI when a GitHub Release is published.
-# Uses PyPI Trusted Publishing (OIDC) — no API token stored anywhere.
+# Uses PyPI Trusted Publishing (OIDC): no API token stored anywhere.
 on:
   release:
     types: [published]

.gitignore

@@ -8,3 +8,6 @@ build/
 .ruff_cache/
 .pytest_cache/
 .env
+.coverage
+.coverage.*
+htmlcov/