@contractspec/example.agent-console 1.44.0

package/dist/agent.feature.js

@@ -0,0 +1,303 @@
+//#region src/agent.feature.ts
+/**
+* Agent Console feature module that bundles all agent, tool, and run
+* operations, events, and presentations into an installable feature.
+*/
+const AgentConsoleFeature = {
+	meta: {
+		key: "agent-console",
+		version: 1,
+		title: "AI Agent Console",
+		description: "AI agent orchestration with tools, runs, and logs management",
+		domain: "ai-ops",
+		owners: ["@agent-console-team"],
+		tags: [
+			"ai",
+			"agents",
+			"orchestration"
+		],
+		stability: "stable"
+	},
+	operations: [
+		{
+			key: "agent-console.agent.create",
+			version: 1
+		},
+		{
+			key: "agent-console.agent.update",
+			version: 1
+		},
+		{
+			key: "agent-console.agent.get",
+			version: 1
+		},
+		{
+			key: "agent-console.agent.list",
+			version: 1
+		},
+		{
+			key: "agent-console.agent.assignTool",
+			version: 1
+		},
+		{
+			key: "agent-console.agent.removeTool",
+			version: 1
+		},
+		{
+			key: "agent.tool.create",
+			version: 1
+		},
+		{
+			key: "agent.tool.update",
+			version: 1
+		},
+		{
+			key: "agent.tool.get",
+			version: 1
+		},
+		{
+			key: "agent.tool.list",
+			version: 1
+		},
+		{
+			key: "agent.tool.test",
+			version: 1
+		},
+		{
+			key: "agent.run.execute",
+			version: 1
+		},
+		{
+			key: "agent.run.cancel",
+			version: 1
+		},
+		{
+			key: "agent.run.get",
+			version: 1
+		},
+		{
+			key: "agent.run.list",
+			version: 1
+		},
+		{
+			key: "agent.run.getSteps",
+			version: 1
+		},
+		{
+			key: "agent.run.getLogs",
+			version: 1
+		},
+		{
+			key: "agent.run.getMetrics",
+			version: 1
+		}
+	],
+	events: [
+		{
+			key: "agent-console.agent.created",
+			version: 1
+		},
+		{
+			key: "agent-console.agent.updated",
+			version: 1
+		},
+		{
+			key: "agent-console.agent.toolAssigned",
+			version: 1
+		},
+		{
+			key: "agent-console.agent.toolRemoved",
+			version: 1
+		},
+		{
+			key: "agent.tool.created",
+			version: 1
+		},
+		{
+			key: "agent.tool.updated",
+			version: 1
+		},
+		{
+			key: "agent.tool.statusChanged",
+			version: 1
+		},
+		{
+			key: "agent.run.started",
+			version: 1
+		},
+		{
+			key: "agent.run.completed",
+			version: 1
+		},
+		{
+			key: "agent.run.failed",
+			version: 1
+		},
+		{
+			key: "agent.run.cancelled",
+			version: 1
+		},
+		{
+			key: "agent.run.toolInvoked",
+			version: 1
+		},
+		{
+			key: "agent.run.toolCompleted",
+			version: 1
+		},
+		{
+			key: "agent.run.messageGenerated",
+			version: 1
+		}
+	],
+	presentations: [
+		{
+			key: "agent-console.dashboard",
+			version: 1
+		},
+		{
+			key: "agent-console.agent.list",
+			version: 1
+		},
+		{
+			key: "agent-console.agent.detail",
+			version: 1
+		},
+		{
+			key: "agent-console.run.list",
+			version: 1
+		},
+		{
+			key: "agent-console.run.detail",
+			version: 1
+		},
+		{
+			key: "agent-console.tool.list",
+			version: 1
+		},
+		{
+			key: "agent-console.tool.detail",
+			version: 1
+		}
+	],
+	opToPresentation: [
+		{
+			op: {
+				key: "agent-console.agent.list",
+				version: 1
+			},
+			pres: {
+				key: "agent-console.agent.list",
+				version: 1
+			}
+		},
+		{
+			op: {
+				key: "agent-console.agent.get",
+				version: 1
+			},
+			pres: {
+				key: "agent-console.agent.detail",
+				version: 1
+			}
+		},
+		{
+			op: {
+				key: "agent.run.list",
+				version: 1
+			},
+			pres: {
+				key: "agent-console.run.list",
+				version: 1
+			}
+		},
+		{
+			op: {
+				key: "agent.run.get",
+				version: 1
+			},
+			pres: {
+				key: "agent-console.run.detail",
+				version: 1
+			}
+		},
+		{
+			op: {
+				key: "agent.tool.list",
+				version: 1
+			},
+			pres: {
+				key: "agent-console.tool.list",
+				version: 1
+			}
+		},
+		{
+			op: {
+				key: "agent.tool.get",
+				version: 1
+			},
+			pres: {
+				key: "agent-console.tool.detail",
+				version: 1
+			}
+		}
+	],
+	presentationsTargets: [
+		{
+			key: "agent-console.dashboard",
+			version: 1,
+			targets: ["react", "markdown"]
+		},
+		{
+			key: "agent-console.agent.list",
+			version: 1,
+			targets: [
+				"react",
+				"markdown",
+				"application/json"
+			]
+		},
+		{
+			key: "agent-console.run.list",
+			version: 1,
+			targets: [
+				"react",
+				"markdown",
+				"application/json"
+			]
+		},
+		{
+			key: "agent-console.tool.list",
+			version: 1,
+			targets: [
+				"react",
+				"markdown",
+				"application/json"
+			]
+		}
+	],
+	capabilities: {
+		requires: [
+			{
+				key: "identity",
+				version: 1
+			},
+			{
+				key: "audit-trail",
+				version: 1
+			},
+			{
+				key: "jobs",
+				version: 1
+			}
+		],
+		provides: [{
+			key: "agent",
+			version: 1
+		}]
+	}
+};
+
+//#endregion
+export { AgentConsoleFeature };
+//# sourceMappingURL=agent.feature.js.map

