@typelets/mcp 0.2.0 → 0.4.0

package/README.md

@@ -110,6 +110,29 @@ Profiles:
 
 Tools marked `destructive` carry the MCP `destructiveHint: true` annotation so host clients (Claude Desktop, Cline, Cursor) prompt the user before invocation.
 
+### Session intelligence (3 tools, interviewer profile only)
+
+| Tool | Reads | Input |
+| --- | --- | --- |
+| `summarize_recording` | `GET /workspaces/:id/recordings/:rid/timeline?mode=summary` | `workspaceId`, `recordingId` |
+| `score_against_rubric` | `GET /workspaces/:id/recordings/:rid/timeline?mode=score` | `workspaceId`, `recordingId` |
+| `suggest_followup_questions` | `GET /workspaces/:id/recordings/active/timeline` | `workspaceId` |
+
+Each tool returns a structured timeline (per-file content checkpoints sampled across the session + chronological Run-button events) so the host LLM can write the prose summary, score, or follow-up questions itself. `score_against_rubric` also attaches the workspace's inline rubric + criteria; calls against a workspace with no applied problem return a friendly error pointing the user to `apply_problem_to_workspace`. `suggest_followup_questions` operates on the workspace's currently-active recording (last 5 minutes), and surfaces a clear error if no recording is in progress.
+
+### Completeness: file/folder + lifecycle (6 tools)
+
+| Tool | Writes | Profile | `destructive` |
+| --- | --- | --- | --- |
+| `move_path` | `POST /workspaces/:id/move` | both | |
+| `create_folder` | `POST /workspaces/:id/folders` | both | |
+| `delete_folder` | `DELETE /workspaces/:id/folders/:folderId` | both | ✓ |
+| `append_to_file` | `PATCH /workspaces/:id/files/:fileId/append` | both | |
+| `delete_workspace` | `DELETE /workspaces/:id` | interviewer only | ✓ |
+| `whoami` | `GET /auth/me` | both | |
+
+`move_path` renames or moves any node (file or folder) to a full destination path, creating intermediate folders as needed; it rejects moving a folder into its own subtree. `create_folder` makes an empty folder (idempotent). `delete_folder` removes a folder and everything under it. `append_to_file` adds to the end of a file without re-sending its content. `delete_workspace` is interviewer-only and owner-gated by the API. `whoami` reports the identity + profile the server is running as.
+
 ## Layout
 
 ```

package/dist/index.js

@@ -11,7 +11,7 @@
  *
  * Phase 2 write tools are profile-gated at registration time.
  * interviewer-only tools are not registered when TYPELETS_PROFILE=candidate.
- * Phase 3 (session intelligence) lands in a later minor release.
+ * Phase 3 session-intelligence tools are also profile-gated at registration.
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -33,6 +33,15 @@ import { registerApplyProblemToWorkspace } from './tools/apply_problem_to_worksp
 import { registerSaveProblemToLibrary } from './tools/save_problem_to_library.js';
 import { registerEditProblem } from './tools/edit_problem.js';
 import { registerDeleteProblem } from './tools/delete_problem.js';
+import { registerSummarizeRecording } from './tools/summarize_recording.js';
+import { registerScoreAgainstRubric } from './tools/score_against_rubric.js';
+import { registerSuggestFollowupQuestions } from './tools/suggest_followup_questions.js';
+import { registerMovePath } from './tools/move_path.js';
+import { registerCreateFolder } from './tools/create_folder.js';
+import { registerDeleteFolder } from './tools/delete_folder.js';
+import { registerAppendToFile } from './tools/append_to_file.js';
+import { registerDeleteWorkspace } from './tools/delete_workspace.js';
+import { registerWhoami } from './tools/whoami.js';
 async function main() {
     const env = readEnv();
     const client = createClient(env);
@@ -64,6 +73,17 @@ async function main() {
     registerSaveProblemToLibrary(server, client, env);
     registerEditProblem(server, client, env);
     registerDeleteProblem(server, client, env);
+    // Phase 3 session-intelligence tools (interviewer-only).
+    registerSummarizeRecording(server, client, env);
+    registerScoreAgainstRubric(server, client, env);
+    registerSuggestFollowupQuestions(server, client, env);
+    // Phase 2.2 completeness tools (delete_workspace is interviewer-only).
+    registerMovePath(server, client, env);
+    registerCreateFolder(server, client, env);
+    registerDeleteFolder(server, client, env);
+    registerAppendToFile(server, client, env);
+    registerDeleteWorkspace(server, client, env);
+    registerWhoami(server, client, env);
     const transport = new StdioServerTransport();
     await server.connect(transport);
     // Log to stderr (stdout is the MCP transport). Surfaces in the client's

package/dist/index.js.map

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

package/dist/profile.js

@@ -14,6 +14,10 @@ export const INTERVIEWER_ONLY_TOOLS = new Set([
     'save_problem_to_library',
     'edit_problem',
     'delete_problem',
+    'summarize_recording',
+    'score_against_rubric',
+    'suggest_followup_questions',
+    'delete_workspace',
 ]);
 export function toolAllowedForProfile(toolName, profile) {
     if (profile === 'interviewer')

package/dist/profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC;IACjE,kBAAkB;IAClB,4BAA4B;IAC5B,yBAAyB;IACzB,cAAc;IACd,gBAAgB;CACjB,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,OAAuB;IAC7E,IAAI,OAAO,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAU,EACV,GAAQ;IAER,IAAI,GAAG,CAAC,OAAO,KAAK,aAAa;QAAE,OAAO,OAAO,CAAC;IAClD,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAC5B,OAAO,IAAI,CAAC,MAAM,CAAC;IACnB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACrB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACrB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC;IACjE,kBAAkB;IAClB,4BAA4B;IAC5B,yBAAyB;IACzB,cAAc;IACd,gBAAgB;IAChB,qBAAqB;IACrB,sBAAsB;IACtB,4BAA4B;IAC5B,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,OAAuB;IAC7E,IAAI,OAAO,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAU,EACV,GAAQ;IAER,IAAI,GAAG,CAAC,OAAO,KAAK,aAAa;QAAE,OAAO,OAAO,CAAC;IAClD,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAC5B,OAAO,IAAI,CAAC,MAAM,CAAC;IACnB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACrB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACrB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/append_to_file.d.ts

@@ -0,0 +1,8 @@
+/**
+ * append_to_file: append text to the end of a file without re-sending the
+ * whole content. Both profiles.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerAppendToFile(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/append_to_file.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerAppendToFile(server, client, env) {
+    if (!toolAllowedForProfile('append_to_file', env.profile))
+        return;
+    server.registerTool('append_to_file', {
+        title: 'Append to a file',
+        description: 'Append text to the end of an existing file without re-sending its full content. Get fileId from list_workspace_files. The file must already exist (use create_file otherwise).',
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id.'),
+            fileId: z.string().min(1).describe('The file id from list_workspace_files.'),
+            text: z.string().min(1).describe('Text to append at the end of the file.'),
+        },
+        annotations: { destructiveHint: false },
+    }, async ({ workspaceId, fileId, text }) => {
+        try {
+            const out = await client.patch(`/workspaces/${encodeURIComponent(workspaceId)}/files/${encodeURIComponent(fileId)}/append`, { text });
+            return ok(`Appended to file (${out.bytes} bytes total).`, out);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=append_to_file.js.map

package/dist/tools/append_to_file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"append_to_file.js","sourceRoot":"","sources":["../../src/tools/append_to_file.ts"],"names":[],"mappings":"AAKA,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;AAOxC,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAsB,EAAE,GAAQ;IACtF,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAElE,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,gLAAgL;QAClL,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC5D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YAC5E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SAC3E;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KACxC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAC5B,eAAe,kBAAkB,CAAC,WAAW,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAC3F,EAAE,IAAI,EAAE,CACT,CAAC;YACF,OAAO,EAAE,CAAC,qBAAqB,GAAG,CAAC,KAAK,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACjE,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_folder.d.ts

@@ -0,0 +1,8 @@
+/**
+ * create_folder: create an empty folder (with intermediate folders) at a path.
+ * Idempotent if the folder already exists. Both profiles.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerCreateFolder(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/create_folder.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerCreateFolder(server, client, env) {
+    if (!toolAllowedForProfile('create_folder', env.profile))
+        return;
+    server.registerTool('create_folder', {
+        title: 'Create a folder',
+        description: 'Create an empty folder at a slash-separated path; intermediate folders are created as needed. Idempotent if the folder already exists. Errors if a file occupies the path.',
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id.'),
+            path: z.string().min(1).describe('Folder path, e.g. "src/lib".'),
+        },
+        annotations: { destructiveHint: false },
+    }, async ({ workspaceId, path }) => {
+        try {
+            const out = await client.post(`/workspaces/${encodeURIComponent(workspaceId)}/folders`, { path });
+            return ok(`Created folder ${out.path}.`, out);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=create_folder.js.map

package/dist/tools/create_folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_folder.js","sourceRoot":"","sources":["../../src/tools/create_folder.ts"],"names":[],"mappings":"AAKA,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,oBAAoB,CAAC,MAAiB,EAAE,MAAsB,EAAE,GAAQ;IACtF,IAAI,CAAC,qBAAqB,CAAC,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAEjE,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,4KAA4K;QAC9K,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;SACjE;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KACxC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAC3B,eAAe,kBAAkB,CAAC,WAAW,CAAC,UAAU,EACxD,EAAE,IAAI,EAAE,CACT,CAAC;YACF,OAAO,EAAE,CAAC,kBAAkB,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;QAChD,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_folder.d.ts

@@ -0,0 +1,8 @@
+/**
+ * delete_folder: recursively delete a folder and everything under it.
+ * Destructive. Both profiles (editors manage their own tree).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerDeleteFolder(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/delete_folder.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerDeleteFolder(server, client, env) {
+    if (!toolAllowedForProfile('delete_folder', env.profile))
+        return;
+    server.registerTool('delete_folder', {
+        title: 'Delete a folder (recursive)',
+        description: 'Permanently delete a folder and ALL files and subfolders inside it. Get folderId from list_workspace_files with includeFolders=true. This cannot be undone.',
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id.'),
+            folderId: z
+                .string()
+                .min(1)
+                .describe('The folder id from list_workspace_files (includeFolders=true).'),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ workspaceId, folderId }) => {
+        try {
+            const out = await client.delete(`/workspaces/${encodeURIComponent(workspaceId)}/folders/${encodeURIComponent(folderId)}`);
+            return ok(`Deleted folder and ${out.deleted} item(s).`, out);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=delete_folder.js.map

package/dist/tools/delete_folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_folder.js","sourceRoot":"","sources":["../../src/tools/delete_folder.ts"],"names":[],"mappings":"AAKA,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;AAMxC,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAsB,EAAE,GAAQ;IACtF,IAAI,CAAC,qBAAqB,CAAC,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAEjE,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,6JAA6J;QAC/J,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC5D,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,gEAAgE,CAAC;SAC9E;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAC7B,eAAe,kBAAkB,CAAC,WAAW,CAAC,YAAY,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CACzF,CAAC;YACF,OAAO,EAAE,CAAC,sBAAsB,GAAG,CAAC,OAAO,WAAW,EAAE,GAAG,CAAC,CAAC;QAC/D,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_workspace.d.ts

@@ -0,0 +1,9 @@
+/**
+ * delete_workspace: permanently delete a workspace. Interviewer-only and
+ * destructive. Wraps the existing owner-gated DELETE /workspaces/:id (the api
+ * returns 403 if the caller is not the owner).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerDeleteWorkspace(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/delete_workspace.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerDeleteWorkspace(server, client, env) {
+    if (!toolAllowedForProfile('delete_workspace', env.profile))
+        return;
+    server.registerTool('delete_workspace', {
+        title: 'Delete a workspace',
+        description: 'Permanently delete a workspace and all its files, recordings, and members. Only the workspace owner can do this. This cannot be undone.',
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id to permanently delete.'),
+        },
+        annotations: { destructiveHint: true },
+    }, async ({ workspaceId }) => {
+        try {
+            await client.delete(`/workspaces/${encodeURIComponent(workspaceId)}`);
+            return ok('Workspace deleted.', { workspaceId, deleted: true });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=delete_workspace.js.map

package/dist/tools/delete_workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_workspace.js","sourceRoot":"","sources":["../../src/tools/delete_workspace.ts"],"names":[],"mappings":"AAMA,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,uBAAuB,CACrC,MAAiB,EACjB,MAAsB,EACtB,GAAQ;IAER,IAAI,CAAC,qBAAqB,CAAC,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAEpE,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,yIAAyI;QAC3I,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;SACnF;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;KACvC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,CAAO,eAAe,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC5E,OAAO,EAAE,CAAC,oBAAoB,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/move_path.d.ts

@@ -0,0 +1,9 @@
+/**
+ * move_path: rename or move a file/folder to a new path. The destination's
+ * parent folders are created as needed. Works on files and folders alike.
+ * Available to both profiles (editors manage their own tree).
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerMovePath(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/move_path.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerMovePath(server, client, env) {
+    if (!toolAllowedForProfile('move_path', env.profile))
+        return;
+    server.registerTool('move_path', {
+        title: 'Move or rename a file or folder',
+        description: 'Move or rename a node (file OR folder) to a new full path. Parent folders are created as needed. Get nodeId from list_workspace_files (use includeFolders for folders). Moving a folder into its own subtree is rejected.',
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id.'),
+            nodeId: z.string().min(1).describe('The file or folder id from list_workspace_files.'),
+            destinationPath: z
+                .string()
+                .min(1)
+                .describe('Full destination path, e.g. "src/lib/auth.ts".'),
+        },
+        annotations: { destructiveHint: false },
+    }, async ({ workspaceId, nodeId, destinationPath }) => {
+        try {
+            const out = await client.post(`/workspaces/${encodeURIComponent(workspaceId)}/files/move`, { nodeId, destinationPath });
+            return ok(`Moved to ${out.path}.`, out);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=move_path.js.map

package/dist/tools/move_path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move_path.js","sourceRoot":"","sources":["../../src/tools/move_path.ts"],"names":[],"mappings":"AAMA,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,gBAAgB,CAAC,MAAiB,EAAE,MAAsB,EAAE,GAAQ;IAClF,IAAI,CAAC,qBAAqB,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAE7D,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,2NAA2N;QAC7N,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC5D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;YACtF,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,gDAAgD,CAAC;SAC9D;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KACxC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAC3B,eAAe,kBAAkB,CAAC,WAAW,CAAC,aAAa,EAC3D,EAAE,MAAM,EAAE,eAAe,EAAE,CAC5B,CAAC;YACF,OAAO,EAAE,CAAC,YAAY,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/score_against_rubric.d.ts

@@ -0,0 +1,18 @@
+/**
+ * score_against_rubric: return a structured timeline plus the workspace's
+ * inline interview rubric + criteria so the host LLM can score the
+ * candidate against per-criterion.
+ *
+ * Workspaces with no inline rubric or criteria are not scorable - the
+ * apply-problem handler copies rubric/criteria onto the workspace
+ * directly; bare workspaces have nothing meaningful to score against.
+ * The api returns 404 + code=no_source_problem in that case, which we
+ * translate to a friendly error so the host LLM nudges the user to
+ * apply or save a problem first.
+ *
+ * Interviewer-only.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerScoreAgainstRubric(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/score_against_rubric.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { TypeletsApiError } from '../client.js';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+function isNoSourceProblem(err) {
+    return (err instanceof TypeletsApiError &&
+        err.status === 404 &&
+        err.body !== null &&
+        typeof err.body === 'object' &&
+        err.body.code === 'no_source_problem');
+}
+export function registerScoreAgainstRubric(server, client, env) {
+    if (!toolAllowedForProfile('score_against_rubric', env.profile))
+        return;
+    server.registerTool('score_against_rubric', {
+        title: 'Score a recording against the rubric',
+        description: "Fetch the structured timeline of a recording plus the workspace's inline interview rubric + criteria, so the host LLM can score the candidate per criterion. Only works on workspaces that have a problem applied (use apply_problem_to_workspace or save_problem_to_library first if needed).",
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id.'),
+            recordingId: z
+                .string()
+                .min(1)
+                .describe('The recording id from list_recordings.'),
+        },
+        annotations: { destructiveHint: false },
+    }, async ({ workspaceId, recordingId }) => {
+        try {
+            const payload = await client.get(`/workspaces/${encodeURIComponent(workspaceId)}/recordings/${encodeURIComponent(recordingId)}/timeline?mode=score&samples=10`);
+            const summary = `Loaded recording ${recordingId} and rubric for workspace ${payload.workspace.name} (${payload.problem.criteria.length} criteria).`;
+            return ok(summary, payload);
+        }
+        catch (err) {
+            if (isNoSourceProblem(err)) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'This workspace is not derived from a problem (no rubric or criteria attached), so there is no rubric to score against. Apply a problem to the workspace first.',
+                        },
+                    ],
+                    structuredContent: { error: { code: 'no_source_problem' } },
+                };
+            }
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=score_against_rubric.js.map

package/dist/tools/score_against_rubric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score_against_rubric.js","sourceRoot":"","sources":["../../src/tools/score_against_rubric.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAexC,SAAS,iBAAiB,CAAC,GAAY;IACrC,OAAO,CACL,GAAG,YAAY,gBAAgB;QAC/B,GAAG,CAAC,MAAM,KAAK,GAAG;QAClB,GAAG,CAAC,IAAI,KAAK,IAAI;QACjB,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC3B,GAAG,CAAC,IAA0B,CAAC,IAAI,KAAK,mBAAmB,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,MAAsB,EACtB,GAAQ;IAER,IAAI,CAAC,qBAAqB,CAAC,sBAAsB,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAExE,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sCAAsC;QAC7C,WAAW,EACT,gSAAgS;QAClS,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC5D,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,wCAAwC,CAAC;SACtD;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KACxC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAC9B,eAAe,kBAAkB,CAAC,WAAW,CAAC,eAAe,kBAAkB,CAAC,WAAW,CAAC,iCAAiC,CAC9H,CAAC;YACF,MAAM,OAAO,GAAG,oBAAoB,WAAW,6BAA6B,OAAO,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,aAAa,CAAC;YACpJ,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,gKAAgK;yBACvK;qBACF;oBACD,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE;iBAC5D,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/suggest_followup_questions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * suggest_followup_questions: return a structured slice of the workspace's
+ * ACTIVE recording (last 5 minutes of activity + current file state) so the
+ * host LLM can propose questions for the interviewer to ask next.
+ *
+ * The api resolves the active recording for us; the tool takes only the
+ * workspaceId. 404 with code=no_active_recording means the interviewer
+ * hasn't started recording the session yet.
+ *
+ * Interviewer-only.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerSuggestFollowupQuestions(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/suggest_followup_questions.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { TypeletsApiError } from '../client.js';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+function isNoActiveRecording(err) {
+    return (err instanceof TypeletsApiError &&
+        err.status === 404 &&
+        err.body !== null &&
+        typeof err.body === 'object' &&
+        err.body.code === 'no_active_recording');
+}
+export function registerSuggestFollowupQuestions(server, client, env) {
+    if (!toolAllowedForProfile('suggest_followup_questions', env.profile))
+        return;
+    server.registerTool('suggest_followup_questions', {
+        title: 'Suggest follow-up questions for the active recording',
+        description: "Fetch the last 5 minutes of activity from the workspace's active recording plus current file state, so the host LLM can suggest 2-3 follow-up questions the interviewer might ask. Requires an active recording; start one with the interview panel first.",
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id.'),
+        },
+        annotations: { destructiveHint: false },
+    }, async ({ workspaceId }) => {
+        try {
+            const payload = await client.get(`/workspaces/${encodeURIComponent(workspaceId)}/recordings/active/timeline?samples=6`);
+            const summary = `Loaded live timeline for workspace ${payload.workspace.name} (${payload.files.length} files in view).`;
+            return ok(summary, payload);
+        }
+        catch (err) {
+            if (isNoActiveRecording(err)) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No active recording in this workspace. Start a recording with the interview panel first.',
+                        },
+                    ],
+                    structuredContent: { error: { code: 'no_active_recording' } },
+                };
+            }
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=suggest_followup_questions.js.map

package/dist/tools/suggest_followup_questions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest_followup_questions.js","sourceRoot":"","sources":["../../src/tools/suggest_followup_questions.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAUxC,SAAS,mBAAmB,CAAC,GAAY;IACvC,OAAO,CACL,GAAG,YAAY,gBAAgB;QAC/B,GAAG,CAAC,MAAM,KAAK,GAAG;QAClB,GAAG,CAAC,IAAI,KAAK,IAAI;QACjB,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAC3B,GAAG,CAAC,IAA0B,CAAC,IAAI,KAAK,qBAAqB,CAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,MAAiB,EACjB,MAAsB,EACtB,GAAQ;IAER,IAAI,CAAC,qBAAqB,CAAC,4BAA4B,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAE9E,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,sDAAsD;QAC7D,WAAW,EACT,4PAA4P;QAC9P,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;SAC7D;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KACxC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAC9B,eAAe,kBAAkB,CAAC,WAAW,CAAC,uCAAuC,CACtF,CAAC;YACF,MAAM,OAAO,GAAG,sCAAsC,OAAO,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,kBAAkB,CAAC;YACxH,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,0FAA0F;yBACjG;qBACF;oBACD,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,EAAE;iBAC9D,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/summarize_recording.d.ts

@@ -0,0 +1,13 @@
+/**
+ * summarize_recording: return a structured timeline of a frozen recording.
+ *
+ * The host LLM consumes the JSON and writes the actual prose summary. The
+ * tool itself just calls the api's /timeline?mode=summary endpoint and
+ * passes the response through.
+ *
+ * Interviewer-only.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerSummarizeRecording(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/summarize_recording.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerSummarizeRecording(server, client, env) {
+    if (!toolAllowedForProfile('summarize_recording', env.profile))
+        return;
+    server.registerTool('summarize_recording', {
+        title: 'Summarize a recording',
+        description: 'Fetch a structured timeline of a recorded interview session for the host LLM to summarize. Includes per-file content checkpoints sampled across the session and a chronological list of Run-button invocations. Use list_recordings first to obtain the recordingId.',
+        inputSchema: {
+            workspaceId: z.string().min(1).describe('The workspace id.'),
+            recordingId: z
+                .string()
+                .min(1)
+                .describe('The recording id from list_recordings.'),
+        },
+        annotations: { destructiveHint: false },
+    }, async ({ workspaceId, recordingId }) => {
+        try {
+            const payload = await client.get(`/workspaces/${encodeURIComponent(workspaceId)}/recordings/${encodeURIComponent(recordingId)}/timeline?mode=summary&samples=10`);
+            const summary = `Loaded recording ${recordingId} for workspace ${payload.workspace.name} (${payload.runs.length} runs across ${payload.files.length} files, ${payload.recording.durationMs}ms).`;
+            return ok(summary, payload);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=summarize_recording.js.map

package/dist/tools/summarize_recording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize_recording.js","sourceRoot":"","sources":["../../src/tools/summarize_recording.ts"],"names":[],"mappings":"AAUA,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;AAUxC,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,MAAsB,EACtB,GAAQ;IAER,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAEvE,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,sQAAsQ;QACxQ,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC5D,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,wCAAwC,CAAC;SACtD;QACD,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KACxC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAC9B,eAAe,kBAAkB,CAAC,WAAW,CAAC,eAAe,kBAAkB,CAAC,WAAW,CAAC,mCAAmC,CAChI,CAAC;YACF,MAAM,OAAO,GAAG,oBAAoB,WAAW,kBAAkB,OAAO,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,gBAAgB,OAAO,CAAC,KAAK,CAAC,MAAM,WAAW,OAAO,CAAC,SAAS,CAAC,UAAU,MAAM,CAAC;YACjM,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/whoami.d.ts

@@ -0,0 +1,9 @@
+/**
+ * whoami: return the authenticated caller's identity. Wraps GET /auth/me so
+ * the host LLM can confirm which account + profile it's operating as. Both
+ * profiles.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TypeletsClient } from '../client.js';
+import type { Env } from '../env.js';
+export declare function registerWhoami(server: McpServer, client: TypeletsClient, env: Env): void;

package/dist/tools/whoami.js

@@ -0,0 +1,25 @@
+import { toolAllowedForProfile } from '../profile.js';
+import { ok, fail } from './_shared.js';
+export function registerWhoami(server, client, env) {
+    if (!toolAllowedForProfile('whoami', env.profile))
+        return;
+    server.registerTool('whoami', {
+        title: 'Who am I',
+        description: 'Return the authenticated caller identity (id, email, display name) for the PAT this server is using, plus the active profile. Use to confirm which account you are operating as.',
+        inputSchema: {},
+        annotations: { destructiveHint: false },
+    }, async () => {
+        try {
+            const me = await client.get('/auth/me');
+            const who = me.displayName ?? me.email ?? me.id;
+            return ok(`Authenticated as ${who} (profile: ${env.profile}).`, {
+                ...me,
+                profile: env.profile,
+            });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+}
+//# sourceMappingURL=whoami.js.map

package/dist/tools/whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../src/tools/whoami.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AASxC,MAAM,UAAU,cAAc,CAAC,MAAiB,EAAE,MAAsB,EAAE,GAAQ;IAChF,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAE1D,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;QACE,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,kLAAkL;QACpL,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KACxC,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAa,UAAU,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,CAAC,oBAAoB,GAAG,cAAc,GAAG,CAAC,OAAO,IAAI,EAAE;gBAC9D,GAAG,EAAE;gBACL,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typelets/mcp",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Model Context Protocol server for Typelets. Wraps the Typelets API as tools an MCP-capable LLM client can call.",
   "type": "module",
   "bin": {