@lssm/lib.contracts-spec 17.3.2

package/dist/customer-support/operations.js

@@ -0,0 +1,9 @@
+import{docRef as f}from"../docs/registry.js";import{defineCommand as e,defineQuery as i}from"../operations/index.js";import{supportAiOutcomeEvaluationOperations as g}from"./ai-outcome-evaluation-operations.js";import{supportAiOutcomeLearningOperations as y}from"./ai-outcome-learning-operations.js";import{supportAttachmentSafetyOperations as h}from"./attachment-safety-operations.js";import{SupportAuthOsSessionDocRef as O}from"./authos-session.js";import{supportBillingEntitlementOperations as x}from"./billing-entitlement-operations.js";import{SupportCaseAssignmentsDocRef as V}from"./case-assignments.js";import{SupportCaseCursorDocRef as k}from"./case-cursor.js";import{SupportCaseArchiveCommandV2 as v,SupportCaseSnoozeCommandV2 as I,supportCaseLifecycleOperations as R}from"./case-lifecycle.js";import{supportCasePresenceOperations as A}from"./case-presence.js";import{SupportCaseRelationsDocRef as M}from"./case-relations.js";import{supportCompanyActionOperations as b}from"./company-action-operations.js";import{supportCryptoRotationDrillOperations as L}from"./crypto-rotation-drill-operations.js";import{supportCryptoRotationOperations as w}from"./crypto-rotation-operations.js";import{SupportCsatRecordCommandV2 as Q,supportCsatOperations as W}from"./csat-operations.js";import{supportCsatSurveyOperations as P}from"./csat-survey-operations.js";import{supportCustomerSessionConsentOperations as z}from"./customer-session-consent-operations.js";import{supportDataLifecycleOperations as E}from"./data-lifecycle-operations.js";import{supportExportOperations as T}from"./export-operations.js";import{supportIdentityResolutionOperations as D}from"./identity-resolution-operations.js";import{supportInternalNoteOperations as U}from"./internal-note-operations.js";import{supportKnowledgeOperations as q}from"./knowledge-authority-operations.js";import{supportLiveChatContinuityOperations as B}from"./live-chat-continuity-operations.js";import{supportMembershipOperations as F}from"./membership-operations.js";import{supportMetadataOperations as G}from"./metadata-operations.js";import{supportNotificationOperations as H}from"./notification-operations.js";import{supportOpaHandoffOperations as j}from"./opa-handoff-operations.js";import{AiCaseInput as K,AuthSessionExchangeInput as N,AuthSessionExchangeOutput as J,CaseAssignmentInput as X,CaseAssignmentMutationInput as Y,CaseCreateInput as Z,CaseGetInput as _,CaseRelationInput as u,CaseRelationMutationInput as oo,CaseReplyInput as to,CaseSnoozeInput as po,CaseTransitionInput as ro,CaseWriteInput as S,CsatInput as so,HelpCenterSearchInput as eo,ProviderOperationInput as ao,PublicBootstrapInput as no,PublicIntakeInput as io,QueryInput as c,QueryOutput as m,QueueInput as uo,SlaInput as co,SupportCaseRelationMutationOutput as mo,SupportMutationOutput as d,supportOperationErrors as r,TeamInput as lo,WorkspaceConfigurationInput as C}from"./operation-schemas.js";import{supportReportExportOperations as So}from"./report-export-operations.js";import{supportReportingOperations as Co}from"./reporting-operations.js";import{SupportQueueListQueryV2 as fo,SupportQueueUpsertCommandV2 as go,SupportTeamUpsertCommandV2 as yo,supportRoutingOperations as ho}from"./routing-operations.js";import{supportSearchViewOperations as Oo}from"./search-view-operations.js";import{supportServiceProfileOperations as xo}from"./service-profile-operations.js";import{supportSignedWebhookOperations as Vo}from"./signed-webhook-operations.js";import{supportSkillsRoutingOperations as ko}from"./skills-routing-operations.js";import{SupportSlaClockMutateCommandV2 as vo,SupportSlaClockMutateCommandV3 as Io,SupportSlaPolicyListQueryV2 as Ro,SupportSlaPolicyListQueryV3 as Ao,SupportSlaPolicyUpsertCommandV2 as Mo,SupportSlaPolicyUpsertCommandV3 as bo,supportSlaOperations as Lo}from"./sla-operations.js";import{supportSloIncidentOperations as wo}from"./slo-incident-operations.js";import{supportWorkspaceBrandLocaleResidencyOperations as Qo}from"./workspace-brand-locale-residency-operations.js";import{SupportWorkspaceMigrateModeCommandV2 as Wo,supportWorkspaceMigrationOperations as Po}from"./workspace-migration-operations.js";import{supportWorkspaceOnboardingOperations as zo}from"./workspace-onboarding-operations.js";import{SupportWorkspaceConfigureCommandV2 as Eo,SupportWorkspaceGetQueryV2 as To,supportWorkspaceOperations as Do}from"./workspace-operations.js";export const CustomerSupportOperationsDocBlock={id:"docs.customer-support.operations",title:"SupportOS operations",summary:"Semantic SupportOS commands and their transport bindings.",kind:"reference",visibility:"public",route:"/docs/customer-support/operations",tags:["supportos","operations","http"],body:`# SupportOS operations
+
+The contracts are transport-neutral. The HTTP adapter derives tenant and
+workspace authority from the authenticated session, reads \`caseRef\` from the
+path for transitions, reads \`idempotencyKey\` from the Idempotency-Key header,
+and validates the remaining semantic fields from the JSON body. Mutation
+outputs may include a redacted \`projection\`; sensitive case content is never
+required in a receipt. Stable error keys are mapped to protocol status codes.
+`};const s=(o,p)=>({key:o,version:"1.0.0",title:p,description:p,goal:p,context:"Tenant and workspace authority are derived from authenticated server context; callers cannot provide authority.",domain:"customer-support",owners:["platform.support"],tags:["support","supportos","tenant-scoped"],stability:"experimental",docId:[f(CustomerSupportOperationsDocBlock.id),...o==="support.case.list"?[k]:[],...o.startsWith("support.case.")&&["support.case.merge","support.case.split","support.case.link"].includes(o)?[M]:[],...o==="support.auth.session-exchange"?[O]:[],...o==="support.case.assign"?[V]:[]]});function t(o,p,n){return e({meta:s(o,p),io:{input:n,output:d,errors:r},policy:{auth:"user",pii:["subject","body"]}})}function a(o,p,n){return i({meta:s(o,p),io:{input:n,output:m,errors:r},policy:{auth:"user",pii:[]}})}function l(o,p){return e({meta:{...s(o,p),version:"2.0.0",description:`${p} with atomic two-case revision fencing and immutable relation evidence.`,tags:["support","supportos","tenant-scoped","case-relation-v2"]},io:{input:oo,output:mo,errors:r},policy:{auth:"user",pii:[]}})}export const SupportCaseMergeCommandV1=t("support.case.merge","Merge support cases",u);export const SupportCaseSplitCommandV1=t("support.case.split","Split support case",u);export const SupportCaseLinkCommandV1=t("support.case.link","Link support case",u);export const SupportCaseMergeCommandV2=l("support.case.merge","Merge support cases");export const SupportCaseSplitCommandV2=l("support.case.split","Split support case");export const SupportCaseLinkCommandV2=l("support.case.link","Link support case");export const SupportCaseAssignCommandV1=t("support.case.assign","Assign support case",X);export const SupportCaseAssignCommandV2=e({meta:{...s("support.case.assign","Assign support case"),key:"support.case.assign",version:"2.0.0",description:"Revision-fenced claim, release, assignment, and governed steal semantics."},io:{input:Y,output:d,errors:r},policy:{auth:"user",pii:[]}});export const SupportWorkspaceConfigureCommandV1=t("support.workspace.configure","Configure support workspace",C);export const SupportWorkspaceGetQueryV1=a("support.workspace.get","Get support workspace",c);export const SupportWorkspaceMigrateModeCommandV1=t("support.workspace.migrate-mode","Migrate workspace mode",C);export const SupportQueueUpsertCommandV1=t("support.queue.upsert","Upsert support queue",uo);export const SupportTeamUpsertCommandV1=t("support.team.upsert","Upsert support team",lo);export const SupportQueueListQueryV1=a("support.queue.list","List support queues",c);export const SupportSlaPolicyUpsertCommandV1=t("support.sla.upsert","Upsert SLA policy",co);export const SupportCsatRecordCommandV1=t("support.csat.record","Record support satisfaction",so);export const SupportCaseSnoozeCommandV1=t("support.case.snooze","Snooze support case",po);export const SupportCaseArchiveCommandV1=t("support.case.archive","Archive support case",S);export const SupportCaseEraseCommandV1=t("support.case.erase","Erase support subject data",S);export const supportCommands=[t("support.case.create","Create support case",Z),t("support.case.reply","Record and deliver support reply",to),t("support.case.transition","Transition support case",ro),SupportCaseAssignCommandV2,SupportCaseMergeCommandV2,SupportCaseSplitCommandV2,SupportCaseLinkCommandV2,...[["support.ai.analyze","Analyze support case"],["support.ai.triage","Triage support case"],["support.ai.summarize","Summarize support case"],["support.ai.draft","Draft support reply"],["support.ai.translate","Translate support content"],["support.ai.propose-action","Propose support action"],["support.ai.propose-sop","Propose support SOP"]].map(([o,p])=>t(o,p,K)),...[["support.provider.connect","Connect support provider"],["support.provider.backfill","Backfill support provider"],["support.provider.sync","Synchronize support provider"],["support.provider.reconcile","Reconcile support provider"],["support.provider.cutover","Cut over support authority"],["support.provider.rollback","Roll back support cutover"],["support.provider.disconnect","Disconnect support provider"]].map(([o,p])=>t(o,p,ao))];export const SupportWidgetSubmitCommand=e({meta:s("support.widget.submit","Submit customer support intake"),io:{input:io,output:d,errors:r},policy:{auth:"anonymous",pii:["payload"]}});export const SupportAuthSessionExchangeCommand=e({meta:s("support.auth.session-exchange","Exchange an AuthOS session"),io:{input:N,output:J,errors:r},policy:{auth:"user",pii:[]}});export const SupportCaseGetQuery=a("support.case.get","Get support case",_);export const SupportWidgetBootstrapQuery=i({meta:s("support.widget.bootstrap","Bootstrap support messenger"),io:{input:no,output:m,errors:r},policy:{auth:"anonymous",pii:[]}});export const SupportHelpCenterSearchQuery=i({meta:s("support.help-center.search","Search support help center"),io:{input:eo,output:m,errors:r},policy:{auth:"anonymous",pii:["query"]}});export const supportQueries=[...[["support.case.list","List support cases"],["support.provider.status","Get provider synchronization status"],["support.portal.list","List customer portal cases"]].map(([o,p])=>a(o,p,c)),SupportCaseGetQuery,SupportWidgetBootstrapQuery,SupportHelpCenterSearchQuery];export const supportOperations=[...y,...g,...supportCommands,...R,...b,...h,...x,...Do,...Qo,...zo,...Po,...F,...ho,...ko,...wo,...Lo,...W,...P,...G,...H,...Co,...So,...w,...L,...E,...T,...z,...Oo,...xo,...D,...U,...B,...q,...Vo,...j,...A,SupportAuthSessionExchangeCommand,SupportWidgetSubmitCommand,...supportQueries];export const supportRoutingOperationVersions={"support.team.upsert":{"1.0.0":SupportTeamUpsertCommandV1,"2.0.0":yo},"support.queue.upsert":{"1.0.0":SupportQueueUpsertCommandV1,"2.0.0":go},"support.queue.list":{"1.0.0":SupportQueueListQueryV1,"2.0.0":fo}};export const supportSlaOperationVersions={"support.sla.upsert":{"1.0.0":SupportSlaPolicyUpsertCommandV1,"2.0.0":Mo,"3.0.0":bo},"support.sla.list":{"2.0.0":Ro,"3.0.0":Ao},"support.sla.clock.mutate":{"2.0.0":vo,"3.0.0":Io}};export const supportCsatOperationVersions={"support.csat.record":{"1.0.0":SupportCsatRecordCommandV1,"2.0.0":Q}};export const supportCaseLifecycleOperationVersions={"support.case.snooze":{"1.0.0":SupportCaseSnoozeCommandV1,"2.0.0":I},"support.case.archive":{"1.0.0":SupportCaseArchiveCommandV1,"2.0.0":v}};export const supportCaseErasureLegacyOperationVersions={"support.case.erase":{"1.0.0":SupportCaseEraseCommandV1}};export const supportCaseRelationOperationVersions={"support.case.merge":{"1.0.0":SupportCaseMergeCommandV1,"2.0.0":SupportCaseMergeCommandV2},"support.case.split":{"1.0.0":SupportCaseSplitCommandV1,"2.0.0":SupportCaseSplitCommandV2},"support.case.link":{"1.0.0":SupportCaseLinkCommandV1,"2.0.0":SupportCaseLinkCommandV2}};export const supportCaseAssignmentOperationVersions={"support.case.assign":{"1.0.0":SupportCaseAssignCommandV1,"2.0.0":SupportCaseAssignCommandV2}};export const supportWorkspaceOperationVersions={"support.workspace.configure":{"1.0.0":SupportWorkspaceConfigureCommandV1,"2.0.0":Eo},"support.workspace.get":{"1.0.0":SupportWorkspaceGetQueryV1,"2.0.0":To}};export const supportWorkspaceMigrationOperationVersions={"support.workspace.migrate-mode":{"1.0.0":SupportWorkspaceMigrateModeCommandV1,"2.0.0":Wo}};

