@cursor/bdk 0.2.14 → 0.2.16

package/dist/internal/convert-grokbot/answers.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Answers for `bdk init --from-grokbot`: the create-agent answers an export
+ * uses, plus the export decisions. Grok Bot collects them in chat and passes
+ * an answers file; a TTY asks the same questions with the same defaults.
+ * Answers name secrets and connectors; they never carry secret values.
+ */
+import { type Channel } from "../interview/agent-questions.js";
+import { type Ask, type InterviewField } from "../interview/question.js";
+import type { Bot } from "./bot.js";
+export declare const GROKBOT_ANSWERS_VERSION = 1;
+export declare const KINDS: readonly ["skills", "routines", "plugins"];
+export declare const MEMORY_MODES: readonly ["skill", "kv", "drop"];
+export declare const CONNECTOR_AUTH: readonly ["cursor-account", "oauth", "secret"];
+export declare const DEPLOY_WHEN: readonly ["after-review", "now", "scheduled", "never"];
+export declare const SLACK_APPS: readonly ["new", "move"];
+export declare const SLACK_CUTOVERS: readonly ["manual", "after-deploy", "scheduled"];
+export type Kind = (typeof KINDS)[number];
+export interface Selection {
+    /** Slugs to keep; omitted keeps everything. */
+    include?: string[];
+    /** Slugs to leave behind, applied after `include`. */
+    exclude?: string[];
+}
+export interface ConnectorAnswer {
+    auth?: (typeof CONNECTOR_AUTH)[number];
+    /** Cursor account connector name (`cursor-account`). */
+    server?: string;
+    /** MCP server URL (`oauth`, `secret`). */
+    url?: string;
+    /** Secret name holding the bearer token (`secret`). */
+    secret?: string;
+}
+export interface SlackAnswers {
+    app?: (typeof SLACK_APPS)[number];
+    cutover?: (typeof SLACK_CUTOVERS)[number];
+    cutoverAt?: string;
+    teamPrefix?: string;
+    botName?: string;
+    justification?: string;
+}
+export interface GrokbotAnswers {
+    /** Editor hint pointing at the published JSON Schema; ignored. */
+    $schema?: string;
+    version?: number;
+    name?: string;
+    description?: string;
+    location?: string;
+    model?: string;
+    channels?: Channel[];
+    memory?: (typeof MEMORY_MODES)[number];
+    skills?: Selection;
+    routines?: Selection;
+    plugins?: Selection;
+    connectors?: Record<string, ConnectorAnswer>;
+    /** Routine slug → placeholder id → value. */
+    fillIns?: Record<string, Record<string, string>>;
+    secrets?: {
+        names?: string[];
+        reauth?: string[];
+    };
+    repo?: {
+        name?: string;
+        namespace?: string;
+    };
+    deploy?: {
+        when?: (typeof DEPLOY_WHEN)[number];
+        at?: string;
+    };
+    slack?: SlackAnswers;
+}
+/** A connector after defaults: one of the shapes its questions allow. */
+export type ResolvedConnector = {
+    auth: "cursor-account";
+    server: string;
+} | {
+    auth: "oauth";
+    url: string;
+} | {
+    auth: "secret";
+    url: string;
+    secret: string;
+};
+/** Slack answers after defaults; present exactly when the Slack channel is on. */
+export type ResolvedSlack = Required<Pick<SlackAnswers, "app" | "cutover" | "botName" | "justification">> & Pick<SlackAnswers, "cutoverAt" | "teamPrefix">;
+/** Answers after defaults: what the conversion and the export record read. */
+export type ResolvedAnswers = Omit<GrokbotAnswers, "connectors" | "repo" | "deploy" | "slack"> & Required<Pick<GrokbotAnswers, "version" | "name" | "description" | "location" | "model" | "channels">> & {
+    connectors?: Record<string, ResolvedConnector>;
+    repo: {
+        name: string;
+        namespace?: string;
+    };
+    deploy: {
+        when: (typeof DEPLOY_WHEN)[number];
+        at?: string;
+    };
+    slack?: ResolvedSlack;
+};
+/** The questions for one recipe, in asking order. */
+export declare function grokbotFields(bot: Bot): InterviewField[];
+export interface ResolveInput {
+    bot: Bot;
+    answers?: unknown;
+    interactive: boolean;
+    ask?: Ask;
+    out?: (text: string) => void;
+}
+export interface Resolved {
+    answers: ResolvedAnswers;
+    /** Answers filled from defaults without asking. */
+    defaulted: string[];
+    /** Answers given that this recipe never asks for. */
+    ignored: string[];
+}
+export type ResolveResult = ({
+    ok: true;
+} & Resolved) | {
+    ok: false;
+    error: string;
+};
+export declare function resolveAnswers(input: ResolveInput): Promise<ResolveResult>;
+/**
+ * JSON Schema for answers files, annotated from the questions so a chat
+ * client can render one widget per field: `title`, `description`, a static
+ * `default`, `x-labels` for choice labels, and `x-round` for the round.
+ */
+export declare function answersJsonSchema(): Record<string, unknown>;
+//# sourceMappingURL=answers.d.ts.map

