@akanjs/cli 3.0.0-beta.13 → 3.0.0-beta.15

package/{devTui-myg3pqeg.js → devTui-v19fbnpk.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
-  openBrowser,
-  plainTextOf,
-  HOST_SOURCE,
-  DevLogBuffer
-} from "./index-cnzm1wn5.js";
+  stripAnsi
+} from "./index-7md2g9vw.js";
+import {
+  openBrowser
+} from "./index-chp5gqmm.js";
 import {
   writeClipboard
 } from "./index-p6pbz9n5.js";
@@ -156,6 +156,8 @@ var DevTuiApp = ({ actions }) => {
       actions.copyLines();
     else if (input === "Y")
       actions.copyPath();
+    else if (input === "s")
+      actions.copyShareUrl();
     else if (input === "o")
       actions.openSelected();
     else if (input === "r")
@@ -216,12 +218,95 @@ var DevTuiApp = ({ actions }) => {
       }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV(Text, {
         dimColor: true,
         wrap: "truncate",
-        children: `Tab next \xB7 1-9 app \xB7 \u2191\u2193 scroll (shift page) \xB7 G follow${snapshot.following ? "" : " (paused)"} \xB7 / grep${snapshot.grep ? ` (${snapshot.grep})` : ""} \xB7 e errors${snapshot.errorsOnly ? " on" : ""} \xB7 c clear \xB7 y copy \xB7 Y path \xB7 o open \xB7 r restart \xB7 q quit`
+        children: `${snapshot.hasShare ? "s share \xB7 " : ""}Tab next \xB7 1-9 app \xB7 \u2191\u2193 scroll (shift page) \xB7 G follow${snapshot.following ? "" : " (paused)"} \xB7 / grep${snapshot.grep ? ` (${snapshot.grep})` : ""} \xB7 e errors${snapshot.errorsOnly ? " on" : ""} \xB7 c clear \xB7 y copy \xB7 Y path \xB7 o open \xB7 r restart \xB7 q quit`
       }, undefined, false, undefined, this)
     ]
   }, undefined, true, undefined, this);
 };
 
