pinecall 0.1.0

package/dist/runtime/grounding.js

@@ -0,0 +1,72 @@
+/** `knowledge` / `docs` / `memory` fields → what the declaration carries: the file read, the base named, the policy. */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+// A string with a `*` or a `/` in it is the glob `docs` used to be — a path the app expanded
+// itself. The base is pushed by name now, and the sentence says which verb does the pushing.
+const A_GLOB = /[*/]/;
+/**
+ * What the class says it knows, reads and remembers, read off one probe instance. `file` is the
+ * agent's own path, so a knowledge file is found beside the class and not beside whoever ran the
+ * process; without one it is read from the working directory.
+ */
+export function groundingOf(probe, file) {
+    const declared = probe;
+    const grounding = {};
+    const knowledge = knowledgeOf(declared.knowledge, file);
+    if (knowledge)
+        grounding.knowledge = knowledge;
+    const docs = baseOf(declared.docs);
+    if (docs)
+        grounding.docs = docs;
+    const memory = memoryOf(declared.memory);
+    if (memory)
+        grounding.memory = memory;
+    return grounding;
+}
+// The file is sent whole: the runtime puts its text where the knowledge marker is, in the static
+// block, once per call. Its path travels as the class wrote it, because that is the name the
+// marker carries. A file that is not there is refused here, with the path that was looked at.
+function knowledgeOf(value, file) {
+    if (typeof value !== "string" || value === "")
+        return undefined;
+    const path = resolve(file === undefined ? process.cwd() : dirname(file), value);
+    if (!existsSync(path)) {
+        throw new Error(`knowledge ${value}: no such file at ${path}`);
+    }
+    return { path: value, text: readFileSync(path, "utf8") };
+}
+/** `docs = "clinica-norte"` or `docs = { base, mode?, k?, minScore? }`: the base, as the wire names it. */
+function baseOf(value) {
+    if (typeof value === "string") {
+        if (value === "")
+            return undefined;
+        if (A_GLOB.test(value)) {
+            throw new Error("docs name the base they were pushed to: run `pinecall knowledge push ./knowledge/docs --base <slug>`");
+        }
+        return { base: value };
+    }
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const declared = value;
+    const docs = { base: declared.base };
+    if (declared.mode !== undefined)
+        docs.mode = declared.mode;
+    if (declared.k !== undefined)
+        docs.k = declared.k;
+    if (declared.minScore !== undefined)
+        docs.minScore = declared.minScore;
+    return docs;
+}
+/** `memory = { remember: [...], forget: [...] }`, in the tenant's words, as declared. */
+function memoryOf(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const declared = value;
+    const memory = {};
+    if (Array.isArray(declared.remember))
+        memory.remember = declared.remember;
+    if (Array.isArray(declared.forget))
+        memory.forget = declared.forget;
+    return memory;
+}
+//# sourceMappingURL=grounding.js.map

package/dist/runtime/grounding.js.map

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

package/dist/runtime/recall.d.ts

@@ -0,0 +1,10 @@
+/** What memory recalled about this caller, as the words a class's `render()` may ask about. */
+import type { Camel, MemoryOps } from "@pinecall/protocol";
+/**
+ * Every word one `memory.ops` entry puts in front of the model: each fact's own sentence, and the
+ * word the class remembered it by. Only a `recall` counts — a `remember` at hang-up is what this
+ * call taught memory, not what memory told this call — so `remembers()` never answers with a fact
+ * the caller has not been told back.
+ */
+export declare function wordsRecalled(entry: Camel<MemoryOps>): string[];
+//# sourceMappingURL=recall.d.ts.map

package/dist/runtime/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/runtime/recall.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,EAAE,CAI/D"}

package/dist/runtime/recall.js

@@ -0,0 +1,13 @@
+/** What memory recalled about this caller, as the words a class's `render()` may ask about. */
+/**
+ * Every word one `memory.ops` entry puts in front of the model: each fact's own sentence, and the
+ * word the class remembered it by. Only a `recall` counts — a `remember` at hang-up is what this
+ * call taught memory, not what memory told this call — so `remembers()` never answers with a fact
+ * the caller has not been told back.
+ */
+export function wordsRecalled(entry) {
+    return entry.ops
+        .filter((op) => op.op === "recall")
+        .flatMap((op) => op.facts.flatMap((fact) => [fact.text, fact.category ?? ""]));
+}
+//# sourceMappingURL=recall.js.map

