@agentforge-io/sdk-server 4.14.0 → 4.16.0

package/dist/client.d.ts

@@ -10,6 +10,7 @@ import { SecretsResource } from './resources/secrets';
 import { TeamsResource } from './resources/teams';
 import { TemplatesResource } from './resources/templates';
 import { TenantConfigResource } from './resources/config';
+import { CatalogResource } from './resources/catalog';
 import { BusinessRolesResource } from './resources/business-roles';
 import { ToolsResource } from './resources/tools';
 export interface AgentForgeClientOptions {
@@ -56,6 +57,10 @@ export interface RequestOptions {
      *  caller already hashed/signed this EXACT string and re-serializing the
      *  same object could (in principle) produce a different byte sequence. */
     rawBody?: string;
+    /** Multipart body (file uploads). Sent as-is; the content-type with its
+     *  boundary is set by fetch, so none is added here. Mutually exclusive with
+     *  `rawBody`. */
+    formData?: FormData;
     /** ms before the request aborts. `null` disables the timeout entirely —
      *  used for chat streaming, where a tool-calling turn can legitimately
      *  run long. Defaults to the client's `timeoutMs`. */
@@ -88,6 +93,7 @@ export declare class AgentForgeClient {
     readonly templates: TemplatesResource;
     readonly config: TenantConfigResource;
     readonly businessRoles: BusinessRolesResource;
+    readonly catalog: CatalogResource;
     constructor(opts: AgentForgeClientOptions);
     /**
      * A client that acts inside `tenantId`, a tenant where this App is

package/dist/client.js

@@ -32,6 +32,7 @@ const secrets_1 = require("./resources/secrets");
 const teams_1 = require("./resources/teams");
 const templates_1 = require("./resources/templates");
 const config_1 = require("./resources/config");
+const catalog_1 = require("./resources/catalog");
 const business_roles_1 = require("./resources/business-roles");
 const tools_1 = require("./resources/tools");
 /** Header that selects an installed tenant for an App secret. */
@@ -74,6 +75,7 @@ class AgentForgeClient {
         this.templates = new templates_1.TemplatesResource(this);
         this.config = new config_1.TenantConfigResource(this);
         this.businessRoles = new business_roles_1.BusinessRolesResource(this);
+        this.catalog = new catalog_1.CatalogResource(this);
     }
     /**
      * A client that acts inside `tenantId`, a tenant where this App is
@@ -183,7 +185,7 @@ class AgentForgeClient {
                     ...(this.tenantId ? { [exports.INSTALLED_TENANT_HEADER]: this.tenantId } : {}),
                     ...(opts?.headers ?? {}),
                 },
-                body: opts?.rawBody,
+                body: opts?.formData ?? opts?.rawBody,
                 signal: controller.signal,
             });
         }

package/dist/errors.d.ts

@@ -1,7 +1,11 @@
 export declare class AgentForgeError extends Error {
     readonly status: number;
     readonly body?: string;
-    constructor(status: number, message: string, body?: string);
+    /** Machine-readable error code from the response body (`{ code }`, or the
+     *  legacy `{ error }`), when the platform sent one — e.g. `FILE_EMPTY_FILE`,
+     *  `INVALID_MAPPING`, `CATALOG_NOT_FOUND`. Also set on 404/401/403 errors. */
+    readonly code?: string;
+    constructor(status: number, message: string, body?: string, code?: string);
 }
 export declare class AgentForgeAuthError extends AgentForgeError {
     constructor(status: 401 | 403, message: string, body?: string);

package/dist/errors.js

@@ -4,14 +4,37 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentForgeNetworkError = exports.AgentForgeNotFoundError = exports.AgentForgeAuthError = exports.AgentForgeError = void 0;
 class AgentForgeError extends Error {
-    constructor(status, message, body) {
+    constructor(status, message, body, code) {
         super(message);
         this.name = 'AgentForgeError';
         this.status = status;
         this.body = body;
+        this.code = code ?? parseErrorCode(body);
     }
 }
 exports.AgentForgeError = AgentForgeError;
+const ERROR_CODE = /^[A-Z][A-Z0-9_]+$/;
+function parseErrorCode(body) {
+    if (!body)
+        return undefined;
+    try {
+        const parsed = JSON.parse(body);
+        if (typeof parsed.code === 'string')
+            return parsed.code;
+        // Nest's default body puts the status text in `error` ("Bad Request"):
+        // only a code-shaped value counts.
+        if (typeof parsed.error === 'string' && ERROR_CODE.test(parsed.error))
+            return parsed.error;
+        // Nest wraps `{ code }` payloads one level down in some versions.
+        const msg = parsed.message;
+        if (msg && typeof msg === 'object' && typeof msg.code === 'string')
+            return msg.code;
+    }
+    catch {
+        /* non-JSON body */
+    }
+    return undefined;
+}
 class AgentForgeAuthError extends AgentForgeError {
     constructor(status, message, body) {
         super(status, message, body);

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { AgentForgeClient, INSTALLED_TENANT_HEADER } from './client';
 export type { AgentForgeClientOptions, RequestOptions } from './client';
 export { AgentForgeError, AgentForgeAuthError, AgentForgeNotFoundError, AgentForgeNetworkError, } from './errors';
 export { TOOL_CALLBACK_HEADERS, ToolCallbackSignatureError, signToolCallbackPayload, verifyToolCallbackSignature, } from './webhooks';
-export type { AgentMe, AgentSummary, AppUserConnectorStatus, ApprovalCopyBundle, ChannelContext, ChatStreamChunk, ChatStreamEvent, ChatTokenRecord, ConnectorDefaultsResult, ConnectorDefaultsSource, ConnectorResourceItem, ConnectorStatus, ConnectorToolInfo, ConversationHistory, ConversationStatus, CreateAgentInput, CreateClickupTaskInput, CreateClickupTaskResult, ExternalToolSummary, IssueChatTokenInput, ListAgentsResult, ListConnectorResourcesResult, McpServerConfig, MessageRecord, MessageRole, PublicAppBranding, PublicProfileBlock, PublicProfileTemplate, PublicTeamLanding, CreateTeamInput, UpdateTeamInput, TeamSummary, TeamDetail, TeamTheme, TeamProfileBlock, AppInstallation, TemplateConfigField, TemplateSummary, TemplateDetail, TemplateInstallResult, TenantConfigEntry, AppSelf, AppSelfConnector, AppSelfConnectors, AppSelfConnectorTools, AppSelfConnectorToolsResponse, RegisterToolInput, RegisterToolsInput, BusinessRoleEntry, RegisterToolsResult, ToolCallbackPayload, ToolCallRecord, ToolPermission, ToolPermissionMode, TokenUsage, TenantSecretEntry, UpdateAgentInput, InboxThreadMode, InboxMessageDirection, InboxMessageSource, InboxMessageType, InboxThreadCustomerProfileView, InboxThreadView, InboxMessageView, SupportKpiTotals, SupportKpiResponse, AgentAttentionLogRow, } from './types';
+export type { AgentMe, AgentSummary, AppUserConnectorStatus, ApprovalCopyBundle, ChannelContext, ChatStreamChunk, ChatStreamEvent, ChatTokenRecord, ConnectorDefaultsResult, ConnectorDefaultsSource, ConnectorResourceItem, ConnectorStatus, ConnectorToolInfo, ConversationHistory, ConversationStatus, CreateAgentInput, CreateClickupTaskInput, CreateClickupTaskResult, ExternalToolSummary, IssueChatTokenInput, ListAgentsResult, ListConnectorResourcesResult, McpServerConfig, MessageRecord, MessageRole, PublicAppBranding, PublicProfileBlock, PublicProfileTemplate, PublicTeamLanding, CreateTeamInput, UpdateTeamInput, TeamSummary, TeamDetail, TeamTheme, TeamBusinessHours, TeamWeekday, TeamProfileBlock, AppInstallation, TemplateConfigField, TemplateSummary, TemplateDetail, TemplateInstallResult, TenantConfigEntry, AppSelf, AppSelfConnector, AppSelfConnectors, AppSelfConnectorTools, AppSelfConnectorToolsResponse, RegisterToolInput, RegisterToolsInput, BusinessRoleEntry, Catalog, CatalogCheckoutCta, CatalogCategory, CatalogProduct, CatalogProductPhoto, CatalogProductKind, CatalogProductStatus, CatalogPriceKind, CatalogAvailability, CatalogLockableField, CatalogProductPage, UpsertCatalogInput, CreateCatalogCategoryInput, UpdateCatalogCategoryInput, CreateCatalogProductInput, UpdateCatalogProductInput, ListCatalogProductsInput, CatalogPhotoUploadTarget, SignCatalogPhotoUploadInput, AttachCatalogPhotoInput, CatalogImportItem, CatalogImportPreview, CatalogImportApplyResult, CatalogFileMapping, CatalogFilePlan, CatalogFilePreview, CatalogFileApplyResult, CatalogFileInput, CatalogFilePreviewInput, CatalogFileApplyInput, CatalogFileErrorCode, CatalogImportSourceStatus, CatalogImportColumnMapping, CatalogImportRunResult, CatalogImportSource, CreateCatalogImportSourceInput, UpdateCatalogImportSourceInput, PreviewCatalogImportSourceInput, CatalogImportSourcePreview, RegisterToolsResult, ToolCallbackPayload, ToolCallRecord, ToolPermission, ToolPermissionMode, TokenUsage, TenantSecretEntry, UpdateAgentInput, InboxThreadMode, InboxMessageDirection, InboxMessageSource, InboxMessageType, InboxThreadCustomerProfileView, InboxThreadView, InboxMessageView, SupportKpiTotals, SupportKpiResponse, AgentAttentionLogRow, } from './types';
 export { AgentsResource } from './resources/agents';
 export { AnalyticsResource } from './resources/analytics';
 export type { GetSupportKpisInput, GetAgentAttentionLogInput, } from './resources/analytics';
@@ -18,6 +18,7 @@ export { TemplatesResource } from './resources/templates';
 export type { ListTemplatesInput } from './resources/templates';
 export { TenantConfigResource } from './resources/config';
 export { BusinessRolesResource } from './resources/business-roles';
+export { CatalogResource, CatalogCategoriesResource, CatalogProductsResource, CatalogPhotosResource, CatalogImportResource, CatalogFileImportResource, CatalogSourcesResource, AgentForgeCatalogImportLimitError, CATALOG_IMPORT_MAX_ITEMS, } from './resources/catalog';
 export type { ListThreadsOptions, SendMessageInput, AssignThreadInput, UnassignThreadInput, SetThreadModeInput, CloseThreadInput, } from './resources/inbox';
 export { ProvisioningResource } from './resources/provisioning';
 export type { ProvisionedTenant, ProvisionedApp, ProvisionedTeam, } from './resources/provisioning';

package/dist/index.js

@@ -28,7 +28,7 @@
 //   const payload = af.tools.verifyCallback({ rawBody, signatureHeader, secretPlaintext });
 //   await af.tools.respondToCallback({ resultUrl: payload.resultUrl, tenantId: payload.tenantId, secret, result });
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolsResource = exports.TeamsResource = exports.SecretsResource = exports.ProvisioningResource = exports.BusinessRolesResource = exports.TenantConfigResource = exports.TemplatesResource = exports.InstallationsResource = exports.InboxResource = exports.ConnectorsResource = exports.ChatResource = exports.AppsResource = exports.AnalyticsResource = exports.AgentsResource = exports.verifyToolCallbackSignature = exports.signToolCallbackPayload = exports.ToolCallbackSignatureError = exports.TOOL_CALLBACK_HEADERS = exports.AgentForgeNetworkError = exports.AgentForgeNotFoundError = exports.AgentForgeAuthError = exports.AgentForgeError = exports.INSTALLED_TENANT_HEADER = exports.AgentForgeClient = void 0;
+exports.ToolsResource = exports.TeamsResource = exports.SecretsResource = exports.ProvisioningResource = exports.CATALOG_IMPORT_MAX_ITEMS = exports.AgentForgeCatalogImportLimitError = exports.CatalogSourcesResource = exports.CatalogFileImportResource = exports.CatalogImportResource = exports.CatalogPhotosResource = exports.CatalogProductsResource = exports.CatalogCategoriesResource = exports.CatalogResource = exports.BusinessRolesResource = exports.TenantConfigResource = exports.TemplatesResource = exports.InstallationsResource = exports.InboxResource = exports.ConnectorsResource = exports.ChatResource = exports.AppsResource = exports.AnalyticsResource = exports.AgentsResource = exports.verifyToolCallbackSignature = exports.signToolCallbackPayload = exports.ToolCallbackSignatureError = exports.TOOL_CALLBACK_HEADERS = exports.AgentForgeNetworkError = exports.AgentForgeNotFoundError = exports.AgentForgeAuthError = exports.AgentForgeError = exports.INSTALLED_TENANT_HEADER = exports.AgentForgeClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "AgentForgeClient", { enumerable: true, get: function () { return client_1.AgentForgeClient; } });
 Object.defineProperty(exports, "INSTALLED_TENANT_HEADER", { enumerable: true, get: function () { return client_1.INSTALLED_TENANT_HEADER; } });
@@ -62,6 +62,16 @@ var config_1 = require("./resources/config");
 Object.defineProperty(exports, "TenantConfigResource", { enumerable: true, get: function () { return config_1.TenantConfigResource; } });
 var business_roles_1 = require("./resources/business-roles");
 Object.defineProperty(exports, "BusinessRolesResource", { enumerable: true, get: function () { return business_roles_1.BusinessRolesResource; } });
+var catalog_1 = require("./resources/catalog");
+Object.defineProperty(exports, "CatalogResource", { enumerable: true, get: function () { return catalog_1.CatalogResource; } });
+Object.defineProperty(exports, "CatalogCategoriesResource", { enumerable: true, get: function () { return catalog_1.CatalogCategoriesResource; } });
+Object.defineProperty(exports, "CatalogProductsResource", { enumerable: true, get: function () { return catalog_1.CatalogProductsResource; } });
+Object.defineProperty(exports, "CatalogPhotosResource", { enumerable: true, get: function () { return catalog_1.CatalogPhotosResource; } });
+Object.defineProperty(exports, "CatalogImportResource", { enumerable: true, get: function () { return catalog_1.CatalogImportResource; } });
+Object.defineProperty(exports, "CatalogFileImportResource", { enumerable: true, get: function () { return catalog_1.CatalogFileImportResource; } });
+Object.defineProperty(exports, "CatalogSourcesResource", { enumerable: true, get: function () { return catalog_1.CatalogSourcesResource; } });
+Object.defineProperty(exports, "AgentForgeCatalogImportLimitError", { enumerable: true, get: function () { return catalog_1.AgentForgeCatalogImportLimitError; } });
+Object.defineProperty(exports, "CATALOG_IMPORT_MAX_ITEMS", { enumerable: true, get: function () { return catalog_1.CATALOG_IMPORT_MAX_ITEMS; } });
 var provisioning_1 = require("./resources/provisioning");
 Object.defineProperty(exports, "ProvisioningResource", { enumerable: true, get: function () { return provisioning_1.ProvisioningResource; } });
 var secrets_1 = require("./resources/secrets");

package/dist/resources/catalog.d.ts

@@ -0,0 +1,120 @@
+import type { AgentForgeClient } from '../client';
+import { AgentForgeError } from '../errors';
+import type { AttachCatalogPhotoInput, Catalog, CatalogCategory, CatalogFileApplyInput, CatalogFileApplyResult, CatalogFilePreview, CatalogFilePreviewInput, CatalogImportApplyResult, CatalogImportItem, CatalogImportPreview, CatalogImportSource, CatalogImportSourcePreview, CatalogImportRunResult, CatalogPhotoUploadTarget, CatalogProduct, CatalogProductPage, CreateCatalogCategoryInput, CreateCatalogImportSourceInput, CreateCatalogProductInput, ListCatalogProductsInput, PreviewCatalogImportSourceInput, SignCatalogPhotoUploadInput, UpdateCatalogCategoryInput, UpdateCatalogImportSourceInput, UpdateCatalogProductInput, UpsertCatalogInput } from '../types';
+/** Max structured items per `import.preview/apply` call (platform cap). */
+export declare const CATALOG_IMPORT_MAX_ITEMS = 200;
+/** Thrown client-side, before any request, when `items` exceeds the cap. */
+export declare class AgentForgeCatalogImportLimitError extends AgentForgeError {
+    readonly count: number;
+    constructor(count: number);
+}
+export declare class CatalogCategoriesResource {
+    private readonly client;
+    constructor(client: AgentForgeClient);
+    /** `GET /categories` — ordered by `sortOrder`. */
+    list(): Promise<CatalogCategory[]>;
+    /** `POST /categories` */
+    create(input: CreateCatalogCategoryInput): Promise<CatalogCategory>;
+    /** `PATCH /categories/:id` */
+    update(categoryId: string, input: UpdateCatalogCategoryInput): Promise<CatalogCategory>;
+    /** `DELETE /categories/:id` */
+    delete(categoryId: string): Promise<void>;
+    /** `PATCH /categories/reorder` — `orderedIds` must be exactly the current set. */
+    reorder(orderedIds: string[]): Promise<CatalogCategory[]>;
+}
+export declare class CatalogPhotosResource {
+    private readonly client;
+    constructor(client: AgentForgeClient);
+    private path;
+    /** `POST …/photos/sign-upload` — signed direct-upload target. PUT the bytes
+     *  to `uploadUrl`, then `attach({ url: publicUrl, key })`. */
+    signUpload(productId: string, input: SignCatalogPhotoUploadInput): Promise<CatalogPhotoUploadTarget>;
+    /** `POST …/photos` — persist an uploaded (or external) photo. The first photo becomes the cover. */
+    attach(productId: string, input: AttachCatalogPhotoInput): Promise<CatalogProduct>;
+    /** `DELETE …/photos` — remove by URL (also deletes the stored object). */
+    remove(productId: string, url: string): Promise<CatalogProduct>;
+    /** `PATCH …/photos/reorder` — send the full ordered URL list; omitted URLs are dropped. */
+    reorder(productId: string, orderedUrls: string[]): Promise<CatalogProduct>;
+    /** `PATCH …/photos/cover` */
+    setCover(productId: string, url: string): Promise<CatalogProduct>;
+}
+export declare class CatalogProductsResource {
+    private readonly client;
+    readonly photos: CatalogPhotosResource;
+    constructor(client: AgentForgeClient);
+    /** `GET /products` — includes drafts/archived (owner view). Paginated. */
+    list(input?: ListCatalogProductsInput): Promise<CatalogProductPage>;
+    /** `GET /products/:id` — 404 → `AgentForgeNotFoundError`. */
+    get(productId: string): Promise<CatalogProduct>;
+    /** `POST /products` — needs a catalog (`catalog.upsert`). `priceCents` is
+     *  required unless `priceKind: 'on_request'` (else `PRICE_REQUIRED`). */
+    create(input: CreateCatalogProductInput): Promise<CatalogProduct>;
+    /** `PATCH /products/:id` */
+    update(productId: string, input: UpdateCatalogProductInput): Promise<CatalogProduct>;
+    /** `DELETE /products/:id` */
+    delete(productId: string): Promise<void>;
+    /** `PATCH /products/reorder` — reorder inside ONE scope: a category, or
+     *  `categoryId: null` for the uncategorized products. `orderedIds` must be exactly that set. */
+    reorder(input: {
+        categoryId: string | null;
+        orderedIds: string[];
+    }): Promise<CatalogProduct[]>;
+}
+export declare class CatalogFileImportResource {
+    private readonly client;
+    constructor(client: AgentForgeClient);
+    private post;
+    /** `POST /import/file/preview` (multipart) — parse an .xlsx/.csv (≤5 MB, ≤2000 rows)
+     *  and get headers, sample rows and a suggested mapping. With `mapping` it also
+     *  returns a `plan`. Errors carry `code` (`FILE_*`, `INVALID_MAPPING`, …). */
+    preview(input: CatalogFilePreviewInput): Promise<CatalogFilePreview>;
+    /** `POST /import/file/apply` (multipart) — import the file using `mapping`
+     *  (field → exact header). Needs a catalog. */
+    apply(input: CatalogFileApplyInput): Promise<CatalogFileApplyResult>;
+}
+export declare class CatalogImportResource {
+    private readonly client;
+    readonly file: CatalogFileImportResource;
+    constructor(client: AgentForgeClient);
+    /** `POST /import/preview` — validate structured items WITHOUT writing. Max 200
+     *  (throws `AgentForgeCatalogImportLimitError` above that, before any request). */
+    preview(items: CatalogImportItem[]): Promise<CatalogImportPreview>;
+    /** `POST /import/apply` — create-only, idempotent per slug. Max 200 per call. */
+    apply(items: CatalogImportItem[]): Promise<CatalogImportApplyResult>;
+    /** `GET /import/template.xlsx` — the downloadable template (xlsx bytes). */
+    template(): Promise<ArrayBuffer>;
+}
+export declare class CatalogSourcesResource {
+    private readonly client;
+    constructor(client: AgentForgeClient);
+    /** `GET /import-sources` */
+    list(): Promise<CatalogImportSource[]>;
+    /** `POST /import-sources` — Google Sheets or Shopify source. */
+    create(input: CreateCatalogImportSourceInput): Promise<CatalogImportSource>;
+    /** `PATCH /import-sources/:id` */
+    update(sourceId: string, input: UpdateCatalogImportSourceInput): Promise<CatalogImportSource>;
+    /** `DELETE /import-sources/:id` */
+    delete(sourceId: string): Promise<void>;
+    /** `POST /import-sources/preview` — sample a Google Sheet (headers, rows,
+     *  suggested mapping) before saving a source. Needs a connected Google grant
+     *  (`NO_GOOGLE_GRANT` otherwise). */
+    preview(input: PreviewCatalogImportSourceInput): Promise<CatalogImportSourcePreview>;
+    /** `POST /import-sources/:id/run` — sync now. Always resolves with `lastResult`;
+     *  run-level failures are in `lastResult.error`. */
+    run(sourceId: string): Promise<{
+        lastResult: CatalogImportRunResult;
+    }>;
+}
+export declare class CatalogResource {
+    private readonly client;
+    readonly categories: CatalogCategoriesResource;
+    readonly products: CatalogProductsResource;
+    readonly import: CatalogImportResource;
+    readonly sources: CatalogSourcesResource;
+    constructor(client: AgentForgeClient);
+    /** `GET /api/v1/catalog` — the tenant's catalog, or `null` when it has none yet
+     *  (404 `CATALOG_NOT_FOUND`). Other 404s still throw. */
+    get(): Promise<Catalog | null>;
+    /** `PUT /api/v1/catalog` — ensure-or-update: creates the catalog if missing, then applies the settings. */
+    upsert(input?: UpsertCatalogInput): Promise<Catalog>;
+}

package/dist/resources/catalog.js

@@ -0,0 +1,263 @@
+"use strict";
+// catalog resource — the tenant's catalog for API-key / App-secret callers
+// (AGF-CATALOG-ONB), `/api/v1/catalog/*`. A host App (PoodleDeck…) manages a
+// business's products, services and categories without hand-rolled fetch.
+//
+//   const biz = af.forTenant(installation.tenantId);
+//   await biz.catalog.upsert({ currency: 'COP' });
+//   await biz.catalog.products.create({ title: 'Café', priceCents: 450000 });
+//
+// The tenant is always the one the client acts in (`forTenant` → `x-af-tenant`,
+// or the `ak_live_` key's own); it is never a parameter. Agent-scoped keys and
+// chat tokens are refused by the platform — this resource always sends the
+// tenant credential (`forceApiKey`).
+//
+// Failures throw the SDK's typed errors; `error.code` carries the platform's
+// machine-readable code (`CATALOG_NOT_FOUND`, `FILE_EMPTY_FILE`,
+// `INVALID_MAPPING`, `TOO_MANY_ITEMS`, …).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CatalogResource = exports.CatalogSourcesResource = exports.CatalogImportResource = exports.CatalogFileImportResource = exports.CatalogProductsResource = exports.CatalogPhotosResource = exports.CatalogCategoriesResource = exports.AgentForgeCatalogImportLimitError = exports.CATALOG_IMPORT_MAX_ITEMS = void 0;
+const errors_1 = require("../errors");
+const BASE = '/api/v1/catalog';
+const TENANT_AUTH = { forceApiKey: true };
+/** Max structured items per `import.preview/apply` call (platform cap). */
+exports.CATALOG_IMPORT_MAX_ITEMS = 200;
+/** Thrown client-side, before any request, when `items` exceeds the cap. */
+class AgentForgeCatalogImportLimitError extends errors_1.AgentForgeError {
+    constructor(count) {
+        super(400, `catalog.import accepts at most ${exports.CATALOG_IMPORT_MAX_ITEMS} items per call (got ${count}). Split into chunks.`, undefined, 'TOO_MANY_ITEMS');
+        this.name = 'AgentForgeCatalogImportLimitError';
+        this.count = count;
+    }
+}
+exports.AgentForgeCatalogImportLimitError = AgentForgeCatalogImportLimitError;
+const seg = encodeURIComponent;
+function guardItems(items) {
+    if (items.length > exports.CATALOG_IMPORT_MAX_ITEMS)
+        throw new AgentForgeCatalogImportLimitError(items.length);
+}
+function toBlob(file) {
+    if (file instanceof Blob)
+        return file;
+    // Copy into a fresh ArrayBuffer-backed view so Blob never sees a SharedArrayBuffer.
+    const bytes = file instanceof Uint8Array ? file : new Uint8Array(file);
+    return new Blob([new Uint8Array(bytes)]);
+}
+function fileForm(input) {
+    const form = new FormData();
+    form.append('file', toBlob(input.file), input.filename);
+    if (input.mapping !== undefined)
+        form.append('mapping', JSON.stringify(input.mapping));
+    if (input.kind !== undefined)
+        form.append('kind', input.kind);
+    if (input.currency !== undefined)
+        form.append('currency', input.currency);
+    return form;
+}
+class CatalogCategoriesResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /** `GET /categories` — ordered by `sortOrder`. */
+    async list() {
+        return this.client.request('GET', `${BASE}/categories`, undefined, TENANT_AUTH);
+    }
+    /** `POST /categories` */
+    async create(input) {
+        return this.client.request('POST', `${BASE}/categories`, input, TENANT_AUTH);
+    }
+    /** `PATCH /categories/:id` */
+    async update(categoryId, input) {
+        return this.client.request('PATCH', `${BASE}/categories/${seg(categoryId)}`, input, TENANT_AUTH);
+    }
+    /** `DELETE /categories/:id` */
+    async delete(categoryId) {
+        await this.client.request('DELETE', `${BASE}/categories/${seg(categoryId)}`, undefined, TENANT_AUTH);
+    }
+    /** `PATCH /categories/reorder` — `orderedIds` must be exactly the current set. */
+    async reorder(orderedIds) {
+        return this.client.request('PATCH', `${BASE}/categories/reorder`, { orderedIds }, TENANT_AUTH);
+    }
+}
+exports.CatalogCategoriesResource = CatalogCategoriesResource;
+class CatalogPhotosResource {
+    constructor(client) {
+        this.client = client;
+    }
+    path(productId, tail = '') {
+        return `${BASE}/products/${seg(productId)}/photos${tail}`;
+    }
+    /** `POST …/photos/sign-upload` — signed direct-upload target. PUT the bytes
+     *  to `uploadUrl`, then `attach({ url: publicUrl, key })`. */
+    async signUpload(productId, input) {
+        return this.client.request('POST', this.path(productId, '/sign-upload'), input, TENANT_AUTH);
+    }
+    /** `POST …/photos` — persist an uploaded (or external) photo. The first photo becomes the cover. */
+    async attach(productId, input) {
+        return this.client.request('POST', this.path(productId), input, TENANT_AUTH);
+    }
+    /** `DELETE …/photos` — remove by URL (also deletes the stored object). */
+    async remove(productId, url) {
+        return this.client.request('DELETE', this.path(productId), { url }, TENANT_AUTH);
+    }
+    /** `PATCH …/photos/reorder` — send the full ordered URL list; omitted URLs are dropped. */
+    async reorder(productId, orderedUrls) {
+        return this.client.request('PATCH', this.path(productId, '/reorder'), { orderedUrls }, TENANT_AUTH);
+    }
+    /** `PATCH …/photos/cover` */
+    async setCover(productId, url) {
+        return this.client.request('PATCH', this.path(productId, '/cover'), { url }, TENANT_AUTH);
+    }
+}
+exports.CatalogPhotosResource = CatalogPhotosResource;
+class CatalogProductsResource {
+    constructor(client) {
+        this.client = client;
+        this.photos = new CatalogPhotosResource(client);
+    }
+    /** `GET /products` — includes drafts/archived (owner view). Paginated. */
+    async list(input = {}) {
+        const qs = new URLSearchParams();
+        if (input.q)
+            qs.set('q', input.q);
+        if (input.categoryId)
+            qs.set('categoryId', input.categoryId);
+        if (input.onlyAvailable)
+            qs.set('onlyAvailable', 'true');
+        if (input.kind)
+            qs.set('kind', input.kind);
+        if (input.page !== undefined)
+            qs.set('page', String(input.page));
+        if (input.pageSize !== undefined)
+            qs.set('pageSize', String(input.pageSize));
+        const q = qs.toString();
+        return this.client.request('GET', `${BASE}/products${q ? `?${q}` : ''}`, undefined, TENANT_AUTH);
+    }
+    /** `GET /products/:id` — 404 → `AgentForgeNotFoundError`. */
+    async get(productId) {
+        return this.client.request('GET', `${BASE}/products/${seg(productId)}`, undefined, TENANT_AUTH);
+    }
+    /** `POST /products` — needs a catalog (`catalog.upsert`). `priceCents` is
+     *  required unless `priceKind: 'on_request'` (else `PRICE_REQUIRED`). */
+    async create(input) {
+        return this.client.request('POST', `${BASE}/products`, input, TENANT_AUTH);
+    }
+    /** `PATCH /products/:id` */
+    async update(productId, input) {
+        return this.client.request('PATCH', `${BASE}/products/${seg(productId)}`, input, TENANT_AUTH);
+    }
+    /** `DELETE /products/:id` */
+    async delete(productId) {
+        await this.client.request('DELETE', `${BASE}/products/${seg(productId)}`, undefined, TENANT_AUTH);
+    }
+    /** `PATCH /products/reorder` — reorder inside ONE scope: a category, or
+     *  `categoryId: null` for the uncategorized products. `orderedIds` must be exactly that set. */
+    async reorder(input) {
+        const qs = `?categoryId=${input.categoryId === null ? 'null' : seg(input.categoryId)}`;
+        return this.client.request('PATCH', `${BASE}/products/reorder${qs}`, { orderedIds: input.orderedIds }, TENANT_AUTH);
+    }
+}
+exports.CatalogProductsResource = CatalogProductsResource;
+class CatalogFileImportResource {
+    constructor(client) {
+        this.client = client;
+    }
+    async post(path, form) {
+        const res = await this.client.requestRaw('POST', path, { ...TENANT_AUTH, formData: form });
+        return (await res.json());
+    }
+    /** `POST /import/file/preview` (multipart) — parse an .xlsx/.csv (≤5 MB, ≤2000 rows)
+     *  and get headers, sample rows and a suggested mapping. With `mapping` it also
+     *  returns a `plan`. Errors carry `code` (`FILE_*`, `INVALID_MAPPING`, …). */
+    async preview(input) {
+        return this.post(`${BASE}/import/file/preview`, fileForm(input));
+    }
+    /** `POST /import/file/apply` (multipart) — import the file using `mapping`
+     *  (field → exact header). Needs a catalog. */
+    async apply(input) {
+        return this.post(`${BASE}/import/file/apply`, fileForm(input));
+    }
+}
+exports.CatalogFileImportResource = CatalogFileImportResource;
+class CatalogImportResource {
+    constructor(client) {
+        this.client = client;
+        this.file = new CatalogFileImportResource(client);
+    }
+    /** `POST /import/preview` — validate structured items WITHOUT writing. Max 200
+     *  (throws `AgentForgeCatalogImportLimitError` above that, before any request). */
+    async preview(items) {
+        guardItems(items);
+        return this.client.request('POST', `${BASE}/import/preview`, { items }, TENANT_AUTH);
+    }
+    /** `POST /import/apply` — create-only, idempotent per slug. Max 200 per call. */
+    async apply(items) {
+        guardItems(items);
+        return this.client.request('POST', `${BASE}/import/apply`, { items }, TENANT_AUTH);
+    }
+    /** `GET /import/template.xlsx` — the downloadable template (xlsx bytes). */
+    async template() {
+        const res = await this.client.requestRaw('GET', `${BASE}/import/template.xlsx`, TENANT_AUTH);
+        return res.arrayBuffer();
+    }
+}
+exports.CatalogImportResource = CatalogImportResource;
+class CatalogSourcesResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /** `GET /import-sources` */
+    async list() {
+        return this.client.request('GET', `${BASE}/import-sources`, undefined, TENANT_AUTH);
+    }
+    /** `POST /import-sources` — Google Sheets or Shopify source. */
+    async create(input) {
+        return this.client.request('POST', `${BASE}/import-sources`, input, TENANT_AUTH);
+    }
+    /** `PATCH /import-sources/:id` */
+    async update(sourceId, input) {
+        return this.client.request('PATCH', `${BASE}/import-sources/${seg(sourceId)}`, input, TENANT_AUTH);
+    }
+    /** `DELETE /import-sources/:id` */
+    async delete(sourceId) {
+        await this.client.request('DELETE', `${BASE}/import-sources/${seg(sourceId)}`, undefined, TENANT_AUTH);
+    }
+    /** `POST /import-sources/preview` — sample a Google Sheet (headers, rows,
+     *  suggested mapping) before saving a source. Needs a connected Google grant
+     *  (`NO_GOOGLE_GRANT` otherwise). */
+    async preview(input) {
+        return this.client.request('POST', `${BASE}/import-sources/preview`, input, TENANT_AUTH);
+    }
+    /** `POST /import-sources/:id/run` — sync now. Always resolves with `lastResult`;
+     *  run-level failures are in `lastResult.error`. */
+    async run(sourceId) {
+        return this.client.request('POST', `${BASE}/import-sources/${seg(sourceId)}/run`, undefined, TENANT_AUTH);
+    }
+}
+exports.CatalogSourcesResource = CatalogSourcesResource;
+class CatalogResource {
+    constructor(client) {
+        this.client = client;
+        this.categories = new CatalogCategoriesResource(client);
+        this.products = new CatalogProductsResource(client);
+        this.import = new CatalogImportResource(client);
+        this.sources = new CatalogSourcesResource(client);
+    }
+    /** `GET /api/v1/catalog` — the tenant's catalog, or `null` when it has none yet
+     *  (404 `CATALOG_NOT_FOUND`). Other 404s still throw. */
+    async get() {
+        try {
+            return await this.client.request('GET', BASE, undefined, TENANT_AUTH);
+        }
+        catch (e) {
+            if (e instanceof errors_1.AgentForgeNotFoundError && e.code === 'CATALOG_NOT_FOUND')
+                return null;
+            throw e;
+        }
+    }
+    /** `PUT /api/v1/catalog` — ensure-or-update: creates the catalog if missing, then applies the settings. */
+    async upsert(input = {}) {
+        return this.client.request('PUT', BASE, input, TENANT_AUTH);
+    }
+}
+exports.CatalogResource = CatalogResource;

package/dist/types.d.ts

@@ -700,7 +700,26 @@ export interface UpdateTeamInput {
     /** The page's blocks in render order (`enabled: false` hides one). Links
      *  must be http(s), mailto:, tel: or sms:. `null` or `[]` clears them. */
     profileBlocks?: TeamProfileBlock[] | null;
+    /** When the team takes human escalations (and what the agent tells
+     *  customers about being open). Normalized by the platform: windows
+     *  sorted, overlapping ones merged. `null` clears it (always open). An
+     *  empty `schedule` is a 400 — send `null` instead. */
+    businessHours?: TeamBusinessHours | null;
 }
+/** A team's weekly opening hours (AGF-HOURS). */
+export interface TeamBusinessHours {
+    /** IANA timezone, e.g. `America/Bogota`. */
+    timezone: string;
+    /** Open windows, `"HH:mm"` 00:00–23:59, `to` after `from`; a day may
+     *  have several (split shift); a day with none is closed. Overnight
+     *  windows go as two entries on adjacent days. */
+    schedule: Array<{
+        day: TeamWeekday;
+        from: string;
+        to: string;
+    }>;
+}
+export type TeamWeekday = 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' | 'sun';
 /** A team's public-page theme (`af_teams.theme`). Colors are hex strings. */
 export interface TeamTheme {
     logoUrl?: string;
@@ -783,6 +802,7 @@ export interface TeamDetail {
             id: string;
             enabled: boolean;
         }> | null;
+        businessHours?: TeamBusinessHours | null;
     };
     members: Array<{
         agentId: string;
@@ -865,4 +885,351 @@ export interface BusinessRoleEntry {
     color: string;
     icon: string | null;
 }
+/** `product` = physical goods; `service` = offering with no stock. */
+export type CatalogProductKind = 'product' | 'service';
+/** Lifecycle. Only `active` is visible to the public catalog and the client
+ *  agent; `draft` and `archived` are owner-only. */
+export type CatalogProductStatus = 'draft' | 'active' | 'archived';
+/** How `priceCents` reads. `on_request` = no published price (null). */
+export type CatalogPriceKind = 'fixed' | 'from' | 'per_unit' | 'on_request';
+/** Reported stock level for products without a numeric `stock`. */
+export type CatalogAvailability = 'in_stock' | 'low' | 'out';
+export interface CatalogCheckoutCta {
+    type: 'wa' | 'custom' | 'none';
+    /** Required for `wa` and `custom` (the target URL); must be omitted for `none`. */
+    value?: string;
+}
+export interface Catalog {
+    id: string;
+    tenantId: string;
+    currency: string;
+    checkoutCta: CatalogCheckoutCta;
+    isActive: boolean;
+    /** AI-curation settings (read-only here; managed from the dashboard). */
+    aiCuration?: {
+        mode: 'off' | 'suggest' | 'auto';
+        origins?: Partial<Record<'prompt' | 'conversation' | 'owner' | 'sales' | 'sources', boolean>>;
+        autoApplyMinConfidence?: number;
+        dailyTokenBudget?: number;
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+/** `PUT /api/v1/catalog` — ensure-or-update. */
+export interface UpsertCatalogInput {
+    /** 3-letter currency code. */
+    currency?: string;
+    checkoutCta?: CatalogCheckoutCta;
+    isActive?: boolean;
+}
+export interface CatalogCategory {
+    id: string;
+    catalogId: string;
+    name: string;
+    slug: string;
+    sortOrder: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateCatalogCategoryInput {
+    name: string;
+    /** Derived from `name` when omitted. */
+    slug?: string;
+}
+export interface UpdateCatalogCategoryInput {
+    name?: string;
+    slug?: string;
+}
+export interface CatalogProductPhoto {
+    url: string;
+    sortOrder: number;
+    isCover: boolean;
+    /** Storage key backing `url` when the platform's upload service wrote it. */
+    key?: string;
+    /** Source URL the photo was copied from (imports/syncs). */
+    sourceUrl?: string;
+}
+export type CatalogLockableField = 'title' | 'description' | 'priceCents' | 'priceKind' | 'unit' | 'categoryId' | 'kind' | 'aliases' | 'attributes' | 'availability' | 'stock' | 'isAvailable' | 'photos';
+export interface CatalogProduct {
+    id: string;
+    catalogId: string;
+    categoryId?: string | null;
+    slug: string;
+    title: string;
+    description?: string;
+    /** `null` only when `priceKind === 'on_request'`. */
+    priceCents: number | null;
+    currency: string;
+    /** `null`/absent = not tracked. */
+    stock?: number | null;
+    /** `stock` minus active reservations, floored at 0; `null` when stock is untracked. */
+    effectiveStock?: number | null;
+    photos: CatalogProductPhoto[];
+    isAvailable: boolean;
+    sortOrder: number;
+    origin?: string;
+    externalId?: string | null;
+    kind: CatalogProductKind;
+    status: CatalogProductStatus;
+    priceKind: CatalogPriceKind;
+    unit?: string | null;
+    aliases: string[];
+    attributes: Record<string, unknown>;
+    availability?: CatalogAvailability | null;
+    availabilityAt?: string | null;
+    fieldProvenance: Record<string, {
+        origin: string;
+        signalId?: string;
+        at: string;
+    }>;
+    lockedFields: CatalogLockableField[];
+    lastSoldAt?: string | null;
+    demandCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateCatalogProductInput {
+    title: string;
+    slug?: string;
+    description?: string;
+    /** Integer cents. Required unless `priceKind` is `'on_request'` (then null/omitted). */
+    priceCents?: number | null;
+    currency?: string;
+    stock?: number | null;
+    categoryId?: string | null;
+    isAvailable?: boolean;
+    kind?: CatalogProductKind;
+    status?: CatalogProductStatus;
+    priceKind?: CatalogPriceKind;
+    /** Max 32 chars (kg, hour, load…). */
+    unit?: string | null;
+    /** Max 30 aliases, 80 chars each. */
+    aliases?: string[];
+    attributes?: Record<string, unknown>;
+    availability?: CatalogAvailability | null;
+    lockedFields?: CatalogLockableField[];
+}
+export interface UpdateCatalogProductInput extends Partial<CreateCatalogProductInput> {
+    sortOrder?: number;
+}
+export interface ListCatalogProductsInput {
+    /** Free-text search. */
+    q?: string;
+    categoryId?: string;
+    onlyAvailable?: boolean;
+    kind?: CatalogProductKind;
+    /** 1-based. Default 1. */
+    page?: number;
+    /** Default 20, max 100 (server-capped). */
+    pageSize?: number;
+}
+export interface CatalogProductPage {
+    items: CatalogProduct[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+/** `POST …/photos/sign-upload` result: PUT the bytes to `uploadUrl`, then
+ *  `photos.attach({ url: publicUrl, key })`. */
+export interface CatalogPhotoUploadTarget {
+    uploadUrl: string;
+    publicUrl: string;
+    key: string;
+    expiresInSeconds: number;
+}
+export interface SignCatalogPhotoUploadInput {
+    /** image/jpeg, image/png, image/webp… (server whitelist). */
+    contentType: string;
+    contentLength?: number;
+}
+export interface AttachCatalogPhotoInput {
+    url: string;
+    isCover?: boolean;
+    /** The `key` returned by `signUpload` (lets the platform reclaim the object on removal). */
+    key?: string;
+}
+/** One structured item for `catalog.import.preview/apply` (max 200 per call). */
+export interface CatalogImportItem {
+    title: string;
+    /** Positive integer cents. Omit only with `priceKind: 'on_request'`. */
+    priceCents?: number | null;
+    priceKind?: CatalogPriceKind;
+    stock?: number | null;
+    /** Category NAME; created when missing. */
+    category?: string;
+    description?: string;
+    kind?: CatalogProductKind;
+}
+export interface CatalogImportPreview {
+    categoriesToCreate: Array<{
+        name: string;
+        slug: string;
+    }>;
+    categoriesExisting: Array<{
+        name: string;
+        slug: string;
+    }>;
+    productsToCreate: number;
+    warnings: string[];
+}
+export interface CatalogImportApplyResult {
+    categoriesCreated: Array<{
+        name: string;
+        slug: string;
+    }>;
+    productsCreated: Array<{
+        slug: string;
+        title: string;
+    }>;
+    updated: number;
+    skipped: Array<{
+        title: string;
+        reason: string;
+    }>;
+    warnings: string[];
+}
+/** File → catalog field mapping. Every value is an EXACT column header of the file. */
+export interface CatalogFileMapping {
+    title?: string;
+    priceCents?: string;
+    category?: string;
+    stock?: string;
+    externalId?: string;
+    description?: string;
+    image?: string;
+    /** The template's "tipo" column (product | service). */
+    kind?: string;
+}
+export interface CatalogFilePlan {
+    willCreate: number;
+    willUpdate: number;
+    unchanged: number;
+    skipped: number;
+    categoriesToCreate: string[];
+}
+export interface CatalogFilePreview {
+    headers: string[];
+    sampleRows: string[][];
+    rowCount: number;
+    suggestedMapping: CatalogFileMapping;
+    confidence?: 'high' | 'medium' | 'low';
+    notes?: string;
+    /** Present only when a `mapping` was supplied AND the tenant has a catalog. */
+    plan?: CatalogFilePlan;
+    warnings?: string[];
+}
+export interface CatalogFileApplyResult {
+    created: number;
+    updated: number;
+    skipped: number;
+    unchanged: number;
+    categoriesCreated: string[];
+    photosImported: number;
+    warnings: string[];
+}
+/** Binary file accepted by the file-import calls. */
+export type CatalogFileInput = Blob | ArrayBuffer | Uint8Array;
+export interface CatalogFilePreviewInput {
+    file: CatalogFileInput;
+    /** Used for type detection: must end in `.xlsx` or `.csv`. */
+    filename: string;
+    /** Omit to get `suggestedMapping` only; supply it to also get a `plan`. */
+    mapping?: CatalogFileMapping;
+    /** Default `kind` for rows without a "tipo" cell. */
+    kind?: CatalogProductKind;
+    /** 3-letter code; price-format hint. */
+    currency?: string;
+}
+export interface CatalogFileApplyInput extends Omit<CatalogFilePreviewInput, 'mapping'> {
+    mapping: CatalogFileMapping;
+}
+/** Error codes of the file import (`error.code`). */
+export type CatalogFileErrorCode = 'FILE_MISSING_FILE' | 'FILE_UNSUPPORTED_TYPE' | 'FILE_FILE_TOO_LARGE' | 'FILE_CORRUPT_FILE' | 'FILE_EMPTY_FILE' | 'FILE_TOO_MANY_ROWS' | 'FILE_TOO_MANY_COLUMNS' | 'INVALID_MAPPING' | 'INVALID_KIND' | 'INVALID_CURRENCY';
+export type CatalogImportSourceStatus = 'active' | 'paused' | 'error';
+/** Column mapping stored on an import source (Sheets header → field). */
+export interface CatalogImportColumnMapping {
+    title?: string;
+    priceCents?: string;
+    category?: string;
+    stock?: string;
+    externalId?: string;
+    description?: string;
+    image?: string;
+}
+export interface CatalogImportRunResult {
+    created: number;
+    updated: number;
+    unavailable: number;
+    skipped: number;
+    warnings?: string[];
+    error?: string;
+    mappedRowCount?: number;
+    previousCount?: number;
+}
+export interface CatalogImportSource {
+    id: string;
+    tenantId: string;
+    /** `google-sheets` | `shopify`. */
+    connectorId: string;
+    spreadsheetId?: string | null;
+    sheetTab?: string | null;
+    range?: string | null;
+    columnMapping: CatalogImportColumnMapping;
+    /** Per-connector extras, e.g. `{ shop: 'acme.myshopify.com' }`. */
+    config: {
+        shop?: string;
+    };
+    currency?: string | null;
+    /** Cron string; null = manual only. */
+    schedule?: string | null;
+    timezone: string;
+    status: CatalogImportSourceStatus;
+    lastRunAt?: string | null;
+    lastResult?: CatalogImportRunResult | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateCatalogImportSourceInput {
+    connectorId: string;
+    /** Required for `google-sheets`. */
+    spreadsheetId?: string;
+    sheetTab?: string;
+    /** A1 range, e.g. "Menu!A1:E999". Required for `google-sheets`. */
+    range?: string;
+    columnMapping?: CatalogImportColumnMapping;
+    config?: {
+        shop?: string;
+    };
+    currency?: string;
+    schedule?: string | null;
+    timezone?: string;
+    status?: CatalogImportSourceStatus;
+}
+export interface UpdateCatalogImportSourceInput {
+    connectorId?: string;
+    spreadsheetId?: string;
+    sheetTab?: string | null;
+    range?: string;
+    columnMapping?: CatalogImportColumnMapping;
+    config?: {
+        shop?: string;
+    };
+    currency?: string | null;
+    schedule?: string | null;
+    timezone?: string;
+    status?: CatalogImportSourceStatus;
+}
+export interface PreviewCatalogImportSourceInput {
+    spreadsheetId: string;
+    sheetTab?: string;
+    /** Defaults to a small header+sample window of the first tab. */
+    range?: string;
+}
+export interface CatalogImportSourcePreview {
+    headers: string[];
+    sampleRows: string[][];
+    suggestedMapping: CatalogImportColumnMapping;
+    confidence?: 'high' | 'medium' | 'low';
+    notes?: string;
+}
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge-io/sdk-server",
-  "version": "4.14.0",
+  "version": "4.16.0",
   "description": "Server-side SDK for backend apps integrating with AgentForge platform. Auth via ChatToken, ak_live_ API key or App secret (sk_live_), with App installations across tenants.",
   "license": "MIT",
   "main": "dist/index.js",