@agentforge-io/core 3.3.0 → 3.3.1

package/dist/domain/connector.d.ts

@@ -16,6 +16,19 @@ export interface ConnectorToolContext {
     /** Returns a valid (non-expired) access token. Refreshes transparently
      *  if the cached one is within the refresh window. */
     getAccessToken: () => Promise<string>;
+    /**
+     * Per-installation context captured at OAuth-time and persisted on
+     * `ConnectorAuth.metadata`. Today only used by Shopify (`metadata.shop`
+     * holds the per-store domain), but kept generic so future per-install
+     * providers (Atlassian cloudId, Intercom region) can read theirs
+     * without another field on the context.
+     *
+     * Undefined for connectors that didn't stamp anything (Google, HubSpot,
+     * etc.). Tools that need a key here must throw a clear error when
+     * absent so a missing-metadata regression surfaces at the tool call
+     * rather than mid-API-request.
+     */
+    metadata?: Record<string, unknown>;
 }
 /**
  * A connector tool is an AgentForge tool that needs an authenticated user

package/dist/services/connector-registry.service.js

@@ -339,6 +339,7 @@ class ConnectorRegistryService {
                 userId: contextUserId,
                 connectorId: a.connectorId,
                 getAccessToken: () => this.getAccessToken(a),
+                metadata: a.metadata,
             };
             for (const factory of def.tools) {
                 tools.push({ ...factory.definition, execute: factory.build(ctx) });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge-io/core",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "Framework-free AI runtime SDK. Owns: agent loop (Anthropic), conversations, tools, streaming, agent-job queue, SdkHooks. Identity, billing, infra (email/uploads/secrets) live in the host's modules — not here.",
   "license": "MIT",
   "main": "dist/index.js",