pinecall 0.5.0 → 0.7.0

package/README.md

@@ -50,7 +50,7 @@ npm i pinecall           # or as a dependency, to write an agent in your own pro
 
 You need a gateway for the CLI to talk to — `pip install pinecall` is that, and
 [from-zero](https://github.com/pinecall/runtime/blob/main/docs/from-zero.md) walks both halves up
-on a laptop in one sitting. To read this code or run the two examples, clone instead:
+on a laptop in one sitting. To read this code or run the example, clone instead:
 
 ## Five minutes
 
@@ -59,11 +59,13 @@ pnpm install                       nothing to build: the checkout runs from its
 cd examples/clinica-norte
 pnpm exec pinecall link            sign in through a browser, pick the org: your key, in ./.env
 pnpm exec pinecall chat            the agent in this terminal, and a prompt against it
-pnpm exec pinecall prompt --state test/prompts/states.json   the exact prompt a state produces
+pnpm exec pinecall prompt --state test/clinica-norte/prompts/states.json   the exact prompt a state produces
 pnpm exec pinecall start           the app: the process you deploy
 pnpm exec pinecall start --serve   the same, and its console on http://localhost:4100
 pnpm exec pinecall serve           that console alone: your sandbox, on this machine
-pnpm exec pinecall knowledge push  ./knowledge/docs to the gateway, under the agent's name
+pnpm exec pinecall docs push       docs/clinica-norte/ to the gateway, as the base the agent searches
+pnpm exec pinecall docs attach clinica-norte --k 4   the agent reads that base, in your corner
+pnpm exec pinecall agent knowledge edit              what it knows by heart, in $EDITOR, as a setting
 pnpm exec pinecall test            ring 1: the goldens, through the app in this process
 ```
 
@@ -76,11 +78,17 @@ Every verb reads `PINECALL_KEY` (and `PINECALL_URL`, when the gateway is not the
 environment, else from the project's `.env`, which `pinecall link` wrote; each is the sandbox until
 `--prod` says production, for a person whose org lets them act there. On a server the agent runs
 on a server's token from the console's Tokens screen, as `pinecall start --prod` or mounted inside
-your own Node app — [docs/production.md](docs/production.md).
-
-A tenant that installed `pinecall` from npm has it on the PATH and writes `pinecall start`. A
-repository of several agents keeps each in `agents/<name>.tsx`, and one `pinecall start` at its root
-holds them all — [docs/writing-an-agent.md](docs/writing-an-agent.md#several-agents-in-one-project).
+your own Node app — [docs/production.md](docs/production.md). `pinecall agent list --prod` says
+which process holds each agent, on which machine, since when, and `pinecall agent stop <app>` stops
+one.
+
+A tenant that installed `pinecall` from npm has it on the PATH and writes `pinecall start`. One
+layout, one agent or five: the class in `agents/<name>/agent.tsx`, what it searches in
+`docs/<name>/`, its goldens, personas and memory cases under `test/<name>/`, and one `pinecall
+start` at the root holds them all — [docs/the-cli.md](docs/the-cli.md#the-project). The class is
+the contract — doors, language, state, tools, `render()` — and what it runs on is the world's:
+voice, model, opening, what it knows by heart and which base it searches are settings, per world
+and versioned, never fields of the class.
 
 Working on the framework itself:
 
@@ -114,7 +122,7 @@ Beside it:
 
 | | |
 |---|---|
-| `examples/` | `clinica-norte` and `tienda-sur`: two tenants, written as a customer writes one |
+| `examples/` | `clinica-norte`: one tenant, written as a customer writes one |
 | `test/` | mirrors `src/`, plus the three that pin the shape: the tree, the imports, the surface |
 
 ## The three doors out of this package

package/dist/agent/agent.d.ts

@@ -1,13 +1,13 @@
 /** The Agent base class: its fields are the state, and every assignment is a change with an author. */
-import type { DocsMode } from "@pinecall/protocol";
 import { type ToolSpec } from "./tools.js";
 import type { Child } from "../views/jsx-runtime.js";
 import type { CallWorld } from "../call/call.js";
+import type { Knowledge } from "./knowledge.js";
 import type { EventDeclarations, EventMeta } from "./accepts.js";
 import { type Visibility } from "./visibility.js";
 import type { Call, MemoryOp } from "./lifecycle.js";
 import { type LastCall, type Snapshot } from "./state.js";
-export declare const CONFIG_FIELDS: readonly ["phone", "whatsapp", "web", "voice", "greeting", "says", "hears", "llm", "stt", "language", "knowledge", "docs", "memory", "hangup"];
+export declare const CONFIG_FIELDS: readonly ["phone", "whatsapp", "web", "language"];
 /** One field assignment, as the log and the console read it. */
 export interface Change {
     seq: number;
@@ -33,42 +33,6 @@ export interface EventHeard {
     meta: EventMeta;
 }
 export type EventListener = (heard: EventHeard) => void;
-/**
- * What `docs` says: the knowledge base the agent answers from, by the name it was pushed under
- * (`pinecall knowledge push --base <name>`), and how its chunks reach the model. The bare string
- * form `docs = "clinica-norte"` is the base alone, with every other setting the runtime's.
- */
-export interface DocsDeclaration {
-    base: string;
-    mode?: DocsMode;
-    k?: number;
-    minScore?: number;
-}
-/**
- * What `greeting` says: how the agent opens a call, before the caller has said anything. Exactly
- * one of the two, because there are only two ways to open one — `say` are the words themselves,
- * read out as written, and `reply` is what the model is told before it finds its own. The bare
- * string form `greeting = "Clínica Norte, buenos días."` is the words. A class that declares
- * nothing waits for the caller.
- */
-export interface GreetingDeclaration {
-    say?: string;
-    reply?: string;
-    allowInterruptions?: boolean;
-}
-/**
- * What `hangup` says: that the model may end the call itself, and when, in your own words. A class
- * that declares nothing cannot hang up — only the caller and a supervisor end a call. The tool is
- * livekit's own `end_call`, and it is hidden while the agent is greeting.
- */
-export interface HangupDeclaration {
-    when?: string;
-}
-/** What `memory` says: what to keep about a contact across calls, in the tenant's words, and what never to. */
-export interface MemoryDeclaration {
-    remember?: string[];
-    forget?: string[];
-}
 /** Everything the framework knows about one live agent, kept off the instance's own fields. */
 export interface Internals {
     changes: Change[];
@@ -94,6 +58,13 @@ export declare class Agent {
     constructor();
     /** The class docstring, when the app prefers to say it out loud instead of in a JSDoc. */
     static doc?: string;
+    /**
+     * The knowledge bases this agent reads, searched from inside a tool: `await
+     * this.knowledge.search("horarios", { k: 3 })`. Which bases is the world's to say — attached to
+     * the agent in its settings, `pinecall docs attach` — and a world that attaches none refuses
+     * the class at registration. The gateway runs the search and logs what it found.
+     */
+    get knowledge(): Knowledge;
     /** The outside facts this class accepts, and from whom: `static events = {...}`. */
     static events?: EventDeclarations;
     /** Who may see a field, for a class that would rather write a map than a `@state`. */

package/dist/agent/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}

package/dist/agent/agent.js

@@ -1,27 +1,16 @@
 /** The Agent base class: its fields are the state, and every assignment is a change with an author. */
+// tools.ts imports this module back; the cycle is fine because both sides only reach across at
+// call time, and both exports are hoisted function declarations.
 import { currentAuthor, UnauthoredWrite } from "./authors.js";
 import { docOf, toolsOf, visibleToolsOf } from "./tools.js";
 import { declaredStateOf } from "./visibility.js";
 import { collapse, restore, snapshot } from "./state.js";
 // The names an app uses to configure the agent rather than to remember something about the
-// caller. They live on the instance like any other field, but they are never state: they do not
-// change during a call, they are not diffed, and no snapshot carries them.
-export const CONFIG_FIELDS = [
-    "phone",
-    "whatsapp",
-    "web",
-    "voice",
-    "greeting",
-    "says",
-    "hears",
-    "llm",
-    "stt",
-    "language",
-    "knowledge",
-    "docs",
-    "memory",
-    "hangup",
-];
+// caller: its doors, and its language. They live on the instance like any other field, but they
+// are never state: they do not change during a call, they are not diffed, and no snapshot carries
+// them. Everything else the class used to configure — a voice, the models, an opening, what it
+// remembers, what it reads — is the world's (runtime/environment.ts), and refused at load.
+export const CONFIG_FIELDS = ["phone", "whatsapp", "web", "language"];
 // The list is the array; the Set is how this module asks about it on every assignment. state.ts
 // derives `ConfigName` from the same array, so a name added here is a name the snapshot drops.
 const CONFIG = new Set(CONFIG_FIELDS);
@@ -80,6 +69,16 @@ export class Agent {
     }
     /** The class docstring, when the app prefers to say it out loud instead of in a JSDoc. */
     static doc;
+    /**
+     * The knowledge bases this agent reads, searched from inside a tool: `await
+     * this.knowledge.search("horarios", { k: 3 })`. Which bases is the world's to say — attached to
+     * the agent in its settings, `pinecall docs attach` — and a world that attaches none refuses
+     * the class at registration. The gateway runs the search and logs what it found.
+     */
+    get knowledge() {
+        // Async, so an instance nobody is serving refuses through the promise and not by throwing.
+        return { search: async (query, options) => await this.call.search(query, options) };
+    }
     /** The outside facts this class accepts, and from whom: `static events = {...}`. */
     static events;
     /** Who may see a field, for a class that would rather write a map than a `@state`. */

package/dist/agent/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}

package/dist/agent/knowledge.d.ts

@@ -0,0 +1,9 @@
+/** What a class reaches its bases through: `this.knowledge.search`, one verb the gateway answers for the call in hand. */
+import type { Found } from "../call/call.js";
+/** The search: the best chunks of the bases the world attached, for these words, `k` of them. */
+export interface Knowledge {
+    search(query: string, options?: {
+        k?: number;
+    }): Promise<Found[]>;
+}
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/agent/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/agent/knowledge.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAE1H,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,iGAAiG;AACjG,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;CACnE"}

package/dist/agent/knowledge.js

@@ -0,0 +1,3 @@
+/** What a class reaches its bases through: `this.knowledge.search`, one verb the gateway answers for the call in hand. */
+export {};
+//# sourceMappingURL=knowledge.js.map

package/dist/agent/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../src/agent/knowledge.ts"],"names":[],"mappings":"AAAA,0HAA0H"}

package/dist/agent/searching.d.ts

@@ -0,0 +1,8 @@
+/** Whether a class searches the knowledge base itself: its source, read by oxc's parser for `this.knowledge`. */
+/**
+ * Whether this source reaches `this.knowledge`. The gateway is told so at registration
+ * (`uses_knowledge`), and refuses a world that attaches the class no base — at boot, not in a call
+ * where the search would find nothing.
+ */
+export declare function searchesKnowledge(source: string, file?: string): boolean;
+//# sourceMappingURL=searching.d.ts.map

package/dist/agent/searching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searching.d.ts","sourceRoot":"","sources":["../../src/agent/searching.ts"],"names":[],"mappings":"AAAA,iHAAiH;AAgBjH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,SAAc,GAAG,OAAO,CAG7E"}

package/dist/agent/searching.js

@@ -0,0 +1,38 @@
+/** Whether a class searches the knowledge base itself: its source, read by oxc's parser for `this.knowledge`. */
+import { parseSync } from "oxc-parser";
+// Why the parser and not a regex: `this.knowledge` inside a string, a comment or a template is not
+// a search, and a regex cannot tell. The AST can. What is looked for is one shape — a member
+// expression whose object is `this` and whose property is the word — anywhere in the file, so a
+// helper method that searches on the class's behalf counts as much as a tool that does.
+const THE_WORD = "knowledge";
+/**
+ * Whether this source reaches `this.knowledge`. The gateway is told so at registration
+ * (`uses_knowledge`), and refuses a world that attaches the class no base — at boot, not in a call
+ * where the search would find nothing.
+ */
+export function searchesKnowledge(source, file = "agent.tsx") {
+    const parsed = parseSync(file, source, { sourceType: "module" });
+    return reaches(parsed.program);
+}
+function reaches(node) {
+    if (node.type === "MemberExpression") {
+        const object = node["object"];
+        const property = node["property"];
+        if (object.type === "ThisExpression" && property.type === "Identifier" && property["name"] === THE_WORD)
+            return true;
+    }
+    for (const child of Object.values(node)) {
+        if (Array.isArray(child)) {
+            if (child.some((one) => isNode(one) && reaches(one)))
+                return true;
+        }
+        else if (isNode(child) && reaches(child)) {
+            return true;
+        }
+    }
+    return false;
+}
+function isNode(value) {
+    return typeof value === "object" && value !== null && typeof value.type === "string";
+}
+//# sourceMappingURL=searching.js.map

package/dist/agent/searching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searching.js","sourceRoot":"","sources":["../../src/agent/searching.ts"],"names":[],"mappings":"AAAA,iHAAiH;AAEjH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,mGAAmG;AACnG,6FAA6F;AAC7F,gGAAgG;AAChG,wFAAwF;AACxF,MAAM,QAAQ,GAAG,WAAW,CAAC;AAQ7B;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,IAAI,GAAG,WAAW;IAClE,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjE,OAAO,OAAO,CAAC,MAAM,CAAC,OAA0B,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,OAAO,CAAC,IAAU;IACzB,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAS,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAS,CAAC;QAC1C,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;IACvH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QACpE,CAAC;aAAM,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAAc,CAAC,IAAI,KAAK,QAAQ,CAAC;AACjG,CAAC"}

package/dist/call/call.d.ts

@@ -2,6 +2,16 @@
 import type { Call as HookCall } from "../agent/lifecycle.js";
 import { History } from "./history.js";
 import { ParticipantHandle, Room, type Commander } from "./room.js";
+/** One chunk a search found, as the model reads it: where it came from, and its text. */
+export interface Found {
+    path: string;
+    heading: string | null;
+    text: string;
+}
+/** What runs a search for this call: the gateway, through the client that holds the call. */
+export type Searching = (query: string, k?: number) => Promise<Found[]>;
+/** A search asked of a call nobody is serving through a gateway: a prompt printed offline, a test. */
+export declare const NO_GATEWAY_TO_SEARCH = "this call cannot search: no gateway is serving it";
 /** What the call world needs to know about the line, beyond what the room's entries tell it. */
 export interface CallLine extends HookCall {
     today?: string;
@@ -14,6 +24,7 @@ export interface CallLine extends HookCall {
 export declare class CallWorld implements HookCall {
     #private;
     private readonly out;
+    private readonly searching;
     private readonly ackMs;
     readonly id: string;
     readonly contact: string;
@@ -28,7 +39,7 @@ export declare class CallWorld implements HookCall {
         name: string;
         seq: number;
     } | null;
-    constructor(line: CallLine, out: Commander, ackMs?: number);
+    constructor(line: CallLine, out: Commander, searching?: Searching | null, ackMs?: number);
     /** The next outside fact's place in this call's own stream of them; the wire's seq is not on it. */
     numbered(): number;
     /** One participant, and what may be done to them: `call.participant(id).mute()`. */
@@ -45,6 +56,14 @@ export declare class CallWorld implements HookCall {
     reply(instructions: string, options?: {
         allowInterruptions?: boolean;
     }): Promise<boolean>;
+    /**
+     * The best chunks of the bases this agent reads, for these words. The gateway searches — the
+     * bases are the world's, attached to the agent in its settings — and writes what it found on
+     * the call's log, so the grounded judge weighs it. `k` is how many; each base's own when unsaid.
+     */
+    search(query: string, options?: {
+        k?: number;
+    }): Promise<Found[]>;
     /** Invite somebody into the room: the room's own verb, reachable from the call for symmetry. */
     invite(to: string, options: {
         kind: "sip" | "participant";

package/dist/call/call.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/call/call.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAErG,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,KAAK,SAAS,EAAwB,MAAM,WAAW,CAAC;AAK1F,gGAAgG;AAChG,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,SAAU,YAAW,QAAQ;;IAoBtC,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IApBxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,UAAiB;IAMjC,0FAA0F;IAC1F,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAQ;IAGnD,YACE,IAAI,EAAE,QAAQ,EACG,GAAG,EAAE,SAAS,EACd,KAAK,SAAS,EAQhC;IAED,oGAAoG;IACpG,QAAQ,IAAI,MAAM,CAEjB;IAED,oFAAoF;IACpF,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAE/C;IAED,0FAA0F;IAC1F,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI,CAEtF;IAED,mGAAmG;IACnG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAGlF;IAED,yFAAyF;IACzF,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAG5F;IAED,gGAAgG;IAChG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,aAAa,CAAA;KAAE,GAAG,IAAI,CAEjE;IAED,iGAAiG;IACjG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAuBlE;CAmBF"}
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/call/call.ts"],"names":[],"mappings":"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"}

package/dist/call/call.js

@@ -3,6 +3,8 @@ import { History } from "./history.js";
 import { ParticipantHandle, Room } from "./room.js";
 /** How long a say or a reply waits for the turn it lands as before it gives up saying so. */
 const ACK_MS = 30_000;
+/** A search asked of a call nobody is serving through a gateway: a prompt printed offline, a test. */
+export const NO_GATEWAY_TO_SEARCH = "this call cannot search: no gateway is serving it";
 /**
  * One live call, as the class holds it. Everything on it was reduced from entries the runtime
  * already receives, and every verb is one command on the wire — there is no LiveKit here and no
@@ -10,6 +12,7 @@ const ACK_MS = 30_000;
  */
 export class CallWorld {
     out;
+    searching;
     ackMs;
     id;
     contact;
@@ -26,8 +29,9 @@ export class CallWorld {
     /** The event being dispatched right now, so a write inside onEvent can name its cause. */
     cause = null;
     #events = 0;
-    constructor(line, out, ackMs = ACK_MS) {
+    constructor(line, out, searching = null, ackMs = ACK_MS) {
         this.out = out;
+        this.searching = searching;
         this.ackMs = ackMs;
         this.id = line.id;
         this.contact = line.contact;
@@ -61,6 +65,16 @@ export class CallWorld {
         this.out("agent.reply", { instructions, ...options });
         return this.#spoken();
     }
+    /**
+     * The best chunks of the bases this agent reads, for these words. The gateway searches — the
+     * bases are the world's, attached to the agent in its settings — and writes what it found on
+     * the call's log, so the grounded judge weighs it. `k` is how many; each base's own when unsaid.
+     */
+    search(query, options = {}) {
+        if (this.searching === null)
+            return Promise.reject(new Error(NO_GATEWAY_TO_SEARCH));
+        return this.searching(query, options.k);
+    }
     /** Invite somebody into the room: the room's own verb, reachable from the call for symmetry. */
     invite(to, options) {
         this.room.invite(to, options);

package/dist/call/call.js.map

@@ -1 +1 @@
-{"version":3,"file":"call.js","sourceRoot":"","sources":["../../src/call/call.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAGrG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAwC,MAAM,WAAW,CAAC;AAE1F,6FAA6F;AAC7F,MAAM,MAAM,GAAG,MAAM,CAAC;AAOtB;;;;GAIG;AACH,MAAM,OAAO,SAAS;IAoBD,GAAG;IACH,KAAK;IApBf,EAAE,CAAS;IACX,OAAO,CAAS;IAChB,IAAI,CAAU;IACd,OAAO,CAAU;IAC1B,8FAA8F;IACrF,KAAK,CAAU;IACf,IAAI,CAAO;IACX,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAEjC,gGAAgG;IAChG,4FAA4F;IAC5F,0EAA0E;IAC1E,SAAS,GAAkC,EAAE,CAAC;IAC9C,0FAA0F;IAC1F,KAAK,GAAyC,IAAI,CAAC;IACnD,OAAO,GAAG,CAAC,CAAC;IAEZ,YACE,IAAc,EACG,GAAc,EACd,KAAK,GAAG,MAAM;mBADd,GAAG;qBACH,KAAK;QAEtB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5D,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,oGAAoG;IACpG,QAAQ;QACN,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,oFAAoF;IACpF,WAAW,CAAC,QAAgB;QAC1B,OAAO,IAAI,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,0FAA0F;IAC1F,IAAI,CAAC,KAAa,EAAE,IAA6B,EAAE,OAAO,GAAoB,EAAE;QAC9E,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,mGAAmG;IACnG,GAAG,CAAC,IAAY,EAAE,OAAO,GAAqC,EAAE;QAC9D,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED,yFAAyF;IACzF,KAAK,CAAC,YAAoB,EAAE,OAAO,GAAqC,EAAE;QACxE,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED,gGAAgG;IAChG,MAAM,CAAC,EAAU,EAAE,OAAwC;QACzD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,iGAAiG;IACjG,IAAI,CAAC,IAAY,EAAE,IAA6B,EAAE,EAAU;QAC1D,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,oBAAoB;gBACvB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CACrB;oBACE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAClC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAoB;oBACrC,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACpE,EACD,EAAE,CACH,CAAC;YACJ,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAClD,KAAK,sBAAsB;gBACzB,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC;YACjF,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACrK,KAAK,YAAY;gBACf,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBACpL,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5B;gBACE,OAAO;QACX,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YACtC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,4FAA4F;YAC5F,4FAA4F;YAC5F,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;gBACzE,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,MAAe;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,KAAK,MAAM,OAAO,IAAI,OAAO;YAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"call.js","sourceRoot":"","sources":["../../src/call/call.ts"],"names":[],"mappings":"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"}

package/dist/cli/agent-knowledge.d.ts

@@ -0,0 +1,19 @@
+/** `pinecall agent knowledge [edit]`: what the agent knows by heart, printed, or opened in $EDITOR and kept as the next version. */
+import type { TuningRow } from "@pinecall/protocol";
+import { type Door } from "./testing/gateway.js";
+/** What opens the text for a person and hands back what they left: $EDITOR, or a test's answer. */
+export type Editor = (text: string) => Promise<string>;
+/** Flags the two verbs read off `pinecall agent`'s own table. */
+interface Flags {
+    team?: boolean | undefined;
+    note?: string | undefined;
+}
+export declare const NOTHING_KNOWN: (agent: string, corner: string) => string;
+export declare const NO_EDITOR = "no editor: set $EDITOR (or $VISUAL) to the one that opens Markdown for you";
+export declare const UNCHANGED = "nothing changed: no version written";
+/** The corner's text printed, or opened in the editor and kept. */
+export declare function knowledgeRun(door: Door, agent: string, verb: string | undefined, flags: Flags, out: NodeJS.WritableStream, err: NodeJS.WritableStream, editor?: Editor): Promise<number>;
+/** Whether a corner's row sets the text: the page that draws a row asks. */
+export declare function knows(row: TuningRow | null): boolean;
+export {};
+//# sourceMappingURL=agent-knowledge.d.ts.map

package/dist/cli/agent-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-knowledge.d.ts","sourceRoot":"","sources":["../../src/cli/agent-knowledge.ts"],"names":[],"mappings":"AAAA,oIAAoI;AAOpI,OAAO,KAAK,EAA4B,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG9E,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAExD,mGAAmG;AACnG,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEvD,iEAAiE;AACjE,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,eAAO,MAAM,aAAa,UAAW,MAAM,UAAU,MAAM,KAAG,MAC+B,CAAC;AAC9F,eAAO,MAAM,SAAS,+EAA+E,CAAC;AACtG,eAAO,MAAM,SAAS,wCAAwC,CAAC;AAE/D,mEAAmE;AACnE,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,MAAM,GAAE,MAAoB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAeD,4EAA4E;AAC5E,wBAAgB,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAEpD"}

package/dist/cli/agent-knowledge.js

@@ -0,0 +1,84 @@
+/** `pinecall agent knowledge [edit]`: what the agent knows by heart, printed, or opened in $EDITOR and kept as the next version. */
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { readSettings, settingsPath } from "./agent-lines.js";
+import { asked } from "./testing/gateway.js";
+export const NOTHING_KNOWN = (agent, corner) => `${agent} knows nothing by heart in ${corner}: \`pinecall agent knowledge edit\` writes it`;
+export const NO_EDITOR = "no editor: set $EDITOR (or $VISUAL) to the one that opens Markdown for you";
+export const UNCHANGED = "nothing changed: no version written";
+/** The corner's text printed, or opened in the editor and kept. */
+export async function knowledgeRun(door, agent, verb, flags, out, err, editor = inTheEditor) {
+    const team = flags.team === true;
+    const standing = await readSettings(door, agent);
+    const row = team ? standing.team : (standing.yours ?? standing.team);
+    const corner = cornerName(standing, team);
+    const text = row?.config.knowledge ?? undefined;
+    if (verb === undefined) {
+        if (text === undefined) {
+            out.write(`${NOTHING_KNOWN(agent, corner)}\n`);
+            return 0;
+        }
+        out.write(text.endsWith("\n") ? text : `${text}\n`);
+        return 0;
+    }
+    if (verb !== "edit") {
+        err.write("usage: pinecall agent knowledge [edit] [--team] [--note '…']\n");
+        return 2;
+    }
+    const written = await editor(text ?? "");
+    if (written === (text ?? "")) {
+        out.write(`${UNCHANGED}\n`);
+        return 0;
+    }
+    const own = team ? standing.team : standing.yours;
+    const config = kept(own?.config ?? {}, written);
+    const answer = await asked(door, settingsPath(agent), {
+        method: "PUT",
+        body: { config, if_version: own?.version ?? null, note: flags.note ?? "knowledge", team },
+    });
+    const now = team ? answer.team : answer.yours;
+    out.write(`${agent} · knowledge ${written.trim() === "" ? "taken out" : `${written.length.toLocaleString("en-US")} chars`} · ${corner} v${now?.version ?? "?"}\n`);
+    return 0;
+}
+// The whole set travels, as every settings write does: the corner's row with one field changed.
+// An empty file takes the field out — there is no blank value, the door refuses one — so what
+// the runtime's default is stands for it again.
+function kept(config, written) {
+    const { knowledge: _was, ...rest } = config;
+    return written.trim() === "" ? rest : { ...rest, knowledge: written };
+}
+function cornerName(answer, team) {
+    if (answer.world === "production")
+        return "production";
+    return team || answer.yours === null ? "the team's corner" : "your corner";
+}
+/** Whether a corner's row sets the text: the page that draws a row asks. */
+export function knows(row) {
+    return row !== null && typeof row.config.knowledge === "string";
+}
+// The one way a person writes a page of Markdown from a terminal that is not typing it into a
+// flag: their own editor, on a file, the way `git commit` and `crontab -e` do it. The file lives
+// a moment in a temp directory of its own and is gone before this returns.
+async function inTheEditor(text) {
+    const editor = process.env["VISUAL"] ?? process.env["EDITOR"];
+    if (editor === undefined || editor === "")
+        throw new Error(NO_EDITOR);
+    const folder = mkdtempSync(join(tmpdir(), "pinecall-knowledge-"));
+    const file = join(folder, "knowledge.md");
+    try {
+        writeFileSync(file, text);
+        // One command line, not a command and an argument: `$EDITOR` is a LINE a person wrote — `code
+        // -w`, `emacsclient -nw` — and a shell is what reads it. The path is quoted here because the
+        // shell would otherwise split a temp directory with a space in it.
+        const opened = spawnSync(`${editor} '${file.replaceAll("'", "'\\''")}'`, { stdio: "inherit", shell: true });
+        if (opened.status !== 0)
+            throw new Error(`${editor} exited with ${opened.status}: nothing written`);
+        return readFileSync(file, "utf8");
+    }
+    finally {
+        rmSync(folder, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=agent-knowledge.js.map

package/dist/cli/agent-knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-knowledge.js","sourceRoot":"","sources":["../../src/cli/agent-knowledge.ts"],"names":[],"mappings":"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"}

package/dist/cli/agent-lines.d.ts

@@ -6,7 +6,7 @@ export declare function settingsPath(agent: string): string;
 /** The three corners as this key sees them: its own, the team's, production's. */
 export declare function readSettings(door: Door, agent: string): Promise<TuningAnswer>;
 /** The fields on the page, in the order a person reads them, under the names a person types. */
-export declare const FIELDS: readonly ["voice", "tts", "tts-model", "stt", "llm", "greeting", "hangup", "turn", "memory", "knowledge"];
+export declare const FIELDS: readonly ["voice", "tts", "tts-model", "stt", "llm", "greeting", "hangup", "turn", "memory", "knowledge", "bases"];
 export type Field = (typeof FIELDS)[number];
 /** The name a person types, as the wire spells it. */
 export declare const WIRE: Record<Field, keyof TuningBody>;

package/dist/cli/agent-lines.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-lines.d.ts","sourceRoot":"","sources":["../../src/cli/agent-lines.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG9E,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAExD,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,kFAAkF;AAClF,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAEnF;AAED,gGAAgG;AAChG,eAAO,MAAM,MAAM,YAAI,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAChI,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,sDAAsD;AACtD,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,UAAU,CAWhD,CAAC;AAOF,iGAAiG;AACjG,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAiC1E;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAIlD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAqBrE"}
+{"version":3,"file":"agent-lines.d.ts","sourceRoot":"","sources":["../../src/cli/agent-lines.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG9E,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAExD,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,kFAAkF;AAClF,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAEnF;AAED,gGAAgG;AAChG,eAAO,MAAM,MAAM,YAAI,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AACzI,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,sDAAsD;AACtD,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,UAAU,CAYhD,CAAC;AAOF,iGAAiG;AACjG,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAqC1E;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAIlD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAqBrE"}