@northflare/runner 0.0.1

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 (154) hide show
  1. package/DEBUG_LOGGING.md +60 -0
  2. package/LICENSE +21 -0
  3. package/MIGRATION_PLAN.md +52 -0
  4. package/README.md +220 -0
  5. package/SDK_IMPLEMENTATION_GUIDE.md +1036 -0
  6. package/bin/northflare-runner +367 -0
  7. package/coverage/base.css +224 -0
  8. package/coverage/block-navigation.js +87 -0
  9. package/coverage/coverage-final.json +12 -0
  10. package/coverage/favicon.png +0 -0
  11. package/coverage/index.html +176 -0
  12. package/coverage/lib/index.html +116 -0
  13. package/coverage/lib/preload-script.js.html +964 -0
  14. package/coverage/prettify.css +1 -0
  15. package/coverage/prettify.js +2 -0
  16. package/coverage/sort-arrow-sprite.png +0 -0
  17. package/coverage/sorter.js +196 -0
  18. package/coverage/src/collections/index.html +116 -0
  19. package/coverage/src/collections/runner-messages.ts.html +312 -0
  20. package/coverage/src/components/claude-manager.ts.html +1290 -0
  21. package/coverage/src/components/index.html +146 -0
  22. package/coverage/src/components/message-handler.ts.html +730 -0
  23. package/coverage/src/components/repository-manager.ts.html +841 -0
  24. package/coverage/src/index.html +131 -0
  25. package/coverage/src/index.ts.html +448 -0
  26. package/coverage/src/runner.ts.html +1239 -0
  27. package/coverage/src/utils/config.ts.html +780 -0
  28. package/coverage/src/utils/console.ts.html +121 -0
  29. package/coverage/src/utils/index.html +161 -0
  30. package/coverage/src/utils/logger.ts.html +475 -0
  31. package/coverage/src/utils/status-line.ts.html +445 -0
  32. package/dist/collections/runner-messages.d.ts +52 -0
  33. package/dist/collections/runner-messages.d.ts.map +1 -0
  34. package/dist/collections/runner-messages.js +161 -0
  35. package/dist/collections/runner-messages.js.map +1 -0
  36. package/dist/components/claude-manager.d.ts +39 -0
  37. package/dist/components/claude-manager.d.ts.map +1 -0
  38. package/dist/components/claude-manager.js +783 -0
  39. package/dist/components/claude-manager.js.map +1 -0
  40. package/dist/components/claude-sdk-manager.d.ts +47 -0
  41. package/dist/components/claude-sdk-manager.d.ts.map +1 -0
  42. package/dist/components/claude-sdk-manager.js +1088 -0
  43. package/dist/components/claude-sdk-manager.js.map +1 -0
  44. package/dist/components/enhanced-repository-manager.d.ts +134 -0
  45. package/dist/components/enhanced-repository-manager.d.ts.map +1 -0
  46. package/dist/components/enhanced-repository-manager.js +602 -0
  47. package/dist/components/enhanced-repository-manager.js.map +1 -0
  48. package/dist/components/message-handler-sse.d.ts +46 -0
  49. package/dist/components/message-handler-sse.d.ts.map +1 -0
  50. package/dist/components/message-handler-sse.js +734 -0
  51. package/dist/components/message-handler-sse.js.map +1 -0
  52. package/dist/components/message-handler.d.ts +35 -0
  53. package/dist/components/message-handler.d.ts.map +1 -0
  54. package/dist/components/message-handler.js +689 -0
  55. package/dist/components/message-handler.js.map +1 -0
  56. package/dist/components/repository-manager.d.ts +51 -0
  57. package/dist/components/repository-manager.d.ts.map +1 -0
  58. package/dist/components/repository-manager.js +295 -0
  59. package/dist/components/repository-manager.js.map +1 -0
  60. package/dist/index.d.ts +9 -0
  61. package/dist/index.d.ts.map +1 -0
  62. package/dist/index.js +166 -0
  63. package/dist/index.js.map +1 -0
  64. package/dist/runner-sse.d.ts +57 -0
  65. package/dist/runner-sse.d.ts.map +1 -0
  66. package/dist/runner-sse.js +698 -0
  67. package/dist/runner-sse.js.map +1 -0
  68. package/dist/runner.d.ts +51 -0
  69. package/dist/runner.d.ts.map +1 -0
  70. package/dist/runner.js +530 -0
  71. package/dist/runner.js.map +1 -0
  72. package/dist/services/RunnerAPIClient.d.ts +30 -0
  73. package/dist/services/RunnerAPIClient.d.ts.map +1 -0
  74. package/dist/services/RunnerAPIClient.js +112 -0
  75. package/dist/services/RunnerAPIClient.js.map +1 -0
  76. package/dist/services/SSEClient.d.ts +60 -0
  77. package/dist/services/SSEClient.d.ts.map +1 -0
  78. package/dist/services/SSEClient.js +204 -0
  79. package/dist/services/SSEClient.js.map +1 -0
  80. package/dist/types/claude.d.ts +45 -0
  81. package/dist/types/claude.d.ts.map +1 -0
  82. package/dist/types/claude.js +6 -0
  83. package/dist/types/claude.js.map +1 -0
  84. package/dist/types/index.d.ts +47 -0
  85. package/dist/types/index.d.ts.map +1 -0
  86. package/dist/types/index.js +23 -0
  87. package/dist/types/index.js.map +1 -0
  88. package/dist/types/messages.d.ts +31 -0
  89. package/dist/types/messages.d.ts.map +1 -0
  90. package/dist/types/messages.js +6 -0
  91. package/dist/types/messages.js.map +1 -0
  92. package/dist/types/runner-interface.d.ts +24 -0
  93. package/dist/types/runner-interface.d.ts.map +1 -0
  94. package/dist/types/runner-interface.js +6 -0
  95. package/dist/types/runner-interface.js.map +1 -0
  96. package/dist/utils/StateManager.d.ts +52 -0
  97. package/dist/utils/StateManager.d.ts.map +1 -0
  98. package/dist/utils/StateManager.js +162 -0
  99. package/dist/utils/StateManager.js.map +1 -0
  100. package/dist/utils/config.d.ts +41 -0
  101. package/dist/utils/config.d.ts.map +1 -0
  102. package/dist/utils/config.js +250 -0
  103. package/dist/utils/config.js.map +1 -0
  104. package/dist/utils/console.d.ts +11 -0
  105. package/dist/utils/console.d.ts.map +1 -0
  106. package/dist/utils/console.js +15 -0
  107. package/dist/utils/console.js.map +1 -0
  108. package/dist/utils/expand-env.d.ts +2 -0
  109. package/dist/utils/expand-env.d.ts.map +1 -0
  110. package/dist/utils/expand-env.js +20 -0
  111. package/dist/utils/expand-env.js.map +1 -0
  112. package/dist/utils/logger.d.ts +9 -0
  113. package/dist/utils/logger.d.ts.map +1 -0
  114. package/dist/utils/logger.js +108 -0
  115. package/dist/utils/logger.js.map +1 -0
  116. package/dist/utils/status-line.d.ts +37 -0
  117. package/dist/utils/status-line.d.ts.map +1 -0
  118. package/dist/utils/status-line.js +113 -0
  119. package/dist/utils/status-line.js.map +1 -0
  120. package/docs/claude-manager.md +91 -0
  121. package/exceptions.log +22 -0
  122. package/lib/preload-script.js +293 -0
  123. package/package.json +55 -0
  124. package/rejections.log +63 -0
  125. package/runner.log +488 -0
  126. package/src/components/claude-sdk-manager.ts +1354 -0
  127. package/src/components/enhanced-repository-manager.ts +823 -0
  128. package/src/components/message-handler-sse.ts +1011 -0
  129. package/src/components/repository-manager.ts +337 -0
  130. package/src/index.ts +166 -0
  131. package/src/runner-sse.ts +847 -0
  132. package/src/services/RunnerAPIClient.ts +135 -0
  133. package/src/services/SSEClient.ts +258 -0
  134. package/src/types/claude.ts +55 -0
  135. package/src/types/computer-name.d.ts +4 -0
  136. package/src/types/index.ts +63 -0
  137. package/src/types/messages.ts +39 -0
  138. package/src/types/runner-interface.ts +34 -0
  139. package/src/utils/StateManager.ts +187 -0
  140. package/src/utils/codex-sdk.js +448 -0
  141. package/src/utils/config.ts +315 -0
  142. package/src/utils/console.ts +13 -0
  143. package/src/utils/expand-env.ts +22 -0
  144. package/src/utils/logger.ts +131 -0
  145. package/src/utils/sdk-demo.js +34 -0
  146. package/src/utils/status-line.ts +121 -0
  147. package/test-debug.sh +26 -0
  148. package/tests/retry-strategies.test.ts +410 -0
  149. package/tests/sdk-integration.test.ts +329 -0
  150. package/tests/sdk-streaming.test.ts +1180 -0
  151. package/tests/setup.ts +5 -0
  152. package/tests/test-claude-manager.ts +120 -0
  153. package/tsconfig.json +36 -0
  154. package/vitest.config.ts +27 -0
