module.ai-chat
AI chat interface module
@lssm-tech/module.ai-chatbun add @lssm-tech/module.ai-chatManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Website: https://contractspec.io
AI chat module with context, core runtime, presentation components, hooks, providers, and agent-aware workflows.
Workspace file operations remain injectable through FileSystem. The compatible createNodeFileOperations factory loads server filesystem capabilities only when an operation runs. Browser imports do not resolve Node builtins; invoking the server adapter without a compatible host returns an explicit capability error. Writes still require the existing allowWrites opt-in. This adapter is not a filesystem sandbox or a replacement for host authorization. The legacy Node fallback uses native runtime import directives for Webpack and Turbopack so browser builds do not attempt to resolve optional server modules.
What It Provides
- Provides the packaged chat feature layer used by examples and higher-level applications.
- Supports MCP tools, provider integration, presentation rendering, forms, and agent-mode workflows.
- Acts as the main composition layer between the low-level agent runtime and user-facing chat UIs.
src/adapters/contains runtime, provider, or environment-specific adapters.src/docs/contains docblocks and documentation-facing exports.src/presentation/contains presentation-layer components and renderers.
Installation
npm install @lssm-tech/module.ai-chat
or
bun add @lssm-tech/module.ai-chat
Usage
Import the root entrypoint from @lssm-tech/module.ai-chat, or choose a documented subpath when you only need one part of the package surface.
Architecture
Headless chat service, storage, workspace context and planner/workflow helpers are canonical in @lssm-tech/lib.ai-agent/chat. Existing core and context exports forward without wrapping constructors or factories. Chat presentation and the aiChat.* reasoning-label keys remain owned by this module.
src/context/contains shared chat providers and contextual runtime state.src/core/contains chat orchestration, workflows, and non-UI runtime logic.src/presentation/exports UI components and React hooks for embedding the chat experience.src/providers/exposes provider bindings and provider-facing integration helpers.- Top-level feature, capability, operation, schema, and event files define the module contract surface.
src/core/economic-evidence.tsmaps chat adapter usage into neutral agent-run economic evidence refs.src/ai-chat.capability.tsdefines a capability surface.
Public Entry Points
- Exports the root module plus context, core, core/workflow, presentation, presentation/components, presentation/hooks, and providers subpaths.
- Export
.resolves through./src/index.ts. - Export
./contextresolves through./src/context/index.ts. - Export
./coreresolves through./src/core/index.ts. - Export
./core/workflowresolves through./src/core/workflow.ts. - Export
./presentationresolves through./src/presentation/index.ts. - Export
./presentation/componentsresolves through./src/presentation/components/index.ts. - Export
./presentation/hooksresolves through./src/presentation/hooks/index.ts. - Export
./providersresolves through./src/providers/index.ts.
Economic Evidence
AI chat now emits safe economic evidence automatically when token usage exists. ChatService stores createAiChatEconomicEvidenceMetadata() output on assistant message metadata, createChatRoute() emits AI SDK messageMetadata on finish, and createCompletionRoute() calls onEconomicEvidence on finish. Missing usage returns undefined so callers do not fabricate spend. Route consumers should persist economicEvidenceRefs/usage metadata and keep prompts, messages, tool args, and provider receipts in their owning secure stores.
Local Commands
bun run dev— contractspec-bun-build devbun run build— contractspec-bun-build buildbun run test— bun testbun run lint— bun lint:fixbun run lint:check— biome check .bun run lint:fix— biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .bun run typecheck— tsgo --noEmitbun run publish:pkg— bun publish --tolerate-republish --ignore-scripts --verbosebun run publish:pkg:canary— bun publish:pkg --tag canarybun run clean— rimraf dist .turbobun run build:bundle— contractspec-bun-build transpilebun run build:types— contractspec-bun-build typesbun run prebuild— contractspec-bun-build prebuild
Recent Updates
- Replace eslint+prettier by biomejs to optimize speed.
- Agentic workflows — subagents, memory tools, and next steps.
- Vnext ai-native.
- Backend operations + frontend rendering support.
- Use browser-safe MCP client stub in client bundles.
- Add changesets and apply pending fixes.
- Add chat usage-to-economic-evidence mapping for AI-native billing, observability, and replay lanes.
Notes
- Depends on
lib.ai-agent,lib.ai-providers,lib.contracts-spec,lib.schema,lib.metering,lib.cost-tracking,lib.surface-runtime. - React peer dependency (>=19.2.4); changes here affect all chat surfaces.
- Metering and cost-tracking are wired in -- never bypass them.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
15 declarations
@lssm-tech/lib.ai-agentworkspace:^
Read the package manual ↗@lssm-tech/lib.orchestration-specworkspace:^
Read the package manual ↗@lssm-tech/lib.surface-runtimeworkspace:^
Read the package manual ↗@lssm-tech/lib.ai-providersworkspace:^
Read the package manual ↗@lssm-tech/lib.contracts-spec-coreworkspace:^
Read the package manual ↗@lssm-tech/integration.workflow-devkitworkspace:^
Read the package manual ↗
Declared capabilities
AI chat interface module
Scripts
publish:pkgbun publish --tolerate-republish --ignore-scripts --verbosepublish:pkg:canarybun publish:pkg --tag canarybuildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolintbun lint:fixlint:fixnode ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .lint:checknode ../../../../scripts/biome.cjs check .testbun testprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit