# @lssm-tech/example.companyos-voiceops-workbench

Deterministic CompanyOS VoiceOps workbench example adapted from the Hackathon Voice AI UI/UX ingest lane.

## Source and release context

- Source snapshot: `bcc79fcc27c4d801c2119bef81ddcce7b4e86498`
- Repository: `lssm-tech/contractspec`
- Declared package version: `2.0.5`
- Package path: `examples/companyos-voiceops-workbench`
- Manifest path: `examples/companyos-voiceops-workbench/package.json`
- Manifest Git blob: `8317331120a44cc5ab1c1dead2f52a00be6fb9e3`
- Manifest origin: pinned GitHub manifest fetch
- Manual: [@lssm-tech/example.companyos-voiceops-workbench](https://lssm.co/docs/packages/example.companyos-voiceops-workbench/)
- 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/companyos-voiceops-workbench)
- [Manifest source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-voiceops-workbench/package.json)
- [Readme source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-voiceops-workbench/README.md)
- [Guide source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.companyos-voiceops-workbench.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": "experimental"
  },
  "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/companyos-voiceops-workbench/README.md",
  "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-voiceops-workbench/README.md",
  "blobSha": "ed4ff628709079a1d228d42194e9fc9e88d4fc0d",
  "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.

# CompanyOS VoiceOps Workbench

Deterministic example package for Hackathon Voice AI web-app parity inside the CompanyOS examples registry.

The package adapts the hackathon app's product shape into a safe, provider-free CompanyOS preview. `VoiceOpsWorkbenchPreview` now renders a package-local app shell with deterministic screen navigation for Workbench, Company, Work, Inbox, Integrations, Settings, Contracts, Receipt Viewer, and Receipt Verify. The Workbench screen keeps the core demo concepts together: source pills, redacted transcript replay, redaction proof, policy/action table, graph canvas, replay scrubber, receipt evidence, and an explicit live-mode-disabled safety banner.

This package intentionally does not ship live provider SDKs, API keys, production endpoints, generated media, raw quarantined source, browser audio capture, network behavior, or production writes. Live/provider ideas are represented only as fixture-backed disabled or reference-only view-model data.

## Source traceability

The UI model records source-path references from the Hackathon Voice AI ingest lane, including original workbench panels such as `TranscriptPanel.tsx`, `RedactionDiff.tsx`, `ReplayScrubber.tsx`, `ReceiptPanel.tsx`, `WorkTable.tsx`, and the sixty-second demo spec. Conceptual screen-map material is marked `reference-only`, while live/provider controls such as `LiveAudioRecorder.tsx` and `GradiumTtsButton.tsx` are marked `rejected-live` so hosts can audit parity without executing unsafe behavior.

## Public surface

- `VoiceOpsWorkbenchPreview` remains the public preview entrypoint.
- `initialScreenId` can render any deterministic app-shell screen for tests or host previews.
- `voiceOpsWorkbenchFixture` contains all screen, contract, approval, receipt, graph, replay, provider-readiness, and source-reference data.

## Safety boundary

All behavior is fixture/view-model only. Browser audio capture, speech recognition, live model/provider calls, router dependencies, environment reads, network requests, and production writes are represented as disabled explanatory cards rather than executable code.

Future fixture changes should keep each adapted concept source-traceable and should classify unsafe/live-only files as reference-only or rejected rather than executable package behavior. Examples of unsafe/live-only concepts include live audio recorders, provider test buttons, provider runtime wiring, environment/configuration files, production URLs, and credential-bearing readiness checks.

## Public exports

Preserve these package exports when evolving the example:

- `CompanyOsVoiceOpsWorkbenchExample`
- `voiceOpsWorkbenchFixture`
- `VoiceOpsWorkbenchPreview`
- `./fixtures`
- `./ui`
- `./ui/VoiceOpsWorkbenchPreview`

Additive fixture/type growth is preferred so downstream registry and sandbox consumers can keep importing the existing surface.

## Verification commands

Run package-local checks before claiming changes:

```bash
bun run typecheck
bun run test
bun run smoke
bun run lint:check
```


If example metadata or exported registry fields change, also regenerate/check the examples registry from the repository root.

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.


## 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": "experimental",
  "platforms": [
    "server"
  ],
  "runtimes": [
    "node"
  ],
  "entrypoints": [
    ".",
    "./docs/companyos-voiceops-workbench.docblock",
    "./example",
    "./docs",
    "./fixtures",
    "./ui",
    "./ui/VoiceOpsWorkbenchPreview"
  ],
  "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.companyos-voiceops-workbench` — subpath `.`
  - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-voiceops-workbench/src/index.ts); verified source file.

