crewly 1.20.25 → 1.20.28

package/dist/cli/backend/src/utils/runtime-model-flags.utils.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Per-agent model selection for the PTY runtimes.
+ *
+ * Every harness exposes a launch flag that pins the model for the session
+ * (the in-process Crewly Agent runtime takes its model in code instead):
+ *
+ * | runtime      | model flag            | reasoning effort                          |
+ * |--------------|-----------------------|-------------------------------------------|
+ * | claude-code  | `--model <name>`      | `--effort low|medium|high|xhigh|max`      |
+ * | codex-cli    | `-m <name>`           | `-c model_reasoning_effort="<level>"`     |
+ * | gemini-cli   | `-m <name>`           | —                                         |
+ * | opencode-cli | `--model <prov/model>`| —                                         |
+ *
+ * `buildRuntimeModelFlags` turns a member's `modelId` / `reasoningEffort`
+ * into those flags; `injectRuntimeFlags` places any flag list right after
+ * the harness binary in a launch command (`codex resume …` included) and
+ * drops a pre-existing copy of the same flag so the member override wins
+ * without tripping clap's "cannot be used multiple times".
+ *
+ * @module utils/runtime-model-flags
+ */
+/**
+ * Whether a model id is safe to put on a command line.
+ *
+ * @param modelId - Candidate model id
+ * @returns True when it matches the allowed character set
+ */
+export declare function isSafeModelId(modelId: string | undefined): modelId is string;
+/**
+ * Whether a reasoning-effort level is safe to put on a command line.
+ *
+ * @param effort - Candidate level
+ * @returns True when it is a single lowercase word
+ */
+export declare function isSafeReasoningEffort(effort: string | undefined): effort is string;
+/**
+ * Build the launch flags that pin a model (and optionally the reasoning
+ * effort) for one runtime. Unknown runtimes and the in-process Crewly
+ * Agent get no flags; unsafe values are ignored rather than quoted.
+ *
+ * @param runtimeType - The member's runtime
+ * @param modelId - Model name as the harness expects it (`opus`, `gpt-5.6-sol`, `anthropic/claude-sonnet-4`)
+ * @param reasoningEffort - Optional effort level (Claude Code / Codex only)
+ * @returns Flags to insert after the binary, e.g. `['--model', 'opus']`
+ *
+ * @example
+ * buildRuntimeModelFlags('codex-cli', 'gpt-5.6-sol', 'high')
+ * // => ['-m', 'gpt-5.6-sol', '-c', 'model_reasoning_effort="high"']
+ */
+export declare function buildRuntimeModelFlags(runtimeType: string, modelId?: string, reasoningEffort?: string): string[];
+/**
+ * Insert flags into a launch command right after the runtime binary
+ * (`claude`, `codex`/`codex resume`, `gemini`, `opencode`). A flag that is
+ * already present in the command is replaced. When the binary is not found
+ * (custom wrapper scripts), the flags go before
+ * `--dangerously-skip-permissions` if present, else at the end.
+ *
+ * @param command - One launch command line (may carry a `VAR=1` prefix)
+ * @param runtimeType - The runtime the command starts
+ * @param flags - Flags to insert (already shell-safe)
+ * @returns The rewritten command; unchanged when `flags` is empty
+ *
+ * @example
+ * injectRuntimeFlags('codex -a never -s danger-full-access', 'codex-cli', ['-m', 'gpt-5.6-sol'])
+ * // => 'codex -m gpt-5.6-sol -a never -s danger-full-access'
+ */
+export declare function injectRuntimeFlags(command: string, runtimeType: string, flags: string[]): string;
+//# sourceMappingURL=runtime-model-flags.utils.d.ts.map

package/dist/cli/backend/src/utils/runtime-model-flags.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model-flags.utils.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/runtime-model-flags.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA0BH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,IAAI,MAAM,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,IAAI,MAAM,CAElF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,EAAE,CAkBV;AAeD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAgBhG"}

package/dist/cli/backend/src/utils/runtime-model-flags.utils.js

