@soederpop/luca 0.0.3 → 0.0.4

package/src/introspection/generated.agi.ts

@@ -1,7 +1,7 @@
 import { setBuildTimeData, setContainerBuildTimeData } from './index.js';
 
 // Auto-generated introspection registry data
-// Generated at: 2026-03-07T16:53:43.519Z
+// Generated at: 2026-03-12T02:48:58.321Z
 
 setBuildTimeData('features.googleDocs', {
   "id": "features.googleDocs",
@@ -820,7 +820,7 @@ setBuildTimeData('features.esbuild', {
   "className": "ESBuild",
   "methods": {
     "transformSync": {
-      "description": "Transform code synchronously",
+      "description": "/** Transform code synchronously",
       "parameters": {
         "code": {
           "type": "string",
@@ -1948,65 +1948,45 @@ setBuildTimeData('features.proc', {
       ],
       "returns": "void"
     },
-    "runScript": {
-      "description": "Runs a script file with Bun, inheriting stdout for full TTY passthrough (animations, colors, cursor movement) while capturing stderr in a rolling buffer.",
+    "exec": {
+      "description": "Execute a command synchronously and return its output. Runs a shell command and waits for it to complete before returning. Useful for simple commands where you need the result immediately.",
       "parameters": {
-        "scriptPath": {
+        "command": {
           "type": "string",
-          "description": "Absolute path to the script file"
+          "description": "The command to execute"
         },
         "options": {
-          "type": "{ cwd?: string; maxLines?: number; env?: Record<string, string> }",
-          "description": "Options",
-          "properties": {
-            "cwd": {
-              "type": "any",
-              "description": "Working directory"
-            },
-            "maxLines": {
-              "type": "any",
-              "description": "Max stderr lines to keep"
-            },
-            "env": {
-              "type": "any",
-              "description": "Extra environment variables"
-            }
-          }
+          "type": "any",
+          "description": "Options for command execution (cwd, encoding, etc.)"
         }
       },
       "required": [
-        "scriptPath"
+        "command"
       ],
-      "returns": "Promise<{ exitCode: number; stderr: string[] }>",
+      "returns": "string",
       "examples": [
         {
           "language": "ts",
-          "code": "const { exitCode, stderr } = await proc.runScript('/path/to/script.ts')\nif (exitCode !== 0) {\n console.log('Error:', stderr.join('\\n'))\n}"
+          "code": "const branch = proc.exec('git branch --show-current')\nconst version = proc.exec('node --version')"
         }
       ]
     },
-    "exec": {
-      "description": "Execute a command synchronously and return its output. Runs a shell command and waits for it to complete before returning. Useful for simple commands where you need the result immediately.",
+    "execSync": {
+      "description": "",
       "parameters": {
         "command": {
           "type": "string",
-          "description": "The command to execute"
+          "description": "Parameter command"
         },
         "options": {
           "type": "any",
-          "description": "Options for command execution (cwd, encoding, etc.)"
+          "description": "Parameter options"
         }
       },
       "required": [
         "command"
       ],
-      "returns": "string",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "const branch = proc.exec('git branch --show-current')\nconst version = proc.exec('node --version')"
-        }
-      ]
+      "returns": "string"
     },
     "establishLock": {
       "description": "Establishes a PID-file lock to prevent duplicate process instances. Writes the current process PID to the given file path. If the file already exists and the PID inside it refers to a running process, the current process exits immediately. Stale PID files (where the process is no longer running) are automatically cleaned up. Cleanup handlers are registered on SIGTERM, SIGINT, and process exit to remove the PID file when the process shuts down.",
@@ -2305,28 +2285,35 @@ setBuildTimeData('features.vm', {
         }
       ]
     },
+    "wrapTopLevelAwait": {
+      "description": "Wrap code containing top-level `await` in an async IIFE, injecting `return` before the last expression so the value is not lost. If the code does not contain `await`, or is already wrapped in an async function/arrow, it is returned unchanged.",
+      "parameters": {
+        "code": {
+          "type": "string",
+          "description": "Parameter code"
+        }
+      },
+      "required": [
+        "code"
+      ],
+      "returns": "string"
+    },
     "run": {
-      "description": "Executes JavaScript code in a controlled environment. This method creates a script from the provided code, sets up an execution context with the specified variables, and runs the code safely. It handles errors gracefully and returns either the result or the error object.",
+      "description": "",
       "parameters": {
         "code": {
           "type": "string",
-          "description": "The JavaScript code to execute"
+          "description": "Parameter code"
         },
         "ctx": {
           "type": "any",
-          "description": "Context variables to make available to the executing code"
+          "description": "Parameter ctx"
         }
       },
       "required": [
         "code"
       ],
-      "returns": "Promise<T>",
-      "examples": [
-        {
-          "language": "ts",
-          "code": "// Simple calculation\nconst result = vm.run('2 + 3 * 4')\nconsole.log(result) // 14\n\n// Using context variables\nconst greeting = vm.run('`Hello ${name}!`', { name: 'Alice' })\nconsole.log(greeting) // 'Hello Alice!'\n\n// Array operations\nconst sum = vm.run('numbers.reduce((a, b) => a + b, 0)', { \n numbers: [1, 2, 3, 4, 5] \n})\nconsole.log(sum) // 15\n\n// Error handling\nconst error = vm.run('invalidFunction()')\nif (error instanceof Error) {\n console.log('Execution failed:', error.message)\n}"
-        }
-      ]
+      "returns": "Promise<T>"
     },
     "runSync": {
       "description": "Execute JavaScript code synchronously in a controlled environment.",
@@ -5308,6 +5295,19 @@ setBuildTimeData('features.fs', {
         }
       ]
     },
+    "mkdirp": {
+      "description": "",
+      "parameters": {
+        "folder": {
+          "type": "string",
+          "description": "Parameter folder"
+        }
+      },
+      "required": [
+        "folder"
+      ],
+      "returns": "void"
+    },
     "ensureFile": {
       "description": "Synchronously ensures a file exists with the specified content, creating directories as needed.",
       "parameters": {
@@ -5403,6 +5403,19 @@ setBuildTimeData('features.fs', {
         }
       ]
     },
+    "existsSync": {
+      "description": "",
+      "parameters": {
+        "path": {
+          "type": "string",
+          "description": "Parameter path"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "returns": "boolean"
+    },
     "rm": {
       "description": "Asynchronously removes a file.",
       "parameters": {
@@ -8484,6 +8497,12 @@ setBuildTimeData('features.contentDb', {
         }
       ]
     },
+    "reload": {
+      "description": "Force-reload the collection from disk, picking up new/changed/deleted documents.",
+      "parameters": {},
+      "required": [],
+      "returns": "Promise<ContentDb>"
+    },
     "read": {
       "description": "Read a single document by its path ID, optionally filtering to specific sections. The document title (H1) is always included in the output. When using `include`, the leading content (paragraphs between the H1 and first H2) is also included by default, controlled by the `leadingContent` option. When `include` is provided, only those sections are returned (via extractSections in flat mode). When `exclude` is provided, those sections are removed from the full document. If both are set, `include` takes precedence.",
       "parameters": {
@@ -8683,7 +8702,13 @@ setBuildTimeData('features.contentDb', {
       ]
     }
   },
-  "events": {},
+  "events": {
+    "reloaded": {
+      "name": "reloaded",
+      "description": "Event emitted by ContentDb",
+      "arguments": {}
+    }
+  },
   "state": {},
   "options": {},
   "envVars": [],
@@ -8862,7 +8887,7 @@ setBuildTimeData('servers.mcp', {
 
 setBuildTimeData('servers.express', {
   "id": "servers.express",
-  "description": "ExpressServer helper",
+  "description": "Express.js HTTP server with automatic endpoint mounting, CORS, and SPA history fallback. Wraps an Express application with convention-based endpoint discovery. Endpoints defined as modules are automatically mounted as routes. Supports static file serving, CORS configuration, and single-page app history fallback out of the box.",
   "shortcut": "servers.express",
   "className": "ExpressServer",
   "methods": {
@@ -8955,12 +8980,18 @@ setBuildTimeData('servers.express', {
   "events": {},
   "state": {},
   "options": {},
-  "envVars": []
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const server = container.server('express', { cors: true, static: './public' })\nawait server.start({ port: 3000 })\n\n// Mount endpoints programmatically\nserver.mount(myEndpoint)\n\n// Access the underlying Express app\nserver.app.get('/health', (req, res) => res.json({ ok: true }))"
+    }
+  ]
 });
 
 setBuildTimeData('servers.websocket', {
   "id": "servers.websocket",
-  "description": "WebsocketServer helper",
+  "description": "WebSocket server built on the `ws` library with optional JSON message framing. Manages WebSocket connections, tracks connected clients, and bridges messages to Luca's event bus. When `json` mode is enabled, messages are automatically parsed and stringified.",
   "shortcut": "servers.websocket",
   "className": "WebsocketServer",
   "methods": {
@@ -9037,7 +9068,13 @@ setBuildTimeData('servers.websocket', {
   },
   "state": {},
   "options": {},
-  "envVars": []
+  "envVars": [],
+  "examples": [
+    {
+      "language": "ts",
+      "code": "const ws = container.server('websocket', { json: true })\nawait ws.start({ port: 8080 })\n\nws.on('message', (client, data) => {\n console.log('Received:', data)\n ws.broadcast({ echo: data })\n})"
+    }
+  ]
 });
 
 setBuildTimeData('features.assistantsManager', {
@@ -12534,7 +12571,7 @@ export const introspectionData = [
     "className": "ESBuild",
     "methods": {
       "transformSync": {
-        "description": "Transform code synchronously",
+        "description": "/** Transform code synchronously",
         "parameters": {
           "code": {
             "type": "string",
@@ -13658,65 +13695,45 @@ export const introspectionData = [
         ],
         "returns": "void"
       },
-      "runScript": {
-        "description": "Runs a script file with Bun, inheriting stdout for full TTY passthrough (animations, colors, cursor movement) while capturing stderr in a rolling buffer.",
+      "exec": {
+        "description": "Execute a command synchronously and return its output. Runs a shell command and waits for it to complete before returning. Useful for simple commands where you need the result immediately.",
         "parameters": {
-          "scriptPath": {
+          "command": {
             "type": "string",
-            "description": "Absolute path to the script file"
+            "description": "The command to execute"
           },
           "options": {
-            "type": "{ cwd?: string; maxLines?: number; env?: Record<string, string> }",
-            "description": "Options",
-            "properties": {
-              "cwd": {
-                "type": "any",
-                "description": "Working directory"
-              },
-              "maxLines": {
-                "type": "any",
-                "description": "Max stderr lines to keep"
-              },
-              "env": {
-                "type": "any",
-                "description": "Extra environment variables"
-              }
-            }
+            "type": "any",
+            "description": "Options for command execution (cwd, encoding, etc.)"
           }
         },
         "required": [
-          "scriptPath"
+          "command"
         ],
-        "returns": "Promise<{ exitCode: number; stderr: string[] }>",
+        "returns": "string",
         "examples": [
           {
             "language": "ts",
-            "code": "const { exitCode, stderr } = await proc.runScript('/path/to/script.ts')\nif (exitCode !== 0) {\n console.log('Error:', stderr.join('\\n'))\n}"
+            "code": "const branch = proc.exec('git branch --show-current')\nconst version = proc.exec('node --version')"
           }
         ]
       },
-      "exec": {
-        "description": "Execute a command synchronously and return its output. Runs a shell command and waits for it to complete before returning. Useful for simple commands where you need the result immediately.",
+      "execSync": {
+        "description": "",
         "parameters": {
           "command": {
             "type": "string",
-            "description": "The command to execute"
+            "description": "Parameter command"
           },
           "options": {
             "type": "any",
-            "description": "Options for command execution (cwd, encoding, etc.)"
+            "description": "Parameter options"
           }
         },
         "required": [
           "command"
         ],
-        "returns": "string",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "const branch = proc.exec('git branch --show-current')\nconst version = proc.exec('node --version')"
-          }
-        ]
+        "returns": "string"
       },
       "establishLock": {
         "description": "Establishes a PID-file lock to prevent duplicate process instances. Writes the current process PID to the given file path. If the file already exists and the PID inside it refers to a running process, the current process exits immediately. Stale PID files (where the process is no longer running) are automatically cleaned up. Cleanup handlers are registered on SIGTERM, SIGINT, and process exit to remove the PID file when the process shuts down.",
@@ -14013,28 +14030,35 @@ export const introspectionData = [
           }
         ]
       },
+      "wrapTopLevelAwait": {
+        "description": "Wrap code containing top-level `await` in an async IIFE, injecting `return` before the last expression so the value is not lost. If the code does not contain `await`, or is already wrapped in an async function/arrow, it is returned unchanged.",
+        "parameters": {
+          "code": {
+            "type": "string",
+            "description": "Parameter code"
+          }
+        },
+        "required": [
+          "code"
+        ],
+        "returns": "string"
+      },
       "run": {
-        "description": "Executes JavaScript code in a controlled environment. This method creates a script from the provided code, sets up an execution context with the specified variables, and runs the code safely. It handles errors gracefully and returns either the result or the error object.",
+        "description": "",
         "parameters": {
           "code": {
             "type": "string",
-            "description": "The JavaScript code to execute"
+            "description": "Parameter code"
           },
           "ctx": {
             "type": "any",
-            "description": "Context variables to make available to the executing code"
+            "description": "Parameter ctx"
           }
         },
         "required": [
           "code"
         ],
-        "returns": "Promise<T>",
-        "examples": [
-          {
-            "language": "ts",
-            "code": "// Simple calculation\nconst result = vm.run('2 + 3 * 4')\nconsole.log(result) // 14\n\n// Using context variables\nconst greeting = vm.run('`Hello ${name}!`', { name: 'Alice' })\nconsole.log(greeting) // 'Hello Alice!'\n\n// Array operations\nconst sum = vm.run('numbers.reduce((a, b) => a + b, 0)', { \n numbers: [1, 2, 3, 4, 5] \n})\nconsole.log(sum) // 15\n\n// Error handling\nconst error = vm.run('invalidFunction()')\nif (error instanceof Error) {\n console.log('Execution failed:', error.message)\n}"
-          }
-        ]
+        "returns": "Promise<T>"
       },
       "runSync": {
         "description": "Execute JavaScript code synchronously in a controlled environment.",
@@ -16999,6 +17023,19 @@ export const introspectionData = [
           }
         ]
       },
+      "mkdirp": {
+        "description": "",
+        "parameters": {
+          "folder": {
+            "type": "string",
+            "description": "Parameter folder"
+          }
+        },
+        "required": [
+          "folder"
+        ],
+        "returns": "void"
+      },
       "ensureFile": {
         "description": "Synchronously ensures a file exists with the specified content, creating directories as needed.",
         "parameters": {
@@ -17094,6 +17131,19 @@ export const introspectionData = [
           }
         ]
       },
+      "existsSync": {
+        "description": "",
+        "parameters": {
+          "path": {
+            "type": "string",
+            "description": "Parameter path"
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "returns": "boolean"
+      },
       "rm": {
         "description": "Asynchronously removes a file.",
         "parameters": {
@@ -20160,6 +20210,12 @@ export const introspectionData = [
           }
         ]
       },
+      "reload": {
+        "description": "Force-reload the collection from disk, picking up new/changed/deleted documents.",
+        "parameters": {},
+        "required": [],
+        "returns": "Promise<ContentDb>"
+      },
       "read": {
         "description": "Read a single document by its path ID, optionally filtering to specific sections. The document title (H1) is always included in the output. When using `include`, the leading content (paragraphs between the H1 and first H2) is also included by default, controlled by the `leadingContent` option. When `include` is provided, only those sections are returned (via extractSections in flat mode). When `exclude` is provided, those sections are removed from the full document. If both are set, `include` takes precedence.",
         "parameters": {
@@ -20359,7 +20415,13 @@ export const introspectionData = [
         ]
       }
     },
-    "events": {},
+    "events": {
+      "reloaded": {
+        "name": "reloaded",
+        "description": "Event emitted by ContentDb",
+        "arguments": {}
+      }
+    },
     "state": {},
     "options": {},
     "envVars": [],
@@ -20536,7 +20598,7 @@ export const introspectionData = [
   },
   {
     "id": "servers.express",
-    "description": "ExpressServer helper",
+    "description": "Express.js HTTP server with automatic endpoint mounting, CORS, and SPA history fallback. Wraps an Express application with convention-based endpoint discovery. Endpoints defined as modules are automatically mounted as routes. Supports static file serving, CORS configuration, and single-page app history fallback out of the box.",
     "shortcut": "servers.express",
     "className": "ExpressServer",
     "methods": {
@@ -20629,11 +20691,17 @@ export const introspectionData = [
     "events": {},
     "state": {},
     "options": {},
-    "envVars": []
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const server = container.server('express', { cors: true, static: './public' })\nawait server.start({ port: 3000 })\n\n// Mount endpoints programmatically\nserver.mount(myEndpoint)\n\n// Access the underlying Express app\nserver.app.get('/health', (req, res) => res.json({ ok: true }))"
+      }
+    ]
   },
   {
     "id": "servers.websocket",
-    "description": "WebsocketServer helper",
+    "description": "WebSocket server built on the `ws` library with optional JSON message framing. Manages WebSocket connections, tracks connected clients, and bridges messages to Luca's event bus. When `json` mode is enabled, messages are automatically parsed and stringified.",
     "shortcut": "servers.websocket",
     "className": "WebsocketServer",
     "methods": {
@@ -20710,7 +20778,13 @@ export const introspectionData = [
     },
     "state": {},
     "options": {},
-    "envVars": []
+    "envVars": [],
+    "examples": [
+      {
+        "language": "ts",
+        "code": "const ws = container.server('websocket', { json: true })\nawait ws.start({ port: 8080 })\n\nws.on('message', (client, data) => {\n console.log('Received:', data)\n ws.broadcast({ echo: data })\n})"
+      }
+    ]
   },
   {
     "id": "features.assistantsManager",