@abyssinia-labs/wake-convex 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abyssinia Labs LLC
+
+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/README.md

@@ -1,3 +1,155 @@
-# Temporary Holding Version
+# @abyssinia-labs/wake-convex
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The server half of [wake/v1](../../docs/spec/wake-v1.md) as a Convex
+component. Add it to a Convex app and your users' coding agents (Claude
+Code, Codex, Cursor) start on their own machines when someone assigns them
+work or mentions them, through [Wake](../../README.md).
+
+You decide **what** summons an agent (an assignment, a mention) and write
+the prompt. The component keeps everything wake/v1 requires: pair codes and
+place keys (stored as hashes), places, the summons's life (asking, open,
+claimed, done, failed, dropped), the race to claim, the thirty-minute
+unclaimed notice, and the three functions and two routes Wake calls.
+
+## Install
+
+```bash
+bun add @abyssinia-labs/wake-convex
+```
+
+`convex/convex.config.ts`:
+
+```ts
+import { defineApp } from "convex/server";
+import wake from "@abyssinia-labs/wake-convex/convex.config";
+
+const app = defineApp();
+app.use(wake);
+export default app;
+```
+
+## Serve wake/v1
+
+**The three functions** must be called `wake:pending`, `wake:claim` and
+`wake:finish`, so they go in `convex/wake.ts`:
+
+```ts
+import { exposeApi } from "@abyssinia-labs/wake-convex";
+import { components } from "./_generated/api";
+
+export const { pending, claim, finish } = exposeApi(components.wake, { app: "acme" });
+```
+
+They take no auth: the place key is the credential, and the component
+checks it. `app` is your app's name in wake/v1: lower case, digits and
+dashes. Wake uses it as a folder name and as the name of your MCP server in
+the agent.
+
+**The two routes**, in `convex/http.ts`:
+
+```ts
+import { httpRouter } from "convex/server";
+import { registerRoutes } from "@abyssinia-labs/wake-convex";
+import { components } from "./_generated/api";
+
+const http = httpRouter();
+registerRoutes(http, components.wake, { app: "acme", keyPrefix: "acme_" });
+export default http;
+```
+
+**Discovery.** Serve `https://<your domain>/.well-known/wake` with
+`discovery({ convexUrl, httpBase })`, from wherever your domain is served.
+If your domain is your Convex site, pass `discovery` to `registerRoutes`
+and it is served for you.
+
+## Wire it to your app
+
+```ts
+import { pairCommand, Wake } from "@abyssinia-labs/wake-convex";
+import { components } from "./_generated/api";
+
+const wake = new Wake(components.wake, { app: "acme" });
+```
+
+**Pairing.** Give your agents a tool (MCP or API) that answers "pair Wake".
+Make the code in an action or HTTP action (it needs real randomness):
+
+```ts
+const { code } = await wake.issueCode(ctx, {
+  agent: agent._id,          // the calling agent
+  agentName: agent.name,
+  owner: agent.ownerId,      // its person
+  tool: "claude",            // the program that asked, when you can tell
+});
+return { command: pairCommand("acme.dev", code) };
+```
+
+**Summoning.** When a person assigns a ticket to an agent or mentions it:
+
+```ts
+await wake.summon(ctx, {
+  agent: agent._id,
+  owner: agent.ownerId,
+  askedBy: userId,           // a person; an agent's own write never summons
+  subject: ticket._id,       // one live summons per agent per subject
+  kind: "assigned",
+  target: { kind: "ticket", ref: "ACME-70", url: "https://acme.dev/t/ACME-70" },
+  repo: "acme/widgets",      // optional, with branch: Wake makes a worktree there
+  branch: "acme-70-fix-the-thing",
+  prompt,                    // which tools to call and how to finish; never the text that asked
+});
+```
+
+When the owner asks, it opens at once. When someone else asks, it waits for
+the owner's `wake.answer(ctx, { id, yes })`. A summons Wake would refuse (a
+control character in `ref`, a non-https `url`, a branch like `../main`) is
+refused here with `INVALID_SUMMONS`. Never name a repository's default
+branch: Wake refuses to run on it.
+
+**The rest:**
+
+| Call | When |
+| --- | --- |
+| `wake.settle(ctx, { subject, agent?, kind?, state, reason })` | It stopped being wanted: unassigned, closed, answered from a live session. |
+| `wake.forSubject(ctx, subject)` | Show each agent's latest summons where it was made: state, reason, `unclaimed` after thirty minutes. |
+| `wake.places(ctx, agent)` / `wake.forgetPlace(ctx, { agent, place })` | An agent's machines, on your agents screen. |
+| `wake.revokeAgent(ctx, agent)` | In the same mutation that revokes an agent: its keys, codes and waiting summonses end. |
+| `wake.deleteScope(ctx, scope)` | A tenant (workspace) is deleted: one batch of its rows; call again until `done`. Pass `scope` when you pair and summon. |
+
+The component has no `ctx.auth`: check who may do what in your functions
+before you call it.
+
+## Check it
+
+```bash
+wakectl check acme.dev
+```
+
+It probes your app the way Wake will, with inputs your app must refuse, so
+it pairs nothing and changes nothing.
+
+In your own tests, register the component with convex-test:
+
+```ts
+import wake from "@abyssinia-labs/wake-convex/test";
+
+const t = convexTest(schema, modules);
+wake.register(t);
+```
+
+## Develop
+
+```bash
+bun install
+bun run --cwd packages/convex test
+bun run --cwd packages/convex typecheck
+```
+
+Code generation needs a Convex deployment. A local, anonymous one is
+enough: `CONVEX_AGENT_MODE=anonymous bunx convex init`, then
+`bunx convex codegen --component-dir ./src/component`. Commit what it
+writes under `_generated`.
+
+## License
+
+[MIT](LICENSE) © Abyssinia Labs LLC