package/dist/runtime/recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.js","sourceRoot":"","sources":["../../src/runtime/recall.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAI/F;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAuB;IACnD,OAAO,KAAK,CAAC,GAAG;SACb,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC;SAClC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/dist/runtime/run-tool.d.ts

@@ -0,0 +1,26 @@
+/** Running one tool call: the args are checked, the method runs, and the result is cut to a preview. */
+import type { ToolDeclaration } from "../agent/tools.js";
+/**
+ * A tool that did not run, or ran and failed, said in words a model may read. The SDK turns a
+ * rejection into a tool.result carrying `error`, which is the only way the model hears about it.
+ */
+export declare class ToolFailed extends Error {
+    constructor(message: string);
+}
+/** What the model sent, checked against the tool's own schema; empty means it may run. */
+export declare function validate(declaration: ToolDeclaration, args: Record<string, unknown>): string[];
+/** The model's object as the method's argument list, in the signature's own order. */
+export declare function argumentsFor(declaration: ToolDeclaration, args: Record<string, unknown>): unknown[];
+/**
+ * What the model sees of a result. `preview: 2` means the model reads two rows and the state field
+ * keeps every one of them, so the agent can offer a third without asking the agenda again.
+ */
+export declare function preview(declaration: ToolDeclaration, result: unknown): unknown;
+/**
+ * Run one tool call against a live agent: check, call, cut.
+ *
+ * The method is reached through the instance and not through `declaration.method`, because the
+ * decorator's wrapper is what gives every `this.slot = …` inside it the tool's name as its author.
+ */
+export declare function runTool(agent: object, declaration: ToolDeclaration, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=run-tool.d.ts.map

package/dist/runtime/run-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tool.d.ts","sourceRoot":"","sources":["../../src/runtime/run-tool.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAExG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAwCD,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAE9F;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAC1B,WAAW,EAAE,eAAe,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,EAAE,CAEX;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAI9E;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,eAAe,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/runtime/run-tool.js

@@ -0,0 +1,82 @@
+/** Running one tool call: the args are checked, the method runs, and the result is cut to a preview. */
+/**
+ * A tool that did not run, or ran and failed, said in words a model may read. The SDK turns a
+ * rejection into a tool.result carrying `error`, which is the only way the model hears about it.
+ */
+export class ToolFailed extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ToolFailed";
+    }
+}
+// The model fills a JSON object; the method takes positional arguments. The schema's property
+// order is the signature's order — parametersOf writes it from the parsed parameter list — so the
+// object becomes the argument list by walking the same keys.
+function orderOf(parameters) {
+    return Object.keys(parameters.properties ?? {});
+}
+function typeOf(value) {
+    if (Array.isArray(value))
+        return "array";
+    if (value === null)
+        return "null";
+    return typeof value;
+}
+// Only the shapes the schema can actually state are checked: a required name that is missing, and
+// a value whose JSON type is not the declared one. Anything deeper — a Slot's own fields — is the
+// app's to check, because the framework never saw the type behind the alias.
+function complaintsAbout(parameters, args) {
+    const properties = parameters.properties ?? {};
+    const complaints = [];
+    for (const name of parameters.required ?? []) {
+        if (args[name] === undefined)
+            complaints.push(`${name} is required`);
+    }
+    for (const [name, schema] of Object.entries(properties)) {
+        const value = args[name];
+        const wanted = schema.type;
+        if (value === undefined || wanted === undefined)
+            continue;
+        if (typeOf(value) !== wanted) {
+            complaints.push(`${name} must be a ${wanted}, not a ${typeOf(value)}`);
+        }
+    }
+    return complaints;
+}
+/** What the model sent, checked against the tool's own schema; empty means it may run. */
+export function validate(declaration, args) {
+    return complaintsAbout(declaration.spec.parameters, args ?? {});
+}
+/** The model's object as the method's argument list, in the signature's own order. */
+export function argumentsFor(declaration, args) {
+    return orderOf(declaration.spec.parameters).map((name) => args?.[name]);
+}
+/**
+ * What the model sees of a result. `preview: 2` means the model reads two rows and the state field
+ * keeps every one of them, so the agent can offer a third without asking the agenda again.
+ */
+export function preview(declaration, result) {
+    const rows = declaration.options.preview;
+    if (rows === undefined || !Array.isArray(result) || result.length <= rows)
+        return result;
+    return result.slice(0, rows);
+}
+/**
+ * Run one tool call against a live agent: check, call, cut.
+ *
+ * The method is reached through the instance and not through `declaration.method`, because the
+ * decorator's wrapper is what gives every `this.slot = …` inside it the tool's name as its author.
+ */
+export async function runTool(agent, declaration, args) {
+    const complaints = validate(declaration, args);
+    if (complaints.length > 0) {
+        throw new ToolFailed(`${declaration.name}: ${complaints.join("; ")}`);
+    }
+    const method = agent[declaration.name];
+    if (typeof method !== "function") {
+        throw new ToolFailed(`${declaration.name}: this agent has no such method any more`);
+    }
+    const result = await method.apply(agent, argumentsFor(declaration, args));
+    return preview(declaration, result);
+}
+//# sourceMappingURL=run-tool.js.map

