@soederpop/luca 0.0.6 → 0.0.8

package/docs/apis/features/agi/conversation.md

@@ -1,6 +1,6 @@
 # Conversation (features.conversation)
 
-No description provided
+A self-contained conversation with OpenAI that supports streaming, tool calling, and message state management.
 
 ## Usage
 
@@ -174,115 +174,228 @@ Append a message to the conversation state.
 
 ### summarizeStart
 
-Event emitted by Conversation
+Fired before generating a conversation summary
 
 
 
 ### summarizeEnd
 
-Event emitted by Conversation
+Fired after the summary is generated
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | The generated summary text |
 
 
 
 ### compactStart
 
-Event emitted by Conversation
+Fired before compacting the conversation history
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `messageCount` | `number` |  |
+| `keepRecent` | `number` |  |
 
 
 
 ### compactEnd
 
-Event emitted by Conversation
+Fired after compaction completes
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `summary` | `string` |  |
+| `removedCount` | `number` |  |
+| `estimatedTokens` | `number` |  |
+| `compactionCount` | `number` |  |
 
 
 
 ### autoCompactTriggered
 
-Event emitted by Conversation
+Fired when auto-compact kicks in because tokens exceeded the threshold
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `estimated` | `number` |  |
+| `limit` | `number` |  |
+| `contextWindow` | `number` |  |
 
 
 
 ### userMessage
 
-Event emitted by Conversation
+Fired when a user message is added to the conversation
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The user message content (string or ContentPart[]) |
 
 
 
 ### turnStart
 
-Event emitted by Conversation
+Fired at the start of each completion turn
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `turn` | `number` |  |
+| `isFollowUp` | `boolean` |  |
 
 
 
 ### rawEvent
 
-Event emitted by Conversation
+Fired for every raw event from the Responses API stream
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | Raw stream event from the API |
 
 
 
 ### mcpEvent
 
-Event emitted by Conversation
+Fired for MCP-related events from the Responses API
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | MCP-related stream event |
 
 
 
 ### chunk
 
-Event emitted by Conversation
+Fired for each streaming text delta
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Text delta from the stream |
 
 
 
 ### preview
 
-Event emitted by Conversation
+Fired after each chunk with the full accumulated text
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Accumulated text so far |
 
 
 
 ### responseCompleted
 
-Event emitted by Conversation
+Fired when the Responses API stream completes
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The completed OpenAI Response object |
 
 
 
 ### toolCallsStart
 
-Event emitted by Conversation
+Fired when the model begins a batch of tool calls
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | Array of tool call objects from the model |
 
 
 
 ### toolError
 
-Event emitted by Conversation
+Fired when a tool handler throws or the tool is unknown
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Tool name |
+| `arg1` | `any` | Error object or message |
 
 
 
 ### toolCall
 
-Event emitted by Conversation
+Fired before invoking a single tool handler
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Tool name |
+| `arg1` | `any` | Parsed arguments object |
 
 
 
 ### toolResult
 
-Event emitted by Conversation
+Fired after a tool handler returns successfully
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Tool name |
+| `arg1` | `string` | Serialized result |
 
 
 
 ### toolCallsEnd
 
-Event emitted by Conversation
+Fired after all tool calls in a turn have been executed
 
 
 
 ### turnEnd
 
-Event emitted by Conversation
+Fired at the end of each completion turn
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `turn` | `number` |  |
+| `hasToolCalls` | `boolean` |  |
 
 
 
 ### response
 
-Event emitted by Conversation
+Fired when the final text response is produced
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Final accumulated response text |
 
 
 

package/docs/apis/features/agi/openai-codex.md

@@ -1,6 +1,6 @@
 # OpenAICodex (features.openaiCodex)
 
-No description provided
+OpenAI Codex CLI wrapper feature. Spawns and manages Codex sessions as subprocesses, streaming structured JSON events back through the container's event system. Mirrors the ClaudeCode feature pattern: each call to `run()` spawns a `codex exec --json` process, parses NDJSON from stdout line-by-line, and emits typed events on the feature's event bus.
 
 ## Usage
 
