@mytecz/teczflow-core 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/assets/config.json +32 -0
  2. package/assets/fixtures/git/payment-schema-change.json +14 -0
  3. package/assets/fixtures/shopflow.openapi.yaml +178 -0
  4. package/assets/fixtures/shopflow.postman.json +60 -0
  5. package/assets/fixtures/telemetry/checkout-errors.json +87 -0
  6. package/dist/adapters/git.adapter.d.ts +11 -0
  7. package/dist/adapters/git.adapter.d.ts.map +1 -0
  8. package/dist/adapters/git.adapter.js +61 -0
  9. package/dist/adapters/git.adapter.js.map +1 -0
  10. package/dist/adapters/graphql.adapter.d.ts +11 -0
  11. package/dist/adapters/graphql.adapter.d.ts.map +1 -0
  12. package/dist/adapters/graphql.adapter.js +86 -0
  13. package/dist/adapters/graphql.adapter.js.map +1 -0
  14. package/dist/adapters/logs.adapter.d.ts +11 -0
  15. package/dist/adapters/logs.adapter.d.ts.map +1 -0
  16. package/dist/adapters/logs.adapter.js +47 -0
  17. package/dist/adapters/logs.adapter.js.map +1 -0
  18. package/dist/adapters/openapi.adapter.d.ts +12 -0
  19. package/dist/adapters/openapi.adapter.d.ts.map +1 -0
  20. package/dist/adapters/openapi.adapter.js +143 -0
  21. package/dist/adapters/openapi.adapter.js.map +1 -0
  22. package/dist/adapters/postman.adapter.d.ts +11 -0
  23. package/dist/adapters/postman.adapter.d.ts.map +1 -0
  24. package/dist/adapters/postman.adapter.js +91 -0
  25. package/dist/adapters/postman.adapter.js.map +1 -0
  26. package/dist/adapters/telemetry.adapter.d.ts +32 -0
  27. package/dist/adapters/telemetry.adapter.d.ts.map +1 -0
  28. package/dist/adapters/telemetry.adapter.js +61 -0
  29. package/dist/adapters/telemetry.adapter.js.map +1 -0
  30. package/dist/core/config.manager.d.ts +17 -0
  31. package/dist/core/config.manager.d.ts.map +1 -0
  32. package/dist/core/config.manager.js +133 -0
  33. package/dist/core/config.manager.js.map +1 -0
  34. package/dist/core/graph.engine.d.ts +29 -0
  35. package/dist/core/graph.engine.d.ts.map +1 -0
  36. package/dist/core/graph.engine.js +207 -0
  37. package/dist/core/graph.engine.js.map +1 -0
  38. package/dist/core/graph.store.d.ts +10 -0
  39. package/dist/core/graph.store.d.ts.map +1 -0
  40. package/dist/core/graph.store.js +17 -0
  41. package/dist/core/graph.store.js.map +1 -0
  42. package/dist/core/reasoning.engine.d.ts +37 -0
  43. package/dist/core/reasoning.engine.d.ts.map +1 -0
  44. package/dist/core/reasoning.engine.js +265 -0
  45. package/dist/core/reasoning.engine.js.map +1 -0
  46. package/dist/core/telemetry.normalizer.d.ts +11 -0
  47. package/dist/core/telemetry.normalizer.d.ts.map +1 -0
  48. package/dist/core/telemetry.normalizer.js +87 -0
  49. package/dist/core/telemetry.normalizer.js.map +1 -0
  50. package/dist/index.d.ts +47 -0
  51. package/dist/index.d.ts.map +1 -0
  52. package/dist/index.js +136 -0
  53. package/dist/index.js.map +1 -0
  54. package/dist/services/index.d.ts +70 -0
  55. package/dist/services/index.d.ts.map +1 -0
  56. package/dist/services/index.js +181 -0
  57. package/dist/services/index.js.map +1 -0
  58. package/dist/types/index.d.ts +187 -0
  59. package/dist/types/index.d.ts.map +1 -0
  60. package/dist/types/index.js +2 -0
  61. package/dist/types/index.js.map +1 -0
  62. package/package.json +55 -0
