@soederpop/luca 0.1.1 → 0.1.3

package/docs/apis/features/agi/claude-code.md

@@ -389,6 +389,102 @@ const md = await cc.sessionHistoryToMarkdown(localSessionId)
 
 
 
+### listProcessSessions
+
+List all Claude Code processes currently registered in ~/.claude/sessions/. Returns each session's metadata along with whether the process is still alive.
+
+**Returns:** `Promise<Array<{
+    pid: number
+    sessionId: string
+    cwd: string
+    startedAt: number
+    kind: string
+    entrypoint: string
+    alive: boolean
+  }>>`
+
+```ts
+const sessions = await cc.listProcessSessions()
+for (const s of sessions) {
+ console.log(`[${s.alive ? 'LIVE' : 'dead'}] PID ${s.pid} in ${s.cwd}`)
+}
+```
+
+
+
+### getProcessSession
+
+Read a single process session by PID from ~/.claude/sessions/<pid>.json.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `pid` | `number` | ✓ | The process ID |
+
+**Returns:** `Promise<{
+    pid: number
+    sessionId: string
+    cwd: string
+    startedAt: number
+    kind: string
+    entrypoint: string
+  } | null>`
+
+```ts
+const session = await cc.getProcessSession(12345)
+console.log(session?.cwd)
+```
+
+
+
+### getConversationHistory
+
+Read the conversation history for a Claude Code session from its JSONL file in ~/.claude/projects/<encoded-cwd>/<sessionId>.jsonl. Returns an array of parsed message objects (user, assistant, tool_use, tool_result).
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `sessionId` | `string` | ✓ | The Claude CLI session ID (from listProcessSessions or getProcessSession) |
+| `cwd` | `string` |  | The working directory of the session (used to locate the project folder) |
+
+**Returns:** `Promise<any[]>`
+
+```ts
+const sessions = await cc.listProcessSessions()
+const s = sessions[0]
+const history = await cc.getConversationHistory(s.sessionId, s.cwd)
+console.log(history.length, 'turns')
+```
+
+
+
+### listSessionsForCwd
+
+List all conversation sessions stored for a given working directory. Reads ~/.claude/projects/<encoded-cwd>/ and returns metadata for each .jsonl file.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `cwd` | `string` |  | The working directory path to look up |
+
+**Returns:** `Promise<Array<{
+    sessionId: string
+    filePath: string
+    messageCount: number
+  }>>`
+
+```ts
+const sessions = await cc.listSessionsForCwd('/Users/me/my-project')
+for (const s of sessions) {
+ console.log(s.sessionId, s.messageCount, 'messages')
+}
+```
+
+
+
 ### cleanupMcpTempFiles
 
 Clean up any temp MCP config files created during sessions.
@@ -736,6 +832,48 @@ const md = await cc.sessionHistoryToMarkdown(localSessionId)
 
 
 
