@scoutflo/topology-contracts 0.1.0 → 0.2.0

package/dist/src/investigation/context.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gatewayTopologyContextSchema = exports.topologyBindingHintsSchema = exports.topologyBindingHintSchema = exports.topologyInvestigationContextSchema = exports.relatedServiceInfoSchema = exports.investigationResourceSchema = exports.targetServiceInfoSchema = exports.topologyInitializationStateSchema = exports.topologyPrimaryAnchorSchema = exports.topologyCandidateTargetSchema = exports.topologyReasonCodeSchema = exports.nestedTopologyResponseSchema = exports.nestedTopologyNodeSchema = exports.nestedTopologyChildSchema = exports.nestedTopologyRelationshipSchema = exports.diagnosticCriticalitySchema = exports.GATEWAY_TOPOLOGY_CONTEXT_VERSION = void 0;
+const zod_1 = require("zod");
+const correlation_core_1 = require("@scoutflo/correlation-core");
+const providers_1 = require("../providers");
+const common_1 = require("../source-sync/common");
+exports.GATEWAY_TOPOLOGY_CONTEXT_VERSION = 'topology.gateway-context.v1';
+exports.diagnosticCriticalitySchema = zod_1.z.enum([
+    'blocking',
+    'degrading',
+    'optional',
+]);
+exports.nestedTopologyRelationshipSchema = zod_1.z.object({
+    id: common_1.nonEmptyStringSchema,
+    relation: common_1.nonEmptyStringSchema,
+    relation_class: common_1.nonEmptyStringSchema.optional(),
+    diagnostic_criticality: exports.diagnosticCriticalitySchema.optional(),
+    attribute_schema_key: common_1.nonEmptyStringSchema.optional(),
+    attributes: common_1.recordSchema.optional(),
+}).passthrough();
+const nestedTopologyNodeBaseSchema = zod_1.z.object({
+    entity_type: common_1.entityKindSchema,
+    id: common_1.nonEmptyStringSchema,
+    entity: common_1.recordSchema.optional(),
+    root_refs: zod_1.z.record(common_1.nonEmptyStringSchema).optional(),
+    is_hierarchy_root_types: zod_1.z.array(common_1.nonEmptyStringSchema).optional(),
+    already_visited: zod_1.z.boolean().optional(),
+});
+exports.nestedTopologyChildSchema = zod_1.z.lazy(() => nestedTopologyNodeBaseSchema.extend({
+    relationship: exports.nestedTopologyRelationshipSchema,
+    children: zod_1.z.array(exports.nestedTopologyChildSchema),
+}).passthrough());
+exports.nestedTopologyNodeSchema = nestedTopologyNodeBaseSchema.extend({
+    children: zod_1.z.array(exports.nestedTopologyChildSchema),
+}).passthrough();
+exports.nestedTopologyResponseSchema = zod_1.z.object({
+    status: zod_1.z.union([zod_1.z.literal('success'), zod_1.z.number()]),
+    topology: exports.nestedTopologyNodeSchema,
+    stats: zod_1.z.object({
+        total_nodes: zod_1.z.number().int().min(0),
+        max_depth: zod_1.z.number().int().min(0),
+        structural_edges: zod_1.z.number().int().min(0),
+        associative_edges: zod_1.z.number().int().min(0),
+    }).optional(),
+}).passthrough();
+exports.topologyReasonCodeSchema = common_1.nonEmptyStringSchema;
+exports.topologyCandidateTargetSchema = zod_1.z.object({
+    entityType: common_1.entityKindSchema,
+    id: common_1.nonEmptyStringSchema,
+    displayName: common_1.nonEmptyStringSchema.optional(),
+    confidence: zod_1.z.number().min(0).optional(),
+}).passthrough();
+exports.topologyPrimaryAnchorSchema = exports.topologyCandidateTargetSchema;
+exports.topologyInitializationStateSchema = zod_1.z.object({
+    correlationState: zod_1.z.enum([
+        'exact_match',
+        'probable_match',
+        'ambiguous_match',
+        'resource_only',
+        'unresolved',
+        'topology_temporarily_unavailable',
+    ]),
+    resolvedVia: common_1.nonEmptyStringSchema,
+    confidence: zod_1.z.number().min(0),
+    reasonCodes: zod_1.z.array(exports.topologyReasonCodeSchema),
+    candidateTargets: zod_1.z.array(exports.topologyCandidateTargetSchema),
+    primaryAnchor: exports.topologyPrimaryAnchorSchema.nullable(),
+    topologyScope: zod_1.z.enum([
+        'narrow',
+        'inferred',
+        'shared',
+        'resource',
+        'alert_only',
+    ]),
+    userMessage: common_1.nonEmptyStringSchema,
+    topologyAvailable: zod_1.z.boolean(),
+}).passthrough();
+exports.targetServiceInfoSchema = zod_1.z.object({
+    id: common_1.nonEmptyStringSchema,
+    name: common_1.nonEmptyStringSchema,
+    displayName: common_1.nonEmptyStringSchema,
+    serviceType: common_1.nonEmptyStringSchema,
+    criticality: common_1.nonEmptyStringSchema,
+    environment: common_1.nonEmptyStringSchema,
+}).passthrough();
+exports.investigationResourceSchema = zod_1.z.object({
+    id: common_1.nonEmptyStringSchema,
+    name: common_1.nonEmptyStringSchema,
+    type: common_1.nonEmptyStringSchema,
+    provider: providers_1.topologyProviderInputSchema.or(common_1.nonEmptyStringSchema),
+    relationship: common_1.nonEmptyStringSchema,
+    investigationHint: common_1.nonEmptyStringSchema,
+    attributeSchemaKey: common_1.nonEmptyStringSchema.optional(),
+    attributes: common_1.recordSchema.optional(),
+}).passthrough();
+exports.relatedServiceInfoSchema = zod_1.z.object({
+    name: common_1.nonEmptyStringSchema,
+    displayName: common_1.nonEmptyStringSchema,
+    relation: common_1.nonEmptyStringSchema,
+    criticality: common_1.nonEmptyStringSchema,
+}).passthrough();
+exports.topologyInvestigationContextSchema = zod_1.z.object({
+    topologyAvailable: zod_1.z.boolean(),
+    targetService: exports.targetServiceInfoSchema.nullable(),
+    investigationResources: zod_1.z.array(exports.investigationResourceSchema),
+    recommendedSpecialists: zod_1.z.array(common_1.recordSchema),
+    eligibleSpecialists: zod_1.z.array(common_1.nonEmptyStringSchema),
+    relatedServices: zod_1.z.object({
+        upstream: zod_1.z.array(exports.relatedServiceInfoSchema),
+        downstream: zod_1.z.array(exports.relatedServiceInfoSchema),
+    }),
+    naturalLanguageSummary: common_1.nonEmptyStringSchema,
+    inferenceMetadata: common_1.recordSchema.optional(),
+}).passthrough();
+exports.topologyBindingHintSchema = zod_1.z.object({
+    provider: providers_1.topologyProviderInputSchema.or(common_1.nonEmptyStringSchema),
+    resourceId: common_1.nonEmptyStringSchema.optional(),
+    externalId: common_1.nonEmptyStringSchema.optional(),
+    sourceCollection: common_1.nonEmptyStringSchema.optional(),
+    resourceType: common_1.nonEmptyStringSchema.optional(),
+    serviceId: common_1.nonEmptyStringSchema.optional(),
+    confidence: zod_1.z.number().min(0).optional(),
+    relation: common_1.nonEmptyStringSchema.optional(),
+    origin: zod_1.z.enum(['source', 'topology', 'source_and_topology']).optional(),
+}).passthrough();
+exports.topologyBindingHintsSchema = zod_1.z.object({
+    sourceIntegrationHint: zod_1.z.object({
+        provider: providers_1.topologyProviderInputSchema.or(common_1.nonEmptyStringSchema).optional(),
+        integrationId: common_1.nonEmptyStringSchema.optional(),
+    }).optional(),
+    candidateBindings: zod_1.z.array(exports.topologyBindingHintSchema),
+    preferredBindingsBySpecialist: zod_1.z.record(zod_1.z.array(exports.topologyBindingHintSchema)).optional(),
+}).passthrough();
+exports.gatewayTopologyContextSchema = zod_1.z.object({
+    version: zod_1.z.literal(exports.GATEWAY_TOPOLOGY_CONTEXT_VERSION),
+    initialization: exports.topologyInitializationStateSchema,
+    investigationContext: exports.topologyInvestigationContextSchema,
+    bindingHints: exports.topologyBindingHintsSchema,
+    reasonCodes: zod_1.z.array(exports.topologyReasonCodeSchema).optional(),
+    selectedTarget: correlation_core_1.correlationEntityRefSchema.optional(),
+    topologySlice: exports.nestedTopologyResponseSchema.nullable().optional(),
+    diagnostics: common_1.recordSchema.optional(),
+}).passthrough();
+//# sourceMappingURL=context.js.map

