@axonflow/sdk 1.1.0 → 1.2.1

package/README.md

@@ -59,6 +59,48 @@ const response = await protectedOpenAI.chat.completions.create({
 });
 ```
 
+### Self-Hosted Mode (No License Required)
+
+Connect to a self-hosted AxonFlow instance running via docker-compose:
+
+```typescript
+import { AxonFlow } from '@axonflow/sdk';
+import OpenAI from 'openai';
+
+const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+
+// Self-hosted (localhost) - no license key needed!
+const axonflow = new AxonFlow({
+  endpoint: 'http://localhost:8081'
+  // That's it - no authentication required for localhost
+});
+
+// Use normally - same features as production
+const response = await axonflow.protect(async () => {
+  return openai.chat.completions.create({
+    model: 'gpt-4',
+    messages: [{ role: 'user', content: 'Test with self-hosted AxonFlow' }]
+  });
+});
+```
+
+**Self-hosted deployment:**
+```bash
+# Clone and start AxonFlow
+git clone https://github.com/getaxonflow/axonflow.git
+cd axonflow
+export OPENAI_API_KEY=sk-your-key-here
+docker-compose up
+
+# SDK connects to http://localhost:8081 - no license needed!
+```
+
+**Features:**
+- ✅ Full AxonFlow features without license
+- ✅ Perfect for local development and testing
+- ✅ Same API as production
+- ✅ Automatically detects localhost and skips authentication
+
 ### Legacy API Key Auth (Deprecated)
 
 > **⚠️ Deprecated**: `apiKey` authentication is deprecated. Please migrate to license-based authentication using `licenseKey`.
@@ -166,7 +208,7 @@ For customers running within AWS VPC, use the private endpoint for sub-10ms late
 ```typescript
 const axonflow = new AxonFlow({
   apiKey: 'your-client-id',
-  endpoint: 'https://10.0.2.67:8443',  // VPC private endpoint (EU)
+  endpoint: 'https://vpc-private-endpoint.getaxonflow.com:8443',  // VPC private endpoint
   tenant: 'your-client-id',
   mode: 'production'
 });
