@tyvm/knowhow 0.0.20 → 0.0.22

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 (72) hide show
  1. package/package.json +3 -1
  2. package/src/agents/base/base.ts +16 -77
  3. package/src/agents/tools/executeScript/README.md +78 -0
  4. package/src/agents/tools/executeScript/definition.ts +73 -0
  5. package/src/agents/tools/executeScript/examples/quick-test.ts +80 -0
  6. package/src/agents/tools/executeScript/examples/serialization-test.ts +309 -0
  7. package/src/agents/tools/executeScript/examples/test-runner.ts +204 -0
  8. package/src/agents/tools/executeScript/index.ts +74 -0
  9. package/src/agents/tools/index.ts +1 -0
  10. package/src/agents/tools/list.ts +2 -1
  11. package/src/cli.ts +2 -6
  12. package/src/clients/index.ts +23 -9
  13. package/src/services/Tools.ts +150 -9
  14. package/src/services/script-execution/SandboxContext.ts +278 -0
  15. package/src/services/script-execution/ScriptExecutor.ts +337 -0
  16. package/src/services/script-execution/ScriptPolicy.ts +236 -0
  17. package/src/services/script-execution/ScriptTracer.ts +249 -0
  18. package/src/services/script-execution/types.ts +134 -0
  19. package/ts_build/src/agents/base/base.js +2 -53
  20. package/ts_build/src/agents/base/base.js.map +1 -1
  21. package/ts_build/src/agents/tools/executeScript/definition.d.ts +2 -0
  22. package/ts_build/src/agents/tools/executeScript/definition.js +70 -0
  23. package/ts_build/src/agents/tools/executeScript/definition.js.map +1 -0
  24. package/ts_build/src/agents/tools/executeScript/examples/quick-test.d.ts +3 -0
  25. package/ts_build/src/agents/tools/executeScript/examples/quick-test.js +68 -0
  26. package/ts_build/src/agents/tools/executeScript/examples/quick-test.js.map +1 -0
  27. package/ts_build/src/agents/tools/executeScript/examples/serialization-test.d.ts +15 -0
  28. package/ts_build/src/agents/tools/executeScript/examples/serialization-test.js +267 -0
  29. package/ts_build/src/agents/tools/executeScript/examples/serialization-test.js.map +1 -0
  30. package/ts_build/src/agents/tools/executeScript/examples/simple-example.d.ts +20 -0
  31. package/ts_build/src/agents/tools/executeScript/examples/simple-example.js +35 -0
  32. package/ts_build/src/agents/tools/executeScript/examples/simple-example.js.map +1 -0
  33. package/ts_build/src/agents/tools/executeScript/examples/test-runner.d.ts +4 -0
  34. package/ts_build/src/agents/tools/executeScript/examples/test-runner.js +202 -0
  35. package/ts_build/src/agents/tools/executeScript/examples/test-runner.js.map +1 -0
  36. package/ts_build/src/agents/tools/executeScript/handler.d.ts +27 -0
  37. package/ts_build/src/agents/tools/executeScript/handler.js +64 -0
  38. package/ts_build/src/agents/tools/executeScript/handler.js.map +1 -0
  39. package/ts_build/src/agents/tools/executeScript/index.d.ts +27 -0
  40. package/ts_build/src/agents/tools/executeScript/index.js +64 -0
  41. package/ts_build/src/agents/tools/executeScript/index.js.map +1 -0
  42. package/ts_build/src/agents/tools/executeScript.d.ts +29 -0
  43. package/ts_build/src/agents/tools/executeScript.js +124 -0
  44. package/ts_build/src/agents/tools/executeScript.js.map +1 -0
  45. package/ts_build/src/agents/tools/index.d.ts +1 -0
  46. package/ts_build/src/agents/tools/index.js +1 -0
  47. package/ts_build/src/agents/tools/index.js.map +1 -1
  48. package/ts_build/src/agents/tools/list.js +2 -0
  49. package/ts_build/src/agents/tools/list.js.map +1 -1
  50. package/ts_build/src/cli.js +2 -6
  51. package/ts_build/src/cli.js.map +1 -1
  52. package/ts_build/src/clients/index.d.ts +9 -2
  53. package/ts_build/src/clients/index.js +17 -4
  54. package/ts_build/src/clients/index.js.map +1 -1
  55. package/ts_build/src/services/Tools.d.ts +11 -1
  56. package/ts_build/src/services/Tools.js +94 -3
  57. package/ts_build/src/services/Tools.js.map +1 -1
  58. package/ts_build/src/services/script-execution/SandboxContext.d.ts +34 -0
  59. package/ts_build/src/services/script-execution/SandboxContext.js +188 -0
  60. package/ts_build/src/services/script-execution/SandboxContext.js.map +1 -0
  61. package/ts_build/src/services/script-execution/ScriptExecutor.d.ts +17 -0
  62. package/ts_build/src/services/script-execution/ScriptExecutor.js +207 -0
  63. package/ts_build/src/services/script-execution/ScriptExecutor.js.map +1 -0
  64. package/ts_build/src/services/script-execution/ScriptPolicy.d.ts +27 -0
  65. package/ts_build/src/services/script-execution/ScriptPolicy.js +150 -0
  66. package/ts_build/src/services/script-execution/ScriptPolicy.js.map +1 -0
  67. package/ts_build/src/services/script-execution/ScriptTracer.d.ts +19 -0
  68. package/ts_build/src/services/script-execution/ScriptTracer.js +186 -0
  69. package/ts_build/src/services/script-execution/ScriptTracer.js.map +1 -0
  70. package/ts_build/src/services/script-execution/types.d.ts +108 -0
  71. package/ts_build/src/services/script-execution/types.js +3 -0
  72. package/ts_build/src/services/script-execution/types.js.map +1 -0
