@raybase/guide 0.0.2 → 0.1.3

package/dist/guide.d.ts

@@ -0,0 +1,164 @@
+import type { RaybaseAction, RaybaseActions } from "@raybase/core";
+import { type RaybaseAIEnv, type RaybaseInferenceProvider, type RaybaseNotificationsRuntime, type RaybaseRetrieval, type RaybaseSearch } from "@raybase/core";
+import { type RaybaseAgent, type RaybaseAgentAudience } from "@raybase/core";
+import { type DoMigration, type SqlExecutor } from "@raybase/core";
+import type { RaybaseAuditContextEvent } from "@raybase/core";
+import type { GuideCorpusDocument } from "./guide-corpus.js";
+import type { RaybaseUser } from "@raybase/core";
+import type { RaybaseSchema } from "@raybase/core";
+export type GuideMode = "help" | "support" | "workflow";
+export type GuideAudience = "signed-in" | "public";
+export type GuideSurface = "app" | "docs";
+export type GuideConfig = {
+    enabled?: boolean;
+    endpoint?: string;
+    surfaces?: {
+        app?: {
+            enabled?: boolean;
+            audience?: GuideAudience;
+        };
+        docs?: {
+            enabled?: boolean;
+            audience?: GuideAudience;
+        };
+    };
+    agent?: {
+        name?: string;
+        title?: string;
+        model?: string;
+        maxOutputTokens?: number;
+    };
+    corpus?: {
+        docs?: boolean;
+        faq?: boolean;
+        spec?: boolean;
+        routeMetadata?: boolean;
+        safeSchema?: boolean;
+        safePolicies?: boolean;
+        priorResolvedSupport?: boolean;
+    };
+    support?: {
+        mode?: "off" | "local";
+        requireContactForPublic?: boolean;
+    };
+    limits?: {
+        maxInputChars?: number;
+        publicIpHourlyRequests?: number;
+        publicIpHourlyOutputTokens?: number;
+        publicDailyRequests?: number;
+        publicDailyOutputTokens?: number;
+        signedInDailyRequests?: number;
+        maxCorpusSnippets?: number;
+    };
+};
+export type GuideTurnRequest = {
+    surface?: GuideSurface;
+    route?: string;
+    conversationId?: string;
+    message: string;
+    mode?: GuideMode;
+};
+export type GuideSupportRequest = {
+    surface?: GuideSurface;
+    route?: string;
+    conversationId?: string;
+    subject?: string;
+    body: string;
+    contactEmail?: string;
+};
+export type NormalizedGuideConfig = {
+    enabled: boolean;
+    endpoint: string;
+    surfaces: Record<GuideSurface, {
+        enabled: boolean;
+        audience: GuideAudience;
+    }>;
+    agent: {
+        name: string;
+        title: string;
+        model?: string;
+        maxOutputTokens?: number;
+    };
+    support: {
+        mode: "off" | "local";
+        requireContactForPublic: boolean;
+    };
+    limits: {
+        maxInputChars: number;
+        publicIpHourlyRequests: number;
+        publicIpHourlyOutputTokens: number;
+        publicDailyRequests: number;
+        publicDailyOutputTokens: number;
+        signedInDailyRequests: number;
+        maxCorpusSnippets: number;
+    };
+};
+export type GuideApiContext<Env extends RaybaseAIEnv = RaybaseAIEnv> = {
+    request: Request;
+    env: Env;
+    config: GuideConfig;
+    schema: RaybaseSchema;
+    appMigrations?: DoMigration[];
+    user?: RaybaseUser;
+    actions?: RaybaseActions<Env>;
+    corpus?: GuideCorpusDocument[];
+    aiProvider?: RaybaseInferenceProvider<Env>;
+    notifications?: RaybaseNotificationsRuntime<Env>;
+    control: SqlExecutor;
+    organizationId?: string | null;
+    audit?: (entry: RaybaseAuditContextEvent) => Promise<void>;
+};
+export type GuideAgentOptions<Env = unknown> = {
+    name?: string;
+    audience?: RaybaseAgentAudience;
+    corpus?: GuideCorpusDocument[];
+    actions?: RaybaseAction<any, any, Env>[];
+    support?: {
+        mode?: "off" | "local";
+    };
+    title?: string;
+    description?: string;
+    model?: string;
+    maxOutputTokens?: number;
+    limits?: NormalizedGuideConfig["limits"];
+    system?: string;
+};
+export type GuideActionsOptions<Env = unknown> = {
+    config?: GuideConfig | NormalizedGuideConfig;
+    schema: RaybaseSchema;
+    search?: RaybaseSearch<Env>;
+    retrieval?: RaybaseRetrieval<Env>;
+    actions?: RaybaseAction<any, any, Env>[];
+};
+export declare class GuideHttpError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+export declare function normalizeGuideConfig(config?: GuideConfig): NormalizedGuideConfig;
+export declare function guideAgent<Env = unknown>(options?: GuideAgentOptions<Env>): RaybaseAgent<Env>;
+export declare function guideEndpoint(config?: GuideConfig): string;
+export declare function guideRoutePath(config: GuideConfig, suffix: string): string;
+export declare function isGuidePath(path: string, config: GuideConfig): boolean;
+export declare function parseGuideTurnBody(body: Record<string, unknown>): GuideTurnRequest;
+export declare function parseGuideSupportBody(body: Record<string, unknown>): GuideSupportRequest;
+export declare function createGuideSupportRequest<Env extends RaybaseAIEnv>(ctx: GuideApiContext<Env>, input: GuideSupportRequest): Promise<{
+    supportRequestId: string;
+    status: string;
+}>;
+export declare function recordGuideFailure(control: SqlExecutor, input: {
+    conversationId?: string | null;
+    organizationId?: string | null;
+    surface: GuideSurface;
+    route: string;
+    question: string;
+    reason: string;
+    corpusIds: string[];
+}): Promise<void>;
+export declare function guideAudienceFromConfig(guide: NormalizedGuideConfig): RaybaseAgentAudience;
+export declare function guideAgentSurfaces(guide: NormalizedGuideConfig): Array<{
+    surface: string;
+    pathPrefix: string;
+}>;
+export declare function guideActions<Env>(options: GuideActionsOptions<Env>): Array<RaybaseAction<unknown, unknown, Env>>;
+export declare function guideControl<Env extends RaybaseAIEnv>(ctx: Omit<GuideApiContext<Env>, "control">): SqlExecutor;
+//# sourceMappingURL=guide.d.ts.map

