@webiny/api-aco 0.0.0-unstable.7be00a75a9 → 0.0.0-unstable.7c2def32a7

package/features/ai/CreateFolderTool.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { CreateFolderUseCase } from "../../features/folder/CreateFolder/index.js";
+declare const inputSchema: z.ZodObject<{
+    title: z.ZodString;
+    slug: z.ZodString;
+    type: z.ZodString;
+    parentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Input = z.infer<typeof inputSchema>;
+interface CreatedFolder {
+    id: string;
+    title: string;
+    slug: string;
+    path: string;
+    type: string;
+}
+declare class CreateFolderToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {
+    private createFolder;
+    constructor(createFolder: CreateFolderUseCase.Interface);
+    execute(input: Input): Promise<CreatedFolder>;
+}
+/**
+ * Creates a folder.
+ *
+ * Additive and reversible, so it is not flagged destructive — but it still changes the project, so it
+ * is not read-only either and therefore needs the user to approve the exact arguments.
+ */
+declare class CreateFolderToolImpl implements AiSdkToolDefinition.Interface<Input> {
+    readonly name = "createFolder";
+    readonly title = "Create folder";
+    readonly description = "Creates a folder in the File Manager ('FmFile') or under a content model ('cms:<modelId>'). Call listFolders first to pick a parent, or omit parentId for the root. Requires user approval.";
+    readonly inputSchema: z.ZodObject<{
+        title: z.ZodString;
+        slug: z.ZodString;
+        type: z.ZodString;
+        parentId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly annotations: {
+        readOnlyHint: boolean;
+    };
+    readonly handler: typeof CreateFolderToolHandlerImpl & {
+        __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolHandler<any>>;
+    };
+}
+export declare const CreateFolderTool: typeof CreateFolderToolImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolDefinition<any>>;
+};
+export {};

package/features/ai/CreateFolderTool.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { CreateFolderUseCase } from "../folder/CreateFolder/index.js";
+const inputSchema = z.object({
+    title: z.string().describe("Human-readable folder name, e.g. 'Marketing'."),
+    slug: z.string().describe("URL-safe identifier, e.g. 'marketing'. Lowercase, hyphens instead of spaces."),
+    type: z.string().describe("Folder namespace: 'FmFile' for File Manager, or 'cms:<modelId>' for a content model's folders."),
+    parentId: z.string().optional().describe("Id of the parent folder. Omit to create at the root of that namespace.")
+});
+class CreateFolderToolHandlerImpl {
+    constructor(createFolder){
+        this.createFolder = createFolder;
+    }
+    async execute(input) {
+        const params = {
+            title: input.title,
+            slug: input.slug,
+            type: input.type,
+            parentId: null
+        };
+        if (input.parentId) params.parentId = input.parentId;
+        const result = await this.createFolder.execute(params);
+        if (result.isFail()) throw new Error(`Could not create the folder: ${result.error.message}`);
+        const folder = result.value;
+        return {
+            id: folder.id,
+            title: folder.title,
+            slug: folder.slug,
+            path: folder.path,
+            type: folder.type
+        };
+    }
+}
+const CreateFolderToolHandler = AiSdkToolHandler.createImplementation({
+    implementation: CreateFolderToolHandlerImpl,
+    dependencies: [
+        CreateFolderUseCase
+    ]
+});
+class CreateFolderToolImpl {
+    constructor(){
+        this.name = "createFolder";
+        this.title = "Create folder";
+        this.description = "Creates a folder in the File Manager ('FmFile') or under a content model ('cms:<modelId>'). Call listFolders first to pick a parent, or omit parentId for the root. Requires user approval.";
+        this.inputSchema = inputSchema;
+        this.annotations = {
+            readOnlyHint: false
+        };
+        this.handler = CreateFolderToolHandler;
+    }
+}
+const CreateFolderTool = AiSdkToolDefinition.createImplementation({
+    implementation: CreateFolderToolImpl,
+    dependencies: []
+});
+export { CreateFolderTool };
+
+//# sourceMappingURL=CreateFolderTool.js.map

package/features/ai/CreateFolderTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/CreateFolderTool.js","sources":["../../../src/features/ai/CreateFolderTool.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { AiSdkToolDefinition, AiSdkToolHandler } from \"@webiny/api-core/features/ai/index.js\";\nimport { CreateFolderUseCase } from \"~/features/folder/CreateFolder/index.js\";\n\nconst inputSchema = z.object({\n    title: z.string().describe(\"Human-readable folder name, e.g. 'Marketing'.\"),\n    slug: z\n        .string()\n        .describe(\"URL-safe identifier, e.g. 'marketing'. Lowercase, hyphens instead of spaces.\"),\n    type: z\n        .string()\n        .describe(\n            \"Folder namespace: 'FmFile' for File Manager, or 'cms:<modelId>' for a content model's folders.\"\n        ),\n    parentId: z\n        .string()\n        .optional()\n        .describe(\"Id of the parent folder. Omit to create at the root of that namespace.\")\n});\n\ntype Input = z.infer<typeof inputSchema>;\n\ninterface CreatedFolder {\n    id: string;\n    title: string;\n    slug: string;\n    path: string;\n    type: string;\n}\n\nclass CreateFolderToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {\n    constructor(private createFolder: CreateFolderUseCase.Interface) {}\n\n    async execute(input: Input): Promise<CreatedFolder> {\n        const params: {\n            title: string;\n            slug: string;\n            type: string;\n            parentId: string | null;\n        } = {\n            title: input.title,\n            slug: input.slug,\n            type: input.type,\n            parentId: null\n        };\n\n        if (input.parentId) {\n            params.parentId = input.parentId;\n        }\n\n        const result = await this.createFolder.execute(params);\n\n        if (result.isFail()) {\n            throw new Error(`Could not create the folder: ${result.error.message}`);\n        }\n\n        const folder = result.value;\n\n        return {\n            id: folder.id,\n            title: folder.title,\n            slug: folder.slug,\n            path: folder.path,\n            type: folder.type\n        };\n    }\n}\n\nconst CreateFolderToolHandler = AiSdkToolHandler.createImplementation({\n    implementation: CreateFolderToolHandlerImpl,\n    dependencies: [CreateFolderUseCase]\n});\n\n/**\n * Creates a folder.\n *\n * Additive and reversible, so it is not flagged destructive — but it still changes the project, so it\n * is not read-only either and therefore needs the user to approve the exact arguments.\n */\nclass CreateFolderToolImpl implements AiSdkToolDefinition.Interface<Input> {\n    readonly name = \"createFolder\";\n    readonly title = \"Create folder\";\n    readonly description =\n        \"Creates a folder in the File Manager ('FmFile') or under a content model ('cms:<modelId>'). Call listFolders first to pick a parent, or omit parentId for the root. Requires user approval.\";\n    readonly inputSchema = inputSchema;\n    readonly annotations = { readOnlyHint: false };\n    readonly handler = CreateFolderToolHandler;\n}\n\nexport const CreateFolderTool = AiSdkToolDefinition.createImplementation({\n    implementation: CreateFolderToolImpl,\n    dependencies: []\n});\n"],"names":["inputSchema","z","CreateFolderToolHandlerImpl","createFolder","input","params","result","Error","folder","CreateFolderToolHandler","AiSdkToolHandler","CreateFolderUseCase","CreateFolderToolImpl","CreateFolderTool","AiSdkToolDefinition"],"mappings":";;;AAIA,MAAMA,cAAcC,EAAE,MAAM,CAAC;IACzB,OAAOA,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,MAAMA,EAAAA,MACK,GACN,QAAQ,CAAC;IACd,MAAMA,EAAAA,MACK,GACN,QAAQ,CACL;IAER,UAAUA,EAAAA,MACC,GACN,QAAQ,GACR,QAAQ,CAAC;AAClB;AAYA,MAAMC;IACF,YAAoBC,YAA2C,CAAE;aAA7CA,YAAY,GAAZA;IAA8C;IAElE,MAAM,QAAQC,KAAY,EAA0B;QAChD,MAAMC,SAKF;YACA,OAAOD,MAAM,KAAK;YAClB,MAAMA,MAAM,IAAI;YAChB,MAAMA,MAAM,IAAI;YAChB,UAAU;QACd;QAEA,IAAIA,MAAM,QAAQ,EACdC,OAAO,QAAQ,GAAGD,MAAM,QAAQ;QAGpC,MAAME,SAAS,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAACD;QAE/C,IAAIC,OAAO,MAAM,IACb,MAAM,IAAIC,MAAM,CAAC,6BAA6B,EAAED,OAAO,KAAK,CAAC,OAAO,EAAE;QAG1E,MAAME,SAASF,OAAO,KAAK;QAE3B,OAAO;YACH,IAAIE,OAAO,EAAE;YACb,OAAOA,OAAO,KAAK;YACnB,MAAMA,OAAO,IAAI;YACjB,MAAMA,OAAO,IAAI;YACjB,MAAMA,OAAO,IAAI;QACrB;IACJ;AACJ;AAEA,MAAMC,0BAA0BC,iBAAiB,oBAAoB,CAAC;IAClE,gBAAgBR;IAChB,cAAc;QAACS;KAAoB;AACvC;AAQA,MAAMC;;aACO,IAAI,GAAG;aACP,KAAK,GAAG;aACR,WAAW,GAChB;aACK,WAAW,GAAGZ;aACd,WAAW,GAAG;YAAE,cAAc;QAAM;aACpC,OAAO,GAAGS;;AACvB;AAEO,MAAMI,mBAAmBC,oBAAoB,oBAAoB,CAAC;IACrE,gBAAgBF;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/CreateTeamTool.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { CreateTeam } from "@webiny/api-core/features/security/teams/CreateTeam/index.js";
+declare const inputSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    roles: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type Input = z.infer<typeof inputSchema>;
+interface CreatedTeam {
+    id: string;
+    name: string;
+    slug: string;
+    roles: string[];
+}
+declare class CreateTeamToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {
+    private createTeam;
+    constructor(createTeam: CreateTeam.Interface);
+    execute(input: Input): Promise<CreatedTeam>;
+}
+/**
+ * Creates a team.
+ *
+ * Not read-only, so it needs approval: a team is an access-control object, and the roles it carries
+ * decide what its members can do. The user should see which roles are being granted before it exists.
+ */
+declare class CreateTeamToolImpl implements AiSdkToolDefinition.Interface<Input> {
+    readonly name = "createTeam";
+    readonly title = "Create team";
+    readonly description = "Creates a team with a set of roles. Call listRoles first and pass what it returns; do not guess role identifiers. Requires user approval.";
+    readonly inputSchema: z.ZodObject<{
+        name: z.ZodString;
+        slug: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        roles: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    readonly annotations: {
+        readOnlyHint: boolean;
+    };
+    readonly handler: typeof CreateTeamToolHandlerImpl & {
+        __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolHandler<any>>;
+    };
+}
+export declare const CreateTeamTool: typeof CreateTeamToolImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolDefinition<any>>;
+};
+export {};

