@agentforge-io/sdk-server 4.6.1 → 4.8.0

package/dist/client.d.ts

@@ -6,6 +6,7 @@ import { ConnectorsResource } from './resources/connectors';
 import { InboxResource } from './resources/inbox';
 import { ProvisioningResource } from './resources/provisioning';
 import { SecretsResource } from './resources/secrets';
+import { TeamsResource } from './resources/teams';
 import { ToolsResource } from './resources/tools';
 export interface AgentForgeClientOptions {
     /** Platform base URL — e.g. http://localhost:3032 in dev. */
@@ -68,6 +69,7 @@ export declare class AgentForgeClient {
     readonly provisioning: ProvisioningResource;
     readonly secrets: SecretsResource;
     readonly tools: ToolsResource;
+    readonly teams: TeamsResource;
     constructor(opts: AgentForgeClientOptions);
     authHeaders(): Record<string, string>;
     getAppSecret(): string | undefined;

package/dist/client.js

@@ -28,6 +28,7 @@ const connectors_1 = require("./resources/connectors");
 const inbox_1 = require("./resources/inbox");
 const provisioning_1 = require("./resources/provisioning");
 const secrets_1 = require("./resources/secrets");
+const teams_1 = require("./resources/teams");
 const tools_1 = require("./resources/tools");
 class AgentForgeClient {
     constructor(opts) {
@@ -57,6 +58,7 @@ class AgentForgeClient {
         this.provisioning = new provisioning_1.ProvisioningResource(this);
         this.secrets = new secrets_1.SecretsResource(this);
         this.tools = new tools_1.ToolsResource(this);
+        this.teams = new teams_1.TeamsResource(this);
     }
     // Auth headers derivados del modo. ChatToken gana si ambos están presentes;
     // luego apiKey (ak_live_); luego appSecret (sk_live_) — ambos secrets viajan

package/dist/index.d.ts

@@ -2,13 +2,13 @@ export { AgentForgeClient } 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, 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, TeamSummary, 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 { AgentsResource } from './resources/agents';
 export { AnalyticsResource } from './resources/analytics';
 export type { GetSupportKpisInput, GetAgentAttentionLogInput, } from './resources/analytics';
 export { AppsResource } from './resources/apps';
 export { ChatResource } from './resources/chat';
-export type { AnthropicClientOptions, StreamMessageInput } from './resources/chat';
+export type { AnthropicClientOptions, AppCallerClaims, StreamMessageInput, StreamMessageForAppUserInput, } from './resources/chat';
 export { ConnectorsResource } from './resources/connectors';
 export type { InboxChannelView } from './resources/connectors';
 export { InboxResource } from './resources/inbox';
@@ -16,5 +16,6 @@ export type { ListThreadsOptions, SendMessageInput, AssignThreadInput, UnassignT
 export { ProvisioningResource } from './resources/provisioning';
 export type { ProvisionedTenant, ProvisionedApp, ProvisionedTeam, } from './resources/provisioning';
 export { SecretsResource } from './resources/secrets';
+export { TeamsResource } from './resources/teams';
 export { ToolsResource } from './resources/tools';
 export type { RespondToCallbackInput, VerifyCallbackInput } from './resources/tools';

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.SecretsResource = exports.ProvisioningResource = 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.AgentForgeClient = void 0;
+exports.ToolsResource = exports.TeamsResource = exports.SecretsResource = exports.ProvisioningResource = 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.AgentForgeClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "AgentForgeClient", { enumerable: true, get: function () { return client_1.AgentForgeClient; } });
 var errors_1 = require("./errors");
@@ -57,5 +57,7 @@ var provisioning_1 = require("./resources/provisioning");
 Object.defineProperty(exports, "ProvisioningResource", { enumerable: true, get: function () { return provisioning_1.ProvisioningResource; } });
 var secrets_1 = require("./resources/secrets");
 Object.defineProperty(exports, "SecretsResource", { enumerable: true, get: function () { return secrets_1.SecretsResource; } });
+var teams_1 = require("./resources/teams");
+Object.defineProperty(exports, "TeamsResource", { enumerable: true, get: function () { return teams_1.TeamsResource; } });
 var tools_1 = require("./resources/tools");
 Object.defineProperty(exports, "ToolsResource", { enumerable: true, get: function () { return tools_1.ToolsResource; } });

package/dist/resources/chat.d.ts

@@ -42,6 +42,25 @@ export interface StreamMessageForAppUserInput {
      * here to turn the sanitizer OFF for this operator-facing surface.
      */
     channel?: ChannelContext;
+    /**
+     * AGF-OUTCOMES I5 — what the App declares about this end user for this
+     * turn. The platform shows it to the agent in the per-turn identity block
+     * as "declared by the App, not verified by AgentForge"; omit for no claims.
+     */
+    caller?: AppCallerClaims;
+}
+/** What an App declares about its end user on a chat turn (see `caller`). */
+export interface AppCallerClaims {
+    displayName?: string;
+    email?: string;
+    phone?: string;
+    /** App-defined role slugs (e.g. `mayorista`); prompts can branch on them. */
+    roles?: string[];
+    /** `true` only when the App itself verified the email. */
+    emailVerified?: boolean;
+    /** Where the person is, in the App's words — e.g. the reference of a
+     *  scanned QR code (`mesa-03`). */
+    location?: string;
 }
 export declare class ChatResource {
     private readonly client;

package/dist/resources/chat.js

@@ -149,6 +149,7 @@ class ChatResource {
             externalUserId: input.externalUserId,
             content: input.content,
             ...(input.channel ? { channel: input.channel } : {}),
+            ...(input.caller ? { caller: input.caller } : {}),
         });
         if (!res.body) {
             throw new Error('chat.streamMessageForAppUser: response has no readable body');

package/dist/resources/teams.d.ts

@@ -0,0 +1,12 @@
+import type { AgentForgeClient } from '../client';
+import type { CreateTeamInput, PublicTeamLanding, TeamSummary } 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>;
+    /** `POST /api/v1/teams` — create a team (and its orchestrator) in the caller's tenant. */
+    create(input: CreateTeamInput): Promise<TeamSummary>;
+    /** `DELETE /api/v1/teams/:teamId` — delete a team of the caller's tenant. */
+    delete(teamId: string): Promise<void>;
+}

package/dist/resources/teams.js

@@ -0,0 +1,40 @@
+"use strict";
+// teams resource — public read of a team's landing payload, so a host App
+// (PoodleDeck, ScrappyDoc, …) can render its own public page for a team
+// without hand-rolling a fetch against the platform (SDK-first rule).
+//
+//   - `getPublic(slug)` — `GET /team/:slug`. The platform's anonymous team
+//     landing surface: team metadata + profile template/blocks/theme, the
+//     orchestrator identity and the member roster. Private teams 404 to
+//     anonymous callers; this client never sends a user JWT, so it only
+//     ever sees public teams.
+//
+//   - `create(input)` / `delete(teamId)` — `POST` / `DELETE /api/v1/teams`.
+//     A host App builds a team for one of its end customers (members are
+//     agents it created with `agents.create`). With `sk_live_` the team is
+//     owned by the App. `delete` is the compensation when a later step of
+//     the host's own onboarding fails.
+//
+// The response also carries a `chatToken` (`aft_…`) for the platform's own
+// public page. A host that runs the chat server-side with its `sk_live_`
+// (`chat.streamMessageForAppUser`) must NOT forward it to browsers.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamsResource = void 0;
+class TeamsResource {
+    constructor(client) {
+        this.client = client;
+    }
+    /** `GET /team/:slug` — public landing payload of a public team. 404 → `AgentForgeNotFoundError`. */
+    async getPublic(slug) {
+        return this.client.request('GET', `/team/${encodeURIComponent(slug)}`);
+    }
+    /** `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);
+    }
+    /** `DELETE /api/v1/teams/:teamId` — delete a team of the caller's tenant. */
+    async delete(teamId) {
+        await this.client.request('DELETE', `/api/v1/teams/${encodeURIComponent(teamId)}`);
+    }
+}
+exports.TeamsResource = TeamsResource;

package/dist/types.d.ts

@@ -587,4 +587,67 @@ export interface AgentAttentionLogRow {
     avgFrtMs: number | null;
     avgTimeToAssignMs: number | null;
 }
+export type PublicProfileTemplate = 'minimal' | 'brand' | 'beacons';
+export interface PublicProfileBlock {
+    id: string;
+    kind: string;
+    enabled: boolean;
+    title?: string;
+    [field: string]: unknown;
+}
+export interface PublicTeamLanding {
+    team: {
+        id: string;
+        name: string;
+        publicSlug?: string;
+        description?: string;
+        theme: Record<string, unknown> | null;
+        profileTemplate: PublicProfileTemplate;
+        profileBlocks: PublicProfileBlock[] | null;
+        orchestrationMode: 'flat' | 'hierarchical';
+    };
+    orchestrator: {
+        id: string;
+        name: string;
+        avatarUrl?: string;
+    };
+    members: Array<{
+        id: string;
+        name: string;
+        avatarUrl?: string;
+        description?: string;
+        roleHint?: string;
+    }>;
+    /** Platform-page ChatToken. Hosts that chat through `sk_live_` must not expose it. */
+    chatToken: string | null;
+}
+/** `POST /api/v1/teams` body. The team's hidden orchestrator agent is created with it. */
+export interface CreateTeamInput {
+    name: string;
+    /** Tenant-unique slug; derived from `name` when omitted. */
+    slug?: string;
+    description?: string;
+    /** Standalone agents of the same tenant that become the team's members. */
+    memberAgentIds?: string[];
+    /** agentId → what that member is for (the orchestrator reads it to delegate). */
+    roleHints?: Record<string, string>;
+    /** Globally unique handle of the public page (`/team/:publicSlug`). Minted when omitted. */
+    publicSlug?: string;
+    visibility?: 'private' | 'public';
+    orchestrationMode?: 'flat' | 'hierarchical';
+}
+/** A team as the admin surface returns it (`/api/v1/teams`). */
+export interface TeamSummary {
+    id: string;
+    tenantId: string;
+    appId?: string | null;
+    name: string;
+    slug: string;
+    description?: string | null;
+    publicSlug?: string | null;
+    visibility: 'private' | 'public';
+    orchestratorAgentId: string;
+    orchestrationMode: 'flat' | 'hierarchical';
+    [field: string]: unknown;
+}
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge-io/sdk-server",
-  "version": "4.6.1",
+  "version": "4.8.0",
   "description": "Server-side SDK for backend apps integrating with AgentForge platform. Auth via ChatToken or ak_live_ API key.",
   "license": "MIT",
   "main": "dist/index.js",