@genesislcap/foundation-ai 14.421.0 → 14.421.1-FUI-2511.1
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/dts/index.d.ts +1 -1
- package/dist/dts/index.d.ts.map +1 -1
- package/dist/dts/transports/gemini-transport.d.ts +2 -0
- package/dist/dts/transports/gemini-transport.d.ts.map +1 -1
- package/dist/dts/types/chat.types.d.ts +49 -1
- package/dist/dts/types/chat.types.d.ts.map +1 -1
- package/dist/esm/transports/gemini-transport.js +6 -1
- package/dist/foundation-ai.api.json +156 -5
- package/dist/foundation-ai.d.ts +52 -1
- package/package.json +11 -11
package/dist/dts/index.d.ts
CHANGED
|
@@ -4,7 +4,7 @@ export { GeminiTransport, MalformedFunctionCallError } from './transports/gemini
|
|
|
4
4
|
export { AI_FEATURE_FLAG, isAIFeatureEnabled } from './utils/feature-flags';
|
|
5
5
|
export { SUPPORTED_GEMINI_MODEL_IDS } from './types';
|
|
6
6
|
export type { AIConfig, AIStatus, AIProviderType, ChromeAIConfig, ChromeAvailability, GeminiAIConfig, GeminiModelId, ServerAIConfig, } from './types';
|
|
7
|
-
export type { ChatAgentConfig, ChatAnimationsConfig, ChatAttachment, ChatConfig, ChatDriverResult, ChatMessage, ChatInteraction, ChatRequestOptions, ChatRole, ChatStreamChunk, ChatToolCall, ChatToolCallUnknown, ChatToolDefinition, ChatToolHandlers, ChatToolResult, ChatUiConfig, ChatSuggestionsConfig, InteractionResult, } from './types/chat.types';
|
|
7
|
+
export type { ChatAgentConfig, ChatAnimationsConfig, ChatAttachment, ChatConfig, ChatDriverResult, ChatMessage, ChatInteraction, ChatRequestOptions, ChatRole, ChatStreamChunk, ChatToolCall, ChatToolCallUnknown, ChatToolDefinition, ChatToolHandlers, ChatToolResult, ChatUiConfig, ChatSuggestionsConfig, InteractionResult, SubAgentRequestOptions, } from './types/chat.types';
|
|
8
8
|
export { isChatToolCallUnknown } from './types/chat.types';
|
|
9
9
|
export type { ChatTransport } from './types/chat-transport.types';
|
|
10
10
|
export type { ResolveAIConfigOptions } from './ai-provider';
|
package/dist/dts/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AACrD,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AACrD,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}
|
|
@@ -60,6 +60,8 @@ export declare class GeminiTransport implements AITransport, ChatTransport {
|
|
|
60
60
|
private buildEndpoint;
|
|
61
61
|
private static readonly MAX_RETRIES;
|
|
62
62
|
private static readonly RATE_LIMIT_STATUS;
|
|
63
|
+
private static readonly SERVICE_UNAVAILABLE_STATUS;
|
|
64
|
+
private static readonly RETRYABLE_STATUSES;
|
|
63
65
|
private static readonly BACKOFF_BASE_MS;
|
|
64
66
|
private post;
|
|
65
67
|
private toDirectPayload;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"gemini-transport.d.ts","sourceRoot":"","sources":["../../../src/transports/gemini-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC7B,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAEV,WAAW,EACX,kBAAkB,EAEnB,MAAM,qBAAqB,CAAC;AA6B7B,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM;gBAAtB,aAAa,CAAC,EAAE,MAAM;CAI5C;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,WAAW,EAAE,aAAa;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,MAAM,GAAE,qBAA0B;IAe9C,SAAS,IAAI;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE;IAMnD,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBvE,eAAe,CACnB,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC;IA4BvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IAEhD,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,gBAAgB;IAgDxB,OAAO,CAAC,kBAAkB;IAkE1B,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;YAEjC,IAAI;IAgDlB,OAAO,CAAC,eAAe;CAexB"}
|
|
1
|
+
{"version":3,"file":"gemini-transport.d.ts","sourceRoot":"","sources":["../../../src/transports/gemini-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC7B,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAEV,WAAW,EACX,kBAAkB,EAEnB,MAAM,qBAAqB,CAAC;AA6B7B,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM;gBAAtB,aAAa,CAAC,EAAE,MAAM;CAI5C;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,WAAW,EAAE,aAAa;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,MAAM,GAAE,qBAA0B;IAe9C,SAAS,IAAI;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE;IAMnD,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBvE,eAAe,CACnB,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC;IA4BvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IAEhD,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,gBAAgB;IAgDxB,OAAO,CAAC,kBAAkB;IAkE1B,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAO;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAGxC;IACF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;YAEjC,IAAI;IAgDlB,OAAO,CAAC,eAAe;CAexB"}
|
|
@@ -25,6 +25,12 @@ type ChatToolCallBase = {
|
|
|
25
25
|
* Not sent to the AI provider.
|
|
26
26
|
*/
|
|
27
27
|
foldPath?: string[];
|
|
28
|
+
/**
|
|
29
|
+
* Full message history from the sub-agent run that produced this tool call's result.
|
|
30
|
+
* Populated by SubAgentRunner when a tool handler delegates to a sub-agent.
|
|
31
|
+
* UI-only — not sent to the AI provider.
|
|
32
|
+
*/
|
|
33
|
+
subAgentTrace?: ChatMessage[];
|
|
28
34
|
};
|
|
29
35
|
/**
|
|
30
36
|
* A tool call for a tool name the driver could not resolve to any handler.
|
|
@@ -122,13 +128,55 @@ export interface ChatToolDefinition {
|
|
|
122
128
|
description: string;
|
|
123
129
|
parameters: Record<string, unknown>;
|
|
124
130
|
}
|
|
131
|
+
/**
|
|
132
|
+
* Options passed to `requestSubAgent` at call time.
|
|
133
|
+
*
|
|
134
|
+
* @beta
|
|
135
|
+
*/
|
|
136
|
+
export interface SubAgentRequestOptions {
|
|
137
|
+
/** Plain-language description of what this specific invocation should do. */
|
|
138
|
+
task?: string;
|
|
139
|
+
/** Per-call override of the config-level historyCap. */
|
|
140
|
+
historyCap?: number;
|
|
141
|
+
/** Extra dynamic data injected as a primer message before the task. */
|
|
142
|
+
context?: Record<string, unknown>;
|
|
143
|
+
}
|
|
125
144
|
/**
|
|
126
145
|
* Map of tool name to async handler function.
|
|
127
146
|
*
|
|
147
|
+
* Optionally parameterised with the sub-agents available to this handler set.
|
|
148
|
+
* Pass the config objects (not string literals) so the name union is derived
|
|
149
|
+
* from the actual configs:
|
|
150
|
+
*
|
|
151
|
+
* ```ts
|
|
152
|
+
* const mySubAgent = { name: 'my_sub_agent', ... } satisfies AgentConfig;
|
|
153
|
+
* type MyHandlers = ChatToolHandlers<typeof mySubAgent>;
|
|
154
|
+
* // requestSubAgent's name param is now typed as 'my_sub_agent'
|
|
155
|
+
* ```
|
|
156
|
+
*
|
|
157
|
+
* Multiple sub-agents: `ChatToolHandlers<typeof agentA | typeof agentB>`.
|
|
158
|
+
* Default (`{ name: string }`) leaves the name param as `string` — no breaking change.
|
|
159
|
+
*
|
|
128
160
|
* @beta
|
|
129
161
|
*/
|
|
130
|
-
export type ChatToolHandlers
|
|
162
|
+
export type ChatToolHandlers<TSubAgent extends {
|
|
163
|
+
name: string;
|
|
164
|
+
} = {
|
|
165
|
+
name: string;
|
|
166
|
+
}> = Record<string, (args: Record<string, unknown>, context: {
|
|
131
167
|
requestInteraction: <T = unknown>(componentName: string, data: any) => Promise<T>;
|
|
168
|
+
/**
|
|
169
|
+
* Delegate to a named sub-agent declared on the parent agent config.
|
|
170
|
+
* Returns the sub-agent's structured result (when `completeSubAgent` was called) or
|
|
171
|
+
* its final assistant message text as a fallback.
|
|
172
|
+
*/
|
|
173
|
+
requestSubAgent?: <T = never>(name: TSubAgent['name'], options?: SubAgentRequestOptions) => Promise<T | string>;
|
|
174
|
+
/**
|
|
175
|
+
* Signal explicit completion from within a sub-agent tool handler.
|
|
176
|
+
* The resolved value is returned to the parent handler as the structured result of
|
|
177
|
+
* `requestSubAgent`. Only available inside sub-agent tool handlers.
|
|
178
|
+
*/
|
|
179
|
+
completeSubAgent?: (result: unknown) => void;
|
|
132
180
|
}) => Promise<unknown>>;
|
|
133
181
|
/**
|
|
134
182
|
* Options for a chat request.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../../../src/types/chat.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,cAAc,CAAC;AAEjF;;;;GAIG;AACH,KAAK,gBAAgB,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../../../src/types/chat.types.ts"],"names":[],"mappings":"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"}
|
|
@@ -241,7 +241,7 @@ export class GeminiTransport {
|
|
|
241
241
|
throw e;
|
|
242
242
|
}
|
|
243
243
|
clearTimeout(timeoutId);
|
|
244
|
-
if (response.status
|
|
244
|
+
if (GeminiTransport.RETRYABLE_STATUSES.includes(response.status) &&
|
|
245
245
|
attempt < GeminiTransport.MAX_RETRIES) {
|
|
246
246
|
// Exponential backoff: 1s, 2s, 4s, 8s, 16s
|
|
247
247
|
yield new Promise((resolve) => {
|
|
@@ -274,4 +274,9 @@ GeminiTransport.TOKENS_PER_MILLION = 1000000;
|
|
|
274
274
|
GeminiTransport.COST_DECIMAL_PLACES = 6;
|
|
275
275
|
GeminiTransport.MAX_RETRIES = 5;
|
|
276
276
|
GeminiTransport.RATE_LIMIT_STATUS = 429;
|
|
277
|
+
GeminiTransport.SERVICE_UNAVAILABLE_STATUS = 503;
|
|
278
|
+
GeminiTransport.RETRYABLE_STATUSES = [
|
|
279
|
+
GeminiTransport.RATE_LIMIT_STATUS,
|
|
280
|
+
GeminiTransport.SERVICE_UNAVAILABLE_STATUS,
|
|
281
|
+
];
|
|
277
282
|
GeminiTransport.BACKOFF_BASE_MS = 1000;
|
|
@@ -2125,11 +2125,27 @@
|
|
|
2125
2125
|
{
|
|
2126
2126
|
"kind": "TypeAlias",
|
|
2127
2127
|
"canonicalReference": "@genesislcap/foundation-ai!ChatToolHandlers:type",
|
|
2128
|
-
"docComment": "/**\n * Map of tool name to async handler function.\n *\n * @beta\n */\n",
|
|
2128
|
+
"docComment": "/**\n * Map of tool name to async handler function.\n *\n * Optionally parameterised with the sub-agents available to this handler set. Pass the config objects (not string literals) so the name union is derived from the actual configs:\n * ```ts\n * const mySubAgent = { name: 'my_sub_agent', ... } satisfies AgentConfig;\n * type MyHandlers = ChatToolHandlers<typeof mySubAgent>;\n * // requestSubAgent's name param is now typed as 'my_sub_agent'\n * ```\n *\n * Multiple sub-agents: `ChatToolHandlers<typeof agentA | typeof agentB>`. Default (`{ name: string }`) leaves the name param as `string` — no breaking change.\n *\n * @beta\n */\n",
|
|
2129
2129
|
"excerptTokens": [
|
|
2130
2130
|
{
|
|
2131
2131
|
"kind": "Content",
|
|
2132
|
-
"text": "export type ChatToolHandlers
|
|
2132
|
+
"text": "export type ChatToolHandlers<TSubAgent extends "
|
|
2133
|
+
},
|
|
2134
|
+
{
|
|
2135
|
+
"kind": "Content",
|
|
2136
|
+
"text": "{\n name: string;\n}"
|
|
2137
|
+
},
|
|
2138
|
+
{
|
|
2139
|
+
"kind": "Content",
|
|
2140
|
+
"text": " = "
|
|
2141
|
+
},
|
|
2142
|
+
{
|
|
2143
|
+
"kind": "Content",
|
|
2144
|
+
"text": "{\n name: string;\n}"
|
|
2145
|
+
},
|
|
2146
|
+
{
|
|
2147
|
+
"kind": "Content",
|
|
2148
|
+
"text": "> = "
|
|
2133
2149
|
},
|
|
2134
2150
|
{
|
|
2135
2151
|
"kind": "Reference",
|
|
@@ -2156,7 +2172,25 @@
|
|
|
2156
2172
|
},
|
|
2157
2173
|
{
|
|
2158
2174
|
"kind": "Content",
|
|
2159
|
-
"text": "<T>;\n
|
|
2175
|
+
"text": "<T>;\n requestSubAgent?: <T = never>(name: TSubAgent['name'], options?: "
|
|
2176
|
+
},
|
|
2177
|
+
{
|
|
2178
|
+
"kind": "Reference",
|
|
2179
|
+
"text": "SubAgentRequestOptions",
|
|
2180
|
+
"canonicalReference": "@genesislcap/foundation-ai!SubAgentRequestOptions:interface"
|
|
2181
|
+
},
|
|
2182
|
+
{
|
|
2183
|
+
"kind": "Content",
|
|
2184
|
+
"text": ") => "
|
|
2185
|
+
},
|
|
2186
|
+
{
|
|
2187
|
+
"kind": "Reference",
|
|
2188
|
+
"text": "Promise",
|
|
2189
|
+
"canonicalReference": "!Promise:interface"
|
|
2190
|
+
},
|
|
2191
|
+
{
|
|
2192
|
+
"kind": "Content",
|
|
2193
|
+
"text": "<T | string>;\n completeSubAgent?: (result: unknown) => void;\n}) => "
|
|
2160
2194
|
},
|
|
2161
2195
|
{
|
|
2162
2196
|
"kind": "Reference",
|
|
@@ -2175,9 +2209,22 @@
|
|
|
2175
2209
|
"fileUrlPath": "src/types/chat.types.ts",
|
|
2176
2210
|
"releaseTag": "Beta",
|
|
2177
2211
|
"name": "ChatToolHandlers",
|
|
2212
|
+
"typeParameters": [
|
|
2213
|
+
{
|
|
2214
|
+
"typeParameterName": "TSubAgent",
|
|
2215
|
+
"constraintTokenRange": {
|
|
2216
|
+
"startIndex": 1,
|
|
2217
|
+
"endIndex": 2
|
|
2218
|
+
},
|
|
2219
|
+
"defaultTypeTokenRange": {
|
|
2220
|
+
"startIndex": 3,
|
|
2221
|
+
"endIndex": 4
|
|
2222
|
+
}
|
|
2223
|
+
}
|
|
2224
|
+
],
|
|
2178
2225
|
"typeTokenRange": {
|
|
2179
|
-
"startIndex":
|
|
2180
|
-
"endIndex":
|
|
2226
|
+
"startIndex": 5,
|
|
2227
|
+
"endIndex": 17
|
|
2181
2228
|
}
|
|
2182
2229
|
},
|
|
2183
2230
|
{
|
|
@@ -4722,6 +4769,110 @@
|
|
|
4722
4769
|
],
|
|
4723
4770
|
"name": "startSpeechRecognition"
|
|
4724
4771
|
},
|
|
4772
|
+
{
|
|
4773
|
+
"kind": "Interface",
|
|
4774
|
+
"canonicalReference": "@genesislcap/foundation-ai!SubAgentRequestOptions:interface",
|
|
4775
|
+
"docComment": "/**\n * Options passed to `requestSubAgent` at call time.\n *\n * @beta\n */\n",
|
|
4776
|
+
"excerptTokens": [
|
|
4777
|
+
{
|
|
4778
|
+
"kind": "Content",
|
|
4779
|
+
"text": "export interface SubAgentRequestOptions "
|
|
4780
|
+
}
|
|
4781
|
+
],
|
|
4782
|
+
"fileUrlPath": "src/types/chat.types.ts",
|
|
4783
|
+
"releaseTag": "Beta",
|
|
4784
|
+
"name": "SubAgentRequestOptions",
|
|
4785
|
+
"preserveMemberOrder": false,
|
|
4786
|
+
"members": [
|
|
4787
|
+
{
|
|
4788
|
+
"kind": "PropertySignature",
|
|
4789
|
+
"canonicalReference": "@genesislcap/foundation-ai!SubAgentRequestOptions#context:member",
|
|
4790
|
+
"docComment": "/**\n * Extra dynamic data injected as a primer message before the task.\n */\n",
|
|
4791
|
+
"excerptTokens": [
|
|
4792
|
+
{
|
|
4793
|
+
"kind": "Content",
|
|
4794
|
+
"text": "context?: "
|
|
4795
|
+
},
|
|
4796
|
+
{
|
|
4797
|
+
"kind": "Reference",
|
|
4798
|
+
"text": "Record",
|
|
4799
|
+
"canonicalReference": "!Record:type"
|
|
4800
|
+
},
|
|
4801
|
+
{
|
|
4802
|
+
"kind": "Content",
|
|
4803
|
+
"text": "<string, unknown>"
|
|
4804
|
+
},
|
|
4805
|
+
{
|
|
4806
|
+
"kind": "Content",
|
|
4807
|
+
"text": ";"
|
|
4808
|
+
}
|
|
4809
|
+
],
|
|
4810
|
+
"isReadonly": false,
|
|
4811
|
+
"isOptional": true,
|
|
4812
|
+
"releaseTag": "Beta",
|
|
4813
|
+
"name": "context",
|
|
4814
|
+
"propertyTypeTokenRange": {
|
|
4815
|
+
"startIndex": 1,
|
|
4816
|
+
"endIndex": 3
|
|
4817
|
+
}
|
|
4818
|
+
},
|
|
4819
|
+
{
|
|
4820
|
+
"kind": "PropertySignature",
|
|
4821
|
+
"canonicalReference": "@genesislcap/foundation-ai!SubAgentRequestOptions#historyCap:member",
|
|
4822
|
+
"docComment": "/**\n * Per-call override of the config-level historyCap.\n */\n",
|
|
4823
|
+
"excerptTokens": [
|
|
4824
|
+
{
|
|
4825
|
+
"kind": "Content",
|
|
4826
|
+
"text": "historyCap?: "
|
|
4827
|
+
},
|
|
4828
|
+
{
|
|
4829
|
+
"kind": "Content",
|
|
4830
|
+
"text": "number"
|
|
4831
|
+
},
|
|
4832
|
+
{
|
|
4833
|
+
"kind": "Content",
|
|
4834
|
+
"text": ";"
|
|
4835
|
+
}
|
|
4836
|
+
],
|
|
4837
|
+
"isReadonly": false,
|
|
4838
|
+
"isOptional": true,
|
|
4839
|
+
"releaseTag": "Beta",
|
|
4840
|
+
"name": "historyCap",
|
|
4841
|
+
"propertyTypeTokenRange": {
|
|
4842
|
+
"startIndex": 1,
|
|
4843
|
+
"endIndex": 2
|
|
4844
|
+
}
|
|
4845
|
+
},
|
|
4846
|
+
{
|
|
4847
|
+
"kind": "PropertySignature",
|
|
4848
|
+
"canonicalReference": "@genesislcap/foundation-ai!SubAgentRequestOptions#task:member",
|
|
4849
|
+
"docComment": "/**\n * Plain-language description of what this specific invocation should do.\n */\n",
|
|
4850
|
+
"excerptTokens": [
|
|
4851
|
+
{
|
|
4852
|
+
"kind": "Content",
|
|
4853
|
+
"text": "task?: "
|
|
4854
|
+
},
|
|
4855
|
+
{
|
|
4856
|
+
"kind": "Content",
|
|
4857
|
+
"text": "string"
|
|
4858
|
+
},
|
|
4859
|
+
{
|
|
4860
|
+
"kind": "Content",
|
|
4861
|
+
"text": ";"
|
|
4862
|
+
}
|
|
4863
|
+
],
|
|
4864
|
+
"isReadonly": false,
|
|
4865
|
+
"isOptional": true,
|
|
4866
|
+
"releaseTag": "Beta",
|
|
4867
|
+
"name": "task",
|
|
4868
|
+
"propertyTypeTokenRange": {
|
|
4869
|
+
"startIndex": 1,
|
|
4870
|
+
"endIndex": 2
|
|
4871
|
+
}
|
|
4872
|
+
}
|
|
4873
|
+
],
|
|
4874
|
+
"extendsTokenRanges": []
|
|
4875
|
+
},
|
|
4725
4876
|
{
|
|
4726
4877
|
"kind": "Variable",
|
|
4727
4878
|
"canonicalReference": "@genesislcap/foundation-ai!SUPPORTED_GEMINI_MODEL_IDS:var",
|
package/dist/foundation-ai.d.ts
CHANGED
|
@@ -310,6 +310,12 @@ declare type ChatToolCallBase = {
|
|
|
310
310
|
* Not sent to the AI provider.
|
|
311
311
|
*/
|
|
312
312
|
foldPath?: string[];
|
|
313
|
+
/**
|
|
314
|
+
* Full message history from the sub-agent run that produced this tool call's result.
|
|
315
|
+
* Populated by SubAgentRunner when a tool handler delegates to a sub-agent.
|
|
316
|
+
* UI-only — not sent to the AI provider.
|
|
317
|
+
*/
|
|
318
|
+
subAgentTrace?: ChatMessage[];
|
|
313
319
|
};
|
|
314
320
|
|
|
315
321
|
/**
|
|
@@ -338,10 +344,39 @@ export declare interface ChatToolDefinition {
|
|
|
338
344
|
/**
|
|
339
345
|
* Map of tool name to async handler function.
|
|
340
346
|
*
|
|
347
|
+
* Optionally parameterised with the sub-agents available to this handler set.
|
|
348
|
+
* Pass the config objects (not string literals) so the name union is derived
|
|
349
|
+
* from the actual configs:
|
|
350
|
+
*
|
|
351
|
+
* ```ts
|
|
352
|
+
* const mySubAgent = { name: 'my_sub_agent', ... } satisfies AgentConfig;
|
|
353
|
+
* type MyHandlers = ChatToolHandlers<typeof mySubAgent>;
|
|
354
|
+
* // requestSubAgent's name param is now typed as 'my_sub_agent'
|
|
355
|
+
* ```
|
|
356
|
+
*
|
|
357
|
+
* Multiple sub-agents: `ChatToolHandlers<typeof agentA | typeof agentB>`.
|
|
358
|
+
* Default (`{ name: string }`) leaves the name param as `string` — no breaking change.
|
|
359
|
+
*
|
|
341
360
|
* @beta
|
|
342
361
|
*/
|
|
343
|
-
export declare type ChatToolHandlers
|
|
362
|
+
export declare type ChatToolHandlers<TSubAgent extends {
|
|
363
|
+
name: string;
|
|
364
|
+
} = {
|
|
365
|
+
name: string;
|
|
366
|
+
}> = Record<string, (args: Record<string, unknown>, context: {
|
|
344
367
|
requestInteraction: <T = unknown>(componentName: string, data: any) => Promise<T>;
|
|
368
|
+
/**
|
|
369
|
+
* Delegate to a named sub-agent declared on the parent agent config.
|
|
370
|
+
* Returns the sub-agent's structured result (when `completeSubAgent` was called) or
|
|
371
|
+
* its final assistant message text as a fallback.
|
|
372
|
+
*/
|
|
373
|
+
requestSubAgent?: <T = never>(name: TSubAgent['name'], options?: SubAgentRequestOptions) => Promise<T | string>;
|
|
374
|
+
/**
|
|
375
|
+
* Signal explicit completion from within a sub-agent tool handler.
|
|
376
|
+
* The resolved value is returned to the parent handler as the structured result of
|
|
377
|
+
* `requestSubAgent`. Only available inside sub-agent tool handlers.
|
|
378
|
+
*/
|
|
379
|
+
completeSubAgent?: (result: unknown) => void;
|
|
345
380
|
}) => Promise<unknown>>;
|
|
346
381
|
|
|
347
382
|
/**
|
|
@@ -577,6 +612,8 @@ export declare class GeminiTransport implements AITransport, ChatTransport {
|
|
|
577
612
|
private buildEndpoint;
|
|
578
613
|
private static readonly MAX_RETRIES;
|
|
579
614
|
private static readonly RATE_LIMIT_STATUS;
|
|
615
|
+
private static readonly SERVICE_UNAVAILABLE_STATUS;
|
|
616
|
+
private static readonly RETRYABLE_STATUSES;
|
|
580
617
|
private static readonly BACKOFF_BASE_MS;
|
|
581
618
|
private post;
|
|
582
619
|
private toDirectPayload;
|
|
@@ -730,6 +767,20 @@ declare interface StructuredPromptOptions {
|
|
|
730
767
|
responseSchema?: object;
|
|
731
768
|
}
|
|
732
769
|
|
|
770
|
+
/**
|
|
771
|
+
* Options passed to `requestSubAgent` at call time.
|
|
772
|
+
*
|
|
773
|
+
* @beta
|
|
774
|
+
*/
|
|
775
|
+
export declare interface SubAgentRequestOptions {
|
|
776
|
+
/** Plain-language description of what this specific invocation should do. */
|
|
777
|
+
task?: string;
|
|
778
|
+
/** Per-call override of the config-level historyCap. */
|
|
779
|
+
historyCap?: number;
|
|
780
|
+
/** Extra dynamic data injected as a primer message before the task. */
|
|
781
|
+
context?: Record<string, unknown>;
|
|
782
|
+
}
|
|
783
|
+
|
|
733
784
|
/** @beta */
|
|
734
785
|
export declare const SUPPORTED_GEMINI_MODEL_IDS: readonly GeminiModelId[];
|
|
735
786
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@genesislcap/foundation-ai",
|
|
3
3
|
"description": "Genesis Foundation AI - Provider-agnostic AI configuration and shared utilities",
|
|
4
|
-
"version": "14.421.
|
|
4
|
+
"version": "14.421.1-FUI-2511.1",
|
|
5
5
|
"sideEffects": false,
|
|
6
6
|
"license": "SEE LICENSE IN license.txt",
|
|
7
7
|
"main": "dist/esm/index.js",
|
|
@@ -51,17 +51,17 @@
|
|
|
51
51
|
}
|
|
52
52
|
},
|
|
53
53
|
"devDependencies": {
|
|
54
|
-
"@genesislcap/foundation-testing": "14.421.
|
|
55
|
-
"@genesislcap/genx": "14.421.
|
|
56
|
-
"@genesislcap/rollup-builder": "14.421.
|
|
57
|
-
"@genesislcap/ts-builder": "14.421.
|
|
58
|
-
"@genesislcap/uvu-playwright-builder": "14.421.
|
|
59
|
-
"@genesislcap/vite-builder": "14.421.
|
|
60
|
-
"@genesislcap/webpack-builder": "14.421.
|
|
54
|
+
"@genesislcap/foundation-testing": "14.421.1-FUI-2511.1",
|
|
55
|
+
"@genesislcap/genx": "14.421.1-FUI-2511.1",
|
|
56
|
+
"@genesislcap/rollup-builder": "14.421.1-FUI-2511.1",
|
|
57
|
+
"@genesislcap/ts-builder": "14.421.1-FUI-2511.1",
|
|
58
|
+
"@genesislcap/uvu-playwright-builder": "14.421.1-FUI-2511.1",
|
|
59
|
+
"@genesislcap/vite-builder": "14.421.1-FUI-2511.1",
|
|
60
|
+
"@genesislcap/webpack-builder": "14.421.1-FUI-2511.1"
|
|
61
61
|
},
|
|
62
62
|
"dependencies": {
|
|
63
|
-
"@genesislcap/foundation-logger": "14.421.
|
|
64
|
-
"@genesislcap/foundation-utils": "14.421.
|
|
63
|
+
"@genesislcap/foundation-logger": "14.421.1-FUI-2511.1",
|
|
64
|
+
"@genesislcap/foundation-utils": "14.421.1-FUI-2511.1",
|
|
65
65
|
"@microsoft/fast-foundation": "2.50.0"
|
|
66
66
|
},
|
|
67
67
|
"repository": {
|
|
@@ -72,5 +72,5 @@
|
|
|
72
72
|
"publishConfig": {
|
|
73
73
|
"access": "public"
|
|
74
74
|
},
|
|
75
|
-
"gitHead": "
|
|
75
|
+
"gitHead": "db66c28b8fdc4d745eea64795133dde08fa06ad2"
|
|
76
76
|
}
|