@moxxy/sdk 0.19.0 → 0.20.0

package/src/session-like.ts

@@ -291,6 +291,30 @@ export interface LoadedPluginView {
   readonly kinds: ReadonlyArray<string>;
 }
 
+/** One swappable contribution within a {@link CategoryView}. */
+export interface CategoryItemView {
+  /** Contribution name (e.g. provider `anthropic`, compactor `summarize`). */
+  readonly name: string;
+  /** Whether this item is the active default for its category. */
+  readonly isDefault: boolean;
+}
+
+/**
+ * One registry category in {@link PluginsAdminView.categories} — the active
+ * default plus the available items to swap between. Powers the per-category
+ * tabs in the `/plugins` picker and the `list_defaults` tool.
+ */
+export interface CategoryView {
+  /** Registry kind, e.g. `provider` | `compactor` | `mode`. */
+  readonly category: string;
+  /** Active default contribution name, or null when the category is empty. */
+  readonly active: string | null;
+  /** The protected floor's name (never disableable), or null when none. */
+  readonly floor: string | null;
+  /** Swappable contributions registered for this category. */
+  readonly items: ReadonlyArray<CategoryItemView>;
+}
+
 /**
  * The slice of plugin management a channel needs to drive the `/plugins`
  * picker: which plugins are disabled, what's installable, and a persist+
@@ -301,12 +325,24 @@ export interface LoadedPluginView {
 export interface PluginsAdminView {
   /** Currently-loaded plugins with their contribution kinds (for kind tabs). */
   loaded(): ReadonlyArray<LoadedPluginView>;
-  /** Package names currently disabled (config `plugins[name].enabled=false`). */
+  /** Package names currently disabled (config `plugins.packages[name].enabled=false`). */
   disabled(): ReadonlyArray<string>;
+  /** Kernel package names that cannot be disabled (swap their default instead). */
+  protectedPackages(): ReadonlyArray<string>;
   /** Curated installable-plugin catalog for the picker's "Installable" tab. */
   catalog(): ReadonlyArray<InstallablePluginView>;
-  /** Persist `plugins[name].enabled` AND apply it to the live session. */
+  /** Persist `plugins.packages[name].enabled` AND apply it to the live session. */
   setEnabled(packageName: string, enabled: boolean): Promise<void>;
+  /**
+   * Per-category active default + swappable items (the swap axis). Powers the
+   * `/plugins` category tabs and the `list_defaults` tool.
+   */
+  categories(): ReadonlyArray<CategoryView>;
+  /**
+   * Persist `plugins.<category>.default` AND apply it to the live session
+   * (`setActive`). Rejects an unknown category or an unregistered name.
+   */
+  setCategoryDefault(category: string, name: string): Promise<void>;
 }
 
 /**

package/src/stuck-loop.test.ts

@@ -3,7 +3,7 @@ import { createStuckLoopDetector, stableHash } from './mode-helpers.js';
 
 describe('createStuckLoopDetector', () => {
   it('trips on exact-input repeats at repeatThreshold', () => {
-    const d = createStuckLoopDetector(); // repeatThreshold 3
+    const d = createStuckLoopDetector({ repeatThreshold: 3 });
     const input = { x: 1 };
     expect(d.record('Read', input).stuck).toBe(false);
     expect(d.record('Read', input).stuck).toBe(false);
@@ -11,8 +11,21 @@ describe('createStuckLoopDetector', () => {
     expect(sig).toMatchObject({ stuck: true, count: 3, kind: 'exact' });
   });
 
+  it('uses a generous default exact threshold (does not trip on a few repeats)', () => {
+    const d = createStuckLoopDetector(); // default repeatThreshold = 8
+    const input = { x: 1 };
+    for (let i = 0; i < 7; i++) expect(d.record('Read', input).stuck).toBe(false);
+    expect(d.record('Read', input).stuck).toBe(true); // 8th identical call trips
+  });
+
+  it('never trips when disabled (relies on maxIterations alone)', () => {
+    const d = createStuckLoopDetector({ enabled: false, repeatThreshold: 2 });
+    const input = { x: 1 };
+    for (let i = 0; i < 20; i++) expect(d.record('Read', input).stuck).toBe(false);
+  });
+
   it('trips on same-target near-dups even when volatile args vary', () => {
-    const d = createStuckLoopDetector(); // nearThreshold 5
+    const d = createStuckLoopDetector({ repeatThreshold: 3 }); // nearThreshold → 5
     const url = 'https://example.com/big';
     // Same url, different maxBytes each time — exact check never fires.
     for (let i = 0; i < 4; i++) {
@@ -44,7 +57,7 @@ describe('createStuckLoopDetector', () => {
   // dispatch path; a throw there crashes the whole turn. These assert it stays
   // total on hostile/partial input — the worst case the provider can hand us.
   it('does not throw recording a tool input with a circular reference', () => {
-    const d = createStuckLoopDetector();
+    const d = createStuckLoopDetector({ repeatThreshold: 3 });
     const input: Record<string, unknown> = { a: 1 };
     input.self = input;
     expect(() => d.record('weird', input)).not.toThrow();

package/src/tool-dispatch.ts

@@ -37,6 +37,7 @@ export async function* dispatchToolCall(
       cwd: ctx.cwd,
       log: ctx.log,
       env: ctx.env,
+      services: ctx.services,
       turnId: ctx.turnId,
       iteration,
       call: { callId: asToolCallId(t.id), name: t.name, input: t.input },