@kvman/kvbuilder 0.2.0

package/dist/preview/preview-call.js.map

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

package/dist/preview/preview-start.d.ts

@@ -0,0 +1,8 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function startPreview(ctx: Ctx, input: {
+    extensions: string[];
+    preset?: string | undefined;
+}): Promise<{
+    url: string;
+}>;
+//# sourceMappingURL=preview-start.d.ts.map

package/dist/preview/preview-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-start.d.ts","sourceRoot":"","sources":["../../src/preview/preview-start.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAsEvD,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBnI"}

package/dist/preview/preview-start.js

@@ -0,0 +1,103 @@
+import { setTimeout as delay } from 'node:timers/promises';
+import { ProblemError, z } from '@kvman/sdk';
+import { insideWorkspace, projectAt } from "../folders.js";
+import { kvbuilderProblem } from "../problems.js";
+import { binFailureProblem, binFailureSchema, binFile } from "../run-bin.js";
+import { lastLines } from "../run-program.js";
+import { cleanUpPreview, recordKey } from "./preview-state.js";
+// `preview start` (plan 09 §9.3, ADR 0010, 21): `kvman-preview` runs through the process service in the workspace
+// folder, so its folders and preset stay as given; the call answers once the ready line `{ url }` shows in the
+// process log. When the bin exits first, its failure line becomes its Problem.
+const pollEveryMs = 200;
+const readySchema = z.object({ url: z.string() });
+function readyUrl(log) {
+    for (const line of log.split('\n')) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const ready = readySchema.safeParse(parsed);
+        if (ready.success)
+            return ready.data.url;
+    }
+    return undefined;
+}
+// The bin's failure: the last JSON failure line becomes its Problem; with none, `kvbuilder/PREVIEW_FAILED` with
+// the last lines.
+function previewFailure(log) {
+    const lines = log.split('\n');
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        const line = lines[index];
+        if (line === undefined || line.trim() === '')
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const failure = binFailureSchema.safeParse(parsed);
+        if (!failure.success)
+            continue;
+        const problem = binFailureProblem(failure.data);
+        if (problem !== undefined)
+            return problem;
+        break;
+    }
+    return kvbuilderProblem('PREVIEW_FAILED', `The preview exited before it was ready:\n${lastLines(log)}`);
+}
+async function waitForReady(ctx) {
+    while (true) {
+        if (!(await ctx.processes.list()).some((process) => process.name === 'preview')) {
+            throw previewFailure(await ctx.processes.log('preview', { tail: 20 }));
+        }
+        const ready = readyUrl(await ctx.processes.log('preview', { tail: 20 }));
+        if (ready !== undefined)
+            return ready;
+        await delay(pollEveryMs, undefined, { signal: ctx.job.signal });
+    }
+}
+async function stopIfRunning(ctx) {
+    try {
+        await ctx.processes.stop('preview');
+    }
+    catch (error) {
+        if (!(error instanceof ProblemError && error.problem.code === 'NOT_FOUND'))
+            throw error;
+    }
+}
+export async function startPreview(ctx, input) {
+    const workspaceFolder = ctx.job.workspace.path;
+    for (const folder of input.extensions)
+        projectAt(workspaceFolder, folder);
+    if (input.preset !== undefined)
+        insideWorkspace(workspaceFolder, input.preset, 'preset');
+    const entry = process.argv[1];
+    if (entry === undefined)
+        throw kvbuilderProblem('PREVIEW_FAILED', "kvman's entry file isn't known in this process.");
+    if ((await ctx.processes.list()).some((process) => process.name === 'preview')) {
+        throw new ProblemError({ code: 'PROCESS_RUNNING', message: 'A preview already runs in this workspace; run preview stop first.', params: { name: 'preview' } });
+    }
+    await ctx.processes.start('preview', {
+        command: process.execPath,
+        args: [...process.execArgv, binFile('kvman-preview'), ...input.extensions, '--kvman', entry, '--name', ctx.job.workspace.id, '--json', ...(input.preset === undefined ? [] : ['--preset', input.preset])],
+        cwd: workspaceFolder,
+    });
+    try {
+        const url = await waitForReady(ctx);
+        const record = { url, extensions: input.extensions };
+        await ctx.store.kv.set(recordKey, record);
+        return { url };
+    }
+    catch (error) {
+        if ((await ctx.processes.list()).some((process) => process.name === 'preview'))
+            await stopIfRunning(ctx);
+        await cleanUpPreview(ctx);
+        throw error;
+    }
+}
+//# sourceMappingURL=preview-start.js.map

