@equationalapplications/core-llm-tools 4.11.0 → 4.13.0

package/README.md

@@ -81,6 +81,41 @@ const response = await ai.models.generateContent({
 });
 ```
 
+### 3. Built-In Tools (Grounding)
+
+Some Gemini capabilities, like [Google Search grounding](https://ai.google.dev/gemini-api/docs/google-search),
+are built-in tools executed server-side by Google rather than function declarations your code
+implements. These are declared with `kind: 'built_in'` and flow through the same
+capability-scope model as function tools, via `buildAuthorizedToolsArray`.
+Use `AnyAgentToolManifest` when mixing function and built-in manifests;
+`AgentToolManifest` remains the function-only type for existing callers:
+
+```typescript
+import type { AnyAgentToolManifest } from '@equationalapplications/core-llm-tools';
+import { buildAuthorizedToolsArray, googleSearchManifest, escalateToCloudManifest } from '@equationalapplications/core-llm-tools';
+
+const allAppTools: AnyAgentToolManifest[] = [escalateToCloudManifest, googleSearchManifest];
+const userGrantedScopes: string[] = [];
+
+// Returns the full Gemini tools[] array: a functionDeclarations group (if any
+// function tools are authorized) plus one entry per authorized built-in tool.
+const tools = buildAuthorizedToolsArray(allAppTools, userGrantedScopes);
+// => [{ functionDeclarations: [...] }, { google_search: {} }]
+
+const response = await ai.models.generateContent({
+  model: 'gemini-2.5-flash',
+  contents: userInput,
+  tools,
+});
+```
+
+> **Note:** When the model uses `google_search`, Gemini returns a `groundingMetadata` object
+> (search queries, source citations, etc.) on the response. Parsing that metadata is the
+> caller's responsibility — this package only handles the request-side tool declaration.
+
+`buildAuthorizedSchemaArray` is still available for callers that only ever use function tools,
+but is deprecated in favor of `buildAuthorizedToolsArray`.
+
 ## Helpful Resources & Links
 
 - [Google Gen AI: Function Calling Tutorial](https://ai.google.dev/gemini-api/docs/function-calling) — Official docs on how the JSON schemas in this package interact with Gemini models.

package/dist/index.d.mts

@@ -8,15 +8,49 @@ interface AgentToolSchema {
         required?: string[];
     };
 }
-interface AgentToolManifest {
+/** Names of Gemini built-in tools (executed server-side, no client handler). */
+type BuiltInToolName = 'google_search';
+/** A tool backed by a client-implemented function-calling schema. */
+interface FunctionToolManifest {
     name: string;
     scope: AgentScope;
+    /** Optional for backward compatibility — manifests without this field are function tools. */
+    kind?: 'function';
     schema: AgentToolSchema;
 }
+/** A Gemini built-in tool (e.g. google_search) — no client handler, no parameters. */
+interface BuiltInToolManifest {
+    name: BuiltInToolName;
+    scope: AgentScope;
+    kind: 'built_in';
+    builtIn: BuiltInToolName;
+}
+/** Function-calling tool manifest (stable public contract for downstream callers). */
+type AgentToolManifest = FunctionToolManifest;
+/** Union of function and built-in manifests for mixed tool arrays. */
+type AnyAgentToolManifest = FunctionToolManifest | BuiltInToolManifest;
 
+/**
+ * @deprecated Use buildAuthorizedToolsArray instead — it returns the full Gemini
+ * tools[] array, including built-in tools like google_search. This function only
+ * ever returns function-declaration schemas; built-in manifests are ignored.
+ */
 declare function buildAuthorizedSchemaArray(availableManifests: AgentToolManifest[], userGrantedScopes: string[]): AgentToolSchema[];
+/** One entry of a Gemini `tools[]` array: a function-declarations group, or a built-in tool. */
+type GeminiToolEntry = {
+    functionDeclarations: AgentToolSchema[];
+} | {
+    [K in BuiltInToolName]: Record<string, never>;
+};
+/**
+ * Filters manifests by granted scope (core-scoped manifests always pass) and
+ * returns the full Gemini tools[] array: at most one functionDeclarations
+ * group, plus one entry per authorized built-in tool.
+ */
+declare function buildAuthorizedToolsArray(availableManifests: AnyAgentToolManifest[], userGrantedScopes: string[]): GeminiToolEntry[];
 
 declare const getCurrentTimeManifest: AgentToolManifest;
 declare const escalateToCloudManifest: AgentToolManifest;
+declare const googleSearchManifest: BuiltInToolManifest;
 
-export { type AgentScope, type AgentToolManifest, type AgentToolSchema, buildAuthorizedSchemaArray, escalateToCloudManifest, getCurrentTimeManifest };
+export { type AgentScope, type AgentToolManifest, type AgentToolSchema, type AnyAgentToolManifest, type BuiltInToolManifest, type BuiltInToolName, type FunctionToolManifest, type GeminiToolEntry, buildAuthorizedSchemaArray, buildAuthorizedToolsArray, escalateToCloudManifest, getCurrentTimeManifest, googleSearchManifest };

package/dist/index.d.ts

@@ -8,15 +8,49 @@ interface AgentToolSchema {
         required?: string[];
     };
 }
-interface AgentToolManifest {
+/** Names of Gemini built-in tools (executed server-side, no client handler). */
+type BuiltInToolName = 'google_search';
+/** A tool backed by a client-implemented function-calling schema. */
+interface FunctionToolManifest {
     name: string;
     scope: AgentScope;
+    /** Optional for backward compatibility — manifests without this field are function tools. */
+    kind?: 'function';
     schema: AgentToolSchema;
 }
+/** A Gemini built-in tool (e.g. google_search) — no client handler, no parameters. */
+interface BuiltInToolManifest {
+    name: BuiltInToolName;
+    scope: AgentScope;
+    kind: 'built_in';
+    builtIn: BuiltInToolName;
+}
+/** Function-calling tool manifest (stable public contract for downstream callers). */
+type AgentToolManifest = FunctionToolManifest;
+/** Union of function and built-in manifests for mixed tool arrays. */
+type AnyAgentToolManifest = FunctionToolManifest | BuiltInToolManifest;
 
+/**
+ * @deprecated Use buildAuthorizedToolsArray instead — it returns the full Gemini
+ * tools[] array, including built-in tools like google_search. This function only
+ * ever returns function-declaration schemas; built-in manifests are ignored.
+ */
 declare function buildAuthorizedSchemaArray(availableManifests: AgentToolManifest[], userGrantedScopes: string[]): AgentToolSchema[];
+/** One entry of a Gemini `tools[]` array: a function-declarations group, or a built-in tool. */
+type GeminiToolEntry = {
+    functionDeclarations: AgentToolSchema[];
+} | {
+    [K in BuiltInToolName]: Record<string, never>;
+};
+/**
+ * Filters manifests by granted scope (core-scoped manifests always pass) and
+ * returns the full Gemini tools[] array: at most one functionDeclarations
+ * group, plus one entry per authorized built-in tool.
+ */
+declare function buildAuthorizedToolsArray(availableManifests: AnyAgentToolManifest[], userGrantedScopes: string[]): GeminiToolEntry[];
 
 declare const getCurrentTimeManifest: AgentToolManifest;
 declare const escalateToCloudManifest: AgentToolManifest;
+declare const googleSearchManifest: BuiltInToolManifest;
 
-export { type AgentScope, type AgentToolManifest, type AgentToolSchema, buildAuthorizedSchemaArray, escalateToCloudManifest, getCurrentTimeManifest };
+export { type AgentScope, type AgentToolManifest, type AgentToolSchema, type AnyAgentToolManifest, type BuiltInToolManifest, type BuiltInToolName, type FunctionToolManifest, type GeminiToolEntry, buildAuthorizedSchemaArray, buildAuthorizedToolsArray, escalateToCloudManifest, getCurrentTimeManifest, googleSearchManifest };

package/dist/index.js

@@ -4,8 +4,26 @@
 function buildAuthorizedSchemaArray(availableManifests, userGrantedScopes) {
   return availableManifests.filter(
     (manifest) => manifest.scope === "core" || userGrantedScopes.includes(manifest.scope)
+  ).filter(
+    (manifest) => "schema" in manifest
   ).map((manifest) => manifest.schema);
 }
+function buildAuthorizedToolsArray(availableManifests, userGrantedScopes) {
+  const authorized = availableManifests.filter(
+    (manifest) => manifest.scope === "core" || userGrantedScopes.includes(manifest.scope)
+  );
+  const entries = [];
+  const fnSchemas = authorized.filter(
+    (manifest) => manifest.kind !== "built_in"
+  ).map((manifest) => manifest.schema);
+  if (fnSchemas.length > 0) entries.push({ functionDeclarations: fnSchemas });
+  for (const manifest of authorized) {
+    if (manifest.kind === "built_in") {
+      entries.push({ [manifest.builtIn]: {} });
+    }
+  }
+  return entries;
+}
 
 // src/manifests/core.ts
 var getCurrentTimeManifest = {
@@ -26,9 +44,17 @@ var escalateToCloudManifest = {
     parameters: { type: "object", properties: {} }
   }
 };
+var googleSearchManifest = {
+  name: "google_search",
+  scope: "core",
+  kind: "built_in",
+  builtIn: "google_search"
+};
 
 exports.buildAuthorizedSchemaArray = buildAuthorizedSchemaArray;
+exports.buildAuthorizedToolsArray = buildAuthorizedToolsArray;
 exports.escalateToCloudManifest = escalateToCloudManifest;
 exports.getCurrentTimeManifest = getCurrentTimeManifest;
+exports.googleSearchManifest = googleSearchManifest;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/injector.ts","../src/manifests/core.ts"],"names":[],"mappings":";;;AAEO,SAAS,0BAAA,CACd,oBACA,iBAAA,EACmB;AACnB,EAAA,OAAO,kBAAA,CACJ,MAAA;AAAA,IACC,CAAC,aACC,QAAA,CAAS,KAAA,KAAU,UAAU,iBAAA,CAAkB,QAAA,CAAS,SAAS,KAAK;AAAA,GAC1E,CACC,GAAA,CAAI,CAAC,QAAA,KAAa,SAAS,MAAM,CAAA;AACtC;;;ACVO,IAAM,sBAAA,GAA4C;AAAA,EACvD,IAAA,EAAM,kBAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,kBAAA;AAAA,IACN,WAAA,EACE,mIAAA;AAAA,IACF,YAAY,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,EAAC;AAAE;AAEjD;AAEO,IAAM,uBAAA,GAA6C;AAAA,EACxD,IAAA,EAAM,yBAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,yBAAA;AAAA,IACN,WAAA,EACE,qJAAA;AAAA,IACF,YAAY,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,EAAC;AAAE;AAEjD","file":"index.js","sourcesContent":["import type { AgentToolManifest, AgentToolSchema } from './types';\n\nexport function buildAuthorizedSchemaArray(\n  availableManifests: AgentToolManifest[],\n  userGrantedScopes: string[]\n): AgentToolSchema[] {\n  return availableManifests\n    .filter(\n      (manifest) =>\n        manifest.scope === 'core' || userGrantedScopes.includes(manifest.scope)\n    )\n    .map((manifest) => manifest.schema);\n}\n","import type { AgentToolManifest } from '../types';\n\nexport const getCurrentTimeManifest: AgentToolManifest = {\n  name: 'get_current_time',\n  scope: 'core',\n  schema: {\n    name: 'get_current_time',\n    description:\n      'Get the exact current date and time. Always call this tool first if resolving relative temporal words like \"today\" or \"tomorrow\".',\n    parameters: { type: 'object', properties: {} },\n  },\n};\n\nexport const escalateToCloudManifest: AgentToolManifest = {\n  name: 'escalate_to_cloud_agent',\n  scope: 'core',\n  schema: {\n    name: 'escalate_to_cloud_agent',\n    description:\n      'Use this tool when the user asks to schedule a reminder, perform deep memory searches, or execute a complex workflow that requires cloud resources.',\n    parameters: { type: 'object', properties: {} },\n  },\n};\n"]}
+{"version":3,"sources":["../src/injector.ts","../src/manifests/core.ts"],"names":[],"mappings":";;;AAaO,SAAS,0BAAA,CACd,oBACA,iBAAA,EACmB;AACnB,EAAA,OAAO,kBAAA,CACJ,MAAA;AAAA,IACC,CAAC,aACC,QAAA,CAAS,KAAA,KAAU,UAAU,iBAAA,CAAkB,QAAA,CAAS,SAAS,KAAK;AAAA,GAC1E,CACC,MAAA;AAAA,IACC,CAAC,aAA+C,QAAA,IAAY;AAAA,GAC9D,CACC,GAAA,CAAI,CAAC,QAAA,KAAa,SAAS,MAAM,CAAA;AACtC;AAYO,SAAS,yBAAA,CACd,oBACA,iBAAA,EACmB;AACnB,EAAA,MAAM,aAAa,kBAAA,CAAmB,MAAA;AAAA,IACpC,CAAC,aACC,QAAA,CAAS,KAAA,KAAU,UAAU,iBAAA,CAAkB,QAAA,CAAS,SAAS,KAAK;AAAA,GAC1E;AAEA,EAAA,MAAM,UAA6B,EAAC;AAEpC,EAAA,MAAM,YAAY,UAAA,CACf,MAAA;AAAA,IACC,CAAC,QAAA,KAA+C,QAAA,CAAS,IAAA,KAAS;AAAA,GACpE,CACC,GAAA,CAAI,CAAC,QAAA,KAAa,SAAS,MAAM,CAAA;AACpC,EAAA,IAAI,SAAA,CAAU,SAAS,CAAA,EAAG,OAAA,CAAQ,KAAK,EAAE,oBAAA,EAAsB,WAAW,CAAA;AAE1E,EAAA,KAAA,MAAW,YAAY,UAAA,EAAY;AACjC,IAAA,IAAI,QAAA,CAAS,SAAS,UAAA,EAAY;AAChC,MAAA,OAAA,CAAQ,IAAA,CAAK,EAAE,CAAC,QAAA,CAAS,OAAO,GAAG,IAAuB,CAAA;AAAA,IAC5D;AAAA,EACF;AAEA,EAAA,OAAO,OAAA;AACT;;;AC7DO,IAAM,sBAAA,GAA4C;AAAA,EACvD,IAAA,EAAM,kBAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,kBAAA;AAAA,IACN,WAAA,EACE,mIAAA;AAAA,IACF,YAAY,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,EAAC;AAAE;AAEjD;AAEO,IAAM,uBAAA,GAA6C;AAAA,EACxD,IAAA,EAAM,yBAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,yBAAA;AAAA,IACN,WAAA,EACE,qJAAA;AAAA,IACF,YAAY,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,EAAC;AAAE;AAEjD;AAEO,IAAM,oBAAA,GAA4C;AAAA,EACvD,IAAA,EAAM,eAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,IAAA,EAAM,UAAA;AAAA,EACN,OAAA,EAAS;AACX","file":"index.js","sourcesContent":["import type {\n  AgentToolManifest,\n  AgentToolSchema,\n  AnyAgentToolManifest,\n  BuiltInToolName,\n  FunctionToolManifest,\n} from './types';\n\n/**\n * @deprecated Use buildAuthorizedToolsArray instead — it returns the full Gemini\n * tools[] array, including built-in tools like google_search. This function only\n * ever returns function-declaration schemas; built-in manifests are ignored.\n */\nexport function buildAuthorizedSchemaArray(\n  availableManifests: AgentToolManifest[],\n  userGrantedScopes: string[]\n): AgentToolSchema[] {\n  return availableManifests\n    .filter(\n      (manifest) =>\n        manifest.scope === 'core' || userGrantedScopes.includes(manifest.scope)\n    )\n    .filter(\n      (manifest): manifest is FunctionToolManifest => 'schema' in manifest\n    )\n    .map((manifest) => manifest.schema);\n}\n\n/** One entry of a Gemini `tools[]` array: a function-declarations group, or a built-in tool. */\nexport type GeminiToolEntry =\n  | { functionDeclarations: AgentToolSchema[] }\n  | { [K in BuiltInToolName]: Record<string, never> };\n\n/**\n * Filters manifests by granted scope (core-scoped manifests always pass) and\n * returns the full Gemini tools[] array: at most one functionDeclarations\n * group, plus one entry per authorized built-in tool.\n */\nexport function buildAuthorizedToolsArray(\n  availableManifests: AnyAgentToolManifest[],\n  userGrantedScopes: string[]\n): GeminiToolEntry[] {\n  const authorized = availableManifests.filter(\n    (manifest) =>\n      manifest.scope === 'core' || userGrantedScopes.includes(manifest.scope)\n  );\n\n  const entries: GeminiToolEntry[] = [];\n\n  const fnSchemas = authorized\n    .filter(\n      (manifest): manifest is FunctionToolManifest => manifest.kind !== 'built_in'\n    )\n    .map((manifest) => manifest.schema);\n  if (fnSchemas.length > 0) entries.push({ functionDeclarations: fnSchemas });\n\n  for (const manifest of authorized) {\n    if (manifest.kind === 'built_in') {\n      entries.push({ [manifest.builtIn]: {} } as GeminiToolEntry);\n    }\n  }\n\n  return entries;\n}\n","import type { AgentToolManifest, BuiltInToolManifest } from '../types';\n\nexport const getCurrentTimeManifest: AgentToolManifest = {\n  name: 'get_current_time',\n  scope: 'core',\n  schema: {\n    name: 'get_current_time',\n    description:\n      'Get the exact current date and time. Always call this tool first if resolving relative temporal words like \"today\" or \"tomorrow\".',\n    parameters: { type: 'object', properties: {} },\n  },\n};\n\nexport const escalateToCloudManifest: AgentToolManifest = {\n  name: 'escalate_to_cloud_agent',\n  scope: 'core',\n  schema: {\n    name: 'escalate_to_cloud_agent',\n    description:\n      'Use this tool when the user asks to schedule a reminder, perform deep memory searches, or execute a complex workflow that requires cloud resources.',\n    parameters: { type: 'object', properties: {} },\n  },\n};\n\nexport const googleSearchManifest: BuiltInToolManifest = {\n  name: 'google_search',\n  scope: 'core',\n  kind: 'built_in',\n  builtIn: 'google_search',\n};\n"]}

package/dist/index.mjs

@@ -2,8 +2,26 @@
 function buildAuthorizedSchemaArray(availableManifests, userGrantedScopes) {
   return availableManifests.filter(
     (manifest) => manifest.scope === "core" || userGrantedScopes.includes(manifest.scope)
+  ).filter(
+    (manifest) => "schema" in manifest
   ).map((manifest) => manifest.schema);
 }
+function buildAuthorizedToolsArray(availableManifests, userGrantedScopes) {
+  const authorized = availableManifests.filter(
+    (manifest) => manifest.scope === "core" || userGrantedScopes.includes(manifest.scope)
+  );
+  const entries = [];
+  const fnSchemas = authorized.filter(
+    (manifest) => manifest.kind !== "built_in"
+  ).map((manifest) => manifest.schema);
+  if (fnSchemas.length > 0) entries.push({ functionDeclarations: fnSchemas });
+  for (const manifest of authorized) {
+    if (manifest.kind === "built_in") {
+      entries.push({ [manifest.builtIn]: {} });
+    }
+  }
+  return entries;
+}
 
 // src/manifests/core.ts
 var getCurrentTimeManifest = {
@@ -24,7 +42,13 @@ var escalateToCloudManifest = {
     parameters: { type: "object", properties: {} }
   }
 };
+var googleSearchManifest = {
+  name: "google_search",
+  scope: "core",
+  kind: "built_in",
+  builtIn: "google_search"
+};
 
-export { buildAuthorizedSchemaArray, escalateToCloudManifest, getCurrentTimeManifest };
+export { buildAuthorizedSchemaArray, buildAuthorizedToolsArray, escalateToCloudManifest, getCurrentTimeManifest, googleSearchManifest };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/injector.ts","../src/manifests/core.ts"],"names":[],"mappings":";AAEO,SAAS,0BAAA,CACd,oBACA,iBAAA,EACmB;AACnB,EAAA,OAAO,kBAAA,CACJ,MAAA;AAAA,IACC,CAAC,aACC,QAAA,CAAS,KAAA,KAAU,UAAU,iBAAA,CAAkB,QAAA,CAAS,SAAS,KAAK;AAAA,GAC1E,CACC,GAAA,CAAI,CAAC,QAAA,KAAa,SAAS,MAAM,CAAA;AACtC;;;ACVO,IAAM,sBAAA,GAA4C;AAAA,EACvD,IAAA,EAAM,kBAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,kBAAA;AAAA,IACN,WAAA,EACE,mIAAA;AAAA,IACF,YAAY,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,EAAC;AAAE;AAEjD;AAEO,IAAM,uBAAA,GAA6C;AAAA,EACxD,IAAA,EAAM,yBAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,yBAAA;AAAA,IACN,WAAA,EACE,qJAAA;AAAA,IACF,YAAY,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,EAAC;AAAE;AAEjD","file":"index.mjs","sourcesContent":["import type { AgentToolManifest, AgentToolSchema } from './types';\n\nexport function buildAuthorizedSchemaArray(\n  availableManifests: AgentToolManifest[],\n  userGrantedScopes: string[]\n): AgentToolSchema[] {\n  return availableManifests\n    .filter(\n      (manifest) =>\n        manifest.scope === 'core' || userGrantedScopes.includes(manifest.scope)\n    )\n    .map((manifest) => manifest.schema);\n}\n","import type { AgentToolManifest } from '../types';\n\nexport const getCurrentTimeManifest: AgentToolManifest = {\n  name: 'get_current_time',\n  scope: 'core',\n  schema: {\n    name: 'get_current_time',\n    description:\n      'Get the exact current date and time. Always call this tool first if resolving relative temporal words like \"today\" or \"tomorrow\".',\n    parameters: { type: 'object', properties: {} },\n  },\n};\n\nexport const escalateToCloudManifest: AgentToolManifest = {\n  name: 'escalate_to_cloud_agent',\n  scope: 'core',\n  schema: {\n    name: 'escalate_to_cloud_agent',\n    description:\n      'Use this tool when the user asks to schedule a reminder, perform deep memory searches, or execute a complex workflow that requires cloud resources.',\n    parameters: { type: 'object', properties: {} },\n  },\n};\n"]}
+{"version":3,"sources":["../src/injector.ts","../src/manifests/core.ts"],"names":[],"mappings":";AAaO,SAAS,0BAAA,CACd,oBACA,iBAAA,EACmB;AACnB,EAAA,OAAO,kBAAA,CACJ,MAAA;AAAA,IACC,CAAC,aACC,QAAA,CAAS,KAAA,KAAU,UAAU,iBAAA,CAAkB,QAAA,CAAS,SAAS,KAAK;AAAA,GAC1E,CACC,MAAA;AAAA,IACC,CAAC,aAA+C,QAAA,IAAY;AAAA,GAC9D,CACC,GAAA,CAAI,CAAC,QAAA,KAAa,SAAS,MAAM,CAAA;AACtC;AAYO,SAAS,yBAAA,CACd,oBACA,iBAAA,EACmB;AACnB,EAAA,MAAM,aAAa,kBAAA,CAAmB,MAAA;AAAA,IACpC,CAAC,aACC,QAAA,CAAS,KAAA,KAAU,UAAU,iBAAA,CAAkB,QAAA,CAAS,SAAS,KAAK;AAAA,GAC1E;AAEA,EAAA,MAAM,UAA6B,EAAC;AAEpC,EAAA,MAAM,YAAY,UAAA,CACf,MAAA;AAAA,IACC,CAAC,QAAA,KAA+C,QAAA,CAAS,IAAA,KAAS;AAAA,GACpE,CACC,GAAA,CAAI,CAAC,QAAA,KAAa,SAAS,MAAM,CAAA;AACpC,EAAA,IAAI,SAAA,CAAU,SAAS,CAAA,EAAG,OAAA,CAAQ,KAAK,EAAE,oBAAA,EAAsB,WAAW,CAAA;AAE1E,EAAA,KAAA,MAAW,YAAY,UAAA,EAAY;AACjC,IAAA,IAAI,QAAA,CAAS,SAAS,UAAA,EAAY;AAChC,MAAA,OAAA,CAAQ,IAAA,CAAK,EAAE,CAAC,QAAA,CAAS,OAAO,GAAG,IAAuB,CAAA;AAAA,IAC5D;AAAA,EACF;AAEA,EAAA,OAAO,OAAA;AACT;;;AC7DO,IAAM,sBAAA,GAA4C;AAAA,EACvD,IAAA,EAAM,kBAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,kBAAA;AAAA,IACN,WAAA,EACE,mIAAA;AAAA,IACF,YAAY,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,EAAC;AAAE;AAEjD;AAEO,IAAM,uBAAA,GAA6C;AAAA,EACxD,IAAA,EAAM,yBAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,MAAA,EAAQ;AAAA,IACN,IAAA,EAAM,yBAAA;AAAA,IACN,WAAA,EACE,qJAAA;AAAA,IACF,YAAY,EAAE,IAAA,EAAM,QAAA,EAAU,UAAA,EAAY,EAAC;AAAE;AAEjD;AAEO,IAAM,oBAAA,GAA4C;AAAA,EACvD,IAAA,EAAM,eAAA;AAAA,EACN,KAAA,EAAO,MAAA;AAAA,EACP,IAAA,EAAM,UAAA;AAAA,EACN,OAAA,EAAS;AACX","file":"index.mjs","sourcesContent":["import type {\n  AgentToolManifest,\n  AgentToolSchema,\n  AnyAgentToolManifest,\n  BuiltInToolName,\n  FunctionToolManifest,\n} from './types';\n\n/**\n * @deprecated Use buildAuthorizedToolsArray instead — it returns the full Gemini\n * tools[] array, including built-in tools like google_search. This function only\n * ever returns function-declaration schemas; built-in manifests are ignored.\n */\nexport function buildAuthorizedSchemaArray(\n  availableManifests: AgentToolManifest[],\n  userGrantedScopes: string[]\n): AgentToolSchema[] {\n  return availableManifests\n    .filter(\n      (manifest) =>\n        manifest.scope === 'core' || userGrantedScopes.includes(manifest.scope)\n    )\n    .filter(\n      (manifest): manifest is FunctionToolManifest => 'schema' in manifest\n    )\n    .map((manifest) => manifest.schema);\n}\n\n/** One entry of a Gemini `tools[]` array: a function-declarations group, or a built-in tool. */\nexport type GeminiToolEntry =\n  | { functionDeclarations: AgentToolSchema[] }\n  | { [K in BuiltInToolName]: Record<string, never> };\n\n/**\n * Filters manifests by granted scope (core-scoped manifests always pass) and\n * returns the full Gemini tools[] array: at most one functionDeclarations\n * group, plus one entry per authorized built-in tool.\n */\nexport function buildAuthorizedToolsArray(\n  availableManifests: AnyAgentToolManifest[],\n  userGrantedScopes: string[]\n): GeminiToolEntry[] {\n  const authorized = availableManifests.filter(\n    (manifest) =>\n      manifest.scope === 'core' || userGrantedScopes.includes(manifest.scope)\n  );\n\n  const entries: GeminiToolEntry[] = [];\n\n  const fnSchemas = authorized\n    .filter(\n      (manifest): manifest is FunctionToolManifest => manifest.kind !== 'built_in'\n    )\n    .map((manifest) => manifest.schema);\n  if (fnSchemas.length > 0) entries.push({ functionDeclarations: fnSchemas });\n\n  for (const manifest of authorized) {\n    if (manifest.kind === 'built_in') {\n      entries.push({ [manifest.builtIn]: {} } as GeminiToolEntry);\n    }\n  }\n\n  return entries;\n}\n","import type { AgentToolManifest, BuiltInToolManifest } from '../types';\n\nexport const getCurrentTimeManifest: AgentToolManifest = {\n  name: 'get_current_time',\n  scope: 'core',\n  schema: {\n    name: 'get_current_time',\n    description:\n      'Get the exact current date and time. Always call this tool first if resolving relative temporal words like \"today\" or \"tomorrow\".',\n    parameters: { type: 'object', properties: {} },\n  },\n};\n\nexport const escalateToCloudManifest: AgentToolManifest = {\n  name: 'escalate_to_cloud_agent',\n  scope: 'core',\n  schema: {\n    name: 'escalate_to_cloud_agent',\n    description:\n      'Use this tool when the user asks to schedule a reminder, perform deep memory searches, or execute a complex workflow that requires cloud resources.',\n    parameters: { type: 'object', properties: {} },\n  },\n};\n\nexport const googleSearchManifest: BuiltInToolManifest = {\n  name: 'google_search',\n  scope: 'core',\n  kind: 'built_in',\n  builtIn: 'google_search',\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equationalapplications/core-llm-tools",
-  "version": "4.11.0",
+  "version": "4.13.0",
   "description": "Zero-dependency Gemini function-calling schemas and capability-scoped tool injection for edge AI agents. Works in Node.js, browser, and React Native (Hermes).",
   "main": "dist/index.js",
   "module": "dist/index.mjs",