package/dist/customer-support/platform-authority-binding-registry.d.ts

@@ -0,0 +1,7 @@
+import type { SupportPlatformAuthorityFacetKey } from './platform-authority.js';
+export declare const SUPPORT_PLATFORM_AUTHORITY_BINDING_KEYS: readonly ['caseCore', 'caseAssignments', 'caseLifecycle', 'caseRelations', 'casePresence', 'workspaces', 'workspaceBrandLocaleResidency', 'workspaceOnboarding', 'workspaceMigrations', 'memberships', 'routing', 'skillsRouting', 'slaPolicies', 'slaClocks', 'slaBreaches', 'csat', 'cryptoRotations', 'cryptoRotationDrills', 'decisions', 'decisionEvaluations', 'customerSessions', 'liveChatContinuity', 'dataLifecycle', 'exports', 'exportArtifacts', 'exportArtifactStorage', 'exportArtifactCleanup', 'internalNotes', 'identityResolution', 'attachmentSafety', 'billingEntitlements', 'companyActions', 'metadata', 'notifications', 'searchViews', 'serviceProfiles', 'opaHandoffs', 'sloIncidents', 'reporting', 'aiOutcomeLearning', 'aiOutcomeEvaluations', 'signedWebhooks'];
+export type SupportPlatformAuthorityBindingKey = (typeof SUPPORT_PLATFORM_AUTHORITY_BINDING_KEYS)[number];
+export declare const SUPPORT_FACET_BINDINGS: Partial<Record<SupportPlatformAuthorityFacetKey, readonly SupportPlatformAuthorityBindingKey[]>>;
+export declare const SUPPORT_OPERATION_BINDINGS: Readonly<Partial<Record<string, SupportPlatformAuthorityBindingKey>>>;
+export declare const SUPPORT_PLATFORM_V1_REQUIRED_BINDINGS: readonly ["caseCore", "caseAssignments", "caseLifecycle", "caseRelations", "casePresence", "workspaces", "workspaceOnboarding", "workspaceMigrations", "memberships", "routing", "skillsRouting", "slaPolicies", "slaClocks", "slaBreaches", "csat", "cryptoRotations", "decisions", "customerSessions", "internalNotes", "identityResolution", "attachmentSafety", "metadata", "notifications", "searchViews", "serviceProfiles", "opaHandoffs"];
+export declare const SUPPORT_PLATFORM_V2_REQUIRED_BINDINGS: readonly ["caseCore", "caseAssignments", "caseLifecycle", "caseRelations", "casePresence", "workspaces", "workspaceOnboarding", "workspaceMigrations", "memberships", "routing", "skillsRouting", "slaPolicies", "slaClocks", "slaBreaches", "csat", "cryptoRotations", "decisions", "customerSessions", "internalNotes", "identityResolution", "attachmentSafety", "metadata", "notifications", "searchViews", "serviceProfiles", "opaHandoffs", "sloIncidents"];

