@tangle-network/agent-interface 2.11.0 → 2.12.0

package/README.md

@@ -191,8 +191,11 @@ const worker = withProfileKb({
 ```
 
 Guidance goes into `appendSystemPrompt` where the harness owns an additive system-prompt control, and into `instructions` otherwise.
-Recomposing replaces earlier guidance, so a second call, or a call with an executor's harness or model override, yields a stable profile.
+Recomposing replaces the guidance `withProfileKb` wrote earlier, so a second call, or a call with an executor's harness or model override, yields a stable profile.
+The knowledge base owns the block sources `harness`, `model`, and `learning` (`PROFILE_KB_SOURCES`).
 `composeAgentProfileGuidance` is the underlying composer for other knowledge layers.
+Give each layer its own source name and pass it as `replaceSources`: the composition then replaces only those sources and keeps every other block in place. Without `replaceSources`, it replaces every block.
+The block marker is reserved for composers: a hand-written `<profile-guidance source="model" ...>` block counts as a knowledge-base block and is replaced.
 
 The module also exports the data (`profileKbHarnesses`, `profileKbModels`), operator notes for launching each harness and model, platform learnings (admitted only after an agent-eval check reproduced them), and `profileKbDiscrepancies`, which records where a vendor source states a requested name differently.
 

package/dist/agent-profile.d.ts

@@ -539,15 +539,28 @@ export interface AgentProfileGuidanceBlock {
  * system-prompt control.
  */
 export type AgentProfileGuidanceChannel = "appendSystemPrompt" | "instructions";
+/** Options for {@link composeAgentProfileGuidance}. */
+export interface AgentProfileGuidanceOptions {
+    /**
+     * The block sources this composition owns. Existing blocks from these
+     * sources are removed before the new blocks are composed; blocks from any
+     * other source stay where they are. When omitted, every previously composed
+     * block is removed, as in 2.11. Pass it to keep other layers in place.
+     */
+    replaceSources?: readonly string[];
+}
 /**
  * Compose harness, model, and other layered guidance into a profile's prompt.
  *
  * The blocks come first, in the order given, and the profile's own text comes
  * last, so the most specific instruction (the profile's) is the one a model
- * reads after the general guidance. Composition replaces any blocks a previous
+ * reads after the general guidance. Composition replaces the blocks a previous
  * composition added, on both channels, so recomposing after a harness or
- * model change never stacks stale guidance. Composing the same blocks twice
- * yields the same profile, and with it the same canonical identity.
+ * model change never stacks stale guidance. By default it replaces every
+ * block; with `options.replaceSources` it replaces only those sources and
+ * keeps the others, such as a team's own layer, in place. Composing the same
+ * blocks twice yields the same profile, and with it the same canonical
+ * identity.
  */
-export declare function composeAgentProfileGuidance(profile: AgentProfile, blocks: readonly AgentProfileGuidanceBlock[], channel: AgentProfileGuidanceChannel): AgentProfile;
+export declare function composeAgentProfileGuidance(profile: AgentProfile, blocks: readonly AgentProfileGuidanceBlock[], channel: AgentProfileGuidanceChannel, options?: AgentProfileGuidanceOptions): AgentProfile;
 export {};

package/dist/agent-profile.js

@@ -173,38 +173,121 @@ export function mergeAgentProfiles(base, overlay) {
         extensions: mergeRecord(base?.extensions, overlay?.extensions),
     });
 }
-const GUIDANCE_OPEN = /^<profile-guidance source="[^"]*" id="[^"]*">\n/;
-const GUIDANCE_BLOCK = /<profile-guidance source="[^"]*" id="[^"]*">\n[\s\S]*?\n<\/profile-guidance>(\n\n)?/g;
+const GUIDANCE_LINE = /^<profile-guidance source="([^"]*)" id="[^"]*">\n(?:(?!<\/profile-guidance>)[\s\S])*\n<\/profile-guidance>$/;
+// A block runs from an opening marker to the first closing marker after it,
+// which is how every released composer wrote blocks (2.11 text could carry an
+// opener but never a closer). When a match holds a second opener and the
+// markers balance from its start, the match may be an outer block cut short by
+// an inner one. That extent is ambiguous, so the balanced extent is kept whole:
+// recomposition may leave a stale block in such caller text, but it never
+// truncates caller text. When the markers never balance, the match is a 2.11
+// block whose text carried an opener, and it is replaced.
+const GUIDANCE_OPEN_MARKER = "<profile-guidance ";
+const GUIDANCE_CLOSE_MARKER = "</profile-guidance>";
+const GUIDANCE_BLOCK = /<profile-guidance source="([^"]*)" id="[^"]*">\n[\s\S]*?\n<\/profile-guidance>(\n\n)?/g;
 function renderGuidanceBlock(block) {
     if (/["\n]/.test(block.source) || /["\n]/.test(block.id)) {
         throw new TypeError("profile guidance source and id must not contain quotes or newlines");
     }
-    if (block.text.includes("</profile-guidance>")) {
-        throw new TypeError("profile guidance text must not contain the closing block marker");
+    // Only a closer can end a block early. An opener in the text is the 2.11
+    // input contract, and stripGuidanceText keeps such a block whole.
+    if (block.text.includes(GUIDANCE_CLOSE_MARKER)) {
+        throw new TypeError("profile guidance text must not contain a closing block marker");
     }
     return `<profile-guidance source="${block.source}" id="${block.id}">\n${block.text}\n</profile-guidance>`;
 }
-/** Remove every previously composed guidance block from appended prompt text. */
-function stripGuidanceText(text) {
+/** True when the block's body, after its opening tag line, holds an opener. */
+function nestsOpener(block) {
+    return block.includes(GUIDANCE_OPEN_MARKER, block.indexOf("\n"));
+}
+/**
+ * The end of the block that opens at `offset`, counting nested markers, or -1
+ * when the markers never balance (a 2.11 block whose text carried an opener).
+ */
+function balancedBlockEnd(text, offset) {
+    // As in GUIDANCE_BLOCK, a closer counts only at the start of a line, and an
+    // opener's attributes (one line, since source and id hold no newline) are
+    // skipped, so marker text inside them cannot end a block.
+    const closer = `\n${GUIDANCE_CLOSE_MARKER}`;
+    let depth = 0;
+    let at = offset;
+    for (;;) {
+        const open = text.indexOf(GUIDANCE_OPEN_MARKER, at);
+        const close = text.indexOf(closer, at);
+        if (close === -1)
+            return -1;
+        if (open !== -1 && open < close) {
+            depth += 1;
+            const lineEnd = text.indexOf("\n", open);
+            if (lineEnd === -1)
+                return -1;
+            at = lineEnd;
+        }
+        else {
+            depth -= 1;
+            at = close + closer.length;
+            if (depth === 0)
+                return at;
+        }
+    }
+}
+const ALL_SOURCES = { has: () => true };
+/** Remove previously composed guidance blocks from the owned sources. */
+function stripGuidanceText(text, owned) {
     if (text === undefined || text === "")
         return text;
-    const stripped = text.replace(GUIDANCE_BLOCK, "");
+    let strippedLast = false;
+    // A kept block that nests markers extends to its balanced end; every match
+    // inside it is caller text and is kept too.
+    let keptUntil = 0;
+    let stripped = text.replace(GUIDANCE_BLOCK, (block, source, gap, offset) => {
+        if (offset < keptUntil)
+            return block;
+        const end = nestsOpener(block) ? balancedBlockEnd(text, offset) : -1;
+        if (!owned.has(source) || end !== -1) {
+            keptUntil = Math.max(keptUntil, end);
+            return block;
+        }
+        if (gap === undefined && offset + block.length === text.length) {
+            strippedLast = true;
+        }
+        return "";
+    });
+    // A removed final block leaves the separator written before it.
+    if (strippedLast && stripped.endsWith("\n\n")) {
+        stripped = stripped.slice(0, -2);
+    }
     return stripped === "" ? undefined : stripped;
 }
+/**
+ * True only for a whole line that is one complete composed block from an owned
+ * source. A line that merely starts with an opening marker is caller text.
+ */
+function isOwnedGuidanceLine(line, owned) {
+    const match = GUIDANCE_LINE.exec(line);
+    return match !== null && owned.has(match[1]);
+}
 /**
  * Compose harness, model, and other layered guidance into a profile's prompt.
  *
  * The blocks come first, in the order given, and the profile's own text comes
  * last, so the most specific instruction (the profile's) is the one a model
- * reads after the general guidance. Composition replaces any blocks a previous
+ * reads after the general guidance. Composition replaces the blocks a previous
  * composition added, on both channels, so recomposing after a harness or
- * model change never stacks stale guidance. Composing the same blocks twice
- * yields the same profile, and with it the same canonical identity.
+ * model change never stacks stale guidance. By default it replaces every
+ * block; with `options.replaceSources` it replaces only those sources and
+ * keeps the others, such as a team's own layer, in place. Composing the same
+ * blocks twice yields the same profile, and with it the same canonical
+ * identity.
  */
-export function composeAgentProfileGuidance(profile, blocks, channel) {
+export function composeAgentProfileGuidance(profile, blocks, channel, options = {}) {
+    // Without replaceSources, every composed block is replaced, as in 2.11.
+    const owned = options.replaceSources === undefined
+        ? ALL_SOURCES
+        : new Set(options.replaceSources);
     const prompt = profile.prompt ?? {};
-    const ownAppend = stripGuidanceText(prompt.appendSystemPrompt);
-    const ownInstructions = prompt.instructions?.filter((line) => !GUIDANCE_OPEN.test(line));
+    const ownAppend = stripGuidanceText(prompt.appendSystemPrompt, owned);
+    const ownInstructions = prompt.instructions?.filter((line) => !isOwnedGuidanceLine(line, owned));
     const rendered = blocks.map(renderGuidanceBlock);
     const next = { ...prompt };
     delete next.appendSystemPrompt;

package/dist/profile-kb/harnesses.js

@@ -33,13 +33,13 @@ export const profileKbHarnesses = [
     {
         id: "codex",
         name: "Codex CLI",
-        version: "0.152.1",
+        version: "0.156.1",
         sources: [
             { url: "https://learn.chatgpt.com/docs/models", checkedAt: CHECKED },
             {
                 url: "cli:codex exec --help; codex features list",
                 checkedAt: CHECKED,
-                note: "0.152.1; multi_agent stable and enabled",
+                note: "0.156.1; multi_agent stable and enabled",
             },
         ],
         prompt: [
@@ -58,10 +58,10 @@ export const profileKbHarnesses = [
     {
         id: "opencode",
         name: "OpenCode",
-        version: "1.18.18",
+        version: "1.18.32",
         sources: [
             { url: "https://opencode.ai/docs/cli/", checkedAt: CHECKED },
-            { url: "cli:opencode run --help", checkedAt: CHECKED, note: "1.18.18" },
+            { url: "cli:opencode run --help", checkedAt: CHECKED, note: "1.18.32" },
         ],
         prompt: [
             "Delegate a focused subtask to a named agent when its persona or model fits the subtask.",
@@ -76,9 +76,17 @@ export const profileKbHarnesses = [
     {
         id: "pi",
         name: "Pi",
-        version: "0.83.0",
+        version: "0.87.1",
         sources: [
-            { url: "cli:pi --help", checkedAt: CHECKED, note: "0.83.0" },
+            {
+                url: "https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/cli.md",
+                checkedAt: CHECKED,
+            },
+            {
+                url: "https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/rpc.md",
+                checkedAt: CHECKED,
+            },
+            { url: "cli:pi --help", checkedAt: CHECKED, note: "0.87.1" },
         ],
         prompt: [
             "Expect steering messages mid-run and fold each one into the current plan.",
@@ -94,13 +102,13 @@ export const profileKbHarnesses = [
     {
         id: "kimi-code",
         name: "Kimi Code CLI",
-        version: "0.36.1",
+        version: "2.0.2",
         sources: [
             { url: "https://moonshotai.github.io/kimi-code/", checkedAt: CHECKED },
             {
                 url: "cli:kimi --help; ~/.kimi-code/config.toml",
                 checkedAt: CHECKED,
-                note: "0.36.1",
+                note: "2.0.2",
             },
         ],
         prompt: [

package/dist/profile-kb/index.d.ts

@@ -6,14 +6,20 @@
  * The data is plain, dated, and sourced. Composition is pure: the same profile
  * yields the same composed profile, so profile identity stays deterministic.
  */
-import { type AgentProfile, type AgentProfileGuidanceBlock } from "../agent-profile.js";
+import { composeAgentProfileGuidance, type AgentProfile, type AgentProfileGuidanceBlock } from "../agent-profile.js";
 import type { HarnessType } from "../harness.js";
 import { profileKbHarnesses } from "./harnesses.js";
 import { profileKbModels } from "./models.js";
 import { profileKbDiscrepancies, profileKbLearnings } from "./records.js";
 import type { ProfileKbHarness, ProfileKbModel } from "./types.js";
 export type * from "./types.js";
-export { profileKbDiscrepancies, profileKbHarnesses, profileKbLearnings, profileKbModels, };
+export type { AgentProfileGuidanceBlock, AgentProfileGuidanceChannel, AgentProfileGuidanceOptions, } from "../agent-profile.js";
+export { composeAgentProfileGuidance, profileKbDiscrepancies, profileKbHarnesses, profileKbLearnings, profileKbModels, };
+/**
+ * The guidance block sources the knowledge base owns. {@link withProfileKb}
+ * replaces blocks from these sources and keeps blocks any other layer added.
+ */
+export declare const PROFILE_KB_SOURCES: readonly ["harness", "model", "learning"];
 /** Date the knowledge base was last checked against its sources. */
 export declare const PROFILE_KB_CHECKED_AT = "2026-09-22";
 /** Find a harness entry by its {@link HarnessType}. */
@@ -47,6 +53,7 @@ export declare function profileKbGuidance(selection: ProfileKbSelection): AgentP
  * Guidance goes into `appendSystemPrompt` where the harness owns an additive
  * system-prompt control and into `instructions` otherwise, so a harness that
  * refuses appended system text still receives it. The profile's own text
- * stays last. Recomposing replaces earlier guidance, so the result is stable.
+ * stays last. Recomposing replaces the guidance this function wrote earlier,
+ * so the result is stable; blocks from other sources are kept.
  */
 export declare function withProfileKb(profile: AgentProfile, selection?: ProfileKbSelection): AgentProfile;

package/dist/profile-kb/index.js

@@ -7,11 +7,17 @@
  * yields the same composed profile, so profile identity stays deterministic.
  */
 import { composeAgentProfileGuidance, } from "../agent-profile.js";
+import { deepFreeze } from "../deep-freeze.js";
 import { harnessSystemPromptIntents } from "../harness-capabilities.js";
 import { profileKbHarnesses } from "./harnesses.js";
 import { profileKbModels } from "./models.js";
 import { profileKbDiscrepancies, profileKbLearnings } from "./records.js";
-export { profileKbDiscrepancies, profileKbHarnesses, profileKbLearnings, profileKbModels, };
+export { composeAgentProfileGuidance, profileKbDiscrepancies, profileKbHarnesses, profileKbLearnings, profileKbModels, };
+/**
+ * The guidance block sources the knowledge base owns. {@link withProfileKb}
+ * replaces blocks from these sources and keeps blocks any other layer added.
+ */
+export const PROFILE_KB_SOURCES = ["harness", "model", "learning"];
 /** Date the knowledge base was last checked against its sources. */
 export const PROFILE_KB_CHECKED_AT = "2026-09-22";
 /** Find a harness entry by its {@link HarnessType}. */
@@ -20,17 +26,29 @@ export function findProfileKbHarness(harness) {
         return undefined;
     return profileKbHarnesses.find((entry) => entry.id === harness);
 }
+/*
+ * Composition reads a frozen snapshot taken at load, never the exported
+ * records. A consumer that edits an exported entry therefore cannot change
+ * later compositions or desynchronize the lookup index, and the exported
+ * types stay as they were published.
+ */
+const harnessSnapshot = deepFreeze(structuredClone(profileKbHarnesses));
+const modelSnapshot = deepFreeze(structuredClone(profileKbModels));
+const learningSnapshot = deepFreeze(structuredClone(profileKbLearnings));
+function harnessPosition(harness) {
+    return harnessSnapshot.findIndex((entry) => entry.id === harness);
+}
 const modelIndex = (() => {
     const index = new Map();
-    for (const model of profileKbModels) {
+    modelSnapshot.forEach((model, position) => {
         for (const name of [model.id, ...model.aliases]) {
             const key = name.toLowerCase();
             if (index.has(key)) {
                 throw new Error(`profile-kb: model name ${name} is declared twice`);
             }
-            index.set(key, model);
+            index.set(key, position);
         }
-    }
+    });
     return index;
 })();
 /**
@@ -43,6 +61,15 @@ const modelIndex = (() => {
  * different model and never matches.
  */
 export function findProfileKbModel(model) {
+    // Public lookups search the exported records as they are now; composition
+    // alone reads the frozen snapshot, so neither can desynchronize the other.
+    return matchModelName(model, (candidate) => profileKbModels.find((entry) => [entry.id, ...entry.aliases].some((name) => name.toLowerCase() === candidate)));
+}
+/**
+ * Try the name as given, then without each leading `provider/` or route
+ * segment, after dropping a trailing `:suffix`.
+ */
+function matchModelName(model, lookup) {
     if (!model)
         return undefined;
     const colon = model.lastIndexOf(":");
@@ -50,8 +77,8 @@ export function findProfileKbModel(model) {
         .trim()
         .toLowerCase();
     for (;;) {
-        const found = modelIndex.get(candidate);
-        if (found)
+        const found = lookup(candidate);
+        if (found !== undefined)
             return found;
         const slash = candidate.indexOf("/");
         if (slash < 0)
@@ -59,8 +86,11 @@ export function findProfileKbModel(model) {
         candidate = candidate.slice(slash + 1);
     }
 }
+function modelPosition(model) {
+    return matchModelName(model, (candidate) => modelIndex.get(candidate)) ?? -1;
+}
 function learningsFor(harness, model) {
-    return profileKbLearnings.filter((learning) => {
+    return learningSnapshot.filter((learning) => {
         const scope = learning.appliesTo;
         if (scope.harness !== undefined && scope.harness !== harness?.id) {
             return false;
@@ -79,8 +109,10 @@ function bullets(lines) {
  * contribute nothing.
  */
 export function profileKbGuidance(selection) {
-    const harness = findProfileKbHarness(selection.harness);
-    const model = findProfileKbModel(selection.model);
+    const harness = selection.harness
+        ? harnessSnapshot[harnessPosition(selection.harness)]
+        : undefined;
+    const model = modelSnapshot[modelPosition(selection.model)];
     const blocks = [];
     if (harness && harness.prompt.length > 0) {
         blocks.push({
@@ -114,14 +146,18 @@ export function profileKbGuidance(selection) {
  * Guidance goes into `appendSystemPrompt` where the harness owns an additive
  * system-prompt control and into `instructions` otherwise, so a harness that
  * refuses appended system text still receives it. The profile's own text
- * stays last. Recomposing replaces earlier guidance, so the result is stable.
+ * stays last. Recomposing replaces the guidance this function wrote earlier,
+ * so the result is stable; blocks from other sources are kept.
  */
 export function withProfileKb(profile, selection = {}) {
     const harness = selection.harness ?? profile.harness;
     const model = selection.model ?? profile.model?.default;
     const blocks = profileKbGuidance({ harness, model });
-    const channel = harnessSystemPromptIntents(findProfileKbHarness(harness)?.id ?? harness).append
+    const known = harness ? harnessSnapshot[harnessPosition(harness)] : undefined;
+    const channel = harnessSystemPromptIntents(known?.id ?? harness).append
         ? "appendSystemPrompt"
         : "instructions";
-    return composeAgentProfileGuidance(profile, blocks, channel);
+    return composeAgentProfileGuidance(profile, blocks, channel, {
+        replaceSources: PROFILE_KB_SOURCES,
+    });
 }

package/dist/profile-kb/models.js

@@ -1,5 +1,14 @@
 const CHECKED = "2026-09-22";
 const claudeDocs = "https://platform.claude.com/docs/en";
+const openaiDocs = "https://developers.openai.com/api/docs";
+/** A router surface is listed only with a dated check that the router served the id. */
+function routerCheck(note) {
+    return {
+        url: "https://router.tangle.tools/v1/chat/completions",
+        checkedAt: CHECKED,
+        note,
+    };
+}
 /**
  * Current frontier models, from vendor sources read on 2026-09-22.
  *
@@ -12,7 +21,7 @@ export const profileKbModels = [
         id: "claude-opus-5-5",
         name: "Claude Opus 5.5",
         vendor: "Anthropic",
-        surfaces: ["api", "router"],
+        surfaces: ["api"],
         aliases: ["anthropic/claude-opus-5-5", "anthropic.claude-opus-5-5"],
         defaultEffort: "medium",
         sources: [
@@ -48,7 +57,7 @@ export const profileKbModels = [
         id: "claude-fable-5-1",
         name: "Claude Fable 5.1",
         vendor: "Anthropic",
-        surfaces: ["api", "router"],
+        surfaces: ["api"],
         aliases: ["anthropic/claude-fable-5-1", "anthropic.claude-fable-5-1"],
         defaultEffort: "high",
         sources: [
@@ -88,6 +97,7 @@ export const profileKbModels = [
                 url: `${claudeDocs}/build-with-claude/prompt-engineering/prompting-claude-sonnet-5`,
                 checkedAt: CHECKED,
             },
+            routerCheck("claude-sonnet-5 returned HTTP 200"),
         ],
         prompt: [
             "Apply each instruction to every case it names; where an instruction should apply broadly, the prompt says so.",
@@ -106,7 +116,7 @@ export const profileKbModels = [
         id: "claude-haiku-4-5",
         name: "Claude Haiku 4.5",
         vendor: "Anthropic",
-        surfaces: ["api", "router"],
+        surfaces: ["api"],
         aliases: [
             "claude-haiku-4-5-20251001",
             "anthropic/claude-haiku-4-5",
@@ -119,9 +129,9 @@ export const profileKbModels = [
             "Answer directly and keep each step scoped to the task in hand.",
         ],
         operator: [
-            "Model id claude-haiku-4-5-20251001 (alias claude-haiku-4-5); 200K context, 64K max output. The fastest model in the current lineup.",
+            "Model id claude-haiku-4-5-20251001 (alias claude-haiku-4-5); 200K context, 64K max output.",
             "Uses manual extended thinking (thinking.type enabled with budget_tokens); it takes no effort parameter.",
-            "Retirement not sooner than 2026-10-15.",
+            "Retirement date: 2026-10-15 at the earliest.",
         ],
     },
     {
@@ -148,6 +158,96 @@ export const profileKbModels = [
             "No API model id; reach it through ChatGPT (chatgpt-fleet).",
         ],
     },
+    {
+        id: "gpt-6-astra",
+        name: "GPT-6 Astra",
+        vendor: "OpenAI",
+        surfaces: ["codex", "api"],
+        aliases: ["openai/gpt-6-astra"],
+        defaultEffort: "medium",
+        sources: [
+            { url: `${openaiDocs}/models/gpt-6-astra`, checkedAt: CHECKED },
+            {
+                url: `${openaiDocs}/guides/latest-model?model=gpt-6-astra`,
+                checkedAt: CHECKED,
+                note: "Using GPT-6: prompting guidance",
+            },
+            { url: "https://learn.chatgpt.com/docs/models", checkedAt: CHECKED },
+            {
+                url: "cli:codex exec -m gpt-6-astra 'Reply with exactly: OK'",
+                checkedAt: CHECKED,
+                note: "codex-cli 0.156.1 on a ChatGPT account returned OK",
+            },
+        ],
+        prompt: [
+            "Infer the user's intent and task scope from the instructions and prior context, bias toward action, and carry the intended task to completion.",
+            "When you can parallelize work by delegating tasks to another agent, do so with the collaboration tools.",
+            "Write clear, concise paragraphs that each develop one idea; use lists only for parallel or sequential items.",
+        ],
+        operator: [
+            "Built for end-to-end work with sustained reasoning across many tools: coding, computer use, research, and documents.",
+            "API: 1,050,000-token context, 128K max output; efforts low, medium, high, xhigh, max.",
+            "Codex: 272K context; efforts low to max plus ultra, which delegates tasks automatically; default medium.",
+        ],
+    },
+    {
+        id: "gpt-6-sol",
+        name: "GPT-6 Sol",
+        vendor: "OpenAI",
+        surfaces: ["codex", "api"],
+        aliases: ["openai/gpt-6-sol"],
+        defaultEffort: "medium",
+        sources: [
+            { url: `${openaiDocs}/models/gpt-6-sol`, checkedAt: CHECKED },
+            {
+                url: `${openaiDocs}/guides/latest-model?model=gpt-6-sol`,
+                checkedAt: CHECKED,
+                note: "Using GPT-6: prompting guidance",
+            },
+            {
+                url: "cli:codex exec -m gpt-6-sol 'Reply with exactly: OK'",
+                checkedAt: CHECKED,
+                note: "codex-cli 0.156.1 on a ChatGPT account returned OK",
+            },
+        ],
+        prompt: [
+            "Treat a request such as 'can you', 'I want to', or 'help me' as an instruction to do the work.",
+            "The user's explicit instructions take precedence over a skill's instructions; if a skill makes you pause or ask, name the SKILL.md file.",
+            "Carry the task to completion and report the checks you ran.",
+        ],
+        operator: [
+            "Built for complex coding and agentic workflows, and for ambiguous or high-value tasks that need analysis and polish.",
+            "API: 1,050,000-token context, 128K max output; efforts none, low, medium (default), high, xhigh, max. Inputs over 272K tokens bill at 2x input and 1.5x output.",
+            "Codex: 272K context; efforts low to max plus ultra; default medium.",
+            "Use the Responses API for built-in tools; Chat Completions supports function calling only at effort none.",
+        ],
+    },
+    {
+        id: "gpt-6-luna",
+        name: "GPT-6 Luna",
+        vendor: "OpenAI",
+        surfaces: ["codex", "api"],
+        aliases: ["openai/gpt-6-luna"],
+        defaultEffort: "medium",
+        sources: [
+            { url: `${openaiDocs}/models/gpt-6-luna`, checkedAt: CHECKED },
+            { url: "https://learn.chatgpt.com/docs/models", checkedAt: CHECKED },
+            {
+                url: "cli:codex exec -m gpt-6-luna 'Reply with exactly: OK'",
+                checkedAt: CHECKED,
+                note: "codex-cli 0.156.1 on a ChatGPT account returned OK",
+            },
+        ],
+        prompt: [
+            "Work to the stated success criteria and output format for each item.",
+            "Scale testing to the change: once the targeted checks pass, test further only when new changes or failures justify it.",
+        ],
+        operator: [
+            "Built for focused, high-volume tasks with known success criteria: summarization, extraction, and focused coding.",
+            "API: 1,050,000-token context, 128K max output; efforts none, low, medium (default), high, xhigh, max.",
+            "Codex: 272K context; efforts low to max; default medium.",
+        ],
+    },
     {
         id: "gpt-5.6-sol",
         name: "GPT-5.6 Sol",
@@ -168,8 +268,9 @@ export const profileKbModels = [
             {
                 url: "file://~/.codex/models_cache.json",
                 checkedAt: CHECKED,
-                note: "codex-cli 0.152.1 served list; `codex exec -m gpt-5.6-sol` returned OK",
+                note: "codex-cli 0.156.1 served list; `codex exec -m gpt-5.6-sol` returned OK",
             },
+            routerCheck("gpt-5.6-sol returned HTTP 200"),
         ],
         prompt: [
             "Work from the outcome: know what good looks like and the stopping condition, then choose the method yourself.",
@@ -198,8 +299,9 @@ export const profileKbModels = [
             {
                 url: "file://~/.codex/models_cache.json",
                 checkedAt: CHECKED,
-                note: "codex-cli 0.152.1 served list; `codex exec -m gpt-5.6-terra` returned OK",
+                note: "codex-cli 0.156.1 served list; `codex exec -m gpt-5.6-terra` returned OK",
             },
+            routerCheck("gpt-5.6-terra returned HTTP 200"),
         ],
         prompt: [
             "Work from the outcome and the stopping condition; choose the method yourself and verify before you report.",
@@ -225,8 +327,9 @@ export const profileKbModels = [
             {
                 url: "file://~/.codex/models_cache.json",
                 checkedAt: CHECKED,
-                note: "codex-cli 0.152.1 served list; `codex exec -m gpt-5.6-luna` returned OK",
+                note: "codex-cli 0.156.1 served list; `codex exec -m gpt-5.6-luna` returned OK",
             },
+            routerCheck("gpt-5.6-luna returned HTTP 200"),
         ],
         prompt: [
             "Follow the stated format exactly and finish each item before moving to the next.",
@@ -252,11 +355,7 @@ export const profileKbModels = [
                 url: "https://api-docs.deepseek.com/quick_start/pricing",
                 checkedAt: CHECKED,
             },
-            {
-                url: "https://router.tangle.tools/v1/chat/completions",
-                checkedAt: CHECKED,
-                note: "deepseek/deepseek-v4.1-flash returned HTTP 200 and served that id",
-            },
+            routerCheck("deepseek/deepseek-v4.1-flash returned HTTP 200 and served that id"),
         ],
         prompt: [
             "State the goal and the finished result up front, and use the tools you are given to check your work.",
@@ -276,11 +375,7 @@ export const profileKbModels = [
         defaultEffort: "ultracode",
         sources: [
             { url: "https://docs.z.ai/guides/llm/glm-5.3", checkedAt: CHECKED },
-            {
-                url: "https://router.tangle.tools/v1/chat/completions",
-                checkedAt: CHECKED,
-                note: "glm-5.3 returned HTTP 200, served as z-ai/glm-5.3",
-            },
+            routerCheck("glm-5.3 returned HTTP 200, served as z-ai/glm-5.3"),
         ],
         prompt: [
             "Work the task through to a verified result, using the tools to run and check each change.",
@@ -302,11 +397,7 @@ export const profileKbModels = [
                 url: "https://platform.kimi.ai/docs/guide/kimi-k3-quickstart",
                 checkedAt: CHECKED,
             },
-            {
-                url: "https://router.tangle.tools/v1/chat/completions",
-                checkedAt: CHECKED,
-                note: "kimi-k3 returned HTTP 200, served as moonshotai/kimi-k3",
-            },
+            routerCheck("kimi-k3 returned HTTP 200, served as moonshotai/kimi-k3"),
         ],
         prompt: [
             "Navigate the repository, run the code, and iterate against tests, logs, and runtime output until the result holds.",

package/dist/profile-kb/records.js

@@ -13,15 +13,15 @@ export const profileKbDiscrepancies = [
     {
         subject: "OpenAI Codex models",
         requested: "gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna as the current Codex models",
-        observed: "OpenAI's Codex model page lists GPT-6 Astra, GPT-6 Sol, and GPT-6 Luna as the current recommended models. " +
-            "On this box, codex-cli 0.152.1 on a ChatGPT account serves gpt-5.6-sol, gpt-5.6-terra, and gpt-5.6-luna (each returned OK) " +
-            "and labels them 'Older'; gpt-6-sol and gpt-6-luna return 'not supported when using Codex with a ChatGPT account', " +
-            "and gpt-6-astra returns 'requires a newer version of Codex'. The knowledge base keeps the gpt-5.6 tiers because they are what this box can run.",
+        observed: "OpenAI's Codex model page lists GPT-6 Astra, GPT-6 Sol, and GPT-6 Luna as the current models. " +
+            "codex-cli 0.156.1 on a ChatGPT account serves all three (each returned OK) and labels the gpt-5.6 tiers 'Older'. " +
+            "The knowledge base carries the GPT-6 tiers as the current Codex models and keeps the requested gpt-5.6 tiers, which Codex and the API still serve.",
         sources: [
             { url: "https://learn.chatgpt.com/docs/models", checkedAt: CHECKED },
             {
                 url: "cli:codex exec -m <model> 'Reply with exactly: OK'",
                 checkedAt: CHECKED,
+                note: "codex-cli 0.156.1",
             },
         ],
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",