@agentforge-io/sdk-server 4.12.0 → 4.13.1

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 { BusinessRolesResource } from './resources/business-roles';
 import { ToolsResource } from './resources/tools';
 export interface AgentForgeClientOptions {
     /** Platform base URL — e.g. http://localhost:3032 in dev. */
@@ -86,6 +87,7 @@ export declare class AgentForgeClient {
     readonly teams: TeamsResource;
     readonly templates: TemplatesResource;
     readonly config: TenantConfigResource;
+    readonly businessRoles: BusinessRolesResource;
     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 business_roles_1 = require("./resources/business-roles");
 const tools_1 = require("./resources/tools");
 /** Header that selects an installed tenant for an App secret. */
 exports.INSTALLED_TENANT_HEADER = 'x-af-tenant';
@@ -72,6 +73,7 @@ class AgentForgeClient {
         this.teams = new teams_1.TeamsResource(this);
         this.templates = new templates_1.TemplatesResource(this);
         this.config = new config_1.TenantConfigResource(this);
+        this.businessRoles = new business_roles_1.BusinessRolesResource(this);
     }
     /**
      * A client that acts inside `tenantId`, a tenant where this App is

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, AppInstallation, TemplateConfigField, TemplateSummary, TemplateDetail, TemplateInstallResult, TenantConfigEntry, AppSelf, AppSelfConnector, AppSelfConnectors, AppSelfConnectorTools, AppSelfConnectorToolsResponse, RegisterToolInput, RegisterToolsInput, 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, 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 { AgentsResource } from './resources/agents';
 export { AnalyticsResource } from './resources/analytics';
 export type { GetSupportKpisInput, GetAgentAttentionLogInput, } from './resources/analytics';
@@ -17,6 +17,7 @@ export type { InstallAppInput } from './resources/installations';
 export { TemplatesResource } from './resources/templates';
 export type { ListTemplatesInput } from './resources/templates';
 export { TenantConfigResource } from './resources/config';
+export { BusinessRolesResource } from './resources/business-roles';
 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.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.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; } });
@@ -60,6 +60,8 @@ var templates_1 = require("./resources/templates");
 Object.defineProperty(exports, "TemplatesResource", { enumerable: true, get: function () { return templates_1.TemplatesResource; } });
 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 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/business-roles.d.ts

@@ -0,0 +1,8 @@
+import type { AgentForgeClient } from '../client';
+import type { BusinessRoleEntry } from '../types';
+export declare class BusinessRolesResource {
+    private readonly client;
+    constructor(client: AgentForgeClient);
+    /** `GET /api/v1/business-roles` — the roles of the tenant the client acts in. */
+    list(): Promise<BusinessRoleEntry[]>;
+}

package/dist/resources/business-roles.js

@@ -0,0 +1,19 @@
+"use strict";
+// business-roles resource — the tenant's business-role catalog, read only
+// (AGF-100z). A template install copies the roles its team was written for
+// into the tenant; a host App reads them to assign ITS OWN people to those
+// roles. The App never creates roles (a role the prompts do not know would
+// break the business's rules), so there is no write here.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BusinessRolesResource = void 0;
+class BusinessRolesResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /** `GET /api/v1/business-roles` — the roles of the tenant the client acts in. */
+    async list() {
+        const res = await this.client.request('GET', '/api/v1/business-roles');
+        return res.items;
+    }
+}
+exports.BusinessRolesResource = BusinessRolesResource;

package/dist/resources/inbox.d.ts

@@ -12,6 +12,12 @@ export interface SendMessageInput {
     pauseAgent?: boolean;
     /** App-minted operator identity (see file header). */
     operatorId?: string;
+    /** The person's name as the App shows it (≤ 80 chars). Labels the reply
+     *  in the conversation history so the agent knows who answered. */
+    operatorName?: string;
+    /** Names of that person's business roles (≤ 10, ≤ 64 chars each), e.g.
+     *  `['Cajero']`. A label for the agent, never authorization. */
+    operatorRoles?: string[];
 }
 export interface AssignThreadInput {
     /** App-minted operator identity — required for assign. Same string

package/dist/types.d.ts

@@ -118,6 +118,10 @@ export interface RegisterToolInput {
     plaintextSecret?: string;
 }
 export interface RegisterToolsInput {
+    /** Required with an App secret (`sk_live_`): the agent to register the
+     *  tools on — it must belong to the calling App. Ignored with a
+     *  ChatToken / agent-scoped key (the token's agent wins). */
+    agentId?: string;
     tools: RegisterToolInput[];
 }
 export interface RegisterToolsResult {
@@ -489,6 +493,9 @@ export interface ToolCallbackPayload {
     tenantId: string;
     agentId: string;
     conversationId: string;
+    /** The App's end user of that turn, when the tool ran on the App-user
+     *  chat path (`chat.streamMessageForAppUser`). Absent otherwise. */
+    externalUserId?: string;
     toolName: string;
     input: Record<string, unknown>;
     /** ISO timestamp — el platform deja de esperar la respuesta después de
@@ -752,4 +759,11 @@ export interface TenantConfigEntry {
     value: string | null;
     updatedAt?: string;
 }
+/** A business role of the tenant's catalog (`GET /api/v1/business-roles`). */
+export interface BusinessRoleEntry {
+    slug: string;
+    name: string;
+    color: string;
+    icon: string | null;
+}
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge-io/sdk-server",
-  "version": "4.12.0",
+  "version": "4.13.1",
   "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",