foundation-ai-agent 1.0.0

package/README.md

@@ -0,0 +1,338 @@
+# foundation
+
+12 layers. Native. Zero wrappers.
+
+```
+ S01 Realtime        S05 Rendering       S09 Persistence
+ S02 CRDTs           S06 Payments        S10 Inference
+ S03 Streaming       S07 Identity        S11 Transport
+ S04 Messaging       S08 Containers      S12 Version Control
+```
+
+Foundation is not a framework. It is a protocol for AI agent systems.
+
+TCP/IP defined what a network is. Foundation defines what an AI agent system is. Every provider, every transport, every memory tier, every consent model plugs in through the same interfaces. No vendor lock-in. No SDK dependencies. No wrappers.
+
+---
+
+## The Architecture
+
+```
+src/
+ ├── sXX-name/       Layers. Each stands alone. No cross-imports.
+ ├── touches/        The only bridges between layers. Explicit coupling.
+ └── compat/         External system bridges. NOT part of the foundation.
+```
+
+**One rule governs the entire system:** Layers never import from sibling layers. All cross-layer integration goes through `touches/` -- named, tested, explicit connection points. If two layers need to talk, there is a file in `touches/` that says exactly how.
+
+### The 12 Layers
+
+| Layer | What it does | Key primitive |
+|-------|-------------|---------------|
+| **S01 Realtime** | WebRTC signaling, media types | `SignalingMessage` (11 types) |
+| **S02 CRDTs** | Distributed state synchronization | `SharedDoc` (interface-first, yjs impl) |
+| **S03 Streaming** | HLS/DASH segmentation, codecs | `Segmenter`, `PlaylistManager` |
+| **S04 Messaging** | Chat, briefings, notifications | `Channel` (platform-agnostic) |
+| **S05 Rendering** | State machines, avatar gestures | `StateMachine<S, E>` (generic) |
+| **S06 Payments** | Billing, subscriptions, usage | `BillingService` (interface-first) |
+| **S07 Identity** | Consent as authorization | `observe / assist / act` |
+| **S08 Containers** | Process isolation, GPU scheduling | `Sandbox`, `GpuScheduler` |
+| **S09 Persistence** | Three-tier cognitive memory | `HOT → WARM → COLD` |
+| **S10 Inference** | Provider-agnostic agent loop | `Provider.stream()` → 4 Chunk types |
+| **S11 Transport** | Network abstraction | `send()` + `receive()` |
+| **S12 Version Control** | Merkle trees for decision audit | `buildTree()`, `verifyProof()` |
+
+### The Touch Points
+
+Every connection between layers is a file. Every file is small. The average touch point is 60 lines.
+
+```
+audio-tap.ts         S01 ↔ S10    Audio → Transcript → Tokens
+stichwort.ts         S01 ↔ S10    Keyword detection (pure pipeline)
+transport-signal.ts  S01 ↔ S11    Signaling ↔ Transport events
+crdt-sync.ts         S02 ↔ S11    CRDT updates ↔ Transport events
+messenger-bridge.ts  S04 ↔ S10    Briefing generation via Loop
+avatar-state.ts      S05 ↔ S10    Inference events → Avatar transitions
+cost-billing.ts      S06 ↔ Ledger Consent tiers → Pricing tiers
+identity-gate.ts     S07 ↔ S10    observe=deny, assist=ask, act=allow
+container-room.ts    S08 ↔ S11    Room → Container isolation
+memory-persist.ts    S09 ↔ S10    HOT → compact → WARM → flush → COLD
+cost-track.ts        S10 ↔ Ledger Usage → Cost tracking
+version-persist.ts   S12 ↔ S09    Merkle DAG → COLD storage
+sentiment-tap.ts     S01 ↔ S10    Audio → Emotion → Dynamics
+```
+
+---
+
+## The Numbers
+
+```
+74 source files      43 test suites     376 tests
+12/12 layers         13 touch points    3 runtime deps
+3 providers          0 SDK wrappers     0 AI framework imports
+5 production backends (Postgres, S3, Stripe, Docker, Observability)
+```
+
+Three runtime dependencies. Each is infrastructure, not abstraction:
+
+| Dependency | Why |
+|------------|-----|
+| `better-sqlite3` | WARM memory (S09) |
+| `ws` | WebSocket transport (S11) |
+| `yjs` | CRDT implementation (S02) |
+
+---
+
+## Quick Start
+
+```bash
+npm install
+npm test          # 347 tests
+npm run check     # tsc --noEmit
+npm run build     # emit dist/
+```
+
+### Use a provider
+
+```typescript
+import { createOllamaProvider, loop, createContext } from 'foundation'
+
+const provider = createOllamaProvider()  // localhost:11434
+const ctx = createContext({ model: 'qwen2.5:3b', root: '.' })
+
+const gen = loop({
+  messages: [{ id: '1', role: 'user', content: 'Hello', ts: Date.now() }],
+  system: 'Be helpful.',
+  actions: [],
+  provider,
+  ctx,
+})
+
+for await (const msg of gen) {
+  console.log(msg.role, typeof msg.content === 'string' ? msg.content : '[blocks]')
+}
+```
+
+### Add actions
+
+```typescript
+import { ok, type Action } from 'foundation'
+
+const search: Action = {
+  name: 'search',
+  schema: { name: 'search', description: 'Search', parameters: { type: 'object', properties: { q: { type: 'string' } } } },
+  concurrent: true,
+  validate: (input) => ok(input),
+  gate: () => 'allow',
+  execute: async (input) => ok(`Results for ${JSON.stringify(input)}`),
+}
+
+// Pass to loop({ ... actions: [search] })
+// The loop calls validate → gate → execute, batches concurrent actions
+```
+
+### Three-tier memory
+
+```typescript
+import { createHotMemory, createWarmMemory, createFsColdMemory, createMemoryStack } from 'foundation'
+
+const hot = createHotMemory({ budget: 50_000 })
+const warm = createWarmMemory('./data/warm.db')
+const cold = createFsColdMemory('./data/cold')
+const memory = createMemoryStack(hot, warm, cold)
+
+// During session: memory.maintain(50_000) compacts when over budget
+// End of session: memory.flushToCold('session-id') archives everything
+```
+
+### Consent as a layer
+
+```typescript
+import { createIdentity, consentToGate } from 'foundation'
+
+const identity = createIdentity()
+const session = identity.initDefaults('user-1')
+
+// Check: can this agent suggest queue items?
+const gate = consentToGate(identity, session, { feature: 'queue_suggest', required: 'assist' })
+// gate === 'ask' (assist level = host must approve)
+
+// Upgrade to autonomous
+identity.setScope(session, 'queue_suggest', 'act')
+const gate2 = consentToGate(identity, session, { feature: 'queue_suggest', required: 'assist' })
+// gate2 === 'allow' (act level = agent can act autonomously)
+```
+
+### Multi-agent
+
+```typescript
+import { createAgentRegistry, createOllamaProvider, createAnthropicProvider } from 'foundation'
+
+const registry = createAgentRegistry()
+
+registry.register({
+  name: 'sebastian-edge',
+  role: 'classifier',
+  provider: createOllamaProvider(),
+  model: 'qwen2.5:3b',
+  mode: 'act',
+  budgetCents: 100,
+})
+
+registry.register({
+  name: 'sebastian-cloud',
+  role: 'researcher',
+  provider: createAnthropicProvider({ apiKey: '...' }),
+  model: 'claude-sonnet-4-6',
+  mode: 'assist',
+  budgetCents: 5000,
+})
+
+registry.perAgent()   // cost breakdown per agent
+registry.perOrg()     // aggregated per organization
+```
+
+---
+
+## Design Decisions
+
+### Errors are values
+
+```typescript
+type Result<T, E = Error> = { ok: true; value: T } | { ok: false; error: E }
+```
+
+No exceptions for control flow. Every function that can fail returns `Result`. Pattern-match on `ok`, not try-catch.
+
+### 4 chunk types standardize all providers
+
+```typescript
+type Chunk =
+  | { type: 'text'; text: string }
+  | { type: 'action_call'; id: string; name: string; input: unknown }
+  | { type: 'usage'; tokens: TokenUsage }
+  | { type: 'done'; reason: 'complete' | 'action_calls' }
+```
+
+Ollama, Anthropic, OpenAI -- all produce the same 4 chunk types. The loop doesn't know which provider it's talking to.
+
+### Interface first, implementation second
+
+Every layer defines its contract as a TypeScript type. The implementation is one of many possible:
+
+- `Provider` interface → Ollama, Anthropic, OpenAI implementations
+- `SharedDoc` interface → yjs implementation (Automerge, diamond-types possible)
+- `Transport` interface → WebSocket, local, IPC implementations
+- `ColdMemory` interface → Filesystem + S3/R2 implementations
+- `BillingService` interface → In-memory + Stripe implementations
+- `Sandbox` interface → In-memory + Docker implementations
+
+### Open unions
+
+Every union type is extensible:
+
+```typescript
+type EntryCategory = 'decision' | 'fact' | 'action_item' | ... | (string & {})
+type ArtifactType  = 'transcript' | 'document' | 'media' | ... | (string & {})
+type Feature       = 'listening' | 'mirror_mode' | ...           | (string & {})
+```
+
+No layer is closed. No external system is locked out.
+
+### Consent is not a feature -- it is infrastructure
+
+Three levels. Three meanings. One mapping:
+
+```
+observe  →  deny   (can only watch)
+assist   →  ask    (can suggest, host approves)
+act      →  allow  (autonomous action)
+```
+
+This maps 1:1 to pricing tiers (free/professional/enterprise), gate decisions (deny/ask/allow), and autonomy levels. It is the single most load-bearing abstraction in the system.
+
+---
+
+## What Emerges
+
+Properties that no single layer has alone:
+
+| Combination | Emergence |
+|-------------|-----------|
+| S07 + S10 | Ethical autonomy -- consent gates action execution |
+| S09 HOT+WARM+COLD | Cognitive memory -- compaction = memory formation |
+| S06 + S07 | Monetized autonomy -- consent levels = pricing tiers |
+| S08 + S10 | Isolated execution -- each agent in its own sandbox |
+| S12 + S09 | Auditable history -- Merkle proofs for every decision |
+| All 12 layers | Mirror Mode -- autonomous agent with ethical boundary, cost limit, audit trail, visual transparency |
+
+---
+
+## The Proof
+
+The architecture was validated empirically, not by argument:
+
+**376 tests** prove that layers compose. Integration tests cross layer boundaries. E2E tests hit real Ollama and real WebSocket servers.
+
+**4 Butler adapters under 100 lines each** prove that the interfaces match reality. The prediction was made before M1. The proof came at M13. Thin adapters = correct abstractions.
+
+**0room0 imports Foundation** for Memory, Consent, Provider, StateMachine. The first external consumer confirmed: Foundation types flow cleanly into a real product with 346 tests.
+
+---
+
+## Project Structure
+
+```
+foundation/
+ ├── src/
+ │    ├── index.ts                     Public API
+ │    ├── types.ts                     Result, Message, Entry, Event
+ │    ├── ledger.ts                    Cost tracking
+ │    │
+ │    ├── s01-realtime/                WebRTC signaling + media types
+ │    ├── s02-crdt/                    SharedDoc interface + yjs
+ │    ├── s03-streaming/               HLS segmentation + playlists
+ │    ├── s04-messaging/               Chat, briefings, channels
+ │    ├── s05-rendering/               StateMachine + avatar gestures
+ │    ├── s06-payments/                Billing + subscriptions
+ │    ├── s07-identity/                Consent (observe/assist/act)
+ │    ├── s08-containers/              Sandbox + GPU scheduler
+ │    ├── s09-persistence/             HOT (memory) + WARM (SQLite) + COLD (fs)
+ │    ├── s10-inference/               Provider → Action → Loop
+ │    │    ├── providers/              Ollama, Anthropic, OpenAI (raw fetch)
+ │    │    └── agents/                 Multi-agent registry, mirror mode
+ │    ├── s11-transport/               Transport + WebSocket + Room
+ │    ├── s12-versioncontrol/          Merkle trees + DAG
+ │    │
+ │    ├── touches/                     13 cross-layer bridges
+ │    └── compat/                      External system bridges
+ │
+ ├── tests/
+ │    ├── s01/ ... s12/                Unit tests per layer
+ │    ├── touches/                     Touch point tests
+ │    ├── integration/                 Cross-layer composition tests
+ │    └── e2e/                         Live Ollama + WebSocket tests
+ │
+ ├── ROADMAP.md                        23-milestone plan (completed)
+ └── M14-PLAN.md                       0room0 integration playbook
+```
+
+---
+
+## TypeScript
+
+```json
+{
+  "strict": true,
+  "noUncheckedIndexedAccess": true,
+  "target": "ES2022",
+  "module": "NodeNext"
+}
+```
+
+No `any`. No unguarded index access. `Result<T,E>` everywhere. `Context<Ext>` is generic for type-safe domain extensions.
+
+---
+
+*Built in one session. 23 milestones. Two parallel agents -- one builds, one observes. Every correction was applied. Every blind spot was closed. The foundation holds.*