package/features/ai/CreateTeamTool.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { CreateTeam } from "@webiny/api-core/features/security/teams/CreateTeam/index.js";
+import { descriptionOnCreate } from "@webiny/api-core/features/security/shared/index.js";
+const inputSchema = z.object({
+    name: z.string().describe("Human-readable team name, e.g. 'Marketing'."),
+    slug: z.string().describe("URL-safe identifier, e.g. 'marketing'. Lowercase, hyphens instead of spaces."),
+    description: z.string().max(500).optional().describe("What the team is for. Shown in the admin UI. Omit it if the user did not say."),
+    roles: z.array(z.string()).describe("Roles from listRoles. Prefer the `id`; a `slug` is accepted and resolved for you. Resolve them with listRoles first, since an unknown value is rejected rather than stored.")
+});
+class CreateTeamToolHandlerImpl {
+    constructor(createTeam){
+        this.createTeam = createTeam;
+    }
+    async execute(input) {
+        const result = await this.createTeam.execute({
+            name: input.name,
+            slug: input.slug,
+            description: descriptionOnCreate(input.description),
+            roles: input.roles
+        });
+        if (result.isFail()) throw new Error(`Could not create the team: ${result.error.message}`);
+        const team = result.value;
+        return {
+            id: team.id,
+            name: team.name,
+            slug: team.slug,
+            roles: team.roles
+        };
+    }
+}
+const CreateTeamToolHandler = AiSdkToolHandler.createImplementation({
+    implementation: CreateTeamToolHandlerImpl,
+    dependencies: [
+        CreateTeam
+    ]
+});
+class CreateTeamToolImpl {
+    constructor(){
+        this.name = "createTeam";
+        this.title = "Create team";
+        this.description = "Creates a team with a set of roles. Call listRoles first and pass what it returns; do not guess role identifiers. Requires user approval.";
+        this.inputSchema = inputSchema;
+        this.annotations = {
+            readOnlyHint: false
+        };
+        this.handler = CreateTeamToolHandler;
+    }
+}
+const CreateTeamTool = AiSdkToolDefinition.createImplementation({
+    implementation: CreateTeamToolImpl,
+    dependencies: []
+});
+export { CreateTeamTool };
+
+//# sourceMappingURL=CreateTeamTool.js.map

