@23blocks/block-jarvis 3.1.7 → 3.2.0

package/dist/index.esm.js

@@ -2186,7 +2186,15 @@ function createExecutionCommentsService(transport, _config) {
     };
 }
 
-function createJarvisBlock(transport, config) {
+/**
+ * Create the Jarvis block.
+ *
+ * @example
+ * ```typescript
+ * const block = createJarvisBlock(transport, { appId: 'xxx' });
+ * const agents = await block.agents.list({ page: 1 });
+ * ```
+ */ function createJarvisBlock(transport, config) {
     return {
         agents: createAgentsService(transport),
         prompts: createPromptsService(transport),

package/dist/src/lib/jarvis.block.d.ts

@@ -1,28 +1,62 @@
 import type { Transport, BlockConfig, BlockMetadata } from '@23blocks/contracts';
 import { type AgentsService, type PromptsService, type WorkflowsService, type ExecutionsService, type ConversationsService, type AIModelsService, type EntitiesService, type ClustersService, type JarvisUsersService, type WorkflowParticipantsService, type WorkflowStepsService, type WorkflowInstancesService, type AgentRuntimeService, type MailTemplatesService, type MarvinChatService, type PromptCommentsService, type ExecutionCommentsService } from './services/index.js';
+/**
+ * Configuration for the Jarvis block.
+ */
 export interface JarvisBlockConfig extends BlockConfig {
+    /** Application ID */
     appId: string;
+    /** Tenant ID (optional, for multi-tenant setups) */
     tenantId?: string;
 }
+/**
+ * AI agents, prompts, and workflow management block interface.
+ */
 export interface JarvisBlock {
+    /** AI agent management */
     agents: AgentsService;
+    /** Prompt template management */
     prompts: PromptsService;
+    /** Workflow definition management */
     workflows: WorkflowsService;
+    /** Workflow execution tracking */
     executions: ExecutionsService;
+    /** AI conversation management */
     conversations: ConversationsService;
+    /** AI model configuration */
     aiModels: AIModelsService;
+    /** Entity management for AI context */
     entities: EntitiesService;
+    /** Entity cluster management */
     clusters: ClustersService;
+    /** Jarvis user management */
     users: JarvisUsersService;
+    /** Workflow participant management */
     workflowParticipants: WorkflowParticipantsService;
+    /** Workflow step definition management */
     workflowSteps: WorkflowStepsService;
+    /** Workflow instance management */
     workflowInstances: WorkflowInstancesService;
+    /** Agent runtime execution */
     agentRuntime: AgentRuntimeService;
+    /** Mail template management */
     mailTemplates: MailTemplatesService;
+    /** Marvin chat interface */
     marvinChat: MarvinChatService;
+    /** Prompt comment management */
     promptComments: PromptCommentsService;
+    /** Execution comment management */
     executionComments: ExecutionCommentsService;
 }
+/**
+ * Create the Jarvis block.
+ *
+ * @example
+ * ```typescript
+ * const block = createJarvisBlock(transport, { appId: 'xxx' });
+ * const agents = await block.agents.list({ page: 1 });
+ * ```
+ */
 export declare function createJarvisBlock(transport: Transport, config: JarvisBlockConfig): JarvisBlock;
 export declare const jarvisBlockMetadata: BlockMetadata;
 //# sourceMappingURL=jarvis.block.d.ts.map

package/dist/src/lib/jarvis.block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jarvis.block.d.ts","sourceRoot":"","sources":["../../../src/lib/jarvis.block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAkBL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,EAAE,oBAAoB,CAAC;IACpC,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,oBAAoB,EAAE,2BAA2B,CAAC;IAClD,aAAa,EAAE,oBAAoB,CAAC;IACpC,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,YAAY,EAAE,mBAAmB,CAAC;IAClC,aAAa,EAAE,oBAAoB,CAAC;IACpC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,qBAAqB,CAAC;IACtC,iBAAiB,EAAE,wBAAwB,CAAC;CAC7C;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,iBAAiB,GACxB,WAAW,CAoBb;AAED,eAAO,MAAM,mBAAmB,EAAE,aAWjC,CAAC"}
+{"version":3,"file":"jarvis.block.d.ts","sourceRoot":"","sources":["../../../src/lib/jarvis.block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAkBL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,iCAAiC;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,qCAAqC;IACrC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kCAAkC;IAClC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,iCAAiC;IACjC,aAAa,EAAE,oBAAoB,CAAC;IACpC,6BAA6B;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,EAAE,eAAe,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,EAAE,eAAe,CAAC;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,sCAAsC;IACtC,oBAAoB,EAAE,2BAA2B,CAAC;IAClD,0CAA0C;IAC1C,aAAa,EAAE,oBAAoB,CAAC;IACpC,mCAAmC;IACnC,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,8BAA8B;IAC9B,YAAY,EAAE,mBAAmB,CAAC;IAClC,+BAA+B;IAC/B,aAAa,EAAE,oBAAoB,CAAC;IACpC,4BAA4B;IAC5B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,gCAAgC;IAChC,cAAc,EAAE,qBAAqB,CAAC;IACtC,mCAAmC;IACnC,iBAAiB,EAAE,wBAAwB,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,iBAAiB,GACxB,WAAW,CAoBb;AAED,eAAO,MAAM,mBAAmB,EAAE,aAWjC,CAAC"}

package/dist/src/lib/services/agent-runtime.service.d.ts

@@ -1,19 +1,67 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { AgentThread, AgentRun, AgentMessage, AgentContext, CreateAgentThreadRequest, CreateAgentContextRequest, SendAgentThreadMessageRequest, SendAgentThreadMessageResponse, RunAgentThreadRequest, RunAgentThreadResponse, AgentRunExecution, ListAgentRunExecutionsParams } from '../types/agent-runtime.js';
 export interface AgentRuntimeService {
+    /**
+     * Get an existing agent context by unique ID.
+     * @returns The AgentContext with thread and optional conversation data.
+     */
     getContext(agentUniqueId: string, contextUniqueId: string): Promise<AgentContext>;
+    /**
+     * Create a new agent context for conversations.
+     * @returns The newly created AgentContext with thread info.
+     */
     createContext(agentUniqueId: string, data?: CreateAgentContextRequest): Promise<AgentContext>;
+    /**
+     * Get the conversation history for an agent context.
+     * @returns Object containing an array of AgentMessage records.
+     */
     getConversation(agentUniqueId: string, contextUniqueId: string): Promise<{
         messages: AgentMessage[];
     }>;
+    /**
+     * Get an existing agent thread by ID.
+     * @returns The AgentThread record.
+     */
     getThread(agentUniqueId: string, threadId: string): Promise<AgentThread>;
+    /**
+     * Create a new agent thread.
+     * @returns The newly created AgentThread record.
+     */
     createThread(agentUniqueId: string, data?: CreateAgentThreadRequest): Promise<AgentThread>;
+    /**
+     * Send a message to an agent thread.
+     * @returns SendAgentThreadMessageResponse with the sent message.
+     */
     sendMessage(agentUniqueId: string, threadId: string, data: SendAgentThreadMessageRequest): Promise<SendAgentThreadMessageResponse>;
+    /**
+     * Send a message to an agent thread and receive a streaming response.
+     * @returns ReadableStream of string chunks for real-time output.
+     */
     sendMessageStream(agentUniqueId: string, threadId: string, data: SendAgentThreadMessageRequest): Promise<ReadableStream<string>>;
+    /**
+     * Run an agent thread to generate a response.
+     * @returns RunAgentThreadResponse with run details and status.
+     */
     runThread(agentUniqueId: string, threadId: string, data?: RunAgentThreadRequest): Promise<RunAgentThreadResponse>;
+    /**
+     * Get the status and details of an agent run.
+     * @returns The AgentRun record with status and usage info.
+     */
     getRun(agentUniqueId: string, threadId: string, runId: string): Promise<AgentRun>;
+    /**
+     * Get all messages in an agent thread.
+     * @returns Array of AgentMessage records.
+     */
     getMessages(agentUniqueId: string, threadId: string): Promise<AgentMessage[]>;
+    /**
+     * List agent run executions with optional filtering and sorting.
+     * @returns Paginated list of AgentRunExecution records with metadata.
+     */
     listExecutions(agentUniqueId: string, params?: ListAgentRunExecutionsParams): Promise<PageResult<AgentRunExecution>>;
+    /**
+     * Get a single agent run execution by unique ID.
+     * @returns The AgentRunExecution record with input, output, and cost details.
+     */
     getExecution(agentUniqueId: string, executionUniqueId: string): Promise<AgentRunExecution>;
 }
 export declare function createAgentRuntimeService(transport: Transport, _config: {

package/dist/src/lib/services/agent-runtime.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/agent-runtime.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,4BAA4B,EAC7B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClF,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9F,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAAC;IACvG,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzE,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3F,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACnI,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACjI,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAClH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClF,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9E,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,4BAA4B,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACrH,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC5F;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CA4Q/G"}
+{"version":3,"file":"agent-runtime.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/agent-runtime.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,4BAA4B,EAC7B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAElF;;;OAGG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE9F;;;OAGG;IACH,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAAC;IAEvG;;;OAGG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzE;;;OAGG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3F;;;OAGG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAEnI;;;OAGG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjI;;;OAGG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAElH;;;OAGG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElF;;;OAGG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE9E;;;OAGG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,4BAA4B,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAErH;;;OAGG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC5F;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,mBAAmB,CA4Q/G"}

package/dist/src/lib/services/agents.service.d.ts

@@ -1,12 +1,39 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Agent, CreateAgentRequest, UpdateAgentRequest, ListAgentsParams, ChatRequest, ChatResponse, CompleteRequest, CompleteResponse } from '../types/agent.js';
 export interface AgentsService {
+    /**
+     * List agents with optional filtering and sorting.
+     * @returns Paginated list of Agent records with metadata.
+     */
     list(params?: ListAgentsParams): Promise<PageResult<Agent>>;
+    /**
+     * Get a single agent by unique ID.
+     * @returns The matching Agent record.
+     */
     get(uniqueId: string): Promise<Agent>;
+    /**
+     * Create a new agent.
+     * @returns The newly created Agent record.
+     */
     create(data: CreateAgentRequest): Promise<Agent>;
+    /**
+     * Update an existing agent.
+     * @returns The updated Agent record.
+     */
     update(uniqueId: string, data: UpdateAgentRequest): Promise<Agent>;
+    /**
+     * Delete an agent.
+     */
     delete(uniqueId: string): Promise<void>;
+    /**
+     * Send a chat message to an agent.
+     * @returns ChatResponse with the agent's reply, token usage, and cost.
+     */
     chat(uniqueId: string, data: ChatRequest): Promise<ChatResponse>;
+    /**
+     * Send a completion request to an agent.
+     * @returns CompleteResponse with output, token usage, cost, and duration.
+     */
     complete(uniqueId: string, data: CompleteRequest): Promise<CompleteResponse>;
 }
 export declare function createAgentsService(transport: Transport, _config: {

package/dist/src/lib/services/agents.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/agents.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CA0FnG"}
+{"version":3,"file":"agents.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/agents.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAE5D;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEtC;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEjD;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnE;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEjE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CA0FnG"}

package/dist/src/lib/services/ai-models.service.d.ts

@@ -1,10 +1,29 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { AIModel, CreateAIModelRequest, UpdateAIModelRequest, ListAIModelsParams } from '../types/ai-model.js';
 export interface AIModelsService {
+    /**
+     * List AI models with optional filtering and sorting.
+     * @returns Paginated list of AIModel records with metadata.
+     */
     list(params?: ListAIModelsParams): Promise<PageResult<AIModel>>;
+    /**
+     * Get a single AI model by unique ID.
+     * @returns The matching AIModel record.
+     */
     get(uniqueId: string): Promise<AIModel>;
+    /**
+     * Create a new AI model configuration.
+     * @returns The newly created AIModel record.
+     */
     create(data: CreateAIModelRequest): Promise<AIModel>;
+    /**
+     * Update an existing AI model configuration.
+     * @returns The updated AIModel record.
+     */
     update(uniqueId: string, data: UpdateAIModelRequest): Promise<AIModel>;
+    /**
+     * Delete an AI model.
+     */
     delete(uniqueId: string): Promise<void>;
 }
 export declare function createAIModelsService(transport: Transport, _config: {

package/dist/src/lib/services/ai-models.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-models.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/ai-models.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAyDvG"}
+{"version":3,"file":"ai-models.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/ai-models.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEhE;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvE;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAyDvG"}

package/dist/src/lib/services/clusters.service.d.ts

@@ -1,17 +1,61 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Cluster, CreateClusterRequest, UpdateClusterRequest, ListClustersParams, ClusterContext, CreateClusterContextRequest, SendClusterMessageRequest, SendClusterMessageResponse } from '../types/cluster.js';
 export interface ClustersService {
+    /**
+     * List clusters for a user with optional filtering and sorting.
+     * @returns Paginated list of Cluster records with metadata.
+     */
     list(userUniqueId: string, params?: ListClustersParams): Promise<PageResult<Cluster>>;
+    /**
+     * Get a single cluster by unique ID.
+     * @returns The matching Cluster record.
+     */
     get(userUniqueId: string, uniqueId: string): Promise<Cluster>;
+    /**
+     * Create a new cluster for a user.
+     * @returns The newly created Cluster record.
+     */
     create(userUniqueId: string, data: CreateClusterRequest): Promise<Cluster>;
+    /**
+     * Update an existing cluster.
+     * @returns The updated Cluster record.
+     */
     update(userUniqueId: string, uniqueId: string, data: UpdateClusterRequest): Promise<Cluster>;
+    /**
+     * Delete a cluster.
+     */
     delete(userUniqueId: string, uniqueId: string): Promise<void>;
+    /**
+     * Add an entity as a member of a cluster.
+     */
     addMember(userUniqueId: string, uniqueId: string, entityUniqueId: string): Promise<void>;
+    /**
+     * Remove an entity from a cluster.
+     */
     removeMember(userUniqueId: string, uniqueId: string, entityUniqueId: string): Promise<void>;
+    /**
+     * Associate a prompt with a cluster.
+     */
     addPrompt(userUniqueId: string, uniqueId: string, promptUniqueId: string): Promise<void>;
+    /**
+     * Get an existing cluster context by unique ID.
+     * @returns The ClusterContext with messages and metadata.
+     */
     getContext(userUniqueId: string, uniqueId: string, contextUniqueId: string): Promise<ClusterContext>;
+    /**
+     * Create a new context for cluster conversations.
+     * @returns The newly created ClusterContext.
+     */
     createContext(userUniqueId: string, uniqueId: string, data?: CreateClusterContextRequest): Promise<ClusterContext>;
+    /**
+     * Get the conversation history for a cluster context.
+     * @returns The ClusterContext with full message history.
+     */
     getConversation(userUniqueId: string, uniqueId: string, contextUniqueId: string): Promise<ClusterContext>;
+    /**
+     * Send a message within a cluster context.
+     * @returns SendClusterMessageResponse with the sent message, optional AI response, and cost.
+     */
     sendMessage(userUniqueId: string, uniqueId: string, contextUniqueId: string, data: SendClusterMessageRequest): Promise<SendClusterMessageResponse>;
 }
 export declare function createClustersService(transport: Transport, _config: {

package/dist/src/lib/services/clusters.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clusters.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/clusters.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACtF,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7F,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACrG,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACnH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1G,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACpJ;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAyIvG"}
+{"version":3,"file":"clusters.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/clusters.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtF;;;OAGG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9D;;;OAGG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3E;;;OAGG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7F;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzF;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5F;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzF;;;OAGG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAErG;;;OAGG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEnH;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE1G;;;OAGG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACpJ;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAyIvG"}

package/dist/src/lib/services/conversations.service.d.ts

@@ -1,11 +1,35 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Conversation, CreateConversationRequest, SendMessageRequest, SendMessageResponse, ListConversationsParams } from '../types/conversation.js';
 export interface ConversationsService {
+    /**
+     * List conversations with optional filtering and sorting.
+     * @returns Paginated list of Conversation records with metadata.
+     */
     list(params?: ListConversationsParams): Promise<PageResult<Conversation>>;
+    /**
+     * Get a single conversation by unique ID.
+     * @returns The matching Conversation record.
+     */
     get(uniqueId: string): Promise<Conversation>;
+    /**
+     * Create a new conversation.
+     * @returns The newly created Conversation record.
+     */
     create(data: CreateConversationRequest): Promise<Conversation>;
+    /**
+     * Send a message in a conversation.
+     * @returns SendMessageResponse with the sent message, optional AI response, and cost.
+     */
     sendMessage(uniqueId: string, data: SendMessageRequest): Promise<SendMessageResponse>;
+    /**
+     * List conversations belonging to a specific user.
+     * @returns Paginated list of Conversation records with metadata.
+     */
     listByUser(userUniqueId: string, params?: ListConversationsParams): Promise<PageResult<Conversation>>;
+    /**
+     * Clear all messages in a conversation.
+     * @returns The updated Conversation record with messages cleared.
+     */
     clear(uniqueId: string): Promise<Conversation>;
 }
 export declare function createConversationsService(transport: Transport, _config: {

package/dist/src/lib/services/conversations.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversations.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/conversations.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1E,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtF,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IACtG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAChD;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CA6EjH"}
+{"version":3,"file":"conversations.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/conversations.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAE1E;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE7C;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/D;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEtF;;;OAGG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAEtG;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAChD;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CA6EjH"}

package/dist/src/lib/services/entities.service.d.ts

@@ -1,16 +1,58 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Entity, RegisterEntityRequest, UpdateEntityRequest, ListEntitiesParams, EntityContext, CreateEntityContextRequest, SendEntityMessageRequest, SendEntityMessageResponse, QueryEntityFileRequest, QueryEntityFileResponse } from '../types/entity.js';
 export interface EntitiesService {
+    /**
+     * List entities with optional filtering and sorting.
+     * @returns Paginated list of Entity records with metadata.
+     */
     list(params?: ListEntitiesParams): Promise<PageResult<Entity>>;
+    /**
+     * Get a single entity by unique ID.
+     * @returns The matching Entity record.
+     */
     get(uniqueId: string): Promise<Entity>;
+    /**
+     * Register an entity in the Jarvis system.
+     * @returns The newly registered Entity record.
+     */
     register(uniqueId: string, data?: RegisterEntityRequest): Promise<Entity>;
+    /**
+     * Update an existing entity.
+     * @returns The updated Entity record.
+     */
     update(uniqueId: string, data: UpdateEntityRequest): Promise<Entity>;
+    /**
+     * Delete an entity.
+     */
     delete(uniqueId: string): Promise<void>;
+    /**
+     * Associate a prompt with an entity.
+     */
     addPrompt(uniqueId: string, promptUniqueId: string): Promise<void>;
+    /**
+     * Get an existing entity context by unique ID.
+     * @returns The EntityContext with messages and metadata.
+     */
     getContext(uniqueId: string, contextUniqueId: string): Promise<EntityContext>;
+    /**
+     * Create a new context for entity conversations.
+     * @returns The newly created EntityContext.
+     */
     createContext(uniqueId: string, data?: CreateEntityContextRequest): Promise<EntityContext>;
+    /**
+     * Get the conversation history for an entity context.
+     * @returns The EntityContext with full message history.
+     */
     getConversation(uniqueId: string, contextUniqueId: string): Promise<EntityContext>;
+    /**
+     * Send a message within an entity context.
+     * @returns SendEntityMessageResponse with the sent message, optional AI response, and cost.
+     */
     sendMessage(uniqueId: string, contextUniqueId: string, data: SendEntityMessageRequest): Promise<SendEntityMessageResponse>;
+    /**
+     * Query an entity's file using natural language (RAG).
+     * @returns QueryEntityFileResponse with answer, sources, token usage, and cost.
+     */
     queryFile(uniqueId: string, fileUniqueId: string, data: QueryEntityFileRequest): Promise<QueryEntityFileResponse>;
 }
 export declare function createEntitiesService(transport: Transport, _config: {

package/dist/src/lib/services/entities.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/entities.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,MAAM,EACN,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9E,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3F,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC3H,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACnH;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAkJvG"}
+{"version":3,"file":"entities.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/entities.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,MAAM,EACN,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAE/D;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1E;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAErE;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE9E;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3F;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEnF;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAE3H;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACnH;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAkJvG"}

package/dist/src/lib/services/execution-comments.service.d.ts

@@ -1,17 +1,46 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { ExecutionComment, CreateExecutionCommentRequest, UpdateExecutionCommentRequest, ListExecutionCommentsParams, ReplyToCommentRequest } from '../types/comment.js';
 export interface ExecutionCommentsService {
+    /**
+     * List comments on an execution with optional filtering and sorting.
+     * @returns Paginated list of ExecutionComment records with metadata.
+     */
     list(promptUniqueId: string, executionUniqueId: string, params?: ListExecutionCommentsParams): Promise<PageResult<ExecutionComment>>;
+    /**
+     * Get a single execution comment by unique ID.
+     * @returns The matching ExecutionComment record.
+     */
     get(promptUniqueId: string, executionUniqueId: string, uniqueId: string): Promise<ExecutionComment>;
+    /**
+     * Create a new comment on an execution.
+     * @returns The newly created ExecutionComment record.
+     */
     create(promptUniqueId: string, executionUniqueId: string, data: CreateExecutionCommentRequest): Promise<ExecutionComment>;
+    /**
+     * Update an existing execution comment.
+     * @returns The updated ExecutionComment record.
+     */
     update(promptUniqueId: string, executionUniqueId: string, uniqueId: string, data: UpdateExecutionCommentRequest): Promise<ExecutionComment>;
+    /**
+     * Delete an execution comment.
+     */
     delete(promptUniqueId: string, executionUniqueId: string, uniqueId: string): Promise<void>;
+    /** Like an execution comment. */
     like(promptUniqueId: string, executionUniqueId: string, uniqueId: string): Promise<void>;
+    /** Remove a like from an execution comment. */
     dislike(promptUniqueId: string, executionUniqueId: string, uniqueId: string): Promise<void>;
+    /**
+     * Reply to an execution comment.
+     * @returns The newly created reply ExecutionComment record.
+     */
     reply(promptUniqueId: string, executionUniqueId: string, uniqueId: string, data: ReplyToCommentRequest): Promise<ExecutionComment>;
+    /** Follow an execution comment to receive notifications. */
     follow(promptUniqueId: string, executionUniqueId: string, uniqueId: string): Promise<void>;
+    /** Unfollow an execution comment. */
     unfollow(promptUniqueId: string, executionUniqueId: string, uniqueId: string): Promise<void>;
+    /** Save an execution comment to bookmarks. */
     save(promptUniqueId: string, executionUniqueId: string, uniqueId: string): Promise<void>;
+    /** Remove an execution comment from bookmarks. */
     unsave(promptUniqueId: string, executionUniqueId: string, uniqueId: string): Promise<void>;
 }
 export declare function createExecutionCommentsService(transport: Transport, _config: {

package/dist/src/lib/services/execution-comments.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-comments.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/execution-comments.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,gBAAgB,EAChB,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACrI,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpG,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1H,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5I,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnI,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7F,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,wBAAwB,CAkFzH"}
+{"version":3,"file":"execution-comments.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/execution-comments.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,gBAAgB,EAChB,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAErI;;;OAGG;IACH,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEpG;;;OAGG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE1H;;;OAGG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE5I;;OAEG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3F,iCAAiC;IACjC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzF,+CAA+C;IAC/C,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5F;;;OAGG;IACH,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEnI,4DAA4D;IAC5D,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3F,qCAAqC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7F,8CAA8C;IAC9C,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzF,kDAAkD;IAClD,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,wBAAwB,CAkFzH"}

package/dist/src/lib/services/executions.service.d.ts

@@ -1,10 +1,30 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Execution, ListExecutionsParams } from '../types/execution.js';
 export interface ExecutionsService {
+    /**
+     * List executions with optional filtering and sorting.
+     * @returns Paginated list of Execution records with metadata.
+     */
     list(params?: ListExecutionsParams): Promise<PageResult<Execution>>;
+    /**
+     * Get a single execution by unique ID.
+     * @returns The matching Execution record.
+     */
     get(uniqueId: string): Promise<Execution>;
+    /**
+     * List executions for a specific agent.
+     * @returns Paginated list of Execution records with metadata.
+     */
     listByAgent(agentUniqueId: string, params?: ListExecutionsParams): Promise<PageResult<Execution>>;
+    /**
+     * List executions for a specific prompt.
+     * @returns Paginated list of Execution records with metadata.
+     */
     listByPrompt(promptUniqueId: string, params?: ListExecutionsParams): Promise<PageResult<Execution>>;
+    /**
+     * Cancel a running execution.
+     * @returns The updated Execution record with cancelled status.
+     */
     cancel(uniqueId: string): Promise<Execution>;
 }
 export declare function createExecutionsService(transport: Transport, _config: {

package/dist/src/lib/services/executions.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executions.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/executions.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7E,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACpE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAClG,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACpG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC9C;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CA+C3G"}
+{"version":3,"file":"executions.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/executions.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7E,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAEpE;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAE1C;;;OAGG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAElG;;;OAGG;IACH,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAEpG;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC9C;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CA+C3G"}

package/dist/src/lib/services/mail-templates.service.d.ts

@@ -1,13 +1,45 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { MailTemplate, CreateMailTemplateRequest, UpdateMailTemplateRequest, ListMailTemplatesParams, CreateMandrillTemplateRequest, UpdateMandrillTemplateRequest, MandrillStats } from '../types/mail-template.js';
 export interface MailTemplatesService {
+    /**
+     * List mail templates with optional filtering and sorting.
+     * @returns Paginated list of MailTemplate records with metadata.
+     */
     list(params?: ListMailTemplatesParams): Promise<PageResult<MailTemplate>>;
+    /**
+     * Get a single mail template by unique ID.
+     * @returns The matching MailTemplate record.
+     */
     get(uniqueId: string): Promise<MailTemplate>;
+    /**
+     * Create a new mail template.
+     * @returns The newly created MailTemplate record.
+     */
     create(data: CreateMailTemplateRequest): Promise<MailTemplate>;
+    /**
+     * Update an existing mail template.
+     * @returns The updated MailTemplate record.
+     */
     update(uniqueId: string, data: UpdateMailTemplateRequest): Promise<MailTemplate>;
+    /**
+     * Create a Mandrill template linked to this mail template.
+     * @returns The updated MailTemplate record with Mandrill integration.
+     */
     createMandrillTemplate(uniqueId: string, data?: CreateMandrillTemplateRequest): Promise<MailTemplate>;
+    /**
+     * Update the linked Mandrill template.
+     * @returns The updated MailTemplate record.
+     */
     updateMandrillTemplate(uniqueId: string, data?: UpdateMandrillTemplateRequest): Promise<MailTemplate>;
+    /**
+     * Publish the Mandrill template to make it active.
+     * @returns The updated MailTemplate record with published status.
+     */
     publishMandrill(uniqueId: string): Promise<MailTemplate>;
+    /**
+     * Get delivery statistics for the linked Mandrill template.
+     * @returns MandrillStats with send, open, click, bounce, and spam counts.
+     */
     getMandrillStats(uniqueId: string): Promise<MandrillStats>;
 }
 export declare function createMailTemplatesService(transport: Transport, _config: {

package/dist/src/lib/services/mail-templates.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mail-templates.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/mail-templates.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,aAAa,EACd,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1E,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACjF,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,6BAA6B,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,6BAA6B,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5D;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CA2FjH"}
+{"version":3,"file":"mail-templates.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/mail-templates.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,aAAa,EACd,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAE1E;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE7C;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/D;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEjF;;;OAGG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,6BAA6B,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEtG;;;OAGG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,6BAA6B,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEtG;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzD;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5D;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CA2FjH"}

package/dist/src/lib/services/marvin-chat.service.d.ts

@@ -1,11 +1,35 @@
 import type { Transport } from '@23blocks/contracts';
 import type { MarvinContext, MarvinChatRequest, MarvinChatResponse, CreateMarvinContextRequest, SendMarvinMessageRequest, SendMarvinMessageResponse } from '../types/marvin-chat.js';
 export interface MarvinChatService {
+    /**
+     * Send a chat message via Marvin v1 API.
+     * @returns MarvinChatResponse with the AI response, token usage, and cost.
+     */
     chat(data: MarvinChatRequest): Promise<MarvinChatResponse>;
+    /**
+     * Send a chat message via Jarvis v2 API.
+     * @returns MarvinChatResponse with the AI response, token usage, and cost.
+     */
     chatV2(data: MarvinChatRequest): Promise<MarvinChatResponse>;
+    /**
+     * Send a chat message via Jarvis v3 API.
+     * @returns MarvinChatResponse with the AI response, token usage, and cost.
+     */
     chatV3(data: MarvinChatRequest): Promise<MarvinChatResponse>;
+    /**
+     * Get an existing Marvin context by unique ID.
+     * @returns The MarvinContext with messages, model config, and metadata.
+     */
     getContext(uniqueId: string): Promise<MarvinContext>;
+    /**
+     * Create a new Marvin context for conversations.
+     * @returns The newly created MarvinContext.
+     */
     createContext(data?: CreateMarvinContextRequest): Promise<MarvinContext>;
+    /**
+     * Send a message within a Marvin context.
+     * @returns SendMarvinMessageResponse with the user message, AI response, and cost.
+     */
     sendMessage(contextUniqueId: string, data: SendMarvinMessageRequest): Promise<SendMarvinMessageResponse>;
 }
 export declare function createMarvinChatService(transport: Transport, _config: {

package/dist/src/lib/services/marvin-chat.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marvin-chat.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/marvin-chat.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3D,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7D,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrD,aAAa,CAAC,IAAI,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzE,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC1G;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CA4H3G"}
+{"version":3,"file":"marvin-chat.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/marvin-chat.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE3D;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE7D;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE7D;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAErD;;;OAGG;IACH,aAAa,CAAC,IAAI,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzE;;;OAGG;IACH,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC1G;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CA4H3G"}

package/dist/src/lib/services/prompt-comments.service.d.ts

@@ -1,17 +1,46 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { PromptComment, CreatePromptCommentRequest, UpdatePromptCommentRequest, ListPromptCommentsParams, ReplyToCommentRequest } from '../types/comment.js';
 export interface PromptCommentsService {
+    /**
+     * List comments on a prompt with optional filtering and sorting.
+     * @returns Paginated list of PromptComment records with metadata.
+     */
     list(promptUniqueId: string, params?: ListPromptCommentsParams): Promise<PageResult<PromptComment>>;
+    /**
+     * Get a single prompt comment by unique ID.
+     * @returns The matching PromptComment record.
+     */
     get(promptUniqueId: string, uniqueId: string): Promise<PromptComment>;
+    /**
+     * Create a new comment on a prompt.
+     * @returns The newly created PromptComment record.
+     */
     create(promptUniqueId: string, data: CreatePromptCommentRequest): Promise<PromptComment>;
+    /**
+     * Update an existing prompt comment.
+     * @returns The updated PromptComment record.
+     */
     update(promptUniqueId: string, uniqueId: string, data: UpdatePromptCommentRequest): Promise<PromptComment>;
+    /**
+     * Delete a prompt comment.
+     */
     delete(promptUniqueId: string, uniqueId: string): Promise<void>;
+    /** Like a prompt comment. */
     like(promptUniqueId: string, uniqueId: string): Promise<void>;
+    /** Remove a like from a prompt comment. */
     dislike(promptUniqueId: string, uniqueId: string): Promise<void>;
+    /**
+     * Reply to a prompt comment.
+     * @returns The newly created reply PromptComment record.
+     */
     reply(promptUniqueId: string, uniqueId: string, data: ReplyToCommentRequest): Promise<PromptComment>;
+    /** Follow a prompt comment to receive notifications. */
     follow(promptUniqueId: string, uniqueId: string): Promise<void>;
+    /** Unfollow a prompt comment. */
     unfollow(promptUniqueId: string, uniqueId: string): Promise<void>;
+    /** Save a prompt comment to bookmarks. */
     save(promptUniqueId: string, uniqueId: string): Promise<void>;
+    /** Remove a prompt comment from bookmarks. */
     unsave(promptUniqueId: string, uniqueId: string): Promise<void>;
 }
 export declare function createPromptCommentsService(transport: Transport, _config: {

package/dist/src/lib/services/prompt-comments.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-comments.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/prompt-comments.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,aAAa,EACb,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;IACpG,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzF,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3G,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrG,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,qBAAqB,CAkFnH"}
+{"version":3,"file":"prompt-comments.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/prompt-comments.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,aAAa,EACb,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpG;;;OAGG;IACH,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEtE;;;OAGG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzF;;;OAGG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3G;;OAEG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE,6BAA6B;IAC7B,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D,2CAA2C;IAC3C,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;OAGG;IACH,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAErG,wDAAwD;IACxD,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE,iCAAiC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE,0CAA0C;IAC1C,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D,8CAA8C;IAC9C,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,qBAAqB,CAkFnH"}

package/dist/src/lib/services/prompts.service.d.ts

@@ -1,13 +1,44 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Prompt, CreatePromptRequest, UpdatePromptRequest, ListPromptsParams, ExecutePromptRequest, ExecutePromptResponse, TestPromptRequest, TestPromptResponse, RenderPromptRequest, RenderPromptResponse } from '../types/prompt.js';
 export interface PromptsService {
+    /**
+     * List prompts with optional filtering and sorting.
+     * @returns Paginated list of Prompt records with metadata.
+     */
     list(params?: ListPromptsParams): Promise<PageResult<Prompt>>;
+    /**
+     * Get a single prompt by unique ID.
+     * @returns The matching Prompt record.
+     */
     get(uniqueId: string): Promise<Prompt>;
+    /**
+     * Create a new prompt.
+     * @returns The newly created Prompt record.
+     */
     create(data: CreatePromptRequest): Promise<Prompt>;
+    /**
+     * Update an existing prompt.
+     * @returns The updated Prompt record.
+     */
     update(uniqueId: string, data: UpdatePromptRequest): Promise<Prompt>;
+    /**
+     * Delete a prompt.
+     */
     delete(uniqueId: string): Promise<void>;
+    /**
+     * Execute a prompt with variables against an agent.
+     * @returns ExecutePromptResponse with output, token usage, cost, and duration.
+     */
     execute(uniqueId: string, data: ExecutePromptRequest): Promise<ExecutePromptResponse>;
+    /**
+     * Test a prompt template for validity without executing it.
+     * @returns TestPromptResponse with rendered prompt, validation status, and errors.
+     */
     test(data: TestPromptRequest): Promise<TestPromptResponse>;
+    /**
+     * Render a prompt template with placeholder values.
+     * @returns RenderPromptResponse with rendered content and placeholder metadata.
+     */
     render(uniqueId: string, data: RenderPromptRequest): Promise<RenderPromptResponse>;
 }
 export declare function createPromptsService(transport: Transport, _config: {

package/dist/src/lib/services/prompts.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/prompts.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,MAAM,EACN,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACtF,IAAI,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACpF;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CA0HrG"}
+{"version":3,"file":"prompts.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/prompts.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,MAAM,EACN,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9D;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnD;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAErE;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAEtF;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE3D;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACpF;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CA0HrG"}

package/dist/src/lib/services/users.service.d.ts

@@ -1,18 +1,69 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { JarvisUser, RegisterJarvisUserRequest, UpdateJarvisUserRequest, ListJarvisUsersParams, UserContext, CreateUserContextRequest, SendUserMessageRequest, SendUserMessageResponse, CreateUserContentContextRequest } from '../types/user.js';
 export interface JarvisUsersService {
+    /**
+     * List Jarvis users with optional filtering and sorting.
+     * @returns Paginated list of JarvisUser records with metadata.
+     */
     list(params?: ListJarvisUsersParams): Promise<PageResult<JarvisUser>>;
+    /**
+     * Get a single Jarvis user by unique ID.
+     * @returns The matching JarvisUser record.
+     */
     get(uniqueId: string): Promise<JarvisUser>;
+    /**
+     * Register a user in the Jarvis system.
+     * @returns The newly registered JarvisUser record.
+     */
     register(uniqueId: string, data?: RegisterJarvisUserRequest): Promise<JarvisUser>;
+    /**
+     * Update a Jarvis user.
+     * @returns The updated JarvisUser record.
+     */
     update(uniqueId: string, data: UpdateJarvisUserRequest): Promise<JarvisUser>;
+    /**
+     * Associate a prompt with a user.
+     */
     addPrompt(uniqueId: string, promptUniqueId: string): Promise<void>;
+    /**
+     * Get an existing user context by unique ID.
+     * @returns The UserContext with messages and metadata.
+     */
     getContext(uniqueId: string, contextUniqueId: string): Promise<UserContext>;
+    /**
+     * Create a new context for user conversations.
+     * @returns The newly created UserContext.
+     */
     createContext(uniqueId: string, data?: CreateUserContextRequest): Promise<UserContext>;
+    /**
+     * Get the conversation history for a user context.
+     * @returns The UserContext with full message history.
+     */
     getConversation(uniqueId: string, contextUniqueId: string): Promise<UserContext>;
+    /**
+     * Send a message within a user context.
+     * @returns SendUserMessageResponse with the sent message, optional AI response, and cost.
+     */
     sendMessage(uniqueId: string, contextUniqueId: string, data: SendUserMessageRequest): Promise<SendUserMessageResponse>;
+    /**
+     * Get an existing content-scoped context for a user.
+     * @returns The UserContext with messages and metadata.
+     */
     getContentContext(uniqueId: string, contentIdentityUniqueId: string, contextUniqueId: string): Promise<UserContext>;
+    /**
+     * Create a new content-scoped context for a user.
+     * @returns The newly created UserContext.
+     */
     createContentContext(uniqueId: string, contentIdentityUniqueId: string, data?: CreateUserContentContextRequest): Promise<UserContext>;
+    /**
+     * Get the content-scoped conversation history for a user.
+     * @returns The UserContext with full message history.
+     */
     getContentConversation(uniqueId: string, contentIdentityUniqueId: string, contextUniqueId: string): Promise<UserContext>;
+    /**
+     * Send a message within a content-scoped user context.
+     * @returns SendUserMessageResponse with the sent message, optional AI response, and cost.
+     */
     sendContentMessage(uniqueId: string, contentIdentityUniqueId: string, contextUniqueId: string, data: SendUserMessageRequest): Promise<SendUserMessageResponse>;
 }
 export declare function createJarvisUsersService(transport: Transport, _config: {

package/dist/src/lib/services/users.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/users.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,UAAU,EACV,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,WAAW,EACX,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAChC,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IACtE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClF,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7E,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5E,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACvF,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACvH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,+BAA+B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtI,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAChK;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAyM7G"}
+{"version":3,"file":"users.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/users.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,UAAU,EACV,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,WAAW,EACX,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAChC,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAEtE;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE3C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAElF;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE7E;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5E;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEvF;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjF;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEvH;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpH;;;OAGG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,+BAA+B,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEtI;;;OAGG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzH;;;OAGG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAChK;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,CAyM7G"}

package/dist/src/lib/services/workflow-instances.service.d.ts

@@ -1,12 +1,40 @@
 import type { Transport } from '@23blocks/contracts';
 import type { WorkflowInstance, WorkflowInstanceDetails, StartWorkflowRequest, StartWorkflowResponse, StepWorkflowRequest, LogWorkflowStepRequest } from '../types/workflow-instance.js';
 export interface WorkflowInstancesService {
+    /**
+     * Start a new workflow instance.
+     * @returns StartWorkflowResponse containing the created WorkflowInstance.
+     */
     start(workflowUniqueId: string, data?: StartWorkflowRequest): Promise<StartWorkflowResponse>;
+    /**
+     * Get a single workflow instance by unique ID.
+     * @returns The matching WorkflowInstance record.
+     */
     get(workflowUniqueId: string, instanceUniqueId: string): Promise<WorkflowInstance>;
+    /**
+     * Get detailed information about a workflow instance including step statuses.
+     * @returns WorkflowInstanceDetails with instance, workflow info, and step progress.
+     */
     getDetails(workflowUniqueId: string, instanceUniqueId: string): Promise<WorkflowInstanceDetails>;
+    /**
+     * Advance a workflow instance to the next step.
+     * @returns The updated WorkflowInstance record.
+     */
     step(workflowUniqueId: string, instanceUniqueId: string, data?: StepWorkflowRequest): Promise<WorkflowInstance>;
+    /**
+     * Log output or errors for a specific workflow step.
+     * @returns The updated WorkflowInstance record.
+     */
     logStep(workflowUniqueId: string, instanceUniqueId: string, data: LogWorkflowStepRequest): Promise<WorkflowInstance>;
+    /**
+     * Suspend a running workflow instance.
+     * @returns The updated WorkflowInstance record with suspended status.
+     */
     suspend(workflowUniqueId: string, instanceUniqueId: string): Promise<WorkflowInstance>;
+    /**
+     * Resume a suspended workflow instance.
+     * @returns The updated WorkflowInstance record with resumed status.
+     */
     resume(workflowUniqueId: string, instanceUniqueId: string): Promise<WorkflowInstance>;
 }
 export declare function createWorkflowInstancesService(transport: Transport, _config: {

package/dist/src/lib/services/workflow-instances.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-instances.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/workflow-instances.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AAGvC,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC7F,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnF,UAAU,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACjG,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChH,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrH,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvF,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACvF;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,wBAAwB,CAiEzH"}
+{"version":3,"file":"workflow-instances.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/workflow-instances.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AAGvC,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,KAAK,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE7F;;;OAGG;IACH,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEnF;;;OAGG;IACH,UAAU,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEjG;;;OAGG;IACH,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEhH;;;OAGG;IACH,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErH;;;OAGG;IACH,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEvF;;;OAGG;IACH,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACvF;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,wBAAwB,CAiEzH"}

package/dist/src/lib/services/workflow-participants.service.d.ts

@@ -1,10 +1,29 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { WorkflowParticipant, AddWorkflowParticipantRequest, UpdateWorkflowParticipantRequest, ListWorkflowParticipantsParams } from '../types/workflow-participant.js';
 export interface WorkflowParticipantsService {
+    /**
+     * List participants in a workflow with optional filtering and sorting.
+     * @returns Paginated list of WorkflowParticipant records with metadata.
+     */
     list(workflowUniqueId: string, params?: ListWorkflowParticipantsParams): Promise<PageResult<WorkflowParticipant>>;
+    /**
+     * Get a single workflow participant by unique ID.
+     * @returns The matching WorkflowParticipant record.
+     */
     get(workflowUniqueId: string, uniqueId: string): Promise<WorkflowParticipant>;
+    /**
+     * Add a participant to a workflow.
+     * @returns The newly created WorkflowParticipant record.
+     */
     add(workflowUniqueId: string, data: AddWorkflowParticipantRequest): Promise<WorkflowParticipant>;
+    /**
+     * Update a workflow participant's role or permissions.
+     * @returns The updated WorkflowParticipant record.
+     */
     update(workflowUniqueId: string, uniqueId: string, data: UpdateWorkflowParticipantRequest): Promise<WorkflowParticipant>;
+    /**
+     * Remove a participant from a workflow.
+     */
     remove(workflowUniqueId: string, uniqueId: string): Promise<void>;
 }
 export declare function createWorkflowParticipantsService(transport: Transport, _config: {

package/dist/src/lib/services/workflow-participants.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-participants.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/workflow-participants.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,gCAAgC,EAChC,8BAA8B,EAC/B,MAAM,kCAAkC,CAAC;AAG1C,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAClH,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9E,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjG,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gCAAgC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzH,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,2BAA2B,CAkD/H"}
+{"version":3,"file":"workflow-participants.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/workflow-participants.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,gCAAgC,EAChC,8BAA8B,EAC/B,MAAM,kCAAkC,CAAC;AAG1C,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAElH;;;OAGG;IACH,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE9E;;;OAGG;IACH,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEjG;;;OAGG;IACH,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gCAAgC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEzH;;OAEG;IACH,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,2BAA2B,CAkD/H"}

package/dist/src/lib/services/workflow-steps.service.d.ts

@@ -1,11 +1,32 @@
 import type { Transport } from '@23blocks/contracts';
 import type { WorkflowStep, AddWorkflowStepRequest, UpdateWorkflowStepRequest, AddStepPromptRequest, AddStepAgentRequest } from '../types/workflow-step.js';
 export interface WorkflowStepsService {
+    /**
+     * Get a single workflow step by unique ID.
+     * @returns The matching WorkflowStep record.
+     */
     get(workflowUniqueId: string, stepUniqueId: string): Promise<WorkflowStep>;
+    /**
+     * Add a new step to a workflow.
+     * @returns The newly created WorkflowStep record.
+     */
     add(workflowUniqueId: string, data: AddWorkflowStepRequest): Promise<WorkflowStep>;
+    /**
+     * Update an existing workflow step.
+     * @returns The updated WorkflowStep record.
+     */
     update(workflowUniqueId: string, stepUniqueId: string, data: UpdateWorkflowStepRequest): Promise<WorkflowStep>;
+    /**
+     * Remove a step from a workflow.
+     */
     remove(workflowUniqueId: string, stepUniqueId: string): Promise<void>;
+    /**
+     * Associate a prompt with a workflow step.
+     */
     addPrompt(stepUniqueId: string, data: AddStepPromptRequest): Promise<void>;
+    /**
+     * Associate an agent with a workflow step.
+     */
     addAgent(stepUniqueId: string, data: AddStepAgentRequest): Promise<void>;
 }
 export declare function createWorkflowStepsService(transport: Transport, _config: {

package/dist/src/lib/services/workflow-steps.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-steps.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/workflow-steps.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnF,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/G,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAuDjH"}
+{"version":3,"file":"workflow-steps.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/workflow-steps.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE3E;;;OAGG;IACH,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEnF;;;OAGG;IACH,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/G;;OAEG;IACH,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,oBAAoB,CAuDjH"}

package/dist/src/lib/services/workflows.service.d.ts

@@ -1,13 +1,44 @@
 import type { Transport, PageResult } from '@23blocks/contracts';
 import type { Workflow, CreateWorkflowRequest, UpdateWorkflowRequest, ListWorkflowsParams, RunWorkflowRequest, RunWorkflowResponse } from '../types/workflow.js';
 export interface WorkflowsService {
+    /**
+     * List workflows with optional filtering and sorting.
+     * @returns Paginated list of Workflow records with metadata.
+     */
     list(params?: ListWorkflowsParams): Promise<PageResult<Workflow>>;
+    /**
+     * Get a single workflow by unique ID.
+     * @returns The matching Workflow record.
+     */
     get(uniqueId: string): Promise<Workflow>;
+    /**
+     * Create a new workflow.
+     * @returns The newly created Workflow record.
+     */
     create(data: CreateWorkflowRequest): Promise<Workflow>;
+    /**
+     * Update an existing workflow.
+     * @returns The updated Workflow record.
+     */
     update(uniqueId: string, data: UpdateWorkflowRequest): Promise<Workflow>;
+    /**
+     * Delete a workflow.
+     */
     delete(uniqueId: string): Promise<void>;
+    /**
+     * Run a workflow with input data.
+     * @returns RunWorkflowResponse with execution ID, status, and output.
+     */
     run(uniqueId: string, data: RunWorkflowRequest): Promise<RunWorkflowResponse>;
+    /**
+     * Pause a running workflow.
+     * @returns The updated Workflow record with paused status.
+     */
     pause(uniqueId: string): Promise<Workflow>;
+    /**
+     * Resume a paused workflow.
+     * @returns The updated Workflow record with resumed status.
+     */
     resume(uniqueId: string): Promise<Workflow>;
 }
 export declare function createWorkflowsService(transport: Transport, _config: {

package/dist/src/lib/services/workflows.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/workflows.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7C;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CA2EzG"}
+{"version":3,"file":"workflows.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/workflows.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAElE;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEzC;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEvD;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEzE;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE9E;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3C;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7C;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CA2EzG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@23blocks/block-jarvis",
-  "version": "3.1.7",
+  "version": "3.2.0",
   "description": "Jarvis AI block for 23blocks SDK - agents, prompts, workflows, executions, conversations",
   "license": "MIT",
   "author": "23blocks <hello@23blocks.com>",