package/dist/runtime/run-tool.js.map

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

package/dist/views/components.d.ts

@@ -0,0 +1,17 @@
+/** The tags a view is written in: prose blocks and standing rules, rendered to text and to nothing else. */
+import { type Component } from "./jsx-runtime.js";
+/** One standing rule, on its own line, as a bullet. */
+export declare const Rule: Component;
+/** The rules block: every child on its own line, wrapped so the model can see where it ends. */
+export declare const Rules: Component;
+/** The protocols block: how the agent behaves whatever the state says. */
+export declare const Protocols: Component;
+/** A titled part of the prompt: the title as a heading, then the children as paragraphs. */
+export declare const Section: Component;
+/** A worked example, wrapped so the model reads it as an example and not as an instruction. */
+export declare const Example: Component;
+/** A paragraph, for a view that prefers the component to the lowercase tag. */
+export declare const p: Component;
+/** A body wrapped in the tag the model reads it under, or nothing at all when the body is empty. */
+export declare function tagged(name: string, body: string): string;
+//# sourceMappingURL=components.d.ts.map

package/dist/views/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/views/components.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAE5G,OAAO,EAAkD,KAAK,SAAS,EAAc,MAAM,kBAAkB,CAAC;AAE9G,uDAAuD;AACvD,eAAO,MAAM,IAAI,EAAE,SAAkE,CAAC;AAGtF,gGAAgG;AAChG,eAAO,MAAM,KAAK,EAAE,SAAoD,CAAC;AAEzE,0EAA0E;AAC1E,eAAO,MAAM,SAAS,EAAE,SAAwD,CAAC;AAEjF,4FAA4F;AAC5F,eAAO,MAAM,OAAO,EAAE,SAKrB,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,OAAO,EAAE,SAAuE,CAAC;AAE9F,+EAA+E;AAC/E,eAAO,MAAM,CAAC,EAAE,SAAoD,CAAC;AAGrE,oGAAoG;AACpG,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/views/components.js

@@ -0,0 +1,33 @@
+/** The tags a view is written in: prose blocks and standing rules, rendered to text and to nothing else. */
+import { blocks, renderInline, renderToText } from "./jsx-runtime.js";
+/** One standing rule, on its own line, as a bullet. */
+export const Rule = (props) => `- ${renderInline(children(props)).trim()}`;
+Rule.inline = true;
+/** The rules block: every child on its own line, wrapped so the model can see where it ends. */
+export const Rules = (props) => tagged("rules", lines(props));
+/** The protocols block: how the agent behaves whatever the state says. */
+export const Protocols = (props) => tagged("protocols", lines(props));
+/** A titled part of the prompt: the title as a heading, then the children as paragraphs. */
+export const Section = (props) => {
+    const body = renderToText(children(props));
+    const title = String(props["title"] ?? "").trim();
+    if (!title)
+        return body;
+    return body ? `## ${title}\n\n${body}` : `## ${title}`;
+};
+/** A worked example, wrapped so the model reads it as an example and not as an instruction. */
+export const Example = (props) => tagged("example", renderToText(children(props)));
+/** A paragraph, for a view that prefers the component to the lowercase tag. */
+export const p = (props) => renderInline(children(props));
+p.inline = true;
+/** A body wrapped in the tag the model reads it under, or nothing at all when the body is empty. */
+export function tagged(name, body) {
+    return body ? `<${name}>\n${body}\n</${name}>` : "";
+}
+function children(props) {
+    return (props["children"] ?? null);
+}
+function lines(props) {
+    return blocks(children(props)).join("\n");
+}
+//# sourceMappingURL=components.js.map