package/features/ai/CreateTeamTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/CreateTeamTool.js","sources":["../../../src/features/ai/CreateTeamTool.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { AiSdkToolDefinition, AiSdkToolHandler } from \"@webiny/api-core/features/ai/index.js\";\nimport { CreateTeam } from \"@webiny/api-core/features/security/teams/CreateTeam/index.js\";\nimport { descriptionOnCreate } from \"@webiny/api-core/features/security/shared/index.js\";\n\nconst inputSchema = z.object({\n    name: z.string().describe(\"Human-readable team name, e.g. 'Marketing'.\"),\n    slug: z\n        .string()\n        .describe(\"URL-safe identifier, e.g. 'marketing'. Lowercase, hyphens instead of spaces.\"),\n    /*\n     * Optional and capped, mirroring the use case's own schema. Requiring it made the model invent a\n     * description for every team; `CreateTeam` treats an absent one as empty via `descriptionOnCreate`.\n     */\n    description: z\n        .string()\n        .max(500)\n        .optional()\n        .describe(\"What the team is for. Shown in the admin UI. Omit it if the user did not say.\"),\n    roles: z\n        .array(z.string())\n        .describe(\n            \"Roles from listRoles. Prefer the `id`; a `slug` is accepted and resolved for you. Resolve them with listRoles first, since an unknown value is rejected rather than stored.\"\n        )\n});\n\ntype Input = z.infer<typeof inputSchema>;\n\ninterface CreatedTeam {\n    id: string;\n    name: string;\n    slug: string;\n    roles: string[];\n}\n\nclass CreateTeamToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {\n    constructor(private createTeam: CreateTeam.Interface) {}\n\n    async execute(input: Input): Promise<CreatedTeam> {\n        /*\n         * Roles go through untouched. `CreateTeam` accepts a role id or a slug and resolves either to\n         * the id a team stores, so the tool has nothing to add: doing it here too would read the roles\n         * a second time and leave two copies of the same rule to keep in step.\n         */\n        const result = await this.createTeam.execute({\n            name: input.name,\n            slug: input.slug,\n            // An omitted description becomes \"\", the same mapping the use case applies to its own input.\n            description: descriptionOnCreate(input.description),\n            roles: input.roles\n        });\n\n        if (result.isFail()) {\n            throw new Error(`Could not create the team: ${result.error.message}`);\n        }\n\n        const team = result.value;\n\n        return {\n            id: team.id,\n            name: team.name,\n            slug: team.slug,\n            // From the created team, so the caller sees the resolved ids that were actually stored.\n            roles: team.roles\n        };\n    }\n}\n\nconst CreateTeamToolHandler = AiSdkToolHandler.createImplementation({\n    implementation: CreateTeamToolHandlerImpl,\n    dependencies: [CreateTeam]\n});\n\n/**\n * Creates a team.\n *\n * Not read-only, so it needs approval: a team is an access-control object, and the roles it carries\n * decide what its members can do. The user should see which roles are being granted before it exists.\n */\nclass CreateTeamToolImpl implements AiSdkToolDefinition.Interface<Input> {\n    readonly name = \"createTeam\";\n    readonly title = \"Create team\";\n    readonly description =\n        \"Creates a team with a set of roles. Call listRoles first and pass what it returns; do not guess role identifiers. Requires user approval.\";\n    readonly inputSchema = inputSchema;\n    readonly annotations = { readOnlyHint: false };\n    readonly handler = CreateTeamToolHandler;\n}\n\nexport const CreateTeamTool = AiSdkToolDefinition.createImplementation({\n    implementation: CreateTeamToolImpl,\n    dependencies: []\n});\n"],"names":["inputSchema","z","CreateTeamToolHandlerImpl","createTeam","input","result","descriptionOnCreate","Error","team","CreateTeamToolHandler","AiSdkToolHandler","CreateTeam","CreateTeamToolImpl","CreateTeamTool","AiSdkToolDefinition"],"mappings":";;;;AAKA,MAAMA,cAAcC,EAAE,MAAM,CAAC;IACzB,MAAMA,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,MAAMA,EAAAA,MACK,GACN,QAAQ,CAAC;IAKd,aAAaA,EAAAA,MACF,GACN,GAAG,CAAC,KACJ,QAAQ,GACR,QAAQ,CAAC;IACd,OAAOA,EAAAA,KACG,CAACA,EAAE,MAAM,IACd,QAAQ,CACL;AAEZ;AAWA,MAAMC;IACF,YAAoBC,UAAgC,CAAE;aAAlCA,UAAU,GAAVA;IAAmC;IAEvD,MAAM,QAAQC,KAAY,EAAwB;QAM9C,MAAMC,SAAS,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YACzC,MAAMD,MAAM,IAAI;YAChB,MAAMA,MAAM,IAAI;YAEhB,aAAaE,oBAAoBF,MAAM,WAAW;YAClD,OAAOA,MAAM,KAAK;QACtB;QAEA,IAAIC,OAAO,MAAM,IACb,MAAM,IAAIE,MAAM,CAAC,2BAA2B,EAAEF,OAAO,KAAK,CAAC,OAAO,EAAE;QAGxE,MAAMG,OAAOH,OAAO,KAAK;QAEzB,OAAO;YACH,IAAIG,KAAK,EAAE;YACX,MAAMA,KAAK,IAAI;YACf,MAAMA,KAAK,IAAI;YAEf,OAAOA,KAAK,KAAK;QACrB;IACJ;AACJ;AAEA,MAAMC,wBAAwBC,iBAAiB,oBAAoB,CAAC;IAChE,gBAAgBR;IAChB,cAAc;QAACS;KAAW;AAC9B;AAQA,MAAMC;;aACO,IAAI,GAAG;aACP,KAAK,GAAG;aACR,WAAW,GAChB;aACK,WAAW,GAAGZ;aACd,WAAW,GAAG;YAAE,cAAc;QAAM;aACpC,OAAO,GAAGS;;AACvB;AAEO,MAAMI,iBAAiBC,oBAAoB,oBAAoB,CAAC;IACnE,gBAAgBF;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/DeleteFolderTool.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { GetFolderUseCase } from "../../features/folder/GetFolder/index.js";
+import { DeleteFolderUseCase } from "../../features/folder/DeleteFolder/index.js";
+declare const inputSchema: z.ZodObject<{
+    folderId: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
+type Input = z.infer<typeof inputSchema>;
+interface DeletedFolder {
+    id: string;
+    title: string;
+    path: string;
+    type: string;
+}
+declare class DeleteFolderToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {
+    private getFolder;
+    private deleteFolder;
+    constructor(getFolder: GetFolderUseCase.Interface, deleteFolder: DeleteFolderUseCase.Interface);
+    execute(input: Input): Promise<DeletedFolder>;
+}
+/**
+ * Deletes one folder.
+ *
+ * Destructive, so the approval says it cannot be undone. Only an empty folder can go: the folder
+ * feature refuses to delete one that still holds subfolders or content, and that error reaches the
+ * model as-is.
+ */
+declare class DeleteFolderToolImpl implements AiSdkToolDefinition.Interface<Input> {
+    readonly name = "deleteFolder";
+    readonly title = "Delete folder";
+    readonly description = "Deletes one empty folder. Folders that still contain subfolders or content are refused. Call listFolders first for the id and exact title. Requires user approval.";
+    readonly inputSchema: z.ZodObject<{
+        folderId: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>;
+    readonly annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+    };
+    readonly handler: typeof DeleteFolderToolHandlerImpl & {
+        __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolHandler<any>>;
+    };
+}
+export declare const DeleteFolderTool: typeof DeleteFolderToolImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolDefinition<any>>;
+};
+export {};