package/dist/preview/preview-start.js.map

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

package/dist/preview/preview-state.d.ts

@@ -0,0 +1,11 @@
+import { z, type Ctx } from '@kvman/sdk';
+export declare const previewRecordSchema: z.ZodObject<{
+    url: z.ZodString;
+    extensions: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PreviewRecord = z.infer<typeof previewRecordSchema>;
+export declare const recordKey = "preview";
+export declare function previewHome(workspaceId: string): string;
+/** Removes the preview's home and forgets its record. */
+export declare function cleanUpPreview(ctx: Ctx): Promise<void>;
+//# sourceMappingURL=preview-state.d.ts.map

package/dist/preview/preview-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-state.d.ts","sourceRoot":"","sources":["../../src/preview/preview-state.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAMzC,eAAO,MAAM,mBAAmB;;;iBAAiE,CAAC;AAElG,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,SAAS,YAAY,CAAC;AAEnC,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,yDAAyD;AACzD,wBAAsB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5D"}

package/dist/preview/preview-state.js

@@ -0,0 +1,18 @@
+import { rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+// The preview's record in the workspace store, its home folder, and its cleanup (plan 09 §9.3, ADR 0010, 21). The
+// bin owns the preview kvman and its `web:watch` children; kvbuilder only removes the home the bin left behind
+// (a Windows tree-kill skips the bin's own cleanup) and forgets the record.
+export const previewRecordSchema = z.object({ url: z.string(), extensions: z.array(z.string()) });
+export const recordKey = 'preview';
+export function previewHome(workspaceId) {
+    return path.join(tmpdir(), `kvman-preview-${workspaceId}`);
+}
+/** Removes the preview's home and forgets its record. */
+export async function cleanUpPreview(ctx) {
+    rmSync(previewHome(ctx.job.workspace.id), { recursive: true, force: true });
+    await ctx.store.kv.delete(recordKey);
+}
+//# sourceMappingURL=preview-state.js.map

package/dist/preview/preview-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-state.js","sourceRoot":"","sources":["../../src/preview/preview-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AAEzC,kHAAkH;AAClH,+GAA+G;AAC/G,4EAA4E;AAE5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAIlG,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC;AAEnC,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,iBAAiB,WAAW,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAQ;IAC3C,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC"}

package/dist/preview/register-preview.d.ts

@@ -0,0 +1,3 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function registerPreview(ctx: Ctx): void;
+//# sourceMappingURL=register-preview.d.ts.map

package/dist/preview/register-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-preview.d.ts","sourceRoot":"","sources":["../../src/preview/register-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAkBzC,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA0D9C"}

package/dist/preview/register-preview.js

@@ -0,0 +1,75 @@
+import { z } from '@kvman/sdk';
+import { jobOptions } from "../job-options.js";
+import { callPreview, previewAnswerSchema } from "./preview-call.js";
+import { startPreview } from "./preview-start.js";
+import { cleanUpPreview, previewRecordSchema, recordKey } from "./preview-state.js";
+// The `preview` connector's commands (plan 09 §9.3): the preview itself, calls of its commands and queries (ADR 0022, 8),
+// and the cleanup when the preview exits by itself.
+const callSchema = z.object({
+    name: z.string().min(1).describe('The full name of a public command or query of the preview, such as notes.item.list.'),
+    input: z.record(z.string(), z.json()).optional().describe('Its input; {} when left out.'),
+});
+const queryTimeoutMs = 120_000;
+const statusSchema = z.union([z.object({ running: z.literal(false) }), z.object({ running: z.literal(true), url: z.string(), extensions: z.array(z.string()), startedAt: z.string() })]);
+export function registerPreview(ctx) {
+    ctx.registerCommand('kvbuilder.preview.start', {
+        description: 'Starts a preview kvman with extension projects of the workspace, and gives its URL.',
+        public: true,
+        ...jobOptions['kvbuilder.preview.start'],
+        input: z.object({
+            extensions: z.array(z.string().min(1)).min(1).describe('The project folders, relative to the workspace folder.'),
+            preset: z.string().min(1).optional().describe('A preset file to add the projects to, relative to the workspace folder.'),
+        }),
+        output: z.object({ url: z.string() }),
+        handle: (input) => startPreview(ctx, input),
+    });
+    ctx.registerCommand('kvbuilder.preview.stop', {
+        description: 'Stops the preview kvman and its component watchers.',
+        public: true,
+        ...jobOptions['kvbuilder.preview.stop'],
+        input: z.object({}),
+        output: z.object({}),
+        handle: async () => {
+            await ctx.processes.stop('preview');
+            await cleanUpPreview(ctx);
+            return {};
+        },
+    });
+    ctx.registerQuery('kvbuilder.preview.status', {
+        description: 'Tells whether the preview kvman runs, and its URL.',
+        public: true,
+        input: z.object({}),
+        output: statusSchema,
+        handle: async () => {
+            const preview = (await ctx.processes.list()).find((process) => process.name === 'preview');
+            const record = previewRecordSchema.safeParse(await ctx.store.kv.get(recordKey));
+            if (preview === undefined || !record.success)
+                return { running: false };
+            return { running: true, url: record.data.url, extensions: record.data.extensions, startedAt: preview.startedAt };
+        },
+    });
+    ctx.registerQuery('kvbuilder.preview.query.get', {
+        description: 'Runs one public query of the preview kvman and gives what it answered: its output, or its Problem.',
+        public: true,
+        timeoutMs: queryTimeoutMs,
+        input: callSchema,
+        output: previewAnswerSchema,
+        handle: ({ name, input }) => callPreview(ctx, 'queries', name, input ?? {}),
+    });
+    ctx.registerCommand('kvbuilder.preview.command.run', {
+        description: 'Runs one public command of the preview kvman and gives what it answered: its output, or its Problem.',
+        public: true,
+        ...jobOptions['kvbuilder.preview.command.run'],
+        input: callSchema,
+        output: previewAnswerSchema,
+        handle: ({ name, input }) => callPreview(ctx, 'commands', name, input ?? {}),
+    });
+    ctx.registerHandler('kernel.process.exited', {
+        description: 'Stops the component watchers and removes the home of a preview that exited by itself.',
+        handle: async (exited) => {
+            if (exited.extension === '@kvman/kvbuilder' && exited.name === 'preview')
+                await cleanUpPreview(ctx);
+        },
+    });
+}
+//# sourceMappingURL=register-preview.js.map

package/dist/preview/register-preview.js.map

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

package/dist/problems.d.ts

@@ -0,0 +1,8 @@
+import { ProblemError, type Json } from '@kvman/sdk';
+export type KvbuilderCode = 'FOLDER_NOT_EMPTY' | 'FILE_EXISTS' | 'NOT_A_PROJECT' | 'NPM_FAILED' | 'NO_FREE_PORT' | 'PREVIEW_FAILED';
+export declare const kvbuilderCodes: readonly KvbuilderCode[];
+/** A `kvbuilder/<code>` Problem to throw. */
+export declare function kvbuilderProblem(code: KvbuilderCode, message: string, params?: Record<string, Json>): ProblemError;
+/** A `VALIDATION_FAILED` Problem to throw. */
+export declare function invalid(message: string, params?: Record<string, Json>): ProblemError;
+//# sourceMappingURL=problems.d.ts.map

package/dist/problems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problems.d.ts","sourceRoot":"","sources":["../src/problems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAIrD,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,aAAa,GAAG,eAAe,GAAG,YAAY,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEpI,eAAO,MAAM,cAAc,EAAE,SAAS,aAAa,EAAyG,CAAC;AAE7J,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAM,GAAG,YAAY,CAEtH;AAED,8CAA8C;AAC9C,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAM,GAAG,YAAY,CAExF"}

package/dist/problems.js

@@ -0,0 +1,11 @@
+import { ProblemError } from '@kvman/sdk';
+export const kvbuilderCodes = ['FOLDER_NOT_EMPTY', 'FILE_EXISTS', 'NOT_A_PROJECT', 'NPM_FAILED', 'NO_FREE_PORT', 'PREVIEW_FAILED'];
+/** A `kvbuilder/<code>` Problem to throw. */
+export function kvbuilderProblem(code, message, params = {}) {
+    return new ProblemError({ code: `kvbuilder/${code}`, message, params });
+}
+/** A `VALIDATION_FAILED` Problem to throw. */
+export function invalid(message, params = {}) {
+    return new ProblemError({ code: 'VALIDATION_FAILED', message, params });
+}
+//# sourceMappingURL=problems.js.map

package/dist/problems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"problems.js","sourceRoot":"","sources":["../src/problems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,MAAM,YAAY,CAAC;AAMrD,MAAM,CAAC,MAAM,cAAc,GAA6B,CAAC,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;AAE7J,6CAA6C;AAC7C,MAAM,UAAU,gBAAgB,CAAC,IAAmB,EAAE,OAAe,EAAE,SAA+B,EAAE;IACtG,OAAO,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,aAAa,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,SAA+B,EAAE;IACxE,OAAO,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/dist/program-command.d.ts

@@ -0,0 +1,17 @@
+export type Program = 'npm' | 'npx';
+export type ProgramCommand = {
+    command: string;
+    args: string[];
+    detached: boolean;
+};
+export type TreeKill = {
+    kind: 'group';
+    pid: number;
+} | {
+    kind: 'taskkill';
+    command: 'taskkill';
+    args: string[];
+};
+export declare function programCommand(platform: NodeJS.Platform, program: Program, args: readonly string[]): ProgramCommand;
+export declare function treeKill(platform: NodeJS.Platform, pid: number): TreeKill;
+//# sourceMappingURL=program-command.d.ts.map

package/dist/program-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-command.d.ts","sourceRoot":"","sources":["../src/program-command.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;AAEpC,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAElH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAGnH;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAEzE"}

package/dist/program-command.js

@@ -0,0 +1,12 @@
+// How kvbuilder starts npm and npx, per OS (plan 02 §2.16, CLAUDE.md §3): directly on Linux and macOS, in its own process
+// group so a cancel ends the whole tree; on Windows through `cmd.exe /d /s /c`, since `npm` there is a `.cmd` file,
+// and a cancel runs `taskkill /T /F`.
+export function programCommand(platform, program, args) {
+    if (platform === 'win32')
+        return { command: 'cmd.exe', args: ['/d', '/s', '/c', program, ...args], detached: false };
+    return { command: program, args: [...args], detached: true };
+}
+export function treeKill(platform, pid) {
+    return platform === 'win32' ? { kind: 'taskkill', command: 'taskkill', args: ['/PID', String(pid), '/T', '/F'] } : { kind: 'group', pid };
+}
+//# sourceMappingURL=program-command.js.map

package/dist/program-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-command.js","sourceRoot":"","sources":["../src/program-command.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAC1H,oHAAoH;AACpH,sCAAsC;AAQtC,MAAM,UAAU,cAAc,CAAC,QAAyB,EAAE,OAAgB,EAAE,IAAuB;IACjG,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAyB,EAAE,GAAW;IAC7D,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAC5I,CAAC"}

package/dist/query/register-app-query.d.ts

@@ -0,0 +1,3 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function registerAppQuery(ctx: Ctx): void;
+//# sourceMappingURL=register-app-query.d.ts.map

package/dist/query/register-app-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-app-query.d.ts","sourceRoot":"","sources":["../../src/query/register-app-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6D,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAyBjG,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAc/C"}

package/dist/query/register-app-query.js

@@ -0,0 +1,39 @@
+import { kernelCommandSchemas, kernelQuerySchemas, ProblemError, z } from '@kvman/sdk';
+import { invalid } from "../problems.js";
+// `kvman query-get` (plan 09 §9.1, ADR 0022, 8 and 13): runs one public query of the running app, so the agent can use
+// what is installed. A command is refused: a command of the app is reached only through a connector that names it. A
+// name under `kernel.secrets.` is refused too, so the connector never lists a secret's name (ADR 0010, 6).
+const secretsPrefix = 'kernel.secrets.';
+const registrationSchema = z.object({ name: z.string(), kind: z.enum(['command', 'query']), public: z.boolean() });
+const notAQuery = (name) => invalid(`${name} is a command, and query-get runs queries only.`, { name });
+const noSuchQuery = (name) => new ProblemError({ code: 'NOT_FOUND', message: `No public query is named ${name}; extensions-list names the queries of every extension.`, params: { name } });
+// The kernel's own names aren't among the registrations, which list the run's extensions.
+async function requirePublicQuery(ctx, name) {
+    if (name.startsWith(secretsPrefix))
+        throw invalid(`${name} isn't available here: this connector never reads or lists a secret.`, { name });
+    if (Object.hasOwn(kernelQuerySchemas, name))
+        return;
+    if (Object.hasOwn(kernelCommandSchemas, name))
+        throw notAQuery(name);
+    const registered = z.array(registrationSchema).parse(await ctx.exec('kernel.registrations.list', {})).find((row) => row.name === name);
+    if (registered === undefined || !registered.public)
+        throw noSuchQuery(name);
+    if (registered.kind === 'command')
+        throw notAQuery(name);
+}
+export function registerAppQuery(ctx) {
+    ctx.registerQuery('kvbuilder.app.query.get', {
+        description: 'Runs one public query of the running app, of the kernel or of any extension, and gives its output.',
+        public: true,
+        input: z.object({
+            name: z.string().min(1).describe('The full name of a public query, such as kernel.health.get.'),
+            input: z.record(z.string(), z.json()).optional().describe("The query's input; {} when left out."),
+        }),
+        output: z.json(),
+        handle: async ({ name, input }) => {
+            await requirePublicQuery(ctx, name);
+            return z.json().parse(await ctx.exec(name, input ?? {}));
+        },
+    });
+}
+//# sourceMappingURL=register-app-query.js.map

package/dist/query/register-app-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-app-query.js","sourceRoot":"","sources":["../../src/query/register-app-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,uHAAuH;AACvH,qHAAqH;AACrH,2GAA2G;AAE3G,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAEnH,MAAM,SAAS,GAAG,CAAC,IAAY,EAAgB,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,iDAAiD,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AAE9H,MAAM,WAAW,GAAG,CAAC,IAAY,EAAgB,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,4BAA4B,IAAI,yDAAyD,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AAElN,0FAA0F;AAC1F,KAAK,UAAU,kBAAkB,CAAC,GAAQ,EAAE,IAAY;IACtD,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,MAAM,OAAO,CAAC,GAAG,IAAI,sEAAsE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3I,IAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,IAAI,CAAC;QAAE,OAAO;IACpD,IAAI,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC;QAAE,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACvI,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,MAAM;QAAE,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5E,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,GAAG,CAAC,aAAa,CAAC,yBAAyB,EAAE;QAC3C,WAAW,EAAE,oGAAoG;QACjH,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6DAA6D,CAAC;YAC/F,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SAClG,CAAC;QACF,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE;QAChB,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;YAChC,MAAM,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACpC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/register-with-kvcoder.d.ts

@@ -0,0 +1,3 @@
+import type { Ctx } from '@kvman/sdk';
+export declare function registerWithKvcoder(ctx: Ctx): void;
+//# sourceMappingURL=register-with-kvcoder.d.ts.map

package/dist/register-with-kvcoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-with-kvcoder.d.ts","sourceRoot":"","sources":["../src/register-with-kvcoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAYtC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAUlD"}

package/dist/register-with-kvcoder.js

@@ -0,0 +1,20 @@
+import { docsConnector } from "./connectors/docs.js";
+import { extConnector } from "./connectors/ext.js";
+import { kvmanConnector } from "./connectors/kvman.js";
+import { presetConnector } from "./connectors/preset.js";
+import { previewConnector } from "./connectors/preview.js";
+// kvbuilder extends kvcoder (plan 09, §9.1 and §9.4; ADR 0027, 14): at each start it registers its connectors, which
+// are `optIn`, and its slash command `/build-kvman`, since kvcoder clears both at its own start. Each connector is in
+// its own file.
+export function registerWithKvcoder(ctx) {
+    ctx.registerHandler('kernel.started', {
+        description: "Registers kvbuilder's connectors and its slash command with kvcoder.",
+        handle: async () => {
+            await ctx.exec('kvcoder.connector.register', { connectors: [kvmanConnector, extConnector, presetConnector, previewConnector, docsConnector] });
+            await ctx.exec('kvcoder.slash.register', {
+                commands: [{ name: 'build-kvman', description: 'kvbuilder.slash.build-kvman', command: 'kvbuilder.build.start', message: 'kvbuilder.slash.build-kvman.message' }],
+            });
+        },
+    });
+}
+//# sourceMappingURL=register-with-kvcoder.js.map

package/dist/register-with-kvcoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-with-kvcoder.js","sourceRoot":"","sources":["../src/register-with-kvcoder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,qHAAqH;AACrH,sHAAsH;AACtH,gBAAgB;AAEhB,MAAM,UAAU,mBAAmB,CAAC,GAAQ;IAC1C,GAAG,CAAC,eAAe,CAAC,gBAAgB,EAAE;QACpC,WAAW,EAAE,sEAAsE;QACnF,MAAM,EAAE,KAAK,IAAI,EAAE;YACjB,MAAM,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,UAAU,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;YAC/I,MAAM,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE;gBACvC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,6BAA6B,EAAE,OAAO,EAAE,uBAAuB,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;aAClK,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/run-bin.d.ts

@@ -0,0 +1,31 @@
+import { ProblemError, z, type Ctx, type Json } from '@kvman/sdk';
+export type BinRun = {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+};
+/** A bin's `{ code, message, params? }` failure line, for validating a process log line. */
+export declare const binFailureSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<Json, unknown, z.core.$ZodTypeInternals<Json, unknown>>>>;
+}, z.core.$strip>;
+/** A bin's structured failure: `{ code, message, params? }`. */
+export type BinFailure = z.output<typeof binFailureSchema>;
+/** The testkit's `docs/` folder, which holds the built-in guides. */
+export declare function testkitDocsFolder(): string;
+/** The file of a `@kvman/testkit` bin; a missing entry or file is an installation problem, not a Problem. */
+export declare function binFile(name: string): string;
+/** Runs a bin with the running Node in `cwd`, `--json` always on; stdout and stderr stay apart for the caller. */
+export declare function runBin(name: string, args: readonly string[], cwd: string, signal: AbortSignal): Promise<BinRun>;
+/** The last non-empty line of an output, or `undefined` when there is none. */
+export declare function lastOutputLine(output: string): string | undefined;
+/** The Problem for a bin's structured failure, or `undefined` when its code has no mapping here. */
+export declare function binFailureProblem(failure: BinFailure): ProblemError | undefined;
+/**
+ * The bin's output: exit 0 gives the last non-empty stdout line against `outputSchema`; exit 1 with the bin's
+ * `{ code, message, params? }` on stderr gives its Problem. Anything else fails `HANDLER_FAILED` in the kernel,
+ * after logging the bin and the exit code, never the output or the arguments.
+ */
+export declare function binResult<Output>(log: Ctx['log'], bin: string, run: BinRun, outputSchema: z.ZodType<Output>): Output;
+//# sourceMappingURL=run-bin.d.ts.map

package/dist/run-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-bin.d.ts","sourceRoot":"","sources":["../src/run-bin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,YAAY,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAO9E,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAI1E,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB;;;;iBAA2G,CAAC;AAEzI,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM3D,qEAAqE;AACrE,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,6GAA6G;AAC7G,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAc5C;AAED,kHAAkH;AAClH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B/G;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOjE;AAID,oGAAoG;AACpG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,CAM/E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAsCpH"}

package/dist/run-bin.js

@@ -0,0 +1,137 @@
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { jsonSchema, ProblemError, z } from '@kvman/sdk';
+import { invalid, kvbuilderProblem } from "./problems.js";
+import { killTree } from "./run-program.js";
+const packageJsonSchema = z.object({ bin: z.record(z.string(), z.string()) });
+/** A bin's `{ code, message, params? }` failure line, for validating a process log line. */
+export const binFailureSchema = z.object({ code: z.string(), message: z.string(), params: z.record(z.string(), jsonSchema).optional() });
+function testkitPackageFile() {
+    return createRequire(import.meta.url).resolve('@kvman/testkit/package.json');
+}
+/** The testkit's `docs/` folder, which holds the built-in guides. */
+export function testkitDocsFolder() {
+    return path.join(path.dirname(testkitPackageFile()), 'docs');
+}
+/** The file of a `@kvman/testkit` bin; a missing entry or file is an installation problem, not a Problem. */
+export function binFile(name) {
+    const packageFile = testkitPackageFile();
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(packageFile, 'utf8'));
+    }
+    catch {
+        throw new Error(`The ${name} bin can't be found; reinstall @kvman/testkit.`);
+    }
+    const parsed = packageJsonSchema.safeParse(raw);
+    const entry = parsed.success ? parsed.data.bin[name] : undefined;
+    if (entry === undefined)
+        throw new Error(`The ${name} bin is missing from @kvman/testkit; reinstall it.`);
+    const file = path.join(path.dirname(packageFile), entry);
+    if (!existsSync(file))
+        throw new Error(`The ${name} bin is missing at ${file}; reinstall @kvman/testkit.`);
+    return file;
+}
+/** Runs a bin with the running Node in `cwd`, `--json` always on; stdout and stderr stay apart for the caller. */
+export function runBin(name, args, cwd, signal) {
+    const file = binFile(name);
+    return new Promise((resolve, reject) => {
+        const child = spawn(process.execPath, [...process.execArgv, file, ...args, '--json'], {
+            cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            detached: process.platform !== 'win32',
+            windowsHide: true,
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.setEncoding('utf8').on('data', (text) => {
+            stdout += text;
+        });
+        child.stderr.setEncoding('utf8').on('data', (text) => {
+            stderr += text;
+        });
+        const abort = () => killTree(child.pid);
+        signal.addEventListener('abort', abort, { once: true });
+        child.once('error', (error) => {
+            signal.removeEventListener('abort', abort);
+            reject(error);
+        });
+        child.once('close', (code) => {
+            signal.removeEventListener('abort', abort);
+            resolve({ exitCode: code ?? 1, stdout, stderr });
+        });
+    });
+}
+/** The last non-empty line of an output, or `undefined` when there is none. */
+export function lastOutputLine(output) {
+    const lines = output.split('\n');
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        const line = lines[index];
+        if (line !== undefined && line.trim() !== '')
+            return line;
+    }
+    return undefined;
+}
+const kvbuilderBinCodes = ['FOLDER_NOT_EMPTY', 'FILE_EXISTS', 'NPM_FAILED', 'NO_FREE_PORT', 'PREVIEW_FAILED'];
+/** The Problem for a bin's structured failure, or `undefined` when its code has no mapping here. */
+export function binFailureProblem(failure) {
+    const params = failure.params ?? {};
+    if (failure.code === 'VALIDATION_FAILED')
+        return invalid(failure.message, params);
+    if (failure.code === 'NOT_FOUND')
+        return new ProblemError({ code: 'NOT_FOUND', message: failure.message, params });
+    if (kvbuilderBinCodes.includes(failure.code))
+        return kvbuilderProblem(failure.code, failure.message, params);
+    return undefined;
+}
+/**
+ * The bin's output: exit 0 gives the last non-empty stdout line against `outputSchema`; exit 1 with the bin's
+ * `{ code, message, params? }` on stderr gives its Problem. Anything else fails `HANDLER_FAILED` in the kernel,
+ * after logging the bin and the exit code, never the output or the arguments.
+ */
+export function binResult(log, bin, run, outputSchema) {
+    if (run.exitCode === 0) {
+        const line = lastOutputLine(run.stdout);
+        if (line !== undefined) {
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                parsed = undefined;
+            }
+            if (parsed !== undefined) {
+                const checked = outputSchema.safeParse(parsed);
+                if (checked.success)
+                    return checked.data;
+            }
+        }
+        log.error(`${bin} printed an unexpected output.`, { bin, exitCode: run.exitCode });
+        throw new Error(`${bin} failed.`);
+    }
+    if (run.exitCode === 1) {
+        const line = lastOutputLine(run.stderr);
+        if (line !== undefined) {
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                parsed = undefined;
+            }
+            if (parsed !== undefined) {
+                const failure = binFailureSchema.safeParse(parsed);
+                if (failure.success) {
+                    const problem = binFailureProblem(failure.data);
+                    if (problem !== undefined)
+                        throw problem;
+                }
+            }
+        }
+    }
+    log.error(`${bin} failed.`, { bin, exitCode: run.exitCode });
+    throw new Error(`${bin} failed.`);
+}
+//# sourceMappingURL=run-bin.js.map

