@mastra/factory 0.29.1-alpha.2 → 0.30.0-alpha.3
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/dist/factory.d.ts +13 -4
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +11 -2
- package/dist/factory.js.map +1 -1
- package/dist/routes/knowledge.d.ts +8 -5
- package/dist/routes/knowledge.d.ts.map +1 -1
- package/dist/routes/knowledge.js +25 -3
- package/dist/routes/knowledge.js.map +1 -1
- package/dist/routes/surface.d.ts +1 -0
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +2 -1
- package/dist/routes/surface.js.map +1 -1
- package/package.json +5 -5
package/dist/factory.d.ts
CHANGED
|
@@ -22,7 +22,7 @@ import type { MastraCodeConfig } from '@mastra/code-sdk';
|
|
|
22
22
|
import type { BuiltinToolId } from '@mastra/core/agent-controller';
|
|
23
23
|
import type { MastraBrowser } from '@mastra/core/browser';
|
|
24
24
|
import type { PubSub } from '@mastra/core/events';
|
|
25
|
-
import
|
|
25
|
+
import { Knowledge } from '@mastra/core/knowledge';
|
|
26
26
|
import type { Mastra } from '@mastra/core/mastra';
|
|
27
27
|
import { RequestContext } from '@mastra/core/request-context';
|
|
28
28
|
import type { IMastraAuthProvider } from '@mastra/core/server';
|
|
@@ -91,13 +91,22 @@ export interface MastraFactoryConfig {
|
|
|
91
91
|
*/
|
|
92
92
|
vector?: MastraVector;
|
|
93
93
|
/**
|
|
94
|
-
* Host-owned Knowledge runtime. Factory registers this exact instance under `
|
|
95
|
-
* key for its read surfaces
|
|
94
|
+
* Host-owned Knowledge runtime. Factory registers this exact instance under its `id` and uses that
|
|
95
|
+
* key for its read surfaces; pass `{ key, instance }` to register it under another key. Omitted,
|
|
96
|
+
* Knowledge stays off.
|
|
96
97
|
*/
|
|
97
|
-
knowledge?: {
|
|
98
|
+
knowledge?: Knowledge | {
|
|
98
99
|
key: string;
|
|
99
100
|
instance: Knowledge;
|
|
100
101
|
};
|
|
102
|
+
/**
|
|
103
|
+
* The scopes every Knowledge run acts with, like an Agent's `scopes`, such as `['org:acme']`. With an
|
|
104
|
+
* `org:` here, every project's sessions and Knowledge page act with these alone instead of their own
|
|
105
|
+
* `org:` and `project:` scopes, for a Knowledge instance that declares only that org; every org and
|
|
106
|
+
* project on this Factory then shares it. A `resource:` or `thread:` scope throws, since those are
|
|
107
|
+
* each run's own identity, and so does a `project:` beside an `org:`.
|
|
108
|
+
*/
|
|
109
|
+
scopes?: string[];
|
|
101
110
|
/**
|
|
102
111
|
* Distributed event bus instance (e.g. `new RedisStreamsPubSub({ url })`).
|
|
103
112
|
* When set, streams/workflows/signals ride it across processes and the
|
package/dist/factory.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"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"}
|
package/dist/factory.js
CHANGED
|
@@ -120,8 +120,10 @@ import { EventEmitterPubSub } from "@mastra/core/events";
|
|
|
120
120
|
import { existsSync } from "fs";
|
|
121
121
|
import { prepareAgentControllerMount } from "@mastra/code-sdk";
|
|
122
122
|
import { getDynamicMemory } from "@mastra/code-sdk/agents/memory";
|
|
123
|
+
import { resolveKnowledgeSessionScopes } from "@mastra/code-sdk/knowledge-scope";
|
|
123
124
|
import { getGlobalMcpPath } from "@mastra/code-sdk/mcp/config";
|
|
124
125
|
import { AgentControllerChannels } from "@mastra/core/channels";
|
|
126
|
+
import { Knowledge } from "@mastra/core/knowledge";
|
|
125
127
|
import { readObjective, resolveGoalStore, writeObjective } from "@mastra/core/tools";
|
|
126
128
|
import { describeFactorySandbox, isFactorySandbox } from "@mastra/core/workspace";
|
|
127
129
|
// src/factory.ts
|
|
@@ -289,6 +291,8 @@ var MastraFactory = class {
|
|
|
289
291
|
#preparing = false;
|
|
290
292
|
constructor(config) {
|
|
291
293
|
if (!config?.storage) throw new Error("MastraFactory: 'storage' is required. Pass a FactoryStorage backend — e.g. new PgFactoryStorage({ connectionString }) from '@mastra/pg' for deployments, or new LibSQLFactoryStorage({ url }) from '@mastra/libsql' for local dev.");
|
|
294
|
+
const hostScopes = resolveKnowledgeSessionScopes({ factoryOrgId: "factory" }, config.scopes);
|
|
295
|
+
if (!hostScopes.resolved) throw new Error(`MastraFactory: 'scopes': ${hostScopes.reason}`);
|
|
292
296
|
if (config.includeDefaultBoards !== void 0) warnIncludeDefaultBoards();
|
|
293
297
|
this.#boards = createBoardRegistry({ boards: config.boards });
|
|
294
298
|
warnDefinedBoards(this.#boards);
|
|
@@ -298,7 +302,10 @@ var MastraFactory = class {
|
|
|
298
302
|
this.#forcedIntake = intakeEvaluatorFrom(process.env);
|
|
299
303
|
for (const problem of findBoardSkillProblems(this.#boards, this.#skills)) console.warn(`[factory] ${problem}`);
|
|
300
304
|
this.#configVersion = assertFactoryConfigVersion(config.configVersion ?? "factory-config-v1");
|
|
301
|
-
this.#config =
|
|
305
|
+
this.#config = {
|
|
306
|
+
...config,
|
|
307
|
+
...config.scopes && { scopes: [...config.scopes] }
|
|
308
|
+
};
|
|
302
309
|
this.#metrics = new FactoryMetrics(resolveMetricsConfig(config.metrics), metricsService());
|
|
303
310
|
installFactoryMetrics(this.#metrics);
|
|
304
311
|
}
|
|
@@ -1197,6 +1204,7 @@ var MastraFactory = class {
|
|
|
1197
1204
|
disableScoreStorage: this.#config.disableScoreStorage ?? true,
|
|
1198
1205
|
...mastraStorageBackend ? { storageBackend: mastraStorageBackend } : {},
|
|
1199
1206
|
knowledge: this.#config.knowledge ?? false,
|
|
1207
|
+
scopes: this.#config.scopes,
|
|
1200
1208
|
inputProcessors: async ({ requestContext }) => {
|
|
1201
1209
|
const environmentProcessor = new FactoryEnvironmentStateProcessor();
|
|
1202
1210
|
const sessionsProcessor = workItemsStorage && storage.isDomainReady("source-control") ? [new FactorySessionsStateProcessor({
|
|
@@ -1437,7 +1445,8 @@ var MastraFactory = class {
|
|
|
1437
1445
|
mcpEnabled,
|
|
1438
1446
|
deploymentModelProviders,
|
|
1439
1447
|
skills: this.#skills,
|
|
1440
|
-
knowledgeKey: this.#config.knowledge?.key,
|
|
1448
|
+
knowledgeKey: this.#config.knowledge instanceof Knowledge ? this.#config.knowledge.id : this.#config.knowledge?.key.trim(),
|
|
1449
|
+
knowledgeScopes: this.#config.scopes,
|
|
1441
1450
|
configVersion,
|
|
1442
1451
|
boardRegistry: boards,
|
|
1443
1452
|
intakeEvaluator: this.#forcedIntake,
|