@mastra/clickhouse 1.2.0 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,183 @@
1
1
  # @mastra/clickhouse
2
2
 
3
+ ## 1.2.1
4
+
5
+ ### Patch Changes
6
+
7
+ - Added workspace and skill storage domains with full CRUD, versioning, and implementations across LibSQL, Postgres, and MongoDB. Added `editor.workspace` and `editor.skill` namespaces for managing workspace configurations and skill definitions through the editor. Agents stored in the editor can now reference workspaces (by ID or inline config) and skills, with full hydration to runtime `Workspace` instances during agent resolution. ([#13156](https://github.com/mastra-ai/mastra/pull/13156))
8
+
9
+ **Filesystem-native skill versioning (draft → publish model):**
10
+
11
+ Skills are versioned as filesystem trees with content-addressable blob storage. The editing surface (live filesystem) is separated from the serving surface (versioned blob store), enabling a `draft → publish` workflow:
12
+ - `editor.skill.publish(skillId, source, skillPath)` — Snapshots a skill directory from the filesystem into blob storage, creates a new version with a tree manifest, and sets `activeVersionId`
13
+ - Version switching via `editor.skill.update({ id, activeVersionId })` — Points the skill to a previous version without re-publishing
14
+ - Publishing a skill automatically invalidates cached agents that reference it, so they re-hydrate with the updated version on next access
15
+
16
+ **Agent skill resolution strategies:**
17
+
18
+ Agents can reference skills with different resolution strategies:
19
+ - `strategy: 'latest'` — Resolves the skill's active version (honors `activeVersionId` for rollback)
20
+ - `pin: '<versionId>'` — Pins to a specific version, immune to publishes
21
+ - `strategy: 'live'` — Reads directly from the live filesystem (no blob store)
22
+
23
+ **Blob storage infrastructure:**
24
+ - `BlobStore` abstract class for content-addressable storage keyed by SHA-256 hash
25
+ - `InMemoryBlobStore` for testing
26
+ - LibSQL, Postgres, and MongoDB implementations
27
+ - `S3BlobStore` for storing blobs in S3 or S3-compatible storage (AWS, R2, MinIO, DO Spaces)
28
+ - `BlobStoreProvider` interface and `MastraEditorConfig.blobStores` registry for pluggable blob storage
29
+ - `VersionedSkillSource` and `CompositeVersionedSkillSource` for reading skill files from the blob store at runtime
30
+
31
+ **New storage types:**
32
+ - `StorageWorkspaceSnapshotType` and `StorageSkillSnapshotType` with corresponding input/output types
33
+ - `StorageWorkspaceRef` for ID-based or inline workspace references on agents
34
+ - `StorageSkillConfig` for per-agent skill overrides (`pin`, `strategy`, description, instructions)
35
+ - `SkillVersionTree` and `SkillVersionTreeEntry` for tree manifests
36
+ - `StorageBlobEntry` for content-addressable blob entries
37
+ - `SKILL_BLOBS_SCHEMA` for the `mastra_skill_blobs` table
38
+
39
+ **New editor namespaces:**
40
+ - `editor.workspace` — CRUD for workspace configs, plus `hydrateSnapshotToWorkspace()` for resolving to runtime `Workspace` instances
41
+ - `editor.skill` — CRUD for skill definitions, plus `publish()` for filesystem-to-blob snapshots
42
+
43
+ **Provider registries:**
44
+ - `MastraEditorConfig` accepts `filesystems`, `sandboxes`, and `blobStores` provider registries (keyed by provider ID)
45
+ - Built-in `local` filesystem and sandbox providers are auto-registered
46
+ - `editor.resolveBlobStore()` resolves from provider registry or falls back to the storage backend's blobs domain
47
+ - Providers expose `id`, `name`, `description`, `configSchema` (JSON Schema for UI form rendering), and a factory method
48
+
49
+ **Storage adapter support:**
50
+ - LibSQL: Full `workspaces`, `skills`, and `blobs` domain implementations
51
+ - Postgres: Full `workspaces`, `skills`, and `blobs` domain implementations
52
+ - MongoDB: Full `workspaces`, `skills`, and `blobs` domain implementations
53
+ - All three include `workspace`, `skills`, and `skillsFormat` fields on agent versions
54
+
55
+ **Server endpoints:**
56
+ - `GET/POST/PATCH/DELETE /stored/workspaces` — CRUD for stored workspaces
57
+ - `GET/POST/PATCH/DELETE /stored/skills` — CRUD for stored skills
58
+ - `POST /stored/skills/:id/publish` — Publish a skill from a filesystem source
59
+
60
+ ```ts
61
+ import { MastraEditor } from '@mastra/editor';
62
+ import { s3FilesystemProvider, s3BlobStoreProvider } from '@mastra/s3';
63
+ import { e2bSandboxProvider } from '@mastra/e2b';
64
+
65
+ const editor = new MastraEditor({
66
+ filesystems: { s3: s3FilesystemProvider },
67
+ sandboxes: { e2b: e2bSandboxProvider },
68
+ blobStores: { s3: s3BlobStoreProvider },
69
+ });
70
+
71
+ // Create a skill and publish it
72
+ const skill = await editor.skill.create({
73
+ name: 'Code Review',
74
+ description: 'Reviews code for best practices',
75
+ instructions: 'Analyze the code and provide feedback...',
76
+ });
77
+ await editor.skill.publish(skill.id, source, 'skills/code-review');
78
+
79
+ // Agents resolve skills by strategy
80
+ await editor.agent.create({
81
+ name: 'Dev Assistant',
82
+ model: { provider: 'openai', name: 'gpt-4' },
83
+ workspace: { type: 'id', workspaceId: workspace.id },
84
+ skills: { [skill.id]: { strategy: 'latest' } },
85
+ skillsFormat: 'xml',
86
+ });
87
+ ```
88
+
89
+ - Updated dependencies [[`252580a`](https://github.com/mastra-ai/mastra/commit/252580a71feb0e46d0ccab04a70a79ff6a2ee0ab), [`f8e819f`](https://github.com/mastra-ai/mastra/commit/f8e819fabdfdc43d2da546a3ad81ba23685f603d), [`5c75261`](https://github.com/mastra-ai/mastra/commit/5c7526120d936757d4ffb7b82232e1641ebd45cb), [`e27d832`](https://github.com/mastra-ai/mastra/commit/e27d83281b5e166fd63a13969689e928d8605944), [`e37ef84`](https://github.com/mastra-ai/mastra/commit/e37ef8404043c94ca0c8e35ecdedb093b8087878), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`10cf521`](https://github.com/mastra-ai/mastra/commit/10cf52183344743a0d7babe24cd24fd78870c354), [`efdb682`](https://github.com/mastra-ai/mastra/commit/efdb682887f6522149769383908f9790c188ab88), [`0dee7a0`](https://github.com/mastra-ai/mastra/commit/0dee7a0ff4c2507e6eb6e6ee5f9738877ebd4ad1), [`04c2c8e`](https://github.com/mastra-ai/mastra/commit/04c2c8e888984364194131aecb490a3d6e920e61), [`02dc07a`](https://github.com/mastra-ai/mastra/commit/02dc07acc4ad42d93335825e3308f5b42266eba2), [`bb7262b`](https://github.com/mastra-ai/mastra/commit/bb7262b7c0ca76320d985b40510b6ffbbb936582), [`cf1c6e7`](https://github.com/mastra-ai/mastra/commit/cf1c6e789b131f55638fed52183a89d5078b4876), [`5ffadfe`](https://github.com/mastra-ai/mastra/commit/5ffadfefb1468ac2612b20bb84d24c39de6961c0), [`1e1339c`](https://github.com/mastra-ai/mastra/commit/1e1339cc276e571a48cfff5014487877086bfe68), [`d03df73`](https://github.com/mastra-ai/mastra/commit/d03df73f8fe9496064a33e1c3b74ba0479bf9ee6), [`79b8f45`](https://github.com/mastra-ai/mastra/commit/79b8f45a6767e1a5c3d56cd3c5b1214326b81661), [`9bbf08e`](https://github.com/mastra-ai/mastra/commit/9bbf08e3c20731c79dea13a765895b9fcf29cbf1), [`0a25952`](https://github.com/mastra-ai/mastra/commit/0a259526b5e1ac11e6efa53db1f140272962af2d), [`ffa5468`](https://github.com/mastra-ai/mastra/commit/ffa546857fc4821753979b3a34e13b4d76fbbcd4), [`3264a04`](https://github.com/mastra-ai/mastra/commit/3264a04e30340c3c5447433300a035ea0878df85), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`088d9ba`](https://github.com/mastra-ai/mastra/commit/088d9ba2577518703c52b0dccd617178d9ee6b0d), [`74fbebd`](https://github.com/mastra-ai/mastra/commit/74fbebd918a03832a2864965a8bea59bf617d3a2), [`aea6217`](https://github.com/mastra-ai/mastra/commit/aea621790bfb2291431b08da0cc5e6e150303ae7), [`b6a855e`](https://github.com/mastra-ai/mastra/commit/b6a855edc056e088279075506442ba1d6fa6def9), [`ae408ea`](https://github.com/mastra-ai/mastra/commit/ae408ea7128f0d2710b78d8623185198e7cb19c1), [`17e942e`](https://github.com/mastra-ai/mastra/commit/17e942eee2ba44985b1f807e6208cdde672f82f9), [`2015cf9`](https://github.com/mastra-ai/mastra/commit/2015cf921649f44c3f5bcd32a2c052335f8e49b4), [`7ef454e`](https://github.com/mastra-ai/mastra/commit/7ef454eaf9dcec6de60021c8f42192052dd490d6), [`2be1d99`](https://github.com/mastra-ai/mastra/commit/2be1d99564ce79acc4846071082bff353035a87a), [`2708fa1`](https://github.com/mastra-ai/mastra/commit/2708fa1055ac91c03e08b598869f6b8fb51fa37f), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ec53e89`](https://github.com/mastra-ai/mastra/commit/ec53e8939c76c638991e21af762e51378eff7543), [`9b5a8cb`](https://github.com/mastra-ai/mastra/commit/9b5a8cb13e120811b0bf14140ada314f1c067894), [`607e66b`](https://github.com/mastra-ai/mastra/commit/607e66b02dc7f531ee37799f3456aa2dc0ca7ac5), [`a215d06`](https://github.com/mastra-ai/mastra/commit/a215d06758dcf590eabfe0b7afd4ae39bdbf082c), [`6909c74`](https://github.com/mastra-ai/mastra/commit/6909c74a7781e0447d475e9dbc1dc871b700f426), [`192438f`](https://github.com/mastra-ai/mastra/commit/192438f8a90c4f375e955f8ff179bf8dc6821a83)]:
90
+ - @mastra/core@1.5.0
91
+
92
+ ## 1.2.1-alpha.0
93
+
94
+ ### Patch Changes
95
+
96
+ - Added workspace and skill storage domains with full CRUD, versioning, and implementations across LibSQL, Postgres, and MongoDB. Added `editor.workspace` and `editor.skill` namespaces for managing workspace configurations and skill definitions through the editor. Agents stored in the editor can now reference workspaces (by ID or inline config) and skills, with full hydration to runtime `Workspace` instances during agent resolution. ([#13156](https://github.com/mastra-ai/mastra/pull/13156))
97
+
98
+ **Filesystem-native skill versioning (draft → publish model):**
99
+
100
+ Skills are versioned as filesystem trees with content-addressable blob storage. The editing surface (live filesystem) is separated from the serving surface (versioned blob store), enabling a `draft → publish` workflow:
101
+ - `editor.skill.publish(skillId, source, skillPath)` — Snapshots a skill directory from the filesystem into blob storage, creates a new version with a tree manifest, and sets `activeVersionId`
102
+ - Version switching via `editor.skill.update({ id, activeVersionId })` — Points the skill to a previous version without re-publishing
103
+ - Publishing a skill automatically invalidates cached agents that reference it, so they re-hydrate with the updated version on next access
104
+
105
+ **Agent skill resolution strategies:**
106
+
107
+ Agents can reference skills with different resolution strategies:
108
+ - `strategy: 'latest'` — Resolves the skill's active version (honors `activeVersionId` for rollback)
109
+ - `pin: '<versionId>'` — Pins to a specific version, immune to publishes
110
+ - `strategy: 'live'` — Reads directly from the live filesystem (no blob store)
111
+
112
+ **Blob storage infrastructure:**
113
+ - `BlobStore` abstract class for content-addressable storage keyed by SHA-256 hash
114
+ - `InMemoryBlobStore` for testing
115
+ - LibSQL, Postgres, and MongoDB implementations
116
+ - `S3BlobStore` for storing blobs in S3 or S3-compatible storage (AWS, R2, MinIO, DO Spaces)
117
+ - `BlobStoreProvider` interface and `MastraEditorConfig.blobStores` registry for pluggable blob storage
118
+ - `VersionedSkillSource` and `CompositeVersionedSkillSource` for reading skill files from the blob store at runtime
119
+
120
+ **New storage types:**
121
+ - `StorageWorkspaceSnapshotType` and `StorageSkillSnapshotType` with corresponding input/output types
122
+ - `StorageWorkspaceRef` for ID-based or inline workspace references on agents
123
+ - `StorageSkillConfig` for per-agent skill overrides (`pin`, `strategy`, description, instructions)
124
+ - `SkillVersionTree` and `SkillVersionTreeEntry` for tree manifests
125
+ - `StorageBlobEntry` for content-addressable blob entries
126
+ - `SKILL_BLOBS_SCHEMA` for the `mastra_skill_blobs` table
127
+
128
+ **New editor namespaces:**
129
+ - `editor.workspace` — CRUD for workspace configs, plus `hydrateSnapshotToWorkspace()` for resolving to runtime `Workspace` instances
130
+ - `editor.skill` — CRUD for skill definitions, plus `publish()` for filesystem-to-blob snapshots
131
+
132
+ **Provider registries:**
133
+ - `MastraEditorConfig` accepts `filesystems`, `sandboxes`, and `blobStores` provider registries (keyed by provider ID)
134
+ - Built-in `local` filesystem and sandbox providers are auto-registered
135
+ - `editor.resolveBlobStore()` resolves from provider registry or falls back to the storage backend's blobs domain
136
+ - Providers expose `id`, `name`, `description`, `configSchema` (JSON Schema for UI form rendering), and a factory method
137
+
138
+ **Storage adapter support:**
139
+ - LibSQL: Full `workspaces`, `skills`, and `blobs` domain implementations
140
+ - Postgres: Full `workspaces`, `skills`, and `blobs` domain implementations
141
+ - MongoDB: Full `workspaces`, `skills`, and `blobs` domain implementations
142
+ - All three include `workspace`, `skills`, and `skillsFormat` fields on agent versions
143
+
144
+ **Server endpoints:**
145
+ - `GET/POST/PATCH/DELETE /stored/workspaces` — CRUD for stored workspaces
146
+ - `GET/POST/PATCH/DELETE /stored/skills` — CRUD for stored skills
147
+ - `POST /stored/skills/:id/publish` — Publish a skill from a filesystem source
148
+
149
+ ```ts
150
+ import { MastraEditor } from '@mastra/editor';
151
+ import { s3FilesystemProvider, s3BlobStoreProvider } from '@mastra/s3';
152
+ import { e2bSandboxProvider } from '@mastra/e2b';
153
+
154
+ const editor = new MastraEditor({
155
+ filesystems: { s3: s3FilesystemProvider },
156
+ sandboxes: { e2b: e2bSandboxProvider },
157
+ blobStores: { s3: s3BlobStoreProvider },
158
+ });
159
+
160
+ // Create a skill and publish it
161
+ const skill = await editor.skill.create({
162
+ name: 'Code Review',
163
+ description: 'Reviews code for best practices',
164
+ instructions: 'Analyze the code and provide feedback...',
165
+ });
166
+ await editor.skill.publish(skill.id, source, 'skills/code-review');
167
+
168
+ // Agents resolve skills by strategy
169
+ await editor.agent.create({
170
+ name: 'Dev Assistant',
171
+ model: { provider: 'openai', name: 'gpt-4' },
172
+ workspace: { type: 'id', workspaceId: workspace.id },
173
+ skills: { [skill.id]: { strategy: 'latest' } },
174
+ skillsFormat: 'xml',
175
+ });
176
+ ```
177
+
178
+ - Updated dependencies [[`252580a`](https://github.com/mastra-ai/mastra/commit/252580a71feb0e46d0ccab04a70a79ff6a2ee0ab), [`f8e819f`](https://github.com/mastra-ai/mastra/commit/f8e819fabdfdc43d2da546a3ad81ba23685f603d), [`5c75261`](https://github.com/mastra-ai/mastra/commit/5c7526120d936757d4ffb7b82232e1641ebd45cb), [`e27d832`](https://github.com/mastra-ai/mastra/commit/e27d83281b5e166fd63a13969689e928d8605944), [`e37ef84`](https://github.com/mastra-ai/mastra/commit/e37ef8404043c94ca0c8e35ecdedb093b8087878), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`10cf521`](https://github.com/mastra-ai/mastra/commit/10cf52183344743a0d7babe24cd24fd78870c354), [`efdb682`](https://github.com/mastra-ai/mastra/commit/efdb682887f6522149769383908f9790c188ab88), [`0dee7a0`](https://github.com/mastra-ai/mastra/commit/0dee7a0ff4c2507e6eb6e6ee5f9738877ebd4ad1), [`04c2c8e`](https://github.com/mastra-ai/mastra/commit/04c2c8e888984364194131aecb490a3d6e920e61), [`02dc07a`](https://github.com/mastra-ai/mastra/commit/02dc07acc4ad42d93335825e3308f5b42266eba2), [`bb7262b`](https://github.com/mastra-ai/mastra/commit/bb7262b7c0ca76320d985b40510b6ffbbb936582), [`cf1c6e7`](https://github.com/mastra-ai/mastra/commit/cf1c6e789b131f55638fed52183a89d5078b4876), [`5ffadfe`](https://github.com/mastra-ai/mastra/commit/5ffadfefb1468ac2612b20bb84d24c39de6961c0), [`1e1339c`](https://github.com/mastra-ai/mastra/commit/1e1339cc276e571a48cfff5014487877086bfe68), [`d03df73`](https://github.com/mastra-ai/mastra/commit/d03df73f8fe9496064a33e1c3b74ba0479bf9ee6), [`79b8f45`](https://github.com/mastra-ai/mastra/commit/79b8f45a6767e1a5c3d56cd3c5b1214326b81661), [`9bbf08e`](https://github.com/mastra-ai/mastra/commit/9bbf08e3c20731c79dea13a765895b9fcf29cbf1), [`0a25952`](https://github.com/mastra-ai/mastra/commit/0a259526b5e1ac11e6efa53db1f140272962af2d), [`ffa5468`](https://github.com/mastra-ai/mastra/commit/ffa546857fc4821753979b3a34e13b4d76fbbcd4), [`3264a04`](https://github.com/mastra-ai/mastra/commit/3264a04e30340c3c5447433300a035ea0878df85), [`6fdd3d4`](https://github.com/mastra-ai/mastra/commit/6fdd3d451a07a8e7e216c62ac364f8dd8e36c2af), [`088d9ba`](https://github.com/mastra-ai/mastra/commit/088d9ba2577518703c52b0dccd617178d9ee6b0d), [`74fbebd`](https://github.com/mastra-ai/mastra/commit/74fbebd918a03832a2864965a8bea59bf617d3a2), [`aea6217`](https://github.com/mastra-ai/mastra/commit/aea621790bfb2291431b08da0cc5e6e150303ae7), [`b6a855e`](https://github.com/mastra-ai/mastra/commit/b6a855edc056e088279075506442ba1d6fa6def9), [`ae408ea`](https://github.com/mastra-ai/mastra/commit/ae408ea7128f0d2710b78d8623185198e7cb19c1), [`17e942e`](https://github.com/mastra-ai/mastra/commit/17e942eee2ba44985b1f807e6208cdde672f82f9), [`2015cf9`](https://github.com/mastra-ai/mastra/commit/2015cf921649f44c3f5bcd32a2c052335f8e49b4), [`7ef454e`](https://github.com/mastra-ai/mastra/commit/7ef454eaf9dcec6de60021c8f42192052dd490d6), [`2be1d99`](https://github.com/mastra-ai/mastra/commit/2be1d99564ce79acc4846071082bff353035a87a), [`2708fa1`](https://github.com/mastra-ai/mastra/commit/2708fa1055ac91c03e08b598869f6b8fb51fa37f), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ba74aef`](https://github.com/mastra-ai/mastra/commit/ba74aef5716142dbbe931351f5243c9c6e4128a9), [`ec53e89`](https://github.com/mastra-ai/mastra/commit/ec53e8939c76c638991e21af762e51378eff7543), [`9b5a8cb`](https://github.com/mastra-ai/mastra/commit/9b5a8cb13e120811b0bf14140ada314f1c067894), [`607e66b`](https://github.com/mastra-ai/mastra/commit/607e66b02dc7f531ee37799f3456aa2dc0ca7ac5), [`a215d06`](https://github.com/mastra-ai/mastra/commit/a215d06758dcf590eabfe0b7afd4ae39bdbf082c), [`6909c74`](https://github.com/mastra-ai/mastra/commit/6909c74a7781e0447d475e9dbc1dc871b700f426), [`192438f`](https://github.com/mastra-ai/mastra/commit/192438f8a90c4f375e955f8ff179bf8dc6821a83)]:
179
+ - @mastra/core@1.5.0-alpha.0
180
+
3
181
  ## 1.2.0
4
182
 
5
183
  ### Minor Changes
@@ -3,7 +3,7 @@ name: mastra-clickhouse
3
3
  description: Documentation for @mastra/clickhouse. Use when working with @mastra/clickhouse APIs, configuration, or implementation.
4
4
  metadata:
5
5
  package: "@mastra/clickhouse"
6
- version: "1.2.0"
6
+ version: "1.2.1"
7
7
  ---
8
8
 
9
9
  ## When to use
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.2.0",
2
+ "version": "1.2.1",
3
3
  "package": "@mastra/clickhouse",
4
4
  "exports": {},
5
5
  "modules": {}
package/dist/index.cjs CHANGED
@@ -31,7 +31,12 @@ var TABLE_ENGINES = {
31
31
  [storage.TABLE_SCORER_DEFINITIONS]: `ReplacingMergeTree()`,
32
32
  [storage.TABLE_SCORER_DEFINITION_VERSIONS]: `MergeTree()`,
33
33
  [storage.TABLE_MCP_CLIENTS]: `ReplacingMergeTree()`,
34
- [storage.TABLE_MCP_CLIENT_VERSIONS]: `MergeTree()`
34
+ [storage.TABLE_MCP_CLIENT_VERSIONS]: `MergeTree()`,
35
+ [storage.TABLE_WORKSPACES]: `ReplacingMergeTree()`,
36
+ [storage.TABLE_WORKSPACE_VERSIONS]: `MergeTree()`,
37
+ [storage.TABLE_SKILLS]: `ReplacingMergeTree()`,
38
+ [storage.TABLE_SKILL_VERSIONS]: `MergeTree()`,
39
+ [storage.TABLE_SKILL_BLOBS]: `ReplacingMergeTree()`
35
40
  };
36
41
  var COLUMN_TYPES = {
37
42
  text: "String",