@cyberismo/backend 1.1.2 → 1.3.0

package/dist/domain/resources/index.js

@@ -1,22 +1,12 @@
-/**
-  Cyberismo
-  Copyright © Cyberismo Ltd and contributors 2025
-  This program is free software: you can redistribute it and/or modify it under
-  the terms of the GNU Affero General Public License version 3 as published by
-  the Free Software Foundation.
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
-  details. You should have received a copy of the GNU Affero General Public
-  License along with this program. If not, see <https://www.gnu.org/licenses/>.
-*/
+// SPDX-FileCopyrightText: Cyberismo Ltd and contributors
+// SPDX-License-Identifier: AGPL-3.0-only
 import { Hono } from 'hono';
 import { ssgParams } from 'hono/ssg';
 import * as resourceService from './service.js';
 import { UserRole } from '../../types.js';
 import { resourceParamsSchema } from '../../common/validationSchemas.js';
 import { zValidator } from '../../middleware/zvalidator.js';
-import { validateResourceParamsSchema, updateOperationBodySchema, workflowGraphParamsSchema, workflowGraphQuerySchema, } from './schema.js';
+import { validateResourceParamsSchema, prefixIdentifierParamsSchema, skillPreviewBodySchema, updateOperationBodySchema, workflowGraphQuerySchema, } from './schema.js';
 import { requireRole } from '../../middleware/auth.js';
 const router = new Hono();
 /**
@@ -32,9 +22,9 @@ const router = new Hono();
  *         description: project_path not set or other internal error
  */
 router.get('/tree', requireRole(UserRole.Reader), async (c) => {
-    const commands = c.get('commands');
+    const ws = c.get('ws');
     try {
-        const tree = await resourceService.buildResourceTree(commands);
+        const tree = await resourceService.buildResourceTree(ws);
         return c.json(tree);
     }
     catch (error) {
@@ -88,10 +78,10 @@ router.get('/tree', requireRole(UserRole.Reader), async (c) => {
  *         description: Internal server error
  */
 router.get('/:prefix/:type/:identifier/validate', requireRole(UserRole.Reader), zValidator('param', validateResourceParamsSchema), async (c) => {
-    const commands = c.get('commands');
+    const ws = c.get('ws');
     const resourceParams = c.req.valid('param');
     try {
-        const response = await resourceService.validateResource(commands, resourceParams);
+        const response = await resourceService.validateResource(ws, resourceParams);
         return c.json(response);
     }
     catch (error) {
@@ -102,9 +92,9 @@ router.get('/:prefix/:type/:identifier/validate', requireRole(UserRole.Reader),
     }
 });
 router.delete('/:prefix/:type/:identifier', requireRole(UserRole.Admin), zValidator('param', resourceParamsSchema), async (c) => {
-    const commands = c.get('commands');
+    const ws = c.get('ws');
     const resourceParams = c.req.valid('param');
-    await resourceService.deleteResource(commands, resourceParams);
+    await resourceService.deleteResource(ws, resourceParams);
     return c.json({
         message: 'Resource deleted',
     });
@@ -156,15 +146,15 @@ router.delete('/:prefix/:type/:identifier', requireRole(UserRole.Admin), zValida
  *         description: Server error
  */
 router.get('/:prefix/workflows/:identifier/graph', requireRole(UserRole.Reader), ssgParams(async (c) => {
-    const commands = c.get('commands');
-    return resourceService.listWorkflowGraphParams(commands);
-}), zValidator('param', workflowGraphParamsSchema), zValidator('query', workflowGraphQuerySchema), async (c) => {
-    const commands = c.get('commands');
+    const ws = c.get('ws');
+    return resourceService.listWorkflowGraphParams(ws);
+}), zValidator('param', prefixIdentifierParamsSchema), zValidator('query', workflowGraphQuerySchema), async (c) => {
+    const ws = c.get('ws');
     const { prefix, identifier } = c.req.valid('param');
     const { card } = c.req.valid('query');
     const workflowName = `${prefix}/workflows/${identifier}`;
     try {
-        const svg = await resourceService.getWorkflowGraph(commands, workflowName, card);
+        const svg = await resourceService.getWorkflowGraph(ws, workflowName, card);
         return c.json({ svg });
     }
     catch (error) {
@@ -174,11 +164,86 @@ router.get('/:prefix/workflows/:identifier/graph', requireRole(UserRole.Reader),
         throw error;
     }
 });
+/**
+ * @swagger
+ * /api/resources/{prefix}/skills/{identifier}/preview:
+ *   post:
+ *     summary: Render a skill's instructions for the configuration editor
+ *     description: Applies Handlebars templating to the skill content and
+ *                  returns the rendered markdown. For template skills the
+ *                  logic program in query.lp is executed first and its result
+ *                  is used as the template context. Unlike the MCP get_skill
+ *                  tool, the skill does not need to be enabled by the logic
+ *                  programs. Pass skillContent and/or skillQuery to render
+ *                  unsaved editor content instead of what is stored on disk.
+ *     parameters:
+ *       - in: path
+ *         name: prefix
+ *         required: true
+ *         schema:
+ *           type: string
+ *       - in: path
+ *         name: identifier
+ *         required: true
+ *         schema:
+ *           type: string
+ *     requestBody:
+ *       required: false
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             properties:
+ *               skillContent:
+ *                 type: string
+ *                 description: Unsaved skill.md content to render.
+ *               skillQuery:
+ *                 type: string
+ *                 description: Unsaved query.lp content to run.
+ *               cardKey:
+ *                 type: string
+ *                 description: Card context for a card-specific skill.
+ *     responses:
+ *       200:
+ *         description: Rendered instructions
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 instructions:
+ *                   type: string
+ *                   description: The rendered skill content as markdown.
+ *       400:
+ *         description: Invalid path parameters, or the query or template failed
+ *       404:
+ *         description: Skill or card not found
+ */
+router.post('/:prefix/skills/:identifier/preview', requireRole(UserRole.Admin), zValidator('param', prefixIdentifierParamsSchema), zValidator('json', skillPreviewBodySchema), async (c) => {
+    const ws = c.get('ws');
+    const { prefix, identifier } = c.req.valid('param');
+    const body = c.req.valid('json');
+    const skillName = `${prefix}/skills/${identifier}`;
+    try {
+        const instructions = await resourceService.previewSkill(ws, skillName, body);
+        return c.json({ instructions });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        if (message.includes('not found')) {
+            return c.json({ error: message }, 404);
+        }
+        return c.json({ error: message }, 400);
+    }
+});
 router.post('/:prefix/:type/:identifier/operation', requireRole(UserRole.Admin, [UserRole.Connector]), zValidator('param', resourceParamsSchema), zValidator('json', updateOperationBodySchema), async (c) => {
-    const commands = c.get('commands');
+    const ws = c.get('ws');
     const resourceParams = c.req.valid('param');
     const { updateKey, operation } = c.req.valid('json');
-    await resourceService.updateResourceWithOperation(commands, resourceParams, { updateKey, operation });
+    await resourceService.updateResourceWithOperation(ws, resourceParams, {
+        updateKey,
+        operation,
+    });
     return c.json({ message: 'Updated' });
 });
 export default router;

package/dist/domain/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/resources/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,eAAe,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;AAE1B;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAC5D,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC/D,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,CAAC,IAAI,CACX;YACE,KAAK,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;SACpG,EACD,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,CAAC,GAAG,CACR,qCAAqC,EACrC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC5B,UAAU,CAAC,OAAO,EAAE,4BAA4B,CAAC,EACjD,KAAK,EAAE,CAAC,EAAE,EAAE;IACV,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,QAAQ,GACZ,MAAM,eAAe,CAAC,gBAAgB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAClE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,CACX,4BAA4B,EAC5B,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAC3B,UAAU,CAAC,OAAO,EAAE,oBAAoB,CAAC,EACzC,KAAK,EAAE,CAAC,EAAE,EAAE;IACV,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,eAAe,CAAC,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC/D,OAAO,CAAC,CAAC,IAAI,CAAC;QACZ,OAAO,EAAE,kBAAkB;KAC5B,CAAC,CAAC;AACL,CAAC,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,CAAC,GAAG,CACR,sCAAsC,EACtC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC5B,SAAS,CAAC,KAAK,EAAE,CAAa,EAAE,EAAE;IAChC,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO,eAAe,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAC3D,CAAC,CAAC,EACF,UAAU,CAAC,OAAO,EAAE,yBAAyB,CAAC,EAC9C,UAAU,CAAC,OAAO,EAAE,wBAAwB,CAAC,EAC7C,KAAK,EAAE,CAAC,EAAE,EAAE;IACV,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,GAAG,MAAM,cAAc,UAAU,EAAE,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,gBAAgB,CAChD,QAAQ,EACR,YAAY,EACZ,IAAI,CACL,CAAC;QACF,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAClE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,sCAAsC,EACtC,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EACjD,UAAU,CAAC,OAAO,EAAE,oBAAoB,CAAC,EACzC,UAAU,CAAC,MAAM,EAAE,yBAAyB,CAAC,EAC7C,KAAK,EAAE,CAAC,EAAE,EAAE;IACV,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,cAAc,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAErD,MAAM,eAAe,CAAC,2BAA2B,CAC/C,QAAQ,EACR,cAAc,EACd,EAAE,SAAS,EAAE,SAAS,EAAE,CACzB,CAAC;IACF,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AACxC,CAAC,CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/resources/index.ts"],"names":[],"mappings":"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"}

package/dist/domain/resources/schema.d.ts

@@ -1,13 +1,19 @@
 import { z } from 'zod';
-export declare const workflowGraphParamsSchema: z.ZodObject<{
+export declare const prefixIdentifierParamsSchema: z.ZodObject<{
     prefix: z.ZodString;
     identifier: z.ZodString;
 }, z.core.$strip>;
-export type WorkflowGraphParams = z.infer<typeof workflowGraphParamsSchema>;
+export type PrefixIdentifierParams = z.infer<typeof prefixIdentifierParamsSchema>;
 export declare const workflowGraphQuerySchema: z.ZodObject<{
     card: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type WorkflowGraphQuery = z.infer<typeof workflowGraphQuerySchema>;
+export declare const skillPreviewBodySchema: z.ZodObject<{
+    skillContent: z.ZodOptional<z.ZodString>;
+    skillQuery: z.ZodOptional<z.ZodString>;
+    cardKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SkillPreviewBody = z.infer<typeof skillPreviewBodySchema>;
 export declare const resourceFileParamsSchema: z.ZodObject<{
     prefix: z.ZodString;
     type: z.ZodEnum<{

package/dist/domain/resources/schema.js

@@ -1,12 +1,19 @@
+// SPDX-FileCopyrightText: Cyberismo Ltd and contributors
+// SPDX-License-Identifier: AGPL-3.0-only
 import { z } from 'zod';
 import { identifierSchema, resourceParamsSchema, resourceTypes, } from '../../common/validationSchemas.js';
-export const workflowGraphParamsSchema = z.object({
+export const prefixIdentifierParamsSchema = z.object({
     prefix: z.string(),
     identifier: identifierSchema,
 });
 export const workflowGraphQuerySchema = z.object({
     card: z.string().optional(),
 });
+export const skillPreviewBodySchema = z.object({
+    skillContent: z.string().optional(),
+    skillQuery: z.string().optional(),
+    cardKey: z.string().optional(),
+});
 export const resourceFileParamsSchema = resourceParamsSchema.extend({
     file: z.string(),
 });

package/dist/domain/resources/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/domain/resources/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,GACd,MAAM,mCAAmC,CAAC;AAE3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,gBAAgB;CAC7B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAClE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,4BAA4B,GAAG,oBAAoB,CAAC,MAAM,CAAC;IACtE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;CAC5B,CAAC,CAAC;AAMH,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC;IACxB,CAAC,CAAC,MAAM,CAAC;QACP,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE;YAC7C,OAAO,EAAE,8BAA8B;SACxC,CAAC;KACH,CAAC;CACH,CAAC,CAAC;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS;IACT,SAAS,EAAE,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;QACtC,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YACtB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;SACpB,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YACzB,oEAAoE;YACpE,kEAAkE;YAClE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC9B,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;YACf,YAAY,EAAE,CAAC;iBACZ,MAAM,CAAC;gBACN,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;aAC/C,CAAC;iBACD,QAAQ,EAAE;SACd,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YACzB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;YACnB,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzC,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YACvB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;YACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;SACrB,CAAC;KACH,CAAC;CACH,CAAC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/domain/resources/schema.ts"],"names":[],"mappings":"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"}

package/dist/domain/resources/service.d.ts

@@ -1,40 +1,28 @@
-/**
-  Cyberismo
-  Copyright © Cyberismo Ltd and contributors 2025
-  This program is free software: you can redistribute it and/or modify it under
-  the terms of the GNU Affero General Public License version 3 as published by
-  the Free Software Foundation.
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
-  details. You should have received a copy of the GNU Affero General Public
-  License along with this program. If not, see <https://www.gnu.org/licenses/>.
-*/
-import { type CommandManager } from '@cyberismo/data-handler';
+import { type Workspace } from '@cyberismo/data-handler';
 import type { ResourceParams } from '../../common/validationSchemas.js';
-import type { ValidateResourceParams, UpdateOperationBody } from './schema.js';
-export declare function buildResourceTree(commands: CommandManager): Promise<unknown[]>;
+import type { SkillPreviewBody, UpdateOperationBody, ValidateResourceParams } from './schema.js';
+export declare function buildResourceTree(ws: Workspace): Promise<unknown[]>;
 /**
  * Delete a resource.
- * @param commands Command manager.
+ * @param ws Command manager.
  * @param resource Resource to delete.
  */
-export declare function deleteResource(commands: CommandManager, resource: ResourceParams): Promise<void>;
+export declare function deleteResource(ws: Workspace, resource: ResourceParams): Promise<void>;
 /**
  * Validate a single resource.
- * @param commands Command manager.
+ * @param ws Command manager.
  * @param resource Resource to validate.
  * @returns Validation result with errors and validity status.
  */
-export declare function validateResource(commands: CommandManager, resource: ValidateResourceParams): Promise<{
+export declare function validateResource(ws: Workspace, resource: ValidateResourceParams): Promise<{
     errors: string[];
 }>;
 /**
  * Lists the path params for every workflow resource in the project.
- * @param commands Command manager.
+ * @param ws Command manager.
  * @returns One `{ prefix, identifier }` entry per workflow resource.
  */
-export declare function listWorkflowGraphParams(commands: CommandManager): Promise<{
+export declare function listWorkflowGraphParams(ws: Workspace): Promise<{
     prefix: string;
     identifier: string;
 }[]>;
@@ -49,9 +37,21 @@ export declare function listWorkflowGraphParams(commands: CommandManager): Promi
  * @throws Error with 'not found' in the message when the workflow or
  *   card cannot be resolved.
  */
-export declare function getWorkflowGraph(commands: CommandManager, workflowName: string, cardKey?: string): Promise<string>;
+export declare function getWorkflowGraph(ws: Workspace, workflowName: string, cardKey?: string): Promise<string>;
+/**
+ * Renders a skill's instructions for the configuration editor preview.
+ * Unlike the MCP `get_skill` tool, this does not require the skill to be
+ * enabled by the logic programs — the author is still working on it. When
+ * `skillContent` or `skillQuery` is given, that unsaved editor content is
+ * rendered instead of what is stored on disk. The lookups and the rendering
+ * share one consistency window so the preview matches a single project state.
+ * @returns the rendered instructions as markdown.
+ * @throws Error with 'not found' in the message when the skill or card cannot
+ *   be resolved; any other error means the template or query failed to render.
+ */
+export declare function previewSkill(ws: Workspace, skillName: string, body: SkillPreviewBody): Promise<string>;
 /**
  * Perform an updateOperation on a resource key.
  * This delegates to the data-handler mutation engine.
  */
-export declare function updateResourceWithOperation(commands: CommandManager, resource: ResourceParams, body: UpdateOperationBody): Promise<void>;
+export declare function updateResourceWithOperation(ws: Workspace, resource: ResourceParams, body: UpdateOperationBody): Promise<void>;

package/dist/domain/resources/service.js

@@ -1,16 +1,6 @@
-/**
-  Cyberismo
-  Copyright © Cyberismo Ltd and contributors 2025
-  This program is free software: you can redistribute it and/or modify it under
-  the terms of the GNU Affero General Public License version 3 as published by
-  the Free Software Foundation.
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
-  details. You should have received a copy of the GNU Affero General Public
-  License along with this program. If not, see <https://www.gnu.org/licenses/>.
-*/
-import { isResourceFolderType, moduleNameFromCardKey, resourceName, resourceNameToString, } from '@cyberismo/data-handler';
+// SPDX-FileCopyrightText: Cyberismo Ltd and contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+import { CardNotFoundError, isResourceFolderType, moduleNameFromCardKey, resourceName, resourceNameToString, ResourceNotFoundError, } from '@cyberismo/data-handler';
 const resourceTypes = [
     'calculations',
     'cardTypes',
@@ -19,15 +9,16 @@ const resourceTypes = [
     'graphViews',
     'linkTypes',
     'reports',
+    'skills',
     'templates',
     'workflows',
 ];
-async function getModules(commands) {
+async function getModules(ws) {
     try {
-        const modules = await commands.showCmd.showModules();
+        const modules = await ws.modules.list();
         return Promise.all(modules.map(async (mod) => {
             try {
-                const module = await commands.showCmd.showModule(mod.name);
+                const module = await ws.modules.show(mod.name);
                 return { name: module.name, cardKeyPrefix: module.cardKeyPrefix };
             }
             catch {
@@ -54,12 +45,12 @@ function sortTemplateCardsByRank(cards) {
         childrenCards: sortTemplateCardsByRank(card.childrenCards ?? []),
     }));
 }
-export async function buildResourceTree(commands) {
-    return commands.consistent(async () => {
-        const project = await commands.showCmd.showProject();
+export async function buildResourceTree(ws) {
+    return ws.consistent(async () => {
+        const project = await ws.settings.info();
         const tree = [];
         const sortByDisplayName = (nodes) => nodes.sort((a, b) => (a.data.displayName || a.data.name.split('/')[2] || '').localeCompare(b.data.displayName || b.data.name.split('/')[2] || ''));
-        const modules = await getModules(commands);
+        const modules = await getModules(ws);
         // General section first (single node with project + modules metadata)
         tree.push({
             id: 'general-project',
@@ -77,10 +68,10 @@ export async function buildResourceTree(commands) {
             let rootResources;
             let moduleResources;
             if (resourceType === 'templates') {
-                ({ rootResources, moduleResources } = await processTemplates(commands, project.prefix));
+                ({ rootResources, moduleResources } = await processTemplates(ws, project.prefix));
             }
             else {
-                ({ rootResources, moduleResources } = await groupResourcesByPrefix(commands, resourceType, project.prefix));
+                ({ rootResources, moduleResources } = await groupResourcesByPrefix(ws, resourceType, project.prefix));
             }
             // Sort resources by display name if present
             sortByDisplayName(rootResources);
@@ -134,8 +125,8 @@ function parseResourcePrefix(resource) {
 }
 // Helper function to create resource node with all data from showResource
 // TODO: The types should be shared between backend and frontend
-async function createResourceNode(commands, resourceType, name, projectPrefix, children) {
-    const resourceData = await commands.showCmd.showResource(name);
+async function createResourceNode(ws, resourceType, name, projectPrefix, children) {
+    const resourceData = await ws.resources.show(name);
     const node = {
         id: `${resourceType}-${name}`,
         type: resourceType,
@@ -193,9 +184,9 @@ function createCardNode(card, module, projectPrefix) {
     return cardNode;
 }
 // Helper function to process templates using templateTree query
-async function processTemplates(commands, projectPrefix) {
-    const templates = await commands.showCmd.showResources('templates');
-    const templateTree = await commands.showCmd.showAllTemplateCards();
+async function processTemplates(ws, projectPrefix) {
+    const templates = await ws.resources.list('templates');
+    const templateTree = await ws.cards.templateCards();
     const rootTemplates = {};
     const moduleTemplates = {};
     for (const { name, cards } of templateTree) {
@@ -222,17 +213,17 @@ async function processTemplates(commands, projectPrefix) {
             }
         }
     }
-    const rootResources = await Promise.all(Object.entries(rootTemplates).map(([templateName, cards]) => createResourceNode(commands, 'templates', templateName, projectPrefix, cards)));
+    const rootResources = await Promise.all(Object.entries(rootTemplates).map(([templateName, cards]) => createResourceNode(ws, 'templates', templateName, projectPrefix, cards)));
     const moduleResources = {};
     for (const [prefix, templates] of Object.entries(moduleTemplates)) {
-        moduleResources[prefix] = await Promise.all(Object.entries(templates).map(([templateName, cards]) => createResourceNode(commands, 'templates', templateName, projectPrefix, cards)));
+        moduleResources[prefix] = await Promise.all(Object.entries(templates).map(([templateName, cards]) => createResourceNode(ws, 'templates', templateName, projectPrefix, cards)));
     }
     // Add also templates that do not have any cards
     for (const template of templates) {
         const { prefix } = parseResourcePrefix(template);
         if (prefix === projectPrefix) {
             if (!rootResources.find((resource) => resource.name === template)) {
-                rootResources.push(await createResourceNode(commands, 'templates', template, projectPrefix, []));
+                rootResources.push(await createResourceNode(ws, 'templates', template, projectPrefix, []));
             }
         }
         else {
@@ -240,16 +231,16 @@ async function processTemplates(commands, projectPrefix) {
                 moduleResources[prefix] = [];
             }
             if (!moduleResources[prefix].find((resource) => resource.name === template)) {
-                moduleResources[prefix].push(await createResourceNode(commands, 'templates', template, projectPrefix, []));
+                moduleResources[prefix].push(await createResourceNode(ws, 'templates', template, projectPrefix, []));
             }
         }
     }
     return { rootResources, moduleResources };
 }
 // Helper function to group regular resources by prefix
-async function groupResourcesByPrefix(commands, resourceType, projectPrefix) {
-    const resourceNames = await commands.showCmd.showResources(resourceType);
-    const resources = await Promise.all(resourceNames.map((name) => createResourceNode(commands, resourceType, name, projectPrefix)));
+async function groupResourcesByPrefix(ws, resourceType, projectPrefix) {
+    const resourceNames = await ws.resources.list(resourceType);
+    const resources = await Promise.all(resourceNames.map((name) => createResourceNode(ws, resourceType, name, projectPrefix)));
     const rootResources = [];
     const moduleResources = {};
     resources.forEach((resource) => {
@@ -268,31 +259,31 @@ async function groupResourcesByPrefix(commands, resourceType, projectPrefix) {
 }
 /**
  * Delete a resource.
- * @param commands Command manager.
+ * @param ws Command manager.
  * @param resource Resource to delete.
  */
-export async function deleteResource(commands, resource) {
-    return commands.removeCmd.remove(resource.type.substring(0, resource.type.length - 1), resourceNameToString(resource));
+export async function deleteResource(ws, resource) {
+    return ws.resources.remove(resourceNameToString(resource), resource.type.substring(0, resource.type.length - 1));
 }
 /**
  * Validate a single resource.
- * @param commands Command manager.
+ * @param ws Command manager.
  * @param resource Resource to validate.
  * @returns Validation result with errors and validity status.
  */
-export async function validateResource(commands, resource) {
-    const errors = await commands.consistent(() => commands.validateCmd.validateResource(resource, commands.project));
+export async function validateResource(ws, resource) {
+    const errors = await ws.resources.validate(resource);
     return {
         errors: errors.split('\n\n').filter((error) => error !== ''),
     };
 }
 /**
  * Lists the path params for every workflow resource in the project.
- * @param commands Command manager.
+ * @param ws Command manager.
  * @returns One `{ prefix, identifier }` entry per workflow resource.
  */
-export async function listWorkflowGraphParams(commands) {
-    const workflows = await commands.showCmd.showResources('workflows');
+export async function listWorkflowGraphParams(ws) {
+    const workflows = await ws.resources.list('workflows');
     return workflows.map((name) => {
         const { prefix, identifier } = resourceName(name);
         return { prefix, identifier };
@@ -309,13 +300,13 @@ export async function listWorkflowGraphParams(commands) {
  * @throws Error with 'not found' in the message when the workflow or
  *   card cannot be resolved.
  */
-export async function getWorkflowGraph(commands, workflowName, cardKey) {
-    return commands.consistent(async () => {
+export async function getWorkflowGraph(ws, workflowName, cardKey) {
+    return ws.consistent(async () => {
         try {
-            await commands.showCmd.showResource(workflowName, 'workflows');
+            await ws.resources.show(workflowName, 'workflows');
         }
         catch (error) {
-            if (error instanceof Error && error.message.includes('does not exist')) {
+            if (error instanceof ResourceNotFoundError) {
                 throw new Error(`Workflow '${workflowName}' not found`, {
                     cause: error,
                 });
@@ -326,7 +317,7 @@ export async function getWorkflowGraph(commands, workflowName, cardKey) {
         if (cardKey) {
             let card;
             try {
-                card = await commands.showCmd.showCardDetails(cardKey);
+                card = await ws.cards.details(cardKey);
             }
             catch (error) {
                 throw new Error(`Card '${cardKey}' not found`, { cause: error });
@@ -336,18 +327,59 @@ export async function getWorkflowGraph(commands, workflowName, cardKey) {
             }
             currentState = card.metadata.workflowState;
         }
-        return commands.calculateCmd.runWorkflowGraph(workflowName, {
+        return ws.queries.runWorkflowGraph(workflowName, {
             currentState,
         });
     });
 }
+/**
+ * Renders a skill's instructions for the configuration editor preview.
+ * Unlike the MCP `get_skill` tool, this does not require the skill to be
+ * enabled by the logic programs — the author is still working on it. When
+ * `skillContent` or `skillQuery` is given, that unsaved editor content is
+ * rendered instead of what is stored on disk. The lookups and the rendering
+ * share one consistency window so the preview matches a single project state.
+ * @returns the rendered instructions as markdown.
+ * @throws Error with 'not found' in the message when the skill or card cannot
+ *   be resolved; any other error means the template or query failed to render.
+ */
+export async function previewSkill(ws, skillName, body) {
+    const { cardKey, skillContent, skillQuery } = body;
+    return ws.consistent(async () => {
+        try {
+            await ws.resources.show(skillName, 'skills');
+        }
+        catch (error) {
+            if (error instanceof ResourceNotFoundError) {
+                throw new Error(`Skill '${skillName}' not found`, { cause: error });
+            }
+            throw error;
+        }
+        if (cardKey) {
+            try {
+                await ws.cards.details(cardKey);
+            }
+            catch (error) {
+                if (error instanceof CardNotFoundError) {
+                    throw new Error(`Card '${cardKey}' not found`, { cause: error });
+                }
+                throw error;
+            }
+        }
+        return ws.resources.skillPreview(skillName, {
+            cardKey,
+            skillContent,
+            skillQuery,
+        });
+    });
+}
 /**
  * Perform an updateOperation on a resource key.
  * This delegates to the data-handler mutation engine.
  */
-export async function updateResourceWithOperation(commands, resource, body) {
+export async function updateResourceWithOperation(ws, resource, body) {
     const { updateKey, operation } = body;
-    await commands.atomic(() => commands.updateCmd.apply({
+    await ws.atomic(() => ws.changes.apply({
         kind: 'edit',
         target: resource,
         updateKey,