@raybase/guide 0.0.2 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Itself & Co
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+export type GuideCliPlugin = {
+    id: "guide";
+    packageName: "@raybase/guide";
+    commands: string[];
+    doctorHooks: string[];
+};
+export declare function guideCliPlugin(): GuideCliPlugin;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,wBAAgB,cAAc,IAAI,cAAc,CAO/C"}

package/dist/cli.js

@@ -0,0 +1,9 @@
+export function guideCliPlugin() {
+    return {
+        id: "guide",
+        packageName: "@raybase/guide",
+        commands: ["guide enable", "guide disable", "guide index", "guide status"],
+        doctorHooks: ["guide"]
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,gBAAgB;QAC7B,QAAQ,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,CAAC;QAC1E,WAAW,EAAE,CAAC,OAAO,CAAC;KACvB,CAAC;AACJ,CAAC"}

package/dist/guide-client.d.ts

@@ -0,0 +1,48 @@
+export type GuideClientMessagePart = {
+    type: "text";
+    text: string;
+} | {
+    type: string;
+    id?: string;
+    data?: unknown;
+    [key: string]: unknown;
+};
+export type GuideClientTurnRequest = {
+    conversationId?: string;
+    message: string;
+    title?: string;
+    route?: string;
+    surface?: string;
+};
+export type GuideClientConversation = {
+    agentName: string;
+    conversationId: string;
+    runtime: "ai-chat";
+    triggerType: "chat";
+    basePath: string;
+    expiresAt: string;
+    conversationToken: string;
+    webSocketToken?: string;
+};
+export type GuideClientTurnResponse = {
+    agentName: string;
+    conversationId: string;
+    requestId: string;
+    status: string;
+    text: string;
+    parts: GuideClientMessagePart[];
+    error?: string;
+};
+export type GuideClientTurnOptions = {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+};
+export declare function createGuideClient(options?: {
+    endpoint?: string;
+    agentName?: string;
+    fetch?: typeof fetch;
+}): {
+    bootstrap: (input?: Omit<GuideClientTurnRequest, "message">) => Promise<GuideClientConversation>;
+    turn(input: GuideClientTurnRequest, turnOptions?: GuideClientTurnOptions): Promise<GuideClientTurnResponse>;
+};
+//# sourceMappingURL=guide-client.d.ts.map

package/dist/guide-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-client.d.ts","sourceRoot":"","sources":["../src/guide-client.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE1E,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA0BF,wBAAgB,iBAAiB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO;wBAK7E,IAAI,CAAC,sBAAsB,EAAE,SAAS,CAAC,KAAQ,OAAO,CAAC,uBAAuB,CAAC;gBAqB3F,sBAAsB,gBAAe,sBAAsB,GAAQ,OAAO,CAAC,uBAAuB,CAAC;EAkGxH"}

package/dist/guide-client.js

@@ -0,0 +1,202 @@
+const defaultGuideTurnTimeoutMs = 120_000;
+const initialGuidePollDelayMs = 250;
+const maximumGuidePollDelayMs = 2_000;
+export function createGuideClient(options = {}) {
+    const agentName = options.agentName ?? "guide";
+    const endpoint = (options.endpoint ?? "/api/raybase/agents").replace(/\/$/, "");
+    const fetcher = options.fetch ?? fetch;
+    async function bootstrap(input = {}) {
+        const response = await fetcher(`${endpoint}/${encodeURIComponent(agentName)}/conversations`, {
+            method: "POST",
+            credentials: "include",
+            headers: guideHeaders(input),
+            body: JSON.stringify({
+                conversationId: input.conversationId,
+                title: input.title,
+                route: input.route,
+                surface: input.surface
+            })
+        });
+        const body = await response.json().catch(() => ({}));
+        if (!response.ok || !body.conversationId || !body.basePath || !body.conversationToken) {
+            throw new Error(body.error ?? `Guide conversation bootstrap failed with ${response.status}`);
+        }
+        return body;
+    }
+    return {
+        bootstrap,
+        async turn(input, turnOptions = {}) {
+            const timeoutMs = normalizeGuideTurnTimeout(turnOptions.timeoutMs);
+            const deadline = Date.now() + timeoutMs;
+            const controller = new AbortController();
+            let timedOut = false;
+            const abortFromCaller = () => controller.abort(turnOptions.signal?.reason);
+            if (turnOptions.signal?.aborted)
+                abortFromCaller();
+            else
+                turnOptions.signal?.addEventListener("abort", abortFromCaller, { once: true });
+            const timeout = setTimeout(() => {
+                timedOut = true;
+                controller.abort();
+            }, timeoutMs);
+            try {
+                const conversation = await bootstrapWithSignal(input, controller.signal);
+                const requestKey = guideRequestKey();
+                const requestBasePath = conversation.basePath.replace(/\/chat\/?$/, "");
+                const sendResponse = await fetcher(`${requestBasePath}/messages`, {
+                    method: "POST",
+                    credentials: "include",
+                    signal: controller.signal,
+                    headers: {
+                        ...guideHeaders(input),
+                        authorization: `Bearer ${conversation.conversationToken}`
+                    },
+                    body: JSON.stringify({ message: input.message, requestKey })
+                });
+                const sendBody = await sendResponse.json().catch(() => ({}));
+                if (!sendResponse.ok || sendBody.requestKey !== requestKey) {
+                    throw new Error(sendBody.error ?? `Guide turn send failed with ${sendResponse.status}`);
+                }
+                let pollDelayMs = initialGuidePollDelayMs;
+                for (;;) {
+                    assertGuideTurnActive(controller.signal, timedOut, timeoutMs);
+                    const statusResponse = await fetcher(`${requestBasePath}/requests/${encodeURIComponent(requestKey)}`, {
+                        method: "GET",
+                        credentials: "include",
+                        signal: controller.signal,
+                        headers: {
+                            ...guideHeaders(input),
+                            authorization: `Bearer ${conversation.conversationToken}`
+                        }
+                    });
+                    const status = await statusResponse.json().catch(() => ({}));
+                    if (!statusResponse.ok) {
+                        throw new Error(status.error ?? `Guide turn status failed with ${statusResponse.status}`);
+                    }
+                    const terminal = guideTurnResponse(conversation, requestKey, status);
+                    if (terminal)
+                        return terminal;
+                    const remainingMs = deadline - Date.now();
+                    if (remainingMs <= 0)
+                        throw guideTurnTimeoutError(timeoutMs);
+                    await abortableDelay(Math.min(pollDelayMs, remainingMs), controller.signal);
+                    pollDelayMs = Math.min(pollDelayMs * 2, maximumGuidePollDelayMs);
+                }
+            }
+            catch (error) {
+                if (timedOut)
+                    throw guideTurnTimeoutError(timeoutMs);
+                if (turnOptions.signal?.aborted) {
+                    throw turnOptions.signal.reason instanceof Error
+                        ? turnOptions.signal.reason
+                        : new DOMException("The Guide turn was aborted", "AbortError");
+                }
+                throw error;
+            }
+            finally {
+                clearTimeout(timeout);
+                turnOptions.signal?.removeEventListener("abort", abortFromCaller);
+            }
+        }
+    };
+    async function bootstrapWithSignal(input, signal) {
+        const response = await fetcher(`${endpoint}/${encodeURIComponent(agentName)}/conversations`, {
+            method: "POST",
+            credentials: "include",
+            signal,
+            headers: guideHeaders(input),
+            body: JSON.stringify({
+                conversationId: input.conversationId,
+                title: input.title,
+                route: input.route,
+                surface: input.surface
+            })
+        });
+        const body = await response.json().catch(() => ({}));
+        if (!response.ok || !body.conversationId || !body.basePath || !body.conversationToken) {
+            throw new Error(body.error ?? `Guide conversation bootstrap failed with ${response.status}`);
+        }
+        return body;
+    }
+}
+function guideHeaders(input = {}) {
+    const headers = { "content-type": "application/json" };
+    if (input.route)
+        headers["x-raybase-agent-route"] = input.route;
+    if (input.surface)
+        headers["x-raybase-agent-surface"] = input.surface;
+    return headers;
+}
+function guideTurnResponse(conversation, requestKey, status) {
+    const run = status.run;
+    if (!run) {
+        if (status.disposition !== "ignored")
+            return null;
+        return {
+            agentName: conversation.agentName,
+            conversationId: conversation.conversationId,
+            requestId: requestKey,
+            status: "ignored",
+            text: "",
+            parts: []
+        };
+    }
+    if (run.status === "queued" || run.status === "running")
+        return null;
+    if (run.status === "failed") {
+        throw new Error(run.error || "Guide turn failed");
+    }
+    const dropped = run.status === "completed" && run.delivery?.verdict === "drop";
+    const text = dropped ? "" : run.text ?? "";
+    const parts = dropped
+        ? []
+        : Array.isArray(run.parts)
+            ? run.parts
+            : text
+                ? [{ type: "text", text }]
+                : [];
+    return {
+        agentName: conversation.agentName,
+        conversationId: conversation.conversationId,
+        requestId: run.requestId,
+        status: dropped ? "dropped" : run.status,
+        text,
+        parts
+    };
+}
+function normalizeGuideTurnTimeout(value) {
+    if (value === undefined)
+        return defaultGuideTurnTimeoutMs;
+    if (!Number.isFinite(value) || value <= 0)
+        throw new Error("Guide turn timeoutMs must be a positive number");
+    return value;
+}
+function guideRequestKey() {
+    return `guide_${crypto.randomUUID()}`;
+}
+function guideTurnTimeoutError(timeoutMs) {
+    return new Error(`Guide turn timed out after ${timeoutMs}ms`);
+}
+function assertGuideTurnActive(signal, timedOut, timeoutMs) {
+    if (!signal.aborted)
+        return;
+    if (timedOut)
+        throw guideTurnTimeoutError(timeoutMs);
+    throw signal.reason instanceof Error
+        ? signal.reason
+        : new DOMException("The Guide turn was aborted", "AbortError");
+}
+function abortableDelay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(signal.reason instanceof Error ? signal.reason : new DOMException("Aborted", "AbortError"));
+            return;
+        }
+        const timeout = setTimeout(resolve, ms);
+        signal.addEventListener("abort", () => {
+            clearTimeout(timeout);
+            reject(signal.reason instanceof Error ? signal.reason : new DOMException("Aborted", "AbortError"));
+        }, { once: true });
+    });
+}
+//# sourceMappingURL=guide-client.js.map

