Trasversale · Workspace · Active

platform-shared-packages

Shared npm workspace that hosts contracts, frontend clients, observability helpers and UI primitives reused across Core and Experience repositories.

• npm workspaces
• CommonJS and ESM exports

Spec sheet

Role

Compile-time shared packages

Workspace

npm workspaces under packages/*

Package scope

@platform/*

Consumers

Core services, BFFs and frontends

Responsibilities

• Publish common DTO and type contracts.
• Provide cookie-aware and auth-specific frontend helpers.
• Provide agent execution contracts shared by platform-agent-service and product backends.
• Provide structured logging and request-context helpers for platform services.
• Seed shared design tokens for frontend alignment.
• Avoid contract duplication across sibling repositories.

Interfaces and contract surface

• npm query .workspace
• Package exports consumed via file: links

Internal modules

Package

@platform/contracts-auth

Shared auth DTO and type contract reused by services and frontends to avoid duplicate auth shapes.

Package

@platform/contracts-ai

Shared contract package for the internal AI generation API exposed by platform-ai-service.

Package

@platform/contracts-payments

Shared payment contract package for provider descriptors, pricing items, checkout sessions, purchase and subscription records, tenant plan status, and normalized payment event delivery.

Package

@codestormlab/cs-contracts-connectors

Shared connector contract package for service-to-service datasource integrations and product-facing adapter layers.

Package

@platform/contracts-agent

Shared type contract for asynchronous agent execution requests, MCP tool policy, tool trace, lifecycle statuses, usage data, callbacks and detail responses.

Package

@platform/auth-client

Thin auth client wrapper built on top of an injected apiFetch implementation and shared auth contracts.

Package

@platform/http-client

Cookie-aware HTTP client package intended for BFF-backed frontend applications in the workspace.

Package

@platform/observability

Shared request-context and structured logging helpers used by platform services to emit consistent JSON logs and request ids.

Package

@platform/ui

Initial shared UI package intended to host design tokens and alignment primitives for cross-project frontend consistency.

Consumers

• platform-ai-service
• platform-agent-service
• platform-mcp-service
• platform-status-service
• funnel backend
• funnel frontend
• sfdc backend
• sfdc frontend
• cs-portal frontend

Notes

• The integration rule for product code is to reuse an existing shared contract instead of redefining DTOs locally.

Source references

• platform-shared-packages/README.md
• platform-shared-packages/package.json
• README.md

Contratto provider MCP

@platform/contracts-mcp definisce il catalogo e il descrittore generici per capability MCP, il payload di invocazione e la risoluzione OAuth del principal. È consumato da platform-mcp-service e dai provider EXPERIENCE come CS Portal; il contratto non contiene tipi o regole specifici del Task Board.