@knightcodeai/cli 0.20.0 → 0.21.1

package/docs/app-server.schema.json

@@ -160,6 +160,18 @@
 										"type": "string",
 										"const": "shuttingDown"
 									},
+									{
+										"type": "string",
+										"const": "approvalRequired"
+									},
+									{
+										"type": "string",
+										"const": "mcpUnavailable"
+									},
+									{
+										"type": "string",
+										"const": "fileChanged"
+									},
 									{
 										"type": "string",
 										"const": "internal"
@@ -2500,6 +2512,26 @@
 																	}
 																},
 																"$ref": "View"
+															},
+															"mcpApp": {
+																"type": "object",
+																"required": [
+																	"server",
+																	"resourceUri"
+																],
+																"properties": {
+																	"server": {
+																		"type": "string"
+																	},
+																	"resourceUri": {
+																		"type": "string"
+																	},
+																	"result": {},
+																	"resultOmitted": {
+																		"type": "boolean"
+																	}
+																},
+																"additionalProperties": false
 															}
 														},
 														"additionalProperties": false
@@ -3621,6 +3653,26 @@
 																}
 															},
 															"$ref": "View"
+														},
+														"mcpApp": {
+															"type": "object",
+															"required": [
+																"server",
+																"resourceUri"
+															],
+															"properties": {
+																"server": {
+																	"type": "string"
+																},
+																"resourceUri": {
+																	"type": "string"
+																},
+																"result": {},
+																"resultOmitted": {
+																	"type": "boolean"
+																}
+															},
+															"additionalProperties": false
 														}
 													},
 													"additionalProperties": false
@@ -4814,6 +4866,9 @@
 					},
 					"environment": {
 						"type": "string"
+					},
+					"dryRun": {
+						"type": "boolean"
 					}
 				},
 				"additionalProperties": false
@@ -5922,6 +5977,312 @@
 					},
 					"against": {
 						"type": "string"
+					},
+					"fromTree": {
+						"type": "string"
+					},
+					"toTree": {
+						"type": "string"
+					}
+				},
+				"additionalProperties": false
+			}
+		},
+		"thread/diff/file": {
+			"params": {
+				"type": "object",
+				"required": [
+					"threadId",
+					"fromTree",
+					"toTree",
+					"path"
+				],
+				"properties": {
+					"threadId": {
+						"type": "string"
+					},
+					"fromTree": {
+						"type": "string"
+					},
+					"toTree": {
+						"type": "string"
+					},
+					"path": {
+						"type": "string"
+					},
+					"oldPath": {
+						"type": "string"
+					}
+				},
+				"additionalProperties": false
+			},
+			"result": {
+				"type": "object",
+				"required": [
+					"binary",
+					"tooLarge"
+				],
+				"properties": {
+					"old": {
+						"type": "string"
+					},
+					"new": {
+						"type": "string"
+					},
+					"binary": {
+						"type": "boolean"
+					},
+					"tooLarge": {
+						"type": "boolean"
+					}
+				},
+				"additionalProperties": false
+			}
+		},
+		"mcp/app/readResource": {
+			"params": {
+				"type": "object",
+				"required": [
+					"threadId",
+					"server",
+					"uri"
+				],
+				"properties": {
+					"threadId": {
+						"type": "string"
+					},
+					"server": {
+						"type": "string"
+					},
+					"uri": {
+						"type": "string"
+					}
+				},
+				"additionalProperties": false
+			},
+			"result": {
+				"type": "object",
+				"required": [
+					"contents"
+				],
+				"properties": {
+					"contents": {
+						"type": "array",
+						"items": {}
+					},
+					"_meta": {
+						"type": "object",
+						"patternProperties": {
+							"^.*$": {}
+						}
+					}
+				},
+				"additionalProperties": false
+			}
+		},
+		"mcp/app/callTool": {
+			"params": {
+				"type": "object",
+				"required": [
+					"threadId",
+					"server",
+					"name"
+				],
+				"properties": {
+					"threadId": {
+						"type": "string"
+					},
+					"server": {
+						"type": "string"
+					},
+					"name": {
+						"type": "string"
+					},
+					"arguments": {
+						"type": "object",
+						"patternProperties": {
+							"^.*$": {}
+						}
+					},
+					"confirmed": {
+						"type": "boolean"
+					}
+				},
+				"additionalProperties": false
+			},
+			"result": {
+				"type": "object",
+				"required": [
+					"content"
+				],
+				"properties": {
+					"content": {
+						"type": "array",
+						"items": {}
+					},
+					"structuredContent": {},
+					"isError": {
+						"type": "boolean"
+					},
+					"_meta": {
+						"type": "object",
+						"patternProperties": {
+							"^.*$": {}
+						}
+					}
+				},
+				"additionalProperties": false
+			}
+		},
+		"file/read": {
+			"params": {
+				"type": "object",
+				"required": [
+					"threadId",
+					"path"
+				],
+				"properties": {
+					"threadId": {
+						"type": "string"
+					},
+					"path": {
+						"type": "string"
+					},
+					"maxBytes": {
+						"type": "integer",
+						"minimum": 1,
+						"maximum": 8388608
+					}
+				},
+				"additionalProperties": false
+			},
+			"result": {
+				"type": "object",
+				"required": [
+					"path",
+					"size",
+					"binary",
+					"tooLarge",
+					"mtimeMs"
+				],
+				"properties": {
+					"path": {
+						"type": "string"
+					},
+					"size": {
+						"type": "number"
+					},
+					"binary": {
+						"type": "boolean"
+					},
+					"tooLarge": {
+						"type": "boolean"
+					},
+					"text": {
+						"type": "string"
+					},
+					"mtimeMs": {
+						"type": "number"
+					}
+				},
+				"additionalProperties": false
+			}
+		},
+		"file/list": {
+			"params": {
+				"type": "object",
+				"required": [
+					"threadId"
+				],
+				"properties": {
+					"threadId": {
+						"type": "string"
+					},
+					"path": {
+						"type": "string"
+					}
+				},
+				"additionalProperties": false
+			},
+			"result": {
+				"type": "object",
+				"required": [
+					"root",
+					"entries",
+					"truncated"
+				],
+				"properties": {
+					"root": {
+						"type": "string"
+					},
+					"entries": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"required": [
+								"path",
+								"type"
+							],
+							"properties": {
+								"path": {
+									"type": "string"
+								},
+								"type": {
+									"anyOf": [
+										{
+											"type": "string",
+											"const": "file"
+										},
+										{
+											"type": "string",
+											"const": "directory"
+										}
+									]
+								}
+							},
+							"additionalProperties": false
+						}
+					},
+					"truncated": {
+						"type": "boolean"
+					}
+				},
+				"additionalProperties": false
+			}
+		},
+		"file/write": {
+			"params": {
+				"type": "object",
+				"required": [
+					"threadId",
+					"path",
+					"text"
+				],
+				"properties": {
+					"threadId": {
+						"type": "string"
+					},
+					"path": {
+						"type": "string"
+					},
+					"text": {
+						"type": "string",
+						"maxLength": 8388608
+					},
+					"expectedMtimeMs": {
+						"type": "number"
+					}
+				},
+				"additionalProperties": false
+			},
+			"result": {
+				"type": "object",
+				"required": [
+					"mtimeMs"
+				],
+				"properties": {
+					"mtimeMs": {
+						"type": "number"
 					}
 				},
 				"additionalProperties": false
@@ -6082,6 +6443,38 @@
 				"additionalProperties": false
 			}
 		},
