agentstudio 0.3.0 → 0.3.1

package/backend/src/types/plugins.ts

@@ -0,0 +1,157 @@
+/**
+ * Plugin System Types
+ * Based on Claude Code plugin specification
+ * Storage: ~/.claude/plugins/marketplaces/
+ */
+
+export interface PluginAuthor {
+  name: string;
+  email?: string;
+  url?: string;
+}
+
+export interface PluginManifest {
+  name: string;
+  version: string;
+  description: string;
+  author: PluginAuthor;
+  repository?: string;
+  homepage?: string;
+  license?: string;
+  keywords?: string[];
+}
+
+export interface PluginComponent {
+  type: 'command' | 'agent' | 'skill' | 'hook' | 'mcp';
+  name: string;
+  path: string;
+  relativePath: string;
+  description?: string;
+}
+
+export interface ParsedPlugin {
+  manifest: PluginManifest;
+  components: {
+    commands: PluginComponent[];
+    agents: PluginComponent[];
+    skills: PluginComponent[];
+    hooks: PluginComponent[];
+    mcpServers: PluginComponent[];
+  };
+  files: PluginFile[];
+  path: string;
+  marketplaceName: string;
+  pluginName: string;
+}
+
+export interface PluginFile {
+  path: string;
+  relativePath: string;
+  type: 'file' | 'directory';
+  size?: number;
+}
+
+export interface InstalledPlugin {
+  id: string; // format: pluginName@marketplaceName
+  name: string;
+  version: string;
+  marketplace: string; // marketplace display name
+  marketplaceName: string; // marketplace directory name
+  enabled: boolean;
+  installedAt: string;
+  updatedAt?: string;
+  manifest: PluginManifest;
+  components: {
+    commands: string[];
+    agents: string[];
+    skills: string[];
+    hooks: string[];
+    mcpServers: string[];
+  };
+  installPath: string; // Full path to plugin directory
+  symlinkCreated: boolean; // Whether symlinks are created
+}
+
+export interface PluginMarketplace {
+  id: string;
+  name: string; // Directory name
+  displayName: string; // Human readable name
+  type: 'git' | 'github' | 'local';
+  source: string; // URL for git/github, path for local
+  description?: string;
+  path: string; // Full path to marketplace directory
+  pluginCount: number;
+  lastSync?: string;
+  owner?: {
+    name: string;
+    url?: string;
+  };
+  branch?: string; // For git repositories
+}
+
+export interface MarketplaceManifest {
+  name: string;
+  owner: {
+    name: string;
+    url?: string;
+  };
+  description?: string;
+  plugins: MarketplacePlugin[];
+}
+
+export interface MarketplacePlugin {
+  name: string;
+  source: string;
+  description?: string;
+  version?: string;
+}
+
+export interface AvailablePlugin {
+  name: string;
+  version: string;
+  description: string;
+  author: PluginAuthor;
+  marketplace: string; // marketplace display name
+  marketplaceName: string; // marketplace directory name
+  marketplaceId: string;
+  source: string;
+  installed: boolean;
+  installedVersion?: string;
+  enabled?: boolean;
+  components: {
+    commands: number;
+    agents: number;
+    skills: number;
+    hooks: number;
+    mcpServers: number;
+  };
+  readme?: string;
+}
+
+export interface PluginInstallRequest {
+  pluginName: string;
+  marketplaceId: string;
+  marketplaceName: string;
+}
+
+export interface PluginInstallResult {
+  success: boolean;
+  plugin?: InstalledPlugin;
+  error?: string;
+  message?: string;
+}
+
+export interface MarketplaceAddRequest {
+  name: string;
+  type: 'git' | 'github' | 'local';
+  source: string;
+  description?: string;
+  branch?: string;
+}
+
+export interface MarketplaceSyncResult {
+  success: boolean;
+  pluginCount?: number;
+  error?: string;
+  syncedAt: string;
+}

package/backend/src/types/projects.ts

