npm - apteva - Versions diffs - 0.4.10 → 0.4.12 - Mend

apteva 0.4.10 → 0.4.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/{App.csbvbyak.js → App.9ph8javh.js} +40 -39
package/dist/index.html +1 -1
package/package.json +1 -1
package/src/mcp-platform.ts +390 -27
package/src/routes/api/meta-agent.ts +25 -17
package/src/web/components/meta-agent/MetaAgent.tsx +17 -2

package/dist/index.html CHANGED Viewed

@@ -11,6 +11,6 @@
 </head>
 <body>
   <div id="root"></div>
-  <script type="module" src="/App.csbvbyak.js"></script>
+  <script type="module" src="/App.9ph8javh.js"></script>
 </body>
 </html>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "apteva",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "Run AI agents locally. Multi-provider support for Claude, GPT, Gemini, Llama, and more.",
   "type": "module",
   "main": "./dist/index.js",

package/src/mcp-platform.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 // Built-in MCP server that exposes the Apteva platform API as MCP tools
 // This allows the meta agent (Apteva Assistant) to control the platform
-import { AgentDB, ProjectDB, McpServerDB, TelemetryDB, generateId } from "./db";
+import { AgentDB, ProjectDB, McpServerDB, SkillDB, TelemetryDB, generateId } from "./db";
 import { getProvidersWithStatus, PROVIDERS } from "./providers";
 import { startAgentProcess, setAgentStatus, toApiAgent, META_AGENT_ID, agentFetch } from "./routes/api/agent-utils";
 import { agentProcesses } from "./server";
