@mastra/factory 0.24.0-alpha.1 → 0.24.0-alpha.10

package/dist/timing.d.ts

@@ -5,6 +5,29 @@
  * grepped (`[factory:timing]`) and diffed across runs to localize slow boot
  * phases and slow per-request dependencies.
  */
+import type { Context } from 'hono';
+/**
+ * Verbose per-operation timing (HTTP requests, storage calls, sandbox
+ * commands). Off by default; enable per deployment with `FACTORY_TIMING=1`.
+ */
+export declare const factoryTimingEnabled: boolean;
+/** Run `fn`, logging its duration only when `FACTORY_TIMING` is enabled. */
+export declare function timed<T>(phase: string, fn: () => Promise<T>): Promise<T>;
+/** Hono middleware logging method, path, status, and duration of each request. */
+export declare function createRequestTimingMiddleware(): (c: Context, next: () => Promise<void>) => Promise<void>;
+/**
+ * Patch `methods` on `target` in place so each call logs `<label>.<method>`
+ * duration. In-place (not a Proxy) so object identity is preserved.
+ */
+export declare function instrumentMethods<T extends object>(target: T, label: string, methods: readonly string[]): T;
+/**
+ * Wrap every async method on `target` so each call logs `<label>.<method>`
+ * duration. Domains passed to a `registerDomain` method are instrumented in
+ * place as `<label>.<domain name>`, so the handle it returns and later
+ * `getDomain` lookups are the same timed object. Returns `target` unchanged
+ * when timing is disabled.
+ */
+export declare function instrumentAsyncMethods<T extends object>(target: T, label: string): T;
 /** Run `fn`, always logging its duration under `phase`. Boot-phase use. */
 export declare function timedPhase<T>(phase: string, fn: () => Promise<T>): Promise<T>;
 /**

package/dist/timing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../src/timing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2EAA2E;AAC3E,wBAAsB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOnF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUjH"}
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../src/timing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,SAA2D,CAAC;AAM7F,4EAA4E;AAC5E,wBAAsB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ9E;AAED,kFAAkF;AAClF,wBAAgB,6BAA6B,KAC7B,GAAG,OAAO,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC,KAAG,OAAO,CAAC,IAAI,CAAC,CAQpE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,CAgB3G;AAmBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAyBpF;AAED,2EAA2E;AAC3E,wBAAsB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOnF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUjH"}

package/dist/timing.js

@@ -1,11 +1,90 @@
 //#region src/timing.ts
 /**
-* Lightweight phase timing for factory boot and hot request paths.
-*
-* Deliberately not a metrics framework: structured stderr lines that can be
-* grepped (`[factory:timing]`) and diffed across runs to localize slow boot
-* phases and slow per-request dependencies.
+* Verbose per-operation timing (HTTP requests, storage calls, sandbox
+* commands). Off by default; enable per deployment with `FACTORY_TIMING=1`.
 */
+const factoryTimingEnabled = /^(1|true|yes)$/i.test(process.env.FACTORY_TIMING ?? "");
+function logTiming(line) {
+	process.stderr.write(`[factory:timing] ${line}\n`);
+}
+/** Run `fn`, logging its duration only when `FACTORY_TIMING` is enabled. */
+async function timed(phase, fn) {
+	if (!factoryTimingEnabled) return fn();
+	const start = performance.now();
+	try {
+		return await fn();
+	} finally {
+		logTiming(`${phase} ${Math.round(performance.now() - start)}ms`);
+	}
+}
+/** Hono middleware logging method, path, status, and duration of each request. */
+function createRequestTimingMiddleware() {
+	return async (c, next) => {
+		const start = performance.now();
+		try {
+			await next();
+		} finally {
+			logTiming(`http ${c.req.method} ${c.req.path} ${c.res.status} ${Math.round(performance.now() - start)}ms`);
+		}
+	};
+}
+/**
+* Patch `methods` on `target` in place so each call logs `<label>.<method>`
+* duration. In-place (not a Proxy) so object identity is preserved.
+*/
+function instrumentMethods(target, label, methods) {
+	if (!factoryTimingEnabled) return target;
+	const record = target;
+	for (const name of methods) {
+		const original = record[name];
+		if (typeof original !== "function") continue;
+		record[name] = (...args) => {
+			const start = performance.now();
+			const result = original.apply(target, args);
+			if (result instanceof Promise) return result.finally(() => logTiming(`${label}.${name} ${Math.round(performance.now() - start)}ms`));
+			return result;
+		};
+	}
+	return target;
+}
+/** Every method name on `target`'s prototype chain, excluding `Object.prototype`. */
+function prototypeMethodNames(target) {
+	const names = /* @__PURE__ */ new Set();
+	for (let proto = Object.getPrototypeOf(target); proto && proto !== Object.prototype; proto = Object.getPrototypeOf(proto)) for (const name of Object.getOwnPropertyNames(proto)) {
+		if (name === "constructor") continue;
+		if (typeof Object.getOwnPropertyDescriptor(proto, name)?.value === "function") names.add(name);
+	}
+	return [...names];
+}
+/**
+* Wrap every async method on `target` so each call logs `<label>.<method>`
+* duration. Domains passed to a `registerDomain` method are instrumented in
+* place as `<label>.<domain name>`, so the handle it returns and later
+* `getDomain` lookups are the same timed object. Returns `target` unchanged
+* when timing is disabled.
+*/
+function instrumentAsyncMethods(target, label) {
+	if (!factoryTimingEnabled) return target;
+	const wrapped = /* @__PURE__ */ new Map();
+	return new Proxy(target, { get(obj, prop, receiver) {
+		const value = Reflect.get(obj, prop, receiver);
+		if (typeof value !== "function" || typeof prop === "symbol" || prop === "constructor") return value;
+		const cached = wrapped.get(prop);
+		if (cached) return cached;
+		const fn = (...args) => {
+			const start = performance.now();
+			const result = value.apply(obj, args);
+			if (prop === "registerDomain" && result && typeof result === "object" && !(result instanceof Promise)) {
+				const name = result.name;
+				return instrumentMethods(result, `${label}.${String(name)}`, prototypeMethodNames(result));
+			}
+			if (result instanceof Promise) return result.finally(() => logTiming(`${label}.${prop} ${Math.round(performance.now() - start)}ms`));
+			return result;
+		};
+		wrapped.set(prop, fn);
+		return fn;
+	} });
+}
 /** Run `fn`, always logging its duration under `phase`. Boot-phase use. */
 async function timedPhase(phase, fn) {
 	const start = performance.now();
@@ -29,6 +108,6 @@ async function timedAboveThreshold(phase, thresholdMs, fn) {
 	}
 }
 //#endregion
-export { timedAboveThreshold, timedPhase };
+export { createRequestTimingMiddleware, factoryTimingEnabled, instrumentAsyncMethods, instrumentMethods, timed, timedAboveThreshold, timedPhase };
 
 //# sourceMappingURL=timing.js.map

package/dist/timing.js.map

