@majkapp/plugin-kit 3.5.4 → 3.5.5

package/README.md

@@ -365,6 +365,7 @@ The main MAJK API:
 
 ```typescript
 interface MajkInterface {
+  ai: AIAPI;              // AI providers and LLMs
   conversations: ConversationAPI;
   todos: TodoAPI;
   projects: ProjectAPI;
@@ -379,6 +380,72 @@ interface MajkInterface {
 }
 ```
 
+### AI API
+
+Access AI providers and language models:
+
+```typescript
+// Get the default LLM
+const llm = ctx.majk.ai.getDefaultLLM();
+
+// Send a prompt
+const result = await llm.prompt({
+  messages: [
+    { role: 'system', content: 'You are a helpful assistant' },
+    { role: 'user', content: 'What is 2+2?' }
+  ],
+  temperature: 0.7,
+  maxTokens: 100
+});
+
+console.log(result.content); // "4"
+
+// Stream responses
+const stream = llm.promptStream({
+  messages: [{ role: 'user', content: 'Tell me a story' }]
+});
+
+for await (const chunk of stream) {
+  if (chunk.type === 'content_delta') {
+    process.stdout.write(chunk.content);
+  }
+}
+
+// List available providers
+const providers = ctx.majk.ai.listProviders();
+console.log(`Available: ${providers.map(p => p.name).join(', ')}`);
+
+// Get specific provider
+const bedrock = ctx.majk.ai.getProvider('bedrock');
+if (bedrock) {
+  const claude = bedrock.getLLM('anthropic.claude-3-5-sonnet-20241022-v2:0');
+  // Use Claude...
+}
+
+// Query by capability
+const imageProviders = ctx.majk.ai.getProvidersWithCapability('imageGeneration');
+if (imageProviders.length > 0) {
+  const image = await imageProviders[0].generateImage({
+    prompt: 'A beautiful sunset over mountains'
+  });
+}
+```
+
+**Key Features:**
+- **Provider-agnostic**: Works with OpenAI, Anthropic, Bedrock, local models, etc.
+- **Streaming support**: Real-time response streaming
+- **Function calling**: LLM can invoke functions
+- **Structured output**: JSON schema enforcement
+- **Advanced capabilities**: Image generation, embeddings, transcription
+- **Capability discovery**: Query providers by features
+
+**Use Cases:**
+- Add AI features to your plugin
+- Create AI-powered tools
+- Build custom AI workflows
+- Integrate multiple AI providers
+- Generate content, analyze data, summarize text
+
 ### PluginStorage
 
 Simple key-value storage scoped to your plugin:

package/bin/promptable-cli.js

@@ -64,6 +64,12 @@ cli.addCommand('--teammates',
   { description: 'AI teammates and agents' }
 );
 
