@supportbridge/sdk 0.9.4 → 0.9.5

package/CHANGELOG.md

@@ -1,103 +1,118 @@
-# Changelog
-
-## 0.9.4
-
-- Publishes the decision-state blocking and manual assistance offer improvements through npm Trusted Publishing without provenance, which npm does not support for private GitHub source repositories.
-- Repairs the malformed `package.json` created while preparing the unpublished `0.9.3` tag.
-- Pins the app2 Integrations onboarding command and displayed release to `@supportbridge/sdk@0.9.4`.
-
-## 0.9.3
-
-- Returns proactive `block_and_offer` matches as successful `awaiting_user_decision` states instead of MCP tool errors, without executing the business handler.
-- Adds explicit accept/decline routing, retry-after-decline metadata, and `do_not_retry_or_bypass` guidance for blocking offers.
-- Preserves genuine business-tool failures as errors, including repeated-failure support context.
-- Keeps `require_acknowledgement` non-blocking so original content and structured data remain available alongside the assistance notice.
-- Pins the app2 Integrations onboarding command and displayed release to `@supportbridge/sdk@0.9.3`.
-- Updates the trusted-publishing workflow to Node.js 24 and npm 11, as required for npm OIDC publishing.
-- Publishes through OIDC without Sigstore provenance because npm does not support provenance for private GitHub source repositories.
-
-## 0.9.2
-
-- GitHub release only; npm accepted OIDC but rejected provenance because the source repository is private.
-
-## 0.9.1
-
-- GitHub release only; npm publication was rejected before package creation because the original workflow's Node.js/npm versions did not support npm trusted publishing.
-
-## 0.9.0
-
-- Adds tenant-scoped live visitor activity for successful and failed MCP calls.
-- Adds manual assistance offers from the control plane, delivered on the targeted user's next tool call.
-- Supports representative assignment, acknowledgement behavior, expiry, and single-use delivery.
-
-## 0.8.1
-
-- Versioned the embedded chat resource URI so MCP hosts refresh the redesigned UI instead of reusing a cached pre-0.8 chat document.
-
-## 0.8.0
-
-- Redesigned the embedded support chat with distinct customer/support messages, representative identity, compact mode, quieter system activity, unread indicators, multiline composing, delivery feedback, and responsive styling.
-- Replaced technical Slack identifiers in the customer-facing header with human-readable presence and conversation status.
-- Added explicit close and reopen states, including a control-plane reopen endpoint and MCP App tool.
-- Improved ticket-detail privacy by moving the conversation identifier into an optional details menu.
-
-## 0.7.0
-
-- Added `require_acknowledgement`, a non-blocking policy action that returns business data while appending a visible, consent-safe assistance offer.
-- Added explicit pending offer metadata and control-plane lifecycle persistence for pending, presented, accepted, declined, and expired offers.
-- Added the acknowledgement action to the dashboard and natural-language policy compiler.
-- Preserved the existing metadata-only offer and blocking decision modes for backward compatibility.
-- Added optional Slack notifications for new live-help chats and new customer messages in existing chats.
-
-## 0.6.0
-
-- Added representative availability as a control-plane policy eligibility condition.
-- Added the mock Sarah representative with Available, Away, and Offline dashboard presence.
-- Added `request_assistance` for accepted sales and customer-success assistance offers.
-- Automatically assigns accepted assistance requests to the policy's representative.
-
-# 0.5.0
-
-- Added the canonical SupportBridge policy schema, approved field/action registries, deterministic validation and evaluation, nested Boolean conditions, explanations, conflict analysis, decision traces, dry runs, event-loop prevention, and idempotent action execution.
-- Added a vendor-neutral NLP provider contract and deterministic fake compiler for local development and tests.
-- Added approval, immutable version, disable, rollback, diff, test-case, and audit lifecycle primitives.
-- Added the embedded Claude policy-builder MCP App with AI/manual authoring modes, canonical preview, validation, and read-only simulation.
-
-## 0.4.0
-
-- Ported the MCP App lifecycle, metadata, session shape, and UI behavior from the known-working `ballyhoogroup/supportbridge` connector.
-- Added the proven `open_support_chat`, `support_get_messages`, `support_send_message`, and `support_end_session` contract.
-- Added preferred-frame resource metadata and the working inline display capability handshake.
-- Added a compatibility fixture and conformance assertions to prevent drift from the working connector.
-- Connected the proven chat lifecycle to the external multi-tenant control plane.
-
-## 0.3.1
-
-- Added a model-visible, MCP-App-linked `talk_to_support` tool.
-- Added reopening of an existing ticket by ID so a missing or scrolled-away widget can be rendered again.
-- Ensured new and reopened chats return the state required by the embedded app.
-
-## 0.3.0
-
-- Added one-call installation for the official TypeScript MCP SDK.
-- Added automatic support-tool, MCP App resource, chat-handler, policy-sync, and shutdown registration.
-- Added a single shared identity resolver and automatic recent-tool ticket briefs.
-- Added installation capability telemetry, dashboard connection status, and `supportbridge doctor`.
-
-## 0.2.0
-
-- Added a portable MCP App resource for embedded SupportBridge live chat.
-- Added ticket creation to `accept_support_offer` when a control-plane client is supplied.
-- Added app-only chat refresh and message handlers with a text fallback for non-App hosts.
-
-## 0.1.0
-
-- Added framework-neutral tool-call instrumentation and MCP result adaptation.
-- Added sanitized, bounded telemetry with buffered HTTP delivery.
-- Added argument-match and repeated-failure support triggers.
-- Added blocking support offers with accept, dismiss, and reset state.
-- Added optional agent and model spans with async trace propagation.
-- Added pluggable telemetry transports and trigger-state stores.
-- Added remote policy synchronization and support-chat control-plane client.
-- Added a tenant-scoped vendor control plane with Live Streams, Visitor 360, chat, and policy management.
+# Changelog
+
+## Unreleased
+
+## 0.9.5
+
+- Fixes telemetry delivery by treating the configured endpoint as the complete App2 ingestion URL instead of appending a second, invalid path.
+
+
+- Reports the actual SDK release in the telemetry transport user agent.
+- Adds pre-tag CI for the SDK and app2, including manifest validation, typechecks, tests, builds, and package inspection.
+- Adds atomic release preparation and a single shared SDK version source.
+- Uses deterministic pnpm lockfiles and cached installs in CI and publishing.
+- Serializes npm publishing and avoids rerunning `prepack` checks during the trusted-publishing step.
+- Makes app2 install the npm `latest` dist-tag so SDK releases no longer require app version edits.
+- Limits Render auto-deploys to runtime app2 files and waits for GitHub checks to pass.
+
+## 0.9.4
+
+- Publishes the decision-state blocking and manual assistance offer improvements through npm Trusted Publishing without provenance, which npm does not support for private GitHub source repositories.
+- Repairs the malformed `package.json` created while preparing the unpublished `0.9.3` tag.
+- Pins the app2 Integrations onboarding command and displayed release to `@supportbridge/sdk@0.9.4`.
+
+## 0.9.3
+
+- Returns proactive `block_and_offer` matches as successful `awaiting_user_decision` states instead of MCP tool errors, without executing the business handler.
+- Adds explicit accept/decline routing, retry-after-decline metadata, and `do_not_retry_or_bypass` guidance for blocking offers.
+- Preserves genuine business-tool failures as errors, including repeated-failure support context.
+- Keeps `require_acknowledgement` non-blocking so original content and structured data remain available alongside the assistance notice.
+- Pins the app2 Integrations onboarding command and displayed release to `@supportbridge/sdk@0.9.3`.
+- Updates the trusted-publishing workflow to Node.js 24 and npm 11, as required for npm OIDC publishing.
+- Publishes through OIDC without Sigstore provenance because npm does not support provenance for private GitHub source repositories.
+
+## 0.9.2
+
+- GitHub release only; npm accepted OIDC but rejected provenance because the source repository is private.
+
+## 0.9.1
+
+- GitHub release only; npm publication was rejected before package creation because the original workflow's Node.js/npm versions did not support npm trusted publishing.
+
+## 0.9.0
+
+- Adds tenant-scoped live visitor activity for successful and failed MCP calls.
+- Adds manual assistance offers from the control plane, delivered on the targeted user's next tool call.
+- Supports representative assignment, acknowledgement behavior, expiry, and single-use delivery.
+
+## 0.8.1
+
+- Versioned the embedded chat resource URI so MCP hosts refresh the redesigned UI instead of reusing a cached pre-0.8 chat document.
+
+## 0.8.0
+
+- Redesigned the embedded support chat with distinct customer/support messages, representative identity, compact mode, quieter system activity, unread indicators, multiline composing, delivery feedback, and responsive styling.
+- Replaced technical Slack identifiers in the customer-facing header with human-readable presence and conversation status.
+- Added explicit close and reopen states, including a control-plane reopen endpoint and MCP App tool.
+- Improved ticket-detail privacy by moving the conversation identifier into an optional details menu.
+
+## 0.7.0
+
+- Added `require_acknowledgement`, a non-blocking policy action that returns business data while appending a visible, consent-safe assistance offer.
+- Added explicit pending offer metadata and control-plane lifecycle persistence for pending, presented, accepted, declined, and expired offers.
+- Added the acknowledgement action to the dashboard and natural-language policy compiler.
+- Preserved the existing metadata-only offer and blocking decision modes for backward compatibility.
+- Added optional Slack notifications for new live-help chats and new customer messages in existing chats.
+
+## 0.6.0
+
+- Added representative availability as a control-plane policy eligibility condition.
+- Added the mock Sarah representative with Available, Away, and Offline dashboard presence.
+- Added `request_assistance` for accepted sales and customer-success assistance offers.
+- Automatically assigns accepted assistance requests to the policy's representative.
+
+# 0.5.0
+
+- Added the canonical SupportBridge policy schema, approved field/action registries, deterministic validation and evaluation, nested Boolean conditions, explanations, conflict analysis, decision traces, dry runs, event-loop prevention, and idempotent action execution.
+- Added a vendor-neutral NLP provider contract and deterministic fake compiler for local development and tests.
+- Added approval, immutable version, disable, rollback, diff, test-case, and audit lifecycle primitives.
+- Added the embedded Claude policy-builder MCP App with AI/manual authoring modes, canonical preview, validation, and read-only simulation.
+
+## 0.4.0
+
+- Ported the MCP App lifecycle, metadata, session shape, and UI behavior from the known-working `ballyhoogroup/supportbridge` connector.
+- Added the proven `open_support_chat`, `support_get_messages`, `support_send_message`, and `support_end_session` contract.
+- Added preferred-frame resource metadata and the working inline display capability handshake.
+- Added a compatibility fixture and conformance assertions to prevent drift from the working connector.
+- Connected the proven chat lifecycle to the external multi-tenant control plane.
+
+## 0.3.1
+
+- Added a model-visible, MCP-App-linked `talk_to_support` tool.
+- Added reopening of an existing ticket by ID so a missing or scrolled-away widget can be rendered again.
+- Ensured new and reopened chats return the state required by the embedded app.
+
+## 0.3.0
+
+- Added one-call installation for the official TypeScript MCP SDK.
+- Added automatic support-tool, MCP App resource, chat-handler, policy-sync, and shutdown registration.
+- Added a single shared identity resolver and automatic recent-tool ticket briefs.
+- Added installation capability telemetry, dashboard connection status, and `supportbridge doctor`.
+
+## 0.2.0
+
+- Added a portable MCP App resource for embedded SupportBridge live chat.
+- Added ticket creation to `accept_support_offer` when a control-plane client is supplied.
+- Added app-only chat refresh and message handlers with a text fallback for non-App hosts.
+
+## 0.1.0
+
+- Added framework-neutral tool-call instrumentation and MCP result adaptation.
+- Added sanitized, bounded telemetry with buffered HTTP delivery.
+- Added argument-match and repeated-failure support triggers.
+- Added blocking support offers with accept, dismiss, and reset state.
+- Added optional agent and model spans with async trace propagation.
+- Added pluggable telemetry transports and trigger-state stores.
+- Added remote policy synchronization and support-chat control-plane client.
+- Added a tenant-scoped vendor control plane with Live Streams, Visitor 360, chat, and policy management.