@fayz-ai/sdk 0.8.1 → 0.8.3

package/dist/shop.d.ts

@@ -8,6 +8,22 @@ export interface FayzShopProviderOptions {
     productMetadata?: FayzShopProductMetadataOverlay[];
     fetcher?: typeof fetch;
 }
+/**
+ * The signed-in shopper's access token, when there is one.
+ *
+ * PostgREST decides who you are from the Authorization bearer, and this client
+ * used to send the publishable key unconditionally — so every request arrived
+ * as `anon` even with a customer logged in. auth.uid() was therefore always
+ * null, which is why shop_resolve_customer never linked auth_user_id (0 of 519
+ * customers in the pool) and why the self-read policy on public.addresses could
+ * never match a row.
+ *
+ * A module-level resolver rather than a per-app option on purpose: the wiring
+ * is done once by initStorefrontRuntime, so a storefront cannot forget it and
+ * silently fall back to anonymous. Mirrors setShopTenantResolver in plugin-shop.
+ */
+type AccessTokenResolver = () => string | null | undefined;
+export declare function setShopAccessTokenResolver(resolver: AccessTokenResolver | null): void;
 export interface FayzShopProductMetadataOverlay {
     sku?: string | null;
     slug?: string | null;
@@ -257,6 +273,9 @@ export declare function createFayzShopProvider(options: FayzShopProviderOptions)
         customerEmail: string | null;
         discountCode: string | null;
         notes: string | null;
+        shippingAddress: Record<string, string | undefined> | null;
+        paymentMethodKind: string | null;
+        paidAt: string | null;
         items: {
             id: string;
             orderId: string;
@@ -289,6 +308,9 @@ export declare function createFayzShopProvider(options: FayzShopProviderOptions)
         customerEmail: string | null;
         discountCode: string | null;
         notes: string | null;
+        shippingAddress: Record<string, string | undefined> | null;
+        paymentMethodKind: string | null;
+        paidAt: string | null;
         items: {
             id: string;
             orderId: string;
@@ -321,6 +343,9 @@ export declare function createFayzShopProvider(options: FayzShopProviderOptions)
         customerEmail: string | null;
         discountCode: string | null;
         notes: string | null;
+        shippingAddress: Record<string, string | undefined> | null;
+        paymentMethodKind: string | null;
+        paidAt: string | null;
         items: {
             id: string;
             orderId: string;
@@ -370,6 +395,9 @@ export declare function createFayzShopProvider(options: FayzShopProviderOptions)
         customerEmail: string | null;
         discountCode: string | null;
         notes: string | null;
+        shippingAddress: Record<string, string | undefined> | null;
+        paymentMethodKind: string | null;
+        paidAt: string | null;
         items: {
             id: string;
             orderId: string;
@@ -402,6 +430,9 @@ export declare function createFayzShopProvider(options: FayzShopProviderOptions)
         customerEmail: string | null;
         discountCode: string | null;
         notes: string | null;
+        shippingAddress: Record<string, string | undefined> | null;
+        paymentMethodKind: string | null;
+        paidAt: string | null;
         items: {
             id: string;
             orderId: string;
@@ -427,6 +458,22 @@ export declare function createFayzShopProvider(options: FayzShopProviderOptions)
         notes?: string;
         discountCode?: string;
         shippingTotal?: number;
+        /** Structured delivery address; frozen on the order and saved to the
+         *  customer's address book by the RPC. */
+        shippingAddress?: {
+            postalCode: string;
+            street: string;
+            number?: string;
+            complement?: string;
+            district?: string;
+            city: string;
+            state: string;
+            country?: string;
+            recipient?: string;
+            phone?: string;
+            label?: string;
+        };
+        paymentMethod?: "pix" | "credit_card" | "debit_card" | "boleto" | "cash" | "other";
         items: Array<{
             productId: string;
             quantity: number;
@@ -450,6 +497,9 @@ export declare function createFayzShopProvider(options: FayzShopProviderOptions)
         customerEmail: string | null;
         discountCode: string | null;
         notes: string | null;
+        shippingAddress: Record<string, string | undefined> | null;
+        paymentMethodKind: string | null;
+        paidAt: string | null;
         items: {
             id: string;
             orderId: string;
@@ -506,6 +556,32 @@ export declare function createFayzShopProvider(options: FayzShopProviderOptions)
         createdAt: string;
         updatedAt: string;
     }>;
+    quoteShipping(postalCode: string, subtotal: number): Promise<{
+        zoneId: string;
+        name: string;
+        carrier: string | undefined;
+        rate: number;
+        baseRate: number;
+        freeAbove: number | null;
+        etaMinDays: number | undefined;
+        etaMaxDays: number | undefined;
+        free: boolean;
+    }[]>;
+    listCustomerAddresses(customerId: string): Promise<{
+        id: string;
+        label: string | undefined;
+        recipient: string | undefined;
+        phone: string | undefined;
+        postalCode: string;
+        street: string;
+        number: string | undefined;
+        complement: string | undefined;
+        district: string | undefined;
+        city: string;
+        state: string;
+        country: string | undefined;
+        isDefault: boolean;
+    }[]>;
     createCustomer(input: {
         firstName: string;
         lastName?: string;

package/dist/shop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shop.d.ts","sourceRoot":"","sources":["../src/shop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shop.d.ts","sourceRoot":"","sources":["../src/shop.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC5B,eAAe,CAAC,EAAE,8BAA8B,EAAE,CAAA;IAClD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,KAAK,mBAAmB,GAAG,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AAI1D,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAErF;AAED,MAAM,WAAW,8BAA8B;IAC7C,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAA;AACnE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;AACnE,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,MAAM,GAAG,gBAAgB,GAAG,UAAU,GAAG,oBAAoB,GAAG,QAAQ,CAAA;AAC1H,MAAM,MAAM,yBAAyB,GAAG,aAAa,GAAG,qBAAqB,GAAG,WAAW,CAAA;AAE3F,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,YAAY,CAAA;IACxD,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,eAAe,CAAC,EAAE,uBAAuB,CAAA;IACzC,iBAAiB,CAAC,EAAE,yBAAyB,CAAA;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AA6JD,qBAAa,aAAc,SAAQ,KAAK;IAGpC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,OAAO,YAAA;CAKlC;AAgND,iBAAS,kBAAkB,CAAC,KAAK,EAAE;IACjC,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,eAAe,CAAC,EAAE,uBAAuB,CAAA;IACzC,iBAAiB,CAAC,EAAE,yBAAyB,CAAA;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,2BAOA;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB;2BA0iBtC,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAiBnC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA1DR,MAAM;;cAEF,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAncA,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAYnC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA+CA,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmCjC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAyBA,MAAM,cAAc,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAU1B;QACvB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,KAAK,EAAE,KAAK,CAAC;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KACzH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA0CqB,MAAM,SAAS,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAQrD;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB;kDAC0C;QAC1C,eAAe,CAAC,EAAE;YAChB,UAAU,EAAE,MAAM,CAAA;YAClB,MAAM,EAAE,MAAM,CAAA;YACd,MAAM,CAAC,EAAE,MAAM,CAAA;YACf,UAAU,CAAC,EAAE,MAAM,CAAA;YACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;YACjB,IAAI,EAAE,MAAM,CAAA;YACZ,KAAK,EAAE,MAAM,CAAA;YACb,OAAO,CAAC,EAAE,MAAM,CAAA;YAChB,SAAS,CAAC,EAAE,MAAM,CAAA;YAClB,KAAK,CAAC,EAAE,MAAM,CAAA;YACd,KAAK,CAAC,EAAE,MAAM,CAAA;SACf,CAAA;QACD,aAAa,CAAC,EAAE,KAAK,GAAG,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;QAClF,KAAK,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAC7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA4C6B,4BAA4B;;;;;;;;;;;;;oBASpC,MAAM;;;;;;;;;;;;;2BAIC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;8BAa7B,MAAM,YAAY,MAAM;;;;;;;;;;;sCAuBhB,MAAM;;;;;;;;;;;;;;;0BA4BlB;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;uBAe3F,MAAM,SAAS;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;;;;;;uBAe7H,MAAM;4BAGD,4BAA4B;;;;;;;;;;;;;;;;;oBAWpC,MAAM;;;;;;;;;;;;;;;;;;;;EAc/B"}

package/dist/shop.js

@@ -1,3 +1,3 @@
-export { FayzShopError, createFayzShopProvider } from './chunk-PRCW5CVJ.js';
+export { FayzShopError, createFayzShopProvider, setShopAccessTokenResolver } from './chunk-7ZHG7XTA.js';
 //# sourceMappingURL=shop.js.map
 //# sourceMappingURL=shop.js.map

package/package.json

@@ -3,7 +3,7 @@
   "fayz": {
     "status": "beta"
   },
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "Fayz SDK — API client, app params, runtime broker helpers, and shared types for generated Fayz projects",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -28,6 +28,12 @@
       "import": "./dist/client.js",
       "require": "./dist/client.cjs"
     },
+    "./agent": {
+      "source": "./src/agent.ts",
+      "types": "./dist/agent.d.ts",
+      "import": "./dist/agent.js",
+      "require": "./dist/agent.cjs"
+    },
     "./shop": {
       "source": "./src/shop.ts",
       "types": "./dist/shop.d.ts",

package/src/agent.test.ts

@@ -0,0 +1,114 @@
+import { describe, expect, it, vi } from 'vitest'
+
+import { createFayzAgentClient, FayzAgentError } from './agent'
+
+function jsonResponse(body: unknown, status = 200): Response {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { 'Content-Type': 'application/json' },
+  })
+}
+
+function client(fetcher: typeof fetch) {
+  return createFayzAgentClient({
+    baseUrl: 'http://localhost:5173/api',
+    projectId: 'project-1',
+    publishableKey: 'fayzpk_test',
+    fetcher,
+  })
+}
+
+describe('createFayzAgentClient', () => {
+  it('targets the public broker and presents the publishable key', async () => {
+    const fetcher = vi.fn<typeof fetch>().mockResolvedValue(
+      jsonResponse({ conversationId: 'conv-1', content: 'Hi', toolCalls: [] }),
+    )
+
+    await client(fetcher).chat({ message: 'Hello' })
+
+    const [url, init] = fetcher.mock.calls[0]
+    expect(url).toBe('http://localhost:5173/api/public/projects/project-1/agents/chat')
+    expect((init?.headers as Record<string, string>)['x-fayz-agent-key']).toBe('fayzpk_test')
+    expect(JSON.parse(init?.body as string)).toEqual({ message: 'Hello' })
+  })
+
+  it('forwards the tool catalog and returns the calls the model asked for', async () => {
+    const toolCall = { id: 'call-1', name: 'getTeamMembers', arguments: { role: 'staff' } }
+    const fetcher = vi.fn<typeof fetch>().mockResolvedValue(
+      jsonResponse({ conversationId: 'conv-1', content: '', toolCalls: [toolCall] }),
+    )
+
+    const response = await client(fetcher).chat({
+      message: "Who's on my team?",
+      tools: [
+        {
+          name: 'getTeamMembers',
+          description: 'Lists team members.',
+          parameters: { type: 'object', properties: { role: { type: 'string' } } },
+        },
+      ],
+    })
+
+    expect(response.toolCalls).toEqual([toolCall])
+    expect(JSON.parse(fetcher.mock.calls[0][1]?.body as string).tools).toHaveLength(1)
+  })
+
+  it('sends tool results with the conversation id and no new message', async () => {
+    const fetcher = vi.fn<typeof fetch>().mockResolvedValue(
+      jsonResponse({ conversationId: 'conv-1', content: 'Ana and Bruno.', toolCalls: [] }),
+    )
+
+    const response = await client(fetcher).chat({
+      conversationId: 'conv-1',
+      toolResults: [{ toolCallId: 'call-1', content: '{"total":2}' }],
+    })
+
+    const body = JSON.parse(fetcher.mock.calls[0][1]?.body as string)
+    expect(body).toEqual({
+      conversationId: 'conv-1',
+      toolResults: [{ toolCallId: 'call-1', content: '{"total":2}' }],
+    })
+    expect(response.content).toBe('Ana and Bruno.')
+    expect(response.toolCalls).toEqual([])
+  })
+
+  it('tolerates a response that omits toolCalls', async () => {
+    const fetcher = vi.fn<typeof fetch>().mockResolvedValue(
+      jsonResponse({ conversationId: 'conv-1', content: 'Hi' }),
+    )
+
+    const response = await client(fetcher).chat({ message: 'Hello' })
+
+    expect(response.toolCalls).toEqual([])
+  })
+
+  it('surfaces the broker error message and status', async () => {
+    const fetcher = vi
+      .fn<typeof fetch>()
+      .mockResolvedValue(jsonResponse({ error: 'Invalid agent key' }, 401))
+
+    await expect(client(fetcher).chat({ message: 'Hello' })).rejects.toMatchObject({
+      name: 'FayzAgentError',
+      status: 401,
+      message: 'Invalid agent key',
+    })
+  })
+
+  it('falls back to a generic message when the error body is not JSON', async () => {
+    const fetcher = vi
+      .fn<typeof fetch>()
+      .mockResolvedValue(new Response('gateway down', { status: 502 }))
+
+    await expect(client(fetcher).getInfo()).rejects.toThrow(FayzAgentError)
+  })
+
+  it('reads the agent identity from /config', async () => {
+    const agent = { id: 'a-1', name: 'Glow', description: null, icon: '💇' }
+    const fetcher = vi.fn<typeof fetch>().mockResolvedValue(jsonResponse({ agent }))
+
+    expect(await client(fetcher).getInfo()).toEqual(agent)
+    expect(fetcher.mock.calls[0][0]).toBe(
+      'http://localhost:5173/api/public/projects/project-1/agents/config',
+    )
+  })
+})

package/src/agent.ts

@@ -0,0 +1,188 @@
+/**
+ * Client for the Fayz agent broker — the runtime surface a generated app uses
+ * to reach the AI agent configured for its project in Fayz.
+ *
+ * Mirrors `createFayzShopProvider`: the app holds a publishable key, Fayz holds
+ * the model credentials. The key ships in the bundle the same way a Supabase
+ * anon key does; it only ever resolves to the one agent its web channel belongs
+ * to, and the broker rate-limits per project.
+ *
+ * Tools are client-plane. The app declares what it can do (`tools`), the model
+ * decides what to call, and the app executes the calls against its own session
+ * before handing results back. Fayz never needs the app's data credentials.
+ */
+
+export interface FayzAgentClientOptions {
+  /** Fayz API base, e.g. https://fayz.ai/api */
+  baseUrl: string
+  projectId: string
+  /** Publishable key of the project's WEB agent channel. */
+  publishableKey: string
+  fetcher?: typeof fetch
+}
+
+export interface FayzAgentTool {
+  name: string
+  description: string
+  /** JSON Schema for the tool's arguments. */
+  parameters?: Record<string, unknown>
+}
+
+export interface FayzAgentToolCall {
+  id: string
+  name: string
+  arguments: Record<string, unknown>
+}
+
+export interface FayzAgentToolResult {
+  toolCallId: string
+  content: string
+}
+
+export interface FayzAgentChatInput {
+  /** New end-user message. Omit when replying with tool results. */
+  message?: string
+  conversationId?: string
+  /** Identity of the end user, required by channels with an INTERNAL audience. */
+  externalUserId?: string
+  /** Human label for that user, so the owner's dashboard shows a name. */
+  externalUserName?: string
+  tools?: FayzAgentTool[]
+  toolResults?: FayzAgentToolResult[]
+  /** Decision for a server-parked write (broker PENDING_CONFIRMATION step). */
+  confirmAction?: { id: string; approved: boolean }
+  /** Runtime context the agent should know about (page, locale, tenant). */
+  context?: Record<string, unknown>
+  signal?: AbortSignal
+}
+
+/** A server-plane write the broker parked pending human confirmation. */
+export interface FayzAgentPendingAction {
+  id: string
+  toolName: string
+  title?: string
+  params?: Record<string, unknown>
+}
+
+export interface FayzAgentChatResponse {
+  conversationId: string
+  content: string
+  toolCalls: FayzAgentToolCall[]
+  /** Present when the broker is waiting on a confirmAction for this write. */
+  pendingAction?: FayzAgentPendingAction
+}
+
+export interface FayzAgentInfo {
+  id: string
+  name: string
+  description: string | null
+  icon: string | null
+}
+
+export class FayzAgentError extends Error {
+  constructor(
+    message: string,
+    readonly status: number,
+  ) {
+    super(message)
+    this.name = 'FayzAgentError'
+  }
+}
+
+export interface FayzAgentConversationSummary {
+  id: string
+  title: string | null
+  /** Last activity — the field the list is ordered by. */
+  updatedAt: string
+}
+
+export interface FayzAgentConversationMessage {
+  id: string
+  role: string
+  content: string
+  createdAt: string
+  /** Tool calls this reply made, with their results — so a resumed thread shows
+   *  the same trace and record links it showed live. */
+  toolCalls?: Array<{
+    name: string
+    arguments?: Record<string, unknown>
+    result?: string
+  }>
+}
+
+export interface FayzAgentConversationDetail {
+  id: string
+  title: string | null
+  messages: FayzAgentConversationMessage[]
+}
+
+export interface FayzAgentClient {
+  /** Identity of the agent behind the key, for rendering its name/icon. */
+  getInfo(signal?: AbortSignal): Promise<FayzAgentInfo>
+  chat(input: FayzAgentChatInput): Promise<FayzAgentChatResponse>
+  /** The signed-in user's own threads, most-recently-active first. */
+  listConversations(externalUserId?: string, signal?: AbortSignal): Promise<FayzAgentConversationSummary[]>
+  /** One thread with its transcript — 404s on another user's thread. */
+  getConversation(
+    conversationId: string,
+    externalUserId?: string,
+    signal?: AbortSignal,
+  ): Promise<FayzAgentConversationDetail>
+}
+
+export function createFayzAgentClient(options: FayzAgentClientOptions): FayzAgentClient {
+  const fetcher = options.fetcher ?? globalThis.fetch
+  const base = `${options.baseUrl.replace(/\/+$/, '')}/public/projects/${options.projectId}/agents`
+  const headers = {
+    'Content-Type': 'application/json',
+    'x-fayz-agent-key': options.publishableKey,
+  }
+
+  async function request<T>(path: string, init: RequestInit): Promise<T> {
+    const response = await fetcher(`${base}${path}`, { ...init, headers })
+    if (!response.ok) {
+      const body = (await response.json().catch(() => null)) as { error?: string } | null
+      throw new FayzAgentError(body?.error ?? `Agent request failed (${response.status})`, response.status)
+    }
+    return (await response.json()) as T
+  }
+
+  return {
+    async getInfo(signal) {
+      const body = await request<{ agent: FayzAgentInfo }>('/config', { method: 'GET', signal })
+      return body.agent
+    },
+
+    async chat({ signal, ...input }) {
+      const body = await request<Partial<FayzAgentChatResponse>>('/chat', {
+        method: 'POST',
+        body: JSON.stringify(input),
+        signal,
+      })
+      return {
+        conversationId: body.conversationId ?? '',
+        content: body.content ?? '',
+        toolCalls: body.toolCalls ?? [],
+        ...(body.pendingAction ? { pendingAction: body.pendingAction } : {}),
+      }
+    },
+
+    async listConversations(externalUserId, signal) {
+      const query = externalUserId ? `?externalUserId=${encodeURIComponent(externalUserId)}` : ''
+      const body = await request<{ conversations?: FayzAgentConversationSummary[] }>(
+        `/conversations${query}`,
+        { method: 'GET', signal },
+      )
+      return body.conversations ?? []
+    },
+
+    async getConversation(conversationId, externalUserId, signal) {
+      const query = externalUserId ? `?externalUserId=${encodeURIComponent(externalUserId)}` : ''
+      const body = await request<{ conversation: FayzAgentConversationDetail }>(
+        `/conversations/${encodeURIComponent(conversationId)}${query}`,
+        { method: 'GET', signal },
+      )
+      return body.conversation
+    },
+  }
+}

package/src/index.ts

@@ -41,6 +41,17 @@ export {
   createFayzRuntimeClient,
   FayzRuntimeError,
 } from './runtime'
+export { createFayzAgentClient, FayzAgentError } from './agent'
+export type {
+  FayzAgentChatInput,
+  FayzAgentChatResponse,
+  FayzAgentClient,
+  FayzAgentClientOptions,
+  FayzAgentInfo,
+  FayzAgentTool,
+  FayzAgentToolCall,
+  FayzAgentToolResult,
+} from './agent'
 export {
   createFayzShopProvider,
   FayzShopError,

package/src/release-channels.json

@@ -1,20 +1,20 @@
 {
   "channels": {
     "stable": {
-      "@fayz-ai/sdk": "^0.8.0",
-      "@fayz-ai/core": "^0.8.0",
-      "@fayz-ai/auth": "^0.8.0",
-      "@fayz-ai/ui": "^0.8.0",
-      "@fayz-ai/saas": "^0.8.0",
+      "@fayz-ai/sdk": "^0.8.1",
+      "@fayz-ai/core": "^0.8.1",
+      "@fayz-ai/auth": "^0.8.1",
+      "@fayz-ai/ui": "^0.8.1",
+      "@fayz-ai/saas": "^0.8.1",
       "@fayz-ai/shop": "^0.8.0",
       "@fayz-ai/storefront": "^0.8.0",
       "@fayz-ai/portal": "^0.8.0",
       "@fayz-ai/courses": "^0.8.0",
       "@fayz-ai/db": "^0.8.0",
-      "@fayz-ai/plugin-agenda": "^0.8.0",
+      "@fayz-ai/plugin-agenda": "^0.8.1",
       "@fayz-ai/plugin-auth": "^0.8.0",
       "@fayz-ai/plugin-automations": "^0.8.0",
-      "@fayz-ai/plugin-blog": "^0.8.0",
+      "@fayz-ai/plugin-blog": "^0.8.1",
       "@fayz-ai/plugin-conversations": "^0.8.0",
       "@fayz-ai/plugin-courses": "^0.8.0",
       "@fayz-ai/plugin-crm": "^0.8.0",
@@ -22,7 +22,7 @@
       "@fayz-ai/plugin-financial": "^0.8.0",
       "@fayz-ai/plugin-forms": "^0.8.0",
       "@fayz-ai/plugin-inventory": "^0.8.0",
-      "@fayz-ai/plugin-marketing": "^0.8.0",
+      "@fayz-ai/plugin-marketing": "^0.8.1",
       "@fayz-ai/plugin-menu": "^0.8.0",
       "@fayz-ai/plugin-orders": "^0.8.0",
       "@fayz-ai/plugin-payments": "^0.8.0",
@@ -34,20 +34,20 @@
       "@fayz-ai/plugin-tasks": "^0.8.0"
     },
     "latest": {
-      "@fayz-ai/sdk": "^0.8.0",
-      "@fayz-ai/core": "^0.8.0",
-      "@fayz-ai/auth": "^0.8.0",
-      "@fayz-ai/ui": "^0.8.0",
-      "@fayz-ai/saas": "^0.8.0",
+      "@fayz-ai/sdk": "^0.8.1",
+      "@fayz-ai/core": "^0.8.1",
+      "@fayz-ai/auth": "^0.8.1",
+      "@fayz-ai/ui": "^0.8.1",
+      "@fayz-ai/saas": "^0.8.1",
       "@fayz-ai/shop": "^0.8.0",
       "@fayz-ai/storefront": "^0.8.0",
       "@fayz-ai/portal": "^0.8.0",
       "@fayz-ai/courses": "^0.8.0",
       "@fayz-ai/db": "^0.8.0",
-      "@fayz-ai/plugin-agenda": "^0.8.0",
+      "@fayz-ai/plugin-agenda": "^0.8.1",
       "@fayz-ai/plugin-auth": "^0.8.0",
       "@fayz-ai/plugin-automations": "^0.8.0",
-      "@fayz-ai/plugin-blog": "^0.8.0",
+      "@fayz-ai/plugin-blog": "^0.8.1",
       "@fayz-ai/plugin-conversations": "^0.8.0",
       "@fayz-ai/plugin-courses": "^0.8.0",
       "@fayz-ai/plugin-crm": "^0.8.0",
@@ -55,7 +55,7 @@
       "@fayz-ai/plugin-financial": "^0.8.0",
       "@fayz-ai/plugin-forms": "^0.8.0",
       "@fayz-ai/plugin-inventory": "^0.8.0",
-      "@fayz-ai/plugin-marketing": "^0.8.0",
+      "@fayz-ai/plugin-marketing": "^0.8.1",
       "@fayz-ai/plugin-menu": "^0.8.0",
       "@fayz-ai/plugin-orders": "^0.8.0",
       "@fayz-ai/plugin-payments": "^0.8.0",
@@ -67,20 +67,20 @@
       "@fayz-ai/plugin-tasks": "^0.8.0"
     },
     "preview": {
-      "@fayz-ai/sdk": "^0.8.0",
-      "@fayz-ai/core": "^0.8.0",
-      "@fayz-ai/auth": "^0.8.0",
-      "@fayz-ai/ui": "^0.8.0",
-      "@fayz-ai/saas": "^0.8.0",
+      "@fayz-ai/sdk": "^0.8.1",
+      "@fayz-ai/core": "^0.8.1",
+      "@fayz-ai/auth": "^0.8.1",
+      "@fayz-ai/ui": "^0.8.1",
+      "@fayz-ai/saas": "^0.8.1",
       "@fayz-ai/shop": "^0.8.0",
       "@fayz-ai/storefront": "^0.8.0",
       "@fayz-ai/portal": "^0.8.0",
       "@fayz-ai/courses": "^0.8.0",
       "@fayz-ai/db": "^0.8.0",
-      "@fayz-ai/plugin-agenda": "^0.8.0",
+      "@fayz-ai/plugin-agenda": "^0.8.1",
       "@fayz-ai/plugin-auth": "^0.8.0",
       "@fayz-ai/plugin-automations": "^0.8.0",
-      "@fayz-ai/plugin-blog": "^0.8.0",
+      "@fayz-ai/plugin-blog": "^0.8.1",
       "@fayz-ai/plugin-conversations": "^0.8.0",
       "@fayz-ai/plugin-courses": "^0.8.0",
       "@fayz-ai/plugin-crm": "^0.8.0",
@@ -88,7 +88,7 @@
       "@fayz-ai/plugin-financial": "^0.8.0",
       "@fayz-ai/plugin-forms": "^0.8.0",
       "@fayz-ai/plugin-inventory": "^0.8.0",
-      "@fayz-ai/plugin-marketing": "^0.8.0",
+      "@fayz-ai/plugin-marketing": "^0.8.1",
       "@fayz-ai/plugin-menu": "^0.8.0",
       "@fayz-ai/plugin-orders": "^0.8.0",
       "@fayz-ai/plugin-payments": "^0.8.0",