package/tests/setup.ts ADDED
@@ -0,0 +1,5 @@
1
+ // Test setup file
2
+ // Mock environment variables for testing
3
+ process.env.NORTHFLARE_RUNNER_TOKEN = "test-token";
4
+ process.env.NORTHFLARE_WORKSPACE_DIR = "/test/workspace";
5
+ process.env.NORTHFLARE_ORCHESTRATOR_URL = "http://orchestrator.test";
@@ -0,0 +1,120 @@
1
+ /**
2
+ * Test script for ClaudeManager integration
3
+ */
4
+
5
+ import { RunnerApp } from "../src/runner";
6
+ import { ClaudeManager } from "../src/components/claude-manager";
7
+ import { RepositoryManager } from "../src/components/repository-manager";
8
+ import { ConversationConfig, ConversationContext } from "../src/types";
9
+
10
+ // Mock runner app for testing
11
+ const mockRunner = {
12
+ config_: {
13
+ orchestratorUrl: "https://example.com",
14
+ runnerId: "test-runner",
15
+ },
16
+ activeConversations_: new Map<string, ConversationContext>(),
17
+ getConversationContext: function (taskId: string): ConversationContext {
18
+ const context = this.activeConversations_.get(taskId);
19
+ if (!context) {
20
+ throw new Error(`No conversation context for task ${taskId}`);
21
+ }
22
+ return context;
23
+ },
24
+ notify: async function (method: string, params: any) {
25
+ console.log(`NOTIFY: ${method}`, params);
26
+ },
27
+ } as unknown as RunnerApp;
28
+
29
+ // Create test instances
30
+ const repositoryManager = new RepositoryManager(mockRunner);
31
+ const claudeManager = new ClaudeManager(mockRunner, repositoryManager);
32
+
33
+ async function testClaudeManager() {
34
+ console.log("Testing ClaudeManager integration...\n");
35
+
36
+ const taskId = "test-task-123";
37
+ const workspaceId = "test-workspace-456";
38
+
39
+ // Create test conversation config
40
+ const config: ConversationConfig = {
41
+ model: "sonnet",
42
+ systemPrompt: "You are a helpful assistant.",
43
+ instructions: "Help the user with their coding tasks.",
44
+ permissionsMode: "all",
45
+ accessKey: "test-access-key",
46
+ workspaceId: workspaceId,
47
+ mcpServers: {
48
+ // Test MCP configuration from orchestrator
49
+ "test-server": {
50
+ command: "test-mcp-server",
51
+ args: ["--test"],
52
+ },
53
+ },
54
+ };
55
+
56
+ // Create conversation context
57
+ const context: ConversationContext = {
58
+ taskId,
59
+ workspaceId,
60
+ status: "starting",
61
+ config,
62
+ startedAt: new Date(),
63
+ lastActivityAt: new Date(),
64
+ };
65
+
66
+ mockRunner.activeConversations_.set(taskId, context);
67
+
68
+ // Test 1: Start conversation
69
+ console.log("Test 1: Starting conversation...");
70
+ try {
71
+ await claudeManager.startConversation(taskId, config, [
72
+ { content: "Hello, Claude!" },
73
+ ]);
74
+ console.log("✅ Conversation start initiated\n");
75
+ } catch (error) {
76
+ console.error("❌ Failed to start conversation:", error);
77
+ }
78
+
79
+ // Test 2: Send user message
80
+ console.log("Test 2: Sending user message...");
81
+ try {
82
+ // Simulate conversation being active
83
+ context.status = "active";
84
+ context.sessionId = "test-session-123";
85
+
86
+ await claudeManager.sendUserMessage(
87
+ taskId,
88
+ "test-session-123",
89
+ "How are you?"
90
+ );
91
+ console.log("✅ User message sent\n");
92
+ } catch (error) {
93
+ console.error("❌ Failed to send user message:", error);
94
+ }
95
+
96
+ // Test 3: Resume conversation
97
+ console.log("Test 3: Resuming conversation...");
98
+ try {
99
+ await claudeManager.resumeConversation(taskId, "test-session-123", config);
100
+ console.log("✅ Conversation resume initiated\n");
101
+ } catch (error) {
102
+ console.error("❌ Failed to resume conversation:", error);
103
+ }
104
+
105
+ // Test 4: Stop conversation
106
+ console.log("Test 4: Stopping conversation...");
107
+ try {
108
+ await claudeManager.stopConversation(taskId, "test-session-123");
109
+ console.log("✅ Conversation stopped\n");
110
+ } catch (error) {
111
+ console.error("❌ Failed to stop conversation:", error);
112
+ }
113
+
114
+ console.log("Testing complete!");
115
+ }
116
+
117
+ // Run tests if this is the main module
118
+ if (require.main === module) {
119
+ testClaudeManager().catch(console.error);
120
+ }
package/tsconfig.json ADDED
@@ -0,0 +1,36 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "module": "commonjs",
5
+ "lib": ["ES2022"],
6
+ "rootDir": "./src",
7
+ "outDir": "./dist",
8
+ "strict": true,
9
+ "esModuleInterop": true,
10
+ "skipLibCheck": true,
11
+ "forceConsistentCasingInFileNames": true,
12
+ "resolveJsonModule": true,
13
+ "declaration": true,
14
+ "declarationMap": true,
15
+ "sourceMap": true,
16
+ "moduleResolution": "node",
17
+ "baseUrl": "./src",
18
+ "paths": {
19
+ "@/*": ["*"],
20
+ "@components/*": ["components/*"],
21
+ "@utils/*": ["utils/*"],
22
+ "@types/*": ["types/*"]
23
+ },
24
+ "noUnusedLocals": false,
25
+ "noUnusedParameters": false,
26
+ "noImplicitReturns": true,
27
+ "noFallthroughCasesInSwitch": true,
28
+ "noUncheckedIndexedAccess": true,
29
+ "noImplicitOverride": true,
30
+ "noPropertyAccessFromIndexSignature": true,
31
+ "allowUnusedLabels": false,
32
+ "allowUnreachableCode": false
33
+ },
34
+ "include": ["src/**/*"],
35
+ "exclude": ["node_modules", "dist", "tests"]
36
+ }
@@ -0,0 +1,27 @@
1
+ import { defineConfig } from 'vitest/config';
2
+ import path from 'path';
3
+
4
+ export default defineConfig({
5
+ test: {
6
+ globals: true,
7
+ environment: 'node',
8
+ setupFiles: ['./tests/setup.ts'],
9
+ testTimeout: 10000,
10
+ coverage: {
11
+ provider: 'v8',
12
+ reporter: ['text', 'json', 'html'],
13
+ exclude: [
14
+ 'node_modules/',
15
+ 'dist/',
16
+ '**/*.d.ts',
17
+ '**/types/**',
18
+ 'tests/**'
19
+ ]
20
+ }
21
+ },
22
+ resolve: {
23
+ alias: {
24
+ '@': path.resolve(__dirname, './src')
25
+ }
26
+ }
27
+ });