@beacon-build/sdk 1.49.4 → 1.49.6

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,20 @@
1
1
  # @beacon-build/sdk Changelog
2
2
 
3
+ ## 1.49.6
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [f20e87b]
8
+ - Updated dependencies [705f810]
9
+ - @beacon-build/core@1.49.6
10
+
11
+ ## 1.49.5
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies [1fe59a3]
16
+ - @beacon-build/core@1.49.5
17
+
3
18
  ## 1.49.4
4
19
 
5
20
  ### Patch Changes
@@ -26,14 +26,17 @@ export declare class AgentCapabilityClient {
26
26
  * return type must reflect the unwrapped shape, not the wire envelope, or
27
27
  * callers destructure a non-existent `.data` off an array and crash.
28
28
  *
29
- * @param query — Problem description (used for empty-query guard + reason text).
30
- * @param embeddingPre-computed query vector (B106: API does not embed).
29
+ * @param query — Problem description (used for empty-query guard + reason text,
30
+ * and C740server-embedded (Jina) when `embedding` is omitted).
31
+ * @param embedding — Optional pre-computed query vector; a caller-supplied
32
+ * embedding wins (backward compatible). Omit it to let the API embed `query`
33
+ * server-side (C740, F288's resolveEmbeddingForRoute).
31
34
  * @param context — Optional task context (taskType/domain) for ranking boost.
32
35
  * @param limit — Max candidates (default 10).
33
36
  */
34
37
  resolve(input: {
35
38
  query: string;
36
- embedding: number[];
39
+ embedding?: number[];
37
40
  context?: {
38
41
  taskType?: string;
39
42
  domain?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"capability.client.d.ts","sourceRoot":"","sources":["../../../src/clients/agent/capability.client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,wEAAwE;IACxE,UAAU,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,qBAAa,qBAAqB;IAClB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,KAAK,EAAE;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,EAAE,CAAA;QACnB,OAAO,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAChD,KAAK,CAAC,EAAE,MAAM,CAAA;KACjB,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;CAGxC"}
1
+ {"version":3,"file":"capability.client.d.ts","sourceRoot":"","sources":["../../../src/clients/agent/capability.client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,UAAU,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,wEAAwE;IACxE,UAAU,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,qBAAa,qBAAqB;IAClB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CAAC,KAAK,EAAE;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;QACpB,OAAO,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAChD,KAAK,CAAC,EAAE,MAAM,CAAA;KACjB,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;CAGxC"}
@@ -17,8 +17,11 @@ export class AgentCapabilityClient {
17
17
  * return type must reflect the unwrapped shape, not the wire envelope, or
18
18
  * callers destructure a non-existent `.data` off an array and crash.
19
19
  *
20
- * @param query — Problem description (used for empty-query guard + reason text).
21
- * @param embeddingPre-computed query vector (B106: API does not embed).
20
+ * @param query — Problem description (used for empty-query guard + reason text,
21
+ * and C740server-embedded (Jina) when `embedding` is omitted).
22
+ * @param embedding — Optional pre-computed query vector; a caller-supplied
23
+ * embedding wins (backward compatible). Omit it to let the API embed `query`
24
+ * server-side (C740, F288's resolveEmbeddingForRoute).
22
25
  * @param context — Optional task context (taskType/domain) for ranking boost.
23
26
  * @param limit — Max candidates (default 10).
24
27
  */
@@ -1 +1 @@
1
- {"version":3,"file":"capability.client.js","sourceRoot":"","sources":["../../../src/clients/agent/capability.client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,OAAO,qBAAqB;IACV;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,OAAO,CAAC,KAKb;QACG,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAA2B,uBAAuB,EAAE,KAAK,CAAC,CAAA;IACnF,CAAC;CACJ"}
1
+ {"version":3,"file":"capability.client.js","sourceRoot":"","sources":["../../../src/clients/agent/capability.client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,OAAO,qBAAqB;IACV;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,OAAO,CAAC,KAKb;QACG,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAA2B,uBAAuB,EAAE,KAAK,CAAC,CAAA;IACnF,CAAC;CACJ"}
@@ -5,6 +5,10 @@
5
5
  * - POST /api/v1/search — Unified search across entities (C572-FS54/10: moved off
6
6
  * /api/agent/v1, dual-audience-dispatched at the route — see agent-sdk.ts's
7
7
  * createAgentClient wiring)
8
+ *
9
+ * C740: `embedding` is now OPTIONAL — a caller-supplied vector is still honored, but
10
+ * every mcp/agent caller now sends `query` text only; the API embeds it server-side
11
+ * (Jina) via F288's resolveEmbeddingForRoute.
8
12
  */
9
13
  import type { HttpClient } from '../../transport/http-client.js';
10
14
  export interface SearchResult {
@@ -25,15 +29,18 @@ export declare class AgentSearchClient {
25
29
  /**
26
30
  * F262: Unified semantic search across documents, messages, memories, conversations.
27
31
  *
28
- * @param embedding — Pre-computed 768-dim vector (generated locally via LazyEmbeddingService)
29
- * @param query B565: raw query textused ONLY as a substring fallback for messages
30
- * whose embedding hasn't been generated yet (async backfill lag / janitor outage)
32
+ * @param embedding — Optional pre-computed vector; a caller-supplied embedding wins
33
+ * (backward compatible). Omit it and send `query` insteadthe API embeds the
34
+ * query text server-side (C740, F288's resolveEmbeddingForRoute).
35
+ * @param query — Query text. Server-embedded when `embedding` is omitted (C740); also
36
+ * used as a substring fallback for messages whose embedding hasn't been generated
37
+ * yet (B565, async backfill lag / janitor outage).
31
38
  * @param sources — Which entities to search (default: all)
32
39
  * @param limit — Max results (default 20, max 100)
33
40
  * @param filters — Optional filters: project, agentId, threadId, actorId
34
41
  */
35
42
  unifiedSearch(input: {
36
- embedding: number[];
43
+ embedding?: number[];
37
44
  query?: string;
38
45
  sources?: ('documents' | 'memories' | 'conversations' | 'messages')[];
39
46
  limit?: number;
@@ -49,7 +56,7 @@ export declare class AgentSearchClient {
49
56
  * Convenience wrapper around unifiedSearch with source='messages'.
50
57
  */
51
58
  searchMessages(input: {
52
- embedding: number[];
59
+ embedding?: number[];
53
60
  query?: string;
54
61
  limit?: number;
55
62
  filters?: {
@@ -63,7 +70,8 @@ export declare class AgentSearchClient {
63
70
  * Convenience wrapper around unifiedSearch with source='documents'.
64
71
  */
65
72
  searchDocuments(input: {
66
- embedding: number[];
73
+ embedding?: number[];
74
+ query?: string;
67
75
  limit?: number;
68
76
  filters?: {
69
77
  project?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"search.client.d.ts","sourceRoot":"","sources":["../../../src/clients/agent/search.client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAA;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,qBAAa,iBAAiB;IACd,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;OASG;IACG,aAAa,CAAC,KAAK,EAAE;QACvB,SAAS,EAAE,MAAM,EAAE,CAAA;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,CAAC,WAAW,GAAG,UAAU,GAAG,eAAe,GAAG,UAAU,CAAC,EAAE,CAAA;QACrE,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE;YACN,OAAO,CAAC,EAAE,MAAM,CAAA;YAChB,OAAO,CAAC,EAAE,MAAM,CAAA;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;YACjB,OAAO,CAAC,EAAE,MAAM,CAAA;SACnB,CAAA;KACJ,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIlC;;;OAGG;IACG,cAAc,CAAC,KAAK,EAAE;QACxB,SAAS,EAAE,MAAM,EAAE,CAAA;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE;YACN,OAAO,CAAC,EAAE,MAAM,CAAA;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;YACjB,OAAO,CAAC,EAAE,MAAM,CAAA;SACnB,CAAA;KACJ,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUlC;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE;QACzB,SAAS,EAAE,MAAM,EAAE,CAAA;QACnB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE;YACN,OAAO,CAAC,EAAE,MAAM,CAAA;SACnB,CAAA;KACJ,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAQrC"}
1
+ {"version":3,"file":"search.client.d.ts","sourceRoot":"","sources":["../../../src/clients/agent/search.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAA;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,qBAAa,iBAAiB;IACd,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,KAAK,EAAE;QACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,CAAC,WAAW,GAAG,UAAU,GAAG,eAAe,GAAG,UAAU,CAAC,EAAE,CAAA;QACrE,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE;YACN,OAAO,CAAC,EAAE,MAAM,CAAA;YAChB,OAAO,CAAC,EAAE,MAAM,CAAA;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;YACjB,OAAO,CAAC,EAAE,MAAM,CAAA;SACnB,CAAA;KACJ,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIlC;;;OAGG;IACG,cAAc,CAAC,KAAK,EAAE;QACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE;YACN,OAAO,CAAC,EAAE,MAAM,CAAA;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;YACjB,OAAO,CAAC,EAAE,MAAM,CAAA;SACnB,CAAA;KACJ,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUlC;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE;QACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;QACpB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE;YACN,OAAO,CAAC,EAAE,MAAM,CAAA;SACnB,CAAA;KACJ,GAAG,OAAO,CAAC,qBAAqB,CAAC;CASrC"}
@@ -5,6 +5,10 @@
5
5
  * - POST /api/v1/search — Unified search across entities (C572-FS54/10: moved off
6
6
  * /api/agent/v1, dual-audience-dispatched at the route — see agent-sdk.ts's
7
7
  * createAgentClient wiring)
8
+ *
9
+ * C740: `embedding` is now OPTIONAL — a caller-supplied vector is still honored, but
10
+ * every mcp/agent caller now sends `query` text only; the API embeds it server-side
11
+ * (Jina) via F288's resolveEmbeddingForRoute.
8
12
  */
9
13
  export class AgentSearchClient {
10
14
  http;
@@ -14,9 +18,12 @@ export class AgentSearchClient {
14
18
  /**
15
19
  * F262: Unified semantic search across documents, messages, memories, conversations.
16
20
  *
17
- * @param embedding — Pre-computed 768-dim vector (generated locally via LazyEmbeddingService)
18
- * @param query B565: raw query textused ONLY as a substring fallback for messages
19
- * whose embedding hasn't been generated yet (async backfill lag / janitor outage)
21
+ * @param embedding — Optional pre-computed vector; a caller-supplied embedding wins
22
+ * (backward compatible). Omit it and send `query` insteadthe API embeds the
23
+ * query text server-side (C740, F288's resolveEmbeddingForRoute).
24
+ * @param query — Query text. Server-embedded when `embedding` is omitted (C740); also
25
+ * used as a substring fallback for messages whose embedding hasn't been generated
26
+ * yet (B565, async backfill lag / janitor outage).
20
27
  * @param sources — Which entities to search (default: all)
21
28
  * @param limit — Max results (default 20, max 100)
22
29
  * @param filters — Optional filters: project, agentId, threadId, actorId
@@ -44,6 +51,7 @@ export class AgentSearchClient {
44
51
  async searchDocuments(input) {
45
52
  return this.unifiedSearch({
46
53
  embedding: input.embedding,
54
+ query: input.query,
47
55
  sources: ['documents'],
48
56
  limit: input.limit,
49
57
  filters: input.filters,
@@ -1 +1 @@
1
- {"version":3,"file":"search.client.js","sourceRoot":"","sources":["../../../src/clients/agent/search.client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,MAAM,OAAO,iBAAiB;IACN;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;OASG;IACH,KAAK,CAAC,aAAa,CAAC,KAWnB;QACG,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAwB,SAAS,EAAE,KAAK,CAAC,CAAA;IAClE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,KASpB;QACG,OAAO,IAAI,CAAC,aAAa,CAAC;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,CAAC,UAAU,CAAC;YACrB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC,CAAA;IACN,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,KAMrB;QACG,OAAO,IAAI,CAAC,aAAa,CAAC;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,CAAC,WAAW,CAAC;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC,CAAA;IACN,CAAC;CACJ"}
1
+ {"version":3,"file":"search.client.js","sourceRoot":"","sources":["../../../src/clients/agent/search.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,MAAM,OAAO,iBAAiB;IACN;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,aAAa,CAAC,KAWnB;QACG,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAwB,SAAS,EAAE,KAAK,CAAC,CAAA;IAClE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,KASpB;QACG,OAAO,IAAI,CAAC,aAAa,CAAC;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,CAAC,UAAU,CAAC;YACrB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC,CAAA;IACN,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,KAOrB;QACG,OAAO,IAAI,CAAC,aAAa,CAAC;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,CAAC,WAAW,CAAC;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC,CAAA;IACN,CAAC;CACJ"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@beacon-build/sdk",
3
- "version": "1.49.4",
3
+ "version": "1.49.6",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -26,7 +26,7 @@
26
26
  "@types/react": "^19.2.0",
27
27
  "@types/react-dom": "^19.2.0",
28
28
  "event-source-polyfill": "^1.0.31",
29
- "@beacon-build/core": "1.49.4"
29
+ "@beacon-build/core": "1.49.6"
30
30
  },
31
31
  "devDependencies": {
32
32
  "@testing-library/react": "^16.3.2",