package/dist/views/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../src/views/components.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAE5G,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAA0C,MAAM,kBAAkB,CAAC;AAE9G,uDAAuD;AACvD,MAAM,CAAC,MAAM,IAAI,GAAc,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AACtF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;AAEnB,gGAAgG;AAChG,MAAM,CAAC,MAAM,KAAK,GAAc,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAEzE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAc,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAEjF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,OAAO,GAAc,CAAC,KAAK,EAAE,EAAE;IAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;AACzD,CAAC,CAAC;AAEF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,OAAO,GAAc,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE9F,+EAA+E;AAC/E,MAAM,CAAC,MAAM,CAAC,GAAc,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;AAEhB,oGAAoG;AACpG,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAY;IAC/C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,IAAI,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAY;IAC5B,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,CAAU,CAAC;AAC9C,CAAC;AAED,SAAS,KAAK,CAAC,KAAY;IACzB,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/views/jsx-dev-runtime.d.ts

@@ -0,0 +1,3 @@
+/** The dev runtime: the same text factory under the name a dev-mode JSX transform imports. */
+export * from "./jsx-runtime.js";
+//# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/dist/views/jsx-dev-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.d.ts","sourceRoot":"","sources":["../../src/views/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAI9F,cAAc,kBAAkB,CAAC"}

package/dist/views/jsx-dev-runtime.js

@@ -0,0 +1,5 @@
+/** The dev runtime: the same text factory under the name a dev-mode JSX transform imports. */
+// One re-export and no second implementation: a dev build and a prod build of the same prompt
+// must not be able to differ. `jsxDEV` is already an alias of `jsx` next door.
+export * from "./jsx-runtime.js";
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/views/jsx-dev-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.js","sourceRoot":"","sources":["../../src/views/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F,8FAA8F;AAC9F,+EAA+E;AAC/E,cAAc,kBAAkB,CAAC"}

package/dist/views/jsx-runtime.d.ts

@@ -0,0 +1,49 @@
+/** The JSX runtime: elements become a small tree and the tree renders to TEXT, never to DOM. */
+/** Anything a component may hand back; arrays and falsy values are part of the language. */
+export type Child = Element | string | number | boolean | null | undefined | Child[];
+export type Props = Record<string, unknown>;
+/** A component is a function from props to text — the only kind of tag that carries behaviour. */
+export interface Component {
+    (props: Props): Child;
+    /** Rendered on one line inside its parent instead of as its own paragraph. */
+    inline?: boolean;
+}
+/** The whole tree: a tag and its props. `children` lives in props, as the automatic runtime says. */
+export interface Element {
+    readonly kind: "element";
+    readonly type: string | Component | typeof Fragment;
+    readonly props: Props;
+}
+/** The empty tag: `<>…</>` groups siblings without adding anything of its own to the text. */
+export declare const Fragment: unique symbol;
+/** The automatic runtime's element factory; `jsxs` is the same function with many children. */
+export declare function jsx(type: Element["type"], props: Props): Element;
+export { jsx as jsxs, jsx as jsxDEV };
+/**
+ * One child rendered inline: strings keep their inner spacing exactly as written, because
+ * `{name} tiene cita el {day}` is a sentence whose spaces are the author's.
+ */
+export declare function renderInline(child: Child): string;
+/**
+ * One child rendered as a block: siblings become paragraphs separated by one blank line,
+ * `null`/`false`/`undefined` render nothing at all, and a bare string is trimmed at its ends.
+ */
+export declare function renderToText(child: Child): string;
+/** Each child as its own block, empties dropped — what a component needs to join them its own way. */
+export declare function blocks(child: Child): string[];
+/** The type-level half of the runtime: what TypeScript looks for behind `jsxImportSource`. */
+type TextElement = Element;
+export declare namespace JSX {
+    type Element = TextElement;
+    /** A tag is a lowercase intrinsic or any function that returns text — never a class. */
+    type ElementType = string | ((props: never) => Child) | Component;
+    interface ElementChildrenAttribute {
+        children: object;
+    }
+    interface IntrinsicElements {
+        p: {
+            children?: Child;
+        };
+    }
+}
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/views/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../../src/views/jsx-runtime.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,4FAA4F;AAC5F,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,EAAE,CAAC;AAErF,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5C,kGAAkG;AAClG,MAAM,WAAW,SAAS;IACxB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qGAAqG;AACrG,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,QAAQ,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED,8FAA8F;AAC9F,eAAO,MAAM,QAAQ,eAAwC,CAAC;AAE9D,+FAA+F;AAC/F,wBAAgB,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAEhE;AAED,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,MAAM,EAAE,CAAC;AAYtC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAQjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEjD;AAED,sGAAsG;AACtG,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAmB7C;AAED,8FAA8F;AAC9F,KAAK,WAAW,GAAG,OAAO,CAAC;AAE3B,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,KAAK,OAAO,GAAG,WAAW,CAAC;IAC3B,wFAAwF;IACxF,KAAK,WAAW,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,GAAG,SAAS,CAAC;IAClE,UAAU,wBAAwB;QAChC,QAAQ,EAAE,MAAM,CAAC;KAClB;IACD,UAAU,iBAAiB;QACzB,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,KAAK,CAAA;SAAE,CAAC;KACzB;CACF"}