@@ -199,67 +199,145 @@ Enable the feature. Delegates to the base Feature enable() lifecycle.
 
 ### session:event
 
-Event emitted by OpenAICodex
+Fired for every parsed JSON event from the Codex CLI stream
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
+| `event` | `any` |  |
 
 
 
 ### session:delta
 
-Event emitted by OpenAICodex
+Fired for each text delta from an agent message
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
+| `text` | `string` |  |
+| `role` | `string` |  |
 
 
 
 ### session:message
 
-Event emitted by OpenAICodex
+Fired when a complete agent message is received
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
+| `message` | `any` |  |
 
 
 
 ### session:exec
 
-Event emitted by OpenAICodex
+Fired when a command execution item completes
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
+| `exec` | `any` |  |
 
 
 
 ### session:reasoning
 
-Event emitted by OpenAICodex
+Fired when a reasoning item is received
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
+| `text` | `string` |  |
 
 
 
 ### session:exec-start
 
-Event emitted by OpenAICodex
+Fired when a command execution item starts
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
+| `command` | `string` |  |
 
 
 
 ### session:start
 
-Event emitted by OpenAICodex
+Fired when a new Codex session is spawned
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
+| `prompt` | `string` |  |
 
 
 
 ### session:error
 
-Event emitted by OpenAICodex
+Fired when a session encounters an error
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
+| `error` | `any` |  |
+| `exitCode` | `number` |  |
 
 
 
 ### session:parse-error
 
-Event emitted by OpenAICodex
+Fired when a JSON line from the CLI cannot be parsed
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
+| `line` | `string` |  |
 
 
 
 ### session:result
 
-Event emitted by OpenAICodex
+Fired when a session completes with a final result
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
+| `result` | `string` |  |
 
 
 
 ### session:abort
 
-Event emitted by OpenAICodex
+Fired when a session is aborted by the user
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `sessionId` | `string` |  |
 
 
 

package/docs/apis/features/agi/skills-library.md

@@ -1,6 +1,6 @@
 # SkillsLibrary (features.skillsLibrary)
 
-No description provided
+Manages two contentbase collections of skills following the Claude Code SKILL.md format. Project-level skills live in .claude/skills/ and user-level skills live in ~/.luca/skills/. Skills can be discovered, searched, created, updated, and removed at runtime.
 
 ## Usage
 
@@ -162,25 +162,43 @@ Generates a markdown block listing all available skills with names and descripti
 
 ### loaded
 
-Event emitted by SkillsLibrary
+Fired after both project and user skill collections are loaded
 
 
 
 ### skillCreated
 
-Event emitted by SkillsLibrary
+Fired after a new skill is written to disk
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The created SkillEntry object |
 
 
 
 ### skillUpdated
 
-Event emitted by SkillsLibrary
+Fired after an existing skill is updated
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `any` | The updated SkillEntry object |
 
 
 
 ### skillRemoved
 
-Event emitted by SkillsLibrary
+Fired after a skill is deleted
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | The name of the removed skill |
 
 
 

package/docs/apis/features/node/container-link.md

@@ -102,6 +102,65 @@ Event emitted by ContainerLink
 
 
 
+### disconnection
+
+Emitted when a web container disconnects
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Container UUID |
+| `arg1` | `string` | Reason |
+
+
+
+### error
+
+Event emitted by ContainerLink
+
+
+
+### connection
+
+Emitted when a web container connects and registers
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Container UUID |
+| `arg1` | `any` | Connection metadata |
+
+
+
+### evalResult
+
+Emitted when an eval result is received
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Request ID |
+| `arg1` | `any` | Result or error |
+
+
+
+### event
+
+Emitted when a web container sends a structured event
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `arg0` | `string` | Container UUID |
+| `arg1` | `string` | Event name |
+| `arg2` | `any` | Event data |
+
+
+
 ## State (Zod v4 schema)
 
 | Property | Type | Description |

package/docs/apis/features/node/content-db.md

@@ -244,7 +244,7 @@ Rebuild the entire search index from scratch.
 
 ### reloaded
 