+// AI API
+cli.addCommand('--ai',
+  cli.createFullDocCommand('AI.md'),
+  { description: 'AI providers and LLMs' }
+);
+
 // Lifecycle hooks
 cli.addCommand('--lifecycle',
   cli.createFullDocCommand('LIFECYCLE.md'),

package/dist/index.d.ts

@@ -19,5 +19,5 @@ export { FunctionRegistryImpl, FunctionProviderImpl } from './registry';
 export { FilesystemResourceProvider } from './resource-provider';
 export { generateClient } from './generator/generator';
 export type { PluginContext, PluginLogger, PluginStorage, ScopedTimers, ScopedIpcRegistry, PluginCapabilities, PluginCapability, ToolImplementation, InProcessPlugin, PluginHealthStatus, ToolSpec, ToolHandler, ApiMethod, ApiRouteDef, JsonSchema, RouteHandler, RequestLike, ResponseLike, UiConfig, HistoryMode, ScreenBase, ReactScreen, HtmlScreen, ConfigWizardDef, SettingsDef, Scope, EntityType, CleanupFn, HealthCheckFn, MCPServerEntity, TeamMemberEntity, ServiceFunctionBinding, FunctionHandler, SubscriptionHandler, FunctionDefinition, SubscriptionDefinition, FunctionRegistry, ClientGenerationConfig, Plugin, FunctionProvider, ResourceProvider, FunctionInfo, AsyncPluginHealthStatus, ServiceCapability, ServiceMetadata, ServiceFunctionMetadata, ServiceParameterMetadata, ServiceReturnMetadata, FunctionEnrichment, IdentityDefinitionCapability, IdentityProviderInfo, IdentitySetupInstructions, IdentityTestConfig, IdentityRequirement } from './types';
-export type { MajkInterface, EntityId, Unsubscribe, BaseEntity, StandardEventType, PluginEventType, RepositoryEventType, EntityType as MajkEntityType, RepositoryEvent, EventFilter, EventListener, Subscription, QueryBuilder, QueryableEventChannel, EventBusAPI, PluginInfo, PluginHealth, PluginCapabilityInfo, PluginLog, InstallPluginOptions, InstallPluginResult, GetLogsOptions, PluginManagementAPI, SecretScope, SecretInfo, ScopedSecretsAPI, SecretsAPI, StartTaskRequest, TaskFilter, TaskMessage, TaskProgress, TaskResult, TaskError, TaskHandle, TaskEventHandler, TaskEvent, TaskAPI, AccountType, AccountMetadata, TimeWindow, CredentialOptions, RefreshOptions, RefreshResult, ValidationResult, TokenInfo, AutoRefreshConfig, AutoRefreshHandle, AwsSdkCredentials, CognitoTokenSet, AzureSdkCredentials, AccountJSON, AwsCognitoCredentials, AzureEntraCredentials, ApiKeyCredentials, SystemDefaultCredentials, Credentials, SystemAccount, OAuthAccount, AwsAccount, AzureAccount, AuthEvent, AuthStateChangeEvent, AuthTokenRefreshedEvent, AuthErrorEvent, AccountChangedEvent, AuthAPI, Message, Conversation, Agent, TeamMember, TeamMemberSkills, TeamMemberPersonality, TeamMemberCodeStats, TeamMemberMetadata, ServiceFunctionBinding as MajkServiceFunctionBinding, Todo, WorkStrategy, Project, MCPServer, ConversationFilter, MessageQueryOptions, ConversationHandle, ConversationAPI, CreateTeammateRequest, TeammateUpdate, TeammateFilter, TeammateHandle, TeammateAPI, CreateTodoRequest, TodoUpdate, TodoFilter, SpawnOptions, TodoHandle, TodoAPI, CreateProjectRequest, ProjectUpdate, ProjectFilter, ProjectHandle, ProjectAPI, CreateMCPServerRequest, MCPServerUpdate, MCPServerFilter, ConnectionTestResult, MCPServerHandle, MCPServerScopedHandle, DiscoveredTool, MCPServerAPI, EverywhereScope, EverywhereScopedHandle, CreateAgentRequest, AgentUpdate, AgentFilter, TestResult, AgentHandle, AgentAPI, AddKnowledgeInput, KnowledgeNode, KnowledgeTree, KnowledgeSearchOptions, KnowledgeAPI } from './majk-interface-types';
+export type { MajkInterface, EntityId, Unsubscribe, BaseEntity, StandardEventType, PluginEventType, RepositoryEventType, EntityType as MajkEntityType, RepositoryEvent, EventFilter, EventListener, Subscription, QueryBuilder, QueryableEventChannel, EventBusAPI, PluginInfo, PluginHealth, PluginCapabilityInfo, PluginLog, InstallPluginOptions, InstallPluginResult, GetLogsOptions, PluginManagementAPI, SecretScope, SecretInfo, ScopedSecretsAPI, SecretsAPI, StartTaskRequest, TaskFilter, TaskMessage, TaskProgress, TaskResult, TaskError, TaskHandle, TaskEventHandler, TaskEvent, TaskAPI, AccountType, AccountMetadata, TimeWindow, CredentialOptions, RefreshOptions, RefreshResult, ValidationResult, TokenInfo, AutoRefreshConfig, AutoRefreshHandle, AwsSdkCredentials, CognitoTokenSet, AzureSdkCredentials, AccountJSON, AwsCognitoCredentials, AzureEntraCredentials, ApiKeyCredentials, SystemDefaultCredentials, Credentials, SystemAccount, OAuthAccount, AwsAccount, AzureAccount, AuthEvent, AuthStateChangeEvent, AuthTokenRefreshedEvent, AuthErrorEvent, AccountChangedEvent, AuthAPI, Message, Conversation, Agent, TeamMember, TeamMemberSkills, TeamMemberPersonality, TeamMemberCodeStats, TeamMemberMetadata, ServiceFunctionBinding as MajkServiceFunctionBinding, Todo, WorkStrategy, Project, MCPServer, ConversationFilter, MessageQueryOptions, ConversationHandle, ConversationAPI, CreateTeammateRequest, TeammateUpdate, TeammateFilter, TeammateHandle, TeammateAPI, CreateTodoRequest, TodoUpdate, TodoFilter, SpawnOptions, TodoHandle, TodoAPI, CreateProjectRequest, ProjectUpdate, ProjectFilter, ProjectHandle, ProjectAPI, CreateMCPServerRequest, MCPServerUpdate, MCPServerFilter, ConnectionTestResult, MCPServerHandle, MCPServerScopedHandle, DiscoveredTool, MCPServerAPI, EverywhereScope, EverywhereScopedHandle, CreateAgentRequest, AgentUpdate, AgentFilter, TestResult, AgentHandle, AgentAPI, AddKnowledgeInput, KnowledgeNode, KnowledgeTree, KnowledgeSearchOptions, KnowledgeAPI, AIAPI, AIProvider, AIProviderCapabilities, AIProviderError, LLMInterface, ModelInfo, AIMessage, ContentBlock, PromptParams, PromptResult, PromptChunk, AIFunctionDefinition, AIJsonSchema, FunctionCallParams, FunctionCallResult, ImageGenerationParams, ImageResult, TranscriptionParams, TranscriptionResult, ProviderStatus } from './majk-interface-types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/majk-interface-types.d.ts

@@ -1021,6 +1021,385 @@ export interface KnowledgeAPI {
     getTree(conversationId: string, treeName: string): Promise<KnowledgeTree>;
     listTrees(conversationId: string): Promise<string[]>;
 }
+/**
+ * Capabilities that an AI provider may support.
+ * Providers declare which capabilities they implement.
+ */
+export interface AIProviderCapabilities {
+    /** Core language model prompting */
+    llm: boolean;
+    /** Image generation (DALL-E, Stable Diffusion, etc.) */
+    imageGeneration?: boolean;
+    /** Text embeddings for semantic search */
+    embeddings?: boolean;
+    /** Audio transcription (Whisper, etc.) */
+    audioTranscription?: boolean;
+    /** Function/tool calling support */
+    functionCalling?: boolean;
+    /** Structured JSON output with schema enforcement */
+    structuredOutput?: boolean;
+    /** Streaming response support */
+    streaming?: boolean;
+}
+/**
+ * Information about an AI model
+ */
+export interface ModelInfo {
+    /** Model identifier (e.g., "gpt-4", "claude-3-opus") */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Model description */
+    description?: string;
+    /** Context window size in tokens */
+    contextWindow?: number;
+    /** Supported capabilities */
+    capabilities?: Partial<AIProviderCapabilities>;
+    /** Pricing information (optional) */
+    pricing?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+/**
+ * Message in a conversation with an LLM
+ */
+export interface AIMessage {
+    /** Role of the message sender */
+    role: 'system' | 'user' | 'assistant';
+    /** Message content (string or structured blocks) */
+    content: string | ContentBlock[];
+    /** Optional message name (for function calls) */
+    name?: string;
+}
+/**
+ * Structured content block (images, tool use, etc.)
+ */
+export interface ContentBlock {
+    /** Type of content */
+    type: 'text' | 'image' | 'tool_use' | 'tool_result';
+    /** Block-specific data */
+    [key: string]: any;
+}
+/**
+ * Parameters for LLM prompting
+ */
+export interface PromptParams {
+    /** Conversation messages */
+    messages: AIMessage[];
+    /** Sampling temperature (0-1, higher = more random) */
+    temperature?: number;
+    /** Maximum tokens to generate */
+    maxTokens?: number;
+    /** Stop sequences */
+    stopSequences?: string[];
+    /** Top-p sampling */
+    topP?: number;
+    /** System prompt override (if not in messages) */
+    system?: string;
+    /** Provider-specific metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Result from an LLM prompt
+ */
+export interface PromptResult {
+    /** Generated text content */
+    content: string;
+    /** Structured content blocks (if any) */
+    contentBlocks?: ContentBlock[];
+    /** Stop reason */
+    stopReason?: 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use';
+    /** Token usage information */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    /** Provider-specific metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Streaming chunk from an LLM
+ */
+export interface PromptChunk {
+    /** Chunk type */
+    type: 'content_start' | 'content_delta' | 'content_end' | 'message_start' | 'message_end';
+    /** Partial content (for delta chunks) */
+    content?: string;
+    /** Content block (for structured content) */
+    contentBlock?: ContentBlock;
+    /** Final message (for message_end) */
+    message?: PromptResult;
+}
+/**
+ * Function definition for function calling
+ */
+export interface AIFunctionDefinition {
+    /** Function name */
+    name: string;
+    /** Function description */
+    description: string;
+    /** Parameter schema (JSON Schema) */
+    parameters: AIJsonSchema;
+}
+/**
+ * JSON Schema for structured output
+ */
+export interface AIJsonSchema {
+    type: string;
+    properties?: Record<string, any>;
+    required?: string[];
+    [key: string]: any;
+}
+/**
+ * Parameters for function calling
+ */
+export interface FunctionCallParams extends PromptParams {
+    /** Available functions */
+    functions: AIFunctionDefinition[];
+    /** Force a specific function to be called */
+    functionCall?: 'auto' | 'none' | {
+        name: string;
+    };
+}
+/**
+ * Result from a function call
+ */
+export interface FunctionCallResult extends PromptResult {
+    /** Function call details (if model invoked a function) */
+    functionCall?: {
+        name: string;
+        arguments: Record<string, any>;
+    };
+}
+/**
+ * Parameters for image generation
+ */
+export interface ImageGenerationParams {
+    /** Image generation prompt */
+    prompt: string;
+    /** Negative prompt (what to avoid) */
+    negativePrompt?: string;
+    /** Image size */
+    size?: string;
+    /** Number of images to generate */
+    n?: number;
+    /** Quality/detail level */
+    quality?: 'standard' | 'hd';
+    /** Style preset */
+    style?: string;
+    /** Provider-specific parameters */
+    metadata?: Record<string, any>;
+}
+/**
+ * Result from image generation
+ */
+export interface ImageResult {
+    /** Generated image URLs or data URLs */
+    images: string[];
+    /** Revised prompt (if provider modified it) */
+    revisedPrompt?: string;
+    /** Generation metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Parameters for audio transcription
+ */
+export interface TranscriptionParams {
+    /** Audio data buffer */
+    audio: Buffer;
+    /** Audio format */
+    format?: 'mp3' | 'wav' | 'webm' | 'ogg';
+    /** Language hint (ISO 639-1) */
+    language?: string;
+    /** Include timestamps */
+    timestamps?: boolean;
+}
+/**
+ * Result from audio transcription
+ */
+export interface TranscriptionResult {
+    /** Transcribed text */
+    text: string;
+    /** Language detected */
+    language?: string;
+    /** Word-level timestamps (if requested) */
+    timestamps?: Array<{
+        word: string;
+        start: number;
+        end: number;
+    }>;
+    /** Confidence score */
+    confidence?: number;
+}
+/**
+ * Core interface for language model operations.
+ * Represents a specific model from a provider.
+ */
+export interface LLMInterface {
+    /** Provider identifier */
+    readonly provider: string;
+    /** Model identifier */
+    readonly model: string;
+    /**
+     * Send a prompt to the model
+     * @param params - Prompt parameters
+     * @returns Promise resolving to the model's response
+     * @throws AIProviderError if the request fails
+     */
+    prompt(params: PromptParams): Promise<PromptResult>;
+    /**
+     * Send a prompt with streaming response
+     * @param params - Prompt parameters
+     * @returns Async iterator of response chunks
+     * @throws AIProviderError if the request fails
+     */
+    promptStream(params: PromptParams): AsyncIterableIterator<PromptChunk>;
+    /**
+     * Prompt for structured JSON output
+     * @param params - Prompt parameters with optional schema
+     * @returns Promise resolving to parsed JSON
+     * @throws AIProviderError if the request fails or JSON is invalid
+     */
+    promptForJson<T = any>(params: PromptParams & {
+        schema?: AIJsonSchema;
+    }): Promise<T>;
+    /**
+     * Prompt with function calling
+     * @param params - Prompt parameters with function definitions
+     * @returns Promise resolving to response with optional function call
+     * @throws AIProviderError if the request fails
+     */
+    functionCall(params: FunctionCallParams): Promise<FunctionCallResult>;
+}
+/**
+ * Provider health and status information
+ */
+export interface ProviderStatus {
+    /** Is the provider available? */
+    available: boolean;
+    /** Is authentication configured and valid? */
+    authenticated: boolean;
+    /** Rate limit remaining (if applicable) */
+    rateLimitRemaining?: number;
+    /** Last error message (if any) */
+    lastError?: string;
+    /** Last successful request timestamp */
+    lastSuccess?: Date;
+    /** Provider-specific status info */
+    metadata?: Record<string, any>;
+}
+/**
+ * Main AI provider interface.
+ * Plugins implement this to provide AI capabilities.
+ */
+export interface AIProvider {
+    /** Unique provider identifier (e.g., "openai", "anthropic") */
+    readonly id: string;
+    /** Human-readable provider name */
+    readonly name: string;
+    /** Declared capabilities */
+    readonly capabilities: AIProviderCapabilities;
+    /**
+     * Get an LLM interface for a specific model
+     * @param model - Model identifier (optional, uses provider default if omitted)
+     * @returns LLM interface for prompting
+     * @throws AIProviderError if model is not available
+     */
+    getLLM(model?: string): LLMInterface;
+    /**
+     * List available models
+     * @returns Promise resolving to array of model information
+     * @throws AIProviderError if listing fails
+     */
+    listModels(): Promise<ModelInfo[]>;
+    /**
+     * Generate an image (if provider supports it)
+     * @param params - Image generation parameters
+     * @returns Promise resolving to generated images
+     * @throws AIProviderError if not supported or generation fails
+     */
+    generateImage?(params: ImageGenerationParams): Promise<ImageResult>;
+    /**
+     * Generate text embeddings (if provider supports it)
+     * @param text - Text to embed
+     * @returns Promise resolving to embedding vector
+     * @throws AIProviderError if not supported or generation fails
+     */
+    generateEmbedding?(text: string): Promise<number[]>;
+    /**
+     * Transcribe audio (if provider supports it)
+     * @param params - Transcription parameters
+     * @returns Promise resolving to transcription
+     * @throws AIProviderError if not supported or transcription fails
+     */
+    transcribeAudio?(params: TranscriptionParams): Promise<TranscriptionResult>;
+}
+/**
+ * Main AI API exposed via majk.ai
+ * Provides access to registered AI providers and convenience methods.
+ */
+export interface AIAPI {
+    /**
+     * Get a specific AI provider by ID
+     * @param providerId - Provider identifier (e.g., "openai", "anthropic")
+     * @returns Provider instance or undefined if not found
+     */
+    getProvider(providerId: string): AIProvider | undefined;
+    /**
+     * List all registered providers
+     * @returns Array of all available providers
+     */
+    listProviders(): AIProvider[];
+    /**
+     * Get the default AI provider
+     * @returns Default provider
+     * @throws AIProviderError if no providers are registered
+     */
+    getDefaultProvider(): AIProvider;
+    /**
+     * Set the default provider
+     * @param providerId - Provider ID to set as default
+     * @throws AIProviderError if provider not found
+     */
+    setDefaultProvider(providerId: string): Promise<void>;
+    /**
+     * Get an LLM from the default provider
+     * @param model - Optional model identifier
+     * @returns LLM interface using default provider
+     * @throws AIProviderError if no providers registered
+     */
+    getLLM(model?: string): LLMInterface;
+    /**
+     * Get the default LLM (default provider, default model)
+     * @returns LLM interface with all defaults
+     * @throws AIProviderError if no providers registered
+     */
+    getDefaultLLM(): LLMInterface;
+    /**
+     * Get all providers that support a specific capability
+     * @param capability - Capability to filter by
+     * @returns Array of providers supporting the capability
+     */
+    getProvidersWithCapability(capability: keyof AIProviderCapabilities): AIProvider[];
+    /**
+     * Get provider status and health information
+     * @param providerId - Provider to check
+     * @returns Promise resolving to status information
+     */
+    getProviderStatus(providerId: string): Promise<ProviderStatus>;
+}
+/**
+ * Standard error class for AI provider operations
+ */
+export declare class AIProviderError extends Error {
+    readonly providerId?: string | undefined;
+    readonly code?: string | undefined;
+    readonly statusCode?: number | undefined;
+    readonly cause?: Error | undefined;
+    constructor(message: string, providerId?: string | undefined, code?: string | undefined, statusCode?: number | undefined, cause?: Error | undefined);
+}
 export interface MajkInterface {
     readonly version: string;
     readonly plugins: PluginManagementAPI;
@@ -1028,6 +1407,7 @@ export interface MajkInterface {
     readonly tasks: TaskAPI;
     readonly eventBus: EventBusAPI;
     readonly auth: AuthAPI;
+    readonly ai: AIAPI;
     readonly conversations: ConversationAPI;
     readonly todos: TodoAPI;
     readonly projects: ProjectAPI;