carthagent 1.0.7 → 1.1.0-preview.13

package/docs/patches/opencode-v2.0.32-help-dispatch.patch

@@ -0,0 +1,156 @@
+diff --git a/packages/tui/src/component/prompt/autocomplete.tsx b/packages/tui/src/component/prompt/autocomplete.tsx
+index c669491..2c0c63a 100644
+--- a/packages/tui/src/component/prompt/autocomplete.tsx
++++ b/packages/tui/src/component/prompt/autocomplete.tsx
+@@ -472,15 +472,28 @@ export function Autocomplete(props: {
+   }
+ 
+   const commands = createMemo((): AutocompleteOption[] => {
+-    const results: AutocompleteOption[] = keymapCommands().flatMap((command) => {
++    const registered = keymapCommands()
++    let help: KeymapCommand | undefined
++    const results: AutocompleteOption[] = registered.flatMap((command) => {
+       const slash = command.slash
+       if (!slash) return []
+-      return [slash.name, ...(slash.aliases ?? [])].map((name) => ({
++      const names = [slash.name, ...(slash.aliases ?? [])]
++      if (names.includes("help") && command.id !== "help.show") help = command
++      return names.filter((name) => name !== "help").map((name) => ({
+         display: `/${name}`,
+         description: command.description ?? command.title,
+         onSelect: slash.arguments ? () => insertSlash(name) : command.run,
+       }))
+     })
++    const helpCommand = help ?? registered.find((command) => command.id === "help.show")
++    if (helpCommand?.slash) {
++      const slash = helpCommand.slash
++      results.push({
++        display: "/help",
++        description: helpCommand.description ?? helpCommand.title,
++        onSelect: slash.arguments ? () => insertSlash("help") : helpCommand.run,
++      })
++    }
+     const commandNames = new Set<string>()
+ 
+     for (const serverCommand of data.location.command.list(location.current) ?? []) {
+diff --git a/packages/tui/src/component/prompt/index.tsx b/packages/tui/src/component/prompt/index.tsx
+index a9f699c..63fe438 100644
+--- a/packages/tui/src/component/prompt/index.tsx
++++ b/packages/tui/src/component/prompt/index.tsx
+@@ -173,11 +173,15 @@ function formatEditorContext(selection: EditorSelection) {
+ function argumentSlash(input: string, commands: readonly KeymapCommand[]) {
+   const head = parseSlashHead(input, /\s/)
+   if (!head) return
+-  const command = commands.find(
++  const matches = commands.filter(
+     (command) =>
+       command.slash?.arguments &&
+       (command.slash.name === head.name || command.slash.aliases?.includes(head.name) === true),
+   )
++  // The built-in help action is a fallback; let an extension own the natural
++  // `/help` spelling regardless of which layer happened to register first.
++  const command =
++    head.name === "help" ? (matches.findLast((item) => item.id !== "help.show") ?? matches[0]) : matches[0]
+   if (!command) return
+   return { command, input: head.arguments }
+ }
+diff --git a/packages/tui/test/plugin-keymap.test.tsx b/packages/tui/test/plugin-keymap.test.tsx
+index 0790e9a..23f502c 100644
+--- a/packages/tui/test/plugin-keymap.test.tsx
++++ b/packages/tui/test/plugin-keymap.test.tsx
+@@ -59,6 +59,38 @@ test("setup layers before and after await reach keyboard, palette, and slash acr
+   await setup.waitForFrame((frame) => frame.includes("Sync keymap ran 1"))
+ })
+ 
++test("a plugin /help overrides native /help for natural autocomplete selection and restores it on disable", async () => {
++  await using plugin = await copyHelpPlugin()
++  const requests: URL[] = []
++  await using setup = await createAppFixture({
++    config: { animations: false, plugins: [plugin.directory] },
++    fetch(url) {
++      requests.push(url)
++    },
++  })
++  await setup.ready
++  await setup.waitForFrame((frame) => frame.includes("Help override ready"))
++
++  await setup.mockInput.typeText("/help")
++  await setup.waitForFrame((frame) => frame.includes("/help"))
++  setup.mockInput.pressEnter()
++  await setup.waitForFrame((frame) => frame.includes("Plugin help handler 2"))
++  expect(requests.some((url) => url.pathname === "/session")).toBe(false)
++
++  setup.mockInput.pressEscape()
++  await openPlugin(setup, "help-override")
++  await setup.waitForFrame((frame) => frame.includes("disable"))
++  setup.mockInput.pressEnter()
++  await setup.waitForFrame((frame) => frame.includes("inactive"))
++  setup.mockInput.pressEscape()
++
++  await setup.mockInput.typeText("/help")
++  await setup.waitForFrame((frame) => frame.includes("/help"))
++  setup.mockInput.pressEnter()
++  await setup.waitForFrame((frame) => frame.includes("Press ctrl+p to see all available actions"))
++  expect(requests.some((url) => url.pathname === "/session")).toBe(false)
++})
++
+ test("a component layer ends when its component unmounts while the plugin stays active", async () => {
+   await using plugin = await copyPlugin()
+   await using setup = await createAppFixture({ config: { animations: false, plugins: [plugin.directory] } })
+@@ -138,6 +170,41 @@ async function copyPlugin() {
+   return { directory, entry, [Symbol.asyncDispose]: root[Symbol.asyncDispose] }
+ }
+ 
++async function copyHelpPlugin() {
++  const root = await tmpdir()
++  const directory = path.join(root.path, "help-override")
++  const entry = path.join(directory, "tui.tsx")
++  await mkdir(directory)
++  await symlink(path.join(import.meta.dir, "../node_modules"), path.join(directory, "node_modules"))
++  await Bun.write(entry, `
++    import { Plugin } from "@opencode/plugin/tui"
++    export default Plugin.define({
++      id: "fixture.help-override",
++      setup(context) {
++        context.keymap.layer(() => ({
++          mode: "global",
++          commands: [
++            {
++              id: "fixture.help-override.first",
++              title: "First plugin help",
++              slash: { name: "help" },
++              run: () => context.ui.dialog.show(() => <text>Plugin help handler 1</text>),
++            },
++            {
++              id: "fixture.help-override.second",
++              title: "Second plugin help",
++              slash: { name: "help" },
++              run: () => context.ui.dialog.show(() => <text>Plugin help handler 2</text>),
++            },
++          ],
++        }))
++        context.ui.toast.show({ message: "Help override ready" })
++      },
++    })
++  `)
++  return { directory, [Symbol.asyncDispose]: root[Symbol.asyncDispose] }
++}
++
+ async function search(setup: Fixture, query: string) {
+   setup.mockInput.pressKey("p", { ctrl: true })
+   await setup.waitForFrame((frame) => frame.includes("Commands"))
+@@ -145,11 +212,11 @@ async function search(setup: Fixture, query: string) {
+   await setup.mockInput.typeText(query)
+ }
+ 
+-async function openPlugin(setup: Fixture) {
++async function openPlugin(setup: Fixture, query = "setup-keymap") {
+   await setup.mockInput.typeText("/plugins")
+   await setup.waitForFrame((frame) => frame.includes("/plugins"))
+   setup.mockInput.pressEnter()
+-  await setup.waitForFrame((frame) => frame.includes("fixture.setup-keymap"))
++  await setup.waitForFrame((frame) => frame.includes(query === "help-override" ? "fixture.help-override" : "fixture.setup-keymap"))
+   await setup.waitFor(() => setup.renderer.currentFocusedEditor instanceof InputRenderable)
+-  await setup.mockInput.typeText("setup-keymap")
++  await setup.mockInput.typeText(query)
+ }

package/docs/patches/opencode-v2.0.32-live-theme-api.patch

@@ -0,0 +1,122 @@
+diff --git a/packages/plugin/src/tui/context.ts b/packages/plugin/src/tui/context.ts
+index fe641b3..21ec351 100644
+--- a/packages/plugin/src/tui/context.ts
++++ b/packages/plugin/src/tui/context.ts
+@@ -490,6 +490,13 @@ export interface Keymap {
+ export interface UI {
+   readonly dialog: Dialog
+   readonly toast: Toast
++  /** Live host theme controls. Theme files must already be available to the host. */
++  readonly theme: {
++    /** Returns the selected theme name and active color mode. */
++    current(): { readonly name: string; readonly mode: "dark" | "light" }
++    /** Switches the live theme and optionally locks its color mode; returns false if either is unavailable. */
++    set(selection: { readonly name: string; readonly mode?: "dark" | "light" }): boolean
++  }
+   readonly format: {
+     path(value: string): string
+   }
+diff --git a/packages/tui/src/context/theme.tsx b/packages/tui/src/context/theme.tsx
+index ed568e6..2d7d363 100644
+--- a/packages/tui/src/context/theme.tsx
++++ b/packages/tui/src/context/theme.tsx
+@@ -94,6 +94,7 @@ type Themes = {
+   mode: Accessor<"dark" | "light">
+   modes: Accessor<readonly ("dark" | "light")[]>
+   supports(mode: "dark" | "light"): boolean
++  supportsThemeMode(theme: string, mode: "dark" | "light"): boolean
+   locked: Accessor<boolean>
+   lock(): void
+   unlock(): void
+@@ -329,6 +330,10 @@ const themeContext = createSimpleContext({
+       mode,
+       modes,
+       supports: (requested) => modes().includes(requested),
++      supportsThemeMode: (theme, requested) => {
++        const source = available()[theme]
++        return source !== undefined && themeModes(parseTheme(source, theme)).includes(requested)
++      },
+       locked: () => store.lock !== undefined,
+       lock: () => pin(mode()),
+       unlock: free,
+diff --git a/packages/tui/src/plugin/api.tsx b/packages/tui/src/plugin/api.tsx
+index 35a4eac..4150ba9 100644
+--- a/packages/tui/src/plugin/api.tsx
++++ b/packages/tui/src/plugin/api.tsx
+@@ -204,6 +204,16 @@ export function createPluginContext(input: {
+     ui: {
+       dialog: dialogApi,
+       toast: toastApi,
++      theme: {
++        current: () => ({ name: host.themes.selected, mode: host.themes.mode() }),
++        set(selection) {
++          if (!selection || typeof selection.name !== "string" || !host.themes.has(selection.name)) return false
++          if (selection.mode !== undefined && !host.themes.supportsThemeMode(selection.name, selection.mode)) return false
++          if (!host.themes.set(selection.name)) return false
++          if (selection.mode !== undefined) host.themes.setMode(selection.mode)
++          return true
++        },
++      },
+       format: {
+         path: (value) => abbreviateHome(value, host.paths.home),
+       },
+diff --git a/packages/tui/test/plugin-theme.test.tsx b/packages/tui/test/plugin-theme.test.tsx
+new file mode 100644
+index 0000000..9a46b4d
+--- /dev/null
++++ b/packages/tui/test/plugin-theme.test.tsx
+@@ -0,0 +1,54 @@
++import { expect, test } from "bun:test"
++import { createPluginContext, type Registry, type usePluginHost } from "../src/plugin/api"
++
++function setup() {
++  let selected = "opencode"
++  let mode: "dark" | "light" = "dark"
++  const available = new Set(["opencode", "custom"])
++  const host = {
++    app: {},
++    client: {},
++    keymap: {},
++    shortcuts: {},
++    keymapState: {},
++    sessionTabs: {},
++    themes: {
++      get selected() {
++        return selected
++      },
++      mode: () => mode,
++      has: (name: string) => available.has(name),
++      supportsThemeMode: (name: string, requested: "dark" | "light") => requested === "dark" || name === "custom",
++      set(name: string) {
++        if (!available.has(name)) return false
++        selected = name
++        return true
++      },
++      setMode(requested: "dark" | "light") {
++        mode = requested
++        return true
++      },
++    },
++  } as unknown as ReturnType<typeof usePluginHost>
++  const registry: Registry = { has: () => false, set() {}, remove() {}, active: () => true }
++  const theme = createPluginContext({ host, id: "test", options: undefined, owned: [], registry }).ui.theme
++  return { theme, current: () => ({ selected, mode }) }
++}
++
++test("plugin theme setter applies available theme and mode live through the host service", () => {
++  const harness = setup()
++  expect(harness.theme.current()).toEqual({ name: "opencode", mode: "dark" })
++  expect(harness.theme.set({ name: "custom", mode: "light" })).toBe(true)
++  expect(harness.theme.current()).toEqual({ name: "custom", mode: "light" })
++  expect(harness.current()).toEqual({ selected: "custom", mode: "light" })
++})
++
++test("plugin theme setter rejects unknown themes and unsupported modes without partial changes", () => {
++  const harness = setup()
++  expect(harness.theme.set({ name: "missing", mode: "dark" })).toBe(false)
++  expect(harness.theme.set({ name: "custom", mode: "light" })).toBe(true)
++  expect(harness.theme.set({ name: "opencode", mode: "light" })).toBe(false)
++  expect(harness.theme.current()).toEqual({ name: "custom", mode: "light" })
++  expect(harness.theme.set({ name: "opencode" })).toBe(true)
++  expect(harness.theme.current()).toEqual({ name: "opencode", mode: "light" })
++})