@agentforge-io/sdk-server 4.13.1 → 4.15.0

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, 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, 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';

package/dist/resources/teams.d.ts

@@ -1,10 +1,12 @@
 import type { AgentForgeClient } from '../client';
-import type { CreateTeamInput, PublicTeamLanding, TeamSummary, UpdateTeamInput } from '../types';
+import type { CreateTeamInput, PublicTeamLanding, TeamDetail, TeamSummary, UpdateTeamInput } from '../types';
 export declare class TeamsResource {
     private readonly client;
     constructor(client: AgentForgeClient);
     /** `GET /team/:slug` — public landing payload of a public team. 404 → `AgentForgeNotFoundError`. */
     getPublic(slug: string): Promise<PublicTeamLanding>;
+    /** `GET /api/v1/teams/:teamId` — a team of the caller's tenant with its page settings and members. */
+    get(teamId: string): Promise<TeamDetail>;
     /** `POST /api/v1/teams` — create a team (and its orchestrator) in the caller's tenant. */
     create(input: CreateTeamInput): Promise<TeamSummary>;
     /** `PATCH /api/v1/teams/:teamId` — e.g. give a team installed from a

package/dist/resources/teams.js

@@ -28,6 +28,10 @@ class TeamsResource {
     async getPublic(slug) {
         return this.client.request('GET', `/team/${encodeURIComponent(slug)}`);
     }
+    /** `GET /api/v1/teams/:teamId` — a team of the caller's tenant with its page settings and members. */
+    async get(teamId) {
+        return this.client.request('GET', `/api/v1/teams/${encodeURIComponent(teamId)}`);
+    }
     /** `POST /api/v1/teams` — create a team (and its orchestrator) in the caller's tenant. */
     async create(input) {
         return this.client.request('POST', '/api/v1/teams', input);

package/dist/types.d.ts

@@ -691,6 +691,125 @@ export interface UpdateTeamInput {
     publicSlug?: string | null;
     visibility?: 'private' | 'public';
     orchestrationMode?: 'flat' | 'hierarchical';
+    /** The public page's theme (colors as hex, persona texts, logo / banner
+     *  URLs, mode, shortcuts). Unknown keys are dropped; an invalid value is a
+     *  400. `null` clears it. */
+    theme?: TeamTheme | null;
+    /** Page layout. `null` resets to the default. */
+    profileTemplate?: 'minimal' | 'brand' | 'beacons' | null;
+    /** 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;
+    bannerUrl?: string;
+    primaryColor?: string;
+    accentColor?: string;
+    headerBg?: string;
+    surfaceBg?: string;
+    surfaceFg?: string;
+    font?: 'inter' | 'geist' | 'dm-sans' | 'serif';
+    mode?: 'light' | 'dark' | 'auto';
+    personaName?: string;
+    tagline?: string;
+    bio?: string;
+    greeting?: string;
+    shortcuts?: string[];
+    bubbleAgentBg?: string;
+    bubbleAgentFg?: string;
+    bubbleUserBg?: string;
+    bubbleUserFg?: string;
+    sendButtonBg?: string;
+    inputBg?: string;
+    inputFg?: string;
+    avatarBg?: string;
+}
+/** One block of a public page. `id` is minted by the platform when omitted. */
+export type TeamProfileBlock = {
+    id?: string;
+    enabled?: boolean;
+    title?: string;
+} & ({
+    kind: 'links';
+    links: Array<{
+        label: string;
+        url: string;
+        icon?: string;
+        imageUrl?: string;
+    }>;
+    [field: string]: unknown;
+} | {
+    kind: 'socials';
+    entries: Array<{
+        presetId: string;
+        handle?: string;
+        url?: string;
+        prefillMessage?: string;
+    }>;
+    [field: string]: unknown;
+} | {
+    kind: 'faq';
+    items: Array<{
+        question: string;
+        answer: string;
+    }>;
+} | {
+    kind: 'examples';
+    prompts: string[];
+} | {
+    kind: 'video';
+    url: string;
+    caption?: string;
+} | {
+    kind: 'website';
+    url: string;
+    label?: string;
+    description?: string;
+    imageUrl?: string;
+    [field: string]: unknown;
+} | {
+    kind: 'catalog';
+    catalogId: string;
+    [field: string]: unknown;
+});
+/** `GET /api/v1/teams/:id` — the team with its page settings, and its members. */
+export interface TeamDetail {
+    team: TeamSummary & {
+        theme?: TeamTheme | null;
+        profileTemplate?: 'minimal' | 'brand' | 'beacons' | null;
+        profileBlocks?: Array<TeamProfileBlock & {
+            id: string;
+            enabled: boolean;
+        }> | null;
+        businessHours?: TeamBusinessHours | null;
+    };
+    members: Array<{
+        agentId: string;
+        roleHint?: string | null;
+        parentAgentId?: string | null;
+        [field: string]: unknown;
+    }>;
 }
 /** An App's installation in a tenant (AGF-096v, `/api/v1/installations`). */
 export interface AppInstallation {

package/package.json

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