package/dist/run-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-bin.js","sourceRoot":"","sources":["../src/run-bin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,EAAuB,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAsB,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAO5C,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAE9E,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAKzI,SAAS,kBAAkB;IACzB,OAAO,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;AAC/E,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,gDAAgD,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,oDAAoD,CAAC,CAAC;IAC1G,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,sBAAsB,IAAI,6BAA6B,CAAC,CAAC;IAC3G,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kHAAkH;AAClH,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAuB,EAAE,GAAW,EAAE,MAAmB;IAC5F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE;YACpF,GAAG;YACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;YACtC,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YAC3D,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YAC3D,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,GAAS,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAC3B,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,iBAAiB,GAA6B,CAAC,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;AAExI,oGAAoG;AACpG,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACnD,MAAM,MAAM,GAAyB,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IAC1D,IAAI,OAAO,CAAC,IAAI,KAAK,mBAAmB;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClF,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnH,IAAI,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAqB,CAAC;QAAE,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAqB,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/I,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAS,GAAe,EAAE,GAAW,EAAE,GAAW,EAAE,YAA+B;IAC1G,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,MAAe,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAC/C,IAAI,OAAO,CAAC,OAAO;oBAAE,OAAO,OAAO,CAAC,IAAI,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,gCAAgC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,MAAe,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBACnD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChD,IAAI,OAAO,KAAK,SAAS;wBAAE,MAAM,OAAO,CAAC;gBAC3C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,UAAU,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7D,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC;AACpC,CAAC"}