package/dist/compat/butler-cloud.d.ts

@@ -0,0 +1,33 @@
+/**
+ * COMPAT — Cloud Butler Adapter
+ *
+ * Wraps Foundation Provider + Loop + Actions als CloudButler Interface.
+ * Der Cloud-Butler exekutiert: research, draft, create, validate, summarize.
+ * Bekommt Query vom Edge-Butler, liefert Material für die Queue.
+ *
+ * Messpunkt: Unter 100 Zeilen = Interfaces stimmen.
+ */
+import type { Provider } from '../s10-inference/provider.js';
+import type { Context } from '../s10-inference/context.js';
+import type { Action } from '../s10-inference/action.js';
+import { type Result } from '../types.js';
+export type CloudTaskType = 'research' | 'draft' | 'create' | 'validate' | 'summarize' | (string & {});
+export type CloudTask = {
+    type: CloudTaskType;
+    query: string;
+    maxTokens?: number;
+    priority?: 'low' | 'normal' | 'high';
+};
+export type CloudOutput = {
+    title: string;
+    summary: string;
+    content: string;
+    confidence: number;
+    sources: string[];
+    gaps: string[];
+};
+export type CloudButler = {
+    execute(task: CloudTask, ledgerContext: string): Promise<Result<CloudOutput, string>>;
+};
+export declare function createCloudButler(provider: Provider, actions: readonly Action[], ctx: Context): CloudButler;
+//# sourceMappingURL=butler-cloud.d.ts.map

