@geminilight/mindos 0.6.23 → 0.6.27

package/app/lib/a2a/types.ts

@@ -0,0 +1,212 @@
+/**
+ * A2A Protocol v1.0 — Core Types for MindOS Agent Card & Task handling.
+ * Subset of the full spec: only what's needed for Phase 1 (Server mode).
+ * Reference: https://a2a-protocol.org/latest/specification/
+ */
+
+/* ── Agent Card ────────────────────────────────────────────────────────── */
+
+export interface AgentCard {
+  name: string;
+  description: string;
+  version: string;
+  provider: {
+    organization: string;
+    url: string;
+  };
+  supportedInterfaces: AgentInterface[];
+  capabilities: AgentCapabilities;
+  defaultInputModes: string[];
+  defaultOutputModes: string[];
+  skills: AgentSkill[];
+  securitySchemes?: Record<string, SecurityScheme>;
+  securityRequirements?: Record<string, string[]>[];
+}
+
+export interface AgentInterface {
+  url: string;
+  protocolBinding: 'JSONRPC' | 'GRPC' | 'HTTP_JSON';
+  protocolVersion: string;
+}
+
+export interface AgentCapabilities {
+  streaming: boolean;
+  pushNotifications: boolean;
+  stateTransitionHistory: boolean;
+}
+
+export interface AgentSkill {
+  id: string;
+  name: string;
+  description: string;
+  tags?: string[];
+  examples?: string[];
+  inputModes?: string[];
+  outputModes?: string[];
+}
+
+export interface SecurityScheme {
+  httpAuthSecurityScheme?: {
+    scheme: string;
+    bearerFormat?: string;
+  };
+}
+
+/* ── JSON-RPC ──────────────────────────────────────────────────────────── */
+
+export interface JsonRpcRequest {
+  jsonrpc: '2.0';
+  id: string | number;
+  method: string;
+  params?: Record<string, unknown>;
+}
+
+export interface JsonRpcResponse {
+  jsonrpc: '2.0';
+  id: string | number | null;
+  result?: unknown;
+  error?: JsonRpcError;
+}
+
+export interface JsonRpcError {
+  code: number;
+  message: string;
+  data?: unknown;
+}
+
+/* ── A2A Messages & Tasks ──────────────────────────────────────────────── */
+
+export type TaskState =
+  | 'TASK_STATE_SUBMITTED'
+  | 'TASK_STATE_WORKING'
+  | 'TASK_STATE_INPUT_REQUIRED'
+  | 'TASK_STATE_COMPLETED'
+  | 'TASK_STATE_FAILED'
+  | 'TASK_STATE_CANCELED'
+  | 'TASK_STATE_REJECTED';
+
+export type MessageRole = 'ROLE_USER' | 'ROLE_AGENT';
+
+export interface MessagePart {
+  text?: string;
+  data?: unknown;
+  mediaType?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface A2AMessage {
+  role: MessageRole;
+  parts: MessagePart[];
+  metadata?: Record<string, unknown>;
+}
+
+export interface TaskStatus {
+  state: TaskState;
+  message?: A2AMessage;
+  timestamp: string;
+}
+
+export interface TaskArtifact {
+  artifactId: string;
+  name?: string;
+  description?: string;
+  parts: MessagePart[];
+}
+
+export interface A2ATask {
+  id: string;
+  contextId?: string;
+  status: TaskStatus;
+  artifacts?: TaskArtifact[];
+  history?: A2AMessage[];
+  metadata?: Record<string, unknown>;
+}
+
+/* ── A2A Method Params ─────────────────────────────────────────────────── */
+
+export interface SendMessageParams {
+  message: A2AMessage;
+  configuration?: {
+    acceptedOutputModes?: string[];
+    blocking?: boolean;
+    historyLength?: number;
+  };
+  metadata?: Record<string, unknown>;
+}
+
+export interface GetTaskParams {
+  id: string;
+  historyLength?: number;
+}
+
+export interface CancelTaskParams {
+  id: string;
+}
+
+/* ── Error Codes ───────────────────────────────────────────────────────── */
+
+export const A2A_ERRORS = {
+  TASK_NOT_FOUND: { code: -32001, message: 'Task not found' },
+  TASK_NOT_CANCELABLE: { code: -32002, message: 'Task not cancelable' },
+  UNSUPPORTED_OPERATION: { code: -32004, message: 'Unsupported operation' },
+  CONTENT_TYPE_NOT_SUPPORTED: { code: -32005, message: 'Content type not supported' },
+  PARSE_ERROR: { code: -32700, message: 'Parse error' },
+  INVALID_REQUEST: { code: -32600, message: 'Invalid request' },
+  METHOD_NOT_FOUND: { code: -32601, message: 'Method not found' },
+  INVALID_PARAMS: { code: -32602, message: 'Invalid params' },
+  INTERNAL_ERROR: { code: -32603, message: 'Internal error' },
+} as const;
+
+/* ── A2A Client Types (Phase 2) ────────────────────────────────────────── */
+
+/** A discovered remote agent with its card and endpoint */
+export interface RemoteAgent {
+  /** Unique identifier (derived from agent card URL) */
+  id: string;
+  /** The agent's card metadata */
+  card: AgentCard;
+  /** The JSON-RPC endpoint URL */
+  endpoint: string;
+  /** When this card was last fetched */
+  discoveredAt: string;
+  /** Whether the agent is currently reachable */
+  reachable: boolean;
+}
+
+/* ── Orchestration Types (Phase 3) ─────────────────────────────────────── */
+
+/** A sub-task decomposed from a user request */
+export interface SubTask {
+  id: string;
+  description: string;
+  assignedAgentId: string | null;
+  matchedSkillId: string | null;
+  status: 'pending' | 'running' | 'completed' | 'failed';
+  result: string | null;
+  error: string | null;
+  dependsOn: string[];
+}
+
+/** Execution strategy for sub-tasks */
+export type ExecutionStrategy = 'parallel' | 'sequential' | 'dependency';
+
+/** An orchestration plan produced by the decomposer */
+export interface OrchestrationPlan {
+  id: string;
+  originalRequest: string;
+  strategy: ExecutionStrategy;
+  subtasks: SubTask[];
+  createdAt: string;
+  completedAt: string | null;
+  status: 'planning' | 'executing' | 'completed' | 'failed';
+  aggregatedResult: string | null;
+}
+
+/** Result of matching a sub-task to an agent skill */
+export interface SkillMatch {
+  agentId: string;
+  agentName: string;
+  skillId: string;
+  skillName: string;
+  confidence: number;
+}

package/app/lib/agent/tools.ts

@@ -9,6 +9,7 @@ import {
 } from '@/lib/fs';
 import { readSkillContentByName, scanSkillDirs } from '@/lib/pi-integration/skills';
 import { callMcporterTool, createMcporterAgentTools, listMcporterServers, listMcporterTools } from '@/lib/pi-integration/mcporter';
+import { a2aTools } from '@/lib/a2a/a2a-tools';
 
 // Max chars per file to avoid token overflow (~100k chars ≈ ~25k tokens)
 const MAX_FILE_CHARS = 20_000;
@@ -186,10 +187,11 @@ export function getOrganizeTools(): AgentTool<any>[] {
 }
 
 export async function getRequestScopedTools(): Promise<AgentTool<any>[]> {
+  const baseTools = [...knowledgeBaseTools, ...a2aTools];
   try {
     const result = await listMcporterServers();
     const okServers = (result.servers ?? []).filter((server) => server.status === 'ok');
-    if (okServers.length === 0) return knowledgeBaseTools;
+    if (okServers.length === 0) return baseTools;
 
     const detailedServers = await Promise.all(okServers.map(async (server) => {
       try {
@@ -200,10 +202,10 @@ export async function getRequestScopedTools(): Promise<AgentTool<any>[]> {
     }));
 
     const dynamicMcpTools = createMcporterAgentTools(detailedServers);
-    if (dynamicMcpTools.length === 0) return knowledgeBaseTools;
-    return [...knowledgeBaseTools, ...dynamicMcpTools];
+    if (dynamicMcpTools.length === 0) return baseTools;
+    return [...baseTools, ...dynamicMcpTools];
   } catch {
-    return knowledgeBaseTools;
+    return baseTools;
   }
 }
 

package/app/lib/i18n-en.ts

@@ -241,6 +241,27 @@ export const en = {
       agentDetailPanelAria: 'Agent connection configuration',
       agentDetailTransport: 'Transport',
       agentDetailSnippet: 'Config snippet',
+      // A2A
+      a2aLabel: 'A2A',
+      a2aReady: 'A2A Ready',
+      a2aChecking: 'Checking A2A...',
+      a2aUnavailable: 'A2A Unavailable',
+      a2aRemote: 'Remote',
+      a2aDiscover: 'Discover Remote Agent',
+      a2aDiscoverHint: 'Connect to an external A2A agent by URL',
+      a2aDiscoverPlaceholder: 'https://agent.example.com',
+      a2aDiscovering: 'Discovering...',
+      a2aDiscoverSuccess: 'Agent discovered!',
+      a2aDiscoverFailed: 'No A2A agent found at this URL',
+      a2aDiscoverFailedHint: 'The server may not support the A2A protocol. Check the URL and try again.',
+      a2aSkills: 'Skills',
+      a2aEndpoint: 'Endpoint',
+      a2aVersion: 'Version',
+      a2aCapabilities: 'A2A Capabilities',
+      a2aStatus: 'Status',
+      a2aConnected: 'Connected & A2A Ready',
+      a2aNoRemote: 'No remote agents',
+      a2aNoRemoteHint: 'Discover remote agents to enable cross-agent delegation.',
     },
     plugins: {
       title: 'Plugins',
@@ -1463,4 +1484,35 @@ prompt: "Here's my resume, read it and organize my info into MindOS.",
       ],
     },
   },
+
+  /** Disabled-state and contextual tooltip hints */
+  hints: {
+    noValidFiles: 'No valid files selected',
+    aiOrganizing: 'AI is organizing',
+    importInProgress: 'Import in progress',
+    templateInitializing: 'Another template is being initialized',
+    configureAiKey: 'Configure API key in Settings → AI',
+    syncInProgress: 'Sync already in progress',
+    toggleInProgress: 'Toggle operation in progress',
+    typeMessage: 'Type a message',
+    mentionInProgress: 'Mention or command in progress',
+    cleanupInProgress: 'Cleanup already in progress',
+    tokenResetInProgress: 'Token reset in progress',
+    aiNotConfigured: 'AI not configured or generation in progress',
+    generationInProgress: 'Generation in progress or AI not configured',
+    cannotJumpForward: 'Cannot jump forward in setup',
+    testInProgressOrNoKey: 'Test in progress or no API key',
+    workflowStepRunning: 'Workflow step already running',
+    workflowRunning: 'Workflow step is running',
+    sessionHistory: 'Session history',
+    newSession: 'New session',
+    attachFile: 'Attach local file',
+    maximizePanel: 'Maximize panel',
+    restorePanel: 'Restore panel',
+    dockToSide: 'Dock to side panel',
+    openAsPopup: 'Open as popup',
+    closePanel: 'Close',
+    newChat: 'New chat',
+    closeSession: 'Close session',
+  },
 } as const;

