@cat-factory/orchestration 0.76.0 → 0.78.0

package/dist/modules/observability/SearchQueryObservabilityService.js

@@ -0,0 +1,64 @@
+import { DEFAULT_WORKSPACE_SETTINGS } from '@cat-factory/kernel';
+/**
+ * Defensive upper bound (characters) on a stored query. Real search queries sit far
+ * below this; the cap exists only so a pathological query can't blow past the store's
+ * per-value limit and make the whole row fail to record.
+ */
+export const MAX_SEARCH_QUERY_CHARS = 8 * 1024;
+function clamp(text) {
+    if (text.length <= MAX_SEARCH_QUERY_CHARS)
+        return text;
+    return `${text.slice(0, MAX_SEARCH_QUERY_CHARS)}…`;
+}
+/**
+ * The agent-search-query observability sink. The container web-search proxy
+ * (`webSearchProxyController`) calls {@link record} best-effort after each search the
+ * agent performs. A sibling of the {@link AgentContextObservabilityService}: that keeps
+ * the complete context the agent was provided, this keeps the searches the agent ran.
+ *
+ * Storing is gated twice: the deployment-wide prompt-recording switch
+ * ({@link recordPrompts}) AND the per-workspace `storeAgentContext` setting must both be
+ * enabled. Wired only when a search-query repository is present, so tests and
+ * unconfigured facades collect nothing.
+ */
+export class SearchQueryObservabilityService {
+    repository;
+    settings;
+    idGenerator;
+    clock;
+    recordPrompts;
+    constructor({ agentSearchQueryRepository, workspaceSettingsRepository, idGenerator, clock, recordPrompts = true, }) {
+        this.repository = agentSearchQueryRepository;
+        this.settings = workspaceSettingsRepository;
+        this.idGenerator = idGenerator;
+        this.clock = clock;
+        this.recordPrompts = recordPrompts;
+    }
+    /**
+     * Persist one performed search query, assigning its id + timestamp. Returns without
+     * storing when prompt recording is disabled deployment-wide or the workspace has
+     * turned `storeAgentContext` off.
+     */
+    async record(input) {
+        if (!this.recordPrompts)
+            return;
+        if (!(await this.storeEnabled(input.workspaceId)))
+            return;
+        const query = {
+            ...input,
+            query: clamp(input.query),
+            id: this.idGenerator.next('asq'),
+            createdAt: this.clock.now(),
+        };
+        await this.repository.record(query);
+    }
+    /** Queries recorded for a run, newest first (for the observability drill-down). */
+    listByExecution(workspaceId, executionId) {
+        return this.repository.listByExecution(workspaceId, executionId);
+    }
+    async storeEnabled(workspaceId) {
+        const settings = (await this.settings.get(workspaceId)) ?? DEFAULT_WORKSPACE_SETTINGS;
+        return settings.storeAgentContext;
+    }
+}
+//# sourceMappingURL=SearchQueryObservabilityService.js.map

package/dist/modules/observability/SearchQueryObservabilityService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchQueryObservabilityService.js","sourceRoot":"","sources":["../../../src/modules/observability/SearchQueryObservabilityService.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAEhE;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,IAAI,CAAA;AAE9C,SAAS,KAAK,CAAC,IAAY;IACzB,IAAI,IAAI,CAAC,MAAM,IAAI,sBAAsB;QAAE,OAAO,IAAI,CAAA;IACtD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,GAAG,CAAA;AACpD,CAAC;AAgBD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,+BAA+B;IACzB,UAAU,CAA4B;IACtC,QAAQ,CAA6B;IACrC,WAAW,CAAa;IACxB,KAAK,CAAO;IACZ,aAAa,CAAS;IAEvC,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,WAAW,EACX,KAAK,EACL,aAAa,GAAG,IAAI,GACwB;QAC5C,IAAI,CAAC,UAAU,GAAG,0BAA0B,CAAA;QAC5C,IAAI,CAAC,QAAQ,GAAG,2BAA2B,CAAA;QAC3C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;IACpC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,KAAkC;QAC7C,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAM;QAC/B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAAE,OAAM;QACzD,MAAM,KAAK,GAAqB;YAC9B,GAAG,KAAK;YACR,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;YACzB,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;YAChC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;SAC5B,CAAA;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;IAED,mFAAmF;IACnF,eAAe,CAAC,WAAmB,EAAE,WAAmB;QACtD,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;IAClE,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,WAAmB;QAC5C,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,0BAA0B,CAAA;QACrF,OAAO,QAAQ,CAAC,iBAAiB,CAAA;IACnC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/orchestration",
-  "version": "0.76.0",
+  "version": "0.78.0",
   "description": "Delivery-workflow engine for the Agent Architecture Board (execution, bootstrap, pipelines, board, boardScan, requirements, and composition root).",
   "repository": {
     "type": "git",
@@ -25,20 +25,20 @@
   },
   "dependencies": {
     "ai": "^6.0.219",
-    "@cat-factory/agents": "0.39.1",
-    "@cat-factory/caching": "0.4.11",
-    "@cat-factory/contracts": "0.103.0",
-    "@cat-factory/integrations": "0.70.0",
-    "@cat-factory/kernel": "0.94.0",
-    "@cat-factory/prompt-fragments": "0.10.9",
-    "@cat-factory/sandbox": "0.9.10",
-    "@cat-factory/spend": "0.10.103",
-    "@cat-factory/workspaces": "0.11.21"
+    "@cat-factory/agents": "0.39.3",
+    "@cat-factory/caching": "0.4.13",
+    "@cat-factory/contracts": "0.105.0",
+    "@cat-factory/integrations": "0.71.0",
+    "@cat-factory/kernel": "0.96.0",
+    "@cat-factory/prompt-fragments": "0.10.11",
+    "@cat-factory/sandbox": "0.9.12",
+    "@cat-factory/spend": "0.10.105",
+    "@cat-factory/workspaces": "0.11.23"
   },
   "devDependencies": {
     "typescript": "7.0.1-rc",
     "vitest": "^4.1.9",
-    "@cat-factory/sandbox-fixtures": "0.7.117"
+    "@cat-factory/sandbox-fixtures": "0.7.119"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",