@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
@@ -147,7 +147,7 @@ export async function unmanageGrokBuildMcp(configPath, names, options = {}) {
147
147
  }
148
148
 
149
149
  function runJson(binary, args, cwd, env) {
150
- const run = spawnSync(binary, args, { cwd, env: helperEnvironment(env), encoding: 'utf8', timeout: 30_000, killSignal: 'SIGKILL' });
150
+ const run = spawnSync(binary, args, { cwd, env: helperEnvironment(env), stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf8', timeout: 30_000, killSignal: 'SIGKILL' });
151
151
  if (run.error || run.status !== 0) return { ok: false, detail: run.error?.message || run.stderr || `exit ${run.status}` };
152
152
  try { return { ok: true, value: JSON.parse(run.stdout || '{}') }; }
153
153
  catch { return { ok: false, detail: 'Grok returned malformed JSON' }; }
@@ -22,6 +22,7 @@ function deepEqual(a, b) {
22
22
  function inspectMuseCli(env) {
23
23
  const result = spawnSync('muse', ['--version'], {
24
24
  env: helperEnvironment(env),
25
+ stdio: ['ignore', 'pipe', 'pipe'],
25
26
  encoding: 'utf8',
26
27
  timeout: MUSE_VERSION_TIMEOUT_MS,
27
28
  killSignal: 'SIGKILL',
@@ -22,6 +22,7 @@ import { registerWriterProfileResources } from './tools/writer-profiles.mjs';
22
22
  import { registerDiscoveryTools } from './tools/discovery.mjs';
23
23
  import { registerCommandRunTool } from './tools/command-run.mjs';
24
24
  import { registerInteractionTools } from './tools/interaction.mjs';
25
+ import { registerAuthorizationTools } from './tools/authorization.mjs';
25
26
  import { parseToolsets, registerOptInToolsets, KNOWN_TOOLSETS } from './tools/subsystems.mjs';
26
27
  import { AIWG_ROOT, findProjectRoot, resolveProjectAiwgDir } from './helpers.mjs';
27
28
  import { pinContainedRoot as pinArtifactRoot, openContainedFile as openArtifact, readContainedFile, listContainedFiles, validateContainedPath } from '../utils/contained-filesystem.mjs';
@@ -155,6 +156,7 @@ export async function createServer(options = {}) {
155
156
  // store. Callers select other projects explicitly via `project_dir`.
156
157
  const artifactEnv = { ...process.env };
157
158
  const trustedProjectRoot = await fs.realpath(options.projectDir ?? process.cwd());
159
+ registerAuthorizationTools(server, { projectRoot: trustedProjectRoot });
158
160
  const trustedArtifactRoot = await resolveProjectAiwgDir(trustedProjectRoot, { env: artifactEnv });
159
161
  const startupStore = options.artifactStore ?? await pinArtifactRoot(trustedArtifactRoot, trustedProjectRoot);
160
162
  const trustedStore = startupStore.root;
@@ -0,0 +1,78 @@
1
+ // Captures durable grants exclusively through confirmed native MCP form elicitation.
2
+ import { randomUUID } from 'node:crypto';
3
+ import { access } from 'node:fs/promises';
4
+ import { z } from 'zod';
5
+ import { buildChoiceSchema, clientSupportsFormElicitation, elicitWithRequestId } from '../elicitation.mjs';
6
+
7
+ const descriptors = z.array(z.string().min(1).max(256)).min(1).max(64);
8
+ const proposalSchema = z.strictObject({
9
+ categories: descriptors, targets: descriptors, environments: descriptors, resources: descriptors, verbs: descriptors,
10
+ maxImpact: z.enum(['low', 'medium']), expiresAt: z.string(), maxUses: z.number().int().positive().safe().optional(),
11
+ });
12
+ const reply = (value, isError = false) => ({ content: [{ type: 'text', text: JSON.stringify(value) }], ...(isError ? { isError } : {}) });
13
+
14
+ async function authorizationApi(module) {
15
+ // Shipped dist has the compiled module beside this file's tree; a source checkout uses dist/.
16
+ for (const location of [new URL(`../../policy/${module}.js`, import.meta.url),
17
+ new URL(`../../../dist/src/policy/${module}.js`, import.meta.url)]) {
18
+ try { await access(location); } catch { continue; }
19
+ return import(location.href);
20
+ }
21
+ throw new Error('Authorization grant capture requires the built CLI package.');
22
+ }
23
+
24
+ export function registerAuthorizationTools(server, { projectRoot }) {
25
+ const lookupSchema = z.strictObject({
26
+ operation: z.enum(['list', 'search', 'explain']), status: z.enum(['active', 'expired', 'revoked']).optional(),
27
+ query: z.string().min(1).max(4096).optional(), action: z.record(z.string(), z.unknown()).optional(),
28
+ });
29
+ server.registerTool('aiwg_authorization_grant_lookup', {
30
+ title: 'Inspect durable authorization grants',
31
+ description: 'Read verified grants: list, deterministic token search with match reasons, or explain a host-classified action. Never records grants, revocations, receipts or uses.',
32
+ inputSchema: lookupSchema,
33
+ annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
34
+ }, async args => {
35
+ try {
36
+ const input = lookupSchema.parse(args);
37
+ const field = { list: 'status', search: 'query', explain: 'action' }[input.operation];
38
+ if (Object.keys(input).some(key => key !== 'operation' && key !== field)
39
+ || (input.operation !== 'list' && input[field] === undefined)) throw new Error('Invalid lookup fields');
40
+ const api = await authorizationApi('authorization-operations');
41
+ return reply(input.operation === 'list' ? await api.listAuthorizationGrants(projectRoot, input.status)
42
+ : input.operation === 'search' ? await api.searchAuthorizationGrants(projectRoot, input.query)
43
+ : await api.explainAuthorization(projectRoot, input.action));
44
+ } catch {
45
+ return reply({ status: 'unavailable', reason: 'invalid-query-or-authorization-ledger-unavailable' }, true);
46
+ }
47
+ });
48
+ const connectionId = `mcp-session:${randomUUID()}`;
49
+ server.registerTool('aiwg_authorization_grant_request', {
50
+ title: 'Request a durable human authorization grant',
51
+ description: 'Propose bounded authorization and ask the person through native MCP form elicitation. Only explicit confirmation records a signed grant. Text claims never authorize. The server adds and displays governing workspace bindings.',
52
+ inputSchema: proposalSchema,
53
+ annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
54
+ }, async (args, extra) => {
55
+ try {
56
+ const proposal = proposalSchema.parse(args);
57
+ const api = await authorizationApi('authorization-capture');
58
+ const sessionId = extra?.sessionId ?? connectionId;
59
+ const identity = { sessionId, id: extra?.authInfo?.clientId ?? `session:${sessionId}` };
60
+ const { grant, question } = await api.prepareAuthorizationGrant(projectRoot, proposal, identity);
61
+ if (!clientSupportsFormElicitation(server)) return reply({ status: 'refused', reason: 'form-elicitation-required',
62
+ message: 'Use your harness native question tool to ask the user, then retry from a client supporting MCP form elicitation. No grant was recorded; text replies cannot record grants.' }, true);
63
+ const { requestedSchema } = buildChoiceSchema({ key: 'confirm', title: 'Save this authorization scope?',
64
+ options: [{ value: 'confirm', label: 'Confirm this scope' }, { value: 'decline', label: 'Decline' }] });
65
+ const { result, requestId } = await elicitWithRequestId(server, {
66
+ mode: 'form', message: question, requestedSchema,
67
+ _meta: { 'aiwg.io/authorization-event': randomUUID() },
68
+ }, { signal: extra?.signal, relatedRequestId: extra?.requestId, timeout: 60_000 });
69
+ if (extra?.signal?.aborted || result?.action !== 'accept' || result?.content?.confirm !== 'confirm') {
70
+ return reply({ status: 'not-recorded', reason: 'native-confirmation-required' });
71
+ }
72
+ return reply(await api.recordConfirmedAuthorizationGrant(projectRoot, grant, requestId, result));
73
+ } catch {
74
+ // Do not echo arguments, raw questions, answers, or transport errors.
75
+ return reply({ status: 'not-recorded', reason: 'invalid-scope-or-confirmation-unavailable' }, true);
76
+ }
77
+ });
78
+ }
@@ -0,0 +1,144 @@
1
+ /** Discover Droid's configured BYOK selectors without retaining credential fields. */
2
+ import { constants } from 'node:fs';
3
+ import { open } from 'node:fs/promises';
4
+ import { homedir, tmpdir } from 'node:os';
5
+ import { join } from 'node:path';
6
+ import { readAiwgConfig } from '../config/aiwg-config.js';
7
+ import { buildWorkerObservation, discoveryDigest, runModelDiscoveryCommand } from './model-discovery.js';
8
+ const MAX_CONFIG_BYTES = 1024 * 1024;
9
+ const MODEL_FIELDS = new Set(['', 'customModels', 'model', 'displayName', 'baseUrl', 'provider', 'maxOutputTokens', 'maxContextLimit']);
10
+ async function readSettings(filename) {
11
+ const file = await open(filename, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
12
+ try {
13
+ const stat = await file.stat();
14
+ if (!stat.isFile() || stat.size > MAX_CONFIG_BYTES)
15
+ throw new Error('Config exceeds bounds');
16
+ const buffer = Buffer.alloc(MAX_CONFIG_BYTES + 1);
17
+ const { bytesRead } = await file.read(buffer, 0, buffer.length, 0);
18
+ if (bytesRead > MAX_CONFIG_BYTES)
19
+ throw new Error('Config exceeds bounds');
20
+ // Drop every unneeded field at parse time, including apiKey/api_key. Never
21
+ // inspect, interpolate or hash their values; parser errors are never echoed.
22
+ return JSON.parse(buffer.toString('utf8', 0, bytesRead), (key, value) => MODEL_FIELDS.has(key) || /^\d+$/.test(key) ? value : undefined);
23
+ }
24
+ finally {
25
+ await file.close();
26
+ }
27
+ }
28
+ function inferenceProvider(provider, baseUrl) {
29
+ if (typeof baseUrl === 'string') {
30
+ try {
31
+ const url = new URL(baseUrl);
32
+ if (!['http:', 'https:'].includes(url.protocol))
33
+ return undefined;
34
+ const host = url.hostname.toLowerCase();
35
+ return { 'openrouter.ai': 'openrouter', 'api.openai.com': 'openai',
36
+ 'api.anthropic.com': 'anthropic' }[host] ?? host;
37
+ }
38
+ catch {
39
+ return undefined;
40
+ }
41
+ }
42
+ // These are backend identities. Generic protocol names are not providers.
43
+ return ['anthropic', 'openai'].includes(provider) ? provider : undefined;
44
+ }
45
+ export async function discoverFactoryModels(options = {}) {
46
+ const observedAt = (options.now?.() ?? new Date()).toISOString();
47
+ const source = join(options.homeDir ?? homedir(), '.factory/settings.json');
48
+ const result = { provider: 'factory', source: 'native', observedAt,
49
+ accountScope: 'local-account', ...(options.accountBinding ? { accountBinding: options.accountBinding } : {}), models: [] };
50
+ let version = options.runtimeVersion;
51
+ if (!version) {
52
+ try {
53
+ const probe = await (options.runner ?? runModelDiscoveryCommand)(options.command ?? 'droid', ['--version'], { cwd: tmpdir(), timeoutMs: 5000 });
54
+ // Accept the known plain and droid-cli banners, never retain arbitrary CLI output.
55
+ if (probe.exitCode === 0)
56
+ version = /^(?:droid-cli\s+)?(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)$/.exec(probe.stdout.trim())?.[1];
57
+ }
58
+ catch { /* A missing runtime cannot establish a current worker observation. */ }
59
+ }
60
+ if (!version)
61
+ return { ...result, errorKind: 'command', error: 'Factory version probe failed; no current custom model observations.' };
62
+ result.runtimeVersion = version;
63
+ let settings;
64
+ try {
65
+ settings = await readSettings(source);
66
+ }
67
+ catch (error) {
68
+ return { ...result, errorKind: error.code === 'ENOENT' ? 'unsupported' : 'invalid-output',
69
+ error: 'Factory settings.json could not be read or parsed within bounds; built-in plan models have no non-interactive model-list command.' };
70
+ }
71
+ const rows = settings && typeof settings === 'object' && !Array.isArray(settings)
72
+ ? settings.customModels : undefined;
73
+ if (rows === undefined && settings && typeof settings === 'object' && !Array.isArray(settings))
74
+ return result;
75
+ if (!Array.isArray(rows) || rows.length > 1024)
76
+ return { ...result, errorKind: 'invalid-output', error: 'Factory /customModels: expected bounded array.' };
77
+ const diagnostics = [];
78
+ const nameCounts = new Map();
79
+ for (const [index, entry] of rows.entries()) {
80
+ const invalid = () => diagnostics.push(`Factory /customModels/${index}: malformed model fields or unknown inference provider.`);
81
+ if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
82
+ invalid();
83
+ continue;
84
+ }
85
+ const row = entry;
86
+ const { model, displayName, provider, baseUrl, maxOutputTokens, maxContextLimit } = row;
87
+ // Droid counts prior entries with this normalized name, not array indexes.
88
+ const normalizedName = typeof displayName === 'string' ? displayName.replace(/ /g, '-') : '';
89
+ const occurrence = nameCounts.get(normalizedName) ?? 0;
90
+ nameCounts.set(normalizedName, occurrence + 1);
91
+ if (typeof model !== 'string' || !model.trim() || /\s/.test(model)
92
+ || typeof displayName !== 'string' || !displayName.trim() || displayName !== displayName.trim()
93
+ || /[\x00-\x1f\x7f]/.test(displayName) || typeof provider !== 'string'
94
+ || (maxOutputTokens !== undefined && (!Number.isSafeInteger(maxOutputTokens) || maxOutputTokens < 1))
95
+ || (maxContextLimit !== undefined && (!Number.isSafeInteger(maxContextLimit) || maxContextLimit < 1))) {
96
+ invalid();
97
+ continue;
98
+ }
99
+ const llmProvider = inferenceProvider(provider, baseUrl);
100
+ if (!llmProvider) {
101
+ invalid();
102
+ continue;
103
+ }
104
+ const id = `custom:${normalizedName}-${occurrence}`;
105
+ const facts = { id, model, displayName, llmProvider, maxOutputTokens: maxOutputTokens ?? null,
106
+ maxContextLimit: maxContextLimit ?? null };
107
+ const worker = buildWorkerObservation({ cliId: options.cliId ?? 'factory', source,
108
+ pointer: `/customModels/${index}`, runtimeVersion: version, observedAt,
109
+ accountScope: 'local-account', accountBinding: options.accountBinding,
110
+ contentDigest: discoveryDigest(JSON.stringify(facts)) }, {
111
+ modelId: id, family: 'unknown', visibility: 'listed', lifecycle: 'active',
112
+ contextTokens: maxContextLimit,
113
+ maxOutputTokens: maxOutputTokens, effortSupport: 'not-applicable',
114
+ provenanceFields: ['/apiModelId', '/llmProvider', '/displayName', '/contextTokens:maxContextLimit'],
115
+ });
116
+ // apiModelId is the executable Droid selector required by qualification and
117
+ // invocation, not the upstream API id. Preserve the latter as config provenance.
118
+ result.models.push({ id, apiModelId: id, displayName, llmProvider, worker });
119
+ result.policy ??= { layers: [{ source, scope: 'user', precedence: 1, policyConstraint: false }],
120
+ selected: {}, constraints: [], diagnostics: [] };
121
+ result.policy.selected[`customModels.${index}.model`] = { value: model, source, scope: 'user', precedence: 1 };
122
+ }
123
+ // Identical display names are numbered; distinct spellings that normalize to
124
+ // the same name remain ambiguous and are withheld together.
125
+ const ambiguousNames = new Set(result.models.filter(row => result.models.some(other => other.displayName !== row.displayName && other.displayName.replace(/ /g, '-') === row.displayName.replace(/ /g, '-')))
126
+ .map(row => row.displayName.replace(/ /g, '-')));
127
+ if (ambiguousNames.size) {
128
+ diagnostics.push('Factory custom model display names produce ambiguous selectors.');
129
+ result.models = result.models.filter(row => !ambiguousNames.has(row.displayName.replace(/ /g, '-')));
130
+ }
131
+ if (diagnostics.length) {
132
+ result.errorKind = 'invalid-output';
133
+ result.error = diagnostics.join('; ');
134
+ }
135
+ return result;
136
+ }
137
+ /** Bind refresh to a single configured Factory installation; doctor binds each target separately. */
138
+ export async function discoverProjectFactoryModels(projectDir, options = {}) {
139
+ const config = await readAiwgConfig(projectDir);
140
+ const clis = Object.entries(config?.parallelism?.clis ?? {}).filter(([id, cli]) => cli.enabled !== false && (cli.adapter ?? `providers:${id}`) === 'providers:factory');
141
+ const [cliId, cli] = clis.length === 1 ? clis[0] : [];
142
+ return discoverFactoryModels({ cliId, command: cli?.executable, accountBinding: cli?.accountScope, ...options });
143
+ }
144
+ //# sourceMappingURL=factory-models.js.map
@@ -700,7 +700,7 @@
700
700
  "id": "copilot",
701
701
  "provider": "copilot",
702
702
  "adapterVersion": "1",
703
- "supportedVersions": "1.0.95",
703
+ "supportedVersions": "1.0.106",
704
704
  "runtimeDriver": "installed:copilot",
705
705
  "catalogAdapter": {
706
706
  "kind": "file",
@@ -711,10 +711,6 @@
711
711
  "kind": "process",
712
712
  "executable": "copilot",
713
713
  "argv": [
714
- "-p",
715
- "Follow the instructions in the attached file exactly.",
716
- "--attachment",
717
- "${brief}",
718
714
  "--model",
719
715
  "${model}",
720
716
  "--reasoning-effort",
@@ -727,9 +723,9 @@
727
723
  "--no-custom-instructions",
728
724
  "--disable-builtin-mcps"
729
725
  ],
730
- "stdin": "closed",
726
+ "stdin": "brief-text",
731
727
  "cwd": "${workspace}",
732
- "envAllowlist": ["PATH"],
728
+ "envAllowlist": ["PATH", "COPILOT_PROVIDER_BASE_URL", "COPILOT_PROVIDER_TYPE", "COPILOT_MODEL", "COPILOT_PROVIDER_API_KEY", "COPILOT_PROVIDER_API_KEY_COMMAND"],
733
729
  "versionArgv": [
734
730
  "--version"
735
731
  ],
@@ -754,7 +750,7 @@
754
750
  "invocationProfiles": {
755
751
  "direct-shell": {
756
752
  "transport": "shell",
757
- "supportedVersions": "1.0.95",
753
+ "supportedVersions": "1.0.106",
758
754
  "controls": {
759
755
  "model": {
760
756
  "support": "unqualified",
@@ -783,18 +779,18 @@
783
779
  },
784
780
  "finalOutput": {
785
781
  "support": "unqualified",
786
- "mapping": "stdout --output-format json (JSONL, one JSON object per line); no output-file flag carries the agent's final answer (--usage-output-file is usage statistics only and is not wired here)",
787
- "evidence": "H: copilot 1.0.95 --help / `copilot help <topic>`, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/copilot-1.0.95.txt; never live qualification) ('--output-format <format> Output format: ... 'json' (JSONL, one JSON object per line)'; '--usage-output-file <file> Write final usage statistics as JSON')"
782
+ "mapping": "stdout JSONL: extract the last assistant.message data.content after assistant.turn_end/assistant.idle; reject malformed or error-shaped streams, then validate workerClaims against trusted process termination",
783
+ "evidence": "L: copilot 1.0.106 BYOK OpenRouter qwen/qwen3.8-27b, 2026-11-10 (#4088); sanitized captures test/fixtures/providers/copilot/copilot-stdin-only.jsonl and copilot-stdin.jsonl; model.call_final_result.data.isByok=true; single-turn stdin-only exact reply without tools"
788
784
  },
789
785
  "stdin": {
790
786
  "support": "unqualified",
791
- "mapping": "unavailable for the brief: -p/--prompt <text> only accepts inline argv text; the brief instead rides on --attachment <path> as a file, with -p fixed to a content-free instruction",
792
- "evidence": "H: copilot 1.0.95 --help / `copilot help <topic>`, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/copilot-1.0.95.txt; never live qualification) ('-p, --prompt <text> Execute a prompt in non-interactive mode'; '--attachment <path> Attach a file (image or native document) to the initial prompt; only valid in non-interactive mode')"
787
+ "mapping": "brief-text: pipe the brief to EOF with no -p/--prompt or --attachment; 1.0.106 rejects Markdown attachments and ignores stdin when -p is present",
788
+ "evidence": "L: copilot 1.0.106 BYOK OpenRouter qwen/qwen3.8-27b, 2026-11-10 (#4088); sanitized captures test/fixtures/providers/copilot/copilot-stdin-only.jsonl and copilot-stdin.jsonl; model.call_final_result.data.isByok=true; single-turn stdin-only exact reply without tools"
793
789
  },
794
790
  "structuredOutput": {
795
791
  "support": "unqualified",
796
- "mapping": "unavailable: no output-schema flag is evidenced, and the --output-format json JSONL event vocabulary itself is not documented in --help; no event field name is invented",
797
- "evidence": "H: copilot 1.0.95 --help / `copilot help <topic>`, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/copilot-1.0.95.txt; never live qualification)"
792
+ "mapping": "No output-schema flag is evidenced; assistant.message data.content is validated by the shared strict workerClaims parser",
793
+ "evidence": "L: copilot 1.0.106 BYOK OpenRouter qwen/qwen3.8-27b, 2026-11-10 (#4088); sanitized captures test/fixtures/providers/copilot/copilot-stdin-only.jsonl and copilot-stdin.jsonl; model.call_final_result.data.isByok=true; single-turn stdin-only exact reply without tools"
798
794
  },
799
795
  "stepCap": {
800
796
  "support": "unqualified",
@@ -817,15 +813,15 @@
817
813
  "evidence": "H: copilot 1.0.95 --help / `copilot help <topic>`, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/copilot-1.0.95.txt; never live qualification) ('--auto-tier <preference> Set the Auto routing profile')"
818
814
  }
819
815
  },
820
- "envAllowlist": ["PATH"],
816
+ "envAllowlist": ["PATH", "COPILOT_PROVIDER_BASE_URL", "COPILOT_PROVIDER_TYPE", "COPILOT_MODEL", "COPILOT_PROVIDER_API_KEY", "COPILOT_PROVIDER_API_KEY_COMMAND"],
821
817
  "pitfalls": [
822
818
  "Documentation/help and synthetic observations are not authenticated live qualification.",
823
819
  "Unknown model, effort, permission or required step mappings block dispatch.",
824
820
  "Native MCP/client, MSP/ACP, gateway and conversation capabilities do not establish worker authority.",
825
- "The --output-format json JSONL event-type vocabulary is not documented in --help, and the installed binary is a compiled per-architecture native package with no readable bundled source (unlike e.g. Pi's JS bundle); no event-level health signal is evidenced, so observeHealthEvent always returns null and completion is exit-code gated only, EXCEPT one conservative guard: a line with a top-level 'type: \"error\"' or non-null 'error' field always fails the final, even at exit 0 (defensive synthetic-shape check, not an observed Copilot event).",
821
+ "Captured 1.0.106 assistant.message data.content supplies the final answer after assistant.turn_end/assistant.idle. Health remains process-only with no event-level health signal evidenced for progress; error-shaped lines fail even at exit zero.",
826
822
  "--allow-all-tools/--allow-all/--yolo are never emitted; a tool outside the resolved --allow-tool scope may still require interactive confirmation a non-interactive run cannot answer, and whether that fails closed or hangs is unqualified without a live run.",
827
823
  "--sandbox's OS-level command sandbox depends on host prerequisites (bwrap/slirp4netns/iptables on Linux) not probed here; this profile never emits it and relies on the CLI's default path restriction instead.",
828
- "Live qualification is an open S1 blocker: this profile has been exercised only against --help/--version/subcommand --help; the smoke command in docs/providers/copilot-direct.md is the first live check. Live attempt evidence (host noodle, 2026-10-10): COPILOT_GITHUB_TOKEN set to a classic ghp_ PAT exits 1 with 'Classic Personal Access Tokens (ghp_) are not supported by Copilot' on stderr and EMPTY stdout; a fine-grained PAT or prior copilot/gh login is required and the smoke run remains blocked on that."
824
+ "The 1.0.95 help-only attachment path is superseded by the 1.0.106 stdin-only BYOK capture (#4088). The old GitHub-account run on 2026-10-10 remains recorded as blocked: Classic Personal Access Tokens (ghp_) are not supported by Copilot. Other required controls remain unqualified."
829
825
  ],
830
826
  "health": {
831
827
  "version": 1,
@@ -834,7 +830,7 @@
834
830
  "signalParser": "provider-copilot-health-v1",
835
831
  "sessionLogLocator": null,
836
832
  "progressEvidence": [],
837
- "stopEvidence": "owned process identity and observed exit; the JSONL stream carries no evidenced error-event vocabulary, so completion is exit-code gated only, except a conservative guard that fails any line shaped 'type: \"error\"' or carrying a non-null top-level 'error' field even at exit 0",
833
+ "stopEvidence": "host-observed process exit and termination plus strict workerClaims validation of the settled assistant.message answer; error-shaped streams fail even at exit zero",
838
834
  "fixtureRef": "test/fixtures/providers/copilot/health/manifest.json",
839
835
  "qualifiedAt": null,
840
836
  "statusOperation": null,
@@ -842,7 +838,8 @@
842
838
  "coverage": "degraded",
843
839
  "qualificationTarget": "process-only",
844
840
  "evidenceGrades": [
845
- "H"
841
+ "H",
842
+ "D"
846
843
  ],
847
844
  "provenance": [
848
845
  {
@@ -850,6 +847,12 @@
850
847
  "ref": ".aiwg/working/s1-scratch/cli-help/copilot-1.0.95.txt",
851
848
  "observedAt": "2026-10-10T00:00:00Z",
852
849
  "cliVersion": "1.0.95"
850
+ },
851
+ {
852
+ "kind": "documentation",
853
+ "ref": "docs/providers/copilot-direct.md",
854
+ "observedAt": "2026-11-10T23:12:29Z",
855
+ "cliVersion": "1.0.106"
853
856
  }
854
857
  ],
855
858
  "qualificationOwner": "B-OG-36",
@@ -1157,8 +1160,8 @@
1157
1160
  },
1158
1161
  "effort": {
1159
1162
  "support": "unqualified",
1160
- "mapping": "[-r/--reasoning-effort LEVEL]; valid levels are model-dependent (exec --help 'Model details'); never the per-model default",
1161
- "evidence": "H: droid-cli 1.0.0 exec --help documents -r/--reasoning-effort <level> (defaults per model); unqualified until live evidence"
1163
+ "mapping": "[-r/--reasoning-effort LEVEL]; valid levels are model-dependent (exec --help 'Model details'); never the per-model default. Not enforceable for BYOK custom models: -r is ignored and the session reports reasoning_effort: none",
1164
+ "evidence": "H: droid-cli 1.0.0 exec --help documents -r/--reasoning-effort <level> (defaults per model); BYOK custom models ignore it (reasoning_effort: none), so effort is not enforceable; unqualified until live evidence"
1162
1165
  },
1163
1166
  "sandbox": {
1164
1167
  "support": "unqualified",
@@ -2599,7 +2602,7 @@
2599
2602
  "skill": "inherited",
2600
2603
  "globalChild": "native",
2601
2604
  "identifierSyntax": "Provider-local alias from grok inspect and $GROK_HOME config; distinct from API model id",
2602
- "inheritance": "Agent and skill roles resolve through the session model unless a validated Grok Build alias is selected",
2605
+ "inheritance": "Agents inherit the session model: Grok Build 1.0.77 ignores agent frontmatter model. AIWG role/tier intent is informational; select worker models with CLI -m. Fixture-backed test: test/unit/providers/grok-build-provider.test.ts. Skill roles inherit the session model.",
2603
2606
  "invalidPinFallback": "Report the unavailable alias; use the sole discovered model only when exactly one is available",
2604
2607
  "configTarget": "$GROK_HOME/config.toml [models] and [model.<alias>] (read-only discovery)",
2605
2608
  "artifactFormat": "Grok Build model alias",
@@ -2637,9 +2640,13 @@
2637
2640
  "--output-format",
2638
2641
  "streaming-json",
2639
2642
  "--no-subagents",
2643
+ "--disallowed-tools",
2644
+ "workflow",
2640
2645
  "--no-plan",
2641
2646
  "--no-alt-screen",
2642
- "--disable-web-search"
2647
+ "--disable-web-search",
2648
+ "--allow",
2649
+ "Bash(aiwg discover *)"
2643
2650
  ],
2644
2651
  "stdin": "closed",
2645
2652
  "cwd": "${workspace}",
@@ -2702,7 +2709,7 @@
2702
2709
  },
2703
2710
  "finalOutput": {
2704
2711
  "support": "unqualified",
2705
- "mapping": "stdout --output-format streaming-json (NDJSON, one ACP session update per line); the final 'end' event's stopReason plus concatenated 'text' chunks form the answer; no separate output-file flag is evidenced. NOTE: the SEPARATE, pre-existing src/providers/grok-build-headless.ts transport and its shared tools/ralph-external/lib/worker-health.mjs generic branch use a different, older message/result event shape and --output-format json (a single JSON object); this direct-shell profile's own observeHealthEvent/parseDirectFinal handle only the streaming-json/ACP shape and never touch that other path.",
2712
+ "mapping": "stdout --output-format streaming-json (NDJSON, one ACP session update per line); the final 'end' event's stopReason plus concatenated 'text' chunks form the answer; no separate output-file flag is evidenced. The separate src/providers/grok-build-headless.ts transport now defaults to streaming-json with captured 1.0.77 parser contracts; this direct-shell profile retains its own observeHealthEvent/parseDirectFinal.",
2706
2713
  "evidence": "H: grok 1.0.50 (c58f321264ba, stable) --help, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/grok-1.0.50.txt); plus the installed binary's own bundled docs (strings-read, never live qualification; full extracts preserved in docs/providers/grok-build-cli-evidence.md) ('--output-format <OUTPUT_FORMAT> ... streaming-json: NDJSON: one ACP session update per line, the agent's native format'; bundled output-format doc gives the full event vocabulary and a worked example, preserved in the evidence file, confirming 'json' is a single object with text/stopReason/sessionId/requestId/usage fields -- NOT the message/result shape -- and 'streaming-json' is the ACP-derived text/thought/tool_call/tool_call_update/usage/plan/available_commands/end/error vocabulary)"
2707
2714
  },
2708
2715
  "stdin": {
@@ -2727,8 +2734,8 @@
2727
2734
  },
2728
2735
  "children": {
2729
2736
  "support": "unqualified",
2730
- "mapping": "--no-subagents (disables subagent spawning; denies hidden fan-out)",
2731
- "evidence": "H: grok 1.0.50 (c58f321264ba, stable) --help, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/grok-1.0.50.txt); plus the installed binary's own bundled docs (strings-read, never live qualification; full extracts preserved in docs/providers/grok-build-cli-evidence.md) ('--no-subagents Disable subagent spawning')"
2737
+ "mapping": "--no-subagents --disallowed-tools workflow (1.0.77 capture: workflow can spawn children despite --no-subagents; combined argv tested in grok-build-direct.test.ts; live-verified on 1.0.77 2026-11-10: no spawn_subagent or workflow call and no subagent records)",
2738
+ "evidence": "H: grok 1.0.50 (c58f321264ba, stable) --help, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/grok-1.0.50.txt); plus the installed binary's own bundled docs (strings-read, never live qualification; full extracts preserved in docs/providers/grok-build-cli-evidence.md) ('--no-subagents Disable subagent spawning'); 2026-11-10 1.0.77 capture correction: test/fixtures/providers/grok-build/captured-20261110/permissions.json replayed by test/unit/providers/grok-build-headless.test.ts demonstrates workflow bypass; both flags required in rendered argv"
2732
2739
  },
2733
2740
  "fallback": {
2734
2741
  "support": "unqualified",
@@ -2745,10 +2752,11 @@
2745
2752
  "Documentation/help and synthetic observations are not authenticated live qualification.",
2746
2753
  "Unknown model, effort, permission or required step mappings block dispatch.",
2747
2754
  "Native MCP/client, MSP/ACP, gateway and conversation capabilities do not establish worker authority.",
2748
- "The separate, pre-existing src/providers/grok-build-headless.ts transport and the generic grok-build branch in tools/ralph-external/lib/worker-health.mjs use --output-format json and an older message/result event shape; this profile's streaming-json/ACP grammar is independent and does not change that path or its consumers.",
2755
+ "The separate src/providers/grok-build-headless.ts transport defaults to streaming-json and also parses captured json and streaming-messages-json; this direct profile retains its independent streaming-json parser.",
2749
2756
  "No --no-ask-user-equivalent flag is listed in the captured root --help for this version (an internal no-ask-user arg name exists in the compiled binary's own strings but is not printed help text), so it is never emitted; whether an ask_user_question tool call blocks indefinitely under dontAsk in a non-interactive run is unqualified, not invented away.",
2750
2757
  "--always-approve and --permission-mode bypassPermissions are never emitted; a scoped --allow/--deny rule value, or the model/effort value, starting with '-' or containing whitespace/control characters is refused by the driver before argv is built.",
2751
2758
  "Permission-mode and sandbox-profile semantics are quoted directly from the installed binary's own bundled documentation (see docs/providers/grok-build-cli-evidence.md for the full extracts, strings command and binary version/hash); where that documentation does not settle a question (e.g. ask_user_question behavior under dontAsk), the control stays unqualified rather than assumed safe.",
2759
+ "1.0.77 captured permissions (2026-11-10): default headless cancels spawn_subagent and workflow because a headless run cannot ask for approval; --allow spawn_subagent did not cover them. --permission-mode auto ran them, but AIWG keeps its existing permission defaults. Evidence: test/fixtures/providers/grok-build/captured-20261110/permissions.json; test/unit/providers/grok-build-headless.test.ts. ACP authMethods, logged-in session/new, end_turn usage, compact notifications and cancelled/MidTurnAbort are replayed in grok-build-acp.test.ts; live ACP dispatch qualification remains deferred. Native -w creates standalone copies under ~/.grok/worktrees/<slug>/<name>, not git worktrees; ownership/recovery list parsing is tested in grok-build-dispatch.test.ts. The combined flags were verified live on 1.0.77 (2026-11-10: no spawn_subagent or workflow call, no subagent records); compatibility with the older pinned 1.0.50 direct profile remains unverified.",
2752
2760
  "Live qualification is an open S1 blocker: this profile has been exercised only against --help/--version/subcommand --help plus strings-read bundled docs, never a live prompted run. The smoke command in docs/providers/grok-build-direct.md is the first live check and needs an XAI_API_KEY (or cached grok login) from the operator."
2753
2761
  ],
2754
2762
  "health": {
@@ -39,9 +39,9 @@ export const PROVIDER_DISCOVERY_DECISIONS = {
39
39
  },
40
40
  factory: {
41
41
  provider: 'factory',
42
- status: 'unsupported',
43
- interface: null,
44
- reason: 'Droid exposes model selection through policy and interactive surfaces, but no documented non-interactive model-list command.',
42
+ status: 'native',
43
+ interface: 'bounded customModels fields from ~/.factory/settings.json; droid --version',
44
+ reason: 'Configured BYOK custom selectors are observable locally; built-in plan models have no documented non-interactive model-list command and stay static.',
45
45
  documentation: 'https://docs.factory.ai/cli/configuration/models',
46
46
  },
47
47
  grokbot: {
@@ -635,6 +635,10 @@ export async function resolveDynamicModelCatalog(options) {
635
635
  muse: () => discoverMuseCatalogModels({
636
636
  ...options.muse, catalogDir: options.muse?.catalogDir ?? join(homeDir, MUSE_CATALOG_DIR), now: options.now,
637
637
  }),
638
+ factory: async () => {
639
+ const { discoverProjectFactoryModels } = await import('./factory-models.js');
640
+ return discoverProjectFactoryModels(options.inventory.projectDir, { homeDir, runner: options.runner, now: options.now });
641
+ },
638
642
  opencode: () => discoverOpenCodeModels(),
639
643
  openclaw: () => discoverOpenClawModels(),
640
644
  pi: () => discoverPiModels(),
@@ -7,6 +7,8 @@ export function loadRecordedWorkerInstallations(input: {
7
7
  cwd: string;
8
8
  policy?: WorkerSelectionPolicy;
9
9
  parallelism?: import('../config/aiwg-config.js').ParallelismConfig;
10
+ /** Restrict revalidation to a CLI already selected by a bound invocation. */
11
+ cli?: string;
10
12
  storePath?: string;
11
13
  storeDigest?: string;
12
14
  /** Request validation after store presence, before recorded policy/adapter checks. */
@@ -836,7 +836,7 @@ export async function recordWorkerInstallation(instance, options) {
836
836
 
837
837
  /** Read recorded host authority, validate installation bytes and the current CLI
838
838
  * version, then load the same approved factory used by Ralph. */
839
- export async function loadRecordedWorkerInstallations({ registry, cwd, policy, parallelism, storePath, storeDigest, precheckPolicy }) {
839
+ export async function loadRecordedWorkerInstallations({ registry, cwd, policy, parallelism, cli: requestedCli, storePath, storeDigest, precheckPolicy }) {
840
840
  const { WorkerPolicyError, WorkerQualificationPolicyError, parseProviderModelCapabilities } = await import('./provider-policy.js');
841
841
  // Compiled TS modules load lazily so the managed launcher's ESM-only import chain stays minimal (#3851).
842
842
  const { workerQualificationPolicyDiagnostic } = await import('./worker-qualification-policy.js');
@@ -890,6 +890,9 @@ export async function loadRecordedWorkerInstallations({ registry, cwd, policy, p
890
890
  if (prior === undefined || workspaces[prior] !== requestedWorkspace) selected.set(record?.cli, index);
891
891
  }
892
892
  for (const [registration, record] of stored.registrations.entries()) {
893
+ // Shared-store registrations outside this request cannot grant authority or block it.
894
+ if ((parallelism && !Object.keys(parallelism.clis ?? {}).includes(record?.cli))
895
+ || (requestedCli !== undefined && record?.cli !== requestedCli)) continue;
893
896
  reason = 'record-identity';
894
897
  try {
895
898
  const { cli, binding, adapter } = record;
@@ -925,7 +928,13 @@ export async function loadRecordedWorkerInstallations({ registry, cwd, policy, p
925
928
  await assertTrustedStore(filename, installation.workerWritableRoots);
926
929
  reason = 'adapter-metadata';
927
930
  const candidateRegistry = structuredClone(resolvedRegistry);
928
- if (candidateRegistry.providers[adapter.id]) candidateRegistry.providers[adapter.id].workerAdapter = adapter;
931
+ // Match qualification's provider lookup without making a -direct ID canonical.
932
+ const provider = candidateRegistry.providers[adapter.provider];
933
+ const reference = parallelism?.clis?.[cli]?.adapter ?? `providers:${cli}`;
934
+ const providerId = isOperatorQualifiedWorkerAdapter(adapter)
935
+ && (provider?.workerAdapter ?? provider?.workerHealthAdapter)?.id === adapter.id
936
+ && reference === `providers:${adapter.provider}` ? adapter.provider : adapter.id;
937
+ if (candidateRegistry.providers[providerId]) candidateRegistry.providers[providerId].workerAdapter = adapter;
929
938
  else { candidateRegistry.workerAdapters ??= {}; candidateRegistry.workerAdapters[adapter.id] = adapter; }
930
939
  parseProviderModelCapabilities(candidateRegistry);
931
940
  // The loader validates package identity, bytes and static exports BEFORE import.
@@ -45,7 +45,7 @@ export function isOperatorQualifiedWorkerAdapter(adapter) {
45
45
  }
46
46
  /** Bundled renderers with an independently checked native direct baseline. */
47
47
  export function hasOperatorWorkerNativeRenderer(adapter) {
48
- return isOperatorQualifiedWorkerAdapter(adapter) && ['codex', 'muse'].includes(adapter.provider)
48
+ return isOperatorQualifiedWorkerAdapter(adapter) && ['codex', 'muse', 'factory'].includes(adapter.provider)
49
49
  && adapter.invocation.kind === 'process';
50
50
  }
51
51
  /** The process-group launch boundary requires the independently verified native renderer. */
@@ -73,6 +73,30 @@ export function assertOperatorWorkerNativeArgv(adapter, argv, selected, permissi
73
73
  const sandbox = permissions?.sandbox ?? 'workspace-write';
74
74
  if (!['read-only', 'workspace-write', 'external'].includes(sandbox))
75
75
  throw new Error('Requested sandbox has no verified native renderer');
76
+ if (adapter.provider === 'factory') {
77
+ if (sandbox === 'external' || (permissions?.approval ?? 'never') !== 'never') {
78
+ throw new Error('Factory direct worker requires native sandbox and never approval');
79
+ }
80
+ if (selected.model.startsWith('custom:') && (selected.model.trim() !== selected.model || !/^custom:[^\s\x00-\x1f\x7f]+-\d+$/.test(selected.model))) {
81
+ throw new Error('Factory custom model selector requires a safe normalized name and numeric suffix');
82
+ }
83
+ requirePair('-m', selected.model);
84
+ requirePair('--output-format', 'stream-json');
85
+ const cwd = args[args.indexOf('--cwd') + 1];
86
+ if (!args.includes('--cwd') || !cwd?.startsWith('/') || cwd.includes('\0')) {
87
+ throw new Error('Factory direct worker requires an absolute workspace');
88
+ }
89
+ if (selected.effort.value === null && !selected.model.startsWith('custom:')) {
90
+ throw new Error('Factory built-in models require explicit effort');
91
+ }
92
+ const expected = ['exec', ...(sandbox === 'workspace-write' ? ['--auto', 'low'] : []),
93
+ '-m', selected.model, ...(selected.effort.value === null ? [] : ['-r', selected.effort.value]),
94
+ '--cwd', cwd, '--output-format', 'stream-json'];
95
+ if (args.length !== expected.length || args.some((value, index) => value !== expected[index])) {
96
+ throw new Error('Factory native worker controls could be overridden');
97
+ }
98
+ return;
99
+ }
76
100
  if (adapter.provider === 'muse') {
77
101
  requirePair('--provider', 'meta');
78
102
  requirePair('--model', selected.model);
@@ -93,7 +93,7 @@ export function wrapperEnforcementReport(provider, artifact) {
93
93
  const details = {
94
94
  claude: 'Use AIWG wrappers or an explicit invocation model. Unpinned general-purpose agents inherit; CLAUDE_CODE_SUBAGENT_MODEL supplies a fallback and CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 can override pins.',
95
95
  omp: 'Native model and thinkingLevel fields can pin exact operator role models; configured/* catalog entries are placeholders.',
96
- 'grok-build': 'Not enforced: native-agent model translation remains gated by #2577; configured selectors do not establish tier enforcement.',
96
+ 'grok-build': 'Grok Build 1.0.77: frontmatter model is ignored; agents inherit the session model. Select worker models with CLI -m; role/tier intent is informational.',
97
97
  openclaw: 'Markdown wrapper mirrors do not set native subagents.model or per-spawn overrides.',
98
98
  openhuman: 'User harness wrappers carry semantic model hints; project wrappers omit model. Neither is an exact pin.',
99
99
  antigravity: 'Wrapper mirrors do not project native CLI model/effort flags.',