@agentic-trust/agentic-trust-sdk 1.0.43

package/dist/schemaKb.d.ts

@@ -0,0 +1,12 @@
+/**
+ * GraphDB-backed (knowledge base) GraphQL schema (v2).
+ *
+ * This schema is intentionally aligned to the KB model:
+ * Agent → Identity → Descriptor → (assembled) ProtocolDescriptor.
+ *
+ * Used as reference for the discovery client; the live backend is introspected at runtime.
+ */
+import { type GraphQLSchema } from 'graphql';
+export declare const graphQLSchemaStringKb = "\n  type OasfSkill {\n    key: String!\n    nameKey: String\n    uid: Int\n    caption: String\n    extendsKey: String\n    category: String\n  }\n\n  type OasfDomain {\n    key: String!\n    nameKey: String\n    uid: Int\n    caption: String\n    extendsKey: String\n    category: String\n  }\n\n  type IntentType {\n    key: String!\n    label: String\n    description: String\n  }\n\n  type TaskType {\n    key: String!\n    label: String\n    description: String\n  }\n\n  type IntentTaskMapping {\n    intent: IntentType!\n    task: TaskType!\n    requiredSkills: [String!]!\n    optionalSkills: [String!]!\n  }\n\n  enum OrderDirection {\n    ASC\n    DESC\n  }\n\n  enum KbAgentOrderBy {\n    agentId8004\n    agentName\n    uaid\n    createdAtTime\n    updatedAtTime\n    trustLedgerTotalPoints\n    atiOverallScore\n    bestRank\n  }\n\n  input KbAgentWhereInput {\n    chainId: Int\n    agentIdentifierMatch: String\n    did8004: String\n    uaid: String\n    uaid_in: [String!]\n    agentName_contains: String\n    isSmartAgent: Boolean\n    hasA2a: Boolean\n    hasAssertions: Boolean\n    hasReviews: Boolean\n    hasValidations: Boolean\n    minReviewAssertionCount: Int\n    minValidationAssertionCount: Int\n  }\n\n  type KbAccount {\n    iri: ID!\n    chainId: Int\n    address: String\n    accountType: String # EOAAccount | SmartAccount | Account | (null/unknown)\n    didEthr: String\n  }\n\n  # Generic descriptor for core entities (protocols, endpoints, etc.)\n  type KbDescriptor {\n    iri: ID!\n    name: String\n    description: String\n    image: String\n  }\n\n  # Protocol descriptor payload (e.g. A2A agent-card.json)\n  type KbProtocolDescriptor {\n    iri: ID!\n    name: String\n    description: String\n    image: String\n    agentCardJson: String\n  }\n\n  type KbProtocol {\n    iri: ID!\n    protocol: String! # a2a | mcp | other\n    protocolVersion: String\n    serviceUrl: String\n    descriptor: KbProtocolDescriptor\n    skills: [String!]!\n    domains: [String!]!\n  }\n\n  type KbServiceEndpoint {\n    iri: ID!\n    name: String! # a2a | mcp | other\n    descriptor: KbDescriptor\n    protocol: KbProtocol!\n  }\n\n  type KbIdentityDescriptor {\n    iri: ID!\n    kind: String! # 8004 | ens | hol | nanda | other\n    name: String\n    description: String\n    image: String\n    registrationJson: String\n    nftMetadataJson: String\n    registeredBy: String\n    registryNamespace: String\n    skills: [String!]!\n    domains: [String!]!\n  }\n\n  # ERC-8122 registries (factory-deployed registries + registrars)\n  type KbAgentRegistry8122 {\n    iri: ID!\n    chainId: Int!\n    registryAddress: String!\n    registrarAddress: String\n    registryName: String\n    registryImplementationAddress: String\n    registrarImplementationAddress: String\n    registeredAgentCount: Int\n    lastAgentUpdatedAtTime: Int\n  }\n\n  # Agent identity record (may include multiple identities per agent, even multiple of the same kind).\n  interface KbAgentIdentity {\n    iri: ID!\n    kind: String! # 8004 | 8122 | ens | hol | other\n    did: String!\n    chainId: Int\n    descriptor: KbIdentityDescriptor\n    serviceEndpoints: [KbServiceEndpoint!]!\n  }\n\n  type KbIdentity8004 implements KbAgentIdentity {\n    iri: ID!\n    kind: String! # \"8004\"\n    did: String!\n    chainId: Int\n\n    did8004: String!\n    agentId8004: Int\n    isSmartAgent: Boolean\n\n    descriptor: KbIdentityDescriptor\n    serviceEndpoints: [KbServiceEndpoint!]!\n\n    ownerAccount: KbAccount\n    agentAccount: KbAccount\n    operatorAccount: KbAccount\n    walletAccount: KbAccount\n    ownerEOAAccount: KbAccount\n  }\n\n  type KbIdentity8122 implements KbAgentIdentity {\n    iri: ID!\n    kind: String! # \"8122\"\n    did: String!\n    chainId: Int\n\n    did8122: String!\n    agentId8122: String!\n    registryAddress: String\n    collectionName: String\n    registry: KbAgentRegistry8122\n    endpointType: String\n    endpoint: String\n\n    descriptor: KbIdentityDescriptor\n    serviceEndpoints: [KbServiceEndpoint!]!\n\n    ownerAccount: KbAccount\n    agentAccount: KbAccount\n  }\n\n  type KbIdentityEns implements KbAgentIdentity {\n    iri: ID!\n    kind: String! # \"ens\"\n    did: String!\n    chainId: Int\n\n    didEns: String!\n    ensName: String\n\n    descriptor: KbIdentityDescriptor\n    serviceEndpoints: [KbServiceEndpoint!]!\n  }\n\n  type KbIdentityHol implements KbAgentIdentity {\n    iri: ID!\n    kind: String! # \"hol\"\n    did: String!\n    chainId: Int\n\n    uaidHOL: String\n\n    descriptor: KbIdentityDescriptor\n    serviceEndpoints: [KbServiceEndpoint!]!\n  }\n\n  type KbIdentityOther implements KbAgentIdentity {\n    iri: ID!\n    kind: String!\n    did: String!\n    chainId: Int\n\n    descriptor: KbIdentityDescriptor\n    serviceEndpoints: [KbServiceEndpoint!]!\n  }\n\n  type KbHolAgentProfile {\n    uaid: String!\n    displayName: String\n    alias: String\n    bio: String\n    profileImage: String\n    profileJson: String\n  }\n\n  type KbHolCapability {\n    iri: ID!\n    key: String!\n    label: String\n    json: String\n  }\n\n  type KbHolSyncResult {\n    success: Boolean!\n    count: Int!\n    message: String\n  }\n\n  type KbHolRegistryCount {\n    registry: String!\n    agentCount: Int!\n  }\n\n  type KbHolCapabilityCount {\n    capability: String!\n    agentCount: Int!\n  }\n\n  type KbHolStats {\n    totalAgents: Int!\n    lastUpdate: String\n    status: String\n    registries: [KbHolRegistryCount!]!\n    capabilities: [KbHolCapabilityCount!]!\n  }\n\n  type KbHolRegistrySearchHit {\n    uaid: String\n    id: String\n    registry: String\n    name: String\n    description: String\n    originalId: String\n    protocols: [String!]\n    json: String\n  }\n\n  type KbHolRegistrySearchResult {\n    total: Int!\n    page: Int\n    limit: Int\n    hits: [KbHolRegistrySearchHit!]!\n  }\n\n  input KbHolVectorSearchFilterInput {\n    registry: String\n    capabilities: [String!]\n  }\n\n  input KbHolVectorSearchInput {\n    query: String!\n    limit: Int\n    filter: KbHolVectorSearchFilterInput\n  }\n\n  input KbHolResolveIncludeInput {\n    capabilities: Boolean\n    endpoints: Boolean\n    relationships: Boolean\n    validations: Boolean\n  }\n\n  type KbAgentDescriptor {\n    iri: ID!\n    name: String\n    description: String\n    image: String\n  }\n\n  type KbAgent {\n    iri: ID!\n    uaid: String\n    agentName: String\n    agentDescription: String\n    agentImage: String\n    agentDescriptor: KbAgentDescriptor\n    agentTypes: [String!]!\n\n    # Provenance (best-effort; may be null for older/missing records)\n    createdAtBlock: Int\n    createdAtTime: Int\n    updatedAtTime: Int\n\n    # KB analytics (GraphDB-resident) scoring signals\n    trustLedgerTotalPoints: Int\n    trustLedgerBadgeCount: Int\n    trustLedgerComputedAt: Int\n    trustLedgerBadges: [TrustLedgerBadgeAward!]!\n    atiOverallScore: Int\n    atiOverallConfidence: Float\n    atiVersion: String\n    atiComputedAt: Int\n\n    identities: [KbAgentIdentity!]!\n\n    serviceEndpoints: [KbServiceEndpoint!]!\n\n    # Counts are always available; items are only fetched when you request a specific agent.\n    assertions: KbAgentAssertions\n    reviewAssertions(first: Int, skip: Int): KbReviewResponseConnection\n    validationAssertions(first: Int, skip: Int): KbValidationResponseConnection\n\n  }\n\n  type KbAgentSearchResult {\n    agents: [KbAgent!]!\n    total: Int!\n    hasMore: Boolean!\n  }\n\n  type KbSubgraphRecord {\n    rawJson: String\n    txHash: String\n    blockNumber: Int\n    timestamp: Int\n  }\n\n  type KbReviewResponse {\n    iri: ID!\n    agentDid8004: String\n    json: String\n    record: KbSubgraphRecord\n  }\n\n  type KbReviewResponseConnection {\n    total: Int!\n    items: [KbReviewResponse!]!\n  }\n\n  type KbValidationResponse {\n    iri: ID!\n    agentDid8004: String\n    json: String\n    record: KbSubgraphRecord\n  }\n\n  type KbValidationResponseConnection {\n    total: Int!\n    items: [KbValidationResponse!]!\n  }\n\n  type KbAgentAssertions {\n    total: Int!\n    reviewResponses: KbReviewResponseConnection!\n    validationResponses: KbValidationResponseConnection!\n  }\n\n  type KbAssociation {\n    iri: ID!\n    record: KbSubgraphRecord\n  }\n\n  type KbSemanticAgentMatch {\n    agent: KbAgent\n    score: Float!\n    matchReasons: [String!]\n  }\n\n  type KbSemanticAgentSearchResult {\n    matches: [KbSemanticAgentMatch!]!\n    total: Int!\n    intentType: String\n  }\n\n  # Reuse input shape from v1 for compatibility with existing clients.\n  input SemanticAgentSearchInput {\n    text: String\n    intentJson: String\n    topK: Int\n    minScore: Float\n    requiredSkills: [String!]\n    filters: SemanticSearchFilterInput\n  }\n\n  input SemanticSearchFilterInput {\n    capabilities: [String!]\n    inputMode: String\n    outputMode: String\n    tags: [String!]\n  }\n\n  # ATI / TrustLedger: keep the v1 shapes for now (served from GraphDB in v2 endpoint).\n  type TrustReason {\n    code: String!\n    weight: Float\n    detail: String\n  }\n\n  type TrustScore {\n    interfaceId: String!\n    score: Float!\n    reputationScore: Float!\n    overlapScore: Float!\n    clientMembershipCount: Int!\n    agentMembershipCount: Int!\n    sharedMembershipCount: Int!\n    sharedMembershipKeys: [String!]!\n    reasons: [TrustReason!]!\n  }\n\n  type AgentTrustComponent {\n    component: String!\n    score: Float!\n    weight: Float!\n    evidenceCountsJson: String\n  }\n\n  type AgentTrustIndex {\n    chainId: Int!\n    agentId: String!\n    overallScore: Int!\n    overallConfidence: Float\n    version: String!\n    computedAt: Int!\n    bundleJson: String\n    components: [AgentTrustComponent!]!\n  }\n\n  type TrustLedgerBadgeDefinition {\n    badgeId: String!\n    program: String!\n    name: String!\n    description: String\n    iconRef: String\n    points: Int!\n    ruleId: String!\n    ruleJson: String\n    active: Boolean!\n    createdAt: Int!\n    updatedAt: Int!\n  }\n\n  type TrustLedgerBadgeAward {\n    iri: ID!\n    awardedAt: Int\n    evidenceJson: String\n    definition: TrustLedgerBadgeDefinition\n  }\n\n  type Query {\n    # Discovery taxonomy (GraphDB-backed, same shape as v1 schema)\n    oasfSkills(\n      key: String\n      nameKey: String\n      category: String\n      extendsKey: String\n      limit: Int\n      offset: Int\n      orderBy: String\n      orderDirection: String\n    ): [OasfSkill!]!\n\n    oasfDomains(\n      key: String\n      nameKey: String\n      category: String\n      extendsKey: String\n      limit: Int\n      offset: Int\n      orderBy: String\n      orderDirection: String\n    ): [OasfDomain!]!\n\n    intentTypes(\n      key: String\n      label: String\n      limit: Int\n      offset: Int\n    ): [IntentType!]!\n\n    taskTypes(\n      key: String\n      label: String\n      limit: Int\n      offset: Int\n    ): [TaskType!]!\n\n    intentTaskMappings(\n      intentKey: String\n      taskKey: String\n      limit: Int\n      offset: Int\n    ): [IntentTaskMapping!]!\n\n    kbAgents(\n      where: KbAgentWhereInput\n      first: Int\n      skip: Int\n      orderBy: KbAgentOrderBy\n      orderDirection: OrderDirection\n    ): KbAgentSearchResult!\n\n    # Convenience query: agents whose ERC-8004 identity hasOwnerAccount matches ownerAddress\n    kbOwnedAgents(\n      chainId: Int!\n      ownerAddress: String!\n      first: Int\n      skip: Int\n      orderBy: KbAgentOrderBy\n      orderDirection: OrderDirection\n    ): KbAgentSearchResult!\n\n    # Like kbOwnedAgents, but searches across all subgraph graphs (no chainId required).\n    kbOwnedAgentsAllChains(\n      ownerAddress: String!\n      first: Int\n      skip: Int\n      orderBy: KbAgentOrderBy\n      orderDirection: OrderDirection\n    ): KbAgentSearchResult!\n\n    # UAID-native ownership check. Returns true if walletAddress resolves to the same EOA as the agent's owner.\n    kbIsOwner(uaid: String!, walletAddress: String!): Boolean!\n\n    kbAgentByUaid(uaid: String!): KbAgent\n    kbHolAgentProfileByUaid(uaid: String!, include: KbHolResolveIncludeInput): KbHolAgentProfile\n    kbHolCapabilities(first: Int, skip: Int): [KbHolCapability!]!\n    kbHolRegistries: [String!]!\n    kbHolRegistriesForProtocol(protocol: String!): [String!]!\n    kbHolStats: KbHolStats!\n    kbHolRegistrySearch(registry: String!, q: String, originalId: String): KbHolRegistrySearchResult!\n    kbHolVectorSearch(input: KbHolVectorSearchInput!): KbHolRegistrySearchResult!\n\n    kbSemanticAgentSearch(input: SemanticAgentSearchInput!): KbSemanticAgentSearchResult!\n\n    kbErc8122Registries(chainId: Int!, first: Int, skip: Int): [KbAgentRegistry8122!]!\n\n    # Minimal trust/event reads from KB (typed nodes + raw JSON where needed)\n    kbReviews(chainId: Int!, first: Int, skip: Int): [KbReviewResponse!]!\n    kbValidations(chainId: Int!, first: Int, skip: Int): [KbValidationResponse!]!\n    kbAssociations(chainId: Int!, first: Int, skip: Int): [KbAssociation!]!\n\n    # ATI / trust ledger (GraphDB-backed in v2)\n    kbAgentTrustIndex(chainId: Int!, agentId: String!): AgentTrustIndex\n    kbTrustLedgerBadgeDefinitions(program: String, active: Boolean): [TrustLedgerBadgeDefinition!]!\n  }\n\n  type Mutation {\n    kbHolSyncCapabilities: KbHolSyncResult!\n  }\n";
+export declare function buildGraphQLSchemaKb(): GraphQLSchema;
+//# sourceMappingURL=schemaKb.d.ts.map