package/dist/guide-client.js.map

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

package/dist/guide-corpus.d.ts

@@ -0,0 +1,64 @@
+import type { RaybaseSchema } from "@raybase/core";
+import type { GuideConfig } from "./guide.js";
+export type GuideCorpusSource = "docs" | "faq" | "spec" | "route" | "schema" | "policy" | "support";
+export type GuideCorpusContext = "template-default" | "app-capability-map" | "workflow";
+export type GuideCorpusDocument = {
+    id: string;
+    title: string;
+    source: GuideCorpusSource;
+    text: string;
+    guideContext?: GuideCorpusContext | null;
+    url?: string;
+    routePatterns?: string[];
+    public?: boolean;
+    updatedAt?: string;
+    hash?: string;
+    metadata?: Record<string, unknown>;
+};
+export type GuideCorpusManifestSource = {
+    kind: "docs";
+    path: string;
+} | {
+    kind: "guide";
+    path: string;
+} | {
+    kind: "configured";
+    path: string;
+    id: string;
+};
+export type GuideCorpusManifest = {
+    schemaVersion: 1;
+    generatedAt: string;
+    sources: GuideCorpusManifestSource[];
+    documents: GuideCorpusDocument[];
+};
+export type GuideCorpusResourceSource = Exclude<GuideCorpusSource, "docs">;
+export type GuideCorpusResource = {
+    id: string;
+    path: string;
+    source: GuideCorpusResourceSource;
+    title?: string;
+    public?: boolean;
+    guideContext?: GuideCorpusContext;
+    routePatterns?: string[];
+};
+export type GuideCorpusResourceConfig = {
+    schemaVersion: 1;
+    resources: GuideCorpusResource[];
+};
+export type GuideCorpusSnippet = GuideCorpusDocument & {
+    score: number;
+};
+export declare function safeSchemaGuideDocuments(schema: RaybaseSchema, config?: GuideConfig): GuideCorpusDocument[];
+export declare function safePolicyGuideDocuments(schema: RaybaseSchema, config?: GuideConfig): GuideCorpusDocument[];
+export declare function rankGuideCorpus(input: {
+    documents: GuideCorpusDocument[];
+    query: string;
+    surface: "app" | "docs";
+    route: string;
+    principalKind: "user" | "public";
+    config: GuideConfig;
+    maxSnippets?: number;
+}): GuideCorpusSnippet[];
+export declare function guideCorpusPrompt(snippets: GuideCorpusSnippet[]): string;
+//# sourceMappingURL=guide-corpus.d.ts.map