package/features/ai/DeleteFolderTool.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { GetFolderUseCase } from "../folder/GetFolder/index.js";
+import { DeleteFolderUseCase } from "../folder/DeleteFolder/index.js";
+const inputSchema = z.object({
+    folderId: z.string().describe("Folder id as returned by listFolders."),
+    title: z.string().describe("The folder's current title, exactly as listFolders returned it. The delete is refused if it does not match.")
+});
+class DeleteFolderToolHandlerImpl {
+    constructor(getFolder, deleteFolder){
+        this.getFolder = getFolder;
+        this.deleteFolder = deleteFolder;
+    }
+    async execute(input) {
+        const found = await this.getFolder.execute(input.folderId);
+        if (found.isFail()) throw new Error(`Folder "${input.folderId}" not found: ${found.error.message}. Call listFolders for valid ids.`);
+        const folder = found.value;
+        if (folder.title !== input.title) throw new Error(`Folder "${input.folderId}" is titled "${folder.title}", not "${input.title}", so nothing was deleted. Check the folder with listFolders.`);
+        const result = await this.deleteFolder.execute(folder.id);
+        if (result.isFail()) throw new Error(`Could not delete the folder: ${result.error.message}`);
+        return {
+            id: folder.id,
+            title: folder.title,
+            path: folder.path,
+            type: folder.type
+        };
+    }
+}
+const DeleteFolderToolHandler = AiSdkToolHandler.createImplementation({
+    implementation: DeleteFolderToolHandlerImpl,
+    dependencies: [
+        GetFolderUseCase,
+        DeleteFolderUseCase
+    ]
+});
+class DeleteFolderToolImpl {
+    constructor(){
+        this.name = "deleteFolder";
+        this.title = "Delete folder";
+        this.description = "Deletes one empty folder. Folders that still contain subfolders or content are refused. Call listFolders first for the id and exact title. Requires user approval.";
+        this.inputSchema = inputSchema;
+        this.annotations = {
+            readOnlyHint: false,
+            destructiveHint: true
+        };
+        this.handler = DeleteFolderToolHandler;
+    }
+}
+const DeleteFolderTool = AiSdkToolDefinition.createImplementation({
+    implementation: DeleteFolderToolImpl,
+    dependencies: []
+});
+export { DeleteFolderTool };
+
+//# sourceMappingURL=DeleteFolderTool.js.map