package/dist/customer-support/platform-authority-binding-registry.js

@@ -0,0 +1 @@
+export const SUPPORT_PLATFORM_AUTHORITY_BINDING_KEYS=["caseCore","caseAssignments","caseLifecycle","caseRelations","casePresence","workspaces","workspaceBrandLocaleResidency","workspaceOnboarding","workspaceMigrations","memberships","routing","skillsRouting","slaPolicies","slaClocks","slaBreaches","csat","cryptoRotations","cryptoRotationDrills","decisions","decisionEvaluations","customerSessions","liveChatContinuity","dataLifecycle","exports","exportArtifacts","exportArtifactStorage","exportArtifactCleanup","internalNotes","identityResolution","attachmentSafety","billingEntitlements","companyActions","metadata","notifications","searchViews","serviceProfiles","opaHandoffs","sloIncidents","reporting","aiOutcomeLearning","aiOutcomeEvaluations","signedWebhooks"];export const SUPPORT_FACET_BINDINGS={cases:["caseCore"],workspaces:["workspaces"],routing:["routing","skillsRouting"],slas:["slaPolicies","slaClocks","slaBreaches"],serviceProfiles:["serviceProfiles","identityResolution"],customer:["internalNotes","casePresence","opaHandoffs","customerSessions","liveChatContinuity"],administration:["memberships","attachmentSafety","billingEntitlements","companyActions","metadata","notifications","searchViews","csat","cryptoRotations","cryptoRotationDrills","dataLifecycle","exports","exportArtifacts","exportArtifactStorage","exportArtifactCleanup","sloIncidents","reporting","signedWebhooks"],decisioning:["decisions","decisionEvaluations"],ai:["aiOutcomeLearning","aiOutcomeEvaluations"]};export const SUPPORT_OPERATION_BINDINGS={"support.customer-experience.live-chat-continuity.bind":"liveChatContinuity","support.customer-experience.live-chat-continuity.get":"liveChatContinuity","support.webhook.subscription.upsert":"signedWebhooks","support.webhook.subscription.rotate-secret":"signedWebhooks","support.webhook.subscription.get":"signedWebhooks","support.webhook.subscription.list":"signedWebhooks","support.webhook.delivery.replay":"signedWebhooks","support.webhook.delivery.get":"signedWebhooks","support.webhook.delivery.list":"signedWebhooks","support.crypto.rotation-drill.request":"cryptoRotationDrills","support.crypto.rotation-drill.execute":"cryptoRotationDrills","support.crypto.rotation-drill.get":"cryptoRotationDrills","support.crypto.rotation-drill.list":"cryptoRotationDrills","support.billing-entitlements.snapshot.refresh":"billingEntitlements","support.billing-entitlements.decide":"billingEntitlements","support.billing-entitlements.snapshot.get":"billingEntitlements","support.billing-entitlements.decision.list":"billingEntitlements","support.company-action.submit":"companyActions","support.company-action.outcome.record":"companyActions","support.company-action.compensate":"companyActions","support.company-action.get":"companyActions","support.company-action.list":"companyActions"};export const SUPPORT_PLATFORM_V1_REQUIRED_BINDINGS=["caseCore","caseAssignments","caseLifecycle","caseRelations","casePresence","workspaces","workspaceOnboarding","workspaceMigrations","memberships","routing","skillsRouting","slaPolicies","slaClocks","slaBreaches","csat","cryptoRotations","decisions","customerSessions","internalNotes","identityResolution","attachmentSafety","metadata","notifications","searchViews","serviceProfiles","opaHandoffs"];export const SUPPORT_PLATFORM_V2_REQUIRED_BINDINGS=[...SUPPORT_PLATFORM_V1_REQUIRED_BINDINGS,"sloIncidents"];

