@contractspec/example.agent-console 3.7.6 → 3.7.7

package/.turbo/turbo-build.log

@@ -3,15 +3,15 @@ $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
 [contractspec-bun-build] transpile target=bun root=src entries=66 noBundle=false
-Bundled 66 modules in 143ms
+Bundled 66 modules in 149ms
 
   ./agent.capability.js                    442 bytes  (entry point)
   tool/tool.test-spec.js                   1.38 KB    (entry point)
   shared/overlay-types.js                  8 bytes    (entry point)
   run/run.test-spec.js                     1.37 KB    (entry point)
   seeders/index.js                         0.64 KB    (entry point)
-  ./index.js                               202.99 KB  (entry point)
-  ui/index.js                              78.23 KB   (entry point)
+  ./index.js                               202.97 KB  (entry point)
+  ui/index.js                              78.21 KB   (entry point)
   ui/views/index.js                        22.0 KB    (entry point)
   ui/renderers/index.js                    14.75 KB   (entry point)
   ui/renderers/agent-list.markdown.js      1.49 KB    (entry point)
@@ -20,10 +20,10 @@ Bundled 66 modules in 143ms
   ui/renderers/run-list.markdown.js        1.39 KB    (entry point)
   ui/renderers/tool-registry.markdown.js   1.64 KB    (entry point)
   ui/views/AgentListView.js                5.35 KB    (entry point)
-  ui/modals/index.js                       22.57 KB   (entry point)
+  ui/modals/index.js                       22.55 KB   (entry point)
   ui/overlays/index.js                     1.46 KB    (entry point)
   ui/overlays/demo-overlays.js             1.46 KB    (entry point)
-  ui/AgentDashboard.js                     63.20 KB   (entry point)
+  ui/AgentDashboard.js                     63.18 KB   (entry point)
   ui/modals/AgentActionsModal.js           12.32 KB   (entry point)
   ui/modals/CreateAgentModal.js            10.18 KB   (entry point)
   ui/AgentRunList.js                       9.39 KB    (entry point)
@@ -35,7 +35,7 @@ Bundled 66 modules in 143ms
   ui/hooks/useToolList.js                  2.52 KB    (entry point)
   ui/hooks/useAgentList.js                 1.69 KB    (entry point)
   ui/hooks/useAgentMutations.js            3.18 KB    (entry point)
-  tool/index.js                            28.61 KB   (entry point)
+  tool/index.js                            28.63 KB   (entry point)
   tool/tool.entity.js                      2.65 KB    (entry point)
   tool/tool.event.js                       3.25 KB    (entry point)
   tool/tool.operation.js                   14.62 KB   (entry point)