package/features/ai/DeleteFolderTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/DeleteFolderTool.js","sources":["../../../src/features/ai/DeleteFolderTool.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { AiSdkToolDefinition, AiSdkToolHandler } from \"@webiny/api-core/features/ai/index.js\";\nimport { GetFolderUseCase } from \"~/features/folder/GetFolder/index.js\";\nimport { DeleteFolderUseCase } from \"~/features/folder/DeleteFolder/index.js\";\n\nconst inputSchema = z.object({\n    folderId: z.string().describe(\"Folder id as returned by listFolders.\"),\n    title: z\n        .string()\n        .describe(\n            \"The folder's current title, exactly as listFolders returned it. The delete is refused if it does not match.\"\n        )\n});\n\ntype Input = z.infer<typeof inputSchema>;\n\ninterface DeletedFolder {\n    id: string;\n    title: string;\n    path: string;\n    type: string;\n}\n\n/*\n * The title is part of the input so the approval shows the user which folder goes, rather than only\n * an id. The model supplies it, so it is checked against the stored folder before anything is\n * deleted: what the user approved by name has to be the folder that is removed.\n */\nclass DeleteFolderToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {\n    constructor(\n        private getFolder: GetFolderUseCase.Interface,\n        private deleteFolder: DeleteFolderUseCase.Interface\n    ) {}\n\n    async execute(input: Input): Promise<DeletedFolder> {\n        const found = await this.getFolder.execute(input.folderId);\n\n        if (found.isFail()) {\n            throw new Error(\n                `Folder \"${input.folderId}\" not found: ${found.error.message}. Call listFolders for valid ids.`\n            );\n        }\n\n        const folder = found.value;\n\n        if (folder.title !== input.title) {\n            throw new Error(\n                `Folder \"${input.folderId}\" is titled \"${folder.title}\", not \"${input.title}\", so nothing was deleted. Check the folder with listFolders.`\n            );\n        }\n\n        const result = await this.deleteFolder.execute(folder.id);\n\n        if (result.isFail()) {\n            throw new Error(`Could not delete the folder: ${result.error.message}`);\n        }\n\n        return { id: folder.id, title: folder.title, path: folder.path, type: folder.type };\n    }\n}\n\nconst DeleteFolderToolHandler = AiSdkToolHandler.createImplementation({\n    implementation: DeleteFolderToolHandlerImpl,\n    dependencies: [GetFolderUseCase, DeleteFolderUseCase]\n});\n\n/**\n * Deletes one folder.\n *\n * Destructive, so the approval says it cannot be undone. Only an empty folder can go: the folder\n * feature refuses to delete one that still holds subfolders or content, and that error reaches the\n * model as-is.\n */\nclass DeleteFolderToolImpl implements AiSdkToolDefinition.Interface<Input> {\n    readonly name = \"deleteFolder\";\n    readonly title = \"Delete folder\";\n    readonly description =\n        \"Deletes one empty folder. Folders that still contain subfolders or content are refused. Call listFolders first for the id and exact title. Requires user approval.\";\n    readonly inputSchema = inputSchema;\n    readonly annotations = { readOnlyHint: false, destructiveHint: true };\n    readonly handler = DeleteFolderToolHandler;\n}\n\nexport const DeleteFolderTool = AiSdkToolDefinition.createImplementation({\n    implementation: DeleteFolderToolImpl,\n    dependencies: []\n});\n"],"names":["inputSchema","z","DeleteFolderToolHandlerImpl","getFolder","deleteFolder","input","found","Error","folder","result","DeleteFolderToolHandler","AiSdkToolHandler","GetFolderUseCase","DeleteFolderUseCase","DeleteFolderToolImpl","DeleteFolderTool","AiSdkToolDefinition"],"mappings":";;;;AAKA,MAAMA,cAAcC,EAAE,MAAM,CAAC;IACzB,UAAUA,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,OAAOA,EAAAA,MACI,GACN,QAAQ,CACL;AAEZ;AAgBA,MAAMC;IACF,YACYC,SAAqC,EACrCC,YAA2C,CACrD;aAFUD,SAAS,GAATA;aACAC,YAAY,GAAZA;IACT;IAEH,MAAM,QAAQC,KAAY,EAA0B;QAChD,MAAMC,QAAQ,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAACD,MAAM,QAAQ;QAEzD,IAAIC,MAAM,MAAM,IACZ,MAAM,IAAIC,MACN,CAAC,QAAQ,EAAEF,MAAM,QAAQ,CAAC,aAAa,EAAEC,MAAM,KAAK,CAAC,OAAO,CAAC,iCAAiC,CAAC;QAIvG,MAAME,SAASF,MAAM,KAAK;QAE1B,IAAIE,OAAO,KAAK,KAAKH,MAAM,KAAK,EAC5B,MAAM,IAAIE,MACN,CAAC,QAAQ,EAAEF,MAAM,QAAQ,CAAC,aAAa,EAAEG,OAAO,KAAK,CAAC,QAAQ,EAAEH,MAAM,KAAK,CAAC,6DAA6D,CAAC;QAIlJ,MAAMI,SAAS,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAACD,OAAO,EAAE;QAExD,IAAIC,OAAO,MAAM,IACb,MAAM,IAAIF,MAAM,CAAC,6BAA6B,EAAEE,OAAO,KAAK,CAAC,OAAO,EAAE;QAG1E,OAAO;YAAE,IAAID,OAAO,EAAE;YAAE,OAAOA,OAAO,KAAK;YAAE,MAAMA,OAAO,IAAI;YAAE,MAAMA,OAAO,IAAI;QAAC;IACtF;AACJ;AAEA,MAAME,0BAA0BC,iBAAiB,oBAAoB,CAAC;IAClE,gBAAgBT;IAChB,cAAc;QAACU;QAAkBC;KAAoB;AACzD;AASA,MAAMC;;aACO,IAAI,GAAG;aACP,KAAK,GAAG;aACR,WAAW,GAChB;aACK,WAAW,GAAGd;aACd,WAAW,GAAG;YAAE,cAAc;YAAO,iBAAiB;QAAK;aAC3D,OAAO,GAAGU;;AACvB;AAEO,MAAMK,mBAAmBC,oBAAoB,oBAAoB,CAAC;IACrE,gBAAgBF;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/GrantFolderAccessTool.d.ts

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { ListTeamsUseCase } from "@webiny/api-core/features/security/teams/ListTeams/index.js";
+import { GetFolderUseCase } from "../../features/folder/GetFolder/index.js";
+import { UpdateFolderUseCase } from "../../features/folder/UpdateFolder/index.js";
+declare const inputSchema: z.ZodObject<{
+    folderId: z.ZodString;
+    target: z.ZodString;
+    level: z.ZodEnum<{
+        editor: "editor";
+        "no-access": "no-access";
+        owner: "owner";
+        public: "public";
+        viewer: "viewer";
+    }>;
+}, z.core.$strip>;
+type Input = z.infer<typeof inputSchema>;
+interface GrantResult {
+    folderId: string;
+    title: string;
+    path: string;
+    /**
+     * Every direct rule on the folder afterwards.
+     *
+     * This is the set the update was asked to store, not an independent read of it:
+     * `UpdateFolderWithFolderLevelPermissions` returns the permissions it derived from the input
+     * rather than the ones the repository wrote. Treating it as a verification would let the tool
+     * confirm its own request back to itself.
+     */
+    permissions: {
+        target: string;
+        level: string;
+    }[];
+    /** True when the target already had a direct rule and its level was changed. */
+    replacedExistingLevel?: string;
+}
+declare class GrantFolderAccessToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {
+    private getFolder;
+    private updateFolder;
+    private listTeams;
+    constructor(getFolder: GetFolderUseCase.Interface, updateFolder: UpdateFolderUseCase.Interface, listTeams: ListTeamsUseCase.Interface);
+    execute(input: Input): Promise<GrantResult>;
+}
+/**
+ * Grants one target access to one folder, leaving every other rule alone.
+ *
+ * Additive by design. The earlier tool took the complete permission set and replaced it, which meant
+ * approving a change showed what would be SET and said nothing about what would be removed — a rule
+ * the model omitted disappeared silently. One target per call keeps the approval honest: what the user
+ * sees in the plan is the whole change.
+ */
+declare class GrantFolderAccessToolImpl implements AiSdkToolDefinition.Interface<Input> {
+    readonly name = "grantFolderAccess";
+    readonly title = "Grant folder access";
+    readonly description = "Grants one team or user a level of access on one folder, leaving all other permissions untouched. Use listFolders for the folder id and listTeams for a team slug. Requires user approval.";
+    readonly inputSchema: z.ZodObject<{
+        folderId: z.ZodString;
+        target: z.ZodString;
+        level: z.ZodEnum<{
+            editor: "editor";
+            "no-access": "no-access";
+            owner: "owner";
+            public: "public";
+            viewer: "viewer";
+        }>;
+    }, z.core.$strip>;
+    readonly annotations: {
+        readOnlyHint: boolean;
+    };
+    readonly handler: typeof GrantFolderAccessToolHandlerImpl & {
+        __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions.js").IAiSdkToolHandler<any>>;
+    };
+}
+export declare const GrantFolderAccessTool: typeof GrantFolderAccessToolImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions.js").IAiSdkToolDefinition<any>>;
+};
+export {};