package/dist/customer-support/platform-authority-bindings.d.ts

@@ -0,0 +1,107 @@
+import type { DecisionEvaluationAuthorityPort, DecisionEvidenceAdministrationPort, DecisionLifecycleAuthorityPort } from '../decisioning/index.js';
+import type { SupportAiOutcomeEvaluationAuthorityPort } from './ai-outcome-evaluation.js';
+import type { SupportAiOutcomeLearningAuthorityPort } from './ai-outcome-learning.js';
+import type { SupportAttachmentSafetyAuthorityPort } from './attachment-safety.js';
+import type { SupportBillingEntitlementAuthorityPort } from './billing-entitlements.js';
+import type { SupportCaseAssignmentAuthorityPort } from './case-assignments.js';
+import type { SupportCaseLifecycleAuthorityPort } from './case-lifecycle.js';
+import type { SupportCasePresencePort } from './case-presence.js';
+import type { SupportCaseRelationsAuthorityPort } from './case-relations.js';
+import type { SupportCompanyActionAuthorityPort } from './company-action-plans.js';
+import type { SupportCryptoRotationAuthorityPort } from './crypto-rotation.js';
+import type { SupportCryptoRotationDrillAuthorityPort } from './crypto-rotation-drill.js';
+import type { SupportCsatAuthorityPort } from './csat.js';
+import type { SupportCustomerSessionAuthorityPort } from './customer-session-consent.js';
+import type { SupportDataLifecycleAuthorityPort } from './data-lifecycle.js';
+import type { SupportExportArtifactAuthorityPort } from './export-artifact-access.js';
+import type { SupportExportArtifactCleanupAuthorityPort, SupportExportArtifactStoragePort } from './export-artifact-storage.js';
+import type { SupportExportAuthorityPort } from './exports.js';
+import type { SupportIdentityResolutionAuthorityPort } from './identity-resolution.js';
+import type { SupportInternalNoteAuthorityPort } from './internal-notes.js';
+import type { SupportLiveChatContinuityAuthorityPort } from './live-chat-continuity.js';
+import type { SupportMembershipAdministrationPort } from './memberships.js';
+import type { SupportMetadataAuthorityPort } from './metadata.js';
+import type { SupportNotificationAuthorityPort } from './notifications.js';
+import type { SupportOpaHandoffAuthorityPort } from './opa-handoffs.js';
+import type { SupportPlatformAuthorityFacetKey, SupportPlatformAuthorityPort } from './platform-authority.js';
+import { type SupportPlatformAuthorityBindingKey } from './platform-authority-binding-registry.js';
+import type { SupportAuthorityPort } from './ports.js';
+import type { SupportReportingAuthorityPort } from './reporting-port.js';
+import type { SupportRoutingAdministrationPort } from './routing-administration.js';
+import type { SupportSavedViewAuthorityPort } from './search-views.js';
+import type { SupportServiceProfileAuthorityPort } from './service-profile.js';
+import type { SupportSignedWebhookAuthorityPort } from './signed-webhook-ports.js';
+import type { SupportSkillsRoutingAuthorityPort } from './skills-routing.js';
+import type { SupportSlaAdministrationPort, SupportSlaBreachAuthorityPort } from './sla-administration.js';
+import type { SupportSloIncidentAuthorityPort } from './slo-incident-ports.js';
+import type { SupportWorkspaceAdministrationPort } from './workspace-administration.js';
+import type { SupportWorkspaceBrandLocaleResidencyAuthorityPort } from './workspace-brand-locale-residency.js';
+import type { SupportWorkspaceMigrationAuthorityPort } from './workspace-migration.js';
+import type { SupportWorkspaceOnboardingAuthorityPort } from './workspace-onboarding.js';
+export { SUPPORT_PLATFORM_AUTHORITY_BINDING_KEYS, SUPPORT_PLATFORM_V1_REQUIRED_BINDINGS, SUPPORT_PLATFORM_V2_REQUIRED_BINDINGS, type SupportPlatformAuthorityBindingKey, } from './platform-authority-binding-registry.js';
+export interface SupportPlatformAuthorityBindings {
+    readonly caseCore?: SupportAuthorityPort;
+    readonly caseAssignments?: SupportCaseAssignmentAuthorityPort;
+    readonly caseLifecycle?: SupportCaseLifecycleAuthorityPort;
+    readonly caseRelations?: SupportCaseRelationsAuthorityPort;
+    readonly casePresence?: SupportCasePresencePort;
+    readonly workspaces?: SupportWorkspaceAdministrationPort;
+    readonly workspaceBrandLocaleResidency?: SupportWorkspaceBrandLocaleResidencyAuthorityPort;
+    readonly workspaceOnboarding?: SupportWorkspaceOnboardingAuthorityPort;
+    readonly workspaceMigrations?: SupportWorkspaceMigrationAuthorityPort;
+    readonly memberships?: SupportMembershipAdministrationPort;
+    readonly routing?: SupportRoutingAdministrationPort;
+    readonly skillsRouting?: SupportSkillsRoutingAuthorityPort;
+    readonly slaPolicies?: Pick<SupportSlaAdministrationPort, 'upsertPolicy' | 'listPolicies'>;
+    readonly slaClocks?: Pick<SupportSlaAdministrationPort, 'mutateClock'>;
+    readonly slaBreaches?: SupportSlaBreachAuthorityPort;
+    readonly csat?: SupportCsatAuthorityPort;
+    readonly cryptoRotations?: SupportCryptoRotationAuthorityPort;
+    readonly cryptoRotationDrills?: SupportCryptoRotationDrillAuthorityPort;
+    readonly decisions?: DecisionLifecycleAuthorityPort;
+    readonly decisionEvaluations?: DecisionEvaluationAuthorityPort & DecisionEvidenceAdministrationPort;
+    readonly customerSessions?: SupportCustomerSessionAuthorityPort;
+    readonly liveChatContinuity?: SupportLiveChatContinuityAuthorityPort;
+    readonly dataLifecycle?: SupportDataLifecycleAuthorityPort;
+    readonly exports?: SupportExportAuthorityPort;
+    readonly exportArtifacts?: SupportExportArtifactAuthorityPort;
+    readonly exportArtifactStorage?: SupportExportArtifactStoragePort;
+    readonly exportArtifactCleanup?: SupportExportArtifactCleanupAuthorityPort;
+    readonly internalNotes?: SupportInternalNoteAuthorityPort;
+    readonly identityResolution?: SupportIdentityResolutionAuthorityPort;
+    readonly attachmentSafety?: SupportAttachmentSafetyAuthorityPort;
+    readonly billingEntitlements?: SupportBillingEntitlementAuthorityPort;
+    readonly companyActions?: SupportCompanyActionAuthorityPort;
+    readonly metadata?: SupportMetadataAuthorityPort;
+    readonly notifications?: SupportNotificationAuthorityPort;
+    readonly searchViews?: SupportSavedViewAuthorityPort;
+    readonly serviceProfiles?: SupportServiceProfileAuthorityPort;
+    readonly opaHandoffs?: SupportOpaHandoffAuthorityPort;
+    readonly sloIncidents?: SupportSloIncidentAuthorityPort;
+    readonly reporting?: SupportReportingAuthorityPort;
+    readonly aiOutcomeLearning?: SupportAiOutcomeLearningAuthorityPort;
+    readonly aiOutcomeEvaluations?: SupportAiOutcomeEvaluationAuthorityPort;
+    readonly signedWebhooks?: SupportSignedWebhookAuthorityPort;
+}
+export interface SupportPlatformAuthorityConformanceProfile {
+    readonly profileRef: string;
+    readonly requiredFacets: readonly SupportPlatformAuthorityFacetKey[];
+    readonly requiredBindings: readonly SupportPlatformAuthorityBindingKey[];
+    readonly requiredOperations?: readonly string[];
+}
+export declare class SupportAuthorityCapabilityUnavailableError extends Error {
+    readonly facetKey: SupportPlatformAuthorityFacetKey;
+    readonly code = "SUPPORT_AUTHORITY_CAPABILITY_UNAVAILABLE";
+    constructor(facetKey: SupportPlatformAuthorityFacetKey);
+}
+export declare class SupportAuthorityBindingUnavailableError extends Error {
+    readonly bindingKey: SupportPlatformAuthorityBindingKey;
+    readonly code = "SUPPORT_AUTHORITY_BINDING_UNAVAILABLE";
+    constructor(bindingKey: SupportPlatformAuthorityBindingKey);
+}
+export declare class SupportAuthorityOperationUnavailableError extends Error {
+    readonly operationRef: string;
+    readonly code = "SUPPORT_AUTHORITY_OPERATION_UNAVAILABLE";
+    constructor(operationRef: string);
+}
+export declare function assertSupportPlatformAuthorityConformance(authority: SupportPlatformAuthorityPort, requirements: readonly SupportPlatformAuthorityFacetKey[] | SupportPlatformAuthorityConformanceProfile): void;

