@salesforce/plugin-agent 1.35.0 → 1.36.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/README.md +67 -25
  2. package/lib/agentTestCache.d.ts +4 -1
  3. package/lib/agentTestCache.js +2 -2
  4. package/lib/agentTestCache.js.map +1 -1
  5. package/lib/commands/agent/publish/authoring-bundle.d.ts +8 -0
  6. package/lib/commands/agent/publish/authoring-bundle.js +51 -0
  7. package/lib/commands/agent/publish/authoring-bundle.js.map +1 -1
  8. package/lib/commands/agent/test/list.js +6 -1
  9. package/lib/commands/agent/test/list.js.map +1 -1
  10. package/lib/commands/agent/test/results.d.ts +3 -2
  11. package/lib/commands/agent/test/results.js +5 -3
  12. package/lib/commands/agent/test/results.js.map +1 -1
  13. package/lib/commands/agent/test/resume.d.ts +1 -0
  14. package/lib/commands/agent/test/resume.js +12 -4
  15. package/lib/commands/agent/test/resume.js.map +1 -1
  16. package/lib/commands/agent/test/run.d.ts +1 -0
  17. package/lib/commands/agent/test/run.js +21 -8
  18. package/lib/commands/agent/test/run.js.map +1 -1
  19. package/lib/flags.d.ts +6 -1
  20. package/lib/flags.js +21 -4
  21. package/lib/flags.js.map +1 -1
  22. package/lib/handleTestResults.d.ts +4 -2
  23. package/lib/handleTestResults.js +137 -5
  24. package/lib/handleTestResults.js.map +1 -1
  25. package/lib/testRunnerFactory.d.ts +7 -0
  26. package/lib/testRunnerFactory.js +30 -0
  27. package/lib/testRunnerFactory.js.map +1 -0
  28. package/lib/testStages.d.ts +4 -3
  29. package/lib/testStages.js.map +1 -1
  30. package/messages/agent.publish.authoring-bundle.md +16 -0
  31. package/messages/agent.test.list.md +1 -1
  32. package/messages/shared.md +8 -0
  33. package/oclif.manifest.json +60 -3
  34. package/package.json +5 -5
  35. package/schemas/agent-activate.json +5 -2
  36. package/schemas/agent-create.json +39 -8
  37. package/schemas/agent-deactivate.json +5 -2
  38. package/schemas/agent-generate-agent__spec.json +18 -4
  39. package/schemas/agent-generate-authoring__bundle.json +6 -2
  40. package/schemas/agent-generate-template.json +5 -2
  41. package/schemas/agent-preview-end.json +5 -2
  42. package/schemas/agent-preview-send.json +6 -2
  43. package/schemas/agent-preview-sessions.json +10 -3
  44. package/schemas/agent-preview-start.json +5 -2
  45. package/schemas/agent-preview.json +1 -1
  46. package/schemas/agent-publish-authoring__bundle.json +25 -0
  47. package/schemas/agent-test-create.json +5 -2
  48. package/schemas/agent-test-list.json +1 -1
  49. package/schemas/agent-test-results.json +111 -10
  50. package/schemas/agent-test-resume.json +113 -10
  51. package/schemas/agent-test-run.json +113 -10
  52. package/schemas/agent-test-run__eval.json +17 -4
  53. package/schemas/agent-validate-authoring__bundle.json +4 -2
@@ -1,5 +1,6 @@
1
- import { AgentTestResultsResponse, AgentTester } from '@salesforce/agents';
1
+ import { AgentTestResultsResponse, AgentforceStudioTestResultsResponse } from '@salesforce/agents';
2
2
  import { Duration } from '@salesforce/kit';
3
+ import type { TestRunnerInstance } from './testRunnerFactory.js';
3
4
  type Data = {
4
5
  id: string;
5
6
  status: string;
@@ -15,9 +16,9 @@ export declare class TestStages {
15
16
  jsonEnabled: boolean;
16
17
  });
