@case-framework/survey-assistant 0.4.0 → 0.5.0

package/docs/integration.md

@@ -122,6 +122,40 @@ Only the active provider's secret is required. `SURVEY_ASSISTANT_ENABLED` is an
 optional operational override; provider, model, role, memory, request-limit, and
 execution policy remains document-owned.
 
+#### Optional experimental-identity rollout gate
+
+Importing hosts can pass `requireExperimentalIdentityOptIn: true` as a third
+argument to either configuration parser:
+
+```ts
+const config = parseSurveyAssistantConfigurationDocument(document, process.env, {
+  requireExperimentalIdentityOptIn: true,
+});
+```
+
+This adds a second, explicit production rollout gate. Outside development, an
+otherwise enabled assistant then remains disabled until the deployment also
+sets:
+
+```dotenv
+SURVEY_ASSISTANT_ALLOW_EXPERIMENTAL_IDENTITY=true
+```
+
+The environment variable alone does not enable the assistant. Enablement must
+still be requested by `enabled: true` in the configuration document or by
+`SURVEY_ASSISTANT_ENABLED=true`; an explicit
+`SURVEY_ASSISTANT_ENABLED=false` still disables it. In development, the extra
+opt-in is not required.
+
+Despite its historical name, this option does not select, create, or authorize
+an identity. Request identity and access remain controlled by the host's
+authorization callbacks. A production host with a complete authenticated-host
+integration should normally omit the parser option, unless it deliberately
+wants this additional deployment switch. Use it when a host still exposes an
+experimental client-request identity path, or when that extra production
+rollout gate is desired. If the parser option is omitted (the default),
+`SURVEY_ASSISTANT_ALLOW_EXPERIMENTAL_IDENTITY` has no effect.
+
 The shared option keys are `parallelToolCalls`, `reasoningEffort`,
 `reasoningSummary`, `promptCacheKey`, `promptCacheRetention`, `serviceTier`, and
 `textVerbosity`. Provider validation rejects known-incompatible combinations;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@case-framework/survey-assistant",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Shared protocol, engine, and runtime for the CASE survey assistant.",
   "license": "ISC",
   "files": [

package/dist/index-biZnRl-h.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-biZnRl-h.d.mts","names":[],"sources":["../src/server/tools/survey-audit-tool.ts","../src/server/tools/survey-asset-tool.ts","../src/server/tools/index.ts"],"mappings":";;;;cA4Ga,eAAA,EAwBX,qBAAA,CAxB0B,IAAA;;;;;;;;;qBAwB1B,qBAAA,CAAA,oBAAA;;;cCiCW,eAAA,wBAAe,IAAA;;;;;;;;GA6H1B,oBAAA;;;cCvRW,yBAAA;AAAA,cAUA,oBAAA,EAAoB,QAAA;;;;;;;;;;;;;;;;;;;;;;uBAQ/B,qBAAA,CAAA,oBAAA"}