package/dist/src/investigation/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/investigation/context.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,iEAAwE;AACxE,4CAA2D;AAC3D,kDAI+B;AAElB,QAAA,gCAAgC,GAAG,6BAA6B,CAAC;AAEjE,QAAA,2BAA2B,GAAG,OAAC,CAAC,IAAI,CAAC;IAChD,UAAU;IACV,WAAW;IACX,UAAU;CACX,CAAC,CAAC;AAEU,QAAA,gCAAgC,GAAG,OAAC,CAAC,MAAM,CAAC;IACvD,EAAE,EAAE,6BAAoB;IACxB,QAAQ,EAAE,6BAAoB;IAC9B,cAAc,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IAC/C,sBAAsB,EAAE,mCAA2B,CAAC,QAAQ,EAAE;IAC9D,oBAAoB,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IACrD,UAAU,EAAE,qBAAY,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC,WAAW,EAAE,CAAC;AAkBjB,MAAM,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,WAAW,EAAE,yBAAgB;IAC7B,EAAE,EAAE,6BAAoB;IACxB,MAAM,EAAE,qBAAY,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,OAAC,CAAC,MAAM,CAAC,6BAAoB,CAAC,CAAC,QAAQ,EAAE;IACpD,uBAAuB,EAAE,OAAC,CAAC,KAAK,CAAC,6BAAoB,CAAC,CAAC,QAAQ,EAAE;IACjE,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEU,QAAA,yBAAyB,GAAmC,OAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CACnF,4BAA4B,CAAC,MAAM,CAAC;IAClC,YAAY,EAAE,wCAAgC;IAC9C,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,iCAAyB,CAAC;CAC7C,CAAC,CAAC,WAAW,EAAE,CACjB,CAAC;AAEW,QAAA,wBAAwB,GACnC,4BAA4B,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,iCAAyB,CAAC;CAC7C,CAAC,CAAC,WAAW,EAAE,CAAC;AAEN,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,QAAQ,EAAE,gCAAwB;IAClC,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC;QACd,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACpC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC3C,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC,WAAW,EAAE,CAAC;AAEJ,QAAA,wBAAwB,GAAG,6BAAoB,CAAC;AAEhD,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,UAAU,EAAE,yBAAgB;IAC5B,EAAE,EAAE,6BAAoB;IACxB,WAAW,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IAC5C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC,WAAW,EAAE,CAAC;AAEJ,QAAA,2BAA2B,GAAG,qCAA6B,CAAC;AAE5D,QAAA,iCAAiC,GAAG,OAAC,CAAC,MAAM,CAAC;IACxD,gBAAgB,EAAE,OAAC,CAAC,IAAI,CAAC;QACvB,aAAa;QACb,gBAAgB;QAChB,iBAAiB;QACjB,eAAe;QACf,YAAY;QACZ,kCAAkC;KACnC,CAAC;IACF,WAAW,EAAE,6BAAoB;IACjC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,gCAAwB,CAAC;IAC9C,gBAAgB,EAAE,OAAC,CAAC,KAAK,CAAC,qCAA6B,CAAC;IACxD,aAAa,EAAE,mCAA2B,CAAC,QAAQ,EAAE;IACrD,aAAa,EAAE,OAAC,CAAC,IAAI,CAAC;QACpB,QAAQ;QACR,UAAU;QACV,QAAQ;QACR,UAAU;QACV,YAAY;KACb,CAAC;IACF,WAAW,EAAE,6BAAoB;IACjC,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE;CAC/B,CAAC,CAAC,WAAW,EAAE,CAAC;AAEJ,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,6BAAoB;IACxB,IAAI,EAAE,6BAAoB;IAC1B,WAAW,EAAE,6BAAoB;IACjC,WAAW,EAAE,6BAAoB;IACjC,WAAW,EAAE,6BAAoB;IACjC,WAAW,EAAE,6BAAoB;CAClC,CAAC,CAAC,WAAW,EAAE,CAAC;AAEJ,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAClD,EAAE,EAAE,6BAAoB;IACxB,IAAI,EAAE,6BAAoB;IAC1B,IAAI,EAAE,6BAAoB;IAC1B,QAAQ,EAAE,uCAA2B,CAAC,EAAE,CAAC,6BAAoB,CAAC;IAC9D,YAAY,EAAE,6BAAoB;IAClC,iBAAiB,EAAE,6BAAoB;IACvC,kBAAkB,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IACnD,UAAU,EAAE,qBAAY,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC,WAAW,EAAE,CAAC;AAEJ,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,6BAAoB;IAC1B,WAAW,EAAE,6BAAoB;IACjC,QAAQ,EAAE,6BAAoB;IAC9B,WAAW,EAAE,6BAAoB;CAClC,CAAC,CAAC,WAAW,EAAE,CAAC;AAEJ,QAAA,kCAAkC,GAAG,OAAC,CAAC,MAAM,CAAC;IACzD,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE;IAC9B,aAAa,EAAE,+BAAuB,CAAC,QAAQ,EAAE;IACjD,sBAAsB,EAAE,OAAC,CAAC,KAAK,CAAC,mCAA2B,CAAC;IAC5D,sBAAsB,EAAE,OAAC,CAAC,KAAK,CAAC,qBAAY,CAAC;IAC7C,mBAAmB,EAAE,OAAC,CAAC,KAAK,CAAC,6BAAoB,CAAC;IAClD,eAAe,EAAE,OAAC,CAAC,MAAM,CAAC;QACxB,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,gCAAwB,CAAC;QAC3C,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,gCAAwB,CAAC;KAC9C,CAAC;IACF,sBAAsB,EAAE,6BAAoB;IAC5C,iBAAiB,EAAE,qBAAY,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC,WAAW,EAAE,CAAC;AAEJ,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,uCAA2B,CAAC,EAAE,CAAC,6BAAoB,CAAC;IAC9D,UAAU,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IAC3C,UAAU,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IAC3C,gBAAgB,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IACjD,YAAY,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IAC1C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,6BAAoB,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC,CAAC,QAAQ,EAAE;CACzE,CAAC,CAAC,WAAW,EAAE,CAAC;AAEJ,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,qBAAqB,EAAE,OAAC,CAAC,MAAM,CAAC;QAC9B,QAAQ,EAAE,uCAA2B,CAAC,EAAE,CAAC,6BAAoB,CAAC,CAAC,QAAQ,EAAE;QACzE,aAAa,EAAE,6BAAoB,CAAC,QAAQ,EAAE;KAC/C,CAAC,CAAC,QAAQ,EAAE;IACb,iBAAiB,EAAE,OAAC,CAAC,KAAK,CAAC,iCAAyB,CAAC;IACrD,6BAA6B,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,KAAK,CAAC,iCAAyB,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvF,CAAC,CAAC,WAAW,EAAE,CAAC;AAEJ,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,OAAO,EAAE,OAAC,CAAC,OAAO,CAAC,wCAAgC,CAAC;IACpD,cAAc,EAAE,yCAAiC;IACjD,oBAAoB,EAAE,0CAAkC;IACxD,YAAY,EAAE,kCAA0B;IACxC,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,gCAAwB,CAAC,CAAC,QAAQ,EAAE;IACzD,cAAc,EAAE,6CAA0B,CAAC,QAAQ,EAAE;IACrD,aAAa,EAAE,oCAA4B,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjE,WAAW,EAAE,qBAAY,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC,WAAW,EAAE,CAAC"}