package/dist/schemaKb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaKb.d.ts","sourceRoot":"","sources":["../schemaKb.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAE1D,eAAO,MAAM,qBAAqB,wjaAmkBjC,CAAC;AAEF,wBAAgB,oBAAoB,IAAI,aAAa,CAEpD"}

package/dist/schemaKb.js

@@ -0,0 +1,593 @@
+/**
+ * GraphDB-backed (knowledge base) GraphQL schema (v2).
+ *
+ * This schema is intentionally aligned to the KB model:
+ * Agent → Identity → Descriptor → (assembled) ProtocolDescriptor.
+ *
+ * Used as reference for the discovery client; the live backend is introspected at runtime.
+ */
+import { buildSchema } from 'graphql';
+export const graphQLSchemaStringKb = `
+  type OasfSkill {
+    key: String!
+    nameKey: String
+    uid: Int
+    caption: String
+    extendsKey: String
+    category: String
+  }
+
+  type OasfDomain {
+    key: String!
+    nameKey: String
+    uid: Int
+    caption: String
+    extendsKey: String
+    category: String
+  }
+
+  type IntentType {
+    key: String!
+    label: String
+    description: String
+  }
+
+  type TaskType {
+    key: String!
+    label: String
+    description: String
+  }
+
+  type IntentTaskMapping {
+    intent: IntentType!
+    task: TaskType!
+    requiredSkills: [String!]!
+    optionalSkills: [String!]!
+  }
+
+  enum OrderDirection {
+    ASC
+    DESC
+  }
+
+  enum KbAgentOrderBy {
+    agentId8004
+    agentName
+    uaid
+    createdAtTime
+    updatedAtTime
+    trustLedgerTotalPoints
+    atiOverallScore
+    bestRank
+  }
+
+  input KbAgentWhereInput {
+    chainId: Int
+    agentIdentifierMatch: String
+    did8004: String
+    uaid: String
+    uaid_in: [String!]
+    agentName_contains: String
+    isSmartAgent: Boolean
+    hasA2a: Boolean
+    hasAssertions: Boolean
+    hasReviews: Boolean
+    hasValidations: Boolean
+    minReviewAssertionCount: Int
+    minValidationAssertionCount: Int
+  }
+
+  type KbAccount {
+    iri: ID!
+    chainId: Int
+    address: String
+    accountType: String # EOAAccount | SmartAccount | Account | (null/unknown)
+    didEthr: String
+  }
+
+  # Generic descriptor for core entities (protocols, endpoints, etc.)
+  type KbDescriptor {
+    iri: ID!
+    name: String
+    description: String
+    image: String
+  }
+
+  # Protocol descriptor payload (e.g. A2A agent-card.json)
+  type KbProtocolDescriptor {
+    iri: ID!
+    name: String
+    description: String
+    image: String
+    agentCardJson: String
+  }
+
+  type KbProtocol {
+    iri: ID!
+    protocol: String! # a2a | mcp | other
+    protocolVersion: String
+    serviceUrl: String
+    descriptor: KbProtocolDescriptor
+    skills: [String!]!
+    domains: [String!]!
+  }
+
+  type KbServiceEndpoint {
+    iri: ID!
+    name: String! # a2a | mcp | other
+    descriptor: KbDescriptor
+    protocol: KbProtocol!
+  }
+
+  type KbIdentityDescriptor {
+    iri: ID!
+    kind: String! # 8004 | ens | hol | nanda | other
+    name: String
+    description: String
+    image: String
+    registrationJson: String
+    nftMetadataJson: String
+    registeredBy: String
+    registryNamespace: String
+    skills: [String!]!
+    domains: [String!]!
+  }
+
+  # ERC-8122 registries (factory-deployed registries + registrars)
+  type KbAgentRegistry8122 {
+    iri: ID!
+    chainId: Int!
+    registryAddress: String!
+    registrarAddress: String
+    registryName: String
+    registryImplementationAddress: String
+    registrarImplementationAddress: String
+    registeredAgentCount: Int
+    lastAgentUpdatedAtTime: Int
+  }
+
+  # Agent identity record (may include multiple identities per agent, even multiple of the same kind).
+  interface KbAgentIdentity {
+    iri: ID!
+    kind: String! # 8004 | 8122 | ens | hol | other
+    did: String!
+    chainId: Int
+    descriptor: KbIdentityDescriptor
+    serviceEndpoints: [KbServiceEndpoint!]!
+  }
+
+  type KbIdentity8004 implements KbAgentIdentity {
+    iri: ID!
+    kind: String! # "8004"
+    did: String!
+    chainId: Int
+
+    did8004: String!
+    agentId8004: Int
+    isSmartAgent: Boolean
+
+    descriptor: KbIdentityDescriptor
+    serviceEndpoints: [KbServiceEndpoint!]!
+
+    ownerAccount: KbAccount
+    agentAccount: KbAccount
+    operatorAccount: KbAccount
+    walletAccount: KbAccount
+    ownerEOAAccount: KbAccount
+  }
+
+  type KbIdentity8122 implements KbAgentIdentity {
+    iri: ID!
+    kind: String! # "8122"
+    did: String!
+    chainId: Int
+
+    did8122: String!
+    agentId8122: String!
+    registryAddress: String
+    collectionName: String
+    registry: KbAgentRegistry8122
+    endpointType: String
+    endpoint: String
+
+    descriptor: KbIdentityDescriptor
+    serviceEndpoints: [KbServiceEndpoint!]!
+
+    ownerAccount: KbAccount
+    agentAccount: KbAccount
+  }
+
+  type KbIdentityEns implements KbAgentIdentity {
+    iri: ID!
+    kind: String! # "ens"
+    did: String!
+    chainId: Int
+
+    didEns: String!
+    ensName: String
+
+    descriptor: KbIdentityDescriptor
+    serviceEndpoints: [KbServiceEndpoint!]!
+  }
+
+  type KbIdentityHol implements KbAgentIdentity {
+    iri: ID!
+    kind: String! # "hol"
+    did: String!
+    chainId: Int
+
+    uaidHOL: String
+
+    descriptor: KbIdentityDescriptor
+    serviceEndpoints: [KbServiceEndpoint!]!
+  }
+
+  type KbIdentityOther implements KbAgentIdentity {
+    iri: ID!
+    kind: String!
+    did: String!
+    chainId: Int
+
+    descriptor: KbIdentityDescriptor
+    serviceEndpoints: [KbServiceEndpoint!]!
+  }
+
+  type KbHolAgentProfile {
+    uaid: String!
+    displayName: String
+    alias: String
+    bio: String
+    profileImage: String
+    profileJson: String
+  }
+
+  type KbHolCapability {
+    iri: ID!
+    key: String!
+    label: String
+    json: String
+  }
+
+  type KbHolSyncResult {
+    success: Boolean!
+    count: Int!
+    message: String
+  }
+
+  type KbHolRegistryCount {
+    registry: String!
+    agentCount: Int!
+  }
+
+  type KbHolCapabilityCount {
+    capability: String!
+    agentCount: Int!
+  }
+
+  type KbHolStats {
+    totalAgents: Int!
+    lastUpdate: String
+    status: String
+    registries: [KbHolRegistryCount!]!
+    capabilities: [KbHolCapabilityCount!]!
+  }
+
+  type KbHolRegistrySearchHit {
+    uaid: String
+    id: String
+    registry: String
+    name: String
+    description: String
+    originalId: String
+    protocols: [String!]
+    json: String
+  }
+
+  type KbHolRegistrySearchResult {
+    total: Int!
+    page: Int
+    limit: Int
+    hits: [KbHolRegistrySearchHit!]!
+  }
+
+  input KbHolVectorSearchFilterInput {
+    registry: String
+    capabilities: [String!]
+  }
+
+  input KbHolVectorSearchInput {
+    query: String!
+    limit: Int
+    filter: KbHolVectorSearchFilterInput
+  }
+
+  input KbHolResolveIncludeInput {
+    capabilities: Boolean
+    endpoints: Boolean
+    relationships: Boolean
+    validations: Boolean
+  }
+
+  type KbAgentDescriptor {
+    iri: ID!
+    name: String
+    description: String
+    image: String
+  }
+
+  type KbAgent {
+    iri: ID!
+    uaid: String
+    agentName: String
+    agentDescription: String
+    agentImage: String
+    agentDescriptor: KbAgentDescriptor
+    agentTypes: [String!]!
+
+    # Provenance (best-effort; may be null for older/missing records)
+    createdAtBlock: Int
+    createdAtTime: Int
+    updatedAtTime: Int
+
+    # KB analytics (GraphDB-resident) scoring signals
+    trustLedgerTotalPoints: Int
+    trustLedgerBadgeCount: Int
+    trustLedgerComputedAt: Int
+    trustLedgerBadges: [TrustLedgerBadgeAward!]!
+    atiOverallScore: Int
+    atiOverallConfidence: Float
+    atiVersion: String
+    atiComputedAt: Int
+
+    identities: [KbAgentIdentity!]!
+
+    serviceEndpoints: [KbServiceEndpoint!]!
+
+    # Counts are always available; items are only fetched when you request a specific agent.
+    assertions: KbAgentAssertions
+    reviewAssertions(first: Int, skip: Int): KbReviewResponseConnection
+    validationAssertions(first: Int, skip: Int): KbValidationResponseConnection
+
+  }
+
+  type KbAgentSearchResult {
+    agents: [KbAgent!]!
+    total: Int!
+    hasMore: Boolean!
+  }
+
+  type KbSubgraphRecord {
+    rawJson: String
+    txHash: String
+    blockNumber: Int
+    timestamp: Int
+  }
+
+  type KbReviewResponse {
+    iri: ID!
+    agentDid8004: String
+    json: String
+    record: KbSubgraphRecord
+  }
+
+  type KbReviewResponseConnection {
+    total: Int!
+    items: [KbReviewResponse!]!
+  }
+
+  type KbValidationResponse {
+    iri: ID!
+    agentDid8004: String
+    json: String
+    record: KbSubgraphRecord
+  }
+
+  type KbValidationResponseConnection {
+    total: Int!
+    items: [KbValidationResponse!]!
+  }
+
+  type KbAgentAssertions {
+    total: Int!
+    reviewResponses: KbReviewResponseConnection!
+    validationResponses: KbValidationResponseConnection!
+  }
+
+  type KbAssociation {
+    iri: ID!
+    record: KbSubgraphRecord
+  }
+
+  type KbSemanticAgentMatch {
+    agent: KbAgent
+    score: Float!
+    matchReasons: [String!]
+  }
+
+  type KbSemanticAgentSearchResult {
+    matches: [KbSemanticAgentMatch!]!
+    total: Int!
+    intentType: String
+  }
+
+  # Reuse input shape from v1 for compatibility with existing clients.
+  input SemanticAgentSearchInput {
+    text: String
+    intentJson: String
+    topK: Int
+    minScore: Float
+    requiredSkills: [String!]
+    filters: SemanticSearchFilterInput
+  }
+
+  input SemanticSearchFilterInput {
+    capabilities: [String!]
+    inputMode: String
+    outputMode: String
+    tags: [String!]
+  }
+
+  # ATI / TrustLedger: keep the v1 shapes for now (served from GraphDB in v2 endpoint).
+  type TrustReason {
+    code: String!
+    weight: Float
+    detail: String
+  }
+
+  type TrustScore {
+    interfaceId: String!
+    score: Float!
+    reputationScore: Float!
+    overlapScore: Float!
+    clientMembershipCount: Int!
+    agentMembershipCount: Int!
+    sharedMembershipCount: Int!
+    sharedMembershipKeys: [String!]!
+    reasons: [TrustReason!]!
+  }
+
+  type AgentTrustComponent {
+    component: String!
+    score: Float!
+    weight: Float!
+    evidenceCountsJson: String
+  }
+
+  type AgentTrustIndex {
+    chainId: Int!
+    agentId: String!
+    overallScore: Int!
+    overallConfidence: Float
+    version: String!
+    computedAt: Int!
+    bundleJson: String
+    components: [AgentTrustComponent!]!
+  }
+
+  type TrustLedgerBadgeDefinition {
+    badgeId: String!
+    program: String!
+    name: String!
+    description: String
+    iconRef: String
+    points: Int!
+    ruleId: String!
+    ruleJson: String
+    active: Boolean!
+    createdAt: Int!
+    updatedAt: Int!
+  }
+
+  type TrustLedgerBadgeAward {
+    iri: ID!
+    awardedAt: Int
+    evidenceJson: String
+    definition: TrustLedgerBadgeDefinition
+  }
+
+  type Query {
+    # Discovery taxonomy (GraphDB-backed, same shape as v1 schema)
+    oasfSkills(
+      key: String
+      nameKey: String
+      category: String
+      extendsKey: String
+      limit: Int
+      offset: Int
+      orderBy: String
+      orderDirection: String
+    ): [OasfSkill!]!
+
+    oasfDomains(
+      key: String
+      nameKey: String
+      category: String
+      extendsKey: String
+      limit: Int
+      offset: Int
+      orderBy: String
+      orderDirection: String
+    ): [OasfDomain!]!
+
+    intentTypes(
+      key: String
+      label: String
+      limit: Int
+      offset: Int
+    ): [IntentType!]!
+
+    taskTypes(
+      key: String
+      label: String
+      limit: Int
+      offset: Int
+    ): [TaskType!]!
+
+    intentTaskMappings(
+      intentKey: String
+      taskKey: String
+      limit: Int
+      offset: Int
+    ): [IntentTaskMapping!]!
+
+    kbAgents(
+      where: KbAgentWhereInput
+      first: Int
+      skip: Int
+      orderBy: KbAgentOrderBy
+      orderDirection: OrderDirection
+    ): KbAgentSearchResult!
+
+    # Convenience query: agents whose ERC-8004 identity hasOwnerAccount matches ownerAddress
+    kbOwnedAgents(
+      chainId: Int!
+      ownerAddress: String!
+      first: Int
+      skip: Int
+      orderBy: KbAgentOrderBy
+      orderDirection: OrderDirection
+    ): KbAgentSearchResult!
+
+    # Like kbOwnedAgents, but searches across all subgraph graphs (no chainId required).
+    kbOwnedAgentsAllChains(
+      ownerAddress: String!
+      first: Int
+      skip: Int
+      orderBy: KbAgentOrderBy
+      orderDirection: OrderDirection
+    ): KbAgentSearchResult!
+
+    # UAID-native ownership check. Returns true if walletAddress resolves to the same EOA as the agent's owner.
+    kbIsOwner(uaid: String!, walletAddress: String!): Boolean!
+
+    kbAgentByUaid(uaid: String!): KbAgent
+    kbHolAgentProfileByUaid(uaid: String!, include: KbHolResolveIncludeInput): KbHolAgentProfile
+    kbHolCapabilities(first: Int, skip: Int): [KbHolCapability!]!
+    kbHolRegistries: [String!]!
+    kbHolRegistriesForProtocol(protocol: String!): [String!]!
+    kbHolStats: KbHolStats!
+    kbHolRegistrySearch(registry: String!, q: String, originalId: String): KbHolRegistrySearchResult!
+    kbHolVectorSearch(input: KbHolVectorSearchInput!): KbHolRegistrySearchResult!
+
+    kbSemanticAgentSearch(input: SemanticAgentSearchInput!): KbSemanticAgentSearchResult!
+
+    kbErc8122Registries(chainId: Int!, first: Int, skip: Int): [KbAgentRegistry8122!]!
+
+    # Minimal trust/event reads from KB (typed nodes + raw JSON where needed)
+    kbReviews(chainId: Int!, first: Int, skip: Int): [KbReviewResponse!]!
+    kbValidations(chainId: Int!, first: Int, skip: Int): [KbValidationResponse!]!
+    kbAssociations(chainId: Int!, first: Int, skip: Int): [KbAssociation!]!
+
+    # ATI / trust ledger (GraphDB-backed in v2)
+    kbAgentTrustIndex(chainId: Int!, agentId: String!): AgentTrustIndex
+    kbTrustLedgerBadgeDefinitions(program: String, active: Boolean): [TrustLedgerBadgeDefinition!]!
+  }
+
+  type Mutation {
+    kbHolSyncCapabilities: KbHolSyncResult!
+  }
+`;
+export function buildGraphQLSchemaKb() {
+    return buildSchema(graphQLSchemaStringKb);
+}
+//# sourceMappingURL=schemaKb.js.map

package/dist/schemaKb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaKb.js","sourceRoot":"","sources":["../schemaKb.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAsB,MAAM,SAAS,CAAC;AAE1D,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmkBpC,CAAC;AAEF,MAAM,UAAU,oBAAoB;IAClC,OAAO,WAAW,CAAC,qBAAqB,CAAC,CAAC;AAC5C,CAAC"}