package/dist/customer-support/platform-authority-bindings.js

@@ -0,0 +1 @@
+import{SUPPORT_FACET_BINDINGS as p,SUPPORT_OPERATION_BINDINGS as u}from"./platform-authority-binding-registry.js";export{SUPPORT_PLATFORM_AUTHORITY_BINDING_KEYS,SUPPORT_PLATFORM_V1_REQUIRED_BINDINGS,SUPPORT_PLATFORM_V2_REQUIRED_BINDINGS}from"./platform-authority-binding-registry.js";export class SupportAuthorityCapabilityUnavailableError extends Error{facetKey;code="SUPPORT_AUTHORITY_CAPABILITY_UNAVAILABLE";constructor(t){super(`SupportOS authority facet ${t} is unavailable.`);this.facetKey=t;this.name="SupportAuthorityCapabilityUnavailableError"}}export class SupportAuthorityBindingUnavailableError extends Error{bindingKey;code="SUPPORT_AUTHORITY_BINDING_UNAVAILABLE";constructor(t){super(`SupportOS authority binding ${t} is unavailable.`);this.bindingKey=t;this.name="SupportAuthorityBindingUnavailableError"}}export class SupportAuthorityOperationUnavailableError extends Error{operationRef;code="SUPPORT_AUTHORITY_OPERATION_UNAVAILABLE";constructor(t){super(`SupportOS authority operation ${t} is unavailable.`);this.operationRef=t;this.name="SupportAuthorityOperationUnavailableError"}}export function assertSupportPlatformAuthorityConformance(t,o){y(t);const r=Array.isArray(o)?void 0:o,i=r?r.requiredFacets:o;for(const e of new Set(i))n(t,e);if(!r)return;for(const e of new Set(r.requiredBindings))if(t.bindings?.[e]===void 0)throw new SupportAuthorityBindingUnavailableError(e);const a=new Set(i.flatMap((e)=>t.facet(e).supportedOperations));for(const e of r.requiredOperations??[])if(!a.has(e))throw new SupportAuthorityOperationUnavailableError(e)}function y(t){for(const o of new Set(t.capabilities)){if(t.facet(o)!==t.facets[o])throw new SupportAuthorityCapabilityUnavailableError(o);n(t,o)}for(const[o,r]of Object.entries(p))if(r?.some((i)=>t.bindings?.[i]!==void 0)&&!t.capabilities.includes(o))throw new SupportAuthorityCapabilityUnavailableError(o);for(const o of t.capabilities)for(const r of t.facet(o).supportedOperations){const i=u[r];if(i&&t.bindings?.[i]===void 0)throw new SupportAuthorityBindingUnavailableError(i)}}function n(t,o){const r=t.facet(o);if(r.key!==o||r.availability!=="available"||!t.capabilities.includes(o)||r.supportedOperations.length===0||!s(t.bindings,o)&&r.execute===void 0&&r.query===void 0)throw new SupportAuthorityCapabilityUnavailableError(o)}function s(t,o){return(p[o]??[]).some((r)=>t?.[r]!==void 0)}

package/dist/customer-support/platform-authority-doc.d.ts

@@ -0,0 +1,10 @@
+export declare const SupportPlatformAuthorityDocBlock: {
+    id: string;
+    title: string;
+    summary: string;
+    kind: "reference";
+    visibility: "public";
+    route: string;
+    tags: string[];
+    body: string;
+};

package/dist/customer-support/platform-authority-doc.js

@@ -0,0 +1,3 @@
+export const SupportPlatformAuthorityDocBlock={id:"customer-support-v1-platform-authority",title:"SupportOS composite platform authority",summary:"Provider-neutral, capability-declared authority facets for managed and self-hosted SupportOS runtimes.",kind:"reference",visibility:"public",route:"/docs/platform/supportos/platform-authority",tags:["supportos","authority","ports","self-hosted"],body:`# SupportOS platform authority
+
+The legacy four-method SupportAuthorityPort remains supported through adaptLegacySupportAuthority. Missing facets stay explicitly unavailable and fail conformance; adapters never silently claim complete v1 support. Production and self-hosted profiles declare every enabled facet, typed authority binding, and canonical operation they require. Conformance rejects missing bindings, undiscoverable operations, inconsistent facet registries, and capabilities advertised without an executable surface. Mutations carry idempotency, revision/fencing, policy, and evidence references. Queries carry pagination, watermark, and redaction intent.`};

package/dist/customer-support/platform-authority.d.ts