@@ -0,0 +1,64 @@
+// Project metadata types for the new project management system
+
+export interface ProjectAgentConfig {
+  enabled: boolean;
+  lastUsed: string;
+  sessionCount: number;
+  customConfig: Record<string, any>;
+}
+
+export interface ProjectSkillConfig {
+  enabled: boolean;
+  lastUsed: string;
+  usageCount: number;
+  customConfig: Record<string, any>;
+}
+
+export interface ProjectMetadata {
+  id: string;
+  name: string;
+  description?: string;
+  path: string;
+  createdAt: string;
+  lastAccessed: string;
+  
+  // Agent associations
+  agents: Record<string, ProjectAgentConfig>;
+  defaultAgent: string;
+  
+  // Skill associations
+  skills: Record<string, ProjectSkillConfig>;
+  
+  // Model/Provider configuration
+  defaultProviderId?: string;  // Default Claude version/provider for this project
+  defaultModel?: string;       // Default model for this project
+  
+  // Simplified metadata
+  tags: string[];
+  metadata: Record<string, any>; // User-defined custom attributes
+}
+
+export interface ProjectWithAgentInfo {
+  id: string;
+  name: string;
+  dirName: string;        // Directory name under ~/.claude/projects
+  path: string;
+  realPath?: string;      // Real project path from session files
+  description?: string;
+  createdAt: string;
+  lastAccessed: string;
+  
+  // Agent information
+  agents: string[];       // List of enabled agent IDs
+  defaultAgent: string;
+  defaultAgentName: string;
+  defaultAgentIcon: string;
+  
+  // Model/Provider configuration
+  defaultProviderId?: string;  // Default Claude version/provider for this project
+  defaultModel?: string;       // Default model for this project
+  
+  // Metadata
+  tags: string[];
+  metadata: Record<string, any>;
+}

package/backend/src/types/scheduledTasks.ts

@@ -0,0 +1,214 @@
+/**
+ * Scheduled Tasks Types
+ * 
+ * Type definitions for scheduled task management.
+ * Scheduled tasks allow agents to be triggered automatically
+ * based on time intervals or cron expressions.
+ */
+
+/**
+ * Schedule configuration for a task
+ */
+export interface TaskSchedule {
+  /**
+   * Type of schedule
+   * - 'interval': Execute every N minutes
+   * - 'cron': Execute based on cron expression
+   * - 'once': Execute once at a specific time
+   */
+  type: 'interval' | 'cron' | 'once';
+
+  /**
+   * Interval in minutes (for 'interval' type)
+   * e.g., 30 = every 30 minutes
+   */
+  intervalMinutes?: number;
+
+  /**
+   * Cron expression (for 'cron' type)
+   * Examples: "0 9 * * *" (every day at 9:00 AM)
+   */
+  cronExpression?: string;
+
+  /**
+   * ISO 8601 timestamp for one-time execution (for 'once' type)
+   * Examples: "2026-01-05T14:30:00.000Z"
+   */
+  executeAt?: string;
+}
+
+/**
+ * Status of a scheduled task execution
+ */
+export type TaskRunStatus = 'running' | 'success' | 'error' | 'stopped';
+
+/**
+ * Model override configuration for scheduled tasks
+ */
+export interface ModelOverride {
+  /** Claude version/supplier ID to use (optional, uses agent default if not specified) */
+  versionId?: string;
+  /** Model ID to use (e.g., 'sonnet', 'opus') */
+  modelId?: string;
+}
+
+/**
+ * Scheduled task configuration
+ */
+export interface ScheduledTask {
+  /** Unique task identifier */
+  id: string;
+
+  /** Human-readable task name */
+  name: string;
+
+  /** Optional task description */
+  description?: string;
+
+  /** Target agent ID to execute */
+  agentId: string;
+
+  /** Project path for agent execution context */
+  projectPath: string;
+
+  /** Schedule configuration */
+  schedule: TaskSchedule;
+
+  /** Message to send to the agent when triggered */
+  triggerMessage: string;
+
+  /** Whether the task is enabled */
+  enabled: boolean;
+
+  /** Model override configuration (optional) */
+  modelOverride?: ModelOverride;
+
+  /** ISO 8601 timestamp of last execution */
+  lastRunAt?: string;
+
+  /** Status of last execution */
+  lastRunStatus?: TaskRunStatus;
+
+  /** Error message from last execution (if failed) */
+  lastRunError?: string;
+
+  /** ISO 8601 timestamp of next scheduled execution */
+  nextRunAt?: string;
+
+  /** ISO 8601 timestamp of creation */
+  createdAt: string;
+
+  /** Task timeout in milliseconds (optional) */
+  timeoutMs?: number;
+
+  /** Maximum number of turns for agent execution (optional) */
+  maxTurns?: number;
+
+
+  /** ISO 8601 timestamp of last update */
+  updatedAt: string;
+}
+
+/**
+ * Task execution history record
+ */
+export interface TaskExecution {
+  /** Unique execution identifier */
+  id: string;
+
+  /** Task ID that was executed */
+  taskId: string;
+
+  /** ISO 8601 timestamp of execution start */
+  startedAt: string;
+
+  /** ISO 8601 timestamp of execution completion */
+  completedAt?: string;
+
+  /** Execution status */
+  status: TaskRunStatus;
+
+  /** Error message (if failed) */
+  error?: string;
+
+  /** Full error stack trace (if failed) */
+  errorStack?: string;
+
+  /** Summary of agent response */
+  responseSummary?: string;
+
+  /** Session ID from agent execution */
+  sessionId?: string;
+
+  /** Full execution logs (Claude messages, tool calls, etc.) */
+  logs?: ExecutionLogEntry[];
+
+  /** Agent ID used for this execution (for "continue chat" functionality) */
+  agentId?: string;
+
+  /** Project path used for this execution (for "continue chat" functionality) */
+  projectPath?: string;
+}
+
+/**
+ * Log entry for task execution
+ */
+export interface ExecutionLogEntry {
+  /** ISO 8601 timestamp */
+  timestamp: string;
+  
+  /** Log level */
+  level: 'info' | 'debug' | 'warn' | 'error';
+  
+  /** Message type (e.g., 'assistant', 'tool_use', 'tool_result', 'system') */
+  type: string;
+  
+  /** Log message content */
+  message: string;
+  
+  /** Optional additional data */
+  data?: Record<string, unknown>;
+}
+
+/**
+ * Request body for creating a new scheduled task
+ */
+export interface CreateScheduledTaskRequest {
+  name: string;
+  description?: string;
+  agentId: string;
+  projectPath: string;
+  schedule: TaskSchedule;
+  triggerMessage: string;
+  enabled?: boolean;
+  modelOverride?: ModelOverride;
+}
+
+/**
+ * Request body for updating a scheduled task
+ */
+export interface UpdateScheduledTaskRequest {
+  name?: string;
+  description?: string;
+  agentId?: string;
+  projectPath?: string;
+  schedule?: TaskSchedule;
+  triggerMessage?: string;
+  enabled?: boolean;
+  modelOverride?: ModelOverride;
+}
+
+/**
+ * Scheduler service configuration
+ */
+export interface SchedulerConfig {
+  /** Maximum number of concurrent task executions */
+  maxConcurrent: number;
+}
+
+/**
+ * Default scheduler configuration
+ */
+export const DEFAULT_SCHEDULER_CONFIG: SchedulerConfig = {
+  maxConcurrent: 20,
+};

