@stigmer/ink 3.20.0 → 3.22.0

package/components/AgentPicker.d.ts

@@ -9,6 +9,13 @@ export interface AgentPickerProps {
     readonly scope?: "org" | "all";
     /** Called with the chosen agent's search result on selection. */
     readonly onSelect: (agent: SearchResult) => void;
+    /**
+     * When given, the list opens with the built-in assistant — the answer a
+     * session gets with no agent at all — as its first row, and choosing it
+     * calls this instead of `onSelect`. Absent, the picker offers agents only
+     * (a caller that needs an agent, such as a schedule, leaves it out).
+     */
+    readonly onSelectBuiltInAssistant?: () => void;
     /** Called when the user cancels (Esc / Ctrl+C). */
     readonly onCancel: () => void;
 }
@@ -29,5 +36,5 @@ export interface AgentPickerProps {
  * );
  * ```
  */
-export declare function AgentPicker({ org, initialQuery, scope, onSelect, onCancel }: AgentPickerProps): import("react/jsx-runtime").JSX.Element;
+export declare function AgentPicker({ org, initialQuery, scope, onSelect, onSelectBuiltInAssistant, onCancel, }: AgentPickerProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=AgentPicker.d.ts.map

package/components/AgentPicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentPicker.d.ts","sourceRoot":"","sources":["../../src/components/AgentPicker.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAI/E,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,gBAAgB,2CAkC7F"}
+{"version":3,"file":"AgentPicker.d.ts","sourceRoot":"","sources":["../../src/components/AgentPicker.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAI/E,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/C,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B;AAkBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,wBAAwB,EACxB,QAAQ,GACT,EAAE,gBAAgB,2CA2ClB"}

package/components/AgentPicker.js

@@ -1,9 +1,20 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo } from "react";
-import { useAgentSearch } from "@stigmer/react";
+import { BUILT_IN_ASSISTANT_NAME, useAgentSearch } from "@stigmer/react";
 import { ResourcePicker } from "./ResourcePicker.js";
 /** Max description length shown as the row subtitle before truncation. */
 const SUBTITLE_MAX = 60;
+/**
+ * The built-in assistant's row id: no agent carries an empty id, so it cannot
+ * collide with a search result, and it reads as what it is on the wire (an
+ * empty `agentInstanceId` is the built-in assistant).
+ */
+const BUILT_IN_ASSISTANT_ITEM_ID = "";
+const BUILT_IN_ASSISTANT_ITEM = {
+    id: BUILT_IN_ASSISTANT_ITEM_ID,
+    title: `${BUILT_IN_ASSISTANT_NAME} (built-in)`,
+    subtitle: "No agent: answers with the tools the conversation carries",
+};
 /**
  * Interactive picker for choosing an agent by name.
  *
@@ -21,7 +32,7 @@ const SUBTITLE_MAX = 60;
  * );
  * ```
  */
-export function AgentPicker({ org, initialQuery, scope, onSelect, onCancel }) {
+export function AgentPicker({ org, initialQuery, scope, onSelect, onSelectBuiltInAssistant, onCancel, }) {
     const { results, isLoading, error, query, setQuery } = useAgentSearch(org, { scope });
     // Seed the typed-but-unresolved query once on mount so the user picks up
     // where the smart-resolution attempt left off.
@@ -31,12 +42,21 @@ export function AgentPicker({ org, initialQuery, scope, onSelect, onCancel }) {
         // Mount-only: re-seeding on every render would fight the user's typing.
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
-    const items = useMemo(() => results.map(toAgentItem), [results]);
+    // The assistant row stays first whatever the query, because it is not a
+    // search result: it is the choice of not searching for an agent at all.
+    const items = useMemo(() => {
+        const agents = results.map(toAgentItem);
+        return onSelectBuiltInAssistant ? [BUILT_IN_ASSISTANT_ITEM, ...agents] : agents;
+    }, [results, onSelectBuiltInAssistant]);
     const handleSelect = useCallback((item) => {
+        if (item.id === BUILT_IN_ASSISTANT_ITEM_ID) {
+            onSelectBuiltInAssistant?.();
+            return;
+        }
         const found = results.find((r) => r.id === item.id);
         if (found !== undefined)
             onSelect(found);
-    }, [results, onSelect]);
+    }, [results, onSelect, onSelectBuiltInAssistant]);
     return (_jsx(ResourcePicker, { prompt: "Select an agent", items: items, query: query, onQueryChange: setQuery, isLoading: isLoading, error: error, onSelect: handleSelect, onCancel: onCancel, emptyLabel: "no agents found" }));
 }
 /** Map a search result to a picker row: org/slug title, description subtitle. */