+		"git/origin": {
+			"params": {
+				"type": "object",
+				"required": [
+					"threadId"
+				],
+				"properties": {
+					"threadId": {
+						"type": "string"
+					}
+				},
+				"additionalProperties": false
+			},
+			"result": {
+				"type": "object",
+				"required": [
+					"root"
+				],
+				"properties": {
+					"root": {
+						"type": "string"
+					},
+					"url": {
+						"type": "string"
+					},
+					"branch": {
+						"type": "string"
+					}
+				},
+				"additionalProperties": false
+			}
+		},
 		"git/stage": {
 			"params": {
 				"type": "object",
@@ -7671,6 +8064,26 @@
 																	}
 																},
 																"$ref": "View"
+															},
+															"mcpApp": {
+																"type": "object",
+																"required": [
+																	"server",
+																	"resourceUri"
+																],
+																"properties": {
+																	"server": {
+																		"type": "string"
+																	},
+																	"resourceUri": {
+																		"type": "string"
+																	},
+																	"result": {},
+																	"resultOmitted": {
+																		"type": "boolean"
+																	}
+																},
+																"additionalProperties": false
 															}
 														},
 														"additionalProperties": false
@@ -8792,6 +9205,26 @@
 																}
 															},
 															"$ref": "View"
+														},
+														"mcpApp": {
+															"type": "object",
+															"required": [
+																"server",
+																"resourceUri"
+															],
+															"properties": {
+																"server": {
+																	"type": "string"
+																},
+																"resourceUri": {
+																	"type": "string"
+																},
+																"result": {},
+																"resultOmitted": {
+																	"type": "boolean"
+																}
+															},
+															"additionalProperties": false
 														}
 													},
 													"additionalProperties": false
@@ -13323,6 +13756,26 @@
 													}
 												},
 												"$ref": "View"