package/backend/src/types/skills.ts

@@ -0,0 +1,130 @@
+// ============================================
+// Core Skill Types
+// ============================================
+
+// Agent Skills configuration
+export interface SkillConfig {
+  id: string;
+  name: string;
+  description: string;
+  version?: string;
+  
+  // Skill metadata
+  author?: string;
+  homepage?: string;
+  tags: string[];
+  
+  // Content files
+  files: SkillFile[];
+  
+  // Tool permissions
+  allowedTools?: string[];
+  
+  // Scope and visibility
+  scope: 'user' | 'project';
+  projectId?: string; // Only for project skills
+  
+  // Source: 'local' for user-created skills, 'plugin' for plugin-installed skills
+  source: 'local' | 'plugin';
+  
+  // Installation path (real path for symlinked plugin skills)
+  installPath?: string;
+  
+  // Status and metadata
+  enabled: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface SkillFile {
+  path: string; // Relative path within skill directory
+  name: string; // Display name
+  type: 'markdown' | 'text' | 'script' | 'template' | 'other';
+  content?: string; // Optional inline content for small files
+  required: boolean; // Whether this file is required for the skill to work
+}
+
+export interface SkillManifest {
+  name: string;
+  description: string;
+  allowedTools?: string[];
+}
+
+// ============================================
+// API Request/Response Types
+// ============================================
+
+export interface CreateSkillRequest {
+  name: string;
+  description: string;
+  scope: 'user' | 'project';
+  projectId?: string;
+  allowedTools?: string[];
+  content: string; // SKILL.md content
+  additionalFiles?: Array<{
+    name: string;
+    path: string;
+    type: 'markdown' | 'text' | 'script' | 'template' | 'other';
+    content: string;
+  }>;
+}
+
+export interface UpdateSkillRequest {
+  name?: string;
+  description?: string;
+  allowedTools?: string[];
+  content?: string; // SKILL.md content
+  additionalFiles?: Array<{
+    name: string;
+    path: string;
+    type: 'markdown' | 'text' | 'script' | 'template' | 'other';
+    content: string;
+  }>;
+}
+
+export interface SkillValidationResult {
+  valid: boolean;
+  errors: Array<{
+    field: string;
+    message: string;
+    line?: number;
+  }>;
+  warnings: Array<{
+    field: string;
+    message: string;
+  }>;
+}
+
+// ============================================
+// File System Types
+// ============================================
+
+export interface SkillFileInfo {
+  path: string;
+  size: number;
+  lastModified: string;
+  type: 'file' | 'directory';
+}
+
+export interface SkillDirectoryInfo {
+  skillId: string;
+  path: string;
+  files: SkillFileInfo[];
+  totalSize: number;
+  lastModified: string;
+}
+
+// ============================================
+// Backend Storage Types
+// ============================================
+
+export interface SkillStorageOptions {
+  validateManifest?: boolean;
+  autoBackup?: boolean;
+}
+
+export interface SkillValidationOptions {
+  strictMode?: boolean;
+  checkFileExists?: boolean;
+  validateSyntax?: boolean;
+}

package/backend/src/types/slack.ts

@@ -0,0 +1,112 @@
+/**
+ * Slack Integration Types
+ *
+ * Type definitions for Slack Bot integration with AgentStudio
+ */
+
+// Slack File types
+export interface SlackFile {
+  id: string;
+  name: string;
+  title: string;
+  mimetype: string;
+  filetype: string;
+  size: number;
+  url_private: string;
+  url_private_download: string;
+  thumb_360?: string;
+  thumb_480?: string;
+  thumb_720?: string;
+  thumb_960?: string;
+  thumb_1024?: string;
+}
+
+// Slack Event types
+export interface SlackMessageEvent {
+  type: 'message';
+  channel: string;
+  user: string;
+  text: string;
+  ts: string;
+  thread_ts?: string;
+  event_ts: string;
+  channel_type: 'channel' | 'im' | 'mpim' | 'group';
+  files?: SlackFile[];
+}
+
+export interface SlackAppMentionEvent {
+  type: 'app_mention';
+  channel: string;
+  user: string;
+  text: string;
+  ts: string;
+  thread_ts?: string;
+  event_ts: string;
+  files?: SlackFile[];
+}
+
+export interface SlackEventCallback {
+  token: string;
+  team_id: string;
+  api_app_id: string;
+  event: SlackMessageEvent | SlackAppMentionEvent;
+  type: 'event_callback';
+  event_id: string;
+  event_time: number;
+  authorizations?: Array<{
+    enterprise_id: string | null;
+    team_id: string;
+    user_id: string;
+    is_bot: boolean;
+  }>;
+}
+
+export interface SlackUrlVerificationPayload {
+  token: string;
+  challenge: string;
+  type: 'url_verification';
+}
+
+export type SlackWebhookPayload = SlackEventCallback | SlackUrlVerificationPayload;
+
+// Slack API Response types
+export interface SlackMessageResponse {
+  ok: boolean;
+  channel: string;
+  ts: string;
+  message?: {
+    text: string;
+    username?: string;
+    bot_id?: string;
+    type: string;
+    subtype?: string;
+    ts: string;
+  };
+  error?: string;
+}
+
+// Thread to Session mapping
+export interface ThreadSessionMapping {
+  threadTs: string;
+  sessionId: string;
+  channel: string;
+  agentId: string;
+  projectId?: string;        // Project directory name
+  projectPath?: string;      // Full project path
+  createdAt: number;
+  lastActivity: number;
+}
+
+// Project parsing result
+export interface ProjectParseResult {
+  projectIdentifier: string;  // The identifier after "proj:"
+  cleanText: string;         // Text with project specification removed
+}
+
+// Slack Bot Configuration
+export interface SlackBotConfig {
+  botToken: string;
+  signingSecret: string;
+  appToken?: string;
+  defaultAgentId: string;
+}

package/backend/src/types/streaming.ts

@@ -0,0 +1,13 @@
+/**
+ * Communication channel for AI chat requests
+ * Determines streaming granularity:
+ * - 'web': Fine-grained character-by-character streaming
+ * - 'slack': Block-based streaming (existing behavior)
+ */
+export type ChannelType = 'web' | 'slack';
+
+/**
+ * Default channel when not specified (web for backward compatibility)
+ */
+export const DEFAULT_CHANNEL: ChannelType = 'web';
+

package/backend/src/types/subagents.ts

@@ -0,0 +1,29 @@
+// Subagent type definitions (backend only)
+export interface Subagent {
+  id: string;
+  name: string;
+  description: string;
+  content: string; // System prompt content
+  scope: 'user' | 'project'; // Support both user-level and project-level subagents
+  tools?: string[]; // Array of allowed tools
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface SubagentCreate {
+  name: string;
+  description: string;
+  content: string;
+  scope: 'user' | 'project';
+  tools?: string[];
+}
+
+export interface SubagentUpdate {
+  description?: string;
+  content?: string;
+  tools?: string[];
+}
+
+export interface SubagentFilter {
+  search?: string;
+}