WFGY/ProblemMap/GlobalFixMap/Agents_Orchestration/rewind_agents.md

13 KiB
Raw Blame History

Rewind Agents: Guardrails and Fix Patterns

🧭 Quick Return to Map

You are in a sub-page of Agents & Orchestration.
To reorient, go back here:

Think of this page as a desk within a ward.
If you need the full triage and all prescriptions, return to the Emergency Room lobby.

Use this page when your orchestration uses Rewind-style agents that capture local context across apps, then plan and act. If you see privacy leaks, wrong app selection, citation mismatches, or answers that flip between runs, follow these checks and jump to the exact WFGY fix pages.

Acceptance targets

  • ΔS(question, retrieved) ≤ 0.45
  • Coverage ≥ 0.70 to the intended section or record
  • λ stays convergent across 3 paraphrases and 2 seeds
  • E_resonance stays flat on long windows

Open these first


Typical Rewind breakpoints and the right fix

  • Context capture is noisy or oversized and raises ΔS
    Tighten capture filters and re-score with deterministic reranking.
    Open: Retrieval Playbook · Rerankers

  • Private strings leak from raw screen or clipboard into prompts
    Add a redaction prefilter and a contract gate before the LLM step.
    Open: Data Contracts · Prompt Injection

  • High similarity yet wrong meaning after capture
    Mixed embedding functions or metric mismatch between capture and store.
    Open: Embedding ≠ Semantic

  • Wrong app gets chosen in cross app routing
    Split the query into intent vs retrieval and lock a two stage rerank.
    Open: Query Parsing Split · Rerankers

  • Citations do not line up because DOM based capture differs from visible text
    Require cite then explain with snippet_id, section_id, offsets.
    Open: Retrieval Traceability · Data Contracts

  • Agent handoff loops or shared memory overwrite between apps
    Split namespaces per app and stamp mem_rev and mem_hash.
    Open: Multi-Agent Problems · role drift · memory desync

  • Cold boot errors when capture begins before indexes are ready
    Guard with warm up checks and backoff.
    Open: Bootstrap Ordering · Pre-Deploy Collapse


Fix in 60 seconds

  1. Measure ΔS
    Compute ΔS(question, retrieved) and ΔS(retrieved, expected anchor).
    Stable < 0.40, transitional 0.40 to 0.60, risk ≥ 0.60.

  2. Probe λ_observe
    Do a k sweep and reorder headers. If λ flips on paraphrases, lock the schema and clamp variance with BBAM.

  3. Apply the module

  1. Verify
    Coverage ≥ 0.70. ΔS ≤ 0.45. Three paraphrases and two seeds with λ convergent.

Minimal Rewind pattern with WFGY checks

# Pseudocode. Show only the control points that matter.

CAPTURE_FIELDS = ["app", "window_title", "text", "dom_path", "timestamp"]
SNIPPET_FIELDS = ["snippet_id", "section_id", "source_url", "offsets", "tokens"]

def capture_context(apps, budget_chars=8000):
    # per-app capture with privacy filters and dedupe
    raw = []
    for app in apps:
        raw.extend(capture_from(app, fields=CAPTURE_FIELDS))
    return redact_and_truncate(raw, budget=budget_chars)

def build_candidates(raw):
    # convert capture into retrievable snippets with a unified analyzer and metric
    return chunk_and_embed(raw, fields=SNIPPET_FIELDS)

def route_intent(question, candidates):
    # two stage: intent selection then deterministic rerank
    intent = detect_intent(question, candidates)
    ordered = rerank(intent, candidates)
    return ordered[:10]

def assemble_prompt(snippets, question):
    # schema-locked prompt with cite then explain
    return prompt.format(context=snippets, question=question)

def wfgy_gate(q, context, answer):
    m = metrics_and_trace(q, context, answer)
    if m["ΔS"] >= 0.60 or m["λ_state"] == "divergent":
        raise RuntimeError("WFGY gate: high ΔS or divergent λ")
    return m

def run_rewind_agent(question):
    raw = capture_context(apps=["browser","docs","mail"])
    candidates = build_candidates(raw)
    topk = route_intent(question, candidates)
    msg = assemble_prompt(topk, question)
    result = agent.invoke(msg)  # the agent must respect strict JSON for tools
    metrics = wfgy_gate(question, topk, result)
    return {"answer": result, "metrics": metrics}

What this enforces

  • Capture is filtered and budgeted before retrieval. Privacy redaction happens first.
  • Retrieval uses a unified analyzer and metric. Deterministic reranking controls ordering.
  • Prompt is schema locked with cite first, then answer.
  • A post generation WFGY gate can halt the run when ΔS is high or λ flips.
  • Traces record snippet to citation mapping for audits.

Specs and recipes RAG Architecture & Recovery · Retrieval Playbook · Retrieval Traceability · Data Contracts


Rewind-specific gotchas

  • Capture order changes across windows and breaks reproducibility Stamp capture_rev and sort by app priority before rerank.

  • Clipboard or screenshot text bypasses redaction rules Force the same redaction pass for every capture source.

  • PDF or canvas based apps produce different text than visible content Add a DOM or accessible text fallback and record the path in source_url.

  • Multi account confusion in Gmail, Drive, Notion Add account id to the namespace and to dedupe_key.

  • Live side effects before citation checks Require successful WFGY gate and idempotency check before any writes.


When to escalate

  • ΔS remains ≥ 0.60 after capture filters and retrieval fixes Rebuild the index using the checklists and verify with a small gold set. Retrieval Playbook

  • Identical input yields different answers across sessions Check version skew, capture order, and session state. Pre-Deploy Collapse


🔗 Quick-Start Downloads (60 sec)

Tool Link 3-Step Setup
WFGY 1.0 PDF Engine Paper 1 Download · 2 Upload to your LLM · 3 Ask “Answer using WFGY + <your question>”
TXT OS (plain-text OS) TXTOS.txt 1 Download · 2 Paste into any LLM chat · 3 Type “hello world” — OS boots instantly

Explore More

Layer Page What its for
Proof WFGY Recognition Map External citations, integrations, and ecosystem proof
Engine WFGY 1.0 Original PDF based tension engine
Engine WFGY 2.0 Production tension kernel and math engine for RAG and agents
Engine WFGY 3.0 TXT based Singularity tension engine, 131 S class set
Map Problem Map 1.0 Flagship 16 problem RAG failure checklist and fix map
Map Problem Map 2.0 RAG focused recovery pipeline
Map Problem Map 3.0 Global Debug Card, image as a debug protocol layer
Map Semantic Clinic Symptom to family to exact fix
Map Grandmas Clinic Plain language stories mapped to Problem Map 1.0
Onboarding Starter Village Guided tour for newcomers
App TXT OS TXT semantic OS, fast boot
App Blah Blah Blah Abstract and paradox Q and A built on TXT OS
App Blur Blur Blur Text to image with semantic control
App Blow Blow Blow Reasoning game engine and memory demo

If this repository helped, starring it improves discovery so more builders can find the docs and tools. GitHub Repo stars

要不要我直接接著生 agents_orchestration/README.md 的目錄與快速路由,或先做下一頁你排程裡的下一個工具?