@x12i/memorix-client-api 0.0.0-stage → 0.17.0

package/dist/shaped-refs.js

@@ -0,0 +1,395 @@
+import { findContentType, findObjectType, } from "./catalog.js";
+import { ApiError, UpstreamError } from "./errors.js";
+import { projectContents } from "./project.js";
+import { scopeBody } from "./scope.js";
+import { asRecord, subjectDirectoryPath } from "./upstream.js";
+const VALUE_LIMIT = 200;
+const NAME_FIELDS = ["displayName", "title", "name"];
+export function shapesInCatalog(catalog) {
+    const seen = new Set();
+    const shapes = [];
+    for (const objectType of catalog) {
+        for (const contentType of objectType.contentTypes) {
+            for (const field of contentType.fields) {
+                for (const shape of field.shapes ?? []) {
+                    const key = JSON.stringify(shape);
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                    shapes.push(shape);
+                }
+            }
+        }
+    }
+    return shapes;
+}
+function grammarMatches(grammar, value) {
+    if (grammar.length > 200 || value.length > 500)
+        return false;
+    let expression;
+    try {
+        expression = new RegExp(grammar);
+    }
+    catch {
+        return false;
+    }
+    const match = expression.exec(value);
+    return Boolean(match && match.index === 0 && match[0] === value);
+}
+function classify(value, shapes) {
+    const shape = shapes.find((item) => grammarMatches(item.grammar, value)) ?? null;
+    return { value, shape };
+}
+/** Object types named by `value` shapes that share a field with this template shape. */
+function relatedRecordTypes(catalog, shape) {
+    const key = JSON.stringify(shape);
+    const types = new Set();
+    for (const objectType of catalog) {
+        for (const contentType of objectType.contentTypes) {
+            for (const field of contentType.fields) {
+                const shapes = field.shapes ?? [];
+                if (!shapes.some((item) => JSON.stringify(item) === key))
+                    continue;
+                for (const other of shapes) {
+                    if (other.resolvesTo.recordId === "value")
+                        types.add(other.resolvesTo.objectType);
+                }
+            }
+        }
+    }
+    return [...types];
+}
+function modeOf(shape) {
+    if (shape.resolvesTo.recordId === "value")
+        return "value";
+    if (shape.resolvesTo.recordId.startsWith("paired-"))
+        return "paired";
+    return "template";
+}
+function templateRecordId(template, value) {
+    return template.replaceAll("{value}", value);
+}
+/** Content types any shape says to read for this object type, plus the ones this token asked for. */
+function expandContentTypes(catalog, objectType, requested) {
+    const ids = new Set(requested);
+    for (const shape of shapesInCatalog(catalog)) {
+        if (shape.resolvesTo.objectType !== objectType)
+            continue;
+        for (const id of shape.resolvesTo.contentTypes)
+            ids.add(id);
+    }
+    return [...ids];
+}
+function contentTypesFor(catalog, objectType, requested) {
+    const view = findObjectType(catalog, objectType);
+    if (!view)
+        return [];
+    const known = new Set(view.contentTypes.map((item) => item.id));
+    const listed = requested.filter((id) => id !== "relationships" && known.has(id));
+    return listed.length > 0 ? listed : [];
+}
+function publishes(data, token, property) {
+    const record = asRecord(data);
+    if (!record)
+        return false;
+    const names = new Set(NAME_FIELDS);
+    if (property) {
+        names.add(property);
+        if (property.endsWith("Id"))
+            names.add(`${property.slice(0, -2)}Ids`);
+    }
+    for (const name of names) {
+        const value = record[name];
+        if (value === token)
+            return true;
+        if (Array.isArray(value) && value.some((item) => item === token))
+            return true;
+    }
+    return false;
+}
+function subjectPublishes(subject, token, property) {
+    const contents = asRecord(subject.contents);
+    if (!contents)
+        return false;
+    for (const list of Object.values(contents)) {
+        if (!Array.isArray(list))
+            continue;
+        for (const item of list) {
+            const data = asRecord(item)?.data ?? (asRecord(asRecord(item)?.json)?.data);
+            if (publishes(data, token, property))
+                return true;
+        }
+    }
+    return false;
+}
+function storedName(subject) {
+    const contents = asRecord(subject.contents);
+    if (!contents)
+        return null;
+    for (const list of Object.values(contents)) {
+        if (!Array.isArray(list))
+            continue;
+        for (const item of list) {
+            const data = asRecord(item)?.data ?? asRecord(asRecord(item)?.json)?.data;
+            const record = asRecord(data);
+            if (!record)
+                continue;
+            for (const key of NAME_FIELDS) {
+                const value = record[key];
+                if (typeof value === "string" && value.trim())
+                    return value.trim();
+            }
+        }
+    }
+    return null;
+}
+function remember(matched, property, token) {
+    if (!property || matched[property])
+        return;
+    matched[property] = token;
+}
+async function loadContents(upstream, scope, recordId, contentTypes) {
+    if (contentTypes.length === 0)
+        return {};
+    try {
+        const composed = asRecord(await upstream.post("/api/data/compose", scope, {
+            explicit: true,
+            recordId,
+            contentTypes,
+        }));
+        return asRecord(asRecord(composed?.composition)?.contents) ?? {};
+    }
+    catch (err) {
+        if (err instanceof UpstreamError)
+            return null;
+        throw err;
+    }
+}
+async function reserved(upstream, scope, recordId, objectType) {
+    try {
+        const body = asRecord(await upstream.get(subjectDirectoryPath(recordId), scope));
+        return body?.recordId === recordId && body.objectType === objectType;
+    }
+    catch (err) {
+        if (err instanceof UpstreamError)
+            return false;
+        throw err;
+    }
+}
+async function loadSubject(upstream, scope, catalog, recordId, objectType, requestedTypes) {
+    const view = findObjectType(catalog, objectType);
+    if (!view)
+        return null;
+    if (!(await reserved(upstream, scope, recordId, objectType)))
+        return null;
+    const contentTypes = contentTypesFor(catalog, objectType, expandContentTypes(catalog, objectType, requestedTypes));
+    const contents = await loadContents(upstream, scope, recordId, contentTypes);
+    if (contents === null)
+        return null;
+    return { objectType, recordId, contentTypes, contents, matched: {} };
+}
+async function recordsByField(upstream, scope, objectType, contentType, field, value) {
+    const params = new URLSearchParams({
+        objectType,
+        contentType,
+        limit: "50",
+        filter: JSON.stringify([{ field, op: "in", value: [value] }]),
+    });
+    try {
+        const body = asRecord(await upstream.get(`/api/data/content?${params.toString()}`, scope));
+        const records = Array.isArray(body?.records) ? body.records : [];
+        const ids = [];
+        for (const item of records) {
+            const recordId = asRecord(item)?.recordId;
+            if (typeof recordId === "string" && recordId && !ids.includes(recordId))
+                ids.push(recordId);
+        }
+        return ids;
+    }
+    catch (err) {
+        if (err instanceof UpstreamError)
+            return [];
+        throw err;
+    }
+}
+function fieldsNamed(view, property) {
+    const found = [];
+    for (const contentType of view.contentTypes) {
+        if (contentType.id === "relationships")
+            continue;
+        for (const field of contentType.fields) {
+            const leaf = field.path.split(".").pop();
+            if (leaf === property || leaf === `${property}[]`)
+                found.push({ contentType: contentType.id, path: field.path.replace(/\[\]$/, "") });
+        }
+    }
+    return found;
+}
+function projectLoaded(catalog, subject) {
+    const view = findObjectType(catalog, subject.objectType);
+    const fieldMap = new Map();
+    for (const contentType of subject.contentTypes) {
+        fieldMap.set(contentType, view ? (findContentType(view, contentType)?.fields ?? []) : []);
+    }
+    return {
+        displayName: storedName(subject),
+        contents: projectContents(subject.contents, fieldMap, "json", "record"),
+    };
+}
+async function loadByFields(upstream, scope, catalog, token, properties, take) {
+    if (properties.length === 0)
+        return false;
+    let found = false;
+    for (const view of catalog) {
+        const fields = new Map();
+        for (const property of properties) {
+            for (const field of fieldsNamed(view, property))
+                fields.set(`${field.contentType}\0${field.path}`, field);
+        }
+        for (const field of fields.values()) {
+            const ids = await recordsByField(upstream, scope, view.id, field.contentType, field.path, token);
+            for (const id of ids.slice(0, 5)) {
+                if (await take(id, view.id, [field.contentType]))
+                    found = true;
+            }
+        }
+    }
+    return found;
+}
+export async function resolveRefValues(upstream, scope, catalog, values) {
+    const shapes = shapesInCatalog(catalog);
+    const tokens = values.map((value) => classify(value, shapes));
+    const subjects = [];
+    const index = new Map();
+    const directKeys = new Set();
+    const consumed = new Set();
+    async function take(recordId, objectType, contentTypes) {
+        const key = `${objectType}\0${recordId}`;
+        const existing = index.get(key);
+        if (existing)
+            return existing;
+        const loaded = await loadSubject(upstream, scope, catalog, recordId, objectType, contentTypes);
+        if (!loaded)
+            return null;
+        index.set(key, loaded);
+        subjects.push(loaded);
+        return loaded;
+    }
+    for (let position = 0; position < tokens.length; position += 1) {
+        const token = tokens[position];
+        if (!token.shape || modeOf(token.shape) !== "value")
+            continue;
+        const loaded = await take(token.value, token.shape.resolvesTo.objectType, token.shape.resolvesTo.contentTypes);
+        if (!loaded)
+            continue;
+        directKeys.add(`${loaded.objectType}\0${loaded.recordId}`);
+        remember(loaded.matched, token.shape.sourceProperty, token.value);
+        consumed.add(position);
+    }
+    for (let position = 0; position < tokens.length; position += 1) {
+        const token = tokens[position];
+        if (!token.shape || modeOf(token.shape) !== "paired")
+            continue;
+        const pairProperty = token.shape.resolvesTo.recordId.slice("paired-".length);
+        const matchProperty = token.shape.resolvesTo.matchProperty;
+        let host = subjects.find((subject) => subject.objectType === token.shape.resolvesTo.objectType &&
+            subject.matched[pairProperty] &&
+            (!matchProperty || subjectPublishes(subject, token.value, matchProperty)));
+        if (!host) {
+            const view = findObjectType(catalog, token.shape.resolvesTo.objectType);
+            const property = matchProperty ?? token.shape.sourceProperty;
+            if (view && property) {
+                for (const field of fieldsNamed(view, property)) {
+                    const ids = await recordsByField(upstream, scope, view.id, field.contentType, field.path, token.value);
+                    if (ids.length !== 1)
+                        continue;
+                    host = (await take(ids[0], view.id, token.shape.resolvesTo.contentTypes)) ?? undefined;
+                    if (host)
+                        break;
+                }
+            }
+        }
+        if (!host)
+            continue;
+        remember(host.matched, token.shape.sourceProperty, token.value);
+        consumed.add(position);
+    }
+    for (let position = 0; position < tokens.length; position += 1) {
+        const token = tokens[position];
+        if (!token.shape || modeOf(token.shape) !== "template")
+            continue;
+        const hosts = subjects.filter((subject) => subjectPublishes(subject, token.value, token.shape?.sourceProperty));
+        if (hosts.length > 0) {
+            for (const host of hosts)
+                remember(host.matched, token.shape.sourceProperty, token.value);
+            consumed.add(position);
+            continue;
+        }
+        const objectType = token.shape.resolvesTo.objectType;
+        const recordId = templateRecordId(token.shape.resolvesTo.recordId, token.value);
+        if (findObjectType(catalog, objectType)) {
+            const loaded = await take(recordId, objectType, token.shape.resolvesTo.contentTypes);
+            if (loaded) {
+                remember(loaded.matched, token.shape.sourceProperty, token.value);
+                consumed.add(position);
+                continue;
+            }
+        }
+        // A batch that already resolved record ids keeps unmatched template tokens unresolved.
+        // Searching the catalog is for a token that arrived on its own.
+        if (directKeys.size > 0)
+            continue;
+        const property = token.shape.sourceProperty;
+        const propertyNames = property
+            ? [property, ...(property.endsWith("Id") ? [`${property.slice(0, -2)}Ids`] : [])]
+            : [];
+        const related = relatedRecordTypes(catalog, token.shape);
+        const views = related.length > 0 ? catalog.filter((view) => related.includes(view.id)) : catalog;
+        const byProperty = await loadByFields(upstream, scope, views, token.value, propertyNames, take);
+        const loadedAny = byProperty ||
+            (await loadByFields(upstream, scope, catalog, token.value, [...NAME_FIELDS], take));
+        if (loadedAny) {
+            const attached = subjects.filter((subject) => subjectPublishes(subject, token.value, property));
+            for (const host of attached)
+                remember(host.matched, property, token.value);
+            consumed.add(position);
+        }
+    }
+    const unresolved = tokens.filter((_, position) => !consumed.has(position)).map((token) => token.value);
+    return {
+        subjects: subjects.map((subject) => {
+            const projected = projectLoaded(catalog, subject);
+            return {
+                objectType: subject.objectType,
+                recordId: subject.recordId,
+                displayName: projected.displayName,
+                contentTypes: subject.contentTypes,
+                matched: subject.matched,
+                contents: projected.contents,
+            };
+        }),
+        unresolved,
+    };
+}
+function valuesOf(body) {
+    const record = asRecord(body);
+    const values = record?.values;
+    if (!Array.isArray(values) || values.some((item) => typeof item !== "string")) {
+        throw new ApiError(400, "VALIDATION", "values must be an array of strings");
+    }
+    const trimmed = values.map((item) => item.trim()).filter(Boolean);
+    if (trimmed.length > VALUE_LIMIT) {
+        throw new ApiError(400, "VALIDATION", `values exceeds ${VALUE_LIMIT}`);
+    }
+    return trimmed;
+}
+export function registerRefRoutes(app, options) {
+    app.post("/api/v1/refs/resolve", async (req) => {
+        const scope = await options.scopeFor(req);
+        const values = valuesOf(req.body);
+        const catalog = await options.loadCatalog(options.upstream, scope);
+        const resolved = await resolveRefValues(options.upstream, scope, catalog, values);
+        return { scope: scopeBody(scope), ...resolved };
+    });
+}
+//# sourceMappingURL=shaped-refs.js.map