package/dist/views/jsx-runtime.js

@@ -0,0 +1,67 @@
+/** The JSX runtime: elements become a small tree and the tree renders to TEXT, never to DOM. */
+/** The empty tag: `<>…</>` groups siblings without adding anything of its own to the text. */
+export const Fragment = Symbol.for("pinecall.views.fragment");
+/** The automatic runtime's element factory; `jsxs` is the same function with many children. */
+export function jsx(type, props) {
+    return { kind: "element", type, props: props ?? {} };
+}
+export { jsx as jsxs, jsx as jsxDEV };
+function childrenOf(props) {
+    return (props["children"] ?? null);
+}
+// A paragraph is one line of prose: the newlines and indentation JSX left in the source are not
+// content, so they collapse to single spaces, and the whole thing is trimmed at both ends.
+function paragraph(text) {
+    return text.replace(/\s*\n\s*/g, " ").replace(/[ \t]{2,}/g, " ").trim();
+}
+/**
+ * One child rendered inline: strings keep their inner spacing exactly as written, because
+ * `{name} tiene cita el {day}` is a sentence whose spaces are the author's.
+ */
+export function renderInline(child) {
+    if (child === null || child === undefined || typeof child === "boolean")
+        return "";
+    if (typeof child === "string")
+        return child;
+    if (typeof child === "number")
+        return String(child);
+    if (Array.isArray(child))
+        return child.map(renderInline).join("");
+    const { type, props } = child;
+    if (typeof type === "function")
+        return renderInline(type(props));
+    return renderInline(childrenOf(props));
+}
+/**
+ * One child rendered as a block: siblings become paragraphs separated by one blank line,
+ * `null`/`false`/`undefined` render nothing at all, and a bare string is trimmed at its ends.
+ */
+export function renderToText(child) {
+    return blocks(child).join("\n\n");
+}
+/** Each child as its own block, empties dropped — what a component needs to join them its own way. */
+export function blocks(child) {
+    if (child === null || child === undefined || typeof child === "boolean")
+        return [];
+    if (typeof child === "string")
+        return child.trim() ? [child.trim()] : [];
+    if (typeof child === "number")
+        return [String(child)];
+    if (Array.isArray(child))
+        return child.flatMap(blocks);
+    const { type, props } = child;
+    if (typeof type === "function") {
+        if (type.inline) {
+            const line = paragraph(renderInline(child));
+            return line ? [line] : [];
+        }
+        return blocks(type(props));
+    }
+    // The one intrinsic tag: `<p>` is a paragraph. Every other lowercase tag is its children.
+    if (type === "p") {
+        const line = paragraph(renderInline(childrenOf(props)));
+        return line ? [line] : [];
+    }
+    return blocks(childrenOf(props));
+}
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/views/jsx-runtime.js.map

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

package/dist/views/lang.d.ts

@@ -0,0 +1,17 @@
+/** The framework's own words: the standing rules and the protocols, in the agent's `language`. */
+/** The two blocks the framework contributes to every prompt, in one language. */
+export interface Words {
+    rules: string;
+    protocols: string;
+}
+/** The default language, and the one an unknown `language` falls back to. */
+export declare const DEFAULT_LANGUAGE = "es";
+/**
+ * The framework's words for this agent: `language` is a config field, so it is read off the
+ * instance and never off the state. A language we do not speak yet falls back to the default
+ * rather than leaving the model with no rules at all.
+ */
+export declare function wordsFor(agent: object): Words;
+/** The languages the framework has words for, for a test that wants to walk them all. */
+export declare function languages(): string[];
+//# sourceMappingURL=lang.d.ts.map

