@blocksdiy/blocks-client-sdk 1.11.3 → 1.12.1

package/dist/Agent.d.ts

@@ -5,8 +5,13 @@
  */
 export interface AgentConfig {
     id: string;
+    /** @deprecated Internal identifier — not for display. */
     name?: string;
+    /** Persona display name (e.g. "Leo"). */
     title?: string;
+    /** Role title (e.g. "Support Specialist"). */
+    jobTitle?: string;
+    /** @deprecated No longer emitted in generated configs. */
     harness?: string;
     photoUrl?: string;
     avatarUrl?: string;
@@ -14,25 +19,34 @@ export interface AgentConfig {
 /**
  * Agent class for referencing an app agent.
  *
- * This class provides typed access to an agent's generated metadata.
+ * UI-facing identity is exposed as readonly props — destructure directly:
+ * `const { title, jobTitle, avatarUrl, photoUrl } = useAgent(MyAgent);`
  */
 export declare class Agent<AC extends AgentConfig = AgentConfig> {
-    private id;
+    readonly id: string;
+    /** Persona display name (e.g. "Leo"). */
+    readonly title?: string;
+    /** Role title (e.g. "Support Specialist"). */
+    readonly jobTitle?: string;
+    readonly photoUrl?: string;
+    readonly avatarUrl?: string;
     private name?;
-    private title?;
     private harness?;
-    private photoUrl?;
-    private avatarUrl?;
     private appId;
     private token?;
     constructor(config: AC, { appId, token }: {
         appId: string;
         token?: string;
     });
+    /**
+     * @deprecated Destructure the readonly props off the agent instead.
+     * Kept for previously generated app code.
+     */
     getAgentProps(): {
         id: string;
         name: string | undefined;
         title: string | undefined;
+        jobTitle: string | undefined;
         harness: string | undefined;
         photoUrl: string | undefined;
         avatarUrl: string | undefined;

package/dist/Agent.d.ts.map

@@ -1 +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"}
+{"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,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,KAAK,CAAC,EAAE,SAAS,WAAW,GAAG,WAAW;IACrD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,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;IAY3E;;;OAGG;IACH,aAAa;;;;;;;;;;;CAad"}

package/dist/Agent.js

@@ -1,32 +1,42 @@
 /**
  * Agent class for referencing an app agent.
  *
- * This class provides typed access to an agent's generated metadata.
+ * UI-facing identity is exposed as readonly props — destructure directly:
+ * `const { title, jobTitle, avatarUrl, photoUrl } = useAgent(MyAgent);`
  */
 export class Agent {
     id;
-    name;
+    /** Persona display name (e.g. "Leo"). */
     title;
-    harness;
+    /** Role title (e.g. "Support Specialist"). */
+    jobTitle;
     photoUrl;
     avatarUrl;
+    name;
+    harness;
     appId;
     token;
     constructor(config, { appId, token }) {
         this.id = config.id;
         this.name = config.name;
         this.title = config.title;
+        this.jobTitle = config.jobTitle;
         this.harness = config.harness;
         this.photoUrl = config.photoUrl;
         this.avatarUrl = config.avatarUrl;
         this.appId = appId;
         this.token = token;
     }
+    /**
+     * @deprecated Destructure the readonly props off the agent instead.
+     * Kept for previously generated app code.
+     */
     getAgentProps() {
         return {
             id: this.id,
             name: this.name,
             title: this.title,
+            jobTitle: this.jobTitle,
             harness: this.harness,
             photoUrl: this.photoUrl,
             avatarUrl: this.avatarUrl,

package/dist/ReactClientSdk.d.ts

@@ -528,8 +528,9 @@ export declare const useAgentChat: <ACC extends AgentChatConfig = AgentChatConfi
  * Hook to get an Agent instance from a generated agent configuration.
  *
  * Import generated agent configs from `@/product-types`, then pass one to
- * `useAgent()` to read typed agent metadata such as name, title, avatarUrl,
- * photoUrl, and harness.
+ * `useAgent()` and read the agent's UI-facing identity directly off the
+ * returned object: `title` (persona display name, e.g. "Leo"), `jobTitle`
+ * (role title), and `avatarUrl` / `photoUrl` (persona images).
  *
  * @template AC - Agent configuration type
  * @param {AC} agentConfig - Generated agent configuration from product-types
@@ -540,10 +541,9 @@ export declare const useAgentChat: <ACC extends AgentChatConfig = AgentChatConfi
  * import { CustomerSupportAgent } from '@/product-types';
  *
  * function AgentHeader() {
- *   const agent = useAgent(CustomerSupportAgent);
- *   const { name, title, avatarUrl, photoUrl } = agent.getAgentProps();
+ *   const { title, jobTitle, avatarUrl, photoUrl } = useAgent(CustomerSupportAgent);
  *
- *   return <img src={avatarUrl ?? photoUrl} alt={name} />;
+ *   return <img src={avatarUrl ?? photoUrl} alt={title ?? jobTitle} />;
  * }
  * ```
  */

package/dist/ReactClientSdk.jsx

@@ -874,8 +874,9 @@ export const useAgentChat = (agentChatConfig) => {
  * Hook to get an Agent instance from a generated agent configuration.
  *
  * Import generated agent configs from `@/product-types`, then pass one to
- * `useAgent()` to read typed agent metadata such as name, title, avatarUrl,
- * photoUrl, and harness.
+ * `useAgent()` and read the agent's UI-facing identity directly off the
+ * returned object: `title` (persona display name, e.g. "Leo"), `jobTitle`
+ * (role title), and `avatarUrl` / `photoUrl` (persona images).
  *
  * @template AC - Agent configuration type
  * @param {AC} agentConfig - Generated agent configuration from product-types
@@ -886,10 +887,9 @@ export const useAgentChat = (agentChatConfig) => {
  * import { CustomerSupportAgent } from '@/product-types';
  *
  * function AgentHeader() {
- *   const agent = useAgent(CustomerSupportAgent);
- *   const { name, title, avatarUrl, photoUrl } = agent.getAgentProps();
+ *   const { title, jobTitle, avatarUrl, photoUrl } = useAgent(CustomerSupportAgent);
  *
- *   return <img src={avatarUrl ?? photoUrl} alt={name} />;
+ *   return <img src={avatarUrl ?? photoUrl} alt={title ?? jobTitle} />;
  * }
  * ```
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocksdiy/blocks-client-sdk",
-  "version": "1.11.3",
+  "version": "1.12.1",
   "type": "module",
   "description": "Blocks client sdk",
   "keywords": [],
@@ -47,8 +47,8 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.101.0",
-    "@blocksdiy/blocks-client-api": "1.20.0",
-    "@blocksdiy/react-common": "1.35.2"
+    "@blocksdiy/react-common": "1.36.0",
+    "@blocksdiy/blocks-client-api": "1.5.0"
   },
   "devDependencies": {
     "tsc-alias": "^1.8.10",