@@ -0,0 +1,117 @@
+import type { SupportAiOutcomeEvaluationAuthorityPort } from './ai-outcome-evaluation.js';
+import type { SupportAiOutcomeLearningAuthorityPort } from './ai-outcome-learning.js';
+import type { SupportCaseAssignmentAuthorityPort } from './case-assignments.js';
+import type { SupportCaseLifecycleAuthorityPort } from './case-lifecycle.js';
+import type { SupportCaseRelationsAuthorityPort } from './case-relations.js';
+import type { SupportCryptoRotationAuthorityPort } from './crypto-rotation.js';
+import type { SupportCustomerSessionAuthorityPort } from './customer-session-consent.js';
+import type { SupportExportArtifactAuthorityPort } from './export-artifact-access.js';
+import type { SupportExportArtifactCleanupAuthorityPort, SupportExportArtifactStoragePort } from './export-artifact-storage.js';
+import type { SupportExportAuthorityPort } from './exports.js';
+import type { SupportIdentityResolutionAuthorityPort } from './identity-resolution.js';
+import type { SupportInternalNoteAuthorityPort } from './internal-notes.js';
+import type { SupportLiveChatContinuityAuthorityPort } from './live-chat-continuity.js';
+import type { SupportMembershipAdministrationPort } from './memberships.js';
+import type { SupportMetadataAuthorityPort } from './metadata.js';
+import type { SupportNotificationAuthorityPort } from './notifications.js';
+import type { SupportPlatformAuthorityBindings } from './platform-authority-bindings.js';
+import type { SupportAuthorityPort, SupportAuthorityScope } from './ports.js';
+import type { SupportReportingAuthorityPort } from './reporting-port.js';
+import type { SupportSavedViewAuthorityPort } from './search-views.js';
+import type { SupportServiceProfileAuthorityPort } from './service-profile.js';
+import type { SupportSignedWebhookAuthorityPort } from './signed-webhook-ports.js';
+import type { SupportSloIncidentAuthorityPort } from './slo-incident-ports.js';
+import type { SupportWorkspaceAdministrationPort } from './workspace-administration.js';
+import type { SupportWorkspaceOnboardingAuthorityPort } from './workspace-onboarding.js';
+export { assertSupportPlatformAuthorityConformance, SupportAuthorityBindingUnavailableError, SupportAuthorityCapabilityUnavailableError, SupportAuthorityOperationUnavailableError, } from './platform-authority-bindings.js';
+export { SupportPlatformAuthorityDocBlock } from './platform-authority-doc.js';
+export declare const SUPPORT_PLATFORM_AUTHORITY_FACETS: readonly ['workspaces', 'cases', 'routing', 'slas', 'serviceProfiles', 'decisioning', 'sops', 'providers', 'ai', 'customer', 'administration'];
+export type SupportPlatformAuthorityFacetKey = (typeof SUPPORT_PLATFORM_AUTHORITY_FACETS)[number];
+export type SupportAuthorityConcurrency = {
+    readonly kind: 'expected-revision';
+    readonly value: number;
+} | {
+    readonly kind: 'fence-token';
+    readonly value: string;
+};
+export interface SupportAuthorityMutationRequest {
+    readonly operationRef: string;
+    readonly resourceRef?: string;
+    readonly idempotencyKey: string;
+    readonly concurrency: SupportAuthorityConcurrency;
+    readonly policyRefs: readonly string[];
+    readonly evidenceRefs: readonly string[];
+    readonly payload: Readonly<Record<string, unknown>>;
+}
+export interface SupportAuthorityQueryRequest {
+    readonly operationRef: string;
+    readonly resourceRef?: string;
+    readonly cursor?: string;
+    readonly limit: number;
+    readonly watermark?: string;
+    readonly projection: 'redacted' | 'sensitive';
+}
+export interface SupportAuthorityMutationResult {
+    readonly resourceRef?: string;
+    readonly revision?: number;
+    readonly receiptRef: string;
+    readonly status: 'accepted' | 'completed' | 'pending_review' | 'rejected';
+    readonly evidenceRefs: readonly string[];
+}
+export interface SupportAuthorityQueryResult {
+    readonly items: readonly Readonly<Record<string, unknown>>[];
+    readonly nextCursor?: string;
+    readonly watermark: string;
+    readonly redacted: boolean;
+}
+export interface SupportPlatformAuthorityFacet {
+    readonly key: SupportPlatformAuthorityFacetKey;
+    readonly availability: 'available' | 'unavailable';
+    readonly supportedOperations: readonly string[];
+    execute?(scope: SupportAuthorityScope, request: SupportAuthorityMutationRequest): Promise<SupportAuthorityMutationResult>;
+    query?(scope: SupportAuthorityScope, request: SupportAuthorityQueryRequest): Promise<SupportAuthorityQueryResult>;
+}
+export interface SupportCaseAuthorityFacet extends SupportPlatformAuthorityFacet, SupportAuthorityPort, SupportCaseAssignmentAuthorityPort, SupportCaseLifecycleAuthorityPort, SupportCaseRelationsAuthorityPort {
+    readonly key: 'cases';
+}
+export interface SupportAdministrationAuthorityFacet extends SupportPlatformAuthorityFacet, SupportMembershipAdministrationPort {
+    readonly key: 'administration';
+}
+export interface SupportWorkspaceAuthorityFacet extends SupportPlatformAuthorityFacet, SupportWorkspaceAdministrationPort {
+    readonly key: 'workspaces';
+}
+export interface SupportPlatformAuthorityPort {
+    readonly capabilities: readonly SupportPlatformAuthorityFacetKey[];
+    readonly facets: Readonly<Record<SupportPlatformAuthorityFacetKey, SupportPlatformAuthorityFacet>>;
+    readonly cases: SupportCaseAuthorityFacet;
+    readonly bindings?: SupportPlatformAuthorityBindings;
+    readonly workspaceAdministration?: SupportWorkspaceAuthorityFacet;
+    readonly workspaceOnboarding?: SupportWorkspaceOnboardingAuthorityPort;
+    readonly membershipAdministration?: SupportAdministrationAuthorityFacet;
+    readonly identityResolution?: SupportIdentityResolutionAuthorityPort;
+    readonly internalNotes?: SupportInternalNoteAuthorityPort;
+    readonly metadata?: SupportMetadataAuthorityPort;
+    readonly notifications?: SupportNotificationAuthorityPort;
+    readonly searchViews?: SupportSavedViewAuthorityPort;
+    readonly serviceProfiles?: SupportServiceProfileAuthorityPort;
+    readonly sloIncidents?: SupportSloIncidentAuthorityPort;
+    readonly reporting?: SupportReportingAuthorityPort;
+    readonly aiOutcomeLearning?: SupportAiOutcomeLearningAuthorityPort;
+    readonly aiOutcomeEvaluations?: SupportAiOutcomeEvaluationAuthorityPort;
+    readonly signedWebhooks?: SupportSignedWebhookAuthorityPort;
+    readonly cryptoRotations?: SupportCryptoRotationAuthorityPort;
+    readonly cryptoRotationDrills?: import('./crypto-rotation-drill').SupportCryptoRotationDrillAuthorityPort;
+    readonly customerSessions?: SupportCustomerSessionAuthorityPort;
+    readonly liveChatContinuity?: SupportLiveChatContinuityAuthorityPort;
+    readonly exports?: SupportExportAuthorityPort;
+    readonly exportArtifacts?: SupportExportArtifactAuthorityPort;
+    readonly exportArtifactStorage?: SupportExportArtifactStoragePort;
+    readonly exportArtifactCleanup?: SupportExportArtifactCleanupAuthorityPort;
+    facet(key: SupportPlatformAuthorityFacetKey): SupportPlatformAuthorityFacet;
+}
+export declare function adaptLegacySupportAuthority(legacy: SupportAuthorityPort): SupportPlatformAuthorityPort;
+export declare function composeSupportPlatformAuthority(input: {
+    readonly cases: SupportCaseAuthorityFacet;
+    readonly bindings: SupportPlatformAuthorityBindings;
+    readonly supportedOperations: Partial<Readonly<Record<SupportPlatformAuthorityFacetKey, readonly string[]>>>;
+}): SupportPlatformAuthorityPort;