package/dist/guide-corpus.d.ts.map

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

package/dist/guide-corpus.js

@@ -0,0 +1,113 @@
+export function safeSchemaGuideDocuments(schema, config = {}) {
+    if (config.corpus?.safeSchema === false)
+        return [];
+    return Object.values(schema.tables).map((table) => ({
+        id: `schema:${table.name}`,
+        title: table.label ?? table.name,
+        source: "schema",
+        public: false,
+        text: [
+            `Table: ${table.label ?? table.name}`,
+            `Columns: ${Object.entries(table.columns)
+                .map(([name, column]) => `${column.label ?? name} (${column.kind})`)
+                .join(", ")}`
+        ].join("\n")
+    }));
+}
+export function safePolicyGuideDocuments(schema, config = {}) {
+    if (config.corpus?.safePolicies === false)
+        return [];
+    return Object.values(schema.tables).map((table) => ({
+        id: `policy:${table.name}`,
+        title: `${table.label ?? table.name} access rules`,
+        source: "policy",
+        public: false,
+        text: `Access to ${table.label ?? table.name} is enforced by Raybase row policies for read, create, update, and delete operations.`
+    }));
+}
+export function rankGuideCorpus(input) {
+    const maxSnippets = Math.max(1, input.maxSnippets ?? input.config.limits?.maxCorpusSnippets ?? 8);
+    const allowed = input.documents
+        .filter((document) => sourceEnabled(document, input.config))
+        .filter((document) => input.principalKind === "user" || document.public === true)
+        .filter((document) => routeNarrows(document, input.route));
+    const queryTokens = tokenize(input.query);
+    const routeTokens = tokenize(input.route);
+    return allowed
+        .map((document) => {
+        const haystack = tokenSet([document.title, document.text, document.url, ...(document.routePatterns ?? [])].filter(Boolean).join(" "));
+        const tokenScore = scoreTokens(queryTokens, haystack);
+        const routeScore = routeTokens.length ? scoreTokens(routeTokens, haystack) * 0.25 : 0;
+        const surfaceScore = document.source === "docs" && input.surface === "docs" ? 0.5 : 0;
+        return { ...document, score: tokenScore + routeScore + surfaceScore };
+    })
+        .filter((document) => document.score > 0 || input.query.trim().length < 2)
+        .sort((left, right) => right.score - left.score || left.title.localeCompare(right.title))
+        .slice(0, maxSnippets);
+}
+export function guideCorpusPrompt(snippets) {
+    if (!snippets.length)
+        return "No authorized app help snippets were found for this question.";
+    return [
+        "Authorized app help snippets:",
+        ...snippets.map((snippet, index) => {
+            const label = [snippet.title, snippet.url].filter(Boolean).join(" - ");
+            return `[${index + 1}] ${label} (${snippet.source})\n${snippet.text.slice(0, 1800)}`;
+        })
+    ].join("\n\n");
+}
+function sourceEnabled(document, config) {
+    const corpus = config.corpus ?? {};
+    switch (document.source) {
+        case "docs":
+            return corpus.docs !== false;
+        case "faq":
+            return corpus.faq !== false;
+        case "spec":
+            return corpus.spec !== false;
+        case "route":
+            return corpus.routeMetadata !== false;
+        case "schema":
+            return corpus.safeSchema !== false;
+        case "policy":
+            return corpus.safePolicies !== false;
+        case "support":
+            return corpus.priorResolvedSupport === true;
+    }
+}
+function routeNarrows(document, route) {
+    if (!document.routePatterns?.length)
+        return true;
+    const normalized = normalizeRoute(route);
+    return document.routePatterns.some((pattern) => routeMatches(normalized, pattern));
+}
+function routeMatches(route, pattern) {
+    const normalized = normalizeRoute(pattern);
+    if (normalized === route)
+        return true;
+    if (normalized.endsWith("*"))
+        return route.startsWith(normalized.slice(0, -1));
+    return false;
+}
+function normalizeRoute(route) {
+    const value = route.trim() || "/";
+    return value.startsWith("/") ? value : `/${value}`;
+}
+function scoreTokens(queryTokens, haystack) {
+    let score = 0;
+    for (const token of queryTokens) {
+        if (haystack.has(token))
+            score += token.length > 4 ? 2 : 1;
+    }
+    return score;
+}
+function tokenize(value) {
+    return value
+        .toLowerCase()
+        .split(/[^a-z0-9]+/g)
+        .filter((token) => token.length > 1);
+}
+function tokenSet(value) {
+    return new Set(tokenize(value));
+}
+//# sourceMappingURL=guide-corpus.js.map