@@ -0,0 +1,87 @@
1
+ export class TelemetryNormalizer {
2
+ static fromMockFixture(data) {
3
+ return {
4
+ logs: (data.logs ?? []).map(normalizeLog),
5
+ metrics: (data.metrics ?? []).map(normalizeMetric),
6
+ traces: (data.traces ?? []).map(normalizeSpan)
7
+ };
8
+ }
9
+ static fromLogLines(lines, parser = 'json') {
10
+ const logs = [];
11
+ for (const line of lines) {
12
+ if (!line.trim())
13
+ continue;
14
+ try {
15
+ if (parser === 'json') {
16
+ const parsed = JSON.parse(line);
17
+ logs.push({
18
+ timestamp: String(parsed.timestamp ?? new Date().toISOString()),
19
+ method: String(parsed.method ?? parsed.httpMethod ?? ''),
20
+ path: String(parsed.path ?? parsed.httpRoute ?? parsed.uri ?? ''),
21
+ status: Number(parsed.status ?? parsed.statusCode ?? 0),
22
+ latencyMs: Number(parsed.latencyMs ?? parsed.duration ?? 0),
23
+ message: String(parsed.message ?? parsed.error ?? ''),
24
+ service: String(parsed.service ?? parsed.serviceName ?? ''),
25
+ requestId: String(parsed.requestId ?? parsed.traceId ?? '')
26
+ });
27
+ }
28
+ else {
29
+ logs.push(parseAccessLogLine(line));
30
+ }
31
+ }
32
+ catch {
33
+ logs.push(parseAccessLogLine(line));
34
+ }
35
+ }
36
+ return { logs, metrics: [], traces: [] };
37
+ }
38
+ }
39
+ function normalizeLog(raw) {
40
+ return {
41
+ timestamp: String(raw.timestamp ?? new Date().toISOString()),
42
+ method: raw.method ? String(raw.method) : undefined,
43
+ path: raw.path ? String(raw.path) : undefined,
44
+ status: raw.status ? Number(raw.status) : undefined,
45
+ latencyMs: raw.latencyMs ? Number(raw.latencyMs) : undefined,
46
+ message: raw.message ? String(raw.message) : undefined,
47
+ service: raw.service ? String(raw.service) : undefined,
48
+ requestId: raw.requestId ? String(raw.requestId) : undefined
49
+ };
50
+ }
51
+ function normalizeMetric(raw) {
52
+ return {
53
+ name: String(raw.name ?? 'unknown'),
54
+ value: Number(raw.value ?? 0),
55
+ unit: raw.unit ? String(raw.unit) : undefined,
56
+ timestamp: String(raw.timestamp ?? new Date().toISOString()),
57
+ tags: raw.tags
58
+ };
59
+ }
60
+ function normalizeSpan(raw) {
61
+ return {
62
+ traceId: String(raw.traceId ?? 'trace-unknown'),
63
+ spanId: String(raw.spanId ?? 'span-unknown'),
64
+ parentSpanId: raw.parentSpanId ? String(raw.parentSpanId) : undefined,
65
+ serviceName: String(raw.serviceName ?? raw.service ?? 'unknown'),
66
+ operationName: String(raw.operationName ?? raw.name ?? 'unknown'),
67
+ httpMethod: raw.httpMethod ? String(raw.httpMethod) : undefined,
68
+ httpRoute: raw.httpRoute ? String(raw.httpRoute) : undefined,
69
+ statusCode: raw.statusCode ? Number(raw.statusCode) : undefined,
70
+ durationMs: Number(raw.durationMs ?? raw.duration ?? 0),
71
+ timestamp: String(raw.timestamp ?? new Date().toISOString())
72
+ };
73
+ }
74
+ function parseAccessLogLine(line) {
75
+ const parts = line.split(' ');
76
+ const method = parts.find((p) => /^(GET|POST|PUT|PATCH|DELETE)$/i.test(p));
77
+ const path = parts.find((p) => p.startsWith('/'));
78
+ const status = parts.find((p) => /^[45]\d{2}$/.test(p));
79
+ return {
80
+ timestamp: new Date().toISOString(),
81
+ method: method?.toUpperCase(),
82
+ path,
83
+ status: status ? parseInt(status, 10) : undefined,
84
+ message: line
85
+ };
86
+ }
87
+ //# sourceMappingURL=telemetry.normalizer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telemetry.normalizer.js","sourceRoot":"","sources":["../../src/core/telemetry.normalizer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,47 @@
1
+ import { ConfigManager } from './core/config.manager.js';
2
+ import { GraphEngine } from './core/graph.engine.js';
3
+ import { DebugService, DiscoveryService, GraphService, ImpactService, SearchService, WorkflowService } from './services/index.js';
4
+ import type { AdapterInput, FeatureFlags, IngestResult } from './types/index.js';
5
+ export declare class TeczFlowEngine {
6
+ private config;
7
+ private store;
8
+ private graphs;
9
+ private reasoning;
10
+ private services;
11
+ private adapters;
12
+ private telemetryRegistry;
13
+ private activeTenant;
14
+ constructor(configPath?: string);
15
+ getConfigManager(): ConfigManager;
16
+ setActiveTenant(tenantId: string): void;
17
+ getActiveTenant(): string;
18
+ getGraph(tenantId?: string): GraphEngine;
19
+ getServices(tenantId?: string): TenantServices;
20
+ load(input: AdapterInput, tenantId?: string): Promise<IngestResult>;
21
+ loadAll(paths: Array<{
22
+ path: string;
23
+ format: AdapterInput['format'];
24
+ }>, tenantId?: string): Promise<IngestResult[]>;
25
+ refreshTelemetry(tenantId?: string): Promise<number>;
26
+ listTenants(): string[];
27
+ getFeatureFlags(): FeatureFlags;
28
+ private getOrCreateGraph;
29
+ private getOrCreateReasoning;
30
+ private getOrCreateServices;
31
+ private persistGraph;
32
+ }
33
+ export interface TenantServices {
34
+ discovery: DiscoveryService;
35
+ search: SearchService;
36
+ workflow: WorkflowService;
37
+ debug: DebugService;
38
+ impact: ImpactService;
39
+ graphService: GraphService;
40
+ }
41
+ export { ConfigManager } from './core/config.manager.js';
42
+ export { GraphEngine } from './core/graph.engine.js';
43
+ export { ReasoningEngine, parseErrorDescription } from './core/reasoning.engine.js';
44
+ export { TelemetryNormalizer } from './core/telemetry.normalizer.js';
45
+ export { MockTelemetryAdapter } from './adapters/telemetry.adapter.js';
46
+ export * from './types/index.js';
47
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AASrD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAiB,MAAM,kBAAkB,CAAC;AAGhG,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,YAAY,CAAS;gBAEjB,UAAU,CAAC,EAAE,MAAM;IAiB/B,gBAAgB,IAAI,aAAa;IAIjC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKvC,eAAe,IAAI,MAAM;IAIzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW;IAIxC,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc;IAIxC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAYnE,OAAO,CACX,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAC,EAC9D,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,EAAE,CAAC;IAQpB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB1D,WAAW,IAAI,MAAM,EAAE;IAIvB,eAAe,IAAI,YAAY;IAI/B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,mBAAmB;YAgBb,YAAY;CAM3B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,cAAc,kBAAkB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,136 @@
1
+ import { ConfigManager } from './core/config.manager.js';
2
+ import { GraphEngine } from './core/graph.engine.js';
3
+ import { InMemoryGraphStore } from './core/graph.store.js';
4
+ import { ReasoningEngine } from './core/reasoning.engine.js';
5
+ import { OpenApiAdapter } from './adapters/openapi.adapter.js';
6
+ import { PostmanAdapter } from './adapters/postman.adapter.js';
7
+ import { GraphqlAdapter } from './adapters/graphql.adapter.js';
8
+ import { LogsAdapter } from './adapters/logs.adapter.js';
9
+ import { GitAdapter } from './adapters/git.adapter.js';
10
+ import { TelemetryRegistry } from './adapters/telemetry.adapter.js';
11
+ import { DebugService, DiscoveryService, GraphService, ImpactService, SearchService, WorkflowService } from './services/index.js';
12
+ export class TeczFlowEngine {
13
+ config;
14
+ store;
15
+ graphs = new Map();
16
+ reasoning = new Map();
17
+ services = new Map();
18
+ adapters;
19
+ telemetryRegistry;
20
+ activeTenant;
21
+ constructor(configPath) {
22
+ this.config = new ConfigManager(configPath);
23
+ this.store = new InMemoryGraphStore();
24
+ this.telemetryRegistry = TelemetryRegistry.createDefault();
25
+ this.activeTenant = this.config.getDefaultTenant();
26
+ const getGraph = (ctx) => this.getOrCreateGraph(ctx.tenantId);
27
+ this.adapters = [
28
+ new OpenApiAdapter(getGraph),
29
+ new PostmanAdapter(getGraph),
30
+ new GraphqlAdapter(getGraph),
31
+ new LogsAdapter(getGraph),
32
+ new GitAdapter(getGraph)
33
+ ];
34
+ }
35
+ getConfigManager() {
36
+ return this.config;
37
+ }
38
+ setActiveTenant(tenantId) {
39
+ this.activeTenant = tenantId;
40
+ this.getOrCreateServices(tenantId);
41
+ }
42
+ getActiveTenant() {
43
+ return this.activeTenant;
44
+ }
45
+ getGraph(tenantId) {
46
+ return this.getOrCreateGraph(tenantId ?? this.activeTenant);
47
+ }
48
+ getServices(tenantId) {
49
+ return this.getOrCreateServices(tenantId ?? this.activeTenant);
50
+ }
51
+ async load(input, tenantId) {
52
+ const ctx = { tenantId: tenantId ?? this.activeTenant };
53
+ const adapter = this.adapters.find((a) => a.canHandle(input));
54
+ if (!adapter) {
55
+ throw new Error(`No adapter found for input: ${input.format ?? input.path}`);
56
+ }
57
+ const result = await adapter.ingest(input, ctx);
58
+ await this.persistGraph(ctx.tenantId);
59
+ await this.refreshTelemetry(ctx.tenantId);
60
+ return result;
61
+ }
62
+ async loadAll(paths, tenantId) {
63
+ const results = [];
64
+ for (const p of paths) {
65
+ results.push(await this.load({ type: 'file', path: p.path, format: p.format }, tenantId));
66
+ }
67
+ return results;
68
+ }
69
+ async refreshTelemetry(tenantId) {
70
+ const tid = tenantId ?? this.activeTenant;
71
+ if (!this.config.isFeatureEnabled('telemetry'))
72
+ return 0;
73
+ const providers = this.config.getTelemetryProviders(tid);
74
+ const ctx = { tenantId: tid };
75
+ let totalEdges = 0;
76
+ for (const providerConfig of providers) {
77
+ const adapter = this.telemetryRegistry.get(providerConfig.type);
78
+ if (!adapter)
79
+ continue;
80
+ await adapter.connect(providerConfig, ctx);
81
+ const signals = await adapter.fetchSignals();
82
+ const reasoning = this.getOrCreateReasoning(tid);
83
+ totalEdges += reasoning.enrichFromTelemetry(signals);
84
+ }
85
+ if (totalEdges > 0) {
86
+ await this.persistGraph(tid);
87
+ }
88
+ return totalEdges;
89
+ }
90
+ listTenants() {
91
+ return this.config.listTenants();
92
+ }
93
+ getFeatureFlags() {
94
+ return this.config.getFeatureFlags();
95
+ }
96
+ getOrCreateGraph(tenantId) {
97
+ if (!this.graphs.has(tenantId)) {
98
+ this.graphs.set(tenantId, new GraphEngine(tenantId));
99
+ }
100
+ return this.graphs.get(tenantId);
101
+ }
102
+ getOrCreateReasoning(tenantId) {
103
+ if (!this.reasoning.has(tenantId)) {
104
+ this.reasoning.set(tenantId, new ReasoningEngine(this.getOrCreateGraph(tenantId)));
105
+ }
106
+ return this.reasoning.get(tenantId);
107
+ }
108
+ getOrCreateServices(tenantId) {
109
+ if (!this.services.has(tenantId)) {
110
+ const graph = this.getOrCreateGraph(tenantId);
111
+ const reasoning = this.getOrCreateReasoning(tenantId);
112
+ this.services.set(tenantId, {
113
+ discovery: new DiscoveryService(graph),
114
+ search: new SearchService(graph),
115
+ workflow: new WorkflowService(reasoning),
116
+ debug: new DebugService(graph, reasoning),
117
+ impact: new ImpactService(graph, reasoning),
118
+ graphService: new GraphService(graph)
119
+ });
120
+ }
121
+ return this.services.get(tenantId);
122
+ }
123
+ async persistGraph(tenantId) {
124
+ const graph = this.graphs.get(tenantId);
125
+ if (graph) {
126
+ await this.store.save(tenantId, graph.toSnapshot());
127
+ }
128
+ }
129
+ }
130
+ export { ConfigManager } from './core/config.manager.js';
131
+ export { GraphEngine } from './core/graph.engine.js';
132
+ export { ReasoningEngine, parseErrorDescription } from './core/reasoning.engine.js';
133
+ export { TelemetryNormalizer } from './core/telemetry.normalizer.js';
134
+ export { MockTelemetryAdapter } from './adapters/telemetry.adapter.js';
135
+ export * from './types/index.js';
136
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,70 @@
1
+ import type { ApiSummary, EndpointInfo, WorkflowResult } from '../types/index.js';
2
+ import type { GraphEngine } from '../core/graph.engine.js';
3
+ import type { ReasoningEngine } from '../core/reasoning.engine.js';
4
+ export declare class WorkflowService {
5
+ private reasoning;
6
+ constructor(reasoning: ReasoningEngine);
7
+ infer(goal: string): WorkflowResult;
8
+ }
9
+ export declare class DiscoveryService {
10
+ private graph;
11
+ constructor(graph: GraphEngine);
12
+ listApis(): ApiSummary[];
13
+ listEndpoints(api?: string): EndpointInfo[];
14
+ getApiSummary(api: string): ApiSummary | null;
15
+ }
16
+ export declare class SearchService {
17
+ private graph;
18
+ constructor(graph: GraphEngine);
19
+ search(query: string): import("../types/index.js").SearchResult[];
20
+ }
21
+ export declare class DebugService {
22
+ private graph;
23
+ private reasoning;
24
+ constructor(graph: GraphEngine, reasoning: ReasoningEngine);
25
+ explain(endpointRef: string, request?: Record<string, unknown>, response?: {
26
+ status: number;
27
+ body?: unknown;
28
+ }): import("../types/index.js").ReasoningResult;
29
+ }
30
+ export declare class ImpactService {
31
+ private graph;
32
+ private reasoning;
33
+ constructor(graph: GraphEngine, reasoning: ReasoningEngine);
34
+ analyze(endpointRef: string): {
35
+ conclusion: string;
36
+ confidence: import("../types/index.js").Confidence;
37
+ evidence: import("../types/index.js").Evidence[];
38
+ changedNodeId: string;
39
+ affected: {
40
+ nodeId: string;
41
+ type: import("../types/index.js").NodeType;
42
+ label: string;
43
+ impact: string;
44
+ severity: "high" | "medium" | "low";
45
+ }[];
46
+ };
47
+ }
48
+ export declare class GraphService {
49
+ private graph;
50
+ constructor(graph: GraphEngine);
51
+ getApiGraph(api: string): {
52
+ nodes: never[];
53
+ edges: never[];
54
+ api?: undefined;
55
+ } | {
56
+ api: string;
57
+ nodes: (import("../types/index.js").GraphNode | undefined)[];
58
+ edges: import("../types/index.js").GraphEdge[];
59
+ };
60
+ getDependencies(endpointRef: string): {
61
+ endpoint: string;
62
+ dependencies: never[];
63
+ endpointId?: undefined;
64
+ } | {
65
+ endpoint: string;
66
+ endpointId: string;
67
+ dependencies: import("../types/index.js").GraphNode[];
68
+ };
69
+ }
70
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE,qBAAa,eAAe;IACd,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,eAAe;IAE9C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;CA6BpC;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,WAAW;IAEtC,QAAQ,IAAI,UAAU,EAAE;IAiCxB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAO3C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;CAQ9C;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,WAAW;IAEtC,MAAM,CAAC,KAAK,EAAE,MAAM;CAGrB;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,SAAS;gBADT,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,eAAe;IAGpC,OAAO,CACL,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,QAAQ,GAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAoB;CAYjE;AAED,qBAAa,aAAa;IAEtB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,SAAS;gBADT,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,eAAe;IAGpC,OAAO,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;CAyB5B;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,WAAW;IAEtC,WAAW,CAAC,GAAG,EAAE,MAAM;;;;;;;;;IA4BvB,eAAe,CAAC,WAAW,EAAE,MAAM;;;;;;;;;CAepC"}
@@ -0,0 +1,181 @@
1
+ export class WorkflowService {
2
+ reasoning;
3
+ constructor(reasoning) {
4
+ this.reasoning = reasoning;
5
+ }
6
+ infer(goal) {
7
+ const { steps, evidence, confidence } = this.reasoning.inferWorkflowGoal(goal);
8
+ const workflowSteps = steps.map((s) => ({
9
+ order: s.order,
10
+ endpointId: s.endpoint.id,
11
+ method: s.endpoint.properties.method,
12
+ path: s.endpoint.properties.path,
13
+ label: s.endpoint.label,
14
+ reason: s.reason
15
+ }));
16
+ const conclusion = workflowSteps.length > 0
17
+ ? `Inferred workflow for "${goal}": ${workflowSteps.map((s) => s.label).join(' → ')}`
18
+ : `No workflow inferred for "${goal}". Try loading more API specs or using more specific terms.`;
19
+ return {
20
+ conclusion,
21
+ confidence,
22
+ evidence,
23
+ steps: workflowSteps,
24
+ goal,
25
+ suggestedNextSteps: workflowSteps.length === 0
26
+ ? ['Load OpenAPI spec with checkout-related tags', 'Enable telemetry for observed flows']
27
+ : undefined
28
+ };
29
+ }
30
+ }
31
+ export class DiscoveryService {
32
+ graph;
33
+ constructor(graph) {
34
+ this.graph = graph;
35
+ }
36
+ listApis() {
37
+ return this.graph.listApis().map((api) => {
38
+ const apiId = api.id;
39
+ const endpoints = this.graph.listEndpoints(apiId);
40
+ const tags = new Set();
41
+ const services = new Set();
42
+ const authSchemes = new Set();
43
+ for (const ep of endpoints) {
44
+ ep.tags.forEach((t) => tags.add(t));
45
+ }
46
+ for (const edge of this.graph.getEdges('observed_calls')) {
47
+ const target = this.graph.getNode(edge.target);
48
+ if (target?.type === 'Service')
49
+ services.add(target.label);
50
+ }
51
+ for (const node of this.graph.getNodes('Auth')) {
52
+ authSchemes.add(node.label);
53
+ }
54
+ return {
55
+ apiId,
56
+ name: api.label,
57
+ description: api.properties.description,
58
+ endpointCount: endpoints.length,
59
+ services: Array.from(services),
60
+ tags: Array.from(tags),
61
+ authSchemes: Array.from(authSchemes)
62
+ };
63
+ });
64
+ }
65
+ listEndpoints(api) {
66
+ const apiNode = api
67
+ ? this.graph.listApis().find((a) => a.id === api || a.label.toLowerCase() === api.toLowerCase())
68
+ : undefined;
69
+ return this.graph.listEndpoints(apiNode?.id);
70
+ }
71
+ getApiSummary(api) {
72
+ const summaries = this.listApis();
73
+ return (summaries.find((s) => s.apiId === api || s.name.toLowerCase() === api.toLowerCase()) ?? null);
74
+ }
75
+ }
76
+ export class SearchService {
77
+ graph;
78
+ constructor(graph) {
79
+ this.graph = graph;
80
+ }
81
+ search(query) {
82
+ return this.graph.search(query);
83
+ }
84
+ }
85
+ export class DebugService {
86
+ graph;
87
+ reasoning;
88
+ constructor(graph, reasoning) {
89
+ this.graph = graph;
90
+ this.reasoning = reasoning;
91
+ }
92
+ explain(endpointRef, request = {}, response = { status: 400 }) {
93
+ const parsed = parseEndpointRef(endpointRef);
94
+ const endpoint = this.graph.findEndpointByPath(parsed.method ?? 'POST', parsed.path ?? endpointRef) ??
95
+ this.graph.findNodesByLabel(parsed.path ?? endpointRef, 'Endpoint')[0];
96
+ return this.reasoning.explainError(endpoint, request, {
97
+ status: parsed.status ?? response.status,
98
+ body: response.body
99
+ });
100
+ }
101
+ }
102
+ export class ImpactService {
103
+ graph;
104
+ reasoning;
105
+ constructor(graph, reasoning) {
106
+ this.graph = graph;
107
+ this.reasoning = reasoning;
108
+ }
109
+ analyze(endpointRef) {
110
+ const endpoint = this.graph.findNodesByLabel(endpointRef, 'Endpoint')[0] ??
111
+ this.graph.findEndpointByPath('POST', endpointRef);
112
+ const nodeId = endpoint?.id ?? endpointRef;
113
+ const { affected, evidence, confidence } = this.reasoning.analyzeImpact(nodeId);
114
+ return {
115
+ conclusion: affected.length > 0
116
+ ? `Changing ${endpoint?.label ?? endpointRef} may impact ${affected.length} dependent node(s).`
117
+ : `No significant dependencies found for ${endpointRef}.`,
118
+ confidence,
119
+ evidence,
120
+ changedNodeId: nodeId,
121
+ affected: affected.map((a) => ({
122
+ nodeId: a.node.id,
123
+ type: a.node.type,
124
+ label: a.node.label,
125
+ impact: a.impact,
126
+ severity: a.severity
127
+ }))
128
+ };
129
+ }
130
+ }
131
+ export class GraphService {
132
+ graph;
133
+ constructor(graph) {
134
+ this.graph = graph;
135
+ }
136
+ getApiGraph(api) {
137
+ const apiNode = this.graph.listApis().find((a) => a.id === api || a.label.toLowerCase().includes(api.toLowerCase())) ?? this.graph.listApis()[0];
138
+ if (!apiNode)
139
+ return { nodes: [], edges: [] };
140
+ const endpoints = this.graph.listEndpoints(apiNode.id);
141
+ const nodeIds = new Set([apiNode.id]);
142
+ for (const ep of endpoints)
143
+ nodeIds.add(ep.id);
144
+ for (const edge of this.graph.getEdges()) {
145
+ if (nodeIds.has(edge.source) || nodeIds.has(edge.target)) {
146
+ nodeIds.add(edge.source);
147
+ nodeIds.add(edge.target);
148
+ }
149
+ }
150
+ return {
151
+ api: apiNode.label,
152
+ nodes: Array.from(nodeIds)
153
+ .map((id) => this.graph.getNode(id))
154
+ .filter(Boolean),
155
+ edges: this.graph.getEdges().filter((e) => nodeIds.has(e.source) && nodeIds.has(e.target))
156
+ };
157
+ }
158
+ getDependencies(endpointRef) {
159
+ const endpoint = this.graph.findNodesByLabel(endpointRef, 'Endpoint')[0] ??
160
+ this.graph.findEndpointByPath('GET', endpointRef);
161
+ if (!endpoint) {
162
+ return { endpoint: endpointRef, dependencies: [] };
163
+ }
164
+ return {
165
+ endpoint: endpoint.label,
166
+ endpointId: endpoint.id,
167
+ dependencies: this.graph.getDependencies(endpoint.id)
168
+ };
169
+ }
170
+ }
171
+ function parseEndpointRef(ref) {
172
+ const methodMatch = ref.match(/^(GET|POST|PUT|PATCH|DELETE)\s+/i);
173
+ const pathMatch = ref.match(/(\/[a-zA-Z0-9_/{}\-]+)/);
174
+ const statusMatch = ref.match(/\b(400|401|403|404|500)\b/);
175
+ return {
176
+ method: methodMatch?.[1]?.toUpperCase(),
177
+ path: pathMatch?.[1],
178
+ status: statusMatch ? parseInt(statusMatch[1], 10) : undefined
179
+ };
180
+ }
181
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"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"}