@axiom-lattice/local-stores 2.0.10 → 3.0.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/local-stores@2.0.10 build /home/runner/work/agentic/agentic/packages/local-stores
+> @axiom-lattice/local-stores@3.0.0 build /home/runner/work/agentic/agentic/packages/local-stores
 > tsup src/index.ts --format cjs,esm --dts --sourcemap
 
 CLI Building entry: src/index.ts
@@ -8,13 +8,13 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-CJS dist/index.js     135.76 KB
-CJS dist/index.js.map 253.30 KB
-CJS ⚡️ Build success in 506ms
-ESM dist/index.mjs     132.29 KB
-ESM dist/index.mjs.map 250.45 KB
-ESM ⚡️ Build success in 509ms
+ESM dist/index.mjs     149.55 KB
+ESM dist/index.mjs.map 279.48 KB
+ESM ⚡️ Build success in 326ms
+CJS dist/index.js     153.07 KB
+CJS dist/index.js.map 282.33 KB
+CJS ⚡️ Build success in 327ms
 DTS Build start
-DTS ⚡️ Build success in 14142ms
-DTS dist/index.d.ts  29.36 KB
-DTS dist/index.d.mts 29.36 KB
+DTS ⚡️ Build success in 11582ms
+DTS dist/index.d.ts  31.56 KB
+DTS dist/index.d.mts 31.56 KB

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @axiom-lattice/local-stores
 
+## 3.0.0
+
+### Major Changes
+
+- 1c783d0: Align A2A with the standard 0.3 protocol.
+
+  **Standard A2A 0.3 server (gateway):** per-assistant discovery and execution via
+  `GET /api/a2a/agents/:assistantId/.well-known/agent-card.json` and
+  `POST /api/a2a/agents/:assistantId/jsonrpc` (`message/send`, `message/stream`,
+  `tasks/get`, `tasks/cancel`), plus an internal `test-call` management route.
+  Every inbound task is persisted as a `TaskItem` (single-ID projection:
+  `TaskItem.id === A2A taskId`). File `bytes` parts are ingested into workspace
+  storage and referenced by URI.
+
+  **API key scope model:** keys are now `tenant + projectId (required) +
+assistantIds[]` whitelist. Added `client.a2aKeys.*` (list/create/delete/disable/
+  enable/rotate) and UI (`A2AKeyList`, `A2AExposureSection` with agent-card preview
+  and dual-mode try-call).
+
+  **Breaking changes:**
+
+  - The legacy custom REST endpoints (`/api/a2a/tasks/send`,
+    `/api/a2a/tasks/:taskId`, `/api/a2a/tasks/:taskId/stream`,
+    `/api/a2a/tasks/:taskId/cancel`) are removed; use the JSON-RPC endpoint instead.
+  - The `A2A_API_KEYS` env format is simplified to `key:tenant:project,...`
+    (no workspace segment); `workspaceId` is removed from the key model and
+    creation flow.
+  - The `x-a2a-agent-id` request header is removed (the assistant is derived from
+    the URL path).
+  - `protocols` self-maintained A2A types are replaced by re-exports of
+    `@a2a-js/sdk` 0.3 types; `A2AApiKeyRecord`/`CreateA2AApiKeyInput` drop
+    `workspaceId` and gain `assistantIds`.
+
+### Patch Changes
+
+- 4de3e59: Harden A2A task persistence with caller-provided local IDs, atomic canceled-state guards across task stores, and request leases that prevent active scoped runtimes from being evicted before or during stream consumption.
+- 1ed2a67: up issues
+- a44c80b: Prevent ordinary channel installation creation from accepting caller IDs, normalize imported installation IDs to UUIDs, and reject duplicate store creates instead of overwriting existing installations.
+- 83e1d5d: Add ProjectKind (business/training/personal) with a per-workspace shared training project. Gateway ensures a default training project exists idempotently on project list and protects the last training project from deletion; personal assistant spaces are marked `personal`; client-sdk `listProjects` accepts a `kind` filter; react-sdk splits business and training projects in WorkspaceContext and pins learning rounds to the read-only shared Training Context via TrainingContextCard. No TrainingWorkspace entity — training isolation reuses the existing projectId scope.
+- e501a4b: Add optional Markdown belief traces and append-only task activities, return recent task work-item history, and align scoped task work-item ordering and filtering across stores.
+- Updated dependencies [4de3e59]
+- Updated dependencies [1c783d0]
+- Updated dependencies [1ed2a67]
+- Updated dependencies [a44c80b]
+- Updated dependencies [83e1d5d]
+- Updated dependencies [139e8f0]
+- Updated dependencies [e501a4b]
+  - @axiom-lattice/protocols@4.0.0
+  - @axiom-lattice/core@4.0.0
+
 ## 2.0.10
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { SqlJsStatic, Database } from 'sql.js';
 import { SqliteSaver } from '@langchain/langgraph-checkpoint-sqlite';