package/dist/client/index.d.ts

@@ -0,0 +1,153 @@
+import { type GenericActionCtx, type GenericDataModel, type GenericMutationCtx, type GenericQueryCtx } from "convex/server";
+import type { ComponentApi } from "../component/_generated/component.js";
+export { registerRoutes } from "./routes.js";
+export type { ComponentApi };
+type RunQuery = Pick<GenericQueryCtx<GenericDataModel>, "runQuery">;
+type RunMutation = Pick<GenericMutationCtx<GenericDataModel>, "runQuery" | "runMutation">;
+type RunAction = Pick<GenericActionCtx<GenericDataModel>, "runQuery" | "runMutation">;
+export type Tool = "claude" | "codex" | "cursor";
+export type Target = {
+    kind: string;
+    ref: string;
+    url: string;
+};
+export type WakeOptions = {
+    /** The app's name in wake/v1: lower case, digits and dashes (`gatherd`). */
+    app: string;
+};
+/** The discovery document, for `GET https://<domain>/.well-known/wake`. */
+export declare function discovery(o: {
+    convexUrl: string;
+    httpBase: string;
+}): {
+    version: "wake/v1";
+    convexUrl: string;
+    httpBase: string;
+};
+/** What the agent tells its person to run. */
+export declare function pairCommand(domain: string, code: string): string;
+export declare class Wake {
+    readonly component: ComponentApi;
+    readonly app: string;
+    constructor(component: ComponentApi, options: WakeOptions);
+    /**
+     * A pair code for the calling agent, to answer its "pair Wake" request.
+     * Needs real randomness, so call it from an action or an HTTP action.
+     */
+    issueCode(ctx: RunAction, o: {
+        agent: string;
+        agentName: string;
+        owner: string;
+        scope?: string;
+        tool?: Tool;
+    }): Promise<{
+        code: string;
+        expiresAt: number;
+    }>;
+    /** A person asked an agent about a subject: see the component's `summon`. */
+    summon(ctx: RunMutation, o: {
+        agent: string;
+        owner: string;
+        askedBy: string;
+        scope?: string;
+        subject: string;
+        kind: string;
+        target: Target;
+        repo?: string;
+        branch?: string;
+        prompt: string;
+    }): Promise<string>;
+    /** The owner's yes or no to a summons someone else made. Check it is the owner first. */
+    answer(ctx: RunMutation, o: {
+        id: string;
+        yes: boolean;
+    }): Promise<void>;
+    /** End what still waits about a subject: unassigned, closed, answered. */
+    settle(ctx: RunMutation, o: {
+        subject: string;
+        agent?: string;
+        kind?: string;
+        state: "done" | "dropped";
+        reason: string;
+    }): Promise<number>;
+    /** Each agent's latest summons about a subject, to show where it was made. */
+    forSubject(ctx: RunQuery, subject: string): Promise<{
+        agent: string;
+        askedBy: string;
+        at: number;
+        id: string;
+        kind: string;
+        owner: string;
+        reason?: string;
+        state: "asking" | "open" | "claimed" | "done" | "failed" | "dropped";
+        unclaimed: boolean;
+        updatedAt: number;
+    }[]>;
+    /** An agent's paired machines. */
+    places(ctx: RunQuery, agent: string): Promise<{
+        id: string;
+        lastSeenAt?: number;
+        machine: string;
+        pairedAt: number;
+        platform: string;
+        tool?: "claude" | "codex" | "cursor";
+    }[]>;
+    /** Forget one of an agent's machines. Check who may first. */
+    forgetPlace(ctx: RunMutation, o: {
+        agent: string;
+        place: string;
+    }): Promise<boolean>;
+    /**
+     * The host deleted a tenant: one batch of what the component keeps for
+     * `scope`. Call it again until `done`, from the host's deletion steps.
+     */
+    deleteScope(ctx: RunMutation, scope: string): Promise<{
+        deleted: number;
+        done: boolean;
+    }>;
+    /** The host revoked an agent: its keys, codes and waiting summonses end with it. */
+    revokeAgent(ctx: RunMutation, agent: string): Promise<void>;
+}
+/**
+ * wake:pending, wake:claim and wake:finish, for the host's `convex/wake.ts`:
+ *
+ *   export const { pending, claim, finish } = exposeApi(components.wake, { app: "acme" });
+ *
+ * They take no auth: the place key is the credential (the spec), and the
+ * component checks it.
+ */
+export declare function exposeApi(component: ComponentApi, options: WakeOptions): {
+    pending: import("convex/server").RegisteredQuery<"public", {
+        key: string;
+    }, Promise<{
+        app: string;
+        at: number;
+        branch?: string;
+        id: string;
+        kind: string;
+        repo?: string;
+        target: {
+            kind: string;
+            ref: string;
+            url: string;
+        };
+    }[]>>;
+    claim: import("convex/server").RegisteredMutation<"public", {
+        id: string;
+        key: string;
+    }, Promise<{
+        claimed: true;
+        run: {
+            prompt: string;
+        };
+    } | {
+        claimed: false;
+    }>>;
+    finish: import("convex/server").RegisteredMutation<"public", {
+        id: string;
+        key: string;
+        outcome: "done" | "failed";
+        reason?: string | undefined;
+    }, Promise<null>>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

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

package/dist/client/index.js

@@ -0,0 +1,111 @@
+// What a host app imports: `Wake`, to make and settle summonses and manage
+// places from its own functions; `exposeApi`, which gives wake:pending,
+// wake:claim and wake:finish their public names; and `registerRoutes`,
+// which mounts the pair and forget routes. docs/spec/wake-v1.md is the
+// protocol these serve.
+import { mutationGeneric, queryGeneric, } from "convex/server";
+import { v } from "convex/values";
+import { CODE_TTL_MS, hashSecret, newPairCode, normalizeCode } from "../component/keys.js";
+import { APP } from "../component/shape.js";
+export { registerRoutes } from "./routes.js";
+function checkApp(app) {
+    if (!APP.test(app))
+        throw new Error(`wake/v1 app names are ${APP}; "${app}" is not one.`);
+    return app;
+}
+/** The discovery document, for `GET https://<domain>/.well-known/wake`. */
+export function discovery(o) {
+    return { version: "wake/v1", convexUrl: o.convexUrl, httpBase: o.httpBase };
+}
+/** What the agent tells its person to run. */
+export function pairCommand(domain, code) {
+    return `wakectl pair ${domain} ${code}`;
+}
+export class Wake {
+    component;
+    app;
+    constructor(component, options) {
+        this.component = component;
+        this.app = checkApp(options.app);
+    }
+    /**
+     * A pair code for the calling agent, to answer its "pair Wake" request.
+     * Needs real randomness, so call it from an action or an HTTP action.
+     */
+    async issueCode(ctx, o) {
+        const code = newPairCode();
+        const expiresAt = Date.now() + CODE_TTL_MS;
+        await ctx.runMutation(this.component.places.storeCode, {
+            ...o,
+            codeHash: await hashSecret(normalizeCode(code)),
+            expiresAt,
+        });
+        return { code, expiresAt };
+    }
+    /** A person asked an agent about a subject: see the component's `summon`. */
+    async summon(ctx, o) {
+        return await ctx.runMutation(this.component.summonses.summon, o);
+    }
+    /** The owner's yes or no to a summons someone else made. Check it is the owner first. */
+    async answer(ctx, o) {
+        await ctx.runMutation(this.component.summonses.answer, o);
+    }
+    /** End what still waits about a subject: unassigned, closed, answered. */
+    async settle(ctx, o) {
+        return await ctx.runMutation(this.component.summonses.settle, o);
+    }
+    /** Each agent's latest summons about a subject, to show where it was made. */
+    async forSubject(ctx, subject) {
+        return await ctx.runQuery(this.component.summonses.forSubject, { subject });
+    }
+    /** An agent's paired machines. */
+    async places(ctx, agent) {
+        return await ctx.runQuery(this.component.places.list, { agent });
+    }
+    /** Forget one of an agent's machines. Check who may first. */
+    async forgetPlace(ctx, o) {
+        return await ctx.runMutation(this.component.places.remove, o);
+    }
+    /**
+     * The host deleted a tenant: one batch of what the component keeps for
+     * `scope`. Call it again until `done`, from the host's deletion steps.
+     */
+    async deleteScope(ctx, scope) {
+        return await ctx.runMutation(this.component.scopes.deleteScope, { scope });
+    }
+    /** The host revoked an agent: its keys, codes and waiting summonses end with it. */
+    async revokeAgent(ctx, agent) {
+        await ctx.runMutation(this.component.places.revokeAgent, { agent });
+    }
+}
+/**
+ * wake:pending, wake:claim and wake:finish, for the host's `convex/wake.ts`:
+ *
+ *   export const { pending, claim, finish } = exposeApi(components.wake, { app: "acme" });
+ *
+ * They take no auth: the place key is the credential (the spec), and the
+ * component checks it.
+ */
+export function exposeApi(component, options) {
+    const app = checkApp(options.app);
+    return {
+        pending: queryGeneric({
+            args: { key: v.string() },
+            handler: async (ctx, args) => await ctx.runQuery(component.wire.pending, { key: args.key, app }),
+        }),
+        claim: mutationGeneric({
+            args: { key: v.string(), id: v.string() },
+            handler: async (ctx, args) => await ctx.runMutation(component.wire.claim, args),
+        }),
+        finish: mutationGeneric({
+            args: {
+                key: v.string(),
+                id: v.string(),
+                outcome: v.union(v.literal("done"), v.literal("failed")),
+                reason: v.optional(v.string()),
+            },
+            handler: async (ctx, args) => await ctx.runMutation(component.wire.finish, args),
+        }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/client/routes.d.ts

@@ -0,0 +1,27 @@
+import { type GenericActionCtx, type GenericDataModel, type HttpRouter } from "convex/server";
+import type { ComponentApi } from "../component/_generated/component.js";
+type Ctx = Pick<GenericActionCtx<GenericDataModel>, "runMutation">;
+export declare function handlePair(ctx: Ctx, req: Request, component: ComponentApi, o: {
+    app: string;
+    keyPrefix?: string;
+}): Promise<Response>;
+export declare function handleForget(ctx: Ctx, req: Request, component: ComponentApi): Promise<Response>;
+/**
+ * Mounts the two routes in the host's router:
+ *
+ *   registerRoutes(http, components.wake, { app: "acme" });
+ *
+ * With `discovery`, it also serves `/.well-known/wake`, for an app whose
+ * domain is its Convex site; any other app serves `discovery()` itself.
+ */
+export declare function registerRoutes(http: HttpRouter, component: ComponentApi, o: {
+    app: string;
+    keyPrefix?: string;
+    pathPrefix?: string;
+    discovery?: {
+        convexUrl: string;
+        httpBase: string;
+    };
+}): void;
+export {};
+//# sourceMappingURL=routes.d.ts.map

package/dist/client/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/client/routes.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEhB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE,KAAK,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,CAAC;AAmBnE,wBAAsB,UAAU,CAC9B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,YAAY,EACvB,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,OAAO,CAAC,QAAQ,CAAC,CA6CnB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,QAAQ,CAAC,CAKnB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,YAAY,EACvB,CAAC,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD,GACA,IAAI,CAuBN"}

package/dist/client/routes.js

@@ -0,0 +1,104 @@
+// `POST /wake/v1/pair` and `POST /wake/v1/forget` (the spec's "Pairing"),
+// mounted in the host's `convex/http.ts`. They run in the host, as HTTP
+// actions must, so the place key is made with real randomness here and
+// only its hash reaches the component.
+import { httpActionGeneric, } from "convex/server";
+import { ConvexError } from "convex/values";
+import { hashSecret, newPlaceKey, normalizeCode } from "../component/keys.js";
+import { APP } from "../component/shape.js";
+function json(status, body) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { "content-type": "application/json", "cache-control": "no-store" },
+    });
+}
+function refuse(status, error, message) {
+    return json(status, { error, message });
+}
+function text(value, max) {
+    return typeof value === "string" && value.trim() !== "" && value.length <= max
+        ? value.trim()
+        : null;
+}
+export async function handlePair(ctx, req, component, o) {
+    let body = null;
+    try {
+        body = await req.json();
+    }
+    catch {
+        // Not JSON: refused below like any other wrong body.
+    }
+    const record = typeof body === "object" && body !== null ? body : {};
+    const machine = typeof record.machine === "object" && record.machine !== null
+        ? record.machine
+        : {};
+    const code = text(record.code, 20);
+    const name = text(machine.name, 100);
+    const platform = text(machine.platform, 40);
+    if (!code || !name || !platform) {
+        return refuse(400, "invalid_body", "Send { code, machine: { name, platform } }.");
+    }
+    const placeKey = newPlaceKey(o.keyPrefix);
+    try {
+        const paired = await ctx.runMutation(component.places.pair, {
+            codeHash: await hashSecret(normalizeCode(code)),
+            keyHash: await hashSecret(placeKey),
+            machine: name,
+            platform,
+        });
+        return json(200, {
+            placeKey,
+            app: o.app,
+            agent: {
+                id: paired.agent,
+                name: paired.agentName,
+                ...(paired.tool === undefined ? {} : { tool: paired.tool }),
+            },
+        });
+    }
+    catch (error) {
+        if (error instanceof ConvexError && error.data === "CODE_INVALID") {
+            return refuse(400, "code_invalid", "That code is wrong, used or older than ten minutes. Ask your agent for a new one.");
+        }
+        throw error;
+    }
+}
+export async function handleForget(ctx, req, component) {
+    const key = req.headers.get("authorization")?.match(/^Bearer\s+(\S+)$/i)?.[1];
+    if (!key)
+        return refuse(401, "unpaired", "Send the place key as a bearer token.");
+    const found = await ctx.runMutation(component.places.forget, { keyHash: await hashSecret(key) });
+    return found ? new Response(null, { status: 204 }) : refuse(401, "unpaired", "No such place.");
+}
+/**
+ * Mounts the two routes in the host's router:
+ *
+ *   registerRoutes(http, components.wake, { app: "acme" });
+ *
+ * With `discovery`, it also serves `/.well-known/wake`, for an app whose
+ * domain is its Convex site; any other app serves `discovery()` itself.
+ */
+export function registerRoutes(http, component, o) {
+    if (!APP.test(o.app))
+        throw new Error(`wake/v1 app names are ${APP}; "${o.app}" is not one.`);
+    const prefix = (o.pathPrefix ?? "/wake/v1").replace(/\/+$/, "");
+    http.route({
+        path: `${prefix}/pair`,
+        method: "POST",
+        handler: httpActionGeneric((ctx, req) => handlePair(ctx, req, component, o)),
+    });
+    http.route({
+        path: `${prefix}/forget`,
+        method: "POST",
+        handler: httpActionGeneric((ctx, req) => handleForget(ctx, req, component)),
+    });
+    const found = o.discovery;
+    if (found) {
+        http.route({
+            path: "/.well-known/wake",
+            method: "GET",
+            handler: httpActionGeneric(async () => json(200, { version: "wake/v1", convexUrl: found.convexUrl, httpBase: found.httpBase })),
+        });
+    }
+}
+//# sourceMappingURL=routes.js.map

package/dist/client/routes.js.map

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

package/dist/component/_generated/api.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Generated `api` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import type * as keys from "../keys.js";
+import type * as places from "../places.js";
+import type * as scopes from "../scopes.js";
+import type * as shape from "../shape.js";
+import type * as summonses from "../summonses.js";
+import type * as wire from "../wire.js";
+import type { ApiFromModules, FilterApi, FunctionReference } from "convex/server";
+declare const fullApi: ApiFromModules<{
+    keys: typeof keys;
+    places: typeof places;
+    scopes: typeof scopes;
+    shape: typeof shape;
+    summonses: typeof summonses;
+    wire: typeof wire;
+}>;
+/**
+ * A utility for referencing Convex functions in your app's public API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export declare const api: FilterApi<typeof fullApi, FunctionReference<any, "public">>;
+/**
+ * A utility for referencing Convex functions in your app's internal API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = internal.myModule.myFunction;
+ * ```
+ */
+export declare const internal: FilterApi<typeof fullApi, FunctionReference<any, "internal">>;
+export declare const components: {};
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/component/_generated/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,IAAI,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,KAAK,IAAI,MAAM,YAAY,CAAC;AAExC,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAGvB,QAAA,MAAM,OAAO,EAAE,cAAc,CAAC;IAC5B,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,EAAE,OAAO,IAAI,CAAC;CACnB,CAAiB,CAAC;AAEnB;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,EAAE,SAAS,CACzB,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CACjB,CAAC;AAElB;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAC9B,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,CACnB,CAAC;AAElB,eAAO,MAAM,UAAU,EAAqC,EAAE,CAAC"}