package/dist/views/lang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang.d.ts","sourceRoot":"","sources":["../../src/views/lang.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAElG,iFAAiF;AACjF,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AA+BD,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAI7C;AAED,yFAAyF;AACzF,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC"}

package/dist/views/lang.js

@@ -0,0 +1,46 @@
+/** The framework's own words: the standing rules and the protocols, in the agent's `language`. */
+// These are the framework's words, identical for every agent and every turn of a call, which is
+// exactly why they belong in the cached region — and why they are a table and not a template.
+const WORDS = {
+    es: {
+        rules: [
+            "- No inventes ningún dato: lo que no salga de una herramienta o del conocimiento, no lo digas.",
+            "- Una sola pregunta por turno, y espera la respuesta.",
+            "- Habla como una persona al teléfono: frases cortas, sin listas ni markdown.",
+        ].join("\n"),
+        protocols: [
+            "- Para actuar usa una herramienta; decir que has hecho algo no lo hace.",
+            "- Antes de una acción irreversible lee en voz alta lo que vas a hacer y espera un sí explícito.",
+            "- Si no puedes resolverlo, dilo y ofrece pasar con una persona.",
+        ].join("\n"),
+    },
+    en: {
+        rules: [
+            "- Invent nothing: if it did not come from a tool or from the knowledge, do not say it.",
+            "- One question per turn, and wait for the answer.",
+            "- Talk like a person on the phone: short sentences, no lists, no markdown.",
+        ].join("\n"),
+        protocols: [
+            "- To act, call a tool; saying you have done something does not do it.",
+            "- Before an irreversible action read back what you are about to do and wait for an explicit yes.",
+            "- If you cannot solve it, say so and offer to hand over to a person.",
+        ].join("\n"),
+    },
+};
+/** The default language, and the one an unknown `language` falls back to. */
+export const DEFAULT_LANGUAGE = "es";
+/**
+ * The framework's words for this agent: `language` is a config field, so it is read off the
+ * instance and never off the state. A language we do not speak yet falls back to the default
+ * rather than leaving the model with no rules at all.
+ */
+export function wordsFor(agent) {
+    const configured = agent.language;
+    const code = (configured ?? DEFAULT_LANGUAGE).toLowerCase().split(/[-_]/)[0] ?? DEFAULT_LANGUAGE;
+    return WORDS[code] ?? WORDS[DEFAULT_LANGUAGE];
+}
+/** The languages the framework has words for, for a test that wants to walk them all. */
+export function languages() {
+    return Object.keys(WORDS);
+}
+//# sourceMappingURL=lang.js.map

package/dist/views/lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang.js","sourceRoot":"","sources":["../../src/views/lang.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAQlG,gGAAgG;AAChG,8FAA8F;AAC9F,MAAM,KAAK,GAA0B;IACnC,EAAE,EAAE;QACF,KAAK,EAAE;YACL,gGAAgG;YAChG,uDAAuD;YACvD,8EAA8E;SAC/E,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,SAAS,EAAE;YACT,yEAAyE;YACzE,iGAAiG;YACjG,iEAAiE;SAClE,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;IACD,EAAE,EAAE;QACF,KAAK,EAAE;YACL,wFAAwF;YACxF,mDAAmD;YACnD,4EAA4E;SAC7E,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,SAAS,EAAE;YACT,uEAAuE;YACvE,kGAAkG;YAClG,sEAAsE;SACvE,CAAC,IAAI,CAAC,IAAI,CAAC;KACb;CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,MAAM,UAAU,GAAI,KAA+B,CAAC,QAAQ,CAAC;IAC7D,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC;IACjG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAE,CAAC;AACjD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS;IACvB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/views/layout.d.ts

@@ -0,0 +1,19 @@
+/** The prompt as named blocks in two regions, in the one order they are sent: static · the history · dynamic. */
+import type { PromptBlockSpec } from "@pinecall/protocol";
+import { type Agent } from "../agent/agent.js";
+/** One block of the prompt as this render produced it: its name, its region, and its text. */
+export interface Block extends PromptBlockSpec {
+    text: string;
+}
+/** The prompt, cut where the cache is cut: only a `dynamic` block may differ between two turns. */
+export interface Blocks {
+    /** Every block, in send order: the static ones, then — after the history — the dynamic one. */
+    blocks: Block[];
+    /** The history is the runtime's. This is only what a `collapse()` left in it, for the printed page. */
+    history: string;
+}
+/** Every block of the prompt, by name and region, in the one order they are sent. */
+export declare const PROMPT_BLOCKS: readonly PromptBlockSpec[];
+/** The whole prompt, block by block in send order: this is what `promptOf(agent)` is. */
+export declare function layout(agent: Agent): Blocks;
+//# sourceMappingURL=layout.d.ts.map

