@aiwg/cli 2026.11.3 → 2026.11.5

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/agentic/code/addons/aiwg-hooks/canonical/aiwg-prompt-discovery.yaml +3 -2
  2. package/agentic/code/addons/aiwg-hooks/hooks/aiwg-prompt-discovery.cjs +12 -9
  3. package/agentic/code/addons/aiwg-utils/rules/anti-laziness.md +2 -0
  4. package/agentic/code/addons/composition-engine/lib/runtime.mjs +5 -26
  5. package/agentic/code/addons/composition-engine/schemas/flow-graph.schema.json +22 -0
  6. package/agentic/code/providers/capability-matrix.yaml +85 -18
  7. package/agentic/code/providers/model-capabilities.v1.json +35 -27
  8. package/dist/src/a2a/hitl-authorization.js +46 -0
  9. package/dist/src/a2a/hitl-driver.js +5 -5
  10. package/dist/src/artifacts/browser-export.js +2 -0
  11. package/dist/src/artifacts/framework-source-digest.js +1 -1
  12. package/dist/src/artifacts/index-builder.js +9 -27
  13. package/dist/src/artifacts/index-capability.js +24 -0
  14. package/dist/src/artifacts/query-engine-discover-output.js +8 -3
  15. package/dist/src/artifacts/query-engine-rules.js +29 -11
  16. package/dist/src/artifacts/query-engine-scoring.js +5 -5
  17. package/dist/src/artifacts/query-engine-show-card.js +5 -1
  18. package/dist/src/artifacts/query-engine-show-load.js +1 -1
  19. package/dist/src/artifacts/query-engine-show.js +3 -3
  20. package/dist/src/artifacts/query-engine-templates.js +10 -4
  21. package/dist/src/artifacts/query-engine-verbose.js +18 -4
  22. package/dist/src/artifacts/relations-builder.js +1 -0
  23. package/dist/src/artifacts/types.js +1 -1
  24. package/dist/src/cli/handlers/checkpoint-handoff.js +2 -1
  25. package/dist/src/cli/handlers/guided-setup.js +3 -1
  26. package/dist/src/cli/handlers/refresh-managed-deployment.js +17 -5
  27. package/dist/src/cli/handlers/rules.js +1 -1
  28. package/dist/src/cli/handlers/script-runner.js +7 -4
  29. package/dist/src/cli/handlers/sessions.js +1 -1
  30. package/dist/src/cli/handlers/steward-format.js +12 -0
  31. package/dist/src/cli/handlers/steward.js +1 -1
  32. package/dist/src/cli/handlers/use.js +14 -6
  33. package/dist/src/cli/handlers/utility-doctor.js +9 -2
  34. package/dist/src/cli/handlers/workspace.js +1 -1
  35. package/dist/src/cli/services/deployment-probe-scope.js +40 -0
  36. package/dist/src/cli/services/deployment-verification.js +4 -5
  37. package/dist/src/config/aiwg-config.js +6 -0
  38. package/dist/src/config/authorization-cli.js +61 -3
  39. package/dist/src/config/cli-help.js +1 -1
  40. package/dist/src/config/cli.js +4 -2
  41. package/dist/src/config/host-resource-runtime.mjs +1 -1
  42. package/dist/src/config/user-registry.js +9 -1
  43. package/dist/src/config/worker-owner-lock.js +90 -10
  44. package/dist/src/decision/graph-flow-adapter.js +1 -1
  45. package/dist/src/effects/authorization-grant.js +50 -0
  46. package/dist/src/effects/authorization-store.js +130 -0
  47. package/dist/src/effects/index.js +2 -0
  48. package/dist/src/effects/ledger.js +1 -0
  49. package/dist/src/effects/lifecycle.js +1 -1
  50. package/dist/src/effects/reader.js +4 -0
  51. package/dist/src/effects/records.js +4 -0
  52. package/dist/src/effects/schema.js +2 -0
  53. package/dist/src/extensions/claude-hooks-installer.js +7 -7
  54. package/dist/src/extensions/manifest.js +6 -0
  55. package/dist/src/extensions/muse-managed-hooks.js +11 -0
  56. package/dist/src/extensions/project-local-discovery.js +21 -1
  57. package/dist/src/extensions/project-local-scaffold.js +19 -7
  58. package/dist/src/extensions/user-hook-diagnostics.js +32 -0
  59. package/dist/src/extensions/verified-hook-command.js +32 -0
  60. package/dist/src/lint/rule-conflicts.js +52 -0
  61. package/dist/src/lint/runner.js +3 -0
  62. package/dist/src/mcp/cli.mjs +3 -1
  63. package/dist/src/mcp/elicitation.mjs +30 -0
  64. package/dist/src/mcp/grok-build-config.mjs +1 -1
  65. package/dist/src/mcp/muse-native-config.mjs +1 -0
  66. package/dist/src/mcp/server.mjs +2 -0
  67. package/dist/src/mcp/tools/authorization.mjs +78 -0
  68. package/dist/src/models/factory-models.js +144 -0
  69. package/dist/src/models/model-capabilities.v1.json +35 -27
  70. package/dist/src/models/model-discovery.js +7 -3
  71. package/dist/src/models/worker-installation.d.mts +2 -0
  72. package/dist/src/models/worker-installation.mjs +11 -2
  73. package/dist/src/models/worker-invocation-policy.js +25 -1
  74. package/dist/src/models/wrapper-enforcement.js +1 -1
  75. package/dist/src/policy/authorization-capture.js +64 -0
  76. package/dist/src/policy/authorization-operations.js +108 -0
  77. package/dist/src/policy/hitl-check.js +3 -2
  78. package/dist/src/policy/hitl-consume.js +14 -0
  79. package/dist/src/policy/hitl-durable-store.js +60 -0
  80. package/dist/src/policy/hitl-durable.js +60 -0
  81. package/dist/src/policy/hitl-receipt.js +5 -0
  82. package/dist/src/policy/hitl.js +44 -6
  83. package/dist/src/policy/repo-access.js +3 -1
  84. package/dist/src/process/bounded-child-process.mjs +49 -39
  85. package/dist/src/providers/capability-matrix.yaml +85 -18
  86. package/dist/src/providers/deployment-ownership.d.mts +1 -0
  87. package/dist/src/providers/deployment-ownership.mjs +29 -3
  88. package/dist/src/providers/deployment-preservation.mjs +44 -3
  89. package/dist/src/providers/grok-build-acp.js +13 -5
  90. package/dist/src/providers/grok-build-dispatch.js +35 -2
  91. package/dist/src/providers/grok-build-headless.js +171 -77
  92. package/dist/src/providers/grok-build-inspect.js +1 -0
  93. package/dist/src/providers/grok-build-paths.js +2 -0
  94. package/dist/src/providers/muse-paths.js +4 -2
  95. package/dist/src/providers/provider-context-contracts.js +12 -4
  96. package/dist/src/providers/provider-definition-schema.js +6 -0
  97. package/dist/src/providers/provider-seeds-1.js +3 -3
  98. package/dist/src/providers/provider-seeds-2.js +6 -4
  99. package/dist/src/providers/provider-seeds-3.js +6 -6
  100. package/dist/src/rules/activation.d.mts +2 -0
  101. package/dist/src/rules/activation.mjs +16 -7
  102. package/dist/src/rules/inline-budget.d.mts +2 -1
  103. package/dist/src/rules/inline-budget.mjs +4 -2
  104. package/dist/src/rules/inventory.js +3 -0
  105. package/dist/src/rules/precedence.d.mts +6 -0
  106. package/dist/src/rules/precedence.mjs +49 -0
  107. package/dist/src/rules/project-precedence.js +73 -0
  108. package/dist/src/rules/rule-frontmatter.schema.json +15 -0
  109. package/dist/src/serve/a2a-terminal-observer.js +12 -3
  110. package/dist/src/serve/mission-hitl.js +20 -1
  111. package/dist/src/serve/worker-stdin-frame.mjs +1 -1
  112. package/dist/src/sessions/adapters/grok-build-fallback.js +33 -0
  113. package/dist/src/sessions/adapters/grok-build-native-records.js +134 -0
  114. package/dist/src/sessions/adapters/grok-build-native.js +237 -98
  115. package/dist/src/sessions/adapters/grok-build.js +95 -32
  116. package/dist/src/sessions/grok-build-cli-output.js +113 -0
  117. package/dist/src/sessions/grok-build-cli.js +4 -28
  118. package/dist/src/sessions/normalization.js +1 -1
  119. package/dist/src/smiths/context-pipeline/bridge-ownership.js +4 -3
  120. package/dist/src/smiths/context-pipeline/finalization.js +5 -0
  121. package/dist/src/smiths/context-pipeline/generator.js +1 -1
  122. package/dist/src/smiths/context-pipeline/workspace-bootstrap.js +20 -17
  123. package/dist/src/smiths/context-pipeline/workspace-doctor.js +6 -1
  124. package/dist/src/smiths/context-pipeline/workspace-document.js +6 -0
  125. package/dist/src/smiths/context-pipeline/workspace-migration.js +2 -12
  126. package/dist/src/smiths/hook-bridge/codex-translator.js +11 -14
  127. package/dist/src/smiths/hook-bridge/codex-trust.js +7 -2
  128. package/dist/src/smiths/hook-bridge/copilot-translator.js +2 -1
  129. package/dist/src/smiths/hook-bridge/factory-trust.js +2 -2
  130. package/dist/src/smiths/hook-bridge/grok-build-translator.js +3 -1
  131. package/dist/src/smiths/hook-bridge/hermes-prompt-discovery.js +81 -0
  132. package/dist/src/smiths/hook-bridge/hermes-translator.js +5 -3
  133. package/dist/src/smiths/hook-bridge/hermes-trust.js +65 -0
  134. package/dist/src/smiths/hook-bridge/index.js +3 -1
  135. package/dist/src/smiths/hook-bridge/prompt-discovery-gaps.js +3 -2
  136. package/package.json +7 -1
  137. package/tools/agents/deploy-agents.mjs +9 -8
  138. package/tools/agents/deploy-options.mjs +3 -0
  139. package/tools/agents/providers/base-frontmatter.mjs +3 -2
  140. package/tools/agents/providers/base-inventory.mjs +3 -1
  141. package/tools/agents/providers/base-kernel-skills.mjs +11 -5
  142. package/tools/agents/providers/claude-post-deploy.mjs +1 -1
  143. package/tools/agents/providers/codex-post-deploy.mjs +1 -1
  144. package/tools/agents/providers/generic.mjs +66 -0
  145. package/tools/agents/providers/grok-build.mjs +34 -41
  146. package/tools/agents/providers/model-wrapper.mjs +2 -5
  147. package/tools/agents/providers/muse-hooks.mjs +13 -11
  148. package/tools/agents/providers/muse-prompt-discovery.mjs +5 -1
  149. package/tools/agents/providers/muse.mjs +2 -1
  150. package/tools/agents/providers/openclaw.mjs +2 -1
  151. package/tools/agents/providers/rule-deployment-commit.mjs +3 -0
  152. package/tools/agents/providers/rule-deployment-prepare.mjs +7 -5
  153. package/tools/agents/providers/rule-deployment-state.mjs +14 -6
  154. package/tools/agents/providers/rule-projection.mjs +39 -4
  155. package/tools/agents/providers/rule-startup.mjs +11 -10
  156. package/tools/agents/providers/skill-copy-prune.mjs +12 -0
  157. package/tools/agents/providers/staged-directory-reference.mjs +14 -0
  158. package/tools/agents/providers/stale-artifact-prune.mjs +24 -10
  159. package/tools/agents/providers/user-hooks.mjs +26 -0
  160. package/tools/cli/authorization-health.mjs +20 -0
  161. package/tools/cli/workspace-status.mjs +7 -0
  162. package/tools/commands/deploy-prompts-codex.mjs +15 -1
  163. package/tools/ralph-external/lib/claude-adapter.mjs +2 -0
  164. package/tools/ralph-external/lib/factory-adapter.mjs +6 -2
  165. package/tools/ralph-external/lib/worker-inputs.mjs +20 -1
  166. package/tools/ralph-external/lib/worker-isolation.mjs +1 -0
  167. package/tools/ralph-external/lib/worker-termination.mjs +21 -12
  168. package/tools/ralph-external/session-launcher.mjs +22 -17
  169. package/vscode-extension/schemas/aiwg.config.v1.json +20 -0
