@tangle-network/agent-interface 0.17.0 → 0.18.0

package/dist/agent-profile.d.ts

@@ -92,7 +92,8 @@ export interface AgentProfileResources {
  *   - `minimal`  — thinking ON, the lowest budget (distinct from `none`)
  *   - `low` / `medium` / `high` / `xhigh`
  *   - `ultracode` — maximum (claude-code's "ultracode" run mode; codex's `max` reconciles here).
- * A backend without a matching native tier clamps to its nearest (e.g. codex maps `xhigh`/`ultracode` → `high`).
+ * A backend without a matching native tier clamps to its nearest (e.g. codex maps `ultracode` → `xhigh`
+ * on models that support it).
  */
 export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "ultracode";
 /**

package/dist/harness-capabilities.d.ts

@@ -11,9 +11,10 @@ import { type HarnessType } from "./harness.js";
  * cli-bridge backends, the sandbox UI pickers, and the router all read one truth instead of each
  * hand-rolling a divergent copy.
  *
- * Grounded in cli-bridge's real backend clamps (codex caps at `high`, kimi is binary on/off, claude
- * carries the full range, cli-base has no agent) — NOT a guessed matrix. The per-MODEL reasoning
- * capability (does this specific model reason at all) is dynamic catalog data the caller supplies.
+ * Grounded in cli-bridge's real backend clamps (codex is `low..xhigh` for current models, kimi is
+ * binary on/off, claude carries the full range, cli-base has no agent) — NOT a guessed matrix. The
+ * per-MODEL reasoning capability (does this specific model reason at all) is dynamic catalog data the
+ * caller supplies.
  */
 /** low → high. `none` = thinking off; `ultracode` = max (claude-code mode). */
 export declare const reasoningLadder: readonly ReasoningEffort[];

package/dist/harness-capabilities.js

@@ -10,9 +10,10 @@ import { canonicalizeHarness } from "./harness.js";
  * cli-bridge backends, the sandbox UI pickers, and the router all read one truth instead of each
  * hand-rolling a divergent copy.
  *
- * Grounded in cli-bridge's real backend clamps (codex caps at `high`, kimi is binary on/off, claude
- * carries the full range, cli-base has no agent) — NOT a guessed matrix. The per-MODEL reasoning
- * capability (does this specific model reason at all) is dynamic catalog data the caller supplies.
+ * Grounded in cli-bridge's real backend clamps (codex is `low..xhigh` for current models, kimi is
+ * binary on/off, claude carries the full range, cli-base has no agent) — NOT a guessed matrix. The
+ * per-MODEL reasoning capability (does this specific model reason at all) is dynamic catalog data the
+ * caller supplies.
  */
 /** low → high. `none` = thinking off; `ultracode` = max (claude-code mode). */
 export const reasoningLadder = [
@@ -124,8 +125,8 @@ export function snapHarnessToModel(harness, modelId) {
 /**
  * The explicit reasoning-effort set a harness's runtime accepts when it ISN'T a plain `none…ceiling`
  * slice — grounded in the cli-bridge adapters (NOT the canonical ladder):
- *   - codex: `model_reasoning_effort` accepts `minimal|low|medium|high` (xhigh/ultracode clamp down);
- *     it has no real `none` (the flag is just omitted), so `none` is dropped — `auto` covers "default".
+ *   - codex: current models advertise `low|medium|high|xhigh`; `none` is omitted (use `auto`) and
+ *     legacy `minimal` requests clamp up to `low`.
  *   - claude-code: `--effort` accepts `low|medium|high|xhigh|max`. `ultracode` is the ladder's stand-in
  *     for claude's `max` (clamped at runtime); `minimal`→`low` and `none`/`auto`→no flag, so both are
  *     dropped as redundant.
@@ -134,7 +135,7 @@ export function snapHarnessToModel(harness, modelId) {
  *     `--no-thinking`, `high` is "thinking on". So two levels, not five.
  */
 const harnessReasoningEffortsOverride = {
-    codex: ["minimal", "low", "medium", "high"],
+    codex: ["low", "medium", "high", "xhigh"],
     "claude-code": ["low", "medium", "high", "xhigh", "ultracode"],
     pi: ["minimal", "low", "medium", "high", "xhigh"],
     openclaw: ["minimal", "low", "medium", "high", "xhigh"],

package/dist/interaction.d.ts

@@ -49,6 +49,7 @@ export declare const InteractionFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     multi: z.ZodOptional<z.ZodBoolean>;
+    allowCustom: z.ZodOptional<z.ZodBoolean>;
     default: z.ZodOptional<z.ZodArray<z.ZodString>>;
     name: z.ZodString;
     label: z.ZodString;
@@ -92,6 +93,7 @@ export declare const InteractionAnswerSpecSchema: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         multi: z.ZodOptional<z.ZodBoolean>;
+        allowCustom: z.ZodOptional<z.ZodBoolean>;
         default: z.ZodOptional<z.ZodArray<z.ZodString>>;
         name: z.ZodString;
         label: z.ZodString;
@@ -190,6 +192,7 @@ export declare const InteractionRequestSchema: z.ZodObject<{
                 description: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             multi: z.ZodOptional<z.ZodBoolean>;
+            allowCustom: z.ZodOptional<z.ZodBoolean>;
             default: z.ZodOptional<z.ZodArray<z.ZodString>>;
             name: z.ZodString;
             label: z.ZodString;
@@ -261,6 +264,8 @@ export type LegacyQuestion = {
         description?: string;
     }>;
     multiSelect?: boolean;
+    /** When true the select field accepts write-in answers beyond `options`. */
+    allowCustom?: boolean;
 };
 /**
  * Build an answer spec from the legacy `question` event shape. Each question

package/dist/interaction.js

@@ -62,6 +62,12 @@ export const InteractionFieldSchema = z.discriminatedUnion("type", [
             .min(1),
         /** When true the user may pick more than one option. */
         multi: z.boolean().optional(),
+        /**
+         * When true the answer may contain write-in values outside `options`
+         * (e.g. a rendered "Other…" choice carrying the user's own text).
+         * Write-ins must still be non-empty strings.
+         */
+        allowCustom: z.boolean().optional(),
         default: z.array(z.string()).optional(),
     }),
     /** Like `text` but the value is sensitive (token/key) and must be masked. */
@@ -185,6 +191,7 @@ export function questionAnswerSpec(questions) {
                 label: q.question,
                 required: true,
                 multi: q.multiSelect === true,
+                ...(q.allowCustom === true ? { allowCustom: true } : {}),
                 options: q.options.map((o) => ({ value: o.label, label: o.label, description: o.description })),
             };
         }
@@ -239,8 +246,16 @@ export function validateInteractionAnswer(spec, data) {
                     errors.push(`field "${field.name}" requires a selection`);
                 const allowed = new Set(field.options.map((o) => o.value));
                 for (const choice of v) {
-                    if (!allowed.has(choice))
-                        errors.push(`field "${field.name}" has invalid option "${choice}"`);
+                    if (allowed.has(choice))
+                        continue;
+                    if (field.allowCustom === true) {
+                        // Write-ins are open but stay fail-closed on shape: string, non-blank.
+                        if (typeof choice !== "string" || choice.trim() === "") {
+                            errors.push(`field "${field.name}" has blank write-in value`);
+                        }
+                        continue;
+                    }
+                    errors.push(`field "${field.name}" has invalid option "${choice}"`);
                 }
                 break;
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.js",