add_member

[refactoring]

Inserts a C# member into an existing type and returns a diff.

Try it locally in the Glider playground

Parameters

Examples

Replace sample paths and symbol keys with values from your workspace.

Preview adding a method to a class

{
  "containerName": "OrderService",
  "memberCode": "public decimal Total() => 0m;",
  "applyChanges": false
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_member",
    "arguments": {
      "containerName": "OrderService",
      "memberCode": "public decimal Total() => 0m;",
      "applyChanges": false
    }
  }
}

{
  "success": true,
  "containerName": "MyProject.OrderService",
  "memberName": "Total",
  "memberKind": "Method",
  "filePath": "/path/to/OrderService.cs",
  "filesChanged": 1,
  "applied": false,
  "message": null,
  "diagnostics": {
    "errorCount": 0,
    "warningCount": 0,
    "items": []
  },
  "unifiedDiff": "...",
  "changedFiles": [
    {
      "filePath": "/path/to/OrderService.cs",
      "changeCount": 1
    }
  ]
}

Preview insertion into a discovered type

{
  "containerName": "<type key from find_code>",
  "memberCode": "public decimal Total() => 0m;",
  "applyChanges": false
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_member",
    "arguments": {
      "containerName": "<type key from find_code>",
      "memberCode": "public decimal Total() => 0m;",
      "applyChanges": false
    }
  }
}

Response Notes

The member text is parsed and validated before it is inserted, and only the inserted code is formatted, so the change lands indented in the body without reformatting the rest of the file. For a partial type, filePath chooses which part receives the member; by default the largest non-generated part is used.

Returns a unified diff of the insertion. containerName, memberName, and memberKind identify what was added, and filePath names the file that received it (the chosen part for a partial type). diagnostics reports the compile errors and warnings the inserted member introduces; when failOnErrors is true and it introduces an error, applied is false and message explains why. When the file is linked into several projects or targets, the check spans all of them.

Unreleased development builds after 13.4.0 return one unified diff by default; the example uses that contract. Follow the installed schema for supported parameters and defaults. Set includeDiff=false for compact output, with includePerFileDiff=false where supported. Set includePerFileDiff=true only when separate file diffs are needed; it works independently of includeDiff. These controls preserve application state, file metadata, counts, and any diagnostics, errors, conflicts, or limits the tool reports. Results use top-level fields with success. Compact is the default; full adds responseDiagnostics. Both modes retain errors, coverage, partial state, and recovery advice.

For a failed symbol-key request, success=false includes errorCode, parameter, error, and suggestions in compact, full, and batch operation results. Batch keeps a bounded summary outside the requested detail budget. If the hard server limit omits details, failureDetailsOmitted or writeStateOmitted identifies the omission. errorCode is invalid_symbol_key, symbol_not_found, ambiguous_symbol_key, wrong_symbol_kind, source_unavailable, unsupported_symbol, or invalid_arguments. Follow the suggestions for the specific failure. Correct the named selector for invalid_arguments. For symbol_not_found, repeat discovery in the selected workspace and pass a returned key unchanged. An absent identity does not prove that a key is stale.