@@ -1,10 +1,12 @@
1
1
  /** Configurable lint guard only. Call with the complete projected startup set. */
2
+ import { validateRulePrecedenceConfig } from './precedence.mjs';
3
+
2
4
  export const DEFAULT_RULES_INLINE_BUDGET_TOKENS = 64000;
3
5
 
4
6
  export function validateRulesConfig(rules) {
5
7
  if (rules === undefined) return [];
6
8
  if (rules === null || typeof rules !== 'object' || Array.isArray(rules)) return ['rules: must be an object'];
7
- const errors = Object.keys(rules).filter(key => !['inline_budget_tokens', 'always_load', 'pin_groups'].includes(key)).map(key => `rules.${key}: unknown field`);
9
+ const errors = Object.keys(rules).filter(key => !['inline_budget_tokens', 'always_load', 'pin_groups', 'precedence'].includes(key)).map(key => `rules.${key}: unknown field`);
8
10
  if (rules.inline_budget_tokens !== undefined && (!Number.isSafeInteger(rules.inline_budget_tokens) || rules.inline_budget_tokens < 0)) {
9
11
  errors.push('rules.inline_budget_tokens: must be a non-negative safe integer');
10
12
  }
@@ -27,7 +29,7 @@ export function validateRulesConfig(rules) {
27
29
  if (selector.group !== undefined && selector.capabilities !== undefined) errors.push('rules.always_load: group and capabilities are mutually exclusive');
28
30
  }
29
31
  }