package/dist/guide.d.ts.map

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

package/dist/guide.js

@@ -0,0 +1,348 @@
+import { z } from "zod";
+import { allowAll, createSupportRequest, createRaybaseKnowledgeSearchAction, principalOnBehalfOf, raybaseAgentDataPartTypes } from "@raybase/core";
+import { sha256Hex, stableJson } from "@raybase/core/internal";
+import { agentRequestSurface, defineAgent, resolveAgentAccess } from "@raybase/core";
+import { createRaybaseDb } from "@raybase/core";
+import { guideFailuresTableName } from "./guide-tables.js";
+import { nowIso, q, randomId } from "@raybase/core";
+function defaultGuidePrompt(system) {
+    return [
+        system ?? "You are the in-app Guide agent for this app.",
+        "Help users understand and use the app. Do not operate the app, bypass permissions, or act as an operator/admin chatbot.",
+        "Call guide_search_knowledge when the user asks about app features, workflows, docs, policies, or other app-specific context and the answer needs app context.",
+        "When the user asks what you can do, explain the current Guide capabilities from your role, available knowledge, and available action descriptions. Do not claim workflows that are not documented or exposed as explicit actions.",
+        "Always respond in friendly end-user language. Do not expose raw tool names, JSON, validation errors, stack traces, internal status, SQL, source-code details, or implementation jargon.",
+        "If knowledge search or an action returns no useful result or fails, say what you can still help with, offer a practical next step, and ask at most one clarifying question if it would unblock the user.",
+        "Cite sources when using retrieved context. If no context is found, do not invent app facts.",
+        "Escalate instead of inventing policy, support, legal, billing, security, admin, refund, deadline, fix, deployment, SQL, source-code, or account authority.",
+        "Use safe explicit actions only when the user clearly asks for that outcome.",
+        "Do not promise refunds, deadlines, policy exceptions, fixes, deployments, admin actions, SQL access, or source-code changes."
+    ].filter(Boolean).join("\n\n");
+}
+export class GuideHttpError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+    }
+}
+export function normalizeGuideConfig(config = {}) {
+    const guide = config;
+    return {
+        enabled: guide.enabled !== false,
+        endpoint: guideEndpoint(config),
+        surfaces: {
+            app: {
+                enabled: guide.surfaces?.app?.enabled ?? true,
+                audience: guide.surfaces?.app?.audience ?? "signed-in"
+            },
+            docs: {
+                enabled: guide.surfaces?.docs?.enabled ?? false,
+                audience: guide.surfaces?.docs?.audience ?? "signed-in"
+            }
+        },
+        agent: {
+            name: guide.agent?.name ?? "guide",
+            title: guide.agent?.title ?? "Guide",
+            model: guide.agent?.model,
+            maxOutputTokens: guide.agent?.maxOutputTokens
+        },
+        support: {
+            mode: guide.support?.mode ?? "local",
+            requireContactForPublic: guide.support?.requireContactForPublic ?? false
+        },
+        limits: {
+            maxInputChars: guide.limits?.maxInputChars ?? 4000,
+            publicIpHourlyRequests: guide.limits?.publicIpHourlyRequests ?? 20,
+            publicIpHourlyOutputTokens: guide.limits?.publicIpHourlyOutputTokens ?? 12_000,
+            publicDailyRequests: guide.limits?.publicDailyRequests ?? 200,
+            publicDailyOutputTokens: guide.limits?.publicDailyOutputTokens ?? 60_000,
+            signedInDailyRequests: guide.limits?.signedInDailyRequests ?? 50,
+            maxCorpusSnippets: guide.limits?.maxCorpusSnippets ?? 8
+        }
+    };
+}
+export function guideAgent(options = {}) {
+    const audience = options.audience ?? { app: "signed-in", docs: "public" };
+    return defineAgent({
+        name: options.name ?? "guide",
+        runtime: "ai-chat",
+        title: options.title ?? "Guide",
+        description: options.description ?? "Helps end users understand the app and docs.",
+        audience,
+        model: options.model,
+        runtimeControl: { configurable: true, defaultEnabled: true },
+        prompt: {
+            default: defaultGuidePrompt(options.system),
+            configurable: true,
+            renderer: "liquid"
+        },
+        actions: options.actions,
+        limits: {
+            maxInputChars: options.limits?.maxInputChars,
+            maxOutputTokens: options.maxOutputTokens,
+            publicIpHourlyRequests: options.limits?.publicIpHourlyRequests,
+            publicIpHourlyOutputTokens: options.limits?.publicIpHourlyOutputTokens,
+            publicDailyRequests: options.limits?.publicDailyRequests,
+            publicDailyOutputTokens: options.limits?.publicDailyOutputTokens,
+            signedInDailyRequests: options.limits?.signedInDailyRequests
+        }
+    });
+}
+export function guideEndpoint(config = {}) {
+    const endpoint = config.endpoint || "/api/guide";
+    return endpoint.startsWith("/") ? endpoint.replace(/\/$/, "") || "/api/guide" : `/${endpoint.replace(/\/$/, "")}`;
+}
+export function guideRoutePath(config, suffix) {
+    return `${guideEndpoint(config)}${suffix.startsWith("/") ? suffix : `/${suffix}`}`;
+}
+export function isGuidePath(path, config) {
+    const endpoint = guideEndpoint(config);
+    return path === endpoint || path.startsWith(`${endpoint}/`);
+}
+export function parseGuideTurnBody(body) {
+    return {
+        surface: body.surface === "docs" ? "docs" : "app",
+        route: typeof body.route === "string" ? body.route : "/",
+        conversationId: typeof body.conversationId === "string" ? body.conversationId : undefined,
+        message: typeof body.message === "string" ? body.message : "",
+        mode: body.mode === "support" || body.mode === "workflow" ? body.mode : "help"
+    };
+}
+export function parseGuideSupportBody(body) {
+    return {
+        surface: body.surface === "docs" ? "docs" : "app",
+        route: typeof body.route === "string" ? body.route : "/",
+        conversationId: typeof body.conversationId === "string" ? body.conversationId : undefined,
+        subject: typeof body.subject === "string" ? body.subject : undefined,
+        body: typeof body.body === "string" ? body.body : "",
+        contactEmail: typeof body.contactEmail === "string" ? body.contactEmail : undefined
+    };
+}
+export async function createGuideSupportRequest(ctx, input) {
+    const guide = normalizeGuideConfig(ctx.config);
+    if (!guide.enabled || guide.support.mode === "off")
+        throw new GuideHttpError("Support is disabled", 404);
+    if (!input.body.trim())
+        throw new GuideHttpError("Support request body is required", 400);
+    const agent = { name: guide.agent.name, audience: guideAudienceFromConfig(guide) };
+    const access = await resolveAgentAccess({ ...ctx, agent, surfaces: guideAgentSurfaces(guide) });
+    if (access.principal.kind === "public" && guide.support.requireContactForPublic && !input.contactEmail?.trim()) {
+        throw new GuideHttpError("Contact email is required", 400);
+    }
+    const requestSurface = agentRequestSurface(ctx.request, guideAgentSurfaces(guide));
+    const result = await createSupportRequest({
+        control: ctx.control,
+        notifications: ctx.notifications,
+        principal: access.principal,
+        user: access.principal.kind === "user" ? access.principal.user : undefined,
+        organizationId: access.organizationId ?? null,
+        agentName: guide.agent.name,
+        surface: requestSurface.surface,
+        route: requestSurface.route,
+        audit: ctx.audit
+    }, {
+        sourceKind: "guide",
+        conversationId: input.conversationId,
+        subject: input.subject?.trim() || input.body.trim().slice(0, 120) || "Support request",
+        body: input.body.trim(),
+        category: "support",
+        confidence: 50,
+        escalationReason: input.body.trim(),
+        contactEmail: input.contactEmail?.trim() || undefined
+    });
+    return { supportRequestId: result.supportRequestId, status: result.status };
+}
+export async function recordGuideFailure(control, input) {
+    await control.run(`INSERT INTO ${q(guideFailuresTableName)}
+     ("id", "conversationId", "organizationId", "fingerprint", "surface", "route", "question", "reason", "corpusIdsJson", "createdAt")
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+        randomId("guide_failure"),
+        input.conversationId ?? null,
+        input.organizationId ?? null,
+        (await sha256Hex(`${input.surface}:${input.route}:${input.question.toLowerCase().trim()}`)).slice(0, 32),
+        input.surface,
+        input.route,
+        input.question,
+        input.reason,
+        stableJson(input.corpusIds),
+        nowIso()
+    ]);
+}
+export function guideAudienceFromConfig(guide) {
+    return {
+        app: guide.surfaces.app.audience,
+        docs: guide.surfaces.docs.audience
+    };
+}
+export function guideAgentSurfaces(guide) {
+    return guide.surfaces.docs.enabled ? [{ surface: "docs", pathPrefix: "/docs" }] : [];
+}
+export function guideActions(options) {
+    const guide = "enabled" in (options.config ?? {}) && "endpoint" in (options.config ?? {})
+        ? options.config
+        : normalizeGuideConfig(options.config);
+    const builtInActions = [
+        createRaybaseKnowledgeSearchAction({
+            name: "guide_search_knowledge",
+            description: "Search app help and app knowledge when the user asks about app features, workflows, docs, policies, or other app-specific context and the answer needs app context. Return source metadata for citations.",
+            schema: options.schema,
+            search: options.search,
+            retrieval: options.retrieval,
+            maxResults: guide.limits.maxCorpusSnippets
+        }),
+        createGuideEscalateToSupportAction(guide)
+    ];
+    return appendGuideActions(builtInActions, options.actions ?? []);
+}
+function appendGuideActions(builtInActions, actions) {
+    const seen = new Set(builtInActions.map((action) => action.name));
+    const appended = [...builtInActions];
+    for (const action of actions) {
+        if (seen.has(action.name)) {
+            throw new Error(`Guide action "${action.name}" conflicts with another Guide action.`);
+        }
+        seen.add(action.name);
+        appended.push(action);
+    }
+    return appended;
+}
+const guideEscalateInput = z.object({
+    reason: z.string().min(1).max(1000),
+    body: z.string().min(1).max(8000),
+    subject: z.string().min(1).max(200).optional(),
+    contactEmail: z.string().email().max(320).optional(),
+    transcriptSummary: z.string().max(4000).optional(),
+    transcriptEvidence: z.string().max(8000).optional(),
+    sources: z.array(z.unknown()).max(20).optional(),
+    createdMessageId: z.string().max(200).optional()
+}).strict();
+const guideSupportRequestOutput = z.object({
+    supportRequestId: z.string(),
+    status: z.string(),
+    subject: z.string(),
+    createdAt: z.string(),
+    conversationId: z.string().nullable(),
+    route: z.string().nullable(),
+    surface: z.string().nullable(),
+    contactEmail: z.string().nullable()
+}).strict();
+const guideEscalationStatusOutput = z.object({
+    ok: z.boolean(),
+    status: z.enum(["created", "unavailable", "error"]),
+    message: z.string(),
+    supportRequestId: z.string().optional()
+}).strict();
+const guideDataPartOutput = z.object({
+    type: z.string(),
+    id: z.string().optional(),
+    data: z.unknown()
+}).strict();
+const guideEscalateOutput = z.object({
+    ok: z.literal(true),
+    supportRequest: guideSupportRequestOutput,
+    escalationStatus: guideEscalationStatusOutput,
+    dataParts: z.array(guideDataPartOutput)
+}).strict();
+function createGuideEscalateToSupportAction(guide) {
+    return {
+        name: "guide_escalate_to_support",
+        description: "Create an idempotent local support request when the user clearly asks for human help or the answer requires support authority.",
+        input: guideEscalateInput,
+        output: guideEscalateOutput,
+        audience: ["signed-in", "public"],
+        policy: allowAll,
+        annotations: {
+            title: "Escalate to support",
+            idempotentHint: true
+        },
+        requiresInternalControl: true,
+        handler: async (ctx, input) => {
+            const control = ctx.control;
+            if (!control)
+                throw new GuideHttpError("Support storage is unavailable", 500);
+            if (guide.support.mode === "off")
+                throw new GuideHttpError("Support is disabled", 404);
+            if (principalOnBehalfOf(ctx.principal).kind === "public" && guide.support.requireContactForPublic && !input.contactEmail?.trim()) {
+                throw new GuideHttpError("Contact email is required", 400);
+            }
+            const conversationId = ctx.conversationId ?? null;
+            const runId = ctx.runId ?? null;
+            const toolCallId = ctx.toolCallId ?? null;
+            const idempotencyKey = await guideSupportIdempotencyKey({
+                conversationId,
+                runId,
+                toolCallId,
+                actionName: "guide_escalate_to_support"
+            });
+            const subject = input.subject?.trim() || input.reason.trim().slice(0, 120) || "Support request";
+            const result = await createSupportRequest(ctx, {
+                sourceKind: "guide",
+                idempotencyKey,
+                subject,
+                body: input.body.trim(),
+                transcriptSummary: input.transcriptSummary?.trim().slice(0, 4000),
+                transcriptEvidence: input.transcriptEvidence?.trim().slice(0, 8000),
+                category: "support",
+                confidence: 50,
+                docsConsulted: input.sources,
+                sources: input.sources,
+                escalationReason: input.reason.trim(),
+                createdMessageId: input.createdMessageId?.trim(),
+                contactEmail: input.contactEmail?.trim()
+            });
+            return guideSupportActionResult({
+                id: result.supportRequestId,
+                status: result.status,
+                subject,
+                createdAt: result.createdAt,
+                conversationId: result.conversationId,
+                route: result.route,
+                surface: result.surface,
+                contactEmail: result.contactEmail
+            });
+        }
+    };
+}
+async function guideSupportIdempotencyKey(input) {
+    const digest = await sha256Hex([input.conversationId ?? "", input.runId ?? "", input.toolCallId ?? "", input.actionName].join("|"));
+    return `guide_support:${digest.slice(0, 48)}`;
+}
+function guideSupportActionResult(row) {
+    const supportRequest = {
+        supportRequestId: row.id,
+        status: row.status,
+        subject: row.subject,
+        createdAt: row.createdAt,
+        conversationId: row.conversationId,
+        route: row.route,
+        surface: row.surface,
+        contactEmail: row.contactEmail
+    };
+    return {
+        ok: true,
+        supportRequest,
+        escalationStatus: {
+            ok: true,
+            status: "created",
+            message: "Support request created.",
+            supportRequestId: row.id
+        },
+        dataParts: [
+            { type: raybaseAgentDataPartTypes.supportRequestCreated, data: supportRequest },
+            {
+                type: raybaseAgentDataPartTypes.escalationStatus,
+                data: {
+                    ok: true,
+                    status: "created",
+                    message: "Support request created.",
+                    supportRequestId: row.id
+                }
+            }
+        ]
+    };
+}
+export function guideControl(ctx) {
+    return createRaybaseDb(ctx.env, ctx.schema, ctx.appMigrations).control;
+}
+//# sourceMappingURL=guide.js.map

package/dist/guide.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./guide.js";
+export * from "./guide-client.js";
+export * from "./guide-corpus.js";
+export * from "./guide-tables.js";
+export * from "./runtime.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./guide.js";
+export * from "./guide-client.js";
+export * from "./guide-corpus.js";
+export * from "./guide-tables.js";
+export * from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,28 @@
+export type GuideInstallOptions = {
+    template?: "tanstack-start" | "react-router" | "astro-emdash";
+};
+export declare const guideModuleManifest: {
+    readonly schemaVersion: 1;
+    readonly id: "guide";
+    readonly name: "Raybase Guide";
+    readonly packageName: "@raybase/guide";
+    readonly version: "0.1.0";
+    readonly skills: readonly ["raybase-guide"];
+    readonly commands: readonly ["guide enable", "guide disable", "guide index", "guide status"];
+    readonly doctorHooks: readonly ["guide"];
+};
+export declare const guideModuleInstaller: {
+    readonly schemaVersion: 1;
+    readonly id: "guide";
+    readonly name: "Raybase Guide";
+    readonly packageName: "@raybase/guide";
+    readonly version: "0.1.0";
+    readonly skills: readonly ["raybase-guide"];
+    readonly commands: readonly ["guide enable", "guide disable", "guide index", "guide status"];
+    readonly doctorHooks: readonly ["guide"];
+};
+export declare function guideInstallRecipe(_options?: GuideInstallOptions): {
+    dependencies: string[];
+    skills: string[];
+};
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,cAAc,GAAG,cAAc,CAAC;CAC/D,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;CAStB,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;;CAAsB,CAAC;AAExD,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,mBAAwB;;;EAKpE"}

package/dist/install.js

@@ -0,0 +1,18 @@
+export const guideModuleManifest = {
+    schemaVersion: 1,
+    id: "guide",
+    name: "Raybase Guide",
+    packageName: "@raybase/guide",
+    version: "0.1.0",
+    skills: ["raybase-guide"],
+    commands: ["guide enable", "guide disable", "guide index", "guide status"],
+    doctorHooks: ["guide"]
+};
+export const guideModuleInstaller = guideModuleManifest;
+export function guideInstallRecipe(_options = {}) {
+    return {
+        dependencies: ["@raybase/guide", "@raybase/agent-ui", "@assistant-ui/react"],
+        skills: ["raybase-guide"]
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,aAAa,EAAE,CAAC;IAChB,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,gBAAgB;IAC7B,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,CAAC,eAAe,CAAC;IACzB,QAAQ,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,CAAC;IAC1E,WAAW,EAAE,CAAC,OAAO,CAAC;CACd,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAExD,MAAM,UAAU,kBAAkB,CAAC,WAAgC,EAAE;IACnE,OAAO;QACL,YAAY,EAAE,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,qBAAqB,CAAC;QAC5E,MAAM,EAAE,CAAC,eAAe,CAAC;KAC1B,CAAC;AACJ,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,19 @@
+import { type RaybaseAction, type RaybaseModule, type RaybaseModuleRuntimeContribution, type RaybaseModuleRuntimeContext } from "@raybase/core";
+import { type GuideConfig } from "./guide.js";
+import type { GuideCorpusDocument } from "./guide-corpus.js";
+export type GuideModuleOptions<Env = any> = {
+    config?: GuideConfig;
+    corpus?: GuideCorpusDocument[];
+    actions?: Array<RaybaseAction<any, any, Env>>;
+    mode?: "actions" | "knowledge-only";
+    endpoint?: string;
+    agent?: {
+        name?: string;
+        title?: string;
+        model?: string;
+        maxOutputTokens?: number;
+    };
+};
+export declare function guideModule<Env = any>(options?: GuideModuleOptions<Env>): RaybaseModule<Env>;
+export declare function guideRuntime<Env>(ctx: RaybaseModuleRuntimeContext<Env>, options: GuideModuleOptions<Env>): RaybaseModuleRuntimeContribution<Env>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,KAAK,gCAAgC,EACrC,KAAK,2BAA2B,EAEjC,MAAM,eAAe,CAAC;AACvB,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,MAAM,MAAM,kBAAkB,CAAC,GAAG,GAAG,GAAG,IAAI;IAC1C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH,CAAC;AAIF,wBAAgB,WAAW,CAAC,GAAG,GAAG,GAAG,EAAE,OAAO,GAAE,kBAAkB,CAAC,GAAG,CAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAMhG;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,2BAA2B,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,gCAAgC,CAAC,GAAG,CAAC,CAoGhJ"}