-import { ThreadStore, Thread, CreateThreadRequest, AssistantStore, Assistant, CreateAssistantRequest, WorkspaceStore, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ProjectStore, Project, CreateProjectRequest, UpdateProjectRequest, UserStore, User, CreateUserRequest, UpdateUserRequest, TenantStore, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLinkStore, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, DatabaseConfigStore, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, ConnectionStore, ConnectionEntry, MetricsServerConfigStore, MetricsServerConfigEntry, CreateMetricsServerConfigRequest, UpdateMetricsServerConfigRequest, McpServerConfigStore, McpServerConfigEntry, CreateMcpServerConfigRequest, UpdateMcpServerConfigRequest, WorkflowTrackingStore, CreateWorkflowRunRequest, WorkflowRun, UpdateWorkflowRunRequest, QueryWorkflowRunsOptions, QueryWorkflowRunsResult, CreateRunStepRequest, RunStep, UpdateRunStepRequest, StepType, EvalStore, EvalProject, CreateEvalProjectRequest, EvalSuite, CreateEvalSuiteRequest, EvalCase, CreateEvalCaseRequest, EvalRun, CreateEvalRunRequest, EvalRunResult, EvalProjectReport, BindingRegistry, Binding, CreateBindingInput, ChannelInstallationStore, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, A2AApiKeyStore, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, SkillStore, SkillStoreContext, Skill, CreateSkillRequest, ScheduleStorage, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, TaskStore, CreateTaskRequest, TaskItem, TaskListFilter, UpdateTaskRequest, TaskWorkItemStore, CreateWorkItemRequest, TaskWorkItem, TaskWorkItemListFilter, IConversationStore, ConversationRecord, CreateConversationInput } from '@axiom-lattice/protocols';
+import { ThreadStore, Thread, CreateThreadRequest, AssistantStore, Assistant, CreateAssistantRequest, WorkspaceStore, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ProjectStore, ProjectFilter, Project, CreateProjectRequest, UpdateProjectRequest, UserStore, User, CreateUserRequest, UpdateUserRequest, TenantStore, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLinkStore, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, DatabaseConfigStore, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, ConnectionStore, ConnectionEntry, MetricsServerConfigStore, MetricsServerConfigEntry, CreateMetricsServerConfigRequest, UpdateMetricsServerConfigRequest, McpServerConfigStore, McpServerConfigEntry, CreateMcpServerConfigRequest, UpdateMcpServerConfigRequest, WorkflowTrackingStore, CreateWorkflowRunRequest, WorkflowRun, UpdateWorkflowRunRequest, QueryWorkflowRunsOptions, QueryWorkflowRunsResult, CreateRunStepRequest, RunStep, UpdateRunStepRequest, StepType, EvalStore, EvalProject, CreateEvalProjectRequest, EvalSuite, CreateEvalSuiteRequest, EvalCase, CreateEvalCaseRequest, EvalRun, CreateEvalRunRequest, EvalRunResult, EvalProjectReport, BindingRegistry, Binding, CreateBindingInput, ChannelInstallationStore, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, A2AApiKeyStore, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, SkillStore, SkillStoreContext, Skill, CreateSkillRequest, ScheduleStorage, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, TaskStore, CreateTaskRequest, TaskItem, TaskListFilter, UpdateTaskRequest, TaskWorkItemStore, CreateWorkItemRequest, TaskWorkItem, CreateWorkItemIfAbsentRequest, TaskWorkItemListFilter, IConversationStore, ConversationRecord, CreateConversationInput } from '@axiom-lattice/protocols';
 import { IMessageQueueStore, AddMessageParams, PendingMessage, ThreadInfo } from '@axiom-lattice/core';
 
 /**
@@ -86,8 +86,8 @@ declare class StatementWrapper {
  * Result of a run operation.
  */
 declare class RunResult {
-    private db;
-    constructor(db: Database);
+    private modifiedRows;
+    constructor(modifiedRows: number);
     /** Number of rows modified by the last INSERT/UPDATE/DELETE. */
     get changes(): number;
 }