@@ -308,6 +350,97 @@ if (resp.success) {
 }
 ```
 
+### Production Connectors (November 2025)
+
+AxonFlow now supports **7 production-ready connectors**:
+
+#### Salesforce CRM Connector
+
+Query Salesforce data using SOQL:
+
+```typescript
+// Query Salesforce contacts
+const contacts = await axonflow.queryConnector(
+  'salesforce-crm',
+  'Find all contacts for account Acme Corp',
+  {
+    soql: "SELECT Id, Name, Email, Phone FROM Contact WHERE AccountId = '001xx000003DHP0'"
+  }
+);
+
+console.log(`Found ${contacts.data.length} contacts`);
+```
+
+**Authentication:** OAuth 2.0 password grant (configured in AxonFlow dashboard)
+
+#### Snowflake Data Warehouse Connector
+
+Execute analytics queries on Snowflake:
+
+```typescript
+// Query Snowflake for sales analytics
+const analytics = await axonflow.queryConnector(
+  'snowflake-warehouse',
+  'Get monthly revenue for last 12 months',
+  {
+    sql: `SELECT DATE_TRUNC('month', order_date) as month,
+          COUNT(*) as orders,
+          SUM(amount) as revenue
+          FROM orders
+          WHERE order_date >= DATEADD(month, -12, CURRENT_DATE())
+          GROUP BY month
+          ORDER BY month`
+  }
+);
+
+console.log('Revenue data:', analytics.data);
+```
+
+**Authentication:** Key-pair JWT authentication (configured in AxonFlow dashboard)
+
+#### Slack Connector
+
+Send notifications and alerts to Slack channels:
+
+```typescript
+// Send Slack notification
+const result = await axonflow.queryConnector(
+  'slack-workspace',
+  'Send deployment notification to #engineering channel',
+  {
+    channel: '#engineering',
+    text: '🚀 Deployment complete! All systems operational.',
+    blocks: [
+      {
+        type: 'section',
+        text: {
+          type: 'mrkdwn',
+          text: '*Deployment Status*\n✅ All systems operational'
+        }
+      }
+    ]
+  }
+);
+
+console.log('Message sent:', result.success);
+```
+
+**Authentication:** OAuth 2.0 bot token (configured in AxonFlow dashboard)
+
+#### Available Connectors
+
+| Connector | Type | Use Case |
+|-----------|------|----------|
+| PostgreSQL | Database | Relational data access |
+| Redis | Cache | Distributed rate limiting |
+| Slack | Communication | Team notifications |
+| Salesforce | CRM | Customer data, SOQL queries |
+| Snowflake | Data Warehouse | Analytics, reporting |
+| Amadeus GDS | Travel | Flight/hotel booking |
+| Cassandra | NoSQL | Distributed database |
+
+For complete connector documentation, see [https://docs.getaxonflow.com/mcp](https://docs.getaxonflow.com/mcp)
+
 ## Multi-Agent Planning (MAP)
 
 Generate and execute complex multi-step plans using AI agent orchestration:

package/dist/cjs/client.d.ts

@@ -1,4 +1,4 @@
-import { AxonFlowConfig, ConnectorMetadata, ConnectorInstallRequest, ConnectorResponse, PlanResponse, PlanExecutionResponse } from './types';
+import { AxonFlowConfig, ConnectorMetadata, ConnectorInstallRequest, ConnectorResponse, PlanResponse, PlanExecutionResponse, PolicyApprovalResult, PolicyApprovalOptions, AuditResult, AuditOptions } from './types';
 /**
  * Main AxonFlow client for invisible AI governance
  */
@@ -46,15 +46,90 @@ export declare class AxonFlow {
     queryConnector(connectorName: string, query: string, params?: any): Promise<ConnectorResponse>;
     /**
      * Generate a multi-agent execution plan from a natural language query
+     * @param query - Natural language query describing the task
+     * @param domain - Optional domain hint (travel, healthcare, etc.)
+     * @param userToken - Optional user token for authentication (defaults to tenant/client_id)
      */
-    generatePlan(query: string, domain?: string): Promise<PlanResponse>;
+    generatePlan(query: string, domain?: string, userToken?: string): Promise<PlanResponse>;
     /**
      * Execute a previously generated multi-agent plan
+     * @param planId - ID of the plan to execute
+     * @param userToken - Optional user token for authentication (defaults to tenant/client_id)
      */
-    executePlan(planId: string): Promise<PlanExecutionResponse>;
+    executePlan(planId: string, userToken?: string): Promise<PlanExecutionResponse>;
     /**
      * Get the status of a running or completed plan
      */
     getPlanStatus(planId: string): Promise<PlanExecutionResponse>;
+    /**
+     * Gateway Mode: Pre-check policy approval before making a direct LLM call.
+     * Alias for getPolicyApprovedContext() for simpler API.
+     */
+    preCheck(options: PolicyApprovalOptions): Promise<PolicyApprovalResult>;
+    /**
+     * Gateway Mode: Get policy-approved context before making a direct LLM call.
+     *
+     * Use this when you want to:
+     * - Make direct LLM calls (not through AxonFlow proxy)
+     * - Have full control over your LLM provider/model selection
+     * - Minimize latency by calling LLM directly
+     *
+     * @example
+     * ```typescript
+     * const ctx = await axonflow.getPolicyApprovedContext({
+     *   userToken: 'user-jwt',
+     *   query: 'Analyze this customer data',
+     *   dataSources: ['postgres']
+     * });
+     *
+     * if (!ctx.approved) {
+     *   throw new Error(`Blocked: ${ctx.blockReason}`);
+     * }
+     *
+     * // Make direct LLM call with approved data
+     * const response = await openai.chat.completions.create({
+     *   model: 'gpt-4',
+     *   messages: [{ role: 'user', content: JSON.stringify(ctx.approvedData) }]
+     * });
+     *
+     * // Audit the call
+     * await axonflow.auditLLMCall({
+     *   contextId: ctx.contextId,
+     *   responseSummary: response.choices[0].message.content.substring(0, 100),
+     *   provider: 'openai',
+     *   model: 'gpt-4',
+     *   tokenUsage: {
+     *     promptTokens: response.usage.prompt_tokens,
+     *     completionTokens: response.usage.completion_tokens,
+     *     totalTokens: response.usage.total_tokens
+     *   },
+     *   latencyMs: 250
+     * });
+     * ```
+     */
+    getPolicyApprovedContext(options: PolicyApprovalOptions): Promise<PolicyApprovalResult>;
+    /**
+     * Gateway Mode: Audit an LLM call after completion.
+     *
+     * Call this after making a direct LLM call to log the audit trail.
+     * This is required for compliance and monitoring.
+     *
+     * @example
+     * ```typescript
+     * await axonflow.auditLLMCall({
+     *   contextId: ctx.contextId,
+     *   responseSummary: 'Generated report with 5 items',
+     *   provider: 'openai',
+     *   model: 'gpt-4',
+     *   tokenUsage: {
+     *     promptTokens: 100,
+     *     completionTokens: 50,
+     *     totalTokens: 150
+     *   },
+     *   latencyMs: 250
+     * });
+     * ```
+     */
+    auditLLMCall(options: AuditOptions): Promise<AuditResult>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/cjs/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAId,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAUZ;IACF,OAAO,CAAC,YAAY,CAAyB;gBAEjC,MAAM,EAAE,cAAc;IAyClC;;;;OAIG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqD5D;;OAEG;YACW,cAAc;IAiB5B;;OAEG;YACW,aAAa;IA8D3B;;OAEG;YACW,QAAQ;IAYtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,GAAE,MAAmB,GAAG,QAAQ;IASrD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAqBpD;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BvE;;OAEG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgDpG;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAmDzE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA+CjE;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAwBpE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAId,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAC;AAOjB;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAUZ;IACF,OAAO,CAAC,YAAY,CAAyB;gBAEjC,MAAM,EAAE,cAAc;IAqDlC;;;;OAIG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuD5D;;OAEG;YACW,cAAc;IAiB5B;;OAEG;YACW,aAAa;IAyE3B;;OAEG;YACW,QAAQ;IAYtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,GAAE,MAAmB,GAAG,QAAQ;IASrD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAqBpD;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCvE;;OAEG;IACG,cAAc,CAClB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,GAAG,GACX,OAAO,CAAC,iBAAiB,CAAC;IAkD7B;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAqD7F;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiDrF;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA+BnE;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACG,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkF7F;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAqEhE"}