@industry-theme/agent-driven-ui-panels 0.1.0

package/dist/types/agent-config.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Agent Configuration Types
+ *
+ * A hybrid schema combining conventions from multiple AI agent standards:
+ *
+ * ## References
+ *
+ * ### A2A Protocol - Agent Card (Google + 50 companies)
+ * - Spec: https://a2a-protocol.org/latest/specification/
+ * - Location: /.well-known/agent.json
+ * - Provides: id, name, description, version, skills, capabilities
+ * - Survey: https://arxiv.org/html/2508.03095v1
+ *
+ * ### Microsoft Declarative Agent Manifest v1.5
+ * - Spec: https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/declarative-agent-manifest-1.5
+ * - JSON Schema: https://aka.ms/json-schemas/copilot/declarative-agent/v1.5/schema.json
+ * - Provides: instructions (system prompt), capabilities, actions
+ *
+ * ### Model Context Protocol (MCP)
+ * - Spec: https://modelcontextprotocol.io/specification/2025-06-18
+ * - TypeScript Schema: https://github.com/modelcontextprotocol/specification/blob/main/schema/schema.ts
+ * - Provides: tools with name, description, inputSchema, outputSchema
+ *
+ * ### OpenAI Function Calling / Structured Outputs
+ * - Docs: https://platform.openai.com/docs/guides/function-calling
+ * - Cookbook: https://cookbook.openai.com/examples/function_calling_with_an_openapi_spec
+ * - Provides: JSON Schema for tool inputs/outputs, strict mode
+ *
+ * ### Agents.md Standard (2025)
+ * - Info: https://www.remio.ai/post/what-is-agents-md-a-complete-guide-to-the-new-ai-coding-agent-standard-in-2025
+ * - Provides: Agent manifest with identity, behavioral rules, capability interfaces
+ *
+ * ### Agent Communication Protocol (ACP)
+ * - Spec: https://agentcommunicationprotocol.dev/core-concepts/agent-manifest
+ * - Provides: Agent manifest with identity, capabilities, metadata, runtime status
+ *
+ * @version 0.1.0
+ * @lastUpdated 2024-12-01
+ */
+import type { PanelTool } from '@principal-ade/panel-framework-core';
+import type { ReactNode } from 'react';
+/**
+ * Skill definition following A2A Protocol Agent Card specification.
+ *
+ * @see https://a2a-protocol.org/latest/specification/
+ *
+ * Skills represent discrete capabilities an agent can perform.
+ * They are similar to MCP tools but with A2A-specific metadata.
+ */
+export interface AgentSkill {
+    /** Unique identifier for the skill */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of what the skill does */
+    description: string;
+    /**
+     * JSON Schema defining expected input parameters.
+     * @see https://json-schema.org/
+     */
+    inputSchema?: Record<string, unknown>;
+    /**
+     * JSON Schema defining the output format.
+     * @see https://json-schema.org/
+     */
+    outputSchema?: Record<string, unknown>;
+    /** Tags for categorization and discovery */
+    tags?: string[];
+}
+/**
+ * Agent capabilities following A2A Protocol conventions.
+ *
+ * @see https://a2a-protocol.org/latest/specification/
+ *
+ * Capabilities declare support for optional protocol features.
+ * Extend this interface for domain-specific capabilities.
+ */
+export interface AgentCapabilities {
+    /** Whether the agent supports streaming responses */
+    streaming?: boolean;
+    /** Whether the agent supports push notifications */
+    pushNotifications?: boolean;
+    /** Whether the agent can execute code */
+    codeExecution?: boolean;
+    /** Whether the agent can generate images */
+    imageGeneration?: boolean;
+    /** Whether the agent can browse the web */
+    webBrowsing?: boolean;
+    /** Whether the agent can access files */
+    fileAccess?: boolean;
+    /** Additional custom capabilities */
+    [key: string]: boolean | undefined;
+}
+/**
+ * Provider/vendor information following A2A Protocol.
+ *
+ * @see https://a2a-protocol.org/latest/specification/
+ */
+export interface AgentProvider {
+    /** Provider/organization name */
+    name: string;
+    /** Provider website URL */
+    url?: string;
+    /** URL to provider logo */
+    logo?: string;
+}
+/**
+ * Reference to an external resource (system prompt, documentation, etc.)
+ *
+ * Supports multiple URI schemes for flexibility:
+ * - `file://` or relative path: Local file
+ * - `http://` or `https://`: Remote URL
+ * - `panel://`: Panel framework resource
+ * - `mcp://`: MCP resource URI
+ */
+export interface ResourceRef {
+    /** URI or path to the resource */
+    uri: string;
+    /** MIME type of the resource (e.g., "text/markdown", "text/plain") */
+    mimeType?: string;
+    /** Human-readable label */
+    label?: string;
+}
+/**
+ * Agent Configuration - Hybrid schema combining multiple standards.
+ *
+ * This interface combines the best practices from:
+ * - A2A Protocol Agent Card (identity, skills, capabilities)
+ * - Microsoft Declarative Agent Manifest (instructions/system prompt)
+ * - MCP Tool Manifest (tools with JSON schemas)
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * const agentConfig: AgentConfig = {
+ *   id: 'my-org.coding-assistant',
+ *   name: 'Coding Assistant',
+ *   description: 'An AI assistant for software development tasks',
+ *   version: '1.0.0',
+ *   instructions: 'You are a helpful coding assistant...',
+ *   systemPromptRef: { uri: './prompts/system.md', mimeType: 'text/markdown' },
+ *   tools: [...],
+ *   capabilities: { streaming: true, codeExecution: true },
+ * };
+ * ```
+ */
+export interface AgentConfig {
+    /**
+     * Unique identifier for the agent.
+     * Recommended format: "{namespace}.{agent-name}" (e.g., "my-org.assistant")
+     */
+    id: string;
+    /**
+     * Human-readable name of the agent.
+     * @maxLength 100 (Microsoft recommendation)
+     */
+    name: string;
+    /**
+     * Description of what the agent does.
+     * @maxLength 1000 (Microsoft recommendation)
+     */
+    description: string;
+    /**
+     * Semantic version of the agent configuration.
+     * @see https://semver.org/
+     */
+    version?: string;
+    /**
+     * Provider/vendor information.
+     * @see https://a2a-protocol.org/latest/specification/
+     */
+    provider?: AgentProvider;
+    /**
+     * Short instructions or guidelines on how the agent should behave.
+     * This is typically a summary; use systemPromptRef for the full prompt.
+     * @maxLength 8000 (Microsoft recommendation)
+     */
+    instructions?: string;
+    /**
+     * Reference to the full system prompt resource.
+     * The actual prompt content is stored externally and loaded on demand.
+     */
+    systemPromptRef?: ResourceRef;
+    /**
+     * Example conversation starters to help users understand agent capabilities.
+     * @maxLength 12 items (Microsoft recommendation)
+     */
+    conversationStarters?: string[];
+    /**
+     * Tools available to the agent.
+     * Uses the PanelTool type from panel-framework-core which is UTCP-compatible.
+     * @see https://modelcontextprotocol.io/specification/2025-06-18
+     */
+    tools?: PanelTool[];
+    /**
+     * Skills following A2A Protocol convention.
+     * Skills are similar to tools but with A2A-specific metadata.
+     * Use this if integrating with A2A-compatible systems.
+     * @see https://a2a-protocol.org/latest/specification/
+     */
+    skills?: AgentSkill[];
+    /**
+     * Capabilities supported by this agent.
+     * Declares optional features the agent can perform.
+     */
+    capabilities?: AgentCapabilities;
+    /**
+     * Icon for the agent.
+     * Can be a ReactNode (e.g., Lucide icon), URL string, or emoji string.
+     */
+    icon?: ReactNode;
+    /**
+     * Tags for categorization and discovery.
+     */
+    tags?: string[];
+    /**
+     * Additional metadata for extensibility.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Minimal agent info for display in lists/cards.
+ * Subset of AgentConfig for lightweight views.
+ */
+export interface AgentInfo {
+    id: string;
+    name: string;
+    description: string;
+    version?: string;
+    icon?: ReactNode;
+    toolCount?: number;
+    capabilities?: AgentCapabilities;
+}
+//# sourceMappingURL=agent-config.d.ts.map

package/dist/types/agent-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../src/types/agent-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IAEX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,qCAAqC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IAEZ,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,WAAW;IAM1B;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IAOzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC;IAE9B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAQhC;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IAEpB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IAOtB;;;OAGG;IACH,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAMjC;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC"}

package/dist/types/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Panel Extension Type Definitions
+ *
+ * Re-exports core types from @principal-ade/panel-framework-core
+ */
+export type { DataSlice, WorkspaceMetadata, RepositoryMetadata, FileTreeSource, ActiveFileSlice, PanelEventType, PanelEvent, PanelActions, PanelContextValue, PanelComponentProps, PanelMetadata, PanelLifecycleHooks, PanelDefinition, PanelModule, PanelRegistryEntry, PanelLoader, PanelRegistryConfig, PanelTool, PanelToolsMetadata, JsonSchema, PanelEventCallTemplate, } from '@principal-ade/panel-framework-core';
+import type { PanelEvent, PanelEventEmitter as BasePanelEventEmitter } from '@principal-ade/panel-framework-core';
+/**
+ * Extended PanelEventEmitter with wildcard subscription support.
+ * The core PanelEventBus class implements these methods, but the
+ * base interface doesn't include them yet.
+ */
+export interface PanelEventEmitter extends BasePanelEventEmitter {
+    /** Subscribe to all events (wildcard) */
+    onAll?<T>(handler: (event: PanelEvent<T>) => void): () => void;
+    /** Unsubscribe from wildcard handler */
+    offAll?<T>(handler: (event: PanelEvent<T>) => void): void;
+}
+export type { AgentConfig, AgentInfo, AgentSkill, AgentCapabilities, AgentProvider, ResourceRef, } from './agent-config';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAEV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,eAAe,EAGf,cAAc,EACd,UAAU,EAGV,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EAGnB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,WAAW,EAGX,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EAGnB,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,IAAI,qBAAqB,EAC3C,MAAM,qCAAqC,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,yCAAyC;IACzC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC/D,wCAAwC;IACxC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CAC3D;AAGD,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,WAAW,GACZ,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@industry-theme/agent-driven-ui-panels",
+  "version": "0.1.0",
+  "description": "Agent-driven UI panels for displaying system prompts, event bus activity, and other agent internals",
+  "type": "module",
+  "main": "dist/panels.bundle.js",
+  "module": "dist/panels.bundle.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/panels.bundle.js",
+      "require": "./dist/panels.bundle.js",
+      "default": "./dist/panels.bundle.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools.bundle.js",
+      "require": "./dist/tools.bundle.js",
+      "default": "./dist/tools.bundle.js"
+    }
+  },
+  "keywords": [
+    "panel-extension"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "scripts": {
+    "build": "bun run clean && bun run build:panel && bun run build:tools && bun run build:types",
+    "build:panel": "vite build",
+    "build:tools": "bun build ./src/tools/index.ts --outfile ./dist/tools.bundle.js --format esm --target browser",
+    "build:types": "tsc --project tsconfig.build.json --emitDeclarationOnly --declaration --declarationMap",
+    "dev": "vite build --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --ext .ts,.tsx",
+    "lint:fix": "eslint . --ext .ts,.tsx --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@principal-ade/panel-framework-core": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@principal-ade/industry-theme": "^0.1.2",
+    "@principal-ade/panel-framework-core": "^0.1.5",
+    "@principal-ade/utcp-panel-event": "^0.1.0",
+    "clsx": "^2.1.1",
+    "lucide-react": "^0.552.0"
+  },
+  "devDependencies": {
+    "@chromatic-com/storybook": "^4.1.3",
+    "@eslint/js": "^9.32.0",
+    "@storybook/addon-docs": "10.1.2",
+    "@storybook/addon-links": "10.1.2",
+    "@storybook/addon-onboarding": "10.1.2",
+    "@storybook/react-vite": "10.1.2",
+    "@types/bun": "latest",
+    "@types/node": "^22.15.26",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "esbuild": "^0.25.8",
+    "eslint": "^9.32.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-react": "^7.37.2",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-storybook": "10.1.2",
+    "prettier": "^3.6.2",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "storybook": "10.1.2",
+    "typescript": "^5.0.4",
+    "typescript-eslint": "^8.38.0",
+    "vite": "^6.0.7"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/industry-theme/agent-driven-ui-panels.git"
+  }
+}