@experiture/xyra-cli 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/README.md +119 -0
  2. package/dist/auth/browser.js +22 -0
  3. package/dist/auth/browser.js.map +1 -0
  4. package/dist/auth/loopbackServer.js +92 -0
  5. package/dist/auth/loopbackServer.js.map +1 -0
  6. package/dist/auth/oauthClient.js +98 -0
  7. package/dist/auth/oauthClient.js.map +1 -0
  8. package/dist/auth/pkce.js +22 -0
  9. package/dist/auth/pkce.js.map +1 -0
  10. package/dist/auth/session.js +122 -0
  11. package/dist/auth/session.js.map +1 -0
  12. package/dist/auth/tokenStore.js +93 -0
  13. package/dist/auth/tokenStore.js.map +1 -0
  14. package/dist/commands/aliasResolver.js +118 -0
  15. package/dist/commands/aliasResolver.js.map +1 -0
  16. package/dist/commands/docs.js +43 -0
  17. package/dist/commands/docs.js.map +1 -0
  18. package/dist/commands/env.js +41 -0
  19. package/dist/commands/env.js.map +1 -0
  20. package/dist/commands/generatedCommandRegistry.js +76 -0
  21. package/dist/commands/generatedCommandRegistry.js.map +1 -0
  22. package/dist/commands/login.js +66 -0
  23. package/dist/commands/login.js.map +1 -0
  24. package/dist/commands/mcp.js +45 -0
  25. package/dist/commands/mcp.js.map +1 -0
  26. package/dist/commands/mcpContext.js +66 -0
  27. package/dist/commands/mcpContext.js.map +1 -0
  28. package/dist/commands/session.js +89 -0
  29. package/dist/commands/session.js.map +1 -0
  30. package/dist/commands/tools.js +204 -0
  31. package/dist/commands/tools.js.map +1 -0
  32. package/dist/config/configStore.js +102 -0
  33. package/dist/config/configStore.js.map +1 -0
  34. package/dist/config/environments.js +27 -0
  35. package/dist/config/environments.js.map +1 -0
  36. package/dist/docs/jsonExporter.js +52 -0
  37. package/dist/docs/jsonExporter.js.map +1 -0
  38. package/dist/docs/markdownExporter.js +66 -0
  39. package/dist/docs/markdownExporter.js.map +1 -0
  40. package/dist/errors/CliError.js +35 -0
  41. package/dist/errors/CliError.js.map +1 -0
  42. package/dist/index.js +159 -0
  43. package/dist/index.js.map +1 -0
  44. package/dist/mcp/confirmation.js +57 -0
  45. package/dist/mcp/confirmation.js.map +1 -0
  46. package/dist/mcp/mcpClient.js +126 -0
  47. package/dist/mcp/mcpClient.js.map +1 -0
  48. package/dist/mcp/mcpError.js +20 -0
  49. package/dist/mcp/mcpError.js.map +1 -0
  50. package/dist/mcp/resourceMetadata.js +34 -0
  51. package/dist/mcp/resourceMetadata.js.map +1 -0
  52. package/dist/metadata/commandAliasSchema.js +51 -0
  53. package/dist/metadata/commandAliasSchema.js.map +1 -0
  54. package/dist/metadata/xyraToolDescriptor.js +20 -0
  55. package/dist/metadata/xyraToolDescriptor.js.map +1 -0
  56. package/dist/output/console.js +36 -0
  57. package/dist/output/console.js.map +1 -0
  58. package/dist/output/formatters.js +73 -0
  59. package/dist/output/formatters.js.map +1 -0
  60. package/dist/output/mcpErrorFormatter.js +55 -0
  61. package/dist/output/mcpErrorFormatter.js.map +1 -0
  62. package/dist/prompt/confirmPrompt.js +31 -0
  63. package/dist/prompt/confirmPrompt.js.map +1 -0
  64. package/dist/version.js +10 -0
  65. package/dist/version.js.map +1 -0
  66. package/package.json +59 -0
