@salesforce/agents 0.1.2

package/LICENSE.txt

@@ -0,0 +1,12 @@
+Copyright (c) 2024, Salesforce.com, Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+* Neither the name of Salesforce.com nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,13 @@
+# Salesforce Agents - UNDER DEVELOPMENT
+
+### THIS LIBRARY IS UNDER DEVELOPMENT AND IS NOT MEANT FOR PRODUCTION USAGE.
+
+[![NPM](https://img.shields.io/npm/v/@salesforce/agents.svg?label=@salesforce/agents)](https://www.npmjs.com/package/@salesforce/agents) [![Downloads/week](https://img.shields.io/npm/dw/@salesforce/agents.svg)](https://npmjs.org/package/@salesforce/agents) [![License](https://img.shields.io/badge/License-BSD%203--Clause-brightgreen.svg)](https://raw.githubusercontent.com/forcedotcom/agents/main/LICENSE.txt)
+
+## Description
+
+A TypeScript library for working with Salesforce Agents.
+
+## Usage
+
+TBD

package/lib/agent.d.ts

@@ -0,0 +1,18 @@
+import { Connection, SfProject } from '@salesforce/core';
+import { type SfAgent, type AgentCreateConfig, type AgentCreateResponse, type AgentJobSpec, type AgentJobSpecCreateConfig } from './types.js';
+export declare class Agent implements SfAgent {
+    private connection;
+    private project;
+    private logger;
+    private mockDir?;
+    constructor(connection: Connection, project: SfProject);
+    create(config: AgentCreateConfig): Promise<AgentCreateResponse>;
+    /**
+     * Create an agent spec from provided data.
+     *
+     * @param config The configuration used to generate an agent spec.
+     */
+    createSpec(config: AgentJobSpecCreateConfig): Promise<AgentJobSpec>;
+    private verifyAgentSpecConfig;
+    private buildAgentJobSpecUrl;
+}

package/lib/agent.js

@@ -0,0 +1,105 @@
+"use strict";
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = void 0;
+const node_path_1 = require("node:path");
+const node_fs_1 = require("node:fs");
+const node_util_1 = require("node:util");
+const core_1 = require("@salesforce/core");
+const kit_1 = require("@salesforce/kit");
+const mockDir_1 = require("./mockDir");
+class Agent {
+    connection;
+    project;
+    logger;
+    mockDir;
+    constructor(connection, project) {
+        this.connection = connection;
+        this.project = project;
+        this.logger = core_1.Logger.childFromRoot(this.constructor.name);
+        this.mockDir = (0, mockDir_1.getMockDir)();
+    }
+    async create(config) {
+        this.logger.debug(`Creating Agent using config: ${(0, node_util_1.inspect)(config)} in project: ${this.project.getPath()}`);
+        // Generate a GenAiPlanner in the local project and deploy
+        // make API request to /services/data/{api-version}/connect/attach-agent-topics
+        await (0, kit_1.sleep)(kit_1.Duration.seconds(3));
+        // on success, retrieve all Agent metadata
+        return { isSuccess: true };
+    }
+    /**
+     * Create an agent spec from provided data.
+     *
+     * @param config The configuration used to generate an agent spec.
+     */
+    async createSpec(config) {
+        this.verifyAgentSpecConfig(config);
+        let agentSpec;
+        if (this.mockDir) {
+            const specFileName = `${config.name}Spec.json`;
+            const specFilePath = (0, node_path_1.join)(this.mockDir, `${specFileName}`);
+            try {
+                this.logger.debug(`Using mock directory: ${this.mockDir} for agent job spec creation`);
+                (0, node_fs_1.statSync)(specFilePath);
+            }
+            catch (err) {
+                throw core_1.SfError.create({
+                    name: 'MissingMockFile',
+                    message: `SF_MOCK_DIR [${this.mockDir}] must contain a spec file with name ${specFileName}`,
+                    cause: err,
+                });
+            }
+            try {
+                this.logger.debug(`Returning mock agent spec file: ${specFilePath}`);
+                agentSpec = JSON.parse((0, node_fs_1.readFileSync)(specFilePath, 'utf8'));
+            }
+            catch (err) {
+                throw core_1.SfError.create({
+                    name: 'InvalidMockFile',
+                    message: `SF_MOCK_DIR [${this.mockDir}] must contain a valid spec file with name ${specFileName}`,
+                    cause: err,
+                    actions: [
+                        'Check that the file is readable',
+                        'Check that the file is a valid JSON array of jobTitle and jobDescription objects',
+                    ],
+                });
+            }
+        }
+        else {
+            // TODO: We'll probably want to wrap this for better error handling but let's see
+            //       what it looks like first.
+            const response = await this.connection.requestGet(this.buildAgentJobSpecUrl(config), {
+                retry: { maxRetries: 3 },
+            });
+            if (response.isSuccess) {
+                agentSpec = response?.jobSpecs;
+            }
+            else {
+                throw core_1.SfError.create({
+                    name: 'AgentJobSpecCreateError',
+                    message: response.errorMessage ?? 'unknown',
+                });
+            }
+        }
+        return agentSpec;
+    }
+    // eslint-disable-next-line class-methods-use-this
+    verifyAgentSpecConfig(config) {
+        // TBD: for now just return. At some point verify all required config values.
+        if (config)
+            return;
+    }
+    // eslint-disable-next-line class-methods-use-this
+    buildAgentJobSpecUrl(config) {
+        const { type, role, companyName, companyDescription, companyWebsite } = config;
+        const website = companyWebsite ? `&companyWebsite=${companyWebsite}` : '';
+        return `/connect/agent-job-spec?agentType=${type}&role=${role}&companyName=${companyName}&companyDescription=${companyDescription}${website}`;
+    }
+}
+exports.Agent = Agent;
+//# sourceMappingURL=agent.js.map

package/lib/agent.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { AgentCreateConfig, AgentCreateResponse, AgentJobSpec, AgentJobSpecCreateConfig, AgentJobSpecCreateResponse, SfAgent, } from './types';
+export { Agent } from './agent';

package/lib/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = void 0;
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_1.Agent; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAUH,iCAAgC;AAAvB,8FAAA,KAAK,OAAA"}

package/lib/mockDir.d.ts

@@ -0,0 +1,9 @@
+/**
+ * If the `SF_MOCK_DIR` environment variable is set, resolve to an absolue path
+ * and ensure the directory exits, then return the path.
+ *
+ * NOTE: THIS SHOULD BE MOVED TO SOME OTHER LIBRARY LIKE `@salesforce/kit`.
+ *
+ * @returns the absolute path to an existing directory used for mocking behavior
+ */
+export declare const getMockDir: () => string | undefined;

package/lib/mockDir.js

@@ -0,0 +1,48 @@
+"use strict";
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMockDir = void 0;
+const node_path_1 = require("node:path");
+const node_fs_1 = require("node:fs");
+const core_1 = require("@salesforce/core");
+const kit_1 = require("@salesforce/kit");
+/**
+ * If the `SF_MOCK_DIR` environment variable is set, resolve to an absolue path
+ * and ensure the directory exits, then return the path.
+ *
+ * NOTE: THIS SHOULD BE MOVED TO SOME OTHER LIBRARY LIKE `@salesforce/kit`.
+ *
+ * @returns the absolute path to an existing directory used for mocking behavior
+ */
+const getMockDir = () => {
+    const mockDir = kit_1.env.getString('SF_MOCK_DIR');
+    if (mockDir) {
+        let mockDirStat;
+        try {
+            mockDirStat = (0, node_fs_1.statSync)((0, node_path_1.resolve)(mockDir));
+        }
+        catch (err) {
+            throw core_1.SfError.create({
+                name: 'InvalidMockDir',
+                message: `SF_MOCK_DIR [${mockDir}] not found`,
+                cause: err,
+                actions: ['If you\'re trying to mock agent behavior you must create the mock directory and add expected mock files to it.']
+            });
+        }
+        if (!mockDirStat.isDirectory()) {
+            throw core_1.SfError.create({
+                name: 'InvalidMockDir',
+                message: `SF_MOCK_DIR [${mockDir}] is not a directory`,
+                actions: ['If you\'re trying to mock agent behavior you must create the mock directory and add expected mock files to it.']
+            });
+        }
+        return mockDir;
+    }
+};
+exports.getMockDir = getMockDir;
+//# sourceMappingURL=mockDir.js.map

package/lib/mockDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockDir.js","sourceRoot":"","sources":["../src/mockDir.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,yCAAoC;AACpC,qCAA+C;AAC/C,2CAA2C;AAC3C,yCAAsC;AAEtC;;;;;;;GAOG;AACI,MAAM,UAAU,GAAG,GAAuB,EAAE;IACjD,MAAM,OAAO,GAAG,SAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC7C,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,WAAkB,CAAC;QACvB,IAAI,CAAC;YACH,WAAW,GAAG,IAAA,kBAAQ,EAAC,IAAA,mBAAO,EAAC,OAAO,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAO,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,gBAAgB,OAAO,aAAa;gBAC7C,KAAK,EAAE,GAAG;gBACV,OAAO,EAAE,CAAC,gHAAgH,CAAC;aAC5H,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/B,MAAM,cAAO,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,gBAAgB,OAAO,sBAAsB;gBACtD,OAAO,EAAE,CAAC,gHAAgH,CAAC;aAC5H,CAAC,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC,CAAA;AAxBY,QAAA,UAAU,cAwBtB"}

package/lib/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * An agent job spec is a list of job titles and descriptions
+ * to be performed by the agent.
+ */
+export type AgentJobSpec = [
+    {
+        jobTitle: string;
+        jobDescription: string;
+    }
+];
+/**
+ * The parameters used to generate an agent spec.
+ */
+export type AgentJobSpecCreateConfig = {
+    name: string;
+    type: 'customer_facing' | 'employee_facing';
+    role: string;
+    companyName: string;
+    companyDescription: string;
+    companyWebsite?: string;
+};
+/**
+ * The parameters used to generate an agent in an org.
+ *
+ * NOTE: This is likely to change with planned serverside APIs.
+ */
+export type AgentCreateConfig = AgentJobSpecCreateConfig & {
+    jobSpecs: AgentJobSpec;
+};
+/**
+ * An interface for working with Agents.
+ */
+export type SfAgent = {
+    create(config: AgentCreateConfig): Promise<AgentCreateResponse>;
+    createSpec(config: AgentJobSpecCreateConfig): Promise<AgentJobSpec>;
+};
+/**
+ * The response from the `agent-job-spec` API.
+ */
+export type AgentJobSpecCreateResponse = {
+    isSuccess: boolean;
+    errorMessage?: string;
+    jobSpecs?: AgentJobSpec;
+};
+/**
+ * The response from the `attach-agent-topics` API.
+ */
+export type AgentCreateResponse = {
+    isSuccess: boolean;
+    errorMessage?: string;
+};

package/lib/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,171 @@
+{
+  "name": "@salesforce/agents",
+  "description": "Client side APIs for working with Salesforce agents",
+  "version": "0.1.2",
+  "license": "BSD-3-Clause",
+  "author": "Salesforce",
+  "main": "lib/index",
+  "types": "lib/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/forcedotcom/agents.git"
+  },
+  "dependencies": {
+    "@salesforce/core": "^8.5.2",
+    "@salesforce/kit": "^3.2.3"
+  },
+  "devDependencies": {
+    "@salesforce/cli-plugins-testkit": "^5.3.20",
+    "@salesforce/dev-scripts": "^10.2.10",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.5.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "/lib",
+    "/messages"
+  ],
+  "keywords": [
+    "force",
+    "salesforce",
+    "salesforcedx",
+    "sf",
+    "sfdx",
+    "agents",
+    "agentforce",
+    "ai"
+  ],
+  "scripts": {
+    "build": "wireit",
+    "clean": "sf-clean",
+    "clean-all": "sf-clean all",
+    "compile": "wireit",
+    "docs": "sf-docs",
+    "format": "wireit",
+    "link-check": "wireit",
+    "lint": "wireit",
+    "lint-fix": "yarn sf-lint --fix",
+    "postcompile": "tsc -p test",
+    "prepack": "sf-prepack",
+    "prepare": "sf-install",
+    "test": "wireit",
+    "test:nuts": "echo 'No tests to run'",
+    "test:only": "wireit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "wireit": {
+    "build": {
+      "dependencies": [
+        "compile",
+        "lint"
+      ]
+    },
+    "compile": {
+      "command": "tsc -p . --pretty --incremental",
+      "files": [
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        "messages/**"
+      ],
+      "output": [
+        "lib/**",
+        "*.tsbuildinfo"
+      ],
+      "clean": "if-file-deleted"
+    },
+    "format": {
+      "command": "prettier --write \"+(src|test|schemas)/**/*.+(ts|js|json)|command-snapshot.json\"",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        "schemas/**/*.json",
+        "command-snapshot.json",
+        ".prettier*"
+      ],
+      "output": []
+    },
+    "lint": {
+      "command": "eslint src test --color --cache --cache-location .eslintcache",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        "messages/**",
+        "**/.eslint*",
+        "**/tsconfig.json"
+      ],
+      "output": []
+    },
+    "test:compile": {
+      "command": "tsc -p \"./test\" --pretty",
+      "files": [
+        "test/**/*.ts",
+        "**/tsconfig.json"
+      ],
+      "output": []
+    },
+    "test": {
+      "dependencies": [
+        "test:only",
+        "test:compile",
+        "link-check"
+      ]
+    },
+    "test:only": {
+      "command": "nyc mocha \"test/**/*.test.ts\"",
+      "env": {
+        "FORCE_COLOR": "2"
+      },
+      "files": [
+        "test/**/*.ts",
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        ".mocha*",
+        "!*.nut.ts",
+        ".nycrc"
+      ],
+      "output": []
+    },
+    "test:command-reference": {
+      "command": "node --loader ts-node/esm --no-warnings=ExperimentalWarning \"./bin/dev.js\" commandreference:generate --erroronwarnings",
+      "files": [
+        "src/**/*.ts",
+        "messages/**",
+        "package.json"
+      ],
+      "output": [
+        "tmp/root"
+      ]
+    },
+    "test:deprecation-policy": {
+      "command": "node --loader ts-node/esm --no-warnings=ExperimentalWarning \"./bin/dev.js\" snapshot:compare",
+      "files": [
+        "src/**/*.ts"
+      ],
+      "output": [],
+      "dependencies": [
+        "compile"
+      ]
+    },
+    "test:json-schema": {
+      "command": "node --loader ts-node/esm --no-warnings=ExperimentalWarning \"./bin/dev.js\" schema:compare",
+      "files": [
+        "src/**/*.ts",
+        "schemas"
+      ],
+      "output": []
+    },
+    "link-check": {
+      "command": "node -e \"process.exit(process.env.CI ? 0 : 1)\" || linkinator \"**/*.md\" --skip \"CHANGELOG.md|node_modules|test/|confluence.internal.salesforce.com|my.salesforce.com|%s\" --markdown --retry --directory-listing --verbosity error",
+      "files": [
+        "./*.md",
+        "./!(CHANGELOG).md",
+        "messages/**/*.md"
+      ],
+      "output": []
+    }
+  }
+}