From 8a69f193c70eba5a55e547fb5b637d3c8014c8ff Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Thu, 23 Jul 2026 13:50:39 -0400
Subject: [PATCH 01/15] feat(ai-observability): make session/trace/span nesting
 a mandatory setup step
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The skill's success bar was 'one $ai_generation event appears', so runs
that only did the OTel bootstrap passed while shipping flat, disconnected
generations — no trace grouping, no session, no user attribution, and
non-LLM steps invisible. Verified by running the skill twice against one
unchanged fixture: one run built the tree, one didn't, both 'passed'.

- 1-begin: map the app's logical structure up front (what is a session,
  a trace, a span-worthy step, the distinct-id source)
- new 4-nesting: build the tree per mechanism — enclosing span (OTel),
  shared posthog_trace_id (wrapper SDKs), explicit $ai_parent_id
  (manual-capture); calls out the silent ai.* span-name drop rule and
  the Resource-vs-per-span session propagation caveat
- 5-verify (was 4-verify): success is the tree — one trace holding the
  request's generations and spans, session grouping, person attribution;
  a lone generation is 'bootstrap verified, nesting unverified'
- shared_docs: add sessions.md and spans.md

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 context/skills/ai-observability/config.yaml   |  2 +
 .../skills/ai-observability/description.md    | 10 +-
 .../ai-observability/references/1-begin.md    | 13 ++-
 .../references/3-otel-setup.md                |  6 +-
 .../ai-observability/references/4-nesting.md  | 96 +++++++++++++++++++
 .../ai-observability/references/4-verify.md   | 37 -------
 .../ai-observability/references/5-verify.md   | 47 +++++++++
 7 files changed, 166 insertions(+), 45 deletions(-)
 create mode 100644 context/skills/ai-observability/references/4-nesting.md
 delete mode 100644 context/skills/ai-observability/references/4-verify.md
 create mode 100644 context/skills/ai-observability/references/5-verify.md

diff --git a/context/skills/ai-observability/config.yaml b/context/skills/ai-observability/config.yaml
index 558cdec8..7ff6d2ad 100644
--- a/context/skills/ai-observability/config.yaml
+++ b/context/skills/ai-observability/config.yaml
@@ -12,6 +12,8 @@ shared_docs:
   - https://posthog.com/docs/ai-observability/basics.md
   - https://posthog.com/docs/ai-observability/generations.md
   - https://posthog.com/docs/ai-observability/traces.md
+  - https://posthog.com/docs/ai-observability/sessions.md
+  - https://posthog.com/docs/ai-observability/spans.md
 variants:
   - id: openai-python
     framework: openai
diff --git a/context/skills/ai-observability/description.md b/context/skills/ai-observability/description.md
index 501391be..b3037fe6 100644
--- a/context/skills/ai-observability/description.md
+++ b/context/skills/ai-observability/description.md
@@ -1,6 +1,6 @@
 # PostHog AI Observability for {display_name}
 
-Wire up PostHog's AI Observability so calls made through {display_name} emit `$ai_generation` events into LLM Analytics.
+Wire up PostHog's AI Observability so calls made through {display_name} land in LLM Analytics as a full **session → trace → span → generation** tree — not just isolated `$ai_generation` events.
 
 ## Prerequisite — vendor LLM SDK
 
@@ -14,10 +14,11 @@ Everything else this skill needs — PostHog credentials, the OTel packages, env
 
 Read every referenced file **before editing**. Then work through them in order:
 
-1. **Begin** — see `references/1-begin.md`. Pick the right variant from the vendor SDK the project declares, then locate the LLM call sites so you know where the instrumentation will apply.
+1. **Begin** — see `references/1-begin.md`. Pick the right variant from the vendor SDK the project declares, locate the LLM call sites, and map the app's logical structure (what a session, trace, span, and user are in this codebase).
 2. **Install** — see `references/2-install.md`. Add the OpenTelemetry SDK, PostHog's span-processor package, and the provider-specific instrumentation package to the manifest.
 3. **Set up OpenTelemetry** — see `references/3-otel-setup.md`. Initialize the OTel TracerProvider once with `PostHogSpanProcessor`, attach the provider-specific instrumentor, and route the project token / host through environment variables.
-4. **Verify** — see `references/4-verify.md`. Describe a single call the user can trigger and how to confirm `$ai_generation` events land in PostHog.
+4. **Build the nesting** — see `references/4-nesting.md`. Group each request's calls into one trace, attach session and distinct id, and wrap non-LLM steps as spans. Mandatory — the bootstrap alone produces flat, disconnected generations.
+5. **Verify** — see `references/5-verify.md`. Describe a request the user can trigger and how to confirm the tree — grouped trace, session, attribution — lands in PostHog, not just a lone `$ai_generation`.
 
 ## Reference files
 
@@ -30,7 +31,8 @@ The linked install page carries the exact code blocks for this variant's languag
 - **Environment variables.** Read `<ph_project_token>` and `<ph_client_api_host>` from env, using the framework's env-var convention. Never hardcode either value.
 - **Minimal changes.** OTel initialization is a single call that runs once at process start. Place it alongside any existing PostHog init rather than restructuring the entry point.
 - **Match the docs.** Package names, instrumentor imports, and processor names change between AIO releases. The install page for this variant is the source of truth.
-- **Don't touch what isn't yours.** This skill instruments generations only. Identify calls, event tracking, error tracking, and dashboards belong to the base `integration` skill — do not add or edit them here.
+- **The tree is the deliverable.** A run that only produces flat `$ai_generation` events is incomplete. Nesting (`4-nesting.md`) is part of setup, not a follow-up.
+- **Don't touch what isn't yours.** This skill instruments LLM observability only — generations, traces, sessions, spans. Identify calls, event tracking, error tracking, and dashboards belong to the base `integration` skill — do not add or edit them here.
 
 ## Emit a run record
 
diff --git a/context/skills/ai-observability/references/1-begin.md b/context/skills/ai-observability/references/1-begin.md
index 21c23932..2cea513e 100644
--- a/context/skills/ai-observability/references/1-begin.md
+++ b/context/skills/ai-observability/references/1-begin.md
@@ -1,7 +1,7 @@
 ---
 next_step: 2-install.md
 title: AI Observability Setup - Begin
-description: Pick the right variant, confirm prerequisites, and locate the LLM call sites before editing
+description: Pick the right variant, locate the LLM call sites, and map the app's session/trace/span structure before editing
 ---
 
 Before touching any code, decide which variant of this skill to install, confirm the two prerequisites, and get a read on where in the project LLM calls actually happen. AI Observability instruments an existing setup — if the setup isn't there, this skill can't do its job.
@@ -49,4 +49,13 @@ Grep for where the vendor SDK is imported and called. This is not a full analysi
 
 Note the app's entry point (server startup file, `main.py`, `index.ts`, `instrumentation.ts` in Next.js, etc.) — OTel must be initialized *before* the vendor SDK is imported, and the entry point is where that happens.
 
-Do not edit yet. Once you have a note of the entry point and the call sites, move on to `2-install.md`.
+## Map the logical structure
+
+Instrumentation captures individual LLM calls; the *tree* that makes them useful — session → trace → span → generation — comes from application semantics only the code can tell you. Answer these four questions now, from the code, and write the answers down; `4-nesting.md` consumes them:
+
+- **What is one session here?** The unit of conversation — a conversation object, a thread id, a workflow run. Some apps have none; that's a valid answer.
+- **What is one trace?** The unit of request — typically a request handler or the top-level function that may make several model calls to produce one result.
+- **Which non-LLM steps deserve spans?** Retrieval, tool calls, validation — steps between model calls worth seeing in the trace.
+- **What is the distinct-id source?** A `user_id` in scope at the call sites? None → events will be anonymous; note that too.
+
+Do not edit yet. Once you have the entry point, the call sites, and the structure map, move on to `2-install.md`.
diff --git a/context/skills/ai-observability/references/3-otel-setup.md b/context/skills/ai-observability/references/3-otel-setup.md
index 3c6f91be..e1c86f05 100644
--- a/context/skills/ai-observability/references/3-otel-setup.md
+++ b/context/skills/ai-observability/references/3-otel-setup.md
@@ -1,10 +1,12 @@
 ---
-next_step: 4-verify.md
+next_step: 4-nesting.md
 title: AI Observability Setup - OpenTelemetry
 description: Initialize the OTel TracerProvider with PostHog's span processor and attach the provider instrumentor
 ---
 
-Initialize OpenTelemetry once, at the app's entry point, so it is running before any LLM call executes. This is the single place PostHog reads the project token and host from — everything after this is normal LLM code that gets auto-traced.
+Initialize OpenTelemetry once, at the app's entry point, so it is running before any LLM call executes. This is the single place PostHog reads the project token and host from.
+
+This bootstrap captures individual generations only. It does **not** build the session → trace → span tree — that is application-level work done in `4-nesting.md`, and it is a mandatory part of this skill, not optional polish.
 
 ## Environment variables
 
diff --git a/context/skills/ai-observability/references/4-nesting.md b/context/skills/ai-observability/references/4-nesting.md
new file mode 100644
index 00000000..8df3a439
--- /dev/null
+++ b/context/skills/ai-observability/references/4-nesting.md
@@ -0,0 +1,96 @@
+---
+next_step: 5-verify.md
+title: AI Observability Setup - Nesting
+description: Build the session → trace → span → generation tree on top of the bootstrap — this step is mandatory, not optional polish
+---
+
+The bootstrap from `3-otel-setup.md` captures each LLM call in isolation. It has no concept of what constitutes a *request* (a trace), a *conversation* (a session), or a *non-LLM step* (a span) — those are application semantics only the code can tell you. Without this step, a request that makes two model calls with a lookup in between lands as two disconnected single-generation traces, no session, no user attribution, and the lookup invisible. The product is built around the tree; flat generations degrade it to a per-call cost log.
+
+Use the structure map you wrote down in `1-begin.md`. This step turns it into code.
+
+## The nesting model
+
+One vocabulary, every variant:
+
+| Concept | Property | Notes |
+|---|---|---|
+| Session | `$ai_session_id` | optional; groups traces (a conversation, workflow, thread) |
+| Trace | `$ai_trace_id` | **required**; groups one request's events |
+| Span | `$ai_span` event + `$ai_span_id` / `$ai_span_name` | a non-LLM step (retrieval, tool call, validation) |
+| Generation | `$ai_generation` event | one LLM call |
+| Tree edge | `$ai_parent_id` | parent is a `trace_id` or another `span_id` |
+
+## Three ways to express it — branch by variant
+
+The model is constant; only the API changes. Pick the branch matching the mechanism you installed.
+
+### OTel auto-instrumentation (most variants)
+
+Wrap each logical operation in an **enclosing span**. Auto-instrumented generations nest under it automatically because they share the OTel trace context — spans in one OTel trace share `$ai_trace_id`, and a child's `parent_span_id` becomes `$ai_parent_id`. Nothing else is needed for trace grouping.
+
+```python
+def ask(self, question: str) -> str:
+    with tracer.start_as_current_span(
+        "ai.support_request",                     # ai.* prefix — required, see below
+        attributes={
+            "$ai_session_id": self.thread_id,     # groups this thread's traces
+            "posthog.distinct_id": self.user_id,  # attributes to the person
+        },
+    ):
+        category = self._classify(question)       # generation, nests automatically
+        order = self._lookup_order(category)      # span, see below
+        return self._answer(question, category, order)
+
+def _lookup_order(self, category: str) -> dict | None:
+    if category != "order_status":
+        return None
+    with tracer.start_as_current_span("ai.lookup_order"):   # non-LLM step
+        return lookup_order(self.user_id)
+```
+
+**The `ai.*` naming rule — silent-failure trap.** PostHog keeps a span only if its name *or an attribute key* begins with `gen_ai.`, `llm.`, `ai.`, or `traceloop.`. Everything else is dropped without error. An enclosing span named `handle_request` or a `lookup_order` span **vanishes** — taking its session and distinct-id attributes with it. Every manual span on the OTel path must be named `ai.*` (e.g. `ai.support_request`, `ai.lookup_order`). This is the single most likely way a well-intentioned run still produces a broken tree.
+
+**Session and distinct-id propagation.** OTel does not inherit attributes parent→child, and PostHog's processor adds no baggage propagation. A **Resource** attribute is process-global — fine only when one process equals one session/user. A **runtime-varying** session or user must be set as an attribute on every span you want grouped (in practice: the enclosing span of each request, as above). If per-request attribution matters and the variant has a wrapper SDK, prefer the wrapper — its per-call params sidestep this.
+
+### Wrapper SDK (`openai`, `anthropic`, `gemini`, `langchain`, `vercel`, `openai-agents` wrapper clients)
+
+Per-call parameters, no manual spans needed. Python kwargs: `posthog_trace_id`, `posthog_distinct_id`, `posthog_properties` (put `$ai_session_id` here), `posthog_groups`. Node equivalents are camelCase (`posthogTraceId`, …).
+
+**Trap:** `posthog_trace_id` auto-generates a *fresh UUID per call* when omitted. To group multiple calls into one trace you must pass a shared id explicitly:
+
+```python
+from uuid import uuid4
+
+def ask(self, question: str) -> str:
+    trace_id = str(uuid4())                       # one per request; reuse for every call in it
+    ph = dict(
+        posthog_trace_id=trace_id,
+        posthog_distinct_id=self.user_id,
+        posthog_properties={"$ai_session_id": self.thread_id},
+    )
+    category = self._classify(question, ph)       # client.messages.create(..., **ph)
+    order = lookup_order(self.user_id) if category == "order_status" else None
+    return self._answer(question, category, order, ph)
+```
+
+### `manual-capture`
+
+Emit `$ai_trace` / `$ai_span` / `$ai_generation` events explicitly and wire the tree yourself: every event in a request shares `$ai_trace_id`; child events set `$ai_parent_id` to the parent's `trace_id` or `span_id`; `$ai_session_id` goes in properties. The manual-capture install page carries the full property tables.
+
+## What to actually edit
+
+For each request-shaped code path you mapped in `1-begin.md`:
+
+1. Group its LLM calls into one trace (enclosing span, shared `posthog_trace_id`, or shared `$ai_trace_id` — per the branch above).
+2. Set `$ai_session_id` from the conversation identifier, if the app has one.
+3. Set the distinct id from the user identifier, if the app has one.
+4. Wrap non-LLM steps worth seeing (retrieval, tool calls, validation) as spans — `ai.*`-named on the OTel path.
+
+Keep it minimal: instrument the representative paths you mapped, don't refactor the app. If the app genuinely has no conversation or user concept, say so in the report — omitting a session is a finding, not a failure.
+
+## Do not
+
+- Do not name a manual OTel span anything that doesn't start with `ai.` — it will be silently dropped.
+- Do not rely on omitted `posthog_trace_id` to group wrapper-SDK calls — each call gets its own fresh UUID.
+- Do not put a runtime-varying `$ai_session_id` or distinct id only on the Resource — the Resource is process-global.
+- Do not skip this step because generations already appear in PostHog. Flat generations are the failure mode this step exists to prevent.
diff --git a/context/skills/ai-observability/references/4-verify.md b/context/skills/ai-observability/references/4-verify.md
deleted file mode 100644
index bb5925f7..00000000
--- a/context/skills/ai-observability/references/4-verify.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-next_step: null
-title: AI Observability Setup - Verify
-description: Give the user a concrete way to trigger a generation and confirm it lands in PostHog
----
-
-You've installed packages and wired OTel init. The last thing this skill produces is a **verification path** the user can run themselves. Don't call the LLM from here — you don't have credentials, and the user should be the one to see the trace show up in their project.
-
-## What to tell the user
-
-Point them at the smallest existing code path in their project that hits the vendor SDK. Pick one from what you noted in `1-begin.md`:
-
-- If the project has a script (`scripts/`, `bin/`, a `package.json` script) that calls the LLM, name it: "Run `npm run <script>` (or `python scripts/<file>.py`) to trigger one generation."
-- If the LLM is called from an API route, name the route: "Hit `POST /api/chat` with a test message to trigger one generation."
-- If the LLM lives inside a test, point at that test.
-- If there is no existing call path, sketch a minimal one — a five-line script that imports the client and makes one call — but do not add it to the project unless the user asks. Include it in the report as suggested code.
-
-## What they should see
-
-After triggering one call:
-
-1. In PostHog, open **Product → LLM Analytics → Generations**.
-2. Filter by the current day and their `service.name` (if the OTel resource was tagged).
-3. A new `$ai_generation` event should appear within a few seconds. Notable properties: `$ai_provider`, `$ai_model`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`.
-4. If a `posthog.distinct_id` resource attribute was set, the event should be attached to that user in Persons.
-
-If nothing shows up within a minute:
-
-- Confirm the OTel init actually runs — a `console.log` / `print` immediately after `sdk.start()` (or `.instrument()`) proves the entry point loaded it.
-- Confirm the vendor SDK was imported *after* the OTel init in the process's load order.
-- Confirm `POSTHOG_API_KEY` and `POSTHOG_HOST` were set in the env the process is actually running under, not just `.env.example`.
-
-## Do not
-
-- Do not run the vendor SDK yourself.
-- Do not embed API keys anywhere to enable a smoke test.
-- Do not claim the integration works until the user has confirmed a generation shows up. Report it as "wired, unverified" if you never got confirmation — the report step will surface that.
diff --git a/context/skills/ai-observability/references/5-verify.md b/context/skills/ai-observability/references/5-verify.md
new file mode 100644
index 00000000..b0f7a899
--- /dev/null
+++ b/context/skills/ai-observability/references/5-verify.md
@@ -0,0 +1,47 @@
+---
+next_step: null
+title: AI Observability Setup - Verify
+description: Give the user a concrete way to trigger a request and confirm the full trace tree — not just a lone generation — lands in PostHog
+---
+
+You've installed packages, wired OTel init, and built the nesting from `4-nesting.md`. The last thing this skill produces is a **verification path** the user can run themselves. Don't call the LLM from here — you don't have credentials, and the user should be the one to see the trace show up in their project.
+
+**The bar is the tree, not a single event.** A lone `$ai_generation` appearing proves the bootstrap works; it does not prove the integration is done. If only flat generations show up, the run is **incomplete** — go back to `4-nesting.md`.
+
+## What to tell the user
+
+Point them at the smallest existing code path that exercises one of the request paths you instrumented in `4-nesting.md` — ideally one that makes more than one model call, so trace grouping is actually visible. Pick from what you noted in `1-begin.md`:
+
+- If the project has a script (`scripts/`, `bin/`, a `package.json` script) that calls the LLM, name it: "Run `npm run <script>` (or `python scripts/<file>.py`) to trigger one request."
+- If the LLM is called from an API route, name the route: "Hit `POST /api/chat` with a test message."
+- If the LLM lives inside a test, point at that test.
+- If there is no existing call path, sketch a minimal one — a short script that exercises one instrumented request path — but do not add it to the project unless the user asks. Include it in the report as suggested code.
+
+## What they should see
+
+After triggering one request:
+
+1. In PostHog, open **Product → LLM Analytics → Traces** (not just Generations).
+2. Open the newest trace. **One trace** should contain all the generations that request made — plus any spans you added — as children, not one trace per call.
+3. If the app has a conversation concept, trigger a second request in the same conversation: both traces should share the same `$ai_session_id`.
+4. If a distinct id was wired, the trace should be attributed to that person in Persons, not anonymous.
+5. Generation properties worth spot-checking: `$ai_provider`, `$ai_model`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`.
+
+Failure modes and what they mean:
+
+- **Each generation is its own trace** → the enclosing span isn't wrapping the calls (OTel path), or calls aren't sharing a `posthog_trace_id` (wrapper path). Back to `4-nesting.md`.
+- **Generations appear but your manual spans don't** → the spans aren't `ai.*`-named; they're being silently dropped. Rename them.
+- **No `$ai_session_id` / anonymous person** → the attributes were set on the Resource (process-global) instead of per-request, or not at all.
+
+If nothing shows up at all within a minute:
+
+- Confirm the OTel init actually runs — a `console.log` / `print` immediately after `sdk.start()` (or `.instrument()`) proves the entry point loaded it.
+- Confirm the vendor SDK was imported *after* the OTel init in the process's load order.
+- Confirm `POSTHOG_API_KEY` and `POSTHOG_HOST` were set in the env the process is actually running under, not just `.env.example`.
+
+## Do not
+
+- Do not run the vendor SDK yourself.
+- Do not embed API keys anywhere to enable a smoke test.
+- Do not claim the integration works until the user has confirmed the **tree** — grouped trace, session (if applicable), attribution (if applicable). A confirmed flat generation is "bootstrap verified, nesting unverified", not done.
+- Do not claim the integration works until the user has confirmed anything at all. Report it as "wired, unverified" if you never got confirmation — the report step will surface that.

From 65a3e28d1aeda8f08f9753214c062f9b4e89c7d5 Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Thu, 23 Jul 2026 14:28:20 -0400
Subject: [PATCH 02/15] chore(dev-server): log incoming requests
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

One line per request so local wizard runs against the dev server are
observable — you can watch the menu + zip fetches arrive.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 scripts/dev-server.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/scripts/dev-server.js b/scripts/dev-server.js
index 4d949ae1..9b45e323 100644
--- a/scripts/dev-server.js
+++ b/scripts/dev-server.js
@@ -282,6 +282,7 @@ function serveFile(res, filePath, contentType, attachmentName = null) {
 
 function createServer() {
     const server = http.createServer((req, res) => {
+        console.log(`→ ${req.method} ${req.url}`);
         // A skill is served as its own zip, or — for a bundled group — as one JSON of every variant.
         const skillMatch = req.url?.match(/^\/skills\/(.+\.(zip|json))$/);
         if (skillMatch) {

From e8b89281c51c396bfca5473e5ec5f820c9c0795c Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Thu, 23 Jul 2026 16:22:31 -0400
Subject: [PATCH 03/15] fix(ai-observability): correct span-survival rule, add
 mechanism gate
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Round-2 delta from re-running the skill on the support-triage fixture:
generations + trace grouping landed but session, user attribution, and
the non-LLM span were silently dropped at ingest.

The 4-nesting doc taught the client-side filter (name OR attribute key
prefixed gen_ai./llm./ai./traceloop.) as the survival rule. The server
(rust/capture/src/otel/fan_out.rs) keeps a span only when an attribute
KEY starts with gen_ai./ai./traceloop./pydantic_ai. — names are never
consulted. So the doc's own example (span named ai.support_request
carrying only $ai_session_id + posthog.distinct_id) died at ingest.

- OTel branch rewritten per goal: trace grouping = enclosing span (any
  name, zero attrs, needn't survive); session + user = two Resource
  attributes in the bootstrap (denylist is only host./process./os./
  telemetry.); non-LLM steps = $ai_span via posthog.capture() sharing
  the OTel trace id; per-request-on-OTel = opentelemetry-processor-
  baggage, never hand-rolled SpanProcessors
- new decision gate: wrapper (per-request identity) → OTel + Resource
  (existing OTel / multi-backend) → manual capture; imports must run in
  the project's env or you switch paths
- 5-verify: prove-the-import rule (posthog 6.9.3 ships no posthog.ai.otel;
  7.29.0 does), failure-mode table updated to the attribute-key rule
- do-not list: ai.* naming rule removed (neither necessary nor
  sufficient), session-only-on-hand-span added

Verified against posthog monorepo rust capture source and the 6.9.3 /
7.29.0 wheels on PyPI.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .../ai-observability/references/4-nesting.md  | 104 +++++++++++-------
 .../ai-observability/references/5-verify.md   |   7 +-
 2 files changed, 72 insertions(+), 39 deletions(-)

diff --git a/context/skills/ai-observability/references/4-nesting.md b/context/skills/ai-observability/references/4-nesting.md
index 8df3a439..ce4cf484 100644
--- a/context/skills/ai-observability/references/4-nesting.md
+++ b/context/skills/ai-observability/references/4-nesting.md
@@ -20,39 +20,15 @@ One vocabulary, every variant:
 | Generation | `$ai_generation` event | one LLM call |
 | Tree edge | `$ai_parent_id` | parent is a `trace_id` or another `span_id` |
 
-## Three ways to express it — branch by variant
+## Pick the mechanism — decision gate
 
-The model is constant; only the API changes. Pick the branch matching the mechanism you installed.
+Work through these in order; take the first that matches. Whichever you pick, its imports must run in the project's environment — if an import fails during verification, come back here and take the next path, don't ship the caveat (some `posthog` releases don't ship `posthog.ai.otel` — 6.9.3, which older Pythons silently resolve to, doesn't; 7.29.0 does).
 
-### OTel auto-instrumentation (most variants)
+1. **Variant has a wrapper SDK** (`openai`, `anthropic`, `gemini`, `langchain`, `vercel`, `openai-agents`) **and** the app has per-request user or conversation identity → **wrapper**. Per-call params, no manual spans, no propagation questions.
+2. **App already runs OpenTelemetry**, or spans must also fan out to non-PostHog backends → **OTel + Resource attributes**.
+3. **Neither** → **manual capture**.
 
-Wrap each logical operation in an **enclosing span**. Auto-instrumented generations nest under it automatically because they share the OTel trace context — spans in one OTel trace share `$ai_trace_id`, and a child's `parent_span_id` becomes `$ai_parent_id`. Nothing else is needed for trace grouping.
-
-```python
-def ask(self, question: str) -> str:
-    with tracer.start_as_current_span(
-        "ai.support_request",                     # ai.* prefix — required, see below
-        attributes={
-            "$ai_session_id": self.thread_id,     # groups this thread's traces
-            "posthog.distinct_id": self.user_id,  # attributes to the person
-        },
-    ):
-        category = self._classify(question)       # generation, nests automatically
-        order = self._lookup_order(category)      # span, see below
-        return self._answer(question, category, order)
-
-def _lookup_order(self, category: str) -> dict | None:
-    if category != "order_status":
-        return None
-    with tracer.start_as_current_span("ai.lookup_order"):   # non-LLM step
-        return lookup_order(self.user_id)
-```
-
-**The `ai.*` naming rule — silent-failure trap.** PostHog keeps a span only if its name *or an attribute key* begins with `gen_ai.`, `llm.`, `ai.`, or `traceloop.`. Everything else is dropped without error. An enclosing span named `handle_request` or a `lookup_order` span **vanishes** — taking its session and distinct-id attributes with it. Every manual span on the OTel path must be named `ai.*` (e.g. `ai.support_request`, `ai.lookup_order`). This is the single most likely way a well-intentioned run still produces a broken tree.
-
-**Session and distinct-id propagation.** OTel does not inherit attributes parent→child, and PostHog's processor adds no baggage propagation. A **Resource** attribute is process-global — fine only when one process equals one session/user. A **runtime-varying** session or user must be set as an attribute on every span you want grouped (in practice: the enclosing span of each request, as above). If per-request attribution matters and the variant has a wrapper SDK, prefer the wrapper — its per-call params sidestep this.
-
-### Wrapper SDK (`openai`, `anthropic`, `gemini`, `langchain`, `vercel`, `openai-agents` wrapper clients)
+## The wrapper path
 
 Per-call parameters, no manual spans needed. Python kwargs: `posthog_trace_id`, `posthog_distinct_id`, `posthog_properties` (put `$ai_session_id` here), `posthog_groups`. Node equivalents are camelCase (`posthogTraceId`, …).
 
@@ -73,7 +49,60 @@ def ask(self, question: str) -> str:
     return self._answer(question, category, order, ph)
 ```
 
-### `manual-capture`
+Non-LLM steps worth seeing: emit a `$ai_span` event with `posthog.capture()` sharing the same `$ai_trace_id` (shape below, under manual capture).
+
+## The OTel path
+
+Three goals, three separate mechanisms — don't conflate them:
+
+**Trace grouping — an enclosing span, any name, zero attributes.** Auto-instrumented generations inside it inherit its OTel trace context in-process, so they share one `$ai_trace_id`. The enclosing span itself does **not** need to survive ingest (or carry anything) for this to work:
+
+```python
+def ask(self, question: str) -> str:
+    with tracer.start_as_current_span("support_request"):   # name is irrelevant to ingest
+        category = self._classify(question)                 # generation, same trace
+        order = self._lookup_order(category)
+        return self._answer(question, category, order)      # generation, same trace
+```
+
+**Session + user — two Resource attributes in the bootstrap you already wrote.** Ingest copies Resource attributes onto every surviving event (only `host.` / `process.` / `os.` / `telemetry.` prefixes are filtered), and `posthog.distinct_id` on the Resource is the documented identity mechanism:
+
+```python
+resource=Resource(attributes={
+    SERVICE_NAME: "my-app",
+    "posthog.distinct_id": user_id,      # already in the install docs
+    "$ai_session_id": session_id,        # add this line; process-global
+})
+```
+
+Resource attributes are process-global by nature — which is fine, because an app whose session/user vary per request was already routed to the wrapper by the gate above. If an app genuinely must stay on OTel *and* needs per-request values, use the standard `opentelemetry-processor-baggage` package — do not generate custom `SpanProcessor` classes in user codebases.
+
+**Non-LLM step — a manual `$ai_span` event via `posthog.capture()`** (the `posthog` client class ships in the package you already installed), sharing the OTel trace id:
+
+```python
+from opentelemetry import trace as otel_trace
+
+def _lookup_order(self, category: str) -> dict | None:
+    if category != "order_status":
+        return None
+    result = lookup_order(self.user_id)
+    ctx = otel_trace.get_current_span().get_span_context()
+    posthog.capture(
+        distinct_id=self.user_id,
+        event="$ai_span",
+        properties={
+            "$ai_trace_id": format(ctx.trace_id, "032x"),   # same trace as the generations
+            "$ai_span_name": "lookup_order",
+        },
+    )
+    return result
+```
+
+Or omit it and say so in the report — "no non-LLM step worth tracing" is a finding.
+
+**Why not hand-authored OTel spans with attributes?** Ingest keeps a span only if an **attribute key** starts with a provider prefix (`gen_ai.` / `ai.` / `traceloop.` / `pydantic_ai.`) — the span *name* is never consulted. A hand-made span carrying only `$ai_session_id` or `posthog.distinct_id` is silently dropped, taking those values with it. Don't fight this rule; put session/user on the Resource and non-LLM steps through `capture()`, as above.
+
+## Manual capture
 
 Emit `$ai_trace` / `$ai_span` / `$ai_generation` events explicitly and wire the tree yourself: every event in a request shares `$ai_trace_id`; child events set `$ai_parent_id` to the parent's `trace_id` or `span_id`; `$ai_session_id` goes in properties. The manual-capture install page carries the full property tables.
 
@@ -81,16 +110,17 @@ Emit `$ai_trace` / `$ai_span` / `$ai_generation` events explicitly and wire the
 
 For each request-shaped code path you mapped in `1-begin.md`:
 
-1. Group its LLM calls into one trace (enclosing span, shared `posthog_trace_id`, or shared `$ai_trace_id` — per the branch above).
-2. Set `$ai_session_id` from the conversation identifier, if the app has one.
-3. Set the distinct id from the user identifier, if the app has one.
-4. Wrap non-LLM steps worth seeing (retrieval, tool calls, validation) as spans — `ai.*`-named on the OTel path.
+1. Group its LLM calls into one trace (shared `posthog_trace_id`, enclosing span, or shared `$ai_trace_id` — per the gate's branch).
+2. Set `$ai_session_id` from the conversation identifier, if the app has one (wrapper: `posthog_properties`; OTel: Resource).
+3. Set the distinct id from the user identifier, if the app has one (wrapper: `posthog_distinct_id`; OTel: Resource `posthog.distinct_id`).
+4. Emit `$ai_span` events for non-LLM steps worth seeing (retrieval, tool calls, validation).
 
 Keep it minimal: instrument the representative paths you mapped, don't refactor the app. If the app genuinely has no conversation or user concept, say so in the report — omitting a session is a finding, not a failure.
 
 ## Do not
 
-- Do not name a manual OTel span anything that doesn't start with `ai.` — it will be silently dropped.
+- Do not attach `$ai_session_id` or the distinct id only to a hand-authored OTel span — ingest drops spans without provider-prefixed attribute keys (names are never consulted). Put them on the Resource (process-global) or the wrapper's per-call params (per-request).
 - Do not rely on omitted `posthog_trace_id` to group wrapper-SDK calls — each call gets its own fresh UUID.
-- Do not put a runtime-varying `$ai_session_id` or distinct id only on the Resource — the Resource is process-global.
+- Do not put a runtime-varying `$ai_session_id` or distinct id on the Resource — the Resource is process-global; per-request identity belongs on the wrapper path.
+- Do not ship a code path whose imports failed in the project's environment — switch to the gate's next mechanism instead.
 - Do not skip this step because generations already appear in PostHog. Flat generations are the failure mode this step exists to prevent.
diff --git a/context/skills/ai-observability/references/5-verify.md b/context/skills/ai-observability/references/5-verify.md
index b0f7a899..8f89b473 100644
--- a/context/skills/ai-observability/references/5-verify.md
+++ b/context/skills/ai-observability/references/5-verify.md
@@ -27,11 +27,13 @@ After triggering one request:
 4. If a distinct id was wired, the trace should be attributed to that person in Persons, not anonymous.
 5. Generation properties worth spot-checking: `$ai_provider`, `$ai_model`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`.
 
+**Before handing over: prove the imports run.** In the project's environment, import what the instrumentation uses (e.g. `python -c "from posthog.ai.otel import PostHogSpanProcessor"` or the wrapper import). If it fails — wrong package version, module not shipped in the installed release — go back to the gate in `4-nesting.md` and switch mechanisms. Do not ship non-running code with a caveat.
+
 Failure modes and what they mean:
 
 - **Each generation is its own trace** → the enclosing span isn't wrapping the calls (OTel path), or calls aren't sharing a `posthog_trace_id` (wrapper path). Back to `4-nesting.md`.
-- **Generations appear but your manual spans don't** → the spans aren't `ai.*`-named; they're being silently dropped. Rename them.
-- **No `$ai_session_id` / anonymous person** → the attributes were set on the Resource (process-global) instead of per-request, or not at all.
+- **Generations appear but your non-LLM spans don't** → they were hand-authored OTel spans; ingest drops spans without provider-prefixed (`gen_ai.`/`ai.`/…) attribute keys — span names are never consulted. Emit them as `$ai_span` events via `posthog.capture()` instead.
+- **No `$ai_session_id` / anonymous person** → OTel path: the two Resource attributes (`posthog.distinct_id`, `$ai_session_id`) are missing from the bootstrap. Wrapper path: per-call params not passed.
 
 If nothing shows up at all within a minute:
 
@@ -43,5 +45,6 @@ If nothing shows up at all within a minute:
 
 - Do not run the vendor SDK yourself.
 - Do not embed API keys anywhere to enable a smoke test.
+- Do not report a run as done while an instrumentation import fails in the project's environment — switching mechanisms at the `4-nesting.md` gate is part of this skill, shipping the caveat is not.
 - Do not claim the integration works until the user has confirmed the **tree** — grouped trace, session (if applicable), attribution (if applicable). A confirmed flat generation is "bootstrap verified, nesting unverified", not done.
 - Do not claim the integration works until the user has confirmed anything at all. Report it as "wired, unverified" if you never got confirmation — the report step will surface that.

From 8fa90b00c5c84df3e03d061fb6bb1fcc1940b5ef Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Thu, 23 Jul 2026 16:40:18 -0400
Subject: [PATCH 04/15] feat(ai-observability): move mechanism gate to step 1,
 branch install/wiring on it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The round-2 gate lived in 4-nesting.md — but by then the agent had
already declared OTel packages (step 2) and written the OTel bootstrap
(step 3), so OTel was still the de-facto default and the wrapper choice
meant ripping out finished work.

- 1-begin: 'Choose the mechanism' gate right after the structure map —
  existing-OTel/multi-backend → OTel; variant has a PostHog wrapper
  (verified: posthog 7.29.0 ships posthog.ai.{openai,anthropic,gemini,
  langchain,openai_agents,claude_agent_sdk}; @posthog/ai ships
  {openai,anthropic,gemini,vercel}) → wrapper; else OTel; no vendor
  SDK → manual capture. Explicit 'do not default to OTel'.
- 2-install: packages per mechanism; wrapper path = posthog /
  @posthog/ai + posthog-node, zero OTel packages
- 3-otel-setup.md renamed 3-instrument.md: wrapper client-swap section
  added, OTel + manual sections scoped per path
- 4-nesting: gate section replaced with a pointer to 1-begin
- description.md: steps and principles updated to match

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .../skills/ai-observability/description.md    | 13 +++--
 .../ai-observability/references/1-begin.md    | 19 +++++--
 .../ai-observability/references/2-install.md  | 29 ++++++++---
 .../{3-otel-setup.md => 3-instrument.md}      | 51 ++++++++++++++-----
 .../ai-observability/references/4-nesting.md  | 12 ++---
 5 files changed, 84 insertions(+), 40 deletions(-)
 rename context/skills/ai-observability/references/{3-otel-setup.md => 3-instrument.md} (60%)

diff --git a/context/skills/ai-observability/description.md b/context/skills/ai-observability/description.md
index b3037fe6..d5d1d578 100644
--- a/context/skills/ai-observability/description.md
+++ b/context/skills/ai-observability/description.md
@@ -8,15 +8,15 @@ This skill instruments the LLM calls the project *already makes*. It does **not*
 
 Check the project's manifest for the provider's package (e.g. `openai`, `@anthropic-ai/sdk`, `langchain`, `ai`, `@google/genai`). If a vendor SDK is present, pick the matching variant. If none is present, switch to the `manual-capture` variant — it posts `$ai_generation` events directly and works standalone.
 
-Everything else this skill needs — PostHog credentials, the OTel packages, env vars — the skill installs and configures itself. It does **not** require a pre-existing `posthog.init(...)`. If one is already there, reuse its env-var names in `3-otel-setup.md`; if not, that step sets fresh values via `set_env_values`.
+Everything else this skill needs — PostHog credentials, instrumentation packages, env vars — the skill installs and configures itself. It does **not** require a pre-existing `posthog.init(...)`. If one is already there, reuse its env-var names in `3-instrument.md`; if not, that step sets fresh values via `set_env_values`.
 
 ## Steps
 
 Read every referenced file **before editing**. Then work through them in order:
 
-1. **Begin** — see `references/1-begin.md`. Pick the right variant from the vendor SDK the project declares, locate the LLM call sites, and map the app's logical structure (what a session, trace, span, and user are in this codebase).
-2. **Install** — see `references/2-install.md`. Add the OpenTelemetry SDK, PostHog's span-processor package, and the provider-specific instrumentation package to the manifest.
-3. **Set up OpenTelemetry** — see `references/3-otel-setup.md`. Initialize the OTel TracerProvider once with `PostHogSpanProcessor`, attach the provider-specific instrumentor, and route the project token / host through environment variables.
+1. **Begin** — see `references/1-begin.md`. Pick the right variant from the vendor SDK the project declares, locate the LLM call sites, map the app's logical structure (what a session, trace, span, and user are in this codebase), and choose the instrumentation mechanism at the gate — wrapper client, OTel, or manual capture. Do not default to OTel.
+2. **Install** — see `references/2-install.md`. Declare the chosen mechanism's packages in the manifest — and only those.
+3. **Instrument** — see `references/3-instrument.md`. Wire the chosen mechanism: swap in the PostHog wrapper client, or initialize the OTel TracerProvider with `PostHogSpanProcessor`, or set up manual capture. Route the project token / host through environment variables.
 4. **Build the nesting** — see `references/4-nesting.md`. Group each request's calls into one trace, attach session and distinct id, and wrap non-LLM steps as spans. Mandatory — the bootstrap alone produces flat, disconnected generations.
 5. **Verify** — see `references/5-verify.md`. Describe a request the user can trigger and how to confirm the tree — grouped trace, session, attribution — lands in PostHog, not just a lone `$ai_generation`.
 
@@ -29,7 +29,8 @@ The linked install page carries the exact code blocks for this variant's languag
 ## Key principles
 
 - **Environment variables.** Read `<ph_project_token>` and `<ph_client_api_host>` from env, using the framework's env-var convention. Never hardcode either value.
-- **Minimal changes.** OTel initialization is a single call that runs once at process start. Place it alongside any existing PostHog init rather than restructuring the entry point.
+- **One mechanism, chosen deliberately.** Wrapper client, OTel, or manual capture — the gate in `1-begin.md` picks exactly one; don't default to OTel or wire two.
+- **Minimal changes.** The wrapper swaps a client import; OTel init is a single call at process start, placed alongside any existing PostHog init. Don't restructure the app either way.
 - **Match the docs.** Package names, instrumentor imports, and processor names change between AIO releases. The install page for this variant is the source of truth.
 - **The tree is the deliverable.** A run that only produces flat `$ai_generation` events is incomplete. Nesting (`4-nesting.md`) is part of setup, not a follow-up.
 - **Don't touch what isn't yours.** This skill instruments LLM observability only — generations, traces, sessions, spans. Identify calls, event tracking, error tracking, and dashboards belong to the base `integration` skill — do not add or edit them here.
@@ -42,6 +43,8 @@ When you finish, write `.posthog-wizard-cache/.posthog-ai.json` at the project r
 { "provider": "openai", "package": "@posthog/ai", "otel_init_file": "src/instrumentation.ts" }
 ```
 
+On the wrapper or manual-capture path there is no OTel init — set `otel_init_file` to the file where the wrapper client (or capture helper) was wired instead.
+
 The `report/` step reads this file to render an AI Observability section in the setup report. If the cache directory does not exist, create it.
 
 ## Framework guidelines
diff --git a/context/skills/ai-observability/references/1-begin.md b/context/skills/ai-observability/references/1-begin.md
index 2cea513e..7148887b 100644
--- a/context/skills/ai-observability/references/1-begin.md
+++ b/context/skills/ai-observability/references/1-begin.md
@@ -1,7 +1,7 @@
 ---
 next_step: 2-install.md
 title: AI Observability Setup - Begin
-description: Pick the right variant, locate the LLM call sites, and map the app's session/trace/span structure before editing
+description: Pick the right variant, locate the LLM call sites, map the app's session/trace/span structure, and choose the instrumentation mechanism before editing
 ---
 
 Before touching any code, decide which variant of this skill to install, confirm the two prerequisites, and get a read on where in the project LLM calls actually happen. AI Observability instruments an existing setup — if the setup isn't there, this skill can't do its job.
@@ -35,7 +35,7 @@ Grep the project for one of:
 
 **This is not a prerequisite.** The OTel-based variants use `PostHogSpanProcessor`, a self-contained exporter that just takes an API key + host — it does not depend on a `posthog.init(...)` call anywhere. The `manual-capture` variant uses `posthog.capture(...)`, which needs the traditional SDK, but the install step will add it if it isn't there.
 
-If a `posthog.init(...)` (or equivalent) **is** already present, note the env-var names it reads (`POSTHOG_API_KEY`, `NEXT_PUBLIC_POSTHOG_KEY`, etc.) and reuse them in `3-otel-setup.md` — don't invent parallel names. If nothing is there, `3-otel-setup.md` will set fresh values via `set_env_values`.
+If a `posthog.init(...)` (or equivalent) **is** already present, note the env-var names it reads (`POSTHOG_API_KEY`, `NEXT_PUBLIC_POSTHOG_KEY`, etc.) and reuse them in `3-instrument.md` — don't invent parallel names. If nothing is there, `3-instrument.md` will set fresh values via `set_env_values`.
 
 ## Locate the LLM call sites
 
@@ -47,7 +47,7 @@ Grep for where the vendor SDK is imported and called. This is not a full analysi
 - Vercel AI: `generateText(`, `streamText(`, `import ... from 'ai'`
 - Google Gemini: `genai.Client(`, `new GoogleGenerativeAI(`
 
-Note the app's entry point (server startup file, `main.py`, `index.ts`, `instrumentation.ts` in Next.js, etc.) — OTel must be initialized *before* the vendor SDK is imported, and the entry point is where that happens.
+Note the app's entry point (server startup file, `main.py`, `index.ts`, `instrumentation.ts` in Next.js, etc.) — on the OTel path, init must run there *before* the vendor SDK is imported; the wrapper path edits the call sites instead.
 
 ## Map the logical structure
 
@@ -58,4 +58,15 @@ Instrumentation captures individual LLM calls; the *tree* that makes them useful
 - **Which non-LLM steps deserve spans?** Retrieval, tool calls, validation — steps between model calls worth seeing in the trace.
 - **What is the distinct-id source?** A `user_id` in scope at the call sites? None → events will be anonymous; note that too.
 
-Do not edit yet. Once you have the entry point, the call sites, and the structure map, move on to `2-install.md`.
+## Choose the mechanism
+
+There are three ways to instrument: a **PostHog wrapper client** (per-call params), **OTel auto-instrumentation** (bootstrap + enclosing spans), and **manual capture** (explicit events). Do not default to OTel — pick from this gate, in order, using the variant and the structure map above:
+
+1. **App already runs OpenTelemetry**, or its spans must also fan out to non-PostHog backends → **OTel**.
+2. **Variant has a PostHog wrapper client** — Python `posthog` ships `posthog.ai.{openai,anthropic,gemini,langchain,openai_agents,claude_agent_sdk}`; Node `@posthog/ai` ships `{openai,anthropic,gemini,vercel}` — → **wrapper**. Simplest path, and the only one that handles per-request user/conversation identity without extra machinery.
+3. **Anything else** (most provider variants have no wrapper) → **OTel**.
+4. **No vendor SDK at all** → you already picked the `manual-capture` variant above → **manual capture**.
+
+Record the choice — `2-install.md` and `3-instrument.md` branch on it. If the chosen mechanism's imports fail in the project's environment at verification time, come back to this gate and take the next viable path; do not ship non-running code.
+
+Do not edit yet. Once you have the entry point, the call sites, the structure map, and the mechanism, move on to `2-install.md`.
diff --git a/context/skills/ai-observability/references/2-install.md b/context/skills/ai-observability/references/2-install.md
index 962272c3..16198203 100644
--- a/context/skills/ai-observability/references/2-install.md
+++ b/context/skills/ai-observability/references/2-install.md
@@ -1,10 +1,10 @@
 ---
-next_step: 3-otel-setup.md
+next_step: 3-instrument.md
 title: AI Observability Setup - Install
-description: Add the OpenTelemetry SDK, PostHog span processor, and provider instrumentation to the manifest
+description: Declare the packages for the mechanism chosen at the gate - wrapper, OTel, or manual capture
 ---
 
-Declare the packages this variant needs in the project's manifest. Do not run the package manager here — the base integration's build/verify step (or the user) installs everything in one pass.
+Declare the packages the mechanism chosen in `1-begin.md` needs in the project's manifest — and only those. Do not run the package manager here — the base integration's build/verify step (or the user) installs everything in one pass.
 
 Read the manifest first. If any of the required packages is already declared, leave the existing version alone and say so. Match the style of dependencies already in the file (versions, ordering, dev vs. runtime).
 
@@ -12,7 +12,20 @@ Read the manifest first. If any of the required packages is already declared, le
 
 The linked install page for this variant carries the authoritative command. The shapes below reflect the current defaults across Tier-1 providers.
 
-### Python — the standard OTel path
+### Wrapper path
+
+No OTel packages at all:
+
+```
+posthog                # Python — ships the posthog.ai.<provider> wrapper clients
+```
+
+```
+@posthog/ai            # Node — ships the wrapper clients
+posthog-node           # Node — the PostHog client the wrapper takes
+```
+
+### Python — the OTel path
 
 Three packages:
 
@@ -31,7 +44,7 @@ Examples:
 
 The vendor SDK itself (`openai`, `anthropic`, `langchain`, …) is a prerequisite — it should already be declared. Do not add or upgrade it.
 
-### Node — the standard OTel path
+### Node — the OTel path
 
 ```
 @posthog/ai                                     # PostHog span processor
@@ -57,7 +70,7 @@ No provider instrumentation package — Vercel AI emits OTel spans natively when
 @opentelemetry/resources
 ```
 
-### `manual-capture` variant
+### Manual-capture path
 
 No OTel packages. Just PostHog core:
 
@@ -66,11 +79,11 @@ posthog                # Python
 posthog-node           # Node
 ```
 
-If PostHog core is already installed (it should be — see `1-begin.md`), this file has nothing to add. Skip to `3-otel-setup.md`, which describes the manual `capture(...)` call shape.
+If PostHog core is already installed (it should be — see `1-begin.md`), this file has nothing to add. Skip to `3-instrument.md`, which describes the manual `capture(...)` call shape.
 
 ## Do not do
 
 - Do not run `npm install` / `pip install` here.
 - Do not edit the lockfile.
 - Do not upgrade the vendor SDK.
-- Do not add both an OTel-based instrumentation package *and* the older wrapper client — pick one. This skill uses the OTel path.
+- Do not add packages for more than one mechanism — no OTel instrumentation packages on a wrapper-path run, and vice versa. The gate in `1-begin.md` picked exactly one.
diff --git a/context/skills/ai-observability/references/3-otel-setup.md b/context/skills/ai-observability/references/3-instrument.md
similarity index 60%
rename from context/skills/ai-observability/references/3-otel-setup.md
rename to context/skills/ai-observability/references/3-instrument.md
index e1c86f05..a668384c 100644
--- a/context/skills/ai-observability/references/3-otel-setup.md
+++ b/context/skills/ai-observability/references/3-instrument.md
@@ -1,14 +1,14 @@
 ---
 next_step: 4-nesting.md
-title: AI Observability Setup - OpenTelemetry
-description: Initialize the OTel TracerProvider with PostHog's span processor and attach the provider instrumentor
+title: AI Observability Setup - Instrument
+description: Wire the mechanism chosen at the gate - wrapper client swap, OTel bootstrap, or manual capture
 ---
 
-Initialize OpenTelemetry once, at the app's entry point, so it is running before any LLM call executes. This is the single place PostHog reads the project token and host from.
+Wire the mechanism you chose at the gate in `1-begin.md`. Only one of the three sections below applies — do not wire OTel for a wrapper-path run or vice versa.
 
-This bootstrap captures individual generations only. It does **not** build the session → trace → span tree — that is application-level work done in `4-nesting.md`, and it is a mandatory part of this skill, not optional polish.
+Whatever the mechanism, this step captures individual generations only. It does **not** build the session → trace → span tree — that is application-level work done in `4-nesting.md`, and it is a mandatory part of this skill, not optional polish.
 
-## Environment variables
+## Environment variables (all mechanisms)
 
 Route the PostHog credentials through env vars, using the wizard's `set_env_values` tool (never hardcode). Reuse whatever names the base PostHog integration already set — typically:
 
@@ -17,9 +17,31 @@ Route the PostHog credentials through env vars, using the wizard's `set_env_valu
 
 If the project has an `.env.example` file, add the names there with empty placeholder values so collaborators know what to set. Create `.env.example` if it doesn't exist. Never write real secrets to any file.
 
-## Initialization shape
+## The wrapper path
 
-There is one initialization call per app. It runs once, at startup, before any vendor SDK call. The linked install page carries the exact code for this variant's language — copy from there.
+No OTel, no entry-point work. Swap the vendor client for PostHog's drop-in wrapper at the module where the client is constructed, and hand it a PostHog client:
+
+```python
+from posthog import Posthog
+from posthog.ai.anthropic import Anthropic          # swap per provider: posthog.ai.openai, .gemini, …
+
+posthog = Posthog(os.environ["POSTHOG_API_KEY"], host=os.environ["POSTHOG_HOST"])
+client = Anthropic(posthog_client=posthog)          # same constructor args as the vendor client otherwise
+```
+
+```typescript
+import { PostHog } from 'posthog-node'
+import { Anthropic } from '@posthog/ai/anthropic'   // swap per provider: @posthog/ai/openai, /gemini, /vercel
+
+const posthog = new PostHog(process.env.POSTHOG_API_KEY!, { host: process.env.POSTHOG_HOST! })
+const client = new Anthropic({ posthog })
+```
+
+The wrapper is call-compatible with the vendor client — existing `client.messages.create(...)` / `client.chat.completions.create(...)` calls keep working unchanged and now emit `$ai_generation` events. The per-call `posthog_*` params (trace id, distinct id, session) are `4-nesting.md`'s job. The linked install page carries the exact import for this variant.
+
+## The OTel path
+
+One initialization call per app. It runs once, at startup, before any vendor SDK call. The linked install page carries the exact code for this variant's language — copy from there.
 
 ### Python — the standard OTel path
 
@@ -79,17 +101,17 @@ const result = await generateText({
 
 If the project has many call sites, wrap the config into a shared helper rather than repeating it inline.
 
-## The PostHog client
+## The PostHog client (wrapper + manual paths)
 
-Some shapes need a PostHog client instance — the `manual-capture` variant, and wrappers that take a client. Look for a reusable one before creating anything:
+The wrapper and manual-capture paths need a PostHog client instance. Look for a reusable one before creating anything:
 
 - Search the project for an existing client: a `posthog-js` init on the frontend, a `PostHog` instance from `posthog` / `posthog-node` on the backend.
 - Frontend: the client is a singleton — always reuse it, never instantiate a second one.
 - Backend: reuse a shared instance if the project has one; if none exists, create one where the instrumentation lives — once, at module level, reused across call sites — and use it when initializing the wrappers.
 
-### `manual-capture` variant
+## The manual-capture path
 
-No OTel. Capture each generation explicitly at the call site:
+No OTel, no wrapper. Capture each generation explicitly at the call site:
 
 ```python
 posthog.capture(
@@ -111,6 +133,7 @@ Refer to `/docs/ai-observability/manual-capture` for the full property list.
 
 ## Do not
 
-- Do not create a PostHog client where one already exists — search first and reuse it (the frontend client is a singleton). Only a backend with no client creates one, once, at module level. Either way, reuse the project token / host already in the app's env — the OTel span processor is a separate exporter, not a separate PostHog install.
-- Do not put SDK init inside a request handler. Once per process, at startup.
-- Do not import the vendor SDK above the OTel init in the same file — the instrumentor patches the SDK when it loads, so the order matters.
+- Do not wire more than one mechanism — the gate in `1-begin.md` chose exactly one.
+- Do not create a PostHog client where one already exists — search first and reuse it (the frontend client is a singleton). Only a backend with no client creates one, once, at module level. Either way, reuse the project token / host already in the app's env — this is a separate exporter, not a separate PostHog install.
+- Do not put client or SDK init inside a request handler. Once per process, at module level or startup.
+- OTel path: do not import the vendor SDK above the OTel init in the same file — the instrumentor patches the SDK when it loads, so the order matters.
diff --git a/context/skills/ai-observability/references/4-nesting.md b/context/skills/ai-observability/references/4-nesting.md
index ce4cf484..d1a7011b 100644
--- a/context/skills/ai-observability/references/4-nesting.md
+++ b/context/skills/ai-observability/references/4-nesting.md
@@ -4,7 +4,7 @@ title: AI Observability Setup - Nesting
 description: Build the session → trace → span → generation tree on top of the bootstrap — this step is mandatory, not optional polish
 ---
 
-The bootstrap from `3-otel-setup.md` captures each LLM call in isolation. It has no concept of what constitutes a *request* (a trace), a *conversation* (a session), or a *non-LLM step* (a span) — those are application semantics only the code can tell you. Without this step, a request that makes two model calls with a lookup in between lands as two disconnected single-generation traces, no session, no user attribution, and the lookup invisible. The product is built around the tree; flat generations degrade it to a per-call cost log.
+The instrumentation from `3-instrument.md` captures each LLM call in isolation. It has no concept of what constitutes a *request* (a trace), a *conversation* (a session), or a *non-LLM step* (a span) — those are application semantics only the code can tell you. Without this step, a request that makes two model calls with a lookup in between lands as two disconnected single-generation traces, no session, no user attribution, and the lookup invisible. The product is built around the tree; flat generations degrade it to a per-call cost log.
 
 Use the structure map you wrote down in `1-begin.md`. This step turns it into code.
 
@@ -20,13 +20,7 @@ One vocabulary, every variant:
 | Generation | `$ai_generation` event | one LLM call |
 | Tree edge | `$ai_parent_id` | parent is a `trace_id` or another `span_id` |
 
-## Pick the mechanism — decision gate
-
-Work through these in order; take the first that matches. Whichever you pick, its imports must run in the project's environment — if an import fails during verification, come back here and take the next path, don't ship the caveat (some `posthog` releases don't ship `posthog.ai.otel` — 6.9.3, which older Pythons silently resolve to, doesn't; 7.29.0 does).
-
-1. **Variant has a wrapper SDK** (`openai`, `anthropic`, `gemini`, `langchain`, `vercel`, `openai-agents`) **and** the app has per-request user or conversation identity → **wrapper**. Per-call params, no manual spans, no propagation questions.
-2. **App already runs OpenTelemetry**, or spans must also fan out to non-PostHog backends → **OTel + Resource attributes**.
-3. **Neither** → **manual capture**.
+The mechanism was chosen at the gate in `1-begin.md` and wired in `3-instrument.md` — use that path's section below. If its imports fail in the project's environment during verification (some `posthog` releases don't ship `posthog.ai.otel` — 6.9.3, which older Pythons silently resolve to, doesn't; 7.29.0 does), return to the gate and take the next viable path; don't ship the caveat.
 
 ## The wrapper path
 
@@ -75,7 +69,7 @@ resource=Resource(attributes={
 })
 ```
 
-Resource attributes are process-global by nature — which is fine, because an app whose session/user vary per request was already routed to the wrapper by the gate above. If an app genuinely must stay on OTel *and* needs per-request values, use the standard `opentelemetry-processor-baggage` package — do not generate custom `SpanProcessor` classes in user codebases.
+Resource attributes are process-global by nature — fine when one process serves one session/user. An app on the OTel path whose session/user vary per request should reconsider the wrapper at the `1-begin.md` gate first. If an app genuinely must stay on OTel *and* needs per-request values, use the standard `opentelemetry-processor-baggage` package — do not generate custom `SpanProcessor` classes in user codebases.
 
 **Non-LLM step — a manual `$ai_span` event via `posthog.capture()`** (the `posthog` client class ships in the package you already installed), sharing the OTel trace id:
 

From b3c0deca2d18419397480559a99726ece42a212e Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Mon, 27 Jul 2026 16:20:02 -0400
Subject: [PATCH 05/15] feat(ai-observability): rebuild the skill around
 tools-are-spans + session-is-the-job
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Supersedes the enclosing-span/hand-authored-span model. Two rules now drive
the skill: spans come from the app's own tool registration, and the wizard's
job is the bootstrap plus the session id.

- 1-begin: variant picker now reaches all 68 variants — agent frameworks
  before providers, and a baseURL/base_url check so OpenAI-compatible
  gateways (Groq, OpenRouter, Together, ...) stop misrouting to openai-*.
  The four structure questions collapse to the two that matter: does the
  app register tools, and what identifies one conversation.
- 4-nesting: rewritten. Spans are never hand-authored; a tools-less app
  correctly has none. Sessions are always set, and cardinality is the
  graded property. Documents that a raw provider SDK + OTel instrumentor
  emits no tool spans at all — it patches only the SDK's own methods and
  records tool use as attributes on the generation.
- 5-verify: grades what lands in PostHog rather than what the diff contains.
- commandments: ai_observability carve-out for rules that assume a
  Posthog() client the OTel path never creates, and for the PII rule that
  contradicts $ai_input carrying the user's prompt.
- skill-generator: dedupe tags before collecting commandments — variants
  re-declare group-level tags, which doubled every carve-out.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 context/commandments.yaml                     |    7 +
 .../skills/ai-observability/description.md    |   16 +-
 .../ai-observability/references/1-begin.md    |  128 +-
 .../ai-observability/references/2-install.md  |   14 +-
 .../references/3-instrument.md                |   18 +-
 .../ai-observability/references/4-nesting.md  |  136 +-
 .../ai-observability/references/5-verify.md   |   58 +-
 package-lock.json                             | 2815 +++++++++++++++++
 scripts/lib/skill-generator.js                |    8 +-
 .../skill-generator-tag-implications.test.js  |    7 +
 10 files changed, 3031 insertions(+), 176 deletions(-)
 create mode 100644 package-lock.json

diff --git a/context/commandments.yaml b/context/commandments.yaml
index 64a8b6c0..ada6a85d 100644
--- a/context/commandments.yaml
+++ b/context/commandments.yaml
@@ -294,3 +294,10 @@ commandments:
     - posthog-kmp is a thin wrapper that delegates to the native posthog-android, posthog-ios, and posthog-js SDKs, so session replay and autocapture availability follow the underlying native platform
     - Use PostHogConfig.HOST_US or PostHogConfig.HOST_EU for the host, and read the project token from generated build config or environment values rather than hardcoding it
     - The SDK is 0.x pre-release; check the latest posthog-kmp version on Maven Central (https://central.sonatype.com/artifact/com.posthog/posthog-kmp) before pinning instead of hardcoding a stale version
+
+  # Carve-outs for the ai-observability skill; every variant carries this tag.
+  # Worded to override the generic language rules regardless of list order.
+  ai_observability:
+    - "AI Observability carve-out: this skill instruments LLM calls and is not product-analytics coverage. Do NOT add posthog.capture() events for user actions, captureException() error handlers, or a reverse proxy unless the user explicitly asks for them"
+    - "AI Observability carve-out: only the wrapper-client and manual-capture install paths construct a PostHog client. The OTel and framework-hook paths have no client at all, so any rule in this file about the Posthog()/PostHog() constructor, exception autocapture, atexit/shutdown registration or flushing simply does not apply — never invent a client just to satisfy one"
+    - "AI Observability carve-out: the $ai_* payload properties ($ai_input, $ai_output_choices, and the rest) intentionally carry user-generated prompt and completion text, so this file's PII rules do NOT apply to them. Those rules still govern every other property you set"
diff --git a/context/skills/ai-observability/description.md b/context/skills/ai-observability/description.md
index d5d1d578..c6fd83d4 100644
--- a/context/skills/ai-observability/description.md
+++ b/context/skills/ai-observability/description.md
@@ -6,7 +6,7 @@ Wire up PostHog's AI Observability so calls made through {display_name} land in
 
 This skill instruments the LLM calls the project *already makes*. It does **not** install the vendor SDK for you.
 
-Check the project's manifest for the provider's package (e.g. `openai`, `@anthropic-ai/sdk`, `langchain`, `ai`, `@google/genai`). If a vendor SDK is present, pick the matching variant. If none is present, switch to the `manual-capture` variant — it posts `$ai_generation` events directly and works standalone.
+Check the project's manifest for an LLM package. The catalog is far wider than the obvious providers — 68 variants covering agent frameworks (`openai-agents`, `claude-agent-sdk`, LangGraph, CrewAI, Mastra, …) and OpenAI-compatible gateways (Groq, OpenRouter, Together, Ollama, …), which an app reaches through the `openai` package plus a `baseURL` override. `1-begin.md` carries the ordered decision rules; follow them rather than matching on the first familiar package name. If no LLM SDK is present, switch to the `manual-capture` variant — it posts `$ai_generation` events directly and works standalone.
 
 Everything else this skill needs — PostHog credentials, instrumentation packages, env vars — the skill installs and configures itself. It does **not** require a pre-existing `posthog.init(...)`. If one is already there, reuse its env-var names in `3-instrument.md`; if not, that step sets fresh values via `set_env_values`.
 
@@ -14,11 +14,11 @@ Everything else this skill needs — PostHog credentials, instrumentation packag
 
 Read every referenced file **before editing**. Then work through them in order:
 
-1. **Begin** — see `references/1-begin.md`. Pick the right variant from the vendor SDK the project declares, locate the LLM call sites, map the app's logical structure (what a session, trace, span, and user are in this codebase), and choose the instrumentation mechanism at the gate — wrapper client, OTel, or manual capture. Do not default to OTel.
-2. **Install** — see `references/2-install.md`. Declare the chosen mechanism's packages in the manifest — and only those.
-3. **Instrument** — see `references/3-instrument.md`. Wire the chosen mechanism: swap in the PostHog wrapper client, or initialize the OTel TracerProvider with `PostHogSpanProcessor`, or set up manual capture. Route the project token / host through environment variables.
-4. **Build the nesting** — see `references/4-nesting.md`. Group each request's calls into one trace, attach session and distinct id, and wrap non-LLM steps as spans. Mandatory — the bootstrap alone produces flat, disconnected generations.
-5. **Verify** — see `references/5-verify.md`. Describe a request the user can trigger and how to confirm the tree — grouped trace, session, attribution — lands in PostHog, not just a lone `$ai_generation`.
+1. **Begin** — see `references/1-begin.md`. Pick the right variant using the ordered rules (framework before provider, gateway `baseURL` before the SDK it borrows), locate the LLM call sites, and answer the two questions that drive everything after: does the app register tools, and what identifies one conversation?
+2. **Install** — see `references/2-install.md`. Declare the variant's packages in the manifest — and only those.
+3. **Instrument** — see `references/3-instrument.md`. Wire the bootstrap the variant's install doc describes: OTel `TracerProvider` + `PostHogSpanProcessor`, a PostHog wrapper client, a framework tracing hook, or manual capture. Route the project token / host through environment variables.
+4. **Attach the session** — see `references/4-nesting.md`. Give the traces that belong to one conversation a shared `$ai_session_id`. Mandatory. Spans are *not* your job — they come from the app's own tool registration.
+5. **Verify** — see `references/5-verify.md`. Describe a request the user can trigger, and grade what lands in PostHog — one session, grouped traces, right attribution — rather than what the diff contains.
 
 ## Reference files
 
@@ -29,10 +29,10 @@ The linked install page carries the exact code blocks for this variant's languag
 ## Key principles
 
 - **Environment variables.** Read `<ph_project_token>` and `<ph_client_api_host>` from env, using the framework's env-var convention. Never hardcode either value.
-- **One mechanism, chosen deliberately.** Wrapper client, OTel, or manual capture — the gate in `1-begin.md` picks exactly one; don't default to OTel or wire two.
+- **One mechanism, and the variant chooses it.** The install doc for the variant you picked names the mechanism; wire that one and no other. Never swap a framework's own tracing hook for an OTel instrumentor.
 - **Minimal changes.** The wrapper swaps a client import; OTel init is a single call at process start, placed alongside any existing PostHog init. Don't restructure the app either way.
 - **Match the docs.** Package names, instrumentor imports, and processor names change between AIO releases. The install page for this variant is the source of truth.
-- **The tree is the deliverable.** A run that only produces flat `$ai_generation` events is incomplete. Nesting (`4-nesting.md`) is part of setup, not a follow-up.
+- **Sessions always, spans never.** Every run attaches an `$ai_session_id`, inferring the conversation boundary when the app has no explicit field — one id shared by the traces that belong together. Spans are the opposite: they come from the app's registered tools, and an app with no tools correctly has none. Never hand-author a span to make a trace look fuller.
 - **Don't touch what isn't yours.** This skill instruments LLM observability only — generations, traces, sessions, spans. Identify calls, event tracking, error tracking, and dashboards belong to the base `integration` skill — do not add or edit them here.
 
 ## Emit a run record
diff --git a/context/skills/ai-observability/references/1-begin.md b/context/skills/ai-observability/references/1-begin.md
index 7148887b..ec968730 100644
--- a/context/skills/ai-observability/references/1-begin.md
+++ b/context/skills/ai-observability/references/1-begin.md
@@ -1,72 +1,96 @@
 ---
 next_step: 2-install.md
 title: AI Observability Setup - Begin
-description: Pick the right variant, locate the LLM call sites, map the app's session/trace/span structure, and choose the instrumentation mechanism before editing
+description: Pick the right variant from the full catalog, locate the LLM call sites, and answer the two questions that drive the whole integration
 ---
 
-Before touching any code, decide which variant of this skill to install, confirm the two prerequisites, and get a read on where in the project LLM calls actually happen. AI Observability instruments an existing setup — if the setup isn't there, this skill can't do its job.
+Before touching any code, decide which variant of this skill to install, confirm the prerequisites, and get a read on where in the project LLM calls actually happen. AI Observability instruments an existing setup — if the setup isn't there, this skill can't do its job.
 
 ## Pick the variant
 
-The `ai-observability` skill has one variant per LLM provider × language (e.g. `ai-observability-openai-python`, `ai-observability-anthropic-node`, …). You are running the group-level entry; before installing, pick the specific variant that matches this project.
-
-Scan the manifest (`package.json`, `pyproject.toml`, `requirements.txt`, `Gemfile`) for a vendor LLM package. Typical package names:
-
-- OpenAI — `openai`
-- Anthropic — `@anthropic-ai/sdk` (Node) or `anthropic` (Python)
-- LangChain — `langchain` / `@langchain/core` (plus a provider adapter like `langchain-openai` / `@langchain/openai`)
-- Vercel AI SDK — `ai` (plus a provider like `@ai-sdk/openai`)
-- Google Gemini — `google-genai` (Python) or `@google/genai` (Node)
-
-Decision rules — apply in order:
-
-1. **Exactly one vendor SDK found** → pick the corresponding variant. Language follows the manifest (`package.json` → Node, `pyproject.toml`/`requirements.txt` → Python). Tell the user which variant you picked and why in a `[STATUS]` line, then call `install_skill` with the full variant id (e.g. `ai-observability-openai-python`).
-2. **Multiple vendor SDKs found** (e.g. LangChain wraps OpenAI, so both may be declared) → prefer the higher-level abstraction: LangChain > direct provider SDK. If still ambiguous, use `wizard_ask` to have the user pick, listing the candidates as options.
-3. **No vendor SDK found** → install `ai-observability-manual-capture`. This variant posts `$ai_generation` events explicitly and works without any auto-instrumentation.
-4. **You're not sure** → `wizard_ask` the user with a multi-choice picker listing every provider you have a variant for. Do not guess when there's real ambiguity.
+This skill ships **68 variants** — one per (provider × language), plus agent frameworks, gateways, and a manual fallback. You are running the group-level entry. Call `load_skill_menu` with `category: "ai-observability"` and treat that list as the source of truth; the families below tell you what to look for in the project.
+
+Apply these rules **in order**. The first match wins — the order matters, because frameworks wrap providers and gateways impersonate them.
+
+### 1. An agent or orchestration framework → use its variant, not the provider's
+
+These wrap the provider SDK. Instrumenting the provider underneath captures the model calls but loses the framework's own structure (tool spans, handoffs, agent steps), and on some of them the provider instrumentor captures nothing at all.
+
+| Package in the manifest | Variant |
+|---|---|
+| `openai-agents` | `openai-agents` |
+| `claude-agent-sdk` | `claude-agent-sdk` |
+| `langchain`, `@langchain/core` | `langchain-{python,node}` |
+| `langgraph`, `@langchain/langgraph` | `langgraph-{python,node}` |
+| `ai` (Vercel AI SDK) | `vercel-ai` |
+| `llama-index`, `llamaindex` | `llamaindex` |
+| `crewai` | `crewai` |
+| `pyautogen`, `autogen-agentchat` | `autogen` |
+| `dspy` / `dspy-ai` | `dspy` |
+| `pydantic-ai` | `pydantic-ai` |
+| `semantic-kernel` | `semantic-kernel` |
+| `smolagents` | `smolagents` |
+| `mirascope` | `mirascope` |
+| `instructor` | `instructor-{python,node}` |
+| `litellm` | `litellm` |
+| `mastra`, `@mastra/core` | `mastra` |
+| `convex` | `convex` |
+
+### 2. A provider SDK with a `baseURL` / `base_url` override → use the gateway's variant
+
+Most OpenAI-compatible providers ship no SDK of their own; apps talk to them with the `openai` package pointed at a different host. **Routing these to `openai-*` is a silent, costly misroute** — generations get attributed to the wrong provider and cost calculation breaks.
+
+So whenever you find an `openai` client, grep its construction for `baseURL` / `base_url` (also check `OPENAI_BASE_URL` in env files) and match the host:
+
+| Host contains | Variant |
+|---|---|
+| `api.groq.com` | `groq-{python,node}` |
+| `openrouter.ai` | `openrouter-{python,node}` |
+| `api.together.` | `together-ai-{python,node}` |
+| `localhost:11434`, `ollama` | `ollama-{python,node}` |
+| `api.deepseek.com` | `deepseek-{python,node}` |
+| `api.x.ai` | `xai-{python,node}` |
+| `api.perplexity.ai` | `perplexity-{python,node}` |
+| `api.fireworks.ai` | `fireworks-ai-{python,node}` |
+| `api.cerebras.ai` | `cerebras-{python,node}` |
+| `huggingface.co` | `hugging-face-{python,node}` |
+| `dedaluslabs.ai` | `dedalus-{python,node}` |
+| `api.portkey.ai` | `portkey-{python,node}` |
+| `helicone.ai` | `helicone-{python,node}` |
+| `gateway.ai.cloudflare.com` | `cloudflare-ai-gateway-{python,node}` |
+| `.openai.azure.com` | `azure-openai-{python,node}` |
+
+An unfamiliar host still means "not plain OpenAI" — check the menu for a variant naming that provider before falling back.
+
+### 3. A direct provider SDK, no override → that provider's variant
+
+`openai` → `openai-*`; `anthropic` / `@anthropic-ai/sdk` → `anthropic-*`; `google-genai` / `@google/genai` → `google-*`; `mistralai` → `mistral-*`; `cohere` → `cohere-*`; `boto3` + `bedrock-runtime` → `aws-bedrock-*`.
+
+### 4. Everything else
+
+- **Several candidates and no framework** → prefer the higher-level abstraction; if still ambiguous, `wizard_ask` the user with the candidates as options.
+- **The app already emits OTel spans for its LLM calls itself** → `opentelemetry-{python,node}`.
+- **No LLM SDK at all** → `ai-observability-manual-capture`, which posts events explicitly.
+- **Genuinely unsure** → `wizard_ask` with a multi-choice picker. Do not guess when there's real ambiguity.
+
+Language follows the manifest (`package.json` → Node, `pyproject.toml`/`requirements.txt` → Python); framework-only variants have no language suffix. Tell the user which variant you picked **and why** in a `[STATUS]` line, then call `install_skill` with the full id (e.g. `ai-observability-groq-node`).
 
 ## Check for an existing PostHog setup (informational — not a blocker)
 
-Grep the project for one of:
-
-- `posthog.init(` — most JS/TS SDKs
-- `PostHog(` — Python, Ruby, Go SDK constructors
-- `AddPostHog(` — .NET DI registration
-
-**This is not a prerequisite.** The OTel-based variants use `PostHogSpanProcessor`, a self-contained exporter that just takes an API key + host — it does not depend on a `posthog.init(...)` call anywhere. The `manual-capture` variant uses `posthog.capture(...)`, which needs the traditional SDK, but the install step will add it if it isn't there.
+Grep for `posthog.init(`, `PostHog(`, or `AddPostHog(`.
 
-If a `posthog.init(...)` (or equivalent) **is** already present, note the env-var names it reads (`POSTHOG_API_KEY`, `NEXT_PUBLIC_POSTHOG_KEY`, etc.) and reuse them in `3-instrument.md` — don't invent parallel names. If nothing is there, `3-instrument.md` will set fresh values via `set_env_values`.
+**This is not a prerequisite.** The OTel-based variants use `PostHogSpanProcessor`, a self-contained exporter taking an API key + host — it does not depend on a `posthog.init(...)` anywhere. If one **is** present, note the env-var names it reads (`POSTHOG_API_KEY`, `NEXT_PUBLIC_POSTHOG_KEY`, …) and reuse them in `3-instrument.md`; don't invent parallel names.
 
 ## Locate the LLM call sites
 
-Grep for where the vendor SDK is imported and called. This is not a full analysis — one or two representative sites is enough for you to reason about where OTel initialization has to run before those calls execute:
-
-- OpenAI: `import OpenAI`, `openai.OpenAI(`, `new OpenAI(`
-- Anthropic: `Anthropic(`, `new Anthropic(`
-- LangChain: `ChatOpenAI(`, `from langchain`, `import { ChatOpenAI } from '@langchain/openai'`
-- Vercel AI: `generateText(`, `streamText(`, `import ... from 'ai'`
-- Google Gemini: `genai.Client(`, `new GoogleGenerativeAI(`
-
-Note the app's entry point (server startup file, `main.py`, `index.ts`, `instrumentation.ts` in Next.js, etc.) — on the OTel path, init must run there *before* the vendor SDK is imported; the wrapper path edits the call sites instead.
-
-## Map the logical structure
-
-Instrumentation captures individual LLM calls; the *tree* that makes them useful — session → trace → span → generation — comes from application semantics only the code can tell you. Answer these four questions now, from the code, and write the answers down; `4-nesting.md` consumes them:
-
-- **What is one session here?** The unit of conversation — a conversation object, a thread id, a workflow run. Some apps have none; that's a valid answer.
-- **What is one trace?** The unit of request — typically a request handler or the top-level function that may make several model calls to produce one result.
-- **Which non-LLM steps deserve spans?** Retrieval, tool calls, validation — steps between model calls worth seeing in the trace.
-- **What is the distinct-id source?** A `user_id` in scope at the call sites? None → events will be anonymous; note that too.
+Grep for where the chosen SDK is imported and called — one or two representative sites is enough to reason about where init has to run. Note the app's **entry point** (server startup file, `main.py`, `index.ts`, `instrumentation.ts` in Next.js): on the OTel path, init must run there *before* the vendor SDK is imported.
 
-## Choose the mechanism
+## Answer the two questions
 
-There are three ways to instrument: a **PostHog wrapper client** (per-call params), **OTel auto-instrumentation** (bootstrap + enclosing spans), and **manual capture** (explicit events). Do not default to OTel — pick from this gate, in order, using the variant and the structure map above:
+Instrumentation captures individual LLM calls. The structure that makes them useful comes from application semantics only the code can tell you — and it reduces to two questions. Write the answers down; `4-nesting.md` consumes them and nothing else.
 
-1. **App already runs OpenTelemetry**, or its spans must also fan out to non-PostHog backends → **OTel**.
-2. **Variant has a PostHog wrapper client** — Python `posthog` ships `posthog.ai.{openai,anthropic,gemini,langchain,openai_agents,claude_agent_sdk}`; Node `@posthog/ai` ships `{openai,anthropic,gemini,vercel}` — → **wrapper**. Simplest path, and the only one that handles per-request user/conversation identity without extra machinery.
-3. **Anything else** (most provider variants have no wrapper) → **OTel**.
-4. **No vendor SDK at all** → you already picked the `manual-capture` variant above → **manual capture**.
+**1. Does the app register tools with its LLM calls?** Look for a `tools=` / `tools:` argument, a tool registry, or a framework's tool decorator. This decides whether the trace should contain spans at all — you never author them by hand, so the answer is "which spans should already be there", not "which should I add".
 
-Record the choice — `2-install.md` and `3-instrument.md` branch on it. If the chosen mechanism's imports fail in the project's environment at verification time, come back to this gate and take the next viable path; do not ship non-running code.
+**2. What identifies one conversation, and does it vary within the process?** A `thread_id` / `conversationId` field, a session row, a request parameter — or nothing explicit, in which case the process run *is* the conversation. Whether it varies per request decides **where** the session id has to live: a server handling many users' threads needs it per call; a CLI or worker can set it once at startup.
 
-Do not edit yet. Once you have the entry point, the call sites, the structure map, and the mechanism, move on to `2-install.md`.
+Do not edit yet. Once you have the variant, the entry point, the call sites, and those two answers, move on to `2-install.md`.
diff --git a/context/skills/ai-observability/references/2-install.md b/context/skills/ai-observability/references/2-install.md
index 16198203..a04e2f44 100644
--- a/context/skills/ai-observability/references/2-install.md
+++ b/context/skills/ai-observability/references/2-install.md
@@ -1,10 +1,10 @@
 ---
 next_step: 3-instrument.md
 title: AI Observability Setup - Install
-description: Declare the packages for the mechanism chosen at the gate - wrapper, OTel, or manual capture
+description: Declare the packages the installed variant needs - OTel, wrapper, framework hook, or manual capture
 ---
 
-Declare the packages the mechanism chosen in `1-begin.md` needs in the project's manifest — and only those. Do not run the package manager here — the base integration's build/verify step (or the user) installs everything in one pass.
+Declare the packages the variant you installed in `1-begin.md` needs in the project's manifest — and only those. Do not run the package manager here — the base integration's build/verify step (or the user) installs everything in one pass.
 
 Read the manifest first. If any of the required packages is already declared, leave the existing version alone and say so. Match the style of dependencies already in the file (versions, ordering, dev vs. runtime).
 
@@ -70,6 +70,14 @@ No provider instrumentation package — Vercel AI emits OTel spans natively when
 @opentelemetry/resources
 ```
 
+### Gateway variants (Groq, OpenRouter, Together, Ollama, …)
+
+These use the `openai` SDK against a different host, so the packages are the OpenAI ones — `opentelemetry-instrumentation-openai-v2` (Python) or `@opentelemetry/instrumentation-openai` (Node). The variant differs in the install doc's configuration, not its dependencies. Do not go looking for a `opentelemetry-instrumentation-groq`.
+
+### Agent framework variants
+
+Framework variants generally need no OTel instrumentation package at all — the tracing hook ships in the framework or in `posthog` / `@posthog/ai`. Take the package list from the variant's install doc; do not assume the three-package OTel shape above applies.
+
 ### Manual-capture path
 
 No OTel packages. Just PostHog core:
@@ -86,4 +94,4 @@ If PostHog core is already installed (it should be — see `1-begin.md`), this f
 - Do not run `npm install` / `pip install` here.
 - Do not edit the lockfile.
 - Do not upgrade the vendor SDK.
-- Do not add packages for more than one mechanism — no OTel instrumentation packages on a wrapper-path run, and vice versa. The gate in `1-begin.md` picked exactly one.
+- Do not add packages for more than one mechanism — no OTel instrumentation packages on a wrapper-path run, and vice versa. The variant's install doc describes exactly one.
diff --git a/context/skills/ai-observability/references/3-instrument.md b/context/skills/ai-observability/references/3-instrument.md
index a668384c..fd6b0519 100644
--- a/context/skills/ai-observability/references/3-instrument.md
+++ b/context/skills/ai-observability/references/3-instrument.md
@@ -4,9 +4,16 @@ title: AI Observability Setup - Instrument
 description: Wire the mechanism chosen at the gate - wrapper client swap, OTel bootstrap, or manual capture
 ---
 
-Wire the mechanism you chose at the gate in `1-begin.md`. Only one of the three sections below applies — do not wire OTel for a wrapper-path run or vice versa.
+**The variant you installed determines the mechanism, and its installation doc is the source of truth** — copy the bootstrap from there rather than adapting a different variant's shape. The doc will describe one of four families:
 
-Whatever the mechanism, this step captures individual generations only. It does **not** build the session → trace → span tree — that is application-level work done in `4-nesting.md`, and it is a mandatory part of this skill, not optional polish.
+| Family | Who uses it | Shape |
+|---|---|---|
+| **OTel bootstrap** | most provider variants, and the gateway variants | `TracerProvider` + `PostHogSpanProcessor` + a provider instrumentor |
+| **PostHog wrapper client** | variants where `posthog.ai.*` / `@posthog/ai` ships a drop-in | swap the client constructor, no entry-point work |
+| **Framework hook** | agent frameworks and Vercel AI | the framework's own tracing processor, callback, or `experimental_telemetry` |
+| **Manual capture** | `manual-capture` | explicit `capture()` calls at the call site |
+
+Wire exactly one. Whatever the family, this step captures individual generations only — attaching the session id is `4-nesting.md`'s job, and it is a mandatory part of this skill, not optional polish.
 
 ## Environment variables (all mechanisms)
 
@@ -87,6 +94,10 @@ sdk.start()
 
 For Next.js / Nuxt / other frameworks that expose a dedicated startup hook (`instrumentation.ts`, `nuxt.config`'s server plugin, etc.), put the SDK init there. It must run once per process, not per request.
 
+### Agent frameworks — a tracing processor, not OTel
+
+Agent SDKs carry their own tracing layer, and the PostHog integration plugs into *that*. `openai-agents` and `claude-agent-sdk` register a processor rather than a `TracerProvider`; LangChain-family variants use a callback handler. Take the exact registration from the variant's install doc — wiring an OTel instrumentor underneath one of these captures the model calls but loses the agent, tool, and handoff structure that makes the framework worth instrumenting.
+
 ### Vercel AI SDK
 
 No instrumentor package. Initialize `NodeSDK` with just `PostHogSpanProcessor` (no `instrumentations` array), then pass `experimental_telemetry` per call:
@@ -133,7 +144,8 @@ Refer to `/docs/ai-observability/manual-capture` for the full property list.
 
 ## Do not
 
-- Do not wire more than one mechanism — the gate in `1-begin.md` chose exactly one.
+- Do not wire more than one mechanism — the variant's install doc describes exactly one.
+- Do not substitute an OTel instrumentor for a framework's own tracing hook. If the variant is an agent framework, its processor is the integration.
 - Do not create a PostHog client where one already exists — search first and reuse it (the frontend client is a singleton). Only a backend with no client creates one, once, at module level. Either way, reuse the project token / host already in the app's env — this is a separate exporter, not a separate PostHog install.
 - Do not put client or SDK init inside a request handler. Once per process, at module level or startup.
 - OTel path: do not import the vendor SDK above the OTel init in the same file — the instrumentor patches the SDK when it loads, so the order matters.
diff --git a/context/skills/ai-observability/references/4-nesting.md b/context/skills/ai-observability/references/4-nesting.md
index d1a7011b..0cdae0a4 100644
--- a/context/skills/ai-observability/references/4-nesting.md
+++ b/context/skills/ai-observability/references/4-nesting.md
@@ -1,65 +1,42 @@
 ---
 next_step: 5-verify.md
 title: AI Observability Setup - Nesting
-description: Build the session → trace → span → generation tree on top of the bootstrap — this step is mandatory, not optional polish
+description: Attach the session id so traces group into conversations - and let spans come from the app's own tools rather than authoring them
 ---
 
-The instrumentation from `3-instrument.md` captures each LLM call in isolation. It has no concept of what constitutes a *request* (a trace), a *conversation* (a session), or a *non-LLM step* (a span) — those are application semantics only the code can tell you. Without this step, a request that makes two model calls with a lookup in between lands as two disconnected single-generation traces, no session, no user attribution, and the lookup invisible. The product is built around the tree; flat generations degrade it to a per-call cost log.
+`3-instrument.md` wired the bootstrap, so individual LLM calls now land. This step adds the one piece of structure the bootstrap can't infer.
 
-Use the structure map you wrote down in `1-begin.md`. This step turns it into code.
+Two rules. Everything else follows from them.
 
-## The nesting model
+## Rule 1 — spans come from the app's own tool registration
 
-One vocabulary, every variant:
+If the app registers tools with its LLM calls, the tool executions **are** the spans, and the tracing layer emits them. You never hand-author a wrapper span around an ordinary helper function.
 
-| Concept | Property | Notes |
-|---|---|---|
-| Session | `$ai_session_id` | optional; groups traces (a conversation, workflow, thread) |
-| Trace | `$ai_trace_id` | **required**; groups one request's events |
-| Span | `$ai_span` event + `$ai_span_id` / `$ai_span_name` | a non-LLM step (retrieval, tool call, validation) |
-| Generation | `$ai_generation` event | one LLM call |
-| Tree edge | `$ai_parent_id` | parent is a `trace_id` or another `span_id` |
+An app that registers no tools has no spans. **That is a correct, complete outcome** — a trace of two generations and nothing else is not a failure, and you must not invent spans to make the tree look fuller.
 
-The mechanism was chosen at the gate in `1-begin.md` and wired in `3-instrument.md` — use that path's section below. If its imports fail in the project's environment during verification (some `posthog` releases don't ship `posthog.ai.otel` — 6.9.3, which older Pythons silently resolve to, doesn't; 7.29.0 does), return to the gate and take the next viable path; don't ship the caveat.
+Which layers actually emit tool spans, so you know what to expect at verification:
 
-## The wrapper path
+| Mechanism | Tool spans? |
+|---|---|
+| Agent / orchestration frameworks (`openai-agents`, `claude-agent-sdk`, LangChain / LangGraph, CrewAI, Pydantic AI, …) | **Yes** — their tracing emits agent, tool, and handoff spans |
+| Vercel AI SDK | **Yes** — `ai.toolCall` spans, automatically |
+| Manual capture | Only what the app dispatches by hand |
+| Raw provider SDK + OTel instrumentor | **No** — see below |
 
-Per-call parameters, no manual spans needed. Python kwargs: `posthog_trace_id`, `posthog_distinct_id`, `posthog_properties` (put `$ai_session_id` here), `posthog_groups`. Node equivalents are camelCase (`posthogTraceId`, …).
+The last row is the one that surprises people. An OTel instrumentor patches only the vendor SDK's own methods (`Messages.create`, `chat.completions.create`, …). A tool the app executes in its own loop never passes through it, so it produces no span; the model's *request* to call that tool is recorded as attributes on the generation (`gen_ai.prompt.N.tool_calls.M.name`), not as a child. On this path a tool-using app still yields a generations-only trace — expected, not a defect to fix.
 
-**Trap:** `posthog_trace_id` auto-generates a *fresh UUID per call* when omitted. To group multiple calls into one trace you must pass a shared id explicitly:
+## Rule 2 — your job is the bootstrap plus the session id
 
-```python
-from uuid import uuid4
-
-def ask(self, question: str) -> str:
-    trace_id = str(uuid4())                       # one per request; reuse for every call in it
-    ph = dict(
-        posthog_trace_id=trace_id,
-        posthog_distinct_id=self.user_id,
-        posthog_properties={"$ai_session_id": self.thread_id},
-    )
-    category = self._classify(question, ph)       # client.messages.create(..., **ph)
-    order = lookup_order(self.user_id) if category == "order_status" else None
-    return self._answer(question, category, order, ph)
-```
-
-Non-LLM steps worth seeing: emit a `$ai_span` event with `posthog.capture()` sharing the same `$ai_trace_id` (shape below, under manual capture).
+The bootstrap is done. Trace grouping is not a separate task: it falls out of the framework's own call structure, because the calls a request makes already share one OTel trace (or one framework run). So the only application semantics left to supply is the **session** — because only the app knows what a conversation is.
 
-## The OTel path
+### Where `$ai_session_id` goes
 
-Three goals, three separate mechanisms — don't conflate them:
+Use the second answer from `1-begin.md`:
 
-**Trace grouping — an enclosing span, any name, zero attributes.** Auto-instrumented generations inside it inherit its OTel trace context in-process, so they share one `$ai_trace_id`. The enclosing span itself does **not** need to survive ingest (or carry anything) for this to work:
-
-```python
-def ask(self, question: str) -> str:
-    with tracer.start_as_current_span("support_request"):   # name is irrelevant to ingest
-        category = self._classify(question)                 # generation, same trace
-        order = self._lookup_order(category)
-        return self._answer(question, category, order)      # generation, same trace
-```
-
-**Session + user — two Resource attributes in the bootstrap you already wrote.** Ingest copies Resource attributes onto every surviving event (only `host.` / `process.` / `os.` / `telemetry.` prefixes are filtered), and `posthog.distinct_id` on the Resource is the documented identity mechanism:
+| Case | Where it goes |
+|---|---|
+| One process = one conversation (CLI, script, worker) | OTel **Resource** attribute, beside `posthog.distinct_id` |
+| Session varies per request (any server) | **Per call** — the wrapper's `posthog_properties` / `posthogProperties`, Vercel AI's `experimental_telemetry.metadata`, or manual-capture properties |
 
 ```python
 resource=Resource(attributes={
@@ -69,52 +46,49 @@ resource=Resource(attributes={
 })
 ```
 
-Resource attributes are process-global by nature — fine when one process serves one session/user. An app on the OTel path whose session/user vary per request should reconsider the wrapper at the `1-begin.md` gate first. If an app genuinely must stay on OTel *and* needs per-request values, use the standard `opentelemetry-processor-baggage` package — do not generate custom `SpanProcessor` classes in user codebases.
+The key is the literal `$ai_session_id` — there is no `posthog.session_id` alias (only `posthog.distinct_id` and `posthog.geoip_disable` get remapped at ingest). Resource attributes are copied onto every event, filtered only by the `host.` / `process.` / `os.` / `telemetry.` prefixes.
 
-**Non-LLM step — a manual `$ai_span` event via `posthog.capture()`** (the `posthog` client class ships in the package you already installed), sharing the OTel trace id:
+**Never put a per-request session on the Resource** — the Resource is global to the SDK instance, so every conversation in the process would collapse into one id. If an app must stay on OTel *and* needs per-request values, use the standard `opentelemetry-processor-baggage` package; do not generate custom `SpanProcessor` classes in user codebases.
 
-```python
-from opentelemetry import trace as otel_trace
-
-def _lookup_order(self, category: str) -> dict | None:
-    if category != "order_status":
-        return None
-    result = lookup_order(self.user_id)
-    ctx = otel_trace.get_current_span().get_span_context()
-    posthog.capture(
-        distinct_id=self.user_id,
-        event="$ai_span",
-        properties={
-            "$ai_trace_id": format(ctx.trace_id, "032x"),   # same trace as the generations
-            "$ai_span_name": "lookup_order",
-        },
-    )
-    return result
-```
+### Always set a session — the graded property is cardinality
 
-Or omit it and say so in the report — "no non-LLM step worth tracing" is a finding.
+Every instrumented app gets an `$ai_session_id`, including one-shot and single-trace apps. Tagging costs nothing, keeps session-level aggregation consistent across the project, and is already correct the day the app grows a second turn.
 
-**Why not hand-authored OTel spans with attributes?** Ingest keeps a span only if an **attribute key** starts with a provider prefix (`gen_ai.` / `ai.` / `traceloop.` / `pydantic_ai.`) — the span *name* is never consulted. A hand-made span carrying only `$ai_session_id` or `posthog.distinct_id` is silently dropped, taking those values with it. Don't fight this rule; put session/user on the Resource and non-LLM steps through `capture()`, as above.
+When the app has no conversation field, **identify the boundary rather than skipping the step**: a CLI or worker run is a session; a server request carrying a thread id uses that; an agent framework run is a session even when it produces exactly one trace.
 
-## Manual capture
+What must be right is the **cardinality** — one id shared by the traces that belong together. A fresh id minted per call or per trace is *worse than no session at all*: it looks instrumented and groups nothing.
 
-Emit `$ai_trace` / `$ai_span` / `$ai_generation` events explicitly and wire the tree yourself: every event in a request shares `$ai_trace_id`; child events set `$ai_parent_id` to the parent's `trace_id` or `span_id`; `$ai_session_id` goes in properties. The manual-capture install page carries the full property tables.
+Note the asymmetry with rule 1. Sessions: always set one, inferring the boundary if needed. Tools: never invent one.
 
-## What to actually edit
+## The wrapper path — the fresh-UUID trap
 
-For each request-shaped code path you mapped in `1-begin.md`:
+On PostHog's wrapper clients, per-call parameters carry the tree: `posthog_trace_id`, `posthog_distinct_id`, `posthog_properties` (where `$ai_session_id` goes), `posthog_groups`. Node equivalents are camelCase.
 
-1. Group its LLM calls into one trace (shared `posthog_trace_id`, enclosing span, or shared `$ai_trace_id` — per the gate's branch).
-2. Set `$ai_session_id` from the conversation identifier, if the app has one (wrapper: `posthog_properties`; OTel: Resource).
-3. Set the distinct id from the user identifier, if the app has one (wrapper: `posthog_distinct_id`; OTel: Resource `posthog.distinct_id`).
-4. Emit `$ai_span` events for non-LLM steps worth seeing (retrieval, tool calls, validation).
+`posthog_trace_id` auto-generates a **fresh UUID per call** when omitted, so calls that belong to one request must be handed a shared id explicitly:
+
+```python
+from uuid import uuid4
+
+def ask(self, question: str) -> str:
+    trace_id = str(uuid4())                       # one per request; reuse for every call in it
+    ph = dict(
+        posthog_trace_id=trace_id,
+        posthog_distinct_id=self.user_id,
+        posthog_properties={"$ai_session_id": self.thread_id},
+    )
+    ...
+```
+
+## Manual capture
 
-Keep it minimal: instrument the representative paths you mapped, don't refactor the app. If the app genuinely has no conversation or user concept, say so in the report — omitting a session is a finding, not a failure.
+Only this path wires the tree by hand: every event in a request shares `$ai_trace_id`; child events set `$ai_parent_id` to the parent's trace or span id; `$ai_session_id` goes in properties. The manual-capture install page carries the full property tables.
 
 ## Do not
 
-- Do not attach `$ai_session_id` or the distinct id only to a hand-authored OTel span — ingest drops spans without provider-prefixed attribute keys (names are never consulted). Put them on the Resource (process-global) or the wrapper's per-call params (per-request).
-- Do not rely on omitted `posthog_trace_id` to group wrapper-SDK calls — each call gets its own fresh UUID.
-- Do not put a runtime-varying `$ai_session_id` or distinct id on the Resource — the Resource is process-global; per-request identity belongs on the wrapper path.
-- Do not ship a code path whose imports failed in the project's environment — switch to the gate's next mechanism instead.
-- Do not skip this step because generations already appear in PostHog. Flat generations are the failure mode this step exists to prevent.
+- Do not hand-author wrapper spans around ordinary helper functions — tool registration is what produces spans.
+- Do not create spans to fill out a trace when the app registers no tools. "No tools, so no spans" is a finding to report, not a gap to close.
+- Do not attach `$ai_session_id` or the distinct id to a hand-authored OTel span. Ingest keeps a span only when an **attribute key** starts with a provider prefix (`gen_ai.` / `ai.` / `traceloop.` / `pydantic_ai.`); the span *name* is never consulted, so such a span is dropped silently and takes those values with it.
+- Do not mint a fresh session id per call or per trace — cardinality is the graded property.
+- Do not put a runtime-varying `$ai_session_id` or distinct id on the Resource.
+- Do not rely on an omitted `posthog_trace_id` to group wrapper-SDK calls.
+- Do not ship a code path whose imports failed in the project's environment — go back to `1-begin.md` and take the next viable variant instead of shipping the caveat.
diff --git a/context/skills/ai-observability/references/5-verify.md b/context/skills/ai-observability/references/5-verify.md
index 8f89b473..e5942066 100644
--- a/context/skills/ai-observability/references/5-verify.md
+++ b/context/skills/ai-observability/references/5-verify.md
@@ -1,50 +1,54 @@
 ---
 next_step: null
 title: AI Observability Setup - Verify
-description: Give the user a concrete way to trigger a request and confirm the full trace tree — not just a lone generation — lands in PostHog
+description: Give the user a concrete way to trigger a request, and grade what lands in PostHog rather than what the diff contains
 ---
 
-You've installed packages, wired OTel init, and built the nesting from `4-nesting.md`. The last thing this skill produces is a **verification path** the user can run themselves. Don't call the LLM from here — you don't have credentials, and the user should be the one to see the trace show up in their project.
+You've installed packages, wired the bootstrap, and attached the session id. The last thing this skill produces is a **verification path** the user can run themselves. Don't call the LLM from here — you don't have credentials, and the user should be the one to see the trace show up.
 
-**The bar is the tree, not a single event.** A lone `$ai_generation` appearing proves the bootstrap works; it does not prove the integration is done. If only flat generations show up, the run is **incomplete** — go back to `4-nesting.md`.
+**Grade what lands in PostHog, not what the diff contains.** A correct-looking diff that produces ungrouped traces or a per-call session id is a failed run.
 
-## What to tell the user
+## What "correct" looks like for this app
+
+Derive the expectation from the two answers in `1-begin.md` before you look at anything:
 
-Point them at the smallest existing code path that exercises one of the request paths you instrumented in `4-nesting.md` — ideally one that makes more than one model call, so trace grouping is actually visible. Pick from what you noted in `1-begin.md`:
+- **One session** containing the traces that belong together — the cardinality you decided on. Two turns of one conversation means two traces under *one* `$ai_session_id`, not two ids.
+- **Each trace** holding the generations that request made, grouped rather than one trace per call.
+- **Spans only if the app registers tools** *and* the mechanism emits them (agent frameworks, Vercel AI, manual dispatch). On a raw provider SDK with an OTel instrumentor, a generations-only trace is the correct result even when the app uses tools — the instrumentor never sees the app's tool loop.
+- **Attribution** to the right person, if the app has a user identifier.
 
-- If the project has a script (`scripts/`, `bin/`, a `package.json` script) that calls the LLM, name it: "Run `npm run <script>` (or `python scripts/<file>.py`) to trigger one request."
-- If the LLM is called from an API route, name the route: "Hit `POST /api/chat` with a test message."
-- If the LLM lives inside a test, point at that test.
-- If there is no existing call path, sketch a minimal one — a short script that exercises one instrumented request path — but do not add it to the project unless the user asks. Include it in the report as suggested code.
+## What to tell the user
 
-## What they should see
+Point them at the smallest existing code path that exercises one of the instrumented paths — ideally one that makes more than one model call, so grouping is visible. Pick from what you noted in `1-begin.md`:
 
-After triggering one request:
+- A script (`scripts/`, `bin/`, a `package.json` script) → name it: "Run `npm run <script>`."
+- An API route → name it: "Hit `POST /api/chat` with a test message."
+- A test that exercises the call → point at that test.
+- Nothing existing → sketch a minimal script, but do not add it to the project unless the user asks. Include it in the report as suggested code.
 
-1. In PostHog, open **Product → LLM Analytics → Traces** (not just Generations).
-2. Open the newest trace. **One trace** should contain all the generations that request made — plus any spans you added — as children, not one trace per call.
-3. If the app has a conversation concept, trigger a second request in the same conversation: both traces should share the same `$ai_session_id`.
-4. If a distinct id was wired, the trace should be attributed to that person in Persons, not anonymous.
-5. Generation properties worth spot-checking: `$ai_provider`, `$ai_model`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`.
+Then, in PostHog: open **Product → LLM Analytics → Traces** (not Generations), open the newest trace, and check it against the expectation above. Triggering a second turn in the same conversation is what proves the session id groups rather than splits. Generation properties worth spot-checking: `$ai_provider`, `$ai_model`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`.
 
-**Before handing over: prove the imports run.** In the project's environment, import what the instrumentation uses (e.g. `python -c "from posthog.ai.otel import PostHogSpanProcessor"` or the wrapper import). If it fails — wrong package version, module not shipped in the installed release — go back to the gate in `4-nesting.md` and switch mechanisms. Do not ship non-running code with a caveat.
+**Before handing over: prove the imports run.** In the project's environment, import what the instrumentation uses (e.g. `python -c "from posthog.ai.otel import PostHogSpanProcessor"`). If it fails — wrong package version, module not shipped in the installed release — go back to `1-begin.md` and switch variants. Do not ship non-running code with a caveat.
 
-Failure modes and what they mean:
+## Failure modes
 
-- **Each generation is its own trace** → the enclosing span isn't wrapping the calls (OTel path), or calls aren't sharing a `posthog_trace_id` (wrapper path). Back to `4-nesting.md`.
-- **Generations appear but your non-LLM spans don't** → they were hand-authored OTel spans; ingest drops spans without provider-prefixed (`gen_ai.`/`ai.`/…) attribute keys — span names are never consulted. Emit them as `$ai_span` events via `posthog.capture()` instead.
-- **No `$ai_session_id` / anonymous person** → OTel path: the two Resource attributes (`posthog.distinct_id`, `$ai_session_id`) are missing from the bootstrap. Wrapper path: per-call params not passed.
+- **Each generation is its own trace** → the calls aren't sharing a trace: no enclosing call structure on the OTel path, or no shared `posthog_trace_id` on the wrapper path.
+- **Every trace has a different `$ai_session_id`** → the id is being minted per call or per request instead of per conversation. This is the most common silent failure; it looks instrumented and groups nothing.
+- **No `$ai_session_id` at all** → OTel path: missing from the Resource. Wrapper path: not passed per call.
+- **`$ai_provider` names the wrong provider** → the app uses an OpenAI-compatible gateway and the run picked `openai-*`. Back to the `baseURL` rule in `1-begin.md`.
+- **Anonymous person** → no distinct id wired.
+- **Tool spans missing** → check the mechanism first. On a raw SDK + instrumentor this is expected and correct; do not "fix" it by hand-authoring spans, which ingest drops anyway.
 
 If nothing shows up at all within a minute:
 
-- Confirm the OTel init actually runs — a `console.log` / `print` immediately after `sdk.start()` (or `.instrument()`) proves the entry point loaded it.
-- Confirm the vendor SDK was imported *after* the OTel init in the process's load order.
-- Confirm `POSTHOG_API_KEY` and `POSTHOG_HOST` were set in the env the process is actually running under, not just `.env.example`.
+- Confirm the init actually runs — a `print` / `console.log` right after it proves the entry point loaded it.
+- Confirm the vendor SDK was imported *after* the init in the process's load order.
+- Confirm `POSTHOG_API_KEY` and `POSTHOG_HOST` are set in the env the process actually runs under, not just `.env.example`.
 
 ## Do not
 
 - Do not run the vendor SDK yourself.
 - Do not embed API keys anywhere to enable a smoke test.
-- Do not report a run as done while an instrumentation import fails in the project's environment — switching mechanisms at the `4-nesting.md` gate is part of this skill, shipping the caveat is not.
-- Do not claim the integration works until the user has confirmed the **tree** — grouped trace, session (if applicable), attribution (if applicable). A confirmed flat generation is "bootstrap verified, nesting unverified", not done.
-- Do not claim the integration works until the user has confirmed anything at all. Report it as "wired, unverified" if you never got confirmation — the report step will surface that.
+- Do not report a run as done while an instrumentation import fails in the project's environment — switching variants is part of this skill, shipping the caveat is not.
+- Do not claim the integration works until the user has confirmed what actually landed. A confirmed flat generation is "bootstrap verified, structure unverified", not done.
+- Do not report "wired" as "working" — if you never got confirmation, say "wired, unverified" and let the report surface it.
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 00000000..82a54794
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,2815 @@
+{
+  "name": "@posthog/context-mill",
+  "version": "1.2.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@posthog/context-mill",
+      "version": "1.2.0",
+      "dependencies": {
+        "@anthropic-ai/sdk": "^0.95.0",
+        "@posthog/warlock": "^0.2.2",
+        "gray-matter": "^4.0.3",
+        "js-yaml": "^4.1.1"
+      },
+      "devDependencies": {
+        "archiver": "^7.0.1",
+        "chokidar": "^4.0.3",
+        "vitest": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=20.11.0"
+      }
+    },
+    "node_modules/@anthropic-ai/sdk": {
+      "version": "0.95.2",
+      "resolved": "https://registry.npmjs.org/@anthropic-ai/sdk/-/sdk-0.95.2.tgz",
+      "integrity": "sha512-Egddwo3sheo1PzUrMkZnH6VkQYwS0h/b/i8vSK8Ta9M45UQipAMeDFH57dYuDAfXMEUUGeKw6CMlremgMZgrSQ==",
+      "license": "MIT",
+      "dependencies": {
+        "json-schema-to-ts": "^3.1.1",
+        "standardwebhooks": "^1.0.0"
+      },
+      "bin": {
+        "anthropic-ai-sdk": "bin/cli"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.0 || ^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "zod": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@babel/runtime": {
+      "version": "7.29.7",
+      "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.7.tgz",
+      "integrity": "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.9.0"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
+      "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
+      "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
+      "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
+      "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
+      "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
+      "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
+      "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
+      "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
+      "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
+      "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
+      "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
+      "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
+      "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
+      "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
+      "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
+      "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
+      "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
+      "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
+      "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
+      "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
+      "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
+      "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
+      "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@isaacs/cliui": {
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
+      "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^5.1.2",
+        "string-width-cjs": "npm:string-width@^4.2.0",
+        "strip-ansi": "^7.0.1",
+        "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
+        "wrap-ansi": "^8.1.0",
+        "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@pkgjs/parseargs": {
+      "version": "0.11.0",
+      "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz",
+      "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@posthog/warlock": {
+      "version": "0.2.3",
+      "resolved": "https://registry.npmjs.org/@posthog/warlock/-/warlock-0.2.3.tgz",
+      "integrity": "sha512-ZlKWA8jU5IlPW5nZ40aE5/MYq/z3HeuKjLiTlH+OyffvDOQkQQ24nBNrMI4tLagGb2tkiNv5l9puAKlSllzWRw==",
+      "license": "MIT",
+      "dependencies": {
+        "@virustotal/yara-x": "^1.15.0"
+      },
+      "engines": {
+        "node": "^20.20.0 || >=22.22.0"
+      }
+    },
+    "node_modules/@rollup/rollup-android-arm-eabi": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.62.2.tgz",
+      "integrity": "sha512-6o7ZLZK+BeenkZCFNDXqpbjw9bD6nuWonvS/lwQJp7NoVVxm6p3qE7qQ5jGuBjiFsgvqjD8mZAU5oWxTmbOeOg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-android-arm64": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.62.2.tgz",
+      "integrity": "sha512-BaH7BllCACHoH1LguOU56UItGfUWjujlO65kS9LAodViaN4bwIKd7oeW/ZHJ/4ljr/7MIiENnNy3HJ0zXv8Zkw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.62.2.tgz",
+      "integrity": "sha512-v39RCCvj4He82I9sFmk+M1VZ0PLM9sfsLVikjfx2hYBNALhrrOR2D3JjQA6AhlaSOgcR+RzrKY7e1+bT6SUO/A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-x64": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.62.2.tgz",
+      "integrity": "sha512-yl0y2vq3S3lHeuXhEdss6TWfKW8vkujImO12tn4ZkG/4oghr09LvdYm2RElVjokTQiUvDUGXLGsYeLqUMCKpGA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-arm64": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.62.2.tgz",
+      "integrity": "sha512-tT4pvt4qXD+vEoezupCWi+a1F0vvDiksiHc+PxRlYTOH1I6/X4id9jPxTP+Fg+545euaFT1jJVs4CEdHZAU1vw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-x64": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.62.2.tgz",
+      "integrity": "sha512-6nU5F2wCW+qvCBhTn1pdIU3bzsIoF7EUwsCDRxilWGprQR6yd508YnH9+OKFCwpfS8pjZqDUmnCAr7exax0XCg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.62.2.tgz",
+      "integrity": "sha512-n1GJHPOvpIfhi3TmrCeh6S6URt9BFCt0KQE3qvexyGCTAKpR4Lg+eWvNZEqu7epxwus/8ElT3hacYEucm49SZg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.62.2.tgz",
+      "integrity": "sha512-JqgflS8wEB+UXV/vS1RpRbifGBeN4D5lz8D8oOFbFZw4vedvdOgCFAjfBmIMdW3yL10XpQQ0Ambepw6MXrhOnA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-gnu": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.62.2.tgz",
+      "integrity": "sha512-wnFJkogWvN4jm/hQRF2UBaeUmk20j5+DmHvoyWii2b8HJDyvz1MF2OU/6ynXt2KR63rbZLWkFpoytpdc/yBuSA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-musl": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.62.2.tgz",
+      "integrity": "sha512-HVu2bp0zhvJ8xHEV9+UUs7S90VadmBSY3LcIMvozbPo4AuMGDWlz3ymHLHZPX4hR67TKTt8Qp5PJ5RBg/i+RMQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-gnu": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.62.2.tgz",
+      "integrity": "sha512-mQqqAV8QaoSgr9I2fKDLY2BAVvmKjWoGiu/cSYQonsLvtqwEn1E4QYfnCOcp5zoEqNhsDYin1s6jx/VJmrxlZg==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loong64-musl": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.62.2.tgz",
+      "integrity": "sha512-IxKLoxCQ2IWi6bT2akyDUBGsOImDKB+sPp4EsTmwFQ/fMwpCKm8uLSSgP/Kx/QYUgKis6SEZ5/Nlhup0DIA0PQ==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.62.2.tgz",
+      "integrity": "sha512-Mk5ha2RQSgyFfmYYLkBpPnUk8D8FriBxesO1u9O75X0mHgXL1UQcH5Itl2lurWL2tj0RxV9b9tJgipac0hRY9A==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-ppc64-musl": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.62.2.tgz",
+      "integrity": "sha512-CjvEnqJL/0/TQ3TXX3OPIJ/kmBellrWd4heXUmHeJlTnmwjKpSJzoehLaL6Xk0ZnMHBu9dZuFADNOrtjF4v+2w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.62.2.tgz",
+      "integrity": "sha512-1SiZbzwdkaDURsew/tSOrooKiYy7EQGT6m8ufavAi9NEyQb/6VuIxFXAL1fqa4iZe3g4NbNk4P7J32z2tw5Mgg==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-musl": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.62.2.tgz",
+      "integrity": "sha512-nQts12zJ3NQRoE6uYljOH89v7szzLDvG2JD/vsX+vGXU8w/At1GowTZ5/7qeFQ8m7L55rpR8Okugnuo5bgjy2Q==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-s390x-gnu": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.62.2.tgz",
+      "integrity": "sha512-E9/ll019jhPIJgpzfZoIkBGhcz+kKNgVWYRY0zr9srBdPPFVpvOKW8VaJKUbeK+eZXyQF9ltME+Kk6affeaPgg==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-gnu": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.62.2.tgz",
+      "integrity": "sha512-5BqxR/pshjey51iliyzTD5Xi3EN0aLmQ2lZ3lvefVV9c82BvrLo2/6OT55iifpWBufs6kdwWbuOKS841DrmK9A==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "libc": [
+        "glibc"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-musl": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.62.2.tgz",
+      "integrity": "sha512-uNN83XxQrRAh/w0/pmAfibcwyb6YWt4gP+dpnQKPVJshAloQ785ii8CT8ZCIxkGg9opVsvAlGhFitSm6D1Jjpg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "libc": [
+        "musl"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-openbsd-x64": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.62.2.tgz",
+      "integrity": "sha512-srjEIxSH3LRnJN6THczDHWQplqEMFiAJrTab0msUryh9kwNpkICf3Ea6q6MN/2cZwRFUNx5w+h6Hpi4QuHS6Zg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-openharmony-arm64": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.62.2.tgz",
+      "integrity": "sha512-8hOJnxgbyObnCm5AlRA3A931xX19xq80RjVTKgJOvEKWqJruP/Uf12IbAOaDjjEXYRewwHLfmF0YRIdK3OwKWA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-arm64-msvc": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.62.2.tgz",
+      "integrity": "sha512-mmF4AY1i0hG/bLWUctUq59gtmgaSIRa3cu/A3JFRp/sCNEme2bgDEiDS22P9FbnJB8NJNF4jPJiSP5RHQpUTDg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-ia32-msvc": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.62.2.tgz",
+      "integrity": "sha512-DZgkknc6jhHrk46V25vbAM0zZkyP0nSDkJB8/dRkLTxv470dOmWDqGoEJl/9A0dFfS7yE3REOwNDxpHwSLSt0Q==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-gnu": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.62.2.tgz",
+      "integrity": "sha512-T6xr6ucWSFto+VGajA8YH26LdpHRuP4YLHEKAtCWvJDOlnmWcDZVCI2Jmjr+IFHDlt2zRaTAKE4tfjTaWLgJBg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-msvc": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.62.2.tgz",
+      "integrity": "sha512-BfzEnDJOt9T8M989/lA37EcJgat01wLRnoi5dQf3QzOH7jzpqTAzdDbVfRljVr5r+jzKqpbHeyOfAaXxAd0PAA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@stablelib/base64": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/@stablelib/base64/-/base64-1.0.1.tgz",
+      "integrity": "sha512-1bnPQqSxSuc3Ii6MhBysoWCg58j97aUjuCSZrGSmDxNqtytIi0k8utUenAwTZN4V5mXXYGsVUI9zeBqy+jBOSQ==",
+      "license": "MIT"
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",
+      "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@virustotal/yara-x": {
+      "version": "1.19.0",
+      "resolved": "https://registry.npmjs.org/@virustotal/yara-x/-/yara-x-1.19.0.tgz",
+      "integrity": "sha512-yCVb8hLVYB6Yb6uFLmndDZL12/O1C28knNFSzarmKupMt+dLQwr5FjsA26mBDY0bBbPT6GkUGMe2bzXIVNM/oQ==",
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/@vitest/expect": {
+      "version": "2.1.9",
+      "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-2.1.9.tgz",
+      "integrity": "sha512-UJCIkTBenHeKT1TTlKMJWy1laZewsRIzYighyYiJKZreqtdxSos/S1t+ktRMQWu2CKqaarrkeszJx1cgC5tGZw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/spy": "2.1.9",
+        "@vitest/utils": "2.1.9",
+        "chai": "^5.1.2",
+        "tinyrainbow": "^1.2.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/mocker": {
+      "version": "2.1.9",
+      "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-2.1.9.tgz",
+      "integrity": "sha512-tVL6uJgoUdi6icpxmdrn5YNo3g3Dxv+IHJBr0GXHaEdTcw3F+cPKnsXFhli6nO+f/6SDKPHEK1UN+k+TQv0Ehg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/spy": "2.1.9",
+        "estree-walker": "^3.0.3",
+        "magic-string": "^0.30.12"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      },
+      "peerDependencies": {
+        "msw": "^2.4.9",
+        "vite": "^5.0.0"
+      },
+      "peerDependenciesMeta": {
+        "msw": {
+          "optional": true
+        },
+        "vite": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@vitest/pretty-format": {
+      "version": "2.1.9",
+      "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-2.1.9.tgz",
+      "integrity": "sha512-KhRIdGV2U9HOUzxfiHmY8IFHTdqtOhIzCpd8WRdJiE7D/HUcZVD0EgQCVjm+Q9gkUXWgBvMmTtZgIG48wq7sOQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tinyrainbow": "^1.2.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/runner": {
+      "version": "2.1.9",
+      "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-2.1.9.tgz",
+      "integrity": "sha512-ZXSSqTFIrzduD63btIfEyOmNcBmQvgOVsPNPe0jYtESiXkhd8u2erDLnMxmGrDCwHCCHE7hxwRDCT3pt0esT4g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/utils": "2.1.9",
+        "pathe": "^1.1.2"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/snapshot": {
+      "version": "2.1.9",
+      "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-2.1.9.tgz",
+      "integrity": "sha512-oBO82rEjsxLNJincVhLhaxxZdEtV0EFHMK5Kmx5sJ6H9L183dHECjiefOAdnqpIgT5eZwT04PoggUnW88vOBNQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/pretty-format": "2.1.9",
+        "magic-string": "^0.30.12",
+        "pathe": "^1.1.2"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/spy": {
+      "version": "2.1.9",
+      "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-2.1.9.tgz",
+      "integrity": "sha512-E1B35FwzXXTs9FHNK6bDszs7mtydNi5MIfUWpceJ8Xbfb1gBMscAnwLbEu+B44ed6W3XjL9/ehLPHR1fkf1KLQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tinyspy": "^3.0.2"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/@vitest/utils": {
+      "version": "2.1.9",
+      "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-2.1.9.tgz",
+      "integrity": "sha512-v0psaMSkNJ3A2NMrUEHFRzJtDPFn+/VWZ5WxImB21T9fjucJRmS7xCS3ppEnARb9y11OAzaD+P2Ps+b+BGX5iQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/pretty-format": "2.1.9",
+        "loupe": "^3.1.2",
+        "tinyrainbow": "^1.2.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/abort-controller": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/abort-controller/-/abort-controller-3.0.0.tgz",
+      "integrity": "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "event-target-shim": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=6.5"
+      }
+    },
+    "node_modules/ansi-regex": {
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz",
+      "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "6.2.3",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
+      "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/archiver": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/archiver/-/archiver-7.0.1.tgz",
+      "integrity": "sha512-ZcbTaIqJOfCc03QwD468Unz/5Ir8ATtvAHsK+FdXbDIbGfihqh9mrvdcYunQzqn4HrvWWaFyaxJhGZagaJJpPQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "archiver-utils": "^5.0.2",
+        "async": "^3.2.4",
+        "buffer-crc32": "^1.0.0",
+        "readable-stream": "^4.0.0",
+        "readdir-glob": "^1.1.2",
+        "tar-stream": "^3.0.0",
+        "zip-stream": "^6.0.1"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/archiver-utils": {
+      "version": "5.0.2",
+      "resolved": "https://registry.npmjs.org/archiver-utils/-/archiver-utils-5.0.2.tgz",
+      "integrity": "sha512-wuLJMmIBQYCsGZgYLTy5FIB2pF6Lfb6cXMSF8Qywwk3t20zWnAi7zLcQFdKQmIB8wyZpY5ER38x08GbwtR2cLA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "glob": "^10.0.0",
+        "graceful-fs": "^4.2.0",
+        "is-stream": "^2.0.1",
+        "lazystream": "^1.0.0",
+        "lodash": "^4.17.15",
+        "normalize-path": "^3.0.0",
+        "readable-stream": "^4.0.0"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/argparse": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
+      "license": "Python-2.0"
+    },
+    "node_modules/assertion-error": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz",
+      "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/async": {
+      "version": "3.2.6",
+      "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz",
+      "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/b4a": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/b4a/-/b4a-1.8.1.tgz",
+      "integrity": "sha512-aiqre1Nr0B/6DgE2N5vwTc+2/oQZ4Wh1t4NznYY4E00y8LCt6NqdRv81so00oo27D8MVKTpUa/MwUUtBLXCoDw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "peerDependencies": {
+        "react-native-b4a": "*"
+      },
+      "peerDependenciesMeta": {
+        "react-native-b4a": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/bare-events": {
+      "version": "2.9.1",
+      "resolved": "https://registry.npmjs.org/bare-events/-/bare-events-2.9.1.tgz",
+      "integrity": "sha512-Z0oHEHAFDZkffN8Qc39zNZjQlMDkPJRyyyZieU1VH7u8c5S+qHZ2S8ixdKIAxEjfHO7FJxXmJWgteOghVanIsg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "peerDependencies": {
+        "bare-abort-controller": "*"
+      },
+      "peerDependenciesMeta": {
+        "bare-abort-controller": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/bare-fs": {
+      "version": "4.7.4",
+      "resolved": "https://registry.npmjs.org/bare-fs/-/bare-fs-4.7.4.tgz",
+      "integrity": "sha512-y1kC+ffIx/tPLdTE693uNjHfzTfr+ravR5tvWlMXe25nELbkqV400S71qHDwbkAQ1FVEZobB1NFRzFbCCcyBCQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "bare-events": "^2.5.4",
+        "bare-path": "^3.0.0",
+        "bare-stream": "^2.6.4",
+        "bare-url": "^2.2.2",
+        "fast-fifo": "^1.3.2"
+      },
+      "engines": {
+        "bare": ">=1.16.0"
+      },
+      "peerDependencies": {
+        "bare-buffer": "*"
+      },
+      "peerDependenciesMeta": {
+        "bare-buffer": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/bare-path": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/bare-path/-/bare-path-3.1.1.tgz",
+      "integrity": "sha512-JprUlveX3QjApC1cTpsUOiscADftCGVWkzitbHsRqv84hzYwYHw2mbluddsq5TvI8mH/8Ov1f4BiMAdcB0oYnQ==",
+      "dev": true,
+      "license": "Apache-2.0"
+    },
+    "node_modules/bare-stream": {
+      "version": "2.13.3",
+      "resolved": "https://registry.npmjs.org/bare-stream/-/bare-stream-2.13.3.tgz",
+      "integrity": "sha512-Kc+brLqvEqGkjyfiwJmImAOqLZL7OsoLKuavx+hJjgVV3nLTOjloJyPMFxjUPerGGHrNH0fLU06jjykMLWrERQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "b4a": "^1.8.1",
+        "streamx": "^2.25.0",
+        "teex": "^1.0.1"
+      },
+      "peerDependencies": {
+        "bare-abort-controller": "*",
+        "bare-buffer": "*",
+        "bare-events": "*"
+      },
+      "peerDependenciesMeta": {
+        "bare-abort-controller": {
+          "optional": true
+        },
+        "bare-buffer": {
+          "optional": true
+        },
+        "bare-events": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/bare-url": {
+      "version": "2.4.6",
+      "resolved": "https://registry.npmjs.org/bare-url/-/bare-url-2.4.6.tgz",
+      "integrity": "sha512-iQxPClE07hETVpbRoX7JXX3v/ZQViCxe/SYCxylRLzdEx1xJAufPptfiOqR8tqiCtmbtMDANKWszzjLu1PMAZQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "bare-path": "^3.0.0"
+      }
+    },
+    "node_modules/base64-js": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/brace-expansion": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.2.tgz",
+      "integrity": "sha512-w5JZcKgdhDOgOwm8H+KgbosopHMuGcl6qbulwjtz3SM7I7P3yW1eAjzMPLrIE+NQ9vjgANKHWeMHnrT0OXW1oA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/buffer": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz",
+      "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "base64-js": "^1.3.1",
+        "ieee754": "^1.2.1"
+      }
+    },
+    "node_modules/buffer-crc32": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-1.0.0.tgz",
+      "integrity": "sha512-Db1SbgBS/fg/392AblrMJk97KggmvYhr4pB5ZIMTWtaivCPMWLkmb7m21cJvpvgK+J3nsU2CmmixNBZx4vFj/w==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/cac": {
+      "version": "6.7.14",
+      "resolved": "https://registry.npmjs.org/cac/-/cac-6.7.14.tgz",
+      "integrity": "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/chai": {
+      "version": "5.3.3",
+      "resolved": "https://registry.npmjs.org/chai/-/chai-5.3.3.tgz",
+      "integrity": "sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "assertion-error": "^2.0.1",
+        "check-error": "^2.1.1",
+        "deep-eql": "^5.0.1",
+        "loupe": "^3.1.0",
+        "pathval": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/check-error": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/check-error/-/check-error-2.1.3.tgz",
+      "integrity": "sha512-PAJdDJusoxnwm1VwW07VWwUN1sl7smmC3OKggvndJFadxxDRyFJBX/ggnu/KE4kQAB7a3Dp8f/YXC1FlUprWmA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 16"
+      }
+    },
+    "node_modules/chokidar": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.3.tgz",
+      "integrity": "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "readdirp": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 14.16.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/compress-commons": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/compress-commons/-/compress-commons-6.0.2.tgz",
+      "integrity": "sha512-6FqVXeETqWPoGcfzrXb37E50NP0LXT8kAMu5ooZayhWWdgEY4lBEEcbQNXtkuKQsGduxiIcI4gOTsxTmuq/bSg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "crc-32": "^1.2.0",
+        "crc32-stream": "^6.0.0",
+        "is-stream": "^2.0.1",
+        "normalize-path": "^3.0.0",
+        "readable-stream": "^4.0.0"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/core-util-is": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
+      "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/crc-32": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/crc-32/-/crc-32-1.2.2.tgz",
+      "integrity": "sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "crc32": "bin/crc32.njs"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/crc32-stream": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/crc32-stream/-/crc32-stream-6.0.0.tgz",
+      "integrity": "sha512-piICUB6ei4IlTv1+653yq5+KoqfBYmj9bw6LqXoOneTMDXk5nM1qt12mFW1caG3LlJXEKW1Bp0WggEmIfQB34g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "crc-32": "^1.2.0",
+        "readable-stream": "^4.0.0"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/deep-eql": {
+      "version": "5.0.2",
+      "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-5.0.2.tgz",
+      "integrity": "sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/eastasianwidth": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
+      "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/emoji-regex": {
+      "version": "9.2.2",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
+      "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/es-module-lexer": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.7.0.tgz",
+      "integrity": "sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/esbuild": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
+      "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.21.5",
+        "@esbuild/android-arm": "0.21.5",
+        "@esbuild/android-arm64": "0.21.5",
+        "@esbuild/android-x64": "0.21.5",
+        "@esbuild/darwin-arm64": "0.21.5",
+        "@esbuild/darwin-x64": "0.21.5",
+        "@esbuild/freebsd-arm64": "0.21.5",
+        "@esbuild/freebsd-x64": "0.21.5",
+        "@esbuild/linux-arm": "0.21.5",
+        "@esbuild/linux-arm64": "0.21.5",
+        "@esbuild/linux-ia32": "0.21.5",
+        "@esbuild/linux-loong64": "0.21.5",
+        "@esbuild/linux-mips64el": "0.21.5",
+        "@esbuild/linux-ppc64": "0.21.5",
+        "@esbuild/linux-riscv64": "0.21.5",
+        "@esbuild/linux-s390x": "0.21.5",
+        "@esbuild/linux-x64": "0.21.5",
+        "@esbuild/netbsd-x64": "0.21.5",
+        "@esbuild/openbsd-x64": "0.21.5",
+        "@esbuild/sunos-x64": "0.21.5",
+        "@esbuild/win32-arm64": "0.21.5",
+        "@esbuild/win32-ia32": "0.21.5",
+        "@esbuild/win32-x64": "0.21.5"
+      }
+    },
+    "node_modules/esprima": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
+      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
+      "license": "BSD-2-Clause",
+      "bin": {
+        "esparse": "bin/esparse.js",
+        "esvalidate": "bin/esvalidate.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/estree-walker": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+      "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "^1.0.0"
+      }
+    },
+    "node_modules/event-target-shim": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/event-target-shim/-/event-target-shim-5.0.1.tgz",
+      "integrity": "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/events": {
+      "version": "3.3.0",
+      "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz",
+      "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.8.x"
+      }
+    },
+    "node_modules/events-universal": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/events-universal/-/events-universal-1.0.1.tgz",
+      "integrity": "sha512-LUd5euvbMLpwOF8m6ivPCbhQeSiYVNb8Vs0fQ8QjXo0JTkEHpz8pxdQf0gStltaPpw0Cca8b39KxvK9cfKRiAw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "bare-events": "^2.7.0"
+      }
+    },
+    "node_modules/expect-type": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.4.0.tgz",
+      "integrity": "sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=12.0.0"
+      }
+    },
+    "node_modules/extend-shallow": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+      "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==",
+      "license": "MIT",
+      "dependencies": {
+        "is-extendable": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/fast-fifo": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/fast-fifo/-/fast-fifo-1.3.2.tgz",
+      "integrity": "sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fast-sha256": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/fast-sha256/-/fast-sha256-1.3.0.tgz",
+      "integrity": "sha512-n11RGP/lrWEFI/bWdygLxhI+pVeo1ZYIVwvvPkW7azl/rOy+F3HYRZ2K5zeE9mmkhQppyv9sQFx0JM9UabnpPQ==",
+      "license": "Unlicense"
+    },
+    "node_modules/foreground-child": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz",
+      "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "cross-spawn": "^7.0.6",
+        "signal-exit": "^4.0.1"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/glob": {
+      "version": "10.5.0",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-10.5.0.tgz",
+      "integrity": "sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==",
+      "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "foreground-child": "^3.1.0",
+        "jackspeak": "^3.1.2",
+        "minimatch": "^9.0.4",
+        "minipass": "^7.1.2",
+        "package-json-from-dist": "^1.0.0",
+        "path-scurry": "^1.11.1"
+      },
+      "bin": {
+        "glob": "dist/esm/bin.mjs"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/graceful-fs": {
+      "version": "4.2.11",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/gray-matter": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/gray-matter/-/gray-matter-4.0.3.tgz",
+      "integrity": "sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==",
+      "license": "MIT",
+      "dependencies": {
+        "js-yaml": "^3.13.1",
+        "kind-of": "^6.0.2",
+        "section-matter": "^1.0.0",
+        "strip-bom-string": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=6.0"
+      }
+    },
+    "node_modules/gray-matter/node_modules/argparse": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+      "license": "MIT",
+      "dependencies": {
+        "sprintf-js": "~1.0.2"
+      }
+    },
+    "node_modules/gray-matter/node_modules/js-yaml": {
+      "version": "3.15.0",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.15.0.tgz",
+      "integrity": "sha512-ttBQIIQPDeLjpPOohtUdXuXUVoA2uIB6fEH9HyJ7234s5mBJ5wTx20njxplLZQgLaOfpmPQA7X2t5AX6tIPbog==",
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^1.0.7",
+        "esprima": "^4.0.0"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/is-extendable": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz",
+      "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-stream": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
+      "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/isarray": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+      "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/jackspeak": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz",
+      "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "@isaacs/cliui": "^8.0.2"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      },
+      "optionalDependencies": {
+        "@pkgjs/parseargs": "^0.11.0"
+      }
+    },
+    "node_modules/js-yaml": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.0.tgz",
+      "integrity": "sha512-1td788aAnnZ5qs7V2QIRl1owjtYpbKt749Y3xauqQgwIIGF/xXWz1wMTEBx5O3LK3lXLVuqXPdPxj2BoFHaW9Q==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/puzrin"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/nodeca"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^2.0.1"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/json-schema-to-ts": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/json-schema-to-ts/-/json-schema-to-ts-3.1.1.tgz",
+      "integrity": "sha512-+DWg8jCJG2TEnpy7kOm/7/AxaYoaRbjVB4LFZLySZlWn8exGs3A4OLJR966cVvU26N7X9TWxl+Jsw7dzAqKT6g==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.18.3",
+        "ts-algebra": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/kind-of": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
+      "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/lazystream": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/lazystream/-/lazystream-1.0.1.tgz",
+      "integrity": "sha512-b94GiNHQNy6JNTrt5w6zNyffMrNkXZb3KTkCZJb2V1xaEGCk093vkZ2jk3tpaeP33/OiXC+WvK9AxUebnf5nbw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "readable-stream": "^2.0.5"
+      },
+      "engines": {
+        "node": ">= 0.6.3"
+      }
+    },
+    "node_modules/lazystream/node_modules/readable-stream": {
+      "version": "2.3.8",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
+      "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "core-util-is": "~1.0.0",
+        "inherits": "~2.0.3",
+        "isarray": "~1.0.0",
+        "process-nextick-args": "~2.0.0",
+        "safe-buffer": "~5.1.1",
+        "string_decoder": "~1.1.1",
+        "util-deprecate": "~1.0.1"
+      }
+    },
+    "node_modules/lazystream/node_modules/safe-buffer": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
+      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lazystream/node_modules/string_decoder": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
+      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.1.0"
+      }
+    },
+    "node_modules/lodash": {
+      "version": "4.18.1",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
+      "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/loupe": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/loupe/-/loupe-3.2.1.tgz",
+      "integrity": "sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lru-cache": {
+      "version": "10.4.3",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
+      "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/magic-string": {
+      "version": "0.30.21",
+      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+      "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@jridgewell/sourcemap-codec": "^1.5.5"
+      }
+    },
+    "node_modules/minimatch": {
+      "version": "9.0.9",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.9.tgz",
+      "integrity": "sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.2"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/minipass": {
+      "version": "7.1.3",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",
+      "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.16",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.16.tgz",
+      "integrity": "sha512-bzlKTyNJ7+LdGIIwy8ijFpIqEQIvafahV7eYykJ8Cvh42EdJeODoJ6gUJXpQJvej1BddH8OqTXZNE/KfbWAu8Q==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/normalize-path": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
+      "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/package-json-from-dist": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
+      "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0"
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-scurry": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz",
+      "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "lru-cache": "^10.2.0",
+        "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/pathe": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/pathe/-/pathe-1.1.2.tgz",
+      "integrity": "sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/pathval": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/pathval/-/pathval-2.0.1.tgz",
+      "integrity": "sha512-//nshmD55c46FuFw26xV/xFAaB5HF9Xdap7HJBBnrKdAd6/GxDBaNA1870O79+9ueg61cZLSVc+OaFlfmObYVQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14.16"
+      }
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/postcss": {
+      "version": "8.5.22",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.22.tgz",
+      "integrity": "sha512-KBDEIpLrvpv16pp3K0Fw+UCoZfopFjjgeB+0tA/aaThfEE74kKDLrgg603YvOWJyg3+WYtyq3xYsQWsIyZlPqQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "nanoid": "^3.3.16",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/process": {
+      "version": "0.11.10",
+      "resolved": "https://registry.npmjs.org/process/-/process-0.11.10.tgz",
+      "integrity": "sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6.0"
+      }
+    },
+    "node_modules/process-nextick-args": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
+      "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/readable-stream": {
+      "version": "4.7.0",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-4.7.0.tgz",
+      "integrity": "sha512-oIGGmcpTLwPga8Bn6/Z75SVaH1z5dUut2ibSyAMVhmUggWpmDn2dapB0n7f8nwaSiRtepAsfJyfXIO5DCVAODg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "abort-controller": "^3.0.0",
+        "buffer": "^6.0.3",
+        "events": "^3.3.0",
+        "process": "^0.11.10",
+        "string_decoder": "^1.3.0"
+      },
+      "engines": {
+        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
+      }
+    },
+    "node_modules/readdir-glob": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/readdir-glob/-/readdir-glob-1.1.3.tgz",
+      "integrity": "sha512-v05I2k7xN8zXvPD9N+z/uhXPaj0sUFCe2rcWZIpBsqxfP7xXFQ0tipAd/wjj1YxWyWtUS5IDJpOG82JKt2EAVA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "minimatch": "^5.1.0"
+      }
+    },
+    "node_modules/readdir-glob/node_modules/minimatch": {
+      "version": "5.1.9",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz",
+      "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/readdirp": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.1.2.tgz",
+      "integrity": "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14.18.0"
+      },
+      "funding": {
+        "type": "individual",
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.62.2",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.62.2.tgz",
+      "integrity": "sha512-RFnrW4lhXA3s3eqHDZvN654g8OTjzRfqpIRJYczCGB6HzphckVAi/Qh4tbPUbRuDi7s1Llv8g/NspLkttY3gTA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/estree": "1.0.9"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@rollup/rollup-android-arm-eabi": "4.62.2",
+        "@rollup/rollup-android-arm64": "4.62.2",
+        "@rollup/rollup-darwin-arm64": "4.62.2",
+        "@rollup/rollup-darwin-x64": "4.62.2",
+        "@rollup/rollup-freebsd-arm64": "4.62.2",
+        "@rollup/rollup-freebsd-x64": "4.62.2",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.62.2",
+        "@rollup/rollup-linux-arm-musleabihf": "4.62.2",
+        "@rollup/rollup-linux-arm64-gnu": "4.62.2",
+        "@rollup/rollup-linux-arm64-musl": "4.62.2",
+        "@rollup/rollup-linux-loong64-gnu": "4.62.2",
+        "@rollup/rollup-linux-loong64-musl": "4.62.2",
+        "@rollup/rollup-linux-ppc64-gnu": "4.62.2",
+        "@rollup/rollup-linux-ppc64-musl": "4.62.2",
+        "@rollup/rollup-linux-riscv64-gnu": "4.62.2",
+        "@rollup/rollup-linux-riscv64-musl": "4.62.2",
+        "@rollup/rollup-linux-s390x-gnu": "4.62.2",
+        "@rollup/rollup-linux-x64-gnu": "4.62.2",
+        "@rollup/rollup-linux-x64-musl": "4.62.2",
+        "@rollup/rollup-openbsd-x64": "4.62.2",
+        "@rollup/rollup-openharmony-arm64": "4.62.2",
+        "@rollup/rollup-win32-arm64-msvc": "4.62.2",
+        "@rollup/rollup-win32-ia32-msvc": "4.62.2",
+        "@rollup/rollup-win32-x64-gnu": "4.62.2",
+        "@rollup/rollup-win32-x64-msvc": "4.62.2",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/section-matter": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/section-matter/-/section-matter-1.0.0.tgz",
+      "integrity": "sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA==",
+      "license": "MIT",
+      "dependencies": {
+        "extend-shallow": "^2.0.1",
+        "kind-of": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/siginfo": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz",
+      "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/signal-exit": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/sprintf-js": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
+      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/stackback": {
+      "version": "0.0.2",
+      "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz",
+      "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/standardwebhooks": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/standardwebhooks/-/standardwebhooks-1.0.0.tgz",
+      "integrity": "sha512-BbHGOQK9olHPMvQNHWul6MYlrRTAOKn03rOe4A8O3CLWhNf4YHBqq2HJKKC+sfqpxiBY52pNeesD6jIiLDz8jg==",
+      "license": "MIT",
+      "dependencies": {
+        "@stablelib/base64": "^1.0.0",
+        "fast-sha256": "^1.3.0"
+      }
+    },
+    "node_modules/std-env": {
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.10.0.tgz",
+      "integrity": "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/streamx": {
+      "version": "2.28.0",
+      "resolved": "https://registry.npmjs.org/streamx/-/streamx-2.28.0.tgz",
+      "integrity": "sha512-1Yowhzjf0ivGMrTIkY9hav5TxobO9qIVqUE41fiCGMGgc3CLlf4MY+9AHmZqBWgDTue0fY9zWjYFVyf6Diuobw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "events-universal": "^1.0.0",
+        "fast-fifo": "^1.3.2",
+        "text-decoder": "^1.1.0"
+      }
+    },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
+    "node_modules/string-width": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
+      "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "eastasianwidth": "^0.2.0",
+        "emoji-regex": "^9.2.2",
+        "strip-ansi": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/string-width-cjs": {
+      "name": "string-width",
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/string-width-cjs/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/string-width-cjs/node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/string-width-cjs/node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz",
+      "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^6.2.2"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
+    "node_modules/strip-ansi-cjs": {
+      "name": "strip-ansi",
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi-cjs/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-bom-string": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/strip-bom-string/-/strip-bom-string-1.0.0.tgz",
+      "integrity": "sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/tar-stream": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-3.2.0.tgz",
+      "integrity": "sha512-ojzvCvVaNp6aOTFmG7jaRD0meowIAuPc3cMMhSgKiVWws1GyHbGd/xvnyuRKcKlMpt3qvxx6r0hreCNITP9hIg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "b4a": "^1.6.4",
+        "bare-fs": "^4.5.5",
+        "fast-fifo": "^1.2.0",
+        "streamx": "^2.15.0"
+      }
+    },
+    "node_modules/teex": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/teex/-/teex-1.0.1.tgz",
+      "integrity": "sha512-eYE6iEI62Ni1H8oIa7KlDU6uQBtqr4Eajni3wX7rpfXD8ysFx8z0+dri+KWEPWpBsxXfxu58x/0jvTVT1ekOSg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "streamx": "^2.12.5"
+      }
+    },
+    "node_modules/text-decoder": {
+      "version": "1.2.7",
+      "resolved": "https://registry.npmjs.org/text-decoder/-/text-decoder-1.2.7.tgz",
+      "integrity": "sha512-vlLytXkeP4xvEq2otHeJfSQIRyWxo/oZGEbXrtEEF9Hnmrdly59sUbzZ/QgyWuLYHctCHxFF4tRQZNQ9k60ExQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "b4a": "^1.6.4"
+      }
+    },
+    "node_modules/tinybench": {
+      "version": "2.9.0",
+      "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz",
+      "integrity": "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/tinyexec": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-0.3.2.tgz",
+      "integrity": "sha512-KQQR9yN7R5+OSwaK0XQoj22pwHoTlgYqmUscPYoknOoWCWfj/5/ABTMRi69FrKU5ffPVh5QcFikpWJI/P1ocHA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/tinypool": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/tinypool/-/tinypool-1.1.1.tgz",
+      "integrity": "sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^18.0.0 || >=20.0.0"
+      }
+    },
+    "node_modules/tinyrainbow": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-1.2.0.tgz",
+      "integrity": "sha512-weEDEq7Z5eTHPDh4xjX789+fHfF+P8boiFB+0vbWzpbnbsEr/GRaohi/uMKxg8RZMXnl1ItAi/IUHWMsjDV7kQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/tinyspy": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/tinyspy/-/tinyspy-3.0.2.tgz",
+      "integrity": "sha512-n1cw8k1k0x4pgA2+9XrOkFydTerNcJ1zWCO5Nn9scWHTD+5tp8dghT2x1uduQePZTZgd3Tupf+x9BxJjeJi77Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/ts-algebra": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ts-algebra/-/ts-algebra-2.0.0.tgz",
+      "integrity": "sha512-FPAhNPFMrkwz76P7cdjdmiShwMynZYN6SgOujD1urY4oNm80Ou9oMdmbR45LotcKOXoy7wSmHkRFE6Mxbrhefw==",
+      "license": "MIT"
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/vite": {
+      "version": "5.4.21",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.21.tgz",
+      "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "^0.21.3",
+        "postcss": "^8.4.43",
+        "rollup": "^4.20.0"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^18.0.0 || >=20.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^18.0.0 || >=20.0.0",
+        "less": "*",
+        "lightningcss": "^1.21.0",
+        "sass": "*",
+        "sass-embedded": "*",
+        "stylus": "*",
+        "sugarss": "*",
+        "terser": "^5.4.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/vite-node": {
+      "version": "2.1.9",
+      "resolved": "https://registry.npmjs.org/vite-node/-/vite-node-2.1.9.tgz",
+      "integrity": "sha512-AM9aQ/IPrW/6ENLQg3AGY4K1N2TGZdR5e4gu/MmmR2xR3Ll1+dib+nook92g4TV3PXVyeyxdWwtaCAiUL0hMxA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cac": "^6.7.14",
+        "debug": "^4.3.7",
+        "es-module-lexer": "^1.5.4",
+        "pathe": "^1.1.2",
+        "vite": "^5.0.0"
+      },
+      "bin": {
+        "vite-node": "vite-node.mjs"
+      },
+      "engines": {
+        "node": "^18.0.0 || >=20.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      }
+    },
+    "node_modules/vitest": {
+      "version": "2.1.9",
+      "resolved": "https://registry.npmjs.org/vitest/-/vitest-2.1.9.tgz",
+      "integrity": "sha512-MSmPM9REYqDGBI8439mA4mWhV5sKmDlBKWIYbA3lRb2PTHACE0mgKwA8yQ2xq9vxDTuk4iPrECBAEW2aoFXY0Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@vitest/expect": "2.1.9",
+        "@vitest/mocker": "2.1.9",
+        "@vitest/pretty-format": "^2.1.9",
+        "@vitest/runner": "2.1.9",
+        "@vitest/snapshot": "2.1.9",
+        "@vitest/spy": "2.1.9",
+        "@vitest/utils": "2.1.9",
+        "chai": "^5.1.2",
+        "debug": "^4.3.7",
+        "expect-type": "^1.1.0",
+        "magic-string": "^0.30.12",
+        "pathe": "^1.1.2",
+        "std-env": "^3.8.0",
+        "tinybench": "^2.9.0",
+        "tinyexec": "^0.3.1",
+        "tinypool": "^1.0.1",
+        "tinyrainbow": "^1.2.0",
+        "vite": "^5.0.0",
+        "vite-node": "2.1.9",
+        "why-is-node-running": "^2.3.0"
+      },
+      "bin": {
+        "vitest": "vitest.mjs"
+      },
+      "engines": {
+        "node": "^18.0.0 || >=20.0.0"
+      },
+      "funding": {
+        "url": "https://opencollective.com/vitest"
+      },
+      "peerDependencies": {
+        "@edge-runtime/vm": "*",
+        "@types/node": "^18.0.0 || >=20.0.0",
+        "@vitest/browser": "2.1.9",
+        "@vitest/ui": "2.1.9",
+        "happy-dom": "*",
+        "jsdom": "*"
+      },
+      "peerDependenciesMeta": {
+        "@edge-runtime/vm": {
+          "optional": true
+        },
+        "@types/node": {
+          "optional": true
+        },
+        "@vitest/browser": {
+          "optional": true
+        },
+        "@vitest/ui": {
+          "optional": true
+        },
+        "happy-dom": {
+          "optional": true
+        },
+        "jsdom": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/why-is-node-running": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz",
+      "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "siginfo": "^2.0.0",
+        "stackback": "0.0.2"
+      },
+      "bin": {
+        "why-is-node-running": "cli.js"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/wrap-ansi": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz",
+      "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.1.0",
+        "string-width": "^5.0.1",
+        "strip-ansi": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs": {
+      "name": "wrap-ansi",
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/wrap-ansi-cjs/node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/zip-stream": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/zip-stream/-/zip-stream-6.0.1.tgz",
+      "integrity": "sha512-zK7YHHz4ZXpW89AHXUPbQVGKI7uvkd3hzusTdotCg1UxyaVtg0zFJSTfW/Dq5f7OBBVnq6cZIaC8Ti4hb6dtCA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "archiver-utils": "^5.0.0",
+        "compress-commons": "^6.0.2",
+        "readable-stream": "^4.0.0"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    }
+  }
+}
diff --git a/scripts/lib/skill-generator.js b/scripts/lib/skill-generator.js
index 71dd2357..454142ac 100644
--- a/scripts/lib/skill-generator.js
+++ b/scripts/lib/skill-generator.js
@@ -298,7 +298,9 @@ function expandSkillGroups(config, configDir) {
         const compositeKeyDashed = key.replace(/\//g, '-');
 
         for (const variation of group.variants) {
-            const mergedTags = [...baseTags, ...(variation.tags || [])];
+            // Deduped: a variant that repeats a group-level tag would otherwise
+            // collect that tag's commandments twice.
+            const mergedTags = [...new Set([...baseTags, ...(variation.tags || [])])];
             let description = variation.description;
             if (!description && baseDescription) {
                 description = baseDescription.replace(/{display_name}/g, variation.display_name);
@@ -522,7 +524,9 @@ function collectCommandments(tags, commandmentsConfig) {
     // `all` is language-agnostic and ships with every skill, whatever its tags.
     const rules = [...(commandments.all || [])];
 
-    for (const tag of tags) {
+    // Deduped: variants inherit group-level tags and may re-declare them, which
+    // would otherwise collect that tag's rules twice.
+    for (const tag of new Set(tags)) {
         if (tag !== 'all' && commandments[tag]) {
             rules.push(...commandments[tag]);
         }
diff --git a/scripts/lib/tests/skill-generator-tag-implications.test.js b/scripts/lib/tests/skill-generator-tag-implications.test.js
index 0f575caa..cd15ad13 100644
--- a/scripts/lib/tests/skill-generator-tag-implications.test.js
+++ b/scripts/lib/tests/skill-generator-tag-implications.test.js
@@ -37,4 +37,11 @@ describe('collectCommandments', () => {
         const rules = collectCommandments(['react-native', 'typescript'], config);
         expect(rules).toEqual(['mobile rule']);
     });
+
+    it('emits a tag\'s rules once when the tag is repeated', () => {
+        // Variants inherit group-level tags and may re-declare them, so the
+        // merged list can carry the same tag twice.
+        const rules = collectCommandments(['nextjs', 'javascript', 'nextjs'], config);
+        expect(rules).toEqual(['nextjs rule', 'root rule']);
+    });
 });

From 0b90fe58ab74d3f167a4d5d8dc64582f431cef18 Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Mon, 27 Jul 2026 17:05:57 -0400
Subject: [PATCH 06/15] fix(ai-observability): restore user identity, cut the
 no-op gateway table
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The four mapping questions collapsed to two last commit, which dropped the
distinct-id source entirely — while 5-verify still graded attribution. Step 1
now asks for conversation and user together (they share a placement rule), and
step 4 states wiring both as the task rather than showing the distinct id only
incidentally in code samples.

Also cuts the 15-row baseURL host table. Verified all 17 gateway variants
install identical packages and the identical OpenAIInstrumentor bootstrap, so
the routing choice affects only how the provider is named in the report — not
the generated code. The claim that misrouting breaks cost attribution was
wrong: $ai_provider is derived at runtime, not from the variant picked.
Portkey's extra portkey-ai package is the one real difference.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../skills/ai-observability/description.md    |  2 +-
 .../ai-observability/references/1-begin.md    | 30 ++++---------------
 .../ai-observability/references/2-install.md  |  2 +-
 .../ai-observability/references/4-nesting.md  | 16 +++++-----
 4 files changed, 17 insertions(+), 33 deletions(-)

diff --git a/context/skills/ai-observability/description.md b/context/skills/ai-observability/description.md
index c6fd83d4..fcf74471 100644
--- a/context/skills/ai-observability/description.md
+++ b/context/skills/ai-observability/description.md
@@ -17,7 +17,7 @@ Read every referenced file **before editing**. Then work through them in order:
 1. **Begin** — see `references/1-begin.md`. Pick the right variant using the ordered rules (framework before provider, gateway `baseURL` before the SDK it borrows), locate the LLM call sites, and answer the two questions that drive everything after: does the app register tools, and what identifies one conversation?
 2. **Install** — see `references/2-install.md`. Declare the variant's packages in the manifest — and only those.
 3. **Instrument** — see `references/3-instrument.md`. Wire the bootstrap the variant's install doc describes: OTel `TracerProvider` + `PostHogSpanProcessor`, a PostHog wrapper client, a framework tracing hook, or manual capture. Route the project token / host through environment variables.
-4. **Attach the session** — see `references/4-nesting.md`. Give the traces that belong to one conversation a shared `$ai_session_id`. Mandatory. Spans are *not* your job — they come from the app's own tool registration.
+4. **Attach identity** — see `references/4-nesting.md`. Give the traces that belong to one conversation a shared `$ai_session_id`, and attribute them to a person with the distinct id. Mandatory. Spans are *not* your job — they come from the app's own tool registration.
 5. **Verify** — see `references/5-verify.md`. Describe a request the user can trigger, and grade what lands in PostHog — one session, grouped traces, right attribution — rather than what the diff contains.
 
 ## Reference files
diff --git a/context/skills/ai-observability/references/1-begin.md b/context/skills/ai-observability/references/1-begin.md
index ec968730..8e6cda48 100644
--- a/context/skills/ai-observability/references/1-begin.md
+++ b/context/skills/ai-observability/references/1-begin.md
@@ -36,31 +36,11 @@ These wrap the provider SDK. Instrumenting the provider underneath captures the
 | `mastra`, `@mastra/core` | `mastra` |
 | `convex` | `convex` |
 
-### 2. A provider SDK with a `baseURL` / `base_url` override → use the gateway's variant
+### 2. A provider SDK with a `baseURL` / `base_url` override → prefer the gateway's variant
 
-Most OpenAI-compatible providers ship no SDK of their own; apps talk to them with the `openai` package pointed at a different host. **Routing these to `openai-*` is a silent, costly misroute** — generations get attributed to the wrong provider and cost calculation breaks.
+Most OpenAI-compatible providers ship no SDK of their own; apps reach them with the `openai` package pointed at another host — `api.groq.com`, `openrouter.ai`, `localhost:11434`, `api.together.xyz`, and so on. Check the `openai` client's construction and `OPENAI_BASE_URL` in env files, then pick the variant naming that provider from the menu.
 
-So whenever you find an `openai` client, grep its construction for `baseURL` / `base_url` (also check `OPENAI_BASE_URL` in env files) and match the host:
-
-| Host contains | Variant |
-|---|---|
-| `api.groq.com` | `groq-{python,node}` |
-| `openrouter.ai` | `openrouter-{python,node}` |
-| `api.together.` | `together-ai-{python,node}` |
-| `localhost:11434`, `ollama` | `ollama-{python,node}` |
-| `api.deepseek.com` | `deepseek-{python,node}` |
-| `api.x.ai` | `xai-{python,node}` |
-| `api.perplexity.ai` | `perplexity-{python,node}` |
-| `api.fireworks.ai` | `fireworks-ai-{python,node}` |
-| `api.cerebras.ai` | `cerebras-{python,node}` |
-| `huggingface.co` | `hugging-face-{python,node}` |
-| `dedaluslabs.ai` | `dedalus-{python,node}` |
-| `api.portkey.ai` | `portkey-{python,node}` |
-| `helicone.ai` | `helicone-{python,node}` |
-| `gateway.ai.cloudflare.com` | `cloudflare-ai-gateway-{python,node}` |
-| `.openai.azure.com` | `azure-openai-{python,node}` |
-
-An unfamiliar host still means "not plain OpenAI" — check the menu for a variant naming that provider before falling back.
+Keep the stakes straight: these variants instrument **identically** — same packages, same `OpenAIInstrumentor`, same bootstrap. Choosing the matching one gets the provider named correctly in the report and the run record; it does not generate different code. If the host matches no variant you can find, `openai-*` produces the same result. One real exception: **Portkey** additionally needs the `portkey-ai` package.
 
 ### 3. A direct provider SDK, no override → that provider's variant
 
@@ -91,6 +71,8 @@ Instrumentation captures individual LLM calls. The structure that makes them use
 
 **1. Does the app register tools with its LLM calls?** Look for a `tools=` / `tools:` argument, a tool registry, or a framework's tool decorator. This decides whether the trace should contain spans at all — you never author them by hand, so the answer is "which spans should already be there", not "which should I add".
 
-**2. What identifies one conversation, and does it vary within the process?** A `thread_id` / `conversationId` field, a session row, a request parameter — or nothing explicit, in which case the process run *is* the conversation. Whether it varies per request decides **where** the session id has to live: a server handling many users' threads needs it per call; a CLI or worker can set it once at startup.
+**2. What identifies the conversation and the user, and do they vary within the process?** For the conversation: a `thread_id` / `conversationId` field, a session row, a request parameter — or nothing explicit, in which case the process run *is* the conversation. For the user: a `user_id` or equivalent in scope at the call sites — or none, in which case events are anonymous. Note that rather than inventing an identifier.
+
+Both answers share one consequence, which is why they're one question: whether they vary per request decides **where** they have to live. A server handling many users' threads sets both per call; a CLI or worker sets them once at startup.
 
 Do not edit yet. Once you have the variant, the entry point, the call sites, and those two answers, move on to `2-install.md`.
diff --git a/context/skills/ai-observability/references/2-install.md b/context/skills/ai-observability/references/2-install.md
index a04e2f44..c191e571 100644
--- a/context/skills/ai-observability/references/2-install.md
+++ b/context/skills/ai-observability/references/2-install.md
@@ -72,7 +72,7 @@ No provider instrumentation package — Vercel AI emits OTel spans natively when
 
 ### Gateway variants (Groq, OpenRouter, Together, Ollama, …)
 
-These use the `openai` SDK against a different host, so the packages are the OpenAI ones — `opentelemetry-instrumentation-openai-v2` (Python) or `@opentelemetry/instrumentation-openai` (Node). The variant differs in the install doc's configuration, not its dependencies. Do not go looking for a `opentelemetry-instrumentation-groq`.
+These use the `openai` SDK against a different host, so the packages are the OpenAI ones — `opentelemetry-instrumentation-openai-v2` (Python) or `@opentelemetry/instrumentation-openai` (Node). There is no per-gateway instrumentation package. The one exception is Portkey, which also needs `portkey-ai`.
 
 ### Agent framework variants
 
diff --git a/context/skills/ai-observability/references/4-nesting.md b/context/skills/ai-observability/references/4-nesting.md
index 0cdae0a4..9cbc6828 100644
--- a/context/skills/ai-observability/references/4-nesting.md
+++ b/context/skills/ai-observability/references/4-nesting.md
@@ -25,18 +25,20 @@ Which layers actually emit tool spans, so you know what to expect at verificatio
 
 The last row is the one that surprises people. An OTel instrumentor patches only the vendor SDK's own methods (`Messages.create`, `chat.completions.create`, …). A tool the app executes in its own loop never passes through it, so it produces no span; the model's *request* to call that tool is recorded as attributes on the generation (`gen_ai.prompt.N.tool_calls.M.name`), not as a child. On this path a tool-using app still yields a generations-only trace — expected, not a defect to fix.
 
-## Rule 2 — your job is the bootstrap plus the session id
+## Rule 2 — your job is the bootstrap plus identity
 
-The bootstrap is done. Trace grouping is not a separate task: it falls out of the framework's own call structure, because the calls a request makes already share one OTel trace (or one framework run). So the only application semantics left to supply is the **session** — because only the app knows what a conversation is.
+The bootstrap is done. Trace grouping is not a separate task: it falls out of the framework's own call structure, because the calls a request makes already share one OTel trace (or one framework run). What's left is the two things only the app can tell you — **which conversation these traces belong to** (`$ai_session_id`) and **who the person is** (the distinct id). Wire both; an unattributed trace is only half-instrumented.
 
-### Where `$ai_session_id` goes
+### Where the session id and distinct id go
 
-Use the second answer from `1-begin.md`:
+They follow the same rule, so place them together, using the second answer from `1-begin.md`:
 
-| Case | Where it goes |
+| Case | Where they go |
 |---|---|
-| One process = one conversation (CLI, script, worker) | OTel **Resource** attribute, beside `posthog.distinct_id` |
-| Session varies per request (any server) | **Per call** — the wrapper's `posthog_properties` / `posthogProperties`, Vercel AI's `experimental_telemetry.metadata`, or manual-capture properties |
+| One process = one conversation and one user (CLI, script, worker) | OTel **Resource** attributes — `$ai_session_id` and `posthog.distinct_id` side by side |
+| Either varies per request (any server) | **Per call** — the wrapper's `posthog_distinct_id` + `posthog_properties` / `posthogProperties`, Vercel AI's `experimental_telemetry.metadata`, or manual-capture properties |
+
+If the app has no user identifier at all, leave the distinct id unset and say so in the report — anonymous is a finding, not a blocker. Never invent one, and never substitute the session id for it.
 
 ```python
 resource=Resource(attributes={

From 30eed3f4d8f7530be636a77439f5e9a035886e88 Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Tue, 28 Jul 2026 08:38:07 -0400
Subject: [PATCH 07/15] fix(ai-observability): stop the bootstrap growing
 scaffolding around itself

Feedback from an openai-python run: the generated install wrapped a five-line
bootstrap in an init function with a module global and a custom env guard.
Three of the four causes were ours.

- 3-instrument: new 'Match the doc's shape' rule. Copy the install doc's block
  at module level, change only the values. No init function, no globals, no
  extra env scaffolding. Names the actual trigger: when a Resource value isn't
  available at module scope, that means the app needs per-call identity, not a
  deferred bootstrap.
- 4-nesting: identity placement now prefers per-call wherever the mechanism
  offers it, with a per-mechanism table. Resource is documented as the raw-OTel
  constraint it is (the instrumentor owns the span; OTel doesn't inherit
  attributes parent->child) rather than the default. Removes a duplicated
  Resource block, and adds the $ai_session_id charset restriction from
  sessions.md that the rewrite had missed.
- commandments: the 'all' missing-configuration rule mandates a custom raise,
  which is what produced the guard block. Carve-out notes that a direct
  os.environ lookup already fails loudly and idiomatically, so no separate
  presence check is warranted around a short bootstrap.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 context/commandments.yaml                     |  1 +
 .../references/3-instrument.md                | 12 ++++++++-
 .../ai-observability/references/4-nesting.md  | 25 ++++++++++++-------
 3 files changed, 28 insertions(+), 10 deletions(-)

diff --git a/context/commandments.yaml b/context/commandments.yaml
index ada6a85d..2f00ce89 100644
--- a/context/commandments.yaml
+++ b/context/commandments.yaml
@@ -301,3 +301,4 @@ commandments:
     - "AI Observability carve-out: this skill instruments LLM calls and is not product-analytics coverage. Do NOT add posthog.capture() events for user actions, captureException() error handlers, or a reverse proxy unless the user explicitly asks for them"
     - "AI Observability carve-out: only the wrapper-client and manual-capture install paths construct a PostHog client. The OTel and framework-hook paths have no client at all, so any rule in this file about the Posthog()/PostHog() constructor, exception autocapture, atexit/shutdown registration or flushing simply does not apply — never invent a client just to satisfy one"
     - "AI Observability carve-out: the $ai_* payload properties ($ai_input, $ai_output_choices, and the rest) intentionally carry user-generated prompt and completion text, so this file's PII rules do NOT apply to them. Those rules still govern every other property you set"
+    - "AI Observability carve-out: read the PostHog key and host exactly as the variant's install doc reads them. A direct os.environ[\"POSTHOG_API_KEY\"] / process.env lookup already fails loudly and idiomatically when unset, which satisfies this file's missing-configuration rule — do NOT add a separate presence check, guard branch, or custom raise around a bootstrap that is only a few lines long"
diff --git a/context/skills/ai-observability/references/3-instrument.md b/context/skills/ai-observability/references/3-instrument.md
index fd6b0519..db23c9f0 100644
--- a/context/skills/ai-observability/references/3-instrument.md
+++ b/context/skills/ai-observability/references/3-instrument.md
@@ -13,7 +13,17 @@ description: Wire the mechanism chosen at the gate - wrapper client swap, OTel b
 | **Framework hook** | agent frameworks and Vercel AI | the framework's own tracing processor, callback, or `experimental_telemetry` |
 | **Manual capture** | `manual-capture` | explicit `capture()` calls at the call site |
 
-Wire exactly one. Whatever the family, this step captures individual generations only — attaching the session id is `4-nesting.md`'s job, and it is a mandatory part of this skill, not optional polish.
+Wire exactly one. Whatever the family, this step captures individual generations only — attaching identity is `4-nesting.md`'s job, and it is a mandatory part of this skill, not optional polish.
+
+## Match the doc's shape
+
+**Copy the install doc's code block and change only the values.** The bootstrap belongs at module level in the entry point, laid out the way the doc lays it out — typically under ten lines. Adding structure around it is the most common way this step goes wrong:
+
+- **No init function.** Don't wrap the bootstrap in `init_observability(...)` or similar. The doc calls it at import time; so should you.
+- **No module-level globals** holding the provider or tracer "for later". Nothing needs to reach them afterwards.
+- **No extra env-var scaffolding.** Read the values the way the doc reads them. `os.environ["POSTHOG_API_KEY"]` already fails loudly and idiomatically when unset — a separate presence check that raises is duplicated ceremony around a five-line snippet.
+
+If a value the bootstrap needs isn't available at module scope — a user id or conversation id that only exists per request — **do not defer the bootstrap into a function to reach it.** That is the signal that this app needs per-call identity instead of process-level identity; `4-nesting.md` covers what to do, and the answer is never to restructure the bootstrap.
 
 ## Environment variables (all mechanisms)
 
diff --git a/context/skills/ai-observability/references/4-nesting.md b/context/skills/ai-observability/references/4-nesting.md
index 9cbc6828..83d61641 100644
--- a/context/skills/ai-observability/references/4-nesting.md
+++ b/context/skills/ai-observability/references/4-nesting.md
@@ -31,26 +31,33 @@ The bootstrap is done. Trace grouping is not a separate task: it falls out of th
 
 ### Where the session id and distinct id go
 
-They follow the same rule, so place them together, using the second answer from `1-begin.md`:
+They follow the same rule, so place them together. **Prefer per-call whenever the mechanism offers it** — per-call identity keeps the bootstrap a literal copy of the install doc, and it stays correct when the app later serves more than one user per process.
 
-| Case | Where they go |
+| Mechanism | Where identity goes |
 |---|---|
-| One process = one conversation and one user (CLI, script, worker) | OTel **Resource** attributes — `$ai_session_id` and `posthog.distinct_id` side by side |
-| Either varies per request (any server) | **Per call** — the wrapper's `posthog_distinct_id` + `posthog_properties` / `posthogProperties`, Vercel AI's `experimental_telemetry.metadata`, or manual-capture properties |
+| Wrapper client | **Per call** — `posthog_distinct_id` and `posthog_properties={"$ai_session_id": …}` (camelCase in Node) |
+| Vercel AI SDK | **Per call** — `experimental_telemetry.metadata` |
+| Manual capture | **Per call** — event properties |
+| Framework hook | Per call if the framework exposes metadata; otherwise the Resource |
+| Raw provider SDK + OTel instrumentor | **Resource attributes only** — see below |
 
-If the app has no user identifier at all, leave the distinct id unset and say so in the report — anonymous is a finding, not a blocker. Never invent one, and never substitute the session id for it.
+The last row is a real constraint, not a preference. The instrumentor creates the generation span itself, so you cannot pass it per-call metadata, and OTel does not inherit attributes parent→child — putting them on an enclosing span leaves the generation without them. `$ai_session_id` and `posthog.distinct_id` go on the Resource, beside `SERVICE_NAME`, exactly as the install doc shows for `posthog.distinct_id`:
 
 ```python
 resource=Resource(attributes={
     SERVICE_NAME: "my-app",
-    "posthog.distinct_id": user_id,      # already in the install docs
-    "$ai_session_id": session_id,        # add this line; process-global
+    "posthog.distinct_id": USER_ID,      # the doc already shows this one
+    "$ai_session_id": SESSION_ID,        # add this line
 })
 ```
 
-The key is the literal `$ai_session_id` — there is no `posthog.session_id` alias (only `posthog.distinct_id` and `posthog.geoip_disable` get remapped at ingest). Resource attributes are copied onto every event, filtered only by the `host.` / `process.` / `os.` / `telemetry.` prefixes.
+Because the Resource is built once at import, both values must be resolvable at module scope. **When they are** — a CLI, a script, a worker, one process serving one user — this is correct and costs two lines. **When they aren't**, the fix is to choose a mechanism with per-call identity (usually the wrapper variant), *not* to defer the bootstrap into an init function so it can receive them. A per-request session on the Resource is wrong regardless: it is global to the process, so every conversation collapses into one id.
+
+If an app must stay on the raw OTel path *and* needs per-request values, use the standard `opentelemetry-processor-baggage` package; do not generate custom `SpanProcessor` classes in user codebases.
+
+If the app has no user identifier at all, leave the distinct id unset and say so in the report — anonymous is a finding, not a blocker. Never invent one, and never substitute the session id for it.
 
-**Never put a per-request session on the Resource** — the Resource is global to the SDK instance, so every conversation in the process would collapse into one id. If an app must stay on OTel *and* needs per-request values, use the standard `opentelemetry-processor-baggage` package; do not generate custom `SpanProcessor` classes in user codebases.
+Two details that bite either way: the key is the literal `$ai_session_id` (there is no `posthog.session_id` alias — only `posthog.distinct_id` and `posthog.geoip_disable` are remapped at ingest), and its value may contain only letters, numbers, and `- _ ~ . @ ( ) ! ' : |`. A raw thread id carrying a `/` or `#` is rejected, so check the app's identifier before passing it straight through.
 
 ### Always set a session — the graded property is cardinality
 

From d14ddb27ebfa66d8a64841fde3cc33019b56dc64 Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Fri, 31 Jul 2026 17:45:38 -0400
Subject: [PATCH 08/15] feat(ai-observability): follow the docs from OTel to
 the SDK wrapper

Matches PostHog/posthog#75976 ("update docs to match SDK use over OTel"),
which rewrites all 40 AIO installation pages: OTel out (-207 mentions, -92
PostHogSpanProcessor, -46 TracerProvider), wrapper client + manual $ai_span
in (+69). The stated reason is that OTel makes the full session tree hard to
build and maintain, which is this skill's whole deliverable.

- 2-install: providers and gateways now install just the PostHog SDK beside
  the vendor SDK. No opentelemetry packages at all. OTel packages narrowed to
  the opentelemetry-* variants and LlamaIndex.
- 3-instrument: wrapper client is the default mechanism; OTel demoted to the
  variants whose docs still call for it. Adds the gateway base_url shape.
- 4-nesting: rewritten. Identity is per call (posthog_distinct_id,
  posthog_trace_id, posthog_properties). Trace id is per turn and must be
  shared across a turn's calls. Reverses the previous rule against authoring
  spans: the docs now require capturing each tool execution as an $ai_span
  event, since the wrapper never sees the app's dispatch loop. Framework
  variants still emit their own.
- 1-begin: restores the gateway-provider consequence, now real for the right
  reason - the wrapper reports openai whatever host it targets, and pricing
  keys on $ai_model + $ai_provider (see PostHog/posthog-python#822).
- 5-verify: expectations follow the new tree, including a $ai_provider check.

The three upstream PRs are still open, so the bundled install pages in each
zip remain the old OTel content until they merge and the docs are re-fetched.
3-instrument carries a note that the wrapper shape wins over a stale bundled
page; it can come out once #75976 lands.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../skills/ai-observability/description.md    |  17 +-
 .../ai-observability/references/1-begin.md    |  22 +--
 .../ai-observability/references/2-install.md  |  70 +++-----
 .../references/3-instrument.md                | 151 ++++++------------
 .../ai-observability/references/4-nesting.md  | 135 ++++++++--------
 .../ai-observability/references/5-verify.md   |  39 ++---
 6 files changed, 179 insertions(+), 255 deletions(-)

diff --git a/context/skills/ai-observability/description.md b/context/skills/ai-observability/description.md
index fcf74471..ab3f909e 100644
--- a/context/skills/ai-observability/description.md
+++ b/context/skills/ai-observability/description.md
@@ -15,9 +15,9 @@ Everything else this skill needs — PostHog credentials, instrumentation packag
 Read every referenced file **before editing**. Then work through them in order:
 
 1. **Begin** — see `references/1-begin.md`. Pick the right variant using the ordered rules (framework before provider, gateway `baseURL` before the SDK it borrows), locate the LLM call sites, and answer the two questions that drive everything after: does the app register tools, and what identifies one conversation?
-2. **Install** — see `references/2-install.md`. Declare the variant's packages in the manifest — and only those.
-3. **Instrument** — see `references/3-instrument.md`. Wire the bootstrap the variant's install doc describes: OTel `TracerProvider` + `PostHogSpanProcessor`, a PostHog wrapper client, a framework tracing hook, or manual capture. Route the project token / host through environment variables.
-4. **Attach identity** — see `references/4-nesting.md`. Give the traces that belong to one conversation a shared `$ai_session_id`, and attribute them to a person with the distinct id. Mandatory. Spans are *not* your job — they come from the app's own tool registration.
+2. **Install** — see `references/2-install.md`. Declare the variant's packages in the manifest — and only those. For providers and gateways that's the PostHog SDK alongside the vendor SDK, with no OpenTelemetry packages.
+3. **Instrument** — see `references/3-instrument.md`. Swap the vendor client for PostHog's wrapper (or wire the framework's tracing hook, for framework variants). Route the project token / host through environment variables.
+4. **Build the tree** — see `references/4-nesting.md`. Attach `$ai_session_id`, a per-turn `posthog_trace_id`, and the distinct id to each call, and capture tool executions as `$ai_span` events. Mandatory — this is what turns isolated generations into a session tree.
 5. **Verify** — see `references/5-verify.md`. Describe a request the user can trigger, and grade what lands in PostHog — one session, grouped traces, right attribution — rather than what the diff contains.
 
 ## Reference files
@@ -29,10 +29,11 @@ The linked install page carries the exact code blocks for this variant's languag
 ## Key principles
 
 - **Environment variables.** Read `<ph_project_token>` and `<ph_client_api_host>` from env, using the framework's env-var convention. Never hardcode either value.
-- **One mechanism, and the variant chooses it.** The install doc for the variant you picked names the mechanism; wire that one and no other. Never swap a framework's own tracing hook for an OTel instrumentor.
-- **Minimal changes.** The wrapper swaps a client import; OTel init is a single call at process start, placed alongside any existing PostHog init. Don't restructure the app either way.
-- **Match the docs.** Package names, instrumentor imports, and processor names change between AIO releases. The install page for this variant is the source of truth.
-- **Sessions always, spans never.** Every run attaches an `$ai_session_id`, inferring the conversation boundary when the app has no explicit field — one id shared by the traces that belong together. Spans are the opposite: they come from the app's registered tools, and an app with no tools correctly has none. Never hand-author a span to make a trace look fuller.
+- **The SDK wrapper is the default, not OpenTelemetry.** OTel makes the session tree awkward to build and maintain, so provider and gateway variants use PostHog's drop-in wrapper client. Reserve OTel for the `opentelemetry-*` variants and LlamaIndex, and never swap a framework's own tracing hook for an instrumentor.
+- **Minimal changes.** The wrapper swaps a client constructor and adds parameters to existing calls. Don't restructure the app, and don't wrap the setup in an init function or module globals.
+- **Match the docs.** Package names and wrapper imports change between AIO releases. The install page for this variant is the source of truth.
+- **Cardinality is what gets graded.** One `$ai_session_id` per conversation, one `posthog_trace_id` per turn, shared by every call in it. An id minted per call is worse than none — it looks instrumented and groups nothing.
+- **Tools become spans.** When the app registers tools, capture each execution as an `$ai_span` event sharing the turn's trace id — the wrapper never sees your dispatch loop. Framework variants emit these themselves; an app with no tools correctly has none.
 - **Don't touch what isn't yours.** This skill instruments LLM observability only — generations, traces, sessions, spans. Identify calls, event tracking, error tracking, and dashboards belong to the base `integration` skill — do not add or edit them here.
 
 ## Emit a run record
@@ -43,7 +44,7 @@ When you finish, write `.posthog-wizard-cache/.posthog-ai.json` at the project r
 { "provider": "openai", "package": "@posthog/ai", "otel_init_file": "src/instrumentation.ts" }
 ```
 
-On the wrapper or manual-capture path there is no OTel init — set `otel_init_file` to the file where the wrapper client (or capture helper) was wired instead.
+`otel_init_file` keeps its name for the report's sake, but on the wrapper path there is no OTel init — set it to the file where the wrapper client was constructed (or, on the manual path, where the capture helper lives).
 
 The `report/` step reads this file to render an AI Observability section in the setup report. If the cache directory does not exist, create it.
 
diff --git a/context/skills/ai-observability/references/1-begin.md b/context/skills/ai-observability/references/1-begin.md
index 8e6cda48..818aa168 100644
--- a/context/skills/ai-observability/references/1-begin.md
+++ b/context/skills/ai-observability/references/1-begin.md
@@ -40,7 +40,7 @@ These wrap the provider SDK. Instrumenting the provider underneath captures the
 
 Most OpenAI-compatible providers ship no SDK of their own; apps reach them with the `openai` package pointed at another host — `api.groq.com`, `openrouter.ai`, `localhost:11434`, `api.together.xyz`, and so on. Check the `openai` client's construction and `OPENAI_BASE_URL` in env files, then pick the variant naming that provider from the menu.
 
-Keep the stakes straight: these variants instrument **identically** — same packages, same `OpenAIInstrumentor`, same bootstrap. Choosing the matching one gets the provider named correctly in the report and the run record; it does not generate different code. If the host matches no variant you can find, `openai-*` produces the same result. One real exception: **Portkey** additionally needs the `portkey-ai` package.
+These variants share one install shape — PostHog's OpenAI wrapper pointed at the provider's `base_url` — but **identifying the provider still matters**. PostHog prices tokens by `$ai_model` + `$ai_provider`, and the wrapper reports `openai` whatever host it targets, so a gateway call has to send the real provider explicitly (`4-nesting.md` covers how). Getting the variant right is what tells you which slug to send. Portkey additionally needs the `portkey-ai` package.
 
 ### 3. A direct provider SDK, no override → that provider's variant
 
@@ -59,20 +59,24 @@ Language follows the manifest (`package.json` → Node, `pyproject.toml`/`requir
 
 Grep for `posthog.init(`, `PostHog(`, or `AddPostHog(`.
 
-**This is not a prerequisite.** The OTel-based variants use `PostHogSpanProcessor`, a self-contained exporter taking an API key + host — it does not depend on a `posthog.init(...)` anywhere. If one **is** present, note the env-var names it reads (`POSTHOG_API_KEY`, `NEXT_PUBLIC_POSTHOG_KEY`, …) and reuse them in `3-instrument.md`; don't invent parallel names.
+**This is not a prerequisite.** The wrapper takes its own PostHog client built from a project token and host — it does not depend on a `posthog.init(...)` anywhere, and `2-install.md` adds the SDK if it isn't there. If one **is** present, note the env-var names it reads (`POSTHOG_API_KEY`, `NEXT_PUBLIC_POSTHOG_KEY`, …) and reuse them in `3-instrument.md`; don't invent parallel names. Reuse the client instance too rather than creating a second one.
 
 ## Locate the LLM call sites
 
-Grep for where the chosen SDK is imported and called — one or two representative sites is enough to reason about where init has to run. Note the app's **entry point** (server startup file, `main.py`, `index.ts`, `instrumentation.ts` in Next.js): on the OTel path, init must run there *before* the vendor SDK is imported.
+Grep for where the chosen SDK is imported and called. On the wrapper path you need **two** things: the module where the vendor client is **constructed** (that constructor gets swapped in `3-instrument.md`), and the **call sites** themselves, since identity is attached per call in `4-nesting.md`. Note the tool-dispatch loop too if the app has one — its executions become spans.
 
-## Answer the two questions
+## Answer the following question
 
-Instrumentation captures individual LLM calls. The structure that makes them useful comes from application semantics only the code can tell you — and it reduces to two questions. Write the answers down; `4-nesting.md` consumes them and nothing else.
+Instrumentation captures individual LLM calls. The structure that makes them useful comes from application semantics only the code can tell you. Write the answers down; `4-nesting.md` consumes them and nothing else.
 
-**1. Does the app register tools with its LLM calls?** Look for a `tools=` / `tools:` argument, a tool registry, or a framework's tool decorator. This decides whether the trace should contain spans at all — you never author them by hand, so the answer is "which spans should already be there", not "which should I add".
+**What identifies the conversation and the user, and where does one turn begin and end?**
 
-**2. What identifies the conversation and the user, and do they vary within the process?** For the conversation: a `thread_id` / `conversationId` field, a session row, a request parameter — or nothing explicit, in which case the process run *is* the conversation. For the user: a `user_id` or equivalent in scope at the call sites — or none, in which case events are anonymous. Note that rather than inventing an identifier.
+- **Conversation** — a `thread_id` / `conversationId` field, a session row, a request parameter, or nothing explicit, in which case the process run *is* the conversation. This becomes `$ai_session_id`.
+- **User** — a `user_id` or equivalent in scope at the call sites, or none, in which case events are anonymous. Note that rather than inventing an identifier.
+- **Turn** — the function or handler that takes one question and produces one answer, however many model calls it makes inside. This becomes one trace, and every call inside it shares one trace id.
 
-Both answers share one consequence, which is why they're one question: whether they vary per request decides **where** they have to live. A server handling many users' threads sets both per call; a CLI or worker sets them once at startup.
+All three are attached per call, so you don't need to know whether they vary within the process — you just need to know where to read them at the call site.
 
-Do not edit yet. Once you have the variant, the entry point, the call sites, and those two answers, move on to `2-install.md`.
+Note as well **whether the app registers tools** with its LLM calls (a `tools=` argument, a tool registry, a framework decorator). If it does, their executions need capturing as spans in `4-nesting.md`.
+
+Do not edit yet. Once you have the variant, the entry point, the call sites, and those answers, move on to `2-install.md`.
diff --git a/context/skills/ai-observability/references/2-install.md b/context/skills/ai-observability/references/2-install.md
index c191e571..2f8057d8 100644
--- a/context/skills/ai-observability/references/2-install.md
+++ b/context/skills/ai-observability/references/2-install.md
@@ -1,97 +1,63 @@
 ---
 next_step: 3-instrument.md
 title: AI Observability Setup - Install
-description: Declare the packages the installed variant needs - OTel, wrapper, framework hook, or manual capture
+description: Declare the packages the installed variant needs - almost always just the PostHog SDK alongside the vendor SDK
 ---
 
 Declare the packages the variant you installed in `1-begin.md` needs in the project's manifest — and only those. Do not run the package manager here — the base integration's build/verify step (or the user) installs everything in one pass.
 
-Read the manifest first. If any of the required packages is already declared, leave the existing version alone and say so. Match the style of dependencies already in the file (versions, ordering, dev vs. runtime).
+Read the manifest first. If any required package is already declared, leave the existing version alone and say so. Match the style of dependencies already in the file (versions, ordering, dev vs. runtime).
 
-## What to add
+## The default: PostHog's SDK wrapper
 
-The linked install page for this variant carries the authoritative command. The shapes below reflect the current defaults across Tier-1 providers.
-
-### Wrapper path
-
-No OTel packages at all:
+Every direct provider (OpenAI, Anthropic, Google, Azure OpenAI, Mistral, Cohere, …) and every OpenAI-compatible gateway (Groq, OpenRouter, Together, Ollama, DeepSeek, xAI, Perplexity, Fireworks, Cerebras, Hugging Face, Dedalus, Portkey, Helicone, Cloudflare AI Gateway) installs the same two things:
 
 ```
 posthog                # Python — ships the posthog.ai.<provider> wrapper clients
 ```
 
 ```
-@posthog/ai            # Node — ships the wrapper clients
+@posthog/ai            # Node — the wrapper clients
 posthog-node           # Node — the PostHog client the wrapper takes
 ```
 
-### Python — the OTel path
+**No OpenTelemetry packages.** There is no `opentelemetry-sdk`, no `posthog[otel]`, and no `opentelemetry-instrumentation-<provider>` on this path. If you find yourself reaching for one, you're on the wrong mechanism — go back to `3-instrument.md`.
 
-Three packages:
+The vendor SDK itself (`openai`, `anthropic`, `@anthropic-ai/sdk`, …) is a prerequisite and should already be declared. Do not add or upgrade it.
 
-```
-posthog[otel]                                   # PostHog SDK + span processor
-opentelemetry-sdk                               # OTel core
-opentelemetry-instrumentation-<provider>        # provider auto-instrumentation
-```
+Portkey is the one gateway needing an extra package: `portkey-ai`.
 
-Examples:
+## Framework variants
 
-- OpenAI → `opentelemetry-instrumentation-openai-v2`
-- Anthropic → `opentelemetry-instrumentation-anthropic`
-- LangChain → `opentelemetry-instrumentation-langchain`
-- Google Gemini → `opentelemetry-instrumentation-google-generativeai`
+Agent and orchestration frameworks (LangChain, LangGraph, CrewAI, DSPy, LiteLLM, OpenAI Agents, Claude Agent SDK, Vercel AI, Mirascope, Instructor, …) ship their tracing hook inside `posthog` / `@posthog/ai` or the framework itself. Take the package list from the variant's install doc; don't assume the shape of another family.
 
-The vendor SDK itself (`openai`, `anthropic`, `langchain`, …) is a prerequisite — it should already be declared. Do not add or upgrade it.
+## The OpenTelemetry variants
 
-### Node — the OTel path
+Only the `opentelemetry-{python,node}` variants — and LlamaIndex, whose instrumentation is OTel-based — use the OTel packages:
 
 ```
-@posthog/ai                                     # PostHog span processor
-@opentelemetry/sdk-node                         # OTel core (Node)
-@opentelemetry/resources                        # resource attributes
-@opentelemetry/instrumentation-<provider>       # provider auto-instrumentation
+posthog[otel]                                   # Python — PostHog SDK + span processor
+opentelemetry-sdk
 ```
 
-Provider instrumentation packages:
-
-- OpenAI → `@opentelemetry/instrumentation-openai`
-- Anthropic → `@traceloop/instrumentation-anthropic`
-- LangChain → `@traceloop/instrumentation-langchain`
-- Google Gemini → `@traceloop/instrumentation-google-generativeai`
-
-### Vercel AI SDK (Node)
-
-No provider instrumentation package — Vercel AI emits OTel spans natively when `experimental_telemetry` is enabled. Just add:
-
 ```
-@posthog/ai
+@posthog/ai                                     # Node — PostHog span processor
 @opentelemetry/sdk-node
 @opentelemetry/resources
 ```
 
-### Gateway variants (Groq, OpenRouter, Together, Ollama, …)
-
-These use the `openai` SDK against a different host, so the packages are the OpenAI ones — `opentelemetry-instrumentation-openai-v2` (Python) or `@opentelemetry/instrumentation-openai` (Node). There is no per-gateway instrumentation package. The one exception is Portkey, which also needs `portkey-ai`.
-
-### Agent framework variants
+## Manual-capture path
 
-Framework variants generally need no OTel instrumentation package at all — the tracing hook ships in the framework or in `posthog` / `@posthog/ai`. Take the package list from the variant's install doc; do not assume the three-package OTel shape above applies.
-
-### Manual-capture path
-
-No OTel packages. Just PostHog core:
+Just PostHog core:
 
 ```
 posthog                # Python
 posthog-node           # Node
 ```
 
-If PostHog core is already installed (it should be — see `1-begin.md`), this file has nothing to add. Skip to `3-instrument.md`, which describes the manual `capture(...)` call shape.
-
 ## Do not do
 
 - Do not run `npm install` / `pip install` here.
 - Do not edit the lockfile.
 - Do not upgrade the vendor SDK.
-- Do not add packages for more than one mechanism — no OTel instrumentation packages on a wrapper-path run, and vice versa. The variant's install doc describes exactly one.
+- Do not add OpenTelemetry packages to a wrapper-path run. That is the most common wrong turn in this step, and it is wrong for every provider and gateway variant.
diff --git a/context/skills/ai-observability/references/3-instrument.md b/context/skills/ai-observability/references/3-instrument.md
index db23c9f0..9004efb2 100644
--- a/context/skills/ai-observability/references/3-instrument.md
+++ b/context/skills/ai-observability/references/3-instrument.md
@@ -1,75 +1,93 @@
 ---
 next_step: 4-nesting.md
 title: AI Observability Setup - Instrument
-description: Wire the mechanism chosen at the gate - wrapper client swap, OTel bootstrap, or manual capture
+description: Swap the vendor client for PostHog's wrapper - the default path for every provider and gateway
 ---
 
-**The variant you installed determines the mechanism, and its installation doc is the source of truth** — copy the bootstrap from there rather than adapting a different variant's shape. The doc will describe one of four families:
+**The PostHog SDK wrapper is the default mechanism.** OpenTelemetry is no longer the recommended path for provider or gateway variants: it makes the full session tree awkward to build and maintain, which is exactly what this skill exists to produce. Use OTel only where the variant's install doc actually calls for it.
 
 | Family | Who uses it | Shape |
 |---|---|---|
-| **OTel bootstrap** | most provider variants, and the gateway variants | `TracerProvider` + `PostHogSpanProcessor` + a provider instrumentor |
-| **PostHog wrapper client** | variants where `posthog.ai.*` / `@posthog/ai` ships a drop-in | swap the client constructor, no entry-point work |
-| **Framework hook** | agent frameworks and Vercel AI | the framework's own tracing processor, callback, or `experimental_telemetry` |
+| **Wrapper client** | every direct provider and OpenAI-compatible gateway | swap the client constructor, hand it a PostHog client |
+| **Framework hook** | agent frameworks and Vercel AI | the framework's own callback, tracing processor, or `experimental_telemetry` |
+| **OTel bootstrap** | the `opentelemetry-*` variants and LlamaIndex only | `TracerProvider` + `PostHogSpanProcessor` |
 | **Manual capture** | `manual-capture` | explicit `capture()` calls at the call site |
 
-Wire exactly one. Whatever the family, this step captures individual generations only — attaching identity is `4-nesting.md`'s job, and it is a mandatory part of this skill, not optional polish.
+Wire exactly one. This step makes generations land; attaching identity and capturing tool calls is `4-nesting.md`'s job, and it is mandatory, not optional polish.
 
-## Match the doc's shape
+> If the bundled install page for this variant still shows a `TracerProvider` + `PostHogSpanProcessor` bootstrap for a provider or gateway, it predates the SDK-first rewrite. The wrapper shape below wins.
 
-**Copy the install doc's code block and change only the values.** The bootstrap belongs at module level in the entry point, laid out the way the doc lays it out — typically under ten lines. Adding structure around it is the most common way this step goes wrong:
+## Match the doc's shape
 
-- **No init function.** Don't wrap the bootstrap in `init_observability(...)` or similar. The doc calls it at import time; so should you.
-- **No module-level globals** holding the provider or tracer "for later". Nothing needs to reach them afterwards.
-- **No extra env-var scaffolding.** Read the values the way the doc reads them. `os.environ["POSTHOG_API_KEY"]` already fails loudly and idiomatically when unset — a separate presence check that raises is duplicated ceremony around a five-line snippet.
+**Copy the install doc's code block and change only the values.** The setup belongs at module level where the client is constructed — typically under ten lines. Adding structure around it is the most common way this step goes wrong:
 
-If a value the bootstrap needs isn't available at module scope — a user id or conversation id that only exists per request — **do not defer the bootstrap into a function to reach it.** That is the signal that this app needs per-call identity instead of process-level identity; `4-nesting.md` covers what to do, and the answer is never to restructure the bootstrap.
+- **No init function.** Don't wrap it in `init_observability(...)` or similar.
+- **No module-level globals** held "for later". Nothing needs to reach them afterwards.
+- **No extra env-var scaffolding.** `os.environ["POSTHOG_API_KEY"]` already fails loudly and idiomatically when unset — a separate presence check that raises is duplicated ceremony around a short snippet.
 
 ## Environment variables (all mechanisms)
 
-Route the PostHog credentials through env vars, using the wizard's `set_env_values` tool (never hardcode). Reuse whatever names the base PostHog integration already set — typically:
-
-- the public project token (e.g. `POSTHOG_API_KEY`, `NEXT_PUBLIC_POSTHOG_KEY`, or the framework's convention)
-- the PostHog host (e.g. `POSTHOG_HOST`, `NEXT_PUBLIC_POSTHOG_HOST`)
+Route the PostHog credentials through env vars using the wizard's `set_env_values` tool (never hardcode). Reuse whatever names the base PostHog integration already set — typically the project token (`POSTHOG_API_KEY`, `NEXT_PUBLIC_POSTHOG_KEY`, or the framework's convention) and the host (`POSTHOG_HOST`).
 
-If the project has an `.env.example` file, add the names there with empty placeholder values so collaborators know what to set. Create `.env.example` if it doesn't exist. Never write real secrets to any file.
+If the project has an `.env.example`, add the names there with empty placeholders. Create it if absent. Never write real secrets to any file.
 
 ## The wrapper path
 
-No OTel, no entry-point work. Swap the vendor client for PostHog's drop-in wrapper at the module where the client is constructed, and hand it a PostHog client:
+Create a PostHog client, then swap the vendor client for PostHog's drop-in wrapper:
 
 ```python
 from posthog import Posthog
-from posthog.ai.anthropic import Anthropic          # swap per provider: posthog.ai.openai, .gemini, …
+from posthog.ai.anthropic import Anthropic      # swap per provider: posthog.ai.openai, .gemini, …
 
 posthog = Posthog(os.environ["POSTHOG_API_KEY"], host=os.environ["POSTHOG_HOST"])
-client = Anthropic(posthog_client=posthog)          # same constructor args as the vendor client otherwise
+client = Anthropic(posthog_client=posthog)      # otherwise the vendor client's constructor args
 ```
 
 ```typescript
 import { PostHog } from 'posthog-node'
-import { Anthropic } from '@posthog/ai/anthropic'   // swap per provider: @posthog/ai/openai, /gemini, /vercel
+import { Anthropic } from '@posthog/ai/anthropic'
 
 const posthog = new PostHog(process.env.POSTHOG_API_KEY!, { host: process.env.POSTHOG_HOST! })
 const client = new Anthropic({ posthog })
 ```
 
-The wrapper is call-compatible with the vendor client — existing `client.messages.create(...)` / `client.chat.completions.create(...)` calls keep working unchanged and now emit `$ai_generation` events. The per-call `posthog_*` params (trace id, distinct id, session) are `4-nesting.md`'s job. The linked install page carries the exact import for this variant.
+The wrapper is call-compatible with the vendor client — existing `client.messages.create(...)` / `client.chat.completions.create(...)` calls keep working and now emit `$ai_generation` events. The per-call `posthog_*` params are `4-nesting.md`'s job.
+
+### Gateways — the same wrapper, pointed elsewhere
+
+An OpenAI-compatible gateway uses `posthog.ai.openai` with the provider's `base_url`. No entry-point work, no instrumentor:
+
+```python
+from posthog.ai.openai import OpenAI
+
+client = OpenAI(
+    base_url="https://api.groq.com/openai/v1",   # the provider's host
+    api_key=os.environ["GROQ_API_KEY"],
+    posthog_client=posthog,
+)
+```
+
+Because the wrapper reports `openai` as the provider by default, gateway calls must override it per call — see `4-nesting.md`.
+
+## Framework hooks
 
-## The OTel path
+Agent SDKs carry their own tracing layer and the PostHog integration plugs into *that*: `openai-agents` and `claude-agent-sdk` register a processor, LangChain-family variants use a callback handler, Vercel AI uses `experimental_telemetry`. Take the exact registration from the variant's install doc. Do not substitute an OTel instrumentor — it captures the model calls but loses the agent, tool, and handoff structure that makes the framework worth instrumenting.
 
-One initialization call per app. It runs once, at startup, before any vendor SDK call. The linked install page carries the exact code for this variant's language — copy from there.
+## The PostHog client
 
-### Python — the standard OTel path
+Every path above needs a PostHog client instance. Look for a reusable one before creating anything:
 
-Wire a `TracerProvider` with `PostHogSpanProcessor`, then call `.instrument()` on the provider-specific instrumentor:
+- Search for an existing client: `posthog-js` on the frontend, `PostHog` from `posthog` / `posthog-node` on the backend.
+- Frontend: the client is a singleton — always reuse it.
+- Backend: reuse a shared instance if one exists; otherwise create one where the instrumentation lives, once, at module level.
+
+## The OTel bootstrap (only where the doc calls for it)
 
 ```python
 from opentelemetry import trace
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.resources import Resource, SERVICE_NAME
 from posthog.ai.otel import PostHogSpanProcessor
-from opentelemetry.instrumentation.openai_v2 import OpenAIInstrumentor   # swap per provider
 
 provider = TracerProvider(resource=Resource(attributes={SERVICE_NAME: "my-app"}))
 provider.add_span_processor(PostHogSpanProcessor(
@@ -77,85 +95,18 @@ provider.add_span_processor(PostHogSpanProcessor(
     host=os.environ["POSTHOG_HOST"],
 ))
 trace.set_tracer_provider(provider)
-
-OpenAIInstrumentor().instrument()
 ```
 
-### Node — the standard OTel path
-
-Use `NodeSDK` with `PostHogSpanProcessor` and the provider instrumentation. Start it before importing the vendor SDK in the app's entry point:
-
-```typescript
-import { NodeSDK } from '@opentelemetry/sdk-node'
-import { resourceFromAttributes } from '@opentelemetry/resources'
-import { PostHogSpanProcessor } from '@posthog/ai/otel'
-import { OpenAIInstrumentation } from '@opentelemetry/instrumentation-openai'   // swap per provider
-
-const sdk = new NodeSDK({
-  resource: resourceFromAttributes({ 'service.name': 'my-app' }),
-  spanProcessors: [new PostHogSpanProcessor({
-    apiKey: process.env.POSTHOG_API_KEY!,
-    host: process.env.POSTHOG_HOST!,
-  })],
-  instrumentations: [new OpenAIInstrumentation()],
-})
-sdk.start()
-```
-
-For Next.js / Nuxt / other frameworks that expose a dedicated startup hook (`instrumentation.ts`, `nuxt.config`'s server plugin, etc.), put the SDK init there. It must run once per process, not per request.
-
-### Agent frameworks — a tracing processor, not OTel
-
-Agent SDKs carry their own tracing layer, and the PostHog integration plugs into *that*. `openai-agents` and `claude-agent-sdk` register a processor rather than a `TracerProvider`; LangChain-family variants use a callback handler. Take the exact registration from the variant's install doc — wiring an OTel instrumentor underneath one of these captures the model calls but loses the agent, tool, and handoff structure that makes the framework worth instrumenting.
-
-### Vercel AI SDK
-
-No instrumentor package. Initialize `NodeSDK` with just `PostHogSpanProcessor` (no `instrumentations` array), then pass `experimental_telemetry` per call:
-
-```typescript
-const result = await generateText({
-  model: openai('gpt-5-mini'),
-  prompt: '...',
-  experimental_telemetry: { isEnabled: true, functionId: 'my-ai-function' },
-})
-```
-
-If the project has many call sites, wrap the config into a shared helper rather than repeating it inline.
-
-## The PostHog client (wrapper + manual paths)
-
-The wrapper and manual-capture paths need a PostHog client instance. Look for a reusable one before creating anything:
-
-- Search the project for an existing client: a `posthog-js` init on the frontend, a `PostHog` instance from `posthog` / `posthog-node` on the backend.
-- Frontend: the client is a singleton — always reuse it, never instantiate a second one.
-- Backend: reuse a shared instance if the project has one; if none exists, create one where the instrumentation lives — once, at module level, reused across call sites — and use it when initializing the wrappers.
+It must run once per process, at startup, before the vendor SDK is imported.
 
 ## The manual-capture path
 
-No OTel, no wrapper. Capture each generation explicitly at the call site:
-
-```python
-posthog.capture(
-    distinct_id="user_123",
-    event="$ai_generation",
-    properties={
-        "$ai_provider": "openai",
-        "$ai_model": "gpt-4",
-        "$ai_input": [{"role": "user", "content": prompt}],
-        "$ai_output_choices": [{"role": "assistant", "content": response}],
-        "$ai_input_tokens": usage.prompt_tokens,
-        "$ai_output_tokens": usage.completion_tokens,
-        "$ai_latency": latency_seconds,
-    },
-)
-```
-
-Refer to `/docs/ai-observability/manual-capture` for the full property list.
+Capture each generation explicitly at the call site with `$ai_generation` and the properties from the install page (`$ai_provider`, `$ai_model`, `$ai_input`, `$ai_output_choices`, token counts, `$ai_latency`), carrying the `$ai_trace_id` from `4-nesting.md`.
 
 ## Do not
 
 - Do not wire more than one mechanism — the variant's install doc describes exactly one.
-- Do not substitute an OTel instrumentor for a framework's own tracing hook. If the variant is an agent framework, its processor is the integration.
-- Do not create a PostHog client where one already exists — search first and reuse it (the frontend client is a singleton). Only a backend with no client creates one, once, at module level. Either way, reuse the project token / host already in the app's env — this is a separate exporter, not a separate PostHog install.
-- Do not put client or SDK init inside a request handler. Once per process, at module level or startup.
-- OTel path: do not import the vendor SDK above the OTel init in the same file — the instrumentor patches the SDK when it loads, so the order matters.
+- Do not reach for OpenTelemetry on a provider or gateway variant. The wrapper is the path.
+- Do not substitute an OTel instrumentor for a framework's own tracing hook.
+- Do not create a PostHog client where one already exists — search first and reuse it. Reuse the project token / host already in the app's env.
+- Do not put client or SDK init inside a request handler. Once per process, at module level.
diff --git a/context/skills/ai-observability/references/4-nesting.md b/context/skills/ai-observability/references/4-nesting.md
index 83d61641..002a0f45 100644
--- a/context/skills/ai-observability/references/4-nesting.md
+++ b/context/skills/ai-observability/references/4-nesting.md
@@ -1,103 +1,104 @@
 ---
 next_step: 5-verify.md
 title: AI Observability Setup - Nesting
-description: Attach the session id so traces group into conversations - and let spans come from the app's own tools rather than authoring them
+description: Attach per-call identity and capture tool calls as spans so the session tree is complete
 ---
 
-`3-instrument.md` wired the bootstrap, so individual LLM calls now land. This step adds the one piece of structure the bootstrap can't infer.
+`3-instrument.md` wired the client, so individual LLM calls now land. This step builds the tree they belong to: **session → trace → span → generation**. It is the reason this skill exists, and a run that stops at the previous step is incomplete.
 
-Two rules. Everything else follows from them.
+Use the answer you wrote down in `1-begin.md`.
 
-## Rule 1 — spans come from the app's own tool registration
+## Identity goes on the call
 
-If the app registers tools with its LLM calls, the tool executions **are** the spans, and the tracing layer emits them. You never hand-author a wrapper span around an ordinary helper function.
+The wrapper takes three per-call parameters. Node uses camelCase (`posthogDistinctId`, `posthogTraceId`, `posthogProperties`).
 
-An app that registers no tools has no spans. **That is a correct, complete outcome** — a trace of two generations and nothing else is not a failure, and you must not invent spans to make the tree look fuller.
+| What | Where | Cardinality |
+|---|---|---|
+| **Session** | `posthog_properties={"$ai_session_id": …}` | one id shared by every turn of the conversation |
+| **Trace** | `posthog_trace_id` | **a new id per turn** — one request in, one answer out |
+| **User** | `posthog_distinct_id` | the person the conversation belongs to |
 
-Which layers actually emit tool spans, so you know what to expect at verification:
+```python
+import uuid
+
+session_id = "conversation-abc"      # same across every turn of this conversation
+trace_id = str(uuid.uuid4())         # one per turn
+distinct_id = "user_123"
+
+response = client.chat.completions.create(
+    model=MODEL,
+    messages=[...],
+    tools=tools,
+    posthog_distinct_id=distinct_id,
+    posthog_trace_id=trace_id,
+    posthog_properties={"$ai_session_id": session_id},
+)
+```
 
-| Mechanism | Tool spans? |
-|---|---|
-| Agent / orchestration frameworks (`openai-agents`, `claude-agent-sdk`, LangChain / LangGraph, CrewAI, Pydantic AI, …) | **Yes** — their tracing emits agent, tool, and handoff spans |
-| Vercel AI SDK | **Yes** — `ai.toolCall` spans, automatically |
-| Manual capture | Only what the app dispatches by hand |
-| Raw provider SDK + OTel instrumentor | **No** — see below |
+Every call that belongs to one turn must be handed **the same** `posthog_trace_id`. Omitting it does not group them — the wrapper mints a fresh UUID per call, which produces one lonely trace per generation.
 
-The last row is the one that surprises people. An OTel instrumentor patches only the vendor SDK's own methods (`Messages.create`, `chat.completions.create`, …). A tool the app executes in its own loop never passes through it, so it produces no span; the model's *request* to call that tool is recorded as attributes on the generation (`gen_ai.prompt.N.tool_calls.M.name`), not as a child. On this path a tool-using app still yields a generations-only trace — expected, not a defect to fix.
+To capture events anonymously, omit `posthog_distinct_id` rather than inventing an id.
 
-## Rule 2 — your job is the bootstrap plus identity
+### Gateways must also send `$ai_provider`
 
-The bootstrap is done. Trace grouping is not a separate task: it falls out of the framework's own call structure, because the calls a request makes already share one OTel trace (or one framework run). What's left is the two things only the app can tell you — **which conversation these traces belong to** (`$ai_session_id`) and **who the person is** (the distinct id). Wire both; an unattributed trace is only half-instrumented.
+`posthog.ai.openai` reports `openai` as the provider whatever host it points at. PostHog prices tokens by `$ai_model` + `$ai_provider`, so a Groq or DeepSeek call left at the default is mispriced or fails to match. Override it per call:
 
-### Where the session id and distinct id go
+```python
+posthog_properties={"$ai_session_id": session_id, "$ai_provider": "groq"},
+```
 
-They follow the same rule, so place them together. **Prefer per-call whenever the mechanism offers it** — per-call identity keeps the bootstrap a literal copy of the install doc, and it stays correct when the app later serves more than one user per process.
+Use the provider slug matching the variant you installed. This applies to every OpenAI-compatible gateway and to nothing else.
 
-| Mechanism | Where identity goes |
-|---|---|
-| Wrapper client | **Per call** — `posthog_distinct_id` and `posthog_properties={"$ai_session_id": …}` (camelCase in Node) |
-| Vercel AI SDK | **Per call** — `experimental_telemetry.metadata` |
-| Manual capture | **Per call** — event properties |
-| Framework hook | Per call if the framework exposes metadata; otherwise the Resource |
-| Raw provider SDK + OTel instrumentor | **Resource attributes only** — see below |
+## Capture tool calls as spans
 
-The last row is a real constraint, not a preference. The instrumentor creates the generation span itself, so you cannot pass it per-call metadata, and OTel does not inherit attributes parent→child — putting them on an enclosing span leaves the generation without them. `$ai_session_id` and `posthog.distinct_id` go on the Resource, beside `SERVICE_NAME`, exactly as the install doc shows for `posthog.distinct_id`:
+**When the app registers tools, you capture their executions as `$ai_span` events.** The wrapper captures the model call as a generation; it does not see your tool-dispatch loop, so nothing else will record it. Emit one event per tool call, sharing the turn's `$ai_trace_id`:
 
 ```python
-resource=Resource(attributes={
-    SERVICE_NAME: "my-app",
-    "posthog.distinct_id": USER_ID,      # the doc already shows this one
-    "$ai_session_id": SESSION_ID,        # add this line
-})
+import time, json, uuid
+
+for call in response.choices[0].message.tool_calls:
+    start = time.time()
+    result = get_weather(**json.loads(call.function.arguments))
+
+    posthog.capture(
+        distinct_id=distinct_id,
+        event="$ai_span",
+        properties={
+            "$ai_trace_id": trace_id,                  # ties the span to the generation
+            "$ai_session_id": session_id,
+            "$ai_span_id": str(uuid.uuid4()),
+            "$ai_span_name": call.function.name,
+            "$ai_input_state": call.function.arguments,
+            "$ai_output_state": result,
+            "$ai_latency": time.time() - start,
+        },
+    )
 ```
 
-Because the Resource is built once at import, both values must be resolvable at module scope. **When they are** — a CLI, a script, a worker, one process serving one user — this is correct and costs two lines. **When they aren't**, the fix is to choose a mechanism with per-call identity (usually the wrapper variant), *not* to defer the bootstrap into an init function so it can receive them. A per-request session on the Resource is wrong regardless: it is global to the process, so every conversation collapses into one id.
-
-If an app must stay on the raw OTel path *and* needs per-request values, use the standard `opentelemetry-processor-baggage` package; do not generate custom `SpanProcessor` classes in user codebases.
-
-If the app has no user identifier at all, leave the distinct id unset and say so in the report — anonymous is a finding, not a blocker. Never invent one, and never substitute the session id for it.
+The span joins the tree through `$ai_trace_id` — the same id the generation carried. Keep the capture next to the existing dispatch; do not restructure the tool loop to accommodate it.
 
-Two details that bite either way: the key is the literal `$ai_session_id` (there is no `posthog.session_id` alias — only `posthog.distinct_id` and `posthog.geoip_disable` are remapped at ingest), and its value may contain only letters, numbers, and `- _ ~ . @ ( ) ! ' : |`. A raw thread id carrying a `/` or `#` is rejected, so check the app's identifier before passing it straight through.
+**Framework variants are the exception.** Agent SDKs and the Vercel AI SDK emit tool spans through their own tracing (`ai.toolCall` and friends), so on those paths you add nothing. An app that registers no tools has no spans, and that is a complete outcome — never invent one to make a trace look fuller.
 
-### Always set a session — the graded property is cardinality
+## Always set a session — the graded property is cardinality
 
-Every instrumented app gets an `$ai_session_id`, including one-shot and single-trace apps. Tagging costs nothing, keeps session-level aggregation consistent across the project, and is already correct the day the app grows a second turn.
+Every instrumented app gets an `$ai_session_id`, including one-shot and single-trace apps. Tagging costs nothing, keeps aggregation consistent across the project, and is already right the day the app grows a second turn.
 
 When the app has no conversation field, **identify the boundary rather than skipping the step**: a CLI or worker run is a session; a server request carrying a thread id uses that; an agent framework run is a session even when it produces exactly one trace.
 
-What must be right is the **cardinality** — one id shared by the traces that belong together. A fresh id minted per call or per trace is *worse than no session at all*: it looks instrumented and groups nothing.
+What must be right is the **cardinality** — one id shared by the traces that belong together, and one trace per turn beneath it. An id minted per call is worse than none: it looks instrumented and groups nothing.
 
-Note the asymmetry with rule 1. Sessions: always set one, inferring the boundary if needed. Tools: never invent one.
-
-## The wrapper path — the fresh-UUID trap
-
-On PostHog's wrapper clients, per-call parameters carry the tree: `posthog_trace_id`, `posthog_distinct_id`, `posthog_properties` (where `$ai_session_id` goes), `posthog_groups`. Node equivalents are camelCase.
-
-`posthog_trace_id` auto-generates a **fresh UUID per call** when omitted, so calls that belong to one request must be handed a shared id explicitly:
-
-```python
-from uuid import uuid4
-
-def ask(self, question: str) -> str:
-    trace_id = str(uuid4())                       # one per request; reuse for every call in it
-    ph = dict(
-        posthog_trace_id=trace_id,
-        posthog_distinct_id=self.user_id,
-        posthog_properties={"$ai_session_id": self.thread_id},
-    )
-    ...
-```
+Two details that bite: the key is the literal `$ai_session_id` (there is no `posthog.session_id` alias), and its value may contain only letters, numbers, and `- _ ~ . @ ( ) ! ' : |`. A thread id carrying a `/` or `#` is rejected, so check before passing one straight through.
 
 ## Manual capture
 
-Only this path wires the tree by hand: every event in a request shares `$ai_trace_id`; child events set `$ai_parent_id` to the parent's trace or span id; `$ai_session_id` goes in properties. The manual-capture install page carries the full property tables.
+The manual path wires the same tree by hand: every event in a turn shares `$ai_trace_id`, spans carry their own `$ai_span_id`, and `$ai_session_id` goes in properties. The manual-capture install page carries the full property tables.
 
 ## Do not
 
-- Do not hand-author wrapper spans around ordinary helper functions — tool registration is what produces spans.
-- Do not create spans to fill out a trace when the app registers no tools. "No tools, so no spans" is a finding to report, not a gap to close.
-- Do not attach `$ai_session_id` or the distinct id to a hand-authored OTel span. Ingest keeps a span only when an **attribute key** starts with a provider prefix (`gen_ai.` / `ai.` / `traceloop.` / `pydantic_ai.`); the span *name* is never consulted, so such a span is dropped silently and takes those values with it.
-- Do not mint a fresh session id per call or per trace — cardinality is the graded property.
-- Do not put a runtime-varying `$ai_session_id` or distinct id on the Resource.
-- Do not rely on an omitted `posthog_trace_id` to group wrapper-SDK calls.
+- Do not omit `posthog_trace_id` and expect calls to group — each one gets a fresh UUID.
+- Do not mint a fresh session id per call or per turn. One conversation, one id.
+- Do not leave a gateway call reporting `$ai_provider: "openai"` — token pricing depends on it.
+- Do not restructure the app's tool loop to add span capture; the capture sits alongside the existing dispatch.
+- Do not create spans when the app registers no tools, and do not add them on framework paths that already emit their own.
+- Do not hand-author OpenTelemetry spans for any of this. These are `capture()` events, not OTel spans.
 - Do not ship a code path whose imports failed in the project's environment — go back to `1-begin.md` and take the next viable variant instead of shipping the caveat.
diff --git a/context/skills/ai-observability/references/5-verify.md b/context/skills/ai-observability/references/5-verify.md
index e5942066..82241280 100644
--- a/context/skills/ai-observability/references/5-verify.md
+++ b/context/skills/ai-observability/references/5-verify.md
@@ -1,25 +1,26 @@
 ---
 next_step: null
 title: AI Observability Setup - Verify
-description: Give the user a concrete way to trigger a request, and grade what lands in PostHog rather than what the diff contains
+description: Give the user a concrete way to trigger a turn, and grade the tree that lands in PostHog rather than the diff
 ---
 
-You've installed packages, wired the bootstrap, and attached the session id. The last thing this skill produces is a **verification path** the user can run themselves. Don't call the LLM from here — you don't have credentials, and the user should be the one to see the trace show up.
+You've installed the SDK, swapped in the wrapper, and attached identity. The last thing this skill produces is a **verification path** the user can run themselves. Don't call the LLM from here — you don't have credentials, and the user should be the one to see the trace show up.
 
 **Grade what lands in PostHog, not what the diff contains.** A correct-looking diff that produces ungrouped traces or a per-call session id is a failed run.
 
 ## What "correct" looks like for this app
 
-Derive the expectation from the two answers in `1-begin.md` before you look at anything:
+Derive the expectation from the answers in `1-begin.md` before you look at anything:
 
-- **One session** containing the traces that belong together — the cardinality you decided on. Two turns of one conversation means two traces under *one* `$ai_session_id`, not two ids.
-- **Each trace** holding the generations that request made, grouped rather than one trace per call.
-- **Spans only if the app registers tools** *and* the mechanism emits them (agent frameworks, Vercel AI, manual dispatch). On a raw provider SDK with an OTel instrumentor, a generations-only trace is the correct result even when the app uses tools — the instrumentor never sees the app's tool loop.
+- **One session** containing the turns that belong together. Two questions in one conversation means two traces under *one* `$ai_session_id`, not two ids.
+- **One trace per turn**, containing every generation that turn made — not one trace per model call.
+- **A span per tool execution**, if the app registers tools: `$ai_span` events sharing the turn's trace id. On framework variants these arrive on their own; on the wrapper path they're the ones you captured.
 - **Attribution** to the right person, if the app has a user identifier.
+- **The right provider** on gateway variants — `$ai_provider` should name Groq, DeepSeek, or whichever, never `openai`.
 
 ## What to tell the user
 
-Point them at the smallest existing code path that exercises one of the instrumented paths — ideally one that makes more than one model call, so grouping is visible. Pick from what you noted in `1-begin.md`:
+Point them at the smallest existing code path that exercises one instrumented turn — ideally one that makes more than one model call, or uses a tool, so the tree has depth. Pick from what you noted in `1-begin.md`:
 
 - A script (`scripts/`, `bin/`, a `package.json` script) → name it: "Run `npm run <script>`."
 - An API route → name it: "Hit `POST /api/chat` with a test message."
@@ -28,27 +29,27 @@ Point them at the smallest existing code path that exercises one of the instrume
 
 Then, in PostHog: open **Product → LLM Analytics → Traces** (not Generations), open the newest trace, and check it against the expectation above. Triggering a second turn in the same conversation is what proves the session id groups rather than splits. Generation properties worth spot-checking: `$ai_provider`, `$ai_model`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`.
 
-**Before handing over: prove the imports run.** In the project's environment, import what the instrumentation uses (e.g. `python -c "from posthog.ai.otel import PostHogSpanProcessor"`). If it fails — wrong package version, module not shipped in the installed release — go back to `1-begin.md` and switch variants. Do not ship non-running code with a caveat.
+**Before handing over: prove the imports run.** In the project's environment, import what the instrumentation uses (e.g. `python -c "from posthog.ai.openai import OpenAI"`). If it fails — wrong package version, module not shipped in the installed release — go back to `1-begin.md` and switch variants. Do not ship non-running code with a caveat.
 
 ## Failure modes
 
-- **Each generation is its own trace** → the calls aren't sharing a trace: no enclosing call structure on the OTel path, or no shared `posthog_trace_id` on the wrapper path.
-- **Every trace has a different `$ai_session_id`** → the id is being minted per call or per request instead of per conversation. This is the most common silent failure; it looks instrumented and groups nothing.
-- **No `$ai_session_id` at all** → OTel path: missing from the Resource. Wrapper path: not passed per call.
-- **`$ai_provider` names the wrong provider** → the app uses an OpenAI-compatible gateway and the run picked `openai-*`. Back to the `baseURL` rule in `1-begin.md`.
-- **Anonymous person** → no distinct id wired.
-- **Tool spans missing** → check the mechanism first. On a raw SDK + instrumentor this is expected and correct; do not "fix" it by hand-authoring spans, which ingest drops anyway.
+- **Each generation is its own trace** → `posthog_trace_id` wasn't passed, or a fresh one was generated per call instead of per turn.
+- **Every trace has a different `$ai_session_id`** → the id is minted per call or per turn instead of per conversation. The most common silent failure: it looks instrumented and groups nothing.
+- **No `$ai_session_id` at all** → not passed in `posthog_properties`.
+- **`$ai_provider` says `openai` on a gateway app** → the per-call override is missing, and token costs will be wrong.
+- **Anonymous person** → `posthog_distinct_id` not passed.
+- **Tool calls invisible** → on the wrapper path, the `$ai_span` captures are missing or aren't sharing the turn's `$ai_trace_id`.
 
 If nothing shows up at all within a minute:
 
-- Confirm the init actually runs — a `print` / `console.log` right after it proves the entry point loaded it.
-- Confirm the vendor SDK was imported *after* the init in the process's load order.
-- Confirm `POSTHOG_API_KEY` and `POSTHOG_HOST` are set in the env the process actually runs under, not just `.env.example`.
+- Confirm the wrapper is actually the client being called — an unswapped vendor client silently emits nothing.
+- Confirm the PostHog client has the project token and host, from the env the process actually runs under, not just `.env.example`.
+- In short-lived scripts, confirm events flush before exit.
 
 ## Do not
 
 - Do not run the vendor SDK yourself.
 - Do not embed API keys anywhere to enable a smoke test.
-- Do not report a run as done while an instrumentation import fails in the project's environment — switching variants is part of this skill, shipping the caveat is not.
-- Do not claim the integration works until the user has confirmed what actually landed. A confirmed flat generation is "bootstrap verified, structure unverified", not done.
+- Do not report a run as done while an instrumentation import fails in the project's environment.
+- Do not claim the integration works until the user has confirmed what actually landed. A confirmed flat generation is "generations verified, tree unverified", not done.
 - Do not report "wired" as "working" — if you never got confirmation, say "wired, unverified" and let the report surface it.

From 7fa18379ce9f51d72fd5c3dcb4d358fd1e16190e Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Mon, 3 Aug 2026 16:19:30 -0400
Subject: [PATCH 09/15] chore(ai-observability): pin six test variants to the
 docs PR branch
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

REVERT BEFORE PostHog/posthog#75976 MERGES.

The SDK-first procedure landed in d14ddb2, but the bundled install pages
still came from posthog.com, which serves master — so every zip paired
wrapper instructions with an OTel reference doc and the agent got
contradictory material.

posthog.com renders those pages from the monorepo onboarding .tsx at build
time (gatsby onPostBuild -> generateRawMarkdownPages), so there is no local
or preview URL carrying the new content: `gatsby develop` never emits the
.md files, and the posthog.com PR preview sources the monorepo from master.
Pointing docs_urls straight at the PR branch's raw .tsx is the only way to
see the real new content before merge. fetchDoc does no format validation,
so the TSX inlines fine; urlToFilename appends .md, hence openai.tsx.md.

Pinned (7 URLs, 6 variants — the ones with workbench fixtures):
openai-python, anthropic-python, vercel-ai, manual-capture, groq-node,
openai-agents. groq-node takes two files because groq.tsx is now just a
config object and _snippets/openai-compatible.tsx carries the steps.

On merge the branch is deleted and these 404. fetchDocOnce treats 404 as
non-retryable, and the stale-cache fallback only helps where an entry
already exists, so leaving these in place breaks the build — and these URLs
compile into manifest.json, which the wizard fetches. Revert this commit,
then `rm -rf .docs-cache && npm run build`.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 context/skills/ai-observability/config.yaml | 34 +++++++++++++++++----
 1 file changed, 28 insertions(+), 6 deletions(-)

diff --git a/context/skills/ai-observability/config.yaml b/context/skills/ai-observability/config.yaml
index 7ff6d2ad..086f1afb 100644
--- a/context/skills/ai-observability/config.yaml
+++ b/context/skills/ai-observability/config.yaml
@@ -21,7 +21,10 @@ variants:
     display_name: OpenAI (Python)
     tags: [openai, python, ai_observability]
     docs_urls:
-      - https://posthog.com/docs/ai-observability/installation/openai.md
+      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
+      # Revert to https://posthog.com/docs/ai-observability/installation/openai.md
+      # when that PR merges; the branch is deleted on merge and this 404s.
+      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/openai.tsx
       - https://posthog.com/docs/libraries/python.md
 
   - id: openai-node
@@ -37,7 +40,10 @@ variants:
     display_name: Anthropic (Python)
     tags: [anthropic, python, ai_observability]
     docs_urls:
-      - https://posthog.com/docs/ai-observability/installation/anthropic.md
+      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
+      # Revert to https://posthog.com/docs/ai-observability/installation/anthropic.md
+      # when that PR merges; the branch is deleted on merge and this 404s.
+      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/anthropic.tsx
       - https://posthog.com/docs/libraries/python.md
 
   - id: anthropic-node
@@ -68,7 +74,10 @@ variants:
     display_name: Vercel AI SDK
     tags: [vercel-ai, javascript_node, ai_observability]
     docs_urls:
-      - https://posthog.com/docs/ai-observability/installation/vercel-ai.md
+      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
+      # Revert to https://posthog.com/docs/ai-observability/installation/vercel-ai.md
+      # when that PR merges; the branch is deleted on merge and this 404s.
+      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/vercel-ai.tsx
       - https://posthog.com/docs/libraries/node.md
   - id: google-python
     framework: google-gemini
@@ -93,7 +102,11 @@ variants:
     description: PostHog AI Observability using explicit $ai_generation capture calls (no auto-instrumentation)
     tags: [manual-capture, ai_observability]
     docs_urls:
-      - https://posthog.com/docs/ai-observability/installation/manual-capture.md
+      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
+      # Revert to https://posthog.com/docs/ai-observability/installation/manual-capture.md
+      # when that PR merges; the branch is deleted on merge and this 404s.
+      # Note the upstream file is manual.tsx, not manual-capture.tsx.
+      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/manual.tsx
 
   - id: azure-openai-python
     framework: azure-openai
@@ -211,7 +224,13 @@ variants:
     display_name: Groq (Node)
     tags: [groq, javascript_node, ai_observability]
     docs_urls:
-      - https://posthog.com/docs/ai-observability/installation/groq.md
+      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
+      # Revert to https://posthog.com/docs/ai-observability/installation/groq.md
+      # when that PR merges; the branch is deleted on merge and this 404s.
+      # groq.tsx is now only a config object — the shared snippet carries the
+      # actual steps, so both are needed for this variant to be usable.
+      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/groq.tsx
+      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/_snippets/openai-compatible.tsx
       - https://posthog.com/docs/libraries/node.md
 
   - id: hugging-face-python
@@ -378,7 +397,10 @@ variants:
     description: PostHog AI Observability for the OpenAI Agents SDK (Python)
     tags: [openai-agents, python, ai_observability]
     docs_urls:
-      - https://posthog.com/docs/ai-observability/installation/openai-agents.md
+      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
+      # Revert to https://posthog.com/docs/ai-observability/installation/openai-agents.md
+      # when that PR merges; the branch is deleted on merge and this 404s.
+      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/openai-agents.tsx
       - https://posthog.com/docs/libraries/python.md
 
   - id: pydantic-ai

From 149ebffc64644565157184fd494e48c157cc5f05 Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Mon, 3 Aug 2026 16:28:23 -0400
Subject: [PATCH 10/15] fix(ai-observability): AWS Bedrock stays on
 OpenTelemetry

PostHog/posthog#75976 rewrote 40 onboarding pages to the SDK wrapper but did
not touch aws-bedrock.tsx, which still bootstraps a TracerProvider and
instruments the AWS SDK (opentelemetry-instrumentation-botocore in Python,
@opentelemetry/instrumentation-aws-sdk in Node). Bedrock has no wrapper
client, so it cannot follow the new default.

d14ddb2 claimed OTel was left to the opentelemetry-* variants and LlamaIndex
only, and that every direct provider uses the wrapper. Both were wrong for
Bedrock. Corrected in the 2-install package guidance and the 3-instrument
mechanism table.

Found by diffing the skill's 43 variant frameworks against the 42 onboarding
pages on the PR branch.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 context/skills/ai-observability/references/2-install.md    | 4 ++--
 context/skills/ai-observability/references/3-instrument.md | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/context/skills/ai-observability/references/2-install.md b/context/skills/ai-observability/references/2-install.md
index 2f8057d8..b9e62dac 100644
--- a/context/skills/ai-observability/references/2-install.md
+++ b/context/skills/ai-observability/references/2-install.md
@@ -10,7 +10,7 @@ Read the manifest first. If any required package is already declared, leave the
 
 ## The default: PostHog's SDK wrapper
 
-Every direct provider (OpenAI, Anthropic, Google, Azure OpenAI, Mistral, Cohere, …) and every OpenAI-compatible gateway (Groq, OpenRouter, Together, Ollama, DeepSeek, xAI, Perplexity, Fireworks, Cerebras, Hugging Face, Dedalus, Portkey, Helicone, Cloudflare AI Gateway) installs the same two things:
+Every direct provider (OpenAI, Anthropic, Google, Azure OpenAI, Mistral, Cohere, …) and every OpenAI-compatible gateway (Groq, OpenRouter, Together, Ollama, DeepSeek, xAI, Perplexity, Fireworks, Cerebras, Hugging Face, Dedalus, Portkey, Helicone, Cloudflare AI Gateway) installs the same two things — **AWS Bedrock is the one exception, and it is still OTel-based; see below**:
 
 ```
 posthog                # Python — ships the posthog.ai.<provider> wrapper clients
@@ -33,7 +33,7 @@ Agent and orchestration frameworks (LangChain, LangGraph, CrewAI, DSPy, LiteLLM,
 
 ## The OpenTelemetry variants
 
-Only the `opentelemetry-{python,node}` variants — and LlamaIndex, whose instrumentation is OTel-based — use the OTel packages:
+Three cases still use the OTel packages: the `opentelemetry-{python,node}` variants, LlamaIndex, and **AWS Bedrock** — Bedrock has no wrapper client and instruments the AWS SDK instead (`opentelemetry-instrumentation-botocore` in Python, `@opentelemetry/instrumentation-aws-sdk` in Node). Take its exact list from its install doc; it differs from the generic pair below.
 
 ```
 posthog[otel]                                   # Python — PostHog SDK + span processor
diff --git a/context/skills/ai-observability/references/3-instrument.md b/context/skills/ai-observability/references/3-instrument.md
index 9004efb2..09dcf058 100644
--- a/context/skills/ai-observability/references/3-instrument.md
+++ b/context/skills/ai-observability/references/3-instrument.md
@@ -8,9 +8,9 @@ description: Swap the vendor client for PostHog's wrapper - the default path for
 
 | Family | Who uses it | Shape |
 |---|---|---|
-| **Wrapper client** | every direct provider and OpenAI-compatible gateway | swap the client constructor, hand it a PostHog client |
+| **Wrapper client** | every direct provider and OpenAI-compatible gateway, except AWS Bedrock | swap the client constructor, hand it a PostHog client |
 | **Framework hook** | agent frameworks and Vercel AI | the framework's own callback, tracing processor, or `experimental_telemetry` |
-| **OTel bootstrap** | the `opentelemetry-*` variants and LlamaIndex only | `TracerProvider` + `PostHogSpanProcessor` |
+| **OTel bootstrap** | the `opentelemetry-*` variants, LlamaIndex, and AWS Bedrock | `TracerProvider` + `PostHogSpanProcessor` |
 | **Manual capture** | `manual-capture` | explicit `capture()` calls at the call site |
 
 Wire exactly one. This step makes generations land; attaching identity and capturing tool calls is `4-nesting.md`'s job, and it is mandatory, not optional polish.

From 85f516d0aa64843b1adb286193822914b828735f Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Tue, 4 Aug 2026 16:47:25 -0400
Subject: [PATCH 11/15] Revert "chore(ai-observability): pin six test variants
 to the docs PR branch"

This reverts commit 7fa18379ce9f51d72fd5c3dcb4d358fd1e16190e.
---
 context/skills/ai-observability/config.yaml | 34 ++++-----------------
 1 file changed, 6 insertions(+), 28 deletions(-)

diff --git a/context/skills/ai-observability/config.yaml b/context/skills/ai-observability/config.yaml
index 086f1afb..7ff6d2ad 100644
--- a/context/skills/ai-observability/config.yaml
+++ b/context/skills/ai-observability/config.yaml
@@ -21,10 +21,7 @@ variants:
     display_name: OpenAI (Python)
     tags: [openai, python, ai_observability]
     docs_urls:
-      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
-      # Revert to https://posthog.com/docs/ai-observability/installation/openai.md
-      # when that PR merges; the branch is deleted on merge and this 404s.
-      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/openai.tsx
+      - https://posthog.com/docs/ai-observability/installation/openai.md
       - https://posthog.com/docs/libraries/python.md
 
   - id: openai-node
@@ -40,10 +37,7 @@ variants:
     display_name: Anthropic (Python)
     tags: [anthropic, python, ai_observability]
     docs_urls:
-      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
-      # Revert to https://posthog.com/docs/ai-observability/installation/anthropic.md
-      # when that PR merges; the branch is deleted on merge and this 404s.
-      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/anthropic.tsx
+      - https://posthog.com/docs/ai-observability/installation/anthropic.md
       - https://posthog.com/docs/libraries/python.md
 
   - id: anthropic-node
@@ -74,10 +68,7 @@ variants:
     display_name: Vercel AI SDK
     tags: [vercel-ai, javascript_node, ai_observability]
     docs_urls:
-      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
-      # Revert to https://posthog.com/docs/ai-observability/installation/vercel-ai.md
-      # when that PR merges; the branch is deleted on merge and this 404s.
-      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/vercel-ai.tsx
+      - https://posthog.com/docs/ai-observability/installation/vercel-ai.md
       - https://posthog.com/docs/libraries/node.md
   - id: google-python
     framework: google-gemini
@@ -102,11 +93,7 @@ variants:
     description: PostHog AI Observability using explicit $ai_generation capture calls (no auto-instrumentation)
     tags: [manual-capture, ai_observability]
     docs_urls:
-      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
-      # Revert to https://posthog.com/docs/ai-observability/installation/manual-capture.md
-      # when that PR merges; the branch is deleted on merge and this 404s.
-      # Note the upstream file is manual.tsx, not manual-capture.tsx.
-      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/manual.tsx
+      - https://posthog.com/docs/ai-observability/installation/manual-capture.md
 
   - id: azure-openai-python
     framework: azure-openai
@@ -224,13 +211,7 @@ variants:
     display_name: Groq (Node)
     tags: [groq, javascript_node, ai_observability]
     docs_urls:
-      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
-      # Revert to https://posthog.com/docs/ai-observability/installation/groq.md
-      # when that PR merges; the branch is deleted on merge and this 404s.
-      # groq.tsx is now only a config object — the shared snippet carries the
-      # actual steps, so both are needed for this variant to be usable.
-      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/groq.tsx
-      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/_snippets/openai-compatible.tsx
+      - https://posthog.com/docs/ai-observability/installation/groq.md
       - https://posthog.com/docs/libraries/node.md
 
   - id: hugging-face-python
@@ -397,10 +378,7 @@ variants:
     description: PostHog AI Observability for the OpenAI Agents SDK (Python)
     tags: [openai-agents, python, ai_observability]
     docs_urls:
-      # TEMPORARY — pinned to PostHog/posthog#75976 (branch marco/update-aio-docs).
-      # Revert to https://posthog.com/docs/ai-observability/installation/openai-agents.md
-      # when that PR merges; the branch is deleted on merge and this 404s.
-      - https://raw.githubusercontent.com/PostHog/posthog/marco/update-aio-docs/docs/onboarding/ai-observability/openai-agents.tsx
+      - https://posthog.com/docs/ai-observability/installation/openai-agents.md
       - https://posthog.com/docs/libraries/python.md
 
   - id: pydantic-ai

From a0ff0d68b8275cf8be7028c66e67d4e462221c79 Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Tue, 4 Aug 2026 16:48:45 -0400
Subject: [PATCH 12/15] chore(ai-observability): drop the stale-doc escape
 hatch

3-instrument told the agent that a bundled page still showing a
TracerProvider bootstrap "predates the SDK-first rewrite" and that the
wrapper wins. That was true only while the docs were unmerged.

Now that posthog.com serves the rewritten pages it is actively wrong: AWS
Bedrock legitimately shows a TracerProvider (it was never part of #75976 and
has no wrapper client), so the note would push a Bedrock run onto a
mechanism that does not exist for it.

Follows the revert of the PR-branch pin in 85f516d.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 context/skills/ai-observability/references/3-instrument.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/context/skills/ai-observability/references/3-instrument.md b/context/skills/ai-observability/references/3-instrument.md
index 09dcf058..ab5c2f0a 100644
--- a/context/skills/ai-observability/references/3-instrument.md
+++ b/context/skills/ai-observability/references/3-instrument.md
@@ -15,8 +15,6 @@ description: Swap the vendor client for PostHog's wrapper - the default path for
 
 Wire exactly one. This step makes generations land; attaching identity and capturing tool calls is `4-nesting.md`'s job, and it is mandatory, not optional polish.
 
-> If the bundled install page for this variant still shows a `TracerProvider` + `PostHogSpanProcessor` bootstrap for a provider or gateway, it predates the SDK-first rewrite. The wrapper shape below wins.
-
 ## Match the doc's shape
 
 **Copy the install doc's code block and change only the values.** The setup belongs at module level where the client is constructed — typically under ten lines. Adding structure around it is the most common way this step goes wrong:

From 63b08f81ef9cb00f7b03cc939d9f9a9d7695bd75 Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Tue, 4 Aug 2026 16:51:35 -0400
Subject: [PATCH 13/15] chore: drop the stray package-lock.json
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The repo is pnpm — main tracks pnpm-lock.yaml and no package-lock.json. An
npm install during this branch's work generated one, and since it is not
gitignored it got committed in b3c0dec, adding 2815 lines of noise to the
diff for zero dependency change (package.json itself was never touched).

pnpm-lock.yaml is unmodified, so nothing about the dependency set changes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 package-lock.json | 2815 ---------------------------------------------
 1 file changed, 2815 deletions(-)
 delete mode 100644 package-lock.json

diff --git a/package-lock.json b/package-lock.json
deleted file mode 100644
index 82a54794..00000000
--- a/package-lock.json
+++ /dev/null
@@ -1,2815 +0,0 @@
-{
-  "name": "@posthog/context-mill",
-  "version": "1.2.0",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "@posthog/context-mill",
-      "version": "1.2.0",
-      "dependencies": {
-        "@anthropic-ai/sdk": "^0.95.0",
-        "@posthog/warlock": "^0.2.2",
-        "gray-matter": "^4.0.3",
-        "js-yaml": "^4.1.1"
-      },
-      "devDependencies": {
-        "archiver": "^7.0.1",
-        "chokidar": "^4.0.3",
-        "vitest": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=20.11.0"
-      }
-    },
-    "node_modules/@anthropic-ai/sdk": {
-      "version": "0.95.2",
-      "resolved": "https://registry.npmjs.org/@anthropic-ai/sdk/-/sdk-0.95.2.tgz",
-      "integrity": "sha512-Egddwo3sheo1PzUrMkZnH6VkQYwS0h/b/i8vSK8Ta9M45UQipAMeDFH57dYuDAfXMEUUGeKw6CMlremgMZgrSQ==",
-      "license": "MIT",
-      "dependencies": {
-        "json-schema-to-ts": "^3.1.1",
-        "standardwebhooks": "^1.0.0"
-      },
-      "bin": {
-        "anthropic-ai-sdk": "bin/cli"
-      },
-      "peerDependencies": {
-        "zod": "^3.25.0 || ^4.0.0"
-      },
-      "peerDependenciesMeta": {
-        "zod": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/@babel/runtime": {
-      "version": "7.29.7",
-      "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.7.tgz",
-      "integrity": "sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=6.9.0"
-      }
-    },
-    "node_modules/@esbuild/aix-ppc64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
-      "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
-      "cpu": [
-        "ppc64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "aix"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/android-arm": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
-      "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "android"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/android-arm64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
-      "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "android"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/android-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
-      "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "android"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/darwin-arm64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
-      "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/darwin-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
-      "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/freebsd-arm64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
-      "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "freebsd"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/freebsd-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
-      "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "freebsd"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/linux-arm": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
-      "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/linux-arm64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
-      "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/linux-ia32": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
-      "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
-      "cpu": [
-        "ia32"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/linux-loong64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
-      "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
-      "cpu": [
-        "loong64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/linux-mips64el": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
-      "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
-      "cpu": [
-        "mips64el"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/linux-ppc64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
-      "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
-      "cpu": [
-        "ppc64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/linux-riscv64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
-      "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
-      "cpu": [
-        "riscv64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/linux-s390x": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
-      "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
-      "cpu": [
-        "s390x"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/linux-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
-      "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/netbsd-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
-      "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "netbsd"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/openbsd-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
-      "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "openbsd"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/sunos-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
-      "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "sunos"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/win32-arm64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
-      "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/win32-ia32": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
-      "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
-      "cpu": [
-        "ia32"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@esbuild/win32-x64": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
-      "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@isaacs/cliui": {
-      "version": "8.0.2",
-      "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
-      "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "string-width": "^5.1.2",
-        "string-width-cjs": "npm:string-width@^4.2.0",
-        "strip-ansi": "^7.0.1",
-        "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
-        "wrap-ansi": "^8.1.0",
-        "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
-      },
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/@jridgewell/sourcemap-codec": {
-      "version": "1.5.5",
-      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
-      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/@pkgjs/parseargs": {
-      "version": "0.11.0",
-      "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz",
-      "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==",
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "engines": {
-        "node": ">=14"
-      }
-    },
-    "node_modules/@posthog/warlock": {
-      "version": "0.2.3",
-      "resolved": "https://registry.npmjs.org/@posthog/warlock/-/warlock-0.2.3.tgz",
-      "integrity": "sha512-ZlKWA8jU5IlPW5nZ40aE5/MYq/z3HeuKjLiTlH+OyffvDOQkQQ24nBNrMI4tLagGb2tkiNv5l9puAKlSllzWRw==",
-      "license": "MIT",
-      "dependencies": {
-        "@virustotal/yara-x": "^1.15.0"
-      },
-      "engines": {
-        "node": "^20.20.0 || >=22.22.0"
-      }
-    },
-    "node_modules/@rollup/rollup-android-arm-eabi": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.62.2.tgz",
-      "integrity": "sha512-6o7ZLZK+BeenkZCFNDXqpbjw9bD6nuWonvS/lwQJp7NoVVxm6p3qE7qQ5jGuBjiFsgvqjD8mZAU5oWxTmbOeOg==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "android"
-      ]
-    },
-    "node_modules/@rollup/rollup-android-arm64": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.62.2.tgz",
-      "integrity": "sha512-BaH7BllCACHoH1LguOU56UItGfUWjujlO65kS9LAodViaN4bwIKd7oeW/ZHJ/4ljr/7MIiENnNy3HJ0zXv8Zkw==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "android"
-      ]
-    },
-    "node_modules/@rollup/rollup-darwin-arm64": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.62.2.tgz",
-      "integrity": "sha512-v39RCCvj4He82I9sFmk+M1VZ0PLM9sfsLVikjfx2hYBNALhrrOR2D3JjQA6AhlaSOgcR+RzrKY7e1+bT6SUO/A==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "darwin"
-      ]
-    },
-    "node_modules/@rollup/rollup-darwin-x64": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.62.2.tgz",
-      "integrity": "sha512-yl0y2vq3S3lHeuXhEdss6TWfKW8vkujImO12tn4ZkG/4oghr09LvdYm2RElVjokTQiUvDUGXLGsYeLqUMCKpGA==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "darwin"
-      ]
-    },
-    "node_modules/@rollup/rollup-freebsd-arm64": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.62.2.tgz",
-      "integrity": "sha512-tT4pvt4qXD+vEoezupCWi+a1F0vvDiksiHc+PxRlYTOH1I6/X4id9jPxTP+Fg+545euaFT1jJVs4CEdHZAU1vw==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "freebsd"
-      ]
-    },
-    "node_modules/@rollup/rollup-freebsd-x64": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.62.2.tgz",
-      "integrity": "sha512-6nU5F2wCW+qvCBhTn1pdIU3bzsIoF7EUwsCDRxilWGprQR6yd508YnH9+OKFCwpfS8pjZqDUmnCAr7exax0XCg==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "freebsd"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.62.2.tgz",
-      "integrity": "sha512-n1GJHPOvpIfhi3TmrCeh6S6URt9BFCt0KQE3qvexyGCTAKpR4Lg+eWvNZEqu7epxwus/8ElT3hacYEucm49SZg==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "libc": [
-        "glibc"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.62.2.tgz",
-      "integrity": "sha512-JqgflS8wEB+UXV/vS1RpRbifGBeN4D5lz8D8oOFbFZw4vedvdOgCFAjfBmIMdW3yL10XpQQ0Ambepw6MXrhOnA==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "libc": [
-        "musl"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-arm64-gnu": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.62.2.tgz",
-      "integrity": "sha512-wnFJkogWvN4jm/hQRF2UBaeUmk20j5+DmHvoyWii2b8HJDyvz1MF2OU/6ynXt2KR63rbZLWkFpoytpdc/yBuSA==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "libc": [
-        "glibc"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-arm64-musl": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.62.2.tgz",
-      "integrity": "sha512-HVu2bp0zhvJ8xHEV9+UUs7S90VadmBSY3LcIMvozbPo4AuMGDWlz3ymHLHZPX4hR67TKTt8Qp5PJ5RBg/i+RMQ==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "libc": [
-        "musl"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-loong64-gnu": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.62.2.tgz",
-      "integrity": "sha512-mQqqAV8QaoSgr9I2fKDLY2BAVvmKjWoGiu/cSYQonsLvtqwEn1E4QYfnCOcp5zoEqNhsDYin1s6jx/VJmrxlZg==",
-      "cpu": [
-        "loong64"
-      ],
-      "dev": true,
-      "libc": [
-        "glibc"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-loong64-musl": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.62.2.tgz",
-      "integrity": "sha512-IxKLoxCQ2IWi6bT2akyDUBGsOImDKB+sPp4EsTmwFQ/fMwpCKm8uLSSgP/Kx/QYUgKis6SEZ5/Nlhup0DIA0PQ==",
-      "cpu": [
-        "loong64"
-      ],
-      "dev": true,
-      "libc": [
-        "musl"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-ppc64-gnu": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.62.2.tgz",
-      "integrity": "sha512-Mk5ha2RQSgyFfmYYLkBpPnUk8D8FriBxesO1u9O75X0mHgXL1UQcH5Itl2lurWL2tj0RxV9b9tJgipac0hRY9A==",
-      "cpu": [
-        "ppc64"
-      ],
-      "dev": true,
-      "libc": [
-        "glibc"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-ppc64-musl": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.62.2.tgz",
-      "integrity": "sha512-CjvEnqJL/0/TQ3TXX3OPIJ/kmBellrWd4heXUmHeJlTnmwjKpSJzoehLaL6Xk0ZnMHBu9dZuFADNOrtjF4v+2w==",
-      "cpu": [
-        "ppc64"
-      ],
-      "dev": true,
-      "libc": [
-        "musl"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.62.2.tgz",
-      "integrity": "sha512-1SiZbzwdkaDURsew/tSOrooKiYy7EQGT6m8ufavAi9NEyQb/6VuIxFXAL1fqa4iZe3g4NbNk4P7J32z2tw5Mgg==",
-      "cpu": [
-        "riscv64"
-      ],
-      "dev": true,
-      "libc": [
-        "glibc"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-riscv64-musl": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.62.2.tgz",
-      "integrity": "sha512-nQts12zJ3NQRoE6uYljOH89v7szzLDvG2JD/vsX+vGXU8w/At1GowTZ5/7qeFQ8m7L55rpR8Okugnuo5bgjy2Q==",
-      "cpu": [
-        "riscv64"
-      ],
-      "dev": true,
-      "libc": [
-        "musl"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-s390x-gnu": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.62.2.tgz",
-      "integrity": "sha512-E9/ll019jhPIJgpzfZoIkBGhcz+kKNgVWYRY0zr9srBdPPFVpvOKW8VaJKUbeK+eZXyQF9ltME+Kk6affeaPgg==",
-      "cpu": [
-        "s390x"
-      ],
-      "dev": true,
-      "libc": [
-        "glibc"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-x64-gnu": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.62.2.tgz",
-      "integrity": "sha512-5BqxR/pshjey51iliyzTD5Xi3EN0aLmQ2lZ3lvefVV9c82BvrLo2/6OT55iifpWBufs6kdwWbuOKS841DrmK9A==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "libc": [
-        "glibc"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-linux-x64-musl": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.62.2.tgz",
-      "integrity": "sha512-uNN83XxQrRAh/w0/pmAfibcwyb6YWt4gP+dpnQKPVJshAloQ785ii8CT8ZCIxkGg9opVsvAlGhFitSm6D1Jjpg==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "libc": [
-        "musl"
-      ],
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "linux"
-      ]
-    },
-    "node_modules/@rollup/rollup-openbsd-x64": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.62.2.tgz",
-      "integrity": "sha512-srjEIxSH3LRnJN6THczDHWQplqEMFiAJrTab0msUryh9kwNpkICf3Ea6q6MN/2cZwRFUNx5w+h6Hpi4QuHS6Zg==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "openbsd"
-      ]
-    },
-    "node_modules/@rollup/rollup-openharmony-arm64": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.62.2.tgz",
-      "integrity": "sha512-8hOJnxgbyObnCm5AlRA3A931xX19xq80RjVTKgJOvEKWqJruP/Uf12IbAOaDjjEXYRewwHLfmF0YRIdK3OwKWA==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "openharmony"
-      ]
-    },
-    "node_modules/@rollup/rollup-win32-arm64-msvc": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.62.2.tgz",
-      "integrity": "sha512-mmF4AY1i0hG/bLWUctUq59gtmgaSIRa3cu/A3JFRp/sCNEme2bgDEiDS22P9FbnJB8NJNF4jPJiSP5RHQpUTDg==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@rollup/rollup-win32-ia32-msvc": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.62.2.tgz",
-      "integrity": "sha512-DZgkknc6jhHrk46V25vbAM0zZkyP0nSDkJB8/dRkLTxv470dOmWDqGoEJl/9A0dFfS7yE3REOwNDxpHwSLSt0Q==",
-      "cpu": [
-        "ia32"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@rollup/rollup-win32-x64-gnu": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.62.2.tgz",
-      "integrity": "sha512-T6xr6ucWSFto+VGajA8YH26LdpHRuP4YLHEKAtCWvJDOlnmWcDZVCI2Jmjr+IFHDlt2zRaTAKE4tfjTaWLgJBg==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@rollup/rollup-win32-x64-msvc": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.62.2.tgz",
-      "integrity": "sha512-BfzEnDJOt9T8M989/lA37EcJgat01wLRnoi5dQf3QzOH7jzpqTAzdDbVfRljVr5r+jzKqpbHeyOfAaXxAd0PAA==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "win32"
-      ]
-    },
-    "node_modules/@stablelib/base64": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/@stablelib/base64/-/base64-1.0.1.tgz",
-      "integrity": "sha512-1bnPQqSxSuc3Ii6MhBysoWCg58j97aUjuCSZrGSmDxNqtytIi0k8utUenAwTZN4V5mXXYGsVUI9zeBqy+jBOSQ==",
-      "license": "MIT"
-    },
-    "node_modules/@types/estree": {
-      "version": "1.0.9",
-      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",
-      "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/@virustotal/yara-x": {
-      "version": "1.19.0",
-      "resolved": "https://registry.npmjs.org/@virustotal/yara-x/-/yara-x-1.19.0.tgz",
-      "integrity": "sha512-yCVb8hLVYB6Yb6uFLmndDZL12/O1C28knNFSzarmKupMt+dLQwr5FjsA26mBDY0bBbPT6GkUGMe2bzXIVNM/oQ==",
-      "license": "BSD-3-Clause"
-    },
-    "node_modules/@vitest/expect": {
-      "version": "2.1.9",
-      "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-2.1.9.tgz",
-      "integrity": "sha512-UJCIkTBenHeKT1TTlKMJWy1laZewsRIzYighyYiJKZreqtdxSos/S1t+ktRMQWu2CKqaarrkeszJx1cgC5tGZw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@vitest/spy": "2.1.9",
-        "@vitest/utils": "2.1.9",
-        "chai": "^5.1.2",
-        "tinyrainbow": "^1.2.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/vitest"
-      }
-    },
-    "node_modules/@vitest/mocker": {
-      "version": "2.1.9",
-      "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-2.1.9.tgz",
-      "integrity": "sha512-tVL6uJgoUdi6icpxmdrn5YNo3g3Dxv+IHJBr0GXHaEdTcw3F+cPKnsXFhli6nO+f/6SDKPHEK1UN+k+TQv0Ehg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@vitest/spy": "2.1.9",
-        "estree-walker": "^3.0.3",
-        "magic-string": "^0.30.12"
-      },
-      "funding": {
-        "url": "https://opencollective.com/vitest"
-      },
-      "peerDependencies": {
-        "msw": "^2.4.9",
-        "vite": "^5.0.0"
-      },
-      "peerDependenciesMeta": {
-        "msw": {
-          "optional": true
-        },
-        "vite": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/@vitest/pretty-format": {
-      "version": "2.1.9",
-      "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-2.1.9.tgz",
-      "integrity": "sha512-KhRIdGV2U9HOUzxfiHmY8IFHTdqtOhIzCpd8WRdJiE7D/HUcZVD0EgQCVjm+Q9gkUXWgBvMmTtZgIG48wq7sOQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "tinyrainbow": "^1.2.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/vitest"
-      }
-    },
-    "node_modules/@vitest/runner": {
-      "version": "2.1.9",
-      "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-2.1.9.tgz",
-      "integrity": "sha512-ZXSSqTFIrzduD63btIfEyOmNcBmQvgOVsPNPe0jYtESiXkhd8u2erDLnMxmGrDCwHCCHE7hxwRDCT3pt0esT4g==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@vitest/utils": "2.1.9",
-        "pathe": "^1.1.2"
-      },
-      "funding": {
-        "url": "https://opencollective.com/vitest"
-      }
-    },
-    "node_modules/@vitest/snapshot": {
-      "version": "2.1.9",
-      "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-2.1.9.tgz",
-      "integrity": "sha512-oBO82rEjsxLNJincVhLhaxxZdEtV0EFHMK5Kmx5sJ6H9L183dHECjiefOAdnqpIgT5eZwT04PoggUnW88vOBNQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@vitest/pretty-format": "2.1.9",
-        "magic-string": "^0.30.12",
-        "pathe": "^1.1.2"
-      },
-      "funding": {
-        "url": "https://opencollective.com/vitest"
-      }
-    },
-    "node_modules/@vitest/spy": {
-      "version": "2.1.9",
-      "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-2.1.9.tgz",
-      "integrity": "sha512-E1B35FwzXXTs9FHNK6bDszs7mtydNi5MIfUWpceJ8Xbfb1gBMscAnwLbEu+B44ed6W3XjL9/ehLPHR1fkf1KLQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "tinyspy": "^3.0.2"
-      },
-      "funding": {
-        "url": "https://opencollective.com/vitest"
-      }
-    },
-    "node_modules/@vitest/utils": {
-      "version": "2.1.9",
-      "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-2.1.9.tgz",
-      "integrity": "sha512-v0psaMSkNJ3A2NMrUEHFRzJtDPFn+/VWZ5WxImB21T9fjucJRmS7xCS3ppEnARb9y11OAzaD+P2Ps+b+BGX5iQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@vitest/pretty-format": "2.1.9",
-        "loupe": "^3.1.2",
-        "tinyrainbow": "^1.2.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/vitest"
-      }
-    },
-    "node_modules/abort-controller": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/abort-controller/-/abort-controller-3.0.0.tgz",
-      "integrity": "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "event-target-shim": "^5.0.0"
-      },
-      "engines": {
-        "node": ">=6.5"
-      }
-    },
-    "node_modules/ansi-regex": {
-      "version": "6.2.2",
-      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz",
-      "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
-      }
-    },
-    "node_modules/ansi-styles": {
-      "version": "6.2.3",
-      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
-      "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
-      }
-    },
-    "node_modules/archiver": {
-      "version": "7.0.1",
-      "resolved": "https://registry.npmjs.org/archiver/-/archiver-7.0.1.tgz",
-      "integrity": "sha512-ZcbTaIqJOfCc03QwD468Unz/5Ir8ATtvAHsK+FdXbDIbGfihqh9mrvdcYunQzqn4HrvWWaFyaxJhGZagaJJpPQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "archiver-utils": "^5.0.2",
-        "async": "^3.2.4",
-        "buffer-crc32": "^1.0.0",
-        "readable-stream": "^4.0.0",
-        "readdir-glob": "^1.1.2",
-        "tar-stream": "^3.0.0",
-        "zip-stream": "^6.0.1"
-      },
-      "engines": {
-        "node": ">= 14"
-      }
-    },
-    "node_modules/archiver-utils": {
-      "version": "5.0.2",
-      "resolved": "https://registry.npmjs.org/archiver-utils/-/archiver-utils-5.0.2.tgz",
-      "integrity": "sha512-wuLJMmIBQYCsGZgYLTy5FIB2pF6Lfb6cXMSF8Qywwk3t20zWnAi7zLcQFdKQmIB8wyZpY5ER38x08GbwtR2cLA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "glob": "^10.0.0",
-        "graceful-fs": "^4.2.0",
-        "is-stream": "^2.0.1",
-        "lazystream": "^1.0.0",
-        "lodash": "^4.17.15",
-        "normalize-path": "^3.0.0",
-        "readable-stream": "^4.0.0"
-      },
-      "engines": {
-        "node": ">= 14"
-      }
-    },
-    "node_modules/argparse": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
-      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
-      "license": "Python-2.0"
-    },
-    "node_modules/assertion-error": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz",
-      "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=12"
-      }
-    },
-    "node_modules/async": {
-      "version": "3.2.6",
-      "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz",
-      "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/b4a": {
-      "version": "1.8.1",
-      "resolved": "https://registry.npmjs.org/b4a/-/b4a-1.8.1.tgz",
-      "integrity": "sha512-aiqre1Nr0B/6DgE2N5vwTc+2/oQZ4Wh1t4NznYY4E00y8LCt6NqdRv81so00oo27D8MVKTpUa/MwUUtBLXCoDw==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "peerDependencies": {
-        "react-native-b4a": "*"
-      },
-      "peerDependenciesMeta": {
-        "react-native-b4a": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/balanced-match": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
-      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/bare-events": {
-      "version": "2.9.1",
-      "resolved": "https://registry.npmjs.org/bare-events/-/bare-events-2.9.1.tgz",
-      "integrity": "sha512-Z0oHEHAFDZkffN8Qc39zNZjQlMDkPJRyyyZieU1VH7u8c5S+qHZ2S8ixdKIAxEjfHO7FJxXmJWgteOghVanIsg==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "peerDependencies": {
-        "bare-abort-controller": "*"
-      },
-      "peerDependenciesMeta": {
-        "bare-abort-controller": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/bare-fs": {
-      "version": "4.7.4",
-      "resolved": "https://registry.npmjs.org/bare-fs/-/bare-fs-4.7.4.tgz",
-      "integrity": "sha512-y1kC+ffIx/tPLdTE693uNjHfzTfr+ravR5tvWlMXe25nELbkqV400S71qHDwbkAQ1FVEZobB1NFRzFbCCcyBCQ==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "bare-events": "^2.5.4",
-        "bare-path": "^3.0.0",
-        "bare-stream": "^2.6.4",
-        "bare-url": "^2.2.2",
-        "fast-fifo": "^1.3.2"
-      },
-      "engines": {
-        "bare": ">=1.16.0"
-      },
-      "peerDependencies": {
-        "bare-buffer": "*"
-      },
-      "peerDependenciesMeta": {
-        "bare-buffer": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/bare-path": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/bare-path/-/bare-path-3.1.1.tgz",
-      "integrity": "sha512-JprUlveX3QjApC1cTpsUOiscADftCGVWkzitbHsRqv84hzYwYHw2mbluddsq5TvI8mH/8Ov1f4BiMAdcB0oYnQ==",
-      "dev": true,
-      "license": "Apache-2.0"
-    },
-    "node_modules/bare-stream": {
-      "version": "2.13.3",
-      "resolved": "https://registry.npmjs.org/bare-stream/-/bare-stream-2.13.3.tgz",
-      "integrity": "sha512-Kc+brLqvEqGkjyfiwJmImAOqLZL7OsoLKuavx+hJjgVV3nLTOjloJyPMFxjUPerGGHrNH0fLU06jjykMLWrERQ==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "b4a": "^1.8.1",
-        "streamx": "^2.25.0",
-        "teex": "^1.0.1"
-      },
-      "peerDependencies": {
-        "bare-abort-controller": "*",
-        "bare-buffer": "*",
-        "bare-events": "*"
-      },
-      "peerDependenciesMeta": {
-        "bare-abort-controller": {
-          "optional": true
-        },
-        "bare-buffer": {
-          "optional": true
-        },
-        "bare-events": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/bare-url": {
-      "version": "2.4.6",
-      "resolved": "https://registry.npmjs.org/bare-url/-/bare-url-2.4.6.tgz",
-      "integrity": "sha512-iQxPClE07hETVpbRoX7JXX3v/ZQViCxe/SYCxylRLzdEx1xJAufPptfiOqR8tqiCtmbtMDANKWszzjLu1PMAZQ==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "bare-path": "^3.0.0"
-      }
-    },
-    "node_modules/base64-js": {
-      "version": "1.5.1",
-      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
-      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/brace-expansion": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.2.tgz",
-      "integrity": "sha512-w5JZcKgdhDOgOwm8H+KgbosopHMuGcl6qbulwjtz3SM7I7P3yW1eAjzMPLrIE+NQ9vjgANKHWeMHnrT0OXW1oA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "balanced-match": "^1.0.0"
-      }
-    },
-    "node_modules/buffer": {
-      "version": "6.0.3",
-      "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz",
-      "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "base64-js": "^1.3.1",
-        "ieee754": "^1.2.1"
-      }
-    },
-    "node_modules/buffer-crc32": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-1.0.0.tgz",
-      "integrity": "sha512-Db1SbgBS/fg/392AblrMJk97KggmvYhr4pB5ZIMTWtaivCPMWLkmb7m21cJvpvgK+J3nsU2CmmixNBZx4vFj/w==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8.0.0"
-      }
-    },
-    "node_modules/cac": {
-      "version": "6.7.14",
-      "resolved": "https://registry.npmjs.org/cac/-/cac-6.7.14.tgz",
-      "integrity": "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/chai": {
-      "version": "5.3.3",
-      "resolved": "https://registry.npmjs.org/chai/-/chai-5.3.3.tgz",
-      "integrity": "sha512-4zNhdJD/iOjSH0A05ea+Ke6MU5mmpQcbQsSOkgdaUMJ9zTlDTD/GYlwohmIE2u0gaxHYiVHEn1Fw9mZ/ktJWgw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "assertion-error": "^2.0.1",
-        "check-error": "^2.1.1",
-        "deep-eql": "^5.0.1",
-        "loupe": "^3.1.0",
-        "pathval": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/check-error": {
-      "version": "2.1.3",
-      "resolved": "https://registry.npmjs.org/check-error/-/check-error-2.1.3.tgz",
-      "integrity": "sha512-PAJdDJusoxnwm1VwW07VWwUN1sl7smmC3OKggvndJFadxxDRyFJBX/ggnu/KE4kQAB7a3Dp8f/YXC1FlUprWmA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 16"
-      }
-    },
-    "node_modules/chokidar": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.3.tgz",
-      "integrity": "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "readdirp": "^4.0.1"
-      },
-      "engines": {
-        "node": ">= 14.16.0"
-      },
-      "funding": {
-        "url": "https://paulmillr.com/funding/"
-      }
-    },
-    "node_modules/color-convert": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
-      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "color-name": "~1.1.4"
-      },
-      "engines": {
-        "node": ">=7.0.0"
-      }
-    },
-    "node_modules/color-name": {
-      "version": "1.1.4",
-      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
-      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/compress-commons": {
-      "version": "6.0.2",
-      "resolved": "https://registry.npmjs.org/compress-commons/-/compress-commons-6.0.2.tgz",
-      "integrity": "sha512-6FqVXeETqWPoGcfzrXb37E50NP0LXT8kAMu5ooZayhWWdgEY4lBEEcbQNXtkuKQsGduxiIcI4gOTsxTmuq/bSg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "crc-32": "^1.2.0",
-        "crc32-stream": "^6.0.0",
-        "is-stream": "^2.0.1",
-        "normalize-path": "^3.0.0",
-        "readable-stream": "^4.0.0"
-      },
-      "engines": {
-        "node": ">= 14"
-      }
-    },
-    "node_modules/core-util-is": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
-      "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/crc-32": {
-      "version": "1.2.2",
-      "resolved": "https://registry.npmjs.org/crc-32/-/crc-32-1.2.2.tgz",
-      "integrity": "sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "bin": {
-        "crc32": "bin/crc32.njs"
-      },
-      "engines": {
-        "node": ">=0.8"
-      }
-    },
-    "node_modules/crc32-stream": {
-      "version": "6.0.0",
-      "resolved": "https://registry.npmjs.org/crc32-stream/-/crc32-stream-6.0.0.tgz",
-      "integrity": "sha512-piICUB6ei4IlTv1+653yq5+KoqfBYmj9bw6LqXoOneTMDXk5nM1qt12mFW1caG3LlJXEKW1Bp0WggEmIfQB34g==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "crc-32": "^1.2.0",
-        "readable-stream": "^4.0.0"
-      },
-      "engines": {
-        "node": ">= 14"
-      }
-    },
-    "node_modules/cross-spawn": {
-      "version": "7.0.6",
-      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
-      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "path-key": "^3.1.0",
-        "shebang-command": "^2.0.0",
-        "which": "^2.0.1"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/debug": {
-      "version": "4.4.3",
-      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
-      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ms": "^2.1.3"
-      },
-      "engines": {
-        "node": ">=6.0"
-      },
-      "peerDependenciesMeta": {
-        "supports-color": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/deep-eql": {
-      "version": "5.0.2",
-      "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-5.0.2.tgz",
-      "integrity": "sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/eastasianwidth": {
-      "version": "0.2.0",
-      "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
-      "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/emoji-regex": {
-      "version": "9.2.2",
-      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
-      "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/es-module-lexer": {
-      "version": "1.7.0",
-      "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.7.0.tgz",
-      "integrity": "sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/esbuild": {
-      "version": "0.21.5",
-      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
-      "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
-      "dev": true,
-      "hasInstallScript": true,
-      "license": "MIT",
-      "bin": {
-        "esbuild": "bin/esbuild"
-      },
-      "engines": {
-        "node": ">=12"
-      },
-      "optionalDependencies": {
-        "@esbuild/aix-ppc64": "0.21.5",
-        "@esbuild/android-arm": "0.21.5",
-        "@esbuild/android-arm64": "0.21.5",
-        "@esbuild/android-x64": "0.21.5",
-        "@esbuild/darwin-arm64": "0.21.5",
-        "@esbuild/darwin-x64": "0.21.5",
-        "@esbuild/freebsd-arm64": "0.21.5",
-        "@esbuild/freebsd-x64": "0.21.5",
-        "@esbuild/linux-arm": "0.21.5",
-        "@esbuild/linux-arm64": "0.21.5",
-        "@esbuild/linux-ia32": "0.21.5",
-        "@esbuild/linux-loong64": "0.21.5",
-        "@esbuild/linux-mips64el": "0.21.5",
-        "@esbuild/linux-ppc64": "0.21.5",
-        "@esbuild/linux-riscv64": "0.21.5",
-        "@esbuild/linux-s390x": "0.21.5",
-        "@esbuild/linux-x64": "0.21.5",
-        "@esbuild/netbsd-x64": "0.21.5",
-        "@esbuild/openbsd-x64": "0.21.5",
-        "@esbuild/sunos-x64": "0.21.5",
-        "@esbuild/win32-arm64": "0.21.5",
-        "@esbuild/win32-ia32": "0.21.5",
-        "@esbuild/win32-x64": "0.21.5"
-      }
-    },
-    "node_modules/esprima": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
-      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
-      "license": "BSD-2-Clause",
-      "bin": {
-        "esparse": "bin/esparse.js",
-        "esvalidate": "bin/esvalidate.js"
-      },
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/estree-walker": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
-      "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@types/estree": "^1.0.0"
-      }
-    },
-    "node_modules/event-target-shim": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/event-target-shim/-/event-target-shim-5.0.1.tgz",
-      "integrity": "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/events": {
-      "version": "3.3.0",
-      "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz",
-      "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.8.x"
-      }
-    },
-    "node_modules/events-universal": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/events-universal/-/events-universal-1.0.1.tgz",
-      "integrity": "sha512-LUd5euvbMLpwOF8m6ivPCbhQeSiYVNb8Vs0fQ8QjXo0JTkEHpz8pxdQf0gStltaPpw0Cca8b39KxvK9cfKRiAw==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "bare-events": "^2.7.0"
-      }
-    },
-    "node_modules/expect-type": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.4.0.tgz",
-      "integrity": "sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "engines": {
-        "node": ">=12.0.0"
-      }
-    },
-    "node_modules/extend-shallow": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
-      "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==",
-      "license": "MIT",
-      "dependencies": {
-        "is-extendable": "^0.1.0"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/fast-fifo": {
-      "version": "1.3.2",
-      "resolved": "https://registry.npmjs.org/fast-fifo/-/fast-fifo-1.3.2.tgz",
-      "integrity": "sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/fast-sha256": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/fast-sha256/-/fast-sha256-1.3.0.tgz",
-      "integrity": "sha512-n11RGP/lrWEFI/bWdygLxhI+pVeo1ZYIVwvvPkW7azl/rOy+F3HYRZ2K5zeE9mmkhQppyv9sQFx0JM9UabnpPQ==",
-      "license": "Unlicense"
-    },
-    "node_modules/foreground-child": {
-      "version": "3.3.1",
-      "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz",
-      "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "cross-spawn": "^7.0.6",
-        "signal-exit": "^4.0.1"
-      },
-      "engines": {
-        "node": ">=14"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      }
-    },
-    "node_modules/fsevents": {
-      "version": "2.3.3",
-      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
-      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
-      "dev": true,
-      "hasInstallScript": true,
-      "license": "MIT",
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
-      }
-    },
-    "node_modules/glob": {
-      "version": "10.5.0",
-      "resolved": "https://registry.npmjs.org/glob/-/glob-10.5.0.tgz",
-      "integrity": "sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==",
-      "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "foreground-child": "^3.1.0",
-        "jackspeak": "^3.1.2",
-        "minimatch": "^9.0.4",
-        "minipass": "^7.1.2",
-        "package-json-from-dist": "^1.0.0",
-        "path-scurry": "^1.11.1"
-      },
-      "bin": {
-        "glob": "dist/esm/bin.mjs"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      }
-    },
-    "node_modules/graceful-fs": {
-      "version": "4.2.11",
-      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
-      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
-      "dev": true,
-      "license": "ISC"
-    },
-    "node_modules/gray-matter": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/gray-matter/-/gray-matter-4.0.3.tgz",
-      "integrity": "sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==",
-      "license": "MIT",
-      "dependencies": {
-        "js-yaml": "^3.13.1",
-        "kind-of": "^6.0.2",
-        "section-matter": "^1.0.0",
-        "strip-bom-string": "^1.0.0"
-      },
-      "engines": {
-        "node": ">=6.0"
-      }
-    },
-    "node_modules/gray-matter/node_modules/argparse": {
-      "version": "1.0.10",
-      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
-      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
-      "license": "MIT",
-      "dependencies": {
-        "sprintf-js": "~1.0.2"
-      }
-    },
-    "node_modules/gray-matter/node_modules/js-yaml": {
-      "version": "3.15.0",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.15.0.tgz",
-      "integrity": "sha512-ttBQIIQPDeLjpPOohtUdXuXUVoA2uIB6fEH9HyJ7234s5mBJ5wTx20njxplLZQgLaOfpmPQA7X2t5AX6tIPbog==",
-      "license": "MIT",
-      "dependencies": {
-        "argparse": "^1.0.7",
-        "esprima": "^4.0.0"
-      },
-      "bin": {
-        "js-yaml": "bin/js-yaml.js"
-      }
-    },
-    "node_modules/ieee754": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
-      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "BSD-3-Clause"
-    },
-    "node_modules/inherits": {
-      "version": "2.0.4",
-      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
-      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
-      "dev": true,
-      "license": "ISC"
-    },
-    "node_modules/is-extendable": {
-      "version": "0.1.1",
-      "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz",
-      "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/is-fullwidth-code-point": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
-      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/is-stream": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
-      "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/isarray": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
-      "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/isexe": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
-      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
-      "dev": true,
-      "license": "ISC"
-    },
-    "node_modules/jackspeak": {
-      "version": "3.4.3",
-      "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz",
-      "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==",
-      "dev": true,
-      "license": "BlueOak-1.0.0",
-      "dependencies": {
-        "@isaacs/cliui": "^8.0.2"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      },
-      "optionalDependencies": {
-        "@pkgjs/parseargs": "^0.11.0"
-      }
-    },
-    "node_modules/js-yaml": {
-      "version": "4.3.0",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.0.tgz",
-      "integrity": "sha512-1td788aAnnZ5qs7V2QIRl1owjtYpbKt749Y3xauqQgwIIGF/xXWz1wMTEBx5O3LK3lXLVuqXPdPxj2BoFHaW9Q==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/puzrin"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/nodeca"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "argparse": "^2.0.1"
-      },
-      "bin": {
-        "js-yaml": "bin/js-yaml.js"
-      }
-    },
-    "node_modules/json-schema-to-ts": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/json-schema-to-ts/-/json-schema-to-ts-3.1.1.tgz",
-      "integrity": "sha512-+DWg8jCJG2TEnpy7kOm/7/AxaYoaRbjVB4LFZLySZlWn8exGs3A4OLJR966cVvU26N7X9TWxl+Jsw7dzAqKT6g==",
-      "license": "MIT",
-      "dependencies": {
-        "@babel/runtime": "^7.18.3",
-        "ts-algebra": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=16"
-      }
-    },
-    "node_modules/kind-of": {
-      "version": "6.0.3",
-      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
-      "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/lazystream": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/lazystream/-/lazystream-1.0.1.tgz",
-      "integrity": "sha512-b94GiNHQNy6JNTrt5w6zNyffMrNkXZb3KTkCZJb2V1xaEGCk093vkZ2jk3tpaeP33/OiXC+WvK9AxUebnf5nbw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "readable-stream": "^2.0.5"
-      },
-      "engines": {
-        "node": ">= 0.6.3"
-      }
-    },
-    "node_modules/lazystream/node_modules/readable-stream": {
-      "version": "2.3.8",
-      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
-      "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "core-util-is": "~1.0.0",
-        "inherits": "~2.0.3",
-        "isarray": "~1.0.0",
-        "process-nextick-args": "~2.0.0",
-        "safe-buffer": "~5.1.1",
-        "string_decoder": "~1.1.1",
-        "util-deprecate": "~1.0.1"
-      }
-    },
-    "node_modules/lazystream/node_modules/safe-buffer": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
-      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/lazystream/node_modules/string_decoder": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
-      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "safe-buffer": "~5.1.0"
-      }
-    },
-    "node_modules/lodash": {
-      "version": "4.18.1",
-      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
-      "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/loupe": {
-      "version": "3.2.1",
-      "resolved": "https://registry.npmjs.org/loupe/-/loupe-3.2.1.tgz",
-      "integrity": "sha512-CdzqowRJCeLU72bHvWqwRBBlLcMEtIvGrlvef74kMnV2AolS9Y8xUv1I0U/MNAWMhBlKIoyuEgoJ0t/bbwHbLQ==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/lru-cache": {
-      "version": "10.4.3",
-      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
-      "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
-      "dev": true,
-      "license": "ISC"
-    },
-    "node_modules/magic-string": {
-      "version": "0.30.21",
-      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
-      "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@jridgewell/sourcemap-codec": "^1.5.5"
-      }
-    },
-    "node_modules/minimatch": {
-      "version": "9.0.9",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.9.tgz",
-      "integrity": "sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "brace-expansion": "^2.0.2"
-      },
-      "engines": {
-        "node": ">=16 || 14 >=14.17"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      }
-    },
-    "node_modules/minipass": {
-      "version": "7.1.3",
-      "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",
-      "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==",
-      "dev": true,
-      "license": "BlueOak-1.0.0",
-      "engines": {
-        "node": ">=16 || 14 >=14.17"
-      }
-    },
-    "node_modules/ms": {
-      "version": "2.1.3",
-      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
-      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/nanoid": {
-      "version": "3.3.16",
-      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.16.tgz",
-      "integrity": "sha512-bzlKTyNJ7+LdGIIwy8ijFpIqEQIvafahV7eYykJ8Cvh42EdJeODoJ6gUJXpQJvej1BddH8OqTXZNE/KfbWAu8Q==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "MIT",
-      "bin": {
-        "nanoid": "bin/nanoid.cjs"
-      },
-      "engines": {
-        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
-      }
-    },
-    "node_modules/normalize-path": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
-      "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/package-json-from-dist": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
-      "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==",
-      "dev": true,
-      "license": "BlueOak-1.0.0"
-    },
-    "node_modules/path-key": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
-      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/path-scurry": {
-      "version": "1.11.1",
-      "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz",
-      "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==",
-      "dev": true,
-      "license": "BlueOak-1.0.0",
-      "dependencies": {
-        "lru-cache": "^10.2.0",
-        "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
-      },
-      "engines": {
-        "node": ">=16 || 14 >=14.18"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      }
-    },
-    "node_modules/pathe": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/pathe/-/pathe-1.1.2.tgz",
-      "integrity": "sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/pathval": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/pathval/-/pathval-2.0.1.tgz",
-      "integrity": "sha512-//nshmD55c46FuFw26xV/xFAaB5HF9Xdap7HJBBnrKdAd6/GxDBaNA1870O79+9ueg61cZLSVc+OaFlfmObYVQ==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 14.16"
-      }
-    },
-    "node_modules/picocolors": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
-      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
-      "dev": true,
-      "license": "ISC"
-    },
-    "node_modules/postcss": {
-      "version": "8.5.22",
-      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.22.tgz",
-      "integrity": "sha512-KBDEIpLrvpv16pp3K0Fw+UCoZfopFjjgeB+0tA/aaThfEE74kKDLrgg603YvOWJyg3+WYtyq3xYsQWsIyZlPqQ==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/postcss/"
-        },
-        {
-          "type": "tidelift",
-          "url": "https://tidelift.com/funding/github/npm/postcss"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/ai"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "nanoid": "^3.3.16",
-        "picocolors": "^1.1.1",
-        "source-map-js": "^1.2.1"
-      },
-      "engines": {
-        "node": "^10 || ^12 || >=14"
-      }
-    },
-    "node_modules/process": {
-      "version": "0.11.10",
-      "resolved": "https://registry.npmjs.org/process/-/process-0.11.10.tgz",
-      "integrity": "sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 0.6.0"
-      }
-    },
-    "node_modules/process-nextick-args": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
-      "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/readable-stream": {
-      "version": "4.7.0",
-      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-4.7.0.tgz",
-      "integrity": "sha512-oIGGmcpTLwPga8Bn6/Z75SVaH1z5dUut2ibSyAMVhmUggWpmDn2dapB0n7f8nwaSiRtepAsfJyfXIO5DCVAODg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "abort-controller": "^3.0.0",
-        "buffer": "^6.0.3",
-        "events": "^3.3.0",
-        "process": "^0.11.10",
-        "string_decoder": "^1.3.0"
-      },
-      "engines": {
-        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
-      }
-    },
-    "node_modules/readdir-glob": {
-      "version": "1.1.3",
-      "resolved": "https://registry.npmjs.org/readdir-glob/-/readdir-glob-1.1.3.tgz",
-      "integrity": "sha512-v05I2k7xN8zXvPD9N+z/uhXPaj0sUFCe2rcWZIpBsqxfP7xXFQ0tipAd/wjj1YxWyWtUS5IDJpOG82JKt2EAVA==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "minimatch": "^5.1.0"
-      }
-    },
-    "node_modules/readdir-glob/node_modules/minimatch": {
-      "version": "5.1.9",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz",
-      "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "brace-expansion": "^2.0.1"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/readdirp": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.1.2.tgz",
-      "integrity": "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 14.18.0"
-      },
-      "funding": {
-        "type": "individual",
-        "url": "https://paulmillr.com/funding/"
-      }
-    },
-    "node_modules/rollup": {
-      "version": "4.62.2",
-      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.62.2.tgz",
-      "integrity": "sha512-RFnrW4lhXA3s3eqHDZvN654g8OTjzRfqpIRJYczCGB6HzphckVAi/Qh4tbPUbRuDi7s1Llv8g/NspLkttY3gTA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@types/estree": "1.0.9"
-      },
-      "bin": {
-        "rollup": "dist/bin/rollup"
-      },
-      "engines": {
-        "node": ">=18.0.0",
-        "npm": ">=8.0.0"
-      },
-      "optionalDependencies": {
-        "@rollup/rollup-android-arm-eabi": "4.62.2",
-        "@rollup/rollup-android-arm64": "4.62.2",
-        "@rollup/rollup-darwin-arm64": "4.62.2",
-        "@rollup/rollup-darwin-x64": "4.62.2",
-        "@rollup/rollup-freebsd-arm64": "4.62.2",
-        "@rollup/rollup-freebsd-x64": "4.62.2",
-        "@rollup/rollup-linux-arm-gnueabihf": "4.62.2",
-        "@rollup/rollup-linux-arm-musleabihf": "4.62.2",
-        "@rollup/rollup-linux-arm64-gnu": "4.62.2",
-        "@rollup/rollup-linux-arm64-musl": "4.62.2",
-        "@rollup/rollup-linux-loong64-gnu": "4.62.2",
-        "@rollup/rollup-linux-loong64-musl": "4.62.2",
-        "@rollup/rollup-linux-ppc64-gnu": "4.62.2",
-        "@rollup/rollup-linux-ppc64-musl": "4.62.2",
-        "@rollup/rollup-linux-riscv64-gnu": "4.62.2",
-        "@rollup/rollup-linux-riscv64-musl": "4.62.2",
-        "@rollup/rollup-linux-s390x-gnu": "4.62.2",
-        "@rollup/rollup-linux-x64-gnu": "4.62.2",
-        "@rollup/rollup-linux-x64-musl": "4.62.2",
-        "@rollup/rollup-openbsd-x64": "4.62.2",
-        "@rollup/rollup-openharmony-arm64": "4.62.2",
-        "@rollup/rollup-win32-arm64-msvc": "4.62.2",
-        "@rollup/rollup-win32-ia32-msvc": "4.62.2",
-        "@rollup/rollup-win32-x64-gnu": "4.62.2",
-        "@rollup/rollup-win32-x64-msvc": "4.62.2",
-        "fsevents": "~2.3.2"
-      }
-    },
-    "node_modules/safe-buffer": {
-      "version": "5.2.1",
-      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT"
-    },
-    "node_modules/section-matter": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/section-matter/-/section-matter-1.0.0.tgz",
-      "integrity": "sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA==",
-      "license": "MIT",
-      "dependencies": {
-        "extend-shallow": "^2.0.1",
-        "kind-of": "^6.0.0"
-      },
-      "engines": {
-        "node": ">=4"
-      }
-    },
-    "node_modules/shebang-command": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
-      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "shebang-regex": "^3.0.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/shebang-regex": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
-      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/siginfo": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz",
-      "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==",
-      "dev": true,
-      "license": "ISC"
-    },
-    "node_modules/signal-exit": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
-      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
-      "dev": true,
-      "license": "ISC",
-      "engines": {
-        "node": ">=14"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      }
-    },
-    "node_modules/source-map-js": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
-      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
-      "dev": true,
-      "license": "BSD-3-Clause",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/sprintf-js": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
-      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
-      "license": "BSD-3-Clause"
-    },
-    "node_modules/stackback": {
-      "version": "0.0.2",
-      "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz",
-      "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/standardwebhooks": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/standardwebhooks/-/standardwebhooks-1.0.0.tgz",
-      "integrity": "sha512-BbHGOQK9olHPMvQNHWul6MYlrRTAOKn03rOe4A8O3CLWhNf4YHBqq2HJKKC+sfqpxiBY52pNeesD6jIiLDz8jg==",
-      "license": "MIT",
-      "dependencies": {
-        "@stablelib/base64": "^1.0.0",
-        "fast-sha256": "^1.3.0"
-      }
-    },
-    "node_modules/std-env": {
-      "version": "3.10.0",
-      "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.10.0.tgz",
-      "integrity": "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/streamx": {
-      "version": "2.28.0",
-      "resolved": "https://registry.npmjs.org/streamx/-/streamx-2.28.0.tgz",
-      "integrity": "sha512-1Yowhzjf0ivGMrTIkY9hav5TxobO9qIVqUE41fiCGMGgc3CLlf4MY+9AHmZqBWgDTue0fY9zWjYFVyf6Diuobw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "events-universal": "^1.0.0",
-        "fast-fifo": "^1.3.2",
-        "text-decoder": "^1.1.0"
-      }
-    },
-    "node_modules/string_decoder": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
-      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "safe-buffer": "~5.2.0"
-      }
-    },
-    "node_modules/string-width": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
-      "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "eastasianwidth": "^0.2.0",
-        "emoji-regex": "^9.2.2",
-        "strip-ansi": "^7.0.1"
-      },
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
-    "node_modules/string-width-cjs": {
-      "name": "string-width",
-      "version": "4.2.3",
-      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
-      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "emoji-regex": "^8.0.0",
-        "is-fullwidth-code-point": "^3.0.0",
-        "strip-ansi": "^6.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/string-width-cjs/node_modules/ansi-regex": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
-      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/string-width-cjs/node_modules/emoji-regex": {
-      "version": "8.0.0",
-      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
-      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/string-width-cjs/node_modules/strip-ansi": {
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
-      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-regex": "^5.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/strip-ansi": {
-      "version": "7.2.0",
-      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz",
-      "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-regex": "^6.2.2"
-      },
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
-      }
-    },
-    "node_modules/strip-ansi-cjs": {
-      "name": "strip-ansi",
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
-      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-regex": "^5.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/strip-ansi-cjs/node_modules/ansi-regex": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
-      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/strip-bom-string": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/strip-bom-string/-/strip-bom-string-1.0.0.tgz",
-      "integrity": "sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/tar-stream": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/tar-stream/-/tar-stream-3.2.0.tgz",
-      "integrity": "sha512-ojzvCvVaNp6aOTFmG7jaRD0meowIAuPc3cMMhSgKiVWws1GyHbGd/xvnyuRKcKlMpt3qvxx6r0hreCNITP9hIg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "b4a": "^1.6.4",
-        "bare-fs": "^4.5.5",
-        "fast-fifo": "^1.2.0",
-        "streamx": "^2.15.0"
-      }
-    },
-    "node_modules/teex": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/teex/-/teex-1.0.1.tgz",
-      "integrity": "sha512-eYE6iEI62Ni1H8oIa7KlDU6uQBtqr4Eajni3wX7rpfXD8ysFx8z0+dri+KWEPWpBsxXfxu58x/0jvTVT1ekOSg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "streamx": "^2.12.5"
-      }
-    },
-    "node_modules/text-decoder": {
-      "version": "1.2.7",
-      "resolved": "https://registry.npmjs.org/text-decoder/-/text-decoder-1.2.7.tgz",
-      "integrity": "sha512-vlLytXkeP4xvEq2otHeJfSQIRyWxo/oZGEbXrtEEF9Hnmrdly59sUbzZ/QgyWuLYHctCHxFF4tRQZNQ9k60ExQ==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "b4a": "^1.6.4"
-      }
-    },
-    "node_modules/tinybench": {
-      "version": "2.9.0",
-      "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz",
-      "integrity": "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/tinyexec": {
-      "version": "0.3.2",
-      "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-0.3.2.tgz",
-      "integrity": "sha512-KQQR9yN7R5+OSwaK0XQoj22pwHoTlgYqmUscPYoknOoWCWfj/5/ABTMRi69FrKU5ffPVh5QcFikpWJI/P1ocHA==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/tinypool": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/tinypool/-/tinypool-1.1.1.tgz",
-      "integrity": "sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": "^18.0.0 || >=20.0.0"
-      }
-    },
-    "node_modules/tinyrainbow": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-1.2.0.tgz",
-      "integrity": "sha512-weEDEq7Z5eTHPDh4xjX789+fHfF+P8boiFB+0vbWzpbnbsEr/GRaohi/uMKxg8RZMXnl1ItAi/IUHWMsjDV7kQ==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=14.0.0"
-      }
-    },
-    "node_modules/tinyspy": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/tinyspy/-/tinyspy-3.0.2.tgz",
-      "integrity": "sha512-n1cw8k1k0x4pgA2+9XrOkFydTerNcJ1zWCO5Nn9scWHTD+5tp8dghT2x1uduQePZTZgd3Tupf+x9BxJjeJi77Q==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=14.0.0"
-      }
-    },
-    "node_modules/ts-algebra": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/ts-algebra/-/ts-algebra-2.0.0.tgz",
-      "integrity": "sha512-FPAhNPFMrkwz76P7cdjdmiShwMynZYN6SgOujD1urY4oNm80Ou9oMdmbR45LotcKOXoy7wSmHkRFE6Mxbrhefw==",
-      "license": "MIT"
-    },
-    "node_modules/util-deprecate": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
-      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/vite": {
-      "version": "5.4.21",
-      "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.21.tgz",
-      "integrity": "sha512-o5a9xKjbtuhY6Bi5S3+HvbRERmouabWbyUcpXXUA1u+GNUKoROi9byOJ8M0nHbHYHkYICiMlqxkg1KkYmm25Sw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "esbuild": "^0.21.3",
-        "postcss": "^8.4.43",
-        "rollup": "^4.20.0"
-      },
-      "bin": {
-        "vite": "bin/vite.js"
-      },
-      "engines": {
-        "node": "^18.0.0 || >=20.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/vitejs/vite?sponsor=1"
-      },
-      "optionalDependencies": {
-        "fsevents": "~2.3.3"
-      },
-      "peerDependencies": {
-        "@types/node": "^18.0.0 || >=20.0.0",
-        "less": "*",
-        "lightningcss": "^1.21.0",
-        "sass": "*",
-        "sass-embedded": "*",
-        "stylus": "*",
-        "sugarss": "*",
-        "terser": "^5.4.0"
-      },
-      "peerDependenciesMeta": {
-        "@types/node": {
-          "optional": true
-        },
-        "less": {
-          "optional": true
-        },
-        "lightningcss": {
-          "optional": true
-        },
-        "sass": {
-          "optional": true
-        },
-        "sass-embedded": {
-          "optional": true
-        },
-        "stylus": {
-          "optional": true
-        },
-        "sugarss": {
-          "optional": true
-        },
-        "terser": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/vite-node": {
-      "version": "2.1.9",
-      "resolved": "https://registry.npmjs.org/vite-node/-/vite-node-2.1.9.tgz",
-      "integrity": "sha512-AM9aQ/IPrW/6ENLQg3AGY4K1N2TGZdR5e4gu/MmmR2xR3Ll1+dib+nook92g4TV3PXVyeyxdWwtaCAiUL0hMxA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "cac": "^6.7.14",
-        "debug": "^4.3.7",
-        "es-module-lexer": "^1.5.4",
-        "pathe": "^1.1.2",
-        "vite": "^5.0.0"
-      },
-      "bin": {
-        "vite-node": "vite-node.mjs"
-      },
-      "engines": {
-        "node": "^18.0.0 || >=20.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/vitest"
-      }
-    },
-    "node_modules/vitest": {
-      "version": "2.1.9",
-      "resolved": "https://registry.npmjs.org/vitest/-/vitest-2.1.9.tgz",
-      "integrity": "sha512-MSmPM9REYqDGBI8439mA4mWhV5sKmDlBKWIYbA3lRb2PTHACE0mgKwA8yQ2xq9vxDTuk4iPrECBAEW2aoFXY0Q==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@vitest/expect": "2.1.9",
-        "@vitest/mocker": "2.1.9",
-        "@vitest/pretty-format": "^2.1.9",
-        "@vitest/runner": "2.1.9",
-        "@vitest/snapshot": "2.1.9",
-        "@vitest/spy": "2.1.9",
-        "@vitest/utils": "2.1.9",
-        "chai": "^5.1.2",
-        "debug": "^4.3.7",
-        "expect-type": "^1.1.0",
-        "magic-string": "^0.30.12",
-        "pathe": "^1.1.2",
-        "std-env": "^3.8.0",
-        "tinybench": "^2.9.0",
-        "tinyexec": "^0.3.1",
-        "tinypool": "^1.0.1",
-        "tinyrainbow": "^1.2.0",
-        "vite": "^5.0.0",
-        "vite-node": "2.1.9",
-        "why-is-node-running": "^2.3.0"
-      },
-      "bin": {
-        "vitest": "vitest.mjs"
-      },
-      "engines": {
-        "node": "^18.0.0 || >=20.0.0"
-      },
-      "funding": {
-        "url": "https://opencollective.com/vitest"
-      },
-      "peerDependencies": {
-        "@edge-runtime/vm": "*",
-        "@types/node": "^18.0.0 || >=20.0.0",
-        "@vitest/browser": "2.1.9",
-        "@vitest/ui": "2.1.9",
-        "happy-dom": "*",
-        "jsdom": "*"
-      },
-      "peerDependenciesMeta": {
-        "@edge-runtime/vm": {
-          "optional": true
-        },
-        "@types/node": {
-          "optional": true
-        },
-        "@vitest/browser": {
-          "optional": true
-        },
-        "@vitest/ui": {
-          "optional": true
-        },
-        "happy-dom": {
-          "optional": true
-        },
-        "jsdom": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/which": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
-      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "isexe": "^2.0.0"
-      },
-      "bin": {
-        "node-which": "bin/node-which"
-      },
-      "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/why-is-node-running": {
-      "version": "2.3.0",
-      "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz",
-      "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "siginfo": "^2.0.0",
-        "stackback": "0.0.2"
-      },
-      "bin": {
-        "why-is-node-running": "cli.js"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/wrap-ansi": {
-      "version": "8.1.0",
-      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz",
-      "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^6.1.0",
-        "string-width": "^5.0.1",
-        "strip-ansi": "^7.0.1"
-      },
-      "engines": {
-        "node": ">=12"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
-      }
-    },
-    "node_modules/wrap-ansi-cjs": {
-      "name": "wrap-ansi",
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
-      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.0.0",
-        "string-width": "^4.1.0",
-        "strip-ansi": "^6.0.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
-      }
-    },
-    "node_modules/wrap-ansi-cjs/node_modules/ansi-regex": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
-      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/wrap-ansi-cjs/node_modules/ansi-styles": {
-      "version": "4.3.0",
-      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
-      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "color-convert": "^2.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
-      }
-    },
-    "node_modules/wrap-ansi-cjs/node_modules/emoji-regex": {
-      "version": "8.0.0",
-      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
-      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/wrap-ansi-cjs/node_modules/string-width": {
-      "version": "4.2.3",
-      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
-      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "emoji-regex": "^8.0.0",
-        "is-fullwidth-code-point": "^3.0.0",
-        "strip-ansi": "^6.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/wrap-ansi-cjs/node_modules/strip-ansi": {
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
-      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-regex": "^5.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/zip-stream": {
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/zip-stream/-/zip-stream-6.0.1.tgz",
-      "integrity": "sha512-zK7YHHz4ZXpW89AHXUPbQVGKI7uvkd3hzusTdotCg1UxyaVtg0zFJSTfW/Dq5f7OBBVnq6cZIaC8Ti4hb6dtCA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "archiver-utils": "^5.0.0",
-        "compress-commons": "^6.0.2",
-        "readable-stream": "^4.0.0"
-      },
-      "engines": {
-        "node": ">= 14"
-      }
-    }
-  }
-}

From 73a8560cc12cc9fc5e0f6bd695ac2ec9dd88a5cb Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Tue, 4 Aug 2026 17:22:06 -0400
Subject: [PATCH 14/15] refactor(ai-observability): collapse to four steps and
 cut the prose in half

The bundle size gate failed at 8,644,625 bytes against an 8 MB limit. Main
builds 7,978,436 and passes, so the 666 KB this branch added caused it. The
step files had grown from 14,554 to 25,843 bytes per variant, times 68.

Rewrote all four steps with the ste-writing skill (ASD-STE100 controlled
English) and its bundled linter. Every file now passes the strict gate:

  1-begin.md      0.26 per 100 words, longest sentence 15 words
  2-install.md    0.00                                 16
  3-instrument.md 0.00                                 20
  4-verify.md     0.32                                 18

The three flagged items left are false positives: the word "begin" in the
step title, and "generation of" where generation is the event type.

Structure: 4-nesting.md folds into 3-instrument.md, and 5-verify.md returns
to 4-verify.md. Identity and tool spans belong with the client swap, not in
a separate step. The published docs now carry the code and property tables,
so the skill keeps only what the docs cannot know: which variant matches this
codebase, which four facts to read from it, the cardinality bar, the gateway
provider override, and how to grade what reaches PostHog.

Per variant: 25,843 -> 11,255 bytes. Bundle: 8,245,278, under the limit by
139 KB. That headroom is thinner than main's 400 KB. Dropping python.md
(32,589 bytes in every Python variant, mostly flags and surveys) is the next
lever if more room is needed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 .../skills/ai-observability/description.md    |   7 +-
 .../ai-observability/references/1-begin.md    |  64 ++++------
 .../ai-observability/references/2-install.md  |  66 ++++------
 .../references/3-instrument.md                | 116 ++++++------------
 .../ai-observability/references/4-nesting.md  | 104 ----------------
 .../ai-observability/references/4-verify.md   |  52 ++++++++
 .../ai-observability/references/5-verify.md   |  55 ---------
 7 files changed, 141 insertions(+), 323 deletions(-)
 delete mode 100644 context/skills/ai-observability/references/4-nesting.md
 create mode 100644 context/skills/ai-observability/references/4-verify.md
 delete mode 100644 context/skills/ai-observability/references/5-verify.md

diff --git a/context/skills/ai-observability/description.md b/context/skills/ai-observability/description.md
index ab3f909e..c43efde0 100644
--- a/context/skills/ai-observability/description.md
+++ b/context/skills/ai-observability/description.md
@@ -14,11 +14,10 @@ Everything else this skill needs — PostHog credentials, instrumentation packag
 
 Read every referenced file **before editing**. Then work through them in order:
 
-1. **Begin** — see `references/1-begin.md`. Pick the right variant using the ordered rules (framework before provider, gateway `baseURL` before the SDK it borrows), locate the LLM call sites, and answer the two questions that drive everything after: does the app register tools, and what identifies one conversation?
+1. **Begin** — see `references/1-begin.md`. Pick the variant with the ordered rules (framework before provider, gateway base URL before the SDK it borrows), then read four facts from the code: the conversation, the user, the turn, and whether the app registers tools.
 2. **Install** — see `references/2-install.md`. Declare the variant's packages in the manifest — and only those. For providers and gateways that's the PostHog SDK alongside the vendor SDK, with no OpenTelemetry packages.
-3. **Instrument** — see `references/3-instrument.md`. Swap the vendor client for PostHog's wrapper (or wire the framework's tracing hook, for framework variants). Route the project token / host through environment variables.
-4. **Build the tree** — see `references/4-nesting.md`. Attach `$ai_session_id`, a per-turn `posthog_trace_id`, and the distinct id to each call, and capture tool executions as `$ai_span` events. Mandatory — this is what turns isolated generations into a session tree.
-5. **Verify** — see `references/5-verify.md`. Describe a request the user can trigger, and grade what lands in PostHog — one session, grouped traces, right attribution — rather than what the diff contains.
+3. **Instrument** — see `references/3-instrument.md`. Swap the vendor client for PostHog's wrapper, attach `$ai_session_id`, a per-turn `posthog_trace_id`, and the distinct id to every call, and capture tool runs as `$ai_span` events. This step is what turns isolated generations into a session tree.
+4. **Verify** — see `references/4-verify.md`. Describe a request the user can trigger, and grade what lands in PostHog — one session, grouped traces, right attribution — rather than what the diff contains.
 
 ## Reference files
 
diff --git a/context/skills/ai-observability/references/1-begin.md b/context/skills/ai-observability/references/1-begin.md
index 818aa168..1076a2e3 100644
--- a/context/skills/ai-observability/references/1-begin.md
+++ b/context/skills/ai-observability/references/1-begin.md
@@ -1,20 +1,18 @@
 ---
 next_step: 2-install.md
 title: AI Observability Setup - Begin
-description: Pick the right variant from the full catalog, locate the LLM call sites, and answer the two questions that drive the whole integration
+description: Pick the variant that matches this project, then read the four facts the instrumentation needs
 ---
 
-Before touching any code, decide which variant of this skill to install, confirm the prerequisites, and get a read on where in the project LLM calls actually happen. AI Observability instruments an existing setup — if the setup isn't there, this skill can't do its job.
+Pick the variant, then read the code. Do not edit anything in this step.
 
 ## Pick the variant
 
-This skill ships **68 variants** — one per (provider × language), plus agent frameworks, gateways, and a manual fallback. You are running the group-level entry. Call `load_skill_menu` with `category: "ai-observability"` and treat that list as the source of truth; the families below tell you what to look for in the project.
+This skill ships 68 variants. Call `load_skill_menu` with `category: "ai-observability"`. That list is the source of truth.
 
-Apply these rules **in order**. The first match wins — the order matters, because frameworks wrap providers and gateways impersonate them.
+Apply these rules in order. The first match wins. Frameworks wrap providers, and gateways look like OpenAI, so the order matters.
 
-### 1. An agent or orchestration framework → use its variant, not the provider's
-
-These wrap the provider SDK. Instrumenting the provider underneath captures the model calls but loses the framework's own structure (tool spans, handoffs, agent steps), and on some of them the provider instrumentor captures nothing at all.
+### 1. A framework wins over the provider under it
 
 | Package in the manifest | Variant |
 |---|---|
@@ -26,7 +24,7 @@ These wrap the provider SDK. Instrumenting the provider underneath captures the
 | `llama-index`, `llamaindex` | `llamaindex` |
 | `crewai` | `crewai` |
 | `pyautogen`, `autogen-agentchat` | `autogen` |
-| `dspy` / `dspy-ai` | `dspy` |
+| `dspy`, `dspy-ai` | `dspy` |
 | `pydantic-ai` | `pydantic-ai` |
 | `semantic-kernel` | `semantic-kernel` |
 | `smolagents` | `smolagents` |
@@ -36,47 +34,37 @@ These wrap the provider SDK. Instrumenting the provider underneath captures the
 | `mastra`, `@mastra/core` | `mastra` |
 | `convex` | `convex` |
 
-### 2. A provider SDK with a `baseURL` / `base_url` override → prefer the gateway's variant
-
-Most OpenAI-compatible providers ship no SDK of their own; apps reach them with the `openai` package pointed at another host — `api.groq.com`, `openrouter.ai`, `localhost:11434`, `api.together.xyz`, and so on. Check the `openai` client's construction and `OPENAI_BASE_URL` in env files, then pick the variant naming that provider from the menu.
-
-These variants share one install shape — PostHog's OpenAI wrapper pointed at the provider's `base_url` — but **identifying the provider still matters**. PostHog prices tokens by `$ai_model` + `$ai_provider`, and the wrapper reports `openai` whatever host it targets, so a gateway call has to send the real provider explicitly (`4-nesting.md` covers how). Getting the variant right is what tells you which slug to send. Portkey additionally needs the `portkey-ai` package.
-
-### 3. A direct provider SDK, no override → that provider's variant
-
-`openai` → `openai-*`; `anthropic` / `@anthropic-ai/sdk` → `anthropic-*`; `google-genai` / `@google/genai` → `google-*`; `mistralai` → `mistral-*`; `cohere` → `cohere-*`; `boto3` + `bedrock-runtime` → `aws-bedrock-*`.
-
-### 4. Everything else
+Instrument the framework, not the provider below it. A provider instrumentor keeps the model calls and loses the agent, tool, and handoff structure.
 
-- **Several candidates and no framework** → prefer the higher-level abstraction; if still ambiguous, `wizard_ask` the user with the candidates as options.
-- **The app already emits OTel spans for its LLM calls itself** → `opentelemetry-{python,node}`.
-- **No LLM SDK at all** → `ai-observability-manual-capture`, which posts events explicitly.
-- **Genuinely unsure** → `wizard_ask` with a multi-choice picker. Do not guess when there's real ambiguity.
+### 2. An `openai` client with a base URL override means a gateway
 
-Language follows the manifest (`package.json` → Node, `pyproject.toml`/`requirements.txt` → Python); framework-only variants have no language suffix. Tell the user which variant you picked **and why** in a `[STATUS]` line, then call `install_skill` with the full id (e.g. `ai-observability-groq-node`).
+Most OpenAI-compatible providers ship no SDK. Apps call them with the `openai` package aimed at another host. Check the client constructor and `OPENAI_BASE_URL`. Common hosts are `api.groq.com`, `openrouter.ai`, `api.together.xyz`, and `localhost:11434`.
 
-## Check for an existing PostHog setup (informational — not a blocker)
+Pick the variant that names the provider. The install shape matches plain OpenAI, but the provider name does not. Step 3 explains why that matters.
 
-Grep for `posthog.init(`, `PostHog(`, or `AddPostHog(`.
+### 3. A plain provider SDK maps to that provider
 
-**This is not a prerequisite.** The wrapper takes its own PostHog client built from a project token and host — it does not depend on a `posthog.init(...)` anywhere, and `2-install.md` adds the SDK if it isn't there. If one **is** present, note the env-var names it reads (`POSTHOG_API_KEY`, `NEXT_PUBLIC_POSTHOG_KEY`, …) and reuse them in `3-instrument.md`; don't invent parallel names. Reuse the client instance too rather than creating a second one.
+`openai`, `anthropic`, `@anthropic-ai/sdk`, `google-genai`, `@google/genai`, `mistralai`, and `cohere` each have a variant. `boto3` with `bedrock-runtime` maps to `aws-bedrock`.
 
-## Locate the LLM call sites
+### 4. Anything else
 
-Grep for where the chosen SDK is imported and called. On the wrapper path you need **two** things: the module where the vendor client is **constructed** (that constructor gets swapped in `3-instrument.md`), and the **call sites** themselves, since identity is attached per call in `4-nesting.md`. Note the tool-dispatch loop too if the app has one — its executions become spans.
+- Several candidates and no framework: prefer the higher-level one. If it stays unclear, use `wizard_ask` with the candidates as options.
+- The app already emits its own OTel spans: `opentelemetry-{python,node}`.
+- No LLM SDK at all: `manual-capture`.
 
-## Answer the following question
+Language follows the manifest. A `package.json` means Node. A `pyproject.toml` or `requirements.txt` means Python. Framework variants have no language suffix.
 
-Instrumentation captures individual LLM calls. The structure that makes them useful comes from application semantics only the code can tell you. Write the answers down; `4-nesting.md` consumes them and nothing else.
+Report the variant and the reason in a `[STATUS]` line, then call `install_skill` with the full id.
 
-**What identifies the conversation and the user, and where does one turn begin and end?**
+## Read four facts from the code
 
-- **Conversation** — a `thread_id` / `conversationId` field, a session row, a request parameter, or nothing explicit, in which case the process run *is* the conversation. This becomes `$ai_session_id`.
-- **User** — a `user_id` or equivalent in scope at the call sites, or none, in which case events are anonymous. Note that rather than inventing an identifier.
-- **Turn** — the function or handler that takes one question and produces one answer, however many model calls it makes inside. This becomes one trace, and every call inside it shares one trace id.
+The install doc holds the code. It cannot know this app. Write these answers down. Step 3 uses them and nothing else.
 
-All three are attached per call, so you don't need to know whether they vary within the process — you just need to know where to read them at the call site.
+1. **Conversation.** The field that groups turns, such as `thread_id` or `conversation_id`. If the app has none, the process run is the conversation.
+2. **User.** The user id in scope at the call sites. If the app has none, the events stay anonymous. Do not invent one.
+3. **Turn.** The function that takes one question and returns one answer. It may call the model several times.
+4. **Tools.** Does the app register tools with its calls? Look for a `tools=` argument or a tool decorator. Find the loop that runs them.
 
-Note as well **whether the app registers tools** with its LLM calls (a `tools=` argument, a tool registry, a framework decorator). If it does, their executions need capturing as spans in `4-nesting.md`.
+Note the module that builds the vendor client. Step 3 replaces that constructor. If the project already calls `posthog.init(...)` or `PostHog(...)`, reuse its env-var names and its client.
 
-Do not edit yet. Once you have the variant, the entry point, the call sites, and those answers, move on to `2-install.md`.
+Go to `2-install.md`.
diff --git a/context/skills/ai-observability/references/2-install.md b/context/skills/ai-observability/references/2-install.md
index b9e62dac..a97de2a9 100644
--- a/context/skills/ai-observability/references/2-install.md
+++ b/context/skills/ai-observability/references/2-install.md
@@ -1,63 +1,41 @@
 ---
 next_step: 3-instrument.md
 title: AI Observability Setup - Install
-description: Declare the packages the installed variant needs - almost always just the PostHog SDK alongside the vendor SDK
+description: Declare the packages the variant needs, and no others
 ---
 
-Declare the packages the variant you installed in `1-begin.md` needs in the project's manifest — and only those. Do not run the package manager here — the base integration's build/verify step (or the user) installs everything in one pass.
+Declare the packages in the project manifest. Do not run the package manager. The build step installs them later.
 
-Read the manifest first. If any required package is already declared, leave the existing version alone and say so. Match the style of dependencies already in the file (versions, ordering, dev vs. runtime).
+Read the manifest first. If a package is already there, keep its version and say so in the report. Match the style of the entries around it.
 
-## The default: PostHog's SDK wrapper
+## Providers and gateways
 
-Every direct provider (OpenAI, Anthropic, Google, Azure OpenAI, Mistral, Cohere, …) and every OpenAI-compatible gateway (Groq, OpenRouter, Together, Ollama, DeepSeek, xAI, Perplexity, Fireworks, Cerebras, Hugging Face, Dedalus, Portkey, Helicone, Cloudflare AI Gateway) installs the same two things — **AWS Bedrock is the one exception, and it is still OTel-based; see below**:
+Every provider and every OpenAI-compatible gateway needs the PostHog SDK next to the vendor SDK.
 
-```
-posthog                # Python — ships the posthog.ai.<provider> wrapper clients
-```
+| Runtime | Packages |
+|---|---|
+| Python | `posthog` |
+| Node | `@posthog/ai`, `posthog-node` |
 
-```
-@posthog/ai            # Node — the wrapper clients
-posthog-node           # Node — the PostHog client the wrapper takes
-```
+**Do not add OpenTelemetry packages.** The wrapper path needs none. If you reach for `opentelemetry-sdk`, `posthog[otel]`, or an `opentelemetry-instrumentation-*` package, you picked the wrong mechanism. Go back to `3-instrument.md`.
 
-**No OpenTelemetry packages.** There is no `opentelemetry-sdk`, no `posthog[otel]`, and no `opentelemetry-instrumentation-<provider>` on this path. If you find yourself reaching for one, you're on the wrong mechanism — go back to `3-instrument.md`.
+The vendor SDK is already in the manifest. Do not add or upgrade it.
 
-The vendor SDK itself (`openai`, `anthropic`, `@anthropic-ai/sdk`, …) is a prerequisite and should already be declared. Do not add or upgrade it.
+Portkey also needs `portkey-ai`.
 
-Portkey is the one gateway needing an extra package: `portkey-ai`.
+## Other variants
 
-## Framework variants
+| Variant | Packages |
+|---|---|
+| Agent frameworks | The list the install doc names |
+| `opentelemetry-*`, LlamaIndex, AWS Bedrock | The OTel packages the install doc names |
+| `manual-capture` | `posthog` or `posthog-node` |
 
-Agent and orchestration frameworks (LangChain, LangGraph, CrewAI, DSPy, LiteLLM, OpenAI Agents, Claude Agent SDK, Vercel AI, Mirascope, Instructor, …) ship their tracing hook inside `posthog` / `@posthog/ai` or the framework itself. Take the package list from the variant's install doc; don't assume the shape of another family.
+AWS Bedrock has no wrapper client. It instruments the AWS SDK through OpenTelemetry, so its package list differs from every other provider.
 
-## The OpenTelemetry variants
+## Do not
 
-Three cases still use the OTel packages: the `opentelemetry-{python,node}` variants, LlamaIndex, and **AWS Bedrock** — Bedrock has no wrapper client and instruments the AWS SDK instead (`opentelemetry-instrumentation-botocore` in Python, `@opentelemetry/instrumentation-aws-sdk` in Node). Take its exact list from its install doc; it differs from the generic pair below.
-
-```
-posthog[otel]                                   # Python — PostHog SDK + span processor
-opentelemetry-sdk
-```
-
-```
-@posthog/ai                                     # Node — PostHog span processor
-@opentelemetry/sdk-node
-@opentelemetry/resources
-```
-
-## Manual-capture path
-
-Just PostHog core:
-
-```
-posthog                # Python
-posthog-node           # Node
-```
-
-## Do not do
-
-- Do not run `npm install` / `pip install` here.
+- Do not run `npm install` or `pip install`.
 - Do not edit the lockfile.
 - Do not upgrade the vendor SDK.
-- Do not add OpenTelemetry packages to a wrapper-path run. That is the most common wrong turn in this step, and it is wrong for every provider and gateway variant.
+- Do not add OpenTelemetry to a wrapper variant.
diff --git a/context/skills/ai-observability/references/3-instrument.md b/context/skills/ai-observability/references/3-instrument.md
index ab5c2f0a..b635b252 100644
--- a/context/skills/ai-observability/references/3-instrument.md
+++ b/context/skills/ai-observability/references/3-instrument.md
@@ -1,110 +1,70 @@
 ---
-next_step: 4-nesting.md
+next_step: 4-verify.md
 title: AI Observability Setup - Instrument
-description: Swap the vendor client for PostHog's wrapper - the default path for every provider and gateway
+description: Swap in the wrapper client, then attach identity and tool spans so the calls form a session tree
 ---
 
-**The PostHog SDK wrapper is the default mechanism.** OpenTelemetry is no longer the recommended path for provider or gateway variants: it makes the full session tree awkward to build and maintain, which is exactly what this skill exists to produce. Use OTel only where the variant's install doc actually calls for it.
+The install doc holds the code for this variant. Copy it and change the values. This step covers what the doc cannot know: the values this app supplies, and the shape the result must have.
 
-| Family | Who uses it | Shape |
-|---|---|---|
-| **Wrapper client** | every direct provider and OpenAI-compatible gateway, except AWS Bedrock | swap the client constructor, hand it a PostHog client |
-| **Framework hook** | agent frameworks and Vercel AI | the framework's own callback, tracing processor, or `experimental_telemetry` |
-| **OTel bootstrap** | the `opentelemetry-*` variants, LlamaIndex, and AWS Bedrock | `TracerProvider` + `PostHogSpanProcessor` |
-| **Manual capture** | `manual-capture` | explicit `capture()` calls at the call site |
+## Swap the client
 
-Wire exactly one. This step makes generations land; attaching identity and capturing tool calls is `4-nesting.md`'s job, and it is mandatory, not optional polish.
+Build a PostHog client. Replace the vendor client with the PostHog wrapper for this provider. The wrapper takes the same constructor arguments and stays call-compatible, so the existing calls keep working. A gateway keeps its `base_url`.
 
-## Match the doc's shape
+Keep the setup at module level, next to the existing client. Under ten lines is normal.
 
-**Copy the install doc's code block and change only the values.** The setup belongs at module level where the client is constructed — typically under ten lines. Adding structure around it is the most common way this step goes wrong:
+- Do not wrap it in an init function.
+- Do not add module globals.
+- Do not add a presence check that raises. `os.environ["POSTHOG_API_KEY"]` already fails loudly when the key is unset.
 
-- **No init function.** Don't wrap it in `init_observability(...)` or similar.
-- **No module-level globals** held "for later". Nothing needs to reach them afterwards.
-- **No extra env-var scaffolding.** `os.environ["POSTHOG_API_KEY"]` already fails loudly and idiomatically when unset — a separate presence check that raises is duplicated ceremony around a short snippet.
+Route the token and host through env vars with `set_env_values`. Reuse the names the project already uses. Add the names to `.env.example` with empty values. Never write a real key to a file.
 
-## Environment variables (all mechanisms)
+Agent frameworks use their own tracing hook in place of a wrapper. Take it from the install doc. Do not substitute an OTel instrumentor.
 
-Route the PostHog credentials through env vars using the wizard's `set_env_values` tool (never hardcode). Reuse whatever names the base PostHog integration already set — typically the project token (`POSTHOG_API_KEY`, `NEXT_PUBLIC_POSTHOG_KEY`, or the framework's convention) and the host (`POSTHOG_HOST`).
+## Attach identity to every call
 
-If the project has an `.env.example`, add the names there with empty placeholders. Create it if absent. Never write real secrets to any file.
+Three per-call parameters carry the tree. Node uses camelCase.
 
-## The wrapper path
+| Parameter | Holds | Cardinality |
+|---|---|---|
+| `posthog_properties` with `$ai_session_id` | the conversation | one id for the whole conversation |
+| `posthog_trace_id` | the turn | a new id per turn |
+| `posthog_distinct_id` | the user | the person |
 
-Create a PostHog client, then swap the vendor client for PostHog's drop-in wrapper:
+Every call inside one turn takes the same `posthog_trace_id`. If you omit it, the wrapper mints a fresh id per call, and each generation lands in its own trace.
 
-```python
-from posthog import Posthog
-from posthog.ai.anthropic import Anthropic      # swap per provider: posthog.ai.openai, .gemini, …
+**Cardinality is what gets graded.** One conversation is one session id. One turn is one trace id. An id minted per call looks instrumented and groups nothing.
 
-posthog = Posthog(os.environ["POSTHOG_API_KEY"], host=os.environ["POSTHOG_HOST"])
-client = Anthropic(posthog_client=posthog)      # otherwise the vendor client's constructor args
-```
+Every app gets a session id. If the app has no conversation field, the process run is the session. Do not skip the step.
 
-```typescript
-import { PostHog } from 'posthog-node'
-import { Anthropic } from '@posthog/ai/anthropic'
+If the app has no user id, leave `posthog_distinct_id` out. Anonymous is a finding for the report. Do not invent an id.
 
-const posthog = new PostHog(process.env.POSTHOG_API_KEY!, { host: process.env.POSTHOG_HOST! })
-const client = new Anthropic({ posthog })
-```
-
-The wrapper is call-compatible with the vendor client — existing `client.messages.create(...)` / `client.chat.completions.create(...)` calls keep working and now emit `$ai_generation` events. The per-call `posthog_*` params are `4-nesting.md`'s job.
+`$ai_session_id` accepts letters, numbers, and `- _ ~ . @ ( ) ! ' : |`. A raw thread id with a slash or a hash fails. Check the value before you pass it through.
 
-### Gateways — the same wrapper, pointed elsewhere
+### A gateway must name its provider
 
-An OpenAI-compatible gateway uses `posthog.ai.openai` with the provider's `base_url`. No entry-point work, no instrumentor:
+The OpenAI wrapper reports `openai` whatever host it calls. PostHog prices tokens by `$ai_model` and `$ai_provider`. A gateway call at the default gets the wrong price. Send the real provider:
 
 ```python
-from posthog.ai.openai import OpenAI
-
-client = OpenAI(
-    base_url="https://api.groq.com/openai/v1",   # the provider's host
-    api_key=os.environ["GROQ_API_KEY"],
-    posthog_client=posthog,
-)
+posthog_properties={"$ai_session_id": session_id, "$ai_provider": "groq"}
 ```
 
-Because the wrapper reports `openai` as the provider by default, gateway calls must override it per call — see `4-nesting.md`.
+## Capture tool calls as spans
 
-## Framework hooks
+The wrapper records the model call. It never sees the tool dispatch loop, so nothing else records a tool run.
 
-Agent SDKs carry their own tracing layer and the PostHog integration plugs into *that*: `openai-agents` and `claude-agent-sdk` register a processor, LangChain-family variants use a callback handler, Vercel AI uses `experimental_telemetry`. Take the exact registration from the variant's install doc. Do not substitute an OTel instrumentor — it captures the model calls but loses the agent, tool, and handoff structure that makes the framework worth instrumenting.
-
-## The PostHog client
-
-Every path above needs a PostHog client instance. Look for a reusable one before creating anything:
-
-- Search for an existing client: `posthog-js` on the frontend, `PostHog` from `posthog` / `posthog-node` on the backend.
-- Frontend: the client is a singleton — always reuse it.
-- Backend: reuse a shared instance if one exists; otherwise create one where the instrumentation lives, once, at module level.
-
-## The OTel bootstrap (only where the doc calls for it)
-
-```python
-from opentelemetry import trace
-from opentelemetry.sdk.trace import TracerProvider
-from opentelemetry.sdk.resources import Resource, SERVICE_NAME
-from posthog.ai.otel import PostHogSpanProcessor
-
-provider = TracerProvider(resource=Resource(attributes={SERVICE_NAME: "my-app"}))
-provider.add_span_processor(PostHogSpanProcessor(
-    api_key=os.environ["POSTHOG_API_KEY"],
-    host=os.environ["POSTHOG_HOST"],
-))
-trace.set_tracer_provider(provider)
-```
+If the app registers tools, capture each run as an `$ai_span` event with `posthog.capture()`. Give it the turn's `$ai_trace_id` so the span joins the trace. The install doc lists the span properties.
 
-It must run once per process, at startup, before the vendor SDK is imported.
+Put the capture next to the existing dispatch. Do not restructure the tool loop.
 
-## The manual-capture path
+Agent frameworks and the Vercel AI SDK emit tool spans on their own. Add nothing on those variants.
 
-Capture each generation explicitly at the call site with `$ai_generation` and the properties from the install page (`$ai_provider`, `$ai_model`, `$ai_input`, `$ai_output_choices`, token counts, `$ai_latency`), carrying the `$ai_trace_id` from `4-nesting.md`.
+An app that registers no tools has no spans. That is a complete result, not a gap.
 
 ## Do not
 
-- Do not wire more than one mechanism — the variant's install doc describes exactly one.
-- Do not reach for OpenTelemetry on a provider or gateway variant. The wrapper is the path.
-- Do not substitute an OTel instrumentor for a framework's own tracing hook.
-- Do not create a PostHog client where one already exists — search first and reuse it. Reuse the project token / host already in the app's env.
-- Do not put client or SDK init inside a request handler. Once per process, at module level.
+- Do not restructure the app. This step swaps a constructor and adds arguments to calls.
+- Do not omit `posthog_trace_id` and expect the calls to group.
+- Do not mint a session id per call or per turn.
+- Do not leave a gateway reporting `$ai_provider` as `openai`.
+- Do not add spans when the app registers no tools.
+- Do not ship code whose imports fail. Go back to `1-begin.md` and pick another variant.
diff --git a/context/skills/ai-observability/references/4-nesting.md b/context/skills/ai-observability/references/4-nesting.md
deleted file mode 100644
index 002a0f45..00000000
--- a/context/skills/ai-observability/references/4-nesting.md
+++ /dev/null
@@ -1,104 +0,0 @@
----
-next_step: 5-verify.md
-title: AI Observability Setup - Nesting
-description: Attach per-call identity and capture tool calls as spans so the session tree is complete
----
-
-`3-instrument.md` wired the client, so individual LLM calls now land. This step builds the tree they belong to: **session → trace → span → generation**. It is the reason this skill exists, and a run that stops at the previous step is incomplete.
-
-Use the answer you wrote down in `1-begin.md`.
-
-## Identity goes on the call
-
-The wrapper takes three per-call parameters. Node uses camelCase (`posthogDistinctId`, `posthogTraceId`, `posthogProperties`).
-
-| What | Where | Cardinality |
-|---|---|---|
-| **Session** | `posthog_properties={"$ai_session_id": …}` | one id shared by every turn of the conversation |
-| **Trace** | `posthog_trace_id` | **a new id per turn** — one request in, one answer out |
-| **User** | `posthog_distinct_id` | the person the conversation belongs to |
-
-```python
-import uuid
-
-session_id = "conversation-abc"      # same across every turn of this conversation
-trace_id = str(uuid.uuid4())         # one per turn
-distinct_id = "user_123"
-
-response = client.chat.completions.create(
-    model=MODEL,
-    messages=[...],
-    tools=tools,
-    posthog_distinct_id=distinct_id,
-    posthog_trace_id=trace_id,
-    posthog_properties={"$ai_session_id": session_id},
-)
-```
-
-Every call that belongs to one turn must be handed **the same** `posthog_trace_id`. Omitting it does not group them — the wrapper mints a fresh UUID per call, which produces one lonely trace per generation.
-
-To capture events anonymously, omit `posthog_distinct_id` rather than inventing an id.
-
-### Gateways must also send `$ai_provider`
-
-`posthog.ai.openai` reports `openai` as the provider whatever host it points at. PostHog prices tokens by `$ai_model` + `$ai_provider`, so a Groq or DeepSeek call left at the default is mispriced or fails to match. Override it per call:
-
-```python
-posthog_properties={"$ai_session_id": session_id, "$ai_provider": "groq"},
-```
-
-Use the provider slug matching the variant you installed. This applies to every OpenAI-compatible gateway and to nothing else.
-
-## Capture tool calls as spans
-
-**When the app registers tools, you capture their executions as `$ai_span` events.** The wrapper captures the model call as a generation; it does not see your tool-dispatch loop, so nothing else will record it. Emit one event per tool call, sharing the turn's `$ai_trace_id`:
-
-```python
-import time, json, uuid
-
-for call in response.choices[0].message.tool_calls:
-    start = time.time()
-    result = get_weather(**json.loads(call.function.arguments))
-
-    posthog.capture(
-        distinct_id=distinct_id,
-        event="$ai_span",
-        properties={
-            "$ai_trace_id": trace_id,                  # ties the span to the generation
-            "$ai_session_id": session_id,
-            "$ai_span_id": str(uuid.uuid4()),
-            "$ai_span_name": call.function.name,
-            "$ai_input_state": call.function.arguments,
-            "$ai_output_state": result,
-            "$ai_latency": time.time() - start,
-        },
-    )
-```
-
-The span joins the tree through `$ai_trace_id` — the same id the generation carried. Keep the capture next to the existing dispatch; do not restructure the tool loop to accommodate it.
-
-**Framework variants are the exception.** Agent SDKs and the Vercel AI SDK emit tool spans through their own tracing (`ai.toolCall` and friends), so on those paths you add nothing. An app that registers no tools has no spans, and that is a complete outcome — never invent one to make a trace look fuller.
-
-## Always set a session — the graded property is cardinality
-
-Every instrumented app gets an `$ai_session_id`, including one-shot and single-trace apps. Tagging costs nothing, keeps aggregation consistent across the project, and is already right the day the app grows a second turn.
-
-When the app has no conversation field, **identify the boundary rather than skipping the step**: a CLI or worker run is a session; a server request carrying a thread id uses that; an agent framework run is a session even when it produces exactly one trace.
-
-What must be right is the **cardinality** — one id shared by the traces that belong together, and one trace per turn beneath it. An id minted per call is worse than none: it looks instrumented and groups nothing.
-
-Two details that bite: the key is the literal `$ai_session_id` (there is no `posthog.session_id` alias), and its value may contain only letters, numbers, and `- _ ~ . @ ( ) ! ' : |`. A thread id carrying a `/` or `#` is rejected, so check before passing one straight through.
-
-## Manual capture
-
-The manual path wires the same tree by hand: every event in a turn shares `$ai_trace_id`, spans carry their own `$ai_span_id`, and `$ai_session_id` goes in properties. The manual-capture install page carries the full property tables.
-
-## Do not
-
-- Do not omit `posthog_trace_id` and expect calls to group — each one gets a fresh UUID.
-- Do not mint a fresh session id per call or per turn. One conversation, one id.
-- Do not leave a gateway call reporting `$ai_provider: "openai"` — token pricing depends on it.
-- Do not restructure the app's tool loop to add span capture; the capture sits alongside the existing dispatch.
-- Do not create spans when the app registers no tools, and do not add them on framework paths that already emit their own.
-- Do not hand-author OpenTelemetry spans for any of this. These are `capture()` events, not OTel spans.
-- Do not ship a code path whose imports failed in the project's environment — go back to `1-begin.md` and take the next viable variant instead of shipping the caveat.
diff --git a/context/skills/ai-observability/references/4-verify.md b/context/skills/ai-observability/references/4-verify.md
new file mode 100644
index 00000000..1c07b39d
--- /dev/null
+++ b/context/skills/ai-observability/references/4-verify.md
@@ -0,0 +1,52 @@
+---
+next_step: null
+title: AI Observability Setup - Verify
+description: Give the user a way to trigger one turn, and grade the tree that reaches PostHog
+---
+
+Give the user a way to run one turn. Do not call the model yourself. You hold no credentials, and the user should watch the trace arrive.
+
+Grade what reaches PostHog, not what the diff contains. A clean diff that produces one trace per call is a failed run.
+
+## What correct looks like
+
+Derive the expectation from the four facts in `1-begin.md`:
+
+- One session holds the turns of one conversation.
+- One trace holds every generation of one turn.
+- A span appears for each tool run, if the app registers tools.
+- The person matches the app's user id, if the app has one.
+- `$ai_provider` names the real provider on a gateway app.
+
+## Tell the user how to trigger it
+
+Name the smallest path in the project that runs one turn. Prefer one that calls the model twice or uses a tool, so the tree has depth.
+
+- A script: "Run `npm run <script>`."
+- An API route: "Send `POST /api/chat` with a test message."
+- A test that calls the model.
+
+If no path exists, write one in the report as suggested code. Do not add it to the project unless the user asks.
+
+Then open **LLM Analytics > Traces** in PostHog and open the newest trace. Check it against the list above. A second turn in the same conversation proves the session id groups the turns instead of splitting them.
+
+Before you hand over, run the import the code depends on, such as `python3 -c "from posthog.ai.openai import OpenAI"`. If it fails, go back to `1-begin.md` and pick another variant.
+
+## When it looks wrong
+
+| Symptom | Cause |
+|---|---|
+| One trace per generation | `posthog_trace_id` is missing, or a new id goes to each call |
+| A new session id on every trace | the session id comes from the wrong scope |
+| No session id | `posthog_properties` never reaches the call |
+| `$ai_provider` says `openai` on a gateway | the per-call override is missing |
+| Anonymous person | `posthog_distinct_id` is missing |
+| No tool spans | the `$ai_span` captures are missing or carry another trace id |
+| Nothing arrives | the code still calls the vendor client, the key or host is unset, or a short script exits before the flush |
+
+## Do not
+
+- Do not run the vendor SDK.
+- Do not put an API key in any file.
+- Do not report a run as done while an import fails.
+- Do not claim the setup works before the user confirms what landed. Report it as "wired, unverified" instead.
diff --git a/context/skills/ai-observability/references/5-verify.md b/context/skills/ai-observability/references/5-verify.md
deleted file mode 100644
index 82241280..00000000
--- a/context/skills/ai-observability/references/5-verify.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-next_step: null
-title: AI Observability Setup - Verify
-description: Give the user a concrete way to trigger a turn, and grade the tree that lands in PostHog rather than the diff
----
-
-You've installed the SDK, swapped in the wrapper, and attached identity. The last thing this skill produces is a **verification path** the user can run themselves. Don't call the LLM from here — you don't have credentials, and the user should be the one to see the trace show up.
-
-**Grade what lands in PostHog, not what the diff contains.** A correct-looking diff that produces ungrouped traces or a per-call session id is a failed run.
-
-## What "correct" looks like for this app
-
-Derive the expectation from the answers in `1-begin.md` before you look at anything:
-
-- **One session** containing the turns that belong together. Two questions in one conversation means two traces under *one* `$ai_session_id`, not two ids.
-- **One trace per turn**, containing every generation that turn made — not one trace per model call.
-- **A span per tool execution**, if the app registers tools: `$ai_span` events sharing the turn's trace id. On framework variants these arrive on their own; on the wrapper path they're the ones you captured.
-- **Attribution** to the right person, if the app has a user identifier.
-- **The right provider** on gateway variants — `$ai_provider` should name Groq, DeepSeek, or whichever, never `openai`.
-
-## What to tell the user
-
-Point them at the smallest existing code path that exercises one instrumented turn — ideally one that makes more than one model call, or uses a tool, so the tree has depth. Pick from what you noted in `1-begin.md`:
-
-- A script (`scripts/`, `bin/`, a `package.json` script) → name it: "Run `npm run <script>`."
-- An API route → name it: "Hit `POST /api/chat` with a test message."
-- A test that exercises the call → point at that test.
-- Nothing existing → sketch a minimal script, but do not add it to the project unless the user asks. Include it in the report as suggested code.
-
-Then, in PostHog: open **Product → LLM Analytics → Traces** (not Generations), open the newest trace, and check it against the expectation above. Triggering a second turn in the same conversation is what proves the session id groups rather than splits. Generation properties worth spot-checking: `$ai_provider`, `$ai_model`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`.
-
-**Before handing over: prove the imports run.** In the project's environment, import what the instrumentation uses (e.g. `python -c "from posthog.ai.openai import OpenAI"`). If it fails — wrong package version, module not shipped in the installed release — go back to `1-begin.md` and switch variants. Do not ship non-running code with a caveat.
-
-## Failure modes
-
-- **Each generation is its own trace** → `posthog_trace_id` wasn't passed, or a fresh one was generated per call instead of per turn.
-- **Every trace has a different `$ai_session_id`** → the id is minted per call or per turn instead of per conversation. The most common silent failure: it looks instrumented and groups nothing.
-- **No `$ai_session_id` at all** → not passed in `posthog_properties`.
-- **`$ai_provider` says `openai` on a gateway app** → the per-call override is missing, and token costs will be wrong.
-- **Anonymous person** → `posthog_distinct_id` not passed.
-- **Tool calls invisible** → on the wrapper path, the `$ai_span` captures are missing or aren't sharing the turn's `$ai_trace_id`.
-
-If nothing shows up at all within a minute:
-
-- Confirm the wrapper is actually the client being called — an unswapped vendor client silently emits nothing.
-- Confirm the PostHog client has the project token and host, from the env the process actually runs under, not just `.env.example`.
-- In short-lived scripts, confirm events flush before exit.
-
-## Do not
-
-- Do not run the vendor SDK yourself.
-- Do not embed API keys anywhere to enable a smoke test.
-- Do not report a run as done while an instrumentation import fails in the project's environment.
-- Do not claim the integration works until the user has confirmed what actually landed. A confirmed flat generation is "generations verified, tree unverified", not done.
-- Do not report "wired" as "working" — if you never got confirmation, say "wired, unverified" and let the report surface it.

From 278c87c25e3b1ae124ba30e844b3d287ea13adae Mon Sep 17 00:00:00 2001
From: Marco Gancitano <marco.g@posthog.com>
Date: Wed, 5 Aug 2026 10:15:38 -0400
Subject: [PATCH 15/15] docs(ai-observability): drop the write-it-down
 instruction

Review feedback on #319: the agent carries prior context between turns, so
telling it to write the four facts down is redundant. The sentence now just
states that step 3 consumes them.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 context/skills/ai-observability/references/1-begin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/context/skills/ai-observability/references/1-begin.md b/context/skills/ai-observability/references/1-begin.md
index 1076a2e3..1ef2f318 100644
--- a/context/skills/ai-observability/references/1-begin.md
+++ b/context/skills/ai-observability/references/1-begin.md
@@ -58,7 +58,7 @@ Report the variant and the reason in a `[STATUS]` line, then call `install_skill
 
 ## Read four facts from the code
 
-The install doc holds the code. It cannot know this app. Write these answers down. Step 3 uses them and nothing else.
+The install doc holds the code. It cannot know this app. Step 3 uses these answers and nothing else.
 
 1. **Conversation.** The field that groups turns, such as `thread_id` or `conversation_id`. If the app has none, the process run is the conversation.
 2. **User.** The user id in scope at the call sites. If the app has none, the events stay anonymous. Do not invent one.