@nexusclawhq/cli 0.3.77 → 0.3.78

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 (169) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/dist/build-info.json +4 -4
  3. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/ai-authoring-context.types.js +0 -5
  4. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/ai-authoring-context.types.js.map +1 -1
  5. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/contract-versions.d.ts +24 -3
  6. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/contract-versions.js +26 -4
  7. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/contract-versions.js.map +1 -1
  8. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-eval-cases.types.d.ts +59 -9
  9. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-eval-cases.types.js +99 -15
  10. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-eval-cases.types.js.map +1 -1
  11. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill-binding.types.d.ts +50 -0
  12. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill-binding.types.js +163 -0
  13. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill-binding.types.js.map +1 -0
  14. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill-composite.types.d.ts +53 -0
  15. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill-composite.types.js +179 -0
  16. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill-composite.types.js.map +1 -0
  17. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.catalog.d.ts +7 -0
  18. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.catalog.js +408 -0
  19. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.catalog.js.map +1 -0
  20. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.contract.fixture.d.ts +14 -0
  21. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.contract.fixture.js +119 -0
  22. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.contract.fixture.js.map +1 -0
  23. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.transport.fixture.d.ts +7 -0
  24. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.transport.fixture.js +70 -0
  25. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.transport.fixture.js.map +1 -0
  26. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.transport.types.d.ts +55 -0
  27. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.transport.types.js +138 -0
  28. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.transport.types.js.map +1 -0
  29. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.types.d.ts +197 -0
  30. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.types.js +412 -0
  31. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/employee-skill.types.js.map +1 -0
  32. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/evidence-case.schemas.d.ts +577 -0
  33. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/evidence-case.schemas.js +742 -0
  34. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/evidence-case.schemas.js.map +1 -0
  35. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/evidence-case.types.d.ts +85 -0
  36. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/evidence-case.types.js +3 -0
  37. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/evidence-case.types.js.map +1 -0
  38. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/evidence-case.validation.d.ts +14 -0
  39. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/evidence-case.validation.js +111 -0
  40. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/evidence-case.validation.js.map +1 -0
  41. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/image-evidence.types.d.ts +44 -0
  42. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/image-evidence.types.js +3 -0
  43. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/image-evidence.types.js.map +1 -0
  44. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/index.d.ts +11 -1
  45. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/index.js +11 -0
  46. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/index.js.map +1 -1
  47. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-prompt-policy/index.d.ts +50 -0
  48. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-prompt-policy/index.js +50 -0
  49. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-prompt-policy/index.js.map +1 -0
  50. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/effective-agent-manifest.d.ts +1 -1
  51. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/effective-agent-manifest.js +1 -0
  52. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/effective-agent-manifest.js.map +1 -1
  53. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/handoff-evidence.d.ts +32 -0
  54. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/handoff-evidence.js +87 -0
  55. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/handoff-evidence.js.map +1 -0
  56. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/index.d.ts +1 -0
  57. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/index.js +5 -1
  58. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/index.js.map +1 -1
  59. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/types.d.ts +2 -0
  60. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/types.js +0 -12
  61. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/types.js.map +1 -1
  62. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/validator.js +27 -0
  63. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/employee-package/validator.js.map +1 -1
  64. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/enterprise-flow-graph.d.ts +39 -0
  65. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/enterprise-flow-graph.js +27 -0
  66. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/enterprise-flow-graph.js.map +1 -0
  67. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/enterprise-integration-nodes.d.ts +19 -0
  68. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/enterprise-integration-nodes.js +28 -0
  69. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/enterprise-integration-nodes.js.map +1 -0
  70. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/external-reference.d.ts +8 -0
  71. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/external-reference.js +35 -0
  72. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/external-reference.js.map +1 -0
  73. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/index.d.ts +4 -0
  74. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/index.js +4 -0
  75. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/index.js.map +1 -1
  76. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/en-US.d.ts +479 -9
  77. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/en-US.js +485 -15
  78. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/en-US.js.map +1 -1
  79. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/index.d.ts +958 -18
  80. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/zh-CN.d.ts +479 -9
  81. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/zh-CN.js +485 -15
  82. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/zh-CN.js.map +1 -1
  83. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/record-home/formAssist.js +5 -2
  84. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/record-home/formAssist.js.map +1 -1
  85. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/record-home/index.d.ts +1 -0
  86. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/record-home/index.js +1 -0
  87. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/record-home/index.js.map +1 -1
  88. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/record-home/referenceView.d.ts +16 -0
  89. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/record-home/referenceView.js +37 -0
  90. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/record-home/referenceView.js.map +1 -0
  91. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/workspace-metadata-package/index.d.ts +2 -2
  92. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/workspace-metadata-package/index.js +2 -2
  93. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/workspace-metadata-package/index.js.map +1 -1
  94. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/workspace-metadata-package/lifecycle.js +2 -2
  95. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/workspace-metadata-package/lifecycle.js.map +1 -1
  96. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/workspace-regional-settings.d.ts +1 -0
  97. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/workspace-regional-settings.js +1 -0
  98. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/workspace-regional-settings.js.map +1 -1
  99. package/dist/nexus-cli/node_modules/@nexusclaw/shared/package.json +4 -0
  100. package/dist/nexus-cli/src/cli-runner.test.js +0 -36
  101. package/dist/nexus-cli/src/cli-runner.test.js.map +1 -1
  102. package/dist/nexus-cli/src/cli.js +1 -46
  103. package/dist/nexus-cli/src/cli.js.map +1 -1
  104. package/dist/nexus-cli/src/commands/ai/help.d.ts +0 -5
  105. package/dist/nexus-cli/src/commands/ai/help.js +2 -233
  106. package/dist/nexus-cli/src/commands/ai/help.js.map +1 -1
  107. package/dist/nexus-cli/src/commands/ai/help.test.js +0 -64
  108. package/dist/nexus-cli/src/commands/ai/help.test.js.map +1 -1
  109. package/dist/nexus-cli/src/commands/ai/index.js +2 -2
  110. package/dist/nexus-cli/src/commands/ai/index.js.map +1 -1
  111. package/dist/nexus-cli/src/contracts/command-contract-coverage-baseline.json +3 -3
  112. package/dist/nexus-cli/src/contracts/command-contract.registry.js +4 -49
  113. package/dist/nexus-cli/src/contracts/command-contract.registry.js.map +1 -1
  114. package/dist/nexus-cli/src/contracts/command-inventory.d.ts +0 -1
  115. package/dist/nexus-cli/src/contracts/command-inventory.js +0 -1
  116. package/dist/nexus-cli/src/contracts/command-inventory.js.map +1 -1
  117. package/dist/nexus-cli/src/contracts/command-policy.exporter.test.js +1 -1
  118. package/dist/nexus-cli/src/contracts/command-policy.registry.js +1 -1
  119. package/dist/nexus-cli/src/contracts/command-policy.registry.js.map +1 -1
  120. package/dist/nexus-cli/src/contracts/command-policy.validator.test.js +3 -3
  121. package/dist/nexus-cli/src/contracts/command-policy.validator.test.js.map +1 -1
  122. package/dist/nexus-cli/src/contracts/contracts.test.js +1 -1
  123. package/dist/nexus-cli/src/contracts/index.d.ts +0 -2
  124. package/dist/nexus-cli/src/contracts/index.js +1 -10
  125. package/dist/nexus-cli/src/contracts/index.js.map +1 -1
  126. package/dist/nexus-cli/src/runtime/actionable-error.js +5 -0
  127. package/dist/nexus-cli/src/runtime/actionable-error.js.map +1 -1
  128. package/dist/nexus-cli/src/runtime/failure-normalizer.js +0 -6
  129. package/dist/nexus-cli/src/runtime/failure-normalizer.js.map +1 -1
  130. package/dist/nexus-cli/src/runtime/output-coordinator.js +7 -1
  131. package/dist/nexus-cli/src/runtime/output-coordinator.js.map +1 -1
  132. package/dist/nexus-cli/src/services/ai-authoring-context-v2.js +3 -18
  133. package/dist/nexus-cli/src/services/ai-authoring-context-v2.js.map +1 -1
  134. package/dist/nexus-cli/src/services/ai-authoring-context-v2.pack.e2e.js +0 -24
  135. package/dist/nexus-cli/src/services/ai-authoring-context-v2.pack.e2e.js.map +1 -1
  136. package/dist/nexus-cli/src/services/ai-authoring-context-v2.test.js +0 -8
  137. package/dist/nexus-cli/src/services/ai-authoring-context-v2.test.js.map +1 -1
  138. package/dist/nexus-cli/src/services/ai-context-signing-key-cache.js +1 -0
  139. package/dist/nexus-cli/src/services/ai-context-signing-key-cache.js.map +1 -1
  140. package/dist/nexus-cli/src/services/api-client.js +14 -4
  141. package/dist/nexus-cli/src/services/api-client.js.map +1 -1
  142. package/dist/nexus-cli/src/services/code-authoring-local.js +3 -1
  143. package/dist/nexus-cli/src/services/code-authoring-local.js.map +1 -1
  144. package/dist/nexus-cli/src/services/revision-ledger/baseline-service.js +1 -0
  145. package/dist/nexus-cli/src/services/revision-ledger/baseline-service.js.map +1 -1
  146. package/dist/nexus-cli/src/services/revision-ledger/drift-calculator.js +1 -0
  147. package/dist/nexus-cli/src/services/revision-ledger/drift-calculator.js.map +1 -1
  148. package/dist/nexus-cli/src/services/revision-ledger/ledger-storage.js +2 -0
  149. package/dist/nexus-cli/src/services/revision-ledger/ledger-storage.js.map +1 -1
  150. package/dist/nexus-cli/src/services/revision-ledger/migration-service.js +1 -0
  151. package/dist/nexus-cli/src/services/revision-ledger/migration-service.js.map +1 -1
  152. package/dist/nexus-cli/src/services/revision-ledger/page-source-baseline-store.js +1 -0
  153. package/dist/nexus-cli/src/services/revision-ledger/page-source-baseline-store.js.map +1 -1
  154. package/dist/nexus-cli/src/services/revision-ledger/revision-service.js +5 -0
  155. package/dist/nexus-cli/src/services/revision-ledger/revision-service.js.map +1 -1
  156. package/dist/nexus-cli/src/services/revision-ledger/rollback-service.js +1 -0
  157. package/dist/nexus-cli/src/services/revision-ledger/rollback-service.js.map +1 -1
  158. package/dist/nexus-cli/src/services/sse-client.js +7 -2
  159. package/dist/nexus-cli/src/services/sse-client.js.map +1 -1
  160. package/dist/nexus-cli/src/services/step-up-helper.js +1 -0
  161. package/dist/nexus-cli/src/services/step-up-helper.js.map +1 -1
  162. package/dist/nexus-cli/src/services/target-context.js +2 -0
  163. package/dist/nexus-cli/src/services/target-context.js.map +1 -1
  164. package/dist/nexus-cli/src/services/workforce-test-remote.d.ts +1 -1
  165. package/dist/nexus-cli/src/services/workforce-test-remote.js +1 -1
  166. package/dist/nexus-cli/src/services/workspace-health.js +10 -5
  167. package/dist/nexus-cli/src/services/workspace-health.js.map +1 -1
  168. package/dist/tsconfig.tsbuildinfo +1 -1
  169. package/package.json +1 -2
