@blocksdiy/blocks-client-sdk 1.7.0 → 1.8.0

package/dist/Action.d.ts

@@ -58,22 +58,9 @@ export declare class Action<AC extends ActionConfig = ActionConfig> {
      * @returns {Promise<AC["outputInstanceType"]>} The action result
      * @example
      * ```ts
-     * // Example 1: Data processing action
-     * const processOrderConfig = {
-     *   actionBlockId: 'process-order-id',
-     *   inputInstanceType: {} as {
-     *     orderId: string;
-     *     userId: string;
-     *     items: Array<{ productId: string; quantity: number }>;
-     *   },
-     *   outputInstanceType: {} as {
-     *     success: boolean;
-     *     orderNumber: string;
-     *     estimatedDelivery: string;
-     *   }
-     * };
+     * import { ProcessOrderAction } from '@/product-types';
      *
-     * const orderAction = new Action(processOrderConfig);
+     * const orderAction = new Action(ProcessOrderAction);
      * const result = await orderAction.execute({
      *   orderId: 'order-123',
      *   userId: 'user-456',
@@ -83,22 +70,9 @@ export declare class Action<AC extends ActionConfig = ActionConfig> {
      * console.log(`Order processed: ${result.orderNumber}`);
      *
      * // Example 2: Integration with external service
-     * const sendEmailConfig = {
-     *   actionBlockId: 'send-email-id',
-     *   inputInstanceType: {} as {
-     *     to: string;
-     *     subject: string;
-     *     body: string;
-     *     attachments?: Array<{ name: string; url: string }>;
-     *   },
-     *   outputInstanceType: {} as {
-     *     sent: boolean;
-     *     messageId?: string;
-     *     error?: string;
-     *   }
-     * };
+     * import { SendEmailAction } from '@/product-types';
      *
-     * const emailAction = new Action(sendEmailConfig);
+     * const emailAction = new Action(SendEmailAction);
      * const emailResult = await emailAction.execute({
      *   to: 'user@example.com',
      *   subject: 'Welcome to our platform',
@@ -106,20 +80,9 @@ export declare class Action<AC extends ActionConfig = ActionConfig> {
      * });
      *
      * // Example 3: Action with streaming response
-     * const generateReportConfig = {
-     *   actionBlockId: 'generate-report-id',
-     *   inputInstanceType: {} as {
-     *     type: 'sales' | 'inventory';
-     *     period: 'daily' | 'weekly' | 'monthly';
-     *     filters: Record<string, any>;
-     *   },
-     *   outputInstanceType: {} as {
-     *     reportUrl: string;
-     *     summary: string;
-     *   }
-     * };
+     * import { GenerateReportAction } from '@/product-types';
      *
-     * const reportAction = new Action(generateReportConfig);
+     * const reportAction = new Action(GenerateReportAction);
      * const reportResult = await reportAction.execute(
      *   {
      *     type: 'sales',

package/dist/Action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../src/Action.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE;IAC5G,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,EAAE,CAAC;IACtB,kBAAkB,EAAE,EAAE,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,qBAAa,MAAM,CAAC,EAAE,SAAS,YAAY,GAAG,YAAY;IACxD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAyB;IACzC,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB;;;OAGG;gBAED,MAAM,EAAE,EAAE,EACV,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAUhG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwFG;IACG,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,EAAE,GAAE;QAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAA;KAAO;CAuBnG"}
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../src/Action.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE;IAC5G,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,EAAE,CAAC;IACtB,kBAAkB,EAAE,EAAE,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,qBAAa,MAAM,CAAC,EAAE,SAAS,YAAY,GAAG,YAAY;IACxD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAyB;IACzC,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB;;;OAGG;gBAED,MAAM,EAAE,EAAE,EACV,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAUhG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACG,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,EAAE,GAAE;QAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAA;KAAO;CAuBnG"}

package/dist/Action.js

@@ -40,22 +40,9 @@ export class Action {
      * @returns {Promise<AC["outputInstanceType"]>} The action result
      * @example
      * ```ts
-     * // Example 1: Data processing action
-     * const processOrderConfig = {
-     *   actionBlockId: 'process-order-id',
-     *   inputInstanceType: {} as {
-     *     orderId: string;
-     *     userId: string;
-     *     items: Array<{ productId: string; quantity: number }>;
-     *   },
-     *   outputInstanceType: {} as {
-     *     success: boolean;
-     *     orderNumber: string;
-     *     estimatedDelivery: string;
-     *   }
-     * };
+     * import { ProcessOrderAction } from '@/product-types';
      *
-     * const orderAction = new Action(processOrderConfig);
+     * const orderAction = new Action(ProcessOrderAction);
      * const result = await orderAction.execute({
      *   orderId: 'order-123',
      *   userId: 'user-456',
@@ -65,22 +52,9 @@ export class Action {
      * console.log(`Order processed: ${result.orderNumber}`);
      *
      * // Example 2: Integration with external service
-     * const sendEmailConfig = {
-     *   actionBlockId: 'send-email-id',
-     *   inputInstanceType: {} as {
-     *     to: string;
-     *     subject: string;
-     *     body: string;
-     *     attachments?: Array<{ name: string; url: string }>;
-     *   },
-     *   outputInstanceType: {} as {
-     *     sent: boolean;
-     *     messageId?: string;
-     *     error?: string;
-     *   }
-     * };
+     * import { SendEmailAction } from '@/product-types';
      *
-     * const emailAction = new Action(sendEmailConfig);
+     * const emailAction = new Action(SendEmailAction);
      * const emailResult = await emailAction.execute({
      *   to: 'user@example.com',
      *   subject: 'Welcome to our platform',
@@ -88,20 +62,9 @@ export class Action {
      * });
      *
      * // Example 3: Action with streaming response
-     * const generateReportConfig = {
-     *   actionBlockId: 'generate-report-id',
-     *   inputInstanceType: {} as {
-     *     type: 'sales' | 'inventory';
-     *     period: 'daily' | 'weekly' | 'monthly';
-     *     filters: Record<string, any>;
-     *   },
-     *   outputInstanceType: {} as {
-     *     reportUrl: string;
-     *     summary: string;
-     *   }
-     * };
+     * import { GenerateReportAction } from '@/product-types';
      *
-     * const reportAction = new Action(generateReportConfig);
+     * const reportAction = new Action(GenerateReportAction);
      * const reportResult = await reportAction.execute(
      *   {
      *     type: 'sales',

package/dist/Agent.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Configuration for defining an agent.
+ *
+ * This interface is used to define the structure of an app agent generated from product-types.
+ */
+export interface AgentConfig {
+    id: string;
+    name?: string;
+    title?: string;
+    harness?: string;
+    photoUrl?: string;
+    avatarUrl?: string;
+}
+/**
+ * Agent class for referencing an app agent.
+ *
+ * This class provides typed access to an agent's generated metadata.
+ */
+export declare class Agent<AC extends AgentConfig = AgentConfig> {
+    private id;
+    private name?;
+    private title?;
+    private harness?;
+    private photoUrl?;
+    private avatarUrl?;
+    private appId;
+    private token?;
+    constructor(config: AC, { appId, token }: {
+        appId: string;
+        token?: string;
+    });
+    getAgentProps(): {
+        id: string;
+        name: string | undefined;
+        title: string | undefined;
+        harness: string | undefined;
+        photoUrl: string | undefined;
+        avatarUrl: string | undefined;
+        appId: string;
+        token: string | undefined;
+    };
+}
+//# sourceMappingURL=Agent.d.ts.map

package/dist/Agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../src/Agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,KAAK,CAAC,EAAE,SAAS,WAAW,GAAG,WAAW;IACrD,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAW3E,aAAa;;;;;;;;;;CAYd"}

package/dist/Agent.js

@@ -0,0 +1,37 @@
+/**
+ * Agent class for referencing an app agent.
+ *
+ * This class provides typed access to an agent's generated metadata.
+ */
+export class Agent {
+    id;
+    name;
+    title;
+    harness;
+    photoUrl;
+    avatarUrl;
+    appId;
+    token;
+    constructor(config, { appId, token }) {
+        this.id = config.id;
+        this.name = config.name;
+        this.title = config.title;
+        this.harness = config.harness;
+        this.photoUrl = config.photoUrl;
+        this.avatarUrl = config.avatarUrl;
+        this.appId = appId;
+        this.token = token;
+    }
+    getAgentProps() {
+        return {
+            id: this.id,
+            name: this.name,
+            title: this.title,
+            harness: this.harness,
+            photoUrl: this.photoUrl,
+            avatarUrl: this.avatarUrl,
+            appId: this.appId,
+            token: this.token,
+        };
+    }
+}

package/dist/ClientSdk.d.ts

@@ -1,4 +1,5 @@
 import { Action, type ActionConfig } from "./Action.js";
+import { Agent, type AgentConfig } from "./Agent.js";
 import { AgentChat, AgentChatConfig } from "./AgentChat.js";
 import { Entity, type EntityConfig } from "./Entity.js";
 import { Page, type PageConfig } from "./Page.js";
@@ -46,6 +47,7 @@ export interface ClientConfig {
  * - Entities: Data objects stored in tables (CRUD operations)
  * - Actions: Executable workflows that perform operations (any server-side logic)
  * - Pages: Application pages with URL and parameter handling
+ * - Agents: App agents generated from product-types
  * - AgentChat: Interact with the agent chat
  * - User: The user's data
  *
@@ -58,6 +60,7 @@ export declare class ClientSdk {
     private readonly entities;
     private readonly actions;
     private readonly pages;
+    private readonly agentsMap;
     private readonly agentChats;
     /**
      * Creates a new ClientSdk instance
@@ -82,18 +85,9 @@ export declare class ClientSdk {
      * @returns {Entity<EC>} An Entity instance for the given configuration
      * @example
      * ```ts
-     * // Define a User entity configuration
-     * const userEntityConfig = {
-     *   tableBlockId: 'users-table-id',
-     *   instanceType: {} as {
-     *     name: string;
-     *     email: string;
-     *     role: 'admin' | 'user';
-     *   }
-     * };
+     * import { UserEntity } from '@/product-types';
      *
-     * // Get the entity instance
-     * const userEntity = client.entity(userEntityConfig);
+     * const userEntity = client.entity(UserEntity);
      *
      * // Use it for CRUD operations
      * const users = await userEntity.findMany();
@@ -118,47 +112,14 @@ export declare class ClientSdk {
      * @returns {Action<AC>} An Action instance for the given configuration
      * @example
      * ```ts
-     * // Example 1: Data processing action
-     * const processOrderConfig = {
-     *   actionBlockId: 'process-order-id',
-     *   inputInstanceType: {} as {
-     *     orderId: string;
-     *     userId: string;
-     *     items: Array<{ productId: string; quantity: number }>;
-     *   },
-     *   outputInstanceType: {} as {
-     *     success: boolean;
-     *     orderNumber: string;
-     *     estimatedDelivery: string;
-     *   }
-     * };
+     * import { ProcessOrderAction } from '@/product-types';
      *
-     * const processOrderAction = client.action(processOrderConfig);
+     * const processOrderAction = client.action(ProcessOrderAction);
      * const result = await processOrderAction.execute({
      *   orderId: 'order-123',
      *   userId: 'user-456',
      *   items: [{ productId: 'prod-789', quantity: 2 }]
      * });
-     *
-     * // Example 2: Authentication action
-     * const loginUserConfig = {
-     *   actionBlockId: 'login-user-id',
-     *   inputInstanceType: {} as {
-     *     email: string;
-     *     password: string;
-     *   },
-     *   outputInstanceType: {} as {
-     *     success: boolean;
-     *     token?: string;
-     *     error?: string;
-     *   }
-     * };
-     *
-     * const loginAction = client.action(loginUserConfig);
-     * const loginResult = await loginAction.execute({
-     *   email: 'user@example.com',
-     *   password: 'password123'
-     * });
      * ```
      */
     action<AC extends ActionConfig = ActionConfig>(actionConfig: AC): Action<AC>;
@@ -175,17 +136,18 @@ export declare class ClientSdk {
      * @returns {Page<PC>} A Page instance for the given configuration
      * @example
      * ```ts
-     * // Define a product page configuration
-     * const productPageConfig = {
-     *   pageBlockId: 'product-page-id'
-     *   pageName: 'product-page'
-     * };
+     * import { ProductPage } from '@/product-types';
      *
-     * // Get the page instance
-     * const productPage = client.page(productPageConfig);
+     * const productPage = client.page(ProductPage);
      * ```
      */
     page<PC extends PageConfig = PageConfig>(pageConfig: PC): Page<PC>;
+    /**
+     * Gets or creates an Agent instance for the specified agent configuration.
+     *
+     * An Agent represents an app agent generated from product-types.
+     */
+    agent<AC extends AgentConfig = AgentConfig>(agentConfig: AC): Agent<AC>;
     /**
      * Gets or creates an AgentChat instance for the specified agent chat configuration
      *
@@ -198,13 +160,9 @@ export declare class ClientSdk {
      * @returns {AgentChat<ACC>} An AgentChat instance for the given configuration
      * @example
      * ```ts
-     * // Define a agent chat configuration
-     * const agentChatConfig = {
-     *   agentChatId: 'agent-chat-id'
-     * };
+     * import { CustomerSupportChatAgent } from '@/product-types';
      *
-     * // Get the agent chat instance
-     * const agentChat = client.agentChat(agentChatConfig);
+     * const agentChat = client.agentChat(CustomerSupportChatAgent);
      * ```
      */
     agentChat<ACC extends AgentChatConfig = AgentChatConfig>(agentChatConfig: ACC): AgentChat<ACC>;

package/dist/ClientSdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClientSdk.d.ts","sourceRoot":"","sources":["../src/ClientSdk.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,IAAI,CAAoC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IAEpD;;;;;;;OAOG;gBACS,MAAM,EAAE,YAAY;IAS1B,YAAY;IAiBlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CAAC,EAAE,SAAS,YAAY,GAAG,YAAY,EAAE,YAAY,EAAE,EAAE,GAKN,MAAM,CAAC,EAAE,CAAC;IAGnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4DG;IACH,MAAM,CAAC,EAAE,SAAS,YAAY,GAAG,YAAY,EAAE,YAAY,EAAE,EAAE,GAQ7B,MAAM,CAAC,EAAE,CAAC;IAG5C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,CAAC,EAAE,SAAS,UAAU,GAAG,UAAU,EAAE,UAAU,EAAE,EAAE,GAKJ,IAAI,CAAC,EAAE,CAAC;IAG3D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,GAAG,SAAS,eAAe,GAAG,eAAe,EAAE,eAAe,EAAE,GAAG,GAQhB,SAAS,CAAC,GAAG,CAAC;YAG7D,YAAY;IAiCpB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE;QAAE,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCvG;;;;;;;;;;;;;OAaG;IACH,OAAO;IAIP;;;;;;;;;;OAUG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB;IAoBlF;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAmBhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,iBAAiB;CAGlB"}
+{"version":3,"file":"ClientSdk.d.ts","sourceRoot":"","sources":["../src/ClientSdk.ts"],"names":[],"mappings":"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"}

package/dist/ClientSdk.js

@@ -1,6 +1,7 @@
 import { AppVersionService } from "@blocksdiy/blocks-client-api/appVersionService";
 import { getGoogleBaseUrl, getHost } from "@blocksdiy/blocks-client-api/envService";
 import { Action } from "./Action.js";
+import { Agent } from "./Agent.js";
 import { AgentChat } from "./AgentChat.js";
 import { Entity } from "./Entity.js";
 import { Page } from "./Page.js";
@@ -11,6 +12,7 @@ import { Page } from "./Page.js";
  * - Entities: Data objects stored in tables (CRUD operations)
  * - Actions: Executable workflows that perform operations (any server-side logic)
  * - Pages: Application pages with URL and parameter handling
+ * - Agents: App agents generated from product-types
  * - AgentChat: Interact with the agent chat
  * - User: The user's data
  *
@@ -23,6 +25,7 @@ export class ClientSdk {
     entities;
     actions;
     pages;
+    agentsMap;
     agentChats;
     /**
      * Creates a new ClientSdk instance
@@ -38,6 +41,7 @@ export class ClientSdk {
         this.entities = new Map();
         this.actions = new Map();
         this.pages = new Map();
+        this.agentsMap = new Map();
         this.agentChats = new Map();
     }
     async authenticate() {
@@ -66,18 +70,9 @@ export class ClientSdk {
      * @returns {Entity<EC>} An Entity instance for the given configuration
      * @example
      * ```ts
-     * // Define a User entity configuration
-     * const userEntityConfig = {
-     *   tableBlockId: 'users-table-id',
-     *   instanceType: {} as {
-     *     name: string;
-     *     email: string;
-     *     role: 'admin' | 'user';
-     *   }
-     * };
+     * import { UserEntity } from '@/product-types';
      *
-     * // Get the entity instance
-     * const userEntity = client.entity(userEntityConfig);
+     * const userEntity = client.entity(UserEntity);
      *
      * // Use it for CRUD operations
      * const users = await userEntity.findMany();
@@ -107,47 +102,14 @@ export class ClientSdk {
      * @returns {Action<AC>} An Action instance for the given configuration
      * @example
      * ```ts
-     * // Example 1: Data processing action
-     * const processOrderConfig = {
-     *   actionBlockId: 'process-order-id',
-     *   inputInstanceType: {} as {
-     *     orderId: string;
-     *     userId: string;
-     *     items: Array<{ productId: string; quantity: number }>;
-     *   },
-     *   outputInstanceType: {} as {
-     *     success: boolean;
-     *     orderNumber: string;
-     *     estimatedDelivery: string;
-     *   }
-     * };
+     * import { ProcessOrderAction } from '@/product-types';
      *
-     * const processOrderAction = client.action(processOrderConfig);
+     * const processOrderAction = client.action(ProcessOrderAction);
      * const result = await processOrderAction.execute({
      *   orderId: 'order-123',
      *   userId: 'user-456',
      *   items: [{ productId: 'prod-789', quantity: 2 }]
      * });
-     *
-     * // Example 2: Authentication action
-     * const loginUserConfig = {
-     *   actionBlockId: 'login-user-id',
-     *   inputInstanceType: {} as {
-     *     email: string;
-     *     password: string;
-     *   },
-     *   outputInstanceType: {} as {
-     *     success: boolean;
-     *     token?: string;
-     *     error?: string;
-     *   }
-     * };
-     *
-     * const loginAction = client.action(loginUserConfig);
-     * const loginResult = await loginAction.execute({
-     *   email: 'user@example.com',
-     *   password: 'password123'
-     * });
      * ```
      */
     action(actionConfig) {
@@ -172,14 +134,9 @@ export class ClientSdk {
      * @returns {Page<PC>} A Page instance for the given configuration
      * @example
      * ```ts
-     * // Define a product page configuration
-     * const productPageConfig = {
-     *   pageBlockId: 'product-page-id'
-     *   pageName: 'product-page'
-     * };
+     * import { ProductPage } from '@/product-types';
      *
-     * // Get the page instance
-     * const productPage = client.page(productPageConfig);
+     * const productPage = client.page(ProductPage);
      * ```
      */
     page(pageConfig) {
@@ -188,6 +145,17 @@ export class ClientSdk {
         }
         return this.pages.get(pageConfig.pageBlockId);
     }
+    /**
+     * Gets or creates an Agent instance for the specified agent configuration.
+     *
+     * An Agent represents an app agent generated from product-types.
+     */
+    agent(agentConfig) {
+        if (!this.agentsMap.has(agentConfig.id)) {
+            this.agentsMap.set(agentConfig.id, new Agent(agentConfig, { appId: this.appId, token: this.token }));
+        }
+        return this.agentsMap.get(agentConfig.id);
+    }
     /**
      * Gets or creates an AgentChat instance for the specified agent chat configuration
      *
@@ -200,13 +168,9 @@ export class ClientSdk {
      * @returns {AgentChat<ACC>} An AgentChat instance for the given configuration
      * @example
      * ```ts
-     * // Define a agent chat configuration
-     * const agentChatConfig = {
-     *   agentChatId: 'agent-chat-id'
-     * };
+     * import { CustomerSupportChatAgent } from '@/product-types';
      *
-     * // Get the agent chat instance
-     * const agentChat = client.agentChat(agentChatConfig);
+     * const agentChat = client.agentChat(CustomerSupportChatAgent);
      * ```
      */
     agentChat(agentChatConfig) {