30
- return errors;
32
+ return [...errors, ...validateRulePrecedenceConfig(rules.precedence)];
31
33
  }
32
34
 
33
35
  export function resolveRulesInlineBudget(config = {}, env = process.env) {
@@ -1,3 +1,5 @@
1
+ import { resolveRulePrecedence } from './precedence.mjs';
2
+ import { ruleOrderingAliases } from './project-precedence.js';
1
3
  import fs from 'node:fs';
2
4
  import path from 'node:path';
3
5
  import { loadRelations } from '../artifacts/relations.js';
@@ -116,6 +118,7 @@ export async function ruleInventory(cwd, root, options) {
116
118
  return [{ id: stableId, name: rule.name, capability: cap, source: rule.path, summary: parsed.rule.summary ?? null,
117
119
  configured: installed, configured_by: configuredBy, applicable: installed ? 'conditional' : 'not-configured',
118
120
  canonical_activation: canonical, effective_activation: installed ? effective : null,
121
+ ...resolveRulePrecedence({ ...parsed.rule, name: rule.name, id: stableId ?? undefined }, selected, ruleOrderingAliases(rule.path, root, cwd)),
119
122
  enforcement, pin_reasons: pin?.matches ?? [],
120
123
  bindings: relation ? relation[1].targets : null, binding_evidence: relation ? 'relationship-index' : 'unknown', bound_to: parsed.rule.bound_to, paths: parsed.rule.paths ?? [],
121
124
  fetch_command: stableId ? `aiwg show rule ${stableId} --body` : null,
@@ -0,0 +1,6 @@
1
+ import type { PinConfigs } from './pins.mjs';
2
+ export interface RuleOrdering { precedence?: unknown; overridable?: unknown; name?: string; id?: string }
3
+ export interface ResolvedRuleOrdering { precedence: string; overridable: boolean; precedence_source: string; project_context: boolean }
4
+ export function validateRulePrecedenceConfig(value: unknown): string[];
5
+ export function resolveRulePrecedence(rule: RuleOrdering, configs?: PinConfigs, aliases?: string[]): ResolvedRuleOrdering;
6
+ export const RULE_PRECEDENCE_TEXT: string;
@@ -0,0 +1,49 @@
1
+ // Resolve instruction ordering without changing activation, pinning, or enforcement.
2
+ import { RULE_PIN_TIERS } from './pins.mjs';
3
+
4
+ export function validateRulePrecedenceConfig(value) {
5
+ if (value === undefined) return [];
6
+ if (!value || typeof value !== 'object' || Array.isArray(value)) return ['rules.precedence: must be an object'];
7
+ const errors = [];
8
+ for (const [id, override] of Object.entries(value)) {
9
+ const label = `rules.precedence.${id}`;
10
+ if (!id.length || ['__proto__', 'prototype', 'constructor'].includes(id)) errors.push(`${label}: invalid rule id`);
11
+ if (!override || typeof override !== 'object' || Array.isArray(override) || !Object.keys(override).length) {
12
+ errors.push(`${label}: expected a non-empty override object`); continue;
13
+ }
14
+ for (const key of Object.keys(override)) if (!['tier', 'project_context'].includes(key)) errors.push(`${label}.${key}: unknown field`);
15
+ if (override.tier !== undefined && !RULE_PIN_TIERS.includes(override.tier)) errors.push(`${label}.tier: expected ${RULE_PIN_TIERS.join(', ')}`);
16
+ if (override.project_context !== undefined && typeof override.project_context !== 'boolean') errors.push(`${label}.project_context: must be a boolean`);
17
+ }
18
+ return errors;
19
+ }
20
+
21
+ /** IDs include a source slug and, when indexed, the stable rule identity. */
22
+ export function resolveRulePrecedence(rule, configs = { project: {}, user: {} }, aliases = []) {
23
+ if (rule.precedence !== undefined && !RULE_PIN_TIERS.includes(rule.precedence)) throw new Error(`Rule ${rule.name ?? rule.id}: invalid precedence`);
24
+ if (rule.overridable !== undefined && typeof rule.overridable !== 'boolean') throw new Error(`Rule ${rule.name ?? rule.id}: overridable must be a boolean`);
25
+ let result = { precedence: rule.precedence ?? 'medium', overridable: rule.overridable ?? true,
26
+ precedence_source: 'rule', project_context: false };
27
+ const ids = new Set([rule.name, rule.id, ...aliases].filter(Boolean));
28
+ for (const source of ['user', 'project']) {
29
+ const errors = validateRulePrecedenceConfig(configs[source]?.rules?.precedence);
30
+ if (errors.length) throw new Error(errors.join('\n'));
31
+ const matches = Object.entries(configs[source]?.rules?.precedence ?? {}).filter(([id]) => ids.has(id));
32
+ if (matches.length > 1) throw new Error(`Multiple precedence overrides name rule ${rule.name ?? rule.id} in ${source}`);
33
+ if (!matches.length) continue;
34
+ if (!result.overridable) throw new Error(`Rule ${rule.name ?? rule.id} is non-overridable (${source} rules.precedence)`);
35
+ const [, override] = matches[0];
36
+ result = { ...result, precedence: override.tier ?? result.precedence,
37
+ project_context: override.project_context ?? result.project_context, precedence_source: source };
38
+ }
39
+ return result;
40
+ }
41
+
42
+ export const RULE_PRECEDENCE_TEXT = [
43
+ 'A skill follows its bound rules, even when its own instructions conflict.',
44
+ 'Between rules, higher precedence wins: critical > high > medium > low (default medium).',
45
+ 'At equal precedence, the narrower scope wins. When resolving a conflict, name the rule followed.',
46
+ 'Only explicit rules.precedence overrides may let project context outrank a named overridable rule;',
47
+ 'non-overridable rules cannot be overridden or demoted. Other layer ordering and platform constraints stay unchanged.',
48
+ 'Effective project ordering and its source are listed in WORKSPACE.md; skills never weaken non-overridable rules.',
49
+ ].join('\n');
@@ -0,0 +1,73 @@
1
+ // Validate ordering against canonical rule sources, including installed project-local bundles.
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import { parseRuleFrontmatter } from './activation.mjs';
5
+ import { ruleFiles, rulePinState } from './pin-state.js';
6
+ import { loadRulePinConfigs } from './pins.mjs';
7
+ import { validateRulePrecedenceConfig } from './precedence.mjs';
8
+ import { resolveFrameworkIndexRoot } from '../artifacts/framework-index-paths.js';
9
+ import { stableRecordId } from '../artifacts/browser-export.js';
10
+ export function validateProjectRulePrecedence(cwd, config, source = 'project', userConfigDir) {
11
+ const overrides = config.rules?.precedence;
12
+ const errors = validateRulePrecedenceConfig(overrides);
13
+ if (errors.length || !overrides || !Object.keys(overrides).length)
14
+ return errors;
15
+ const root = resolveFrameworkIndexRoot(cwd);
16
+ const configs = loadRulePinConfigs(cwd, source === 'project' ? config : undefined, userConfigDir);
17
+ if (source === 'user')
18
+ configs.user = config;
19
+ const inventory = rulePinState(cwd, root, configs, true, false).inventory;
20
+ const files = new Map(inventory.map(rule => [rule.path, [rule.id, rule.name]]));
21
+ for (const kind of ['addons', 'frameworks', 'extensions']) {
22
+ const base = path.join(root, 'agentic/code', kind);
23
+ if (!fs.existsSync(base))
24
+ continue;
25
+ for (const name of fs.readdirSync(base))
26
+ for (const file of ruleFiles(path.join(base, name, 'rules'))) {
27
+ if (!files.has(file))
28
+ files.set(file, []);
29
+ }
30
+ }
31
+ const candidates = [...files].filter(([file]) => !/\.core\.md$|\/(?:README|RULES-INDEX|RULES-ONDEMAND)\.md$/.test(file)).map(([file, aliases]) => {
32
+ const parsed = parseRuleFrontmatter(fs.readFileSync(file, 'utf8'));
33
+ const slug = path.basename(file, '.md');
34
+ return { file, parsed, aliases: [...aliases, ...ruleOrderingAliases(file, root, cwd), String(parsed.data?.name ?? slug)] };
35
+ });
36
+ const selected = new Map();
37
+ for (const id of Object.keys(overrides)) {
38
+ const matches = candidates.filter(candidate => candidate.aliases.includes(id));
39
+ if (matches.length !== 1) {
40
+ errors.push(`rules.precedence.${id}: ${matches.length ? 'ambiguous' : 'unknown'} rule`);
41
+ continue;
42
+ }
43
+ const { parsed, file } = matches[0];
44
+ if (selected.has(file))
45
+ errors.push(`rules.precedence.${id}: duplicates override ${selected.get(file)} for the same rule`);
46
+ selected.set(file, id);
47
+ if (!parsed.valid)
48
+ errors.push(`${file}: ${parsed.diagnostics.map(item => item.message).join('; ')}`);
49
+ else if (!parsed.rule.overridable)
50
+ errors.push(`Rule ${id} is non-overridable (rules.precedence)`);
51
+ }
52
+ return errors;
53
+ }
54
+ /** Source slugs and stable IDs share the same override identity in every read surface. */
55
+ export function ruleOrderingAliases(file, root, cwd = root) {
56
+ const paths = [file, path.relative(root, file), path.relative(cwd, file)];
57
+ return [path.basename(file, '.md'), ...paths, ...paths.map(value => stableRecordId('aiwg.rule', value))];
58
+ }
59
+ /** Render operator ordering where agents already load project context. */
60
+ export function projectRulePrecedenceText(cwd) {
61
+ const configs = loadRulePinConfigs(cwd);
62
+ const lines = [];
63
+ for (const source of ['user', 'project']) {
64
+ const errors = validateProjectRulePrecedence(cwd, configs[source], source);
65
+ if (errors.length)
66
+ throw new Error(errors.join('\n'));
67
+ for (const [id, override] of Object.entries(configs[source].rules?.precedence ?? {})) {
68
+ lines.push(`- Rule ${id}: ${override.tier ? `precedence ${override.tier}; ` : ''}${override.project_context === undefined ? '' : `project context outranks rule: ${override.project_context}; `}source: ${source} rules.precedence.`);
69
+ }
70
+ }
71
+ return lines.length ? `Configured rule ordering (project entries override user entries):\n${lines.join('\n')}` : '';
72
+ }
73
+ //# sourceMappingURL=project-precedence.js.map
@@ -9,6 +9,21 @@
9
9
  ],
10
10
  "additionalProperties": true,
11
11
  "properties": {
12
+ "precedence": {
13
+ "type": "string",
14
+ "enum": ["critical", "high", "medium", "low"],
15
+ "default": "medium",
16
+ "description": "Conflict ordering, using RULE_PIN_TIERS vocabulary; independent of enforcement and activation."
17
+ },
18
+ "overridable": {
19
+ "type": "boolean",
20
+ "default": true,
21
+ "description": "Whether project or user ordering may override this rule."
22
+ },
23
+ "enforcement": {
24
+ "type": "string",
25
+ "enum": ["critical", "high", "medium", "low"]
26
+ },
12
27
  "activation": {
13
28
  "type": "string",
14
29
  "enum": [
@@ -11,6 +11,7 @@
11
11
  import { A2AClient, A2A_HITL_PROMPT_V1 } from '../a2a/client.js';
12
12
  import { isTerminalTaskState, } from '../a2a/types.js';
13
13
  import { extractGraphMetadata } from '../flow/graph-metadata.js';
14
+ import { autoRespondToA2AMission } from './mission-hitl.js';
14
15
  import { extractHitlEnvelope } from '../a2a/hitl.js';
15
16
  const DEFAULT_POLL_INTERVAL_MS = 1000;
16
17
  const DEFAULT_MAX_POLLS = 300;
@@ -24,8 +25,11 @@ export async function observeA2ATerminalState(registry, executor, missionId, a2a
24
25
  protocolVersion: opts.protocolVersion ?? '0.3',
25
26
  ...(opts.selectedInterface ? { selectedInterface: opts.selectedInterface } : {}),
26
27
  acceptedPrompts: new Set(),
28
+ authorization: opts.authorization,
27
29
  };
28
30
  }
31
+ if (mission?.a2a && opts.authorization && !mission.a2a.authorization)
32
+ mission.a2a.authorization = opts.authorization;
29
33
  try {
30
34
  const clientOpts = {
31
35
  baseUrl: executor.transportEndpoints.rest,
@@ -41,7 +45,7 @@ export async function observeA2ATerminalState(registry, executor, missionId, a2a
41
45
  clientOpts.fetch = opts.fetch;
42
46
  const client = new A2AClient(clientOpts);
43
47
  let task = initialTask;
44
- emitNonTerminalProgress(registry, executor.executorId, missionId, task);
48
+ await emitNonTerminalProgress(registry, executor.executorId, missionId, task, opts);
45
49
  for (let attempt = 0; attempt <= (opts.maxPolls ?? DEFAULT_MAX_POLLS); attempt++) {
46
50
  if (isTerminalTaskState(task.status.state)) {
47
51
  emitTerminalTask(registry, executor.executorId, missionId, task);
@@ -54,7 +58,7 @@ export async function observeA2ATerminalState(registry, executor, missionId, a2a
54
58
  if (task.id !== initialTask.id || task.contextId !== initialTask.contextId) {
55
59
  throw new Error('A2A observer task binding changed');
56
60
  }
57
- emitNonTerminalProgress(registry, executor.executorId, missionId, task);
61
+ await emitNonTerminalProgress(registry, executor.executorId, missionId, task, opts);
58
62
  }
59
63
  registry.failMission(missionId, `A2A task ${initialTask.id} did not reach a terminal state before observer timeout`);
60
64
  }
@@ -63,7 +67,7 @@ export async function observeA2ATerminalState(registry, executor, missionId, a2a
63
67
  opts.onError?.(err);
64
68
  }
65
69
  }
66
- function emitNonTerminalProgress(registry, executorId, missionId, task) {
70
+ async function emitNonTerminalProgress(registry, executorId, missionId, task, opts) {
67
71
  const state = task.status.state;
68
72
  if (state === 'working') {
69
73
  registry.handleEvent(makeEnvelope('mission.started', executorId, missionId, task, {
@@ -75,6 +79,11 @@ function emitNonTerminalProgress(registry, executorId, missionId, task) {
75
79
  }
76
80
  if (state === 'input-required') {
77
81
  const prompt = extractHitlEnvelope(task);
82
+ // Only a configured host binding source can authorize automatically. Without one, publish the
83
+ // prompt synchronously as before, so the mission shows hitl-required when dispatch returns.
84
+ const bound = opts.authorization ?? registry.getMission(missionId)?.a2a?.authorization;
85
+ if (prompt?.ok && bound && await autoRespondToA2AMission(registry, missionId, prompt.envelope.prompt_id, opts))
86
+ return;
78
87
  registry.handleEvent(makeEnvelope('mission.hitl_required', executorId, missionId, task, {
79
88
  state: 'hitl-required',
80
89
  a2a_task_id: task.id,
@@ -3,6 +3,7 @@ import { createHash, randomUUID } from 'node:crypto';
3
3
  import Ajv from 'ajv';
4
4
  import { A2AClient, A2A_HITL_PROMPT_V1 } from '../a2a/client.js';
5
5
  import { buildHitlResponseMessage, extractHitlEnvelope } from '../a2a/hitl.js';
6
+ import { lookupPromptAuthorization } from '../a2a/hitl-authorization.js';
6
7
  export async function respondToA2AMission(registry, missionId, promptId, response, opts = {}) {
7
8
  const mission = registry.getMission(missionId);
8
9
  const binding = mission?.a2a;
@@ -41,6 +42,15 @@ export async function respondToA2AMission(registry, missionId, promptId, respons
41
42
  // accept a caller-supplied name as authority for a restricted prompt.
42
43
  if (prompt.allowed_responders && !prompt.allowed_responders.includes('any'))
43
44
  return reply(403, 'authenticated_responder_required');
45
+ let authorization;
46
+ if (opts.automatic) {
47
+ const authorized = await lookupPromptAuthorization({ envelope: prompt, taskId: binding.taskId,
48
+ contextId: binding.contextId, authorization: binding.authorization });
49
+ if (!authorized)
50
+ return reply(409, 'approval_requires_human');
51
+ response = authorized.response;
52
+ authorization = authorized.authorization;
53
+ }
44
54
  try {
45
55
  const validate = new Ajv({ allErrors: true, strict: true }).compile(prompt.response_schema);
46
56
  if ('$async' in validate && validate.$async === true)
@@ -73,7 +83,8 @@ export async function respondToA2AMission(registry, missionId, promptId, respons
73
83
  registry.handleEvent({
74
84
  event: 'mission.progress', executor_id: mission.executorId, mission_id: missionId,
75
85
  ts: new Date().toISOString(),
76
- data: { action: 'hitl_response_accepted', hitl_id: promptId, a2a_task_id: binding.taskId },
86
+ data: { action: 'hitl_response_accepted', hitl_id: promptId, a2a_task_id: binding.taskId,
87
+ ...(authorization ? { authorization } : {}) },
77
88
  });
78
89
  return { status: 200, body: { ok: true } };
79
90
  }
@@ -88,4 +99,12 @@ export async function respondToA2AMission(registry, missionId, promptId, respons
88
99
  function reply(status, error) {
89
100
  return { status, body: { error } };
90
101
  }
102
+ /** Called before publishing a mission prompt. The HTTP response route never sets automatic. */
103
+ export async function autoRespondToA2AMission(registry, missionId, promptId, opts = {}) {
104
+ const binding = registry.getMission(missionId)?.a2a;
105
+ if (binding?.acceptedPrompts.has(promptId))
106
+ return true;
107
+ const result = await respondToA2AMission(registry, missionId, promptId, null, { ...opts, automatic: true });
108
+ return result.status === 200;
109
+ }
91
110
  //# sourceMappingURL=mission-hitl.js.map
@@ -73,7 +73,7 @@ export async function recordedWorkerStdinBytes({ filename, workspace, cli, adapt
73
73
  const { loadRecordedWorkerInstallations } = await import('../models/worker-installation.mjs');
74
74
  const { loadProviderModelCapabilities } = await import('../models/provider-policy.js');
75
75
  const { drivers } = await loadRecordedWorkerInstallations({ registry: loadProviderModelCapabilities(),
76
- cwd: workspace, policy, storePath, storeDigest });
76
+ cwd: workspace, policy, cli, storePath, storeDigest });
77
77
  const driver = drivers[cli];
78
78
  if (!driver || driver.qualification.adapterId !== adapterId
79
79
  || driver.qualification.adapter.invocation.stdin !== 'adapter-frame'
@@ -0,0 +1,33 @@
1
+ // Acquire a bounded CLI export when an authorized native projection is unavailable.
2
+ import { mkdtemp, rm } from 'node:fs/promises';
3
+ import { tmpdir } from 'node:os';
4
+ import { join, resolve } from 'node:path';
5
+ import { resolveGrokHomeResult } from '../../providers/grok-build-paths.js';
6
+ import { SessionContractError } from '../contracts.js';
7
+ import { authorizeGrokBuildNativeSource } from './grok-build-native.js';
8
+ export function canFallbackGrokNative(error, options) {
9
+ return options !== undefined && process.env.AIWG_GROK_BUILD_NATIVE_EXPERIMENTAL === '1'
10
+ && error instanceof SessionContractError
11
+ && ['SCHEMA_DRIFT', 'UNKNOWN_SCHEMA_MAJOR', 'UNSUPPORTED_OPERATION', 'MALFORMED_SOURCE'].includes(error.code);
12
+ }
13
+ export async function withGrokCliFallback(source, options, operation) {
14
+ if (process.env.AIWG_GROK_BUILD_NATIVE_EXPERIMENTAL !== '1') {
15
+ throw new SessionContractError('UNSUPPORTED_OPERATION', 'Grok Build native fallback requires the experimental opt-in; use an explicit `grok export` instead.');
16
+ }
17
+ const { sessionId, cwd } = await authorizeGrokBuildNativeSource(source);
18
+ const home = resolveGrokHomeResult(options.env ?? process.env);
19
+ if (!home.ok || resolve(source.locator) !== join(home.path, 'sessions', encodeURIComponent(cwd), sessionId, 'chat_history.jsonl')) {
20
+ throw new SessionContractError('SOURCE_NOT_AUTHORIZED', 'Grok Build CLI fallback requires the selected session to belong to $GROK_HOME/sessions; set GROK_HOME to the authorized source home.');
21
+ }
22
+ const directory = await mkdtemp(join(tmpdir(), 'aiwg-grok-fallback-'));
23
+ try {
24
+ const { grokBuildExport } = await import('../grok-build-cli.js');
25
+ const locator = await grokBuildExport({ ...options, cwd }, sessionId, directory);
26
+ return await operation({ ...source, locator, locatorClass: 'grok-build-cli-markdown-export',
27
+ authorizedScope: { ...source.authorizedScope, allowedRoots: [directory] } });
28
+ }
29
+ finally {
30
+ await rm(directory, { recursive: true, force: true });
31
+ }
32
+ }
33
+ //# sourceMappingURL=grok-build-fallback.js.map
@@ -0,0 +1,134 @@
1
+ // Project only the observed 1.0.77 chat records; never acquire snapshots or attachments.
2
+ import { z } from 'zod';
3
+ import { SessionContractError } from '../contracts.js';
4
+ const text = z.strictObject({ type: z.literal('text'), text: z.string() });
5
+ const tool = z.strictObject({ id: z.string().min(1), name: z.string().min(1), arguments: z.string() });
6
+ const recordSchema = z.discriminatedUnion('type', [
7
+ z.strictObject({ type: z.literal('user'), content: z.array(text), prompt_index: z.number().int().nonnegative().optional(), synthetic_reason: z.enum(['system_reminder', 'compaction_meta']).optional() }),
8
+ z.strictObject({ type: z.literal('assistant'), content: z.string(), tool_calls: z.array(tool).max(999).optional(), model_id: z.string().optional(), model_fingerprint: z.string().optional(), reasoning_effort: z.string().optional() }),
9
+ z.strictObject({ type: z.literal('tool_result'), tool_call_id: z.string(), content: z.string() }),
10
+ z.strictObject({ type: z.literal('system'), content: z.string() }),
11
+ z.strictObject({ type: z.literal('reasoning'), id: z.string(), summary: z.array(z.unknown()), encrypted_content: z.string(), status: z.literal('completed') }),
12
+ ]);
13
+ const summarySchema = z.looseObject({
14
+ chat_format_version: z.literal(1),
15
+ info: z.strictObject({ id: z.string().uuid(), cwd: z.string().min(1) }),
16
+ created_at: z.string(), updated_at: z.string(), current_model_id: z.string(),
17
+ session_kind: z.enum(['headless', 'interactive', 'subagent']).nullish(),
18
+ parent_session_id: z.string().uuid().optional(), forked_at: z.string().optional(),
19
+ });
20
+ export function nativeDrift() {
21
+ throw new SessionContractError('SCHEMA_DRIFT', 'Unrecognized Grok Build 1.0.77 native schema; fall back to `grok export <session-id> <session-id>.md`.');
22
+ }
23
+ export function parseNativeSummary(value, sessionId, cwd) {
24
+ const parsed = summarySchema.safeParse(value);
25
+ if (!parsed.success || parsed.data.info.id.toLowerCase() !== sessionId || parsed.data.info.cwd !== cwd)
26
+ nativeDrift();
27
+ for (const time of [parsed.data.created_at, parsed.data.updated_at])
28
+ if (!Number.isFinite(Date.parse(time)))
29
+ nativeDrift();
30
+ const data = parsed.data;
31
+ if (data.forked_at !== undefined && (!data.parent_session_id || !Number.isFinite(Date.parse(data.forked_at))))
32
+ nativeDrift();
33
+ if (data.parent_session_id?.toLowerCase() === sessionId)
34
+ nativeDrift();
35
+ const lineage = data.parent_session_id ? { parentSessionId: data.parent_session_id.toLowerCase(), ...(data.forked_at ? { forkedAt: data.forked_at } : {}) } : undefined;
36
+ return { sessionCreatedAt: data.created_at, sessionUpdatedAt: data.updated_at, currentModelId: data.current_model_id, ...(data.session_kind ? { sessionKind: data.session_kind } : {}), ...(lineage ? { lineage } : {}) };
37
+ }
38
+ export function projectNativeLine(line, cwd, metadata) {
39
+ const parsed = recordSchema.safeParse(line.value);
40
+ if (!parsed.success)
41
+ nativeDrift();
42
+ const value = parsed.data;
43
+ const records = [];
44
+ const base = { cwd, ...metadata, sequence: line.sequence * 1_000 };
45
+ if (value.type === 'user' && !value.synthetic_reason)
46
+ records.push({ ...base, kind: 'message', role: 'user', content: value.content.map(c => c.text).join('\n') });
47
+ if (value.type === 'assistant') {
48
+ if (value.content)
49
+ records.push({ ...base, kind: 'message', role: 'assistant', content: value.content, model: value.model_id });
50
+ for (const [index, call] of (value.tool_calls ?? []).entries())
51
+ records.push({ ...base, sequence: base.sequence + index + 1, kind: 'tool-call', role: 'tool', content: call.arguments, toolName: call.name, toolCallId: call.id, model: value.model_id });
52
+ }
53
+ if (value.type === 'tool_result')
54
+ records.push({ ...base, kind: 'tool-result', role: 'tool', content: value.content, toolCallId: value.tool_call_id });
55
+ return records.map(record => ({ record, line }));
56
+ }
57
+ export function nativeProjectionRecord(sessionId, entry) {
58
+ const { record, line } = entry;
59
+ return {
60
+ nativeSessionId: sessionId, nativeEventId: `${sessionId}:${record.acquisition === 'grok-build-native-updates' ? 'updates:' : ''}${record.sequence}`, sequence: record.sequence,
61
+ kind: record.kind, role: record.role, occurredAt: record.occurredAt, text: record.content, model: record.model,
62
+ toolName: record.toolName, toolCallId: record.toolCallId,
63
+ rawReference: { locatorClass: record.acquisition ?? 'grok-build-native-chat-history', sequence: line.sequence },
64
+ extensions: {
65
+ lifecycle: 'unknown-at-import',
66
+ provenance: { product: 'grok-build', acquisition: record.acquisition ?? 'grok-build-native-chat-history', sourceSchema: '1.0.0', nativeStoreInspected: true, toolOutputAvailable: true, grokVersion: '1.0.77', workingDirectory: record.cwd, sessionCreatedAt: record.sessionCreatedAt, sessionUpdatedAt: record.sessionUpdatedAt, sessionCreatedAtMs: Date.parse(record.sessionCreatedAt), sessionUpdatedAtMs: Date.parse(record.sessionUpdatedAt), currentModelId: record.currentModelId, ...(record.sessionKind ? { sessionKind: record.sessionKind } : {}) },
67
+ ...(record.lineage ? { lineage: record.lineage } : {}),
68
+ ...(record.compaction ? { compaction: record.compaction } : {}),
69
+ identity: { nativeSessionIdKnown: true, nativeEventIdKnown: false, eventIdentityBasis: 'source-position' },
70
+ lossReport: { lossless: false, excludedRecordTypes: ['system', 'system_reminder', 'reasoning', ...(record.acquisition ? ['compaction_meta'] : [])], unavailable: [...(record.occurredAt ? [] : ['eventTimestamps']), 'attachments', 'fileSnapshots'] },
71
+ },
72
+ };
73
+ }
74
+ const updateEnvelope = z.looseObject({
75
+ timestamp: z.number().finite(),
76
+ method: z.enum(['session/update', '_x.ai/session/update']),
77
+ params: z.looseObject({
78
+ sessionId: z.string().uuid(),
79
+ update: z.looseObject({ sessionUpdate: z.string() }),
80
+ _meta: z.looseObject({ agentTimestampMs: z.number().finite().nonnegative().max(8_640_000_000_000_000).optional() }).optional(),
81
+ }),
82
+ });
83
+ const messageUpdate = z.looseObject({
84
+ content: text,
85
+ _meta: z.looseObject({ modelId: z.string().optional(), promptIndex: z.number().int().nonnegative().optional(), hostTurn: z.boolean().optional() }).optional(),
86
+ });
87
+ const compactUpdate = z.strictObject({
88
+ sessionUpdate: z.literal('auto_compact_completed'),
89
+ tokens_before: z.number().int().nonnegative(), tokens_after: z.number().int().nonnegative(),
90
+ summary_preview: z.string().nullable(),
91
+ });
92
+ const checkpointUpdate = z.strictObject({
93
+ sessionUpdate: z.literal('compaction_checkpoint'), checkpoint_id: z.string().uuid(),
94
+ prompt_index_at_compaction: z.number().int().nonnegative(), checkpoint_file: z.string(),
95
+ schema_version: z.literal(1), created_at: z.string(),
96
+ });
97
+ /** Validate checkpoint references without opening their private context files. */
98
+ export function parseNativeCompactionCheckpoint(value) {
99
+ const parsed = checkpointUpdate.safeParse(value);
100
+ if (!parsed.success || !Number.isFinite(Date.parse(parsed.data.created_at))
101
+ || parsed.data.checkpoint_file !== `compaction_checkpoints/${parsed.data.checkpoint_id}.json`)
102
+ nativeDrift();
103
+ return { checkpointId: parsed.data.checkpoint_id.toLowerCase(), promptIndexAtCompaction: parsed.data.prompt_index_at_compaction };
104
+ }
105
+ const omittedUpdates = new Set(['agent_thought_chunk', 'turn_completed', 'hook_execution', 'background_tasks',
106
+ 'compaction_checkpoint', 'subagent_spawned', 'subagent_finished', 'workflow_updated']);
107
+ /** Text-only update logs retain original turns when compaction rewrites chat history. */
108
+ export function projectNativeUpdate(line, sessionId, cwd, metadata) {
109
+ const parsed = updateEnvelope.safeParse(line.value);
110
+ if (!parsed.success || parsed.data.params.sessionId.toLowerCase() !== sessionId)
111
+ nativeDrift();
112
+ const { update, _meta } = parsed.data.params;
113
+ const type = update.sessionUpdate;
114
+ const base = { ...metadata, cwd, sequence: line.sequence * 1_000, acquisition: 'grok-build-native-updates',
115
+ ...(_meta?.agentTimestampMs !== undefined ? { occurredAt: new Date(_meta.agentTimestampMs).toISOString() } : {}) };
116
+ if (type === 'user_message_chunk' || type === 'agent_message_chunk') {
117
+ const message = messageUpdate.safeParse(update);
118
+ if (!message.success)
119
+ nativeDrift();
120
+ return { record: { ...base, kind: 'message', role: type === 'user_message_chunk' ? 'user' : 'assistant',
121
+ content: message.data.content.text, ...(message.data._meta?.modelId ? { model: message.data._meta.modelId } : {}) }, line };
122
+ }
123
+ if (type === 'auto_compact_completed') {
124
+ const compact = compactUpdate.safeParse(update);
125
+ if (!compact.success)
126
+ nativeDrift();
127
+ return { record: { ...base, kind: 'compaction', content: '',
128
+ compaction: { tokensBefore: compact.data.tokens_before, tokensAfter: compact.data.tokens_after } }, line };
129
+ }
130
+ if (!omittedUpdates.has(type) && type !== 'tool_call' && type !== 'tool_call_update')
131
+ nativeDrift();
132
+ return null;
133
+ }
134
+ //# sourceMappingURL=grok-build-native-records.js.map