+											},
+											"mcpApp": {
+												"type": "object",
+												"required": [
+													"server",
+													"resourceUri"
+												],
+												"properties": {
+													"server": {
+														"type": "string"
+													},
+													"resourceUri": {
+														"type": "string"
+													},
+													"result": {},
+													"resultOmitted": {
+														"type": "boolean"
+													}
+												},
+												"additionalProperties": false
 											}
 										},
 										"additionalProperties": false
@@ -14493,6 +14946,26 @@
 												}
 											},
 											"$ref": "View"
+										},
+										"mcpApp": {
+											"type": "object",
+											"required": [
+												"server",
+												"resourceUri"
+											],
+											"properties": {
+												"server": {
+													"type": "string"
+												},
+												"resourceUri": {
+													"type": "string"
+												},
+												"result": {},
+												"resultOmitted": {
+													"type": "boolean"
+												}
+											},
+											"additionalProperties": false
 										}
 									},
 									"additionalProperties": false
@@ -15481,6 +15954,26 @@
 												}
 											},
 											"$ref": "View"
+										},
+										"mcpApp": {
+											"type": "object",
+											"required": [
+												"server",
+												"resourceUri"
+											],
+											"properties": {
+												"server": {
+													"type": "string"
+												},
+												"resourceUri": {
+													"type": "string"
+												},
+												"result": {},
+												"resultOmitted": {
+													"type": "boolean"
+												}
+											},
+											"additionalProperties": false
 										}
 									},
 									"additionalProperties": false

package/docs/cli.md

@@ -13,7 +13,7 @@ knightcode update [target] [options]
 knightcode list
 knightcode config [options]
 knightcode auth <check|print-api-key|print-bearer-token> [options]
-knightcode mcp <list|login|logout> [options]
+knightcode mcp <add|remove|list|login|logout> [options]
 knightcode app-server [-e <extension>]... [--session-dir <dir>]
 ```
 
@@ -167,7 +167,7 @@ The MCP resource tools (`list_mcp_resources`, `list_mcp_resource_templates`, `re
 
 The [web tools](usage.md#web-tools) `webfetch` and `websearch` and the [question tool](usage.md#questions) `ask_user` are off until enabled with `/tools` or named here. A tool excluded here stays off whatever `/tools` says, and one turned off with `/tools` stays off even when named here.
 
-Built-in extensions add two more tools. They are off by default; the MCP extension turns them on when an MCP server needs them (see [MCP](mcp.md#exposure)). To enable them yourself, name them in `--tools` or `defaultTools`.
+Built-in extensions add two more tools. They are off by default; the MCP extension turns them on when an MCP server needs them (see [MCP](mcp.md#control-tool-exposure)). To enable them yourself, name them in `--tools` or `defaultTools`.
 
 | Built-in extension | Purpose |
 |---|---|
@@ -388,6 +388,6 @@ These commands work outside a session, so agents can run them through `bash`. Se
 | `knightcode mcp login <server> [--timeout <seconds>]` | Sign in to an OAuth server: open the authorization page and wait for the browser; a terminal also accepts the pasted redirect URL. `--timeout` limits the whole sign-in, including requests to the authorization server (default 300 seconds) |
 | `knightcode mcp logout <server>` | Delete the stored OAuth credentials of a server |
 
-`add` and `remove` change `~/.knightcode/agent/mcp.json`, or `.knightcode/mcp.json` in the current directory with `--local` (`-l`). `add` also takes `--exposure <mode>` (see [Exposure](mcp.md#exposure)) and `--description <text>` and does not connect; run `knightcode mcp list` to check the server.
+`add` and `remove` change `~/.knightcode/agent/mcp.json`, or `.knightcode/mcp.json` in the current directory with `--local` (`-l`). `add` also takes `--exposure <mode>` (see [Exposure](mcp.md#control-tool-exposure)) and `--description <text>` and does not connect; run `knightcode mcp list` to check the server.
 
 Project `.knightcode/mcp.json` files are only read for projects that are already trusted.

package/docs/custom-provider.md

@@ -138,6 +138,8 @@ An OAuth provider supplies a display name, login flow, token refresh, and access
 
 OAuth callbacks are UI-neutral. They can open an authorization URL, show a device code, report progress, request input, or ask the user to choose a login method. Honor cancellation and the supplied abort signal during network requests.
 
+Press Enter (`tui.select.confirm`) to open the device-login URL and copy the code, or log in manually. Providers can disable either action with `openBrowserOnConfirm: false` or `copyCodeOnConfirm: false` in `onDeviceCode` or native `AuthEvent` notifications.
+
 Never write access tokens, refresh tokens, authorization headers, or complete provider responses to ordinary logs.
 
 ## Supply and refresh models