17
18
  start(data?: Partial<Data>): void;
18
- poll(agentTester: AgentTester, id: string, wait: Duration): Promise<{
19
+ poll(agentTester: TestRunnerInstance, id: string, wait: Duration): Promise<{
19
20
  completed: boolean;
20
- response?: AgentTestResultsResponse;
21
+ response?: AgentTestResultsResponse | AgentforceStudioTestResultsResponse;
21
22
  }>;
22
23
  update(data: Partial<Data>): void;
23
24
  stop(finalStatus?: 'async'): void;
@@ -1 +1 @@
1
- {"version":3,"file":"testStages.js","sourceRoot":"","sources":["../src/testStages.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"testStages.js","sourceRoot":"","sources":["../src/testStages.ts"],"names":[],"mappings":"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"}
@@ -20,6 +20,14 @@ This command uses the API name of the authoring bundle.
20
20
 
21
21
  <%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --target-org my-dev-org
22
22
 
23
+ - Publish with verbose output to see all retrieved and deployed metadata components:
24
+
25
+ <%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --verbose
26
+
27
+ - Publish with concise output showing only essential information:
28
+
29
+ <%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --concise
30
+
23
31
  # flags.api-name.summary
24
32
 
25
33
  API name of the authoring bundle you want to publish; if not specified, the command provides a list that you can choose from.
@@ -32,6 +40,14 @@ API name of the authoring bundle to publish
32
40
 
33
41
  Don't retrieve the metadata associated with the agent to your DX project.
34
42
 
43
+ # flags.verbose.summary
44
+
45
+ Display detailed output showing all metadata components retrieved and deployed during the publish process.
46
+
47
+ # flags.concise.summary
48
+
49
+ Display minimal output with only essential information about the publish operation.
50
+
35
51
  # error.missingRequiredFlags
36
52
 
37
53
  Required flag(s) missing: %s.
@@ -4,7 +4,7 @@ List the available agent tests in your org.
4
4
 
5
5
  # description
6
6
 
7
- The command outputs a table with the name (API name) of each test along with its unique ID and the date it was created in the org.
7
+ The command outputs a table with the name (API name) of each test along with its unique ID, type ('agentforce-studio' or 'testing-center'), and the date it was created in the org.
8
8
 
9
9
  # examples
10
10
 
@@ -20,6 +20,14 @@ When enabled, includes detailed generated data (such as invoked actions) in the
20
20
 
21
21
  The generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations.
22
22
 
23
+ # flags.test-runner.summary
24
+
25
+ Explicitly specify which test runner to use (agentforce-studio or testing-center).
26
+
27
+ # flags.test-runner.description
28
+
29
+ By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.
30
+
23
31
  # error.invalidAgentType
24
32
 
25
33
  agentType must be either "customer" or "internal". Found: [%s]
@@ -1352,7 +1352,9 @@
1352
1352
  "description": "An authoring bundle is a metadata type (named aiAuthoringBundle) that provides the blueprint for an agent. The metadata type contains two files: the standard metatada XML file and an Agent Script file (extension \".agent\") that fully describes the agent using the Agent Script language.\n\nWhen you publish an authoring bundle to your org, a number of things happen. First, this command validates that the Agent Script file successfully compiles. If there are compilation errors, the command exits and you must fix the Agent Script file to continue. Once the Agent Script file compiles, then it's published to the org, which in turn creates new associated metadata (Bot, BotVersion, GenAiX), or new versions of the metadata if the agent already exists. The new or updated metadata is retrieved back to your DX project; specify the --skip-retrieve flag to skip this step. Finally, the authoring bundle metadata (AiAuthoringBundle) is deployed to your org.\n\nThis command uses the API name of the authoring bundle.",
1353
1353
  "examples": [
1354
1354
  "Publish an authoring bundle by being prompted for its API name; use your default org:\n<%= config.bin %> <%= command.id %>",
1355
- "Publish an authoring bundle with API name MyAuthoringBundle to the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --target-org my-dev-org"
1355
+ "Publish an authoring bundle with API name MyAuthoringBundle to the org with alias \"my-dev-org\":\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --target-org my-dev-org",
1356
+ "Publish with verbose output to see all retrieved and deployed metadata components:\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --verbose",
1357
+ "Publish with concise output showing only essential information:\n<%= config.bin %> <%= command.id %> --api-name MyAuthoringbundle --concise"
1356
1358
  ],
1357
1359
  "flags": {
1358
1360
  "json": {
@@ -1400,6 +1402,25 @@
1400
1402
  "summary": "Don't retrieve the metadata associated with the agent to your DX project.",
1401
1403
  "allowNo": false,
1402
1404
  "type": "boolean"
1405
+ },
1406
+ "verbose": {
1407
+ "char": "v",
1408
+ "exclusive": [
1409
+ "concise"
1410
+ ],
1411
+ "name": "verbose",
1412
+ "summary": "Display detailed output showing all metadata components retrieved and deployed during the publish process.",
1413
+ "allowNo": false,
1414
+ "type": "boolean"
1415
+ },
1416
+ "concise": {
1417
+ "exclusive": [
1418
+ "verbose"
1419
+ ],
1420
+ "name": "concise",
1421
+ "summary": "Display minimal output with only essential information about the publish operation.",
1422
+ "allowNo": false,
1423
+ "type": "boolean"
1403
1424
  }
1404
1425
  },
1405
1426
  "hasDynamicHelp": true,
@@ -1578,7 +1599,7 @@
1578
1599
  "agent:test:list": {
1579
1600
  "aliases": [],
1580
1601
  "args": {},
1581
- "description": "The command outputs a table with the name (API name) of each test along with its unique ID and the date it was created in the org.",
1602
+ "description": "The command outputs a table with the name (API name) of each test along with its unique ID, type ('agentforce-studio' or 'testing-center'), and the date it was created in the org.",
1582
1603
  "examples": [
1583
1604
  "List the agent tests in your default org:\n<%= config.bin %> <%= command.id %>",
1584
1605
  "List the agent tests in an org with alias \"my-org\"\"\n<%= config.bin %> <%= command.id %> --target-org my-org"
@@ -1740,6 +1761,18 @@
1740
1761
  "multiple": false,
1741
1762
  "type": "option"
1742
1763
  },
1764
+ "test-runner": {
1765
+ "description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
1766
+ "name": "test-runner",
1767
+ "summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
1768
+ "hasDynamicHelp": false,
1769
+ "multiple": false,
1770
+ "options": [
1771
+ "agentforce-studio",
1772
+ "testing-center"
1773
+ ],
1774
+ "type": "option"
1775
+ },
1743
1776
  "verbose": {
1744
1777
  "description": "When enabled, includes detailed generated data (such as invoked actions) in the human-readable test results output. This is useful for debugging test failures and understanding what actions were actually invoked during the test run.\n\nThe generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations.",
1745
1778
  "name": "verbose",
@@ -1890,6 +1923,18 @@
1890
1923
  "multiple": false,
1891
1924
  "type": "option"
1892
1925
  },
1926
+ "test-runner": {
1927
+ "description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
1928
+ "name": "test-runner",
1929
+ "summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
1930
+ "hasDynamicHelp": false,
1931
+ "multiple": false,
1932
+ "options": [
1933
+ "agentforce-studio",
1934
+ "testing-center"
1935
+ ],
1936
+ "type": "option"
1937
+ },
1893
1938
  "verbose": {
1894
1939
  "description": "When enabled, includes detailed generated data (such as invoked actions) in the human-readable test results output. This is useful for debugging test failures and understanding what actions were actually invoked during the test run.\n\nThe generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations.",
1895
1940
  "name": "verbose",
@@ -2195,6 +2240,18 @@
2195
2240
  "multiple": false,
2196
2241
  "type": "option"
2197
2242
  },
2243
+ "test-runner": {
2244
+ "description": "By default, the command automatically detects which test runner to use based on the test definition metadata type in your org. Use this flag to explicitly specify the runner type. 'agentforce-studio' uses AiTestingDefinition metadata. 'testing-center' uses AiEvaluationDefinition metadata.",
2245
+ "name": "test-runner",
2246
+ "summary": "Explicitly specify which test runner to use (agentforce-studio or testing-center).",
2247
+ "hasDynamicHelp": false,
2248
+ "multiple": false,
2249
+ "options": [
2250
+ "agentforce-studio",
2251
+ "testing-center"
2252
+ ],
2253
+ "type": "option"
2254
+ },
2198
2255
  "verbose": {
2199
2256
  "description": "When enabled, includes detailed generated data (such as invoked actions) in the human-readable test results output. This is useful for debugging test failures and understanding what actions were actually invoked during the test run.\n\nThe generated data is in JSON format and includes the Apex classes or Flows that were invoked, the Salesforce objects that were touched, and so on. Use the JSON structure of this information to build the test case JSONPath expression when using custom evaluations.",
2200
2257
  "name": "verbose",
@@ -2375,5 +2432,5 @@
2375
2432
  ]
2376
2433
  }
2377
2434
  },
2378
- "version": "1.35.0"
2435
+ "version": "1.36.1"
2379
2436
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@salesforce/plugin-agent",
3
3
  "description": "Commands to interact with Salesforce agents",
4
- "version": "1.35.0",
4
+ "version": "1.36.1",
5
5
  "author": "Salesforce",
6
6
  "bugs": "https://github.com/forcedotcom/cli/issues",
7
7
  "enableO11y": true,
@@ -12,11 +12,11 @@
12
12
  "@inquirer/prompts": "^7.10.1",
13
13
  "@oclif/core": "^4",
14
14
  "@oclif/multi-stage-output": "^0.8.36",
15
- "@salesforce/agents": "^1.4.0",
15
+ "@salesforce/agents": "^1.5.1",
16
16
  "@salesforce/core": "^8.28.3",
17
17
  "@salesforce/kit": "^3.2.6",
18
18
  "@salesforce/sf-plugins-core": "^12.2.6",
19
- "@salesforce/source-deploy-retrieve": "^12.32.8",
19
+ "@salesforce/source-deploy-retrieve": "^12.35.3",
20
20
  "@salesforce/types": "^1.7.1",
21
21
  "ansis": "^3.3.2",
22
22
  "fast-xml-parser": "^5.7.1",
@@ -240,7 +240,7 @@
240
240
  "exports": "./lib/index.js",
241
241
  "type": "module",
242
242
  "sfdx": {
243
- "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.35.0.crt",
244
- "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.35.0.sig"
243
+ "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.36.1.crt",
244
+ "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-agent/1.36.1.sig"
245
245
  }
246
246
  }
@@ -12,8 +12,11 @@
12
12
  "type": "number"
13
13
  }