@@ -0,0 +1,140 @@
+/**
+ * Per-agent model selection for the PTY runtimes.
+ *
+ * Every harness exposes a launch flag that pins the model for the session
+ * (the in-process Crewly Agent runtime takes its model in code instead):
+ *
+ * | runtime      | model flag            | reasoning effort                          |
+ * |--------------|-----------------------|-------------------------------------------|
+ * | claude-code  | `--model <name>`      | `--effort low|medium|high|xhigh|max`      |
+ * | codex-cli    | `-m <name>`           | `-c model_reasoning_effort="<level>"`     |
+ * | gemini-cli   | `-m <name>`           | —                                         |
+ * | opencode-cli | `--model <prov/model>`| —                                         |
+ *
+ * `buildRuntimeModelFlags` turns a member's `modelId` / `reasoningEffort`
+ * into those flags; `injectRuntimeFlags` places any flag list right after
+ * the harness binary in a launch command (`codex resume …` included) and
+ * drops a pre-existing copy of the same flag so the member override wins
+ * without tripping clap's "cannot be used multiple times".
+ *
+ * @module utils/runtime-model-flags
+ */
+import { RUNTIME_TYPES } from '../constants.js';
+/** Model names are passed to a shell: only the characters real model ids use. */
+const MODEL_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/;
+/** Effort levels are single lowercase words (`low`, `xhigh`, …). */
+const EFFORT_RE = /^[a-z][a-z0-9]{0,15}$/;
+/** Flags that select a model / effort, per runtime, so an existing copy can be replaced. */
+const MODEL_FLAG_NAMES = {
+    [RUNTIME_TYPES.CLAUDE_CODE]: ['--model', '--effort'],
+    [RUNTIME_TYPES.CODEX_CLI]: ['--model', '-m'],
+    [RUNTIME_TYPES.GEMINI_CLI]: ['--model', '-m'],
+    [RUNTIME_TYPES.OPENCODE_CLI]: ['--model', '-m'],
+};
+/** Runtime binaries, used to find the insertion point in a launch command. */
+const RUNTIME_BINARY_RE = {
+    [RUNTIME_TYPES.CLAUDE_CODE]: /\bclaude\b/,
+    // `codex resume <id>` takes the same global flags after the subcommand.
+    [RUNTIME_TYPES.CODEX_CLI]: /\bcodex(?:\s+resume)?\b/,
+    [RUNTIME_TYPES.GEMINI_CLI]: /\bgemini\b/,
+    [RUNTIME_TYPES.OPENCODE_CLI]: /\bopencode\b/,
+};
+/**
+ * Whether a model id is safe to put on a command line.
+ *
+ * @param modelId - Candidate model id
+ * @returns True when it matches the allowed character set
+ */
+export function isSafeModelId(modelId) {
+    return typeof modelId === 'string' && MODEL_ID_RE.test(modelId);
+}
+/**
+ * Whether a reasoning-effort level is safe to put on a command line.
+ *
+ * @param effort - Candidate level
+ * @returns True when it is a single lowercase word
+ */
+export function isSafeReasoningEffort(effort) {
+    return typeof effort === 'string' && EFFORT_RE.test(effort);
+}
+/**
+ * Build the launch flags that pin a model (and optionally the reasoning
+ * effort) for one runtime. Unknown runtimes and the in-process Crewly
+ * Agent get no flags; unsafe values are ignored rather than quoted.
+ *
+ * @param runtimeType - The member's runtime
+ * @param modelId - Model name as the harness expects it (`opus`, `gpt-5.6-sol`, `anthropic/claude-sonnet-4`)
+ * @param reasoningEffort - Optional effort level (Claude Code / Codex only)
+ * @returns Flags to insert after the binary, e.g. `['--model', 'opus']`
+ *
+ * @example
+ * buildRuntimeModelFlags('codex-cli', 'gpt-5.6-sol', 'high')
+ * // => ['-m', 'gpt-5.6-sol', '-c', 'model_reasoning_effort="high"']
+ */
+export function buildRuntimeModelFlags(runtimeType, modelId, reasoningEffort) {
+    const model = isSafeModelId(modelId) ? modelId : undefined;
+    const effort = isSafeReasoningEffort(reasoningEffort) ? reasoningEffort : undefined;
+    switch (runtimeType) {
+        case RUNTIME_TYPES.CLAUDE_CODE:
+            return [...(model ? ['--model', model] : []), ...(effort ? ['--effort', effort] : [])];
+        case RUNTIME_TYPES.CODEX_CLI:
+            return [
+                ...(model ? ['-m', model] : []),
+                ...(effort ? ['-c', `model_reasoning_effort="${effort}"`] : []),
+            ];
+        case RUNTIME_TYPES.GEMINI_CLI:
+            return model ? ['-m', model] : [];
+        case RUNTIME_TYPES.OPENCODE_CLI:
+            return model ? ['--model', model] : [];
+        default:
+            return [];
+    }
+}
+/**
+ * Remove an existing `<flag> <value>` / `<flag>=<value>` pair from a command.
+ *
+ * @param command - Launch command
+ * @param flagName - e.g. `--model` or `-m`
+ * @returns Command without that flag
+ */
+function stripFlag(command, flagName) {
+    const escaped = flagName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const re = new RegExp(`(^|\\s)${escaped}(?:=|\\s+)(?:"[^"]*"|'[^']*'|\\S+)(?=\\s|$)`, 'g');
+    return command.replace(re, '$1').replace(/\s{2,}/g, ' ').trim();
+}
+/**
+ * Insert flags into a launch command right after the runtime binary
+ * (`claude`, `codex`/`codex resume`, `gemini`, `opencode`). A flag that is
+ * already present in the command is replaced. When the binary is not found
+ * (custom wrapper scripts), the flags go before
+ * `--dangerously-skip-permissions` if present, else at the end.
+ *
+ * @param command - One launch command line (may carry a `VAR=1` prefix)
+ * @param runtimeType - The runtime the command starts
+ * @param flags - Flags to insert (already shell-safe)
+ * @returns The rewritten command; unchanged when `flags` is empty
+ *
+ * @example
+ * injectRuntimeFlags('codex -a never -s danger-full-access', 'codex-cli', ['-m', 'gpt-5.6-sol'])
+ * // => 'codex -m gpt-5.6-sol -a never -s danger-full-access'
+ */
+export function injectRuntimeFlags(command, runtimeType, flags) {
+    if (flags.length === 0)
+        return command;
+    let cmd = command;
+    const known = MODEL_FLAG_NAMES[runtimeType] ?? [];
+    for (const flag of flags) {
+        if (flag.startsWith('-') && known.includes(flag))
+            cmd = stripFlag(cmd, flag);
+    }
+    const flagStr = flags.join(' ');
+    const binary = RUNTIME_BINARY_RE[runtimeType];
+    if (binary && binary.test(cmd)) {
+        return cmd.replace(binary, (m) => `${m} ${flagStr}`);
+    }
+    if (cmd.includes('--dangerously-skip-permissions')) {
+        return cmd.replace('--dangerously-skip-permissions', `${flagStr} --dangerously-skip-permissions`);
+    }
+    return `${cmd} ${flagStr}`;
+}
+//# sourceMappingURL=runtime-model-flags.utils.js.map

package/dist/cli/backend/src/utils/runtime-model-flags.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-model-flags.utils.js","sourceRoot":"","sources":["../../../../../backend/src/utils/runtime-model-flags.utils.ts"],"names":[],"mappings":"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"}