-Event emitted by ContentDb
+When the content collection is reloaded from disk
 
 
 

package/docs/apis/features/node/disk-cache.md

@@ -223,7 +223,7 @@ Create a cacache instance with the specified path
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `path` | `string` |  | Optional cache directory path (defaults to options.path or node_modules/.cache/luca-disk-cache) |
+| `path` | `string` |  | Optional cache directory path (defaults to options.path or ~/.cache/luca/disk-cache-{cwdHash}) |
 
 **Returns:** `void`
 

package/docs/apis/features/node/dns.md

@@ -457,6 +457,7 @@ const verified = await dns.hasTxtRecord('example.com', 'google-site-verification
 | Property | Type | Description |
 |----------|------|-------------|
 | `proc` | `any` |  |
+| `digPath` | `string` | Resolved path to the dig binary |
 
 ## State (Zod v4 schema)
 

package/docs/apis/features/node/docker.md

@@ -551,7 +551,8 @@ Initialize the Docker feature by checking availability and optionally refreshing
 
 | Property | Type | Description |
 |----------|------|-------------|
-| `proc` | `any` | Get the proc feature for executing shell commands |
+| `proc` | `any` |  |
+| `dockerPath` | `string` | Resolve the docker binary path via `which`, caching the result. Options take precedence. |
 
 ## State (Zod v4 schema)
 

package/docs/apis/features/node/esbuild.md

@@ -1,6 +1,6 @@
 # Esbuild (features.esbuild)
 
-Esbuild helper
+Browser-side TypeScript/ESM compilation feature using esbuild-wasm. Loads esbuild's WebAssembly build via the AssetLoader, then provides `compile()` and `transform()` methods that work entirely in the browser. Useful for live playgrounds, in-browser REPLs, and client-side bundling.
 
 ## Usage
 
@@ -53,7 +53,8 @@ container.feature('esbuild')
 
 ```ts
 const esbuild = container.feature('esbuild')
-const result = esbuild.transformSync('const x: number = 1')
-console.log(result.code) // 'const x = 1;\n'
+await esbuild.start()
+const result = await esbuild.compile('const x: number = 1')
+console.log(result.code)
 ```
 

package/docs/apis/features/node/file-manager.md

@@ -89,18 +89,19 @@ Scans the files in the project and updates the file manager state.
 
 ### watch
 
-Watches the files in the project and updates the file manager state.
+Watches directories for file changes. Can be called multiple times to add more directories to an existing watcher. Tracks all watched paths in state. When called without `paths`, watches the project's `directoryIds` (default behavior). When called with `paths`, watches only those specific directories/globs. Subsequent calls add to the existing watcher — they never replace what's already watched.
 
 **Parameters:**
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `options` | `{ exclude?: string | string[] }` |  | Options for the file manager |
+| `options` | `{ paths?: string | string[]; exclude?: string | string[] }` |  | Options for the file manager |
 
-`{ exclude?: string | string[] }` properties:
+`{ paths?: string | string[]; exclude?: string | string[] }` properties:
 
 | Property | Type | Description |
 |----------|------|-------------|
+| `paths` | `any` | Specific directories or globs to watch. Defaults to project directoryIds. |
 | `exclude` | `any` | The patterns to exclude from the watch |
 
 **Returns:** `void`
@@ -148,13 +149,21 @@ Watches the files in the project and updates the file manager state.
 | `isStarted` | `any` | Whether the file manager has completed its initial scan. |
 | `isStarting` | `any` | Whether the file manager is currently performing its initial scan. |
 | `isWatching` | `any` | Whether the file watcher is actively monitoring for changes. |
+| `watchedPaths` | `string[]` | Returns the list of directories currently being watched. |
 | `watchedFiles` | `Record<string, string[]>` | Returns the directories and files currently being watched by chokidar. |
 
 ## Events (Zod v4 schema)
 
 ### file:change
 
-Event emitted by FileManager
+Emitted when a watched file is added, changed, or deleted
+
+**Event Arguments:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `type` | `'add' | 'change' | 'delete'` | The type of file change |
+| `path` | `string` | Absolute path to the changed file |