@or-sdk/agents 1.12.0-beta.2534.0 → 1.12.0-beta.2550.0

package/README.md

@@ -134,4 +134,87 @@ await agents.deleteAgent('agent-id');
 
 **Note:** Deleting an agent is a permanent operation, and the removed data cannot be recovered. Be cautious when using this method and ensure you have backups of your data if necessary.
 
+### `setAgentAction`
+Set an action for an agent.
+
+#### Params
+- `agentId`: `string` - The ID of the agent for which to set the action.
+- `params`: `AgentAction` - An object containing the properties of the action to set.
+
+#### Example
+```typescript
+const actionParams = {
+  kind: ActionKind.Mutation,
+  name: 'updateStatus',
+  description: 'Updates the status of an item',
+  typeDefs: `
+  input UpdateStatusInput {
+    id: ID!
+    status: String!
+  }
+
+  type UpdateStatusResult {
+    id: ID!
+    status: String!
+  }`,
+  examples: [
+    {
+      description: 'Update the status of item 123 to "processed"',
+      activities: [
+        {
+          kind: ActivityKind.Action,
+          input: 'updateStatus(input: { id: "123", status: "processed" })',
+        },
+      ],
+    },
+  ],
+};
+const setActionResponse = await agents.setAgentAction('agent-id', actionParams);
+
+// Example response
+{
+  kind: ActionKind.Mutation,
+  name: 'updateStatus',
+  description: 'Updates the status of an item',
+  typeDefs: `
+  input UpdateStatusInput {
+    id: ID!
+    status: String!
+  }
+
+  type UpdateStatusResult {
+    id: ID!
+    status: String!
+  }`,
+  examples: [
+    {
+      description: 'Update the status of item 123 to "processed"',
+      activities: [
+        {
+          kind: ActivityKind.Action,
+          input: 'updateStatus(input: { id: "123", status: "processed" })',
+        },
+      ],
+    },
+  ],
+}
+```
+
+**Note:** Setting an agent action allows you to define custom behaviors and operations that the agent can perform. Ensure that the `typeDefs` and `examples` are correctly defined to match the intended functionality of the action.
+
+### `deleteAgentAction`
+Delete a specific action of an agent.
+
+#### Params
+- `agentId`: `string` - The ID of the agent whose action is to be deleted.
+- `actionName`: `string` - The name of the action to delete.
+
+#### Example
+```typescript
+typescript
+const actionName = 'updateStatus';
+await agents.deleteAgentAction('agent-id', actionName);
+// No direct response, the action is deleted
+```
+
 This documentation update provides a basic overview of the `@or-sdk/agents` package, including installation, usage, and examples for the main methods available in the Agents class. Additional methods and their usage can be added following the same structure.

package/dist/cjs/Agents.js

@@ -169,6 +169,34 @@ var Agents = (function (_super) {
             });
         });
     };
+    Agents.prototype.setAgentAction = function (agentId, params, options) {
+        if (options === void 0) { options = {}; }
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4, this.makeRequest(__assign({ method: 'PUT', route: "agents/".concat(agentId, "/actions/").concat(params.name), data: params }, options))];
+                    case 1:
+                        response = _a.sent();
+                        return [2, response];
+                }
+            });
+        });
+    };
+    Agents.prototype.deleteAgentAction = function (agentId, actionName, options) {
+        if (options === void 0) { options = {}; }
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4, this.makeRequest(__assign({ method: 'DELETE', route: "agents/".concat(agentId, "/actions/").concat(actionName) }, options))];
+                    case 1:
+                        response = _a.sent();
+                        return [2, response];
+                }
+            });
+        });
+    };
     return Agents;
 }(base_1.Base));
 exports.Agents = Agents;

