@graview/tools 0.1.0

package/dist/intelligence.js

@@ -0,0 +1,463 @@
+import { argShape, formFields, labelOf, nodeRefArgs, } from "@graview/core";
+/**
+ * THE FIRST WHOLE JSON OBJECT IN AN ANSWER, or nothing.
+ *
+ * Models fence code, apologise first, explain afterwards and — often
+ * enough to matter — close one brace too many. Taking everything between
+ * the first `{` and the last `}` swallowed the extra, `JSON.parse` threw,
+ * and the caller fell back to showing the person the raw answer: a chat
+ * bubble containing `{"say": "Yes", "proposals": [...]}}`, which is the
+ * seat handing over its own plumbing.
+ *
+ * Scanning for the BALANCED close instead reads the object the model meant
+ * and ignores whatever it typed after it. Strings and their escapes are
+ * respected, or a brace inside a description ends the object early.
+ */
+export function firstJsonObject(answer) {
+    /*
+     * EITHER SHAPE THE MODEL ACTUALLY USES.
+     *
+     * Asked for `{"say", "proposals"}`, a model answers with the bare ARRAY
+     * of proposals often enough to matter — the sibling seam on this very
+     * contract asks for exactly that — and reading from the first `{` found
+     * the first PROPOSAL inside the array, returned it as the whole answer,
+     * and left the person looking at "…" with a perfectly good list thrown
+     * away. Whichever bracket opens first is the value the model meant.
+     */
+    const object = answer.indexOf("{");
+    const array = answer.indexOf("[");
+    const start = array !== -1 && (object === -1 || array < object) ? array : object;
+    if (start === -1)
+        return undefined;
+    const opener = answer[start];
+    const closer = opener === "[" ? "]" : "}";
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let at = start; at < answer.length; at++) {
+        const char = answer[at];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (char === "\\")
+                escaped = true;
+            else if (char === '"')
+                inString = false;
+            continue;
+        }
+        if (char === '"')
+            inString = true;
+        else if (char === opener)
+            depth += 1;
+        else if (char === closer) {
+            depth -= 1;
+            if (depth === 0) {
+                try {
+                    return JSON.parse(answer.slice(start, at + 1));
+                }
+                catch {
+                    return undefined;
+                }
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * A NAME IS NOT AN ID, and a model will hand you a name.
+ *
+ * Asked to add a field to Meal, a model answers `{"kind": "Meal"}` — the
+ * word on the screen rather than the node's id — and the store refuses it
+ * for the arguments, in zod's words, under a struck-through line. That is
+ * a lookup, not a guess: where EXACTLY ONE node of a kind the argument
+ * accepts carries that label, the label means that node. Where two do, or
+ * none, the value is left exactly as it came and the form asks.
+ */
+export function resolveProposal(store, proposal) {
+    let mutation;
+    try {
+        mutation = store.mutation(proposal.mutation);
+    }
+    catch {
+        return proposal;
+    }
+    const args = { ...proposal.args };
+    let moved = false;
+    for (const field of formFields(mutation.input)) {
+        if (field.control !== "node")
+            continue;
+        const said = args[field.name];
+        if (typeof said !== "string" || said.length === 0)
+            continue;
+        if (store.graph.getNode(said))
+            continue;
+        const wanted = said.trim().toLowerCase();
+        const found = [...store.graph.allNodes()].filter((node) => (field.kinds.includes("*") || field.kinds.includes(node.kind)) &&
+            labelOf(store.schema.tryDefinition(node.kind), node).trim().toLowerCase() === wanted);
+        if (found.length === 1) {
+            args[field.name] = found[0].id;
+            moved = true;
+        }
+    }
+    return moved ? { ...proposal, args } : proposal;
+}
+/** A proposal as the store's own call shape, ready for apply/preview. */
+export function toCall(proposal) {
+    return { name: proposal.mutation, args: { ...proposal.args } };
+}
+/**
+ * WHAT THE GATE TOOK OUT, AND WHY — so a seat can say so.
+ *
+ * `validateProposals` drops silently, which is right for a provider filling
+ * the inspector and wrong for a conversation: a model that answers "Sure"
+ * and names `add_field` on an app whose act is `add-field` left a person
+ * looking at a sentence with nothing under it and no way to know why. The
+ * seat can only say what it is told.
+ */
+export function droppedProposals(store, proposals, may) {
+    const allowed = may === undefined ? null : new Set(may);
+    const out = [];
+    for (const proposal of proposals) {
+        if (typeof proposal.mutation !== "string")
+            continue;
+        let known = true;
+        try {
+            store.mutation(proposal.mutation);
+        }
+        catch {
+            known = false;
+        }
+        if (!known)
+            out.push({ proposal, why: "unknown" });
+        else if (allowed && !allowed.has(proposal.mutation))
+            out.push({ proposal, why: "not-allowed" });
+    }
+    return out;
+}
+/** Drops proposals naming unknown or disallowed mutations, with no guessing. */
+export function validateProposals(store, proposals, may) {
+    const allowed = may === undefined ? null : new Set(may);
+    return proposals.filter((proposal) => {
+        if (typeof proposal.mutation !== "string")
+            return false;
+        if (allowed && !allowed.has(proposal.mutation))
+            return false;
+        try {
+            store.mutation(proposal.mutation);
+        }
+        catch {
+            return false;
+        }
+        return proposal.args !== null && typeof proposal.args === "object";
+    });
+}
+/**
+ * An LLM as a provider: the model reads a compact statement of the
+ * declaration and the current trouble, and answers with calls to declared
+ * mutations. Vendor-neutral by construction — the adapter is one async
+ * function, so claude/openai/local are one line each in the host.
+ */
+export function llmIntelligence(options) {
+    return {
+        name: options.name,
+        ...(options.may ? { may: options.may } : {}),
+        async propose(store) {
+            const kinds = store.schema.kinds
+                .map((kind) => {
+                const definition = store.schema.tryDefinition(kind);
+                const count = store.graph.nodesOfKind(kind).length;
+                return `- ${kind} (${definition?.plural ?? `${kind}s`}, ${count} present): ${definition?.description ?? ""}`;
+            })
+                .join("\n");
+            const mutations = store
+                .allMutations()
+                .map((mutation) => `- ${mutation.name}: ${mutation.description ?? mutation.title ?? ""}`)
+                .join("\n");
+            const trouble = store
+                .violations()
+                .map((violation) => `- ${violation.message}`)
+                .join("\n");
+            const prompt = [
+                "You are proposing changes to a typed context graph.",
+                "Kinds:",
+                kinds,
+                "Mutations you may call:",
+                mutations,
+                trouble ? `Currently broken:\n${trouble}` : "Nothing is currently broken.",
+                'Answer ONLY a JSON array of {"mutation": string, "args": object, "why": string}.',
+            ].join("\n\n");
+            const answer = await options.complete(prompt);
+            const match = answer.match(/\[[\s\S]*\]/);
+            if (!match)
+                return [];
+            let parsed;
+            try {
+                parsed = JSON.parse(match[0]);
+            }
+            catch {
+                return [];
+            }
+            if (!Array.isArray(parsed))
+                return [];
+            return validateProposals(store, parsed, options.may);
+        },
+    };
+}
+/**
+ * Starter data FROM THE DECLARATION ALONE — the intelligence an empty app
+ * has before any key exists. For each mutation that creates a kind with no
+ * members yet, synthesise honest arguments off the derived form: sample
+ * text, today's date, a bounded number, the first choice. Anything needing
+ * a node that does not exist is left for the next round rather than faked.
+ */
+export function templateIntelligence(options = {}) {
+    return {
+        name: options.name ?? "starter",
+        async propose(store) {
+            const today = options.today ?? new Date().toISOString().slice(0, 10);
+            const proposals = [];
+            const fill = (field, hint) => {
+                switch (field.control) {
+                    case "text":
+                        // "First gardener", not "First label": the field is almost
+                        // always the thing's name, and the hint is what it names.
+                        return { ok: true, value: `First ${hint ?? field.name}` };
+                    case "date":
+                        return { ok: true, value: field.time ? `${today}T09:00` : today };
+                    case "number":
+                        return { ok: true, value: field.min ?? 1 };
+                    case "boolean":
+                        return { ok: true, value: false };
+                    case "choice":
+                        return field.options?.length
+                            ? { ok: true, value: field.options[0] }
+                            : { ok: false };
+                    case "variant": {
+                        const arm = field.options[0];
+                        if (!arm)
+                            return { ok: false };
+                        const held = { [field.tag]: arm.value };
+                        for (const child of arm.fields) {
+                            const answer = fill(child);
+                            if (!answer.ok && !child.optional)
+                                return { ok: false };
+                            if (answer.ok)
+                                held[child.name] = answer.value;
+                        }
+                        return { ok: true, value: held };
+                    }
+                    case "group": {
+                        const held = {};
+                        for (const child of field.fields) {
+                            const answer = fill(child);
+                            if (!answer.ok && !child.optional)
+                                return { ok: false };
+                            if (answer.ok)
+                                held[child.name] = answer.value;
+                        }
+                        return { ok: true, value: held };
+                    }
+                    default:
+                        return { ok: false };
+                }
+            };
+            for (const mutation of store.allMutations()) {
+                const creates = mutation.creates ?? [];
+                const empty = creates.filter((kind) => store.graph.nodesOfKind(kind).length === 0);
+                if (empty.length === 0)
+                    continue;
+                const args = {};
+                let possible = true;
+                for (const field of formFields(mutation.input)) {
+                    const answer = fill(field, empty[0]);
+                    if (!answer.ok) {
+                        if (!field.optional)
+                            possible = false;
+                        continue;
+                    }
+                    args[field.name] = answer.value;
+                }
+                if (!possible)
+                    continue;
+                proposals.push({
+                    mutation: mutation.name,
+                    args,
+                    why: `nothing of kind ${empty.join(", ")} exists yet`,
+                });
+            }
+            // Repairs whose arguments the violation already decided.
+            for (const violation of store.violations()) {
+                const repair = violation.repairs.find((candidate) => !candidate.missing?.length);
+                if (!repair)
+                    continue;
+                proposals.push({
+                    mutation: repair.mutation,
+                    args: { ...repair.args },
+                    why: violation.message,
+                });
+            }
+            return validateProposals(store, proposals);
+        },
+    };
+}
+/**
+ * An Intelligence as an affordance provider, for the suggestion surfaces.
+ *
+ * `deriveAffordances` is synchronous and a model is not, so the wrapper
+ * answers from a cache keyed to the log length and refreshes in the
+ * background; `notify` tells the host a fresh answer landed (a re-render
+ * re-derives). Every suggestion says which provider and why, and applies
+ * through the ordinary path — previewable, attributed, undoable.
+ */
+export function intelligenceProvider(intelligence, hooks = {}) {
+    let version = -1;
+    let pending = false;
+    let cached = [];
+    return {
+        name: "llm",
+        derive({ store }) {
+            const now = store.log.all().length;
+            if (now !== version && !pending) {
+                pending = true;
+                void intelligence
+                    .propose(store)
+                    .then((proposals) => {
+                    cached = proposals;
+                    version = now;
+                    hooks.notify?.();
+                })
+                    .catch(() => {
+                    cached = [];
+                    version = now;
+                })
+                    .finally(() => {
+                    pending = false;
+                });
+            }
+            const affordances = cached.map((proposal, index) => {
+                const mutation = store.allMutations().find((m) => m.name === proposal.mutation);
+                return {
+                    id: `llm:${intelligence.name}:${index}`,
+                    label: mutation?.title ?? proposal.mutation,
+                    provider: "llm",
+                    mutation: proposal.mutation,
+                    args: proposal.args,
+                    open: [],
+                    score: 25,
+                    why: `${intelligence.name}: ${proposal.why ?? "suggested"}`,
+                    nodeIds: [],
+                };
+            });
+            return { affordances };
+        },
+    };
+}
+/** Something readable for logs and seats: the provider's own sentence. */
+export function describeProposal(store, proposal) {
+    const mutation = store.allMutations().find((m) => m.name === proposal.mutation);
+    /*
+     * IN THE ACT'S OWN WORDS, when it can say them. "Sow something" under a
+     * proposal that already says sunflower and the back bed is the title of
+     * the menu entry, not the change on offer — and the act's `describe` is
+     * the sentence the activity rail will use once it lands, so the offer
+     * and the record read alike. Only for arguments that would actually
+     * validate: a describe handed half an answer names "undefined". A name
+     * nothing answers to yet — the plot staked out in the same reply — is
+     * still a name, and reads as one.
+     */
+    if (mutation?.describe) {
+        const resolved = resolveProposal(store, proposal);
+        const parsed = mutation.input
+            .safeParse?.(resolved.args);
+        if (parsed?.success) {
+            try {
+                return mutation.describe(parsed.data, store.graph);
+            }
+            catch {
+                // A describe that cannot read this graph falls back to the title.
+            }
+        }
+    }
+    const subject = mutation?.subject?.arg;
+    const id = subject ? proposal.args[subject] : undefined;
+    const node = typeof id === "string" ? store.graph.getNode(id) : undefined;
+    const title = mutation?.title ?? proposal.mutation;
+    return node
+        ? `${title} — ${labelOf(store.schema.tryDefinition(node.kind), node)}`
+        : title;
+}
+/**
+ * WHAT A PROPOSAL HAS NOT SAID YET.
+ *
+ * A responder proposes from the graph and knows nothing of the policy, so
+ * the seat asks the store whether the person may do a thing before offering
+ * it. It knows just as little about the ACT'S OWN ARGUMENTS — a model told
+ * "add a shift called soup kitchen" will happily answer `add-shift` with no
+ * arguments at all, or with the label and none of the day, the place and
+ * the hours. Applied, the store refuses, and what reaches the person is the
+ * validator talking to itself:
+ *
+ *   Refused: Invalid arguments for mutation "add-shift" label: Invalid
+ *   input: expected string, received undefined; on: Invalid input: …
+ *
+ * That is not a refusal, it is a stack trace. The act was never impossible;
+ * it was under-specified, and the framework already knows what to do with
+ * an under-specified act — it asks. A person pressing "Add a shift" from
+ * the menu gets the same questions one at a time, with the graph's own
+ * candidates offered for anything that names a node.
+ *
+ * So: the arguments this proposal still owes, in the shape the ask already
+ * takes. Empty means it is ready to apply.
+ */
+export function stillNeeded(store, proposal) {
+    const mutation = store.allMutations().find((one) => one.name === proposal.mutation);
+    if (!mutation)
+        return [];
+    /*
+     * A NAME IS AN ANSWER ONLY WHEN SOMETHING ANSWERS TO IT. A model names
+     * things the way a person does, and a proposal to sow into "back bed"
+     * made in the same breath as staking it out names a plot that does not
+     * exist yet. Resolved now, it may; unresolved, it is still owed — asked
+     * for with the graph's candidates rather than refused by the store.
+     */
+    proposal = resolveProposal(store, proposal);
+    const shape = mutation.input.shape ?? {};
+    const refs = nodeRefArgs(mutation.input);
+    const owed = [];
+    for (const name of Object.keys(shape)) {
+        if (optionalArg(shape[name]))
+            continue;
+        const given = proposal.args[name];
+        /*
+         * Given means given. A model that answers `""` or `null` for a required
+         * field has not answered it — and the empty string is the common one,
+         * because a model asked for JSON fills every key it was shown.
+         */
+        const ref = refs.find((candidate) => candidate.name === name);
+        const answered = given !== undefined &&
+            given !== null &&
+            given !== "" &&
+            (!ref || typeof given !== "string" || store.graph.getNode(given) !== undefined);
+        if (answered)
+            continue;
+        owed.push({
+            name,
+            ...(ref ? { kinds: ref.kinds } : {}),
+            ...(ref
+                ? {
+                    candidates: ref.kinds.includes("*")
+                        ? store.graph.allNodes().map((node) => node.id)
+                        : ref.kinds.flatMap((kind) => store.graph.nodesOfKind(kind).map((node) => node.id)),
+                }
+                : {}),
+            shape: argShape(mutation.input, name),
+        });
+    }
+    return owed;
+}
+/** Whether an argument may be left out, so it does not count as unanswered. */
+function optionalArg(schema) {
+    const type = schema?._def?.type;
+    return type === "optional" || type === "default" || type === "nullable";
+}
+//# sourceMappingURL=intelligence.js.map

package/dist/intelligence.js.map

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

package/dist/local.d.ts

@@ -0,0 +1,192 @@
+import { type AnySchema, type IntelligenceCapability } from "@graview/core";
+import { type Responder } from "./conversation.js";
+import type { Completion } from "./intelligence.js";
+import { type Decide } from "./providers/jev.js";
+/**
+ * THE INTELLIGENCE LADDER, as configuration a person can climb.
+ *
+ * Four rungs: the graph answers for itself (keyless, always there); a
+ * model runs in the person's own browser (free after the download, and
+ * nothing leaves the machine); a decision provider answers typed questions
+ * exactly and has no prose; a frontier model answers over the network with
+ * the person's own key. The three that talk are the same Responder
+ * contract, and the one that does not says so in its answers — so choosing
+ * a rung is choosing a config value, and whatever answers, its proposals
+ * still travel the one validated path.
+ *
+ * The config is plain serialisable data in the BROWSER's storage, because
+ * an API key belongs to the person at the keyboard: it must never sit in a
+ * repo, a bundle, or a declaration that ships.
+ */
+export type IntelligenceSource = "graph" | "local" | "decision" | "remote";
+export interface IntelligenceConfig {
+    readonly source: IntelligenceSource;
+    readonly local?: {
+        /** A WebLLM model id. The default is small enough to be honest about. */
+        readonly model?: string;
+    };
+    /**
+     * THE DECISION RUNG: a provider that answers typed questions exactly
+     * and has no prose. Reached with the person's own key straight from
+     * this browser, or through the dev server's decision door — which holds
+     * the key on its side, so a browser never does. With neither, the
+     * default is the door at its default path.
+     */
+    readonly decision?: {
+        readonly apiKey?: string;
+        /** The door's path when the key is on the server side. */
+        readonly bridge?: string;
+        readonly model?: string;
+    };
+    readonly remote?: {
+        readonly preset?: "xai" | "custom";
+        /** For `custom`: any OpenAI-compatible /chat/completions endpoint. */
+        readonly baseUrl?: string;
+        readonly apiKey: string;
+        readonly model?: string;
+    };
+}
+export declare const DEFAULT_INTELLIGENCE: IntelligenceConfig;
+/**
+ * FOUR RUNGS, TWO AXES. Each rung says which capabilities it serves; a
+ * surface asks for a capability, never for a rung; and what the chosen
+ * rung cannot serve falls DOWN to the graph, which is keyless and always
+ * there. Pretending the ladder has one axis is how a switch starts lying:
+ * a decision provider is the best rung for a decision and no rung at all
+ * for prose.
+ */
+export declare const RUNGS: Readonly<Record<IntelligenceSource, {
+    readonly label: string;
+    readonly serves: readonly IntelligenceCapability[];
+}>>;
+/**
+ * Which rung answers a capability under this config: the chosen one when
+ * it serves the capability, the graph otherwise — with `fell` saying so,
+ * which is what a seat's honesty sentence is made of.
+ */
+export declare function rungFor(config: IntelligenceConfig, capability: IntelligenceCapability): {
+    readonly rung: IntelligenceSource;
+    readonly fell: boolean;
+};
+/** The sentence a seat says on a rung that cannot talk. Part of the answer, not chrome. */
+export declare function rungHonesty(config: IntelligenceConfig, capability: IntelligenceCapability): string | undefined;
+/** The saved rung, or the keyless default — never a throw. */
+export declare function loadIntelligenceConfig(): IntelligenceConfig;
+export declare function saveIntelligenceConfig(config: IntelligenceConfig): void;
+type FetchLike = (input: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+    signal?: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+}>;
+/**
+ * Any OpenAI-compatible /chat/completions endpoint as one Completion.
+ * The call goes STRAIGHT from the browser to the provider — the key is
+ * sent nowhere else, and there is no relay to trust.
+ */
+export declare function openAiCompatibleCompletion(options: {
+    readonly baseUrl: string;
+    readonly apiKey: string;
+    readonly model: string;
+    /** Injectable for tests. */
+    readonly fetch?: FetchLike;
+}): Completion;
+/** xAI's Grok, as a preset of the same shape. */
+export declare function xaiCompletion(options: {
+    readonly apiKey: string;
+    readonly model?: string;
+    readonly fetch?: FetchLike;
+}): Completion;
+/** What the local rung is doing, for a UI that wants to say so. */
+export interface LocalStatus {
+    readonly state: "cold" | "warming" | "ready" | "failed";
+    /** 0–1 while warming, when the engine reports progress. */
+    readonly progress?: number;
+    readonly detail?: string;
+}
+interface EngineLike {
+    chat: {
+        completions: {
+            create(options: {
+                messages: {
+                    role: string;
+                    content: string;
+                }[];
+            }): Promise<{
+                choices?: {
+                    message?: {
+                        content?: string;
+                    };
+                }[];
+            }>;
+        };
+    };
+}
+export declare function localCompletion(options?: {
+    readonly model?: string;
+    readonly onStatus?: (status: LocalStatus) => void;
+    /** Injectable for tests: replaces the whole engine bring-up. */
+    readonly load?: () => Promise<EngineLike>;
+}): {
+    complete: Completion;
+    ready: () => boolean;
+    warm: () => void;
+};
+/**
+ * THE MODEL BEHIND A RUNG, when the person has chosen one.
+ *
+ * A conversation is not the only thing a model is good for: drawing a
+ * kind's figure is one prompt and one answer, judged by the checker's own
+ * function. Both reach the same configured provider through this, so there
+ * is one place a key is read and one place a rung is honoured — and a
+ * keyless config answers `undefined` rather than a completion that throws,
+ * so a caller can say what it will do INSTEAD of drawing.
+ */
+export declare function completionFor(config: IntelligenceConfig, hooks?: {
+    readonly onStatus?: (status: LocalStatus) => void;
+}): Completion | undefined;
+/**
+ * One Responder from one config. The graph is always the floor: a remote
+ * failure or a cold local model answers from the graph WITH A NOTE rather
+ * than failing the conversation — a chat that errors where it could have
+ * answered is worse than either rung alone.
+ */
+export declare function configuredResponder<S extends AnySchema>(config: IntelligenceConfig, hooks?: {
+    readonly onStatus?: (status: LocalStatus) => void;
+    /**
+     * The rung below every model, when a surface has one of its own. The
+     * studio's floor answers about the DECLARATION — what kinds there are,
+     * what an act writes — which the ordinary graph responder cannot know
+     * to say; passing it here means the studio climbs the same ladder
+     * rather than growing a second one beside it.
+     */
+    readonly floor?: Responder<S>;
+    /**
+     * WHAT THE SETTING IS NOW, asked after the answer lands. A person who
+     * switches rungs while a turn is in flight gets the answer the old
+     * rung was making — and is told so, in the answer, rather than
+     * watching a turn quietly finish on a rung they left.
+     */
+    readonly current?: () => IntelligenceConfig;
+}): Responder<S>;
+/**
+ * THE DECISION BEHIND A RUNG, for a surface that asks for one — a field
+ * that wants filling, a matrix that wants judging. On the decision rung
+ * it is the provider exactly, by the person's key or through the dev
+ * server's door; on a model rung it is the model with the parse-and-refuse
+ * layer behind it; on the graph rung it is nothing here, because the
+ * graph decides by its own rules and needs the store to do it
+ * (`graphDecide`). A surface holding `undefined` falls down to that.
+ */
+export declare function decideFor(config: IntelligenceConfig, hooks?: {
+    readonly onStatus?: (status: LocalStatus) => void;
+}): Decide | undefined;
+/** A word for the header: where answers are coming from right now. */
+export declare function describeIntelligence(config: IntelligenceConfig): string;
+export {};
+//# sourceMappingURL=local.d.ts.map