package/app/lib/i18n-zh.ts

@@ -265,6 +265,27 @@ export const zh = {
       agentDetailPanelAria: '智能体连接配置',
       agentDetailTransport: '传输方式',
       agentDetailSnippet: '配置片段',
+      // A2A
+      a2aLabel: 'A2A',
+      a2aReady: 'A2A 就绪',
+      a2aChecking: '检测 A2A 中...',
+      a2aUnavailable: 'A2A 不可用',
+      a2aRemote: '远程',
+      a2aDiscover: '发现远程 Agent',
+      a2aDiscoverHint: '通过 URL 连接外部 A2A Agent',
+      a2aDiscoverPlaceholder: 'https://agent.example.com',
+      a2aDiscovering: '发现中...',
+      a2aDiscoverSuccess: 'Agent 已发现！',
+      a2aDiscoverFailed: '未在此 URL 找到 A2A Agent',
+      a2aDiscoverFailedHint: '该服务器可能不支持 A2A 协议，请检查 URL 后重试。',
+      a2aSkills: '技能',
+      a2aEndpoint: '端点',
+      a2aVersion: '版本',
+      a2aCapabilities: 'A2A 能力',
+      a2aStatus: '状态',
+      a2aConnected: '已连接，A2A 就绪',
+      a2aNoRemote: '无远程 Agent',
+      a2aNoRemoteHint: '发现远程 Agent 以启用跨 Agent 委派。',
     },
     plugins: {
       title: '插件',
@@ -1487,4 +1508,35 @@ prompt: '这是我的简历，读一下，把我的信息整理到 MindOS 里。
       ],
     },
   },