14
14
  },
15
- "required": ["success", "version"],
15
+ "required": [
16
+ "success",
17
+ "version"
18
+ ],
16
19
  "additionalProperties": false
17
20
  }
18
21
  }
19
- }
22
+ }
@@ -28,7 +28,11 @@
28
28
  "type": "string"
29
29
  }
30
30
  },
31
- "required": ["botId", "botVersionId", "plannerId"],
31
+ "required": [
32
+ "botId",
33
+ "botVersionId",
34
+ "plannerId"
35
+ ],
32
36
  "additionalProperties": false,
33
37
  "description": "If the agent was created with saveAgent=true, these are the IDs that make up an agent; Bot, BotVersion, and GenAiPlanner metadata."
34
38
  },
@@ -78,7 +82,11 @@
78
82
  "type": "string"
79
83
  }
80
84
  },
81
- "required": ["inputName", "inputDataType", "inputDescription"],
85
+ "required": [
86
+ "inputName",
87
+ "inputDataType",
88
+ "inputDescription"
89
+ ],
82
90
  "additionalProperties": false
83
91
  },
84
92
  "minItems": 1,
@@ -99,14 +107,24 @@
99
107
  "type": "string"
100
108
  }
101
109
  },
102
- "required": ["outputName", "outputDataType", "outputDescription"],
110
+ "required": [
111
+ "outputName",
112
+ "outputDataType",
113
+ "outputDescription"
114
+ ],
103
115
  "additionalProperties": false