@@ -239,11 +239,13 @@ declare class LocalWorkspaceStore implements WorkspaceStore {
 declare class LocalProjectStore implements ProjectStore {
     private db;
     constructor(db: DatabaseWrapper);
-    getProjectsByWorkspace(tenantId: string, workspaceId: string): Promise<Project[]>;
+    getProjectsByWorkspace(tenantId: string, workspaceId: string, filter?: ProjectFilter): Promise<Project[]>;
     getProjectById(tenantId: string, id: string): Promise<Project | null>;
     createProject(tenantId: string, workspaceId: string, id: string, data: CreateProjectRequest): Promise<Project>;
     updateProject(tenantId: string, id: string, updates: UpdateProjectRequest): Promise<Project | null>;
     deleteProject(tenantId: string, id: string): Promise<boolean>;
+    /** Add a column if it does not exist (SQLite version compatible). */
+    private ensureColumn;
 }
 
 /**
@@ -485,10 +487,15 @@ declare class LocalChannelInstallationStore implements ChannelInstallationStore
  * Local SQLite implementation of A2AApiKeyStore.
  */
 
+/** SQLite-backed A2A API key persistence for local deployments. */
 declare class LocalA2AApiKeyStore implements A2AApiKeyStore {
     private db;
     constructor(db: DatabaseWrapper);
+    /** Add a column if it does not exist (SQLite version compatible). */
+    private ensureColumn;
+    private repairManagementIds;
     findByKey(key: string): Promise<A2AApiKeyRecord | null>;
+    findById(id: string): Promise<A2AApiKeyRecord | null>;
     list(params: {
         tenantId?: string;
         limit?: number;
@@ -598,6 +605,22 @@ declare class LocalTaskStore implements TaskStore {
     getById(tenantId: string, id: string): Promise<TaskItem | null>;
     list(filter: TaskListFilter): Promise<TaskItem[]>;
     update(tenantId: string, id: string, updates: UpdateTaskRequest): Promise<TaskItem | null>;
+    /**
+     * Atomically update a task unless its current status is blocked.
+     *
+     * @param tenantId Tenant identifier.
+     * @param id Task identifier.
+     * @param updates Partial task data to update.
+     * @param blockedStatuses Current statuses that prevent the update.
+     * @returns The updated task, or `null` when missing or blocked.
+     */
+    updateIfStatusNotIn(tenantId: string, id: string, updates: UpdateTaskRequest, blockedStatuses: TaskItem["status"][]): Promise<TaskItem | null>;
+    /** Atomically update a task only when its current status is expected. */
+    updateIfStatusIn(tenantId: string, id: string, updates: UpdateTaskRequest, expectedStatuses: TaskItem["status"][]): Promise<TaskItem | null>;
+    /** Atomically update a task only when status and updatedAt match a read snapshot. */
+    updateIfStatusAndUpdatedAt(tenantId: string, id: string, updates: UpdateTaskRequest, expectedStatuses: TaskItem["status"][], expectedUpdatedAt: Date | string): Promise<TaskItem | null>;
+    /** Atomically update a child only when both child and parent snapshots match. */
+    updateIfStatusUpdatedAtAndParentUpdatedAt(tenantId: string, id: string, updates: UpdateTaskRequest, expectedStatuses: TaskItem["status"][], expectedUpdatedAt: Date | string, parentId: string, expectedParentUpdatedAt: Date | string): Promise<TaskItem | null>;
     delete(tenantId: string, id: string): Promise<boolean>;
 }
 
@@ -608,7 +631,13 @@ declare class LocalTaskStore implements TaskStore {
 declare class LocalTaskWorkItemStore implements TaskWorkItemStore {
     private db;
     constructor(db: DatabaseWrapper);
+    /** Add a column if it does not exist (SQLite version compatible). */
+    private ensureColumn;
     create(params: CreateWorkItemRequest): Promise<TaskWorkItem>;
+    /** Find an event by its tenant- and task-scoped key without pagination. */
+    findByEventKey(tenantId: string, taskId: string, eventKey: string): Promise<TaskWorkItem | null>;
+    /** Atomically return an existing event or create it once. */
+    createIfAbsentByEventKey(params: CreateWorkItemIfAbsentRequest): Promise<TaskWorkItem>;
     list(filter: TaskWorkItemListFilter): Promise<TaskWorkItem[]>;
 }
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { SqlJsStatic, Database } from 'sql.js';
 import { SqliteSaver } from '@langchain/langgraph-checkpoint-sqlite';
-import { ThreadStore, Thread, CreateThreadRequest, AssistantStore, Assistant, CreateAssistantRequest, WorkspaceStore, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ProjectStore, Project, CreateProjectRequest, UpdateProjectRequest, UserStore, User, CreateUserRequest, UpdateUserRequest, TenantStore, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLinkStore, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, DatabaseConfigStore, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, ConnectionStore, ConnectionEntry, MetricsServerConfigStore, MetricsServerConfigEntry, CreateMetricsServerConfigRequest, UpdateMetricsServerConfigRequest, McpServerConfigStore, McpServerConfigEntry, CreateMcpServerConfigRequest, UpdateMcpServerConfigRequest, WorkflowTrackingStore, CreateWorkflowRunRequest, WorkflowRun, UpdateWorkflowRunRequest, QueryWorkflowRunsOptions, QueryWorkflowRunsResult, CreateRunStepRequest, RunStep, UpdateRunStepRequest, StepType, EvalStore, EvalProject, CreateEvalProjectRequest, EvalSuite, CreateEvalSuiteRequest, EvalCase, CreateEvalCaseRequest, EvalRun, CreateEvalRunRequest, EvalRunResult, EvalProjectReport, BindingRegistry, Binding, CreateBindingInput, ChannelInstallationStore, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, A2AApiKeyStore, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, SkillStore, SkillStoreContext, Skill, CreateSkillRequest, ScheduleStorage, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, TaskStore, CreateTaskRequest, TaskItem, TaskListFilter, UpdateTaskRequest, TaskWorkItemStore, CreateWorkItemRequest, TaskWorkItem, TaskWorkItemListFilter, IConversationStore, ConversationRecord, CreateConversationInput } from '@axiom-lattice/protocols';
+import { ThreadStore, Thread, CreateThreadRequest, AssistantStore, Assistant, CreateAssistantRequest, WorkspaceStore, Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ProjectStore, ProjectFilter, Project, CreateProjectRequest, UpdateProjectRequest, UserStore, User, CreateUserRequest, UpdateUserRequest, TenantStore, Tenant, CreateTenantRequest, UpdateTenantRequest, UserTenantLinkStore, UserTenantLink, CreateUserTenantLinkRequest, UpdateUserTenantLinkRequest, DatabaseConfigStore, DatabaseConfigEntry, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, ConnectionStore, ConnectionEntry, MetricsServerConfigStore, MetricsServerConfigEntry, CreateMetricsServerConfigRequest, UpdateMetricsServerConfigRequest, McpServerConfigStore, McpServerConfigEntry, CreateMcpServerConfigRequest, UpdateMcpServerConfigRequest, WorkflowTrackingStore, CreateWorkflowRunRequest, WorkflowRun, UpdateWorkflowRunRequest, QueryWorkflowRunsOptions, QueryWorkflowRunsResult, CreateRunStepRequest, RunStep, UpdateRunStepRequest, StepType, EvalStore, EvalProject, CreateEvalProjectRequest, EvalSuite, CreateEvalSuiteRequest, EvalCase, CreateEvalCaseRequest, EvalRun, CreateEvalRunRequest, EvalRunResult, EvalProjectReport, BindingRegistry, Binding, CreateBindingInput, ChannelInstallationStore, ChannelInstallation, ChannelInstallationType, CreateChannelInstallationRequest, UpdateChannelInstallationRequest, A2AApiKeyStore, A2AApiKeyRecord, CreateA2AApiKeyInput, A2AApiKeyEntry, SkillStore, SkillStoreContext, Skill, CreateSkillRequest, ScheduleStorage, ScheduledTaskDefinition, ScheduledTaskStatus, ScheduleExecutionType, TaskStore, CreateTaskRequest, TaskItem, TaskListFilter, UpdateTaskRequest, TaskWorkItemStore, CreateWorkItemRequest, TaskWorkItem, CreateWorkItemIfAbsentRequest, TaskWorkItemListFilter, IConversationStore, ConversationRecord, CreateConversationInput } from '@axiom-lattice/protocols';
 import { IMessageQueueStore, AddMessageParams, PendingMessage, ThreadInfo } from '@axiom-lattice/core';
 
 /**
@@ -86,8 +86,8 @@ declare class StatementWrapper {
  * Result of a run operation.
  */
 declare class RunResult {
-    private db;
-    constructor(db: Database);
+    private modifiedRows;
+    constructor(modifiedRows: number);
     /** Number of rows modified by the last INSERT/UPDATE/DELETE. */
     get changes(): number;
 }
@@ -239,11 +239,13 @@ declare class LocalWorkspaceStore implements WorkspaceStore {
 declare class LocalProjectStore implements ProjectStore {
     private db;
     constructor(db: DatabaseWrapper);
-    getProjectsByWorkspace(tenantId: string, workspaceId: string): Promise<Project[]>;
+    getProjectsByWorkspace(tenantId: string, workspaceId: string, filter?: ProjectFilter): Promise<Project[]>;
     getProjectById(tenantId: string, id: string): Promise<Project | null>;
     createProject(tenantId: string, workspaceId: string, id: string, data: CreateProjectRequest): Promise<Project>;
     updateProject(tenantId: string, id: string, updates: UpdateProjectRequest): Promise<Project | null>;
     deleteProject(tenantId: string, id: string): Promise<boolean>;
+    /** Add a column if it does not exist (SQLite version compatible). */
+    private ensureColumn;
 }
 
 /**
@@ -485,10 +487,15 @@ declare class LocalChannelInstallationStore implements ChannelInstallationStore
  * Local SQLite implementation of A2AApiKeyStore.
  */
 
+/** SQLite-backed A2A API key persistence for local deployments. */
 declare class LocalA2AApiKeyStore implements A2AApiKeyStore {
     private db;
     constructor(db: DatabaseWrapper);
+    /** Add a column if it does not exist (SQLite version compatible). */
+    private ensureColumn;
+    private repairManagementIds;
     findByKey(key: string): Promise<A2AApiKeyRecord | null>;
+    findById(id: string): Promise<A2AApiKeyRecord | null>;
     list(params: {
         tenantId?: string;
         limit?: number;
@@ -598,6 +605,22 @@ declare class LocalTaskStore implements TaskStore {
     getById(tenantId: string, id: string): Promise<TaskItem | null>;
     list(filter: TaskListFilter): Promise<TaskItem[]>;
     update(tenantId: string, id: string, updates: UpdateTaskRequest): Promise<TaskItem | null>;
+    /**
+     * Atomically update a task unless its current status is blocked.
+     *
+     * @param tenantId Tenant identifier.
+     * @param id Task identifier.
+     * @param updates Partial task data to update.
+     * @param blockedStatuses Current statuses that prevent the update.
+     * @returns The updated task, or `null` when missing or blocked.
+     */
+    updateIfStatusNotIn(tenantId: string, id: string, updates: UpdateTaskRequest, blockedStatuses: TaskItem["status"][]): Promise<TaskItem | null>;
+    /** Atomically update a task only when its current status is expected. */
+    updateIfStatusIn(tenantId: string, id: string, updates: UpdateTaskRequest, expectedStatuses: TaskItem["status"][]): Promise<TaskItem | null>;
+    /** Atomically update a task only when status and updatedAt match a read snapshot. */
+    updateIfStatusAndUpdatedAt(tenantId: string, id: string, updates: UpdateTaskRequest, expectedStatuses: TaskItem["status"][], expectedUpdatedAt: Date | string): Promise<TaskItem | null>;
+    /** Atomically update a child only when both child and parent snapshots match. */
+    updateIfStatusUpdatedAtAndParentUpdatedAt(tenantId: string, id: string, updates: UpdateTaskRequest, expectedStatuses: TaskItem["status"][], expectedUpdatedAt: Date | string, parentId: string, expectedParentUpdatedAt: Date | string): Promise<TaskItem | null>;
     delete(tenantId: string, id: string): Promise<boolean>;
 }
 
@@ -608,7 +631,13 @@ declare class LocalTaskStore implements TaskStore {
 declare class LocalTaskWorkItemStore implements TaskWorkItemStore {
     private db;
     constructor(db: DatabaseWrapper);
+    /** Add a column if it does not exist (SQLite version compatible). */
+    private ensureColumn;
     create(params: CreateWorkItemRequest): Promise<TaskWorkItem>;
+    /** Find an event by its tenant- and task-scoped key without pagination. */
+    findByEventKey(tenantId: string, taskId: string, eventKey: string): Promise<TaskWorkItem | null>;
+    /** Atomically return an existing event or create it once. */
+    createIfAbsentByEventKey(params: CreateWorkItemIfAbsentRequest): Promise<TaskWorkItem>;
     list(filter: TaskWorkItemListFilter): Promise<TaskWorkItem[]>;
 }