@@ -73,15 +73,15 @@ Bundled 66 modules in 143ms
   agent/agent.enum.js                      467 bytes  (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=66 noBundle=false
-Bundled 66 modules in 111ms
+Bundled 66 modules in 122ms
 
   ./agent.capability.js                    434 bytes  (entry point)
   tool/tool.test-spec.js                   1.38 KB    (entry point)
   shared/overlay-types.js                  0 KB       (entry point)
   run/run.test-spec.js                     1.36 KB    (entry point)
   seeders/index.js                         0.63 KB    (entry point)
-  ./index.js                               202.92 KB  (entry point)
-  ui/index.js                              78.18 KB   (entry point)
+  ./index.js                               202.91 KB  (entry point)
+  ui/index.js                              78.16 KB   (entry point)
   ui/views/index.js                        22.00 KB   (entry point)
   ui/renderers/index.js                    14.73 KB   (entry point)
   ui/renderers/agent-list.markdown.js      1.48 KB    (entry point)
@@ -90,10 +90,10 @@ Bundled 66 modules in 111ms
   ui/renderers/run-list.markdown.js        1.39 KB    (entry point)
   ui/renderers/tool-registry.markdown.js   1.62 KB    (entry point)
   ui/views/AgentListView.js                5.34 KB    (entry point)
-  ui/modals/index.js                       22.54 KB   (entry point)
+  ui/modals/index.js                       22.53 KB   (entry point)
   ui/overlays/index.js                     1.45 KB    (entry point)
   ui/overlays/demo-overlays.js             1.45 KB    (entry point)
-  ui/AgentDashboard.js                     63.16 KB   (entry point)
+  ui/AgentDashboard.js                     63.15 KB   (entry point)
   ui/modals/AgentActionsModal.js           12.29 KB   (entry point)
   ui/modals/CreateAgentModal.js            10.17 KB   (entry point)
   ui/AgentRunList.js                       9.38 KB    (entry point)
@@ -105,7 +105,7 @@ Bundled 66 modules in 111ms
   ui/hooks/useToolList.js                  2.51 KB    (entry point)
   ui/hooks/useAgentList.js                 1.68 KB    (entry point)
   ui/hooks/useAgentMutations.js            3.18 KB    (entry point)
-  tool/index.js                            28.60 KB   (entry point)
+  tool/index.js                            28.62 KB   (entry point)
   tool/tool.entity.js                      2.64 KB    (entry point)
   tool/tool.event.js                       3.24 KB    (entry point)
   tool/tool.operation.js                   14.62 KB   (entry point)
@@ -143,15 +143,15 @@ Bundled 66 modules in 111ms
   agent/agent.enum.js                      459 bytes  (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=66 noBundle=false
-Bundled 66 modules in 108ms
+Bundled 66 modules in 86ms
 
   ./agent.capability.js                    434 bytes  (entry point)
   tool/tool.test-spec.js                   1.38 KB    (entry point)
   shared/overlay-types.js                  0 KB       (entry point)
   run/run.test-spec.js                     1.36 KB    (entry point)
   seeders/index.js                         0.63 KB    (entry point)
-  ./index.js                               202.92 KB  (entry point)
-  ui/index.js                              78.18 KB   (entry point)
+  ./index.js                               202.91 KB  (entry point)
+  ui/index.js                              78.16 KB   (entry point)
   ui/views/index.js                        22.00 KB   (entry point)
   ui/renderers/index.js                    14.73 KB   (entry point)
   ui/renderers/agent-list.markdown.js      1.48 KB    (entry point)
@@ -160,10 +160,10 @@ Bundled 66 modules in 108ms
   ui/renderers/run-list.markdown.js        1.39 KB    (entry point)
   ui/renderers/tool-registry.markdown.js   1.62 KB    (entry point)
   ui/views/AgentListView.js                5.34 KB    (entry point)
-  ui/modals/index.js                       22.54 KB   (entry point)
+  ui/modals/index.js                       22.53 KB   (entry point)
   ui/overlays/index.js                     1.45 KB    (entry point)
   ui/overlays/demo-overlays.js             1.45 KB    (entry point)
-  ui/AgentDashboard.js                     63.16 KB   (entry point)
+  ui/AgentDashboard.js                     63.15 KB   (entry point)
   ui/modals/AgentActionsModal.js           12.29 KB   (entry point)
   ui/modals/CreateAgentModal.js            10.17 KB   (entry point)
   ui/AgentRunList.js                       9.38 KB    (entry point)
@@ -175,7 +175,7 @@ Bundled 66 modules in 108ms
   ui/hooks/useToolList.js                  2.51 KB    (entry point)
   ui/hooks/useAgentList.js                 1.68 KB    (entry point)
   ui/hooks/useAgentMutations.js            3.18 KB    (entry point)
-  tool/index.js                            28.60 KB   (entry point)
+  tool/index.js                            28.62 KB   (entry point)
   tool/tool.entity.js                      2.64 KB    (entry point)
   tool/tool.event.js                       3.24 KB    (entry point)
   tool/tool.operation.js                   14.62 KB   (entry point)

package/AGENTS.md

@@ -1,40 +1,59 @@
-# AI Agent Guide -- `@contractspec/example.agent-console`
+# AI Agent Guide — `@contractspec/example.agent-console`
 
 Scope: `packages/examples/agent-console/*`
 
-Demonstrates AI agent orchestration with tools, runs, and execution logs using the ContractSpec spec-first pattern.
+Agent Console example - AI agent orchestration with tools, runs, and logs.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.schema`, `lib.contracts-spec`, `lib.example-shared-ui`, `lib.design-system`, `lib.runtime-sandbox`
-
-## What This Demonstrates
-
-- Agent entity with lifecycle (create, configure, execute)
-- Run tracking with status enums and event-driven state transitions
-- Tool registry with typed schemas and operation handlers
-- Presentation layer with React UI components, hooks, modals, and overlays
-- Markdown and React renderers for multi-surface output
-- Seeders and mock data for demo scenarios
-
-## Public Exports
-
-- `.` -- root barrel
-- `./agent` -- agent entity, enum, event, handler, operation, presentation, schema, test-spec
-- `./agent.capability`, `./agent.feature` -- capability and feature definitions
-- `./run` -- run entity, enum, event, handler, operation, presentation, schema, test-spec
-- `./tool` -- tool entity, enum, event, handler, operation, presentation, schema, test-spec
-- `./handlers` -- operation handlers
-- `./presentations` -- presentation definitions
-- `./seeders`, `./shared` -- mock data and shared types
-- `./ui` -- React components, hooks, modals, overlays, renderers, views
-- `./docs` -- DocBlock documentation
-- `./example` -- runnable example entry point
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.runtime-sandbox`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, ...
+
+## Architecture
+
+- `src/agent` is part of the package's public or composition surface.
+- `src/agent.capability.ts` defines a capability surface.
+- `src/agent.feature.ts` defines a feature entrypoint.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/handlers/` contains handlers or demo adapters wired to contract surfaces.
+- `src/index.ts` is the root public barrel and package entrypoint.
+
+## Public Surface
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./agent` resolves through `./src/agent/index.ts`.
+- Export `./agent.capability` resolves through `./src/agent.capability.ts`.
+- Export `./agent.feature` resolves through `./src/agent.feature.ts`.
+- Export `./agent/agent.entity` resolves through `./src/agent/agent.entity.ts`.
+- Export `./agent/agent.enum` resolves through `./src/agent/agent.enum.ts`.
+- Export `./agent/agent.event` resolves through `./src/agent/agent.event.ts`.
+- Export `./agent/agent.handler` resolves through `./src/agent/agent.handler.ts`.
+- Export `./agent/agent.operation` resolves through `./src/agent/agent.operation.ts`.
+- Export `./agent/agent.presentation` resolves through `./src/agent/agent.presentation.ts`.
+- The package publishes 66 total export subpaths; keep docs aligned with `package.json`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.runtime-sandbox`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, ....
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.runtime-sandbox`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, ...
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/README.md

@@ -1,86 +1,78 @@
-# Agent Console Example
+# @contractspec/example.agent-console
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**Agent Console example - AI agent orchestration with tools, runs, and logs.**
 
-A ContractSpec example demonstrating AI agent orchestration with tools, runs, and execution logs.
+## What This Demonstrates
 
-## Overview
+- Agent entity with lifecycle (create, configure, execute).
+- Run tracking with status enums and event-driven state transitions.
+- Tool registry with typed schemas and operation handlers.
+- Presentation layer with React UI components, hooks, modals, and overlays.
+- Markdown and React renderers for multi-surface output.
+- Seeders and mock data for demo scenarios.
 
-This example showcases how to build an AI agent management system using ContractSpec's spec-first approach. It includes:
+## Running Locally
 
-- **Tools**: Reusable AI functions/capabilities that agents can invoke
-- **Agents**: AI agent configurations with assigned tools and parameters
-- **Runs**: Execution instances of agents processing user requests
-- **Logs**: Detailed execution logs for debugging and auditing
-
-## Features
-
-- Multi-tenant agent management
-- Tool registry with typed parameters
-- Agent composition with multiple tools
-- Run execution with step-by-step logging
-- Token usage tracking for billing
-- Event-driven architecture for real-time updates
+From `packages/examples/agent-console`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
 ## Usage
 
-```typescript
-import { 
-  ToolEntity, 
-  AgentEntity, 
-  RunEntity,
-  CreateToolCommand,
-  ExecuteAgentCommand 
-} from '@contractspec/example.agent-console';
-
-// Define a tool
-const searchTool = {
-  name: 'web-search',
-  description: 'Search the web for information',
-  parameters: {
-    type: 'object',
-    properties: {
-      query: { type: 'string' }
-    }
-  }
-};
-
-// Create an agent with tools
-const agent = {
-  name: 'Research Assistant',
-  model: 'gpt-4',
-  systemPrompt: 'You are a helpful research assistant.',
-  toolIds: ['tool-web-search', 'tool-summarize']
-};
-
-// Execute the agent
-const run = await executeAgent({
-  agentId: agent.id,
-  input: { message: 'What are the latest AI developments?' }
-});
-```
-
-## Entities
-
-- `Tool` - AI tool/function definitions
-- `Agent` - Agent configurations
-- `Run` - Agent execution instances
-- `RunStep` - Individual steps within a run
-- `RunLog` - Detailed execution logs
-
-## Events
-
-- `AgentCreated` - When a new agent is configured
-- `RunStarted` - When an agent run begins
-- `RunCompleted` - When an agent run finishes
-- `RunFailed` - When an agent run encounters an error
-- `ToolInvoked` - When a tool is called during execution
-
-## Dependencies
-
-This example builds on the following cross-cutting modules:
-
-- `@contractspec/lib.identity-rbac` - User and organization management
-- `@contractspec/lib.jobs` - Async job processing for long-running agents
-- `@contractspec/module.audit-trail` - Audit logging for compliance
+Use `@contractspec/example.agent-console` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
+
+## Architecture
+
+- `src/agent` is part of the package's public or composition surface.
+- `src/agent.capability.ts` defines a capability surface.
+- `src/agent.feature.ts` defines a feature entrypoint.
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/handlers/` contains handlers or demo adapters wired to contract surfaces.
+- `src/index.ts` is the root public barrel and package entrypoint.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./agent` resolves through `./src/agent/index.ts`.
+- Export `./agent.capability` resolves through `./src/agent.capability.ts`.
+- Export `./agent.feature` resolves through `./src/agent.feature.ts`.
+- Export `./agent/agent.entity` resolves through `./src/agent/agent.entity.ts`.
+- Export `./agent/agent.enum` resolves through `./src/agent/agent.enum.ts`.
+- Export `./agent/agent.event` resolves through `./src/agent/agent.event.ts`.
+- Export `./agent/agent.handler` resolves through `./src/agent/agent.handler.ts`.
+- Export `./agent/agent.operation` resolves through `./src/agent/agent.operation.ts`.
+- Export `./agent/agent.presentation` resolves through `./src/agent/agent.presentation.ts`.
+- The package publishes 66 total export subpaths; keep docs aligned with `package.json`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Package exports.
+- Add latest models and align defaults.
+- Resolve lint and build errors in workspace bundle and integrations lib.
+- Missing contract layers.
+
+## Notes
+
+- Works alongside `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.runtime-sandbox`, `@contractspec/lib.schema`, ...

package/dist/agent/agent.event.js

@@ -1,7 +1,7 @@
 // @bun
 // src/agent/agent.event.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OWNERS = ["@agent-console-team"];
 var AgentCreatedPayload = defineSchemaModel({
   name: "AgentCreatedPayload",

package/dist/agent/agent.operation.js

@@ -22,7 +22,7 @@ var ToolChoiceEnum = defineEnum("ToolChoice", [
 
 // src/agent/agent.event.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OWNERS = ["@agent-console-team"];
 var AgentCreatedPayload = defineSchemaModel({
   name: "AgentCreatedPayload",

package/dist/agent/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * Agent domain - AI agent configuration and management.
  */
+export { AgentEntity, AgentStatusEntityEnum, AgentToolEntity, ModelProviderEntityEnum, } from './agent.entity';
 export { AgentStatusEnum, ModelProviderEnum, ToolChoiceEnum, } from './agent.enum';
+export { AgentCreatedEvent, AgentToolAssignedEvent, AgentToolRemovedEvent, AgentUpdatedEvent, } from './agent.event';
+export { type AgentSummary, type AgentToolRef, type AgentWithTools, type GetAgentInput, type ListAgentsInput, type ListAgentsOutput, mockCreateAgentHandler, mockGetAgentHandler, mockListAgentsHandler, mockUpdateAgentHandler, } from './agent.handler';
+export { AssignToolToAgentCommand, CreateAgentCommand, GetAgentQuery, ListAgentsQuery, RemoveToolFromAgentCommand, UpdateAgentCommand, } from './agent.operation';
+export { AgentConsoleDashboardPresentation, AgentDetailPresentation, AgentListPresentation, } from './agent.presentation';
 export { AgentModel, AgentSummaryModel, AgentToolRefModel, AgentWithToolsModel, CreateAgentInputModel, UpdateAgentInputModel, } from './agent.schema';
-export { CreateAgentCommand, UpdateAgentCommand, GetAgentQuery, ListAgentsQuery, AssignToolToAgentCommand, RemoveToolFromAgentCommand, } from './agent.operation';
-export { AgentCreatedEvent, AgentUpdatedEvent, AgentToolAssignedEvent, AgentToolRemovedEvent, } from './agent.event';
-export { AgentStatusEntityEnum, ModelProviderEntityEnum, AgentEntity, AgentToolEntity, } from './agent.entity';
-export { AgentListPresentation, AgentDetailPresentation, AgentConsoleDashboardPresentation, } from './agent.presentation';
-export { mockListAgentsHandler, mockGetAgentHandler, mockCreateAgentHandler, mockUpdateAgentHandler, type ListAgentsInput, type AgentSummary, type ListAgentsOutput, type GetAgentInput, type AgentToolRef, type AgentWithTools, } from './agent.handler';

package/dist/agent/index.js

@@ -144,7 +144,7 @@ var ToolChoiceEnum = defineEnum("ToolChoice", [
 
 // src/agent/agent.event.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OWNERS = ["@agent-console-team"];
 var AgentCreatedPayload = defineSchemaModel({
   name: "AgentCreatedPayload",

package/dist/browser/agent/agent.event.js

@@ -1,6 +1,6 @@
 // src/agent/agent.event.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OWNERS = ["@agent-console-team"];
 var AgentCreatedPayload = defineSchemaModel({
   name: "AgentCreatedPayload",

package/dist/browser/agent/agent.operation.js

@@ -21,7 +21,7 @@ var ToolChoiceEnum = defineEnum("ToolChoice", [
 
 // src/agent/agent.event.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OWNERS = ["@agent-console-team"];
 var AgentCreatedPayload = defineSchemaModel({
   name: "AgentCreatedPayload",

package/dist/browser/agent/index.js

@@ -143,7 +143,7 @@ var ToolChoiceEnum = defineEnum("ToolChoice", [
 
 // src/agent/agent.event.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var OWNERS = ["@agent-console-team"];
 var AgentCreatedPayload = defineSchemaModel({
   name: "AgentCreatedPayload",