@softacus-software/elwis-data-mcp 0.1.0

package/dist/resolve.js

@@ -0,0 +1,71 @@
+import { ElwisHttpError } from './http-client.js';
+const OID = /^[a-f0-9]{24}$/i;
+export function IsObjectId(value) {
+    return OID.test(value);
+}
+export async function RequireApplicationId(api, ref) {
+    const appRef = ref.applicationId ?? ref.applicationName;
+    if (!appRef)
+        throw new Error('Provide applicationId or applicationName');
+    return ResolveApplicationId(api, appRef);
+}
+export class AmbiguityError extends Error {
+    candidates;
+    constructor(message, candidates) {
+        super(message);
+        this.name = 'AmbiguityError';
+        this.candidates = candidates;
+    }
+}
+export async function ResolveEntity(api, kind, applicationId, nameOrAlias) {
+    const scope = { applicationId: { $oid: applicationId } };
+    let rows;
+    try {
+        rows = await api.list(kind, { ...scope, $or: [{ name: nameOrAlias }, { alias: nameOrAlias }] });
+    }
+    catch (error) {
+        if (error instanceof ElwisHttpError && error.status === 400) {
+            rows = await api.list(kind, { ...scope, name: nameOrAlias });
+        }
+        else {
+            throw error;
+        }
+    }
+    return { matches: rows.map(r => ({ id: r.id, name: r.name, alias: r.alias, kind })) };
+}
+export async function ResolveOneId(api, kind, applicationId, ref) {
+    if (IsObjectId(ref))
+        return ref;
+    const { matches } = await ResolveEntity(api, kind, applicationId, ref);
+    if (matches.length === 1)
+        return matches[0].id;
+    if (matches.length === 0)
+        throw new AmbiguityError(`No active ${kind} named "${ref}" in the application`, []);
+    throw new AmbiguityError(`Multiple ${kind} entries named "${ref}" in the application; pass an explicit id`, matches.map(m => ({ id: m.id, name: m.name })));
+}
+export async function ResolveArtifactByRef(api, nameAttributeId, artifactTypeId, ref, label) {
+    if (IsObjectId(ref)) {
+        const artifact = await api.getOne('artifact', ref);
+        return { id: ref, name: artifact.attributes?.[nameAttributeId]?.value ?? ref };
+    }
+    const filter = { [`attributes.${nameAttributeId}.value`]: ref };
+    if (artifactTypeId)
+        filter.artifactTypeId = { $oid: artifactTypeId };
+    const page = await api.listRecords('artifact', filter, { limit: 2 });
+    if (page.data.length === 1)
+        return { id: page.data[0].id, name: ref };
+    if (page.data.length === 0)
+        throw new Error(`No ${label} artifact named "${ref}"${artifactTypeId ? ' in the restricted artifact type' : ''}`);
+    throw new AmbiguityError(`Multiple ${label} artifacts named "${ref}"; pass an explicit id`, page.data.map(a => ({ id: a.id, name: ref })));
+}
+export async function ResolveApplicationId(api, applicationIdOrName) {
+    if (IsObjectId(applicationIdOrName))
+        return applicationIdOrName;
+    const rows = await api.list('application', { name: applicationIdOrName });
+    if (rows.length === 1)
+        return rows[0].id;
+    if (rows.length === 0)
+        throw new AmbiguityError(`No active application named "${applicationIdOrName}"`, []);
+    throw new AmbiguityError(`Multiple active applications named "${applicationIdOrName}"; pass an explicit applicationId`, rows.map(r => ({ id: r.id, name: r.name })));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/result.js

@@ -0,0 +1,16 @@
+import { AmbiguityError } from './resolve.js';
+import { ElwisHttpError } from './http-client.js';
+export function Text(value, isError = false) {
+    const result = { content: [{ type: 'text', text: JSON.stringify(value, null, 2) }] };
+    if (isError)
+        result.isError = true;
+    return result;
+}
+export function ErrorResult(error) {
+    if (error instanceof AmbiguityError)
+        return Text({ status: 'error', error: error.message, candidates: error.candidates }, true);
+    if (error instanceof ElwisHttpError)
+        return Text({ status: 'error', error: error.message, status_code: error.status, detail: error.body }, true);
+    return Text({ status: 'error', error: error.message }, true);
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,UAAU,IAAI,CAAC,KAAc,EAAE,OAAO,GAAG,KAAK;IAClD,MAAM,MAAM,GAAqE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvJ,IAAI,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACnC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,cAAc;QAAE,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC;IAChI,IAAI,KAAK,YAAY,cAAc;QAAE,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IACjJ,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC"}

package/dist/server.js

@@ -0,0 +1,82 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { LoadConfig } from './config.js';
+import { ElwisHttpClient } from './http-client.js';
+import { LoadSession, SaveSession } from './session-store.js';
+import { ElwisApi } from './elwis-api.js';
+import { AppScope } from './app-scope.js';
+import { RegisterExplainAccess } from './tools/explain-access.js';
+import { RegisterListApps } from './tools/list-apps.js';
+import { RegisterListEntities } from './tools/list-entities.js';
+import { RegisterReadArtifacts } from './tools/read-artifacts.js';
+import { RegisterResolveEntity } from './tools/resolve-entity.js';
+import { RegisterProposePageDesign } from './tools/propose-page-design.js';
+import { RegisterBuildArtifactType } from './tools/build-artifact-type.js';
+import { RegisterBuildPage } from './tools/build-page.js';
+import { RegisterGetPage } from './tools/get-page.js';
+import { RegisterUpdatePage } from './tools/update-page.js';
+import { RegisterBuildWorkflow } from './tools/build-workflow.js';
+import { RegisterCreateArtifacts } from './tools/create-artifacts.js';
+import { RegisterUpdateArtifacts } from './tools/update-artifacts.js';
+import { RegisterDeleteArtifacts } from './tools/delete-artifacts.js';
+import { RegisterUpdateEntity } from './tools/update-entity.js';
+import { RegisterDeleteEntity } from './tools/delete-entity.js';
+import { RegisterGetEntity } from './tools/get-entity.js';
+import { RegisterCreateApplication } from './tools/create-application.js';
+import { RegisterCreateFolder } from './tools/create-folder.js';
+import { RegisterBuildLinks } from './tools/build-links.js';
+import { RegisterRawApi } from './tools/raw-api.js';
+export function BuildServer() {
+    const server = new McpServer({ name: 'elwis-data-mcp', version: '0.1.0' });
+    const cfg = LoadConfig();
+    const client = new ElwisHttpClient(cfg, cfg.authMode === 'session'
+        ? {
+            refresh: true,
+            reload: () => LoadSession(cfg.baseUrl)?.token ?? null,
+            persist: (token) => {
+                const existing = LoadSession(cfg.baseUrl);
+                SaveSession({
+                    host: cfg.baseUrl,
+                    token,
+                    tenantId: existing?.tenantId ?? null,
+                    email: existing?.email ?? null,
+                    updatedAt: new Date().toISOString(),
+                });
+            },
+        }
+        : {});
+    const api = new ElwisApi(client, cfg.expectedTenant);
+    const scope = new AppScope(api, cfg.allowedApps, cfg.expectedTenant);
+    if (!cfg.expectedTenant) {
+        process.stderr.write('WARNING: no ELWIS_TENANT set, data tools are disabled until a tenant is configured (explain_elwis_access shows the id, or re-run setup)\n');
+    }
+    if (cfg.writeEnabled && !cfg.requireConfirmation) {
+        process.stderr.write('WARNING: writes are enabled without per-plan confirmation (ELWIS_REQUIRE_CONFIRMATION=false), intended for scripted automation only\n');
+    }
+    RegisterExplainAccess(server, cfg, api, scope);
+    RegisterListApps(server, api, scope);
+    RegisterListEntities(server, api, scope);
+    RegisterReadArtifacts(server, api, scope);
+    RegisterResolveEntity(server, api, scope);
+    RegisterGetPage(server, api, scope);
+    RegisterProposePageDesign(server);
+    if (cfg.buildersEnabled) {
+        RegisterBuildArtifactType(server, api, cfg, scope);
+        RegisterBuildPage(server, api, cfg, scope);
+        RegisterUpdatePage(server, api, cfg, scope);
+        RegisterBuildWorkflow(server, api, cfg, scope);
+        RegisterCreateArtifacts(server, api, cfg, scope);
+        RegisterUpdateArtifacts(server, api, cfg, scope);
+        RegisterDeleteArtifacts(server, api, cfg, scope);
+        RegisterUpdateEntity(server, api, cfg, scope);
+        RegisterDeleteEntity(server, api, cfg, scope);
+        RegisterGetEntity(server, api, scope);
+        RegisterCreateApplication(server, api, cfg, scope);
+        RegisterCreateFolder(server, api, cfg, scope);
+        RegisterBuildLinks(server, api, cfg, scope);
+    }
+    else {
+        RegisterRawApi(server, api, cfg, scope);
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/session-store.js

@@ -0,0 +1,51 @@
+import { createHash } from 'node:crypto';
+import { chmodSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+export function DefaultSessionsDir() {
+    return process.env.ELWIS_SESSIONS_DIR?.trim() || join(homedir(), '.elwis', 'sessions');
+}
+export function SessionPath(host, dir = DefaultSessionsDir()) {
+    const key = createHash('sha256').update(host.replace(/\/$/, '')).digest('hex').slice(0, 12);
+    return join(dir, `${key}.json`);
+}
+export function LoadSession(host, dir) {
+    try {
+        const record = JSON.parse(readFileSync(SessionPath(host, dir), 'utf8'));
+        return typeof record.token === 'string' && record.token.length > 0 ? record : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function ListSessions(dir = DefaultSessionsDir()) {
+    try {
+        return readdirSync(dir)
+            .filter(name => name.endsWith('.json'))
+            .map(name => {
+            try {
+                return JSON.parse(readFileSync(join(dir, name), 'utf8'));
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((record) => record !== null && typeof record.token === 'string');
+    }
+    catch {
+        return [];
+    }
+}
+export function SaveSession(record, dir) {
+    const path = SessionPath(record.host, dir);
+    const parent = dirname(path);
+    mkdirSync(parent, { recursive: true, mode: 0o700 });
+    chmodSync(parent, 0o700);
+    writeFileSync(path, `${JSON.stringify(record, null, 2)}\n`, { mode: 0o600 });
+    chmodSync(path, 0o600);
+    return path;
+}
+export function DeleteSession(host, dir) {
+    rmSync(SessionPath(host, dir), { force: true });
+}
+//# sourceMappingURL=session-store.js.map

package/dist/session-store.js.map

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

package/dist/tools/build-artifact-type.js

@@ -0,0 +1,36 @@
+import { BuildArtifactTypePlan, BuildArtifactTypeInput } from '../builders/artifact-type-plan.js';
+import { ExecuteArtifactTypePlan } from '../builders/artifact-type-execute.js';
+import { AssertWriteEnabled, CheckConfirmation, CONFIRMATION_MESSAGE, DRY_RUN_MESSAGE } from '../write-gate.js';
+import { PlanToken } from '../confirm.js';
+import { AuditedExecute } from '../audit.js';
+import { RequireApplicationId } from '../resolve.js';
+import { Text, ErrorResult } from '../result.js';
+export function RegisterBuildArtifactType(server, api, cfg, scope) {
+    server.registerTool('build_artifact_type', {
+        description: 'Build an ELWIS artifact type with its attributes and data types in one call. Creates missing data types and attributes, reuses existing ones by name, and assembles the artifact type. Per attribute you may pass: description, icon, uri, private (true for a private attribute); multipleValuesOrdering (ASC/DESC/NONE) for list-valued attributes; minimum and maximum for a BOUNDED kind; units [{name, symbol, base}] for a CUSTOM-UNIT kind; siUnit (one of TIME, LENGTH, MASS, AREA, VOLUME, SPEED) for a UNIT kind; counterFormat and counterNextValue for a COUNTER kind (both default sensibly); fileArtifactTypeId to override the file reference for HTML/FILE base types; and the per-attribute placement fields initialValue, help, regexValidator, regexFlags, equation, equationRecalculate, entityFilter. At the artifact-type level you may pass: color, delimiter, isLoggingDisabled, inheritableAcl, defaultIsHeading; defaultFolder and defaultPage (id or name, resolved within the application); defaultWidgets {artifactWidgetTemplateId, cardWidgetTemplateId}; avrMapper and avrTriggers (CREATE/UPDATE/DEMAND); and preferredArtifactTypes (ids or names, only valid when format is MODULE). Use dryRun to preview without writing.',
+        inputSchema: BuildArtifactTypeInput.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async (raw) => {
+        try {
+            const applicationId = await RequireApplicationId(api, raw);
+            await scope.assertAllowed(applicationId);
+            const plan = await BuildArtifactTypePlan(api, { ...raw, applicationId });
+            if (plan.reuse) {
+                return Text({ status: 'ok', artifactType: plan.reuse, createdDataTypes: [], createdAttributes: [], reused: [{ ...plan.reuse, kind: 'artifact-type', note: 'An artifact type with this name already exists in the application; it was returned unchanged and not updated.' }] });
+            }
+            const token = PlanToken(cfg, 'build_artifact_type', plan);
+            if (raw.dryRun)
+                return Text({ status: 'dry-run', dryRun: true, confirmationToken: token, message: DRY_RUN_MESSAGE, plan });
+            AssertWriteEnabled(cfg);
+            if (CheckConfirmation(cfg, token, raw.confirm) === 'pending') {
+                return Text({ status: 'confirmation-required', confirmationToken: token, plan, message: CONFIRMATION_MESSAGE });
+            }
+            const report = await AuditedExecute(cfg, scope, 'build_artifact_type', token, () => ExecuteArtifactTypePlan(api, plan), (r) => ({ artifactType: r.artifactType, createdDataTypes: r.createdDataTypes.length, createdAttributes: r.createdAttributes.length }));
+            return Text({ status: 'ok', ...report });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=build-artifact-type.js.map

package/dist/tools/build-artifact-type.js.map

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

package/dist/tools/build-links.js

@@ -0,0 +1,33 @@
+import { BuildLinksInput, BuildLinksPlan } from '../builders/links-plan.js';
+import { ExecuteLinksPlan } from '../builders/links-execute.js';
+import { AssertWriteEnabled, CheckConfirmation, CONFIRMATION_MESSAGE, DRY_RUN_MESSAGE } from '../write-gate.js';
+import { PlanToken } from '../confirm.js';
+import { AuditedExecute } from '../audit.js';
+import { RequireApplicationId } from '../resolve.js';
+import { Text, ErrorResult } from '../result.js';
+export function RegisterBuildLinks(server, api, cfg, scope) {
+    server.registerTool('build_links', {
+        description: 'Create an ELWIS link type and link instances between records in one call. An existing active link type with the given name is reused; otherwise it is created, which requires sourceArtifactType and destinationArtifactType (restriction of what can be linked). Link instances are passed as source/destination artifact names (resolved within the restricted artifact types) or ids; pairs that are already linked are skipped, so the call is safe to repeat. Cardinality defaults to unrestricted on both sides. Use dryRun to preview the resolved plan without writing.',
+        inputSchema: BuildLinksInput.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async (raw) => {
+        try {
+            const applicationId = await RequireApplicationId(api, raw);
+            await scope.assertAllowed(applicationId);
+            const plan = await BuildLinksPlan(api, raw, applicationId);
+            const token = PlanToken(cfg, 'build_links', plan);
+            if (raw.dryRun)
+                return Text({ status: 'dry-run', dryRun: true, confirmationToken: token, message: DRY_RUN_MESSAGE, plan });
+            AssertWriteEnabled(cfg);
+            if (CheckConfirmation(cfg, token, raw.confirm) === 'pending') {
+                return Text({ status: 'confirmation-required', confirmationToken: token, plan, message: CONFIRMATION_MESSAGE });
+            }
+            const report = await AuditedExecute(cfg, scope, 'build_links', token, () => ExecuteLinksPlan(api, plan), (r) => ({ linkType: r.linkType, createdLinks: r.createdLinks.length, skippedExisting: r.skippedExisting.length }));
+            return Text({ status: 'ok', ...report });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=build-links.js.map

package/dist/tools/build-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-links.js","sourceRoot":"","sources":["../../src/tools/build-links.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAChH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,GAAa,EAAE,GAAgB,EAAE,KAAe;IACpG,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EAAE,ijBAAijB;QAC9jB,WAAW,EAAE,eAAe,CAAC,KAAK;QAClC,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACxG,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3D,MAAM,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;YAClD,IAAI,GAAG,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3H,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC7D,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;YAClH,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC5N,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/build-page.js

@@ -0,0 +1,40 @@
+import { BuildPagePlan, BuildPageInput, ADVERTISED_WIDGET_CODES } from '../builders/page-plan.js';
+import { ExecutePagePlan } from '../builders/page-execute.js';
+import { AssertWriteEnabled, CheckConfirmation, CONFIRMATION_MESSAGE, DRY_RUN_MESSAGE } from '../write-gate.js';
+import { PlanToken } from '../confirm.js';
+import { AuditedExecute } from '../audit.js';
+import { RequireApplicationId } from '../resolve.js';
+import { Text, ErrorResult } from '../result.js';
+export function RegisterBuildPage(server, api, cfg, scope) {
+    server.registerTool('build_page', {
+        description: `Build an ELWIS page with its widgets in one call. Provide the full section/row/block/part nesting; put each widget inline at the part level as { code, value } (the server creates the widget and wires its id into the page). Supported widget codes: ${ADVERTISED_WIDGET_CODES.join(', ')}. Row layout is an array of numeric strings summing to 12. Section styles, if given, must be shaped { outerContainer, innerContainer }.
+
+DATA FIRST: when the page shows or manages records, bind a native LIST-NEW widget to the artifact type, do NOT render record values as HTML text; TEXT widgets are for prose, headers and layout only. A live table needs only { code: 'LIST-NEW', value: { model: { selected: { applications: [{ id: <appId> }], artifactTypes: [{ id: <artifactTypeId> }], columns: [{ key: <attributeId> }, ...] } } } }, the server fills the full working skeleton (listType, state.columnOrder, per-column settings, table defaults) and your values win on conflict. columns is effectively required: a LIST-NEW without columns renders an empty "No records found" table even when records exist, so always pass at least the Name system attribute as a column. The table then always shows the current records: editing the data changes the page with no rebuild. Resolve attribute ids for columns via list_elwis_entities (kind attribute); system attribute ids like Name come from explain_elwis_access systemAttributes. An HTML table or list of data inside a TEXT widget is always wrong, if the values exist (or should exist) as records, the LIST-NEW widget shows them; never duplicate them into TEXT. A CHART widget takes { model: { settings: { chartType: 'pie' | 'doughnut' }, selected: { artifactType: { id }, groupByAttributeId, totalByAttributeId } } }.
+
+Reference a widget created earlier in the same page by its part position with a $widgetIndex placeholder. A page with the same name is returned unchanged, use update_elwis_page to change an existing page. For a page requested in plain language, run the propose_page_design interview first and build only from a brief it marked ready, never build on a guess. Use dryRun to preview without writing and show the user the plan before the real run.`,
+        inputSchema: BuildPageInput.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async (raw) => {
+        try {
+            const applicationId = await RequireApplicationId(api, raw);
+            await scope.assertAllowed(applicationId);
+            const plan = await BuildPagePlan(api, { ...raw, applicationId });
+            if (plan.reuse) {
+                return Text({ status: 'ok', page: plan.reuse, widgets: [], reused: [{ ...plan.reuse, kind: 'page', note: 'A page with this name already exists in the application; it was returned unchanged and not updated.' }] });
+            }
+            const token = PlanToken(cfg, 'build_page', plan);
+            if (raw.dryRun)
+                return Text({ status: 'dry-run', dryRun: true, confirmationToken: token, message: DRY_RUN_MESSAGE, plan });
+            AssertWriteEnabled(cfg);
+            if (CheckConfirmation(cfg, token, raw.confirm) === 'pending') {
+                return Text({ status: 'confirmation-required', confirmationToken: token, plan, message: CONFIRMATION_MESSAGE });
+            }
+            const report = await AuditedExecute(cfg, scope, 'build_page', token, () => ExecutePagePlan(api, plan), (r) => ({ page: r.page, widgets: r.widgets.length }));
+            return Text({ status: 'ok', ...report });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=build-page.js.map

package/dist/tools/build-page.js.map

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

package/dist/tools/build-workflow.js

@@ -0,0 +1,36 @@
+import { BuildWorkflowPlan, BuildWorkflowInput } from '../builders/workflow-plan.js';
+import { ExecuteWorkflowPlan } from '../builders/workflow-execute.js';
+import { AssertWriteEnabled, CheckConfirmation, CONFIRMATION_MESSAGE, DRY_RUN_MESSAGE } from '../write-gate.js';
+import { PlanToken } from '../confirm.js';
+import { AuditedExecute } from '../audit.js';
+import { RequireApplicationId } from '../resolve.js';
+import { Text, ErrorResult } from '../result.js';
+export function RegisterBuildWorkflow(server, api, cfg, scope) {
+    server.registerTool('build_workflow', {
+        description: `Build an ELWIS workflow in one call. type is "be" (server-side automation on data changes) or "fe" (client-side automation on UI events). ownerType scopes the workflow to what it reacts to (data-type, attribute, artifact-type, artifact, link-type, link, widget, page, template, or CUSTOM). The owner is the container the workflow belongs to, which differs by ownerType: for data-type, attribute, artifact-type and link-type the owner is the application itself, so leave owner unset and it defaults to applicationId/applicationName; for artifact the owner is its artifact type, for link the owner is its link type, and for page and widget the owner is that page or widget, pass these by name (resolved within applicationId/applicationName) or as an id; for template pass an explicit id; CUSTOM workflows take no owner. usedIn defaults to the owner and can be left unset. Provide triggers and actions as full objects with their type and settings, the server passes them through and the backend validates them. Common trigger types: OWNER_CREATE, OWNER_UPDATE, OWNER_DELETE, ATTRIBUTE_VALUE_CHANGE, PAGE_LOAD, BUTTON_CLICK, MANUAL. Common action types: SET_VALUE, CREATE_LINK, CREATE_ARTIFACTS, UPDATE_ARTIFACTS, DELETE_ARTIFACTS, SEND_EMAIL, NAVIGATE_TO_PAGE, EXEC_CUSTOM_JAVASCRIPT. A SET_VALUE action is shaped { type: 'SET_VALUE', attributeId, actionSettings: { value: { isDynamic, value }, operation: { isDynamic, value } } }: the target attribute is the action's top-level attributeId, the per-type settings live under actionSettings, each setting is wrapped as { isDynamic, value } (set isDynamic true when value is an equation or reference rather than a literal), and operation is one of add, remove, replace. Other trigger and action types follow the same { type, ...top-level target ids, actionSettings } pattern and pass through untouched, so any documented field is accepted. Every trigger and action needs a settings object (triggerSettings / actionSettings); the server fills in an empty one when you omit it. Use dryRun to preview without writing.`,
+        inputSchema: BuildWorkflowInput.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async (raw) => {
+        try {
+            const applicationId = await RequireApplicationId(api, raw);
+            await scope.assertAllowed(applicationId);
+            const plan = await BuildWorkflowPlan(api, { ...raw, applicationId });
+            if (plan.reuse) {
+                return Text({ status: 'ok', workflow: plan.reuse, reused: [{ ...plan.reuse, kind: 'workflow', note: 'A workflow with this name already exists for this owner; it was returned unchanged and not updated.' }] });
+            }
+            const token = PlanToken(cfg, 'build_workflow', plan);
+            if (raw.dryRun)
+                return Text({ status: 'dry-run', dryRun: true, confirmationToken: token, message: DRY_RUN_MESSAGE, plan });
+            AssertWriteEnabled(cfg);
+            if (CheckConfirmation(cfg, token, raw.confirm) === 'pending') {
+                return Text({ status: 'confirmation-required', confirmationToken: token, plan, message: CONFIRMATION_MESSAGE });
+            }
+            const report = await AuditedExecute(cfg, scope, 'build_workflow', token, () => ExecuteWorkflowPlan(api, plan), (r) => ({ workflow: r.workflow }));
+            return Text({ status: 'ok', ...report });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=build-workflow.js.map

package/dist/tools/build-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-workflow.js","sourceRoot":"","sources":["../../src/tools/build-workflow.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAChH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,GAAa,EAAE,GAAgB,EAAE,KAAe;IACvG,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EAAE,6gEAA6gE;QAC1hE,WAAW,EAAE,kBAAkB,CAAC,KAAK;QACrC,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACxG,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3D,MAAM,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;YACrE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,qGAAqG,EAAE,CAAC,EAAE,CAAC,CAAC;YAClN,CAAC;YACD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;YACrD,IAAI,GAAG,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3H,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC7D,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;YAClH,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YAClJ,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/create-application.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { AppScopeError } from '../app-scope.js';
+import { AssertWriteEnabled, CheckConfirmation, CONFIRMATION_MESSAGE, DRY_RUN_MESSAGE } from '../write-gate.js';
+import { PlanToken } from '../confirm.js';
+import { AuditedExecute } from '../audit.js';
+import { Text, ErrorResult } from '../result.js';
+const CreateApplicationInput = z.object({
+    name: z.string().min(1).max(50),
+    description: z.string().max(1000).optional(),
+    dryRun: z.boolean().default(false).describe('Preview without creating anything'),
+    confirm: z.string().optional().describe('Confirmation token from the previous preview of this exact plan; required to execute when confirmation mode is on'),
+});
+export function RegisterCreateApplication(server, api, cfg, scope) {
+    server.registerTool('create_elwis_application', {
+        description: 'Create a new ELWIS application, the top-level container that data types, attributes, artifact types, link types, pages, and records live in. Use this when the user wants to start a fresh workspace ("make me an app for the warehouse"), then build inside it with build_artifact_type and the other tools. An active application with the same name is an error suggesting reuse instead of a duplicate. Not available on connections restricted to an application allowlist, a new application would be outside the allowlist and unusable; the allowlist owner has to create it and add its id to ELWIS_ALLOWED_APPS.',
+        inputSchema: CreateApplicationInput.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async (raw) => {
+        try {
+            await scope.assertTenant();
+            if (scope.restricted) {
+                throw new AppScopeError('creating applications, this connection is limited to an application allowlist, and a new application would be outside it');
+            }
+            const existing = await api.list('application', { name: raw.name });
+            if (existing.length) {
+                throw new Error(`An active application named "${raw.name}" already exists (${existing[0].id}); use it instead of creating a duplicate, or pick another name`);
+            }
+            const plan = { name: raw.name, description: raw.description ?? '' };
+            const token = PlanToken(cfg, 'create_elwis_application', plan);
+            if (raw.dryRun)
+                return Text({ status: 'dry-run', dryRun: true, confirmationToken: token, message: DRY_RUN_MESSAGE, plan });
+            AssertWriteEnabled(cfg);
+            if (CheckConfirmation(cfg, token, raw.confirm) === 'pending') {
+                return Text({ status: 'confirmation-required', confirmationToken: token, plan, message: CONFIRMATION_MESSAGE });
+            }
+            const created = await AuditedExecute(cfg, scope, 'create_elwis_application', token, () => api.create('application', plan), (r) => ({ created: r.id, name: r.name }));
+            return Text({ status: 'ok', application: created, note: 'Build inside it with build_artifact_type, create_elwis_artifacts, and build_page.' });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=create-application.js.map

package/dist/tools/create-application.js.map

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

package/dist/tools/create-artifacts.js

@@ -0,0 +1,33 @@
+import { CreateArtifactsInput, BuildRecordsPlan } from '../builders/records-plan.js';
+import { ExecuteRecordsPlan } from '../builders/records-execute.js';
+import { AssertWriteEnabled, CheckConfirmation, CONFIRMATION_MESSAGE, DRY_RUN_MESSAGE } from '../write-gate.js';
+import { PlanToken } from '../confirm.js';
+import { AuditedExecute } from '../audit.js';
+import { RequireApplicationId } from '../resolve.js';
+import { Text, ErrorResult } from '../result.js';
+export function RegisterCreateArtifacts(server, api, cfg, scope) {
+    server.registerTool('create_elwis_artifacts', {
+        description: 'Create data records (artifacts) of an existing artifact type in one batch call (up to 50). Pass attribute values by attribute name; the server resolves names to ids and satisfies the backend contract that every attribute of the type must receive a value: the system Name attribute is filled from each record\'s name, the system Sequence attribute is auto-generated when not provided, and unspecified attributes default to an empty string. Values are coerced to strings (the backend stores all attribute values as strings). A value key that does not match an attribute assigned to the type is an error listing the assignable attribute names. Use dryRun to preview the resolved payloads without writing.',
+        inputSchema: CreateArtifactsInput.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async (raw) => {
+        try {
+            const applicationId = await RequireApplicationId(api, raw);
+            await scope.assertAllowed(applicationId);
+            const plan = await BuildRecordsPlan(api, raw, applicationId);
+            const token = PlanToken(cfg, 'create_elwis_artifacts', plan);
+            if (raw.dryRun)
+                return Text({ status: 'dry-run', dryRun: true, confirmationToken: token, message: DRY_RUN_MESSAGE, plan });
+            AssertWriteEnabled(cfg);
+            if (CheckConfirmation(cfg, token, raw.confirm) === 'pending') {
+                return Text({ status: 'confirmation-required', confirmationToken: token, plan, message: CONFIRMATION_MESSAGE });
+            }
+            const report = await AuditedExecute(cfg, scope, 'create_elwis_artifacts', token, () => ExecuteRecordsPlan(api, plan), (r) => ({ artifactType: r.artifactType, created: r.created }));
+            return Text({ status: 'ok', ...report });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=create-artifacts.js.map

package/dist/tools/create-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-artifacts.js","sourceRoot":"","sources":["../../src/tools/create-artifacts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAChH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,GAAa,EAAE,GAAgB,EAAE,KAAe;IACzG,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EAAE,+rBAA+rB;QAC5sB,WAAW,EAAE,oBAAoB,CAAC,KAAK;QACvC,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;KACzG,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3D,MAAM,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;YAC7D,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,wBAAwB,EAAE,IAAI,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3H,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC7D,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;YAClH,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACrL,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/create-folder.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { AppRootFolder, ResolveFolder, FolderFullPath } from '../builders/entity-lifecycle-plan.js';
+import { AssertWriteEnabled, CheckConfirmation, CONFIRMATION_MESSAGE, DRY_RUN_MESSAGE } from '../write-gate.js';
+import { PlanToken } from '../confirm.js';
+import { AuditedExecute } from '../audit.js';
+import { RequireApplicationId } from '../resolve.js';
+import { Text, ErrorResult } from '../result.js';
+const CreateFolderInput = z.object({
+    applicationId: z.string().optional(),
+    applicationName: z.string().optional(),
+    name: z.string().min(1).max(50),
+    parent: z.string().optional().describe('Parent folder name, full path (like "Projects/2026"), or id; defaults to the application root folder'),
+    dryRun: z.boolean().default(false).describe('Preview without creating anything'),
+    confirm: z.string().optional().describe('Confirmation token from the previous preview of this exact plan; required to execute when confirmation mode is on'),
+});
+export function RegisterCreateFolder(server, api, cfg, scope) {
+    server.registerTool('create_elwis_folder', {
+        description: 'Create a folder in an application\'s folder tree, for organizing records ("put invoices in their own folder"). The parent is a folder name, full path, or id; without it the folder lands directly under the application root. A sibling with the same name is an error suggesting reuse. Move records into it by updating them, and reorganize later with update_elwis_entity (rename, parentFolderId to move, folderSequence to reorder) or delete_elwis_entity.',
+        inputSchema: CreateFolderInput.shape,
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async (raw) => {
+        try {
+            const applicationId = await RequireApplicationId(api, raw);
+            await scope.assertAllowed(applicationId);
+            const root = await AppRootFolder(api, applicationId);
+            const parent = raw.parent
+                ? await ResolveFolder(api, applicationId, raw.parent)
+                : await api.getOne('folder', root.id);
+            if (parent.deleted)
+                throw new Error('The parent folder is deleted; pick an active folder');
+            const parentFullPath = FolderFullPath(parent);
+            if (String(parent.id) !== root.id && !parentFullPath.startsWith(root.fullPath)) {
+                throw new Error(`The parent folder "${parentFullPath}" lives outside this application's folder tree (${root.fullPath})`);
+            }
+            const siblings = await api.list('folder', { parentFolderId: { $oid: String(parent.id) }, name: raw.name }, 1);
+            if (siblings.length) {
+                throw new Error(`A folder named "${raw.name}" already exists at ${parentFullPath} (${siblings[0].id}); use it instead of creating a duplicate`);
+            }
+            const plan = { name: raw.name, parentFolderId: String(parent.id), path: `${parentFullPath}${raw.name}/` };
+            const token = PlanToken(cfg, 'create_elwis_folder', plan);
+            if (raw.dryRun)
+                return Text({ status: 'dry-run', dryRun: true, confirmationToken: token, message: DRY_RUN_MESSAGE, plan });
+            AssertWriteEnabled(cfg);
+            if (CheckConfirmation(cfg, token, raw.confirm) === 'pending') {
+                return Text({ status: 'confirmation-required', confirmationToken: token, plan, message: CONFIRMATION_MESSAGE });
+            }
+            const created = await AuditedExecute(cfg, scope, 'create_elwis_folder', token, () => api.create('folder', { name: plan.name, parentFolderId: plan.parentFolderId }), (r) => ({ created: r.id, path: plan.path }));
+            return Text({ status: 'ok', folder: { id: created.id, path: plan.path } });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=create-folder.js.map

package/dist/tools/create-folder.js.map

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