@ljoukov/llm 4.0.1 → 4.0.3

package/README.md

@@ -333,13 +333,15 @@ Use a `chatgpt-` prefix:
 import { generateText } from "@ljoukov/llm";
 
 const result = await generateText({
-  model: "chatgpt-gpt-5.1-codex-mini",
+  model: "chatgpt-gpt-5.4",
   input: "Return exactly: OK",
 });
 
 console.log(result.text);
 ```
 
+`chatgpt-gpt-5.4-fast` is also supported as a convenience alias for ChatGPT-authenticated `gpt-5.4` with priority processing enabled (`service_tier="priority"`), matching Codex `/fast` semantics.
+
 ## JSON outputs
 
 `generateJson()` validates the output with Zod and returns the parsed value.
@@ -675,6 +677,44 @@ const result = await runAgentLoop({
 Telemetry emits parent/child run correlation (`runId` + `parentRunId`) for subagents.
 See `docs/agent-telemetry.md` for event schema, design rationale, and backend adapter guidance.
 
+### Agent Logging (Console + Files + Redirects)
+
+`runAgentLoop()` enables logging by default. It writes:
+
+- console lines,
+- `<workspace>/agent.log`,
+- per-call artifacts under a sibling logs directory: `<workspace-parent>/logs/<timestamp>-<n>/<model-id>/`.
+
+Each LLM call writes:
+
+- `request.txt`, `request.metadata.json`, and extracted attachments immediately,
+- streamed `thoughts.txt` and `response.txt` deltas during generation,
+- `response.metadata.json` at completion/failure (usage/cost/status/error).
+
+`image_url` data URLs are redacted in text/metadata logs (`data:...,...`) so base64 payloads are not printed inline.
+
+```ts
+import { runAgentLoop } from "@ljoukov/llm";
+
+await runAgentLoop({
+  model: "chatgpt-gpt-5.3-codex",
+  input: "Do the task",
+  filesystemTool: true,
+  logging: {
+    workspaceDir: process.cwd(), // optional; defaults to filesystem cwd or process.cwd()
+    mirrorToConsole: false, // useful for CLI UIs that already render stream events
+    sink: {
+      append: (line) => {
+        // Optional extra destination (file, socket, queue, etc.)
+      },
+      flush: async () => {},
+    },
+  },
+});
+```
+
+Set `logging: false` to disable logger output for a run.
+
 If you need exact control over tool definitions, build the filesystem toolset yourself and call `runToolLoop()` directly.
 
 ```ts