package/dist/src/investigation/index.d.ts

@@ -0,0 +1 @@
+export * from './context';

package/dist/src/investigation/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./context"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/investigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/investigation/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B"}

package/dist/src/schemas/index.d.ts

@@ -3,3 +3,4 @@ export { awsTopologyFamilySchema, kubernetesTopologyFamilySchema, integrationTop
 export { sourceSyncCapabilitySchema, topologySourceIntentIncludeSchema, topologySourceIntentSchema, topologySyncIntentOptionsSchema, topologySyncIntentSchema, topologySyncScopeSchema, topologySyncCompletenessStatusSchema, topologySyncCompletenessSchema, topologySyncWarningSeveritySchema, topologySyncWarningSchema, topologySourceRefStatusSchema, topologyEntitySourceRefCandidateSchema, topologyAccessRefCandidateSchema, topologySourceNodeCandidateSchema, topologyExistingEntityRefSchema, topologySourceRelationshipCandidateSchema, } from '../source-sync';
 export { topologyCorrelationApplyPolicySchema, topologyCorrelationRequiredEndpointSchema, topologyCorrelationRuleMetadataSchema, topologyCorrelationDecisionSchema, topologyCorrelationCandidateSchema, } from '../correlation';
 export { topologyResourceTypeSchema, topologyRelationTypeSchema, } from '../topology';
+export { diagnosticCriticalitySchema, nestedTopologyRelationshipSchema, nestedTopologyNodeSchema, nestedTopologyChildSchema, nestedTopologyResponseSchema, topologyReasonCodeSchema, topologyCandidateTargetSchema, topologyPrimaryAnchorSchema, topologyInitializationStateSchema, targetServiceInfoSchema, investigationResourceSchema, relatedServiceInfoSchema, topologyInvestigationContextSchema, topologyBindingHintSchema, topologyBindingHintsSchema, gatewayTopologyContextSchema, } from '../investigation';

package/dist/src/schemas/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.topologyRelationTypeSchema = exports.topologyResourceTypeSchema = exports.topologyCorrelationCandidateSchema = exports.topologyCorrelationDecisionSchema = exports.topologyCorrelationRuleMetadataSchema = exports.topologyCorrelationRequiredEndpointSchema = exports.topologyCorrelationApplyPolicySchema = exports.topologySourceRelationshipCandidateSchema = exports.topologyExistingEntityRefSchema = exports.topologySourceNodeCandidateSchema = exports.topologyAccessRefCandidateSchema = exports.topologyEntitySourceRefCandidateSchema = exports.topologySourceRefStatusSchema = exports.topologySyncWarningSchema = exports.topologySyncWarningSeveritySchema = exports.topologySyncCompletenessSchema = exports.topologySyncCompletenessStatusSchema = exports.topologySyncScopeSchema = exports.topologySyncIntentSchema = exports.topologySyncIntentOptionsSchema = exports.topologySourceIntentSchema = exports.topologySourceIntentIncludeSchema = exports.sourceSyncCapabilitySchema = exports.topologyFamilySchema = exports.integrationTopologyFamilySchema = exports.kubernetesTopologyFamilySchema = exports.awsTopologyFamilySchema = exports.topologyProviderInputSchema = exports.topologyProviderSchema = void 0;
+exports.gatewayTopologyContextSchema = exports.topologyBindingHintsSchema = exports.topologyBindingHintSchema = exports.topologyInvestigationContextSchema = exports.relatedServiceInfoSchema = exports.investigationResourceSchema = exports.targetServiceInfoSchema = exports.topologyInitializationStateSchema = exports.topologyPrimaryAnchorSchema = exports.topologyCandidateTargetSchema = exports.topologyReasonCodeSchema = exports.nestedTopologyResponseSchema = exports.nestedTopologyChildSchema = exports.nestedTopologyNodeSchema = exports.nestedTopologyRelationshipSchema = exports.diagnosticCriticalitySchema = exports.topologyRelationTypeSchema = exports.topologyResourceTypeSchema = exports.topologyCorrelationCandidateSchema = exports.topologyCorrelationDecisionSchema = exports.topologyCorrelationRuleMetadataSchema = exports.topologyCorrelationRequiredEndpointSchema = exports.topologyCorrelationApplyPolicySchema = exports.topologySourceRelationshipCandidateSchema = exports.topologyExistingEntityRefSchema = exports.topologySourceNodeCandidateSchema = exports.topologyAccessRefCandidateSchema = exports.topologyEntitySourceRefCandidateSchema = exports.topologySourceRefStatusSchema = exports.topologySyncWarningSchema = exports.topologySyncWarningSeveritySchema = exports.topologySyncCompletenessSchema = exports.topologySyncCompletenessStatusSchema = exports.topologySyncScopeSchema = exports.topologySyncIntentSchema = exports.topologySyncIntentOptionsSchema = exports.topologySourceIntentSchema = exports.topologySourceIntentIncludeSchema = exports.sourceSyncCapabilitySchema = exports.topologyFamilySchema = exports.integrationTopologyFamilySchema = exports.kubernetesTopologyFamilySchema = exports.awsTopologyFamilySchema = exports.topologyProviderInputSchema = exports.topologyProviderSchema = void 0;
 var providers_1 = require("../providers");
 Object.defineProperty(exports, "topologyProviderSchema", { enumerable: true, get: function () { return providers_1.topologyProviderSchema; } });
 Object.defineProperty(exports, "topologyProviderInputSchema", { enumerable: true, get: function () { return providers_1.topologyProviderInputSchema; } });
@@ -35,4 +35,21 @@ Object.defineProperty(exports, "topologyCorrelationCandidateSchema", { enumerabl
 var topology_1 = require("../topology");
 Object.defineProperty(exports, "topologyResourceTypeSchema", { enumerable: true, get: function () { return topology_1.topologyResourceTypeSchema; } });
 Object.defineProperty(exports, "topologyRelationTypeSchema", { enumerable: true, get: function () { return topology_1.topologyRelationTypeSchema; } });
+var investigation_1 = require("../investigation");
+Object.defineProperty(exports, "diagnosticCriticalitySchema", { enumerable: true, get: function () { return investigation_1.diagnosticCriticalitySchema; } });
+Object.defineProperty(exports, "nestedTopologyRelationshipSchema", { enumerable: true, get: function () { return investigation_1.nestedTopologyRelationshipSchema; } });
+Object.defineProperty(exports, "nestedTopologyNodeSchema", { enumerable: true, get: function () { return investigation_1.nestedTopologyNodeSchema; } });
+Object.defineProperty(exports, "nestedTopologyChildSchema", { enumerable: true, get: function () { return investigation_1.nestedTopologyChildSchema; } });
+Object.defineProperty(exports, "nestedTopologyResponseSchema", { enumerable: true, get: function () { return investigation_1.nestedTopologyResponseSchema; } });
+Object.defineProperty(exports, "topologyReasonCodeSchema", { enumerable: true, get: function () { return investigation_1.topologyReasonCodeSchema; } });
+Object.defineProperty(exports, "topologyCandidateTargetSchema", { enumerable: true, get: function () { return investigation_1.topologyCandidateTargetSchema; } });
+Object.defineProperty(exports, "topologyPrimaryAnchorSchema", { enumerable: true, get: function () { return investigation_1.topologyPrimaryAnchorSchema; } });
+Object.defineProperty(exports, "topologyInitializationStateSchema", { enumerable: true, get: function () { return investigation_1.topologyInitializationStateSchema; } });
+Object.defineProperty(exports, "targetServiceInfoSchema", { enumerable: true, get: function () { return investigation_1.targetServiceInfoSchema; } });
+Object.defineProperty(exports, "investigationResourceSchema", { enumerable: true, get: function () { return investigation_1.investigationResourceSchema; } });
+Object.defineProperty(exports, "relatedServiceInfoSchema", { enumerable: true, get: function () { return investigation_1.relatedServiceInfoSchema; } });
+Object.defineProperty(exports, "topologyInvestigationContextSchema", { enumerable: true, get: function () { return investigation_1.topologyInvestigationContextSchema; } });
+Object.defineProperty(exports, "topologyBindingHintSchema", { enumerable: true, get: function () { return investigation_1.topologyBindingHintSchema; } });
+Object.defineProperty(exports, "topologyBindingHintsSchema", { enumerable: true, get: function () { return investigation_1.topologyBindingHintsSchema; } });
+Object.defineProperty(exports, "gatewayTopologyContextSchema", { enumerable: true, get: function () { return investigation_1.gatewayTopologyContextSchema; } });
 //# sourceMappingURL=index.js.map

package/dist/src/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/index.ts"],"names":[],"mappings":";;;AAAA,0CAGsB;AAFpB,mHAAA,sBAAsB,OAAA;AACtB,wHAAA,2BAA2B,OAAA;AAG7B,wCAKqB;AAJnB,mHAAA,uBAAuB,OAAA;AACvB,0HAAA,8BAA8B,OAAA;AAC9B,2HAAA,+BAA+B,OAAA;AAC/B,gHAAA,oBAAoB,OAAA;AAGtB,8CAiBwB;AAhBtB,yHAAA,0BAA0B,OAAA;AAC1B,gIAAA,iCAAiC,OAAA;AACjC,yHAAA,0BAA0B,OAAA;AAC1B,8HAAA,+BAA+B,OAAA;AAC/B,uHAAA,wBAAwB,OAAA;AACxB,sHAAA,uBAAuB,OAAA;AACvB,mIAAA,oCAAoC,OAAA;AACpC,6HAAA,8BAA8B,OAAA;AAC9B,gIAAA,iCAAiC,OAAA;AACjC,wHAAA,yBAAyB,OAAA;AACzB,4HAAA,6BAA6B,OAAA;AAC7B,qIAAA,sCAAsC,OAAA;AACtC,+HAAA,gCAAgC,OAAA;AAChC,gIAAA,iCAAiC,OAAA;AACjC,8HAAA,+BAA+B,OAAA;AAC/B,wIAAA,yCAAyC,OAAA;AAG3C,8CAMwB;AALtB,mIAAA,oCAAoC,OAAA;AACpC,wIAAA,yCAAyC,OAAA;AACzC,oIAAA,qCAAqC,OAAA;AACrC,gIAAA,iCAAiC,OAAA;AACjC,iIAAA,kCAAkC,OAAA;AAGpC,wCAGqB;AAFnB,sHAAA,0BAA0B,OAAA;AAC1B,sHAAA,0BAA0B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/index.ts"],"names":[],"mappings":";;;AAAA,0CAGsB;AAFpB,mHAAA,sBAAsB,OAAA;AACtB,wHAAA,2BAA2B,OAAA;AAG7B,wCAKqB;AAJnB,mHAAA,uBAAuB,OAAA;AACvB,0HAAA,8BAA8B,OAAA;AAC9B,2HAAA,+BAA+B,OAAA;AAC/B,gHAAA,oBAAoB,OAAA;AAGtB,8CAiBwB;AAhBtB,yHAAA,0BAA0B,OAAA;AAC1B,gIAAA,iCAAiC,OAAA;AACjC,yHAAA,0BAA0B,OAAA;AAC1B,8HAAA,+BAA+B,OAAA;AAC/B,uHAAA,wBAAwB,OAAA;AACxB,sHAAA,uBAAuB,OAAA;AACvB,mIAAA,oCAAoC,OAAA;AACpC,6HAAA,8BAA8B,OAAA;AAC9B,gIAAA,iCAAiC,OAAA;AACjC,wHAAA,yBAAyB,OAAA;AACzB,4HAAA,6BAA6B,OAAA;AAC7B,qIAAA,sCAAsC,OAAA;AACtC,+HAAA,gCAAgC,OAAA;AAChC,gIAAA,iCAAiC,OAAA;AACjC,8HAAA,+BAA+B,OAAA;AAC/B,wIAAA,yCAAyC,OAAA;AAG3C,8CAMwB;AALtB,mIAAA,oCAAoC,OAAA;AACpC,wIAAA,yCAAyC,OAAA;AACzC,oIAAA,qCAAqC,OAAA;AACrC,gIAAA,iCAAiC,OAAA;AACjC,iIAAA,kCAAkC,OAAA;AAGpC,wCAGqB;AAFnB,sHAAA,0BAA0B,OAAA;AAC1B,sHAAA,0BAA0B,OAAA;AAG5B,kDAiB0B;AAhBxB,4HAAA,2BAA2B,OAAA;AAC3B,iIAAA,gCAAgC,OAAA;AAChC,yHAAA,wBAAwB,OAAA;AACxB,0HAAA,yBAAyB,OAAA;AACzB,6HAAA,4BAA4B,OAAA;AAC5B,yHAAA,wBAAwB,OAAA;AACxB,8HAAA,6BAA6B,OAAA;AAC7B,4HAAA,2BAA2B,OAAA;AAC3B,kIAAA,iCAAiC,OAAA;AACjC,wHAAA,uBAAuB,OAAA;AACvB,4HAAA,2BAA2B,OAAA;AAC3B,yHAAA,wBAAwB,OAAA;AACxB,mIAAA,kCAAkC,OAAA;AAClC,0HAAA,yBAAyB,OAAA;AACzB,2HAAA,0BAA0B,OAAA;AAC1B,6HAAA,4BAA4B,OAAA"}

package/dist/test/investigation-context.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/investigation-context.test.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = __importDefault(require("node:test"));
+const src_1 = require("../src");
+(0, node_test_1.default)('parses Gateway topology context DTO for Voyager', () => {
+    const parsed = src_1.gatewayTopologyContextSchema.parse({
+        version: src_1.GATEWAY_TOPOLOGY_CONTEXT_VERSION,
+        initialization: {
+            correlationState: 'probable_match',
+            resolvedVia: 'relationship_attribute_match',
+            confidence: 9,
+            reasonCodes: ['deterministic_service_match'],
+            candidateTargets: [{
+                    entityType: 'service',
+                    id: 'svc-checkout',
+                    displayName: 'checkout',
+                    confidence: 9,
+                }],
+            primaryAnchor: {
+                entityType: 'service',
+                id: 'svc-checkout',
+                displayName: 'checkout',
+            },
+            topologyScope: 'inferred',
+            userMessage: 'Gateway returned a topology slice for service checkout.',
+            topologyAvailable: true,
+        },
+        investigationContext: {
+            topologyAvailable: true,
+            targetService: {
+                id: 'svc-checkout',
+                name: 'checkout',
+                displayName: 'checkout',
+                serviceType: 'service',
+                criticality: 'unknown',
+                environment: 'unknown',
+            },
+            investigationResources: [],
+            recommendedSpecialists: [],
+            eligibleSpecialists: [],
+            relatedServices: { upstream: [], downstream: [] },
+            naturalLanguageSummary: 'Gateway returned a topology slice for service checkout.',
+        },
+        bindingHints: {
+            sourceIntegrationHint: {
+                provider: 'prometheus',
+                integrationId: 'prometheus-prod',
+            },
+            candidateBindings: [],
+        },
+        reasonCodes: ['deterministic_service_match'],
+    });
+    strict_1.default.equal(parsed.version, 'topology.gateway-context.v1');
+    strict_1.default.equal(parsed.initialization.primaryAnchor?.id, 'svc-checkout');
+});
+(0, node_test_1.default)('parses nested topology response DTO used inside Gateway topology slices', () => {
+    const parsed = src_1.nestedTopologyResponseSchema.parse({
+        status: 'success',
+        topology: {
+            entity_type: 'service',
+            id: 'svc-checkout',
+            entity: { name: 'checkout', display_name: 'checkout' },
+            root_refs: {},
+            children: [
+                {
+                    relationship: {
+                        id: 'rel-checkout-deployment',
+                        relation: 'DEPLOYED_AS',
+                        diagnostic_criticality: 'blocking',
+                        attribute_schema_key: 'deployment.kubernetes',
+                        attributes: { namespace: 'prod' },
+                    },
+                    entity_type: 'resource',
+                    id: 'res-k8s-deployment-checkout',
+                    entity: {
+                        name: 'checkout-deployment',
+                        resource_type: 'kubernetes_deployment',
+                        provider: 'k8s',
+                    },
+                    children: [],
+                },
+            ],
+        },
+        stats: {
+            total_nodes: 2,
+            max_depth: 1,
+            structural_edges: 1,
+            associative_edges: 0,
+        },
+    });
+    strict_1.default.equal(parsed.topology.children[0]?.relationship.relation, 'DEPLOYED_AS');
+});
+//# sourceMappingURL=investigation-context.test.js.map

package/dist/test/investigation-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"investigation-context.test.js","sourceRoot":"","sources":["../../test/investigation-context.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scoutflo/topology-contracts",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Pure shared topology vocabulary and Zod schemas for Scoutflo topology workflows.",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",