@@ -1 +1 @@
-{"version":3,"file":"timing.js","names":[],"sources":["../src/timing.ts"],"sourcesContent":["/**\n * Lightweight phase timing for factory boot and hot request paths.\n *\n * Deliberately not a metrics framework: structured stderr lines that can be\n * grepped (`[factory:timing]`) and diffed across runs to localize slow boot\n * phases and slow per-request dependencies.\n */\n\n/** Run `fn`, always logging its duration under `phase`. Boot-phase use. */\nexport async function timedPhase<T>(phase: string, fn: () => Promise<T>): Promise<T> {\n  const start = performance.now();\n  try {\n    return await fn();\n  } finally {\n    process.stderr.write(`[factory:timing] ${phase} ${Math.round(performance.now() - start)}ms\\n`);\n  }\n}\n\n/**\n * Run `fn`, logging only when it exceeds `thresholdMs`. Request-path use,\n * where per-request logging would be noise but slow outliers must surface.\n */\nexport async function timedAboveThreshold<T>(phase: string, thresholdMs: number, fn: () => Promise<T>): Promise<T> {\n  const start = performance.now();\n  try {\n    return await fn();\n  } finally {\n    const elapsed = performance.now() - start;\n    if (elapsed > thresholdMs) {\n      process.stderr.write(`[factory:timing] slow ${phase} ${Math.round(elapsed)}ms\\n`);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AASA,eAAsB,WAAc,OAAe,IAAkC;CACnF,MAAM,QAAQ,YAAY,IAAI;CAC9B,IAAI;EACF,OAAO,MAAM,GAAG;CAClB,UAAU;EACR,QAAQ,OAAO,MAAM,oBAAoB,MAAM,GAAG,KAAK,MAAM,YAAY,IAAI,IAAI,KAAK,EAAE,KAAK;CAC/F;AACF;;;;;AAMA,eAAsB,oBAAuB,OAAe,aAAqB,IAAkC;CACjH,MAAM,QAAQ,YAAY,IAAI;CAC9B,IAAI;EACF,OAAO,MAAM,GAAG;CAClB,UAAU;EACR,MAAM,UAAU,YAAY,IAAI,IAAI;EACpC,IAAI,UAAU,aACZ,QAAQ,OAAO,MAAM,yBAAyB,MAAM,GAAG,KAAK,MAAM,OAAO,EAAE,KAAK;CAEpF;AACF"}
+{"version":3,"file":"timing.js","names":[],"sources":["../src/timing.ts"],"sourcesContent":["/**\n * Lightweight phase timing for factory boot and hot request paths.\n *\n * Deliberately not a metrics framework: structured stderr lines that can be\n * grepped (`[factory:timing]`) and diffed across runs to localize slow boot\n * phases and slow per-request dependencies.\n */\n\nimport type { Context } from 'hono';\n\n/**\n * Verbose per-operation timing (HTTP requests, storage calls, sandbox\n * commands). Off by default; enable per deployment with `FACTORY_TIMING=1`.\n */\nexport const factoryTimingEnabled = /^(1|true|yes)$/i.test(process.env.FACTORY_TIMING ?? '');\n\nfunction logTiming(line: string): void {\n  process.stderr.write(`[factory:timing] ${line}\\n`);\n}\n\n/** Run `fn`, logging its duration only when `FACTORY_TIMING` is enabled. */\nexport async function timed<T>(phase: string, fn: () => Promise<T>): Promise<T> {\n  if (!factoryTimingEnabled) return fn();\n  const start = performance.now();\n  try {\n    return await fn();\n  } finally {\n    logTiming(`${phase} ${Math.round(performance.now() - start)}ms`);\n  }\n}\n\n/** Hono middleware logging method, path, status, and duration of each request. */\nexport function createRequestTimingMiddleware() {\n  return async (c: Context, next: () => Promise<void>): Promise<void> => {\n    const start = performance.now();\n    try {\n      await next();\n    } finally {\n      logTiming(`http ${c.req.method} ${c.req.path} ${c.res.status} ${Math.round(performance.now() - start)}ms`);\n    }\n  };\n}\n\n/**\n * Patch `methods` on `target` in place so each call logs `<label>.<method>`\n * duration. In-place (not a Proxy) so object identity is preserved.\n */\nexport function instrumentMethods<T extends object>(target: T, label: string, methods: readonly string[]): T {\n  if (!factoryTimingEnabled) return target;\n  const record = target as Record<string, unknown>;\n  for (const name of methods) {\n    const original = record[name];\n    if (typeof original !== 'function') continue;\n    record[name] = (...args: unknown[]) => {\n      const start = performance.now();\n      const result = original.apply(target, args);\n      if (result instanceof Promise) {\n        return result.finally(() => logTiming(`${label}.${name} ${Math.round(performance.now() - start)}ms`));\n      }\n      return result;\n    };\n  }\n  return target;\n}\n\n/** Every method name on `target`'s prototype chain, excluding `Object.prototype`. */\nfunction prototypeMethodNames(target: object): string[] {\n  const names = new Set<string>();\n  for (\n    let proto = Object.getPrototypeOf(target);\n    proto && proto !== Object.prototype;\n    proto = Object.getPrototypeOf(proto)\n  ) {\n    for (const name of Object.getOwnPropertyNames(proto)) {\n      if (name === 'constructor') continue;\n      const descriptor = Object.getOwnPropertyDescriptor(proto, name);\n      if (typeof descriptor?.value === 'function') names.add(name);\n    }\n  }\n  return [...names];\n}\n\n/**\n * Wrap every async method on `target` so each call logs `<label>.<method>`\n * duration. Domains passed to a `registerDomain` method are instrumented in\n * place as `<label>.<domain name>`, so the handle it returns and later\n * `getDomain` lookups are the same timed object. Returns `target` unchanged\n * when timing is disabled.\n */\nexport function instrumentAsyncMethods<T extends object>(target: T, label: string): T {\n  if (!factoryTimingEnabled) return target;\n  const wrapped = new Map<PropertyKey, unknown>();\n  return new Proxy(target, {\n    get(obj, prop, receiver) {\n      const value = Reflect.get(obj, prop, receiver);\n      if (typeof value !== 'function' || typeof prop === 'symbol' || prop === 'constructor') return value;\n      const cached = wrapped.get(prop);\n      if (cached) return cached;\n      const fn = (...args: unknown[]) => {\n        const start = performance.now();\n        const result = value.apply(obj, args);\n        if (prop === 'registerDomain' && result && typeof result === 'object' && !(result instanceof Promise)) {\n          const name = (result as { name?: unknown }).name;\n          return instrumentMethods(result, `${label}.${String(name)}`, prototypeMethodNames(result));\n        }\n        if (result instanceof Promise) {\n          return result.finally(() => logTiming(`${label}.${prop} ${Math.round(performance.now() - start)}ms`));\n        }\n        return result;\n      };\n      wrapped.set(prop, fn);\n      return fn;\n    },\n  });\n}\n\n/** Run `fn`, always logging its duration under `phase`. Boot-phase use. */\nexport async function timedPhase<T>(phase: string, fn: () => Promise<T>): Promise<T> {\n  const start = performance.now();\n  try {\n    return await fn();\n  } finally {\n    process.stderr.write(`[factory:timing] ${phase} ${Math.round(performance.now() - start)}ms\\n`);\n  }\n}\n\n/**\n * Run `fn`, logging only when it exceeds `thresholdMs`. Request-path use,\n * where per-request logging would be noise but slow outliers must surface.\n */\nexport async function timedAboveThreshold<T>(phase: string, thresholdMs: number, fn: () => Promise<T>): Promise<T> {\n  const start = performance.now();\n  try {\n    return await fn();\n  } finally {\n    const elapsed = performance.now() - start;\n    if (elapsed > thresholdMs) {\n      process.stderr.write(`[factory:timing] slow ${phase} ${Math.round(elapsed)}ms\\n`);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/tools/annotations.d.ts

@@ -0,0 +1,7 @@
+import type { ToolAnnotations } from '@mastra/core/tools';
+/**
+ * MCP hints for each Factory tool, so clients like ChatGPT can tell lookups
+ * from writes and ask before a tool changes or discards state.
+ */
+export declare const FACTORY_TOOL_ANNOTATIONS: Record<string, ToolAnnotations>;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/tools/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../src/tools/annotations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAY1D;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAkBpE,CAAC"}

package/dist/tools/annotations.js

@@ -0,0 +1,102 @@
+//#region src/tools/annotations.ts
+const read = {
+	readOnlyHint: true,
+	destructiveHint: false,
+	idempotentHint: true,
+	openWorldHint: false
+};
+const additive = {
+	readOnlyHint: false,
+	destructiveHint: false,
+	openWorldHint: false
+};
+const toggle = {
+	...additive,
+	idempotentHint: true
+};
+const changes = {
+	readOnlyHint: false,
+	destructiveHint: true,
+	openWorldHint: false
+};
+/**
+* MCP hints for each Factory tool, so clients like ChatGPT can tell lookups
+* from writes and ask before a tool changes or discards state.
+*/
+const FACTORY_TOOL_ANNOTATIONS = {
+	factory_list_work_items: {
+		...read,
+		title: "List work items"
+	},
+	factory_inspect_work_item: {
+		...read,
+		title: "Inspect a work item"
+	},
+	factory_list_attention: {
+		...read,
+		title: "List items that need attention"
+	},
+	factory_create_work_item: {
+		...additive,
+		title: "Create a work item"
+	},
+	factory_update_work_item: {
+		...changes,
+		title: "Update a work item"
+	},
+	factory_transition_work_item: {
+		...changes,
+		title: "Move a work item to another stage"
+	},
+	factory_retry_decision: {
+		...additive,
+		title: "Retry a failed decision"
+	},
+	factory_dismiss_decision: {
+		...changes,
+		title: "Dismiss a decision"
+	},
+	factory_resolve_proposal: {
+		...changes,
+		title: "Approve or reject a proposal"
+	},
+	factory_subscribe_work_item: {
+		...toggle,
+		title: "Follow a work item"
+	},
+	factory_unsubscribe_work_item: {
+		...toggle,
+		title: "Stop following a work item"
+	},
+	factory_start_session: {
+		...additive,
+		openWorldHint: true,
+		title: "Start an agent session"
+	},
+	factory_signal_session: {
+		...additive,
+		openWorldHint: true,
+		title: "Message a running session"
+	},
+	factory_message_origin: {
+		...additive,
+		title: "Reply to the session that started this one"
+	},
+	factory_answer_approval: {
+		...changes,
+		openWorldHint: true,
+		title: "Answer a session approval request"
+	},
+	search: {
+		...read,
+		title: "Search work items"
+	},
+	fetch: {
+		...read,
+		title: "Fetch a work item"
+	}
+};
+//#endregion
+export { FACTORY_TOOL_ANNOTATIONS };
+
+//# sourceMappingURL=annotations.js.map

package/dist/tools/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","names":[],"sources":["../../src/tools/annotations.ts"],"sourcesContent":["import type { ToolAnnotations } from '@mastra/core/tools';\n\nconst read: ToolAnnotations = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: false,\n};\nconst additive: ToolAnnotations = { readOnlyHint: false, destructiveHint: false, openWorldHint: false };\nconst toggle: ToolAnnotations = { ...additive, idempotentHint: true };\nconst changes: ToolAnnotations = { readOnlyHint: false, destructiveHint: true, openWorldHint: false };\n\n/**\n * MCP hints for each Factory tool, so clients like ChatGPT can tell lookups\n * from writes and ask before a tool changes or discards state.\n */\nexport const FACTORY_TOOL_ANNOTATIONS: Record<string, ToolAnnotations> = {\n  factory_list_work_items: { ...read, title: 'List work items' },\n  factory_inspect_work_item: { ...read, title: 'Inspect a work item' },\n  factory_list_attention: { ...read, title: 'List items that need attention' },\n  factory_create_work_item: { ...additive, title: 'Create a work item' },\n  factory_update_work_item: { ...changes, title: 'Update a work item' },\n  factory_transition_work_item: { ...changes, title: 'Move a work item to another stage' },\n  factory_retry_decision: { ...additive, title: 'Retry a failed decision' },\n  factory_dismiss_decision: { ...changes, title: 'Dismiss a decision' },\n  factory_resolve_proposal: { ...changes, title: 'Approve or reject a proposal' },\n  factory_subscribe_work_item: { ...toggle, title: 'Follow a work item' },\n  factory_unsubscribe_work_item: { ...toggle, title: 'Stop following a work item' },\n  factory_start_session: { ...additive, openWorldHint: true, title: 'Start an agent session' },\n  factory_signal_session: { ...additive, openWorldHint: true, title: 'Message a running session' },\n  factory_message_origin: { ...additive, title: 'Reply to the session that started this one' },\n  factory_answer_approval: { ...changes, openWorldHint: true, title: 'Answer a session approval request' },\n  search: { ...read, title: 'Search work items' },\n  fetch: { ...read, title: 'Fetch a work item' },\n};\n"],"mappings":";AAEA,MAAM,OAAwB;CAC5B,cAAc;CACd,iBAAiB;CACjB,gBAAgB;CAChB,eAAe;AACjB;AACA,MAAM,WAA4B;CAAE,cAAc;CAAO,iBAAiB;CAAO,eAAe;AAAM;AACtG,MAAM,SAA0B;CAAE,GAAG;CAAU,gBAAgB;AAAK;AACpE,MAAM,UAA2B;CAAE,cAAc;CAAO,iBAAiB;CAAM,eAAe;AAAM;;;;;AAMpG,MAAa,2BAA4D;CACvE,yBAAyB;EAAE,GAAG;EAAM,OAAO;CAAkB;CAC7D,2BAA2B;EAAE,GAAG;EAAM,OAAO;CAAsB;CACnE,wBAAwB;EAAE,GAAG;EAAM,OAAO;CAAiC;CAC3E,0BAA0B;EAAE,GAAG;EAAU,OAAO;CAAqB;CACrE,0BAA0B;EAAE,GAAG;EAAS,OAAO;CAAqB;CACpE,8BAA8B;EAAE,GAAG;EAAS,OAAO;CAAoC;CACvF,wBAAwB;EAAE,GAAG;EAAU,OAAO;CAA0B;CACxE,0BAA0B;EAAE,GAAG;EAAS,OAAO;CAAqB;CACpE,0BAA0B;EAAE,GAAG;EAAS,OAAO;CAA+B;CAC9E,6BAA6B;EAAE,GAAG;EAAQ,OAAO;CAAqB;CACtE,+BAA+B;EAAE,GAAG;EAAQ,OAAO;CAA6B;CAChF,uBAAuB;EAAE,GAAG;EAAU,eAAe;EAAM,OAAO;CAAyB;CAC3F,wBAAwB;EAAE,GAAG;EAAU,eAAe;EAAM,OAAO;CAA4B;CAC/F,wBAAwB;EAAE,GAAG;EAAU,OAAO;CAA6C;CAC3F,yBAAyB;EAAE,GAAG;EAAS,eAAe;EAAM,OAAO;CAAoC;CACvG,QAAQ;EAAE,GAAG;EAAM,OAAO;CAAoB;CAC9C,OAAO;EAAE,GAAG;EAAM,OAAO;CAAoB;AAC/C"}

package/dist/tools/approval-tools.d.ts

@@ -0,0 +1,15 @@
+import type { IntegrationTools } from '../integrations/base.js';
+import type { SourceControlSessionLookup } from '../session/factory-session.js';
+import type { AuditRecorder } from '../storage/domains/audit/domain.js';
+import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
+import type { FactoryMessaging } from './messaging-tools.js';
+import type { FactoryToolScope } from './scope.js';
+export interface FactoryApprovalToolDependencies {
+    sessions: Pick<SourceControlSessionLookup, 'getBySessionId'>;
+    workItems: Pick<WorkItemsStorage, 'findActiveRunBindingForSession' | 'listSessionSubscriptions'>;
+    auditRecorder: AuditRecorder;
+    messaging: () => Promise<FactoryMessaging | null>;
+}
+/** Answers a tool call another session holds for approval. Only a signed-in person's turn may answer. */
+export declare function createFactoryApprovalTools(scope: FactoryToolScope, deps: FactoryApprovalToolDependencies): IntegrationTools;
+//# sourceMappingURL=approval-tools.d.ts.map

package/dist/tools/approval-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-tools.d.ts","sourceRoot":"","sources":["../../src/tools/approval-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,gBAAgB,CAAC,CAAC;IAC7D,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,gCAAgC,GAAG,0BAA0B,CAAC,CAAC;IACjG,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACnD;AAYD,yGAAyG;AACzG,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,+BAA+B,GACpC,gBAAgB,CAoFlB"}

package/dist/tools/approval-tools.js

@@ -0,0 +1,79 @@
+import { requirePerson } from "./scope.js";
+import { z } from "zod";
+import { createTool } from "@mastra/core/tools";
+//#region src/tools/approval-tools.ts
+/** Answers a tool call another session holds for approval. Only a signed-in person's turn may answer. */
+function createFactoryApprovalTools(scope, deps) {
+	return { factory_answer_approval: createTool({
+		id: "factory_answer_approval",
+		description: [
+			"Approve or decline a tool call a session you follow is waiting on, as you.",
+			"A `factory-session` notification of kind `approval` names the session, tool, arguments and toolCallId.",
+			"Answer only what the person in this conversation agreed to; decline with a reason the session will see."
+		].join(" "),
+		inputSchema: z.object({
+			sessionId: z.string().uuid().describe("The session holding the call, from the approval notice."),
+			toolCallId: z.string().trim().min(1).max(200),
+			decision: z.enum(["approve", "decline"]),
+			reason: z.string().trim().min(1).max(1e3).optional().describe("Why, when declining.")
+		}).strict(),
+		execute: async ({ sessionId, toolCallId, decision, reason }) => {
+			requirePerson(scope, "answer an approval");
+			const row = await deps.sessions.getBySessionId(sessionId);
+			if (!row || row.orgId !== scope.orgId || row.factoryProjectId !== scope.factoryProjectId) throw new Error(`Session ${sessionId} was not found in this Factory.`);
+			if (row.visibility === "private" && row.userId !== scope.userId) throw new Error(`Session ${sessionId} is private to its owner.`);
+			const binding = await deps.workItems.findActiveRunBindingForSession({
+				orgId: scope.orgId,
+				factoryProjectId: scope.factoryProjectId,
+				sessionId
+			});
+			const isOrigin = row.originSessionId === scope.sessionId;
+			const follows = binding !== null && (await deps.workItems.listSessionSubscriptions({
+				orgId: scope.orgId,
+				factoryProjectId: scope.factoryProjectId,
+				sessionId: scope.sessionId
+			})).some((subscription) => subscription.workItemId === binding.workItemId);
+			if (!isOrigin && !follows) throw new Error(`This session doesn't follow session ${sessionId}: follow its work item first, or answer from that session.`);
+			const messaging = await deps.messaging();
+			if (!messaging) throw new Error("Answering approvals is not available on this server.");
+			const live = await messaging.controller.getSession(sessionId);
+			if (!live?.approval.isArmed({ toolCallId })) throw new Error("Nothing is waiting on that tool call any more: the run that asked has ended or it was already answered. Message the session with factory_signal_session if it should try again.");
+			const result = live.respondToToolApproval({
+				decision,
+				toolCallId,
+				...decision === "decline" ? { declineContext: { reason: reason ?? "Declined by a session following it." } } : {}
+			});
+			if (!result.accepted) throw new Error(`The answer was not accepted (${result.reason}).`);
+			deps.auditRecorder.record({
+				orgId: scope.orgId,
+				actorId: scope.userId,
+				actorType: "human",
+				...scope.actorProfile ? { actorProfile: scope.actorProfile } : {},
+				action: decision === "approve" ? "factory.run.approved" : "factory.run.dismissed",
+				factoryProjectId: scope.factoryProjectId,
+				targets: [{
+					type: "session",
+					id: sessionId
+				}, ...binding ? [{
+					type: "work_item",
+					id: binding.workItemId
+				}] : []],
+				metadata: {
+					toolCallId,
+					sessionId,
+					decision,
+					cause: "factory_tools"
+				}
+			});
+			return {
+				answered: decision,
+				sessionId,
+				toolCallId
+			};
+		}
+	}) };
+}
+//#endregion
+export { createFactoryApprovalTools };
+
+//# sourceMappingURL=approval-tools.js.map

package/dist/tools/approval-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-tools.js","names":[],"sources":["../../src/tools/approval-tools.ts"],"sourcesContent":["import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport type { IntegrationTools } from '../integrations/base.js';\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\nimport type { AuditRecorder } from '../storage/domains/audit/domain.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport type { FactoryMessaging } from './messaging-tools.js';\nimport { requirePerson } from './scope.js';\nimport type { FactoryToolScope } from './scope.js';\n\nexport interface FactoryApprovalToolDependencies {\n  sessions: Pick<SourceControlSessionLookup, 'getBySessionId'>;\n  workItems: Pick<WorkItemsStorage, 'findActiveRunBindingForSession' | 'listSessionSubscriptions'>;\n  auditRecorder: AuditRecorder;\n  messaging: () => Promise<FactoryMessaging | null>;\n}\n\n/** The parts of a live session an answer needs: its open approval gates. */\ninterface ApprovalGateSession {\n  approval: { isArmed(filter: { toolCallId: string }): boolean };\n  respondToToolApproval(input: {\n    decision: 'approve' | 'decline';\n    toolCallId: string;\n    declineContext?: { reason?: string };\n  }): { accepted: true } | { accepted: false; reason: string };\n}\n\n/** Answers a tool call another session holds for approval. Only a signed-in person's turn may answer. */\nexport function createFactoryApprovalTools(\n  scope: FactoryToolScope,\n  deps: FactoryApprovalToolDependencies,\n): IntegrationTools {\n  const answer = createTool({\n    id: 'factory_answer_approval',\n    description: [\n      'Approve or decline a tool call a session you follow is waiting on, as you.',\n      'A `factory-session` notification of kind `approval` names the session, tool, arguments and toolCallId.',\n      'Answer only what the person in this conversation agreed to; decline with a reason the session will see.',\n    ].join(' '),\n    inputSchema: z\n      .object({\n        sessionId: z.string().uuid().describe('The session holding the call, from the approval notice.'),\n        toolCallId: z.string().trim().min(1).max(200),\n        decision: z.enum(['approve', 'decline']),\n        reason: z.string().trim().min(1).max(1000).optional().describe('Why, when declining.'),\n      })\n      .strict(),\n    execute: async ({ sessionId, toolCallId, decision, reason }) => {\n      requirePerson(scope, 'answer an approval');\n      const row = await deps.sessions.getBySessionId(sessionId);\n      if (!row || row.orgId !== scope.orgId || row.factoryProjectId !== scope.factoryProjectId) {\n        throw new Error(`Session ${sessionId} was not found in this Factory.`);\n      }\n      if (row.visibility === 'private' && row.userId !== scope.userId) {\n        throw new Error(`Session ${sessionId} is private to its owner.`);\n      }\n\n      // Only the sessions it reports to may answer it: its origin, or followers of its item.\n      const binding = await deps.workItems.findActiveRunBindingForSession({\n        orgId: scope.orgId,\n        factoryProjectId: scope.factoryProjectId,\n        sessionId,\n      });\n      const isOrigin = row.originSessionId === scope.sessionId;\n      const follows =\n        binding !== null &&\n        (\n          await deps.workItems.listSessionSubscriptions({\n            orgId: scope.orgId,\n            factoryProjectId: scope.factoryProjectId,\n            sessionId: scope.sessionId,\n          })\n        ).some(subscription => subscription.workItemId === binding.workItemId);\n      if (!isOrigin && !follows) {\n        throw new Error(\n          `This session doesn't follow session ${sessionId}: follow its work item first, or answer from that session.`,\n        );\n      }\n\n      const messaging = await deps.messaging();\n      if (!messaging) throw new Error('Answering approvals is not available on this server.');\n      const live = (await messaging.controller.getSession(sessionId)) as ApprovalGateSession | null;\n      if (!live?.approval.isArmed({ toolCallId })) {\n        throw new Error(\n          'Nothing is waiting on that tool call any more: the run that asked has ended or it was already answered. ' +\n            'Message the session with factory_signal_session if it should try again.',\n        );\n      }\n      const result = live.respondToToolApproval({\n        decision,\n        toolCallId,\n        ...(decision === 'decline'\n          ? { declineContext: { reason: reason ?? 'Declined by a session following it.' } }\n          : {}),\n      });\n      if (!result.accepted) throw new Error(`The answer was not accepted (${result.reason}).`);\n\n      deps.auditRecorder.record({\n        orgId: scope.orgId,\n        actorId: scope.userId,\n        actorType: 'human',\n        ...(scope.actorProfile ? { actorProfile: scope.actorProfile } : {}),\n        action: decision === 'approve' ? 'factory.run.approved' : 'factory.run.dismissed',\n        factoryProjectId: scope.factoryProjectId,\n        targets: [\n          { type: 'session', id: sessionId },\n          ...(binding ? [{ type: 'work_item' as const, id: binding.workItemId }] : []),\n        ],\n        metadata: { toolCallId, sessionId, decision, cause: 'factory_tools' },\n      });\n      return { answered: decision, sessionId, toolCallId };\n    },\n  });\n\n  return { factory_answer_approval: answer };\n}\n"],"mappings":";;;;;AA6BA,SAAgB,2BACd,OACA,MACkB;CAmFlB,OAAO,EAAE,yBAlFM,WAAW;EACxB,IAAI;EACJ,aAAa;GACX;GACA;GACA;EACF,CAAC,CAAC,KAAK,GAAG;EACV,aAAa,EACV,OAAO;GACN,WAAW,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,yDAAyD;GAC/F,YAAY,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;GAC5C,UAAU,EAAE,KAAK,CAAC,WAAW,SAAS,CAAC;GACvC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,sBAAsB;EACvF,CAAC,CAAC,CACD,OAAO;EACV,SAAS,OAAO,EAAE,WAAW,YAAY,UAAU,aAAa;GAC9D,cAAc,OAAO,oBAAoB;GACzC,MAAM,MAAM,MAAM,KAAK,SAAS,eAAe,SAAS;GACxD,IAAI,CAAC,OAAO,IAAI,UAAU,MAAM,SAAS,IAAI,qBAAqB,MAAM,kBACtE,MAAM,IAAI,MAAM,WAAW,UAAU,gCAAgC;GAEvE,IAAI,IAAI,eAAe,aAAa,IAAI,WAAW,MAAM,QACvD,MAAM,IAAI,MAAM,WAAW,UAAU,0BAA0B;GAIjE,MAAM,UAAU,MAAM,KAAK,UAAU,+BAA+B;IAClE,OAAO,MAAM;IACb,kBAAkB,MAAM;IACxB;GACF,CAAC;GACD,MAAM,WAAW,IAAI,oBAAoB,MAAM;GAC/C,MAAM,UACJ,YAAY,SAEV,MAAM,KAAK,UAAU,yBAAyB;IAC5C,OAAO,MAAM;IACb,kBAAkB,MAAM;IACxB,WAAW,MAAM;GACnB,CAAC,EAAA,CACD,MAAK,iBAAgB,aAAa,eAAe,QAAQ,UAAU;GACvE,IAAI,CAAC,YAAY,CAAC,SAChB,MAAM,IAAI,MACR,uCAAuC,UAAU,2DACnD;GAGF,MAAM,YAAY,MAAM,KAAK,UAAU;GACvC,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,sDAAsD;GACtF,MAAM,OAAQ,MAAM,UAAU,WAAW,WAAW,SAAS;GAC7D,IAAI,CAAC,MAAM,SAAS,QAAQ,EAAE,WAAW,CAAC,GACxC,MAAM,IAAI,MACR,iLAEF;GAEF,MAAM,SAAS,KAAK,sBAAsB;IACxC;IACA;IACA,GAAI,aAAa,YACb,EAAE,gBAAgB,EAAE,QAAQ,UAAU,sCAAsC,EAAE,IAC9E,CAAC;GACP,CAAC;GACD,IAAI,CAAC,OAAO,UAAU,MAAM,IAAI,MAAM,gCAAgC,OAAO,OAAO,GAAG;GAEvF,KAAK,cAAc,OAAO;IACxB,OAAO,MAAM;IACb,SAAS,MAAM;IACf,WAAW;IACX,GAAI,MAAM,eAAe,EAAE,cAAc,MAAM,aAAa,IAAI,CAAC;IACjE,QAAQ,aAAa,YAAY,yBAAyB;IAC1D,kBAAkB,MAAM;IACxB,SAAS,CACP;KAAE,MAAM;KAAW,IAAI;IAAU,GACjC,GAAI,UAAU,CAAC;KAAE,MAAM;KAAsB,IAAI,QAAQ;IAAW,CAAC,IAAI,CAAC,CAC5E;IACA,UAAU;KAAE;KAAY;KAAW;KAAU,OAAO;IAAgB;GACtE,CAAC;GACD,OAAO;IAAE,UAAU;IAAU;IAAW;GAAW;EACrD;CACF,CAEuC,EAAE;AAC3C"}

package/dist/tools/deliver.d.ts

@@ -0,0 +1,71 @@
+import type { MountedMastraCode } from '@mastra/code-sdk';
+import type { SendNotificationSignalInput } from '@mastra/core/notifications';
+import type { SourceControlSessionLookup } from '../session/factory-session.js';
+import type { SessionRunBindings } from '../session/session-threads.js';
+import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
+/** Notifications between Factory sessions all carry this source. */
+export declare const FACTORY_SESSION_NOTIFICATION_SOURCE = "factory-session";
+export type FactoryDeliveryController = Pick<MountedMastraCode['controller'], 'queryThreadById' | 'queryThreads' | 'setThreadModel' | 'listAvailableModels' | 'getSession' | 'createSession' | 'getCurrentAgent'>;
+export interface FactoryDeliveryTarget {
+    /** The target's source-control session id. */
+    sessionId: string;
+    /** The stored thread the notification belongs to. Never the session's current thread by default. */
+    threadId: string;
+}
+export type FactoryDeliveryResult = 
+/**
+ * `woken`: the target was idle and the notification started a run.
+ * `mid-run`: the target was already running; it reads the notification when that run
+ * next checks its inbox, not now.
+ */
+{
+    delivered: 'woken' | 'mid-run' | 'persisted' | 'summarized';
+    notificationId: string;
+    reason?: string;
+} | {
+    delivered: 'skipped';
+    notificationId?: string;
+    reason: 'thread-not-found' | 'thread-not-owned' | 'session-not-found' | 'offline' | 'discarded';
+};
+/**
+ * Deliver a notification to a Factory session's stored thread.
+ *
+ * Sent through the target's agent with an explicit `{ resourceId, threadId }`,
+ * never `Session.sendNotificationSignal`: that one builds the wake from the
+ * sender's request context and aims at the target's current thread. On this
+ * path the SDK builds the wake from the session that owns the target resource,
+ * so the woken run is the target row's owner, with that owner's credentials.
+ *
+ * A target that isn't live is created first, as its row's owner and bound to
+ * the stored thread: waking a resource no session owns starts a run with no
+ * model. A live session's thread is never switched.
+ */
+export declare function deliverFactorySessionNotification({ controller, sessions, target, notification, onlyIfLive, runs, }: {
+    controller: FactoryDeliveryController;
+    sessions: Pick<SourceControlSessionLookup, 'getBySessionId'>;
+    /** Run bindings, which decide whether a session may use its Factory's resource. */
+    runs: SessionRunBindings | undefined;
+    target: FactoryDeliveryTarget;
+    notification: Omit<SendNotificationSignalInput, 'source'>;
+    /** Skip, without creating anything, when no live session owns the target (stage notices). */
+    onlyIfLive?: boolean;
+}): Promise<FactoryDeliveryResult>;
+export interface FactorySessionActivity {
+    /** Whether the session's agent is mid-run in this process. */
+    running: boolean;
+    /** When the session's thread last changed (a message saved, a run step persisted), ISO. */
+    lastActivityAt: string | null;
+}
+/** Whether a session is busy right now, and when its thread last moved, so a stuck run is told apart from a long one. */
+export declare function sessionActivity(controller: Pick<FactoryDeliveryController, 'getSession' | 'queryThreadById'>, sessionId: string, threadId: string): Promise<FactorySessionActivity>;
+/**
+ * The thread a message to a session should land on: the thread its role runs
+ * on, else the thread it has open, else its most recently updated thread.
+ */
+export declare function resolveSessionThread({ controller, sessions, workItems, sessionId, }: {
+    controller: Pick<FactoryDeliveryController, 'getSession' | 'queryThreads' | 'queryThreadById'>;
+    sessions: Pick<SourceControlSessionLookup, 'getBySessionId'>;
+    workItems: Pick<WorkItemsStorage, 'findActiveRunBindingForSession' | 'hasRunBindingForSession'>;
+    sessionId: string;
+}): Promise<string | null>;
+//# sourceMappingURL=deliver.d.ts.map

package/dist/tools/deliver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver.d.ts","sourceRoot":"","sources":["../../src/tools/deliver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAG9E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,KAAK,EAA2B,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,oEAAoE;AACpE,eAAO,MAAM,mCAAmC,oBAAoB,CAAC;AAErE,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,iBAAiB,CAAC,YAAY,CAAC,EAC7B,iBAAiB,GACjB,cAAc,GACd,gBAAgB,GAChB,qBAAqB,GACrB,YAAY,GACZ,eAAe,GACf,iBAAiB,CACpB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,qBAAqB;AAC/B;;;;GAIG;AACD;IAAE,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxG;IACE,SAAS,EAAE,SAAS,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,SAAS,GAAG,WAAW,CAAC;CACjG,CAAC;AAEN;;;;;;;;;;;;GAYG;AACH,wBAAsB,iCAAiC,CAAC,EACtD,UAAU,EACV,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,UAAkB,EAClB,IAAI,GACL,EAAE;IACD,UAAU,EAAE,yBAAyB,CAAC;IACtC,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,gBAAgB,CAAC,CAAC;IAC7D,mFAAmF;IACnF,IAAI,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,YAAY,EAAE,IAAI,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;IAC1D,6FAA6F;IAC7F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAwDjC;AAED,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,yHAAyH;AACzH,wBAAsB,eAAe,CACnC,UAAU,EAAE,IAAI,CAAC,yBAAyB,EAAE,YAAY,GAAG,iBAAiB,CAAC,EAC7E,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,CAUjC;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,EACzC,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,GACV,EAAE;IACD,UAAU,EAAE,IAAI,CAAC,yBAAyB,EAAE,YAAY,GAAG,cAAc,GAAG,iBAAiB,CAAC,CAAC;IAC/F,QAAQ,EAAE,IAAI,CAAC,0BAA0B,EAAE,gBAAgB,CAAC,CAAC;IAC7D,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,gCAAgC,GAAG,yBAAyB,CAAC,CAAC;IAChG,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBzB"}

package/dist/tools/deliver.js

@@ -0,0 +1,129 @@
+import { listFactorySessionThreads, sessionMemoryResourceId, sessionStampCounts } from "../session/session-threads.js";
+import { createSessionAsRowOwner } from "../integrations/subscription-session.js";
+//#region src/tools/deliver.ts
+/** Notifications between Factory sessions all carry this source. */
+const FACTORY_SESSION_NOTIFICATION_SOURCE = "factory-session";
+/**
+* Deliver a notification to a Factory session's stored thread.
+*
+* Sent through the target's agent with an explicit `{ resourceId, threadId }`,
+* never `Session.sendNotificationSignal`: that one builds the wake from the
+* sender's request context and aims at the target's current thread. On this
+* path the SDK builds the wake from the session that owns the target resource,
+* so the woken run is the target row's owner, with that owner's credentials.
+*
+* A target that isn't live is created first, as its row's owner and bound to
+* the stored thread: waking a resource no session owns starts a run with no
+* model. A live session's thread is never switched.
+*/
+async function deliverFactorySessionNotification({ controller, sessions, target, notification, onlyIfLive = false, runs }) {
+	const thread = await controller.queryThreadById({ threadId: target.threadId });
+	if (!thread) return {
+		delivered: "skipped",
+		reason: "thread-not-found"
+	};
+	let targetRow;
+	const loadRow = () => targetRow ??= sessions.getBySessionId(target.sessionId);
+	if (!await isSessionThread(controller, runs, thread, target.sessionId, loadRow)) return {
+		delivered: "skipped",
+		reason: "thread-not-owned"
+	};
+	const ownerResourceId = thread.resourceId || target.sessionId;
+	let session = await controller.getSession(target.sessionId);
+	if (!session) {
+		if (onlyIfLive) return {
+			delivered: "skipped",
+			reason: "offline"
+		};
+		const row = await loadRow();
+		if (!row?.factoryProjectId) return {
+			delivered: "skipped",
+			reason: "session-not-found"
+		};
+		session = await createSessionAsRowOwner(controller, {
+			sessionId: target.sessionId,
+			ownerResourceId,
+			row,
+			tags: {
+				factoryProjectId: row.factoryProjectId,
+				...row.projectRepositoryId ? { projectRepositoryId: row.projectRepositoryId } : {}
+			},
+			threadId: target.threadId
+		});
+	}
+	const busy = session.stream.isActive() && session.thread.getId() === target.threadId;
+	const result = await controller.getCurrentAgent(session).sendNotificationSignal({
+		...notification,
+		source: FACTORY_SESSION_NOTIFICATION_SOURCE
+	}, {
+		resourceId: ownerResourceId,
+		threadId: target.threadId
+	});
+	await Promise.all([result.persisted, result.accepted].filter(Boolean));
+	const notificationId = result.record.id;
+	const reason = result.decision.reason ? { reason: result.decision.reason } : {};
+	switch (result.decision.action) {
+		case "deliver": return {
+			delivered: busy ? "mid-run" : "woken",
+			notificationId,
+			...reason
+		};
+		case "summarize": return {
+			delivered: "summarized",
+			notificationId,
+			...reason
+		};
+		case "discard": return {
+			delivered: "skipped",
+			notificationId,
+			reason: "discarded"
+		};
+		default: return {
+			delivered: "persisted",
+			notificationId,
+			...reason
+		};
+	}
+}
+/** Whether a session is busy right now, and when its thread last moved, so a stuck run is told apart from a long one. */
+async function sessionActivity(controller, sessionId, threadId) {
+	const [live, thread] = await Promise.all([controller.getSession(sessionId), controller.queryThreadById({ threadId })]);
+	const updatedAt = thread?.updatedAt ? new Date(thread.updatedAt) : null;
+	return {
+		running: live?.stream.isActive() ?? false,
+		lastActivityAt: updatedAt && Number.isFinite(updatedAt.getTime()) ? updatedAt.toISOString() : null
+	};
+}
+/**
+* The thread a message to a session should land on: the thread its role runs
+* on, else the thread it has open, else its most recently updated thread.
+*/
+async function resolveSessionThread({ controller, sessions, workItems, sessionId }) {
+	const row = await sessions.getBySessionId(sessionId);
+	if (row?.factoryProjectId) {
+		const binding = await workItems.findActiveRunBindingForSession({
+			orgId: row.orgId,
+			factoryProjectId: row.factoryProjectId,
+			sessionId
+		});
+		if (binding) return binding.threadId;
+	}
+	const current = (await controller.getSession(sessionId))?.thread.getId();
+	if (current) return current;
+	return [...await listFactorySessionThreads(controller, row ?? {
+		sessionId,
+		userId: ""
+	}, workItems)].sort((left, right) => right.updatedAt.getTime() - left.updatedAt.getTime())[0]?.id ?? null;
+}
+async function isSessionThread(controller, runs, thread, sessionId, loadRow) {
+	if (thread.resourceId === sessionId) return true;
+	if (thread.id !== sessionId && thread.metadata?.factorySessionId !== sessionId) return false;
+	const row = await loadRow();
+	if (!row) return false;
+	if (thread.id !== sessionId && !sessionStampCounts(row, thread.resourceId)) return false;
+	return thread.resourceId === await sessionMemoryResourceId(controller, row, runs);
+}
+//#endregion
+export { FACTORY_SESSION_NOTIFICATION_SOURCE, deliverFactorySessionNotification, resolveSessionThread, sessionActivity };
+
+//# sourceMappingURL=deliver.js.map

package/dist/tools/deliver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver.js","names":[],"sources":["../../src/tools/deliver.ts"],"sourcesContent":["import type { MountedMastraCode } from '@mastra/code-sdk';\nimport type { SendNotificationSignalInput } from '@mastra/core/notifications';\n\nimport { createSessionAsRowOwner } from '../integrations/subscription-session.js';\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\nimport { listFactorySessionThreads, sessionMemoryResourceId, sessionStampCounts } from '../session/session-threads.js';\nimport type { FactorySessionOwnership, SessionRunBindings } from '../session/session-threads.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\n\n/** Notifications between Factory sessions all carry this source. */\nexport const FACTORY_SESSION_NOTIFICATION_SOURCE = 'factory-session';\n\nexport type FactoryDeliveryController = Pick<\n  MountedMastraCode['controller'],\n  | 'queryThreadById'\n  | 'queryThreads'\n  | 'setThreadModel'\n  | 'listAvailableModels'\n  | 'getSession'\n  | 'createSession'\n  | 'getCurrentAgent'\n>;\n\nexport interface FactoryDeliveryTarget {\n  /** The target's source-control session id. */\n  sessionId: string;\n  /** The stored thread the notification belongs to. Never the session's current thread by default. */\n  threadId: string;\n}\n\nexport type FactoryDeliveryResult =\n  /**\n   * `woken`: the target was idle and the notification started a run.\n   * `mid-run`: the target was already running; it reads the notification when that run\n   * next checks its inbox, not now.\n   */\n  | { delivered: 'woken' | 'mid-run' | 'persisted' | 'summarized'; notificationId: string; reason?: string }\n  | {\n      delivered: 'skipped';\n      notificationId?: string;\n      reason: 'thread-not-found' | 'thread-not-owned' | 'session-not-found' | 'offline' | 'discarded';\n    };\n\n/**\n * Deliver a notification to a Factory session's stored thread.\n *\n * Sent through the target's agent with an explicit `{ resourceId, threadId }`,\n * never `Session.sendNotificationSignal`: that one builds the wake from the\n * sender's request context and aims at the target's current thread. On this\n * path the SDK builds the wake from the session that owns the target resource,\n * so the woken run is the target row's owner, with that owner's credentials.\n *\n * A target that isn't live is created first, as its row's owner and bound to\n * the stored thread: waking a resource no session owns starts a run with no\n * model. A live session's thread is never switched.\n */\nexport async function deliverFactorySessionNotification({\n  controller,\n  sessions,\n  target,\n  notification,\n  onlyIfLive = false,\n  runs,\n}: {\n  controller: FactoryDeliveryController;\n  sessions: Pick<SourceControlSessionLookup, 'getBySessionId'>;\n  /** Run bindings, which decide whether a session may use its Factory's resource. */\n  runs: SessionRunBindings | undefined;\n  target: FactoryDeliveryTarget;\n  notification: Omit<SendNotificationSignalInput, 'source'>;\n  /** Skip, without creating anything, when no live session owns the target (stage notices). */\n  onlyIfLive?: boolean;\n}): Promise<FactoryDeliveryResult> {\n  const thread = await controller.queryThreadById({ threadId: target.threadId });\n  if (!thread) return { delivered: 'skipped', reason: 'thread-not-found' };\n  // Sessions share their Factory's or owner's resource, so a thread is this\n  // session's when it is the session's own thread or carries its session stamp\n  // (or, before migration, sits under the session id). Anything else is not\n  // this session's, whatever the caller paired it with.\n  let targetRow: ReturnType<SourceControlSessionLookup['getBySessionId']> | undefined;\n  const loadRow = () => (targetRow ??= sessions.getBySessionId(target.sessionId));\n  if (!(await isSessionThread(controller, runs, thread, target.sessionId, loadRow))) {\n    return { delivered: 'skipped', reason: 'thread-not-owned' };\n  }\n  const ownerResourceId = thread.resourceId || target.sessionId;\n\n  // No request context: without a user the controller's access check is a no-op,\n  // and this is a server-side lookup on the target's behalf, not the sender's.\n  let session = await controller.getSession(target.sessionId);\n  if (!session) {\n    if (onlyIfLive) return { delivered: 'skipped', reason: 'offline' };\n    const row = await loadRow();\n    if (!row?.factoryProjectId) return { delivered: 'skipped', reason: 'session-not-found' };\n    session = await createSessionAsRowOwner(controller, {\n      sessionId: target.sessionId,\n      ownerResourceId,\n      row,\n      tags: {\n        factoryProjectId: row.factoryProjectId,\n        ...(row.projectRepositoryId ? { projectRepositoryId: row.projectRepositoryId } : {}),\n      },\n      threadId: target.threadId,\n    });\n  }\n\n  // Read before sending: the send itself starts a run on an idle target. Delivery is per thread,\n  // so a run on another thread of the same session leaves the target thread idle.\n  const busy = session.stream.isActive() && session.thread.getId() === target.threadId;\n  const result = await controller\n    .getCurrentAgent(session)\n    .sendNotificationSignal(\n      { ...notification, source: FACTORY_SESSION_NOTIFICATION_SOURCE },\n      { resourceId: ownerResourceId, threadId: target.threadId },\n    );\n  await Promise.all([result.persisted, result.accepted].filter(Boolean));\n\n  const notificationId = result.record.id;\n  const reason = result.decision.reason ? { reason: result.decision.reason } : {};\n  switch (result.decision.action) {\n    case 'deliver':\n      return { delivered: busy ? 'mid-run' : 'woken', notificationId, ...reason };\n    case 'summarize':\n      return { delivered: 'summarized', notificationId, ...reason };\n    case 'discard':\n      return { delivered: 'skipped', notificationId, reason: 'discarded' };\n    default:\n      return { delivered: 'persisted', notificationId, ...reason };\n  }\n}\n\nexport interface FactorySessionActivity {\n  /** Whether the session's agent is mid-run in this process. */\n  running: boolean;\n  /** When the session's thread last changed (a message saved, a run step persisted), ISO. */\n  lastActivityAt: string | null;\n}\n\n/** Whether a session is busy right now, and when its thread last moved, so a stuck run is told apart from a long one. */\nexport async function sessionActivity(\n  controller: Pick<FactoryDeliveryController, 'getSession' | 'queryThreadById'>,\n  sessionId: string,\n  threadId: string,\n): Promise<FactorySessionActivity> {\n  const [live, thread] = await Promise.all([\n    controller.getSession(sessionId),\n    controller.queryThreadById({ threadId }),\n  ]);\n  const updatedAt = thread?.updatedAt ? new Date(thread.updatedAt) : null;\n  return {\n    running: live?.stream.isActive() ?? false,\n    lastActivityAt: updatedAt && Number.isFinite(updatedAt.getTime()) ? updatedAt.toISOString() : null,\n  };\n}\n\n/**\n * The thread a message to a session should land on: the thread its role runs\n * on, else the thread it has open, else its most recently updated thread.\n */\nexport async function resolveSessionThread({\n  controller,\n  sessions,\n  workItems,\n  sessionId,\n}: {\n  controller: Pick<FactoryDeliveryController, 'getSession' | 'queryThreads' | 'queryThreadById'>;\n  sessions: Pick<SourceControlSessionLookup, 'getBySessionId'>;\n  workItems: Pick<WorkItemsStorage, 'findActiveRunBindingForSession' | 'hasRunBindingForSession'>;\n  sessionId: string;\n}): Promise<string | null> {\n  const row = await sessions.getBySessionId(sessionId);\n  if (row?.factoryProjectId) {\n    const binding = await workItems.findActiveRunBindingForSession({\n      orgId: row.orgId,\n      factoryProjectId: row.factoryProjectId,\n      sessionId,\n    });\n    if (binding) return binding.threadId;\n  }\n  const live = await controller.getSession(sessionId);\n  const current = live?.thread.getId();\n  if (current) return current;\n  // Without a row no resource is the session's to claim stamped threads on.\n  const threads = await listFactorySessionThreads(controller, row ?? { sessionId, userId: '' }, workItems);\n  const newest = [...threads].sort((left, right) => right.updatedAt.getTime() - left.updatedAt.getTime())[0];\n  return newest?.id ?? null;\n}\n\nasync function isSessionThread(\n  controller: Pick<FactoryDeliveryController, 'queryThreadById'>,\n  runs: SessionRunBindings | undefined,\n  thread: { id: string; resourceId?: string | null; metadata?: Record<string, unknown> | null },\n  sessionId: string,\n  loadRow: () => Promise<FactorySessionOwnership | null>,\n): Promise<boolean> {\n  // Before resources were shared a session's threads ran under its own id.\n  if (thread.resourceId === sessionId) return true;\n  if (thread.id !== sessionId && thread.metadata?.factorySessionId !== sessionId) return false;\n  // Thread ids and stamps are client-writable: either only counts under the\n  // session's own memory resource.\n  const row = await loadRow();\n  if (!row) return false;\n  if (thread.id !== sessionId && !sessionStampCounts(row, thread.resourceId)) return false;\n  return thread.resourceId === (await sessionMemoryResourceId(controller, row, runs));\n}\n"],"mappings":"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"}