104
116
  },
105
117
  "minItems": 1,
106
118
  "maxItems": 1
107
119
  }
108
120
  },
109
- "required": ["actionName", "exampleOutput", "actionDescription", "inputs", "outputs"],
121
+ "required": [
122
+ "actionName",
123
+ "exampleOutput",
124
+ "actionDescription",
125
+ "inputs",
126
+ "outputs"
127
+ ],
110
128
  "additionalProperties": false
111
129
  },
112
130
  "minItems": 1,
@@ -122,7 +140,13 @@
122
140
  "type": "string"
123
141
  }
124
142
  },
125
- "required": ["scope", "topic", "actions", "instructions", "classificationDescription"],
143
+ "required": [
144
+ "scope",
145
+ "topic",
146
+ "actions",
147
+ "instructions",
148
+ "classificationDescription"
149
+ ],
126
150
  "additionalProperties": false
127
151
  },
128
152
  "minItems": 1,
@@ -135,11 +159,18 @@
135
159
  }
136
160
  }
137
161
  },
138
- "required": ["agentDescription", "topics", "sampleUtterances"],
162
+ "required": [
163
+ "agentDescription",
164
+ "topics",
165
+ "sampleUtterances"
166
+ ],
139
167
  "additionalProperties": false
140
168
  }