package/dist/views/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/views/layout.ts"],"names":[],"mappings":"AAAA,iHAAiH;AAEjH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAMxD,8FAA8F;AAC9F,MAAM,WAAW,KAAM,SAAQ,eAAe;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mGAAmG;AACnG,MAAM,WAAW,MAAM;IACrB,+FAA+F;IAC/F,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD,qFAAqF;AACrF,eAAO,MAAM,aAAa,EAAE,SAAS,eAAe,EAAyD,CAAC;AAE9G,yFAAyF;AACzF,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAG3C"}

package/dist/views/layout.js

@@ -0,0 +1,62 @@
+/** The prompt as named blocks in two regions, in the one order they are sent: static · the history · dynamic. */
+import { changes } from "../agent/agent.js";
+import { docOf, toolsOf } from "../agent/tools.js";
+import { tagged } from "./components.js";
+import { wordsFor } from "./lang.js";
+import { renderToText } from "./jsx-runtime.js";
+// The whole prompt, in the one order it is sent, each block beside whoever writes it. Everything
+// the class says about itself is static and cached; the view is the whole dynamic region and the
+// LAST thing the model reads, so what the state says about this turn is never buried under the
+// history. The layout is the framework's: a class contributes the view and nothing else.
+const BLOCKS = [
+    { name: "identity", region: "static", text: identityBlock },
+    // The knowledge file travels whole in the declaration — `runtime/grounding.ts` reads it beside
+    // the class and sends `{path, text}` — and the runtime writes its text into this block, once per
+    // call, where it is the operator's own words in the cached prefix. The app sends nothing for it:
+    // this package never opens the file on a render, and the same file twice is a worse bug than an
+    // empty block.
+    { name: "knowledge", region: "static", text: () => "" },
+    { name: "tools", region: "static", text: toolsBlock },
+    { name: "view", region: "dynamic", text: viewBlock },
+];
+/** Every block of the prompt, by name and region, in the one order they are sent. */
+export const PROMPT_BLOCKS = BLOCKS.map(({ name, region }) => ({ name, region }));
+/** The whole prompt, block by block in send order: this is what `promptOf(agent)` is. */
+export function layout(agent) {
+    const blocks = BLOCKS.map(({ name, region, text }) => ({ name, region, text: text(agent) }));
+    return { blocks, history: collapsedHistory(agent) };
+}
+/** Who the agent is: the class docstring, the standing rules and the protocols. Cached; reads no state. */
+function identityBlock(agent) {
+    const words = wordsFor(agent);
+    return paragraphs([docOf(agent) ?? "", tagged("rules", words.rules), tagged("protocols", words.protocols)]);
+}
+// Every tool the class declares, visible right now or not: see docs/decisions/views.md. The model
+// reads the docstring, never the JSON schema — the schema is what the wire carries.
+function toolsBlock(agent) {
+    const docs = toolsOf(agent)
+        .map((declared) => `- ${declared.name}: ${declared.spec.description}`)
+        .join("\n");
+    return tagged("tools", docs);
+}
+// The view: what the class's own `render()` says about this turn, and nothing else. All of it is
+// the tenant's words, which is why nothing that came from outside the conversation is spliced into
+// it — a recalled fact and a retrieved chunk reach the model as tool results, where they belong
+// (the runtime's docs/security/prompt-injection.md).
+function viewBlock(agent) {
+    return renderToText(agent.render());
+}
+/**
+ * What the framework knows of the history: the runtime owns the turns, so this is only the
+ * summaries a `collapse()` left where a stretch of the call used to be.
+ */
+function collapsedHistory(agent) {
+    return changes(agent)
+        .filter((change) => change.field === "@summary")
+        .map((change) => String(change.next))
+        .join("\n\n");
+}
+function paragraphs(parts) {
+    return parts.filter((part) => part.trim()).join("\n\n");
+}
+//# sourceMappingURL=layout.js.map

package/dist/views/layout.js.map

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