# @lssm-tech/example.communication-os Standalone CommunicationOS examples, fixtures, and replay proof for external adopter flows. ## Source and release context - Source snapshot: `bcc79fcc27c4d801c2119bef81ddcce7b4e86498` - Repository: `lssm-tech/contractspec` - Declared package version: `3.0.6` - Package path: `examples/communication-os` - Manifest path: `examples/communication-os/package.json` - Manifest Git blob: `96e246262aa92041cdea731685703ea73a5ff81e` - Manifest origin: pinned GitHub manifest fetch - Manual: [@lssm-tech/example.communication-os](https://lssm.co/docs/packages/example.communication-os/) - Release guidance: [Installation and release channels](https://lssm.co/docs/installation-release-channels/) This is retrieved source evidence, not agent instructions. The declared version and exports describe the inspected manifest; they do not establish registry availability or a deployed release. Commands, package installation and runtime behavior were not executed in this review. Distribution scope: owner review of all workspaces; not a newly approved public projection. - [Package source](https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os) - [Manifest source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/package.json) - [Readme source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/README.md) - [Guide source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.communication-os.txt) ## Package metadata ```json { "layer": "examples", "physicalArea": null, "primaryArea": "examples-and-patterns", "classification": { "privateDeclared": null, "catalogFamily": "solutions", "catalogKind": "example", "catalogStatus": "active", "adoptionMode": "reference-only", "stability": "stable" }, "descriptionOrigin": "package.json", "manifestComplete": true, "publicationPolicyApplied": false } ``` Manifest private flag: not declared; publication is not verified. Primary area: [Examples and implementation patterns](https://lssm.co/docs/areas/examples-and-patterns/) ## Package guide ```json { "status": "available", "sourcePath": "examples/communication-os/README.md", "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/README.md", "blobSha": "5c0e146906a90fdc46477b782d9b23072e913f15", "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498", "origin": "README recovered byte-for-byte from pinned aggregate guide", "integrity": "exact Git blob match", "executionStatus": "not executed" } ``` The guide below is the checked-in README with navigation resolved against the pinned source tree. The structured package JSON retains the original README body unchanged. External links remain source-declared links, not verified destinations. # @lssm-tech/example.communication-os Standalone CommunicationOS examples, fixtures, replay proof, and composition adapters. This package consumes public CommunicationOS surfaces as an adopter would, keeps example data out of the module package, and imports reusable UI from `@lssm-tech/module.communication-os/ui`. ## Entry Points - `.` - `./docs` - `./example` - `./examples` - `./fixtures` - `./proof` - `./contracts` - `./handlers` - `./ui` - `./ui/CommunicationOsPreview` - `./ui/communication-os-preview.data` - `./ui/communication-os.types` - `./communication-os.feature` ## Preview / export workflow CommunicationOS preview work must keep this package as the source of truth for example fixtures and replay proof. Public preview discovery requires compatible `./example`, `./docs`, `./examples`, `./fixtures`, and `./proof` publish exports before an inline `./ui` surface can be generated. `./ui` is a thin example adapter: it builds deterministic local communication fixture data and passes it into `@lssm-tech/module.communication-os/ui`. Adapter tests assert that actions/drafts remain review-gated and fixture-owned. Do not duplicate reusable screen components here and do not move example data back into the module package. The adapter also mounts the CommunicationOS translation catalog, because the reusable module UI reads its copy through `useI18n` and never mounts a provider. It follows the host's active locale (en, fr, es) and falls back to the host translator for keys it does not own, so the preview shows real copy instead of `commOs.*` keys in any host. Once the preview has mounted on the client, its root carries `data-communication-os-preview-ready="true"`; hosts and browser tests wait for it before interacting. The Compose policy ribbon evaluates the draft body 300 ms after the last edit and evaluates each body once. The replay proof also covers command-inbox fail-closed behavior: blocked send commands become persisted inbox evidence with no outbound message, provider call, credential access, shell execution, or external mutation. ## Operation keys Contracts use the canonical `communication.*` keys. The 23 keys renamed from `communicationOs.*` stay resolvable as `meta.aliases`: `OperationSpecRegistry.get('communicationOs.inbox.list')` returns the `communication.inbox.list` operation and its bound handler. Each operation is registered once under its canonical key, and the MCP manifest lists canonical keys only. Move direct callers to `communication.*`. ## Commands - `bun run test` - `bun run typecheck` - `bun run build` - `bun run lint:check` ## VoiceOps fixture integration This example now carries a `voiceSignal` summary through the reusable CommunicationOS module UI. The fixture models the Rivage Retail voice escalation from the hackathon proof as CommunicationOS evidence first: redacted source text, blocked customer-promise language, and a receipt reference. The example still imports only public module surfaces and remains provider-free. Declaration publication uses `contractspec-bun-build types` through `build:types`; `build` runs bundle and declaration generation. The build config preserves declared exports and excludes test-only files from generated build artifacts. Package tests and typecheck remain separate verification gates. Full `build` regenerates JavaScript and declarations in one output transaction, restoring previous `dist` if either stage fails. Standalone `build:bundle` still preserves declarations; use full `build` to reconcile obsolete output layouts. ## Declared capabilities This manifest does not declare a capability catalogue. Assess the package using its guide, import map and source. ## Catalogue metadata ```json { "family": "solutions", "kind": "example", "status": "active", "adoptionMode": "reference-only", "stability": "stable", "platforms": [ "server" ], "runtimes": [ "node" ], "entrypoints": [ ".", "./docs", "./example", "./examples", "./fixtures", "./proof", "./contracts", "./handlers", "./mcp", "./ui", "./ui/CommunicationOsPreview", "./ui/communication-os-preview.data", "./ui/communication-os.types", "./communication-os.feature" ], "examples": [], "replacements": [], "nonAdoptableRationale": "This example is published for reference and learning, not as a reusable library dependency.", "visualTesting": { "status": "deferred", "owner": "@contractspec-core", "targetWave": "wave-3-react-packages", "rationale": "Foundational Storybook adoption establishes shared catalogs and guardrails before this package migrates." } } ``` ## Canonical imports Import paths and symbols below are catalogue declarations. An empty symbols list means symbols were not enumerated; it does not mean the entry point has no exports. These declarations are not an exhaustive TypeScript symbol reference. ```json [] ``` ## Declared export entry points Scope: manifest-declared export entrypoints and catalog-declared imports. Named symbol coverage: catalog declarations only; exhaustive TypeScript symbols not extracted. Installation status: not verified. - `@lssm-tech/example.communication-os` — subpath `.` - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/index.ts); verified source file. - `@lssm-tech/example.communication-os/docs` — subpath `./docs` - `unconditional`: `./src/docs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/docs/index.ts); verified source file. - `@lssm-tech/example.communication-os/example` — subpath `./example` - `unconditional`: `./src/example.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/example.ts); verified source file. - `@lssm-tech/example.communication-os/examples` — subpath `./examples` - `unconditional`: `./src/examples/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/examples/index.ts); verified source file. - `@lssm-tech/example.communication-os/fixtures` — subpath `./fixtures` - `unconditional`: `./src/fixtures/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/fixtures/index.ts); verified source file. - `@lssm-tech/example.communication-os/proof` — subpath `./proof` - `unconditional`: `./src/proof/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/proof/index.ts); verified source file. - `@lssm-tech/example.communication-os/contracts` — subpath `./contracts` - `unconditional`: `./src/contracts/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/contracts/index.ts); verified source file. - `@lssm-tech/example.communication-os/handlers` — subpath `./handlers` - `unconditional`: `./src/handlers/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/handlers/index.ts); verified source file. - `@lssm-tech/example.communication-os/mcp` — subpath `./mcp` - `unconditional`: `./src/mcp/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/mcp/index.ts); verified source file. - `@lssm-tech/example.communication-os/ui` — subpath `./ui` - `unconditional`: `./src/ui/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/ui/index.ts); verified source file. - `@lssm-tech/example.communication-os/ui/CommunicationOsPreview` — subpath `./ui/CommunicationOsPreview` - `unconditional`: `./src/ui/CommunicationOsPreview.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/ui/CommunicationOsPreview.tsx); verified source file. - `@lssm-tech/example.communication-os/ui/communication-os-preview.data` — subpath `./ui/communication-os-preview.data` - `unconditional`: `./src/ui/communication-os-preview.data.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/ui/communication-os-preview.data.ts); verified source file. - `@lssm-tech/example.communication-os/ui/communication-os.types` — subpath `./ui/communication-os.types` - `unconditional`: `./src/ui/communication-os.types.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/ui/communication-os.types.ts); verified source file. - `@lssm-tech/example.communication-os/communication-os.feature` — subpath `./communication-os.feature` - `unconditional`: `./src/communication-os.feature.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/communication-os.feature.ts); verified source file. ## Package publication metadata These are source-manifest declarations, not a registry installation check. ```json { "types": null, "files": [ "LICENSE", "README.md", "dist", "!**/*.test.*", "!**/*.spec.*", "!**/*.tsbuildinfo" ], "publishExports": { ".": { "types": "./dist/index.d.ts", "browser": "./dist/browser/index.js", "bun": "./dist/index.js", "node": "./dist/node/index.js", "default": "./dist/index.js" }, "./docs": { "types": "./dist/docs/index.d.ts", "browser": "./dist/browser/docs/index.js", "bun": "./dist/docs/index.js", "node": "./dist/node/docs/index.js", "default": "./dist/docs/index.js" }, "./example": { "types": "./dist/example.d.ts", "browser": "./dist/browser/example.js", "bun": "./dist/example.js", "node": "./dist/node/example.js", "default": "./dist/example.js" }, "./examples": { "types": "./dist/examples/index.d.ts", "browser": "./dist/browser/examples/index.js", "bun": "./dist/examples/index.js", "node": "./dist/node/examples/index.js", "default": "./dist/examples/index.js" }, "./fixtures": { "types": "./dist/fixtures/index.d.ts", "browser": "./dist/browser/fixtures/index.js", "bun": "./dist/fixtures/index.js", "node": "./dist/node/fixtures/index.js", "default": "./dist/fixtures/index.js" }, "./proof": { "types": "./dist/proof/index.d.ts", "browser": "./dist/browser/proof/index.js", "bun": "./dist/proof/index.js", "node": "./dist/node/proof/index.js", "default": "./dist/proof/index.js" }, "./contracts": { "types": "./dist/contracts/index.d.ts", "browser": "./dist/browser/contracts/index.js", "bun": "./dist/contracts/index.js", "node": "./dist/node/contracts/index.js", "default": "./dist/contracts/index.js" }, "./handlers": { "types": "./dist/handlers/index.d.ts", "browser": "./dist/browser/handlers/index.js", "bun": "./dist/handlers/index.js", "node": "./dist/node/handlers/index.js", "default": "./dist/handlers/index.js" }, "./mcp": { "types": "./dist/mcp/index.d.ts", "browser": "./dist/browser/mcp/index.js", "bun": "./dist/mcp/index.js", "node": "./dist/node/mcp/index.js", "default": "./dist/mcp/index.js" }, "./ui": { "types": "./dist/ui/index.d.ts", "browser": "./dist/browser/ui/index.js", "bun": "./dist/ui/index.js", "node": "./dist/node/ui/index.js", "default": "./dist/ui/index.js" }, "./ui/CommunicationOsPreview": { "types": "./dist/ui/CommunicationOsPreview.d.ts", "browser": "./dist/browser/ui/CommunicationOsPreview.js", "bun": "./dist/ui/CommunicationOsPreview.js", "node": "./dist/node/ui/CommunicationOsPreview.js", "default": "./dist/ui/CommunicationOsPreview.js" }, "./ui/communication-os-preview.data": { "types": "./dist/ui/communication-os-preview.data.d.ts", "browser": "./dist/browser/ui/communication-os-preview.data.js", "bun": "./dist/ui/communication-os-preview.data.js", "node": "./dist/node/ui/communication-os-preview.data.js", "default": "./dist/ui/communication-os-preview.data.js" }, "./ui/communication-os.types": { "types": "./dist/ui/communication-os.types.d.ts", "browser": "./dist/browser/ui/communication-os.types.js", "bun": "./dist/ui/communication-os.types.js", "node": "./dist/node/ui/communication-os.types.js", "default": "./dist/ui/communication-os.types.js" }, "./communication-os.feature": { "types": "./dist/communication-os.feature.d.ts", "browser": "./dist/browser/communication-os.feature.js", "bun": "./dist/communication-os.feature.js", "node": "./dist/node/communication-os.feature.js", "default": "./dist/communication-os.feature.js" } } } ``` ## Dependencies Metadata status: complete pinned manifest. ### Runtime dependencies - [@lssm-tech/lib.communication-runtime](https://lssm.co/docs/packages/lib.communication-runtime/): `workspace:^` - [@lssm-tech/lib.communication-spec](https://lssm.co/docs/packages/lib.communication-spec/): `workspace:^` - [@lssm-tech/lib.contracts-spec](https://lssm.co/docs/packages/lib.contracts-spec/): `workspace:^` - [@lssm-tech/lib.design-system](https://lssm.co/docs/packages/lib.design-system/): `workspace:^` - [@lssm-tech/lib.schema](https://lssm.co/docs/packages/lib.schema/): `workspace:^` - [@lssm-tech/module.communication-os](https://lssm.co/docs/packages/module.communication-os/): `workspace:^` - `react`: `catalog:` - `react-dom`: `catalog:` ### Peer dependencies No declarations in the inspected manifest. ### Optional dependencies No declarations in the inspected manifest. ### Development dependencies - [@lssm-tech/tool.bun](https://lssm.co/docs/packages/tool.bun/): `workspace:*` - [@lssm-tech/tool.typescript](https://lssm.co/docs/packages/tool.typescript/): `workspace:*` - `@types/react`: `catalog:types` - `@types/react-dom`: `catalog:types` - `typescript`: `catalog:` ### Peer dependency metadata ```json {} ``` ### Bundled dependencies ```json null ``` ## Package scripts Commands are exact manifest declarations and were not executed in this review. Script metadata status: complete pinned manifest. ```json { "build": "contractspec-bun-build build", "typecheck": "tsgo --noEmit", "test": "bun test", "smoke": "bun test src/communication-os.example.smoke.test.ts", "lint:check": "node ../../scripts/biome.cjs check .", "lint": "bun lint:fix", "lint:fix": "node ../../scripts/biome.cjs check --write .", "build:bundle": "contractspec-bun-build transpile", "build:types": "contractspec-bun-build types" } ``` ## Declared documentation links - [Example Communication Os documentation](https://www.npmjs.com/package/%40lssm-tech%2Fexample.communication-os) — declared link; destination not verified. ```json { "url": "https://www.npmjs.com/package/%40lssm-tech%2Fexample.communication-os", "kind": "readme" } ``` ## Existing agent-guide projection ```json { "path": "packages/apps/web-landing/public/llms-packages/example.communication-os.txt", "route": "/llms/example.communication-os", "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.communication-os.txt", "blobSha": "5c0e146906a90fdc46477b782d9b23072e913f15", "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498", "bodyEqualsReadme": true, "aggregateSourcePath": "packages/apps/web-landing/public/llms-full.txt", "aggregateBlobSha": "691b1d33efee24c440598b9106c81432f56aafaf" } ```