package/dist/customer-support/platform-authority.js

@@ -0,0 +1 @@
+import{SupportAuthorityCapabilityUnavailableError as a}from"./platform-authority-bindings.js";export{assertSupportPlatformAuthorityConformance,SupportAuthorityBindingUnavailableError,SupportAuthorityCapabilityUnavailableError,SupportAuthorityOperationUnavailableError}from"./platform-authority-bindings.js";export{SupportPlatformAuthorityDocBlock}from"./platform-authority-doc.js";export const SUPPORT_PLATFORM_AUTHORITY_FACETS=["workspaces","cases","routing","slas","serviceProfiles","decisioning","sops","providers","ai","customer","administration"];export function adaptLegacySupportAuthority(r){const e={key:"cases",availability:"available",supportedOperations:["support.case.create","support.case.event.append","support.case.get","support.case.list"],createCase:(t,o)=>r.createCase(t,o),appendCaseEvent:(t,o,n)=>r.appendCaseEvent(t,o,n),getCase:(t,o)=>r.getCase(t,o),listCases:(t,o)=>r.listCases(t,o),assignCase:()=>Promise.reject(new a("cases")),relateCases:()=>Promise.reject(new a("cases")),snoozeCase:()=>Promise.reject(new a("cases")),archiveCase:()=>Promise.reject(new a("cases")),unsnoozeCase:()=>Promise.reject(new a("cases"))},i=Object.fromEntries(SUPPORT_PLATFORM_AUTHORITY_FACETS.map((t)=>[t,t==="cases"?e:p(t)]));return{capabilities:["cases"],facets:i,cases:e,bindings:{caseCore:r},facet:(t)=>i[t]}}export function composeSupportPlatformAuthority(r){const e=SUPPORT_PLATFORM_AUTHORITY_FACETS.filter((t)=>t==="cases"||(r.supportedOperations[t]?.length??0)>0),i=Object.fromEntries(SUPPORT_PLATFORM_AUTHORITY_FACETS.map((t)=>[t,t==="cases"?r.cases:e.includes(t)?{key:t,availability:"available",supportedOperations:r.supportedOperations[t]??[]}:p(t)]));return{capabilities:e,facets:i,cases:r.cases,bindings:r.bindings,facet:(t)=>i[t]}}function p(r){return{key:r,availability:"unavailable",supportedOperations:[]}}

package/dist/customer-support/platform-ports.d.ts

