@corgelabs/corge 0.0.1 → 1.0.1

package/dist/router/service.js

@@ -0,0 +1,339 @@
+import { getRequestListener } from '@hono/node-server';
+import { defineSecret } from 'firebase-functions/params';
+import { onRequest } from 'firebase-functions/v2/https';
+import { onTaskDispatched } from 'firebase-functions/v2/tasks';
+import { Hono } from 'hono';
+import { bodyLimit } from 'hono/body-limit';
+import { cors } from 'hono/cors';
+import { z } from 'zod';
+import { coreAttachmentsRoutes, getRegisteredAttachmentTypes, registerAttachmentTypes } from '../attachments';
+import { coreAuthRoutes } from '../auth';
+import { coreChatRoutes, mcpRoute } from '../chat';
+import { CORE_CONFIG, SECRET_NAMES } from '../config';
+import { registerCollections } from '../db';
+import { coreEmailRoutes, registerEmailTemplates } from '../emails';
+import { coreFilesRoutes } from '../files';
+import { Core } from '../index';
+import { corePaymentRoutes, registerPlans, registerProducts } from '../payments';
+import { buildHealthRoute, buildRoutesListRoute, buildTaskCancelRoute, buildTaskSignalRoute, buildTaskStatusRoute, TaskWaitDetachedSignal } from '../tasks';
+import { isRespondAsyncPreferred, mergeCoreAndDomainRoutes, RouterGuardEngine } from './guard';
+export class RouterService {
+    #core;
+    #guard;
+    constructor(coreClient) {
+        this.#core = coreClient;
+        this.#guard = new RouterGuardEngine(coreClient);
+    }
+    applyRateLimit = (...args) => this.#guard.applyRateLimit(...args);
+    authenticateRequest = (...args) => this.#guard.authenticateRequest(...args);
+    #createCloudFunctions = (app, devApp, workflowRegistry) => {
+        const emailProvider = CORE_CONFIG.emails.provider;
+        const paymentProvider = CORE_CONFIG.payments.provider;
+        const emailSecrets = [
+            ...(emailProvider === 'resend' ? ['RESEND_API_KEY', 'EMAIL_WEBHOOK_SECRET'] : []),
+            ...(emailProvider === 'sendgrid' ? ['SENDGRID_API_KEY', 'EMAIL_WEBHOOK_SECRET'] : [])
+        ];
+        const paymentSecrets = [
+            ...(paymentProvider === 'stripe' ? ['STRIPE_API_KEY', 'STRIPE_WEBHOOK_SECRET', 'STRIPE_SANDBOX_API_KEY', 'STRIPE_SANDBOX_WEBHOOK_SECRET'] : []),
+            ...(paymentProvider === 'dodo' ? ['DODO_API_KEY', 'DODO_WEBHOOK_SECRET', 'DODO_SANDBOX_API_KEY', 'DODO_SANDBOX_WEBHOOK_SECRET'] : [])
+        ];
+        const secretNames = [...new Set([...SECRET_NAMES, ...emailSecrets, ...paymentSecrets, ...CORE_CONFIG.secrets])];
+        const sharedOpts = {
+            region: CORE_CONFIG.region,
+            memory: CORE_CONFIG.cloudRun.memory,
+            cpu: CORE_CONFIG.cloudRun.cpu,
+            secrets: secretNames.map((name) => defineSecret(name))
+        };
+        const httpOpts = { ...sharedOpts, ...CORE_CONFIG.cloudRun.http };
+        const workerOpts = { ...sharedOpts, ...CORE_CONFIG.cloudRun.worker };
+        const httpHandler = onRequest(httpOpts, getRequestListener((req) => app.fetch(req)));
+        const devHttpHandler = onRequest(httpOpts, getRequestListener((req) => devApp.fetch(req)));
+        const workerConfig = {
+            ...workerOpts,
+            invoker: [CORE_CONFIG.serviceAccount, CORE_CONFIG.computeAccount],
+            retryConfig: { maxAttempts: CORE_CONFIG.tasks.maxAttempts, minBackoffSeconds: 2, maxBackoffSeconds: 20 },
+            rateLimits: { maxConcurrentDispatches: 1000, maxDispatchesPerSecond: 500 }
+        };
+        const tasksHandler = onTaskDispatched(workerConfig, async (req) => {
+            try {
+                await this.#core.internals.workflows.execute({ ...req.data, isDev: false }, workflowRegistry);
+            }
+            catch (err) {
+                if (!this.#core.errors.isStaleWorkerEpochError(err))
+                    throw err;
+            }
+        });
+        const devTasksHandler = onTaskDispatched(workerConfig, async (req) => {
+            try {
+                await this.#core.internals.workflows.execute({ ...req.data, isDev: true }, workflowRegistry);
+            }
+            catch (err) {
+                if (!this.#core.errors.isStaleWorkerEpochError(err))
+                    throw err;
+            }
+        });
+        const fnName = CORE_CONFIG.gcpProject;
+        const functions = {
+            [fnName]: httpHandler,
+            [`${fnName}-dev`]: devHttpHandler,
+            [`${fnName}-tasks`]: tasksHandler,
+            [`${fnName}-tasks-dev`]: devTasksHandler
+        };
+        return { httpHandler, devHttpHandler, tasksHandler, devTasksHandler, functions };
+    };
+    #makeCtx = (env, userId, role, mode, input, step = this.#core.internals.workflows.createStepRunner('rest'), c, params, query, rawBody) => ({
+        core: new Core({ env, userId, role, step }),
+        c: c,
+        env,
+        userId,
+        role,
+        mode,
+        step,
+        allWithRollback: this.#core.internals.workflows.allWithRollback,
+        input,
+        params: (params ?? (c ? c.req.param() : {})),
+        query: (query ?? (c ? c.req.query() : {})),
+        ...(rawBody !== undefined ? { rawBody } : {})
+    });
+    #respondAsync202 = (c, taskId) => {
+        if (c) {
+            c.header('Preference-Applied', 'respond-async');
+            c.header('Location', `/api/tasks/${taskId}`);
+            return c.json({ taskId, status: 'running', pollUrl: `/api/tasks/${taskId}` }, 202);
+        }
+        return { taskId, status: 'running', pollUrl: `/api/tasks/${taskId}` };
+    };
+    #executeRouteCore = async (opts) => {
+        const { key, wfName, cfg, mode, runTask, parseOut, env, userId, role, parsed, parsedParams, parsedQuery, rawBody, c, wait } = opts;
+        await this.#guard.enforceGuard(c, cfg, userId, parsed, role);
+        const dedupeKey = (cfg.idempotencyKey ? cfg.idempotencyKey(parsed, { userId }) : undefined) ??
+            (c?.req.header('idempotency-key')?.trim() || undefined);
+        const runWithStep = (m, fn) => {
+            const step = this.#core.internals.workflows.createStepRunner(m);
+            return this.#core.internals.context.run({ env, userId, role, step }, async () => fn(this.#makeCtx(env, userId, role, m, parsed, step, c, parsedParams, parsedQuery, rawBody)));
+        };
+        if (mode === 'rest') {
+            const executeRest = () => runWithStep('rest', cfg.handler);
+            const out = dedupeKey
+                ? await this.#guard.withHttpIdempotency(key, dedupeKey, userId, Boolean(env.isDev), executeRest)
+                : await executeRest();
+            return parseOut(out);
+        }
+        const cached = cfg.shortCircuit ? await runWithStep('workflow', cfg.shortCircuit) : undefined;
+        if (cached !== undefined && cached !== null)
+            return parseOut(cached);
+        try {
+            const dispatched = await this.#core.internals.workflows.dispatch(wfName, runTask, parsed, {
+                mode: 'workflow',
+                ...(cfg.timeout !== undefined ? { timeout: cfg.timeout } : {}),
+                ...(dedupeKey ? { dedupeKey } : {}),
+                wait,
+                ...(wait && c ? { maxWaitMs: CORE_CONFIG.limits.maxWaitMs, signal: c.req.raw?.signal } : {}),
+                userId,
+                userRole: role
+            });
+            return !wait ? this.#respondAsync202(c, dispatched.taskId) : parseOut(dispatched);
+        }
+        catch (err) {
+            if (err instanceof TaskWaitDetachedSignal)
+                return this.#respondAsync202(c, err.taskId);
+            throw err;
+        }
+    };
+    #registerRouteSpecAndTools = (key, wfName, mode, cfg, description, inputSchema, runTask, invoke, workflowRegistry, routeRegistryItems) => {
+        const method = (cfg.method ?? 'POST').toUpperCase();
+        const path = cfg.path ?? `/${key}`;
+        const deadlineSeconds = cfg.timeout
+            ? Math.max(15, Math.ceil(this.#core.errors.parseDuration(cfg.timeout, 540_000) / 1000))
+            : undefined;
+        routeRegistryItems.push({
+            id: key,
+            mode,
+            method,
+            path,
+            ...(mode === 'workflow' || cfg.workflowName ? { workflowName: wfName } : {}),
+            auth: cfg.auth ?? 'user',
+            description,
+            mcp: cfg.mcp === true,
+            tool: cfg.tool !== false,
+            ...(cfg.input ? { input: cfg.input } : {}),
+            ...(cfg.output ? { output: cfg.output } : {}),
+            ...(cfg.guard ? { guard: cfg.guard } : {})
+        });
+        if (mode === 'workflow' || cfg.workflowName) {
+            workflowRegistry[wfName] = {
+                name: wfName,
+                description,
+                input: inputSchema,
+                output: cfg.output,
+                mode,
+                ...(deadlineSeconds !== undefined ? { deadlineSeconds } : {}),
+                guard: cfg.guard,
+                runTask,
+                invoke
+            };
+        }
+        if (cfg.tool !== false || cfg.mcp === true || mode === 'workflow' || cfg.workflowName) {
+            const registerToolUnder = (toolName, mcp, tool) => this.#core.internals.registry.registerWorkflowTool(toolName, {
+                description,
+                input: inputSchema,
+                mcp,
+                tool,
+                execute: (inp, u) => invoke(inp, u)
+            });
+            registerToolUnder(wfName, cfg.mcp === true, cfg.tool !== false);
+            if (key !== wfName && cfg.tool !== false)
+                registerToolUnder(key, false, true);
+        }
+    };
+    #buildRouteInvoker = (key, cfg, workflowRegistry, routeRegistryItems) => {
+        const mode = cfg.mode ?? 'rest';
+        const wfName = cfg.workflowName ?? key;
+        const inputSchema = (cfg.input ?? z.object({}));
+        const description = cfg.description ?? wfName;
+        const parseOut = (out) => (out instanceof Response ? out : cfg.output ? cfg.output.parse(out) : out);
+        const runTask = async (taskInput, step) => {
+            const current = new Core();
+            const uid = current.userId || CORE_CONFIG.auth.adminUserId;
+            return cfg.handler(this.#makeCtx(current.env, uid, current.role, mode, taskInput, step));
+        };
+        const invoke = async (rawInput, userId, c, explicitRole, opts) => {
+            const env = c?.env ?? this.#core.env;
+            const authLevel = cfg.auth ?? 'user';
+            const role = this.#core.internals.auth.resolveUserRole(userId, explicitRole ?? c?.get('userRole'));
+            if (authLevel !== 'public' && authLevel !== 'none' && authLevel !== false && !userId) {
+                return this.#core.errors.httpError(401, 'Unauthorized', 'UNAUTHORIZED');
+            }
+            if ((authLevel === 'admin' || authLevel === 'api-key') && role !== 'admin' && userId !== CORE_CONFIG.auth.adminUserId) {
+                return this.#core.errors.httpError(403, 'Forbidden', 'FORBIDDEN');
+            }
+            const parsedParams = cfg.params && c ? cfg.params.parse(c.req.param()) : c?.req.param() ?? {};
+            const parsedQuery = cfg.query && c ? cfg.query.parse(c.req.query()) : c?.req.query() ?? {};
+            const parsed = cfg.input ? cfg.input.parse(rawInput ?? {}) : rawInput;
+            return this.#core.internals.context.run({ env, userId, role }, () => this.#executeRouteCore({ key, wfName, cfg, mode, runTask, parseOut, env, userId, role, parsed, parsedParams, parsedQuery, rawBody: opts?.rawBody, c, wait: opts?.wait !== false }));
+        };
+        this.#registerRouteSpecAndTools(key, wfName, mode, cfg, description, inputSchema, runTask, invoke, workflowRegistry, routeRegistryItems);
+        return invoke;
+    };
+    #mountRoute = (app, cfg, invoke) => {
+        const method = (cfg.method ?? 'POST').toLowerCase();
+        const routePath = cfg.path ?? '/';
+        app[method](routePath, async (c) => {
+            const userId = await this.authenticateRequest(c, cfg);
+            const role = this.#core.internals.auth.resolveUserRole(userId, c.get('userRole'));
+            let rawInput;
+            let rawText;
+            if (cfg.rawBody && method !== 'get') {
+                rawText = await c.req.text().catch(() => '');
+                if (cfg.input) {
+                    try {
+                        rawInput = rawText ? JSON.parse(rawText) : {};
+                    }
+                    catch {
+                        rawInput = {};
+                    }
+                }
+                else {
+                    rawInput = rawText;
+                }
+            }
+            else if (cfg.input && method !== 'get') {
+                rawInput = await c.req.json().catch(() => ({}));
+            }
+            const wait = !(cfg.mode === 'workflow' && isRespondAsyncPreferred(c));
+            const out = await invoke(rawInput, userId, c, role, {
+                wait,
+                ...(rawText !== undefined ? { rawBody: rawText } : {})
+            });
+            return out instanceof Response ? out : c.json(out);
+        });
+    };
+    #createHonoApp = (isDev, allRoutes, routeInvokers) => {
+        const app = new Hono().basePath('/api');
+        app.use('*', cors({
+            origin: (origin, c) => {
+                if (!origin)
+                    return undefined;
+                if (CORE_CONFIG.auth.allowedOrigins.some((p) => typeof p === 'string' ? p === origin : p.test(origin))) {
+                    return origin;
+                }
+                try {
+                    if (origin === new URL(c.req.url).origin)
+                        return origin;
+                }
+                catch { }
+                return null;
+            },
+            credentials: true
+        }));
+        app.use('*', bodyLimit({
+            maxSize: CORE_CONFIG.limits.maxBodyBytes,
+            onError: () => this.#core.errors.httpError(413, 'Payload too large (max 25MiB)', 'PAYLOAD_TOO_LARGE')
+        }));
+        app.onError((err) => this.#core.errors.toHttpError(err).getResponse());
+        app.use('*', async (c, next) => {
+            const env = { ...this.#core.env, ...(c.env ?? {}), isDev };
+            c.env = env;
+            await this.#core.internals.context.run({ env, userId: CORE_CONFIG.auth.adminUserId, role: 'admin' }, () => next());
+        });
+        for (const r of Object.values(allRoutes))
+            this.#mountRoute(app, r, routeInvokers.get(r));
+        app.all('/mcp', async (c) => {
+            const userId = await this.authenticateRequest(c, { path: '/mcp', auth: 'user' });
+            return mcpRoute(c.req.raw, userId, this.#core.internals.context.getMcpTools());
+        });
+        return app;
+    };
+    createApp = (init = {}) => {
+        if (init.emailTemplates)
+            registerEmailTemplates(init.emailTemplates, true);
+        if (init.plans)
+            registerPlans(init.plans, true);
+        if (init.products)
+            registerProducts(init.products, true);
+        registerCollections(init.collections ?? {}, true);
+        this.#core.internals.registry.registerAgents(init.agents ?? {}, true);
+        if (init.attachmentTypes)
+            registerAttachmentTypes(init.attachmentTypes);
+        this.#core.internals.registry.registerContextCatalog(init.context ?? [], true);
+        this.#core.internals.registry.clearWorkflowTools();
+        const overrides = init.coreRouteOverrides ?? {};
+        const workflowRegistry = {};
+        const routeRegistryItems = [];
+        const attachmentTypesDesc = Object.entries(getRegisteredAttachmentTypes())
+            .map(([k, v]) => `${k} (${v.description})`)
+            .join('; ');
+        const rawCoreRoutes = {
+            health: buildHealthRoute(),
+            ...coreAuthRoutes,
+            ...coreFilesRoutes,
+            ...coreChatRoutes,
+            ...coreAttachmentsRoutes,
+            ...coreEmailRoutes,
+            ...corePaymentRoutes,
+            'routes.list': buildRoutesListRoute(() => routeRegistryItems),
+            'tasks.status': buildTaskStatusRoute(),
+            'tasks.signal': buildTaskSignalRoute(),
+            'tasks.cancel': buildTaskCancelRoute()
+        };
+        const allRoutes = mergeCoreAndDomainRoutes(rawCoreRoutes, overrides, attachmentTypesDesc, init.routes ?? {});
+        const routeInvokers = new Map();
+        for (const [id, r] of Object.entries(allRoutes)) {
+            routeInvokers.set(r, this.#buildRouteInvoker(id, r, workflowRegistry, routeRegistryItems));
+        }
+        this.#core.internals.workflows.registerRuntime(workflowRegistry);
+        const createApp = (isDev = false) => this.#createHonoApp(isDev, allRoutes, routeInvokers);
+        const app = createApp(false);
+        const devApp = createApp(true);
+        const cloudFunctions = this.#createCloudFunctions(app, devApp, workflowRegistry);
+        return {
+            createApp,
+            app,
+            devApp,
+            workflowRegistry,
+            agents: this.#core.internals.registry.getRegisteredAgents(),
+            ...cloudFunctions
+        };
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/router/service.js.map

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

package/dist/tasks/index.d.ts

@@ -0,0 +1,4 @@
+export * from './schema';
+export { TasksService } from './service';
+export { buildHealthRoute, buildRoutesIntrospection, buildRoutesListRoute, buildTaskCancelRoute, buildTaskSignalRoute, buildTaskStatusRoute, renderApiContractMarkdown } from './routes';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,UAAU,CAAA"}

package/dist/tasks/index.js

@@ -0,0 +1,4 @@
+export * from './schema';
+export { TasksService } from './service';
+export { buildHealthRoute, buildRoutesIntrospection, buildRoutesListRoute, buildTaskCancelRoute, buildTaskSignalRoute, buildTaskStatusRoute, renderApiContractMarkdown } from './routes';
+//# sourceMappingURL=index.js.map

package/dist/tasks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,UAAU,CAAA"}

package/dist/tasks/routes.d.ts

@@ -0,0 +1,54 @@
+import type { Context } from 'hono';
+import type { z } from 'zod';
+import { type AppEnv } from '../config';
+import { signalTaskBody, type RouteIntrospectionItem, type RouteRegistryItem, type RoutesIntrospectionResponse } from './schema';
+import { zodToJsonSchemaSafe } from './utils';
+export { signalTaskBody, zodToJsonSchemaSafe, type RouteIntrospectionItem, type RouteRegistryItem, type RoutesIntrospectionResponse };
+export declare const buildRoutesIntrospection: (routeItems: RouteRegistryItem[], scope?: 'all' | 'custom' | 'core') => RoutesIntrospectionResponse;
+export declare const renderApiContractMarkdown: (meta: RoutesIntrospectionResponse) => string;
+export declare const buildHealthRoute: () => {
+    mode: 'rest';
+    handler: () => Promise<{
+        ok: boolean;
+        status: 'healthy';
+        service: string;
+        env: "dev" | "prod";
+        timestamp: string;
+    }>;
+};
+export declare const buildRoutesListRoute: (routeItems: () => RouteRegistryItem[]) => {
+    mode: 'rest';
+    handler: ({ c }: {
+        c: Context<AppEnv>;
+    }) => Promise<Response | RoutesIntrospectionResponse>;
+};
+export declare const buildTaskStatusRoute: () => {
+    mode: 'rest';
+    handler: ({ c }: {
+        c: Context<AppEnv>;
+    }) => Promise<unknown>;
+};
+export declare const buildTaskSignalRoute: () => {
+    mode: 'rest';
+    input: z.ZodObject<{
+        signal: z.ZodString;
+        payload: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>;
+    handler: ({ c, input }: {
+        c: Context<AppEnv>;
+        input: z.infer<typeof signalTaskBody>;
+    }) => Promise<{
+        taskId: string;
+        signaled: true;
+    }>;
+};
+export declare const buildTaskCancelRoute: () => {
+    mode: 'rest';
+    handler: ({ c }: {
+        c: Context<AppEnv>;
+    }) => Promise<{
+        taskId: string;
+        status: 'cancelled';
+    }>;
+};
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/tasks/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,WAAW,CAAA;AAIpD,OAAO,EACL,cAAc,EACd,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EACjC,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAE7C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EACjC,CAAA;AAeD,eAAO,MAAM,wBAAwB,eACvB,iBAAiB,EAAE,UACxB,KAAK,GAAG,QAAQ,GAAG,MAAM,KAC/B,2BAsCF,CAAA;AAED,eAAO,MAAM,yBAAyB,SAAU,2BAA2B,KAAG,MAqE7E,CAAA;AAED,eAAO,MAAM,gBAAgB;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO;;gBAEG,SAAS;;;;;CAKnB,CAAA;AAEF,eAAO,MAAM,oBAAoB,eAAgB,MAAM,iBAAiB,EAAE;IACxE,IAAI,EAAE,MAAM;IACZ,OAAO,UAAgB;QAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE;CAgB7C,CAAA;AAEF,eAAO,MAAM,oBAAoB;IAC/B,IAAI,EAAE,MAAM;IACZ,OAAO,UAAgB;QAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE;CA8B7C,CAAA;AAEF,eAAO,MAAM,oBAAoB;IAC/B,IAAI,EAAE,MAAM;IACZ,KAAK;;;;IACL,OAAO,iBAAuB;QAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;KAAE;;;;CAI3F,CAAA;AAEF,eAAO,MAAM,oBAAoB;IAC/B,IAAI,EAAE,MAAM;IACZ,OAAO,UAAgB;QAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE;;;;CAI7C,CAAA"}

package/dist/tasks/routes.js

@@ -0,0 +1,195 @@
+import { CORE_CONFIG } from '../config';
+import { collectionRegistry, getEffectiveRbac } from '../db';
+import { core } from '../index';
+import { CORE_ROUTE_DEFAULTS } from '../router';
+import { signalTaskBody } from './schema';
+import { zodToJsonSchemaSafe } from './utils';
+export { signalTaskBody, zodToJsonSchemaSafe };
+const summarizeGuards = (g) => {
+    if (!g)
+        return [];
+    const guards = [];
+    if (g.checkFileRef)
+        guards.push('checkFileRef');
+    if (g.checkUserId)
+        guards.push('checkUserId');
+    if (g.checkCollectionField) {
+        guards.push(`checkCollectionField:${g.checkCollectionField.collection}.${g.checkCollectionField.param}`);
+    }
+    if (g.requireEmailVerified)
+        guards.push('requireEmailVerified');
+    if (g.custom)
+        guards.push('custom');
+    return guards;
+};
+export const buildRoutesIntrospection = (routeItems, scope = 'all') => {
+    const filtered = routeItems.filter((r) => {
+        const isCore = r.id in CORE_ROUTE_DEFAULTS;
+        if (scope === 'core')
+            return isCore;
+        if (scope === 'custom')
+            return !isCore;
+        return true;
+    });
+    const routes = filtered.map((r) => ({
+        id: r.id,
+        method: r.method,
+        path: `/api${r.path}`,
+        mode: r.mode,
+        ...(r.workflowName ? { workflowName: r.workflowName } : {}),
+        auth: r.auth ?? 'user',
+        description: r.description,
+        mcp: Boolean(r.mcp),
+        tool: r.tool !== false,
+        guards: summarizeGuards(r.guard),
+        inputSchema: zodToJsonSchemaSafe(r.input),
+        outputSchema: zodToJsonSchemaSafe(r.output)
+    }));
+    const collections = {};
+    for (const [name, def] of collectionRegistry) {
+        collections[name] = {
+            relationType: def.userRelation?.type ?? '1:N',
+            rbac: getEffectiveRbac(name),
+            schema: zodToJsonSchemaSafe(def.schema)
+        };
+    }
+    return {
+        appName: CORE_CONFIG.appName,
+        generatedAt: new Date().toISOString(),
+        routes,
+        collections
+    };
+};
+export const renderApiContractMarkdown = (meta) => {
+    const coreRoutes = meta.routes.filter((r) => r.id in CORE_ROUTE_DEFAULTS);
+    const domainRoutes = meta.routes.filter((r) => !(r.id in CORE_ROUTE_DEFAULTS));
+    const renderRouteBlock = (r) => {
+        const lines = [
+            `### ${r.method} ${r.path}`,
+            `- **ID:** \`${r.id}\`${r.workflowName ? ` (Workflow: \`${r.workflowName}\`)` : ''}`,
+            `- **Mode:** \`${r.mode}\` | **Auth:** \`${String(r.auth)}\` | **Guards:** \`${r.guards.join(', ') || 'none'}\` | **MCP:** \`${r.mcp}\` | **Tool:** \`${r.tool}\``,
+            `- **Description:** ${r.description}`
+        ];
+        if (r.inputSchema) {
+            lines.push('', '**Input JSON Schema:**', '```json', JSON.stringify(r.inputSchema, null, 2), '```');
+        }
+        if (r.outputSchema) {
+            lines.push('', '**Output JSON Schema:**', '```json', JSON.stringify(r.outputSchema, null, 2), '```');
+        }
+        return lines.join('\n');
+    };
+    const collectionLines = [];
+    for (const [name, col] of Object.entries(meta.collections ?? {})) {
+        collectionLines.push(`### Collection: \`${name}\``, `- **User Relation:** \`${col.relationType}\``, `- **RBAC Matrix:** \`${JSON.stringify(col.rbac ?? {})}\``, ...(col.schema ? ['', '```json', JSON.stringify(col.schema, null, 2), '```'] : []));
+    }
+    return [
+        `# API Contract & Schema Reference — ${meta.appName}`,
+        '',
+        `> **Generated At:** \`${meta.generatedAt}\``,
+        '> **Agent Instruction:** This document is deterministically generated from runtime Zod schemas and route definitions. Treat it as the single source of truth for all HTTP endpoints, payloads, authentication levels, and Firestore collection models.',
+        '',
+        '## 1. Core Protocol & Architecture Conventions',
+        '',
+        '### 1.1. Authentication & Sessions (`auth`)',
+        '- **`public` / `none` / `false`**: No authentication required.',
+        '- **`user`**: Requires `Authorization: Bearer <idToken | SDK_API_KEY>` or HTTP-only `session` cookie.',
+        '- **`strict`**: Requires revocation-checked session verification (`verifySessionCookie(..., true)` / `_system/auth_revocations`).',
+        '- **`admin`**: Requires admin role (`SDK_API_KEY` or admin user claim).',
+        '- **Social OAuth & Account Recovery**: Use `POST /api/auth/sign-in/social` (`google` | `apple`), `POST /api/auth/email/send-verification`, `POST /api/auth/email/verify`, `POST /api/auth/password/forgot`, `POST /api/auth/password/reset`, `POST /api/auth/recovery-email/set`, `POST /api/auth/recovery-email/verify`, `POST /api/auth/account-recovery/initiate`, and `POST /api/auth/account-recovery/complete`.',
+        '',
+        '### 1.2. Content-Addressed Files (`FileRef`)',
+        '- All uploaded files use content-addressed IDs formatted as `<userId>_<sha256_24>` matching `/^[A-Za-z0-9_-]{1,128}_[a-f0-9]{24}$/`.',
+        '- Upload files via `POST /api/files` (`multipart/form-data` field `file`) before passing `ref` or `refs` to downstream endpoints.',
+        '',
+        '### 1.3. Execution Modes (`mode: "rest"` vs `mode: "workflow"`)',
+        '- **`mode: "rest"`**: Synchronous `200 OK` JSON response.',
+        '- **`mode: "workflow"`**: Durable Cloud Tasks workflow. May return `200 OK` directly (if resolved via `shortCircuit` cache or within wait budget) **OR** `202 Accepted` (`{ taskId, status: "running", pollUrl: "/api/tasks/<taskId>" }`) when `Prefer: respond-async` / `?wait=false` is passed.',
+        '- Poll task progress via `GET /api/tasks/:taskId`, send signals via `POST /api/tasks/:taskId/signal`, or cancel via `DELETE /api/tasks/:taskId`.',
+        '',
+        '### 1.4. Thin-Client AI Chat Streaming (`POST /api/chats/:chatId`)',
+        '- Send `{ message: { id?, role: "user", content, parts?, attachments? }, agentId?, model? }` to stream SSE responses and cancel active streams via `POST /api/chats/:chatId/cancel`.',
+        '',
+        '## 2. Core Endpoints Catalog',
+        '',
+        ...coreRoutes.map(renderRouteBlock),
+        '',
+        '## 3. Domain Endpoints Catalog',
+        '',
+        ...(domainRoutes.length > 0 ? domainRoutes.map(renderRouteBlock) : ['_No custom domain routes registered._']),
+        '',
+        '## 4. Registered Firestore Collections Catalog',
+        '',
+        ...collectionLines
+    ].join('\n');
+};
+export const buildHealthRoute = () => ({
+    mode: 'rest',
+    handler: async () => ({
+        ok: true,
+        status: 'healthy',
+        service: CORE_CONFIG.appName,
+        env: core.env.isDev ? 'dev' : 'prod',
+        timestamp: new Date().toISOString()
+    })
+});
+export const buildRoutesListRoute = (routeItems) => ({
+    mode: 'rest',
+    handler: async ({ c }) => {
+        const rawScope = c?.req.query('scope');
+        const scope = rawScope === 'custom' || rawScope === 'core' ? rawScope : 'all';
+        const format = c?.req.query('format');
+        const accept = c?.req.header('accept') ?? '';
+        const meta = buildRoutesIntrospection(routeItems(), scope);
+        if (format === 'md' || accept.includes('text/markdown')) {
+            return new Response(renderApiContractMarkdown(meta), {
+                status: 200,
+                headers: { 'content-type': 'text/markdown; charset=utf-8' }
+            });
+        }
+        return meta;
+    }
+});
+export const buildTaskStatusRoute = () => ({
+    mode: 'rest',
+    handler: async ({ c }) => {
+        const taskId = c.req.param('taskId') ?? '';
+        const status = await core.tasks.status(taskId);
+        if (status.status === 'running' ||
+            status.status === 'sleeping' ||
+            status.status === 'waiting_signal' ||
+            status.status === 'compensating') {
+            return c.json({
+                taskId,
+                status: status.status,
+                ...(status.progress ? { progress: status.progress } : {}),
+                pollUrl: `/api/tasks/${taskId}`
+            }, 202);
+        }
+        if (status.status === 'errored') {
+            return core.errors.httpError(502, status.error ?? 'Workflow task failed', 'WORKFLOW_ERROR');
+        }
+        if (status.status === 'cancelled') {
+            return core.errors.httpError(409, status.error ?? 'Workflow task cancelled', 'TASK_CANCELLED');
+        }
+        if (c.req.query('envelope') === 'true') {
+            return status;
+        }
+        return status.response;
+    }
+});
+export const buildTaskSignalRoute = () => ({
+    mode: 'rest',
+    input: signalTaskBody,
+    handler: async ({ c, input }) => {
+        const taskId = c.req.param('taskId') ?? '';
+        return core.tasks.signal(taskId, input.signal, input.payload);
+    }
+});
+export const buildTaskCancelRoute = () => ({
+    mode: 'rest',
+    handler: async ({ c }) => {
+        const taskId = c.req.param('taskId') ?? '';
+        return core.tasks.cancel(taskId);
+    }
+});
+//# sourceMappingURL=routes.js.map