@experiture/xyra-cli 0.6.2 → 0.6.4
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.
- package/README.md +24 -1
- package/dist/auth/oauthClient.js +89 -30
- package/dist/auth/oauthClient.js.map +1 -1
- package/dist/auth/session.js +11 -7
- package/dist/auth/session.js.map +1 -1
- package/dist/auth/tokenStore.js.map +1 -1
- package/dist/chat/runtimeChatClient.js +22110 -850
- package/dist/chat/runtimeChatClient.js.map +4 -4
- package/dist/commands/chat.js +159 -9
- package/dist/commands/chat.js.map +1 -1
- package/dist/commands/login.js +7 -7
- package/dist/commands/login.js.map +1 -1
- package/dist/commands/mcpContext.js +29 -3
- package/dist/commands/mcpContext.js.map +1 -1
- package/dist/commands/session.js +32 -24
- package/dist/commands/session.js.map +1 -1
- package/dist/commands/tools.js +72 -7
- package/dist/commands/tools.js.map +1 -1
- package/dist/commands/workflowProposal.js +19 -0
- package/dist/commands/workflowProposal.js.map +1 -0
- package/dist/config/configStore.js +88 -45
- package/dist/config/configStore.js.map +2 -2
- package/dist/index.js +27 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp/confirmation.js +17 -3
- package/dist/mcp/confirmation.js.map +1 -1
- package/dist/mcp/mcpClient.js +56 -6
- package/dist/mcp/mcpClient.js.map +2 -2
- package/dist/output/formatters.js +4 -0
- package/dist/output/formatters.js.map +1 -1
- package/package.json +2 -2
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../../../libs/xyra-types/src/xyra-administration.ts", "../../src/mcp/mcpClient.ts", "../../src/diagnostics/latency.ts"],
|
|
4
|
-
"sourcesContent": ["import type { XyraRuntimeIdentityV2 } from './context';\n\n/** A requested maintenance target. It is never a runtime identity or an authorization decision. */\nexport type XyraAdministrationTargetV1 =\n | Readonly<{ targetKind: 'global-resource'; managedProductId: 'xyra-ai' }>\n | Readonly<{ targetKind: 'configuration-owner'; configurationTenantId: string; managedProductId: string }>\n | Readonly<{ targetKind: 'customer-resource'; targetTenantId: string; activeProductId: string }>;\n\n/** Selects a candidate from verified runtime facts. Auth must still admit the exact action. */\nexport function runtimeAdministrationTarget(identity: XyraRuntimeIdentityV2): XyraAdministrationTargetV1 {\n return identity.licenseSourceProductId !== identity.licensedProductId\n && identity.tenantId === identity.licenseOwnerTenantId\n ? { targetKind: 'configuration-owner', configurationTenantId: identity.licenseOwnerTenantId,\n managedProductId: identity.licenseSourceProductId }\n : { targetKind: 'customer-resource', targetTenantId: identity.tenantId, activeProductId: identity.productId };\n}\n\nexport type XyraAccessPurposeV1 = 'runtime' | 'administration';\nexport type XyraAuthorityDecisionPhaseV1 = 'discovery' | 'execution';\nexport type XyraConfigurationAccess = 'read' | 'manage' | 'manage_selection';\n\nexport type XyraAdministrationRequestV1 = Readonly<{\n operationId: string;\n target: XyraAdministrationTargetV1;\n}>;\n\n/** Auth-resolved relationship facts, without a permission snapshot or runtime licence grant. */\nexport type XyraAdministrationResolvedTargetV1 =\n | Readonly<{ targetKind: 'global-resource'; managedProductId: 'xyra-ai'; relationshipKind: 'global-resource' }>\n | Readonly<{ targetKind: 'configuration-owner' | 'customer-resource'; managedProductId: string;\n relationshipKind: 'native-product-tenant'; activeProductId: 'xyra-ai'; actualTenantId: string;\n licensedProductId: 'xyra-ai'; commercialState: string }>\n | Readonly<{ targetKind: 'configuration-owner' | 'customer-resource'; managedProductId: string;\n relationshipKind: 'embedded-product-entitlement'; activeProductId: string; actualTenantId: string;\n licenseSourceProductId: string; licensedProductId: 'xyra-ai'; licenseOwnerTenantId: string;\n bindingId: string; entitlementId: string; sourceEntitlementId: string; commercialState: string }>;\n\nexport type XyraAdministrationDecisionV1 = Readonly<{\n operationId: string;\n purpose: XyraAuthorityDecisionPhaseV1;\n accessPurpose: 'administration';\n allowed: boolean;\n code: string;\n productId: 'xyra-ai';\n operatorTenantId: string | null;\n targetTenantId: string | null;\n grantId: string | null;\n target: XyraAdministrationTargetV1;\n resolvedTarget: XyraAdministrationResolvedTargetV1 | null;\n /** Optional Auth-owned projection requested during a rolling service release. */\n configurationAccess?: XyraConfigurationAccess;\n}>;\n\n/** Protected execution/approval scope, not a permission grant and never a public argument. */\nexport type XyraAdministrationExecutionScopeV1 = Readonly<{\n accessPurpose: 'administration';\n resourceAudience: string;\n administrationTransport: 'native-http' | 'delegated-oauth';\n actorOperatorTenantId: string | null;\n targetHash: string;\n target: XyraAdministrationTargetV1;\n resolvedTarget: XyraAdministrationResolvedTargetV1;\n}>;\n\nconst identifier = (value: unknown): value is string => typeof value === 'string'\n && /^[A-Za-z0-9][A-Za-z0-9._:-]{0,49}$/.test(value);\nconst guid = (value: unknown): value is string => typeof value === 'string'\n && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(value)\n && value !== '00000000-0000-0000-0000-000000000000';\nconst record = (value: unknown): value is Record<string, unknown> => value !== null\n && typeof value === 'object' && !Array.isArray(value);\nconst exact = (value: Record<string, unknown>, keys: readonly string[]): boolean =>\n Object.keys(value).length === keys.length && keys.every(key => Object.prototype.hasOwnProperty.call(value, key));\n\n/** Strictly parse the closed object shape; raw duplicate JSON keys belong to the transport parser. */\nexport function parseXyraAdministrationTargetV1(value: unknown): XyraAdministrationTargetV1 | null {\n if (!record(value)) return null;\n if (value.targetKind === 'global-resource' && exact(value, ['targetKind', 'managedProductId'])\n && value.managedProductId === 'xyra-ai') {\n return { targetKind: 'global-resource', managedProductId: 'xyra-ai' };\n }\n if (value.targetKind === 'configuration-owner'\n && exact(value, ['targetKind', 'configurationTenantId', 'managedProductId'])\n && identifier(value.configurationTenantId) && identifier(value.managedProductId)) {\n return { targetKind: 'configuration-owner', configurationTenantId: value.configurationTenantId,\n managedProductId: value.managedProductId };\n }\n if (value.targetKind === 'customer-resource'\n && exact(value, ['targetKind', 'targetTenantId', 'activeProductId'])\n && identifier(value.targetTenantId) && identifier(value.activeProductId)) {\n return { targetKind: 'customer-resource', targetTenantId: value.targetTenantId, activeProductId: value.activeProductId };\n }\n return null;\n}\n\n/** Stable exact tuple for cache/request binding, excluding display text and mutable capabilities. */\nexport function xyraAdministrationTargetKeyV1(target: XyraAdministrationTargetV1): string {\n return JSON.stringify(target.targetKind === 'global-resource'\n ? [target.targetKind, target.managedProductId]\n : target.targetKind === 'configuration-owner'\n ? [target.targetKind, target.configurationTenantId, target.managedProductId]\n : [target.targetKind, target.targetTenantId, target.activeProductId]);\n}\n\n/** Validate independent Auth facts against the exact request, never infer a missing relationship. */\nexport function parseXyraAdministrationResolvedTargetV1(\n value: unknown, target: XyraAdministrationTargetV1,\n): XyraAdministrationResolvedTargetV1 | null {\n if (!record(value) || value.targetKind !== target.targetKind) return null;\n const managedProductId = target.targetKind === 'customer-resource' ? 'xyra-ai' : target.managedProductId;\n if (value.managedProductId !== managedProductId) return null;\n if (target.targetKind === 'global-resource') {\n return exact(value, ['targetKind', 'managedProductId', 'relationshipKind']) && value.relationshipKind === 'global-resource'\n ? { targetKind: 'global-resource', managedProductId: 'xyra-ai', relationshipKind: 'global-resource' } : null;\n }\n const base = ['targetKind', 'managedProductId', 'relationshipKind', 'activeProductId', 'actualTenantId', 'licensedProductId', 'commercialState'];\n const embedded = ['licenseSourceProductId', 'licenseOwnerTenantId', 'bindingId', 'entitlementId', 'sourceEntitlementId'];\n const isNative = value.relationshipKind === 'native-product-tenant';\n if ((!isNative && value.relationshipKind !== 'embedded-product-entitlement')\n || !exact(value, isNative ? base : [...base, ...embedded]) || value.licensedProductId !== 'xyra-ai'\n || !base.filter(key => !['targetKind', 'relationshipKind'].includes(key)).every(key => identifier(value[key]))\n || (isNative ? value.activeProductId !== 'xyra-ai' : !embedded.every(key => identifier(value[key])))\n || value.actualTenantId !== (target.targetKind === 'customer-resource' ? target.targetTenantId : target.configurationTenantId)\n || (target.targetKind === 'customer-resource' && value.activeProductId !== target.activeProductId)\n || (target.targetKind === 'configuration-owner' && value.activeProductId !== target.managedProductId)\n || (!isNative && (value.activeProductId !== value.licenseSourceProductId && value.activeProductId !== value.licensedProductId\n || !['bindingId', 'entitlementId', 'sourceEntitlementId'].every(key => guid(value[key]))\n || (target.targetKind === 'configuration-owner' && (value.licenseOwnerTenantId !== target.configurationTenantId\n || value.licenseSourceProductId !== target.managedProductId))))) return null;\n return { ...value } as XyraAdministrationResolvedTargetV1;\n}\n\n/** Parse a decision only for the operation, phase and target that were actually requested. */\nexport function parseXyraAdministrationDecisionV1(value: unknown,\n request: XyraAdministrationRequestV1, purpose: XyraAuthorityDecisionPhaseV1,\n): XyraAdministrationDecisionV1 | null {\n if (!record(value) || !exact(value, ['operationId', 'purpose', 'accessPurpose', 'allowed', 'code', 'productId',\n 'operatorTenantId', 'targetTenantId', 'grantId', 'target', 'resolvedTarget',\n ...(Object.prototype.hasOwnProperty.call(value, 'configurationAccess') ? ['configurationAccess'] : [])])\n || (value.configurationAccess !== undefined && !['read', 'manage', 'manage_selection'].includes(String(value.configurationAccess)))\n || value.operationId !== request.operationId || value.purpose !== purpose || value.accessPurpose !== 'administration'\n || value.productId !== 'xyra-ai' || typeof value.allowed !== 'boolean' || typeof value.code !== 'string'\n || !/^[A-Z0-9_.]{1,160}$/.test(value.code)\n || !(value.operatorTenantId === null || identifier(value.operatorTenantId))\n || !(value.grantId === null || guid(value.grantId))) return null;\n const target = parseXyraAdministrationTargetV1(value.target);\n if (!target || xyraAdministrationTargetKeyV1(target) !== xyraAdministrationTargetKeyV1(request.target)\n || value.targetTenantId !== (target.targetKind === 'global-resource' ? null\n : target.targetKind === 'configuration-owner' ? target.configurationTenantId : target.targetTenantId)) return null;\n const resolvedTarget = parseXyraAdministrationResolvedTargetV1(value.resolvedTarget, target);\n if (value.allowed) {\n if (!resolvedTarget) return null;\n if (value.code === 'AUTHORIZATION.ALLOWED.SAME_TENANT') {\n if (target.targetKind !== 'customer-resource' || value.operatorTenantId !== target.targetTenantId\n || value.grantId !== null) return null;\n } else if (value.code === 'AUTHORIZATION.ALLOWED.SUPER_USER'\n ? value.operatorTenantId !== null || value.grantId !== null\n : !['AUTHORIZATION.ALLOWED', 'AUTHORIZATION.ALLOWED.LICENSEE'].includes(value.code) || value.operatorTenantId === null || value.grantId === null) return null;\n if (value.code === 'AUTHORIZATION.ALLOWED.LICENSEE'\n && (target.targetKind === 'global-resource' || resolvedTarget.relationshipKind !== 'embedded-product-entitlement'\n || resolvedTarget.licenseOwnerTenantId !== value.operatorTenantId)) return null;\n } else if (value.code.startsWith('AUTHORIZATION.ALLOWED') || value.resolvedTarget !== null) return null;\n return { ...value, target, resolvedTarget } as XyraAdministrationDecisionV1;\n}\n", "import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport type { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport { ResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport type {\n XyraRuntimeActionDescriptor,\n XyraPendingHumanApprovalV1,\n XyraRuntimeResponse,\n XyraRuntimeStreamOutcome,\n XyraHumanApprovalViewV1,\n} from '@experiture/xyra-runtime-client';\nimport { McpRpcError } from './mcpError';\nimport { measureLatencyPhase } from '../diagnostics/latency';\nimport {parseXyraAdministrationTargetV1,type XyraAdministrationTargetV1}from'@xyra/types/xyra-administration';\n\nexport interface RpcCallOptions {\n /** Exact JSON-RPC envelope captured from a JSON Streamable HTTP response. */\n captureRaw?: (raw: unknown) => void;\n}\n\nexport class McpRawResponseCapture {\n private callback?: (raw: unknown) => void;\n\n begin(callback?: (raw: unknown) => void): void {\n this.callback = callback;\n }\n\n end(): void {\n this.callback = undefined;\n }\n\n async observe(response: Response): Promise<void> {\n if (!this.callback || !response.headers.get('content-type')?.includes('application/json')) return;\n try {\n this.callback(await response.clone().json());\n } catch {\n // The SDK remains the protocol authority; raw capture is diagnostic only.\n }\n }\n}\n\nexport interface McpTool {\n name: string;\n title?: string;\n description?: string;\n inputSchema?: unknown;\n outputSchema?: unknown;\n annotations?: Record<string, unknown>;\n _meta?: Record<string, unknown>;\n}\n\ninterface ToolsListResult {\n tools: McpTool[];\n nextCursor?: string;\n}\n\nexport interface ToolCallResult {\n content?: unknown;\n structuredContent?: unknown;\n isError?: boolean;\n [key: string]: unknown;\n}\n\nexport interface ConfirmationControl {\n confirmationRequestId?: string;\n}\n\nexport interface ConfirmationListResult {\n confirmations: Record<string, unknown>[];\n count: number;\n}\n\nexport interface McpChatRequest {\n conversationId?: string;\n createConversation?: boolean;\n title?: string;\n message: string;\n locale?: 'en' | 'fr' | 'zh-Hans';\n clientRequestId?: string;\n}\n\nexport interface McpChatResult {\n schemaVersion: 1;\n conversationId: string;\n clientRequestId: string;\n requestId: string;\n executionId: string;\n streamId: string;\n traceId?: string;\n userMessageId: string;\n assistantMessageId?: string;\n outcome: XyraRuntimeStreamOutcome;\n message?: string;\n response?: XyraRuntimeResponse;\n error?: unknown;\n actions?: XyraRuntimeActionDescriptor[];\n pendingHumanApproval?: XyraPendingHumanApprovalV1;\n confirmation?: XyraHumanApprovalViewV1;\n eventCount: number;\n chunkCount: number;\n createdConversation?: {\n id: string;\n title: string;\n titleSource: string;\n createdAt: string;\n };\n}\n\nexport class McpClient {\n constructor(\n private readonly sdk: Client,\n private readonly transport: StreamableHTTPClientTransport,\n private readonly rawCapture?: McpRawResponseCapture,\n private readonly administrationTarget?:XyraAdministrationTargetV1,\n ) {\n if(administrationTarget){\n const selected=parseXyraAdministrationTargetV1(administrationTarget);\n if(!selected)throw new McpRpcError({code:-32602,message:'Select one closed administration target.',data:{xyraCode:'XYRA.MCP.REQUEST_INVALID'}});\n this.administrationTarget=selected;\n }\n }\n\n initialize(): unknown {\n return {\n protocolVersion: this.transport.protocolVersion,\n capabilities: this.sdk.getServerCapabilities() ?? {},\n serverInfo: this.sdk.getServerVersion() ?? {},\n instructions: this.sdk.getInstructions(),\n };\n }\n\n private async request<T>(method: string, params: Record<string, unknown> = {}, options?: RpcCallOptions): Promise<T> {\n if(this.administrationTarget){\n if(method==='xyra/chat'||['xyra/confirmations/approve','xyra/confirmations/reject','xyra/confirmations/cancel'].includes(method))\n throw new McpRpcError({code:-32602,message:'Administrative delegated sessions cannot run chat or decide approvals.',data:{xyraCode:'XYRA.AUTH.INSUFFICIENT_PERMISSIONS'}});\n if(method==='tools/list'||method==='tools/call')params={...params,target:this.administrationTarget};\n }\n this.rawCapture?.begin(options?.captureRaw);\n try {\n return await measureLatencyPhase(\n 'mcp.method',\n () => this.sdk.request({ method, params } as never, ResultSchema) as Promise<T>,\n { method },\n );\n } catch (error) {\n throw McpRpcError.from(error) ?? error;\n } finally {\n this.rawCapture?.end();\n }\n }\n\n private assertConfirmationExtension(): void {\n const experimental = this.sdk.getServerCapabilities()?.experimental;\n const extension = experimental?.['com.experiture.xyra.confirmations'] as Record<string, unknown> | undefined;\n if (extension?.version !== 1) {\n throw new McpRpcError({\n code: -32602,\n message: 'The server did not negotiate the Xyra confirmation extension.',\n data: { xyraCode: 'XYRA.MCP.EXTENSION_NOT_NEGOTIATED' },\n });\n }\n }\n\n private assertChatExtension(): void {\n const experimental = this.sdk.getServerCapabilities()?.experimental;\n const extension = experimental?.['com.experiture.xyra.chat'] as Record<string, unknown> | undefined;\n if (extension?.version !== 1) {\n throw new McpRpcError({\n code: -32602,\n message: 'The server did not negotiate the Xyra chat extension.',\n data: { xyraCode: 'XYRA.MCP.EXTENSION_NOT_NEGOTIATED' },\n });\n }\n }\n\n /** Page through every visible tool unless a hard limit is supplied. */\n async listTools(filters?: { domainId?: string; taskKey?: string; toolKey?: string; limit?: number }): Promise<McpTool[]> {\n const tools: McpTool[] = [];\n let cursor: string | undefined;\n do {\n const params: Record<string, unknown> = {};\n if(this.administrationTarget&&(filters?.domainId||filters?.taskKey))throw new McpRpcError({code:-32602,\n message:'Administrative discovery uses a closed target and optional exact tool key; runtime domain/task filters are not admission.',data:{xyraCode:'XYRA.MCP.REQUEST_INVALID'}});\n if (filters?.domainId) params.domainId = filters.domainId;\n if (filters?.taskKey) params.taskKey = filters.taskKey;\n if (filters?.toolKey) params.toolKey = filters.toolKey;\n if (cursor) params.cursor = cursor;\n const result = await this.request<ToolsListResult>('tools/list', params);\n tools.push(...(result.tools ?? []));\n cursor = result.nextCursor;\n if (filters?.limit && tools.length >= filters.limit) return tools.slice(0, filters.limit);\n } while (cursor);\n return tools;\n }\n\n async describeTool(toolKey: string): Promise<McpTool | undefined> {\n const byKey = await this.listTools({ toolKey });\n if (byKey.length > 0) return byKey.find((tool) => tool.name === toolKey) ?? byKey[0];\n const all = await this.listTools();\n return all.find((tool) => tool.name === toolKey);\n }\n\n callTool(name: string, args: Record<string, unknown>, options?: RpcCallOptions, control?: ConfirmationControl): Promise<ToolCallResult> {\n return this.request<ToolCallResult>('tools/call', {\n name,\n arguments: args,\n ...(control?.confirmationRequestId\n ? { _meta: { 'com.experiture.xyra/confirmationRequestId': control.confirmationRequestId } }\n : {}),\n }, options);\n }\n\n listConfirmations(params: { status?: string[]; toolKey?: string; limit?: number; includeAll?: boolean } = {}): Promise<ConfirmationListResult> {\n this.assertConfirmationExtension();\n return this.request<ConfirmationListResult>('xyra/confirmations/list', params);\n }\n\n getConfirmation(id: string): Promise<Record<string, unknown>> {\n this.assertConfirmationExtension();\n return this.request('xyra/confirmations/get', { id });\n }\n\n approveConfirmation(id: string): Promise<Record<string, unknown>> {\n this.assertConfirmationExtension();\n return this.request('xyra/confirmations/approve', { id });\n }\n\n rejectConfirmation(id: string, reason?: string): Promise<Record<string, unknown>> {\n this.assertConfirmationExtension();\n return this.request('xyra/confirmations/reject', { id, ...(reason ? { reason } : {}) });\n }\n\n cancelConfirmation(id: string): Promise<Record<string, unknown>> {\n this.assertConfirmationExtension();\n return this.request('xyra/confirmations/cancel', { id });\n }\n\n chat(params: McpChatRequest): Promise<McpChatResult> {\n this.assertChatExtension();\n return this.request<McpChatResult>('xyra/chat', params as unknown as Record<string, unknown>);\n }\n}\n", "import crypto from 'node:crypto';\nimport { context, trace, TraceFlags, type Context } from '@opentelemetry/api';\nimport { W3CTraceContextPropagator } from '@opentelemetry/core';\nimport type { OutputWriter } from '../output/console';\n\nexport interface LatencyPhaseRecord {\n name: string;\n durationMs: number;\n metadata?: Record<string, string | number | boolean>;\n}\n\nexport interface LatencyLinkage {\n traceId?: string;\n correlationId?: string;\n serverTiming?: string;\n}\n\nexport interface LatencyReport {\n schemaVersion: 1;\n generatedAt: string;\n totalDurationMs: number;\n phases: LatencyPhaseRecord[];\n linkage: LatencyLinkage;\n}\n\ntype LatencyMode = 'human' | 'json';\n\nlet configuredMode: LatencyMode | undefined;\nlet activeDiagnostics: LatencyDiagnostics | undefined;\n\nfunction elapsedMs(startedAt: number): number {\n return Math.round((performance.now() - startedAt) * 100) / 100;\n}\n\nfunction validTraceId(value: string | null): value is string {\n return Boolean(value && /^[0-9a-f]{32}$/i.test(value) && !/^0{32}$/.test(value));\n}\n\nexport class LatencyDiagnostics {\n private readonly startedAt = performance.now();\n private readonly records: LatencyPhaseRecord[] = [];\n private readonly linkage: LatencyLinkage = {};\n private readonly traceContext: Context;\n\n constructor(readonly mode: LatencyMode) {\n const traceId = crypto.randomBytes(16).toString('hex');\n const spanId = crypto.randomBytes(8).toString('hex');\n this.linkage.traceId = traceId;\n this.traceContext = trace.setSpanContext(context.active(), {\n traceId,\n spanId,\n traceFlags: TraceFlags.SAMPLED,\n isRemote: false,\n });\n }\n\n async measure<T>(\n name: string,\n fn: () => Promise<T> | T,\n metadata?: Record<string, string | number | boolean>,\n ): Promise<T> {\n const startedAt = performance.now();\n try {\n return await fn();\n } finally {\n this.records.push({ name, durationMs: elapsedMs(startedAt), ...(metadata ? { metadata } : {}) });\n }\n }\n\n record(name: string, durationMs: number, metadata?: Record<string, string | number | boolean>): void {\n this.records.push({ name, durationMs: Math.round(durationMs * 100) / 100, ...(metadata ? { metadata } : {}) });\n }\n\n injectTraceHeaders(headers: Headers): void {\n new W3CTraceContextPropagator().inject(this.traceContext, headers, {\n set(carrier, key, value) {\n carrier.set(key, value);\n },\n });\n }\n\n observeResponseHeaders(headers: Headers): void {\n const serverTraceId = headers.get('x-trace-id');\n if (validTraceId(serverTraceId)) this.linkage.traceId = serverTraceId.toLowerCase();\n const correlationId = headers.get('x-correlation-id');\n if (correlationId) this.linkage.correlationId = correlationId;\n const serverTiming = headers.get('server-timing');\n if (serverTiming) this.linkage.serverTiming = serverTiming;\n }\n\n report(): LatencyReport {\n return {\n schemaVersion: 1,\n generatedAt: new Date().toISOString(),\n totalDurationMs: elapsedMs(this.startedAt),\n phases: [...this.records],\n linkage: { ...this.linkage },\n };\n }\n}\n\nexport function configureLatencyDiagnostics(options: { timings?: boolean; timingsJson?: boolean }): void {\n configuredMode = options.timingsJson ? 'json' : options.timings ? 'human' : undefined;\n}\n\nexport function beginLatencyDiagnostics(): LatencyDiagnostics | undefined {\n activeDiagnostics = configuredMode ? new LatencyDiagnostics(configuredMode) : undefined;\n return activeDiagnostics;\n}\n\nexport function getLatencyDiagnostics(): LatencyDiagnostics | undefined {\n return activeDiagnostics;\n}\n\nexport function endLatencyDiagnostics(): void {\n activeDiagnostics = undefined;\n}\n\nexport async function measureLatencyPhase<T>(\n name: string,\n fn: () => Promise<T> | T,\n metadata?: Record<string, string | number | boolean>,\n): Promise<T> {\n return activeDiagnostics\n ? activeDiagnostics.measure(name, fn, metadata)\n : fn();\n}\n\nexport function createTimedOutputWriter(writer: OutputWriter): OutputWriter {\n return {\n out(message) {\n const startedAt = performance.now();\n try {\n writer.out(message);\n } finally {\n activeDiagnostics?.record('output.render', elapsedMs(startedAt), { stream: 'stdout' });\n }\n },\n err(message) {\n const startedAt = performance.now();\n try {\n writer.err(message);\n } finally {\n activeDiagnostics?.record('output.render', elapsedMs(startedAt), { stream: 'stderr' });\n }\n },\n };\n}\n\nexport function emitLatencyDiagnostics(diagnostics: LatencyDiagnostics, writer: OutputWriter): void {\n const report = diagnostics.report();\n if (diagnostics.mode === 'json') {\n writer.err(JSON.stringify(report));\n return;\n }\n const rows = report.phases.map((phase) => ` ${phase.name}: ${phase.durationMs.toFixed(2)} ms`);\n writer.err([\n `Latency diagnostics: ${report.totalDurationMs.toFixed(2)} ms total`,\n ...rows,\n ...(report.linkage.serverTiming ? [` server-timing: ${report.linkage.serverTiming}`] : []),\n ...(report.linkage.traceId ? [` trace-id: ${report.linkage.traceId}`] : []),\n ...(report.linkage.correlationId ? [` correlation-id: ${report.linkage.correlationId}`] : []),\n ].join('\\n'));\n}\n"],
|
|
5
|
-
"mappings": "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
|
|
4
|
+
"sourcesContent": ["import type { XyraRuntimeIdentityV2 } from './context';\n\n/** A requested maintenance target. It is never a runtime identity or an authorization decision. */\nexport type XyraAdministrationTargetV1 =\n | Readonly<{ targetKind: 'global-resource'; managedProductId: 'xyra-ai' }>\n | Readonly<{ targetKind: 'configuration-owner'; configurationTenantId: string; managedProductId: string }>\n | Readonly<{ targetKind: 'customer-resource'; targetTenantId: string; activeProductId: string }>;\n\n/** Selects a candidate from verified runtime facts. Auth must still admit the exact action. */\nexport function runtimeAdministrationTarget(identity: XyraRuntimeIdentityV2): XyraAdministrationTargetV1 {\n return identity.licenseSourceProductId !== identity.licensedProductId\n && identity.tenantId === identity.licenseOwnerTenantId\n ? { targetKind: 'configuration-owner', configurationTenantId: identity.licenseOwnerTenantId,\n managedProductId: identity.licenseSourceProductId }\n : { targetKind: 'customer-resource', targetTenantId: identity.tenantId, activeProductId: identity.productId };\n}\n\nexport type XyraAccessPurposeV1 = 'runtime' | 'administration';\nexport type XyraAuthorityDecisionPhaseV1 = 'discovery' | 'execution';\nexport type XyraConfigurationAccess = 'read' | 'manage' | 'manage_selection';\n\nexport type XyraAdministrationRequestV1 = Readonly<{\n operationId: string;\n target: XyraAdministrationTargetV1;\n}>;\n\n/** Auth-resolved relationship facts, without a permission snapshot or runtime licence grant. */\nexport type XyraAdministrationResolvedTargetV1 =\n | Readonly<{ targetKind: 'global-resource'; managedProductId: 'xyra-ai'; relationshipKind: 'global-resource' }>\n | Readonly<{ targetKind: 'configuration-owner' | 'customer-resource'; managedProductId: string;\n relationshipKind: 'native-product-tenant'; activeProductId: 'xyra-ai'; actualTenantId: string;\n licensedProductId: 'xyra-ai'; commercialState: string }>\n | Readonly<{ targetKind: 'configuration-owner' | 'customer-resource'; managedProductId: string;\n relationshipKind: 'embedded-product-entitlement'; activeProductId: string; actualTenantId: string;\n licenseSourceProductId: string; licensedProductId: 'xyra-ai'; licenseOwnerTenantId: string;\n bindingId: string; entitlementId: string; sourceEntitlementId: string; commercialState: string }>;\n\nexport type XyraAdministrationDecisionV1 = Readonly<{\n operationId: string;\n purpose: XyraAuthorityDecisionPhaseV1;\n accessPurpose: 'administration';\n allowed: boolean;\n code: string;\n productId: 'xyra-ai';\n operatorTenantId: string | null;\n targetTenantId: string | null;\n grantId: string | null;\n target: XyraAdministrationTargetV1;\n resolvedTarget: XyraAdministrationResolvedTargetV1 | null;\n /** Optional Auth-owned projection requested during a rolling service release. */\n configurationAccess?: XyraConfigurationAccess;\n}>;\n\n/** Protected execution/approval scope, not a permission grant and never a public argument. */\nexport type XyraAdministrationExecutionScopeV1 = Readonly<{\n accessPurpose: 'administration';\n resourceAudience: string;\n administrationTransport: 'native-http' | 'delegated-oauth';\n actorOperatorTenantId: string | null;\n targetHash: string;\n target: XyraAdministrationTargetV1;\n resolvedTarget: XyraAdministrationResolvedTargetV1;\n}>;\n\nconst identifier = (value: unknown): value is string => typeof value === 'string'\n && /^[A-Za-z0-9][A-Za-z0-9._:-]{0,49}$/.test(value);\nconst guid = (value: unknown): value is string => typeof value === 'string'\n && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i.test(value)\n && value !== '00000000-0000-0000-0000-000000000000';\nconst record = (value: unknown): value is Record<string, unknown> => value !== null\n && typeof value === 'object' && !Array.isArray(value);\nconst exact = (value: Record<string, unknown>, keys: readonly string[]): boolean =>\n Object.keys(value).length === keys.length && keys.every(key => Object.prototype.hasOwnProperty.call(value, key));\n\n/** Strictly parse the closed object shape; raw duplicate JSON keys belong to the transport parser. */\nexport function parseXyraAdministrationTargetV1(value: unknown): XyraAdministrationTargetV1 | null {\n if (!record(value)) return null;\n if (value.targetKind === 'global-resource' && exact(value, ['targetKind', 'managedProductId'])\n && value.managedProductId === 'xyra-ai') {\n return { targetKind: 'global-resource', managedProductId: 'xyra-ai' };\n }\n if (value.targetKind === 'configuration-owner'\n && exact(value, ['targetKind', 'configurationTenantId', 'managedProductId'])\n && identifier(value.configurationTenantId) && identifier(value.managedProductId)) {\n return { targetKind: 'configuration-owner', configurationTenantId: value.configurationTenantId,\n managedProductId: value.managedProductId };\n }\n if (value.targetKind === 'customer-resource'\n && exact(value, ['targetKind', 'targetTenantId', 'activeProductId'])\n && identifier(value.targetTenantId) && identifier(value.activeProductId)) {\n return { targetKind: 'customer-resource', targetTenantId: value.targetTenantId, activeProductId: value.activeProductId };\n }\n return null;\n}\n\n/** Stable exact tuple for cache/request binding, excluding display text and mutable capabilities. */\nexport function xyraAdministrationTargetKeyV1(target: XyraAdministrationTargetV1): string {\n return JSON.stringify(target.targetKind === 'global-resource'\n ? [target.targetKind, target.managedProductId]\n : target.targetKind === 'configuration-owner'\n ? [target.targetKind, target.configurationTenantId, target.managedProductId]\n : [target.targetKind, target.targetTenantId, target.activeProductId]);\n}\n\n/** Validate independent Auth facts against the exact request, never infer a missing relationship. */\nexport function parseXyraAdministrationResolvedTargetV1(\n value: unknown, target: XyraAdministrationTargetV1,\n): XyraAdministrationResolvedTargetV1 | null {\n if (!record(value) || value.targetKind !== target.targetKind) return null;\n const managedProductId = target.targetKind === 'customer-resource' ? 'xyra-ai' : target.managedProductId;\n if (value.managedProductId !== managedProductId) return null;\n if (target.targetKind === 'global-resource') {\n return exact(value, ['targetKind', 'managedProductId', 'relationshipKind']) && value.relationshipKind === 'global-resource'\n ? { targetKind: 'global-resource', managedProductId: 'xyra-ai', relationshipKind: 'global-resource' } : null;\n }\n const base = ['targetKind', 'managedProductId', 'relationshipKind', 'activeProductId', 'actualTenantId', 'licensedProductId', 'commercialState'];\n const embedded = ['licenseSourceProductId', 'licenseOwnerTenantId', 'bindingId', 'entitlementId', 'sourceEntitlementId'];\n const isNative = value.relationshipKind === 'native-product-tenant';\n if ((!isNative && value.relationshipKind !== 'embedded-product-entitlement')\n || !exact(value, isNative ? base : [...base, ...embedded]) || value.licensedProductId !== 'xyra-ai'\n || !base.filter(key => !['targetKind', 'relationshipKind'].includes(key)).every(key => identifier(value[key]))\n || (isNative ? value.activeProductId !== 'xyra-ai' : !embedded.every(key => identifier(value[key])))\n || value.actualTenantId !== (target.targetKind === 'customer-resource' ? target.targetTenantId : target.configurationTenantId)\n || (target.targetKind === 'customer-resource' && value.activeProductId !== target.activeProductId)\n || (target.targetKind === 'configuration-owner' && value.activeProductId !== target.managedProductId)\n || (!isNative && (value.activeProductId !== value.licenseSourceProductId && value.activeProductId !== value.licensedProductId\n || !['bindingId', 'entitlementId', 'sourceEntitlementId'].every(key => guid(value[key]))\n || (target.targetKind === 'configuration-owner' && (value.licenseOwnerTenantId !== target.configurationTenantId\n || value.licenseSourceProductId !== target.managedProductId))))) return null;\n return { ...value } as XyraAdministrationResolvedTargetV1;\n}\n\n/** Parse a decision only for the operation, phase and target that were actually requested. */\nexport function parseXyraAdministrationDecisionV1(value: unknown,\n request: XyraAdministrationRequestV1, purpose: XyraAuthorityDecisionPhaseV1,\n): XyraAdministrationDecisionV1 | null {\n if (!record(value) || !exact(value, ['operationId', 'purpose', 'accessPurpose', 'allowed', 'code', 'productId',\n 'operatorTenantId', 'targetTenantId', 'grantId', 'target', 'resolvedTarget',\n ...(Object.prototype.hasOwnProperty.call(value, 'configurationAccess') ? ['configurationAccess'] : [])])\n || (value.configurationAccess !== undefined && !['read', 'manage', 'manage_selection'].includes(String(value.configurationAccess)))\n || value.operationId !== request.operationId || value.purpose !== purpose || value.accessPurpose !== 'administration'\n || value.productId !== 'xyra-ai' || typeof value.allowed !== 'boolean' || typeof value.code !== 'string'\n || !/^[A-Z0-9_.]{1,160}$/.test(value.code)\n || !(value.operatorTenantId === null || identifier(value.operatorTenantId))\n || !(value.grantId === null || guid(value.grantId))) return null;\n const target = parseXyraAdministrationTargetV1(value.target);\n if (!target || xyraAdministrationTargetKeyV1(target) !== xyraAdministrationTargetKeyV1(request.target)\n || value.targetTenantId !== (target.targetKind === 'global-resource' ? null\n : target.targetKind === 'configuration-owner' ? target.configurationTenantId : target.targetTenantId)) return null;\n const resolvedTarget = parseXyraAdministrationResolvedTargetV1(value.resolvedTarget, target);\n if (value.allowed) {\n if (!resolvedTarget) return null;\n if (value.code === 'AUTHORIZATION.ALLOWED.SAME_TENANT') {\n if (target.targetKind !== 'customer-resource' || value.operatorTenantId !== target.targetTenantId\n || value.grantId !== null) return null;\n } else if (value.code === 'AUTHORIZATION.ALLOWED.SUPER_USER'\n ? value.operatorTenantId !== null || value.grantId !== null\n : !['AUTHORIZATION.ALLOWED', 'AUTHORIZATION.ALLOWED.LICENSEE'].includes(value.code) || value.operatorTenantId === null || value.grantId === null) return null;\n if (value.code === 'AUTHORIZATION.ALLOWED.LICENSEE'\n && (target.targetKind === 'global-resource' || resolvedTarget.relationshipKind !== 'embedded-product-entitlement'\n || resolvedTarget.licenseOwnerTenantId !== value.operatorTenantId)) return null;\n } else if (value.code.startsWith('AUTHORIZATION.ALLOWED') || value.resolvedTarget !== null) return null;\n return { ...value, target, resolvedTarget } as XyraAdministrationDecisionV1;\n}\n", "import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport type { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport { ResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport type {\n XyraRuntimeActionDescriptor,\n XyraPendingHumanApprovalV1,\n XyraRuntimeResponse,\n XyraRuntimeStreamOutcome,\n XyraRuntimeTurnStatusV1,\n XyraHumanApprovalViewV1,\n} from '@experiture/xyra-runtime-client';\nimport { CliError, CliErrorCodes } from '../errors/CliError';\nimport { McpRpcError } from './mcpError';\nimport { measureLatencyPhase } from '../diagnostics/latency';\nimport {parseXyraAdministrationTargetV1,type XyraAdministrationTargetV1}from'@xyra/types/xyra-administration';\nimport type { XyraGovernanceApprovalContinuationV1 } from '@xyra/types';\n\nexport interface RpcCallOptions {\n /** Exact JSON-RPC envelope captured from a JSON Streamable HTTP response. */\n captureRaw?: (raw: unknown) => void;\n}\n\nexport class McpRawResponseCapture {\n private callback?: (raw: unknown) => void;\n\n begin(callback?: (raw: unknown) => void): void {\n this.callback = callback;\n }\n\n end(): void {\n this.callback = undefined;\n }\n\n async observe(response: Response): Promise<void> {\n if (!this.callback || !response.headers.get('content-type')?.includes('application/json')) return;\n try {\n this.callback(await response.clone().json());\n } catch {\n // The SDK remains the protocol authority; raw capture is diagnostic only.\n }\n }\n}\n\nexport interface McpTool {\n name: string;\n title?: string;\n description?: string;\n inputSchema?: unknown;\n outputSchema?: unknown;\n annotations?: Record<string, unknown>;\n _meta?: Record<string, unknown>;\n}\n\ninterface ToolsListResult {\n tools: McpTool[];\n nextCursor?: string;\n}\n\nexport interface ToolCallResult {\n content?: unknown;\n structuredContent?: unknown;\n isError?: boolean;\n [key: string]: unknown;\n}\n\nexport interface ConfirmationControl {\n conversationId?: string;\n confirmationRequestId?: string;\n workflowResume?: {executionId:string;expectedRevision:number;continueCorrection?:true;guidance?:string};\n}\n\n/** Resume only the checkpoint revision published by the existing execution owner. */\nexport function workflowResumeControlFor(result: ToolCallResult, toolKey: string, executionId: string): { workflowResume: NonNullable<ConfirmationControl['workflowResume']> } | undefined {\n const envelope = result.structuredContent as { continuation?: unknown } | undefined;\n const metadata = result._meta as Record<string, unknown> | undefined;\n const value = envelope?.continuation ?? metadata?.['com.experiture.xyra/workflowContinuation'];\n if (!value || typeof value !== 'object' || Array.isArray(value)) return undefined;\n const reference = value as Record<string, unknown>;\n if (reference.executionId !== executionId || reference.toolKey !== toolKey\n || !Number.isSafeInteger(reference.revision) || Number(reference.revision) < 0) return undefined;\n return { workflowResume: { executionId, expectedRevision: Number(reference.revision) } };\n}\n\nexport function validateToolConversationId(value: string | undefined): string | undefined {\n if (value !== undefined && (typeof value !== 'string' || value !== value.trim() || !/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value))) {\n throw new CliError(CliErrorCodes.InvalidArguments, '--conversation must be a conversation UUID.');\n }\n return value;\n}\n\nexport interface ConfirmationListResult {\n confirmations: Record<string, unknown>[];\n count: number;\n}\n\nexport interface McpChatRequest {\n conversationId?: string;\n createConversation?: boolean;\n title?: string;\n message: string;\n locale?: 'en' | 'fr' | 'zh-Hans';\n clientRequestId?: string;\n}\n\nexport interface McpChatRecoveryResult {\n schemaVersion:1;mode:'observe';conversationId:string;clientRequestId:string;runtimeTurnId?:string;\n status:XyraRuntimeTurnStatusV1;outcome:XyraRuntimeStreamOutcome|'waiting';assistantMessageId?:string;message?:string;\n recovery:{state:'completed'|'waiting'|'denied'|'unavailable';code?:string};eventCount:0;chunkCount:0;\n}\n\nexport interface McpChatResult {\n schemaVersion: 1;\n conversationId: string;\n clientRequestId: string;\n requestId: string;\n executionId: string;\n streamId: string;\n traceId?: string;\n userMessageId: string;\n assistantMessageId?: string;\n outcome: XyraRuntimeStreamOutcome;\n message?: string;\n response?: XyraRuntimeResponse;\n error?: unknown;\n actions?: XyraRuntimeActionDescriptor[];\n pendingHumanApproval?: XyraPendingHumanApprovalV1;\n confirmation?: XyraHumanApprovalViewV1;\n eventCount: number;\n chunkCount: number;\n createdConversation?: {\n id: string;\n title: string;\n titleSource: string;\n createdAt: string;\n };\n}\n\nexport class McpClient {\n constructor(\n private readonly sdk: Client,\n private readonly transport: StreamableHTTPClientTransport,\n private readonly rawCapture?: McpRawResponseCapture,\n private readonly administrationTarget?:XyraAdministrationTargetV1,\n ) {\n if(administrationTarget){\n const selected=parseXyraAdministrationTargetV1(administrationTarget);\n if(!selected)throw new McpRpcError({code:-32602,message:'Select one closed administration target.',data:{xyraCode:'XYRA.MCP.REQUEST_INVALID'}});\n this.administrationTarget=selected;\n }\n }\n\n initialize(): unknown {\n return {\n protocolVersion: this.transport.protocolVersion,\n capabilities: this.sdk.getServerCapabilities() ?? {},\n serverInfo: this.sdk.getServerVersion() ?? {},\n instructions: this.sdk.getInstructions(),\n };\n }\n\n private async request<T>(method: string, params: Record<string, unknown> = {}, options?: RpcCallOptions): Promise<T> {\n if(this.administrationTarget){\n if(method==='xyra/chat'||['xyra/confirmations/approve','xyra/confirmations/reject','xyra/confirmations/cancel','xyra/confirmations/continue'].includes(method))\n throw new McpRpcError({code:-32602,message:'Administrative delegated sessions cannot run chat or decide approvals.',data:{xyraCode:'XYRA.AUTH.INSUFFICIENT_PERMISSIONS'}});\n if(method==='tools/list'||method==='tools/call')params={...params,target:this.administrationTarget};\n }\n this.rawCapture?.begin(options?.captureRaw);\n try {\n return await measureLatencyPhase(\n 'mcp.method',\n () => this.sdk.request({ method, params } as never, ResultSchema) as Promise<T>,\n { method },\n );\n } catch (error) {\n throw McpRpcError.from(error) ?? error;\n } finally {\n this.rawCapture?.end();\n }\n }\n\n private assertConfirmationExtension(method?: string): void {\n const experimental = this.sdk.getServerCapabilities()?.experimental;\n const extension = experimental?.['com.experiture.xyra.confirmations'] as Record<string, unknown> | undefined;\n if (extension?.version !== 1 || (method && (!Array.isArray(extension.methods) || !extension.methods.includes(method)))) {\n throw new McpRpcError({\n code: -32602,\n message: 'The server did not negotiate the Xyra confirmation extension.',\n data: { xyraCode: 'XYRA.MCP.EXTENSION_NOT_NEGOTIATED' },\n });\n }\n }\n\n private assertChatExtension(): void {\n const experimental = this.sdk.getServerCapabilities()?.experimental;\n const extension = experimental?.['com.experiture.xyra.chat'] as Record<string, unknown> | undefined;\n if (extension?.version !== 1) {\n throw new McpRpcError({\n code: -32602,\n message: 'The server did not negotiate the Xyra chat extension.',\n data: { xyraCode: 'XYRA.MCP.EXTENSION_NOT_NEGOTIATED' },\n });\n }\n }\n\n /** Page through every visible tool unless a hard limit is supplied. */\n async listTools(filters?: { domainId?: string; taskKey?: string; toolKey?: string; limit?: number }): Promise<McpTool[]> {\n const tools: McpTool[] = [];\n let cursor: string | undefined;\n do {\n const params: Record<string, unknown> = {};\n if(this.administrationTarget&&(filters?.domainId||filters?.taskKey))throw new McpRpcError({code:-32602,\n message:'Administrative discovery uses a closed target and optional exact tool key; runtime domain/task filters are not admission.',data:{xyraCode:'XYRA.MCP.REQUEST_INVALID'}});\n if (filters?.domainId) params.domainId = filters.domainId;\n if (filters?.taskKey) params.taskKey = filters.taskKey;\n if (filters?.toolKey) params.toolKey = filters.toolKey;\n if (cursor) params.cursor = cursor;\n const result = await this.request<ToolsListResult>('tools/list', params);\n tools.push(...(result.tools ?? []));\n cursor = result.nextCursor;\n if (filters?.limit && tools.length >= filters.limit) return tools.slice(0, filters.limit);\n } while (cursor);\n return tools;\n }\n\n async describeTool(toolKey: string): Promise<McpTool | undefined> {\n const byKey = await this.listTools({ toolKey });\n if (byKey.length > 0) return byKey.find((tool) => tool.name === toolKey) ?? byKey[0];\n const all = await this.listTools();\n return all.find((tool) => tool.name === toolKey);\n }\n\n callTool(name: string, args: Record<string, unknown>, options?: RpcCallOptions, control?: ConfirmationControl): Promise<ToolCallResult> {\n const conversationId = validateToolConversationId(control?.conversationId);\n return this.request<ToolCallResult>('tools/call', {\n ...(conversationId ? { conversationId } : {}),\n name,\n arguments: args,\n ...(control?.confirmationRequestId || control?.workflowResume ? { _meta: {\n ...(control.confirmationRequestId ? {'com.experiture.xyra/confirmationRequestId':control.confirmationRequestId}:{}),\n ...(control.workflowResume ? {'com.experiture.xyra/workflowResume':control.workflowResume}:{})} } : {}),\n }, options);\n }\n\n listConfirmations(params: { status?: string[]; toolKey?: string; limit?: number; includeAll?: boolean } = {}): Promise<ConfirmationListResult> {\n this.assertConfirmationExtension();\n return this.request<ConfirmationListResult>('xyra/confirmations/list', params);\n }\n\n getConfirmation(id: string): Promise<Record<string, unknown>> {\n this.assertConfirmationExtension();\n return this.request('xyra/confirmations/get', { id });\n }\n\n approveConfirmation(id: string): Promise<Record<string, unknown>> {\n this.assertConfirmationExtension();\n return this.request('xyra/confirmations/approve', { id });\n }\n\n rejectConfirmation(id: string, reason?: string): Promise<Record<string, unknown>> {\n this.assertConfirmationExtension();\n return this.request('xyra/confirmations/reject', { id, ...(reason ? { reason } : {}) });\n }\n\n cancelConfirmation(id: string): Promise<Record<string, unknown>> {\n this.assertConfirmationExtension();\n return this.request('xyra/confirmations/cancel', { id });\n }\n\n async continueGovernanceApproval(id: string, expected?: XyraGovernanceApprovalContinuationV1['continuation'], options?: RpcCallOptions): Promise<XyraGovernanceApprovalContinuationV1> {\n this.assertConfirmationExtension('xyra/confirmations/continue');\n const result = await this.request<XyraGovernanceApprovalContinuationV1>('xyra/confirmations/continue', { id }, options);\n if (result?.schemaVersion !== 1 || !['pending', 'completed', 'failed', 'canceled'].includes(result.status)\n || result.confirmation?.id !== id || result.continuation?.kind !== 'governance_change_set'\n || typeof result.continuation.changeSetId !== 'string' || !result.continuation.changeSetId\n || typeof result.continuation.changeSetHash !== 'string' || !result.continuation.changeSetHash\n || (expected && (result.continuation.changeSetId !== expected.changeSetId || result.continuation.changeSetHash !== expected.changeSetHash))\n || result.changeSet?.id !== result.continuation.changeSetId || (result.status === 'completed' && result.changeSet.status !== 'applied')) {\n throw new McpRpcError({ code: -32603, message: 'The governance continuation did not match its original approval and change set.',\n data: { xyraCode: 'XYRA.MCP.RESULT_SCHEMA_MISMATCH' } });\n }\n return result;\n }\n\n resumeChat(params:{conversationId:string;clientRequestId:string;control?:{resumeExecutionId:string;expectedRevision:number;guidance?:string}}):Promise<McpChatRecoveryResult> {\n this.assertChatExtension();\n return this.request<McpChatRecoveryResult>('xyra/chat',{...params,resumeRetainedWork:true});\n }\n\n getWorkflowProposal(params:{conversationId:string;clientRequestId:string;executionId:string;revision:number;stepKey:string}):Promise<import('@experiture/xyra-runtime-client').XyraWorkflowInputProposalV1> {\n this.assertChatExtension();const {conversationId,clientRequestId,...readProposal}=params;return this.request('xyra/chat',{conversationId,clientRequestId,readProposal});\n }\n\n stopChat(params:{conversationId:string;clientRequestId:string}):Promise<unknown> {\n this.assertChatExtension();return this.request('xyra/chat',{...params,stopRetainedWork:true});\n }\n\n chat(params: McpChatRequest): Promise<McpChatResult> {\n this.assertChatExtension();\n return this.request<McpChatResult>('xyra/chat', params as unknown as Record<string, unknown>);\n }\n}\n", "import crypto from 'node:crypto';\nimport { context, trace, TraceFlags, type Context } from '@opentelemetry/api';\nimport { W3CTraceContextPropagator } from '@opentelemetry/core';\nimport type { OutputWriter } from '../output/console';\n\nexport interface LatencyPhaseRecord {\n name: string;\n durationMs: number;\n metadata?: Record<string, string | number | boolean>;\n}\n\nexport interface LatencyLinkage {\n traceId?: string;\n correlationId?: string;\n serverTiming?: string;\n}\n\nexport interface LatencyReport {\n schemaVersion: 1;\n generatedAt: string;\n totalDurationMs: number;\n phases: LatencyPhaseRecord[];\n linkage: LatencyLinkage;\n}\n\ntype LatencyMode = 'human' | 'json';\n\nlet configuredMode: LatencyMode | undefined;\nlet activeDiagnostics: LatencyDiagnostics | undefined;\n\nfunction elapsedMs(startedAt: number): number {\n return Math.round((performance.now() - startedAt) * 100) / 100;\n}\n\nfunction validTraceId(value: string | null): value is string {\n return Boolean(value && /^[0-9a-f]{32}$/i.test(value) && !/^0{32}$/.test(value));\n}\n\nexport class LatencyDiagnostics {\n private readonly startedAt = performance.now();\n private readonly records: LatencyPhaseRecord[] = [];\n private readonly linkage: LatencyLinkage = {};\n private readonly traceContext: Context;\n\n constructor(readonly mode: LatencyMode) {\n const traceId = crypto.randomBytes(16).toString('hex');\n const spanId = crypto.randomBytes(8).toString('hex');\n this.linkage.traceId = traceId;\n this.traceContext = trace.setSpanContext(context.active(), {\n traceId,\n spanId,\n traceFlags: TraceFlags.SAMPLED,\n isRemote: false,\n });\n }\n\n async measure<T>(\n name: string,\n fn: () => Promise<T> | T,\n metadata?: Record<string, string | number | boolean>,\n ): Promise<T> {\n const startedAt = performance.now();\n try {\n return await fn();\n } finally {\n this.records.push({ name, durationMs: elapsedMs(startedAt), ...(metadata ? { metadata } : {}) });\n }\n }\n\n record(name: string, durationMs: number, metadata?: Record<string, string | number | boolean>): void {\n this.records.push({ name, durationMs: Math.round(durationMs * 100) / 100, ...(metadata ? { metadata } : {}) });\n }\n\n injectTraceHeaders(headers: Headers): void {\n new W3CTraceContextPropagator().inject(this.traceContext, headers, {\n set(carrier, key, value) {\n carrier.set(key, value);\n },\n });\n }\n\n observeResponseHeaders(headers: Headers): void {\n const serverTraceId = headers.get('x-trace-id');\n if (validTraceId(serverTraceId)) this.linkage.traceId = serverTraceId.toLowerCase();\n const correlationId = headers.get('x-correlation-id');\n if (correlationId) this.linkage.correlationId = correlationId;\n const serverTiming = headers.get('server-timing');\n if (serverTiming) this.linkage.serverTiming = serverTiming;\n }\n\n report(): LatencyReport {\n return {\n schemaVersion: 1,\n generatedAt: new Date().toISOString(),\n totalDurationMs: elapsedMs(this.startedAt),\n phases: [...this.records],\n linkage: { ...this.linkage },\n };\n }\n}\n\nexport function configureLatencyDiagnostics(options: { timings?: boolean; timingsJson?: boolean }): void {\n configuredMode = options.timingsJson ? 'json' : options.timings ? 'human' : undefined;\n}\n\nexport function beginLatencyDiagnostics(): LatencyDiagnostics | undefined {\n activeDiagnostics = configuredMode ? new LatencyDiagnostics(configuredMode) : undefined;\n return activeDiagnostics;\n}\n\nexport function getLatencyDiagnostics(): LatencyDiagnostics | undefined {\n return activeDiagnostics;\n}\n\nexport function endLatencyDiagnostics(): void {\n activeDiagnostics = undefined;\n}\n\nexport async function measureLatencyPhase<T>(\n name: string,\n fn: () => Promise<T> | T,\n metadata?: Record<string, string | number | boolean>,\n): Promise<T> {\n return activeDiagnostics\n ? activeDiagnostics.measure(name, fn, metadata)\n : fn();\n}\n\nexport function createTimedOutputWriter(writer: OutputWriter): OutputWriter {\n return {\n out(message) {\n const startedAt = performance.now();\n try {\n writer.out(message);\n } finally {\n activeDiagnostics?.record('output.render', elapsedMs(startedAt), { stream: 'stdout' });\n }\n },\n err(message) {\n const startedAt = performance.now();\n try {\n writer.err(message);\n } finally {\n activeDiagnostics?.record('output.render', elapsedMs(startedAt), { stream: 'stderr' });\n }\n },\n };\n}\n\nexport function emitLatencyDiagnostics(diagnostics: LatencyDiagnostics, writer: OutputWriter): void {\n const report = diagnostics.report();\n if (diagnostics.mode === 'json') {\n writer.err(JSON.stringify(report));\n return;\n }\n const rows = report.phases.map((phase) => ` ${phase.name}: ${phase.durationMs.toFixed(2)} ms`);\n writer.err([\n `Latency diagnostics: ${report.totalDurationMs.toFixed(2)} ms total`,\n ...rows,\n ...(report.linkage.serverTiming ? [` server-timing: ${report.linkage.serverTiming}`] : []),\n ...(report.linkage.traceId ? [` trace-id: ${report.linkage.traceId}`] : []),\n ...(report.linkage.correlationId ? [` correlation-id: ${report.linkage.correlationId}`] : []),\n ].join('\\n'));\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": ["exports", "parseXyraAdministrationTargetV1"]
|
|
7
7
|
}
|
|
@@ -58,6 +58,10 @@ function hasPresentationEnvelope(result) {
|
|
|
58
58
|
}
|
|
59
59
|
/** Human view of a tools/call result: presenter Markdown first, then legacy structured output. */
|
|
60
60
|
function formatToolResult(result) {
|
|
61
|
+
const envelope = result.structuredContent;
|
|
62
|
+
if (envelope?.status === 'requirements_unmet') {
|
|
63
|
+
return ['The requested operation was not started.', ...(envelope.requirements?.unmet ?? []).map(item => item.explanation).filter(Boolean), toJson(envelope)].join('\n');
|
|
64
|
+
}
|
|
61
65
|
const text = textContent(result);
|
|
62
66
|
if (text && hasPresentationEnvelope(result)) {
|
|
63
67
|
return text;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/output/formatters.ts"],"names":[],"mappings":";;AAIA,wBAEC;AAED,wCAOC;AAED,4CAaC;AA4BD,
|
|
1
|
+
{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/output/formatters.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@experiture/xyra-cli",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.4",
|
|
4
4
|
"description": "Xyra CLI - headless application runner over the Xyra MCP server and Auth delegated OAuth flow.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"private": false,
|
|
@@ -52,7 +52,7 @@
|
|
|
52
52
|
},
|
|
53
53
|
"devDependencies": {
|
|
54
54
|
"@experiture/xyra-provider-client": "^0.1.13",
|
|
55
|
-
"@experiture/xyra-runtime-client": "0.1.
|
|
55
|
+
"@experiture/xyra-runtime-client": "0.1.93",
|
|
56
56
|
"@jest/globals": "^29.7.0",
|
|
57
57
|
"@types/jest": "^29.5.0",
|
|
58
58
|
"@types/node": "^20.11.0",
|