- `@lssm-tech/example.companyos-voiceops-workbench/docs/companyos-voiceops-workbench.docblock` — subpath `./docs/companyos-voiceops-workbench.docblock`
  - `unconditional`: `./src/docs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-voiceops-workbench/src/docs/index.ts); verified source file.

- `@lssm-tech/example.companyos-voiceops-workbench/example` — subpath `./example`
  - `unconditional`: `./src/example.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-voiceops-workbench/src/example.ts); verified source file.

- `@lssm-tech/example.companyos-voiceops-workbench/docs` — subpath `./docs`
  - `unconditional`: `./src/docs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-voiceops-workbench/src/docs/index.ts); verified source file.

- `@lssm-tech/example.companyos-voiceops-workbench/fixtures` — subpath `./fixtures`
  - `unconditional`: `./src/fixtures/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-voiceops-workbench/src/fixtures/index.ts); verified source file.

- `@lssm-tech/example.companyos-voiceops-workbench/ui` — subpath `./ui`
  - `unconditional`: `./src/ui/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-voiceops-workbench/src/ui/index.ts); verified source file.

- `@lssm-tech/example.companyos-voiceops-workbench/ui/VoiceOpsWorkbenchPreview` — subpath `./ui/VoiceOpsWorkbenchPreview`
  - `unconditional`: `./src/ui/VoiceOpsWorkbenchPreview.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-voiceops-workbench/src/ui/VoiceOpsWorkbenchPreview.tsx); verified source file.

## Package publication metadata

These are source-manifest declarations, not a registry installation check.

```json
{
  "types": "./dist/index.d.ts",
  "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"
    },
    "./example": {
      "types": "./dist/example.d.ts",
      "browser": "./dist/browser/example.js",
      "bun": "./dist/example.js",
      "node": "./dist/node/example.js",
      "default": "./dist/example.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"
    },
    "./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/VoiceOpsWorkbenchPreview": {
      "types": "./dist/ui/VoiceOpsWorkbenchPreview.d.ts",
      "browser": "./dist/browser/ui/VoiceOpsWorkbenchPreview.js",
      "bun": "./dist/ui/VoiceOpsWorkbenchPreview.js",
      "node": "./dist/node/ui/VoiceOpsWorkbenchPreview.js",
      "default": "./dist/ui/VoiceOpsWorkbenchPreview.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"
    },
    "./docs/companyos-voiceops-workbench.docblock": {
      "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"
    }
  }
}
```

## Dependencies

Metadata status: complete pinned manifest.

### Runtime dependencies

- [@lssm-tech/lib.contracts-spec](https://lssm.co/docs/packages/lib.contracts-spec/): `workspace:^`
- [@lssm-tech/lib.example-shared-ui](https://lssm.co/docs/packages/lib.example-shared-ui/): `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/example.smoke.test.ts",
  "lint:check": "node ../../scripts/biome.cjs check .",
  "lint": "bun lint:fix",
  "lint:fix": "node ../../scripts/biome.cjs check --write .",
  "preflight": "bun run build && bun run typecheck && bun run test && bun run smoke",
  "build:bundle": "contractspec-bun-build transpile",
  "build:types": "contractspec-bun-build types"
}
```

## Declared documentation links

- [Example Companyos Voiceops Workbench documentation](https://www.npmjs.com/package/%40lssm-tech%2Fexample.companyos-voiceops-workbench) — declared link; destination not verified.

```json
{
  "url": "https://www.npmjs.com/package/%40lssm-tech%2Fexample.companyos-voiceops-workbench",
  "kind": "readme"
}
```

## Existing agent-guide projection

```json
{
  "path": "packages/apps/web-landing/public/llms-packages/example.companyos-voiceops-workbench.txt",
  "route": "/llms/example.companyos-voiceops-workbench",
  "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.companyos-voiceops-workbench.txt",
  "blobSha": "ed4ff628709079a1d228d42194e9fc9e88d4fc0d",
  "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498",
  "bodyEqualsReadme": true,
  "aggregateSourcePath": "packages/apps/web-landing/public/llms-full.txt",
  "aggregateBlobSha": "691b1d33efee24c440598b9106c81432f56aafaf"
}
```