package/dist/index.js ADDED
@@ -0,0 +1,159 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.buildProgram = buildProgram;
5
+ const commander_1 = require("commander");
6
+ const console_1 = require("./output/console");
7
+ const configStore_1 = require("./config/configStore");
8
+ const mcpErrorFormatter_1 = require("./output/mcpErrorFormatter");
9
+ const login_1 = require("./commands/login");
10
+ const session_1 = require("./commands/session");
11
+ const env_1 = require("./commands/env");
12
+ const mcp_1 = require("./commands/mcp");
13
+ const tools_1 = require("./commands/tools");
14
+ const docs_1 = require("./commands/docs");
15
+ const generatedCommandRegistry_1 = require("./commands/generatedCommandRegistry");
16
+ const version_1 = require("./version");
17
+ /**
18
+ * Apply an optional `--env <name>` override before a command runs, without
19
+ * persisting it (transient selection for this invocation).
20
+ */
21
+ function configFor(envOverride) {
22
+ return new configStore_1.ConfigStore(undefined, envOverride);
23
+ }
24
+ /** Wrap an async command so failures render cleanly and set a non-zero exit code. */
25
+ function run(writer, action) {
26
+ Promise.resolve()
27
+ .then(action)
28
+ .then((code) => {
29
+ process.exitCode = code ?? 0;
30
+ })
31
+ .catch((error) => {
32
+ const formatted = (0, mcpErrorFormatter_1.formatError)(error);
33
+ writer.err(formatted.human);
34
+ process.exitCode = 1;
35
+ });
36
+ }
37
+ function buildProgram(writer = console_1.defaultWriter) {
38
+ const program = new commander_1.Command();
39
+ program
40
+ .name('xyra')
41
+ .description('Xyra headless MCP command-line client (delegated OAuth).')
42
+ .version(version_1.CLI_VERSION, '-v, --version')
43
+ .option('--env <name>', 'Environment to target for this command (overrides the active one).');
44
+ const globalEnv = () => program.opts().env;
45
+ // ---- env ----
46
+ const env = program.command('env').description('Manage connection environments.');
47
+ env
48
+ .command('list')
49
+ .description('List available environments.')
50
+ .option('--json', 'Emit JSON.')
51
+ .action((opts) => run(writer, () => (0, env_1.runEnvList)(configFor(globalEnv()), writer, opts)));
52
+ env
53
+ .command('use <name>')
54
+ .description('Set the active environment.')
55
+ .action((name) => run(writer, () => (0, env_1.runEnvUse)(configFor(), writer, name)));
56
+ env
57
+ .command('show')
58
+ .description('Show the active environment profile.')
59
+ .option('--json', 'Emit JSON.')
60
+ .action((opts) => run(writer, () => (0, env_1.runEnvShow)(configFor(globalEnv()), writer, opts)));
61
+ // ---- login / logout / whoami ----
62
+ program
63
+ .command('login')
64
+ .description('Sign in via delegated OAuth (Authorization Code + PKCE).')
65
+ .option('--no-browser', 'Print the authorization URL instead of opening a browser.')
66
+ .option('--no-open', 'Alias for --no-browser (az/gh convention).')
67
+ .action((opts) => run(writer, () => (0, login_1.runLogin)(configFor(globalEnv()), writer, { noBrowser: !opts.browser || !opts.open })));
68
+ program
69
+ .command('logout')
70
+ .description('Remove the stored token for the active environment.')
71
+ .action(() => run(writer, () => (0, session_1.runLogout)(configFor(globalEnv()), writer)));
72
+ program
73
+ .command('whoami')
74
+ .description('Show the current identity, login scopes, and token status (never prints the token).')
75
+ .option('--json', 'Emit JSON.')
76
+ .action((opts) => run(writer, () => (0, session_1.runWhoami)(configFor(globalEnv()), writer, opts)));
77
+ // ---- mcp ----
78
+ const mcp = program.command('mcp').description('Low-level MCP operations.');
79
+ mcp
80
+ .command('metadata')
81
+ .description('Show the public OAuth protected-resource metadata (no login required).')
82
+ .option('--json', 'Emit JSON.')
83
+ .action((opts) => run(writer, () => (0, mcp_1.runMcpMetadata)(configFor(globalEnv()), writer, opts)));
84
+ mcp
85
+ .command('initialize')
86
+ .description('Perform the MCP initialize handshake.')
87
+ .option('--json', 'Emit JSON.')
88
+ .action((opts) => run(writer, () => (0, mcp_1.runMcpInitialize)(configFor(globalEnv()), writer, opts)));
89
+ // ---- tools ----
90
+ const tools = program.command('tools').description('Discover and invoke Xyra tools.');
91
+ tools
92
+ .command('list')
93
+ .description('List tools visible to the current identity.')
94
+ .option('--json', 'Emit JSON.')
95
+ .option('--domain <id>', 'Filter by domain id.')
96
+ .option('--task <key>', 'Filter by task key.')
97
+ .option('--limit <n>', 'Cap the number of tools returned.')
98
+ .action((opts) => run(writer, () => (0, tools_1.runToolsList)(configFor(globalEnv()), writer, opts)));
99
+ tools
100
+ .command('describe <toolKey>')
101
+ .description('Show a tool description and input schema.')
102
+ .option('--json', 'Emit JSON.')
103
+ .action((toolKey, opts) => run(writer, () => (0, tools_1.runToolsDescribe)(configFor(globalEnv()), writer, toolKey, opts)));
104
+ tools
105
+ .command('schema <toolKey>')
106
+ .description('Print the JSON input schema for a tool.')
107
+ .action((toolKey) => run(writer, () => (0, tools_1.runToolsSchema)(configFor(globalEnv()), writer, toolKey)));
108
+ tools
109
+ .command('call <toolKey>')
110
+ .description('Invoke a tool. Provide args with repeated --arg key=value and/or --input JSON.')
111
+ .option('--arg <keyValue...>', 'Argument as key=value (repeatable; value parsed as JSON when possible).')
112
+ .option('--input <json>', 'Full arguments object as a JSON string.')
113
+ .option('--input-file <path>', 'Read the arguments object from a JSON file.')
114
+ .option('--json', 'Emit the structured result as JSON.')
115
+ .option('--raw', 'Emit the raw JSON-RPC envelope.')
116
+ .option('--yes', 'Skip the local confirmation prompt for non-read tools (server confirmations are never auto-approved).')
117
+ .option('--confirmation-request-id <id>', 'Resume an already approved confirmation request.')
118
+ .action((toolKey, opts) => run(writer, () => (0, tools_1.runToolsCall)(configFor(globalEnv()), writer, toolKey, {
119
+ arg: opts.arg,
120
+ input: opts.input,
121
+ inputFile: opts.inputFile,
122
+ json: opts.json,
123
+ raw: opts.raw,
124
+ yes: opts.yes,
125
+ confirmationRequestId: opts.confirmationRequestId,
126
+ })));
127
+ const approvals = program.command('approvals').description('Inspect and decide Xyra tool confirmations.');
128
+ approvals.command('list').option('--json', 'Emit JSON.').option('--all', 'Include all tenant requests when authorized.').action((opts) => run(writer, () => (0, tools_1.runApprovalsList)(configFor(globalEnv()), writer, { json: opts.json, includeAll: opts.all })));
129
+ approvals.command('show <id>').option('--json', 'Emit JSON.').action((id, opts) => run(writer, () => (0, tools_1.runApprovalDecision)(configFor(globalEnv()), writer, 'show', id, opts)));
130
+ approvals.command('approve <id>').option('--json', 'Emit JSON.').action((id, opts) => run(writer, () => (0, tools_1.runApprovalDecision)(configFor(globalEnv()), writer, 'approve', id, opts)));
131
+ approvals.command('reject <id>').option('--reason <text>', 'Reason for rejection.').option('--json', 'Emit JSON.').action((id, opts) => run(writer, () => (0, tools_1.runApprovalDecision)(configFor(globalEnv()), writer, 'reject', id, opts)));
132
+ approvals.command('cancel <id>').option('--json', 'Emit JSON.').action((id, opts) => run(writer, () => (0, tools_1.runApprovalDecision)(configFor(globalEnv()), writer, 'cancel', id, opts)));
133
+ tools
134
+ .command('export')
135
+ .description('Export the visible tool catalog as agent-readable documentation.')
136
+ .option('--format <fmt>', "Output format: 'markdown' or 'json'.", 'markdown')
137
+ .option('--output <path>', 'Write to this file instead of stdout.')
138
+ .option('--domain <id>', 'Filter by domain id.')
139
+ .action((opts) => run(writer, () => (0, docs_1.runToolsExport)(configFor(globalEnv()), writer, { format: opts.format, output: opts.output, domain: opts.domain })));
140
+ // ---- docs ----
141
+ const docs = program.command('docs').description('Generate agent-facing documentation.');
142
+ docs
143
+ .command('generate')
144
+ .description('Write the markdown tool catalog to a file.')
145
+ .option('--output <path>', 'Destination file path.', './xyra-tools.md')
146
+ .action((opts) => run(writer, () => (0, docs_1.runDocsGenerate)(configFor(globalEnv()), writer, { output: opts.output })));
147
+ return program;
148
+ }
149
+ /* istanbul ignore next -- CLI bootstrap */
150
+ if (require.main === module) {
151
+ // CLI-7: unknown top-level commands are offered to the metadata-backed alias
152
+ // resolver (friendly commands generated from Tool Registry metadata) before
153
+ // commander emits its normal unknown-command error.
154
+ (0, generatedCommandRegistry_1.parseWithGeneratedCommands)(buildProgram(), process.argv, console_1.defaultWriter).catch((error) => {
155
+ console_1.defaultWriter.err((0, mcpErrorFormatter_1.formatError)(error).human);
156
+ process.exitCode = 1;
157
+ });
158
+ }
159
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,57 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SERVER_CONFIRMATION_CODE = exports.READ_SIDE_EFFECT = void 0;
4
+ exports.classifyToolConfirmation = classifyToolConfirmation;
5
+ exports.extractServerConfirmationChallenge = extractServerConfirmationChallenge;
6
+ const xyraToolDescriptor_1 = require("../metadata/xyraToolDescriptor");
7
+ /**
8
+ * Write-safety classification for `tools call`, driven by the execution-policy
9
+ * annotations the Xyra MCP server publishes on every tool
10
+ * (provider-service XyraMcpToolMapper copies executionPolicy verbatim):
11
+ * sideEffect: 'read' | 'write' | 'delete' | 'async-write'
12
+ * confirmation: 'none' | 'recommended' | 'required'
13
+ * idempotency: 'idempotent' | 'non-idempotent' | 'conditional'
14
+ * Canonical vocabulary: libs/xyra-types/src/api-catalog.ts.
15
+ */
16
+ exports.READ_SIDE_EFFECT = 'read';
17
+ /** Canonical server code raised when a tool demands server-side confirmation. */
18
+ exports.SERVER_CONFIRMATION_CODE = 'XYRA.OPERATION.CONFIRMATION_REQUIRED';
19
+ /**
20
+ * Decide whether the CLI must confirm locally before calling a tool.
21
+ * Fail safe: only a declared 'read' side effect skips confirmation; a tool
22
+ * with missing or unrecognized annotations is treated as a write.
23
+ */
24
+ function classifyToolConfirmation(tool) {
25
+ const descriptor = (0, xyraToolDescriptor_1.parseXyraToolDescriptor)(tool);
26
+ const sideEffect = descriptor?.sideEffect;
27
+ const confirmation = descriptor?.confirmation;
28
+ return { sideEffect, confirmation, requiresLocalConfirmation: sideEffect !== exports.READ_SIDE_EFFECT };
29
+ }
30
+ function asRecord(value) {
31
+ return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
32
+ }
33
+ /**
34
+ * Detect a server-issued confirmation challenge in a tools/call result.
35
+ * Ground truth: provider-service ToolConfirmationBroker throws AppError
36
+ * XYRA.OPERATION.CONFIRMATION_REQUIRED with details.confirmation, and
37
+ * the MCP server surfaces it as an isError result whose structuredContent.error
38
+ * carries { code, message, details }. Detection is deliberately defensive —
39
+ * it matches either the canonical code or a typed confirmation object,
40
+ * so a challenge is still recognized if the server changes one of the two.
41
+ */
42
+ function extractServerConfirmationChallenge(result) {
43
+ const error = asRecord(asRecord(result.structuredContent)?.error);
44
+ if (!error)
45
+ return undefined;
46
+ const code = typeof error.code === 'string' ? error.code : undefined;
47
+ const confirmation = asRecord(error.confirmation)
48
+ ?? asRecord(asRecord(error.details)?.confirmation);
49
+ if (code !== exports.SERVER_CONFIRMATION_CODE && !confirmation)
50
+ return undefined;
51
+ return {
52
+ code: code ?? exports.SERVER_CONFIRMATION_CODE,
53
+ message: typeof error.message === 'string' ? error.message : undefined,
54
+ confirmation,
55
+ };
56
+ }
57
+ //# sourceMappingURL=confirmation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"confirmation.js","sourceRoot":"","sources":["../../src/mcp/confirmation.ts"],"names":[],"mappings":";;;AA6BA,4DAKC;AAsBD,gFAYC;AAnED,uEAAyE;AAEzE;;;;;;;;GAQG;AAEU,QAAA,gBAAgB,GAAG,MAAM,CAAC;AAEvC,iFAAiF;AACpE,QAAA,wBAAwB,GAAG,sCAAsC,CAAC;AAQ/E;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,IAA4B;IACnE,MAAM,UAAU,GAAG,IAAA,4CAAuB,EAAC,IAAI,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,UAAU,EAAE,UAAU,CAAC;IAC1C,MAAM,YAAY,GAAG,UAAU,EAAE,YAAY,CAAC;IAC9C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,yBAAyB,EAAE,UAAU,KAAK,wBAAgB,EAAE,CAAC;AAClG,CAAC;AASD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,kCAAkC,CAAC,MAAsB;IACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC;WAC5C,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC;IACrD,IAAI,IAAI,KAAK,gCAAwB,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IACzE,OAAO;QACL,IAAI,EAAE,IAAI,IAAI,gCAAwB;QACtC,OAAO,EAAE,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACtE,YAAY;KACb,CAAC;AACJ,CAAC"}
@@ -0,0 +1,126 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.McpClient = exports.McpRawResponseCapture = void 0;
4
+ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
5
+ const mcpError_1 = require("./mcpError");
6
+ class McpRawResponseCapture {
7
+ callback;
8
+ begin(callback) {
9
+ this.callback = callback;
10
+ }
11
+ end() {
12
+ this.callback = undefined;
13
+ }
14
+ async observe(response) {
15
+ if (!this.callback || !response.headers.get('content-type')?.includes('application/json'))
16
+ return;
17
+ try {
18
+ this.callback(await response.clone().json());
19
+ }
20
+ catch {
21
+ // The SDK remains the protocol authority; raw capture is diagnostic only.
22
+ }
23
+ }
24
+ }
25
+ exports.McpRawResponseCapture = McpRawResponseCapture;
26
+ class McpClient {
27
+ sdk;
28
+ transport;
29
+ rawCapture;
30
+ constructor(sdk, transport, rawCapture) {
31
+ this.sdk = sdk;
32
+ this.transport = transport;
33
+ this.rawCapture = rawCapture;
34
+ }
35
+ initialize() {
36
+ return {
37
+ protocolVersion: this.transport.protocolVersion,
38
+ capabilities: this.sdk.getServerCapabilities() ?? {},
39
+ serverInfo: this.sdk.getServerVersion() ?? {},
40
+ instructions: this.sdk.getInstructions(),
41
+ };
42
+ }
43
+ async request(method, params = {}, options) {
44
+ this.rawCapture?.begin(options?.captureRaw);
45
+ try {
46
+ return await this.sdk.request({ method, params }, types_js_1.ResultSchema);
47
+ }
48
+ catch (error) {
49
+ throw mcpError_1.McpRpcError.from(error) ?? error;
50
+ }
51
+ finally {
52
+ this.rawCapture?.end();
53
+ }
54
+ }
55
+ assertConfirmationExtension() {
56
+ const experimental = this.sdk.getServerCapabilities()?.experimental;
57
+ const extension = experimental?.['com.experiture.xyra.confirmations'];
58
+ if (extension?.version !== 1) {
59
+ throw new mcpError_1.McpRpcError({
60
+ code: -32602,
61
+ message: 'The server did not negotiate the Xyra confirmation extension.',
62
+ data: { xyraCode: 'XYRA.MCP.EXTENSION_NOT_NEGOTIATED' },
63
+ });
64
+ }
65
+ }
66
+ /** Page through every visible tool unless a hard limit is supplied. */
67
+ async listTools(filters) {
68
+ const tools = [];
69
+ let cursor;
70
+ do {
71
+ const params = {};
72
+ if (filters?.domainId)
73
+ params.domainId = filters.domainId;
74
+ if (filters?.taskKey)
75
+ params.taskKey = filters.taskKey;
76
+ if (filters?.toolKey)
77
+ params.toolKey = filters.toolKey;
78
+ if (cursor)
79
+ params.cursor = cursor;
80
+ const result = await this.request('tools/list', params);
81
+ tools.push(...(result.tools ?? []));
82
+ cursor = result.nextCursor;
83
+ if (filters?.limit && tools.length >= filters.limit)
84
+ return tools.slice(0, filters.limit);
85
+ } while (cursor);
86
+ return tools;
87
+ }
88
+ async describeTool(toolKey) {
89
+ const byKey = await this.listTools({ toolKey });
90
+ if (byKey.length > 0)
91
+ return byKey.find((tool) => tool.name === toolKey) ?? byKey[0];
92
+ const all = await this.listTools();
93
+ return all.find((tool) => tool.name === toolKey);
94
+ }
95
+ callTool(name, args, options, control) {
96
+ return this.request('tools/call', {
97
+ name,
98
+ arguments: args,
99
+ ...(control?.confirmationRequestId
100
+ ? { _meta: { 'com.experiture.xyra/confirmationRequestId': control.confirmationRequestId } }
101
+ : {}),
102
+ }, options);
103
+ }
104
+ listConfirmations(params = {}) {
105
+ this.assertConfirmationExtension();
106
+ return this.request('xyra/confirmations/list', params);
107
+ }
108
+ getConfirmation(id) {
109
+ this.assertConfirmationExtension();
110
+ return this.request('xyra/confirmations/get', { id });
111
+ }
112
+ approveConfirmation(id) {
113
+ this.assertConfirmationExtension();
114
+ return this.request('xyra/confirmations/approve', { id });
115
+ }
116
+ rejectConfirmation(id, reason) {
117
+ this.assertConfirmationExtension();
118
+ return this.request('xyra/confirmations/reject', { id, ...(reason ? { reason } : {}) });
119
+ }
120
+ cancelConfirmation(id) {
121
+ this.assertConfirmationExtension();
122
+ return this.request('xyra/confirmations/cancel', { id });
123
+ }
124
+ }
125
+ exports.McpClient = McpClient;
126
+ //# sourceMappingURL=mcpClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcpClient.js","sourceRoot":"","sources":["../../src/mcp/mcpClient.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.McpRpcError = void 0;
4
+ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
5
+ /** Wraps a canonical MCP error so the formatter preserves code and data. */
6
+ class McpRpcError extends Error {
7
+ rpc;
8
+ constructor(rpc) {
9
+ super(rpc.message);
10
+ this.name = 'McpRpcError';
11
+ this.rpc = rpc;
12
+ }
13
+ static from(error) {
14
+ return error instanceof types_js_1.McpError
15
+ ? new McpRpcError({ code: error.code, message: error.message, data: error.data })
16
+ : null;
17
+ }
18
+ }
19
+ exports.McpRpcError = McpRpcError;
20
+ //# sourceMappingURL=mcpError.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcpError.js","sourceRoot":"","sources":["../../src/mcp/mcpError.ts"],"names":[],"mappings":";;;AAAA,iEAA8D;AAQ9D,4EAA4E;AAC5E,MAAa,WAAY,SAAQ,KAAK;IAC3B,GAAG,CAAe;IAE3B,YAAY,GAAiB;QAC3B,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAc;QACxB,OAAO,KAAK,YAAY,mBAAQ;YAC9B,CAAC,CAAC,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YACjF,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;CACF;AAdD,kCAcC"}
@@ -0,0 +1,34 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.resourceMetadataUrl = resourceMetadataUrl;
4
+ exports.fetchResourceMetadata = fetchResourceMetadata;
5
+ const CliError_1 = require("../errors/CliError");
6
+ /**
7
+ * Derive the protected-resource metadata URL from the MCP resource, matching
8
+ * provider-service's derivation (strip a trailing `/mcp`, append the
9
+ * well-known path). No token is required — this is a public discovery document.
10
+ */
11
+ function resourceMetadataUrl(env) {
12
+ const resource = (env.oauthResource || env.mcpUrl).replace(/\/+$/, '');
13
+ return `${resource.replace(/\/mcp$/, '')}/.well-known/oauth-protected-resource`;
14
+ }
15
+ async function fetchResourceMetadata(env) {
16
+ const url = resourceMetadataUrl(env);
17
+ let response;
18
+ try {
19
+ response = await fetch(url, { headers: { accept: 'application/json' } });
20
+ }
21
+ catch (cause) {
22
+ throw new CliError_1.CliError(CliError_1.CliErrorCodes.McpProtocolError, `Could not reach MCP metadata endpoint ${url}.`, cause?.message);
23
+ }
24
+ if (!response.ok) {
25
+ throw new CliError_1.CliError(CliError_1.CliErrorCodes.McpProtocolError, `MCP metadata request failed (HTTP ${response.status}) at ${url}.`);
26
+ }
27
+ try {
28
+ return (await response.json());
29
+ }
30
+ catch {
31
+ throw new CliError_1.CliError(CliError_1.CliErrorCodes.McpProtocolError, `MCP metadata endpoint returned a non-JSON document at ${url}.`);
32
+ }
33
+ }
34
+ //# sourceMappingURL=resourceMetadata.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resourceMetadata.js","sourceRoot":"","sources":["../../src/mcp/resourceMetadata.ts"],"names":[],"mappings":";;AAkBA,kDAGC;AAED,sDAgBC;AAvCD,iDAA6D;AAa7D;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,GAAoB;IACtD,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,uCAAuC,CAAC;AAClF,CAAC;AAEM,KAAK,UAAU,qBAAqB,CAAC,GAAoB;IAC9D,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,mBAAQ,CAAC,wBAAa,CAAC,gBAAgB,EAAE,yCAAyC,GAAG,GAAG,EAAG,KAAe,EAAE,OAAO,CAAC,CAAC;IACjI,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,mBAAQ,CAAC,wBAAa,CAAC,gBAAgB,EAAE,qCAAqC,QAAQ,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC;IACzH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAqB,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,mBAAQ,CAAC,wBAAa,CAAC,gBAAgB,EAAE,yDAAyD,GAAG,GAAG,CAAC,CAAC;IACtH,CAAC;AACH,CAAC"}
@@ -0,0 +1,51 @@
1
+ "use strict";
2
+ /**
3
+ * commandAliasSchema - defensive parser for the `cli` block inside Xyra's
4
+ * namespaced MCP descriptor metadata (Phase CLI-7).
5
+ *
6
+ * The server passes `tool_action_definitions.metadata.cli` through the
7
+ * `com.experiture.xyra/tool` descriptor. The CLI must never trust that shape: this parser
8
+ * tolerates absence and malformed data by returning null. It never throws.
9
+ */
10
+ Object.defineProperty(exports, "__esModule", { value: true });
11
+ exports.normalizeAliasWords = normalizeAliasWords;
12
+ exports.parseCliCommandMetadata = parseCliCommandMetadata;
13
+ function isRecord(value) {
14
+ return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
15
+ }
16
+ /** Split an alias into normalized lowercase words; returns [] for unusable input. */
17
+ function normalizeAliasWords(alias) {
18
+ if (typeof alias !== 'string')
19
+ return [];
20
+ return alias
21
+ .trim()
22
+ .toLowerCase()
23
+ .split(/\s+/)
24
+ .filter((word) => word.length > 0);
25
+ }
26
+ function parseStringArray(value) {
27
+ if (!Array.isArray(value))
28
+ return [];
29
+ return value.filter((item) => typeof item === 'string' && item.trim().length > 0);
30
+ }
31
+ /**
32
+ * Parse the `cli` block out of a tool's MCP annotations.
33
+ * Returns null when the annotations are absent, the `cli` block is absent or
34
+ * malformed, or no usable alias survives normalization. Never throws.
35
+ */
36
+ function parseCliCommandMetadata(descriptor) {
37
+ if (!isRecord(descriptor))
38
+ return null;
39
+ const cli = descriptor.cli;
40
+ if (!isRecord(cli))
41
+ return null;
42
+ const aliases = parseStringArray(cli.aliases)
43
+ .map((alias) => normalizeAliasWords(alias).join(' '))
44
+ .filter((alias) => alias.length > 0);
45
+ if (aliases.length === 0)
46
+ return null;
47
+ const examples = parseStringArray(cli.examples);
48
+ const defaultOutput = cli.defaultOutput === 'table' || cli.defaultOutput === 'json' ? cli.defaultOutput : undefined;
49
+ return { aliases: Array.from(new Set(aliases)), examples, defaultOutput };
50
+ }
51
+ //# sourceMappingURL=commandAliasSchema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commandAliasSchema.js","sourceRoot":"","sources":["../../src/metadata/commandAliasSchema.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAkBH,kDAOC;AAYD,0DAgBC;AAxCD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,qFAAqF;AACrF,SAAgB,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzC,OAAO,KAAK;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpG,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,UAAmB;IACzD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC;IAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;SAC1C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACpD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEhD,MAAM,aAAa,GACjB,GAAG,CAAC,aAAa,KAAK,OAAO,IAAI,GAAG,CAAC,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhG,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AAC5E,CAAC"}
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.XYRA_TOOL_DESCRIPTOR_META_KEY = void 0;
4
+ exports.parseXyraToolDescriptor = parseXyraToolDescriptor;
5
+ exports.XYRA_TOOL_DESCRIPTOR_META_KEY = 'com.experiture.xyra/tool';
6
+ function isRecord(value) {
7
+ return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
8
+ }
9
+ function parseXyraToolDescriptor(tool) {
10
+ const descriptor = tool._meta?.[exports.XYRA_TOOL_DESCRIPTOR_META_KEY];
11
+ if (!isRecord(descriptor) || descriptor.schemaVersion !== 1)
12
+ return null;
13
+ const requiredStrings = ['classificationReason', 'domainId', 'category', 'sideEffect', 'confirmation', 'idempotency', 'invokerKind'];
14
+ if (requiredStrings.some((key) => typeof descriptor[key] !== 'string'))
15
+ return null;
16
+ if (!Array.isArray(descriptor.taskBindings))
17
+ return null;
18
+ return descriptor;
19
+ }
20
+ //# sourceMappingURL=xyraToolDescriptor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"xyraToolDescriptor.js","sourceRoot":"","sources":["../../src/metadata/xyraToolDescriptor.ts"],"names":[],"mappings":";;;AAyBA,0DAOC;AA9BY,QAAA,6BAA6B,GAAG,0BAA0B,CAAC;AAmBxE,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAgB,uBAAuB,CAAC,IAA4B;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,qCAA6B,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,aAAa,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,MAAM,eAAe,GAAG,CAAC,sBAAsB,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IACrI,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACpF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,UAAmD,CAAC;AAC7D,CAAC"}
@@ -0,0 +1,36 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.defaultWriter = void 0;
4
+ exports.redactSecrets = redactSecrets;
5
+ exports.defaultWriter = {
6
+ out: (line) => process.stdout.write(line.endsWith('\n') ? line : `${line}\n`),
7
+ err: (line) => process.stderr.write(line.endsWith('\n') ? line : `${line}\n`),
8
+ };
9
+ /** Keys whose values must never be printed or logged. */
10
+ const SECRET_KEYS = new Set([
11
+ 'access_token',
12
+ 'refresh_token',
13
+ 'id_token',
14
+ 'code',
15
+ 'code_verifier',
16
+ 'client_secret',
17
+ 'authorization',
18
+ 'cookie',
19
+ 'set-cookie',
20
+ 'password',
21
+ ].map((k) => k.toLowerCase()));
22
+ /** Recursively redact secret-bearing fields before any diagnostic print. */
23
+ function redactSecrets(value) {
24
+ if (Array.isArray(value)) {
25
+ return value.map(redactSecrets);
26
+ }
27
+ if (value && typeof value === 'object') {
28
+ const out = {};
29
+ for (const [key, val] of Object.entries(value)) {
30
+ out[key] = SECRET_KEYS.has(key.toLowerCase()) ? '***redacted***' : redactSecrets(val);
31
+ }
32
+ return out;
33
+ }
34
+ return value;
35
+ }
36
+ //# sourceMappingURL=console.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/output/console.ts"],"names":[],"mappings":";;;AA+BA,sCAYC;AAlCY,QAAA,aAAa,GAAiB;IACzC,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;IACrF,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;CACtF,CAAC;AAEF,yDAAyD;AACzD,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB;IACE,cAAc;IACd,eAAe;IACf,UAAU;IACV,MAAM;IACN,eAAe;IACf,eAAe;IACf,eAAe;IACf,QAAQ;IACR,YAAY;IACZ,UAAU;CACX,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAC9B,CAAC;AAEF,4EAA4E;AAC5E,SAAgB,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC1E,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -0,0 +1,73 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.toJson = toJson;
4
+ exports.formatToolList = formatToolList;
5
+ exports.formatToolDetail = formatToolDetail;
6
+ exports.formatToolResult = formatToolResult;
7
+ const console_1 = require("./console");
8
+ /** Pretty JSON with secrets redacted (defense-in-depth for --json / --raw). */
9
+ function toJson(value) {
10
+ return JSON.stringify((0, console_1.redactSecrets)(value), null, 2);
11
+ }
12
+ function formatToolList(tools) {
13
+ if (tools.length === 0)
14
+ return 'No tools available for the current identity and delegated permissions.';
15
+ const rows = tools.map((t) => {
16
+ const desc = (t.description ?? '').split('\n')[0];
17
+ return ` ${t.name}${desc ? ` — ${desc}` : ''}`;
18
+ });
19
+ return [`${tools.length} tool(s):`, ...rows].join('\n');
20
+ }
21
+ function formatToolDetail(tool) {
22
+ const lines = [`Tool: ${tool.name}`];
23
+ if (tool.description)
24
+ lines.push('', tool.description);
25
+ if (tool.inputSchema) {
26
+ lines.push('', 'Input schema:', toJson(tool.inputSchema));
27
+ }
28
+ if (tool.annotations && Object.keys(tool.annotations).length > 0) {
29
+ lines.push('', 'Standard annotations:', toJson(tool.annotations));
30
+ }
31
+ if (tool._meta && Object.keys(tool._meta).length > 0) {
32
+ lines.push('', 'Xyra metadata:', toJson(tool._meta));
33
+ }
34
+ return lines.join('\n');
35
+ }
36
+ function textContent(result) {
37
+ if (!Array.isArray(result.content)) {
38
+ return null;
39
+ }
40
+ const text = result.content
41
+ .map((part) => {
42
+ if (part && typeof part === 'object' && part.type === 'text') {
43
+ return String(part.text ?? '');
44
+ }
45
+ return toJson(part);
46
+ })
47
+ .join('\n')
48
+ .trim();
49
+ return text.length > 0 ? text : null;
50
+ }
51
+ function hasPresentationEnvelope(result) {
52
+ const structured = result.structuredContent;
53
+ if (!structured || typeof structured !== 'object' || Array.isArray(structured)) {
54
+ return false;
55
+ }
56
+ const presentations = structured.presentations;
57
+ return Array.isArray(presentations) && presentations.length > 0;
58
+ }
59
+ /** Human view of a tools/call result: presenter Markdown first, then legacy structured output. */
60
+ function formatToolResult(result) {
61
+ const text = textContent(result);
62
+ if (text && hasPresentationEnvelope(result)) {
63
+ return text;
64
+ }
65
+ if (result.structuredContent !== undefined) {
66
+ return toJson(result.structuredContent);
67
+ }
68
+ if (text) {
69
+ return text;
70
+ }
71
+ return toJson(result);
72
+ }
73
+ //# sourceMappingURL=formatters.js.map