captify 0.1.18 → 0.1.19

package/dist/agents/services/agent-tools.d.ts

@@ -1,198 +1,241 @@
 import { type ToolName } from "../agents.constants";
+import type { ToolUserContext } from "../agents.interfaces";
+import { tool } from "ai";
 /**
- * Tool Registry
+ * Creates a DynamoDB tool with user context pre-injected
  *
- * Define all available tools here. Each tool needs:
- * - description: What the tool does
- * - inputSchema: Zod schema for inputs
- * - execute: Async function that implements the tool
- *
- * Agents can enable tools by referencing their names in the tools field.
- */
-/**
- * Calculator tool - performs basic arithmetic operations
+ * The tool provides schema-aware read access to application tables.
+ * User's tenantId and userId are automatically used from their session.
  */
-export declare const calculator: import("ai").Tool<{
-    operation: "add" | "subtract" | "multiply" | "divide";
-    a: number;
-    b: number;
+export declare function createDynamoDbTool(context: ToolUserContext): import("ai").Tool<{
+    operation: "getMySessions" | "getSessionMessages" | "getAgents" | "getAgent" | "getProviders" | "getMyBookmarks" | "getFeedbacks";
+    sessionId?: string | undefined;
+    agentId?: string | undefined;
+    status?: "active" | "archived" | undefined;
+    limit?: number | undefined;
 }, {
-    result: number;
-}>;
-/**
- * Get current time tool
- */
-export declare const getCurrentTime: import("ai").Tool<Record<string, never>, {
-    timestamp: string;
-    timezone: string;
-    unixTime: number;
-}>;
-/**
- * String manipulation tool
- */
-export declare const stringManipulator: import("ai").Tool<{
-    text: string;
-    operation: "length" | "reverse" | "lowercase" | "uppercase" | "word_count";
-}, {
-    result: string;
+    operation: string;
+    sessions: any[];
+    count: number;
+    hasMore: boolean;
+    error?: undefined;
+    message?: undefined;
+    shouldRetry?: undefined;
+    messages?: undefined;
+    agents?: undefined;
+    agent?: undefined;
+    found?: undefined;
+    providers?: undefined;
+    bookmarks?: undefined;
+    feedbacks?: undefined;
+    hint?: undefined;
 } | {
-    result: number;
-}>;
-/**
- * Random number generator tool
- */
-export declare const randomNumber: import("ai").Tool<{
-    min: number;
-    max: number;
+    operation: string;
+    error: boolean;
+    message: string;
+    shouldRetry: boolean;
+    sessions?: undefined;
+    count?: undefined;
+    hasMore?: undefined;
+    messages?: undefined;
+    agents?: undefined;
+    agent?: undefined;
+    found?: undefined;
+    providers?: undefined;
+    bookmarks?: undefined;
+    feedbacks?: undefined;
+    hint?: undefined;
+} | {
+    operation: string;
+    messages: any[];
     count: number;
-}, {
-    numbers: number[];
+    hasMore: boolean;
+    sessions?: undefined;
+    error?: undefined;
+    message?: undefined;
+    shouldRetry?: undefined;
+    agents?: undefined;
+    agent?: undefined;
+    found?: undefined;
+    providers?: undefined;
+    bookmarks?: undefined;
+    feedbacks?: undefined;
+    hint?: undefined;
+} | {
+    operation: string;
+    agents: any[];
     count: number;
-    min: number;
-    max: number;
-}>;
-/**
- * JSON validator tool
- */
-export declare const jsonValidator: import("ai").Tool<{
-    jsonString: string;
-}, {
-    valid: boolean;
-    parsed: any;
-    type: string;
+    hasMore: boolean;
+    sessions?: undefined;
     error?: undefined;
+    message?: undefined;
+    shouldRetry?: undefined;
+    messages?: undefined;
+    agent?: undefined;
+    found?: undefined;
+    providers?: undefined;
+    bookmarks?: undefined;
+    feedbacks?: undefined;
+    hint?: undefined;
 } | {
-    valid: boolean;
-    error: string;
-    parsed?: undefined;
-    type?: undefined;
-}>;
-/**
- * URL parser tool
- */
-export declare const urlParser: import("ai").Tool<{
-    url: string;
-}, {
-    valid: boolean;
-    protocol: string;
-    hostname: string;
-    port: string;
-    pathname: string;
-    search: string;
-    hash: string;
-    queryParams: Record<string, string>;
-    origin: string;
+    operation: string;
+    agent: any;
+    found: boolean;
+    sessions?: undefined;
+    count?: undefined;
+    hasMore?: undefined;
+    error?: undefined;
+    message?: undefined;
+    shouldRetry?: undefined;
+    messages?: undefined;
+    agents?: undefined;
+    providers?: undefined;
+    bookmarks?: undefined;
+    feedbacks?: undefined;
+    hint?: undefined;
+} | {
+    operation: string;
+    providers: any[];
+    count: number;
+    hasMore: boolean;
+    sessions?: undefined;
+    error?: undefined;
+    message?: undefined;
+    shouldRetry?: undefined;
+    messages?: undefined;
+    agents?: undefined;
+    agent?: undefined;
+    found?: undefined;
+    bookmarks?: undefined;
+    feedbacks?: undefined;
+    hint?: undefined;
+} | {
+    operation: string;
+    bookmarks: any[];
+    count: number;
+    hasMore: boolean;
+    sessions?: undefined;
     error?: undefined;
+    message?: undefined;
+    shouldRetry?: undefined;
+    messages?: undefined;
+    agents?: undefined;
+    agent?: undefined;
+    found?: undefined;
+    providers?: undefined;
+    feedbacks?: undefined;
+    hint?: undefined;
 } | {
-    valid: boolean;
-    error: string;
-    protocol?: undefined;
-    hostname?: undefined;
-    port?: undefined;
-    pathname?: undefined;
-    search?: undefined;
-    hash?: undefined;
-    queryParams?: undefined;
-    origin?: undefined;
+    operation: string;
+    feedbacks: any[];
+    count: number;
+    hasMore: boolean;
+    sessions?: undefined;
+    error?: undefined;
+    message?: undefined;
+    shouldRetry?: undefined;
+    messages?: undefined;
+    agents?: undefined;
+    agent?: undefined;
+    found?: undefined;
+    providers?: undefined;
+    bookmarks?: undefined;
+    hint?: undefined;
+} | {
+    operation: "getMySessions" | "getSessionMessages" | "getAgents" | "getAgent" | "getProviders" | "getMyBookmarks" | "getFeedbacks";
+    error: boolean;
+    message: string;
+    shouldRetry: boolean;
+    hint: string;
+    sessions?: undefined;
+    count?: undefined;
+    hasMore?: undefined;
+    messages?: undefined;
+    agents?: undefined;
+    agent?: undefined;
+    found?: undefined;
+    providers?: undefined;
+    bookmarks?: undefined;
+    feedbacks?: undefined;
 }>;
 /**
- * Array operations tool
+ * Creates a Kendra tool with user context pre-injected
+ *
+ * The tool provides document search and retrieval capabilities using Amazon Kendra.
+ * User's credentials are automatically used for governance compliance.
  */
-export declare const arrayOperations: import("ai").Tool<{
-    numbers: number[];
-    operation: "max" | "min" | "sum" | "average" | "sort_asc" | "sort_desc" | "unique";
+export declare function createKendraTool(context: ToolUserContext): import("ai").Tool<{
+    operation: "search" | "retrieve";
+    query: string;
+    indexId?: string | undefined;
+    pageSize?: number | undefined;
+    filters?: {
+        category?: string | undefined;
+        source?: string | undefined;
+        documentType?: string | undefined;
+    } | undefined;
 }, {
-    result: number;
+    operation: string;
+    queryId: string | undefined;
+    documents: {
+        id: string;
+        title: string | undefined;
+        excerpt: string | undefined;
+        uri: string | undefined;
+        confidence: import("@aws-sdk/client-kendra").ScoreConfidence | undefined;
+    }[];
+    totalResults: number | undefined;
+    count: number;
+    passages?: undefined;
+    error?: undefined;
+    message?: undefined;
+    shouldRetry?: undefined;
+    hint?: undefined;
+    query?: undefined;
 } | {
-    result: number[];
+    operation: string;
+    queryId: string | undefined;
+    passages: {
+        documentId: string | undefined;
+        title: string | undefined;
+        uri: string | undefined;
+        content: string | undefined;
+    }[];
+    count: number;
+    documents?: undefined;
+    totalResults?: undefined;
+    error?: undefined;
+    message?: undefined;
+    shouldRetry?: undefined;
+    hint?: undefined;
+    query?: undefined;
+} | {
+    operation: "search" | "retrieve";
+    error: boolean;
+    message: string;
+    shouldRetry: boolean;
+    hint: string;
+    query: string;
+    queryId?: undefined;
+    documents?: undefined;
+    totalResults?: undefined;
+    count?: undefined;
+    passages?: undefined;
 }>;
 /**
- * Tool Registry Map
- * Add new tools here to make them available to agents.
- * NOTE: Tool names must match TOOL_NAMES in constants.ts
+ * Tool definitions for listing available tools (name + description)
  */
-export declare const TOOL_REGISTRY: {
-    readonly calculator: import("ai").Tool<{
-        operation: "add" | "subtract" | "multiply" | "divide";
-        a: number;
-        b: number;
-    }, {
-        result: number;
-    }>;
-    readonly getCurrentTime: import("ai").Tool<Record<string, never>, {
-        timestamp: string;
-        timezone: string;
-        unixTime: number;
-    }>;
-    readonly stringManipulator: import("ai").Tool<{
-        text: string;
-        operation: "length" | "reverse" | "lowercase" | "uppercase" | "word_count";
-    }, {
-        result: string;
-    } | {
-        result: number;
-    }>;
-    readonly randomNumber: import("ai").Tool<{
-        min: number;
-        max: number;
-        count: number;
-    }, {
-        numbers: number[];
-        count: number;
-        min: number;
-        max: number;
-    }>;
-    readonly jsonValidator: import("ai").Tool<{
-        jsonString: string;
-    }, {
-        valid: boolean;
-        parsed: any;
-        type: string;
-        error?: undefined;
-    } | {
-        valid: boolean;
-        error: string;
-        parsed?: undefined;
-        type?: undefined;
-    }>;
-    readonly urlParser: import("ai").Tool<{
-        url: string;
-    }, {
-        valid: boolean;
-        protocol: string;
-        hostname: string;
-        port: string;
-        pathname: string;
-        search: string;
-        hash: string;
-        queryParams: Record<string, string>;
-        origin: string;
-        error?: undefined;
-    } | {
-        valid: boolean;
-        error: string;
-        protocol?: undefined;
-        hostname?: undefined;
-        port?: undefined;
-        pathname?: undefined;
-        search?: undefined;
-        hash?: undefined;
-        queryParams?: undefined;
-        origin?: undefined;
-    }>;
-    readonly arrayOperations: import("ai").Tool<{
-        numbers: number[];
-        operation: "max" | "min" | "sum" | "average" | "sort_asc" | "sort_desc" | "unique";
-    }, {
-        result: number;
-    } | {
-        result: number[];
-    }>;
-};
+export declare const TOOL_DEFINITIONS: Record<ToolName, {
+    description: string;
+}>;
+type AnyTool = ReturnType<typeof tool<any, any>>;
 /**
- * Get tools by their names
+ * Get tools by their names with user context
+ *
  * @param toolNames - Array of tool names to retrieve
+ * @param context - User context for tools
  * @returns Object with selected tools
  */
-export declare function getToolsByNames(toolNames: ToolName[]): Record<string, (typeof TOOL_REGISTRY)[ToolName]>;
+export declare function getToolsByNames(toolNames: ToolName[], context: ToolUserContext): Record<string, AnyTool>;
+export {};
 //# sourceMappingURL=agent-tools.d.ts.map

package/dist/agents/services/agent-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../../lib/agents/services/agent-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;;;;;;;;GASG;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;EA2BrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;EAWzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;EAwB5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;EA2BvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;EAoBxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;EAgCpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;EAgC1B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQhB,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,QAAQ,EAAE,GACpB,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,CAUlD"}
+{"version":3,"file":"agent-tools.d.ts","sourceRoot":"","sources":["../../../lib/agents/services/agent-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAKtE,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAG1B;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsR1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2JxD;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAatE,CAAC;AAEF,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,EAAE,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB"}