@githits/mcp 0.20.0 → 0.22.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.
package/dist/client.d.ts CHANGED
@@ -1413,20 +1413,20 @@ interface DependencyReport {
1413
1413
  dependencyGroups?: DependencyGroupsInfo;
1414
1414
  }
1415
1415
  /**
1416
- * Inputs to `packageChangelog`. Addressing is "spec XOR repo-URL":
1417
- * either both `registry` and `packageName`, or `repoUrl` alone.
1418
- * The shared request builder enforces the XOR before reaching the
1419
- * service; the service layer trusts the contract.
1416
+ * Inputs to `packageChangelog`. Package-only: `registry` + `packageName`
1417
+ * are required. `version` selects one release via `packageInfo`;
1418
+ * otherwise the timeline `packageChangelog` query is used.
1420
1419
  */
1421
1420
  interface PackageChangelogParams {
1422
- /** Uppercase GraphQL registry enum value. Required with `packageName`. */
1423
- registry?: PkgseerRegistry;
1424
- /** Package name. Required with `registry`. */
1425
- packageName?: string;
1426
- /** GitHub repo URL. Mutually exclusive with `registry` + `packageName`. */
1427
- repoUrl?: string;
1428
- /** Branch or tag for CHANGELOG.md fetching. Ignored for GH Releases. */
1429
- gitRef?: string;
1421
+ /** Uppercase GraphQL registry enum value. */
1422
+ registry: PkgseerRegistry;
1423
+ /** Package name. */
1424
+ packageName: string;
1425
+ /**
1426
+ * Exact selected-release selector. When set, the service queries
1427
+ * `packageInfo.selectedVersion.changelog` and ignores range/limit.
1428
+ */
1429
+ version?: string;
1430
1430
  /**
1431
1431
  * Exclusive start of version range. When set, the backend returns every
1432
1432
  * entry after `fromVersion` through `toVersion` (or latest); `limit` is
@@ -1448,7 +1448,6 @@ interface PackageChangelogParams {
1448
1448
  interface ChangelogPackageInfo {
1449
1449
  name?: string;
1450
1450
  registry?: string;
1451
- repoUrl?: string;
1452
1451
  fromVersion?: string;
1453
1452
  toVersion?: string;
1454
1453
  limit?: number;
@@ -1460,6 +1459,8 @@ interface ChangelogEntryDetail {
1460
1459
  body?: string;
1461
1460
  htmlUrl?: string;
1462
1461
  publishedAt?: string;
1462
+ /** Present for exact selected-release results. */
1463
+ hasChangelog?: boolean;
1463
1464
  }