package/dist/cjs/Agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"Agents.js","sourceRoot":"","sources":["../../src/Agents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Agents.js","sourceRoot":"","sources":["../../src/Agents.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types.js

@@ -1,3 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionKind = exports.ActivityKind = void 0;
+var ActivityKind;
+(function (ActivityKind) {
+    ActivityKind["Observation"] = "Observation";
+    ActivityKind["Thought"] = "Thought";
+    ActivityKind["Action"] = "Action";
+})(ActivityKind = exports.ActivityKind || (exports.ActivityKind = {}));
+var ActionKind;
+(function (ActionKind) {
+    ActionKind["Query"] = "Query";
+    ActionKind["Mutation"] = "Mutation";
+})(ActionKind = exports.ActionKind || (exports.ActionKind = {}));
 //# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;;AAMA,IAAY,YAOX;AAPD,WAAY,YAAY;IAEtB,2CAA2B,CAAA;IAE3B,mCAAmB,CAAA;IAEnB,iCAAiB,CAAA;AACnB,CAAC,EAPW,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QAOvB;AAKD,IAAY,UAMX;AAND,WAAY,UAAU;IAEpB,6BAAe,CAAA;IAGf,mCAAqB,CAAA;AACvB,CAAC,EANW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAMrB"}

package/dist/esm/Agents.js

@@ -67,5 +67,17 @@ export class Agents extends Base {
             return response;
         });
     }
+    setAgentAction(agentId, params, options = {}) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.makeRequest(Object.assign({ method: 'PUT', route: `agents/${agentId}/actions/${params.name}`, data: params }, options));
+            return response;
+        });
+    }
+    deleteAgentAction(agentId, actionName, options = {}) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.makeRequest(Object.assign({ method: 'DELETE', route: `agents/${agentId}/actions/${actionName}` }, options));
+            return response;
+        });
+    }
 }
 //# sourceMappingURL=Agents.js.map