package/dist/compat/butler-cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"butler-cloud.d.ts","sourceRoot":"","sources":["../../src/compat/butler-cloud.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAExD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEtG,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,aAAa,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,EAAE,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;CACtF,CAAA;AAQD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,OAAO,GACX,WAAW,CAkDb"}

package/dist/compat/butler-cloud.js

@@ -0,0 +1,69 @@
+/**
+ * COMPAT — Cloud Butler Adapter
+ *
+ * Wraps Foundation Provider + Loop + Actions als CloudButler Interface.
+ * Der Cloud-Butler exekutiert: research, draft, create, validate, summarize.
+ * Bekommt Query vom Edge-Butler, liefert Material für die Queue.
+ *
+ * Messpunkt: Unter 100 Zeilen = Interfaces stimmen.
+ */
+import { loop } from '../s10-inference/loop.js';
+import { ok, err } from '../types.js';
+const CLOUD_SYSTEM_PROMPT = `Du bist Sebastian-Außen, ein Research-Butler.
+Du erfindest NICHTS. Keine Quellen = keine Antwort. Wahrheit vor Höflichkeit.
+Antworte als JSON: {"title":"...","summary":"...","content":"...","confidence":0.0-1.0,"sources":["..."],"gaps":["..."]}
+confidence: high(>0.7), medium(0.4-0.7), low(<0.4). Sei ehrlich.
+gaps: Was fehlt? Was konntest du nicht prüfen?`;
+export function createCloudButler(provider, actions, ctx) {
+    return {
+        async execute(task, ledgerContext) {
+            const userMsg = [
+                `Aufgabe: ${task.type}`,
+                `Frage: ${task.query}`,
+                ledgerContext ? `Kontext:\n${ledgerContext}` : '',
+            ].filter(Boolean).join('\n');
+            const gen = loop({
+                messages: [{ id: 'cloud-in', role: 'user', content: userMsg, ts: Date.now() }],
+                system: CLOUD_SYSTEM_PROMPT,
+                actions,
+                provider,
+                ctx,
+                budget: 7, // ADR: Max 7 Tool-Calls pro Turn
+            });
+            let responseText = '';
+            for (;;) {
+                const { value, done } = await gen.next();
+                if (done)
+                    break;
+                if (value.role === 'assistant' && typeof value.content === 'string') {
+                    responseText = value.content;
+                }
+                // Bei ContentBlock[] den letzten Text extrahieren
+                if (value.role === 'assistant' && Array.isArray(value.content)) {
+                    for (const block of value.content) {
+                        if (block.type === 'text')
+                            responseText = block.text;
+                    }
+                }
+            }
+            try {
+                const match = responseText.match(/\{[\s\S]*\}/);
+                if (!match)
+                    return err('Cloud-Butler: No JSON in response');
+                const parsed = JSON.parse(match[0]);
+                return ok({
+                    title: parsed.title ?? task.query,
+                    summary: parsed.summary ?? '',
+                    content: parsed.content ?? '',
+                    confidence: parsed.confidence ?? 0.5,
+                    sources: Array.isArray(parsed.sources) ? parsed.sources : [],
+                    gaps: Array.isArray(parsed.gaps) ? parsed.gaps : [],
+                });
+            }
+            catch {
+                return err('Cloud-Butler: Failed to parse response');
+            }
+        },
+    };
+}
+//# sourceMappingURL=butler-cloud.js.map