package/features/ai/GrantFolderAccessTool.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { ListTeamsUseCase } from "@webiny/api-core/features/security/teams/ListTeams/index.js";
+import { GetFolderUseCase } from "../folder/GetFolder/index.js";
+import { UpdateFolderUseCase } from "../folder/UpdateFolder/index.js";
+import { loadFolderPermissions } from "./loadFolderPermissions.js";
+import { assertTargetIsUsable } from "./assertTargetIsUsable.js";
+const ACCESS_LEVELS = [
+    "owner",
+    "editor",
+    "viewer",
+    "public",
+    "no-access"
+];
+const inputSchema = z.object({
+    folderId: z.string().describe("Folder id as returned by listFolders."),
+    target: z.string().describe("Who to grant access to. A team is 'team:<slug>' — the SLUG, not the id. A user is 'admin:<userId>'. Resolve with listTeams first."),
+    level: z["enum"](ACCESS_LEVELS).describe("owner = full control including permissions; editor = change content; viewer = read only; no-access = explicitly denied.")
+});
+class GrantFolderAccessToolHandlerImpl {
+    constructor(getFolder, updateFolder, listTeams){
+        this.getFolder = getFolder;
+        this.updateFolder = updateFolder;
+        this.listTeams = listTeams;
+    }
+    async execute(input) {
+        const loaded = await loadFolderPermissions(this.getFolder, input.folderId);
+        await assertTargetIsUsable(this.listTeams, input.target, loaded.inheritedTargets);
+        const existing = loaded.direct.find((permission)=>String(permission.target) === input.target);
+        const permissions = loaded.direct.filter((permission)=>String(permission.target) !== input.target).concat([
+            {
+                target: input.target,
+                level: input.level
+            }
+        ]);
+        const result = await this.updateFolder.execute(input.folderId, {
+            permissions
+        });
+        if (result.isFail()) throw new Error(`Could not grant access: ${result.error.message}`);
+        const folder = result.value;
+        const granted = {
+            folderId: folder.id,
+            title: folder.title,
+            path: folder.path,
+            permissions: (folder.permissions ?? []).filter((permission)=>!permission.inheritedFrom).map((permission)=>({
+                    target: String(permission.target),
+                    level: permission.level
+                }))
+        };
+        if (existing) granted.replacedExistingLevel = existing.level;
+        return granted;
+    }
+}
+const GrantFolderAccessToolHandler = AiSdkToolHandler.createImplementation({
+    implementation: GrantFolderAccessToolHandlerImpl,
+    dependencies: [
+        GetFolderUseCase,
+        UpdateFolderUseCase,
+        ListTeamsUseCase
+    ]
+});
+class GrantFolderAccessToolImpl {
+    constructor(){
+        this.name = "grantFolderAccess";
+        this.title = "Grant folder access";
+        this.description = "Grants one team or user a level of access on one folder, leaving all other permissions untouched. Use listFolders for the folder id and listTeams for a team slug. Requires user approval.";
+        this.inputSchema = inputSchema;
+        this.annotations = {
+            readOnlyHint: false
+        };
+        this.handler = GrantFolderAccessToolHandler;
+    }
+}
+const GrantFolderAccessTool = AiSdkToolDefinition.createImplementation({
+    implementation: GrantFolderAccessToolImpl,
+    dependencies: []
+});
+export { GrantFolderAccessTool };
+
+//# sourceMappingURL=GrantFolderAccessTool.js.map