141
169
  },
142
- "required": ["agentDefinition", "isSuccess"]
170
+ "required": [
171
+ "agentDefinition",
172
+ "isSuccess"
173
+ ]
143
174
  }
144
175
  }
145
- }
176
+ }
@@ -12,8 +12,11 @@
12
12
  "type": "number"
13
13
  }
14
14
  },
15
- "required": ["success", "version"],
15
+ "required": [
16
+ "success",
17
+ "version"
18
+ ],
16
19
  "additionalProperties": false
17
20
  }
18
21
  }
19
- }
22
+ }
@@ -47,7 +47,14 @@
47
47
  "type": "string"
48
48
  }
49
49
  },
50
- "required": ["agentType", "companyDescription", "companyName", "isSuccess", "role", "topics"]
50
+ "required": [
51
+ "agentType",
52
+ "companyDescription",
53
+ "companyName",
54
+ "isSuccess",
55
+ "role",
56
+ "topics"
57
+ ]
51
58
  },
52
59
  "DraftAgentTopics": {
53
60
  "type": "array",
@@ -61,7 +68,10 @@
61
68
  "type": "string"
62
69
  }
63
70
  },
64
- "required": ["name", "description"],
71
+ "required": [
72
+ "name",
73
+ "description"
74
+ ],
65
75
  "additionalProperties": false
66
76
  },
67
77
  "minItems": 1,
@@ -69,7 +79,11 @@
69
79
  },
70
80
  "AgentType": {
71
81
  "type": "string",
72
- "enum": ["customer", "internal", "AGENT"]
82
+ "enum": [
83
+ "customer",
84
+ "internal",
85
+ "AGENT"
86
+ ]
73
87
  }
74
88
  }
75
- }
89
+ }
@@ -15,8 +15,12 @@
15
15
  "type": "string"
16
16
  }
17
17
  },