package/dist/guide-corpus.js.map

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

package/dist/guide-tables.d.ts

@@ -0,0 +1,4 @@
+import { type RaybaseSystemTable } from "@raybase/core";
+export declare const guideFailuresTableName = "_guide_failures";
+export declare const raybaseGuideSystemTables: RaybaseSystemTable[];
+//# sourceMappingURL=guide-tables.d.ts.map

package/dist/guide-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-tables.d.ts","sourceRoot":"","sources":["../src/guide-tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEhG,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AAExD,eAAO,MAAM,wBAAwB,EAAE,kBAAkB,EAiBxD,CAAC"}

package/dist/guide-tables.js

@@ -0,0 +1,17 @@
+import { id, longText, raybaseSystemTable, text } from "@raybase/core";
+export const guideFailuresTableName = "_guide_failures";
+export const raybaseGuideSystemTables = [
+    raybaseSystemTable(guideFailuresTableName, {
+        id: id(),
+        conversationId: text(),
+        organizationId: text(),
+        fingerprint: text({ required: true }),
+        surface: text({ required: true }),
+        route: text({ required: true }),
+        question: longText({ required: true }),
+        reason: text({ required: true }),
+        corpusIdsJson: longText(),
+        createdAt: text({ required: true })
+    }, { label: "Guide unanswered questions", indexes: [["fingerprint"], ["organizationId", "createdAt"], ["surface", "createdAt"]] })
+];
+//# sourceMappingURL=guide-tables.js.map

package/dist/guide-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-tables.js","sourceRoot":"","sources":["../src/guide-tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAA2B,MAAM,eAAe,CAAC;AAEhG,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAExD,MAAM,CAAC,MAAM,wBAAwB,GAAyB;IAC5D,kBAAkB,CAChB,sBAAsB,EACtB;QACE,EAAE,EAAE,EAAE,EAAE;QACR,cAAc,EAAE,IAAI,EAAE;QACtB,cAAc,EAAE,IAAI,EAAE;QACtB,WAAW,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACrC,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACjC,KAAK,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC/B,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACtC,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAChC,aAAa,EAAE,QAAQ,EAAE;QACzB,SAAS,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KACpC,EACD,EAAE,KAAK,EAAE,4BAA4B,EAAE,OAAO,EAAE,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,gBAAgB,EAAE,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,EAAE,CAC/H;CACF,CAAC"}