package/features/ai/GrantFolderAccessTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/GrantFolderAccessTool.js","sources":["../../../src/features/ai/GrantFolderAccessTool.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { AiSdkToolDefinition, AiSdkToolHandler } from \"@webiny/api-core/features/ai/index.js\";\nimport { ListTeamsUseCase } from \"@webiny/api-core/features/security/teams/ListTeams/index.js\";\nimport { GetFolderUseCase } from \"~/features/folder/GetFolder/index.js\";\nimport { UpdateFolderUseCase } from \"~/features/folder/UpdateFolder/index.js\";\nimport type { FolderPermission } from \"~/types.js\";\nimport { loadFolderPermissions } from \"./loadFolderPermissions.js\";\nimport { assertTargetIsUsable } from \"./assertTargetIsUsable.js\";\n\nconst ACCESS_LEVELS = [\"owner\", \"editor\", \"viewer\", \"public\", \"no-access\"] as const;\n\nconst inputSchema = z.object({\n    folderId: z.string().describe(\"Folder id as returned by listFolders.\"),\n    target: z\n        .string()\n        .describe(\n            \"Who to grant access to. A team is 'team:<slug>' — the SLUG, not the id. A user is 'admin:<userId>'. Resolve with listTeams first.\"\n        ),\n    level: z\n        .enum(ACCESS_LEVELS)\n        .describe(\n            \"owner = full control including permissions; editor = change content; viewer = read only; no-access = explicitly denied.\"\n        )\n});\n\ntype Input = z.infer<typeof inputSchema>;\n\ninterface GrantResult {\n    folderId: string;\n    title: string;\n    path: string;\n    /**\n     * Every direct rule on the folder afterwards.\n     *\n     * This is the set the update was asked to store, not an independent read of it:\n     * `UpdateFolderWithFolderLevelPermissions` returns the permissions it derived from the input\n     * rather than the ones the repository wrote. Treating it as a verification would let the tool\n     * confirm its own request back to itself.\n     */\n    permissions: { target: string; level: string }[];\n    /** True when the target already had a direct rule and its level was changed. */\n    replacedExistingLevel?: string;\n}\n\nclass GrantFolderAccessToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {\n    constructor(\n        private getFolder: GetFolderUseCase.Interface,\n        private updateFolder: UpdateFolderUseCase.Interface,\n        private listTeams: ListTeamsUseCase.Interface\n    ) {}\n\n    async execute(input: Input): Promise<GrantResult> {\n        const loaded = await loadFolderPermissions(this.getFolder, input.folderId);\n\n        await assertTargetIsUsable(this.listTeams, input.target, loaded.inheritedTargets);\n\n        const existing = loaded.direct.find(\n            permission => String(permission.target) === input.target\n        );\n\n        const permissions: FolderPermission[] = loaded.direct\n            .filter(permission => String(permission.target) !== input.target)\n            .concat([{ target: input.target, level: input.level } as FolderPermission]);\n\n        const result = await this.updateFolder.execute(input.folderId, { permissions });\n\n        if (result.isFail()) {\n            throw new Error(`Could not grant access: ${result.error.message}`);\n        }\n\n        const folder = result.value;\n\n        const granted: GrantResult = {\n            folderId: folder.id,\n            title: folder.title,\n            path: folder.path,\n            permissions: (folder.permissions ?? [])\n                .filter(permission => !permission.inheritedFrom)\n                .map(permission => ({ target: String(permission.target), level: permission.level }))\n        };\n\n        if (existing) {\n            granted.replacedExistingLevel = existing.level;\n        }\n\n        return granted;\n    }\n}\n\nconst GrantFolderAccessToolHandler = AiSdkToolHandler.createImplementation({\n    implementation: GrantFolderAccessToolHandlerImpl,\n    dependencies: [GetFolderUseCase, UpdateFolderUseCase, ListTeamsUseCase]\n});\n\n/**\n * Grants one target access to one folder, leaving every other rule alone.\n *\n * Additive by design. The earlier tool took the complete permission set and replaced it, which meant\n * approving a change showed what would be SET and said nothing about what would be removed — a rule\n * the model omitted disappeared silently. One target per call keeps the approval honest: what the user\n * sees in the plan is the whole change.\n */\nclass GrantFolderAccessToolImpl implements AiSdkToolDefinition.Interface<Input> {\n    readonly name = \"grantFolderAccess\";\n    readonly title = \"Grant folder access\";\n    readonly description =\n        \"Grants one team or user a level of access on one folder, leaving all other permissions untouched. Use listFolders for the folder id and listTeams for a team slug. Requires user approval.\";\n    readonly inputSchema = inputSchema;\n    readonly annotations = { readOnlyHint: false };\n    readonly handler = GrantFolderAccessToolHandler;\n}\n\nexport const GrantFolderAccessTool = AiSdkToolDefinition.createImplementation({\n    implementation: GrantFolderAccessToolImpl,\n    dependencies: []\n});\n"],"names":["ACCESS_LEVELS","inputSchema","z","GrantFolderAccessToolHandlerImpl","getFolder","updateFolder","listTeams","input","loaded","loadFolderPermissions","assertTargetIsUsable","existing","permission","String","permissions","result","Error","folder","granted","GrantFolderAccessToolHandler","AiSdkToolHandler","GetFolderUseCase","UpdateFolderUseCase","ListTeamsUseCase","GrantFolderAccessToolImpl","GrantFolderAccessTool","AiSdkToolDefinition"],"mappings":";;;;;;;AASA,MAAMA,gBAAgB;IAAC;IAAS;IAAU;IAAU;IAAU;CAAY;AAE1E,MAAMC,cAAcC,EAAE,MAAM,CAAC;IACzB,UAAUA,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,QAAQA,EAAAA,MACG,GACN,QAAQ,CACL;IAER,OAAOA,CAAC,CAADA,OACE,CAACF,eACL,QAAQ,CACL;AAEZ;AAqBA,MAAMG;IACF,YACYC,SAAqC,EACrCC,YAA2C,EAC3CC,SAAqC,CAC/C;aAHUF,SAAS,GAATA;aACAC,YAAY,GAAZA;aACAC,SAAS,GAATA;IACT;IAEH,MAAM,QAAQC,KAAY,EAAwB;QAC9C,MAAMC,SAAS,MAAMC,sBAAsB,IAAI,CAAC,SAAS,EAAEF,MAAM,QAAQ;QAEzE,MAAMG,qBAAqB,IAAI,CAAC,SAAS,EAAEH,MAAM,MAAM,EAAEC,OAAO,gBAAgB;QAEhF,MAAMG,WAAWH,OAAO,MAAM,CAAC,IAAI,CAC/BI,CAAAA,aAAcC,OAAOD,WAAW,MAAM,MAAML,MAAM,MAAM;QAG5D,MAAMO,cAAkCN,OAAO,MAAM,CAChD,MAAM,CAACI,CAAAA,aAAcC,OAAOD,WAAW,MAAM,MAAML,MAAM,MAAM,EAC/D,MAAM,CAAC;YAAC;gBAAE,QAAQA,MAAM,MAAM;gBAAE,OAAOA,MAAM,KAAK;YAAC;SAAsB;QAE9E,MAAMQ,SAAS,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAACR,MAAM,QAAQ,EAAE;YAAEO;QAAY;QAE7E,IAAIC,OAAO,MAAM,IACb,MAAM,IAAIC,MAAM,CAAC,wBAAwB,EAAED,OAAO,KAAK,CAAC,OAAO,EAAE;QAGrE,MAAME,SAASF,OAAO,KAAK;QAE3B,MAAMG,UAAuB;YACzB,UAAUD,OAAO,EAAE;YACnB,OAAOA,OAAO,KAAK;YACnB,MAAMA,OAAO,IAAI;YACjB,aAAcA,AAAAA,CAAAA,OAAO,WAAW,IAAI,EAAC,EAChC,MAAM,CAACL,CAAAA,aAAc,CAACA,WAAW,aAAa,EAC9C,GAAG,CAACA,CAAAA,aAAe;oBAAE,QAAQC,OAAOD,WAAW,MAAM;oBAAG,OAAOA,WAAW,KAAK;gBAAC;QACzF;QAEA,IAAID,UACAO,QAAQ,qBAAqB,GAAGP,SAAS,KAAK;QAGlD,OAAOO;IACX;AACJ;AAEA,MAAMC,+BAA+BC,iBAAiB,oBAAoB,CAAC;IACvE,gBAAgBjB;IAChB,cAAc;QAACkB;QAAkBC;QAAqBC;KAAiB;AAC3E;AAUA,MAAMC;;aACO,IAAI,GAAG;aACP,KAAK,GAAG;aACR,WAAW,GAChB;aACK,WAAW,GAAGvB;aACd,WAAW,GAAG;YAAE,cAAc;QAAM;aACpC,OAAO,GAAGkB;;AACvB;AAEO,MAAMM,wBAAwBC,oBAAoB,oBAAoB,CAAC;IAC1E,gBAAgBF;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/ListFoldersTool.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { ListFoldersUseCase } from "../../features/folder/ListFolders/index.js";
+declare const inputSchema: z.ZodObject<{
+    type: z.ZodString;
+}, z.core.$strip>;
+type Input = z.infer<typeof inputSchema>;
+interface FolderSummary {
+    id: string;
+    title: string;
+    slug: string;
+    path: string;
+    parentId?: string | null;
+    permissions: {
+        target: string;
+        level: string;
+        inherited: boolean;
+    }[];
+}
+declare class ListFoldersToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {
+    private listFolders;
+    constructor(listFolders: ListFoldersUseCase.Interface);
+    execute(input: Input): Promise<FolderSummary[]>;
+}
+/**
+ * Lists folders with their current access rules, so a permission change is proposed against a real
+ * folder id and the user can see what the access already is before approving a change to it.
+ */
+declare class ListFoldersToolImpl implements AiSdkToolDefinition.Interface<Input> {
+    readonly name = "listFolders";
+    readonly title = "List folders";
+    readonly description = "Lists folders of a given type with their ids, paths and current access permissions. Call this before changing folder permissions so the change targets a real folder.";
+    readonly inputSchema: z.ZodObject<{
+        type: z.ZodString;
+    }, z.core.$strip>;
+    readonly annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+    };
+    readonly handler: typeof ListFoldersToolHandlerImpl & {
+        __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolHandler<any>>;
+    };
+}
+export declare const ListFoldersTool: typeof ListFoldersToolImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-core/features/ai/abstractions").IAiSdkToolDefinition<any>>;
+};
+export {};

