@bitbitpress/client 1.2.2 → 1.2.3

package/dist/generated/openapi.d.ts

@@ -1102,19 +1102,23 @@ export interface paths {
                             configurationKeyName?: string;
                             /** @description How many recent stored synthesis outputs to expose in the streamed `synthesisHistory` / `synthesisHistoryEntries` fields. Defaults to 0 (no history emitted). When > 0, the final data event includes a `synthesisHistoryEntries` array of up to N `{ synthesisOutputId, data }` (most-recent first; each row's payload paired with its output id, so submissions can attach to a specific historical output), and — DEPRECATED, for older app builds — an index-aligned `synthesisHistory` array of the same bare `data` payloads. The first entry is the current synthesis itself — the same payload `data` is derived from — and the remaining entries are older stored rows. */
                             synthesisHistoryLimit?: number;
-                            /** @description Per-request overrides for search options. */
+                            /** @description Per-request overrides for the entry agent's search options (merged over the config). Deliberately limited to per-request scoping — a recency window and tag filters. Search SHAPE (which data sources, search type, mime/asset types, result/bit counts) is a config-design decision and is NOT overridable per request. */
                             searchOptionsOverrides?: {
                                 /** @description Override for search lookback window in minutes (e.g. 1440 for last 24 hours). */
                                 lookbackMinutes?: number;
+                                /** @description Only include assets carrying at least one of these tags. */
+                                includeTags?: string[];
+                                /** @description Exclude assets carrying any of these tags. */
+                                excludeTags?: string[];
                             };
-                            /** @description Inputs used as context for the synthesis: externalId (article ID), or text (freeform text). */
+                            /** @description Inputs used as context for the synthesis. Each agent only receives the input types listed in its own config. Types: text (freeform), externalId (an asset by external id, injected as context), assetIds (comma-separated INTERNAL asset ids, injected as context), synthesisOutputIds (comma-separated SynthesisOutput ids whose data is injected as context), excludeExternalIds / excludeAssetIds (comma-separated ids excluded from search). */
                             inputs?: {
                                 /**
-                                 * @description Type of input: externalId (article) or text (freeform).
+                                 * @description Input type. externalId = one asset by external id; assetIds = internal asset ids (comma-separated); synthesisOutputIds = prior output ids (comma-separated); text = freeform; excludeExternalIds / excludeAssetIds = ids to exclude from search (comma-separated).
                                  * @enum {string}
                                  */
-                                type: "externalId" | "text" | "excludeExternalIds";
-                                /** @description External ID (e.g. article) for externalId, freeform text for text, or comma-separated list of external IDs to exclude */
+                                type: "externalId" | "text" | "assetIds" | "synthesisOutputIds" | "excludeExternalIds" | "excludeAssetIds";
+                                /** @description The input value: an external id / freeform text, or a comma-separated list of ids for assetIds / synthesisOutputIds / excludeExternalIds / excludeAssetIds. */
                                 value: string;
                             }[];
                             /** @description Optional output definition. Omit to use the output schema declared on the config named by `configurationKeyName` (`output.outputSchema`). */
@@ -1270,19 +1274,23 @@ export interface paths {
                             keyName: string;
                             /** @description How many recent stored synthesis outputs to expose in the streamed `synthesisHistory` / `synthesisHistoryEntries` fields. Defaults to 0. See `/v1/user/synthesize` for the full semantics. */
                             synthesisHistoryLimit?: number;
-                            /** @description Per-request overrides for search options. */
+                            /** @description Per-request overrides for the entry agent's search options (merged over the config). Deliberately limited to per-request scoping — a recency window and tag filters. Search SHAPE (which data sources, search type, mime/asset types, result/bit counts) is a config-design decision and is NOT overridable per request. */
                             searchOptionsOverrides?: {
                                 /** @description Override for search lookback window in minutes (e.g. 1440 for last 24 hours). */
                                 lookbackMinutes?: number;
+                                /** @description Only include assets carrying at least one of these tags. */
+                                includeTags?: string[];
+                                /** @description Exclude assets carrying any of these tags. */
+                                excludeTags?: string[];
                             };
-                            /** @description Inputs used as context for the synthesis: externalId (article ID), or text (freeform text). */
+                            /** @description Inputs used as context for the synthesis. Each agent only receives the input types listed in its own config. Types: text (freeform), externalId (an asset by external id), assetIds (comma-separated INTERNAL asset ids), synthesisOutputIds (comma-separated SynthesisOutput ids whose data is injected as context), excludeExternalIds / excludeAssetIds (comma-separated ids excluded from search). */
                             inputs?: {
                                 /**
-                                 * @description Type of input: externalId (article) or text (freeform).
+                                 * @description Input type. externalId = one asset by external id; assetIds = internal asset ids (comma-separated); synthesisOutputIds = prior output ids (comma-separated); text = freeform; excludeExternalIds / excludeAssetIds = ids to exclude from search (comma-separated).
                                  * @enum {string}
                                  */
-                                type: "externalId" | "text" | "excludeExternalIds";
-                                /** @description External ID (e.g. article) for externalId, freeform text for text, or comma-separated list of external IDs to exclude */
+                                type: "externalId" | "text" | "assetIds" | "synthesisOutputIds" | "excludeExternalIds" | "excludeAssetIds";
+                                /** @description The input value: an external id / freeform text, or a comma-separated list of ids for assetIds / synthesisOutputIds / excludeExternalIds / excludeAssetIds. */
                                 value: string;
                             }[];
                             /** @description Optional output definition. Omit to use the output schema declared on the UI's attached config (`output.outputSchema`). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitbitpress/client",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "BitBitPress TypeScript client library",
   "type": "module",
   "main": "./dist/index.js",