fix(docs): fix 7 remaining crashes in README and docs

Author: danilobatson

packages/docs/content/docs/guides/rag-pipeline.mdx

@@ -57,7 +57,7 @@ const knowledge = createKnowledge({
   },
 });
 
-await ingest('./handbook.pdf', knowledge.embedder, knowledge.store, {
+await knowledge.ingest('./handbook.pdf', {
   metadata: { source: 'handbook', version: '2024' },
 });
 ```

packages/docs/content/docs/modules/knowledge.mdx

@@ -109,14 +109,15 @@ const result = await ingest(
 // result.chunks — number of chunks stored
 ```
 
-### `search(knowledge, query, options?)`
+### `search(query, embedder, store, options?)`
 
-Semantic search across ingested documents.
+Semantic search across ingested documents. Also available as `knowledge.search(query, options?)` on a `KnowledgeClient`.
 
 ```ts
 function search(
-  knowledge: KnowledgeClient,
   query: string,
+  embedder: EmbedFunction,
+  store: VectorStore,
   options?: SearchOptions,
 ): Promise<SearchResult[]>
 ```

packages/docs/content/docs/modules/security.mdx

@@ -109,8 +109,8 @@ function checkOutput(response: string, rules: GuardrailRule[]): GuardrailResult
 
 ```ts
 const rules = [
-  { id: 'no-pii', description: 'No PII in output', test: (text) => detectPII(text).length === 0 },
-  { id: 'max-length', description: 'Under 10k chars', test: (text) => text.length < 10000 },
+  { id: 'no-pii', description: 'No PII in output', test: (text) => detectPII(text).length > 0 },
+  { id: 'max-length', description: 'Under 10k chars', test: (text) => text.length >= 10000 },
 ];
 
 const guardrails = createGuardrails(rules);

packages/toolkit/README.md

@@ -123,11 +123,11 @@ const tsSplitter = createLanguageSplitter('typescript', { chunkSize: 1000 });
 ```typescript
 import { createAgent, createGraph, route } from '@jamaalbuilds/ai-toolkit/agents';
 
-const researcher = createAgent({ name: 'researcher', instructions: 'Research topics' });
-const writer = createAgent({ name: 'writer', instructions: 'Write content' });
+const researcher = createAgent({ name: 'researcher', systemPrompt: 'Research topics' });
+const writer = createAgent({ name: 'writer', systemPrompt: 'Write content' });
 
 const graph = await createGraph({
-  agents: { researcher, writer },
+  agents: [researcher, writer],
   edges: [{ from: 'researcher', to: 'writer' }],
 });
 
@@ -209,13 +209,14 @@ const emailJob = defineJob(workflow, {
 
   // Human-in-the-loop approval (pauses workflow until approved)
   const approval = await humanInTheLoop(step, {
-    prompt: 'Approve welcome email?',
+    stepId: 'approve',
+    event: 'approval/response',
     timeout: '24h',
   });
 
   // AI-powered step (calls LLM inside a durable step)
   const summary = await aiStep(step, {
-    name: 'summarize-signup',
+    stepId: 'summarize-signup',
     prompt: `Summarize signup for ${event.data.email}`,
   });
 });