package/dist/internal/convert-grokbot/answers.d.ts.map

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

package/dist/internal/convert-grokbot/answers.js

@@ -0,0 +1,443 @@
+/**
+ * Answers for `bdk init --from-grokbot`: the create-agent answers an export
+ * uses, plus the export decisions. Grok Bot collects them in chat and passes
+ * an answers file; a TTY asks the same questions with the same defaults.
+ * Answers name secrets and connectors; they never carry secret values.
+ */
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { envPrefixFromName } from "../../channels/slack/credentials.js";
+import { CLI_COMMAND_NAME } from "../distribution.js";
+import { MAX_SECRET_NAME_LENGTH, validateSettableSecretName } from "../hosting.js";
+import { AGENT_FIELDS, agentName, CHANNELS } from "../interview/agent-questions.js";
+import { checkedString, collectAnswers, field, listAnswer, } from "../interview/question.js";
+import { isRecord } from "../is-record.js";
+import { slugify } from "../slug.js";
+import { connectorUrlError, defaultSlackBotName, namespaceError, redactSecretValues, repoNameError, slackBotNameError, } from "./checks.js";
+import { formatIssues, versionSchema } from "./recipe.js";
+import { liveChannel } from "./routine.js";
+export const GROKBOT_ANSWERS_VERSION = 1;
+export const KINDS = ["skills", "routines", "plugins"];
+export const MEMORY_MODES = ["skill", "kv", "drop"];
+export const CONNECTOR_AUTH = ["cursor-account", "oauth", "secret"];
+export const DEPLOY_WHEN = ["after-review", "now", "scheduled", "never"];
+export const SLACK_APPS = ["new", "move"];
+export const SLACK_CUTOVERS = ["manual", "after-deploy", "scheduled"];
+const slug = z.string().regex(/^[a-z0-9][a-z0-9-]*$/, "must be a lowercase slug");
+const instant = z
+    .string()
+    .datetime({ offset: true, message: "must be an ISO 8601 time with a timezone" });
+const secretName = checkedString(validateSettableSecretName);
+const slackOn = (answers) => listAnswer(answers.channels).includes("slack");
+function agentField(id) {
+    const found = AGENT_FIELDS.find((f) => f.question.id === id);
+    if (found === undefined) {
+        throw new Error(`No create-agent question "${id}".`);
+    }
+    return found;
+}
+/** Identity, surface, and item choices; recipe defaults are patched in per bot. */
+const BASE_FIELDS = [
+    agentField("name"),
+    field("identity", {
+        id: "description",
+        label: "Description",
+        prompt: "What does the bot do, in a sentence or two?",
+    }, z.string().min(1)),
+    agentField("location"),
+    agentField("model"),
+    agentField("channels"),
+    field("export", {
+        id: "memory",
+        label: "Memory",
+        prompt: "What should happen to the bot's memories?",
+        hint: "skill: a knowledge skill the agent reads on demand. kv: data in bot/lib/memory-seed.json for your own seeding code (BDK has no built-in KV seed). drop: leave them behind.",
+        choices: [...MEMORY_MODES],
+        default: "skill",
+    }, z.enum(MEMORY_MODES)),
+    ...KINDS.map((kind) => field("export", {
+        id: `${kind}.include`,
+        label: `Include ${kind}`,
+        prompt: `Which ${kind} should come along?`,
+        multi: true,
+        default: "all",
+    }, z.array(slug))),
+];
+/** One set per recipe plugin; `*` is its slug and `{plugin}` its name. */
+const CONNECTOR_FIELDS = [
+    field("export", {
+        id: "connectors.*.auth",
+        label: "Auth",
+        prompt: "How should {plugin} authenticate?",
+        hint: `cursor-account: tools run through your Cursor account's connector, with no secret in the project. oauth: host OAuth against the server URL (\`${CLI_COMMAND_NAME} mcp oauth\`). secret: a bearer token read from a named secret.`,
+        choices: [...CONNECTOR_AUTH],
+        default: "cursor-account",
+    }, z.enum(CONNECTOR_AUTH)),
+    field("export", {
+        id: "connectors.*.server",
+        label: "Connector name",
+        prompt: "Name of the {plugin} connector in your Cursor account?",
+    }, z.string().min(1)),
+    field("export", { id: "connectors.*.url", label: "Server URL", prompt: "{plugin} MCP server URL?" }, checkedString(connectorUrlError)),
+    field("export", {
+        id: "connectors.*.secret",
+        label: "Secret name",
+        prompt: "Secret that holds the {plugin} token?",
+        hint: `A name only, like LINEAR_API_KEY. Set the value later with \`${CLI_COMMAND_NAME} secrets set\`.`,
+    }, secretName),
+];
+/** One per routine placeholder; `*.*` is the routine slug and placeholder id. */
+const FILL_IN_FIELD = field("export", {
+    id: "fillIns.*.*",
+    label: "{placeholder}",
+    prompt: "{routine}: {placeholder}?",
+    optional: true,
+}, z.string().min(1));
+const DECISION_FIELDS = [
+    field("export", {
+        id: "secrets.names",
+        label: "Secret names",
+        prompt: "Other secret names to list in SECRETS.md?",
+        hint: "Names only, UPPER_SNAKE_CASE. Names the generated files read are always listed.",
+        multi: true,
+        other: true,
+        optional: true,
+    }, z.array(secretName)),
+    field("export", {
+        id: "secrets.reauth",
+        label: "Fresh sign-in",
+        prompt: "Which other connectors need a fresh sign-in?",
+        hint: "OAuth connectors always do; they are listed without asking.",
+        multi: true,
+        optional: true,
+    }, z.array(slug)),
+    field("export", {
+        id: "repo.name",
+        label: "Repository",
+        prompt: `Repository name? (recorded only; ${CLI_COMMAND_NAME} does not create repositories)`,
+        default: (answers) => answers.name?.slice(0, 100),
+    }, checkedString(repoNameError)),
+    field("export", {
+        id: "repo.namespace",
+        label: "Repository namespace",
+        prompt: "Repository owner or namespace? (recorded only)",
+        optional: true,
+    }, checkedString(namespaceError)),
+    field("export", {
+        id: "deploy.when",
+        label: "Deploy",
+        prompt: `When should it deploy? (recorded only; ${CLI_COMMAND_NAME} does not deploy)`,
+        choices: [...DEPLOY_WHEN],
+        default: "after-review",
+    }, z.enum(DEPLOY_WHEN)),
+    field("export", {
+        id: "deploy.at",
+        label: "Deploy at",
+        prompt: "Deploy at (ISO 8601 with a timezone)?",
+        when: (answers) => answers["deploy.when"] === "scheduled",
+    }, instant),
+    field("export", {
+        id: "slack.app",
+        label: "Slack app",
+        prompt: "Mint a new Slack app, or move the bot's existing one?",
+        choices: [...SLACK_APPS],
+        default: "new",
+        when: slackOn,
+    }, z.enum(SLACK_APPS)),
+    field("export", {
+        id: "slack.cutover",
+        label: "Slack cutover",
+        prompt: "When should Slack traffic switch to the BDK agent?",
+        choices: [...SLACK_CUTOVERS],
+        default: "manual",
+        when: slackOn,
+    }, z.enum(SLACK_CUTOVERS)),
+    field("export", {
+        id: "slack.cutoverAt",
+        label: "Slack cutover at",
+        prompt: "Switch Slack traffic at (ISO 8601 with a timezone)?",
+        when: (answers) => slackOn(answers) && answers["slack.cutover"] === "scheduled",
+    }, instant),
+    field("export", {
+        id: "slack.teamPrefix",
+        label: "Team prefix",
+        prompt: "Team prefix the Slack bot name must start with?",
+        optional: true,
+        when: slackOn,
+    }, z.string().min(1)),
+    field("export", {
+        id: "slack.botName",
+        label: "Slack bot name",
+        prompt: "Slack bot display name?",
+        hint: 'Starts with the team prefix and must not contain "Grok".',
+        check: (value, answers) => slackBotNameError(value, answers["slack.teamPrefix"]),
+        when: slackOn,
+    }, z.string().min(1)),
+    field("export", {
+        id: "slack.justification",
+        label: "Security justification",
+        prompt: "Security justification for the Slack app review?",
+        hint: "What the bot does in Slack and why it needs its scopes. Saved for the Slack app setup.",
+        default: (answers) => answers.description,
+        when: slackOn,
+    }, z.string().min(1)),
+];
+/** Every question an answers file can answer, in asking order. */
+const FIELDS = [
+    ...BASE_FIELDS,
+    ...CONNECTOR_FIELDS,
+    FILL_IN_FIELD,
+    ...DECISION_FIELDS,
+];
+/** Whether an item survives the include answer; an unasked include keeps everything. */
+function isSelected(answers, kind, item) {
+    const include = answers[`${kind}.include`];
+    return include === undefined || listAnswer(include).includes(item);
+}
+function exportName(name) {
+    const candidate = slugify(name, "grokbot");
+    return agentName.safeParse(candidate).success ? candidate : `${candidate}-bot`;
+}
+/** The channels the recipe's live triggers use. */
+function botChannels(bot) {
+    const used = new Set([...bot.skills, ...bot.routines].flatMap((item) => item.triggers).map(liveChannel));
+    return CHANNELS.filter((channel) => used.has(channel)).join(", ") || "none";
+}
+function defaultSecretName(plugin) {
+    const prefix = envPrefixFromName(plugin.slug).slice(0, MAX_SECRET_NAME_LENGTH - "MCP__TOKEN".length);
+    const name = `${prefix}_TOKEN`;
+    return validateSettableSecretName(name) === undefined ? name : `MCP_${name}`;
+}
+function patch(f, question) {
+    return { ...f, question: { ...f.question, ...question } };
+}
+function pluginFields(plugin) {
+    const id = (key) => `connectors.${plugin.slug}.${key}`;
+    const included = (answers) => isSelected(answers, "plugins", plugin.slug);
+    const auth = (answers) => (included(answers) ? answers[id("auth")] : undefined);
+    const patches = {
+        auth: { when: included },
+        server: { default: plugin.name, when: (answers) => auth(answers) === "cursor-account" },
+        url: { when: (answers) => auth(answers) === "oauth" || auth(answers) === "secret" },
+        secret: { default: defaultSecretName(plugin), when: (answers) => auth(answers) === "secret" },
+    };
+    return CONNECTOR_FIELDS.map((f) => {
+        const key = f.question.id.split(".").at(-1) ?? "";
+        return patch(f, {
+            id: id(key),
+            prompt: f.question.prompt.replace("{plugin}", plugin.name),
+            ...patches[key],
+        });
+    });
+}
+function fillInField(routine, fill) {
+    return patch(FILL_IN_FIELD, {
+        id: `fillIns.${routine.slug}.${fill.id}`,
+        label: fill.label,
+        prompt: `${routine.name}: ${fill.label}?`,
+        when: (answers) => isSelected(answers, "routines", routine.slug),
+    });
+}
+/** The questions for one recipe, in asking order. */
+export function grokbotFields(bot) {
+    const patches = {
+        name: { default: exportName(bot.name) },
+        description: { default: bot.description },
+        channels: { default: botChannels(bot) },
+        memory: { when: () => bot.memory.length > 0 },
+        "secrets.reauth": {
+            choices: bot.plugins.map((plugin) => ({ value: plugin.slug, label: plugin.name })),
+            when: () => bot.plugins.length > 0,
+        },
+        "slack.botName": {
+            default: (answers) => defaultSlackBotName(bot.name, answers["slack.teamPrefix"]),
+        },
+    };
+    for (const kind of KINDS) {
+        const items = bot[kind];
+        patches[`${kind}.include`] = {
+            choices: items.map((item) => ({ value: item.slug, label: item.name })),
+            when: () => items.length > 0,
+        };
+    }
+    return [
+        ...BASE_FIELDS.map((f) => patch(f, patches[f.question.id])),
+        ...bot.plugins.flatMap(pluginFields),
+        ...bot.routines.flatMap((routine) => routine.fillIns.map((fill) => fillInField(routine, fill))),
+        ...DECISION_FIELDS.map((f) => patch(f, patches[f.question.id])),
+    ];
+}
+function child(node, key) {
+    if (!Object.hasOwn(node, key)) {
+        node[key] = {};
+    }
+    return node[key];
+}
+/** Schemas nested by dotted id; a `*` segment becomes a record. */
+function shapeOf(entries) {
+    const tree = {};
+    for (const [id, schema] of entries) {
+        const path = id.split(".");
+        const leaf = path.pop() ?? id;
+        path.reduce(child, tree)[leaf] = schema;
+    }
+    return mapValues(tree, (node) => toZod(node).optional());
+}
+function toZod(node) {
+    if (node instanceof z.ZodType) {
+        return node;
+    }
+    const record = node;
+    return Object.hasOwn(record, "*")
+        ? z.record(z.string(), toZod(record["*"]))
+        : z.object(mapValues(record, (value) => toZod(value).optional())).strict();
+}
+function mapValues(record, fn) {
+    return Object.fromEntries(Object.entries(record).map(([key, value]) => [key, fn(value)]));
+}
+const EXCLUDES = KINDS.map((kind) => [`${kind}.exclude`, z.array(slug)]);
+/** An answers file: every field optional, unknown fields rejected. */
+const answersSchema = z
+    .object({
+    $schema: z.string().optional(),
+    version: versionSchema(GROKBOT_ANSWERS_VERSION),
+    ...shapeOf([...FIELDS.map((f) => [f.question.id, f.schema]), ...EXCLUDES]),
+})
+    .strict();
+export async function resolveAnswers(input) {
+    const file = answersSchema.safeParse(input.answers ?? {});
+    if (!file.success) {
+        return { ok: false, error: `Invalid answers: ${formatIssues(file.error)}` };
+    }
+    const { $schema: _schema, version: _version, ...rest } = file.data;
+    const given = foldExcludes(flatten(rest), input.bot);
+    const fields = grokbotFields(input.bot);
+    const collected = await collectAnswers({
+        questions: fields.map((f) => f.question),
+        given,
+        interactive: input.interactive,
+        ask: input.ask,
+        out: input.out,
+        show: (text) => redactSecretValues(text).text,
+        missing: (question) => `add ${question.id} to the answers file (${question.prompt})`,
+    });
+    if (!collected.ok) {
+        return collected;
+    }
+    const multi = new Set(fields.filter((f) => f.question.multi).map((f) => f.question.id));
+    const answers = answersSchema.parse({
+        version: GROKBOT_ANSWERS_VERSION,
+        ...unflatten(collected.answers, multi),
+    });
+    return {
+        ok: true,
+        answers,
+        defaulted: collected.defaulted,
+        ignored: Object.keys(given).filter((id) => !(id in collected.answers)),
+    };
+}
+/** `exclude` narrows `include` (everything when unset or `all`), so only `include` is asked. */
+function foldExcludes(given, bot) {
+    for (const kind of KINDS) {
+        const exclude = given[`${kind}.exclude`];
+        if (exclude === undefined || bot[kind].length === 0) {
+            continue;
+        }
+        const include = given[`${kind}.include`];
+        const kept = (include === undefined || include.trim() === "all"
+            ? bot[kind].map((item) => item.slug)
+            : listAnswer(include)).filter((item) => !listAnswer(exclude).includes(item));
+        delete given[`${kind}.exclude`];
+        given[`${kind}.include`] = kept.length === 0 ? "none" : kept.join(", ");
+    }
+    return given;
+}
+function flatten(value, prefix = "", out = {}) {
+    if (Array.isArray(value)) {
+        out[prefix] = value.length === 0 ? "none" : value.join(", ");
+    }
+    else if (isRecord(value)) {
+        for (const [key, nested] of Object.entries(value)) {
+            flatten(nested, prefix === "" ? key : `${prefix}.${key}`, out);
+        }
+    }
+    else if (value !== undefined) {
+        out[prefix] = String(value);
+    }
+    return out;
+}
+function unflatten(answers, multi) {
+    const out = {};
+    for (const [id, raw] of Object.entries(answers)) {
+        const path = id.split(".");
+        const leaf = path.pop() ?? id;
+        path.reduce(child, out)[leaf] = multi.has(id) ? listAnswer(raw) : raw;
+    }
+    return out;
+}
+/**
+ * JSON Schema for answers files, annotated from the questions so a chat
+ * client can render one widget per field: `title`, `description`, a static
+ * `default`, `x-labels` for choice labels, and `x-round` for the round.
+ */
+export function answersJsonSchema() {
+    const json = zodToJsonSchema(answersSchema, {
+        $refStrategy: "none",
+        target: "jsonSchema7",
+    });
+    for (const f of FIELDS) {
+        annotate(json, f.question.id.split("."), fieldMeta(f));
+    }
+    for (const kind of KINDS) {
+        annotate(json, [kind, "exclude"], {
+            title: `Exclude ${kind}`,
+            description: `Which ${kind} should stay behind, applied after the include list.`,
+            "x-round": "export",
+        });
+    }
+    annotate(json, ["$schema"], { description: "Path or URL of this schema, for editors. Ignored." });
+    annotate(json, ["version"], { description: "Answers format version." });
+    annotate(json, ["connectors"], {
+        description: "How each recipe plugin connects, keyed by plugin slug.",
+    });
+    annotate(json, ["fillIns"], {
+        description: "Values for recipe placeholders, keyed by routine slug, then placeholder id (e.g. slack_channel). Unfilled placeholders stay in the text.",
+    });
+    return {
+        $schema: json.$schema,
+        title: `${CLI_COMMAND_NAME} init --from-grokbot answers`,
+        description: "Decisions for exporting a Grok Bot recipe. Every field is optional: a missing answer takes the default an interactive run offers. Names only, never secret values.",
+        ...json,
+    };
+}
+function fieldMeta({ question, round }) {
+    const meta = {
+        title: question.label,
+        description: question.hint === undefined ? question.prompt : `${question.prompt} ${question.hint}`,
+        "x-round": round,
+    };
+    if (typeof question.default === "string" && question.default !== "all") {
+        meta.default = question.multi ? listAnswer(question.default) : question.default;
+    }
+    const labeled = (question.choices ?? []).filter((choice) => typeof choice !== "string");
+    if (labeled.length > 0) {
+        meta["x-labels"] = Object.fromEntries(labeled.map((choice) => [choice.value, choice.label]));
+    }
+    return meta;
+}
+function annotate(json, path, meta) {
+    let node = json;
+    for (const key of path) {
+        const parent = isRecord(node) ? node : {};
+        node =
+            key === "*"
+                ? parent.additionalProperties
+                : isRecord(parent.properties)
+                    ? parent.properties[key]
+                    : undefined;
+    }
+    if (!isRecord(node)) {
+        throw new Error(`The answers JSON Schema has no ${path.join(".")}.`);
+    }
+    Object.assign(node, meta);
+}

