@agentforge-io/sdk-server 4.13.1 → 4.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -2,7 +2,7 @@ export { AgentForgeClient, INSTALLED_TENANT_HEADER } from './client';
2
2
  export type { AgentForgeClientOptions, RequestOptions } from './client';
3
3
  export { AgentForgeError, AgentForgeAuthError, AgentForgeNotFoundError, AgentForgeNetworkError, } from './errors';
4
4
  export { TOOL_CALLBACK_HEADERS, ToolCallbackSignatureError, signToolCallbackPayload, verifyToolCallbackSignature, } from './webhooks';
5
- 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';
5
+ 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';
6
6
  export { AgentsResource } from './resources/agents';
7
7
  export { AnalyticsResource } from './resources/analytics';
8
8
  export type { GetSupportKpisInput, GetAgentAttentionLogInput, } from './resources/analytics';
@@ -1,10 +1,12 @@
1
1
  import type { AgentForgeClient } from '../client';
2
- import type { CreateTeamInput, PublicTeamLanding, TeamSummary, UpdateTeamInput } from '../types';
2
+ import type { CreateTeamInput, PublicTeamLanding, TeamDetail, TeamSummary, UpdateTeamInput } from '../types';
3
3
  export declare class TeamsResource {
4
4
  private readonly client;
5
5
  constructor(client: AgentForgeClient);
6
6
  /** `GET /team/:slug` — public landing payload of a public team. 404 → `AgentForgeNotFoundError`. */
7
7
  getPublic(slug: string): Promise<PublicTeamLanding>;
8
+ /** `GET /api/v1/teams/:teamId` — a team of the caller's tenant with its page settings and members. */
9
+ get(teamId: string): Promise<TeamDetail>;
8
10
  /** `POST /api/v1/teams` — create a team (and its orchestrator) in the caller's tenant. */
9
11
  create(input: CreateTeamInput): Promise<TeamSummary>;
10
12
  /** `PATCH /api/v1/teams/:teamId` — e.g. give a team installed from a
@@ -28,6 +28,10 @@ class TeamsResource {
28
28
  async getPublic(slug) {
29
29
  return this.client.request('GET', `/team/${encodeURIComponent(slug)}`);
30
30
  }
31
+ /** `GET /api/v1/teams/:teamId` — a team of the caller's tenant with its page settings and members. */
32
+ async get(teamId) {
33
+ return this.client.request('GET', `/api/v1/teams/${encodeURIComponent(teamId)}`);
34
+ }
31
35
  /** `POST /api/v1/teams` — create a team (and its orchestrator) in the caller's tenant. */
32
36
  async create(input) {
33
37
  return this.client.request('POST', '/api/v1/teams', input);
package/dist/types.d.ts CHANGED
@@ -691,6 +691,105 @@ export interface UpdateTeamInput {
691
691
  publicSlug?: string | null;
692
692
  visibility?: 'private' | 'public';
693
693
  orchestrationMode?: 'flat' | 'hierarchical';
694
+ /** The public page's theme (colors as hex, persona texts, logo / banner
695
+ * URLs, mode, shortcuts). Unknown keys are dropped; an invalid value is a
696
+ * 400. `null` clears it. */
697
+ theme?: TeamTheme | null;
698
+ /** Page layout. `null` resets to the default. */
699
+ profileTemplate?: 'minimal' | 'brand' | 'beacons' | null;
700
+ /** The page's blocks in render order (`enabled: false` hides one). Links
701
+ * must be http(s), mailto:, tel: or sms:. `null` or `[]` clears them. */
702
+ profileBlocks?: TeamProfileBlock[] | null;
703
+ }
704
+ /** A team's public-page theme (`af_teams.theme`). Colors are hex strings. */
705
+ export interface TeamTheme {
706
+ logoUrl?: string;
707
+ bannerUrl?: string;
708
+ primaryColor?: string;
709
+ accentColor?: string;
710
+ headerBg?: string;
711
+ surfaceBg?: string;
712
+ surfaceFg?: string;
713
+ font?: 'inter' | 'geist' | 'dm-sans' | 'serif';
714
+ mode?: 'light' | 'dark' | 'auto';
715
+ personaName?: string;
716
+ tagline?: string;
717
+ bio?: string;
718
+ greeting?: string;
719
+ shortcuts?: string[];
720
+ bubbleAgentBg?: string;
721
+ bubbleAgentFg?: string;
722
+ bubbleUserBg?: string;
723
+ bubbleUserFg?: string;
724
+ sendButtonBg?: string;
725
+ inputBg?: string;
726
+ inputFg?: string;
727
+ avatarBg?: string;
728
+ }
729
+ /** One block of a public page. `id` is minted by the platform when omitted. */
730
+ export type TeamProfileBlock = {
731
+ id?: string;
732
+ enabled?: boolean;
733
+ title?: string;
734
+ } & ({
735
+ kind: 'links';
736
+ links: Array<{
737
+ label: string;
738
+ url: string;
739
+ icon?: string;
740
+ imageUrl?: string;
741
+ }>;
742
+ [field: string]: unknown;
743
+ } | {
744
+ kind: 'socials';
745
+ entries: Array<{
746
+ presetId: string;
747
+ handle?: string;
748
+ url?: string;
749
+ prefillMessage?: string;
750
+ }>;
751
+ [field: string]: unknown;
752
+ } | {
753
+ kind: 'faq';
754
+ items: Array<{
755
+ question: string;
756
+ answer: string;
757
+ }>;
758
+ } | {
759
+ kind: 'examples';
760
+ prompts: string[];
761
+ } | {
762
+ kind: 'video';
763
+ url: string;
764
+ caption?: string;
765
+ } | {
766
+ kind: 'website';
767
+ url: string;
768
+ label?: string;
769
+ description?: string;
770
+ imageUrl?: string;
771
+ [field: string]: unknown;
772
+ } | {
773
+ kind: 'catalog';
774
+ catalogId: string;
775
+ [field: string]: unknown;
776
+ });
777
+ /** `GET /api/v1/teams/:id` — the team with its page settings, and its members. */
778
+ export interface TeamDetail {
779
+ team: TeamSummary & {
780
+ theme?: TeamTheme | null;
781
+ profileTemplate?: 'minimal' | 'brand' | 'beacons' | null;
782
+ profileBlocks?: Array<TeamProfileBlock & {
783
+ id: string;
784
+ enabled: boolean;
785
+ }> | null;
786
+ };
787
+ members: Array<{
788
+ agentId: string;
789
+ roleHint?: string | null;
790
+ parentAgentId?: string | null;
791
+ [field: string]: unknown;
792
+ }>;
694
793
  }
695
794
  /** An App's installation in a tenant (AGF-096v, `/api/v1/installations`). */
696
795
  export interface AppInstallation {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agentforge-io/sdk-server",
3
- "version": "4.13.1",
3
+ "version": "4.14.0",
4
4
  "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.",
5
5
  "license": "MIT",
6
6
  "main": "dist/index.js",