package/dist/compat/butler-cloud.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"butler-cloud.js","sourceRoot":"","sources":["../../src/compat/butler-cloud.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAC/C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAe,MAAM,aAAa,CAAA;AAwBlD,MAAM,mBAAmB,GAAG;;;;+CAImB,CAAA;AAE/C,MAAM,UAAU,iBAAiB,CAC/B,QAAkB,EAClB,OAA0B,EAC1B,GAAY;IAEZ,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa;YAC/B,MAAM,OAAO,GAAG;gBACd,YAAY,IAAI,CAAC,IAAI,EAAE;gBACvB,UAAU,IAAI,CAAC,KAAK,EAAE;gBACtB,aAAa,CAAC,CAAC,CAAC,aAAa,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;aAClD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAE5B,MAAM,GAAG,GAAG,IAAI,CAAC;gBACf,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAC9E,MAAM,EAAE,mBAAmB;gBAC3B,OAAO;gBACP,QAAQ;gBACR,GAAG;gBACH,MAAM,EAAE,CAAC,EAAG,iCAAiC;aAC9C,CAAC,CAAA;YAEF,IAAI,YAAY,GAAG,EAAE,CAAA;YACrB,SAAS,CAAC;gBACR,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;gBACxC,IAAI,IAAI;oBAAE,MAAK;gBACf,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACpE,YAAY,GAAG,KAAK,CAAC,OAAO,CAAA;gBAC9B,CAAC;gBACD,kDAAkD;gBAClD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC/D,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;wBAClC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;4BAAE,YAAY,GAAG,KAAK,CAAC,IAAI,CAAA;oBACtD,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;gBAC/C,IAAI,CAAC,KAAK;oBAAE,OAAO,GAAG,CAAC,mCAAmC,CAAC,CAAA;gBAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAA4B,CAAA;gBAC9D,OAAO,EAAE,CAAC;oBACR,KAAK,EAAG,MAAM,CAAC,KAAgB,IAAI,IAAI,CAAC,KAAK;oBAC7C,OAAO,EAAG,MAAM,CAAC,OAAkB,IAAI,EAAE;oBACzC,OAAO,EAAG,MAAM,CAAC,OAAkB,IAAI,EAAE;oBACzC,UAAU,EAAG,MAAM,CAAC,UAAqB,IAAI,GAAG;oBAChD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAmB,CAAC,CAAC,CAAC,EAAE;oBACxE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAgB,CAAC,CAAC,CAAC,EAAE;iBAChE,CAAC,CAAA;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,CAAC,wCAAwC,CAAC,CAAA;YACtD,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/compat/butler-edge.d.ts

@@ -0,0 +1,34 @@
+/**
+ * COMPAT — Edge Butler Adapter
+ *
+ * Wraps Foundation Provider + Loop als EdgeButler Interface.
+ * Der Edge-Butler klassifiziert: IGNORE, OBSERVE, ROUTE_CLOUD, ALERT.
+ * Kein Chat, kein Draft — nur Routing + Gesture + Ledger-Eintrag.
+ *
+ * Messpunkt: Unter 100 Zeilen = Interfaces stimmen.
+ */
+import type { Provider } from '../s10-inference/provider.js';
+import type { Context } from '../s10-inference/context.js';
+import type { GestureType } from '../s05-rendering/types.js';
+import { type Result } from '../types.js';
+export type EdgeIntent = 'ignore' | 'observe' | 'route_cloud' | 'alert';
+export type EdgeInput = {
+    triggeredKeyword?: string;
+    ledgerSnapshot: string;
+    roomContext: {
+        roomId: string;
+        participants: string[];
+        activeSpeaker?: string;
+    };
+};
+export type EdgeOutput = {
+    intent: EdgeIntent;
+    gesture?: GestureType;
+    ledgerEntry?: string;
+    cloudQuery?: string;
+};
+export type EdgeButler = {
+    process(input: EdgeInput): Promise<Result<EdgeOutput, string>>;
+};
+export declare function createEdgeButler(provider: Provider, ctx: Context): EdgeButler;
+//# sourceMappingURL=butler-edge.d.ts.map

package/dist/compat/butler-edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"butler-edge.d.ts","sourceRoot":"","sources":["../../src/compat/butler-edge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,CAAA;AAEvE,MAAM,MAAM,SAAS,GAAG;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAA;QACd,YAAY,EAAE,MAAM,EAAE,CAAA;QACtB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;CAC/D,CAAA;AASD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAG,UAAU,CA2C7E"}

package/dist/compat/butler-edge.js

@@ -0,0 +1,62 @@
+/**
+ * COMPAT — Edge Butler Adapter
+ *
+ * Wraps Foundation Provider + Loop als EdgeButler Interface.
+ * Der Edge-Butler klassifiziert: IGNORE, OBSERVE, ROUTE_CLOUD, ALERT.
+ * Kein Chat, kein Draft — nur Routing + Gesture + Ledger-Eintrag.
+ *
+ * Messpunkt: Unter 100 Zeilen = Interfaces stimmen.
+ */
+import { loop } from '../s10-inference/loop.js';
+import { ok, err } from '../types.js';
+const EDGE_SYSTEM_PROMPT = `Du bist Sebastian-Innen, ein Edge-Classifier.
+Antworte NUR als JSON: {"intent":"ignore"|"observe"|"route_cloud"|"alert","gesture":"idle"|"nodding"|"bowing"|"hand_raise","ledgerEntry":"...oder null","cloudQuery":"...oder null"}
+Kein Fließtext. Kein Markdown. Nur JSON.
+Wenn Stichwort erkannt → intent: route_cloud, cloudQuery formulieren.
+Wenn nichts relevant → intent: ignore.
+Max 150 Zeichen für ledgerEntry.`;
+export function createEdgeButler(provider, ctx) {
+    return {
+        async process(input) {
+            const userMsg = [
+                input.triggeredKeyword ? `Stichwort: "${input.triggeredKeyword}"` : '',
+                `Raum: ${input.roomContext.roomId}, ${input.roomContext.participants.length} Teilnehmer`,
+                input.roomContext.activeSpeaker ? `Spricht: ${input.roomContext.activeSpeaker}` : '',
+                `Ledger:\n${input.ledgerSnapshot}`,
+            ].filter(Boolean).join('\n');
+            const gen = loop({
+                messages: [{ id: 'edge-in', role: 'user', content: userMsg, ts: Date.now() }],
+                system: EDGE_SYSTEM_PROMPT,
+                actions: [],
+                provider,
+                ctx,
+                budget: 1,
+            });
+            let responseText = '';
+            for (;;) {
+                const { value, done } = await gen.next();
+                if (done)
+                    break;
+                if (value.role === 'assistant' && typeof value.content === 'string') {
+                    responseText = value.content;
+                }
+            }
+            try {
+                const match = responseText.match(/\{[\s\S]*\}/);
+                if (!match)
+                    return err('Edge-Butler: No JSON in response');
+                const parsed = JSON.parse(match[0]);
+                return ok({
+                    intent: parsed.intent ?? 'ignore',
+                    gesture: parsed.gesture ?? 'idle',
+                    ledgerEntry: parsed.ledgerEntry,
+                    cloudQuery: parsed.cloudQuery,
+                });
+            }
+            catch {
+                return err('Edge-Butler: Failed to parse response');
+            }
+        },
+    };
+}
+//# sourceMappingURL=butler-edge.js.map

package/dist/compat/butler-edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"butler-edge.js","sourceRoot":"","sources":["../../src/compat/butler-edge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAC/C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAe,MAAM,aAAa,CAAA;AAyBlD,MAAM,kBAAkB,GAAG;;;;;iCAKM,CAAA;AAEjC,MAAM,UAAU,gBAAgB,CAAC,QAAkB,EAAE,GAAY;IAC/D,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,OAAO,GAAG;gBACd,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,KAAK,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,EAAE;gBACtE,SAAS,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,MAAM,aAAa;gBACxF,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;gBACpF,YAAY,KAAK,CAAC,cAAc,EAAE;aACnC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAE5B,MAAM,GAAG,GAAG,IAAI,CAAC;gBACf,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAC7E,MAAM,EAAE,kBAAkB;gBAC1B,OAAO,EAAE,EAAE;gBACX,QAAQ;gBACR,GAAG;gBACH,MAAM,EAAE,CAAC;aACV,CAAC,CAAA;YAEF,IAAI,YAAY,GAAG,EAAE,CAAA;YACrB,SAAS,CAAC;gBACR,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;gBACxC,IAAI,IAAI;oBAAE,MAAK;gBACf,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACpE,YAAY,GAAG,KAAK,CAAC,OAAO,CAAA;gBAC9B,CAAC;YACH,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;gBAC/C,IAAI,CAAC,KAAK;oBAAE,OAAO,GAAG,CAAC,kCAAkC,CAAC,CAAA;gBAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAA4B,CAAA;gBAC9D,OAAO,EAAE,CAAC;oBACR,MAAM,EAAG,MAAM,CAAC,MAAqB,IAAI,QAAQ;oBACjD,OAAO,EAAG,MAAM,CAAC,OAAuB,IAAI,MAAM;oBAClD,WAAW,EAAE,MAAM,CAAC,WAAiC;oBACrD,UAAU,EAAE,MAAM,CAAC,UAAgC;iBACpD,CAAC,CAAA;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,CAAC,uCAAuC,CAAC,CAAA;YACrD,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/compat/butler-pair.d.ts

@@ -0,0 +1,27 @@
+/**
+ * COMPAT — Butler Pair Factory
+ *
+ * Erzeugt Edge + Cloud Butler Paar mit SharedDoc für State-Sync.
+ * Ein Aufruf, alles verdrahtet.
+ */
+import type { Provider } from '../s10-inference/provider.js';
+import type { Action } from '../s10-inference/action.js';
+import { type Context, type GateMode } from '../s10-inference/context.js';
+import type { SharedDocWithAccessors } from '../s02-crdt/types.js';
+import { type EdgeButler } from './butler-edge.js';
+import { type CloudButler } from './butler-cloud.js';
+export type ButlerPair = {
+    edge: EdgeButler;
+    cloud: CloudButler;
+    shared: SharedDocWithAccessors;
+    edgeCtx: Context;
+    cloudCtx: Context;
+};
+export declare function createButlerPair(opts: {
+    edgeProvider: Provider;
+    cloudProvider: Provider;
+    cloudActions?: readonly Action[];
+    root: string;
+    mode?: GateMode;
+}): ButlerPair;
+//# sourceMappingURL=butler-pair.d.ts.map

package/dist/compat/butler-pair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"butler-pair.d.ts","sourceRoot":"","sources":["../../src/compat/butler-pair.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAiB,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAExF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAClE,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEvE,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,WAAW,CAAA;IAClB,MAAM,EAAE,sBAAsB,CAAA;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,YAAY,EAAE,QAAQ,CAAA;IACtB,aAAa,EAAE,QAAQ,CAAA;IACvB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,QAAQ,CAAA;CAChB,GAAG,UAAU,CAYb"}

package/dist/compat/butler-pair.js

@@ -0,0 +1,23 @@
+/**
+ * COMPAT — Butler Pair Factory
+ *
+ * Erzeugt Edge + Cloud Butler Paar mit SharedDoc für State-Sync.
+ * Ein Aufruf, alles verdrahtet.
+ */
+import { createContext } from '../s10-inference/context.js';
+import { createYjsDoc } from '../s02-crdt/yjs.js';
+import { createEdgeButler } from './butler-edge.js';
+import { createCloudButler } from './butler-cloud.js';
+export function createButlerPair(opts) {
+    const shared = createYjsDoc();
+    const edgeCtx = createContext({ model: 'edge', root: opts.root, mode: opts.mode });
+    const cloudCtx = createContext({ model: 'cloud', root: opts.root, mode: opts.mode });
+    return {
+        edge: createEdgeButler(opts.edgeProvider, edgeCtx),
+        cloud: createCloudButler(opts.cloudProvider, opts.cloudActions ?? [], cloudCtx),
+        shared,
+        edgeCtx,
+        cloudCtx,
+    };
+}
+//# sourceMappingURL=butler-pair.js.map

package/dist/compat/butler-pair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"butler-pair.js","sourceRoot":"","sources":["../../src/compat/butler-pair.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,aAAa,EAA+B,MAAM,6BAA6B,CAAA;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,iBAAiB,EAAoB,MAAM,mBAAmB,CAAA;AAUvE,MAAM,UAAU,gBAAgB,CAAC,IAMhC;IACC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IAClF,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IAEpF,OAAO;QACL,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;QAClD,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE,EAAE,QAAQ,CAAC;QAC/E,MAAM;QACN,OAAO;QACP,QAAQ;KACT,CAAA;AACH,CAAC"}

package/dist/compat/entry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * COMPAT — Entry ↔ LedgerEntry Adapter
+ *
+ * Lebt in compat/, NICHT in touches/ oder sXX/.
+ * compat/ ist die Brücke zu externen Typsystemen.
+ * Foundation kennt keine externen Types.
+ * Dieser Adapter kennt beide Seiten.
+ *
+ * Observer-Korrektur #1: Klare Positionierung außerhalb des Schichten-Modells.
+ */
+import type { Entry } from '../types.js';
+/**
+ * 0room0's LedgerEntry Type (gespiegelt, nicht importiert).
+ * Foundation importiert NICHT aus 0room0. Die Struktur wird hier definiert.
+ */
+export type LedgerEntry = {
+    text: string;
+    timestamp: Date;
+    participants: string[];
+    category: string;
+    sessionId: string;
+    embedding?: Float32Array;
+};
+export declare function ledgerToEntry(ledger: LedgerEntry): Entry;
+export declare function entryToLedger(entry: Entry): LedgerEntry;
+//# sourceMappingURL=entry.d.ts.map

package/dist/compat/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/compat/entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,aAAa,CAAA;AAEvD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,IAAI,CAAA;IACf,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,YAAY,CAAA;CACzB,CAAA;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAWxD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAUvD"}