package/components/AgentPicker.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentPicker.js","sourceRoot":"","sources":["../../src/components/AgentPicker.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAmB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgBtE,0EAA0E;AAC1E,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAoB;IAC5F,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAEtF,yEAAyE;IACzE,+CAA+C;IAC/C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,EAAE;YAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC9E,wEAAwE;QACxE,uDAAuD;IACzD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,OAAO,CAAe,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/E,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,IAAgB,EAAE,EAAE;QACnB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,EACD,CAAC,OAAO,EAAE,QAAQ,CAAC,CACpB,CAAC;IAEF,OAAO,CACL,KAAC,cAAc,IACb,MAAM,EAAC,iBAAiB,EACxB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,QAAQ,EACvB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAC,iBAAiB,GAC5B,CACH,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,SAAS,WAAW,CAAC,MAAoB;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IAClG,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACzC,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;AAClE,CAAC"}
+{"version":3,"file":"AgentPicker.js","sourceRoot":"","sources":["../../src/components/AgentPicker.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/ink",
-  "version": "3.20.0",
+  "version": "3.22.0",
   "description": "Ink (React for terminals) components for rendering Stigmer agent sessions in the terminal",
   "license": "Apache-2.0",
   "type": "module",
@@ -35,7 +35,7 @@
   },
   "dependencies": {
     "@connectrpc/connect-node": "^2.1.1",
-    "@stigmer/react": "3.20.0",
+    "@stigmer/react": "3.22.0",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "marked": "^15.0.7",
@@ -43,8 +43,8 @@
   },
   "peerDependencies": {
     "@bufbuild/protobuf": "^2.0.0",
-    "@stigmer/protos": "3.20.0",
-    "@stigmer/sdk": "3.20.0",
+    "@stigmer/protos": "3.22.0",
+    "@stigmer/sdk": "3.22.0",
     "ink": "^7.0.0",
     "react": ">=19.0.0"
   }

package/src/__tests__/data-pickers.test.tsx

@@ -54,6 +54,50 @@ describe("AgentPicker", () => {
     expect(onSelect.mock.calls[0][0].id).toBe("agt_1");
   });
 
+  it("offers the built-in assistant first when asked, and picks it without an agent", async () => {
+    const results = [agentResult("agt_1", "acme/alpha", "first")];
+    const client = fakeClient({
+      agent: { list: vi.fn(async () => ({ entries: results, totalPages: 1, totalCount: 1 })) },
+    });
+    const onSelect = vi.fn();
+    const onSelectBuiltInAssistant = vi.fn();
+
+    const { lastFrame, stdin } = render(
+      <InkStigmerProvider client={client}>
+        <AgentPicker
+          org="acme"
+          onSelect={onSelect}
+          onSelectBuiltInAssistant={onSelectBuiltInAssistant}
+          onCancel={vi.fn()}
+        />
+      </InkStigmerProvider>,
+    );
+
+    await settle();
+    const frame = lastFrame() ?? "";
+    expect(frame).toContain("Assistant (built-in)");
+    // First row: above every agent the search found.
+    expect(frame.indexOf("Assistant (built-in)")).toBeLessThan(frame.indexOf("acme/alpha"));
+
+    stdin.write(KEY.enter);
+    await settle();
+    expect(onSelectBuiltInAssistant).toHaveBeenCalledTimes(1);
+    expect(onSelect).not.toHaveBeenCalled();
+  });
+
+  it("offers agents only when no built-in handler is given", async () => {
+    const client = fakeClient({
+      agent: { list: vi.fn(async () => ({ entries: [], totalPages: 0, totalCount: 0 })) },
+    });
+    const { lastFrame } = render(
+      <InkStigmerProvider client={client}>
+        <AgentPicker org="acme" onSelect={vi.fn()} onCancel={vi.fn()} />
+      </InkStigmerProvider>,
+    );
+    await settle();
+    expect(lastFrame() ?? "").not.toContain("Assistant (built-in)");
+  });
+
   it("seeds the search box from initialQuery", async () => {
     const list = vi.fn(async () => ({ entries: [], totalPages: 0, totalCount: 0 }));
     const client = fakeClient({ agent: { list } });

package/src/components/AgentPicker.tsx

@@ -1,6 +1,6 @@
 import React, { useCallback, useEffect, useMemo } from "react";
 import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
-import { useAgentSearch } from "@stigmer/react";
+import { BUILT_IN_ASSISTANT_NAME, useAgentSearch } from "@stigmer/react";
 import { type PickerItem, ResourcePicker } from "./ResourcePicker.js";
 
 /** Props for {@link AgentPicker}. */
@@ -13,6 +13,13 @@ export interface AgentPickerProps {
   readonly scope?: "org" | "all";
   /** Called with the chosen agent's search result on selection. */
   readonly onSelect: (agent: SearchResult) => void;
+  /**
+   * When given, the list opens with the built-in assistant — the answer a
+   * session gets with no agent at all — as its first row, and choosing it
+   * calls this instead of `onSelect`. Absent, the picker offers agents only
+   * (a caller that needs an agent, such as a schedule, leaves it out).
+   */
+  readonly onSelectBuiltInAssistant?: () => void;
   /** Called when the user cancels (Esc / Ctrl+C). */
   readonly onCancel: () => void;
 }
@@ -20,6 +27,19 @@ export interface AgentPickerProps {
 /** Max description length shown as the row subtitle before truncation. */
 const SUBTITLE_MAX = 60;
 
+/**
+ * The built-in assistant's row id: no agent carries an empty id, so it cannot
+ * collide with a search result, and it reads as what it is on the wire (an
+ * empty `agentInstanceId` is the built-in assistant).
+ */
+const BUILT_IN_ASSISTANT_ITEM_ID = "";
+
+const BUILT_IN_ASSISTANT_ITEM: PickerItem = {
+  id: BUILT_IN_ASSISTANT_ITEM_ID,
+  title: `${BUILT_IN_ASSISTANT_NAME} (built-in)`,
+  subtitle: "No agent: answers with the tools the conversation carries",
+};
+
 /**
  * Interactive picker for choosing an agent by name.
  *
@@ -37,7 +57,14 @@ const SUBTITLE_MAX = 60;
  * );
  * ```
  */
-export function AgentPicker({ org, initialQuery, scope, onSelect, onCancel }: AgentPickerProps) {
+export function AgentPicker({
+  org,
+  initialQuery,
+  scope,
+  onSelect,
+  onSelectBuiltInAssistant,
+  onCancel,
+}: AgentPickerProps) {
   const { results, isLoading, error, query, setQuery } = useAgentSearch(org, { scope });
 
   // Seed the typed-but-unresolved query once on mount so the user picks up
@@ -48,14 +75,23 @@ export function AgentPicker({ org, initialQuery, scope, onSelect, onCancel }: Ag
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
 
-  const items = useMemo<PickerItem[]>(() => results.map(toAgentItem), [results]);
+  // The assistant row stays first whatever the query, because it is not a
+  // search result: it is the choice of not searching for an agent at all.
+  const items = useMemo<PickerItem[]>(() => {
+    const agents = results.map(toAgentItem);
+    return onSelectBuiltInAssistant ? [BUILT_IN_ASSISTANT_ITEM, ...agents] : agents;
+  }, [results, onSelectBuiltInAssistant]);
 
   const handleSelect = useCallback(
     (item: PickerItem) => {
+      if (item.id === BUILT_IN_ASSISTANT_ITEM_ID) {
+        onSelectBuiltInAssistant?.();
+        return;
+      }
       const found = results.find((r) => r.id === item.id);
       if (found !== undefined) onSelect(found);
     },
-    [results, onSelect],
+    [results, onSelect, onSelectBuiltInAssistant],
   );
 
   return (