@agentforge-io/sdk-server 4.9.0 → 4.10.0

package/dist/client.d.ts

@@ -109,6 +109,15 @@ export declare class AgentForgeClient {
      *  ak_live_ — usado por resources cuya superficie SIEMPRE requiere apiKey
      *  (tenant-admin), regardless de si también hay chatToken. */
     requireApiKey(): string;
+    /**
+     * The tenant-wide credential for surfaces that refuse a ChatToken
+     * (connector-resources, connectors/oauth/*-for-tenant): the `ak_live_`, or
+     * an App's `sk_` secret. The server's ApiKeyGuard accepts both on the same
+     * header, and with `forTenant` the secret acts in the installed tenant —
+     * that is how a host connects an account (Google…) into each of its
+     * tenants. Throws when the client has neither.
+     */
+    requireTenantCredential(): string;
     private resolveAuthHeaders;
     /**
      * Primitiva de bajo nivel: hace el fetch, mapea status codes a errores

package/dist/client.js

@@ -138,9 +138,25 @@ class AgentForgeClient {
         }
         return this.apiKey;
     }
+    /**
+     * The tenant-wide credential for surfaces that refuse a ChatToken
+     * (connector-resources, connectors/oauth/*-for-tenant): the `ak_live_`, or
+     * an App's `sk_` secret. The server's ApiKeyGuard accepts both on the same
+     * header, and with `forTenant` the secret acts in the installed tenant —
+     * that is how a host connects an account (Google…) into each of its
+     * tenants. Throws when the client has neither.
+     */
+    requireTenantCredential() {
+        const credential = this.apiKey ?? this.appSecret;
+        if (!credential) {
+            throw new Error('AgentForgeClient: this call requires an ak_live_ apiKey or an App secret (sk_), ' +
+                'but the client was constructed with neither.');
+        }
+        return credential;
+    }
     resolveAuthHeaders(opts) {
         if (opts?.forceApiKey)
-            return { Authorization: `Bearer ${this.requireApiKey()}` };
+            return { Authorization: `Bearer ${this.requireTenantCredential()}` };
         return this.authHeaders();
     }
     /**

package/dist/resources/templates.d.ts

@@ -2,8 +2,14 @@ import type { AgentForgeClient } from '../client';
 import type { TemplateDetail, TemplateInstallResult, TemplateSummary } from '../types';
 export interface ListTemplatesInput {
     kind?: 'agent' | 'team';
-    /** Every tag must match (AND), e.g. ['poodledeck', 'type:food']. */
+    /** Every tag must match (AND), e.g. ['type:food']. */
     tags?: string[];
+    /** Leave out templates carrying any of these tags. */
+    excludeTags?: string[];
+    /** 'own': the caller's templates (its tenant's and, for an App in an
+     *  installed tenant, its home tenant's). 'market': system and public
+     *  templates of others. Omit for both. */
+    scope?: 'own' | 'market';
     /** Free-text search. */
     q?: string;
     /** 1–200. */

package/dist/resources/templates.js

@@ -4,6 +4,11 @@
 // public, filtered by tag) and installs one into the tenant it acts in —
 // usually an owner's tenant via `af.forTenant(tenantId).templates.install`.
 //
+// A host authors its templates in its OWN tenant (`scope: 'own'`); they stay
+// its own — listed and installable — in every tenant the App is installed
+// in, without being published. `scope: 'market'` is everyone else's: system
+// and public templates.
+//
 // Installing copies the team, members, orchestrator, skills and tools, and
 // creates the template's config variables EMPTY (`configCreated`); fill them
 // with `config.set`. Rows created by an App secret are owned by the App.
@@ -20,6 +25,10 @@ class TemplatesResource {
             qs.set('kind', input.kind);
         for (const tag of input.tags ?? [])
             qs.append('tag', tag);
+        for (const tag of input.excludeTags ?? [])
+            qs.append('excludeTag', tag);
+        if (input.scope)
+            qs.set('scope', input.scope);
         if (input.q)
             qs.set('q', input.q);
         if (input.limit !== undefined)

package/package.json

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