package/features/ai/ListFoldersTool.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { AiSdkToolDefinition, AiSdkToolHandler } from "@webiny/api-core/features/ai/index.js";
+import { ListFoldersUseCase } from "../folder/ListFolders/index.js";
+const inputSchema = z.object({
+    type: z.string().describe("Folder namespace, e.g. 'FmFile' for the file manager or 'cms:<modelId>' for a content model's folders.")
+});
+class ListFoldersToolHandlerImpl {
+    constructor(listFolders){
+        this.listFolders = listFolders;
+    }
+    async execute(input) {
+        const result = await this.listFolders.execute({
+            where: {
+                type: input.type
+            }
+        });
+        if (result.isFail()) throw new Error(`Could not list folders: ${result.error.message}`);
+        return result.value.folders.map((folder)=>({
+                id: folder.id,
+                title: folder.title,
+                slug: folder.slug,
+                path: folder.path,
+                parentId: folder.parentId,
+                permissions: (folder.permissions ?? []).map((permission)=>({
+                        target: permission.target,
+                        level: permission.level,
+                        inherited: Boolean(permission.inheritedFrom)
+                    }))
+            }));
+    }
+}
+const ListFoldersToolHandler = AiSdkToolHandler.createImplementation({
+    implementation: ListFoldersToolHandlerImpl,
+    dependencies: [
+        ListFoldersUseCase
+    ]
+});
+class ListFoldersToolImpl {
+    constructor(){
+        this.name = "listFolders";
+        this.title = "List folders";
+        this.description = "Lists folders of a given type with their ids, paths and current access permissions. Call this before changing folder permissions so the change targets a real folder.";
+        this.inputSchema = inputSchema;
+        this.annotations = {
+            readOnlyHint: true,
+            idempotentHint: true
+        };
+        this.handler = ListFoldersToolHandler;
+    }
+}
+const ListFoldersTool = AiSdkToolDefinition.createImplementation({
+    implementation: ListFoldersToolImpl,
+    dependencies: []
+});
+export { ListFoldersTool };
+
+//# sourceMappingURL=ListFoldersTool.js.map

package/features/ai/ListFoldersTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/ListFoldersTool.js","sources":["../../../src/features/ai/ListFoldersTool.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { AiSdkToolDefinition, AiSdkToolHandler } from \"@webiny/api-core/features/ai/index.js\";\nimport { ListFoldersUseCase } from \"~/features/folder/ListFolders/index.js\";\n\nconst inputSchema = z.object({\n    type: z\n        .string()\n        .describe(\n            \"Folder namespace, e.g. 'FmFile' for the file manager or 'cms:<modelId>' for a content model's folders.\"\n        )\n});\n\ntype Input = z.infer<typeof inputSchema>;\n\ninterface FolderSummary {\n    id: string;\n    title: string;\n    slug: string;\n    path: string;\n    parentId?: string | null;\n    permissions: { target: string; level: string; inherited: boolean }[];\n}\n\nclass ListFoldersToolHandlerImpl implements AiSdkToolHandler.Interface<Input> {\n    constructor(private listFolders: ListFoldersUseCase.Interface) {}\n\n    async execute(input: Input): Promise<FolderSummary[]> {\n        const result = await this.listFolders.execute({ where: { type: input.type } });\n\n        if (result.isFail()) {\n            throw new Error(`Could not list folders: ${result.error.message}`);\n        }\n\n        return result.value.folders.map(folder => ({\n            id: folder.id,\n            title: folder.title,\n            slug: folder.slug,\n            path: folder.path,\n            parentId: folder.parentId,\n            permissions: (folder.permissions ?? []).map(permission => ({\n                target: permission.target,\n                level: permission.level,\n                // Inherited rules cannot be edited on this folder — only on the ancestor that set them.\n                inherited: Boolean(permission.inheritedFrom)\n            }))\n        }));\n    }\n}\n\nconst ListFoldersToolHandler = AiSdkToolHandler.createImplementation({\n    implementation: ListFoldersToolHandlerImpl,\n    dependencies: [ListFoldersUseCase]\n});\n\n/**\n * Lists folders with their current access rules, so a permission change is proposed against a real\n * folder id and the user can see what the access already is before approving a change to it.\n */\nclass ListFoldersToolImpl implements AiSdkToolDefinition.Interface<Input> {\n    readonly name = \"listFolders\";\n    readonly title = \"List folders\";\n    readonly description =\n        \"Lists folders of a given type with their ids, paths and current access permissions. Call this before changing folder permissions so the change targets a real folder.\";\n    readonly inputSchema = inputSchema;\n    readonly annotations = { readOnlyHint: true, idempotentHint: true };\n    readonly handler = ListFoldersToolHandler;\n}\n\nexport const ListFoldersTool = AiSdkToolDefinition.createImplementation({\n    implementation: ListFoldersToolImpl,\n    dependencies: []\n});\n"],"names":["inputSchema","z","ListFoldersToolHandlerImpl","listFolders","input","result","Error","folder","permission","Boolean","ListFoldersToolHandler","AiSdkToolHandler","ListFoldersUseCase","ListFoldersToolImpl","ListFoldersTool","AiSdkToolDefinition"],"mappings":";;;AAIA,MAAMA,cAAcC,EAAE,MAAM,CAAC;IACzB,MAAMA,EAAAA,MACK,GACN,QAAQ,CACL;AAEZ;AAaA,MAAMC;IACF,YAAoBC,WAAyC,CAAE;aAA3CA,WAAW,GAAXA;IAA4C;IAEhE,MAAM,QAAQC,KAAY,EAA4B;QAClD,MAAMC,SAAS,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;YAAE,OAAO;gBAAE,MAAMD,MAAM,IAAI;YAAC;QAAE;QAE5E,IAAIC,OAAO,MAAM,IACb,MAAM,IAAIC,MAAM,CAAC,wBAAwB,EAAED,OAAO,KAAK,CAAC,OAAO,EAAE;QAGrE,OAAOA,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAACE,CAAAA,SAAW;gBACvC,IAAIA,OAAO,EAAE;gBACb,OAAOA,OAAO,KAAK;gBACnB,MAAMA,OAAO,IAAI;gBACjB,MAAMA,OAAO,IAAI;gBACjB,UAAUA,OAAO,QAAQ;gBACzB,aAAcA,AAAAA,CAAAA,OAAO,WAAW,IAAI,EAAC,EAAG,GAAG,CAACC,CAAAA,aAAe;wBACvD,QAAQA,WAAW,MAAM;wBACzB,OAAOA,WAAW,KAAK;wBAEvB,WAAWC,QAAQD,WAAW,aAAa;oBAC/C;YACJ;IACJ;AACJ;AAEA,MAAME,yBAAyBC,iBAAiB,oBAAoB,CAAC;IACjE,gBAAgBT;IAChB,cAAc;QAACU;KAAmB;AACtC;AAMA,MAAMC;;aACO,IAAI,GAAG;aACP,KAAK,GAAG;aACR,WAAW,GAChB;aACK,WAAW,GAAGb;aACd,WAAW,GAAG;YAAE,cAAc;YAAM,gBAAgB;QAAK;aACzD,OAAO,GAAGU;;AACvB;AAEO,MAAMI,kBAAkBC,oBAAoB,oBAAoB,CAAC;IACpE,gBAAgBF;IAChB,cAAc,EAAE;AACpB"}