18
- "required": ["agentPath", "metaXmlPath", "outputDir"],
18
+ "required": [
19
+ "agentPath",
20
+ "metaXmlPath",
21
+ "outputDir"
22
+ ],
19
23
  "additionalProperties": false
20
24
  }
21
25
  }
22
- }
26
+ }
@@ -12,8 +12,11 @@
12
12
  "type": "string"
13
13
  }
14
14
  },
15
- "required": ["genAiPlannerBundlePath", "botTemplatePath"],
15
+ "required": [
16
+ "genAiPlannerBundlePath",
17
+ "botTemplatePath"
18
+ ],
16
19
  "additionalProperties": false
17
20
  }
18
21
  }
19
- }
22
+ }
@@ -12,8 +12,11 @@
12
12
  "type": "string"
13
13
  }
14
14
  },
15
- "required": ["sessionId", "tracesPath"],
15
+ "required": [
16
+ "sessionId",
17
+ "tracesPath"
18
+ ],
16
19
  "additionalProperties": false
17
20
  }
18
21
  }
19
- }
22
+ }
@@ -27,8 +27,12 @@
27
27
  "type": "string"
28
28
  }
29
29
  },
30
- "required": ["messages", "agentApiName", "sessionId"],
30
+ "required": [
31
+ "messages",
32
+ "agentApiName",
33
+ "sessionId"
34
+ ],
31
35
  "additionalProperties": false
32
36
  }
33
37
  }
34
- }
38
+ }
@@ -23,13 +23,20 @@
23
23
  "$ref": "#/definitions/SessionType"
24
24
  }
25
25
  },
26
- "required": ["agentId", "sessionId"],
26
+ "required": [
27
+ "agentId",
28
+ "sessionId"
29
+ ],
27
30
  "additionalProperties": false
28
31
  }
29
32
  },
30
33
  "SessionType": {
31
34
  "type": "string",
32
- "enum": ["simulated", "live", "published"]
35
+ "enum": [
36
+ "simulated",
37
+ "live",
38
+ "published"
39
+ ]
33
40
  }
34
41
  }
35
- }
42
+ }
@@ -12,8 +12,11 @@
12
12
  "type": "string"
13
13
  }
14
14
  },
15
- "required": ["sessionId", "agentApiName"],
15
+ "required": [
16
+ "sessionId",
17
+ "agentApiName"
18
+ ],
16
19
  "additionalProperties": false
17
20
  }
18
21
  }
19
- }
22
+ }
@@ -6,4 +6,4 @@
6
6
  "type": "null"
7
7
  }
8
8
  }
9
- }
9
+ }
@@ -16,6 +16,31 @@
16
16
  "items": {
17
17
  "type": "string"
18
18
  }
19
+ },
20
+ "retrievedComponents": {
21
+ "type": "array",
22
+ "items": {
23
+ "type": "string"
24
+ }
25
+ },
26
+ "deployedComponents": {
27
+ "type": "array",
28
+ "items": {
29
+ "type": "string"
30
+ }
31
+ },
32
+ "summary": {
33
+ "type": "object",
34
+ "properties": {
35
+ "retrieved": {
36
+ "type": "number"
37
+ },
38
+ "deployed": {
39
+ "type": "number"
40
+ }
41
+ },
42
+ "required": ["retrieved", "deployed"],
43
+ "additionalProperties": false
19
44
  }
20
45
  },
21
46
  "required": ["success"],
@@ -12,8 +12,11 @@
12
12
  "type": "string"
13
13
  }
14
14
  },
15
- "required": ["path", "contents"],
15
+ "required": [
16
+ "path",
17
+ "contents"
18
+ ],
16
19
  "additionalProperties": false
17
20
  }
18
21
  }
19
- }
22
+ }
@@ -57,4 +57,4 @@
57
57
  "additionalProperties": false
58
58
  }
59
59
  }
60
- }
60
+ }