@pellux/goodvibes-sdk 0.18.17 → 0.18.18

package/dist/_internal/platform/tools/packet/index.js

@@ -1,5 +1,6 @@
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join, resolve } from 'node:path';
+import { resolveScopedDirectory } from '../../runtime/surface-root.js';
 import { PACKET_TOOL_SCHEMA } from './schema.js';
 function summarizePacket(record) {
     return {
@@ -16,9 +17,11 @@ function summarizePacket(record) {
         publishedAt: record.publishedAt,
     };
 }
-export function createPacketTool(workingDirectory) {
+export function createPacketTool(options) {
+    const workingDirectory = typeof options === 'string' ? options : options.workingDirectory;
+    const surfaceRoot = typeof options === 'string' ? undefined : options.surfaceRoot;
     const workspaceRoot = resolve(workingDirectory);
-    const packetsDir = join(workspaceRoot, '.goodvibes', 'goodvibes');
+    const packetsDir = resolveScopedDirectory(workspaceRoot, surfaceRoot);
     const packetsPath = join(packetsDir, 'packets.json');
     function loadPackets() {
         try {

package/dist/_internal/platform/tools/query/index.d.ts

@@ -1,3 +1,6 @@
 import type { Tool } from '../../types/tools.js';
-export declare function createQueryTool(workingDirectory: string): Tool;
+export declare function createQueryTool(options: string | {
+    readonly workingDirectory: string;
+    readonly surfaceRoot?: string;
+}): Tool;
 //# sourceMappingURL=index.d.ts.map

package/dist/_internal/platform/tools/query/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/query/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AA6BjD,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAiG9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/query/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AA8BjD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACrF,IAAI,CAmGN"}

package/dist/_internal/platform/tools/query/index.js

@@ -1,5 +1,6 @@
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join, resolve } from 'node:path';
+import { resolveScopedDirectory } from '../../runtime/surface-root.js';
 import { QUERY_TOOL_SCHEMA } from './schema.js';
 function summarizeQuery(record) {
     return {
@@ -14,9 +15,11 @@ function summarizeQuery(record) {
         updatedAt: record.updatedAt,
     };
 }
-export function createQueryTool(workingDirectory) {
+export function createQueryTool(options) {
+    const workingDirectory = typeof options === 'string' ? options : options.workingDirectory;
+    const surfaceRoot = typeof options === 'string' ? undefined : options.surfaceRoot;
     const workspaceRoot = resolve(workingDirectory);
-    const queriesDir = join(workspaceRoot, '.goodvibes', 'goodvibes');
+    const queriesDir = resolveScopedDirectory(workspaceRoot, surfaceRoot);
     const queriesPath = join(queriesDir, 'queries.json');
     function loadQueries() {
         try {

package/dist/_internal/platform/tools/registry-tool/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/registry-tool/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAmCnD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAiID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAwC7F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/registry-tool/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAmCnD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AA6HD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAwC7F"}

package/dist/_internal/platform/tools/registry-tool/index.js

@@ -114,20 +114,18 @@ function fuzzyFilter(items, query) {
 function getSkillDirs(roots) {
     const dirs = [
         join(roots.workingDirectory, '.goodvibes', 'skills'),
-        join(roots.workingDirectory, '.goodvibes', 'goodvibes', 'skills'),
     ];
     if (roots.homeDirectory) {
-        dirs.push(join(roots.homeDirectory, '.goodvibes', 'skills'), join(roots.homeDirectory, '.goodvibes', 'goodvibes', 'skills'));
+        dirs.push(join(roots.homeDirectory, '.goodvibes', 'skills'));
     }
     return dirs;
 }
 function getAgentDirs(roots) {
     const dirs = [
         join(roots.workingDirectory, '.goodvibes', 'agents'),
-        join(roots.workingDirectory, '.goodvibes', 'goodvibes', 'agents'),
     ];
     if (roots.homeDirectory) {
-        dirs.push(join(roots.homeDirectory, '.goodvibes', 'agents'), join(roots.homeDirectory, '.goodvibes', 'goodvibes', 'agents'));
+        dirs.push(join(roots.homeDirectory, '.goodvibes', 'agents'));
     }
     return dirs;
 }

package/dist/_internal/platform/tools/registry-tool/skill-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/registry-tool/skill-loader.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAgBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAuDxF"}
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/registry-tool/skill-loader.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAcD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAuDxF"}

package/dist/_internal/platform/tools/registry-tool/skill-loader.js

@@ -10,10 +10,9 @@ import { materializeMarkdownBody, parseMarkdownFrontmatter, normalizeFrontmatter
 function getSkillDirs(roots) {
     const dirs = [
         join(roots.workingDirectory, '.goodvibes', 'skills'),
-        join(roots.workingDirectory, '.goodvibes', 'goodvibes', 'skills'),
     ];
     if (roots.homeDirectory) {
-        dirs.push(join(roots.homeDirectory, '.goodvibes', 'skills'), join(roots.homeDirectory, '.goodvibes', 'goodvibes', 'skills'));
+        dirs.push(join(roots.homeDirectory, '.goodvibes', 'skills'));
     }
     return dirs;
 }

package/dist/_internal/platform/tools/team/index.d.ts

@@ -1,3 +1,6 @@
 import type { Tool } from '../../types/tools.js';
+export declare function createTeamTool(options?: {
+    readonly surfaceRoot?: string;
+}): Tool;
 export declare const teamTool: Tool;
 //# sourceMappingURL=index.d.ts.map

package/dist/_internal/platform/tools/team/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/team/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AA4DjD,eAAO,MAAM,QAAQ,EAAE,IA4HtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/team/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AA6DjD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA+HhF;AAED,eAAO,MAAM,QAAQ,MAAmB,CAAC"}

package/dist/_internal/platform/tools/team/index.js

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { dirname } from 'node:path';
+import { resolveScopedDirectory } from '../../runtime/surface-root.js';
 import { TEAM_TOOL_SCHEMA } from './schema.js';
 function summarizeTeam(team) {
     return {
@@ -12,11 +13,11 @@ function summarizeTeam(team) {
         updatedAt: team.updatedAt,
     };
 }
-function teamsPath(storageRoot) {
-    return join(storageRoot, '.goodvibes', 'goodvibes', 'teams.json');
+function teamsPath(storageRoot, surfaceRoot) {
+    return resolveScopedDirectory(storageRoot, surfaceRoot, 'teams.json');
 }
-function loadTeams(storageRoot) {
-    const path = teamsPath(storageRoot);
+function loadTeams(storageRoot, surfaceRoot) {
+    const path = teamsPath(storageRoot, surfaceRoot);
     if (!existsSync(path))
         return [];
     try {
@@ -27,123 +28,127 @@ function loadTeams(storageRoot) {
         return [];
     }
 }
-function saveTeams(storageRoot, teams) {
-    const path = teamsPath(storageRoot);
+function saveTeams(storageRoot, teams, surfaceRoot) {
+    const path = teamsPath(storageRoot, surfaceRoot);
     mkdirSync(dirname(path), { recursive: true });
     writeFileSync(path, JSON.stringify({ version: 1, teams }, null, 2) + '\n', 'utf-8');
 }
-export const teamTool = {
-    definition: {
-        name: 'team',
-        description: 'Manage durable team definitions, roles, and communication lanes.',
-        parameters: TEAM_TOOL_SCHEMA,
-        sideEffects: ['workflow', 'state'],
-        concurrency: 'serial',
-    },
-    async execute(args) {
-        if (!args || typeof args !== 'object' || typeof args.mode !== 'string') {
-            return { success: false, error: 'Invalid args: mode is required.' };
-        }
-        const input = args;
-        if (!input.storageRoot || input.storageRoot.trim().length === 0) {
-            return { success: false, error: 'team requires storageRoot.' };
-        }
-        const teams = loadTeams(input.storageRoot);
-        const view = input.view ?? 'summary';
-        if (input.mode === 'create') {
-            if (!input.teamId || !input.name || !input.summary) {
-                return { success: false, error: 'create requires teamId, name, and summary.' };
+export function createTeamTool(options) {
+    const surfaceRoot = options?.surfaceRoot;
+    return {
+        definition: {
+            name: 'team',
+            description: 'Manage durable team definitions, roles, and communication lanes.',
+            parameters: TEAM_TOOL_SCHEMA,
+            sideEffects: ['workflow', 'state'],
+            concurrency: 'serial',
+        },
+        async execute(args) {
+            if (!args || typeof args !== 'object' || typeof args.mode !== 'string') {
+                return { success: false, error: 'Invalid args: mode is required.' };
+            }
+            const input = args;
+            if (!input.storageRoot || input.storageRoot.trim().length === 0) {
+                return { success: false, error: 'team requires storageRoot.' };
+            }
+            const teams = loadTeams(input.storageRoot, surfaceRoot);
+            const view = input.view ?? 'summary';
+            if (input.mode === 'create') {
+                if (!input.teamId || !input.name || !input.summary) {
+                    return { success: false, error: 'create requires teamId, name, and summary.' };
+                }
+                if (teams.some((team) => team.id === input.teamId)) {
+                    return { success: false, error: `Team already exists: ${input.teamId}` };
+                }
+                const now = Date.now();
+                const team = {
+                    id: input.teamId,
+                    name: input.name,
+                    summary: input.summary,
+                    members: [],
+                    createdAt: now,
+                    updatedAt: now,
+                };
+                saveTeams(input.storageRoot, [...teams, team], surfaceRoot);
+                return { success: true, output: JSON.stringify(team) };
+            }
+            if (input.mode === 'list') {
+                return {
+                    success: true,
+                    output: JSON.stringify({
+                        view,
+                        count: teams.length,
+                        teams: view === 'full' ? teams : teams.map(summarizeTeam),
+                    }),
+                };
+            }
+            const index = teams.findIndex((team) => team.id === input.teamId);
+            if (index < 0) {
+                return { success: false, error: `Unknown team: ${input.teamId ?? '(missing)'}` };
             }
-            if (teams.some((team) => team.id === input.teamId)) {
-                return { success: false, error: `Team already exists: ${input.teamId}` };
+            const current = teams[index];
+            if (input.mode === 'show') {
+                return {
+                    success: true,
+                    output: JSON.stringify(view === 'full' ? current : {
+                        ...summarizeTeam(current),
+                        members: current.members.map((member) => ({
+                            id: member.id,
+                            role: member.role,
+                            lanes: member.lanes,
+                        })),
+                    }),
+                };
             }
-            const now = Date.now();
-            const team = {
-                id: input.teamId,
-                name: input.name,
-                summary: input.summary,
-                members: [],
-                createdAt: now,
-                updatedAt: now,
-            };
-            saveTeams(input.storageRoot, [...teams, team]);
-            return { success: true, output: JSON.stringify(team) };
-        }
-        if (input.mode === 'list') {
-            return {
-                success: true,
-                output: JSON.stringify({
-                    view,
-                    count: teams.length,
-                    teams: view === 'full' ? teams : teams.map(summarizeTeam),
-                }),
-            };
-        }
-        const index = teams.findIndex((team) => team.id === input.teamId);
-        if (index < 0) {
-            return { success: false, error: `Unknown team: ${input.teamId ?? '(missing)'}` };
-        }
-        const current = teams[index];
-        if (input.mode === 'show') {
-            return {
-                success: true,
-                output: JSON.stringify(view === 'full' ? current : {
-                    ...summarizeTeam(current),
-                    members: current.members.map((member) => ({
-                        id: member.id,
-                        role: member.role,
-                        lanes: member.lanes,
-                    })),
-                }),
-            };
-        }
-        if (input.mode === 'delete') {
-            saveTeams(input.storageRoot, teams.filter((team) => team.id !== input.teamId));
-            return { success: true, output: JSON.stringify({ removed: input.teamId }) };
-        }
-        if (input.mode === 'add-member') {
-            if (!input.memberId || !input.role) {
-                return { success: false, error: 'add-member requires memberId and role.' };
+            if (input.mode === 'delete') {
+                saveTeams(input.storageRoot, teams.filter((team) => team.id !== input.teamId), surfaceRoot);
+                return { success: true, output: JSON.stringify({ removed: input.teamId }) };
             }
-            const next = {
-                ...current,
-                members: [
-                    ...current.members.filter((member) => member.id !== input.memberId),
-                    { id: input.memberId, role: input.role, lanes: input.lanes ?? [] },
-                ],
-                updatedAt: Date.now(),
-            };
-            teams[index] = next;
-            saveTeams(input.storageRoot, teams);
-            return { success: true, output: JSON.stringify(next) };
-        }
-        if (input.mode === 'remove-member') {
-            if (!input.memberId)
-                return { success: false, error: 'remove-member requires memberId.' };
-            const next = {
-                ...current,
-                members: current.members.filter((member) => member.id !== input.memberId),
-                updatedAt: Date.now(),
-            };
-            teams[index] = next;
-            saveTeams(input.storageRoot, teams);
-            return { success: true, output: JSON.stringify(next) };
-        }
-        if (input.mode === 'set-lanes') {
-            if (!input.memberId)
-                return { success: false, error: 'set-lanes requires memberId.' };
-            const members = current.members.map((member) => (member.id === input.memberId
-                ? { ...member, lanes: input.lanes ?? [] }
-                : member));
-            const next = {
-                ...current,
-                members,
-                updatedAt: Date.now(),
-            };
-            teams[index] = next;
-            saveTeams(input.storageRoot, teams);
-            return { success: true, output: JSON.stringify(next) };
-        }
-        return { success: false, error: `Unknown mode: ${input.mode}` };
-    },
-};
+            if (input.mode === 'add-member') {
+                if (!input.memberId || !input.role) {
+                    return { success: false, error: 'add-member requires memberId and role.' };
+                }
+                const next = {
+                    ...current,
+                    members: [
+                        ...current.members.filter((member) => member.id !== input.memberId),
+                        { id: input.memberId, role: input.role, lanes: input.lanes ?? [] },
+                    ],
+                    updatedAt: Date.now(),
+                };
+                teams[index] = next;
+                saveTeams(input.storageRoot, teams, surfaceRoot);
+                return { success: true, output: JSON.stringify(next) };
+            }
+            if (input.mode === 'remove-member') {
+                if (!input.memberId)
+                    return { success: false, error: 'remove-member requires memberId.' };
+                const next = {
+                    ...current,
+                    members: current.members.filter((member) => member.id !== input.memberId),
+                    updatedAt: Date.now(),
+                };
+                teams[index] = next;
+                saveTeams(input.storageRoot, teams, surfaceRoot);
+                return { success: true, output: JSON.stringify(next) };
+            }
+            if (input.mode === 'set-lanes') {
+                if (!input.memberId)
+                    return { success: false, error: 'set-lanes requires memberId.' };
+                const members = current.members.map((member) => (member.id === input.memberId
+                    ? { ...member, lanes: input.lanes ?? [] }
+                    : member));
+                const next = {
+                    ...current,
+                    members,
+                    updatedAt: Date.now(),
+                };
+                teams[index] = next;
+                saveTeams(input.storageRoot, teams, surfaceRoot);
+                return { success: true, output: JSON.stringify(next) };
+            }
+            return { success: false, error: `Unknown mode: ${input.mode}` };
+        },
+    };
+}
+export const teamTool = createTeamTool();

package/dist/_internal/platform/tools/worklist/index.d.ts

@@ -1,3 +1,6 @@
 import type { Tool } from '../../types/tools.js';
+export declare function createWorklistTool(options?: {
+    readonly surfaceRoot?: string;
+}): Tool;
 export declare const worklistTool: Tool;
 //# sourceMappingURL=index.d.ts.map

package/dist/_internal/platform/tools/worklist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/worklist/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AA+DjD,eAAO,MAAM,YAAY,EAAE,IAyG1B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/worklist/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAgEjD,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4GpF;AAED,eAAO,MAAM,YAAY,MAAuB,CAAC"}

package/dist/_internal/platform/tools/worklist/index.js

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { dirname } from 'node:path';
+import { resolveScopedDirectory } from '../../runtime/surface-root.js';
 import { WORKLIST_TOOL_SCHEMA } from './schema.js';
 function summarizeWorklist(record) {
     const openCount = record.items.filter((item) => item.status === 'open').length;
@@ -14,11 +15,11 @@ function summarizeWorklist(record) {
         updatedAt: record.updatedAt,
     };
 }
-function worklistsPath(storageRoot) {
-    return join(storageRoot, '.goodvibes', 'goodvibes', 'worklists.json');
+function worklistsPath(storageRoot, surfaceRoot) {
+    return resolveScopedDirectory(storageRoot, surfaceRoot, 'worklists.json');
 }
-function loadWorklists(storageRoot) {
-    const path = worklistsPath(storageRoot);
+function loadWorklists(storageRoot, surfaceRoot) {
+    const path = worklistsPath(storageRoot, surfaceRoot);
     if (!existsSync(path))
         return [];
     try {
@@ -29,112 +30,116 @@ function loadWorklists(storageRoot) {
         return [];
     }
 }
-function saveWorklists(storageRoot, worklists) {
-    const path = worklistsPath(storageRoot);
+function saveWorklists(storageRoot, worklists, surfaceRoot) {
+    const path = worklistsPath(storageRoot, surfaceRoot);
     mkdirSync(dirname(path), { recursive: true });
     writeFileSync(path, JSON.stringify({ version: 1, worklists }, null, 2) + '\n', 'utf-8');
 }
-export const worklistTool = {
-    definition: {
-        name: 'worklist',
-        description: 'Manage durable worklists and checklist items for execution planning and follow-up.',
-        parameters: WORKLIST_TOOL_SCHEMA,
-        sideEffects: ['workflow', 'state'],
-        concurrency: 'serial',
-    },
-    async execute(args) {
-        if (!args || typeof args !== 'object' || typeof args.mode !== 'string') {
-            return { success: false, error: 'Invalid args: mode is required.' };
-        }
-        const input = args;
-        if (!input.storageRoot || input.storageRoot.trim().length === 0) {
-            return { success: false, error: 'worklist requires storageRoot.' };
-        }
-        const worklists = loadWorklists(input.storageRoot);
-        const view = input.view ?? 'summary';
-        if (input.mode === 'create') {
-            if (!input.worklistId || !input.title) {
-                return { success: false, error: 'create requires worklistId and title.' };
+export function createWorklistTool(options) {
+    const surfaceRoot = options?.surfaceRoot;
+    return {
+        definition: {
+            name: 'worklist',
+            description: 'Manage durable worklists and checklist items for execution planning and follow-up.',
+            parameters: WORKLIST_TOOL_SCHEMA,
+            sideEffects: ['workflow', 'state'],
+            concurrency: 'serial',
+        },
+        async execute(args) {
+            if (!args || typeof args !== 'object' || typeof args.mode !== 'string') {
+                return { success: false, error: 'Invalid args: mode is required.' };
             }
-            if (worklists.some((entry) => entry.id === input.worklistId)) {
-                return { success: false, error: `Worklist already exists: ${input.worklistId}` };
+            const input = args;
+            if (!input.storageRoot || input.storageRoot.trim().length === 0) {
+                return { success: false, error: 'worklist requires storageRoot.' };
             }
-            const now = Date.now();
-            const record = {
-                id: input.worklistId,
-                title: input.title,
-                items: [],
-                createdAt: now,
-                updatedAt: now,
-            };
-            saveWorklists(input.storageRoot, [...worklists, record]);
-            return { success: true, output: JSON.stringify(record) };
-        }
-        if (input.mode === 'list') {
-            return {
-                success: true,
-                output: JSON.stringify({
-                    view,
-                    count: worklists.length,
-                    worklists: view === 'full' ? worklists : worklists.map(summarizeWorklist),
-                }),
-            };
-        }
-        const index = worklists.findIndex((entry) => entry.id === input.worklistId);
-        if (index < 0) {
-            return { success: false, error: `Unknown worklist: ${input.worklistId ?? '(missing)'}` };
-        }
-        const current = worklists[index];
-        if (input.mode === 'show') {
-            return {
-                success: true,
-                output: JSON.stringify(view === 'full' ? current : {
-                    ...summarizeWorklist(current),
-                    items: current.items.map((item) => ({
-                        id: item.id,
-                        text: item.text,
-                        status: item.status,
-                        owner: item.owner,
-                        priority: item.priority,
-                    })),
-                }),
-            };
-        }
-        if (input.mode === 'add-item') {
-            if (!input.itemId || !input.text)
-                return { success: false, error: 'add-item requires itemId and text.' };
+            const worklists = loadWorklists(input.storageRoot, surfaceRoot);
+            const view = input.view ?? 'summary';
+            if (input.mode === 'create') {
+                if (!input.worklistId || !input.title) {
+                    return { success: false, error: 'create requires worklistId and title.' };
+                }
+                if (worklists.some((entry) => entry.id === input.worklistId)) {
+                    return { success: false, error: `Worklist already exists: ${input.worklistId}` };
+                }
+                const now = Date.now();
+                const record = {
+                    id: input.worklistId,
+                    title: input.title,
+                    items: [],
+                    createdAt: now,
+                    updatedAt: now,
+                };
+                saveWorklists(input.storageRoot, [...worklists, record], surfaceRoot);
+                return { success: true, output: JSON.stringify(record) };
+            }
+            if (input.mode === 'list') {
+                return {
+                    success: true,
+                    output: JSON.stringify({
+                        view,
+                        count: worklists.length,
+                        worklists: view === 'full' ? worklists : worklists.map(summarizeWorklist),
+                    }),
+                };
+            }
+            const index = worklists.findIndex((entry) => entry.id === input.worklistId);
+            if (index < 0) {
+                return { success: false, error: `Unknown worklist: ${input.worklistId ?? '(missing)'}` };
+            }
+            const current = worklists[index];
+            if (input.mode === 'show') {
+                return {
+                    success: true,
+                    output: JSON.stringify(view === 'full' ? current : {
+                        ...summarizeWorklist(current),
+                        items: current.items.map((item) => ({
+                            id: item.id,
+                            text: item.text,
+                            status: item.status,
+                            owner: item.owner,
+                            priority: item.priority,
+                        })),
+                    }),
+                };
+            }
+            if (input.mode === 'add-item') {
+                if (!input.itemId || !input.text)
+                    return { success: false, error: 'add-item requires itemId and text.' };
+                const next = {
+                    ...current,
+                    items: [
+                        ...current.items.filter((item) => item.id !== input.itemId),
+                        { id: input.itemId, text: input.text, status: 'open', priority: input.priority ?? 'medium', ...(input.owner ? { owner: input.owner } : {}) },
+                    ],
+                    updatedAt: Date.now(),
+                };
+                worklists[index] = next;
+                saveWorklists(input.storageRoot, worklists, surfaceRoot);
+                return { success: true, output: JSON.stringify(next) };
+            }
+            if (!input.itemId)
+                return { success: false, error: `${input.mode} requires itemId.` };
+            const nextItems = current.items
+                .filter((item) => input.mode !== 'remove-item' || item.id !== input.itemId)
+                .map((item) => {
+                if (item.id !== input.itemId)
+                    return item;
+                if (input.mode === 'complete-item')
+                    return { ...item, status: 'done' };
+                if (input.mode === 'reopen-item')
+                    return { ...item, status: 'open' };
+                return item;
+            });
             const next = {
                 ...current,
-                items: [
-                    ...current.items.filter((item) => item.id !== input.itemId),
-                    { id: input.itemId, text: input.text, status: 'open', priority: input.priority ?? 'medium', ...(input.owner ? { owner: input.owner } : {}) },
-                ],
+                items: nextItems,
                 updatedAt: Date.now(),
             };
             worklists[index] = next;
-            saveWorklists(input.storageRoot, worklists);
+            saveWorklists(input.storageRoot, worklists, surfaceRoot);
             return { success: true, output: JSON.stringify(next) };
-        }
-        if (!input.itemId)
-            return { success: false, error: `${input.mode} requires itemId.` };
-        const nextItems = current.items
-            .filter((item) => input.mode !== 'remove-item' || item.id !== input.itemId)
-            .map((item) => {
-            if (item.id !== input.itemId)
-                return item;
-            if (input.mode === 'complete-item')
-                return { ...item, status: 'done' };
-            if (input.mode === 'reopen-item')
-                return { ...item, status: 'open' };
-            return item;
-        });
-        const next = {
-            ...current,
-            items: nextItems,
-            updatedAt: Date.now(),
-        };
-        worklists[index] = next;
-        saveWorklists(input.storageRoot, worklists);
-        return { success: true, output: JSON.stringify(next) };
-    },
-};
+        },
+    };
+}
+export const worklistTool = createWorklistTool();