@axiom-lattice/protocols 2.1.51 → 2.1.54

package/src/PluginProtocol.ts

@@ -1,3 +1,5 @@
+import type { AgentConfig } from "./AgentLatticeProtocol";
+
 /**
  * Plugin Connection 字段 schema（驱动前端表单渲染）
  */
@@ -190,4 +192,16 @@ export interface Plugin {
    * Builder 在构建中间件之前从所有启用的插件中收集。
    */
   skills?: Record<string, string>;
+  /**
+   * 插件贡献的 Agent 定义（以 agent key 为键）。
+   * 在租户首次访问时通过 ensurePluginAgentsForTenant 按租户注册到
+   * AgentLatticeManager，与 builtin agents 模式一致。所有租户全局可用。
+   */
+  agents?: Record<string, AgentConfig>;
+  /**
+   * 插件贡献的 Store 实现（以 store type 为键）。
+   * 在 configureStores 时通过 customStores 机制自动注册到 StoreLatticeManager。
+   * 支持工厂函数（延迟初始化）或实例对象。
+   */
+  stores?: Record<string, object | (() => object)>;
 }

package/src/STTModelLatticeProtocol.ts

@@ -0,0 +1,66 @@
+/**
+ * STTModelLatticeProtocol
+ *
+ * Speech-to-text model lattice protocol for defining unified interface
+ * for speech recognition / transcription models.
+ */
+
+import { BaseLatticeProtocol } from "./BaseLatticeProtocol";
+
+/**
+ * STT provider configuration.
+ */
+export interface STTConfig {
+  /** Provider type */
+  provider?: string;
+  /** API mode: "whisper" uses /v1/audio/transcriptions, "chat" uses /v1/chat/completions */
+  apiMode?: "whisper" | "chat";
+  /** Model name, e.g. "whisper-1", "qwen3-asr-flash" */
+  model?: string;
+  /** Direct API key */
+  apiKey?: string;
+  /** Environment variable name for API key, e.g. "DASHSCOPE_API_KEY" */
+  apiKeyEnvName?: string;
+  /** Custom base URL */
+  baseURL?: string;
+  /** Request timeout in milliseconds */
+  timeout?: number;
+  /** Additional parameters passed through to provider (e.g. asr_options) */
+  extra?: Record<string, unknown>;
+}
+
+/**
+ * Result returned by a transcription provider.
+ */
+export interface TranscriptionResult {
+  /** Transcribed text */
+  text: string;
+  /** Confidence score 0-1, if available */
+  confidence?: number;
+  /** Word-level timing segments, if available */
+  segments?: Array<{
+    start: number;
+    end: number;
+    text: string;
+  }>;
+}
+
+/**
+ * STT client interface for providers to implement.
+ */
+export interface STTClient {
+  transcribe(audio: Buffer, format: string): Promise<TranscriptionResult>;
+}
+
+/**
+ * STT model lattice protocol interface.
+ */
+export interface STTModelLatticeProtocol
+  extends BaseLatticeProtocol<STTConfig, STTClient> {
+  /**
+   * Transcribe audio buffer to text.
+   * @param audio - Raw audio buffer
+   * @param format - Audio format, e.g. "webm", "wav", "mp3"
+   */
+  transcribe(audio: Buffer, format: string): Promise<TranscriptionResult>;
+}

package/src/TaskStoreProtocol.ts