+// pkgs/@akanjs/cli/application/devLogBuffer.ts
+var plainTextOf = (lines, { withApp = false } = {}) => {
+  const width = withApp ? lines.reduce((max, line) => Math.max(max, line.app.length), 0) : 0;
+  return lines.map((line) => `${withApp ? `${line.app.padEnd(width)} \u2502 ` : ""}${stripAnsi(line.text)}`).join(`
+`);
+};
+var HOST_SOURCE = "host";
+var childPrefix = /^\[child:(\d+) ([a-z-]+)\] \[(?:stdout|stderr)\] /;
+var sourceOf = (text) => {
+  const match = childPrefix.exec(text);
+  return match ? `#${match[1]} ${match[2]}` : HOST_SOURCE;
+};
+
+class DevLogBuffer {
+  static defaultLimit = 5000;
+  #limit;
+  #lines = [];
+  #partial = new Map;
+  #sources = new Map;
+  #seq = 0;
+  constructor({ limit = DevLogBuffer.defaultLimit } = {}) {
+    this.#limit = Math.max(1, limit);
+  }
+  get size() {
+    return this.#lines.length;
+  }
+  sourcesOf(app) {
+    return [...this.#sources.get(app) ?? []];
+  }
+  push(app, kind, chunk) {
+    const key = `${app}:${kind}`;
+    const parts = `${this.#partial.get(key) ?? ""}${chunk}`.split(`
+`);
+    this.#partial.set(key, parts.pop() ?? "");
+    return this.#append(app, kind, parts);
+  }
+  flushPartials() {
+    const flushed = [];
+    for (const [key, remainder] of [...this.#partial]) {
+      this.#partial.set(key, "");
+      if (!remainder)
+        continue;
+      const split = key.lastIndexOf(":");
+      const app = key.slice(0, split);
+      const kind = key.slice(split + 1) === "stderr" ? "stderr" : "stdout";
+      flushed.push(...this.#append(app, kind, [remainder]));
+    }
+    return flushed;
+  }
+  select({ app = null, source = null, grep, errorsOnly = false } = {}) {
+    const needle = grep?.trim().toLowerCase();
+    return this.#lines.filter((line) => {
+      if (app !== null && line.app !== app)
+        return false;
+      if (source !== null && line.source !== source)
+        return false;
+      if (errorsOnly && line.kind !== "stderr")
+        return false;
+      if (needle && !stripAnsi(line.text).toLowerCase().includes(needle))
+        return false;
+      return true;
+    });
+  }
+  clear(app = null) {
+    const kept = app === null ? [] : this.#lines.filter((line) => line.app !== app);
+    this.#lines.length = 0;
+    this.#lines.push(...kept);
+  }
+  #append(app, kind, texts) {
+    const known = this.#sources.get(app) ?? new Set;
+    this.#sources.set(app, known);
+    const added = texts.map((text) => {
+      const source = sourceOf(text);
+      known.add(source);
+      return { seq: ++this.#seq, app, source, kind, text };
+    });
+    this.#lines.push(...added);
+    if (this.#lines.length > this.#limit)
+      this.#lines.splice(0, this.#lines.length - this.#limit);
+    return added;
+  }
+}
+
 // pkgs/@akanjs/cli/application/devLogWindow.ts
 var windowOf = (lines, rows, anchor) => {
   const height = Math.max(1, Math.trunc(rows));
@@ -293,6 +378,7 @@ class DevTui {
         clear: this.#clear,
         copyLines: this.#copyLines,
         copyPath: this.#copyPath,
+        copyShareUrl: this.#copyShareUrl,
         openSelected: this.#openSelected,
         restartSelected: this.#restartSelected,
         quit: this.#quit
@@ -328,7 +414,7 @@ class DevTui {
       process.stdout.write(`${line.app} \u2502 ${line.text}
 `);
     for (const status of this.#statuses)
-      process.stdout.write(`${status.name} ${status.url} \u2014 ${status.state}
+      process.stdout.write(`${status.name} ${status.url}${status.shareUrl ? ` \xB7 ${status.shareUrl}` : ""} \u2014 ${status.state}
 `);
     const log = this.#supervisor.sessionLog;
     for (const name of log.appNames)
@@ -388,7 +474,7 @@ class DevTui {
     this.#cachedSnapshot = {
       rows,
       selected: this.#indexOfTarget(rows),
-      title: status ? `${status.name}${this.#target.source ? ` \xB7 ${this.#target.source}` : ""} \xB7 ${status.url} \xB7 ${status.state}${status.detail ? ` (${status.detail})` : ""}` : "all apps",
+      title: status ? `${status.name}${this.#target.source ? ` \xB7 ${this.#target.source}` : ""}${status.shareUrl ? ` \xB7 \u25C8 ${status.shareUrl}` : ""} \xB7 ${status.url} \xB7 ${status.state}${status.detail ? ` (${status.detail})` : ""}` : this.#mergedTitle(),
       lines: view.lines,
       above: view.above,
       below: view.below,
@@ -399,6 +485,7 @@ class DevTui {
       errorsOnly: this.#errorsOnly,
       editingGrep: this.#editingGrep,
       notice: this.#notice,
+      hasShare: this.#statuses.some((candidate) => !!candidate.shareUrl),
       readyCount: this.#statuses.filter((candidate) => candidate.state === "ready").length,
       appCount: this.#statuses.length,
       logRows,
@@ -500,6 +587,25 @@ class DevTui {
     const app = this.#target.app;
     return (app ? [app] : log.appNames).map((name) => log.relativePathOf(name));
   }
+  #copyShareUrl = () => {
+    const urls = this.#shareUrls();
+    if (urls.length === 0) {
+      this.#setNotice("no public share \u2014 start with --share");
+      return;
+    }
+    writeClipboard(urls.join(`
+`)).then((copied) => {
+      this.#setNotice(copied ? `copied ${urls.join(" \xB7 ")}` : urls.join(" \xB7 "));
+    });
+  };
+  #shareUrls() {
+    const app = this.#target.app;
+    return this.#statuses.filter((status) => app === null || status.name === app).map((status) => status.shareUrl).filter((url) => !!url);
+  }
+  #mergedTitle() {
+    const urls = this.#shareUrls();
+    return urls.length === 0 ? "all apps" : `all apps \xB7 \u25C8 ${urls.join(" \xB7 ")}`;
+  }
   #setNotice(text) {
     this.#notice = text;
     if (this.#noticeTimer)

package/{devTuiView-gz2fbf4v.js → devTuiView-pa63jrjq.js}

@@ -1,7 +1,7 @@
 // @bun
 // pkgs/@akanjs/cli/application/devTuiView.ts
 var createDevTuiView = async (supervisor) => {
-  const { DevTui } = await import("./devTui-myg3pqeg.js");
+  const { DevTui } = await import("./devTui-v19fbnpk.js");
   return new DevTui(supervisor);
 };
 export {

package/guideline.command-qvrh5pnx.js

@@ -0,0 +1,48 @@
+// @bun
+import {
+  script,
+  command
+} from "./index-gca9y01h.js";
+import"./index-q0y2jq9j.js";
+import"./index-p1j0cyvd.js";
+import"./index-6wwzs1bc.js";
+import {
+  Prompter2
+} from "./index-twq9p2sp.js";
+
+// pkgs/@akanjs/cli/guideline/guideline.script.ts
+import { Logger } from "akanjs/common";
+
+class GuidelineScript extends script("guideline") {
+  async guideline(action, name = null, format = "markdown") {
+    if (action === "list") {
+      const guidelines = await Prompter2.listGuidelines();
+      Logger.rawLog(format === "json" ? JSON.stringify({ guidelines }, null, 2) : guidelines.join(`
+`));
+      return;
+    }
+    if (action === "show") {
+      if (!name)
+        throw new Error("Guideline name is required. Example: akan guideline show framework");
+      const [instruction, guideJson] = await Promise.all([Prompter2.getInstruction(name), Prompter2.getGuideJson(name)]);
+      Logger.rawLog(format === "json" ? JSON.stringify({ name, instruction, guideJson }, null, 2) : instruction);
+      return;
+    }
+    throw new Error(`Unknown guideline action: ${action}. Use "list" or "show".`);
+  }
+}
+
+// pkgs/@akanjs/cli/guideline/guideline.command.ts
+class GuidelineCommand extends command("guideline", [GuidelineScript], ({ public: target }) => ({
+  guideline: target({ desc: "List or show Akan AI guideline instructions" }).arg("action", String, { desc: "list or show" }).arg("name", String, { desc: "guideline name for show", nullable: true }).option("format", String, {
+    desc: "output format",
+    default: "markdown",
+    enum: ["markdown", "json"]
+  }).exec(async function(action, name, format) {
+    await this.guidelineScript.guideline(action, name, format);
+  })
+})) {
+}
+export {
+  GuidelineCommand
+};

package/guidelines/agentRule/agentRule.instruction.md

@@ -46,7 +46,7 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   already titles, and `defaultDraft` opens the composer with text in it without sending it. A panel driven by a
   controlled `open` with **no** `onOpenChange` draws no close button at all rather than an inert one. Then the
   slots: `AgentLauncher`, `AgentSteps`, `AgentBubble`, `AgentComposer`, `AgentApproval`,
-  `AgentQuestion`, `AgentQueued`, `AgentMenu`, `AgentMarkdown` and `AgentCode` each replace one part in `_overrides.tsx`, and
+  `AgentQuestion`, `AgentToolCard`, `AgentQueued`, `AgentMenu`, `AgentMarkdown` and `AgentCode` each replace one part in `_overrides.tsx`, and
   `akanjs/ui` exports every default beside them (`DefaultBubble`, `DefaultComposer`, …) so a skin composes the
   one it is replacing. **`AgentSteps` is one agent turn** — the messages between the user message that opened it
   and the next one, with `isRunning` saying whether more are still coming — which is the grain a chat needs to
@@ -76,19 +76,30 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
 - **The LLM is configured in `option.ts`, never through the environment.** `option.setLlm({ apiKey, model, host })`
   — or `setLlm((options) => …)` to read the key out of the app's own env object, which is where a secret belongs —
   fills whichever adaptor holds `LlmAdaptorRole`, reaching it as the `llmOption` use. The settings are the role's
-  rather than one provider's, so they survive a swap. **DeepSeek is the built-in default** (`deepseek-v4-flash` at
-  `https://api.deepseek.com`); with no `apiKey` the app still boots and the chat answers `llmUnavailable`. Swap
-  providers the way middleware is applied: `option.applyAdaptor(LlmAdaptorRole, AnthropicLlm)`. An app may still
-  write its own — an `adapt()` class in a `srvkit/` implementing `LlmAdaptor.chat(request, onDelta?)`, where
-  ignoring `onDelta` still answers whole — but for vision it no longer has to.
-- **Three providers ship, and only two of them read a picture.** `DeepseekLlm` is the default and declares no
-  `accepts`, which is a fact about its API rather than a gap. `OpenaiLlm` speaks the same chat-completions dialect
-  — `OpenaiDialect`, shared between them so a protocol fix lands once — against `https://api.openai.com/v1` and
-  declares `{ image: true }`, sending an image as a content part. `AnthropicLlm` is the Messages API and declares
-  `{ image: true, document: true }`; it is its own file rather than a branch, because the system prompt is a field
-  and not a message, tool calls and results are content blocks, the results ride in a *user* turn, roles must
-  alternate — so two wire turns that map to one role are merged — and `max_tokens` is required. **Both new ones
-  require `model`**: a default would age into a 404, and worse, it would decide the vision claim for the app.
+  rather than one provider's, so they survive a swap. **`OpenaiLlm` is the built-in default**, pointed at
+  `https://api.openai.com/v1`; with no `apiKey` or no `model` the app still boots and the chat answers
+  `llmUnavailable`. Swap providers the way middleware is applied:
+  `option.applyAdaptor(LlmAdaptorRole, AnthropicLlm)`. An app may still write its own — an `adapt()` class in a
+  `srvkit/` implementing `LlmAdaptor.chat(request, onDelta?)`, where ignoring `onDelta` still answers whole — and
+  whatever settings it needs beyond `LlmOption` travel through the same `setLlm`, read back with
+  `use<MyLlmOption>()` from an interface extending it.
+- **Two adaptors ship, one per wire — a vendor is a host and a model name, not a protocol.** `OpenaiLlm` is the
+  chat-completions dialect (`OpenaiDialect`) pointed at whatever `host` names, so OpenAI, DeepSeek, Groq,
+  Together, OpenRouter, Ollama and a self-hosted vLLM are all one class and one `option.setLlm({ host, model })`.
+  `AnthropicLlm` is the Messages API and declares `{ image: true, document: true }`; it is its own file rather
+  than a branch, because the system prompt is a field and not a message, tool calls and results are content
+  blocks, the results ride in a *user* turn, roles must alternate — so two wire turns that map to one role are
+  merged — and `max_tokens` is required. **Both require `model`**: a default would age into a 404, and worse, it
+  would decide the vision claim for the app.
+- **`OpenaiLlm` claims vision for its default host and for nothing else.** OpenAI's own endpoint takes image
+  parts, so that is what it answers with no `host` set. A `host` the app named is a gateway the class knows
+  nothing about, and it stays text-only until `option.setLlm({ accepts })` says otherwise — handing bytes to a
+  model that cannot decode them kills the whole turn on a 400, where text-only degrades them to a note the model
+  can repeat back.
+- **A refusal is one key, `agent.error.llmRequestFailed`, and it names the host.** The provider's own sentence
+  rides in `reason` and the hostname in `provider`, so an adaptor an app wrote reports through the same
+  translated channel the shipped ones do rather than needing a key in the framework's dictionary it cannot
+  add.
 - **`accepts` is answered per model, through `option.setLlm({ accepts })`.** An adaptor answers for an API and one
   API serves models that differ, so the override rides beside the `model` it is a fact about. It is not a table
   the framework keeps: a table is a claim about models that ship after it, and getting this wrong is the worst
@@ -205,6 +216,15 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   is called from components the composer cannot see; writing the token is the composer's half, and `refer` warns
   rather than staging silently when no chat is mounted on that session — the case where a card sits outside the
   `<Agent.Zone>` its chat is inside.
+- **The composer draws a pointer as the name it points at, never as the token.** Where `reference` sources are
+  declared the input is a Lexical editor rather than a textarea, and each pointer is one atomic node — a backspace
+  takes the whole thing rather than a character of a label that would then name nothing. Nothing above it changes:
+  the node's text content *is* the `@[…](mention:…)` token, so the draft string the chat reads, the `@` query, the
+  chips, the wire and the server's framing all see what they always saw, and every offset the chat hands over is
+  an offset into that string. It is its own chunk behind the chat's, fetched only where a source was declared, and
+  `mentions={false}` keeps the plain textarea — for an app that overrides `AgentComposer`, or one that would
+  rather see the tokens it is sending. An override that draws its own textarea keeps working: it fills the
+  `inputRef` it is handed, and the chat reads the caret off that when no editor filled `handleRef`.
 - **`attach` and `voice` both carry functions, so a server layout cannot pass either.** A closure does not cross
   the RSC boundary — `non-scalar-props-restricted` says so on `page/**` — so an app that wants either mounts the
   chat from a small client component in the app's own `ui/` that calls the hook.
@@ -276,6 +296,14 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   `data-akan-action` like a store setter does. A `remove*` name defaults to a confirm gate. Reach a store action
   from the body — `.exec((id) => st.do.removeX(id))` — which is how an agent gets CRUD; `st.do` on its own
   reaches nobody.
+- **`.card()` is the other way the chain ends, for an answer that is the user's to give.** Where `.exec()` runs a
+  function, `.card(({ submit, cancel }, ...args) => <Form …/>)` parks the call in the chat and renders the app's own
+  component there; what `submit` is handed is what the model reads back, and `cancel` is the refusal it reads
+  instead. A name and a phone number, a date somebody has to look up, a signature — a model that fills those in
+  has answered its own question, and every other shape of "ask the user" is `askUser`. The declared arguments are
+  checked **before** the card is parked, so a bad one reaches the model as a refusal rather than throwing inside
+  the render; `confirm` is not read at all, because the card in front of the user is already the asking. The frame
+  draws its own way out even when the card does not, and the turn is never parked on something with no exit.
 - **The second argument is how the call behaves, never what it is.** `{ settle, confirm, guard }`:
   `settle: false` marks a read that returns what is already there and skips the wait; every other tool is waited
   out before its effect on the screen is reported, because a write may still be landing when `exec` resolves. A
@@ -674,7 +702,10 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   is among them. The loop parks on the question exactly as it parks on an approval, a dismissal is the tool's
   error result rather than a silent empty answer, and the settled exchange renders as question-and-answer instead
   of a tool row. **Never re-implement it per screen** — a `st.tool("askAboutX")` that opens a modal is the same
-  thing with a worse transcript — and a hook tool named `askUser` shadows it like any other built-in.
+  thing with a worse transcript — and a hook tool named `askUser` shadows it like any other built-in. The line
+  between it and a `.card()` tool is what the answer *is*: a sentence or a pick off a list is `askUser` and belongs
+  to the conversation, while a shape the model must not invent — fields, a form, a signature — is a card the screen
+  declares, because only the screen knows what filling it in looks like.
 
 ## What The Page Draws
 - **The page shows the agent's work, not just the transcript.** A chat panel is closed as often as it is open, and

package/guidelines/conventions/conventions.instruction.md

@@ -714,9 +714,12 @@ what every developer must know even when not building one.
   every tool runs in the caller's own browser session, gated by guards and the approval card. Its guard is
   `AgentRelayAccess`, which refuses every call until the app names a guard of its own —
   `option.setAgentAccess(SignedIn)`. **The LLM is configured in `option.ts`, never through the environment**
-  (`option.setLlm({ apiKey, model, host })`). Three providers ship — `DeepseekLlm` (the default, text only),
-  `OpenaiLlm` and `AnthropicLlm` (both read images) — and swapping one in is
-  `option.applyAdaptor(LlmAdaptorRole, AnthropicLlm)`.
+  (`option.setLlm({ apiKey, model, host })`). Two adaptors ship, one per wire: `OpenaiLlm` is the default and
+  speaks the chat-completions dialect to whatever `host` names — OpenAI, DeepSeek, Groq, OpenRouter, Ollama — and
+  `AnthropicLlm` speaks the Messages API and reads a PDF as well as a picture. Both require `model`. A provider
+  neither covers is an `adapt()` class in `srvkit/` implementing `LlmAdaptor`, applied with
+  `option.applyAdaptor(LlmAdaptorRole, TheClass)`; whatever settings it needs beyond `LlmOption` ride `setLlm`
+  too, read back with `use<MyLlmOption>()`.
 - **Declare the tool beside the control that already does it**, never as a separate surface:
   `st.tool("x").desc("…").arg("id", ID).exec(fn)` returns the callable to hand to `onClick` — one handler for the
   person and the agent. Publish it only where the screen already renders the control; a falsy name declares the
@@ -943,7 +946,9 @@ when two shapes disagree.
   selected one's log beside it. `Tab` walks every row and `1`-`9` jump to that app (the rail shows each
   app's digit), `↑↓` scroll (shift for a page, `G` back to following),
   `/` greps, `e` shows stderr only, `c` clears, `y` copies, `Y` copies the log path, `o` opens the browser,
-  `r` restarts that app, `q` quits.
+  `r` restarts that app, `q` quits. Under `--share`, `s` copies the public URL — the selected app's, or every
+  app's from the merged row — and the header carries it ahead of the local one, because the line `--share`
+  printed before the view took the terminal is gone by its first repaint.
   **`--plain` prints prefixed interleaved lines instead**, and a pipe, a redirect or an unsized terminal
   downgrades to that on its own.
 - **A supervised session writes `local/apps/<app>/runtime/dev.log`, and that path is how a log gets handed over.**

package/guidelines/moduleCodegen/moduleCodegen.instruction.md

@@ -6,7 +6,7 @@ Use this to orchestrate AI-assisted module creation. The model should emit small
 ## Ownership
 - Input description explains the business object, lifecycle, actions, queries, UI needs, and relations.
 - The first output pass should prioritize data shape and persistence over decorative UI.
-- Each returned code block must start with `// File: <relative path>` so `AiSession.writeTypescripts()` can parse it.
+- Each returned code block must start with `// File: <relative path>` so the caller can tell which file it writes.
 - Generated files must target `lib/<model>/...` or `lib/__scalar/<scalar>/...` only unless explicitly requested.
 
 ## Current Akan Patterns

package/guidelines/workspaceRecipes/workspaceRecipes.generate.json

@@ -21,6 +21,7 @@
       "create a mutation",
       "internal triggers",
       "insights",
+      "migrating the LLM adaptor and the removed --ai commands",
       "auto-generated API reference"
     ],
     "rules": [

package/guidelines/workspaceRecipes/workspaceRecipes.instruction.md

@@ -393,6 +393,68 @@ Rules the loader and `akan sync` enforce: a chain module has no other export; `p
 `_overrides.tsx` is untouched. MCP: `prompts/get` now runs the page's body under the caller's token and hands the
 model the description, what the page fetched, and the tools of those modules — see `mcpRule`.
 
+---
+
+### Recipe 8: Migrating the LLM Adaptor and the Removed `--ai` Commands
+
+Two changes land together. The runtime LLM seam now names a wire rather than a vendor, and the CLI's AI editor is
+gone. They touch different files and neither one is optional — the first breaks a build or, worse, degrades
+silently; the second breaks a script that calls a command that no longer exists.
+
+#### The adaptor, in `lib/option.ts` and `env/env.server.*.ts`
+
+`DeepseekLlm` is deleted. `OpenaiLlm` is the default and speaks the chat-completions dialect to whatever `host`
+names, so DeepSeek, Groq, Together, OpenRouter, Ollama and a self-hosted vLLM are the same class with a different
+`host` and `model`. `AnthropicLlm` is unchanged.
+
+```ts
+// before — env/env.server.local.ts
+export const env: ModulesOptions = {
+  ...libEnv,
+  llm: { apiKey: process.env.DEEPSEEK_KEY },
+};
+
+// after — the default model and host are gone, so name both
+export const env: ModulesOptions = {
+  ...libEnv,
+  llm: { apiKey: process.env.DEEPSEEK_KEY, model: "deepseek-v4-flash", host: "https://api.deepseek.com" },
+};
+```
+
+| Before | After | What happens if you skip it |
+|---|---|---|
+| `setLlm({ apiKey })`, relying on the DeepSeek default | `setLlm({ apiKey, model, host })` | The app boots, the log warns once, and the chat answers `llmUnavailable` to every turn |
+| `applyAdaptor(LlmAdaptorRole, DeepseekLlm)` | `OpenaiLlm` + `host: "https://api.deepseek.com"` | Build error — the class is gone |
+| `OpenaiLlm` pointed at a **named** `host`, reading images | add `accepts: { image: true }` to `setLlm` | **Silent**: images reach the model as a note saying they could not be read |
+| An adaptor of your own throwing `agent.error.<vendor>RequestFailed` | `new Err("agent.error.llmRequestFailed", { provider, status, reason })` | The chat prints the raw key instead of a sentence |
+| Provider settings in a second `option.use({ myLlmOption })` | put them in `setLlm` and read `use<MyLlmOption>()` | Nothing breaks; the second channel is no longer needed |
+
+`OpenaiLlm` claims vision for its default host (`https://api.openai.com/v1`) and for nothing else, because a host
+you named is a gateway it knows nothing about — and bytes handed to a model that cannot decode them kill the whole
+turn on a 400, where text-only degrades them to a note. Declare `accepts` whenever you set `host`.
+
+`LlmOption` is now a floor rather than the whole shape: `setLlm` carries whatever else it is handed to the role, so
+an adaptor of your own declares `interface MyLlmOption extends LlmOption { region: string }`, reads it with
+`use<MyLlmOption>()`, and stops needing a config channel beside `setLlm`.
+
+#### The CLI, in scripts and CI
+
+`AiSession` and every command that drove it are removed. There is no replacement command — the workspace's agent
+surface (`akan context`, the MCP tools, `akan guideline show`) is what feeds a coding agent now.
+
+| Removed | What to do instead |
+|---|---|
+| `akan create-module <name> --ai`, `akan create-scalar <name> --ai` | Drop the flag. The command scaffolds the same files it always did; write the constant and dictionary yourself or let a coding agent do it against `get_guideline modelConstant` / `modelDictionary` |
+| `akan compact <app-or-lib>` | Edit the `*.abstract.md` by hand. `akan quality scan` still warns past 300 lines |
+| `akan set-llm`, `akan reset-llm`, `akan ask` | Nothing. The runtime LLM is `option.setLlm(...)` and has never been this config |
+| `akan generate-instruction`, `akan update-instruction`, `akan generate-document`, `akan reapply-instruction` | Nothing. `akan guideline list` / `show` still read the bundled guidelines |
+| `import { AiSession } from "@akanjs/devkit/aiEditor"` | Nothing — the module is gone |
+
+`~/.akan/config.json` keeps an `llm` entry if it had one. It is ignored; delete it, because it holds an API key.
+
+Then: `bun run akan typecheck <app>`, `bun run akan lint <app>`, and one agent turn in the browser to confirm the
+provider answers.
+
 ### Data Flow Summary
 
 For each business question, follow this chain:

package/incrementalBuilder.proc.js

@@ -3,7 +3,7 @@ import {
   CodegenLock,
   WorkspaceExecutor,
   AppExecutor
-} from "./index-5nyznra1.js";
+} from "./index-p1j0cyvd.js";
 import"./index-q0y2jq9j.js";
 import"./index-6wwzs1bc.js";
 import {

package/{index-bz10w9t2.js → index-0qvq9aeb.js}

@@ -3,20 +3,17 @@ import {
   getDefaultHostConfig,
   GlobalConfig,
   CloudApi
-} from "./index-649svkyt.js";
+} from "./index-myj01w9r.js";
+import {
+  runner
+} from "./index-gca9y01h.js";
 import {
   WorkspaceExecutor,
   AppExecutor
-} from "./index-5nyznra1.js";
-import {
-  AiSession
-} from "./index-5tw8t1ts.js";
-import {
-  runner
-} from "./index-b3ae16mg.js";
+} from "./index-p1j0cyvd.js";
 import {
   openBrowser
-} from "./index-cnzm1wn5.js";
+} from "./index-chp5gqmm.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.runner.ts
 import path from "path";
@@ -239,13 +236,6 @@ ${chalk.green("\u27A4")} Authentication Required`));
 `));
     }
   }
-  async setLlm() {
-    await AiSession.init({ useExisting: false });
-  }
-  resetLlm() {
-    AiSession.setLlmConfig(null);
-    Logger.rawLog(chalk.green("\u2611\uFE0F LLM model config is cleared. Please run `akan set-llm` to set a new LLM model."));
-  }
   async getAkanPkgs(workspace) {
     const pkgs = await workspace.getPkgs();
     return pkgs.filter((pkg) => pkg === "akanjs" || pkg === "create-akan-workspace" || pkg.startsWith("@akanjs/"));

package/{index-jwjaf9fy.js → index-1p146w4s.js}

@@ -2,7 +2,7 @@
 import {
   AppExecutor,
   LibExecutor
-} from "./index-5nyznra1.js";
+} from "./index-p1j0cyvd.js";
 
 // pkgs/@akanjs/devkit/workflow/utils.ts
 var jsonText = (value, { trailingNewline = true } = {}) => `${JSON.stringify(value, null, 2)}${trailingNewline ? `
@@ -21,49 +21,6 @@ var uniqueBy = (values, key) => {
 };
 var compactDiagnostics = (diagnostics) => diagnostics.filter((diagnostic) => !!diagnostic);
 
-// pkgs/@akanjs/devkit/workflow/primitive.ts
-var createPrimitiveWriteReport = ({
-  command,
-  status,
-  changedFiles = [],
-  generatedFiles = [],
-  validationCommands = [],
-  diagnostics = [],
-  nextActions = []
-}) => ({
-  schemaVersion: 1,
-  command,
-  status: status ?? (diagnostics.some((diagnostic) => diagnostic.severity === "error") ? "failed" : "passed"),
-  changedFiles,
-  generatedFiles,
-  validationCommands,
-  diagnostics,
-  nextActions
-});
-var renderPrimitiveWriteReport = (report) => [
-  `# Primitive Write: ${report.command}`,
-  "",
-  `- Status: ${report.status}`,
-  "",
-  "## Changed Files",
-  ...report.changedFiles.length ? report.changedFiles.map((file) => `- \`${file.action}\` ${file.path}: ${file.reason}`) : ["- none"],
-  "",
-  "## Generated Files",
-  ...report.generatedFiles.length ? report.generatedFiles.map((file) => `- \`${file.action}\` ${file.path}: ${file.reason}`) : ["- none"],
-  "",
-  "## Validation Commands",
-  ...report.validationCommands.length ? report.validationCommands.map((validation) => `- \`${validation.command}\`: ${validation.reason}`) : ["- none"],
-  "",
-  "## Diagnostics",
-  ...report.diagnostics.length ? report.diagnostics.map((diagnostic) => `- [${diagnostic.severity}] ${diagnostic.code}: ${diagnostic.message}`) : ["- none"],
-  "",
-  "## Next Actions",
-  ...report.nextActions.length ? report.nextActions.map((action) => `- \`${action.command}\`: ${action.reason}`) : ["- none"],
-  ""
-].join(`
-`);
-var renderPrimitiveReport = (report, format = "markdown") => format === "json" ? jsonText(report) : renderPrimitiveWriteReport(report);
-
 // pkgs/@akanjs/devkit/workflow/artifacts.ts
 var sourceChangeBlocked = (diagnostics) => diagnostics.some((diagnostic) => diagnostic.severity === "error" && (diagnostic.failureScope === "source-change" || !diagnostic.failureScope || diagnostic.failureScope === "unknown"));
 var workflowPlanApproval = {
@@ -415,6 +372,49 @@ var createRepairReport = ({
   generatedFiles,
   ...syncedAt ? { syncedAt } : {}
 });
+
+// pkgs/@akanjs/devkit/workflow/primitive.ts
+var createPrimitiveWriteReport = ({
+  command,
+  status,
+  changedFiles = [],
+  generatedFiles = [],
+  validationCommands = [],
+  diagnostics = [],
+  nextActions = []
+}) => ({
+  schemaVersion: 1,
+  command,
+  status: status ?? (diagnostics.some((diagnostic) => diagnostic.severity === "error") ? "failed" : "passed"),
+  changedFiles,
+  generatedFiles,
+  validationCommands,
+  diagnostics,
+  nextActions
+});
+var renderPrimitiveWriteReport = (report) => [
+  `# Primitive Write: ${report.command}`,
+  "",
+  `- Status: ${report.status}`,
+  "",
+  "## Changed Files",
+  ...report.changedFiles.length ? report.changedFiles.map((file) => `- \`${file.action}\` ${file.path}: ${file.reason}`) : ["- none"],
+  "",
+  "## Generated Files",
+  ...report.generatedFiles.length ? report.generatedFiles.map((file) => `- \`${file.action}\` ${file.path}: ${file.reason}`) : ["- none"],
+  "",
+  "## Validation Commands",
+  ...report.validationCommands.length ? report.validationCommands.map((validation) => `- \`${validation.command}\`: ${validation.reason}`) : ["- none"],
+  "",
+  "## Diagnostics",
+  ...report.diagnostics.length ? report.diagnostics.map((diagnostic) => `- [${diagnostic.severity}] ${diagnostic.code}: ${diagnostic.message}`) : ["- none"],
+  "",
+  "## Next Actions",
+  ...report.nextActions.length ? report.nextActions.map((action) => `- \`${action.command}\`: ${action.reason}`) : ["- none"],
+  ""
+].join(`
+`);
+var renderPrimitiveReport = (report, format = "markdown") => format === "json" ? jsonText(report) : renderPrimitiveWriteReport(report);
 // pkgs/@akanjs/devkit/workflow/executor.ts
 import ts3 from "typescript";
 

package/{index-7f4dsf9v.js → index-1sggq0m8.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   CommandExecutionError
-} from "./index-5nyznra1.js";
+} from "./index-p1j0cyvd.js";
 import {
   resolveMobilePath,
   targetHtmlFilename

package/{index-15r9a10e.js → index-3dmebxnk.js}

@@ -7,7 +7,7 @@ import {
   isScannedRootEntry,
   AppExecutor,
   LibExecutor
-} from "./index-5nyznra1.js";
+} from "./index-p1j0cyvd.js";
 import {
   FileSys
 } from "./index-q0y2jq9j.js";
@@ -19,7 +19,7 @@ import {
 import {
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-jwjaf9fy.js";
+} from "./index-1p146w4s.js";
 
 // pkgs/@akanjs/devkit/akanContext.ts
 import { readdir } from "fs/promises";

package/{index-vrwdx0zx.js → index-3hr7cpy1.js}

@@ -2,7 +2,7 @@
 import {
   AsyncDefaultExportDetector,
   resolveSsrPageEntriesForApp
-} from "./index-5nyznra1.js";
+} from "./index-p1j0cyvd.js";
 import {
   BarrelAnalyzer,
   createBarrelImportsPlugin,