coderswap_log_session_note
Record session summaries to maintain continuity across research projects by capturing key insights and progress markers for future reference.
Instructions
Record lightweight ingestion summary for session continuity (non-DSL)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| summary_text | Yes | ||
| job_id | No | ||
| ingestion_metrics | No | ||
| tags | No |
Input Schema (JSON Schema)
{
"properties": {
"ingestion_metrics": {},
"job_id": {
"type": "string"
},
"project_id": {
"minLength": 1,
"type": "string"
},
"summary_text": {
"minLength": 1,
"type": "string"
},
"tags": {}
},
"required": [
"project_id",
"summary_text"
],
"type": "object"
}
Implementation Reference
- src/index.ts:652-695 (handler)The asynchronous handler function that executes the core logic of the 'coderswap_log_session_note' tool. It checks for guardrail bypasses, generates a note ID, logs the session note details using the log utility, and returns structured output with success or error response.async ({ project_id, summary_text, job_id, ingestion_metrics, tags }) => { if (containsGuardrailBypass({ project_id, summary_text, job_id, ingestion_metrics, tags })) { return guardrailViolationResponse() } try { log('debug', 'Logging session note', { project_id, job_id }) // Generate a simple note ID const timestamp = new Date().toISOString() const note_id = `note_${Date.now()}` // Log the note (for now, just to console/debug) log('info', `Session note logged for project ${project_id}`, { note_id, summary_text, job_id, ingestion_metrics, tags }) const output = { note_id, project_id, timestamp } return { content: [{ type: 'text', text: `✓ Logged session note: ${summary_text.substring(0, 100)}${summary_text.length > 100 ? '...' : ''}` }], structuredContent: output } } catch (error) { log('error', 'Failed to log session note', { project_id, error: error instanceof Error ? error.message : error }) return { content: [{ type: 'text', text: `✗ Failed to log session note: ${error instanceof Error ? error.message : 'Unknown error'}` }], isError: true } } }
- src/index.ts:636-650 (schema)The inputSchema and outputSchema definitions using Zod for validating the tool's inputs (project_id, summary_text, etc.) and outputs (note_id, etc.). Includes title and description.{ title: 'Log Session Note', description: 'Record lightweight ingestion summary for session continuity (non-DSL)', inputSchema: { project_id: z.string().min(1, 'project_id is required'), summary_text: z.string().min(1, 'summary_text is required'), job_id: z.string().optional(), ingestion_metrics: z.any().optional(), tags: z.any().optional() }, outputSchema: { note_id: z.string(), project_id: z.string(), timestamp: z.string() }
- src/index.ts:634-696 (registration)The server.registerTool call that registers the 'coderswap_log_session_note' tool with the MCP server, providing the tool name, metadata/schemas, and handler function.server.registerTool( 'coderswap_log_session_note', { title: 'Log Session Note', description: 'Record lightweight ingestion summary for session continuity (non-DSL)', inputSchema: { project_id: z.string().min(1, 'project_id is required'), summary_text: z.string().min(1, 'summary_text is required'), job_id: z.string().optional(), ingestion_metrics: z.any().optional(), tags: z.any().optional() }, outputSchema: { note_id: z.string(), project_id: z.string(), timestamp: z.string() } }, async ({ project_id, summary_text, job_id, ingestion_metrics, tags }) => { if (containsGuardrailBypass({ project_id, summary_text, job_id, ingestion_metrics, tags })) { return guardrailViolationResponse() } try { log('debug', 'Logging session note', { project_id, job_id }) // Generate a simple note ID const timestamp = new Date().toISOString() const note_id = `note_${Date.now()}` // Log the note (for now, just to console/debug) log('info', `Session note logged for project ${project_id}`, { note_id, summary_text, job_id, ingestion_metrics, tags }) const output = { note_id, project_id, timestamp } return { content: [{ type: 'text', text: `✓ Logged session note: ${summary_text.substring(0, 100)}${summary_text.length > 100 ? '...' : ''}` }], structuredContent: output } } catch (error) { log('error', 'Failed to log session note', { project_id, error: error instanceof Error ? error.message : error }) return { content: [{ type: 'text', text: `✗ Failed to log session note: ${error instanceof Error ? error.message : 'Unknown error'}` }], isError: true } } } )