package/dist/shaped-refs.js.map

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

package/dist/skills.d.ts

@@ -0,0 +1,102 @@
+import type { FastifyInstance, FastifyRequest } from "fastify";
+import { type SafeFilter } from "@x12i/memorix-client";
+import type { PeerChoice } from "./peers.js";
+import type { ClientScope } from "./scope.js";
+export type FunctionRead = {
+    objectType?: string;
+    contentType?: string;
+    recordId?: string;
+    template?: string;
+    sameSubject?: boolean;
+};
+export type FunctionEntry = {
+    id: string;
+    question: string;
+    page: string;
+    objectTypes: string[];
+    composes: boolean;
+    pageStory: boolean;
+    reads: FunctionRead[];
+    origin: "agent" | "database";
+    template?: string;
+    kind?: string;
+};
+export type SkillsInfo = {
+    mode: "embedded" | "external";
+    source: string;
+    version: string;
+    baseUrl?: string;
+};
+export type SkillsHost = {
+    info: SkillsInfo;
+    list(scope: ClientScope, agentId: string): Promise<{
+        items: FunctionEntry[];
+    }>;
+    run(scope: ClientScope, agentId: string, functionId: string, body: unknown): Promise<unknown>;
+    save(scope: ClientScope, agentId: string, functionId: string, body: unknown): Promise<unknown>;
+    remove(scope: ClientScope, agentId: string, functionId: string): Promise<unknown>;
+};
+/** Enough of `@x12i/memorix-client` for function reads and the story write. */
+export type FunctionMemorix = {
+    explore: {
+        listContent(input: {
+            objectType: string;
+            contentType: string;
+            limit?: number;
+            filter?: SafeFilter[];
+            discriminatorValue?: string;
+        }): Promise<unknown>;
+        getContent?(input: {
+            objectType: string;
+            contentType: string;
+            recordId: string;
+            discriminatorValue?: string;
+        }): Promise<unknown>;
+        writeContent(input: {
+            objectType: string;
+            contentType: string;
+            record: Record<string, unknown>;
+            precondition: "absent" | {
+                kind: "revision";
+                revision: number;
+            };
+            op?: "upsert" | "replace";
+            discriminatorValue?: string;
+            expectedRevision?: number;
+        }): Promise<unknown>;
+    };
+};
+export type EmbeddedSkillsOptions = {
+    memorixUrl: string;
+    peer?: PeerChoice;
+    packDir?: string;
+    agentsDir?: string;
+    contentAgentIds?: string[];
+    /** Assistants database. Unset means pack functions run and save returns 503. */
+    mongoUri?: string;
+    createClient?: (scope: ClientScope) => FunctionMemorix;
+};
+export declare function createEmbeddedSkillsHost(options: EmbeddedSkillsOptions): SkillsHost;
+export type ExternalSkillsOptions = {
+    peer: PeerChoice;
+    fetchImpl?: typeof fetch;
+    /** Test double. Production mints an HMAC deployment identity. */
+    issueIdentity?: (scope: ClientScope, write: boolean) => Promise<string> | string;
+};
+/** Forward function calls to a running skill-api. This process does not load a pack. */
+export declare function createExternalSkillsHost(options: ExternalSkillsOptions): SkillsHost;
+export type SkillRouteOptions = {
+    host: SkillsHost;
+    scopeFor: (req: FastifyRequest) => Promise<ClientScope>;
+};
+export declare function registerSkillRoutes(app: FastifyInstance, options: SkillRouteOptions): void;
+/**
+ * One pack directory serves that folder name, and every content agent.
+ * An agents root is searched by folder name, then by the first pack that has functions.
+ */
+export declare function resolvePackDir(agentId: string, options: {
+    packDir?: string;
+    agentsDir?: string;
+    contentAgentIds?: string[];
+}): string | null;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

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