@axiom-lattice/protocols 2.1.53 → 3.0.0

package/src/AgentLatticeProtocol.ts

@@ -237,8 +237,20 @@ export function isTeamAgentConfig(
 
 // ─── A2A_REMOTE Agent ──────────────────────────────────────────────────────
 
+export interface LocalRuntimeConfig {
+  label?: string;
+  agentCardUrl: string;
+  healthUrl?: string;
+  command: {
+    executable: string;
+    args: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+  };
+}
+
 /**
- * A2A_REMOTE agent configuration — delegates to an external A2A server.
+ * A2A_REMOTE agent configuration — wraps a remote A2A-compatible agent endpoint.
  *
  * This agent type wraps a remote A2A endpoint so orchestrators can treat
  * external agents the same as local LangGraph agents.
@@ -251,17 +263,48 @@ export interface A2ARemoteAgentConfig extends BaseAgentConfig {
    */
   agentCardUrl: string;
   /**
-   * Optional API key sent as Bearer token or X-API-Key header.
+   * Optional API key sent as a Bearer token.
    */
   apiKey?: string;
   /**
    * HTTP timeout in milliseconds (default: 300_000 = 5 min).
    */
   timeout?: number;
+  projectId?: string;
   /**
    * Optional tool keys (not used by the builder, but included for type compatibility).
    */
   tools?: string[];
+  /**
+   * Optional local runtime snapshot for Local Managed A2A assistants.
+   * When present, the gateway manages a local process for this assistant.
+   * Copied from a template or custom form at creation time.
+   */
+  localRuntime?: LocalRuntimeConfig;
+}
+
+export type LocalA2AProviderId = string;
+
+export type LocalA2AProviderStatus =
+  | "missing"
+  | "disabled"
+  | "starting"
+  | "running"
+  | "stopped"
+  | "failed";
+
+export interface LocalA2AProviderState {
+  runtimeId: string;
+  label: string;
+  status: LocalA2AProviderStatus;
+  enabled: boolean;
+  assistantId?: string;
+  agentCardUrl?: string;
+  healthUrl?: string;
+  pid?: number;
+  message?: string;
+  lastStartedAt?: string;
+  lastStoppedAt?: string;
 }
 
 /**

package/src/ConversationStoreProtocol.ts

@@ -0,0 +1,36 @@
+/**
+ * ConversationStoreProtocol
+ *
+ * Application-layer conversation persistence. Maintains mappings from
+ * application `conversationId`/`threadId` to A2A task IDs, allowing
+ * consumers to reference previous tasks without relying on A2A protocol
+ * state for chat memory. A2A handles task routing; conversation memory
+ * lives here.
+ */
+
+export interface ConversationRecord {
+  conversationId: string;
+  tenantId?: string;
+  taskIds: string[];
+  contextId?: string;
+  metadata?: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface CreateConversationInput {
+  conversationId: string;
+  tenantId?: string;
+  contextId?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface IConversationStore {
+  getConversation(conversationId: string): Promise<ConversationRecord | null>;
+
+  createConversation(input: CreateConversationInput): Promise<ConversationRecord>;
+
+  addTaskToConversation(conversationId: string, taskId: string): Promise<ConversationRecord>;
+
+  deleteConversation(conversationId: string): Promise<void>;
+}

package/src/LocalA2ATemplateConfig.ts

@@ -0,0 +1,19 @@
+/**
+ * LocalA2ATemplateConfig
+ *
+ * Read-only template definitions for Local Managed A2A providers.
+ * Templates define command defaults (executable, args, cwd, env)
+ * without port or agentCardUrl — those are user-supplied at creation time.
+ *
+ * Templates are defined in `packages/gateway/src/config/local-a2a-templates.ts`
+ * and served via `GET /api/local-a2a/templates`.
+ */
+
+import type { LocalRuntimeConfig } from "./AgentLatticeProtocol";
+
+export interface LocalA2ATemplateDefinition {
+  key: string;
+  name: string;
+  description?: string;
+  command: LocalRuntimeConfig["command"];
+}

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/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";
@@ -39,9 +40,11 @@ export * from "./EvalStoreProtocol";
 export * from "./TaskStoreProtocol";
 export * from "./TaskWorkItemProtocol";
 
+export * from "./LocalA2ATemplateConfig";
 export * from "./ChannelAdapterProtocol";
 export * from "./A2AProtocol";
 export * from "./A2AApiKeyStoreProtocol";
+export * from "./ConversationStoreProtocol";
 
 // Workflow DSL (concise, public API)
 export * from "./WorkflowDSL";