@@ -48,24 +48,47 @@ const PLATFORM_TOOLS = [
   },
   {
     name: "create_agent",
-    description: "Create a new AI agent. Requires a name, provider, and model. The provider must have an API key configured.",
+    description: `Create a new AI agent. The provider must have an API key configured — use list_providers first to check.
+PROVIDERS & MODELS (use list_providers to see which have keys):
+- anthropic: claude-sonnet-4-5 (recommended), claude-haiku-4-5 (fast/cheap)
+- openai: gpt-4o (recommended), gpt-4o-mini (fast/cheap)
+- groq: llama-3.3-70b-versatile (recommended), llama-3.1-8b-instant (fast)
+- gemini: gemini-3-pro-preview (recommended), gemini-3-flash-preview (fast)
+- xai: grok-2 (recommended), grok-2-mini (fast)
+- together: moonshotai/Kimi-K2.5 (recommended), moonshotai/Kimi-K2-Thinking (reasoning)
+- fireworks: accounts/fireworks/models/kimi-k2p5, accounts/fireworks/models/kimi-k2-thinking
+- moonshot: moonshot-v1-128k (recommended), moonshot-v1-32k (fast)
+- ollama: llama3.3, llama3.2, qwen2.5, mistral, deepseek-r1 (local, no API key needed)
+FEATURES (all optional, default false):
+- memory: Persistent memory across conversations — agent remembers past interactions. Requires OpenAI key for embeddings.
+- tasks: Task scheduling — agent can create, schedule, and track tasks. Supports recurring tasks.
+- vision: Image & PDF understanding — agent can analyze uploaded images and PDFs.
+- mcp: MCP tool use — agent can use tools from assigned MCP servers. Enable this if you plan to assign MCP servers.
+- files: File management — agent can read, write, and manage files in its workspace.
+TIPS:
+- Always provide a descriptive system_prompt that tells the agent what it does and how to behave.
+- Assign to a project_id to organize agents. Use list_projects to see available projects.
+- After creating, use start_agent to run it. Then assign MCP servers or skills as needed.`,
     inputSchema: {
       type: "object",
       properties: {
-        name: { type: "string", description: "Agent name" },
-        provider: { type: "string", description: "LLM provider ID (e.g. anthropic, openai, groq, gemini, xai, together, fireworks, ollama)" },
-        model: { type: "string", description: "Model ID (e.g. claude-sonnet-4-5, gpt-4o, llama-3.3-70b-versatile)" },
-        system_prompt: { type: "string", description: "System prompt for the agent (optional)" },
-        project_id: { type: "string", description: "Project ID to assign the agent to (optional)" },
+        name: { type: "string", description: "Agent name (e.g. 'Customer Support', 'Code Reviewer')" },
+        provider: { type: "string", description: "LLM provider ID: anthropic, openai, groq, gemini, xai, together, fireworks, moonshot, ollama" },
+        model: { type: "string", description: "Model ID — see tool description for full list per provider" },
+        system_prompt: { type: "string", description: "Instructions for the agent. Describe its role, personality, and capabilities. This is the most important field for agent behavior." },
+        project_id: { type: "string", description: "Project ID to assign the agent to (optional). Use list_projects to find IDs." },
         features: {
           type: "object",
-          description: "Feature flags (optional). All default to false.",
+          description: "Feature flags to enable. All default to false. See tool description for details on each feature.",
           properties: {
-            memory: { type: "boolean" },
-            tasks: { type: "boolean" },
-            vision: { type: "boolean" },
-            mcp: { type: "boolean" },
-            files: { type: "boolean" },
+            memory: { type: "boolean", description: "Persistent memory across conversations (requires OpenAI key for embeddings)" },
+            tasks: { type: "boolean", description: "Task scheduling and tracking" },
+            vision: { type: "boolean", description: "Image and PDF understanding" },
+            mcp: { type: "boolean", description: "MCP tool use — required if assigning MCP servers" },
+            files: { type: "boolean", description: "File read/write in agent workspace" },
           },
         },
       },
@@ -74,17 +97,27 @@ const PLATFORM_TOOLS = [
   },
   {
     name: "update_agent",
-    description: "Update an existing agent's configuration. Only provide fields you want to change.",
+    description: "Update an existing agent's configuration. Only provide fields you want to change. If the agent is running, restart it after updating for changes to take effect.",
     inputSchema: {
       type: "object",
       properties: {
         agent_id: { type: "string", description: "The agent ID to update" },
-        name: { type: "string", description: "New name" },
-        model: { type: "string", description: "New model ID" },
-        provider: { type: "string", description: "New provider ID" },
-        system_prompt: { type: "string", description: "New system prompt" },
-        project_id: { type: "string", description: "New project ID (or null to unassign)" },
-        features: { type: "object", description: "Feature flags to update" },
+        name: { type: "string", description: "New display name" },
+        model: { type: "string", description: "New model ID (see create_agent for available models per provider)" },
+        provider: { type: "string", description: "New provider ID (the new provider must have an API key configured)" },
+        system_prompt: { type: "string", description: "New system prompt / instructions" },
+        project_id: { type: "string", description: "New project ID, or null to unassign from project" },
+        features: {
+          type: "object",
+          description: "Feature flags to update (only provided flags are changed, others remain as-is)",
+          properties: {
+            memory: { type: "boolean" },
+            tasks: { type: "boolean" },
+            vision: { type: "boolean" },
+            mcp: { type: "boolean" },
+            files: { type: "boolean" },
+          },
+        },
       },
       required: ["agent_id"],
     },
@@ -102,7 +135,7 @@ const PLATFORM_TOOLS = [
   },
   {
     name: "start_agent",
-    description: "Start a stopped agent. The agent's provider must have an API key configured.",
+    description: "Start a stopped agent. The agent's provider must have an API key configured. Starting spawns a process, waits for health check, and pushes configuration (model, features, MCP servers, skills). Takes a few seconds.",
     inputSchema: {
       type: "object",
       properties: {
@@ -153,10 +186,84 @@ const PLATFORM_TOOLS = [
   },
   {
     name: "list_mcp_servers",
-    description: "List all configured MCP servers (tool integrations).",
+    description: "List all configured MCP servers (tool integrations). Optionally filter by project.",
     inputSchema: {
       type: "object",
-      properties: {},
+      properties: {
+        project_id: { type: "string", description: "Filter by project ID (optional)" },
+      },
+    },
+  },
+  {
+    name: "get_mcp_server",
+    description: "Get detailed information about an MCP server by ID.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        server_id: { type: "string", description: "The MCP server ID" },
+      },
+      required: ["server_id"],
+    },
+  },
+  {
+    name: "create_mcp_server",
+    description: `Create a new MCP server configuration. MCP servers provide tools that agents can use (web search, file access, APIs, etc).
+SERVER TYPES:
+- http: Remote MCP server accessible via URL. Provide url and optional auth headers. Ready to use immediately.
+- npm: Node.js MCP server from npm. Provide package name (e.g. '@modelcontextprotocol/server-filesystem'). Needs to be started.
+- pip: Python MCP server from PyPI. Provide package name. Needs to be started.
+- custom: Custom command. Provide command and args. Needs to be started.
+After creating, assign to agents with assign_mcp_server_to_agent. HTTP servers work immediately; npm/pip/custom servers need to be started from the MCP page in the UI.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "Display name (e.g. 'Filesystem', 'Web Search', 'GitHub')" },
+        type: { type: "string", description: "Server type: http, npm, pip, or custom" },
+        url: { type: "string", description: "For http type: the remote MCP server URL (e.g. 'https://mcp.example.com/sse')" },
+        headers: { type: "object", description: "For http type: auth headers as key-value pairs" },
+        package: { type: "string", description: "For npm/pip type: package name" },
+        command: { type: "string", description: "For custom type: executable command" },
+        args: { type: "string", description: "Command arguments string (optional)" },
+        project_id: { type: "string", description: "Scope to a project (optional). null = available globally to all agents." },
+      },
+      required: ["name", "type"],
+    },
+  },
+  {
+    name: "delete_mcp_server",
+    description: "Delete an MCP server. It must be stopped first.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        server_id: { type: "string", description: "The MCP server ID to delete" },
+      },
+      required: ["server_id"],
+    },
+  },
+  {
+    name: "assign_mcp_server_to_agent",
+    description: "Assign an MCP server to an agent so the agent can use its tools. This automatically enables the MCP feature on the agent. If the agent is running, restart it for changes to take effect.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        agent_id: { type: "string", description: "The agent ID" },
+        server_id: { type: "string", description: "The MCP server ID to assign" },
+      },
+      required: ["agent_id", "server_id"],
+    },
+  },
+  {
+    name: "unassign_mcp_server_from_agent",
+    description: "Remove an MCP server from an agent.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        agent_id: { type: "string", description: "The agent ID" },
+        server_id: { type: "string", description: "The MCP server ID to remove" },
+      },
+      required: ["agent_id", "server_id"],
     },
   },
   {
@@ -179,6 +286,75 @@ const PLATFORM_TOOLS = [
       required: ["agent_id", "message"],
     },
   },
+  // Skills management
+  {
+    name: "list_skills",
+    description: "List all installed skills. Skills are reusable instruction sets (like prompt templates with tool permissions) that give agents specialized capabilities. Skills can be installed from the SkillsMP marketplace or created locally.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        enabled_only: { type: "boolean", description: "Only return enabled skills (optional, default false)" },
+      },
+    },
+  },
+  {
+    name: "get_skill",
+    description: "Get detailed information about a skill by ID, including its full instructions content.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        skill_id: { type: "string", description: "The skill ID" },
+      },
+      required: ["skill_id"],
+    },
+  },
+  {
+    name: "toggle_skill",
+    description: "Enable or disable a skill.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        skill_id: { type: "string", description: "The skill ID" },
+        enabled: { type: "boolean", description: "Whether to enable (true) or disable (false) the skill" },
+      },
+      required: ["skill_id", "enabled"],
+    },
+  },
+  {
+    name: "assign_skill_to_agent",
+    description: "Assign a skill to an agent. The skill's instructions and tool permissions will be pushed to the agent on next start/restart.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        agent_id: { type: "string", description: "The agent ID" },
+        skill_id: { type: "string", description: "The skill ID to assign" },
+      },
+      required: ["agent_id", "skill_id"],
+    },
+  },
+  {
+    name: "unassign_skill_from_agent",
+    description: "Remove a skill from an agent.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        agent_id: { type: "string", description: "The agent ID" },
+        skill_id: { type: "string", description: "The skill ID to remove" },
+      },
+      required: ["agent_id", "skill_id"],
+    },
+  },
+  {
+    name: "delete_skill",
+    description: "Delete a skill. It will be unassigned from all agents.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        skill_id: { type: "string", description: "The skill ID to delete" },
+      },
+      required: ["skill_id"],
+    },
+  },
 ];
 // Tool execution handlers
@@ -351,24 +527,114 @@ async function executeTool(name: string, args: Record<string, any>): Promise<{ c
       }
       case "list_mcp_servers": {
-        const servers = McpServerDB.findAll();
+        const servers = args.project_id
+          ? McpServerDB.findByProject(args.project_id)
+          : McpServerDB.findAll();
         const result = servers.map(s => ({
           id: s.id,
           name: s.name,
           type: s.type,
           status: s.status,
           url: s.url,
+          package: s.package,
+          projectId: s.project_id,
         }));
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
       }
+      case "get_mcp_server": {
+        const server = McpServerDB.findById(args.server_id);
+        if (!server) {
+          return { content: [{ type: "text", text: `MCP server not found: ${args.server_id}` }], isError: true };
+        }
+        return { content: [{ type: "text", text: JSON.stringify({
+          id: server.id,
+          name: server.name,
+          type: server.type,
+          status: server.status,
+          url: server.url,
+          package: server.package,
+          command: server.command,
+          args: server.args,
+          port: server.port,
+          source: server.source,
+          projectId: server.project_id,
+        }, null, 2) }] };
+      }
+      case "create_mcp_server": {
+        const id = generateId();
+        const server = McpServerDB.create({
+          id,
+          name: args.name,
+          type: args.type || "http",
+          package: args.package || null,
+          pip_module: null,
+          command: args.command || null,
+          args: args.args || null,
+          env: {},
+          url: args.url || null,
+          headers: args.headers || {},
+          source: null,
+          project_id: args.project_id || null,
+        });
+        return { content: [{ type: "text", text: `MCP server created: ${JSON.stringify({ id: server.id, name: server.name, type: server.type }, null, 2)}` }] };
+      }
+      case "delete_mcp_server": {
+        const server = McpServerDB.findById(args.server_id);
+        if (!server) {
+          return { content: [{ type: "text", text: `MCP server not found: ${args.server_id}` }], isError: true };
+        }
+        if (server.status === "running") {
+          return { content: [{ type: "text", text: "Cannot delete a running MCP server. Stop it first." }], isError: true };
+        }
+        McpServerDB.delete(args.server_id);
+        return { content: [{ type: "text", text: `MCP server deleted: ${server.name} (${server.id})` }] };
+      }
+      case "assign_mcp_server_to_agent": {
+        const agent = AgentDB.findById(args.agent_id);
+        if (!agent) {
+          return { content: [{ type: "text", text: `Agent not found: ${args.agent_id}` }], isError: true };
+        }
+        const server = McpServerDB.findById(args.server_id);
+        if (!server) {
+          return { content: [{ type: "text", text: `MCP server not found: ${args.server_id}` }], isError: true };
+        }
+        const mcpServers = agent.mcp_servers || [];
+        if (mcpServers.includes(args.server_id)) {
+          return { content: [{ type: "text", text: `Server ${server.name} is already assigned to ${agent.name}` }] };
+        }
+        AgentDB.update(args.agent_id, { mcp_servers: [...mcpServers, args.server_id] });
+        // Enable MCP feature if not already
+        if (!agent.features.mcp) {
+          AgentDB.update(args.agent_id, { features: { ...agent.features, mcp: true } });
+        }
+        return { content: [{ type: "text", text: `Assigned MCP server "${server.name}" to agent "${agent.name}". Restart the agent for changes to take effect.` }] };
+      }
+      case "unassign_mcp_server_from_agent": {
+        const agent = AgentDB.findById(args.agent_id);
+        if (!agent) {
+          return { content: [{ type: "text", text: `Agent not found: ${args.agent_id}` }], isError: true };
+        }
+        const mcpServers = agent.mcp_servers || [];
+        if (!mcpServers.includes(args.server_id)) {
+          return { content: [{ type: "text", text: `Server is not assigned to this agent` }] };
+        }
+        AgentDB.update(args.agent_id, { mcp_servers: mcpServers.filter((id: string) => id !== args.server_id) });
+        return { content: [{ type: "text", text: `Removed MCP server from agent "${agent.name}". Restart the agent for changes to take effect.` }] };
+      }
       case "get_dashboard_stats": {
         const agentCount = AgentDB.count();
         const runningCount = AgentDB.countRunning();
         const projectCount = ProjectDB.count();
         const providers = getProvidersWithStatus().filter(p => p.type === "llm");
         const configuredProviders = providers.filter(p => p.hasKey).length;
-        const mcpServers = McpServerDB.findAll().length;
+        const mcpServerCount = McpServerDB.findAll().length;
+        const skillCount = SkillDB.count();
         return {
           content: [{
@@ -377,7 +643,8 @@ async function executeTool(name: string, args: Record<string, any>): Promise<{ c
               agents: { total: agentCount - 1, running: runningCount }, // -1 for meta agent
               projects: projectCount,
               providers: { total: providers.length, configured: configuredProviders },
-              mcpServers,
+              mcpServers: mcpServerCount,
+              skills: skillCount,
             }, null, 2),
           }],
         };
@@ -413,6 +680,92 @@ async function executeTool(name: string, args: Record<string, any>): Promise<{ c
         }
       }
+      case "list_skills": {
+        const skills = args.enabled_only ? SkillDB.findEnabled() : SkillDB.findAll();
+        const result = skills.map(s => ({
+          id: s.id,
+          name: s.name,
+          description: s.description,
+          version: s.version,
+          enabled: s.enabled,
+          source: s.source,
+          projectId: s.project_id,
+        }));
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+      case "get_skill": {
+        const skill = SkillDB.findById(args.skill_id);
+        if (!skill) {
+          return { content: [{ type: "text", text: `Skill not found: ${args.skill_id}` }], isError: true };
+        }
+        return { content: [{ type: "text", text: JSON.stringify({
+          id: skill.id,
+          name: skill.name,
+          description: skill.description,
+          content: skill.content.slice(0, 500) + (skill.content.length > 500 ? "..." : ""),
+          version: skill.version,
+          enabled: skill.enabled,
+          source: skill.source,
+          allowedTools: skill.allowed_tools,
+          projectId: skill.project_id,
+        }, null, 2) }] };
+      }
+      case "toggle_skill": {
+        const skill = SkillDB.findById(args.skill_id);
+        if (!skill) {
+          return { content: [{ type: "text", text: `Skill not found: ${args.skill_id}` }], isError: true };
+        }
+        SkillDB.setEnabled(args.skill_id, args.enabled);
+        return { content: [{ type: "text", text: `Skill "${skill.name}" ${args.enabled ? "enabled" : "disabled"}` }] };
+      }
+      case "assign_skill_to_agent": {
+        const agent = AgentDB.findById(args.agent_id);
+        if (!agent) {
+          return { content: [{ type: "text", text: `Agent not found: ${args.agent_id}` }], isError: true };
+        }
+        const skill = SkillDB.findById(args.skill_id);
+        if (!skill) {
+          return { content: [{ type: "text", text: `Skill not found: ${args.skill_id}` }], isError: true };
+        }
+        const skills = agent.skills || [];
+        if (skills.includes(args.skill_id)) {
+          return { content: [{ type: "text", text: `Skill "${skill.name}" is already assigned to "${agent.name}"` }] };
+        }
+        AgentDB.update(args.agent_id, { skills: [...skills, args.skill_id] });
+        return { content: [{ type: "text", text: `Assigned skill "${skill.name}" to agent "${agent.name}". Restart the agent for changes to take effect.` }] };
+      }
+      case "unassign_skill_from_agent": {
+        const agent = AgentDB.findById(args.agent_id);
+        if (!agent) {
+          return { content: [{ type: "text", text: `Agent not found: ${args.agent_id}` }], isError: true };
+        }
+        const skills = agent.skills || [];
+        if (!skills.includes(args.skill_id)) {
+          return { content: [{ type: "text", text: `Skill is not assigned to this agent` }] };
+        }
+        AgentDB.update(args.agent_id, { skills: skills.filter((id: string) => id !== args.skill_id) });
+        return { content: [{ type: "text", text: `Removed skill from agent "${agent.name}". Restart the agent for changes to take effect.` }] };
+      }
+      case "delete_skill": {
+        const skill = SkillDB.findById(args.skill_id);
+        if (!skill) {
+          return { content: [{ type: "text", text: `Skill not found: ${args.skill_id}` }], isError: true };
+        }
+        // Unassign from all agents first
+        const agentsWithSkill = AgentDB.findBySkill(args.skill_id);
+        for (const agent of agentsWithSkill) {
+          const updated = (agent.skills || []).filter((id: string) => id !== args.skill_id);
+          AgentDB.update(agent.id, { skills: updated });
+        }
+        SkillDB.delete(args.skill_id);
+        return { content: [{ type: "text", text: `Skill "${skill.name}" deleted${agentsWithSkill.length > 0 ? ` (unassigned from ${agentsWithSkill.length} agent(s))` : ""}` }] };
+      }
       default:
         return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
     }
@@ -460,7 +813,17 @@ export async function handlePlatformMcpRequest(req: Request): Promise<Response>
           name: "apteva-platform",
           version: "1.0.0",
         },
-        instructions: "This MCP server provides tools to control the Apteva AI agent platform. You can create, start, stop, and manage agents, projects, and view system status.",
+        instructions: `This MCP server controls the Apteva AI agent management platform.
+You can manage:
+- AGENTS: Create, configure, start, stop, and delete AI agents. Each agent has a provider (LLM), model, system prompt, and optional features (memory, tasks, vision, MCP tools, files).
+- PROJECTS: Organize agents into projects for grouping.
+- MCP SERVERS: Tool integrations that give agents capabilities (web search, file access, APIs). Assign servers to agents.
+- SKILLS: Reusable instruction sets that specialize agent behavior. Assign skills to agents.
+- PROVIDERS: View which LLM providers have API keys configured.
+Typical workflow: list_providers → create_agent → assign MCP servers/skills → start_agent.
+Always use list_providers first to check which providers have API keys before creating agents.`,
       };
       break;
     }

package/src/routes/api/meta-agent.ts CHANGED Viewed

@@ -47,23 +47,31 @@ export async function handleMetaAgentRoutes(
         name: "Apteva Assistant",
         model: defaultModel,
         provider: providerId,
-        system_prompt: `You are the Apteva Assistant, an AI that manages the Apteva agent platform.
-You have tools to control the platform directly:
-- Create, configure, start, and stop AI agents
-- Manage projects and organize agents into them
-- View system status, configured providers, and MCP servers
-- Send messages to other running agents
-Use your tools proactively when users ask you to do things. For example:
-- "Create a GPT agent" → use create_agent with provider "openai" and model "gpt-4o"
-- "Start my agent" → use start_agent
-- "How many agents do I have?" → use get_dashboard_stats or list_agents
-Available providers: anthropic (Claude), openai (GPT), groq (Llama), gemini (Gemini), xai (Grok), together, fireworks, ollama (local).
-Use list_providers to see which have API keys configured.
-Be concise and action-oriented. Confirm what you did after taking actions. Use markdown formatting.`,
+        system_prompt: `You are the Apteva Assistant, an AI that manages the Apteva agent platform. You have full control over the platform via your tools.
+WHAT YOU CAN DO:
+- **Agents**: Create, configure, start, stop, and delete AI agents
+- **Projects**: Create projects and organize agents into them
+- **MCP Servers**: Add tool integrations (HTTP, npm, pip) and assign them to agents
+- **Skills**: List, enable/disable, and assign skills to agents
+- **Providers**: Check which LLM providers have API keys configured
+- **Communication**: Send messages to running agents
+WORKFLOW FOR CREATING AGENTS:
+1. Use list_providers to check which providers have API keys
+2. Use create_agent with a provider that has a key, pick a model, write a good system prompt
+3. Optionally assign MCP servers (for tools) and skills (for behavior)
+4. Use start_agent to run it
+AGENT FEATURES (enable when creating/updating):
+- **memory**: Persistent memory across conversations (needs OpenAI key for embeddings)
+- **tasks**: Scheduling and task tracking
+- **vision**: Image and PDF understanding
+- **mcp**: Required if assigning MCP servers — gives the agent tool-use capability
+- **files**: File read/write in agent workspace
+ALWAYS use your tools proactively. When a user says "create an agent", don't explain how — just do it. Confirm what you did after.
+Be concise. Use markdown formatting.`,
         features: {
           memory: false,
           tasks: false,

package/src/web/components/meta-agent/MetaAgent.tsx CHANGED Viewed

@@ -1,6 +1,6 @@
-import React, { useState, useEffect, createContext, useContext, type ReactNode } from "react";
+import React, { useState, useEffect, useMemo, createContext, useContext, type ReactNode } from "react";
 import { Chat } from "@apteva/apteva-kit";
-import { useAuth } from "../../context";
+import { useAuth, useProjects } from "../../context";
 interface MetaAgentStatus {
   enabled: boolean;
@@ -129,10 +129,24 @@ export function MetaAgentButton() {
 // Chat panel component - renders as a right-side drawer
 export function MetaAgentPanel() {
   const ctx = useMetaAgent();
+  const { currentProjectId, currentProject } = useProjects();
   if (!ctx?.isAvailable || !ctx.isOpen) return null;
   const { agent, isRunning, error, isStarting, startAgent, close } = ctx;
+  // Build context string for the meta agent
+  const chatContext = useMemo(() => {
+    const parts: string[] = [];
+    if (currentProject) {
+      parts.push(`Current project: "${currentProject.name}" (id: ${currentProject.id})`);
+    } else if (currentProjectId === "unassigned") {
+      parts.push("Viewing: unassigned agents (no project)");
+    } else {
+      parts.push("Viewing: All Projects");
+    }
+    return parts.join("\n");
+  }, [currentProjectId, currentProject]);
   return (
     <>
       {/* Backdrop */}
@@ -166,6 +180,7 @@ export function MetaAgentPanel() {
               placeholder="Ask me anything about Apteva..."
               variant="terminal"
               showHeader={false}
+              context={chatContext}
             />
           ) : (
             <div className="flex-1 flex flex-col items-center justify-center p-6 text-center">