@dimo-network/data-sdk 1.3.3 → 1.5.1

package/.github/workflows/npm-publish.yml

@@ -29,12 +29,17 @@ jobs:
   publish-npm:
     needs: build
     runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # Required for OIDC
+      contents: read
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: 20
           registry-url: https://registry.npmjs.org/
+      - name: Install latest npm
+        run: npm install -g npm@latest
       - name: Clear npm cache
         run: npm cache clean --force
       - name: Install dependencies
@@ -46,5 +51,3 @@ jobs:
       - name: Check dist directory
         run: ls dist/
       - run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

package/README.md

@@ -293,5 +293,87 @@ const totalNetworkVehicles = await dimo.identity.query({
 
 This GraphQL API query is equivalent to calling `dimo.identity.countDimoVehicles()`.
 
+### Agents API
+
+The DIMO Agents API enables developers to create intelligent AI agents that can interact with vehicle data through natural language. These agents can query vehicle information, real-time telemetry, perform web searches to answer questions about vehicles and nearby services, and more.
+
+#### Create an Agent
+
+Create a new conversational AI agent with the specified configuration:
+
+```ts
+const agent = await dimo.agents.createAgent({
+  ...developerJwt,
+  type: "driver_agent_v1", // Optional: defaults to "driver_agent_v1"
+  personality: "uncle_mechanic", // Optional: defaults to "uncle_mechanic"
+  secrets: {
+    DIMO_API_KEY: "<YOUR_API_KEY>"
+  },
+  variables: {
+    USER_WALLET: "0x1234567890abcdef1234567890abcdef12345678",
+    VEHICLE_IDS: "[872, 1234]"
+  }
+});
+```
+
+Available personalities: `uncle_mechanic`, `master_technician`, `concierge`, `driving_enthusiast`, `fleet_manager_pro`
+
+#### Send a Message
+
+Send a message to an agent and receive a complete response synchronously:
+
+```ts
+const response = await dimo.agents.sendMessage({
+  ...developerJwt,
+  agentId: "agent-abc123def456",
+  message: "What's the make and model of my vehicle?"
+});
+```
+
+#### Stream a Message
+
+Send a message and receive real-time token-by-token streaming response:
+
+```ts
+const stream = await dimo.agents.streamMessage({
+  ...developerJwt,
+  agentId: "agent-abc123def456",
+  message: "What's my current speed?"
+});
+
+stream.on('token', (chunk) => {
+  console.log(chunk.content);
+});
+
+stream.on('done', (metadata) => {
+  console.log('Vehicles queried:', metadata.vehiclesQueried);
+});
+```
+
+#### Get Conversation History
+
+Retrieve the complete conversation history for an agent:
+
+```ts
+const history = await dimo.agents.getHistory({
+  ...developerJwt,
+  agentId: "agent-abc123def456",
+  limit: 50 // Optional
+});
+```
+
+#### Delete an Agent
+
+Permanently delete an agent and all associated resources:
+
+```ts
+await dimo.agents.deleteAgent({
+  ...developerJwt,
+  agentId: "agent-abc123def456"
+});
+```
+
+For more details, visit the [Agents API Documentation](https://www.dimo.org/docs/api-references/agents-api).
+
 ## How to Contribute to the SDK
 Read more about contributing [here](https://github.com/DIMO-Network/data-sdk/blob/master/CONTRIBUTING.md).

package/dist/api/Method.js

@@ -87,14 +87,19 @@ export const Method = async (resource, baseUrl, params = {}, env) => {
     let body = {};
     if (resource.body) {
         for (const key in resource.body) {
-            if (typeof resource.body[key] === 'boolean') {
+            if (resource.body[key] === true) {
+                // Required field
                 if (!params[key]) {
                     console.error(`Missing required body parameter: ${key}`);
                     throw new DimoError({
                         message: `Missing required body parameter: ${key}`
                     });
                 }
-                else {
+                body[key] = params[key];
+            }
+            else if (resource.body[key] === false) {
+                // Optional field - include only if provided
+                if (params[key] !== undefined) {
                     body[key] = params[key];
                 }
             }

package/dist/api/Method.test.js

@@ -2,6 +2,8 @@ import axios from 'axios';
 import { Method } from './Method'; // Import the Method function to be tested
 import { DimoError } from '../errors';
 import { DimoEnvironment } from '../environments';
+jest.mock('axios');
+const mockedAxios = axios;
 const PROD = 'Production';
 const DEV = 'Dev';
 const RESOURCE = {
@@ -11,8 +13,11 @@ const RESOURCE = {
 };
 const PARAM = { param1: 'value1' };
 describe('Method Function', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
     test('Valid API Call - Device Definitions API Server is up and returning data', async () => {
-        jest.spyOn(axios, 'request').mockResolvedValue({ data: { key: 'value' } });
+        mockedAxios.mockResolvedValue({ data: 'device definitions api running!' });
         const devResponse = await Method(RESOURCE, DimoEnvironment.Dev.DeviceDefinitions, PARAM, DEV);
         const prodResponse = await Method(RESOURCE, DimoEnvironment.Production.DeviceDefinitions, PARAM, PROD);
         // Assertion - Check if the response data is returned correctly
@@ -20,7 +25,7 @@ describe('Method Function', () => {
         expect(prodResponse).toEqual('device definitions api running!');
     });
     test('Valid API Call - Devices API Server is up and returning data', async () => {
-        jest.spyOn(axios, 'request').mockResolvedValue({ data: { key: 'value' } });
+        mockedAxios.mockResolvedValue({ data: { data: 'Server is up and running' } });
         const devResponse = await Method(RESOURCE, DimoEnvironment.Dev.Devices, PARAM, DEV);
         const prodResponse = await Method(RESOURCE, DimoEnvironment.Production.Devices, PARAM, PROD);
         // Assertion - Check if the response data is returned correctly
@@ -28,7 +33,7 @@ describe('Method Function', () => {
         expect(prodResponse).toEqual({ data: 'Server is up and running' });
     });
     test('Valid API Call - Token Exchange API Server is up and returning data', async () => {
-        jest.spyOn(axios, 'request').mockResolvedValue({ data: { key: 'value' } });
+        mockedAxios.mockResolvedValue({ data: { data: 'Server is up and running' } });
         const devResponse = await Method(RESOURCE, DimoEnvironment.Dev.TokenExchange, PARAM, DEV);
         const prodResponse = await Method(RESOURCE, DimoEnvironment.Production.TokenExchange, PARAM, PROD);
         // Assertion - Check if the response data is returned correctly
@@ -36,7 +41,7 @@ describe('Method Function', () => {
         expect(prodResponse).toEqual({ data: 'Server is up and running' });
     });
     test('Valid API Call - Valuations API Server is up and returning data', async () => {
-        jest.spyOn(axios, 'request').mockResolvedValue({ data: { key: 'value' } });
+        mockedAxios.mockResolvedValue({ data: { code: 200, message: 'Server is up.' } });
         const devResponse = await Method(RESOURCE, DimoEnvironment.Dev.Valuations, PARAM, DEV);
         const prodResponse = await Method(RESOURCE, DimoEnvironment.Production.Valuations, PARAM, PROD);
         // Assertion - Check if the response data is returned correctly
@@ -44,7 +49,7 @@ describe('Method Function', () => {
         expect(prodResponse).toEqual({ code: 200, message: 'Server is up.' });
     });
     test('Valid API Call - Vehicle Signal Decoding API Server is up and returning data', async () => {
-        jest.spyOn(axios, 'request').mockResolvedValue({ data: { key: 'value' } });
+        mockedAxios.mockResolvedValue({ data: 'healthy' });
         const devResponse = await Method(RESOURCE, DimoEnvironment.Dev.VehicleSignalDecoding, PARAM, DEV);
         const prodResponse = await Method(RESOURCE, DimoEnvironment.Production.VehicleSignalDecoding, PARAM, PROD);
         // Assertion - Check if the response data is returned correctly

package/dist/api/resources/Agents/index.d.ts

@@ -0,0 +1,5 @@
+import { Resource } from '../../Resource';
+import { DimoEnvironment } from '../../../environments';
+export declare class Agents extends Resource {
+    constructor(api: any, env: keyof typeof DimoEnvironment);
+}

package/dist/api/resources/Agents/index.js

@@ -0,0 +1,63 @@
+import { Resource } from '../../Resource';
+export class Agents extends Resource {
+    constructor(api, env) {
+        super(api, 'Agents', env);
+        this.setResource({
+            healthCheck: {
+                method: 'GET',
+                path: '/'
+            },
+            createAgent: {
+                method: 'POST',
+                path: '/agents',
+                body: {
+                    'type': false,
+                    'personality': false,
+                    'secrets': true,
+                    'variables': true,
+                },
+                auth: 'developer_jwt'
+            },
+            deleteAgent: {
+                method: 'DELETE',
+                path: '/agents/:agentId',
+                auth: 'developer_jwt'
+            },
+            sendMessage: {
+                method: 'POST',
+                path: '/agents/:agentId/message',
+                body: {
+                    'message': true,
+                    'vehicleIds': false,
+                    'user': false
+                },
+                auth: 'developer_jwt'
+            },
+            streamMessage: {
+                method: 'POST',
+                path: '/agents/:agentId/stream',
+                body: {
+                    'message': true,
+                    'vehicleIds': false,
+                    'user': false
+                },
+                auth: 'developer_jwt'
+            },
+            getHistory: {
+                method: 'GET',
+                path: '/agents/:agentId/history',
+                queryParams: {
+                    'limit': false
+                },
+                auth: 'developer_jwt'
+            }
+        });
+        const originalCreateAgent = this.createAgent;
+        this.createAgent = (params = {}) => {
+            return originalCreateAgent({
+                type: 'driver_agent_v1',
+                ...params
+            });
+        };
+    }
+}

package/dist/api/resources/DimoRestResources.d.ts

@@ -1,4 +1,5 @@
 /** @format */
+import { Agents } from './Agents';
 import { Attestation } from './Attestation';
 import { Auth } from './Auth';
 import { DeviceDefinitions } from './DeviceDefinitions';
@@ -6,5 +7,5 @@ import { Devices } from './Devices';
 import { TokenExchange } from './TokenExchange';
 import { Trips } from './Trips';
 import { Valuations } from './Valuations';
-import { VehicleEvents } from './VehicleEvents';
-export { Attestation, Auth, DeviceDefinitions, Devices, TokenExchange, Trips, Valuations, VehicleEvents, };
+import { VehicleTriggers } from './VehicleTriggers';
+export { Agents, Attestation, Auth, DeviceDefinitions, Devices, TokenExchange, Trips, Valuations, VehicleTriggers, };

package/dist/api/resources/DimoRestResources.js

@@ -1,4 +1,5 @@
 /** @format */
+import { Agents } from './Agents';
 import { Attestation } from './Attestation';
 import { Auth } from './Auth';
 import { DeviceDefinitions } from './DeviceDefinitions';
@@ -6,5 +7,5 @@ import { Devices } from './Devices';
 import { TokenExchange } from './TokenExchange';
 import { Trips } from './Trips';
 import { Valuations } from './Valuations';
-import { VehicleEvents } from './VehicleEvents';
-export { Attestation, Auth, DeviceDefinitions, Devices, TokenExchange, Trips, Valuations, VehicleEvents, };
+import { VehicleTriggers } from './VehicleTriggers';
+export { Agents, Attestation, Auth, DeviceDefinitions, Devices, TokenExchange, Trips, Valuations, VehicleTriggers, };

package/dist/api/resources/{VehicleEvents → VehicleTriggers}/index.d.ts

@@ -1,7 +1,7 @@
 /** @format */
 import { Resource } from '../../Resource';
 import { DimoEnvironment } from '../../../environments';
-declare class VehicleEvents extends Resource {
+declare class VehicleTriggers extends Resource {
     constructor(api: any, env: keyof typeof DimoEnvironment);
 }
-export { VehicleEvents };
+export { VehicleTriggers };

package/dist/api/resources/{VehicleEvents → VehicleTriggers}/index.js

@@ -1,8 +1,8 @@
 /** @format */
 import { Resource } from '../../Resource';
-class VehicleEvents extends Resource {
+class VehicleTriggers extends Resource {
     constructor(api, env) {
-        super(api, 'VehicleEvents', env);
+        super(api, 'VehicleTriggers', env);
         this.setResource({
             listWebhooks: {
                 method: 'GET',
@@ -14,13 +14,14 @@ class VehicleEvents extends Resource {
                 path: '/v1/webhooks',
                 body: {
                     service: true,
-                    data: true,
-                    trigger: true,
-                    setup: true,
+                    metricName: true,
+                    condition: true,
+                    coolDownPeriod: true,
                     description: false,
-                    target_uri: true,
+                    targetURL: true,
                     status: true,
-                    verification_token: true,
+                    verificationToken: true,
+                    displayName: false
                 },
                 auth: 'developer_jwt',
             },
@@ -28,14 +29,7 @@ class VehicleEvents extends Resource {
                 method: 'PUT',
                 path: '/v1/webhooks/:webhookId',
                 body: {
-                    service: true,
-                    data: true,
-                    trigger: true,
-                    setup: true,
-                    description: false,
-                    target_uri: true,
-                    status: true,
-                    verification_token: true,
+                    request: true
                 },
                 auth: 'developer_jwt',
             },
@@ -56,12 +50,12 @@ class VehicleEvents extends Resource {
             },
             listVehicleSubscriptions: {
                 method: 'GET',
-                path: '/v1/webhooks/vehicles/:tokenId',
+                path: '/v1/webhooks/vehicles/:tokenDID',
                 auth: 'developer_jwt',
             },
             subscribeVehicle: {
                 method: 'POST',
-                path: '/v1/webhooks/:webhookId/subscribe/:tokenId',
+                path: '/v1/webhooks/:webhookId/subscribe/:tokenDID',
                 auth: 'developer_jwt',
             },
             subscribeAllVehicles: {
@@ -71,7 +65,7 @@ class VehicleEvents extends Resource {
             },
             unsubscribeVehicle: {
                 method: 'DELETE',
-                path: '/v1/webhooks/:webhookId/unsubscribe/:tokenId',
+                path: '/v1/webhooks/:webhookId/unsubscribe/:tokenDID',
                 auth: 'developer_jwt',
             },
             unsubscribeAllVehicles: {
@@ -82,4 +76,4 @@ class VehicleEvents extends Resource {
         });
     }
 }
-export { VehicleEvents };
+export { VehicleTriggers };