@typelets/mcp 0.2.0

package/dist/tools/create_file.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerCreateFile(server, client, env) {
+    // Profile gate: keep the string in sync with INTERVIEWER_ONLY_TOOLS in ../profile.ts.
+    if (!toolAllowedForProfile('create_file', env.profile))
+        return;
+    server.registerTool('create_file', {
+        title: 'Create a file in a workspace',
+        description: 'Create a new file at a slash-separated path in a workspace. Folders are created as needed. Returns the new file id. Errors: 409 if a file already exists at the path (use update_file instead); 413 if content exceeds 1 MiB.',
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id from list_workspaces.'),
+            path: z.string().min(1).describe('Slash-separated path from the workspace root (e.g. "src/lib/auth.ts"). Cannot contain ".." segments.'),
+            content: z.string().optional().describe('Initial UTF-8 content. Omit to create an empty placeholder file that the y-websocket server will materialise on first open.'),
+        },
+    }, async ({ workspaceId, path, content }) => {
+        try {
+            const body = { path };
+            if (content !== undefined)
+                body.content = content;
+            const result = await client.post(`/workspaces/${encodeURIComponent(workspaceId)}/files`, body);
+            return ok(`Created ${result.path} (id=${result.id}).`, { file: result });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=create_file.js.map

package/dist/tools/create_file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_file.js","sourceRoot":"","sources":["../../src/tools/create_file.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AASxC,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAsB,EAAE,GAAQ;IACpF,sFAAsF;IACtF,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAE/D,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,+NAA+N;QACjO,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YACjF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sGAAsG,CAAC;YACxI,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6HAA6H,CAAC;SACvK;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,IAAI,GAAuC,EAAE,IAAI,EAAE,CAAC;YAC1D,IAAI,OAAO,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAC9B,eAAe,kBAAkB,CAAC,WAAW,CAAC,QAAQ,EACtD,IAAI,CACL,CAAC;YACF,OAAO,EAAE,CAAC,WAAW,MAAM,CAAC,IAAI,QAAQ,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/create_workspace.d.ts

@@ -0,0 +1,11 @@
+/**
+ * create_workspace: create a new Typelets workspace.
+ *
+ * Interviewer-only. Candidates never see this tool in listTools.
+ * Returns the new workspace object including its id, which the
+ * caller will need for subsequent tool calls (e.g. apply_problem_to_workspace).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerCreateWorkspace(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/create_workspace.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerCreateWorkspace(server, client, env) {
+    // Profile gate: keep the string in sync with INTERVIEWER_ONLY_TOOLS in ../profile.ts.
+    if (!toolAllowedForProfile('create_workspace', env.profile))
+        return;
+    server.registerTool('create_workspace', {
+        title: 'Create a new workspace',
+        description: 'Create a new Typelets workspace. Returns the new workspace object including its id. ' +
+            'Use the returned id to apply a problem (apply_problem_to_workspace) or create files. ' +
+            'Errors: 409 if mode=interview and shareScope=public (interviews cannot be public).',
+        inputSchema: {
+            name: z.string().min(1).max(80).describe('Display name for the new workspace (max 80 chars).'),
+            mode: z.enum(['general', 'interview']).optional().describe('Workspace mode. Defaults to "general". Use "interview" for structured coding interviews.'),
+            shareScope: z.enum(['private', 'org', 'public']).optional().describe('Sharing scope. Defaults to "private". "interview" mode cannot be "public".'),
+        },
+    }, async ({ name, mode, shareScope }) => {
+        try {
+            const body = { name };
+            if (mode !== undefined)
+                body.mode = mode;
+            if (shareScope !== undefined)
+                body.shareScope = shareScope;
+            const result = await client.post('/workspaces', body);
+            return ok(`Created workspace "${result.workspace.name}" (id=${result.workspace.id}).`, { workspace: result.workspace });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=create_workspace.js.map

package/dist/tools/create_workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_workspace.js","sourceRoot":"","sources":["../../src/tools/create_workspace.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAaxC,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAsB,EAAE,GAAQ;IACzF,sFAAsF;IACtF,IAAI,CAAC,qBAAqB,CAAC,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAEpE,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,sFAAsF;YACtF,uFAAuF;YACvF,oFAAoF;QACtF,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,oDAAoD,CAAC;YAC9F,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0FAA0F,CAAC;YACtJ,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;SACnJ;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,GAAyD,EAAE,IAAI,EAAE,CAAC;YAC5E,IAAI,IAAI,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACzC,IAAI,UAAU,KAAK,SAAS;gBAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;YAC3D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0B,aAAa,EAAE,IAAI,CAAC,CAAC;YAC/E,OAAO,EAAE,CAAC,sBAAsB,MAAM,CAAC,SAAS,CAAC,IAAI,SAAS,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC1H,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/delete_file.d.ts

@@ -0,0 +1,12 @@
+/**
+ * delete_file: remove a file from a workspace.
+ *
+ * Available to both interviewer and candidate profiles. Idempotent: if the
+ * file id no longer exists in the workspace the server returns 204 without
+ * error. Marked destructive because the delete is permanent from the MCP
+ * server's perspective.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerDeleteFile(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/delete_file.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerDeleteFile(server, client, env) {
+    // Profile gate: keep the string in sync with INTERVIEWER_ONLY_TOOLS in ../profile.ts.
+    if (!toolAllowedForProfile('delete_file', env.profile))
+        return;
+    server.registerTool('delete_file', {
+        title: 'Delete a file from a workspace',
+        description: 'Permanently delete a file from a workspace. This action is idempotent: if the file id no longer exists the operation still succeeds silently. The deletion is immediate and cannot be undone via this tool.',
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id from list_workspaces.'),
+            fileId: z.string().min(1).describe('The file id from list_workspace_files.'),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ workspaceId, fileId }) => {
+        try {
+            await client.delete(`/workspaces/${encodeURIComponent(workspaceId)}/files/${encodeURIComponent(fileId)}`);
+            return ok(`Deleted file ${fileId} from workspace ${workspaceId}.`, { deleted: true });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=delete_file.js.map

package/dist/tools/delete_file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_file.js","sourceRoot":"","sources":["../../src/tools/delete_file.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAsB,EAAE,GAAQ;IACpF,sFAAsF;IACtF,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAE/D,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EACT,6MAA6M;QAC/M,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YACjF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SAC7E;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,CACjB,eAAe,kBAAkB,CAAC,WAAW,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,CACrF,CAAC;YACF,OAAO,EAAE,CAAC,gBAAgB,MAAM,mBAAmB,WAAW,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACxF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/delete_problem.d.ts

@@ -0,0 +1,11 @@
+/**
+ * delete_problem: delete a problem from the library.
+ *
+ * Interviewer-only. PERMANENT: the problem is removed from the library.
+ * Workspaces that previously applied it keep their copy of the prompt,
+ * criteria, and files; the deletion only removes the library entry.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerDeleteProblem(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/delete_problem.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerDeleteProblem(server, client, env) {
+    // Profile gate: keep the string in sync with INTERVIEWER_ONLY_TOOLS in ../profile.ts.
+    if (!toolAllowedForProfile('delete_problem', env.profile))
+        return;
+    server.registerTool('delete_problem', {
+        title: 'Delete a problem from the library',
+        description: 'Delete a problem from the Typelets library. PERMANENT: the problem is removed and cannot ' +
+            'be restored. Workspaces that previously applied it keep their copy of the ' +
+            'prompt, criteria, and files. ' +
+            'Errors: 403 if you are not the author (or not an org admin for shared-library problems); ' +
+            '404 if the problem is not found.',
+        inputSchema: {
+            problemId: z.string().min(1).describe('The problem id or slug from list_problems.'),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ problemId }) => {
+        try {
+            await client.delete(`/problems/${encodeURIComponent(problemId)}`);
+            return ok(`Deleted problem ${problemId}.`, { deleted: true, problemId });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=delete_problem.js.map

package/dist/tools/delete_problem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_problem.js","sourceRoot":"","sources":["../../src/tools/delete_problem.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAsB,EAAE,GAAQ;IACvF,sFAAsF;IACtF,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAElE,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EACT,2FAA2F;YAC3F,4EAA4E;YAC5E,+BAA+B;YAC/B,2FAA2F;YAC3F,kCAAkC;QACpC,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;SACpF;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,CAAO,aAAa,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YACxE,OAAO,EAAE,CAAC,mBAAmB,SAAS,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/edit_problem.d.ts

@@ -0,0 +1,11 @@
+/**
+ * edit_problem: edit an existing library problem.
+ *
+ * Interviewer-only. All fields are optional. Send only the ones you
+ * want to change. Workspaces that previously applied the problem keep
+ * their copy of the prompt/criteria/files; changes only affect future applies.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerEditProblem(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/edit_problem.js

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+const criterionSchema = z.object({
+    name: z.string().trim().min(1).max(120),
+    description: z.string().max(2000),
+});
+const stdinTestCaseSchema = z.object({
+    kind: z.literal('stdin').optional(),
+    name: z.string().trim().min(1).max(120),
+    stdin: z.string().max(20000),
+    expectedStdout: z.string().max(20000),
+    visible: z.boolean().default(true),
+});
+const frameworkTestCaseSchema = z.object({
+    kind: z.literal('framework'),
+    name: z.string().trim().min(1).max(120),
+    framework: z.enum([
+        'go', 'pytest', 'jest', 'vitest', 'rspec',
+        'minitest', 'npm-test', 'rails', 'phpunit', 'other',
+    ]),
+    command: z.string().min(1).max(4000),
+    visible: z.boolean().default(true),
+});
+const testCaseSchema = z.union([frameworkTestCaseSchema, stdinTestCaseSchema]);
+const problemFileSchema = z.object({
+    name: z.string().trim().min(1).max(512).describe('Slash-separated path from workspace root.'),
+    content: z.string().max(1_048_576),
+});
+const categoryEnum = z.enum([
+    'arrays_strings',
+    'hash_tables',
+    'linked_lists',
+    'stacks_queues',
+    'trees',
+    'graphs',
+    'recursion_dp',
+    'sorting_searching',
+    'math_bigo',
+    'design',
+    'ai',
+    'data',
+    'frontend',
+    'backend',
+    'systems',
+    'sql',
+    'other',
+]);
+export function registerEditProblem(server, client, env) {
+    // Profile gate: keep the string in sync with INTERVIEWER_ONLY_TOOLS in ../profile.ts.
+    if (!toolAllowedForProfile('edit_problem', env.profile))
+        return;
+    server.registerTool('edit_problem', {
+        title: 'Edit an existing library problem',
+        description: 'Edit an existing problem in the Typelets library. All fields are optional. Only the fields ' +
+            'you provide are updated. Workspaces that previously applied this problem keep their copy of the ' +
+            'prompt, criteria, and files; edits here only affect future apply_problem_to_workspace calls. ' +
+            'Destructive. Changes to the library entry are immediate and cannot be undone via this tool. ' +
+            'Errors: 400 if no fields are provided; 403 if you are not the author (or not an org admin ' +
+            'for shared-library problems); 404 if the problem is not found.',
+        inputSchema: {
+            problemId: z.string().min(1).describe('The problem id or slug from list_problems.'),
+            title: z.string().trim().min(1).max(200).optional().describe('New title.'),
+            difficulty: z.enum(['easy', 'medium', 'hard']).optional().describe('New difficulty.'),
+            prompt: z.string().min(1).max(20000).optional().describe('New problem statement. Markdown supported.'),
+            rubric: z.string().max(20000).nullable().optional().describe('New interviewer-only rubric. Pass null to clear.'),
+            criteria: z.array(criterionSchema).max(20).optional().describe('Replace the full criteria list. Up to 20 entries.'),
+            tests: z.array(testCaseSchema).max(40).optional().describe('Replace the full test-case list. Up to 40 entries.'),
+            starters: z.record(z.string(), z.string()).optional().describe('Replace the legacy single-file starter map.'),
+            starterFiles: z.array(problemFileSchema).max(5000).optional().describe('Replace the full starter file tree. Up to 5000 files.'),
+            solutionFiles: z.array(problemFileSchema).max(5000).optional().describe('Replace the full solution file tree. Up to 5000 files.'),
+            testFiles: z.array(problemFileSchema).max(5000).optional().describe('Replace the full test file tree. Up to 5000 files.'),
+            tags: z.array(z.string().trim().min(1).max(40)).max(20).optional().describe('Replace the tag list. Up to 20 tags.'),
+            category: categoryEnum.optional().describe('New category.'),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ problemId, ...fields }) => {
+        try {
+            const result = await client.patch(`/problems/${encodeURIComponent(problemId)}`, fields);
+            return ok(`Updated problem "${result.problem.title}" (id=${result.problem.id}).`, { problem: result.problem });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=edit_problem.js.map

package/dist/tools/edit_problem.js.map

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

package/dist/tools/get_problem.d.ts

@@ -0,0 +1,13 @@
+/**
+ * get_problem: fetch the full detail for a single library problem.
+ *
+ * In `interviewer` profile, returns prompt + rubric + criteria + visible
+ * and hidden tests + solution metadata. In `candidate` profile the
+ * rubric, criteria, hidden tests, and solution are stripped before
+ * leaving this process. The LLM never sees them. The filtering is in
+ * `profile.ts`; this handler just forwards the result through it.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerGetProblem(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/get_problem.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { filterProblemForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerGetProblem(server, client, env) {
+    server.registerTool('get_problem', {
+        title: 'Get library problem',
+        description: 'Fetch the full detail of a library problem by id. In the interviewer profile the response includes rubric, criteria, hidden tests, and solution metadata; in the candidate profile those fields are stripped before the response leaves this server.',
+        inputSchema: {
+            problemId: z.string().min(1).describe('The library problem id.'),
+        },
+    }, async ({ problemId }) => {
+        try {
+            const { problem } = await client.get(`/problems/${encodeURIComponent(problemId)}`);
+            const filtered = filterProblemForProfile(problem, env);
+            const note = env.profile === 'candidate'
+                ? ' (candidate profile: rubric, criteria, hidden tests, and solution stripped)'
+                : '';
+            return ok(`Problem "${filtered.title}" (${filtered.difficulty})${note}.`, {
+                problem: filtered,
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=get_problem.js.map

package/dist/tools/get_problem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_problem.js","sourceRoot":"","sources":["../../src/tools/get_problem.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,uBAAuB,EAA0B,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAMxC,MAAM,UAAU,kBAAkB,CAChC,MAAiB,EACjB,MAAsB,EACtB,GAAQ;IAER,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,sPAAsP;QACxP,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;SACjE;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAClC,aAAa,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAC7C,CAAC;YACF,MAAM,QAAQ,GAAG,uBAAuB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACvD,MAAM,IAAI,GACR,GAAG,CAAC,OAAO,KAAK,WAAW;gBACzB,CAAC,CAAC,6EAA6E;gBAC/E,CAAC,CAAC,EAAE,CAAC;YACT,OAAO,EAAE,CAAC,YAAY,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,UAAU,IAAI,IAAI,GAAG,EAAE;gBACxE,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get_workspace.d.ts

@@ -0,0 +1,12 @@
+/**
+ * get_workspace: fetch the full summary for a single workspace.
+ *
+ * Returns the applied problem id (when any), preview configuration,
+ * and the candidate / interviewer membership state. Combine with
+ * `list_workspace_files` to surface what a candidate has actually
+ * been working on inside a workspace.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerGetWorkspace(server: McpServer, client: TypeletsClient, _env: Env): void;

package/dist/tools/get_workspace.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { ok, fail } from './_shared.js';
+export function registerGetWorkspace(server, client, _env) {
+    server.registerTool('get_workspace', {
+        title: 'Get workspace',
+        description: 'Fetch the full workspace summary for a given id (use list_workspaces to discover ids). Returns role, share scope, applied problem id, and preview settings.',
+        inputSchema: {
+            workspaceId: z
+                .string()
+                .min(1)
+                .describe('The workspace id, e.g. "cmpkojnzm0004iqsfa2o2z94n".'),
+        },
+    }, async ({ workspaceId }) => {
+        try {
+            const { workspace } = await client.get(`/workspaces/${encodeURIComponent(workspaceId)}`);
+            return ok(`Workspace "${workspace.name}" (${workspace.mode}).`, { workspace });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=get_workspace.js.map

package/dist/tools/get_workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_workspace.js","sourceRoot":"","sources":["../../src/tools/get_workspace.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAmBxC,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAsB,EACtB,IAAS;IAET,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,6JAA6J;QAC/J,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,qDAAqD,CAAC;SACnE;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CACpC,eAAe,kBAAkB,CAAC,WAAW,CAAC,EAAE,CACjD,CAAC;YACF,OAAO,EAAE,CAAC,cAAc,SAAS,CAAC,IAAI,MAAM,SAAS,CAAC,IAAI,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list_pending_invites.d.ts

@@ -0,0 +1,12 @@
+/**
+ * list_pending_invites: return invitations addressed to the caller.
+ *
+ * Returns both workspace-level and organization-level invites in the
+ * same response so the LLM can answer "what's waiting for me?" with a
+ * single tool call. Each entry carries an `accept` and `decline` path
+ * the agent could plug into a Phase 2 write tool later.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerListPendingInvites(server: McpServer, client: TypeletsClient, _env: Env): void;

package/dist/tools/list_pending_invites.js

@@ -0,0 +1,39 @@
+import { ok, fail } from './_shared.js';
+export function registerListPendingInvites(server, client, _env) {
+    server.registerTool('list_pending_invites', {
+        title: 'List pending invitations',
+        description: "Return every workspace + organisation invitation addressed to the caller's email. Combine the two server-side so the model sees one merged list.",
+        inputSchema: {},
+    }, async () => {
+        try {
+            const [workspaceInvites, orgInvites] = await Promise.all([
+                client.get('/invites'),
+                client.get('/invitations'),
+            ]);
+            const merged = [
+                ...workspaceInvites.invites.map((i) => ({
+                    kind: 'workspace',
+                    id: i.id,
+                    workspaceId: i.workspaceId,
+                    workspaceName: i.workspaceName,
+                    role: i.role,
+                    createdAt: i.createdAt,
+                })),
+                ...orgInvites.invitations.map((i) => ({
+                    kind: 'organization',
+                    id: i.id,
+                    organizationId: i.organization.id,
+                    organizationName: i.organization.name,
+                    role: i.role,
+                    createdAt: i.createdAt,
+                    expiresAt: i.expiresAt,
+                })),
+            ];
+            return ok(`Found ${merged.length} pending invitation${merged.length === 1 ? '' : 's'}.`, { invites: merged });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=list_pending_invites.js.map

package/dist/tools/list_pending_invites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_pending_invites.js","sourceRoot":"","sources":["../../src/tools/list_pending_invites.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AA6BxC,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,MAAsB,EACtB,IAAS;IAET,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,kJAAkJ;QACpJ,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACvD,MAAM,CAAC,GAAG,CAAsB,UAAU,CAAC;gBAC3C,MAAM,CAAC,GAAG,CAA6B,cAAc,CAAC;aACvD,CAAC,CAAC;YACH,MAAM,MAAM,GAAoC;gBAC9C,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAkB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvD,IAAI,EAAE,WAAW;oBACjB,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,aAAa,EAAE,CAAC,CAAC,aAAa;oBAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB,CAAC,CAAC;gBACH,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAY,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC/C,IAAI,EAAE,cAAc;oBACpB,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,cAAc,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE;oBACjC,gBAAgB,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI;oBACrC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB,CAAC,CAAC;aACJ,CAAC;YACF,OAAO,EAAE,CACP,SAAS,MAAM,CAAC,MAAM,sBAAsB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAC7E,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list_problems.d.ts

@@ -0,0 +1,15 @@
+/**
+ * list_problems: return library entries the caller can see.
+ *
+ * Respects the existing API-side scoping (system library vs. org
+ * library) plus the candidate profile when active (the profile gate is
+ * a list-level no-op; the per-problem filtering happens in get_problem).
+ *
+ * Optional filters mirror the in-app picker: category, difficulty,
+ * scope (system / org / all). The model can call this iteratively to
+ * narrow down before a get_problem.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerListProblems(server: McpServer, client: TypeletsClient, _env: Env): void;

package/dist/tools/list_problems.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { ok, fail } from './_shared.js';
+const DIFFICULTY = z.enum(['easy', 'medium', 'hard']);
+export function registerListProblems(server, client, _env) {
+    server.registerTool('list_problems', {
+        title: 'List library problems',
+        description: 'Return the problem-library entries the caller can see. Optional filters: category, difficulty, scope (system / org / all). The candidate profile sees the same listing as the interviewer profile here; rubric / hidden tests are stripped at the get_problem stage.',
+        inputSchema: {
+            difficulty: DIFFICULTY.optional().describe('Filter by difficulty.'),
+            category: z
+                .string()
+                .optional()
+                .describe('Filter by category enum (e.g. "arrays_strings", "trees").'),
+            scope: z
+                .enum(['all', 'shared', 'org'])
+                .optional()
+                .describe('"shared" = the system library; "org" = scoped to the caller\'s active org.'),
+        },
+    }, async ({ difficulty, category, scope }) => {
+        try {
+            const { problems } = await client.get('/problems');
+            const filtered = problems.filter((p) => {
+                if (difficulty !== undefined && p.difficulty !== difficulty)
+                    return false;
+                if (category !== undefined && p.category !== category)
+                    return false;
+                if (scope !== undefined && scope !== 'all' && p.visibility !== scope)
+                    return false;
+                return true;
+            });
+            return ok(`Found ${filtered.length} problem${filtered.length === 1 ? '' : 's'} matching the filter.`, { problems: filtered });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=list_problems.js.map

package/dist/tools/list_problems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_problems.js","sourceRoot":"","sources":["../../src/tools/list_problems.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAexC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtD,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAsB,EACtB,IAAS;IAET,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,sQAAsQ;QACxQ,WAAW,EAAE;YACX,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACnE,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2DAA2D,CAAC;YACxE,KAAK,EAAE,CAAC;iBACL,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;iBAC9B,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;SAC1F;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAuB,WAAW,CAAC,CAAC;YACzE,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrC,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,UAAU;oBAAE,OAAO,KAAK,CAAC;gBAC1E,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBACpE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,UAAU,KAAK,KAAK;oBAAE,OAAO,KAAK,CAAC;gBACnF,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,CACP,SAAS,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,uBAAuB,EAC1F,EAAE,QAAQ,EAAE,QAAQ,EAAE,CACvB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list_recordings.d.ts

@@ -0,0 +1,12 @@
+/**
+ * list_recordings: return the recordings made in a workspace.
+ *
+ * Metadata only: id, label, createdAt, durationMs, and the count of
+ * captured events. The actual event-stream blob endpoint stays out of
+ * Phase 1; downloading and replaying a session is a Phase 3 concern
+ * because it pairs naturally with transcript summarisation tools.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerListRecordings(server: McpServer, client: TypeletsClient, _env: Env): void;

package/dist/tools/list_recordings.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { ok, fail } from './_shared.js';
+export function registerListRecordings(server, client, _env) {
+    server.registerTool('list_recordings', {
+        title: 'List session recordings',
+        description: "Return every saved session recording for a workspace, metadata only. The recordings themselves stay out of the Phase 1 surface. Call out to the platform to replay them.",
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id.'),
+        },
+    }, async ({ workspaceId }) => {
+        try {
+            const { recordings } = await client.get(`/workspaces/${encodeURIComponent(workspaceId)}/recordings`);
+            return ok(`Found ${recordings.length} recording${recordings.length === 1 ? '' : 's'}.`, { recordings });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=list_recordings.js.map

package/dist/tools/list_recordings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_recordings.js","sourceRoot":"","sources":["../../src/tools/list_recordings.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAcxC,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,MAAsB,EACtB,IAAS;IAET,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,0KAA0K;QAC5K,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;SAC7D;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CACrC,eAAe,kBAAkB,CAAC,WAAW,CAAC,aAAa,CAC5D,CAAC;YACF,OAAO,EAAE,CACP,SAAS,UAAU,CAAC,MAAM,aAAa,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAC5E,EAAE,UAAU,EAAE,CACf,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list_workspace_files.d.ts

@@ -0,0 +1,15 @@
+/**
+ * list_workspace_files: walk a workspace's tree and return flat paths.
+ *
+ * Phase 1 calls the snapshot endpoint `GET /workspaces/:id/files` which
+ * the Typelets API exposes specifically for non-Yjs consumers (the
+ * collaborative tree is the source of truth; this endpoint returns a
+ * point-in-time materialised view of it).
+ *
+ * Returns file ids alongside paths so a follow-up `read_workspace_file`
+ * call can fetch contents by id (cheaper + immune to mid-call renames).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerListWorkspaceFiles(server: McpServer, client: TypeletsClient, _env: Env): void;

package/dist/tools/list_workspace_files.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { ok, fail } from './_shared.js';
+export function registerListWorkspaceFiles(server, client, _env) {
+    server.registerTool('list_workspace_files', {
+        title: 'List workspace files',
+        description: 'Return every file, folder, and whiteboard in a workspace as a flat list of slash-separated paths plus stable ids. Use the id with read_workspace_file to fetch contents.',
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id.'),
+            includeFolders: z
+                .boolean()
+                .optional()
+                .describe('Include folder + whiteboard entries. Default false: files only.'),
+        },
+    }, async ({ workspaceId, includeFolders }) => {
+        try {
+            const { files } = await client.get(`/workspaces/${encodeURIComponent(workspaceId)}/files`);
+            const filtered = includeFolders === true ? files : files.filter((f) => f.type === 'file');
+            return ok(`Found ${filtered.length} entr${filtered.length === 1 ? 'y' : 'ies'}.`, { files: filtered });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=list_workspace_files.js.map

package/dist/tools/list_workspace_files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_workspace_files.js","sourceRoot":"","sources":["../../src/tools/list_workspace_files.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAaxC,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,MAAsB,EACtB,IAAS;IAET,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,0KAA0K;QAC5K,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC5D,cAAc,EAAE,CAAC;iBACd,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,iEAAiE,CAAC;SAC/E;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAChC,eAAe,kBAAkB,CAAC,WAAW,CAAC,QAAQ,CACvD,CAAC;YACF,MAAM,QAAQ,GACZ,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;YAC3E,OAAO,EAAE,CACP,SAAS,QAAQ,CAAC,MAAM,QAAQ,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,EACtE,EAAE,KAAK,EAAE,QAAQ,EAAE,CACpB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list_workspaces.d.ts

@@ -0,0 +1,11 @@
+/**
+ * list_workspaces: return every workspace the caller can see.
+ *
+ * Includes the caller's role per workspace (owner/admin/editor/viewer)
+ * so the model can decide whether a follow-up write tool will be
+ * allowed before attempting it.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerListWorkspaces(server: McpServer, client: TypeletsClient, _env: Env): void;