Trasversale · Package · Active seed

@platform/contracts-agent

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

• TypeScript declarations
• Dual package exports

Spec sheet

Package name

@platform/contracts-agent

Repository path

platform-shared-packages/packages/contracts-agent

Exports

CommonJS and ESM entrypoints plus type declarations

Responsibilities

• Define the AgentExecutionStatus union used by platform-agent-service and product consumers.
• Define request, create response, detail response, callback payload and token usage shapes.
• Define toolPolicy and toolTrace shapes for products that need real MCP execution.
• Keep callback contracts stable between Core agent runtime and product BFFs.

Interfaces and contract surface

• Package root export

Consumers

• platform-agent-service
• funnel backend
• cs-chat api

Notes

• The runtime contract includes terminal statuses for policy skips, duplicate skips, model skips, failures and callback failures.

Source references

• platform-shared-packages/packages/contracts-agent/package.json
• platform-shared-packages/packages/contracts-agent/index.d.ts