@agentforge-io/sdk-server 4.3.0 → 4.5.0

package/dist/resources/connectors.d.ts

@@ -227,8 +227,9 @@ export declare class ConnectorsResource {
      * `listConnected()`, which is the ak_live_ tenant-wide picker). Returns
      * the SAME rich shape `listForTenant`/`listForUser` produce server-side
      * (`AppUserConnectorStatus`: name/description/category/iconUrl/configured/
-     * accountLabel/connectedAt) — NOT the narrow `ConnectorStatus` the
-     * tenant-picker methods above use.
+     * accountLabel/connectedAt), PLUS `browsable` (AGF-074, computed
+     * server-side on top of the raw `ConnectorStatus` rows) — NOT the narrow
+     * `ConnectorStatus` the tenant-picker methods above use.
      *
      * Requires `appSecret` — throws early otherwise, same as
      * `authorizeForAppUser`.

package/dist/resources/connectors.js

@@ -259,8 +259,9 @@ class ConnectorsResource {
      * `listConnected()`, which is the ak_live_ tenant-wide picker). Returns
      * the SAME rich shape `listForTenant`/`listForUser` produce server-side
      * (`AppUserConnectorStatus`: name/description/category/iconUrl/configured/
-     * accountLabel/connectedAt) — NOT the narrow `ConnectorStatus` the
-     * tenant-picker methods above use.
+     * accountLabel/connectedAt), PLUS `browsable` (AGF-074, computed
+     * server-side on top of the raw `ConnectorStatus` rows) — NOT the narrow
+     * `ConnectorStatus` the tenant-picker methods above use.
      *
      * Requires `appSecret` — throws early otherwise, same as
      * `authorizeForAppUser`.

package/dist/types.d.ts

@@ -95,6 +95,17 @@ export interface RegisterToolInput {
     executionMode?: 'client' | 'remote';
     /** Requerido cuando `executionMode === 'remote'`. */
     callbackUrl?: string;
+    /** Opcional. Si se provee, el platform usa ESTE valor como secret HMAC
+     *  en vez de generar uno random — compartido por todas las tools que
+     *  apunten al mismo `callbackUrl` (ver secretForGroup() en
+     *  ExternalToolsRepository, agentforge-platform). Útil para derivar un
+     *  secret determinístico desde una credencial persistente propia (p.ej.
+     *  un `sk_live_`/app secret que sobrevive redeploys), en vez de depender
+     *  de un secret generado por el platform que solo se muestra una vez y
+     *  que se pierde si el cache local del cliente vive en disco efímero.
+     *  Mínimo 16 caracteres. Omitilo para preservar el comportamiento
+     *  anterior (secret generado por el platform). */
+    plaintextSecret?: string;
 }
 export interface RegisterToolsInput {
     tools: RegisterToolInput[];
@@ -330,6 +341,11 @@ export interface AppUserConnectorStatus {
     configured: boolean;
     /** Este externalUserId particular ya completó el OAuth/API-key setup. */
     connected: boolean;
+    /** ¿Tiene selector de recursos real implementado (nivel 2 del picker)?
+     *  `false` = se puede conectar pero `listResourcesForAppUser()` devuelve
+     *  `unsupported: true`. Mismo criterio (`SUPPORTED_CONNECTORS`) que
+     *  `ConnectorStatus.browsable` usa para el picker tenant-wide. */
+    browsable: boolean;
     accountLabel?: string;
     /** ISO 8601 — `Date` en el server, serializado a string sobre JSON. */
     connectedAt?: string;
@@ -338,12 +354,24 @@ export interface ConnectorResourceItem {
     id: string;
     name: string;
     description?: string;
+    /** Avatar/icon URL for the resource — populated for Slack DMs/people
+     *  (AGF-074 bug #2: the interlocutor's profile photo, from
+     *  `users.info`/`users.list`). Channels and other resource kinds leave
+     *  this `undefined`; render a generic icon (`#` for Slack channels)
+     *  as a fallback. */
+    imageUrl?: string;
 }
 export interface ListConnectorResourcesResult {
     items: ConnectorResourceItem[];
     /** true cuando el connector está conectado pero `browsable` es false —
      *  no es un error, la UI debe mostrar un estado "sin selector todavía". */
     unsupported?: true;
+    /** AGF-074 bug #3: true cuando el provider devolvió `missing_scope` para
+     *  un sub-recurso opcional (ej. Slack DMs vía `im`/`mpim`/`users.list`,
+     *  en un grant OAuth previo a que el connector declarara esos scopes).
+     *  `items` igual trae lo que SÍ se pudo listar (ej. los canales); la UI
+     *  debe ofrecer un CTA de reconectar en vez de tratarlo como error. */
+    needsReconnectForDms?: true;
 }
 export interface CreateClickupTaskInput {
     /** Id de la lista de ClickUp (`ConnectorResourceItem.id` del picker). */

package/package.json

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