+
+  /** 禁用态和上下文提示文案 */
+  hints: {
+    noValidFiles: '未选择有效文件',
+    aiOrganizing: 'AI 正在整理中',
+    importInProgress: '正在导入',
+    templateInitializing: '正在初始化另一个模板',
+    configureAiKey: '请在 设置 → AI 中配置 API 密钥',
+    syncInProgress: '正在同步中',
+    toggleInProgress: '正在切换中',
+    typeMessage: '请输入消息',
+    mentionInProgress: '正在输入提及或命令',
+    cleanupInProgress: '正在清理中',
+    tokenResetInProgress: '正在重置令牌',
+    aiNotConfigured: 'AI 未配置或正在生成',
+    generationInProgress: '正在生成或 AI 未配置',
+    cannotJumpForward: '无法跳过前序步骤',
+    testInProgressOrNoKey: '正在测试或未配置 API 密钥',
+    workflowStepRunning: '工作流步骤正在运行',
+    workflowRunning: '工作流步骤正在运行',
+    sessionHistory: '会话历史',
+    newSession: '新会话',
+    attachFile: '附加本地文件',
+    maximizePanel: '最大化面板',
+    restorePanel: '还原面板',
+    dockToSide: '停靠到侧边栏',
+    openAsPopup: '弹窗模式',
+    closePanel: '关闭',
+    newChat: '新对话',
+    closeSession: '关闭会话',
+  },
 } as const satisfies Widen<typeof en>;

package/app/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/dev/types/routes.d.ts";
+import "./.next/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.