@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,163 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.EMPLOYEE_SKILL_PROVIDER_SCOPE_EVIDENCE_SCHEMA_VERSION = void 0;
4
+ exports.employeeSkillBindingProductForSkill = employeeSkillBindingProductForSkill;
5
+ exports.employeeSkillBindingTargetResourceTypes = employeeSkillBindingTargetResourceTypes;
6
+ exports.assertValidEmployeeSkillBinding = assertValidEmployeeSkillBinding;
7
+ exports.assertValidEmployeeSkillProviderScopeEvidence = assertValidEmployeeSkillProviderScopeEvidence;
8
+ exports.assertEmployeeSkillBindingTargetScope = assertEmployeeSkillBindingTargetScope;
9
+ exports.assertEmployeeSkillBindingProviderScopeEvidence = assertEmployeeSkillBindingProviderScopeEvidence;
10
+ exports.assertEmployeeSkillBindingUsable = assertEmployeeSkillBindingUsable;
11
+ const contract_versions_1 = require("./contract-versions");
12
+ const employee_skill_types_1 = require("./employee-skill.types");
13
+ exports.EMPLOYEE_SKILL_PROVIDER_SCOPE_EVIDENCE_SCHEMA_VERSION = 'nexusclaw.employee-skill-provider-scope-evidence/v1';
14
+ const PRODUCT_BY_SKILL_FAMILY = Object.freeze({
15
+ document: 'docs',
16
+ presentation: 'presentation',
17
+ spreadsheet: 'spreadsheet',
18
+ business_table: 'aitable',
19
+ mail: 'mail',
20
+ calendar: 'calendar',
21
+ task: 'task',
22
+ chat: 'chat',
23
+ file: 'file',
24
+ research: 'research',
25
+ social: 'social',
26
+ });
27
+ const TARGET_RESOURCE_TYPES_BY_SKILL_FAMILY = Object.freeze({
28
+ document: Object.freeze(['document', 'folder', 'workspace']),
29
+ presentation: Object.freeze(['presentation', 'folder', 'workspace']),
30
+ spreadsheet: Object.freeze(['spreadsheet', 'sheet', 'workspace']),
31
+ business_table: Object.freeze(['base', 'table', 'view', 'workspace']),
32
+ mail: Object.freeze(['mailbox', 'message', 'workspace']),
33
+ calendar: Object.freeze(['calendar', 'workspace']),
34
+ task: Object.freeze(['project', 'task', 'workspace']),
35
+ chat: Object.freeze(['conversation', 'workspace']),
36
+ file: Object.freeze(['file', 'folder', 'workspace']),
37
+ research: Object.freeze(['workspace']),
38
+ social: Object.freeze(['account', 'workspace']),
39
+ });
40
+ function skillFamily(skillId) {
41
+ return skillId.split('.')[0] ?? '';
42
+ }
43
+ function employeeSkillBindingProductForSkill(skillId) {
44
+ return PRODUCT_BY_SKILL_FAMILY[skillFamily(skillId)] ?? null;
45
+ }
46
+ function employeeSkillBindingTargetResourceTypes(skillId) {
47
+ return TARGET_RESOURCE_TYPES_BY_SKILL_FAMILY[skillFamily(skillId)] ?? null;
48
+ }
49
+ const IDENTIFIER = /^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/;
50
+ function text(value) {
51
+ return typeof value === 'string' && value.trim().length > 0;
52
+ }
53
+ function hasOnlyKeys(value, keys) {
54
+ const allowed = new Set(keys);
55
+ return Object.keys(value).every((key) => allowed.has(key));
56
+ }
57
+ function isStatus(value) {
58
+ return value === 'draft' || value === 'enabled' || value === 'disabled' || value === 'revoked';
59
+ }
60
+ function assertValidEmployeeSkillBinding(value) {
61
+ const binding = value;
62
+ const scope = binding?.targetScope;
63
+ if (!binding ||
64
+ !hasOnlyKeys(binding, [
65
+ 'schemaVersion', 'bindingId', 'workspaceId', 'agentId', 'skillId',
66
+ 'connectionId', 'providerWorkspaceRef', 'name', 'targetScope',
67
+ 'defaultTargetRef', 'operationScopes', 'approvalPolicyRef', 'revision', 'status',
68
+ 'providerScopeEvidence',
69
+ ]) ||
70
+ binding.schemaVersion !== contract_versions_1.EMPLOYEE_SKILL_BINDING_SCHEMA_VERSION ||
71
+ !text(binding.bindingId) || !text(binding.workspaceId) || !text(binding.agentId) ||
72
+ !IDENTIFIER.test(binding.skillId ?? '') || !text(binding.connectionId) ||
73
+ !text(binding.providerWorkspaceRef) || !text(binding.name) || !text(binding.approvalPolicyRef) ||
74
+ !Number.isInteger(binding.revision) || binding.revision < 1 || !isStatus(binding.status) ||
75
+ !Array.isArray(binding.operationScopes) ||
76
+ !binding.operationScopes.every((scopeName) => text(scopeName) && IDENTIFIER.test(scopeName)) ||
77
+ !scope || !hasOnlyKeys(scope, ['product', 'resourceType', 'opaqueResourceId', 'allowDescendants']) ||
78
+ !text(scope.product) || !text(scope.resourceType) || !text(scope.opaqueResourceId) ||
79
+ typeof scope.allowDescendants !== 'boolean' ||
80
+ (binding.defaultTargetRef !== undefined && !text(binding.defaultTargetRef))) {
81
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_BINDING_SCHEMA_DRIFT');
82
+ }
83
+ if (binding.providerScopeEvidence !== undefined) {
84
+ assertValidEmployeeSkillProviderScopeEvidence(binding.providerScopeEvidence);
85
+ }
86
+ }
87
+ function assertValidEmployeeSkillProviderScopeEvidence(value) {
88
+ const evidence = value;
89
+ const digest = evidence?.capabilityDigest;
90
+ const observedAt = typeof evidence?.observedAt === 'string' ? Date.parse(evidence.observedAt) : Number.NaN;
91
+ if (!evidence ||
92
+ !hasOnlyKeys(evidence, [
93
+ 'schemaVersion', 'providerFamily', 'product', 'providerWorkspaceRef',
94
+ 'targetScopeRef', 'capabilityDigest', 'operationScopes', 'observedAt',
95
+ ]) ||
96
+ evidence.schemaVersion !== exports.EMPLOYEE_SKILL_PROVIDER_SCOPE_EVIDENCE_SCHEMA_VERSION ||
97
+ !['dingtalk', 'feishu', 'tencent'].includes(evidence.providerFamily ?? '') ||
98
+ !text(evidence.product) ||
99
+ !text(evidence.providerWorkspaceRef) ||
100
+ !text(evidence.targetScopeRef) ||
101
+ typeof digest !== 'string' ||
102
+ !/^sha256:[0-9a-f]{64}$/.test(digest) ||
103
+ !Array.isArray(evidence.operationScopes) ||
104
+ !evidence.operationScopes.every((scope) => text(scope) && IDENTIFIER.test(scope)) ||
105
+ !Number.isFinite(observedAt)) {
106
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_PROVIDER_SCOPE_EVIDENCE_INVALID');
107
+ }
108
+ }
109
+ /**
110
+ * Validates the product and target-scope portion of a binding against the
111
+ * canonical skill family. Provider capability and ancestry evidence remain
112
+ * backend owner responsibilities; this guard only rejects impossible or
113
+ * mismatched client contracts.
114
+ */
115
+ function assertEmployeeSkillBindingTargetScope(binding) {
116
+ assertValidEmployeeSkillBinding(binding);
117
+ const expectedProduct = employeeSkillBindingProductForSkill(binding.skillId);
118
+ if (expectedProduct && binding.targetScope.product !== expectedProduct) {
119
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_BINDING_PRODUCT_MISMATCH');
120
+ }
121
+ const allowedResourceTypes = employeeSkillBindingTargetResourceTypes(binding.skillId);
122
+ if (allowedResourceTypes &&
123
+ !allowedResourceTypes.includes(binding.targetScope.resourceType)) {
124
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_BINDING_TARGET_SCOPE_INVALID');
125
+ }
126
+ if (binding.targetScope.resourceType === 'document' &&
127
+ binding.targetScope.allowDescendants) {
128
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_BINDING_TARGET_SCOPE_INVALID');
129
+ }
130
+ if (binding.defaultTargetRef !== undefined &&
131
+ binding.defaultTargetRef !== binding.targetScope.opaqueResourceId) {
132
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_BINDING_TARGET_SCOPE_INVALID');
133
+ }
134
+ }
135
+ function assertEmployeeSkillBindingProviderScopeEvidence(binding) {
136
+ if (!binding.providerScopeEvidence) {
137
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_PROVIDER_SCOPE_EVIDENCE_REQUIRED');
138
+ }
139
+ assertValidEmployeeSkillProviderScopeEvidence(binding.providerScopeEvidence);
140
+ const evidence = binding.providerScopeEvidence;
141
+ const bindingOperationScopes = new Set(binding.operationScopes);
142
+ const evidenceOperationScopes = new Set(evidence.operationScopes);
143
+ if (evidence.product !== binding.targetScope.product ||
144
+ evidence.providerWorkspaceRef !== binding.providerWorkspaceRef ||
145
+ evidence.targetScopeRef !== binding.targetScope.opaqueResourceId ||
146
+ bindingOperationScopes.size !== evidenceOperationScopes.size ||
147
+ [...bindingOperationScopes].some((scope) => !evidenceOperationScopes.has(scope))) {
148
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_PROVIDER_SCOPE_EVIDENCE_INVALID');
149
+ }
150
+ }
151
+ function assertEmployeeSkillBindingUsable(binding, expectedRevision) {
152
+ assertValidEmployeeSkillBinding(binding);
153
+ if (binding.status === 'revoked' || binding.status === 'disabled') {
154
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_BINDING_REVOKED');
155
+ }
156
+ if (binding.status !== 'enabled') {
157
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_BINDING_REQUIRED');
158
+ }
159
+ if (binding.revision !== expectedRevision) {
160
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_BINDING_REVISION_MISMATCH');
161
+ }
162
+ }
163
+ //# sourceMappingURL=employee-skill-binding.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"employee-skill-binding.types.js","sourceRoot":"","sources":["../../src/agent-executable-assets/employee-skill-binding.types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ import { EMPLOYEE_SKILL_COMPOSITE_SCHEMA_VERSION, EMPLOYEE_SKILL_ROLE_PACKAGE_SCHEMA_VERSION } from './contract-versions';
2
+ export type CompositeApprovalPoint = 'none' | 'before' | 'after';
3
+ export type CompositeCompensationKind = 'none' | 'manual' | 'atomic_skill';
4
+ export interface EmployeeSkillCompositeStepV1 {
5
+ readonly stepId: string;
6
+ /** Canonical atomic skill id; never a provider operation or endpoint. */
7
+ readonly skillId: string;
8
+ readonly dependsOn: readonly string[];
9
+ readonly approvalPoint: CompositeApprovalPoint;
10
+ /** Canonical external write intents, e.g. `calendar.event.create`. */
11
+ readonly writeSet: readonly string[];
12
+ readonly compensation: {
13
+ readonly kind: CompositeCompensationKind;
14
+ readonly skillId?: string;
15
+ readonly actionKey?: string;
16
+ };
17
+ }
18
+ /**
19
+ * Portable composite skill plan. Provider resolution, authorization and
20
+ * execution remain owned by the atomic skill resolver and Agent Runtime.
21
+ */
22
+ export interface EmployeeSkillCompositeV1 {
23
+ readonly schemaVersion: typeof EMPLOYEE_SKILL_COMPOSITE_SCHEMA_VERSION;
24
+ readonly compositeSkillId: string;
25
+ readonly version: string;
26
+ readonly title: string;
27
+ readonly description: string;
28
+ readonly steps: readonly EmployeeSkillCompositeStepV1[];
29
+ readonly successCriteria: readonly string[];
30
+ readonly owner: string;
31
+ readonly publication: {
32
+ readonly releaseGate: string;
33
+ readonly rollbackOwner: string;
34
+ };
35
+ }
36
+ /**
37
+ * Portable role package. It contains only canonical skill ids and policy
38
+ * references; it deliberately has no agent identity, provider endpoint or
39
+ * credential fields.
40
+ */
41
+ export interface EmployeeSkillRolePackageV1 {
42
+ readonly schemaVersion: typeof EMPLOYEE_SKILL_ROLE_PACKAGE_SCHEMA_VERSION;
43
+ readonly rolePackageId: string;
44
+ readonly version: string;
45
+ readonly title: string;
46
+ readonly description: string;
47
+ readonly atomicSkillIds: readonly string[];
48
+ readonly compositeSkillIds: readonly string[];
49
+ readonly policyRefs: readonly string[];
50
+ readonly guardrailRefs: readonly string[];
51
+ }
52
+ export declare function assertValidEmployeeSkillComposite(value: unknown): asserts value is EmployeeSkillCompositeV1;
53
+ export declare function assertValidEmployeeSkillRolePackage(value: unknown): asserts value is EmployeeSkillRolePackageV1;
@@ -0,0 +1,179 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.assertValidEmployeeSkillComposite = assertValidEmployeeSkillComposite;
4
+ exports.assertValidEmployeeSkillRolePackage = assertValidEmployeeSkillRolePackage;
5
+ const contract_versions_1 = require("./contract-versions");
6
+ const employee_skill_types_1 = require("./employee-skill.types");
7
+ const IDENTIFIER = /^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/;
8
+ const PROVIDER_ENDPOINT = /(?:^|\b)(?:https?:\/\/|mcp:\/\/|api\.|endpoint:|server:)/i;
9
+ function assertValidEmployeeSkillComposite(value) {
10
+ const composite = value;
11
+ if (!composite ||
12
+ !hasOnlyKeys(composite, [
13
+ 'schemaVersion',
14
+ 'compositeSkillId',
15
+ 'version',
16
+ 'title',
17
+ 'description',
18
+ 'steps',
19
+ 'successCriteria',
20
+ 'owner',
21
+ 'publication',
22
+ ]) ||
23
+ composite.schemaVersion !== contract_versions_1.EMPLOYEE_SKILL_COMPOSITE_SCHEMA_VERSION ||
24
+ !isIdentifier(composite.compositeSkillId) ||
25
+ !hasText(composite.version) ||
26
+ !hasText(composite.title) ||
27
+ !hasText(composite.description) ||
28
+ !Array.isArray(composite.steps) ||
29
+ composite.steps.length === 0 ||
30
+ !Array.isArray(composite.successCriteria) ||
31
+ !composite.successCriteria.length ||
32
+ !composite.successCriteria.every(isSafeText) ||
33
+ !hasText(composite.owner) ||
34
+ !composite.publication ||
35
+ !hasText(composite.publication.releaseGate) ||
36
+ !hasText(composite.publication.rollbackOwner)) {
37
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_COMPOSITE_SCHEMA_DRIFT');
38
+ }
39
+ const steps = composite.steps;
40
+ const stepIds = new Set();
41
+ for (const step of steps) {
42
+ if (!step ||
43
+ !hasOnlyKeys(step, [
44
+ 'stepId',
45
+ 'skillId',
46
+ 'dependsOn',
47
+ 'approvalPoint',
48
+ 'writeSet',
49
+ 'compensation',
50
+ ]) ||
51
+ !isIdentifier(step.stepId) ||
52
+ stepIds.has(step.stepId) ||
53
+ !isIdentifier(step.skillId) ||
54
+ !Array.isArray(step.dependsOn) ||
55
+ !step.dependsOn.every(isIdentifier) ||
56
+ step.dependsOn.includes(step.stepId) ||
57
+ !isApprovalPoint(step.approvalPoint) ||
58
+ !Array.isArray(step.writeSet) ||
59
+ !step.writeSet.every(isSafeText) ||
60
+ !isCompensation(step.compensation)) {
61
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_COMPOSITE_SCHEMA_DRIFT');
62
+ }
63
+ stepIds.add(step.stepId);
64
+ }
65
+ for (const step of steps) {
66
+ if (step.dependsOn.some((dependency) => !stepIds.has(dependency))) {
67
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_COMPOSITE_DEPENDENCY_INVALID');
68
+ }
69
+ }
70
+ assertAcyclic(steps);
71
+ }
72
+ function assertValidEmployeeSkillRolePackage(value) {
73
+ const rolePackage = value;
74
+ if (!rolePackage ||
75
+ !hasOnlyKeys(rolePackage, [
76
+ 'schemaVersion',
77
+ 'rolePackageId',
78
+ 'version',
79
+ 'title',
80
+ 'description',
81
+ 'atomicSkillIds',
82
+ 'compositeSkillIds',
83
+ 'policyRefs',
84
+ 'guardrailRefs',
85
+ ]) ||
86
+ rolePackage.schemaVersion !== contract_versions_1.EMPLOYEE_SKILL_ROLE_PACKAGE_SCHEMA_VERSION ||
87
+ !isIdentifier(rolePackage.rolePackageId) ||
88
+ !hasText(rolePackage.version) ||
89
+ !hasText(rolePackage.title) ||
90
+ !hasText(rolePackage.description) ||
91
+ !isIdentifierArray(rolePackage.atomicSkillIds) ||
92
+ !isIdentifierArray(rolePackage.compositeSkillIds) ||
93
+ (rolePackage.atomicSkillIds.length === 0 &&
94
+ rolePackage.compositeSkillIds.length === 0) ||
95
+ !hasNoDuplicates([
96
+ ...rolePackage.atomicSkillIds,
97
+ ...rolePackage.compositeSkillIds,
98
+ ]) ||
99
+ !isSafeTextArray(rolePackage.policyRefs) ||
100
+ !isSafeTextArray(rolePackage.guardrailRefs) ||
101
+ hasForbiddenRolePackageKeys(rolePackage)) {
102
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_ROLE_PACKAGE_SCHEMA_DRIFT');
103
+ }
104
+ }
105
+ function assertAcyclic(steps) {
106
+ const byId = new Map(steps.map((step) => [step.stepId, step]));
107
+ const visiting = new Set();
108
+ const visited = new Set();
109
+ const visit = (stepId) => {
110
+ if (visiting.has(stepId)) {
111
+ throw (0, employee_skill_types_1.employeeSkillBlocker)('EMPLOYEE_SKILL_COMPOSITE_DEPENDENCY_CYCLE');
112
+ }
113
+ if (visited.has(stepId))
114
+ return;
115
+ visiting.add(stepId);
116
+ for (const dependency of byId.get(stepId).dependsOn)
117
+ visit(dependency);
118
+ visiting.delete(stepId);
119
+ visited.add(stepId);
120
+ };
121
+ for (const step of steps)
122
+ visit(step.stepId);
123
+ }
124
+ function isCompensation(value) {
125
+ if (!value || typeof value !== 'object' || Array.isArray(value))
126
+ return false;
127
+ if (!hasOnlyKeys(value, ['kind', 'skillId', 'actionKey']))
128
+ return false;
129
+ const compensation = value;
130
+ if (!isCompensationKind(compensation.kind))
131
+ return false;
132
+ if (compensation.kind === 'atomic_skill')
133
+ return isIdentifier(compensation.skillId);
134
+ if (compensation.kind === 'manual')
135
+ return isSafeText(compensation.actionKey);
136
+ return compensation.skillId === undefined && compensation.actionKey === undefined;
137
+ }
138
+ function isCompensationKind(value) {
139
+ return value === 'none' || value === 'manual' || value === 'atomic_skill';
140
+ }
141
+ function isApprovalPoint(value) {
142
+ return value === 'none' || value === 'before' || value === 'after';
143
+ }
144
+ function isIdentifierArray(value) {
145
+ return Array.isArray(value) && value.every(isIdentifier);
146
+ }
147
+ function hasNoDuplicates(values) {
148
+ return new Set(values).size === values.length;
149
+ }
150
+ function hasForbiddenRolePackageKeys(value) {
151
+ return [
152
+ 'agentKind',
153
+ 'isAssistant',
154
+ 'identityType',
155
+ 'serviceUserId',
156
+ 'roleId',
157
+ 'providerEndpoint',
158
+ 'credential',
159
+ ].some((key) => Object.prototype.hasOwnProperty.call(value, key));
160
+ }
161
+ function hasOnlyKeys(value, allowed) {
162
+ return (value !== null &&
163
+ typeof value === 'object' &&
164
+ !Array.isArray(value) &&
165
+ Object.keys(value).every((key) => allowed.includes(key)));
166
+ }
167
+ function isSafeTextArray(value) {
168
+ return Array.isArray(value) && value.every(isSafeText);
169
+ }
170
+ function isIdentifier(value) {
171
+ return typeof value === 'string' && IDENTIFIER.test(value);
172
+ }
173
+ function isSafeText(value) {
174
+ return hasText(value) && !PROVIDER_ENDPOINT.test(value);
175
+ }
176
+ function hasText(value) {
177
+ return typeof value === 'string' && value.trim().length > 0;
178
+ }
179
+ //# sourceMappingURL=employee-skill-composite.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"employee-skill-composite.types.js","sourceRoot":"","sources":["../../src/agent-executable-assets/employee-skill-composite.types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import { type SkillCatalogCandidate } from './employee-skill.types';
2
+ /**
3
+ * The first customer-facing catalog slice. Every entry is explicitly
4
+ * development-only until a package supplies a provider adapter, capability
5
+ * evidence, connection probe and release-gate receipt.
6
+ */
7
+ export declare const DEFAULT_EMPLOYEE_SKILL_CATALOG_CANDIDATES: readonly SkillCatalogCandidate[];