bilinc 2.6.2__tar.gz → 2.7.0__tar.gz

{bilinc-2.6.2/src/bilinc.egg-info → bilinc-2.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bilinc
-Version: 2.6.2
+Version: 2.7.0
 Summary: Cloud-only memory SDK and MCP adapter for autonomous agents
 Author: Bilinc Team
 License-Expression: BUSL-1.1
@@ -185,6 +185,9 @@ The config carries no key; the adapter reads the one `bilinc login` saved. On a
 | `list_memories` | Browse what is stored. Free. |
 | `history` | One memory's changes, newest first. Free. |
 | `confirm` | Record that a memory is still accurate. One write. |
+| `dream_start` | Start a dream pass: the entries changed since the last one, for your agent to review. Stdio adapter; coming to the hosted connector. |
+| `dream_apply` | Apply the dream's merges, retirements, confirmations and flags. **Destructive**; undo with `dream_undo`. Stdio adapter; coming to the hosted connector. |
+| `dream_undo` | Undo a dream in one step, for 7 days. Stdio adapter; coming to the hosted connector. |
 
 The remote connector at `https://mcp.bilinc.space/mcp` has ten tools; a read-only connection lists only the four read tools. Client guides: [Claude Code](https://bilinc.space/docs/claude-code) · [Codex](https://bilinc.space/docs/codex) · [Cursor](https://bilinc.space/docs/cursor) · [any MCP client](https://bilinc.space/for/mcp).
 
@@ -211,11 +214,10 @@ All endpoints live under `https://bilinc.space`. Memory operations need an API k
 
 Send an `Idempotency-Key` header on any write you might retry: the same key with the same payload replays the original result and is billed once; a different payload is refused with `409 idempotency_conflict`. Saves that contain a credential, such as an API key, token or private key, are refused with `secret_detected` and the value is never echoed back.
 
-## What's new in 2.6.2
+## What's new in 2.7.0
 
-- **"What changed today?"**: recall answers time questions in English and Turkish ("since Monday", "dünkü kararlar", "son 3 günde") with the memories written in that window, newest first, in the project's time zone.
-- **Less noise in time questions**: sources such as raw chat transcripts can be left out of time answers unless you ask for chats.
-- **Nothing else moves**: queries without a time phrase are answered exactly as before.
+- **Wiki export**: `bilinc wiki <dir>` writes your memory as Obsidian-compatible Markdown, one page per key, with recent changes, links between keys and an index. It is one-way, never touches files it did not write, and reruns reuse unchanged pages. `--wikilinks` writes `[[...]]` links; the stdio MCP adapter has the same export as `export_wiki`.
+- **Dream pass**: your agent tidies its own memory (merges duplicates, retires stale entries, flags what a person should decide) and you can undo the pass's own changes in one step for 7 days. Bilinc runs no model for this. Available in the SDK, the CLI (`bilinc dream`) and the stdio MCP adapter; coming to the hosted connector.
 
 Every release: [changelog](https://bilinc.space/changelog).
 

{bilinc-2.6.2 → bilinc-2.7.0}/README.md

@@ -137,6 +137,9 @@ The config carries no key; the adapter reads the one `bilinc login` saved. On a
 | `list_memories` | Browse what is stored. Free. |
 | `history` | One memory's changes, newest first. Free. |
 | `confirm` | Record that a memory is still accurate. One write. |
+| `dream_start` | Start a dream pass: the entries changed since the last one, for your agent to review. Stdio adapter; coming to the hosted connector. |
+| `dream_apply` | Apply the dream's merges, retirements, confirmations and flags. **Destructive**; undo with `dream_undo`. Stdio adapter; coming to the hosted connector. |
+| `dream_undo` | Undo a dream in one step, for 7 days. Stdio adapter; coming to the hosted connector. |
 
 The remote connector at `https://mcp.bilinc.space/mcp` has ten tools; a read-only connection lists only the four read tools. Client guides: [Claude Code](https://bilinc.space/docs/claude-code) · [Codex](https://bilinc.space/docs/codex) · [Cursor](https://bilinc.space/docs/cursor) · [any MCP client](https://bilinc.space/for/mcp).
 
@@ -163,11 +166,10 @@ All endpoints live under `https://bilinc.space`. Memory operations need an API k
 
 Send an `Idempotency-Key` header on any write you might retry: the same key with the same payload replays the original result and is billed once; a different payload is refused with `409 idempotency_conflict`. Saves that contain a credential, such as an API key, token or private key, are refused with `secret_detected` and the value is never echoed back.
 
-## What's new in 2.6.2
+## What's new in 2.7.0
 
-- **"What changed today?"**: recall answers time questions in English and Turkish ("since Monday", "dünkü kararlar", "son 3 günde") with the memories written in that window, newest first, in the project's time zone.
-- **Less noise in time questions**: sources such as raw chat transcripts can be left out of time answers unless you ask for chats.
-- **Nothing else moves**: queries without a time phrase are answered exactly as before.
+- **Wiki export**: `bilinc wiki <dir>` writes your memory as Obsidian-compatible Markdown, one page per key, with recent changes, links between keys and an index. It is one-way, never touches files it did not write, and reruns reuse unchanged pages. `--wikilinks` writes `[[...]]` links; the stdio MCP adapter has the same export as `export_wiki`.
+- **Dream pass**: your agent tidies its own memory (merges duplicates, retires stale entries, flags what a person should decide) and you can undo the pass's own changes in one step for 7 days. Bilinc runs no model for this. Available in the SDK, the CLI (`bilinc dream`) and the stdio MCP adapter; coming to the hosted connector.
 
 Every release: [changelog](https://bilinc.space/changelog).
 

{bilinc-2.6.2 → bilinc-2.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bilinc"
-version = "2.6.2"
+version = "2.7.0"
 description = "Cloud-only memory SDK and MCP adapter for autonomous agents"
 readme = "README.md"
 license = "BUSL-1.1"
@@ -75,7 +75,7 @@ bilinc = "bilinc.cli.main:main"
 
 [tool.setuptools]
 package-dir = {"" = "src"}
-packages = ["bilinc", "bilinc.cli"]
+packages = ["bilinc", "bilinc.cli", "bilinc.wiki"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{bilinc-2.6.2 → bilinc-2.7.0}/src/bilinc/__init__.py

@@ -1,4 +1,4 @@
-"""Bilinc 2.6.2: cloud-only SDK for agent memory."""
+"""Bilinc 2.7.0: cloud-only SDK for agent memory."""
 
 from bilinc.client import (
     ACTIVATION_SIGNUP_URL,
@@ -25,7 +25,7 @@ from bilinc.client import (
     CloudClient,
 )
 
-__version__ = "2.6.2"
+__version__ = "2.7.0"
 version = __version__
 
 __all__ = [

{bilinc-2.6.2 → bilinc-2.7.0}/src/bilinc/cli/main.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 
 import argparse
 import contextlib
+import http.client
 import json
 import os
 import shlex
@@ -24,6 +25,7 @@ from bilinc.client import (
     BilincValidationError,
     CloudClient,
     INSTALL_URL,
+    MAX_HISTORY_LIMIT,
     MEMORY_TYPES,
     SIGNUP_URL,
     VALUE_MODES,
@@ -32,6 +34,7 @@ from bilinc.client import (
     save_config_api_key,
 )
 from bilinc.cli.login import LoginError, device_login, is_headless, loopback_login
+from bilinc.wiki import WikiExportError, export_wiki, summary_line
 
 
 def _parse_value(value: str) -> Any:
@@ -169,6 +172,194 @@ def _write_private_json(path: str, payload: dict[str, Any]) -> None:
         raise
 
 
+def _history_count(text: str) -> int:
+    try:
+        value = int(text)
+    except ValueError:
+        raise argparse.ArgumentTypeError(f"must be a whole number from 0 to {MAX_HISTORY_LIMIT}") from None
+    if not 0 <= value <= MAX_HISTORY_LIMIT:
+        raise argparse.ArgumentTypeError(f"must be a whole number from 0 to {MAX_HISTORY_LIMIT}")
+    return value
+
+
+def _name_some(keys: list[str], limit: int = 20) -> str:
+    shown = ", ".join(keys[:limit])
+    return shown + (f", … ({len(keys) - limit} more)" if len(keys) > limit else "")
+
+
+def _read_dream_actions(
+    parser: argparse.ArgumentParser, source: str
+) -> tuple[list[dict[str, Any]], dict[str, Any] | None]:
+    """Load `{"actions": [...], "report": {...}}` or a bare action list; bad input is a usage error."""
+    try:
+        if source == "-":
+            text = sys.stdin.read()
+        else:
+            with open(source, encoding="utf-8") as handle:
+                text = handle.read()
+    except OSError as exc:
+        parser.error(f"dream apply: cannot read {source}: {exc.strerror or exc}")
+    try:
+        payload = json.loads(text)
+    except json.JSONDecodeError as exc:
+        parser.error(f"dream apply: {source} is not valid JSON ({exc.msg}, line {exc.lineno})")
+    report = None
+    if isinstance(payload, dict):
+        actions = payload.get("actions")
+        report = payload.get("report")
+        if report is not None and not isinstance(report, dict):
+            parser.error("dream apply: report must be a JSON object")
+    else:
+        actions = payload
+    if not isinstance(actions, list):
+        parser.error('dream apply: expected {"actions": [...]} or a JSON list of actions')
+    return actions, report
+
+
+def _dream_parser(parser: argparse.ArgumentParser) -> argparse.ArgumentParser:
+    commands = next(action for action in parser._actions if isinstance(action, argparse._SubParsersAction))
+    return commands.choices["dream"]
+
+
+def _print_dream_start(result: dict[str, Any]) -> None:
+    if not result.get("dream_id"):
+        print(f"Nothing changed since {result.get('since') or 'the last dream'}; no dream started.")
+        return
+    candidates = result.get("candidates") or []
+    count = result.get("candidate_count", len(candidates))
+    window = result.get("undo_window_days", 7)
+    print(
+        f"dream {result['dream_id']}: {count} candidates, forget cap {result.get('forget_cap', 0)}, "
+        f"undo window {window} days"
+    )
+    for item in candidates:
+        print(
+            f"{item.get('key')}  [{item.get('memory_type') or '-'}]  "
+            f"{_short_time(item.get('updated_at'))}  {item.get('entry_version') or '-'}"
+        )
+    if result.get("truncated"):
+        print("(more candidates than shown; run again after this dream, or narrow with --prefix)")
+
+
+def _print_dream_results(results: list[dict[str, Any]]) -> None:
+    totals = {"applied": 0, "conflict": 0, "error": 0, "skipped": 0}
+    for row in results:
+        outcome = str(row.get("result") or "-")
+        if outcome in totals:
+            totals[outcome] += 1
+        line = f"{row.get('n')}  {row.get('op')}  {row.get('key')}  {outcome}"
+        if row.get("error"):
+            line += f" {row['error']}"
+        print(line)
+    print(
+        f"applied {totals['applied']}, conflicts {totals['conflict']}, "
+        f"errors {totals['error']}, skipped {totals['skipped']}"
+    )
+
+
+def _print_dream_undo(result: dict[str, Any]) -> None:
+    print(f"dream {result.get('dream_id')}: {result.get('status')}")
+    restored = result.get("restored") or []
+    conflicts = result.get("conflicts") or []
+    kept = result.get("kept") or []
+    print(f"restored ({len(restored)})")
+    for row in restored:
+        line = f"  {row.get('n')}  {row.get('op')}  {row.get('key')}"
+        if row.get("metadata_restored") is False:
+            line += "  (metadata not restored)"
+        print(line)
+    print(f"conflicts ({len(conflicts)})")
+    for row in conflicts:
+        print(f"  {row.get('n')}  {row.get('key')}  {row.get('reason') or ''}".rstrip())
+    print(f"kept ({len(kept)})")
+    for row in kept:
+        print(f"  {row.get('n')}  {row.get('key')}")
+
+
+def _run_dream(client: CloudClient, args: argparse.Namespace, parser: argparse.ArgumentParser) -> int:
+    if args.dream_command == "start":
+        result = client.dream_start(prefix=args.prefix, since=args.since, limit=args.limit)
+        if args.json:
+            _print(result)
+        else:
+            _print_dream_start(result)
+    elif args.dream_command == "apply":
+        actions, report = _read_dream_actions(parser, args.file)
+        try:
+            result = client.dream_apply(args.dream_id, actions, report=report)
+        except BilincCloudError as exc:
+            partial = getattr(exc, "partial", None)
+            if isinstance(partial, dict) and partial.get("results"):
+                _print_dream_results(partial["results"])
+            raise
+        _print_dream_results(result.get("results") or [])
+    elif args.dream_command == "undo":
+        result = client.dream_undo(args.dream_id)
+        if args.json:
+            _print(result)
+        else:
+            _print_dream_undo(result)
+    elif args.dream_command == "show":
+        _print(client.dream_show(args.dream_id))
+    return 0
+
+
+def _run_wiki(client: CloudClient, args: argparse.Namespace) -> int:
+    """Export to a folder; one summary line on stdout, everything else on stderr."""
+    counted = []
+
+    def progress(done: int, total: int) -> None:
+        counted.append(done)
+        print(f"\rhistory {done}/{total}", end="", file=sys.stderr, flush=True)
+
+    try:
+        result = export_wiki(
+            client,
+            args.dir,
+            history=args.history,
+            prefix=args.prefix,
+            wikilinks=args.wikilinks,
+            refresh_history=args.refresh_history,
+            progress=progress if sys.stderr.isatty() else None,
+        )
+    except KeyboardInterrupt:
+        if counted:
+            print(file=sys.stderr)
+        print("bilinc: wiki export cancelled", file=sys.stderr)
+        return 130
+    except WikiExportError as exc:
+        if counted:
+            print(file=sys.stderr)
+        print(f"bilinc: error: {exc}", file=sys.stderr)
+        return 1
+    except (OSError, http.client.HTTPException) as exc:
+        # The SDK's transport lets a timeout or dropped connection while reading
+        # a response through unwrapped; nothing was written at that point.
+        if counted:
+            print(file=sys.stderr)
+        print(f"bilinc: error: Bilinc Cloud request failed: {exc}", file=sys.stderr)
+        return 1
+    if counted:
+        print(file=sys.stderr)
+    for line in result.warnings:
+        print(line, file=sys.stderr)
+    if result.history_unavailable:
+        count = len(result.history_unavailable)
+        print(
+            f"warning: history unavailable for {count} key{'s' if count != 1 else ''}: "
+            f"{_name_some(result.history_unavailable)}",
+            file=sys.stderr,
+        )
+    if result.skipped:
+        print(
+            "warning: left these previously exported files alone because a folder on the way "
+            f"is no longer a real folder: {_name_some(result.skipped)}",
+            file=sys.stderr,
+        )
+    print(summary_line(result, args.dir))
+    return 0
+
+
 def _client(args: argparse.Namespace) -> CloudClient:
     return CloudClient(api_key=args.api_key, base_url=args.base_url, timeout=args.timeout)
 
@@ -335,6 +526,51 @@ def build_parser() -> argparse.ArgumentParser:
     export.add_argument("--prefix", help="Only keys starting with this text")
     export.add_argument("--type", choices=MEMORY_TYPES, help="Only this memory type")
 
+    wiki_help = "Write every stored memory as Obsidian-compatible Markdown pages in a folder"
+    wiki = sub.add_parser("wiki", help=wiki_help, description=wiki_help)
+    wiki.add_argument("dir", help="Folder to write: new, empty, or a previous bilinc wiki export")
+    wiki.add_argument(
+        "--history",
+        type=_history_count,
+        default=5,
+        metavar="N",
+        help=f"Recorded changes per page, newest first (0-{MAX_HISTORY_LIMIT}, default 5; 0 skips history)",
+    )
+    wiki.add_argument("--prefix", help="Only keys starting with this text")
+    wiki.add_argument(
+        "--wikilinks",
+        action="store_true",
+        help="Write [[...]] links (Obsidian style) instead of standard Markdown links",
+    )
+    wiki.add_argument(
+        "--refresh-history",
+        action="store_true",
+        help="Fetch every page's history again; by default history is reused only when "
+        "nothing changed since the last export",
+    )
+
+    dream_help = "Tidy your agent's memory in a dream pass, and undo it in one step"
+    dream = sub.add_parser("dream", help=dream_help, description=dream_help)
+    dream_sub = dream.add_subparsers(dest="dream_command")
+    dream_start = dream_sub.add_parser("start", help="Start a dream and list the candidate entries")
+    dream_start.add_argument("--prefix", help="Only keys starting with this text")
+    dream_start.add_argument("--since", help="Only entries changed after this ISO-8601 time")
+    dream_start.add_argument("--limit", type=int, default=200, help="Most candidates to return (1-200)")
+    dream_start.add_argument("--json", action="store_true", help="Print the raw JSON response")
+    dream_apply = dream_sub.add_parser("apply", help="Apply a dream's actions from a JSON file or stdin")
+    dream_apply.add_argument("dream_id", help="The id printed by bilinc dream start")
+    dream_apply.add_argument(
+        "--file",
+        default="-",
+        help='JSON with {"actions": [...], "report": {...}} or a bare action list; - reads stdin (default)',
+    )
+    dream_undo = dream_sub.add_parser("undo", help="Undo a dream's own changes")
+    dream_undo.add_argument("dream_id")
+    dream_undo.add_argument("--json", action="store_true", help="Print the raw JSON response")
+    dream_show = dream_sub.add_parser("show", help="Show a dream's report")
+    dream_show.add_argument("dream_id")
+    dream_show.add_argument("--json", action="store_true", help="Print the raw JSON response (the default)")
+
     snapshot = sub.add_parser("snapshot", help="Create or list project checkpoints")
     snapshot.add_argument("action", choices=["create", "list"], nargs="?", default="create")
     snapshot.add_argument("--label", help="Human-readable label for a new checkpoint")
@@ -474,6 +710,9 @@ def main(argv: list[str] | None = None) -> int:
     if args.command is None:
         parser.print_help()
         return 0
+    if args.command == "dream" and args.dream_command is None:
+        _dream_parser(parser).print_help(sys.stderr)
+        return 2
 
     try:
         client = _client(args)
@@ -571,6 +810,10 @@ def main(argv: list[str] | None = None) -> int:
                 print(f"Exported {exported['count']} memories to {args.output}", file=sys.stderr)
             else:
                 _print(exported)
+        elif args.command == "wiki":
+            return _run_wiki(client, args)
+        elif args.command == "dream":
+            return _run_dream(client, args, parser)
         elif args.command == "snapshot":
             if args.action == "list":
                 _print(client.list_snapshots(limit=args.limit))