@@ -0,0 +1,55 @@
1
+ import { type EmployeeSkillBlockerCode, type EmployeeSkillProviderFamily } from './employee-skill.types';
2
+ import { EMPLOYEE_SKILL_TRANSPORT_MANIFEST_SCHEMA_VERSION } from './contract-versions';
3
+ export type SkillApiMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
4
+ interface SkillTransportManifestBase {
5
+ readonly schemaVersion: typeof EMPLOYEE_SKILL_TRANSPORT_MANIFEST_SCHEMA_VERSION;
6
+ readonly providerFamily: EmployeeSkillProviderFamily;
7
+ readonly skillId: string;
8
+ readonly adapterId: string;
9
+ readonly product: string;
10
+ readonly adapterVersion: string;
11
+ readonly operationId: string;
12
+ readonly operationVersion: string;
13
+ readonly timeoutMs: number;
14
+ }
15
+ export interface SkillApiTransportManifest extends SkillTransportManifestBase {
16
+ readonly transport: 'api';
17
+ readonly method: SkillApiMethod;
18
+ readonly baseUrl: string;
19
+ readonly pathTemplate: string;
20
+ readonly requestIdHeader: string;
21
+ readonly pagination?: {
22
+ readonly mode: 'cursor' | 'page';
23
+ readonly requestField: string;
24
+ readonly responseField: string;
25
+ readonly maxPages: number;
26
+ };
27
+ readonly rateLimit: {
28
+ readonly maxRequests: number;
29
+ readonly windowMs: number;
30
+ };
31
+ readonly errorCodeMap: Readonly<Record<string, EmployeeSkillBlockerCode>>;
32
+ readonly redactedHeaders: readonly string[];
33
+ }
34
+ export interface SkillMcpTransportManifest extends SkillTransportManifestBase {
35
+ readonly transport: 'mcp';
36
+ readonly serverId: string;
37
+ readonly serverVersion: string;
38
+ readonly toolName: string;
39
+ readonly inputSchemaDigest: string;
40
+ readonly outputSchemaDigest: string;
41
+ readonly allowedResourceTypes: readonly string[];
42
+ }
43
+ export interface SkillCliTransportManifest extends SkillTransportManifestBase {
44
+ readonly transport: 'cli';
45
+ readonly executableRef: string;
46
+ readonly executableDigest: string;
47
+ readonly argvTemplate: readonly string[];
48
+ readonly workingDirectoryRef: string;
49
+ readonly envAllowlist: readonly string[];
50
+ readonly stdoutSchemaVersion: string;
51
+ readonly stderrRedactionPatterns: readonly string[];
52
+ }
53
+ export type SkillTransportManifest = SkillApiTransportManifest | SkillMcpTransportManifest | SkillCliTransportManifest;
54
+ export declare function assertValidSkillTransportManifest(value: unknown): asserts value is SkillTransportManifest;
55
+ export {};
@@ -0,0 +1,138 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.assertValidSkillTransportManifest = assertValidSkillTransportManifest;
4
+ const employee_skill_types_1 = require("./employee-skill.types");
5
+ const contract_versions_1 = require("./contract-versions");
6
+ const TRANSPORT_MANIFEST_SHELL_META = /[;&|<>`$()\u0000]/;
7
+ const CONTROL_CHARACTER = /[\u0000-\u001f\u007f]/;
8
+ const SHA256_DIGEST = /^sha256:[0-9a-f]{64}$/;
9
+ const ENV_NAME = /^[A-Z_][A-Z0-9_]*$/;
10
+ // DWS shortcut commands use a literal `+` segment (for example `+search`).
11
+ // Keep the token shell-safe while allowing that fixed manifest syntax.
12
+ const SAFE_TOKEN = /^[A-Za-z0-9._:/@{}[\]+-]+$/;
13
+ const SAFE_FIELD_PATH = /^[A-Za-z][A-Za-z0-9_.-]{0,127}$/;
14
+ function assertValidSkillTransportManifest(value) {
15
+ const manifest = value;
16
+ if (!manifest ||
17
+ manifest.schemaVersion !== contract_versions_1.EMPLOYEE_SKILL_TRANSPORT_MANIFEST_SCHEMA_VERSION ||
18
+ !isProviderFamily(manifest.providerFamily) ||
19
+ !isTransport(manifest.transport) ||
20
+ !hasText(manifest.skillId) ||
21
+ !hasText(manifest.adapterId) ||
22
+ !hasText(manifest.product) ||
23
+ !hasText(manifest.adapterVersion) ||
24
+ !hasText(manifest.operationId) ||
25
+ !hasText(manifest.operationVersion) ||
26
+ !isTimeout(manifest.timeoutMs)) {
27
+ throw new Error('EMPLOYEE_SKILL_SCHEMA_DRIFT');
28
+ }
29
+ if (manifest.transport === 'api') {
30
+ assertApiManifest(manifest);
31
+ return;
32
+ }
33
+ if (manifest.transport === 'mcp') {
34
+ assertMcpManifest(manifest);
35
+ return;
36
+ }
37
+ assertCliManifest(manifest);
38
+ }
39
+ function assertApiManifest(manifest) {
40
+ let parsedUrl;
41
+ try {
42
+ parsedUrl = new URL(String(manifest.baseUrl));
43
+ }
44
+ catch {
45
+ throw new Error('EMPLOYEE_SKILL_SCHEMA_DRIFT');
46
+ }
47
+ if (parsedUrl.protocol !== 'https:' ||
48
+ parsedUrl.username ||
49
+ parsedUrl.password ||
50
+ /(?:token|secret|bearer|password)/i.test(parsedUrl.href) ||
51
+ !isHttpMethod(manifest.method) ||
52
+ !hasText(manifest.pathTemplate) ||
53
+ TRANSPORT_MANIFEST_SHELL_META.test(manifest.pathTemplate) ||
54
+ CONTROL_CHARACTER.test(manifest.pathTemplate) ||
55
+ !hasText(manifest.requestIdHeader) ||
56
+ !manifest.rateLimit ||
57
+ !isPositiveInteger(manifest.rateLimit.maxRequests) ||
58
+ !isPositiveInteger(manifest.rateLimit.windowMs) ||
59
+ !Array.isArray(manifest.redactedHeaders) ||
60
+ !manifest.redactedHeaders.every(hasText) ||
61
+ !isErrorCodeMap(manifest.errorCodeMap) ||
62
+ !isPagination(manifest.pagination)) {
63
+ throw new Error('EMPLOYEE_SKILL_SCHEMA_DRIFT');
64
+ }
65
+ }
66
+ function assertMcpManifest(manifest) {
67
+ if (!hasText(manifest.serverId) ||
68
+ !hasText(manifest.serverVersion) ||
69
+ !hasText(manifest.toolName) ||
70
+ !SHA256_DIGEST.test(String(manifest.inputSchemaDigest)) ||
71
+ !SHA256_DIGEST.test(String(manifest.outputSchemaDigest)) ||
72
+ !Array.isArray(manifest.allowedResourceTypes) ||
73
+ !manifest.allowedResourceTypes.every(hasText)) {
74
+ throw new Error('EMPLOYEE_SKILL_SCHEMA_DRIFT');
75
+ }
76
+ }
77
+ function assertCliManifest(manifest) {
78
+ if (!hasText(manifest.executableRef) ||
79
+ TRANSPORT_MANIFEST_SHELL_META.test(manifest.executableRef) ||
80
+ !SHA256_DIGEST.test(String(manifest.executableDigest)) ||
81
+ !Array.isArray(manifest.argvTemplate) ||
82
+ manifest.argvTemplate.length === 0 ||
83
+ !manifest.argvTemplate.every((arg) => hasText(arg) &&
84
+ SAFE_TOKEN.test(arg) &&
85
+ !TRANSPORT_MANIFEST_SHELL_META.test(arg)) ||
86
+ !hasText(manifest.workingDirectoryRef) ||
87
+ TRANSPORT_MANIFEST_SHELL_META.test(manifest.workingDirectoryRef) ||
88
+ !Array.isArray(manifest.envAllowlist) ||
89
+ !manifest.envAllowlist.every((name) => typeof name === 'string' && ENV_NAME.test(name)) ||
90
+ !hasText(manifest.stdoutSchemaVersion) ||
91
+ !Array.isArray(manifest.stderrRedactionPatterns) ||
92
+ !manifest.stderrRedactionPatterns.every(hasText)) {
93
+ throw new Error('EMPLOYEE_SKILL_SCHEMA_DRIFT');
94
+ }
95
+ }
96
+ function isPagination(pagination) {
97
+ return (pagination === undefined ||
98
+ (pagination !== null &&
99
+ (pagination.mode === 'cursor' || pagination.mode === 'page') &&
100
+ SAFE_FIELD_PATH.test(pagination.requestField) &&
101
+ SAFE_FIELD_PATH.test(pagination.responseField) &&
102
+ isPositiveInteger(pagination.maxPages) &&
103
+ pagination.maxPages <= 100));
104
+ }
105
+ function isErrorCodeMap(value) {
106
+ return (value !== undefined &&
107
+ typeof value === 'object' &&
108
+ value !== null &&
109
+ !Array.isArray(value) &&
110
+ Object.entries(value).every(([providerCode, blocker]) => hasText(providerCode) && isBlockerCode(blocker)));
111
+ }
112
+ function isTimeout(value) {
113
+ return isPositiveInteger(value) && value <= 120000;
114
+ }
115
+ function isPositiveInteger(value) {
116
+ return typeof value === 'number' && Number.isInteger(value) && value > 0;
117
+ }
118
+ function hasText(value) {
119
+ return typeof value === 'string' && value.trim().length > 0;
120
+ }
121
+ function isProviderFamily(value) {
122
+ return value === 'dingtalk' || value === 'feishu' || value === 'tencent';
123
+ }
124
+ function isTransport(value) {
125
+ return value === 'api' || value === 'mcp' || value === 'cli';
126
+ }
127
+ function isHttpMethod(value) {
128
+ return (value === 'GET' ||
129
+ value === 'POST' ||
130
+ value === 'PUT' ||
131
+ value === 'PATCH' ||
132
+ value === 'DELETE');
133
+ }
134
+ function isBlockerCode(value) {
135
+ return (typeof value === 'string' &&
136
+ employee_skill_types_1.EMPLOYEE_SKILL_BLOCKER_CODES.includes(value));
137
+ }
138
+ //# sourceMappingURL=employee-skill.transport.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"employee-skill.transport.types.js","sourceRoot":"","sources":["../../src/agent-executable-assets/employee-skill.transport.types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,197 @@
1
+ import { EMPLOYEE_SKILL_CATALOG_SCHEMA_VERSION, EMPLOYEE_SKILL_DESCRIPTOR_SCHEMA_VERSION, EMPLOYEE_SKILL_INVOCATION_SCHEMA_VERSION, EMPLOYEE_SKILL_RESULT_SCHEMA_VERSION, EMPLOYEE_EXTERNAL_ARTIFACT_REF_SCHEMA_VERSION } from './contract-versions';
2
+ import { type JsonValue } from './json-value';
3
+ export declare const SKILL_GROUP_IDS: readonly ["communication", "data", "social", "office"];
4
+ export type SkillGroup = (typeof SKILL_GROUP_IDS)[number];
5
+ export declare const SKILL_LIFECYCLE_STATUSES: readonly ["development", "released"];
6
+ export type SkillLifecycleStatus = (typeof SKILL_LIFECYCLE_STATUSES)[number];
7
+ export declare const EMPLOYEE_SKILL_PROVIDER_FAMILIES: readonly ["dingtalk", "feishu", "tencent"];
8
+ export type EmployeeSkillProviderFamily = (typeof EMPLOYEE_SKILL_PROVIDER_FAMILIES)[number];
9
+ export type SkillTransportKind = 'api' | 'mcp' | 'cli';
10
+ export type SkillAdapterHealthStatus = 'ready' | 'degraded' | 'blocked';
11
+ export type SkillAdapterIdempotencySupport = 'none' | 'provider_key' | 'nexus_key' | 'provider_and_nexus_key';
12
+ export type SkillAdapterCompensationSupport = 'none' | 'manual' | 'provider';
13
+ export type SkillCapabilityAvailability = 'available' | 'blocked';
14
+ /** Runtime availability details shown beside a catalog skill. */
15
+ export type SkillCatalogCapabilityStatus = SkillCapabilityAvailability | 'unavailable';
16
+ export type SkillCatalogAdapterHealthStatus = SkillAdapterHealthStatus | 'unregistered';
17
+ export type SkillCatalogConnectionStatus = 'ready' | 'blocked' | 'unverified' | 'unavailable';
18
+ export type SkillResultStatus = 'preview' | 'completed' | 'completed_unverified' | 'partial' | 'blocked' | 'failed' | 'provider_unavailable' | 'unknown_outcome';
19
+ export type SkillVerificationStatus = 'passed' | 'failed' | 'not_required' | 'pending';
20
+ export type SkillSideEffectClass = 'read' | 'draft' | 'write' | 'share' | 'delete' | 'external_send';
21
+ export type SkillApprovalRequirement = 'none' | 'on_write' | 'on_external_send' | 'always';
22
+ export type SkillIdempotencyMode = 'none' | 'required' | 'lookup_before_retry' | 'provider_query';
23
+ export type SkillArtifactContract = 'none' | 'external_ref' | 'import_to_file_storage';
24
+ export declare const EMPLOYEE_SKILL_BLOCKER_CODES: readonly ["EMPLOYEE_SKILL_NOT_REGISTERED", "EMPLOYEE_SKILL_LIFECYCLE_NOT_RELEASED", "EMPLOYEE_SKILL_DESCRIPTOR_SCHEMA_VERSION_INVALID", "EMPLOYEE_SKILL_ID_INVALID", "EMPLOYEE_SKILL_GROUP_INVALID", "EMPLOYEE_SKILL_LIFECYCLE_STATUS_INVALID", "EMPLOYEE_SKILL_ADAPTER_NOT_REGISTERED", "EMPLOYEE_SKILL_ADAPTER_VERSION_AMBIGUOUS", "EMPLOYEE_SKILL_ADAPTER_HEALTH_BLOCKED", "EMPLOYEE_SKILL_ADAPTER_PROVIDER_MISMATCH", "EMPLOYEE_SKILL_ADAPTER_METADATA_MISMATCH", "EMPLOYEE_SKILL_AUTHORIZATION_OWNER_NOT_READY", "EMPLOYEE_SKILL_APPROVAL_OWNER_NOT_READY", "EMPLOYEE_SKILL_IDEMPOTENCY_OWNER_NOT_READY", "EMPLOYEE_SKILL_IDEMPOTENCY_KEY_REQUIRED", "EMPLOYEE_SKILL_IDEMPOTENCY_KEY_CONFLICT", "EMPLOYEE_SKILL_IDEMPOTENCY_RESULT_UNREPLAYABLE", "EMPLOYEE_SKILL_AUDIT_OWNER_NOT_READY", "EMPLOYEE_SKILL_RUNTIME_LINEAGE_NOT_READY", "EMPLOYEE_SKILL_RUNTIME_LINEAGE_MISMATCH", "EMPLOYEE_SKILL_CAPABILITY_NOT_REGISTERED", "EMPLOYEE_SKILL_CAPABILITY_BLOCKED", "EMPLOYEE_SKILL_CAPABILITY_AMBIGUOUS", "EMPLOYEE_SKILL_RATE_LIMITED", "EMPLOYEE_SKILL_CLI_EXECUTABLE_DIGEST_MISMATCH", "EMPLOYEE_SKILL_CLI_EXECUTABLE_NOT_ALLOWLISTED", "EMPLOYEE_SKILL_TRANSPORT_OWNER_NOT_READY", "EMPLOYEE_SKILL_CONNECTION_NOT_READY", "EMPLOYEE_SKILL_SCOPE_NOT_ALLOWED", "EMPLOYEE_SKILL_APPROVAL_REQUIRED", "EMPLOYEE_SKILL_SCHEMA_DRIFT", "EMPLOYEE_SKILL_INPUT_SCHEMA_INVALID", "EMPLOYEE_SKILL_TIMEOUT", "EMPLOYEE_SKILL_UNKNOWN_OUTCOME", "EMPLOYEE_SKILL_VERIFICATION_OWNER_NOT_READY", "EMPLOYEE_SKILL_VERIFICATION_FAILED", "EMPLOYEE_SKILL_COMPOSITE_SCHEMA_DRIFT", "EMPLOYEE_SKILL_COMPOSITE_DEPENDENCY_INVALID", "EMPLOYEE_SKILL_COMPOSITE_DEPENDENCY_CYCLE", "EMPLOYEE_SKILL_ROLE_PACKAGE_SCHEMA_DRIFT", "EMPLOYEE_SKILL_BINDING_SCHEMA_DRIFT", "EMPLOYEE_SKILL_BINDING_REQUIRED", "EMPLOYEE_SKILL_BINDING_REVOKED", "EMPLOYEE_SKILL_BINDING_REVISION_MISMATCH", "EMPLOYEE_SKILL_BINDING_SCOPE_NOT_ALLOWED", "EMPLOYEE_SKILL_BINDING_PRODUCT_MISMATCH", "EMPLOYEE_SKILL_BINDING_TARGET_SCOPE_INVALID", "EMPLOYEE_SKILL_BINDING_ENABLEMENT_NOT_READY", "EMPLOYEE_SKILL_PROVIDER_SCOPE_EVIDENCE_REQUIRED", "EMPLOYEE_SKILL_PROVIDER_SCOPE_EVIDENCE_INVALID", "EMPLOYEE_SKILL_BINDING_APPROVAL_OWNER_NOT_READY", "EMPLOYEE_SKILL_BINDING_APPROVAL_REQUIRED", "EMPLOYEE_SKILL_BINDING_APPROVAL_MISMATCH", "EMPLOYEE_SKILL_BINDING_APPROVAL_NOT_APPROVED"];
25
+ export type EmployeeSkillBlockerCode = (typeof EMPLOYEE_SKILL_BLOCKER_CODES)[number];
26
+ export declare function isEmployeeSkillBlockerRetryable(code: EmployeeSkillBlockerCode): boolean;
27
+ export declare class EmployeeSkillBlockerError extends Error {
28
+ readonly code: EmployeeSkillBlockerCode;
29
+ readonly retryable: boolean;
30
+ constructor(code: EmployeeSkillBlockerCode);
31
+ }
32
+ export declare function employeeSkillBlocker(code: EmployeeSkillBlockerCode): EmployeeSkillBlockerError;
33
+ export interface SkillGroupDescriptor {
34
+ readonly groupId: SkillGroup;
35
+ readonly displayName: string;
36
+ readonly description: string;
37
+ readonly sortOrder: number;
38
+ readonly defaultFamilies: readonly string[];
39
+ }
40
+ export declare const DEFAULT_SKILL_GROUPS: readonly SkillGroupDescriptor[];
41
+ export interface SkillVerificationContract {
42
+ readonly required: boolean;
43
+ readonly checks: readonly string[];
44
+ }
45
+ export interface SkillAdapterDescriptor {
46
+ readonly adapterId: string;
47
+ readonly providerFamily: EmployeeSkillProviderFamily;
48
+ readonly product: string;
49
+ readonly adapterVersion: string;
50
+ readonly transport: SkillTransportKind;
51
+ readonly executableRef?: string;
52
+ readonly supportedSkills: readonly string[];
53
+ readonly capabilityProbeRef: string;
54
+ readonly authBindingType: string;
55
+ readonly credentialRequirements: readonly string[];
56
+ readonly scopes: readonly string[];
57
+ readonly dataResidency: string;
58
+ readonly rateLimit: {
59
+ readonly maxRequests: number;
60
+ readonly windowMs: number;
61
+ };
62
+ readonly idempotencySupport: SkillAdapterIdempotencySupport;
63
+ readonly artifactReferenceSupport: SkillArtifactContract;
64
+ readonly verificationSupport: readonly string[];
65
+ readonly compensationSupport: SkillAdapterCompensationSupport;
66
+ readonly owner: string;
67
+ readonly rollbackOwner: string;
68
+ readonly evidenceRefs: readonly string[];
69
+ readonly healthStatus: SkillAdapterHealthStatus;
70
+ }
71
+ export type AdapterDescriptor = SkillAdapterDescriptor;
72
+ export interface SkillCapabilityMatrixEntry {
73
+ readonly skillId: string;
74
+ readonly providerFamily: EmployeeSkillProviderFamily;
75
+ readonly product: string;
76
+ readonly adapterId: string;
77
+ readonly adapterVersion: string;
78
+ readonly operationId: string;
79
+ readonly operationVersion: string;
80
+ readonly transport: SkillTransportKind;
81
+ readonly requiredScopes: readonly string[];
82
+ readonly capabilityLimits: readonly string[];
83
+ readonly availability: SkillCapabilityAvailability;
84
+ }
85
+ export interface SkillDescriptor {
86
+ readonly skillId: string;
87
+ readonly schemaVersion: typeof EMPLOYEE_SKILL_DESCRIPTOR_SCHEMA_VERSION;
88
+ readonly title: string;
89
+ readonly description: string;
90
+ readonly group: SkillGroup;
91
+ readonly lifecycleStatus: SkillLifecycleStatus;
92
+ readonly family: string;
93
+ readonly inputSchema: Readonly<Record<string, unknown>>;
94
+ readonly outputSchema: Readonly<Record<string, unknown>>;
95
+ readonly supportedProviders: readonly EmployeeSkillProviderFamily[];
96
+ readonly requiredCapabilities: readonly string[];
97
+ readonly sideEffectClass: SkillSideEffectClass;
98
+ readonly riskLevel: string;
99
+ readonly approvalRequirement: SkillApprovalRequirement;
100
+ readonly idempotencyMode: SkillIdempotencyMode;
101
+ readonly verificationContract: SkillVerificationContract;
102
+ readonly artifactContract: SkillArtifactContract;
103
+ readonly learningSignals: readonly string[];
104
+ readonly owner: string;
105
+ readonly publication: {
106
+ readonly releaseGate: string;
107
+ readonly rollbackOwner: string;
108
+ };
109
+ }
110
+ /** Catalog-only candidate. It may name intended providers without claiming
111
+ * that the skill is registered for runtime execution. */
112
+ export interface SkillCatalogCandidate {
113
+ readonly descriptor: SkillDescriptor;
114
+ readonly plannedProviders: readonly EmployeeSkillProviderFamily[];
115
+ }
116
+ export interface SkillCatalogProviderStatus {
117
+ readonly providerFamily: EmployeeSkillProviderFamily;
118
+ readonly capabilityStatus: SkillCatalogCapabilityStatus;
119
+ readonly adapterHealth: SkillCatalogAdapterHealthStatus;
120
+ readonly connectionStatus: SkillCatalogConnectionStatus;
121
+ }
122
+ export interface SkillCatalogSkill extends SkillDescriptor {
123
+ /** Provider status is a read-only projection and never changes execution resolution. */
124
+ readonly providerStatuses: readonly SkillCatalogProviderStatus[];
125
+ /** Intended provider families for development catalog candidates only. */
126
+ readonly plannedProviders?: readonly EmployeeSkillProviderFamily[];
127
+ }
128
+ export interface SkillCatalogReadModel {
129
+ readonly schemaVersion: typeof EMPLOYEE_SKILL_CATALOG_SCHEMA_VERSION;
130
+ readonly groups: readonly SkillGroupDescriptor[];
131
+ readonly skills: readonly SkillCatalogSkill[];
132
+ }
133
+ export interface SkillInvocation {
134
+ readonly schemaVersion: typeof EMPLOYEE_SKILL_INVOCATION_SCHEMA_VERSION;
135
+ readonly invocationId: string;
136
+ readonly skillId: string;
137
+ readonly skillVersion: string;
138
+ readonly workspaceId: string;
139
+ readonly agentId: string;
140
+ /** Existing AgentExecution primary key for the invocation. */
141
+ readonly executionId: string;
142
+ /** Tool-call identity owned by the existing Agent Runtime. */
143
+ readonly toolCallId: string;
144
+ readonly callerUserId: string;
145
+ readonly providerFamily: EmployeeSkillProviderFamily;
146
+ readonly product: string;
147
+ readonly adapterId: string;
148
+ readonly adapterVersion: string;
149
+ readonly operationId: string;
150
+ readonly operationVersion: string;
151
+ readonly transport: SkillTransportKind;
152
+ readonly input: JsonValue;
153
+ readonly connectionId?: string;
154
+ /** User-selected employee skill binding; credentials never travel here. */
155
+ readonly bindingId?: string;
156
+ readonly bindingRevision?: number;
157
+ readonly targetScopeRef?: string;
158
+ readonly idempotencyKey?: string;
159
+ readonly approvalContext?: {
160
+ readonly approvalId: string;
161
+ readonly approvedBy: string;
162
+ };
163
+ readonly traceId: string;
164
+ }
165
+ export interface ExternalArtifactRef {
166
+ readonly schemaVersion: typeof EMPLOYEE_EXTERNAL_ARTIFACT_REF_SCHEMA_VERSION;
167
+ readonly providerFamily: EmployeeSkillProviderFamily;
168
+ readonly adapterId: string;
169
+ readonly product: string;
170
+ readonly objectType: string;
171
+ readonly opaqueObjectId: string;
172
+ readonly revision: string;
173
+ readonly workspaceId: string;
174
+ readonly permissionContextHash: string;
175
+ readonly createdByExecutionId: string;
176
+ readonly canonicalUrl?: string;
177
+ }
178
+ export interface SkillResult {
179
+ readonly schemaVersion: typeof EMPLOYEE_SKILL_RESULT_SCHEMA_VERSION;
180
+ readonly status: SkillResultStatus;
181
+ readonly providerReceipt?: JsonValue;
182
+ readonly artifacts: readonly ExternalArtifactRef[];
183
+ readonly importedContentDocumentIds?: readonly string[];
184
+ readonly verification: {
185
+ readonly status: SkillVerificationStatus;
186
+ readonly evidenceRefs: readonly string[];
187
+ };
188
+ readonly blockerCode?: EmployeeSkillBlockerCode;
189
+ readonly retryable: boolean;
190
+ }
191
+ export declare function assertValidSkillInvocation(value: unknown): asserts value is SkillInvocation;
192
+ export declare function assertValidExternalArtifactRef(value: unknown): asserts value is ExternalArtifactRef;
193
+ export declare function assertValidSkillResult(value: unknown): asserts value is SkillResult;
194
+ export declare function isSkillGroup(value: unknown): value is SkillGroup;
195
+ export declare function isSkillLifecycleStatus(value: unknown): value is SkillLifecycleStatus;
196
+ export declare function assertValidSkillDescriptor(descriptor: SkillDescriptor): void;
197
+ export declare function assertReleasedSkill(descriptor: Pick<SkillDescriptor, 'lifecycleStatus'>): void;