Chronos Protocol

Instructions

Implementation Reference

• src/chronos_protocol/server.py:462-497 (handler)

  Core handler function in TimeServer class that ends an activity log: validates existence and status, records end time, computes duration, updates database with result/notes/status, and returns the updated ActivityLog object.

  def end_activity_log(
      self,
      activity_id: str,
      result: Optional[str] = None,
      notes: Optional[str] = None
  ) -> ActivityLog:
      """End an activity log and calculate duration"""
      log_data = self.db.get_activity_log(activity_id)
      if not log_data:
          raise ValueError(f"Activity log with ID {activity_id} not found")
  
      if log_data['status'] == 'completed':
          raise ValueError(f"Activity log with ID {activity_id} is already completed")
      
      end_time = datetime.now(ZoneInfo('UTC')).isoformat(timespec="seconds")
      start_time = datetime.fromisoformat(log_data['startTime'].replace('Z', '+00:00'))
      end_dt = datetime.fromisoformat(end_time.replace('Z', '+00:00'))
      
      duration_seconds = int((end_dt - start_time).total_seconds())
      duration_str = format_duration(duration_seconds)
      
      updates = {
          'endTime': end_time,
          'duration': duration_str,
          'durationSeconds': duration_seconds,
          'result': result,
          'notes': notes,
          'status': 'completed'
      }
      
      self.db.update_activity_log(activity_id, updates)
  
      # Return updated log
      updated_log_data = self.db.get_activity_log(activity_id)
      return ActivityLog(**updated_log_data)

• src/chronos_protocol/server.py:705-726 (registration)

  Tool registration in list_tools(): defines name 'end_activity_log', description, and input schema (activityId required, result/notes optional).

  Tool(
      name=TimeTools.END_ACTIVITY_LOG.value,
      description="End an activity log with system timestamp and calculate duration",
      inputSchema={
          "type": "object",
          "properties": {
              "activityId": {
                  "type": "string",
                  "description": "Unique identifier of the activity log to end",
              },
              "result": {
                  "type": "string",
                  "description": "Result or outcome of the activity",
              },
              "notes": {
                  "type": "string",
                  "description": "Detailed notes for traceability and session continuity. Include: what was accomplished, key decisions made, challenges encountered, solutions implemented, and any critical context for future reference. This enables other AI agents to understand your work, backtrack steps if issues arise, and continue development effectively. Be specific about code changes, architectural decisions, and debugging insights.",
              },
          },
          "required": ["activityId"],
      },
  ),

• src/chronos_protocol/server.py:889-898 (registration)

  Dispatch/registration in _execute_tool(): pattern matches tool name and calls TimeServer.end_activity_log with parsed arguments.

  case TimeTools.END_ACTIVITY_LOG.value:
      activity_id = arguments.get("activityId")
      if not activity_id:
          raise ValueError("Missing required argument: activityId")
  
      result = time_server.end_activity_log(
          activity_id,
          arguments.get("result"),
          arguments.get("notes"),
      )

• src/chronos_protocol/server.py:113-126 (schema)

  Pydantic schema/model for ActivityLog, used for input/output serialization and validation in end_activity_log and related operations.

  class ActivityLog(BaseModel):
      activityId: str  # Changed from timeId for better naming
      activityType: str
      task_scope: TaskScope
      description: Optional[str] = None
      tags: Optional[List[str]] = None
      startTime: str
      endTime: Optional[str] = None
      duration: Optional[str] = None
      durationSeconds: Optional[int] = None
      result: Optional[str] = None
      notes: Optional[str] = None
      status: str  # "started", "completed"

• src/chronos_protocol/server.py:80-80 (registration)

  Enum definition TimeTools.END_ACTIVITY_LOG providing the canonical tool name string.

  END_ACTIVITY_LOG = "end_activity_log"