package/dist/internal/convert-grokbot/bot.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The bot a recipe describes. Slugs are claimed here once, so questions,
+ * answers, and output paths all name items the same way. Names become one
+ * printable line and prose loses unprintable characters, so recipe text is
+ * safe to show in a terminal or a list.
+ */
+import type { GrokbotRecipe } from "./recipe.js";
+import { type CronTrigger, type FillIn, type Trigger } from "./routine.js";
+export interface BotSkill {
+    slug: string;
+    name: string;
+    description: string;
+    body: string;
+    /** The skill's own schedule, when its frontmatter has one. */
+    triggers: CronTrigger[];
+}
+export interface BotRoutine {
+    slug: string;
+    name: string;
+    description: string;
+    job: string;
+    triggers: Trigger[];
+    fillIns: FillIn[];
+}
+export interface BotPlugin {
+    slug: string;
+    name: string;
+}
+export interface BotMemory {
+    kind?: string;
+    createdAt?: string;
+    content: string;
+}
+export interface Bot {
+    name: string;
+    description: string;
+    avatar?: {
+        color?: string;
+        shape?: string;
+    };
+    skills: BotSkill[];
+    routines: BotRoutine[];
+    plugins: BotPlugin[];
+    memory: BotMemory[];
+    /** Slug of the skill a new user starts with. */
+    gettingStarted?: string;
+    unknownFields: string[];
+}
+export declare function botFromRecipe(recipe: GrokbotRecipe, unknownFields?: string[]): Bot;
+//# sourceMappingURL=bot.d.ts.map

package/dist/internal/convert-grokbot/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/internal/convert-grokbot/bot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,MAAM,EAGX,KAAK,OAAO,EACb,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAOD,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,GAAE,MAAM,EAAO,GAAG,GAAG,CA6CtF"}