package/dist/agent.feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.feature.js","names":["AgentConsoleFeature: FeatureModuleSpec"],"sources":["../src/agent.feature.ts"],"sourcesContent":["/**\n * Agent Console Feature Module Specification\n *\n * Defines the feature module for agent orchestration capabilities.\n */\nimport type { FeatureModuleSpec } from '@contractspec/lib.contracts';\n\n/**\n * Agent Console feature module that bundles all agent, tool, and run\n * operations, events, and presentations into an installable feature.\n */\nexport const AgentConsoleFeature: FeatureModuleSpec = {\n  meta: {\n    key: 'agent-console',\n    version: 1,\n    title: 'AI Agent Console',\n    description: 'AI agent orchestration with tools, runs, and logs management',\n    domain: 'ai-ops',\n    owners: ['@agent-console-team'],\n    tags: ['ai', 'agents', 'orchestration'],\n    stability: 'stable',\n  },\n\n  // All contract operations included in this feature\n  operations: [\n    // Agent operations\n    { key: 'agent-console.agent.create', version: 1 },\n    { key: 'agent-console.agent.update', version: 1 },\n    { key: 'agent-console.agent.get', version: 1 },\n    { key: 'agent-console.agent.list', version: 1 },\n    { key: 'agent-console.agent.assignTool', version: 1 },\n    { key: 'agent-console.agent.removeTool', version: 1 },\n\n    // Tool operations\n    { key: 'agent.tool.create', version: 1 },\n    { key: 'agent.tool.update', version: 1 },\n    { key: 'agent.tool.get', version: 1 },\n    { key: 'agent.tool.list', version: 1 },\n    { key: 'agent.tool.test', version: 1 },\n\n    // Run operations\n    { key: 'agent.run.execute', version: 1 },\n    { key: 'agent.run.cancel', version: 1 },\n    { key: 'agent.run.get', version: 1 },\n    { key: 'agent.run.list', version: 1 },\n    { key: 'agent.run.getSteps', version: 1 },\n    { key: 'agent.run.getLogs', version: 1 },\n    { key: 'agent.run.getMetrics', version: 1 },\n  ],\n\n  // Events emitted by this feature\n  events: [\n    // Agent events\n    { key: 'agent-console.agent.created', version: 1 },\n    { key: 'agent-console.agent.updated', version: 1 },\n    { key: 'agent-console.agent.toolAssigned', version: 1 },\n    { key: 'agent-console.agent.toolRemoved', version: 1 },\n\n    // Tool events\n    { key: 'agent.tool.created', version: 1 },\n    { key: 'agent.tool.updated', version: 1 },\n    { key: 'agent.tool.statusChanged', version: 1 },\n\n    // Run events\n    { key: 'agent.run.started', version: 1 },\n    { key: 'agent.run.completed', version: 1 },\n    { key: 'agent.run.failed', version: 1 },\n    { key: 'agent.run.cancelled', version: 1 },\n    { key: 'agent.run.toolInvoked', version: 1 },\n    { key: 'agent.run.toolCompleted', version: 1 },\n    { key: 'agent.run.messageGenerated', version: 1 },\n  ],\n\n  // Presentations associated with this feature\n  presentations: [\n    { key: 'agent-console.dashboard', version: 1 },\n    { key: 'agent-console.agent.list', version: 1 },\n    { key: 'agent-console.agent.detail', version: 1 },\n    { key: 'agent-console.run.list', version: 1 },\n    { key: 'agent-console.run.detail', version: 1 },\n    { key: 'agent-console.tool.list', version: 1 },\n    { key: 'agent-console.tool.detail', version: 1 },\n  ],\n\n  // Link operations to their primary presentations\n  opToPresentation: [\n    {\n      op: { key: 'agent-console.agent.list', version: 1 },\n      pres: { key: 'agent-console.agent.list', version: 1 },\n    },\n    {\n      op: { key: 'agent-console.agent.get', version: 1 },\n      pres: { key: 'agent-console.agent.detail', version: 1 },\n    },\n    {\n      op: { key: 'agent.run.list', version: 1 },\n      pres: { key: 'agent-console.run.list', version: 1 },\n    },\n    {\n      op: { key: 'agent.run.get', version: 1 },\n      pres: { key: 'agent-console.run.detail', version: 1 },\n    },\n    {\n      op: { key: 'agent.tool.list', version: 1 },\n      pres: { key: 'agent-console.tool.list', version: 1 },\n    },\n    {\n      op: { key: 'agent.tool.get', version: 1 },\n      pres: { key: 'agent-console.tool.detail', version: 1 },\n    },\n  ],\n\n  // Target requirements for multi-surface rendering\n  presentationsTargets: [\n    {\n      key: 'agent-console.dashboard',\n      version: 1,\n      targets: ['react', 'markdown'],\n    },\n    {\n      key: 'agent-console.agent.list',\n      version: 1,\n      targets: ['react', 'markdown', 'application/json'],\n    },\n    {\n      key: 'agent-console.run.list',\n      version: 1,\n      targets: ['react', 'markdown', 'application/json'],\n    },\n    {\n      key: 'agent-console.tool.list',\n      version: 1,\n      targets: ['react', 'markdown', 'application/json'],\n    },\n  ],\n\n  // Capability requirements\n  capabilities: {\n    requires: [\n      { key: 'identity', version: 1 },\n      { key: 'audit-trail', version: 1 },\n      { key: 'jobs', version: 1 },\n    ],\n    provides: [{ key: 'agent', version: 1 }],\n  },\n};\n"],"mappings":"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"}

package/dist/docs/agent-console.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/agent-console.docblock.js

@@ -0,0 +1,113 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/agent-console.docblock.ts
+registerDocBlocks([
+	{
+		id: "docs.examples.agent-console.goal",
+		title: "Agent Console — Goal",
+		summary: "AI agent ops console: tools, agents, runs, logs, and metrics.",
+		kind: "goal",
+		visibility: "public",
+		route: "/docs/examples/agent-console/goal",
+		tags: [
+			"ai",
+			"agents",
+			"goal"
+		],
+		body: `## Why it matters
+- Provides a regenerable agent operations surface with tool registry and run history.
+- Prevents drift between tool schemas, agent configs, and execution logs.
+
+## Business/Product goal
+- Safely manage tools/agents/runs with auditability and observability.
+- Enable staged rollout of tools and metrics via feature flags.
+
+## Success criteria
+- Tool/agent/run specs regenerate UI/API/events cleanly.
+- Logs/metrics stay aligned and PII is scoped.`
+	},
+	{
+		id: "docs.examples.agent-console.usage",
+		title: "Agent Console — Usage",
+		summary: "How to operate, extend, and regenerate the agent console safely.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/examples/agent-console/usage",
+		tags: [
+			"ai",
+			"agents",
+			"usage"
+		],
+		body: `## Setup
+1) Seed (if available) or create tools and agents; define run configs.
+2) Configure Notifications for run completion/failure; Audit for changes.
+
+## Extend & regenerate
+1) Adjust tool schemas (inputs/outputs), agent configs, run metrics in spec.
+2) Regenerate to sync UI/API/events/logs; mark PII paths for run payloads.
+3) Use Feature Flags to gate risky tools or execution policies.
+
+## Guardrails
+- Emit events for run lifecycle; store logs with redaction where needed.
+- Enforce tool input validation; avoid unsafe arbitrary code exec in handlers.
+- Keep tenant/user scoping explicit for ops data.`
+	},
+	{
+		id: "docs.examples.agent-console.reference",
+		title: "Agent Console — Reference",
+		summary: "Entities, contracts, events, and presentations for the agent console.",
+		kind: "reference",
+		visibility: "public",
+		route: "/docs/examples/agent-console",
+		tags: [
+			"ai",
+			"agents",
+			"reference"
+		],
+		body: `## Entities
+- Tool, Agent, AgentTool, Run, RunStep, RunLog, RunMetric.
+
+## Contracts
+- tool/create, agent/create, agent/execute, run/get, run/logs, run/metrics.
+
+## Events
+- tool.created, agent.created, run.started/completed/failed, tool.invoked.
+
+## Presentations
+- Tool registry, agent list/detail, run list/detail, metrics dashboards.
+
+## Notes
+- Keep tool schemas explicit; enforce validation in spec.
+- Use Audit Trail for agent/run changes; Notifications for run outcomes.`
+	},
+	{
+		id: "docs.examples.agent-console.constraints",
+		title: "Agent Console — Constraints & Safety",
+		summary: "Internal guardrails for tool/agent/run safety, PII, and regeneration.",
+		kind: "reference",
+		visibility: "internal",
+		route: "/docs/examples/agent-console/constraints",
+		tags: [
+			"ai",
+			"agents",
+			"constraints",
+			"internal"
+		],
+		body: `## Constraints
+- Tool schemas (inputs/outputs) must be explicit in spec; no arbitrary untyped payloads.
+- Events to emit: tool.created, agent.created, run.started/completed/failed, tool.invoked.
+- Regeneration must not loosen execution policies or logging without explicit spec diff.
+
+## Safety & PII
+- Mark PII in run payloads/logs; redact in markdown/JSON targets.
+- Avoid exposing raw tool outputs to MCP/web without policy checks.
+
+## Verification
+- Add fixtures for tool schema changes and run lifecycle.
+- Ensure Audit/Notifications remain wired for runs; metrics collection unchanged.
+- Use Feature Flags to gate risky tools; default safe/off.`
+	}
+]);
+
+//#endregion
+//# sourceMappingURL=agent-console.docblock.js.map

package/dist/docs/agent-console.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-console.docblock.js","names":[],"sources":["../../src/docs/agent-console.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst agentConsoleDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.agent-console.goal',\n    title: 'Agent Console — Goal',\n    summary: 'AI agent ops console: tools, agents, runs, logs, and metrics.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/agent-console/goal',\n    tags: ['ai', 'agents', 'goal'],\n    body: `## Why it matters\n- Provides a regenerable agent operations surface with tool registry and run history.\n- Prevents drift between tool schemas, agent configs, and execution logs.\n\n## Business/Product goal\n- Safely manage tools/agents/runs with auditability and observability.\n- Enable staged rollout of tools and metrics via feature flags.\n\n## Success criteria\n- Tool/agent/run specs regenerate UI/API/events cleanly.\n- Logs/metrics stay aligned and PII is scoped.`,\n  },\n  {\n    id: 'docs.examples.agent-console.usage',\n    title: 'Agent Console — Usage',\n    summary: 'How to operate, extend, and regenerate the agent console safely.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/agent-console/usage',\n    tags: ['ai', 'agents', 'usage'],\n    body: `## Setup\n1) Seed (if available) or create tools and agents; define run configs.\n2) Configure Notifications for run completion/failure; Audit for changes.\n\n## Extend & regenerate\n1) Adjust tool schemas (inputs/outputs), agent configs, run metrics in spec.\n2) Regenerate to sync UI/API/events/logs; mark PII paths for run payloads.\n3) Use Feature Flags to gate risky tools or execution policies.\n\n## Guardrails\n- Emit events for run lifecycle; store logs with redaction where needed.\n- Enforce tool input validation; avoid unsafe arbitrary code exec in handlers.\n- Keep tenant/user scoping explicit for ops data.`,\n  },\n  {\n    id: 'docs.examples.agent-console.reference',\n    title: 'Agent Console — Reference',\n    summary:\n      'Entities, contracts, events, and presentations for the agent console.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/agent-console',\n    tags: ['ai', 'agents', 'reference'],\n    body: `## Entities\n- Tool, Agent, AgentTool, Run, RunStep, RunLog, RunMetric.\n\n## Contracts\n- tool/create, agent/create, agent/execute, run/get, run/logs, run/metrics.\n\n## Events\n- tool.created, agent.created, run.started/completed/failed, tool.invoked.\n\n## Presentations\n- Tool registry, agent list/detail, run list/detail, metrics dashboards.\n\n## Notes\n- Keep tool schemas explicit; enforce validation in spec.\n- Use Audit Trail for agent/run changes; Notifications for run outcomes.`,\n  },\n  {\n    id: 'docs.examples.agent-console.constraints',\n    title: 'Agent Console — Constraints & Safety',\n    summary:\n      'Internal guardrails for tool/agent/run safety, PII, and regeneration.',\n    kind: 'reference',\n    visibility: 'internal',\n    route: '/docs/examples/agent-console/constraints',\n    tags: ['ai', 'agents', 'constraints', 'internal'],\n    body: `## Constraints\n- Tool schemas (inputs/outputs) must be explicit in spec; no arbitrary untyped payloads.\n- Events to emit: tool.created, agent.created, run.started/completed/failed, tool.invoked.\n- Regeneration must not loosen execution policies or logging without explicit spec diff.\n\n## Safety & PII\n- Mark PII in run payloads/logs; redact in markdown/JSON targets.\n- Avoid exposing raw tool outputs to MCP/web without policy checks.\n\n## Verification\n- Add fixtures for tool schema changes and run lifecycle.\n- Ensure Audit/Notifications remain wired for runs; metrics collection unchanged.\n- Use Feature Flags to gate risky tools; default safe/off.`,\n  },\n];\n\nregisterDocBlocks(agentConsoleDocBlocks);\n"],"mappings":";;;AAgGA,kBA7F0C;CACxC;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAM;GAAU;GAAO;EAC9B,MAAM;;;;;;;;;;;EAWP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAM;GAAU;GAAQ;EAC/B,MAAM;;;;;;;;;;;;;EAaP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAM;GAAU;GAAY;EACnC,MAAM;;;;;;;;;;;;;;;EAeP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SACE;EACF,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GAAC;GAAM;GAAU;GAAe;GAAW;EACjD,MAAM;;;;;;;;;;;;;EAaP;CACF,CAEuC"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./agent-console.docblock.js";

package/dist/example.d.ts

@@ -0,0 +1,40 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "agent-console";
+  readonly title: "Agent Console";
+  readonly summary: "AI agent ops console: tools, agents, runs, logs, and metrics (spec-first, regenerable).";
+  readonly tags: readonly ["ai", "agents", "tools", "orchestration"];
+  readonly kind: "template";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.examples.agent-console.reference";
+    readonly goalDocId: "docs.examples.agent-console.goal";
+    readonly usageDocId: "docs.examples.agent-console.usage";
+    readonly constraintsDocId: "docs.examples.agent-console.constraints";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@contractspec/example.agent-console";
+    readonly feature: "./feature";
+    readonly contracts: "./contracts";
+    readonly presentations: "./presentations";
+    readonly handlers: "./handlers";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["playground", "specs", "builder", "markdown", "evolution"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EA+BI,EAAA,eAAA"}

package/dist/example.js

@@ -0,0 +1,51 @@
+//#region src/example.ts
+const example = {
+	id: "agent-console",
+	title: "Agent Console",
+	summary: "AI agent ops console: tools, agents, runs, logs, and metrics (spec-first, regenerable).",
+	tags: [
+		"ai",
+		"agents",
+		"tools",
+		"orchestration"
+	],
+	kind: "template",
+	visibility: "public",
+	docs: {
+		rootDocId: "docs.examples.agent-console.reference",
+		goalDocId: "docs.examples.agent-console.goal",
+		usageDocId: "docs.examples.agent-console.usage",
+		constraintsDocId: "docs.examples.agent-console.constraints"
+	},
+	entrypoints: {
+		packageName: "@contractspec/example.agent-console",
+		feature: "./feature",
+		contracts: "./contracts",
+		presentations: "./presentations",
+		handlers: "./handlers",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: [
+				"playground",
+				"specs",
+				"builder",
+				"markdown",
+				"evolution"
+			]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'agent-console',\n  title: 'Agent Console',\n  summary:\n    'AI agent ops console: tools, agents, runs, logs, and metrics (spec-first, regenerable).',\n  tags: ['ai', 'agents', 'tools', 'orchestration'],\n  kind: 'template',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.examples.agent-console.reference',\n    goalDocId: 'docs.examples.agent-console.goal',\n    usageDocId: 'docs.examples.agent-console.usage',\n    constraintsDocId: 'docs.examples.agent-console.constraints',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.agent-console',\n    feature: './feature',\n    contracts: './contracts',\n    presentations: './presentations',\n    handlers: './handlers',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: {\n      enabled: true,\n      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],\n    },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAM;EAAU;EAAS;EAAgB;CAChD,MAAM;CACN,YAAY;CACZ,MAAM;EACJ,WAAW;EACX,WAAW;EACX,YAAY;EACZ,kBAAkB;EACnB;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,WAAW;EACX,eAAe;EACf,UAAU;EACV,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GACP,SAAS;GACT,OAAO;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY;GACnE;EACD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,4 @@
+import { AgentSummary, mockCreateAgentHandler, mockGetAgentHandler, mockListAgentsHandler } from "../agent/agent.handler.js";
+import { RunSummary, mockExecuteAgentHandler, mockGetRunHandler, mockListRunsHandler } from "../run/run.handler.js";
+import { ToolSummary, mockCreateToolHandler, mockGetToolHandler, mockListToolsHandler } from "../tool/tool.handler.js";
+export { type AgentSummary, type RunSummary, type ToolSummary, mockCreateAgentHandler, mockCreateToolHandler, mockExecuteAgentHandler, mockGetAgentHandler, mockGetRunHandler, mockGetToolHandler, mockListAgentsHandler, mockListRunsHandler, mockListToolsHandler };

package/dist/handlers/index.js

@@ -0,0 +1,5 @@
+import { mockCreateAgentHandler, mockGetAgentHandler, mockListAgentsHandler } from "../agent/agent.handler.js";
+import { mockExecuteAgentHandler, mockGetRunHandler, mockListRunsHandler } from "../run/run.handler.js";
+import { mockCreateToolHandler, mockGetToolHandler, mockListToolsHandler } from "../tool/tool.handler.js";
+
+export { mockCreateAgentHandler, mockCreateToolHandler, mockExecuteAgentHandler, mockGetAgentHandler, mockGetRunHandler, mockGetToolHandler, mockListAgentsHandler, mockListRunsHandler, mockListToolsHandler };

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { AgentConsoleFeature } from "./agent.feature.js";
+import { AgentEntity, AgentStatusEntityEnum, AgentToolEntity, ModelProviderEntityEnum } from "./agent/agent.entity.js";
+import { AgentStatusEnum, ModelProviderEnum, ToolChoiceEnum } from "./agent/agent.enum.js";
+import { AgentCreatedEvent, AgentToolAssignedEvent, AgentToolRemovedEvent, AgentUpdatedEvent } from "./agent/agent.event.js";
+import { AgentSummary, AgentToolRef, AgentWithTools, GetAgentInput, ListAgentsInput, ListAgentsOutput, mockCreateAgentHandler, mockGetAgentHandler, mockListAgentsHandler, mockUpdateAgentHandler } from "./agent/agent.handler.js";
+import { AssignToolToAgentCommand, CreateAgentCommand, GetAgentQuery, ListAgentsQuery, RemoveToolFromAgentCommand, UpdateAgentCommand } from "./agent/agent.operation.js";
+import { AgentConsoleDashboardPresentation, AgentDetailPresentation, AgentListPresentation } from "./agent/agent.presentation.js";
+import { AgentModel, AgentSummaryModel, AgentToolRefModel, AgentWithToolsModel, CreateAgentInputModel, UpdateAgentInputModel } from "./agent/agent.schema.js";
+import "./agent/index.js";
+import example from "./example.js";
+import { ListRunsInput, ListRunsOutput, RunSummary, mockCancelRunHandler, mockExecuteAgentHandler, mockGetRunHandler, mockListRunsHandler } from "./run/run.handler.js";
+import { ListToolsInput, ListToolsOutput, ToolSummary, mockCreateToolHandler, mockGetToolHandler, mockListToolsHandler, mockTestToolHandler, mockUpdateToolHandler } from "./tool/tool.handler.js";
+import { GranularityEnum, LogLevelEnum, RunStatusEnum, RunStepTypeEnum } from "./run/run.enum.js";
+import { RunAgentRefModel, RunInputModel, RunLogModel, RunModel, RunStepModel, RunSummaryModel, TimelineDataPointModel } from "./run/run.schema.js";
+import { CancelRunCommand, ExecuteAgentCommand, GetRunLogsQuery, GetRunMetricsQuery, GetRunQuery, GetRunStepsQuery, ListRunsQuery } from "./run/run.operation.js";
+import { MessageGeneratedEvent, RunCancelledEvent, RunCompletedEvent, RunFailedEvent, RunStartedEvent, ToolCompletedEvent, ToolInvokedEvent } from "./run/run.event.js";
+import { LogLevelEntityEnum, RunEntity, RunLogEntity, RunStatusEntityEnum, RunStepEntity, RunStepTypeEntityEnum } from "./run/run.entity.js";
+import { RunDetailPresentation, RunListPresentation } from "./run/run.presentation.js";
+import "./run/index.js";
+import { ImplementationTypeEnum, ToolCategoryEnum, ToolStatusEnum } from "./tool/tool.enum.js";
+import { CreateToolInputModel, ToolModel, ToolSummaryModel, UpdateToolInputModel } from "./tool/tool.schema.js";
+import { CreateToolCommand, GetToolQuery, ListToolsQuery, TestToolCommand, UpdateToolCommand } from "./tool/tool.operation.js";
+import { ToolCreatedEvent, ToolStatusChangedEvent, ToolUpdatedEvent } from "./tool/tool.event.js";
+import { ImplementationTypeEntityEnum, ToolCategoryEntityEnum, ToolEntity, ToolStatusEntityEnum } from "./tool/tool.entity.js";
+import { ToolDetailPresentation, ToolListPresentation } from "./tool/tool.presentation.js";
+import "./tool/index.js";
+import { MOCK_AGENTS } from "./shared/mock-agents.js";
+import { MOCK_TOOLS } from "./shared/mock-tools.js";
+import { MOCK_RUNS } from "./shared/mock-runs.js";
+export { AgentConsoleDashboardPresentation, AgentConsoleFeature, AgentCreatedEvent, AgentDetailPresentation, AgentEntity, AgentListPresentation, AgentModel, AgentStatusEntityEnum, AgentStatusEnum, AgentSummary, AgentSummaryModel, AgentToolAssignedEvent, AgentToolEntity, AgentToolRef, AgentToolRefModel, AgentToolRemovedEvent, AgentUpdatedEvent, AgentWithTools, AgentWithToolsModel, AssignToolToAgentCommand, CancelRunCommand, CreateAgentCommand, CreateAgentInputModel, CreateToolCommand, CreateToolInputModel, ExecuteAgentCommand, GetAgentInput, GetAgentQuery, GetRunLogsQuery, GetRunMetricsQuery, GetRunQuery, GetRunStepsQuery, GetToolQuery, GranularityEnum, ImplementationTypeEntityEnum, ImplementationTypeEnum, ListAgentsInput, ListAgentsOutput, ListAgentsQuery, ListRunsInput, ListRunsOutput, ListRunsQuery, ListToolsInput, ListToolsOutput, ListToolsQuery, LogLevelEntityEnum, LogLevelEnum, MOCK_AGENTS, MOCK_RUNS, MOCK_TOOLS, MessageGeneratedEvent, ModelProviderEntityEnum, ModelProviderEnum, RemoveToolFromAgentCommand, RunAgentRefModel, RunCancelledEvent, RunCompletedEvent, RunDetailPresentation, RunEntity, RunFailedEvent, RunInputModel, RunListPresentation, RunLogEntity, RunLogModel, RunModel, RunStartedEvent, RunStatusEntityEnum, RunStatusEnum, RunStepEntity, RunStepModel, RunStepTypeEntityEnum, RunStepTypeEnum, RunSummary, RunSummaryModel, TestToolCommand, TimelineDataPointModel, ToolCategoryEntityEnum, ToolCategoryEnum, ToolChoiceEnum, ToolCompletedEvent, ToolCreatedEvent, ToolDetailPresentation, ToolEntity, ToolInvokedEvent, ToolListPresentation, ToolModel, ToolStatusChangedEvent, ToolStatusEntityEnum, ToolStatusEnum, ToolSummary, ToolSummaryModel, ToolUpdatedEvent, UpdateAgentCommand, UpdateAgentInputModel, UpdateToolCommand, UpdateToolInputModel, example, mockCancelRunHandler, mockCreateAgentHandler, mockCreateToolHandler, mockExecuteAgentHandler, mockGetAgentHandler, mockGetRunHandler, mockGetToolHandler, mockListAgentsHandler, mockListRunsHandler, mockListToolsHandler, mockTestToolHandler, mockUpdateAgentHandler, mockUpdateToolHandler };

package/dist/index.js

@@ -0,0 +1,32 @@
+import { AgentConsoleFeature } from "./agent.feature.js";
+import example_default from "./example.js";
+import { AgentStatusEnum, ModelProviderEnum, ToolChoiceEnum } from "./agent/agent.enum.js";
+import { AgentModel, AgentSummaryModel, AgentToolRefModel, AgentWithToolsModel, CreateAgentInputModel, UpdateAgentInputModel } from "./agent/agent.schema.js";
+import { AgentCreatedEvent, AgentToolAssignedEvent, AgentToolRemovedEvent, AgentUpdatedEvent } from "./agent/agent.event.js";
+import { AssignToolToAgentCommand, CreateAgentCommand, GetAgentQuery, ListAgentsQuery, RemoveToolFromAgentCommand, UpdateAgentCommand } from "./agent/agent.operation.js";
+import { AgentEntity, AgentStatusEntityEnum, AgentToolEntity, ModelProviderEntityEnum } from "./agent/agent.entity.js";
+import { AgentConsoleDashboardPresentation, AgentDetailPresentation, AgentListPresentation } from "./agent/agent.presentation.js";
+import { MOCK_AGENTS } from "./shared/mock-agents.js";
+import { MOCK_TOOLS } from "./shared/mock-tools.js";
+import { mockCreateAgentHandler, mockGetAgentHandler, mockListAgentsHandler, mockUpdateAgentHandler } from "./agent/agent.handler.js";
+import "./agent/index.js";
+import { GranularityEnum, LogLevelEnum, RunStatusEnum, RunStepTypeEnum } from "./run/run.enum.js";
+import { RunAgentRefModel, RunInputModel, RunLogModel, RunModel, RunStepModel, RunSummaryModel, TimelineDataPointModel } from "./run/run.schema.js";
+import { CancelRunCommand, ExecuteAgentCommand, GetRunLogsQuery, GetRunMetricsQuery, GetRunQuery, GetRunStepsQuery, ListRunsQuery } from "./run/run.operation.js";
+import { MessageGeneratedEvent, RunCancelledEvent, RunCompletedEvent, RunFailedEvent, RunStartedEvent, ToolCompletedEvent, ToolInvokedEvent } from "./run/run.event.js";
+import { LogLevelEntityEnum, RunEntity, RunLogEntity, RunStatusEntityEnum, RunStepEntity, RunStepTypeEntityEnum } from "./run/run.entity.js";
+import { RunDetailPresentation, RunListPresentation } from "./run/run.presentation.js";
+import { MOCK_RUNS } from "./shared/mock-runs.js";
+import { mockCancelRunHandler, mockExecuteAgentHandler, mockGetRunHandler, mockListRunsHandler } from "./run/run.handler.js";
+import "./run/index.js";
+import { ImplementationTypeEnum, ToolCategoryEnum, ToolStatusEnum } from "./tool/tool.enum.js";
+import { CreateToolInputModel, ToolModel, ToolSummaryModel, UpdateToolInputModel } from "./tool/tool.schema.js";
+import { CreateToolCommand, GetToolQuery, ListToolsQuery, TestToolCommand, UpdateToolCommand } from "./tool/tool.operation.js";
+import { ToolCreatedEvent, ToolStatusChangedEvent, ToolUpdatedEvent } from "./tool/tool.event.js";
+import { ImplementationTypeEntityEnum, ToolCategoryEntityEnum, ToolEntity, ToolStatusEntityEnum } from "./tool/tool.entity.js";
+import { ToolDetailPresentation, ToolListPresentation } from "./tool/tool.presentation.js";
+import { mockCreateToolHandler, mockGetToolHandler, mockListToolsHandler, mockTestToolHandler, mockUpdateToolHandler } from "./tool/tool.handler.js";
+import "./tool/index.js";
+import "./docs/index.js";
+
+export { AgentConsoleDashboardPresentation, AgentConsoleFeature, AgentCreatedEvent, AgentDetailPresentation, AgentEntity, AgentListPresentation, AgentModel, AgentStatusEntityEnum, AgentStatusEnum, AgentSummaryModel, AgentToolAssignedEvent, AgentToolEntity, AgentToolRefModel, AgentToolRemovedEvent, AgentUpdatedEvent, AgentWithToolsModel, AssignToolToAgentCommand, CancelRunCommand, CreateAgentCommand, CreateAgentInputModel, CreateToolCommand, CreateToolInputModel, ExecuteAgentCommand, GetAgentQuery, GetRunLogsQuery, GetRunMetricsQuery, GetRunQuery, GetRunStepsQuery, GetToolQuery, GranularityEnum, ImplementationTypeEntityEnum, ImplementationTypeEnum, ListAgentsQuery, ListRunsQuery, ListToolsQuery, LogLevelEntityEnum, LogLevelEnum, MOCK_AGENTS, MOCK_RUNS, MOCK_TOOLS, MessageGeneratedEvent, ModelProviderEntityEnum, ModelProviderEnum, RemoveToolFromAgentCommand, RunAgentRefModel, RunCancelledEvent, RunCompletedEvent, RunDetailPresentation, RunEntity, RunFailedEvent, RunInputModel, RunListPresentation, RunLogEntity, RunLogModel, RunModel, RunStartedEvent, RunStatusEntityEnum, RunStatusEnum, RunStepEntity, RunStepModel, RunStepTypeEntityEnum, RunStepTypeEnum, RunSummaryModel, TestToolCommand, TimelineDataPointModel, ToolCategoryEntityEnum, ToolCategoryEnum, ToolChoiceEnum, ToolCompletedEvent, ToolCreatedEvent, ToolDetailPresentation, ToolEntity, ToolInvokedEvent, ToolListPresentation, ToolModel, ToolStatusChangedEvent, ToolStatusEntityEnum, ToolStatusEnum, ToolSummaryModel, ToolUpdatedEvent, UpdateAgentCommand, UpdateAgentInputModel, UpdateToolCommand, UpdateToolInputModel, example_default as example, mockCancelRunHandler, mockCreateAgentHandler, mockCreateToolHandler, mockExecuteAgentHandler, mockGetAgentHandler, mockGetRunHandler, mockGetToolHandler, mockListAgentsHandler, mockListRunsHandler, mockListToolsHandler, mockTestToolHandler, mockUpdateAgentHandler, mockUpdateToolHandler };

package/dist/presentations/index.d.ts

@@ -0,0 +1,4 @@
+import { AgentConsoleDashboardPresentation, AgentDetailPresentation, AgentListPresentation } from "../agent/agent.presentation.js";
+import { RunDetailPresentation, RunListPresentation } from "../run/run.presentation.js";
+import { ToolDetailPresentation, ToolListPresentation } from "../tool/tool.presentation.js";
+export { AgentConsoleDashboardPresentation, AgentDetailPresentation, AgentListPresentation, RunDetailPresentation, RunListPresentation, RunDetailPresentation as RunMetricsPresentation, ToolDetailPresentation, ToolListPresentation, ToolListPresentation as ToolRegistryPresentation };

package/dist/presentations/index.js

@@ -0,0 +1,5 @@
+import { AgentConsoleDashboardPresentation, AgentDetailPresentation, AgentListPresentation } from "../agent/agent.presentation.js";
+import { RunDetailPresentation, RunListPresentation } from "../run/run.presentation.js";
+import { ToolDetailPresentation, ToolListPresentation } from "../tool/tool.presentation.js";
+
+export { AgentConsoleDashboardPresentation, AgentDetailPresentation, AgentListPresentation, RunDetailPresentation, RunListPresentation, RunDetailPresentation as RunMetricsPresentation, ToolDetailPresentation, ToolListPresentation, ToolListPresentation as ToolRegistryPresentation };

package/dist/run/index.d.ts

@@ -0,0 +1,8 @@
+import { ListRunsInput, ListRunsOutput, RunSummary, mockCancelRunHandler, mockExecuteAgentHandler, mockGetRunHandler, mockListRunsHandler } from "./run.handler.js";
+import { GranularityEnum, LogLevelEnum, RunStatusEnum, RunStepTypeEnum } from "./run.enum.js";
+import { RunAgentRefModel, RunInputModel, RunLogModel, RunModel, RunStepModel, RunSummaryModel, TimelineDataPointModel } from "./run.schema.js";
+import { CancelRunCommand, ExecuteAgentCommand, GetRunLogsQuery, GetRunMetricsQuery, GetRunQuery, GetRunStepsQuery, ListRunsQuery } from "./run.operation.js";
+import { MessageGeneratedEvent, RunCancelledEvent, RunCompletedEvent, RunFailedEvent, RunStartedEvent, ToolCompletedEvent, ToolInvokedEvent } from "./run.event.js";
+import { LogLevelEntityEnum, RunEntity, RunLogEntity, RunStatusEntityEnum, RunStepEntity, RunStepTypeEntityEnum } from "./run.entity.js";
+import { RunDetailPresentation, RunListPresentation } from "./run.presentation.js";
+export { CancelRunCommand, ExecuteAgentCommand, GetRunLogsQuery, GetRunMetricsQuery, GetRunQuery, GetRunStepsQuery, GranularityEnum, type ListRunsInput, type ListRunsOutput, ListRunsQuery, LogLevelEntityEnum, LogLevelEnum, MessageGeneratedEvent, RunAgentRefModel, RunCancelledEvent, RunCompletedEvent, RunDetailPresentation, RunEntity, RunFailedEvent, RunInputModel, RunListPresentation, RunLogEntity, RunLogModel, RunModel, RunStartedEvent, RunStatusEntityEnum, RunStatusEnum, RunStepEntity, RunStepModel, RunStepTypeEntityEnum, RunStepTypeEnum, type RunSummary, RunSummaryModel, TimelineDataPointModel, ToolCompletedEvent, ToolInvokedEvent, mockCancelRunHandler, mockExecuteAgentHandler, mockGetRunHandler, mockListRunsHandler };