@@ -0,0 +1,202 @@
+import type { SupportAuthorityScope } from './ports.js';
+export declare const SupportRuntimeReadinessDocBlock: {
+    id: string;
+    title: string;
+    summary: string;
+    kind: "reference";
+    visibility: "public";
+    route: string;
+    tags: string[];
+    body: string;
+};
+export declare const SupportRuntimeReadinessDocRef: import("../docs").DocId;
+export declare const SUPPORT_READINESS_CHECK_KEYS: readonly ['database', 'migrations', 'worker', 'queue', 'feature-flags', 'required-adapters'];
+export type SupportReadinessCheckKey = (typeof SUPPORT_READINESS_CHECK_KEYS)[number];
+export interface SupportReadinessCheck {
+    readonly key: SupportReadinessCheckKey;
+    readonly status: 'ready' | 'degraded' | 'not-ready';
+    readonly required: boolean;
+    readonly checkedAt: string;
+    readonly evidenceRef?: string;
+}
+export interface SupportReadinessSnapshot {
+    readonly status: 'ready' | 'not-ready';
+    readonly checkedAt: string;
+    readonly checks: readonly SupportReadinessCheck[];
+}
+export interface SupportRuntimeReadinessPort {
+    read(input?: {
+        readonly signal?: AbortSignal;
+    }): Promise<SupportReadinessSnapshot>;
+}
+export interface SupportRolloutControlPort {
+    assertEnabled(input: {
+        readonly scope: SupportAuthorityScope;
+        readonly featureRefs: readonly string[];
+        readonly signal?: AbortSignal;
+    }): Promise<{
+        readonly evidenceRef: string;
+    }>;
+}
+export interface SupportIdentityGrant {
+    readonly subjectRef: string;
+    readonly tenantRef: string;
+    readonly workspaceRef: string;
+    readonly capabilityRefs: readonly string[];
+    readonly assurance: 'anonymous' | 'customer' | 'operator' | 'service';
+    readonly issuedAt: string;
+    readonly expiresAt: string;
+    readonly tokenId: string;
+}
+export interface SupportIdentityPort {
+    exchange(input: {
+        readonly hostSessionRef: string;
+        readonly audience: 'supportos';
+    }): Promise<SupportIdentityGrant>;
+    verify(input: {
+        readonly grantRef: string;
+    }): Promise<SupportIdentityGrant>;
+    isRevoked(input: {
+        readonly tokenId: string;
+    }): Promise<boolean>;
+}
+export interface SupportSecretPort {
+    resolve(input: {
+        readonly secretRef: string;
+        readonly purpose: string;
+    }): Promise<{
+        readonly value: string;
+        readonly version: string;
+    }>;
+}
+/** @deprecated Use SupportCryptoKeyManagementPort for versioned envelope keys. */
+export interface SupportKeyManagementPort {
+    encrypt(input: {
+        readonly scopeRef: string;
+        readonly plaintext: Uint8Array;
+    }): Promise<{
+        readonly ciphertext: Uint8Array;
+        readonly keyVersion: string;
+    }>;
+    decrypt(input: {
+        readonly scopeRef: string;
+        readonly ciphertext: Uint8Array;
+        readonly keyVersion: string;
+    }): Promise<Uint8Array>;
+    keyedHash(input: {
+        readonly scopeRef: string;
+        readonly value: string;
+    }): Promise<{
+        readonly digest: string;
+        readonly keyVersion: string;
+    }>;
+}
+export interface SupportObjectStorePort {
+    /** Implementations must deduplicate puts by idempotencyKey within objectRef. */
+    put(input: {
+        readonly objectRef: string;
+        readonly content: ReadableStream<Uint8Array>;
+        readonly contentType: string;
+        readonly dataClass: string;
+        readonly idempotencyKey?: string;
+        readonly signal?: AbortSignal;
+    }): Promise<{
+        readonly versionRef: string;
+        readonly digest: string;
+    }>;
+    get(input: {
+        readonly objectRef: string;
+        readonly versionRef?: string;
+        readonly signal?: AbortSignal;
+    }): Promise<ReadableStream<Uint8Array>>;
+    delete(input: {
+        readonly objectRef: string;
+        readonly signal?: AbortSignal;
+    }): Promise<void>;
+}
+/** @deprecated Use SupportDurableJobPort through adaptLegacySupportJobPort. */
+export interface SupportJobPort {
+    enqueue(input: {
+        readonly kind: string;
+        readonly workspaceRef: string;
+        readonly payloadRef: string;
+        readonly idempotencyKey: string;
+        readonly runAfter?: string;
+    }): Promise<{
+        readonly jobRef: string;
+    }>;
+}
+export interface SupportRealtimePort {
+    publish(input: {
+        readonly workspaceRef: string;
+        readonly topic: string;
+        readonly evidenceRef: string;
+    }): Promise<void>;
+}
+export interface SupportTelemetryPort {
+    record(input: {
+        readonly name: string;
+        readonly traceRef?: string;
+        readonly dimensions: Readonly<Record<string, string | number | boolean>>;
+    }): void;
+}
+export interface SupportEntitlementPort {
+    decide(input: {
+        readonly scope: SupportAuthorityScope;
+        readonly capabilityRef: string;
+        readonly units?: number;
+    }): Promise<{
+        readonly allowed: boolean;
+        readonly decisionRef: string;
+    }>;
+}
+export interface SupportKnowledgePort {
+    search(input: {
+        readonly scope: SupportAuthorityScope;
+        readonly query: string;
+        readonly locale: string;
+        readonly spaceRefs: readonly string[];
+        readonly watermark?: string;
+    }): Promise<{
+        readonly watermark: string;
+        readonly resultRefs: readonly string[];
+        readonly citationRefs: readonly string[];
+    }>;
+}
+export interface SupportWorkflowPort {
+    start(input: {
+        readonly scope: SupportAuthorityScope;
+        readonly workflowRef: string;
+        readonly revisionRef: string;
+        readonly inputRef: string;
+        readonly idempotencyKey: string;
+    }): Promise<{
+        readonly runRef: string;
+        readonly evidenceRef: string;
+    }>;
+}
+export interface SupportConnectPort {
+    decide(input: {
+        readonly scope: SupportAuthorityScope;
+        readonly operationRef: string;
+        readonly planDigest: string;
+        readonly evidenceRefs: readonly string[];
+    }): Promise<{
+        readonly allowed: boolean;
+        readonly decisionRef: string;
+        readonly approvalRef?: string;
+    }>;
+}
+export interface SupportHostRuntimePort {
+    readonly hostRef: string;
+    readonly authorityMode: 'managed' | 'self_hosted';
+    resolveScope(input: {
+        readonly requestRef: string;
+    }): Promise<SupportAuthorityScope>;
+    resolveLocale(input: {
+        readonly requestRef: string;
+    }): Promise<string>;
+    resolveBrand(input: {
+        readonly workspaceRef: string;
+    }): Promise<string>;
+}

package/dist/customer-support/platform-ports.js

@@ -0,0 +1,9 @@
+import{docRef as e}from"../docs/registry.js";export const SupportRuntimeReadinessDocBlock={id:"docs.customer-support.runtime-readiness",title:"SupportOS runtime readiness",summary:"Truthful dependency readiness for managed and self-hosted cells.",kind:"reference",visibility:"public",route:"/docs/customer-support/runtime-readiness",tags:["supportos","operations","readiness"],body:`# SupportOS runtime readiness
+
+Liveness proves only that the API process can answer. Readiness is a fresh,
+bounded projection of required migrations, database, worker, queue, feature
+flag, and adapter checks. A missing port or any required non-ready check fails
+closed. Callers provide an abort signal so timed-out checks release database and
+provider resources. Evidence references must not contain credentials or
+customer data.
+`};export const SupportRuntimeReadinessDocRef=e(SupportRuntimeReadinessDocBlock.id);export const SUPPORT_READINESS_CHECK_KEYS=["database","migrations","worker","queue","feature-flags","required-adapters"];

package/dist/customer-support/policies.d.ts

@@ -0,0 +1,38 @@
+export type SupportAutonomyLevel = 'L0' | 'L1' | 'L2' | 'L3' | 'L4';
+export interface SupportAutomationPolicy {
+    readonly autonomyLevel: SupportAutonomyLevel;
+    readonly allowedSopRefs: readonly string[];
+    readonly allowedOperationRefs: readonly string[];
+    readonly maxRisk: 'low' | 'medium' | 'high' | 'critical';
+    readonly requiresConnectDecision: boolean;
+    readonly rollbackWindowMs: number;
+}
+export interface SupportAiPolicy {
+    readonly key: string;
+    readonly version: string;
+    readonly mode: 'off' | 'copilot' | 'graduated';
+    readonly dataMode: 'redacted' | 'full-with-consent' | 'self-hosted';
+    readonly allowedInputPaths: readonly string[];
+    readonly allowedKnowledgeSpaceRefs: readonly string[];
+    readonly allowedOperationRefs: readonly string[];
+    readonly maxModelCalls: number;
+    readonly maxInputTokens: number;
+    readonly maxOutputTokens: number;
+    readonly maxCostMinor: number;
+    readonly timeoutMs: number;
+    readonly consentNoticeVersion?: string;
+}
+export interface SupportAiDecision {
+    readonly id: string;
+    readonly caseRef: string;
+    readonly kind: 'triage' | 'summary' | 'draft' | 'translation' | 'action' | 'sop-proposal';
+    readonly autonomyLevel: SupportAutonomyLevel;
+    readonly status: 'proposed' | 'approved' | 'rejected' | 'executed' | 'rolled-back';
+    readonly inputDigest: string;
+    readonly policyVersion: string;
+    readonly modelRef?: string;
+    readonly promptRef?: string;
+    readonly evidenceRefs: readonly string[];
+    readonly economicEvidenceRefs: readonly string[];
+    readonly createdAt: string;
+}