@orbytautomation/engine 0.4.1 → 0.5.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/core/OrbytEngine.d.ts +3 -21
- package/dist/core/OrbytEngine.d.ts.map +1 -1
- package/dist/core/OrbytEngine.js +33 -138
- package/dist/core/OrbytEngine.js.map +1 -1
- package/dist/loader/WorkflowLoader.d.ts +6 -0
- package/dist/loader/WorkflowLoader.d.ts.map +1 -1
- package/dist/loader/WorkflowLoader.js +64 -14
- package/dist/loader/WorkflowLoader.js.map +1 -1
- package/dist/logging/EngineLogger.d.ts +93 -57
- package/dist/logging/EngineLogger.d.ts.map +1 -1
- package/dist/logging/EngineLogger.js +188 -54
- package/dist/logging/EngineLogger.js.map +1 -1
- package/dist/logging/LoggerManager.d.ts +16 -3
- package/dist/logging/LoggerManager.d.ts.map +1 -1
- package/dist/logging/LoggerManager.js +26 -9
- package/dist/logging/LoggerManager.js.map +1 -1
- package/dist/parser/WorkflowParser.d.ts.map +1 -1
- package/dist/parser/WorkflowParser.js +0 -5
- package/dist/parser/WorkflowParser.js.map +1 -1
- package/dist/security/ReservedFields.d.ts +11 -0
- package/dist/security/ReservedFields.d.ts.map +1 -1
- package/dist/security/ReservedFields.js +71 -34
- package/dist/security/ReservedFields.js.map +1 -1
- package/dist/types/log-types.d.ts +95 -2
- package/dist/types/log-types.d.ts.map +1 -1
- package/dist/types/log-types.js +10 -0
- package/dist/types/log-types.js.map +1 -1
- package/package.json +1 -1
|
@@ -1,4 +1,47 @@
|
|
|
1
1
|
import { LogLevel } from "@dev-ecosystem/core";
|
|
2
|
+
/**
|
|
3
|
+
* Log categories (phase-based, not feature-based)
|
|
4
|
+
*
|
|
5
|
+
* - 'system': Engine lifecycle, infrastructure, configuration, adapter registration
|
|
6
|
+
* - 'analysis': Parsing, validation, explain, plan building, cycle detection
|
|
7
|
+
* - 'runtime': Actual workflow execution (steps, retries, completion, failures)
|
|
8
|
+
* - 'security': Internal field violation, reserved field usage, permission rejection
|
|
9
|
+
*
|
|
10
|
+
* Never add feature, adapter, or business domain categories here.
|
|
11
|
+
*/
|
|
12
|
+
export type LogCategory = 'system' | 'analysis' | 'runtime' | 'security';
|
|
13
|
+
/**
|
|
14
|
+
* Enum for log categories (for strict usage)
|
|
15
|
+
*/
|
|
16
|
+
export declare enum LogCategoryEnum {
|
|
17
|
+
SYSTEM = "system",
|
|
18
|
+
ANALYSIS = "analysis",
|
|
19
|
+
RUNTIME = "runtime",
|
|
20
|
+
SECURITY = "security"
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Interface for a structured engine log entry
|
|
24
|
+
* Every log must have a category and source.
|
|
25
|
+
*/
|
|
26
|
+
export interface EngineLog {
|
|
27
|
+
timestamp: number;
|
|
28
|
+
level: 'info' | 'warn' | 'error';
|
|
29
|
+
category: LogCategory;
|
|
30
|
+
source: string;
|
|
31
|
+
message: string;
|
|
32
|
+
context?: Record<string, unknown>;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Engine log structure (every log must have category and source)
|
|
36
|
+
*/
|
|
37
|
+
export interface EngineLog {
|
|
38
|
+
timestamp: number;
|
|
39
|
+
level: 'info' | 'warn' | 'error';
|
|
40
|
+
category: LogCategory;
|
|
41
|
+
source: string;
|
|
42
|
+
message: string;
|
|
43
|
+
context?: Record<string, unknown>;
|
|
44
|
+
}
|
|
2
45
|
/**
|
|
3
46
|
* Engine-specific log format type
|
|
4
47
|
*/
|
|
@@ -36,7 +79,7 @@ export declare enum EngineLogType {
|
|
|
36
79
|
ERROR = "error"
|
|
37
80
|
}
|
|
38
81
|
/**
|
|
39
|
-
* Structured engine log event
|
|
82
|
+
* Structured engine log event (with category and source)
|
|
40
83
|
*/
|
|
41
84
|
export interface EngineLogEvent {
|
|
42
85
|
/** Event type */
|
|
@@ -45,6 +88,10 @@ export interface EngineLogEvent {
|
|
|
45
88
|
timestamp: Date;
|
|
46
89
|
/** Log message */
|
|
47
90
|
message: string;
|
|
91
|
+
/** Log category (phase) */
|
|
92
|
+
category: LogCategory;
|
|
93
|
+
/** Log source (component/module) */
|
|
94
|
+
source: string;
|
|
48
95
|
/** Additional context */
|
|
49
96
|
context?: Record<string, unknown>;
|
|
50
97
|
/** Error object if applicable */
|
|
@@ -98,8 +145,54 @@ export interface EngineLoggerConfig {
|
|
|
98
145
|
/** Include timestamps */
|
|
99
146
|
timestamp?: boolean;
|
|
100
147
|
/** Source identifier */
|
|
101
|
-
source
|
|
148
|
+
source: string;
|
|
102
149
|
/** Enable structured event logging */
|
|
103
150
|
structuredEvents?: boolean;
|
|
151
|
+
/** Log category */
|
|
152
|
+
category: LogCategory;
|
|
153
|
+
}
|
|
154
|
+
/**
|
|
155
|
+
* Export logs in formats suitable for different consumers
|
|
156
|
+
*/
|
|
157
|
+
export interface ExportedLogs {
|
|
158
|
+
/** Raw JSON logs */
|
|
159
|
+
raw: EngineLogEvent[];
|
|
160
|
+
/** Logs grouped by type */
|
|
161
|
+
grouped: Record<string, EngineLogEvent[]>;
|
|
162
|
+
/** Statistics */
|
|
163
|
+
stats: {
|
|
164
|
+
total: number;
|
|
165
|
+
byType: Record<string, number>;
|
|
166
|
+
withErrors: number;
|
|
167
|
+
withMetrics: number;
|
|
168
|
+
timeRange: {
|
|
169
|
+
first?: Date;
|
|
170
|
+
last?: Date;
|
|
171
|
+
};
|
|
172
|
+
};
|
|
173
|
+
/** Workflow execution summary for explanation */
|
|
174
|
+
execution?: {
|
|
175
|
+
workflow?: {
|
|
176
|
+
name: string;
|
|
177
|
+
status: string;
|
|
178
|
+
duration?: number;
|
|
179
|
+
};
|
|
180
|
+
steps: Array<{
|
|
181
|
+
id: string;
|
|
182
|
+
name: string;
|
|
183
|
+
status: string;
|
|
184
|
+
duration?: number;
|
|
185
|
+
}>;
|
|
186
|
+
errors: Array<{
|
|
187
|
+
step?: string;
|
|
188
|
+
message: string;
|
|
189
|
+
error?: Error;
|
|
190
|
+
}>;
|
|
191
|
+
metrics: Array<{
|
|
192
|
+
label: string;
|
|
193
|
+
duration?: number;
|
|
194
|
+
memory?: number;
|
|
195
|
+
}>;
|
|
196
|
+
};
|
|
104
197
|
}
|
|
105
198
|
//# sourceMappingURL=log-types.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"log-types.d.ts","sourceRoot":"","sources":["../../src/types/log-types.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"log-types.d.ts","sourceRoot":"","sources":["../../src/types/log-types.ts"],"names":[],"mappings":"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"}
|
package/dist/types/log-types.js
CHANGED
|
@@ -1,3 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enum for log categories (for strict usage)
|
|
3
|
+
*/
|
|
4
|
+
export var LogCategoryEnum;
|
|
5
|
+
(function (LogCategoryEnum) {
|
|
6
|
+
LogCategoryEnum["SYSTEM"] = "system";
|
|
7
|
+
LogCategoryEnum["ANALYSIS"] = "analysis";
|
|
8
|
+
LogCategoryEnum["RUNTIME"] = "runtime";
|
|
9
|
+
LogCategoryEnum["SECURITY"] = "security";
|
|
10
|
+
})(LogCategoryEnum || (LogCategoryEnum = {}));
|
|
1
11
|
/**
|
|
2
12
|
* Engine log event types - All possible log events in the engine
|
|
3
13
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"log-types.js","sourceRoot":"","sources":["../../src/types/log-types.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"log-types.js","sourceRoot":"","sources":["../../src/types/log-types.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,wCAAqB,CAAA;IACrB,sCAAmB,CAAA;IACnB,wCAAqB,CAAA;AACvB,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAiCD;;GAEG;AACH,MAAM,CAAN,IAAY,aA2CX;AA3CD,WAAY,aAAa;IACvB,qBAAqB;IACrB,sDAAqC,CAAA;IACrC,0DAAyC,CAAA;IACzC,oDAAmC,CAAA;IACnC,4DAA2C,CAAA;IAE3C,iBAAiB;IACjB,8CAA6B,CAAA;IAC7B,kDAAiC,CAAA;IACjC,4CAA2B,CAAA;IAC3B,0CAAyB,CAAA;IACzB,8CAA6B,CAAA;IAE7B,cAAc;IACd,gEAA+C,CAAA;IAC/C,0DAAyC,CAAA;IAEzC,mBAAmB;IACnB,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,sDAAqC,CAAA;IACrC,oDAAmC,CAAA;IAEnC,gBAAgB;IAChB,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,sDAAqC,CAAA;IAErC,cAAc;IACd,0DAAyC,CAAA;IACzC,kDAAiC,CAAA;IAEjC,SAAS;IACT,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,sDAAqC,CAAA;IAErC,UAAU;IACV,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,gCAAe,CAAA;AACjB,CAAC,EA3CW,aAAa,KAAb,aAAa,QA2CxB"}
|