@@ -19,6 +19,16 @@ export interface TaskItem {
    */
   tenantId: string;
 
+  /**
+   * Workspace identifier (from runConfig)
+   */
+  workspaceId?: string;
+
+  /**
+   * Project identifier (from runConfig)
+   */
+  projectId?: string;
+
   /**
    * Owner type — either a user or an agent
    */
@@ -42,7 +52,7 @@ export interface TaskItem {
   /**
    * Task status
    */
-  status: 'pending' | 'in_progress' | 'completed' | 'cancelled';
+  status: 'pending' | 'in_progress' | 'review' | 'failed' | 'interrupted' | 'completed' | 'cancelled';
 
   /**
    * Task priority level
@@ -83,6 +93,26 @@ export interface TaskItem {
    * Task last update timestamp
    */
   updatedAt: Date;
+
+  /**
+   * Whether this task requires review before completion
+   */
+  requireReview?: boolean;
+
+  /**
+   * IDs of tasks this task depends on
+   */
+  dependencies?: string[];
+
+  /**
+   * Task result output
+   */
+  result?: string;
+
+  /**
+   * Reason for task failure (when status is 'failed')
+   */
+  failureReason?: string;
 }
 
 /**
@@ -102,13 +132,23 @@ export interface CreateTaskRequest {
   /**
    * Task status — defaults to 'pending' if not provided
    */
-  status?: 'pending' | 'in_progress' | 'completed' | 'cancelled';
+  status?: 'pending' | 'in_progress' | 'review' | 'failed' | 'interrupted' | 'completed' | 'cancelled';
 
   /**
    * Task priority level — defaults to 'medium' if not provided
    */
   priority?: 'low' | 'medium' | 'high';
 
+  /**
+   * Workspace identifier
+   */
+  workspaceId?: string;
+
+  /**
+   * Project identifier
+   */
+  projectId?: string;
+
   /**
    * Optional due date as ISO string
    */
@@ -143,6 +183,26 @@ export interface CreateTaskRequest {
    * Owner identifier — defaults based on context if not provided
    */
   ownerId?: string;
+
+  /**
+   * Whether this task requires review before completion
+   */
+  requireReview?: boolean;
+
+  /**
+   * IDs of tasks this task depends on
+   */
+  dependencies?: string[];
+
+  /**
+   * Task result output
+   */
+  result?: string;
+
+  /**
+   * Reason for task failure (when status is 'failed')
+   */
+  failureReason?: string;
 }
 
 /**
@@ -162,13 +222,23 @@ export interface UpdateTaskRequest {
   /**
    * Task status
    */
-  status?: 'pending' | 'in_progress' | 'completed' | 'cancelled';
+  status?: 'pending' | 'in_progress' | 'review' | 'failed' | 'interrupted' | 'completed' | 'cancelled';
 
   /**
    * Task priority level
    */
   priority?: 'low' | 'medium' | 'high';
 
+  /**
+   * Workspace identifier
+   */
+  workspaceId?: string;
+
+  /**
+   * Project identifier
+   */
+  projectId?: string;
+
   /**
    * Optional due date as ISO string
    */
@@ -203,6 +273,26 @@ export interface UpdateTaskRequest {
    * Owner identifier
    */
   ownerId?: string;
+
+  /**
+   * Whether this task requires review before completion
+   */
+  requireReview?: boolean;
+
+  /**
+   * IDs of tasks this task depends on
+   */
+  dependencies?: string[];
+
+  /**
+   * Task result output
+   */
+  result?: string;
+
+  /**
+   * Reason for task failure (when status is 'failed')
+   */
+  failureReason?: string;
 }
 
 /**
@@ -234,6 +324,16 @@ export interface TaskListFilter {
    */
   priority?: string;
 
+  /**
+   * Filter by workspace ID
+   */
+  workspaceId?: string;
+
+  /**
+   * Filter by project ID
+   */
+  projectId?: string;
+
   /**
    * Filter by parent task ID
    */

package/src/TaskWorkItemProtocol.ts

@@ -0,0 +1,49 @@
+/**
+ * TaskWorkItemProtocol
+ *
+ * Work item protocol for event-sourced task change tracking.
+ * Every status change or action on a TaskItem produces one TaskWorkItem.
+ */
+
+export interface TaskWorkItem {
+  id: string;
+  taskId: string;
+  tenantId: string;
+  workspaceId?: string;
+  projectId?: string;
+  action: string;
+  actor: string;
+  threadId?: string;
+  summary?: string;
+  detail?: Record<string, unknown>;
+  attempt?: number;
+  createdAt: Date;
+}
+
+export interface CreateWorkItemRequest {
+  taskId: string;
+  tenantId: string;
+  workspaceId?: string;
+  projectId?: string;
+  action: string;
+  actor: string;
+  threadId?: string;
+  summary?: string;
+  detail?: Record<string, unknown>;
+  attempt?: number;
+}
+
+export interface TaskWorkItemListFilter {
+  tenantId: string;
+  taskId: string;
+  workspaceId?: string;
+  projectId?: string;
+  action?: string;
+  limit?: number;
+  offset?: number;
+}
+
+export interface TaskWorkItemStore {
+  create(params: CreateWorkItemRequest): Promise<TaskWorkItem>;
+  list(filter: TaskWorkItemListFilter): Promise<TaskWorkItem[]>;
+}

package/src/index.ts

@@ -13,6 +13,7 @@ export * from "./UILatticeProtocol";
 export * from "./QueueLatticeProtocol";
 export * from "./ScheduleLatticeProtocol";
 export * from "./EmbeddingsLatticeProtocol";
+export * from "./STTModelLatticeProtocol";
 export * from "./VectorStoreLatticeProtocol";
 export * from "./LoggerLatticeProtocol";
 export * from "./MessageProtocol";
@@ -37,6 +38,7 @@ export * from "./VectorStoreProviderProtocol";
 export * from "./MenuProtocol";
 export * from "./EvalStoreProtocol";
 export * from "./TaskStoreProtocol";
+export * from "./TaskWorkItemProtocol";
 
 export * from "./ChannelAdapterProtocol";
 export * from "./A2AProtocol";