@softacus-software/elwis-data-mcp 0.1.0

package/dist/tools/read-artifacts.js

@@ -0,0 +1,197 @@
+import { z } from 'zod';
+import { AppScopeError } from '../app-scope.js';
+import { RequireApplicationId, ResolveOneId } from '../resolve.js';
+import { LoadAttributeMap, ResolveAttributeId, ResolveUnknownAttributeNames, BuildWhereClauses, EscapeRegex, SummarizeArtifact, TranslateArtifact, PageMeta } from '../artifact-read.js';
+import { Text, ErrorResult } from '../result.js';
+const READ_ONLY = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
+const MAP_CACHE_TTL_MS = 60000;
+const WherePrimitive = z.union([z.string(), z.number(), z.boolean(), z.null()]);
+const WhereInput = z.object({
+    attribute: z.string().describe('Attribute name or 24-char hex id'),
+    op: z.enum(['equals', 'contains', 'gt', 'gte', 'lt', 'lte', 'in']).optional().describe('Comparison operator (default equals)'),
+    value: z.union([WherePrimitive, z.array(WherePrimitive)]).describe('Primitive value, or an array of primitives for the in operator'),
+});
+class ReadContext {
+    api;
+    sysAttrs = null;
+    maps = new Map();
+    typeApps = new Map();
+    constructor(api) {
+        this.api = api;
+    }
+    systemAttributes() {
+        this.sysAttrs = this.sysAttrs ?? this.api.systemAttributes();
+        return this.sysAttrs;
+    }
+    attributeMap(applicationId) {
+        const hit = this.maps.get(applicationId);
+        if (hit && Date.now() - hit.at < MAP_CACHE_TTL_MS)
+            return hit.map;
+        const map = LoadAttributeMap(this.api, applicationId);
+        this.maps.set(applicationId, { at: Date.now(), map });
+        return map;
+    }
+    applicationOfType(artifactTypeId) {
+        let hit = this.typeApps.get(artifactTypeId);
+        if (!hit) {
+            hit = this.api.getOne('artifact-type', artifactTypeId)
+                .then(t => (t.applicationId ? String(t.applicationId) : null))
+                .catch(() => null);
+            this.typeApps.set(artifactTypeId, hit);
+        }
+        return hit;
+    }
+}
+async function AssertArtifactInScope(ctx, scope, artifact) {
+    const applicationId = await ctx.applicationOfType(String(artifact.artifactTypeId));
+    if (!scope.restricted)
+        return applicationId;
+    if (!applicationId)
+        throw new Error('The record has no resolvable owning application; a scoped deployment cannot serve it');
+    try {
+        await scope.assertAllowed(applicationId);
+    }
+    catch (e) {
+        if (e instanceof AppScopeError)
+            throw new Error('The record is outside the configured application allowlist (ELWIS_ALLOWED_APPS)');
+        throw e;
+    }
+    return applicationId;
+}
+async function CounterpartInScope(ctx, scope, artifact) {
+    if (!scope.restricted || !artifact)
+        return true;
+    const applicationId = await ctx.applicationOfType(String(artifact.artifactTypeId));
+    if (!applicationId)
+        return false;
+    const allowed = await scope.allowedIds();
+    return allowed === null || allowed.has(applicationId);
+}
+export function RegisterReadArtifacts(server, api, scope) {
+    const ctx = new ReadContext(api);
+    server.registerTool('list_elwis_artifacts', {
+        title: 'List ELWIS artifacts',
+        description: 'List or search live data records (artifacts) the configured user can access. Scope by application (required) and optionally by artifact type, folder path, a name substring, and attribute-value conditions combined with AND (attribute names are resolved for you; values must be primitives). Returns compact summaries with total/hasMore pagination metadata; fetch full records with get_elwis_artifact.',
+        inputSchema: {
+            applicationId: z.string().optional(),
+            applicationName: z.string().optional(),
+            artifactType: z.string().optional().describe('Artifact type name or id; when omitted, all types of the application are searched'),
+            nameContains: z.string().optional().describe('Case-insensitive substring match on the record name'),
+            folderPathContains: z.string().optional().describe('Case-insensitive substring match on the folder path'),
+            where: z.array(WhereInput).optional().describe('Attribute-value conditions, combined with AND'),
+            sortBy: z.string().optional().describe('Attribute name or id to sort by'),
+            sortOrder: z.enum(['asc', 'desc']).optional(),
+            limit: z.number().int().positive().max(100).optional().describe('Page size (default 25)'),
+            skip: z.number().int().min(0).optional(),
+        },
+        annotations: READ_ONLY,
+    }, async (raw) => {
+        try {
+            const applicationId = await RequireApplicationId(api, raw);
+            await scope.assertAllowed(applicationId);
+            const map = await ctx.attributeMap(applicationId);
+            const sys = await ctx.systemAttributes();
+            const and = [];
+            if (raw.artifactType) {
+                and.push({ artifactTypeId: { $oid: await ResolveOneId(api, 'artifact-type', applicationId, raw.artifactType) } });
+            }
+            else {
+                const types = await api.list('artifact-type', { applicationId: { $oid: applicationId } }, 501);
+                if (types.length > 500)
+                    throw new Error('The application has more than 500 artifact types; pass an explicit artifactType');
+                and.push({ artifactTypeId: { $in: types.map(t => ({ $oid: t.id })) } });
+            }
+            if (raw.nameContains)
+                and.push({ [`attributes.${sys.nameAttributeId}.value`]: { $regex: EscapeRegex(raw.nameContains), $options: 'i' } });
+            if (raw.folderPathContains)
+                and.push({ 'folderData.path': { $regex: EscapeRegex(raw.folderPathContains), $options: 'i' } });
+            if (raw.where?.length)
+                and.push(...BuildWhereClauses(map, raw.where));
+            const sort = raw.sortBy
+                ? { [`attributes.${ResolveAttributeId(map, raw.sortBy)}.value`]: raw.sortOrder === 'desc' ? -1 : 1 }
+                : undefined;
+            const page = await api.listRecords('artifact', { $and: and }, { sort, skip: raw.skip ?? 0, limit: raw.limit ?? 25 });
+            const results = page.data.map(a => SummarizeArtifact(a, sys.nameAttributeId));
+            return Text({ status: 'ok', ...PageMeta(page.meta, results.length), results });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+    server.registerTool('get_elwis_artifact', {
+        title: 'Get one ELWIS artifact',
+        description: 'Get one data record (artifact) by id with its attribute values translated to attribute names. Long values and long arrays are truncated with explicit markers; values whose attribute name is unknown or collides stay addressable in unmappedValuesById.',
+        inputSchema: { id: z.string().describe('Artifact id from list_elwis_artifacts') },
+        annotations: READ_ONLY,
+    }, async ({ id }) => {
+        try {
+            const artifact = await api.getOne('artifact', id);
+            const applicationId = await AssertArtifactInScope(ctx, scope, artifact);
+            const artifactTypeName = applicationId === null ? null : (await api.getOne('artifact-type', String(artifact.artifactTypeId))).name;
+            const map = applicationId ? await ctx.attributeMap(applicationId) : { byId: new Map(), byName: new Map() };
+            await ResolveUnknownAttributeNames(api, map, Object.keys(artifact.attributes ?? {}));
+            return Text({ status: 'ok', applicationId, artifactTypeName, ...TranslateArtifact(artifact, map) });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+    server.registerTool('list_elwis_artifact_links', {
+        title: 'List links of an ELWIS artifact',
+        description: 'List the links (relationships) of one artifact: link type, direction, and the record on the other side with its name. Counterparts living outside the configured application allowlist are redacted and marked outOfScope. Paginated.',
+        inputSchema: {
+            id: z.string().describe('Artifact id'),
+            direction: z.enum(['source', 'destination', 'both']).optional().describe('Restrict to links where this artifact is the source or the destination (default both)'),
+            limit: z.number().int().positive().max(100).optional(),
+            skip: z.number().int().min(0).optional(),
+        },
+        annotations: READ_ONLY,
+    }, async ({ id, direction, limit, skip }) => {
+        try {
+            const artifact = await api.getOne('artifact', id);
+            await AssertArtifactInScope(ctx, scope, artifact);
+            const clauses = [];
+            if (direction !== 'destination')
+                clauses.push({ sourceArtifactId: { $oid: id } });
+            if (direction !== 'source')
+                clauses.push({ destinationArtifactId: { $oid: id } });
+            const page = await api.listRecords('link', { $or: clauses }, { skip: skip ?? 0, limit: limit ?? 25 });
+            if (page.data.length === 0)
+                return Text({ status: 'ok', ...PageMeta(page.meta, 0), results: [] });
+            const sys = await ctx.systemAttributes();
+            const counterpartIds = [...new Set(page.data.map(l => String(String(l.sourceArtifactId) === id ? l.destinationArtifactId : l.sourceArtifactId)))];
+            const counterparts = new Map();
+            await Promise.all(counterpartIds.map(async (cid) => {
+                try {
+                    counterparts.set(cid, await api.getOne('artifact', cid));
+                }
+                catch {
+                    counterparts.set(cid, null);
+                }
+            }));
+            const linkTypeNames = new Map();
+            const results = await Promise.all(page.data.map(async (link) => {
+                const ltId = String(link.linkTypeId);
+                if (!linkTypeNames.has(ltId))
+                    linkTypeNames.set(ltId, api.getOne('link-type', ltId).then(lt => lt.name).catch(() => ltId));
+                const isSource = String(link.sourceArtifactId) === id;
+                const otherId = String(isSource ? link.destinationArtifactId : link.sourceArtifactId);
+                const other = counterparts.get(otherId) ?? null;
+                const inScope = await CounterpartInScope(ctx, scope, other);
+                return {
+                    linkId: link.id,
+                    linkType: await linkTypeNames.get(ltId),
+                    direction: isSource ? 'outgoing' : 'incoming',
+                    ...(inScope
+                        ? { otherArtifactId: otherId, otherArtifactName: other?.attributes?.[sys.nameAttributeId]?.value ?? null }
+                        : { otherArtifactId: null, otherArtifactName: null, outOfScope: true }),
+                };
+            }));
+            return Text({ status: 'ok', ...PageMeta(page.meta, results.length), results });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=read-artifacts.js.map

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

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

package/dist/tools/resolve-entity.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { ResolveEntity, RequireApplicationId } from '../resolve.js';
+import { Text, ErrorResult } from '../result.js';
+const KIND = z.enum(['dataType', 'attribute', 'artifactType', 'linkType', 'folder', 'page']);
+const MAP = { dataType: 'data-type', attribute: 'attribute', artifactType: 'artifact-type', linkType: 'link-type', folder: 'folder', page: 'page' };
+export function RegisterResolveEntity(server, api, scope) {
+    server.registerTool('resolve_elwis_entity', {
+        description: 'Resolve a data type / attribute / artifact type / link type / folder / page by name or alias within an application to its stable id. Active records only.',
+        inputSchema: { applicationId: z.string().optional(), applicationName: z.string().optional(), kind: KIND, nameOrAlias: z.string() },
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    }, async ({ applicationId, applicationName, kind, nameOrAlias }) => {
+        try {
+            const appId = await RequireApplicationId(api, { applicationId, applicationName });
+            await scope.assertAllowed(appId);
+            return Text({ status: 'ok', ...(await ResolveEntity(api, MAP[kind], appId, nameOrAlias)) });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=resolve-entity.js.map

package/dist/tools/resolve-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-entity.js","sourceRoot":"","sources":["../../src/tools/resolve-entity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAC7F,MAAM,GAAG,GAA+B,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAEhL,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,GAAa,EAAE,KAAe;IACrF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EAAE,2JAA2J;QACxK,WAAW,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;QAClI,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KAC/E,EACD,KAAK,EAAE,EAAE,aAAa,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE;QAC9D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC,CAAC;YAClF,MAAM,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/update-artifacts.js

@@ -0,0 +1,33 @@
+import { UpdateArtifactsInput, BuildUpdatePlan } from '../builders/records-lifecycle-plan.js';
+import { ExecuteUpdatePlan } from '../builders/records-lifecycle-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 RegisterUpdateArtifacts(server, api, cfg, scope) {
+    server.registerTool('update_elwis_artifacts', {
+        description: 'Update existing data records (artifacts) in one batch call (up to 50), the tool for requests like "mark the order as paid", "change the price to 120", or "rename this record". Records are addressed by name (scoped by artifactType when names repeat; one artifactType scope per call, split mixed-type batches) or by id. Only the attributes you pass change; everything else keeps its current value. Attribute keys are names (resolved case-insensitively) or ids; a key that is not assigned to the record\'s type is an error listing the assignable names, the tool never writes to a guessed field. Use rename to change the record\'s Name. A record whose name does not resolve is a clean error: nothing else gets modified in its place. Use dryRun to preview exactly which records and attributes would change.',
+        inputSchema: UpdateArtifactsInput.shape,
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
+    }, async (raw) => {
+        try {
+            const applicationId = await RequireApplicationId(api, raw);
+            await scope.assertAllowed(applicationId);
+            const plan = await BuildUpdatePlan(api, raw, applicationId);
+            const token = PlanToken(cfg, 'update_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, 'update_elwis_artifacts', token, () => ExecuteUpdatePlan(api, plan), (r) => ({ updated: r.updated }));
+            return Text({ status: 'ok', ...report });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=update-artifacts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-artifacts.js","sourceRoot":"","sources":["../../src/tools/update-artifacts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,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,myBAAmyB;QAChzB,WAAW,EAAE,oBAAoB,CAAC,KAAK;QACvC,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACvG,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,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;YAC5D,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,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACtJ,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/update-entity.js

@@ -0,0 +1,41 @@
+import { UpdateEntityInput, BuildEntityUpdatePlan } from '../builders/entity-lifecycle-plan.js';
+import { ExecuteEntityUpdatePlan } from '../builders/entity-lifecycle-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, ResolveApplicationId } from '../resolve.js';
+import { Text, ErrorResult } from '../result.js';
+export function RegisterUpdateEntity(server, api, cfg, scope) {
+    server.registerTool('update_elwis_entity', {
+        description: 'Update one configuration entity: an application, data type, attribute, artifact type, link type, workflow, or folder (rename, move via parentFolderId, an id, resolve it with get_elwis_entity, or reorder via folderSequence), the tool for requests like "rename the application", "rename the Status attribute", "add a value to the Priority enum" (enum values live on the data type, in its values array), "change the workflow trigger", or "fix the description". For entity "application", target IS the application (applicationId/applicationName are ignored). The entity is addressed by name, alias, or id within an application (workflows are tenant-wide by name). Read-modify-write: only the fields you pass change, everything else keeps its current value, read the entity first when editing structured fields like values or actions, then send the whole corrected field. id and applicationId cannot be changed. The backend validates the result; a rejected change is a clean error and nothing is modified. Use dryRun to preview the before/after diff of exactly what would change.',
+        inputSchema: UpdateEntityInput.shape,
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
+    }, async (raw) => {
+        try {
+            const applicationId = raw.entity === 'application'
+                ? await ResolveApplicationId(api, raw.target)
+                : await RequireApplicationId(api, raw);
+            await scope.assertAllowed(applicationId);
+            const plan = await BuildEntityUpdatePlan(api, raw, { applicationId, restricted: scope.restricted });
+            if (!plan.changedFields.length) {
+                return Text({ status: 'no-change', message: 'Every field already has the requested value; nothing was written.', plan: Preview(plan) });
+            }
+            const token = PlanToken(cfg, 'update_elwis_entity', plan);
+            if (raw.dryRun)
+                return Text({ status: 'dry-run', dryRun: true, confirmationToken: token, message: DRY_RUN_MESSAGE, plan: Preview(plan) });
+            AssertWriteEnabled(cfg);
+            if (CheckConfirmation(cfg, token, raw.confirm) === 'pending') {
+                return Text({ status: 'confirmation-required', confirmationToken: token, plan: Preview(plan), message: CONFIRMATION_MESSAGE });
+            }
+            const report = await AuditedExecute(cfg, scope, 'update_elwis_entity', token, () => ExecuteEntityUpdatePlan(api, plan), (r) => r.updated);
+            return Text({ status: 'ok', ...report });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+function Preview(plan) {
+    return { entity: plan.entity, id: plan.id, name: plan.name, changedFields: plan.changedFields };
+}
+//# sourceMappingURL=update-entity.js.map

package/dist/tools/update-entity.js.map

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

package/dist/tools/update-page.js

@@ -0,0 +1,40 @@
+import { UpdatePageInput, BuildUpdatePagePlan } from '../builders/update-page-plan.js';
+import { ExecuteUpdatePagePlan } from '../builders/update-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 RegisterUpdatePage(server, api, cfg, scope) {
+    server.registerTool('update_elwis_page', {
+        description: `Change an existing page in place, the tool for requests like "make the background darker", "change the header text", "add a banner", or "remove the second section". Call get_elwis_page first to see the structure and widget ids.
+
+OPERATIONS: sectionStyles (merge or replace a section's CSS), widgetTexts (replace a TEXT widget's HTML content), addSections / removeSections, rename / alias / isPublic. sectionStyles and removeSections use the section numbers get_elwis_page returned; addSections positions are evaluated after removals.
+
+STYLE VOCABULARY, users speak plainly, not in CSS; translate their words: "beautiful/modern" = rounded corners (12-14px), soft shadows, generous padding, a restrained palette; "animated/alive" = :hover transitions and @keyframes fade or slide-in inside the widget's <style> block (script tags never execute, interactivity only via inline on* attributes); "dark mode/carbon/black" = backgroundColor around #0f0f14, panels #1a1524, light text #e0e0e0; "darker/lighter" alone = shift the CURRENT backgroundColor (visible in get_elwis_page section styles) a step in that direction, not a jump to the dark palette; "warmer" = cream/beige backgrounds (#faf6f0) with an amber accent, "cooler" = blue-gray tones; "cleaner/minimal" = remove shadows and borders, white background, one accent color, larger headings, MORE padding; "bigger" = one step up in font-size and padding; "more space/air" = outerContainer paddingTop/paddingBottom 24-48px. Backgrounds and spacing belong on section outerContainer styles; visual detail (cards, buttons, animations) lives inside widget HTML via widgetTexts.
+
+BEFORE WRITING: widgetTexts replaces the ENTIRE widget content, first fetch the current HTML with get_elwis_page fullTextWidgets:[id] and modify it; never regenerate a widget from its excerpt. removeSections and widgetTexts cannot be undone: always call with dryRun:true first, show the user the change summary, and repeat without dryRun only after they confirm. When the request is vague, propose 2-3 concrete options (which section, what colors, what text) and make your first call with dryRun:true so the user confirms the actual change, not a paraphrase of it.`,
+        inputSchema: UpdatePageInput.shape,
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
+    }, async (raw) => {
+        try {
+            const applicationId = await RequireApplicationId(api, raw);
+            await scope.assertAllowed(applicationId);
+            const plan = await BuildUpdatePagePlan(api, raw, applicationId);
+            const token = PlanToken(cfg, 'update_elwis_page', plan);
+            if (raw.dryRun) {
+                return Text({ status: 'dry-run', dryRun: true, confirmationToken: token, message: DRY_RUN_MESSAGE, page: plan.page, changes: plan.summary, newWidgets: plan.newWidgets.length });
+            }
+            AssertWriteEnabled(cfg);
+            if (CheckConfirmation(cfg, token, raw.confirm) === 'pending') {
+                return Text({ status: 'confirmation-required', confirmationToken: token, page: plan.page, changes: plan.summary, message: CONFIRMATION_MESSAGE });
+            }
+            const report = await AuditedExecute(cfg, scope, 'update_elwis_page', token, () => ExecuteUpdatePagePlan(api, plan), (r) => ({ page: r.page, applied: r.applied, createdWidgets: r.createdWidgets.length, updatedWidgets: r.updatedWidgets }));
+            return Text({ status: 'ok', ...report });
+        }
+        catch (e) {
+            return ErrorResult(e);
+        }
+    });
+}
+//# sourceMappingURL=update-page.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-page.js","sourceRoot":"","sources":["../../src/tools/update-page.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,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,mBAAmB,EACnB;QACE,WAAW,EAAE;;;;;;qjBAMkiB;QAC/iB,WAAW,EAAE,eAAe,CAAC,KAAK;QAClC,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,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,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;YAChE,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC;YACxD,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACf,OAAO,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YACnL,CAAC;YACD,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,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;YACpJ,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;YAC9O,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/write-gate.js

@@ -0,0 +1,25 @@
+export const DRY_RUN_MESSAGE = 'Preview only, nothing was written. Summarize the plan for the user in plain language. After they approve, call again without dryRun and with confirm set to this confirmationToken; one approval is enough, do not ask twice.';
+export const CONFIRMATION_MESSAGE = 'Not executed yet. Summarize this plan for the user in plain language, what will be created or changed, with names and counts, no raw JSON or ids, and ask one clear yes/no question. Never show or mention the confirmationToken; it is internal to your next tool call. Once the user agrees, call this tool again with the same arguments plus confirm set to the confirmationToken. If the user already approved this exact plan earlier in the conversation (the dryRun preview carrying this same confirmationToken), that approval counts, execute now instead of asking again.';
+export class WriteDisabledError extends Error {
+    constructor() { super('Writes are disabled. Set ELWIS_WRITE_ENABLED=true to allow build tools.'); this.name = 'WriteDisabledError'; }
+}
+export class StalePlanError extends Error {
+    constructor() {
+        super('Nothing was written. This plan is not the one that was confirmed, either the underlying data changed since the preview, or the arguments differ from what was previewed. Run the preview again, show the user the current plan in plain language, and get a fresh approval before executing.');
+        this.name = 'StalePlanError';
+    }
+}
+export function AssertWriteEnabled(cfg) {
+    if (!cfg.writeEnabled)
+        throw new WriteDisabledError();
+}
+export function CheckConfirmation(cfg, token, confirm) {
+    if (!cfg.requireConfirmation)
+        return 'execute';
+    if (!confirm)
+        return 'pending';
+    if (confirm !== token)
+        throw new StalePlanError();
+    return 'execute';
+}
+//# sourceMappingURL=write-gate.js.map

package/dist/write-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-gate.js","sourceRoot":"","sources":["../src/write-gate.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAC1B,+NAA+N,CAAC;AAElO,MAAM,CAAC,MAAM,oBAAoB,GAC/B,ujBAAujB,CAAC;AAE1jB,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,gBAAgB,KAAK,CAAC,yEAAyE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC,CAAC,CAAC;CACtI;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC;QACE,KAAK,CAAC,8RAA8R,CAAC,CAAC;QACtS,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAgB;IACjD,IAAI,CAAC,GAAG,CAAC,YAAY;QAAE,MAAM,IAAI,kBAAkB,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAgB,EAAE,KAAa,EAAE,OAA2B;IAC5F,IAAI,CAAC,GAAG,CAAC,mBAAmB;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,OAAO,KAAK,KAAK;QAAE,MAAM,IAAI,cAAc,EAAE,CAAC;IAClD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@softacus-software/elwis-data-mcp",
+  "version": "0.1.0",
+  "description": "Write-capable Model Context Protocol server for building ELWIS configuration over the ELWIS HTTP API.",
+  "type": "module",
+  "bin": {
+    "elwis-data-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "shx rm -rf dist && tsc && shx chmod +x dist/index.js",
+    "watch": "tsc --watch",
+    "lint": "eslint .",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "tsx --test test/*.test.ts",
+    "prepack": "npm run build",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^26.0.1",
+    "eslint": "^10.6.0",
+    "shx": "^0.4.0",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.1"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.softacus.com/elwis/manage-data-mcp.git"
+  },
+  "keywords": [
+    "modelcontextprotocol",
+    "mcp",
+    "elwis",
+    "softacus"
+  ],
+  "license": "UNLICENSED"
+}