+**listProcessSessions**
+
+```ts
+const sessions = await cc.listProcessSessions()
+for (const s of sessions) {
+ console.log(`[${s.alive ? 'LIVE' : 'dead'}] PID ${s.pid} in ${s.cwd}`)
+}
+```
+
+
+
+**getProcessSession**
+
+```ts
+const session = await cc.getProcessSession(12345)
+console.log(session?.cwd)
+```
+
+
+
+**getConversationHistory**
+
+```ts
+const sessions = await cc.listProcessSessions()
+const s = sessions[0]
+const history = await cc.getConversationHistory(s.sessionId, s.cwd)
+console.log(history.length, 'turns')
+```
+
+
+
+**listSessionsForCwd**
+
+```ts
+const sessions = await cc.listSessionsForCwd('/Users/me/my-project')
+for (const s of sessions) {
+ console.log(s.sessionId, s.messageCount, 'messages')
+}
+```
+
+
+
 **sessionId**
 
 ```ts

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

@@ -136,6 +136,26 @@ Merge new tools into the conversation, replacing any with the same name. Accepts
 
 
 
+### stub
+
+Register a hardcoded stub response that bypasses the API when the user's message matches. Streaming is still simulated — chunk/preview events fire word-by-word.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `matcher` | `string | RegExp` | ✓ | Exact string match, substring, or RegExp tested against user input |
+| `response` | `string | (() => string)` | ✓ | The text to stream back, or a zero-arg function that returns it |
+
+**Returns:** `this`
+
+```ts
+conversation.stub('hello', 'Hi there!')
+conversation.stub(/weather/i, () => 'Sunny and 72°F.')
+```
+
+
+
 ### estimateTokens
 
 Estimate the input token count for the current messages array using the js-tiktoken tokenizer. Updates state.
@@ -367,106 +387,106 @@ Fired at the start of each completion turn
 
 
 
-### rawEvent
+### chunk
 
-Fired for every raw event from the Responses API stream
+Fired for each streaming text delta
 
 **Event Arguments:**
 
 | Name | Type | Description |
 |------|------|-------------|
-| `arg0` | `any` | Raw stream event from the API |
+| `arg0` | `string` | Text delta from the stream |
 
 
 
-### mcpEvent
+### preview
 
-Fired for MCP-related events from the Responses API
+Fired after each chunk with the full accumulated text
 
 **Event Arguments:**
 
 | Name | Type | Description |
 |------|------|-------------|
-| `arg0` | `any` | MCP-related stream event |
+| `arg0` | `string` | Accumulated text so far |
 
 
 
-### chunk
+### turnEnd
 
-Fired for each streaming text delta
+Fired at the end of each completion turn
 
 **Event Arguments:**
 
 | Name | Type | Description |
 |------|------|-------------|
-| `arg0` | `string` | Text delta from the stream |
+| `turn` | `number` |  |
+| `hasToolCalls` | `boolean` |  |
 
 
 
-### preview
+### response
 
-Fired after each chunk with the full accumulated text
+Fired when the final text response is produced
 
 **Event Arguments:**
 
 | Name | Type | Description |
 |------|------|-------------|
-| `arg0` | `string` | Accumulated text so far |
+| `arg0` | `string` | Final accumulated response text |
 
 
 
-### responseCompleted
+### rawEvent
 
-Fired when the Responses API stream completes
+Fired for every raw event from the Responses API stream
 
 **Event Arguments:**
 
 | Name | Type | Description |
 |------|------|-------------|
-| `arg0` | `any` | The completed OpenAI Response object |
+| `arg0` | `any` | Raw stream event from the API |
 
 
 
-### toolCallsStart
+### mcpEvent
 
-Fired when the model begins a batch of tool calls
+Fired for MCP-related events from the Responses API
 
 **Event Arguments:**
 
 | Name | Type | Description |
 |------|------|-------------|
-| `arg0` | `any` | Array of tool call objects from the model |
-
-
-
-### toolCallsEnd
-
-Fired after all tool calls in a turn have been executed
+| `arg0` | `any` | MCP-related stream event |
 
 
 
-### turnEnd
+### responseCompleted
 
-Fired at the end of each completion turn
+Fired when the Responses API stream completes
 
 **Event Arguments:**
 
 | Name | Type | Description |
 |------|------|-------------|
-| `turn` | `number` |  |
-| `hasToolCalls` | `boolean` |  |
+| `arg0` | `any` | The completed OpenAI Response object |
 
 
 
-### response
+### toolCallsStart
 
-Fired when the final text response is produced
+Fired when the model begins a batch of tool calls
 
 **Event Arguments:**
 
 | Name | Type | Description |
 |------|------|-------------|
-| `arg0` | `string` | Final accumulated response text |
+| `arg0` | `any` | Array of tool call objects from the model |
+
+
+
+### toolCallsEnd
+
+Fired after all tool calls in a turn have been executed
 
 
 
@@ -506,6 +526,15 @@ const reply = await conversation.ask('What is the meaning of life?')
 
 
 
+**stub**
+
+```ts
+conversation.stub('hello', 'Hi there!')
+conversation.stub(/weather/i, () => 'Sunny and 72°F.')
+```
+
+
+
 **ask**
 
 ```ts