@@ -0,0 +1,108 @@
1
+ import { Message } from '../../clients/types';
2
+ export interface TraceEvent {
3
+ id: string;
4
+ type: string;
5
+ timestamp: number;
6
+ data: any;
7
+ }
8
+ export interface TraceMetrics {
9
+ executionTimeMs: number;
10
+ toolCallCount: number;
11
+ llmCallCount: number;
12
+ tokenUsage: {
13
+ prompt: number;
14
+ completion: number;
15
+ total: number;
16
+ };
17
+ memoryUsage: {
18
+ heapUsed: number;
19
+ heapTotal: number;
20
+ };
21
+ costUsd: number;
22
+ }
23
+ export interface ExecutionTrace {
24
+ id: string;
25
+ startTime: number;
26
+ endTime: number;
27
+ events: TraceEvent[];
28
+ metrics: TraceMetrics;
29
+ success: boolean;
30
+ error?: string;
31
+ }
32
+ export interface ResourceQuotas {
33
+ maxToolCalls: number;
34
+ maxTokens: number;
35
+ maxExecutionTimeMs: number;
36
+ maxCostUsd: number;
37
+ maxMemoryMb: number;
38
+ }
39
+ export interface SecurityPolicy {
40
+ allowlistedTools: string[];
41
+ denylistedTools: string[];
42
+ maxScriptLength: number;
43
+ allowNetworkAccess: boolean;
44
+ allowFileSystemAccess: boolean;
45
+ }
46
+ export interface QuotaUsage {
47
+ toolCalls: number;
48
+ tokens: number;
49
+ executionTimeMs: number;
50
+ costUsd: number;
51
+ }
52
+ export interface PolicyViolation {
53
+ id: string;
54
+ type: 'quota_exceeded' | 'tool_denied' | 'tool_not_allowed' | 'script_validation';
55
+ message: string;
56
+ timestamp: number;
57
+ usage: QuotaUsage;
58
+ }
59
+ export interface ExecutionRequest {
60
+ script: string;
61
+ context?: Record<string, any>;
62
+ quotas?: Partial<ResourceQuotas>;
63
+ policy?: Partial<SecurityPolicy>;
64
+ }
65
+ export interface ExecutionResult {
66
+ success: boolean;
67
+ error: string | null;
68
+ result: any;
69
+ trace: ExecutionTrace;
70
+ artifacts: Artifact[];
71
+ consoleOutput: string[];
72
+ }
73
+ export interface Artifact {
74
+ id: string;
75
+ name: string;
76
+ type: 'text' | 'json' | 'csv' | 'html' | 'markdown';
77
+ content: string;
78
+ createdAt: string;
79
+ }
80
+ export interface ToolResult {
81
+ success: boolean;
82
+ result?: any;
83
+ error?: string;
84
+ }
85
+ export interface ToolCall {
86
+ id: string;
87
+ name: string;
88
+ args: Record<string, any>;
89
+ result?: any;
90
+ error?: string;
91
+ timestamp: number;
92
+ duration?: number;
93
+ }
94
+ export interface LLMCall {
95
+ id: string;
96
+ model: string;
97
+ messages: Message[];
98
+ response?: any;
99
+ error?: string;
100
+ timestamp: number;
101
+ duration?: number;
102
+ tokenUsage?: {
103
+ prompt: number;
104
+ completion: number;
105
+ total: number;
106
+ };
107
+ cost?: number;
108
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/services/script-execution/types.ts"],"names":[],"mappings":""}