package/dist/esm/Agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"Agents.js","sourceRoot":"","sources":["../../src/Agents.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,IAAI,EAAsB,QAAQ,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,GAAG,iBAAiB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAExD,MAAM,OAAO,MAAO,SAAQ,IAAI;IAG9B,YAAY,MAAoB;QAC9B,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC;QAElF,KAAK,CAAC;YACJ,KAAK;YACL,YAAY;YACZ,UAAU,EAAE,WAAW;YACvB,SAAS;YACT,UAAU;YACV,OAAO;YACP,oBAAoB,EAAE,IAAI;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAEa,WAAW,CAAI,MAAoB;;YAC/C,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE;gBAC/C,MAAM,CAAC,MAAM,KAAb,MAAM,CAAC,MAAM,GAAK,EAAE,EAAC;gBAEpB,MAAM,CAAC,MAAc,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;aAChD;YAED,OAAO,IAAI,CAAC,SAAS,CAAI,MAAM,CAAC,CAAC;QACnC,CAAC;KAAA;IAED,UAAU,CAAC,GAAY;QACrB,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAQK,WAAW,CAAC,MAAmB,EAAE,UAAuB,EAAE;;YAC9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,MAAM,IACT,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IAQK,UAAU,CAAC,SAA4B,EAAE,EAAE,UAAuB,EAAE;;YACxE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,KAAK,EACb,KAAK,EAAE,QAAQ,EACf,MAAM,IACH,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;KAAA;IAQK,QAAQ,CAAC,OAAe,EAAE,UAAuB,EAAE;;YACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,KAAK,EACb,KAAK,EAAE,UAAU,OAAO,EAAE,IACvB,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IASK,WAAW,CAAC,OAAe,EAAE,MAAmB,EAAE,UAAuB,EAAE;;YAC/E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,KAAK,EACb,KAAK,EAAE,UAAU,OAAO,EAAE,EAC1B,IAAI,EAAE,MAAM,IACT,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IAQK,WAAW,CAAC,OAAe,EAAE,UAAuB,EAAE;;YAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,OAAO,EAAE,IACvB,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;CACF"}
+{"version":3,"file":"Agents.js","sourceRoot":"","sources":["../../src/Agents.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,IAAI,EAAsB,QAAQ,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,GAAG,iBAAiB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAExD,MAAM,OAAO,MAAO,SAAQ,IAAI;IAG9B,YAAY,MAAoB;QAC9B,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC;QAElF,KAAK,CAAC;YACJ,KAAK;YACL,YAAY;YACZ,UAAU,EAAE,WAAW;YACvB,SAAS;YACT,UAAU;YACV,OAAO;YACP,oBAAoB,EAAE,IAAI;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAEa,WAAW,CAAI,MAAoB;;YAC/C,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE;gBAC/C,MAAM,CAAC,MAAM,KAAb,MAAM,CAAC,MAAM,GAAK,EAAE,EAAC;gBAEpB,MAAM,CAAC,MAAc,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;aAChD;YAED,OAAO,IAAI,CAAC,SAAS,CAAI,MAAM,CAAC,CAAC;QACnC,CAAC;KAAA;IAED,UAAU,CAAC,GAAY;QACrB,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAQK,WAAW,CAAC,MAAmB,EAAE,UAAuB,EAAE;;YAC9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,MAAM,IACT,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IAQK,UAAU,CAAC,SAA4B,EAAE,EAAE,UAAuB,EAAE;;YACxE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,KAAK,EACb,KAAK,EAAE,QAAQ,EACf,MAAM,IACH,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;KAAA;IAQK,QAAQ,CAAC,OAAe,EAAE,UAAuB,EAAE;;YACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,KAAK,EACb,KAAK,EAAE,UAAU,OAAO,EAAE,IACvB,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IASK,WAAW,CAAC,OAAe,EAAE,MAAmB,EAAE,UAAuB,EAAE;;YAC/E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,KAAK,EACb,KAAK,EAAE,UAAU,OAAO,EAAE,EAC1B,IAAI,EAAE,MAAM,IACT,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IAQK,WAAW,CAAC,OAAe,EAAE,UAAuB,EAAE;;YAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,OAAO,EAAE,IACvB,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IASK,cAAc,CAAC,OAAe,EAAE,MAAmB,EAAE,UAAuB,EAAE;;YAClF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,KAAK,EACb,KAAK,EAAE,UAAU,OAAO,YAAY,MAAM,CAAC,IAAI,EAAE,EACjD,IAAI,EAAE,MAAM,IACT,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;IASK,iBAAiB,CAAC,OAAe,EAAE,UAAkB,EAAE,UAAuB,EAAE;;YACpF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,iBACrC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,OAAO,YAAY,UAAU,EAAE,IAC7C,OAAO,EACV,CAAC;YAEH,OAAO,QAAQ,CAAC;QAClB,CAAC;KAAA;CACF"}

package/dist/esm/types.js

@@ -1,2 +1,12 @@
-export {};
+export var ActivityKind;
+(function (ActivityKind) {
+    ActivityKind["Observation"] = "Observation";
+    ActivityKind["Thought"] = "Thought";
+    ActivityKind["Action"] = "Action";
+})(ActivityKind || (ActivityKind = {}));
+export var ActionKind;
+(function (ActionKind) {
+    ActionKind["Query"] = "Query";
+    ActionKind["Mutation"] = "Mutation";
+})(ActionKind || (ActionKind = {}));
 //# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IAEtB,2CAA2B,CAAA;IAE3B,mCAAmB,CAAA;IAEnB,iCAAiB,CAAA;AACnB,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAKD,MAAM,CAAN,IAAY,UAMX;AAND,WAAY,UAAU;IAEpB,6BAAe,CAAA;IAGf,mCAAqB,CAAA;AACvB,CAAC,EANW,UAAU,KAAV,UAAU,QAMrB"}

package/dist/types/Agents.d.ts

@@ -1,5 +1,5 @@
 import { Base, List } from '@or-sdk/base';
-import { Agent, CreateAgent, UpdateAgent, FindAgentsOptions, CallOptions, AgentsConfig } from './types';
+import { Agent, CreateAgent, UpdateAgent, FindAgentsOptions, CallOptions, AgentsConfig, AgentAction } from './types';
 export declare class Agents extends Base {
     private readonly _feature;
     constructor(params: AgentsConfig);
@@ -10,5 +10,7 @@ export declare class Agents extends Base {
     getAgent(agentId: string, options?: CallOptions): Promise<Agent>;
     updateAgent(agentId: string, params: UpdateAgent, options?: CallOptions): Promise<Agent>;
     deleteAgent(agentId: string, options?: CallOptions): Promise<Agent>;
+    setAgentAction(agentId: string, params: AgentAction, options?: CallOptions): Promise<AgentAction>;
+    deleteAgentAction(agentId: string, actionName: string, options?: CallOptions): Promise<AgentAction>;
 }
 //# sourceMappingURL=Agents.d.ts.map

package/dist/types/Agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Agents.d.ts","sourceRoot":"","sources":["../../src/Agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,IAAI,EAAY,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAKxG,qBAAa,MAAO,SAAQ,IAAI;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,MAAM,EAAE,YAAY;YAgBlB,WAAW;IAUzB,UAAU,CAAC,GAAG,EAAE,OAAO;IAUjB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAiB3E,UAAU,CAAC,MAAM,GAAE,iBAAsB,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAiB3F,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAiBpE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAiB5F,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;CAS9E"}
+{"version":3,"file":"Agents.d.ts","sourceRoot":"","sources":["../../src/Agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,IAAI,EAAY,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKrH,qBAAa,MAAO,SAAQ,IAAI;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,MAAM,EAAE,YAAY;YAgBlB,WAAW;IAUzB,UAAU,CAAC,GAAG,EAAE,OAAO;IAUjB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAiB3E,UAAU,CAAC,MAAM,GAAE,iBAAsB,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAiB3F,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAiBpE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAiB5F,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAiBvE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBrG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;CAS9G"}

package/dist/types/types.d.ts

@@ -1,5 +1,14 @@
 import { OrderDirection, Token } from '@or-sdk/base';
 import type { SearchMode } from '@or-sdk/lookup';
+export declare enum ActivityKind {
+    Observation = "Observation",
+    Thought = "Thought",
+    Action = "Action"
+}
+export declare enum ActionKind {
+    Query = "Query",
+    Mutation = "Mutation"
+}
 export type CallOptions = {
     signal?: AbortSignal;
 };
@@ -17,33 +26,37 @@ export type AgentModelOptions = {
     presencePenalty?: number;
     modelName?: string;
 };
-export type CreateAgent = {
-    name: string;
-    description?: string;
-    typeDefs?: string;
-    objective?: string;
-    image?: string;
-    model?: AgentModelOptions;
+export type AgentActivity = {
+    kind: ActivityKind;
+    input: string;
 };
-export type UpdateAgent = {
-    description?: string;
-    image?: string;
-    typeDefs?: string;
-    objective?: string;
-    model?: AgentModelOptions;
+export type ActionExample = {
+    description: string;
+    activities: AgentActivity[];
+};
+export type AgentAction = {
+    kind: ActionKind;
+    name: string;
+    description: string;
+    typeDefs: string;
+    examples?: ActionExample[];
 };
 export type Agent = {
     id: string;
     accountId: string;
     name: string;
     description?: string;
-    image?: string;
-    typeDefs?: string;
-    objective?: string;
-    model?: AgentModelOptions;
+    image: string;
+    actions: AgentAction[];
+    typeDefs: string;
+    objective: string;
+    model: AgentModelOptions;
     createdAt: string | Date;
     updatedAt: string | Date;
+    primer: AgentActivity[];
 };
+export type UpdateAgent = Partial<Omit<Agent, 'id' | 'createdAt' | 'updatedAt' | 'name' | 'accountId' | 'typeDefs'>>;
+export type CreateAgent = Omit<Agent, 'id' | 'createdAt' | 'updatedAt' | 'accountId' | 'typeDefs'>;
 export type FindAgentsOptions = {
     from?: number;
     size?: number;

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAIzB,KAAK,EAAE,KAAK,CAAC;IAKb,YAAY,CAAC,EAAE,MAAM,CAAC;IAKtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAKpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAI9B,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,eAAe,CAAC,EAAE,MAAM,CAAC;IAKzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAKxB,IAAI,EAAE,MAAM,CAAC;IAKb,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAIxB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAIlB,EAAE,EAAE,MAAM,CAAC;IAKX,SAAS,EAAE,MAAM,CAAC;IAMlB,IAAI,EAAE,MAAM,CAAC;IAKb,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAK1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAKzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAI9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,IAAI,CAAC,EAAE,UAAU,CAAC;IAKlB,aAAa,CAAC,EAAE,MAAM,CAAC;IAKvB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKjD,oBAAY,YAAY;IAEtB,WAAW,gBAAgB;IAE3B,OAAO,YAAY;IAEnB,MAAM,WAAW;CAClB;AAKD,oBAAY,UAAU;IAEpB,KAAK,UAAU;IAGf,QAAQ,aAAa;CACtB;AAKD,MAAM,MAAM,WAAW,GAAG;IAIxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAKF,MAAM,MAAM,YAAY,GAAG;IAIzB,KAAK,EAAE,KAAK,CAAC;IAKb,YAAY,CAAC,EAAE,MAAM,CAAC;IAKtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAKpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAKF,MAAM,MAAM,iBAAiB,GAAG;IAI9B,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,eAAe,CAAC,EAAE,MAAM,CAAC;IAKzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAKF,MAAM,MAAM,aAAa,GAAG;IAI1B,IAAI,EAAE,YAAY,CAAC;IAKnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAKF,MAAM,MAAM,aAAa,GAAG;IAI1B,WAAW,EAAE,MAAM,CAAC;IAKpB,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B,CAAC;AAKF,MAAM,MAAM,WAAW,GAAG;IAIxB,IAAI,EAAE,UAAU,CAAC;IAKjB,IAAI,EAAE,MAAM,CAAC;IAKb,WAAW,EAAE,MAAM,CAAC;IAKpB,QAAQ,EAAE,MAAM,CAAC;IAKjB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B,CAAC;AAKF,MAAM,MAAM,KAAK,GAAG;IAIlB,EAAE,EAAE,MAAM,CAAC;IAKX,SAAS,EAAE,MAAM,CAAC;IAKlB,IAAI,EAAE,MAAM,CAAC;IAKb,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,KAAK,EAAE,MAAM,CAAC;IAKd,OAAO,EAAE,WAAW,EAAE,CAAC;IAKvB,QAAQ,EAAE,MAAM,CAAC;IAKjB,SAAS,EAAE,MAAM,CAAC;IAKlB,KAAK,EAAE,iBAAiB,CAAC;IAKzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAKzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAKzB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB,CAAC;AAKF,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC;AAKrH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC;AAKnG,MAAM,MAAM,iBAAiB,GAAG;IAI9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,IAAI,CAAC,EAAE,UAAU,CAAC;IAKlB,aAAa,CAAC,EAAE,MAAM,CAAC;IAKvB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@or-sdk/agents",
-  "version": "1.12.0-beta.2534.0",
+  "version": "1.12.0-beta.2550.0",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -20,12 +20,19 @@
     "test:watch": "vitest --watch"
   },
   "dependencies": {
+    "@graphql-tools/merge": "^9.0.3",
+    "@graphql-tools/schema": "^10.0.3",
     "@or-sdk/base": "^0.34.1",
-    "lodash": "^4.17.21"
+    "dedent": "^1.5.1",
+    "graphql": "^16.8.1",
+    "graphql-tag": "^2.12.6",
+    "lodash": "^4.17.21",
+    "lodash.camelcase": "^4.3.0"
   },
   "devDependencies": {
     "@or-sdk/lookup": "^1.0.0",
     "@types/lodash": "^4.14.176",
+    "@types/lodash.camelcase": "^4.3.9",
     "@vitest/coverage-c8": "^0.31.1",
     "concurrently": "^6.4.0",
     "msw": "^1.2.1",

package/src/Agents.ts

@@ -1,6 +1,6 @@
 import { Base, CalApiParams, List, makeList } from '@or-sdk/base';
 import { SERVICE_KEY } from './constants';
-import { Agent, CreateAgent, UpdateAgent, FindAgentsOptions, CallOptions, AgentsConfig } from './types';
+import { Agent, CreateAgent, UpdateAgent, FindAgentsOptions, CallOptions, AgentsConfig, AgentAction } from './types';
 import { createErrorParser, processors } from './error-parser';
 
 const errorParser = createErrorParser(processors.AXIOS);
@@ -121,5 +121,40 @@ export class Agents extends Base {
 
     return response;
   }
+
+  /**
+   * Set an agent action.
+   * @param agentId - The ID of the agent to delete.
+   * @param params - Set action params.
+   * @param options - The API call options.
+   * @returns The deleted agent.
+   */
+  async setAgentAction(agentId: string, params: AgentAction, options: CallOptions = {}): Promise<AgentAction> {
+    const response = await this.makeRequest<AgentAction>({
+      method: 'PUT',
+      route: `agents/${agentId}/actions/${params.name}`,
+      data: params,
+      ...options,
+    });
+
+    return response;
+  }
+
+  /**
+   * Delete an agent action.
+   * @param agentId - The ID of the agent to delete.
+   * @param actionName - Set action params.
+   * @param options - The API call options.
+   * @returns The deleted agent.
+   */
+  async deleteAgentAction(agentId: string, actionName: string, options: CallOptions = {}): Promise<AgentAction> {
+    const response = await this.makeRequest<AgentAction>({
+      method: 'DELETE',
+      route: `agents/${agentId}/actions/${actionName}`,
+      ...options,
+    });
+
+    return response;
+  }
 }
 

package/src/types.ts

@@ -1,205 +1,265 @@
 import { OrderDirection, Token } from '@or-sdk/base';
 import type { SearchMode } from '@or-sdk/lookup';
 
+/**
+ * Enum representing the kinds of activities that an agent can perform.
+ */
+export enum ActivityKind {
+  /** An observation made by the agent. */
+  Observation = 'Observation',
+  /** A thought process of the agent. */
+  Thought = 'Thought',
+  /** An action taken by the agent. */
+  Action = 'Action',
+}
+
+/**
+ * Enum representing the kinds of action that an agent can take.
+ */
+export enum ActionKind {
+  /** Query is an action to read or fetch data. */
+  Query = 'Query',
+
+  /** Mutation is an action to create, update, or delete data. */
+  Mutation = 'Mutation',
+}
+
+/**
+ * Defines call options for asynchronous operations, including the ability to cancel them.
+ */
 export type CallOptions = {
+  /**
+   * An optional AbortSignal to cancel the request.
+   */
   signal?: AbortSignal;
 };
 
+/**
+ * Configuration options required for initializing agents, including authentication and service URLs.
+ */
 export type AgentsConfig = {
   /**
-   * token
+   * Authentication token for service access.
    */
   token: Token;
 
   /**
-   * Url of OneReach service discovery api
+   * Optional URL for the OneReach service discovery API.
    */
   discoveryUrl?: string;
 
   /**
-   * Account ID for cross-account requests (super admin only)
+   * Optional account ID for making cross-account requests. This is typically required for super admin users.
    */
   accountId?: string;
 
   /**
-   * Url of OneReach lookup api
+   * Optional URL of the OneReach lookup API.
    */
   serviceUrl?: string;
 
   /**
-   * Feature name, default: 'master'
+   * Optional feature name for the agent. Defaults to 'master' if not provided.
    */
   feature?: string;
 };
 
+/**
+ * Options for configuring the behavior and output of the agent's underlying language model.
+ */
 export type AgentModelOptions = {
   /**
-   * What sampling temperature to use.
+   * Controls the randomness of the output. Higher values may lead to more creative responses.
    */
   temperature?: number;
 
   /**
-   * Max output length from the LLM.
+   * The maximum length of the output generated by the language model.
    */
   maxTokens?: number;
 
   /**
-   * Positive values penalize new tokens based on their existing frequency in the text so far.
+   * Adjusts the likelihood of the model repeating the same line of thinking.
    */
   frequencyPenalty?: number;
 
   /**
-   * Penalize new tokens based on whether they appear in the text so far.
+   * Discourages the model from using tokens already present in the text.
    */
   presencePenalty?: number;
 
   /**
-   * Large language model name.
+   * Specifies the name of the large language model to use.
    */
   modelName?: string;
 };
 
-export type CreateAgent = {
+/**
+ * Represents an activity performed by the agent, such as an observation, thought, or action.
+ */
+export type AgentActivity = {
   /**
-   * Agent name
-   * Can start only with a capital letter.
+   * The type of activity performed.
    */
-  name: string;
+  kind: ActivityKind;
 
   /**
-   * Agent description
+   * The input data or content related to the activity.
    */
-  description?: string;
-
-  /**
-   * A GraphQL type definitions document.
-   */
-  typeDefs?: string;
-
-  /**
-   * The objective or goal the agent is trying to achieve.
-   */
-  objective?: string;
+  input: string;
+};
 
+/**
+ * Describes an example of how an agent action could be used, including a description and relevant activities.
+ */
+export type ActionExample = {
   /**
-   * A agent thumbnail image URL.
+   * A brief description of what the example demonstrates.
    */
-  image?: string;
+  description: string;
 
   /**
-   * Model options for the agent.
+   * A series of activities associated with the example.
    */
-  model?: AgentModelOptions;
+  activities: AgentActivity[];
 };
 
-export type UpdateAgent = {
+/**
+ * Defines an action that an agent can perform, including querying and mutation operations.
+ */
+export type AgentAction = {
   /**
-   * Agent description
+   * The category of action, such as a query or mutation.
    */
-  description?: string;
+  kind: ActionKind;
 
   /**
-   * A agent thumbnail image URL.
+   * The name of the action.
    */
-  image?: string;
+  name: string;
 
   /**
-   * A GraphQL type definitions document.
+   * A detailed description of the action.
    */
-  typeDefs?: string;
+  description: string;
 
   /**
-   * The objective or goal the agent is trying to achieve.
+   * The type definitions associated with the action, described in a schema language.
    */
-  objective?: string;
+  typeDefs: string;
 
   /**
-   * Model options for the agent.
+   * Optional examples that illustrate how the action can be used.
    */
-  model?: AgentModelOptions;
+  examples?: ActionExample[];
 };
 
+/**
+ * Represents a digital agent capable of performing actions and processing information based on a given model.
+ */
 export type Agent = {
   /**
-   * Agent ID
+   * Unique identifier for the agent.
    */
   id: string;
 
   /**
-   * Account ID
+   * The account ID associated with the agent.
    */
   accountId: string;
 
   /**
-   * Agent name
-   * Can start only with a capital letter.
+   * The name of the agent, which must start with a capital letter.
    */
   name: string;
 
   /**
-   * Agent description
+   * Optional description of the agent's purpose and capabilities.
    */
   description?: string;
 
   /**
-   * Agent image URL.
+   * URL to an image representing the agent.
+   */
+  image: string;
+
+  /**
+   * A list of actions the agent is capable of performing.
    */
-  image?: string;
+  actions: AgentAction[];
 
   /**
-   * A GraphQL type definitions document.
+   * The readonly definitions associated with the all the actions, described in a schema language.
    */
-  typeDefs?: string;
+  typeDefs: string;
 
   /**
-   * The objective or goal the agent is trying to achieve.
+   * A description of the objective or goal the agent is designed to achieve.
    */
-  objective?: string;
+  objective: string;
 
   /**
-   * Model options for the agent.
+   * Configuration options for the agent's model, affecting performance and output.
    */
-  model?: AgentModelOptions;
+  model: AgentModelOptions;
 
   /**
-   * Creation Date
+   * The date and time when the agent was created.
    */
   createdAt: string | Date;
 
   /**
-   * Updating Date
+   * The date and time when the agent was last updated.
    */
   updatedAt: string | Date;
+
+  /**
+   * A primer of historical interactions or activities for the agent, which can influence its behavior.
+   */
+  primer: AgentActivity[];
 };
 
+/**
+ * Defines the properties that can be modified when updating an existing agent.
+ */
+export type UpdateAgent = Partial<Omit<Agent, 'id' | 'createdAt' | 'updatedAt' | 'name' | 'accountId' | 'typeDefs'>>;
+
+/**
+ * Defines the properties required to create a new agent, excluding those automatically assigned upon creation.
+ */
+export type CreateAgent = Omit<Agent, 'id' | 'createdAt' | 'updatedAt' | 'accountId' | 'typeDefs'>;
+
+/**
+ * Options for querying the list of agents, including search parameters and pagination controls.
+ */
 export type FindAgentsOptions = {
   /**
-   * Start pagination from
+   * Pagination offset for retrieving a subset of agents.
    */
   from?: number;
 
   /**
-   * Page size for pagination
+   * Maximum number of agents to retrieve per page.
    */
   size?: number;
 
   /**
-   * Search query
+   * Text query for searching agents by name, description, or other attributes.
    */
   query?: string;
 
   /**
-   * Search mode
+   * Mode of the search, affecting the specificity and type of matching.
    */
   mode?: SearchMode;
 
   /**
-   * Property name to order by
+   * The property name by which to order the results.
    */
   orderProperty?: string;
 
   /**
-   * Order direction
+   * The direction in which to order the results, either ascending or descending.
    */
   orderDirection?: OrderDirection;
 };