1464
1465
  interface ChangelogReport {
1465
1466
  /** Echo of addressing + filter as the backend saw it. */
@@ -1599,7 +1600,10 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
1599
1600
  private normaliseDependencyIssuesSummary;
1600
1601
  packageChangelog(params: PackageChangelogParams): Promise<ChangelogReport>;
1601
1602
  private executePackageChangelog;
1602
- private normaliseChangelogReport;
1603
+ private executeTimelinePackageChangelog;
1604
+ private executeExactPackageChangelog;
1605
+ private normaliseTimelineChangelogReport;
1606
+ private normaliseExactChangelogReport;
1603
1607
  listPackageDocs(params: ListPackageDocsParams): Promise<PackageDocsList>;
1604
1608
  private executeListPackageDocs;
1605
1609
  private normalisePackageDocsList;
@@ -1609,6 +1613,7 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
1609
1613
  interface ReadParams {
1610
1614
  target: string;
1611
1615
  path?: string;
1616
+ selector?: string;
1612
1617
  startLine?: number;
1613
1618
  endLine?: number;
1614
1619
  waitTimeoutMs?: number;
@@ -1621,7 +1626,38 @@ interface ReadDocsResult {
1621
1626
  source: "docs";
1622
1627
  result: PackageDocResult;
1623
1628
  }
1624
- type ReadResult = ReadCodeResult | ReadDocsResult;
1629
+ interface CodeSymbolCandidate {
1630
+ name: string | null;
1631
+ qualifiedPath: string | null;
1632
+ kind: string | null;
1633
+ arity: number | null;
1634
+ filePath: string | null;
1635
+ startLine: number | null;
1636
+ endLine: number | null;
1637
+ }
1638
+ interface CodeSymbolSuggestion {
1639
+ name: string;
1640
+ qualifiedPath: string | null;
1641
+ localId: string | null;
1642
+ arity: number | null;
1643
+ filePath: string | null;
1644
+ reason: string | null;
1645
+ }
1646
+ interface CodeSymbolResolution {
1647
+ status: "AMBIGUOUS" | "NOT_FOUND" | "SNAPSHOT_UNSUPPORTED";
1648
+ candidates: CodeSymbolCandidate[];
1649
+ suggestions: CodeSymbolSuggestion[];
1650
+ hasMore: boolean;
1651
+ repoUrl: string;
1652
+ gitRef: string;
1653
+ message: string | null;
1654
+ codeIndexState: string;
1655
+ }
1656
+ interface ReadSymbolResolutionResult {
1657
+ source: "symbol_resolution";
1658
+ result: CodeSymbolResolution;
1659
+ }
1660
+ type ReadResult = ReadCodeResult | ReadDocsResult | ReadSymbolResolutionResult;
1625
1661
  interface ReadService {
1626
1662
  read(params: ReadParams): Promise<ReadResult>;
1627
1663
  }
@@ -1663,4 +1699,4 @@ declare class RefreshingGitHitsService implements GitHitsService {
1663
1699
  */
1664
1700
  private withTokenRefresh;
1665
1701
  }
1666
- export { AgentInfo, CodeDiffError, CodeDiffErrorDetails, CodeDiffErrorRef, CodeDiffMode, CodeDiffOptions, CodeDiffPackageInfo, CodeDiffPackageTarget, CodeDiffParams, CodeDiffPartialResult, CodeDiffRefKind, CodeDiffRefResolution, CodeDiffRepositoryTarget, CodeDiffResult, CodeDiffService, CodeDiffTarget, CodeDiffVersionSource, CodeNavigationService, CodeNavigationServiceImpl, ContentModification, ContentSafety, DEFAULT_API_URL, DEFAULT_CODE_NAV_URL, DEFAULT_MCP_URL, GitHitsService, GitHitsServiceImpl, PKGSEER_REGISTRY_LIST, PackageIntelligenceService, PackageIntelligenceServiceImpl, RawCodeDiff, RawCodeDiffContentCoverage, RawCodeDiffContentFailure, RawCodeDiffFile, RawCodeDiffFileContentStatus, RawCodeDiffFileStatus, RawCodeDiffPathEncoding, RawCodeDiffScope, RawCodeDiffScopeStatus, RawCodeDiffSummary, ReadCodeResult, ReadDocsResult, ReadParams, ReadResult, ReadService, ReadServiceImpl, RefreshingGitHitsService, ServiceDiagnostics, TokenProvider, createClientHeaderBuilder, createStaticTokenProvider, getApiUrl, getCodeNavigationUrl, getEnvApiToken, getMcpUrl, toPkgseerRegistry, toPkgseerRegistryLowercase };
1702
+ export { AgentInfo, CodeDiffError, CodeDiffErrorDetails, CodeDiffErrorRef, CodeDiffMode, CodeDiffOptions, CodeDiffPackageInfo, CodeDiffPackageTarget, CodeDiffParams, CodeDiffPartialResult, CodeDiffRefKind, CodeDiffRefResolution, CodeDiffRepositoryTarget, CodeDiffResult, CodeDiffService, CodeDiffTarget, CodeDiffVersionSource, CodeNavigationService, CodeNavigationServiceImpl, CodeSymbolCandidate, CodeSymbolResolution, CodeSymbolSuggestion, ContentModification, ContentSafety, DEFAULT_API_URL, DEFAULT_CODE_NAV_URL, DEFAULT_MCP_URL, GitHitsService, GitHitsServiceImpl, PKGSEER_REGISTRY_LIST, PackageIntelligenceService, PackageIntelligenceServiceImpl, RawCodeDiff, RawCodeDiffContentCoverage, RawCodeDiffContentFailure, RawCodeDiffFile, RawCodeDiffFileContentStatus, RawCodeDiffFileStatus, RawCodeDiffPathEncoding, RawCodeDiffScope, RawCodeDiffScopeStatus, RawCodeDiffSummary, ReadCodeResult, ReadDocsResult, ReadParams, ReadResult, ReadService, ReadServiceImpl, ReadSymbolResolutionResult, RefreshingGitHitsService, ServiceDiagnostics, TokenProvider, createClientHeaderBuilder, createStaticTokenProvider, getApiUrl, getCodeNavigationUrl, getEnvApiToken, getMcpUrl, toPkgseerRegistry, toPkgseerRegistryLowercase };
package/dist/client.js CHANGED
@@ -1 +1 @@
1
- import{DEFAULT_MCP_URL2,DEFAULT_API_URL2,DEFAULT_CODE_NAV_URL2,getMcpUrl2,getApiUrl2,getCodeNavigationUrl2,getEnvApiToken2,GitHitsServiceImpl2,PackageIntelligenceServiceImpl2,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,CodeDiffError2,CodeNavigationServiceImpl2,ReadServiceImpl2,RefreshingGitHitsService2,createStaticTokenProvider2,createClientHeaderBuilder2}from"./shared/chunk-d30a8smh.js";export{CodeDiffError2 as CodeDiffError,CodeNavigationServiceImpl2 as CodeNavigationServiceImpl,DEFAULT_API_URL2 as DEFAULT_API_URL,DEFAULT_CODE_NAV_URL2 as DEFAULT_CODE_NAV_URL,DEFAULT_MCP_URL2 as DEFAULT_MCP_URL,GitHitsServiceImpl2 as GitHitsServiceImpl,PKGSEER_REGISTRY_LIST2 as PKGSEER_REGISTRY_LIST,PackageIntelligenceServiceImpl2 as PackageIntelligenceServiceImpl,ReadServiceImpl2 as ReadServiceImpl,RefreshingGitHitsService2 as RefreshingGitHitsService,createClientHeaderBuilder2 as createClientHeaderBuilder,createStaticTokenProvider2 as createStaticTokenProvider,getApiUrl2 as getApiUrl,getCodeNavigationUrl2 as getCodeNavigationUrl,getEnvApiToken2 as getEnvApiToken,getMcpUrl2 as getMcpUrl,toPkgseerRegistry2 as toPkgseerRegistry,toPkgseerRegistryLowercase2 as toPkgseerRegistryLowercase};
1
+ import{DEFAULT_MCP_URL2,DEFAULT_API_URL2,DEFAULT_CODE_NAV_URL2,getMcpUrl2,getApiUrl2,getCodeNavigationUrl2,getEnvApiToken2,GitHitsServiceImpl2,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,PackageIntelligenceServiceImpl2,CodeDiffError2,CodeNavigationServiceImpl2,ReadServiceImpl2,RefreshingGitHitsService2,createStaticTokenProvider2,createClientHeaderBuilder2}from"./shared/chunk-dc5q5dw3.js";export{CodeDiffError2 as CodeDiffError,CodeNavigationServiceImpl2 as CodeNavigationServiceImpl,DEFAULT_API_URL2 as DEFAULT_API_URL,DEFAULT_CODE_NAV_URL2 as DEFAULT_CODE_NAV_URL,DEFAULT_MCP_URL2 as DEFAULT_MCP_URL,GitHitsServiceImpl2 as GitHitsServiceImpl,PKGSEER_REGISTRY_LIST2 as PKGSEER_REGISTRY_LIST,PackageIntelligenceServiceImpl2 as PackageIntelligenceServiceImpl,ReadServiceImpl2 as ReadServiceImpl,RefreshingGitHitsService2 as RefreshingGitHitsService,createClientHeaderBuilder2 as createClientHeaderBuilder,createStaticTokenProvider2 as createStaticTokenProvider,getApiUrl2 as getApiUrl,getCodeNavigationUrl2 as getCodeNavigationUrl,getEnvApiToken2 as getEnvApiToken,getMcpUrl2 as getMcpUrl,toPkgseerRegistry2 as toPkgseerRegistry,toPkgseerRegistryLowercase2 as toPkgseerRegistryLowercase};
package/dist/index.d.ts CHANGED
@@ -1143,20 +1143,20 @@ interface DependencyReport {
1143
1143
  dependencyGroups?: DependencyGroupsInfo;
1144
1144
  }
1145
1145
  /**
1146
- * Inputs to `packageChangelog`. Addressing is "spec XOR repo-URL":
1147
- * either both `registry` and `packageName`, or `repoUrl` alone.
1148
- * The shared request builder enforces the XOR before reaching the
1149
- * service; the service layer trusts the contract.
1146
+ * Inputs to `packageChangelog`. Package-only: `registry` + `packageName`
1147
+ * are required. `version` selects one release via `packageInfo`;
1148
+ * otherwise the timeline `packageChangelog` query is used.
1150
1149
  */
1151
1150
  interface PackageChangelogParams {
1152
- /** Uppercase GraphQL registry enum value. Required with `packageName`. */
1153
- registry?: PkgseerRegistry;
1154
- /** Package name. Required with `registry`. */
1155
- packageName?: string;
1156
- /** GitHub repo URL. Mutually exclusive with `registry` + `packageName`. */
1157
- repoUrl?: string;
1158
- /** Branch or tag for CHANGELOG.md fetching. Ignored for GH Releases. */
1159
- gitRef?: string;
1151
+ /** Uppercase GraphQL registry enum value. */
1152
+ registry: PkgseerRegistry;
1153
+ /** Package name. */
1154
+ packageName: string;
1155
+ /**
1156
+ * Exact selected-release selector. When set, the service queries
1157
+ * `packageInfo.selectedVersion.changelog` and ignores range/limit.
1158
+ */
1159
+ version?: string;
1160
1160
  /**
1161
1161
  * Exclusive start of version range. When set, the backend returns every
1162
1162
  * entry after `fromVersion` through `toVersion` (or latest); `limit` is
@@ -1178,7 +1178,6 @@ interface PackageChangelogParams {
1178
1178
  interface ChangelogPackageInfo {
1179
1179
  name?: string;
1180
1180
  registry?: string;
1181
- repoUrl?: string;
1182
1181
  fromVersion?: string;
1183
1182
  toVersion?: string;
1184
1183
  limit?: number;
@@ -1190,6 +1189,8 @@ interface ChangelogEntryDetail {
1190
1189
  body?: string;
1191
1190
  htmlUrl?: string;
1192
1191
  publishedAt?: string;
1192
+ /** Present for exact selected-release results. */
1193
+ hasChangelog?: boolean;
1193
1194
  }
1194
1195
  interface ChangelogReport {
1195
1196
  /** Echo of addressing + filter as the backend saw it. */
@@ -1296,6 +1297,7 @@ interface PackageIntelligenceService {
1296
1297
  interface ReadParams {
1297
1298
  target: string;
1298
1299
  path?: string;
1300
+ selector?: string;
1299
1301
  startLine?: number;
1300
1302
  endLine?: number;
1301
1303
  waitTimeoutMs?: number;
@@ -1308,7 +1310,38 @@ interface ReadDocsResult {
1308
1310
  source: "docs";
1309
1311
  result: PackageDocResult;
1310
1312
  }
1311
- type ReadResult = ReadCodeResult | ReadDocsResult;
1313
+ interface CodeSymbolCandidate {
1314
+ name: string | null;
1315
+ qualifiedPath: string | null;
1316
+ kind: string | null;
1317
+ arity: number | null;
1318
+ filePath: string | null;
1319
+ startLine: number | null;
1320
+ endLine: number | null;
1321
+ }
1322
+ interface CodeSymbolSuggestion {
1323
+ name: string;
1324
+ qualifiedPath: string | null;
1325
+ localId: string | null;
1326
+ arity: number | null;
1327
+ filePath: string | null;
1328
+ reason: string | null;
1329
+ }
1330
+ interface CodeSymbolResolution {
1331
+ status: "AMBIGUOUS" | "NOT_FOUND" | "SNAPSHOT_UNSUPPORTED";
1332
+ candidates: CodeSymbolCandidate[];
1333
+ suggestions: CodeSymbolSuggestion[];
1334
+ hasMore: boolean;
1335
+ repoUrl: string;
1336
+ gitRef: string;
1337
+ message: string | null;
1338
+ codeIndexState: string;
1339
+ }
1340
+ interface ReadSymbolResolutionResult {
1341
+ source: "symbol_resolution";
1342
+ result: CodeSymbolResolution;
1343
+ }
1344
+ type ReadResult = ReadCodeResult | ReadDocsResult | ReadSymbolResolutionResult;
1312
1345
  interface ReadService {
1313
1346
  read(params: ReadParams): Promise<ReadResult>;
1314
1347
  }