tabc 0.1.0__tar.gz

tabc-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TAE HYEONG KIM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tabc-0.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include PYPI.md LICENSE
+exclude tabus/locales/ko.json
+exclude README.md
+prune tests
+prune scripts

tabc-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: tabc
+Version: 0.1.0
+Summary: A shared inbox for AI agents and programs on one machine
+License: MIT License
+        
+        Copyright (c) 2026 TAE HYEONG KIM
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Keywords: agents,messaging,ipc,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Communications
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=41
+Dynamic: license-file
+
+# tabc
+
+<img src="https://raw.githubusercontent.com/jultabc/tabc/main/docs/logo.png" alt="tabc" width="320">
+
+A shared inbox for AI agents and programs on one machine.
+Messages are stored locally. Programs can send events; they do not receive replies.
+
+This is an experimental package. It is not a security boundary between agents
+using the same operating-system account. Message delivery does not imply that
+an agent read, understood, or completed a request.
+
+## Install
+
+```bash
+pip install tabc
+```
+
+Installing from TestPyPI is a different command, and the dependency comes from
+the main index:
+
+```bash
+pip install --index-url https://test.pypi.org/simple/ \
+            --extra-index-url https://pypi.org/simple/ tabc
+```
+
+## Requirements
+
+Python 3.9 or later is declared. Installation has been exercised on CPython
+3.11 and 3.13, on macOS. Other versions and operating systems are untested.
+`cryptography` and its platform-dependent dependencies are installed by pip.
+
+## A first round trip
+
+Two shells. If this works, the installation is sound.
+
+```bash
+# shell 1 — start the server, register yourself
+tabd &
+tabc register --node alice --kind generic
+
+# shell 2 — register before anything is sent here
+tabc register --node bob --kind generic
+
+# shell 1 — send
+tabc send --sender alice --to bob --subject "hello" --body "first"
+
+# shell 2 — read it, then record that you did
+tabc pull --node bob --mode full
+tabc ack  --node bob --id <full-uuid> --state READ
+
+# shell 1 — the point: bob: READ
+tabc sent --node alice
+```
+
+The last line is what matters. It shows the message reached the other side,
+rather than showing that sending did not fail. `--id` takes the full UUID from
+the `pull --mode full` detail block, not the truncated one on a title line.
+
+Terminal notification is a separate process and does not start with the
+install; see the repository's guide before turning it on.
+
+## Commands
+
+- `tabc register --node alice --kind codex`: register an agent.
+- `tabc send --sender alice --to bob --subject "Hello" --body "Ready to collaborate."`: send a dm.
+- `tabc dm --node bob`: list unread messages.
+- `tabc read --node bob`: display messages and record them as read.
+- `tabc sent --node alice`: inspect outgoing delivery states.
+- `tabc tac search --node alice --query text`: search joined topics without changing read state.
+
+Register each recipient before sending. tac creators must also join their topic.
+Run `tabc --help` for available commands. The local server is `tabd`; management
+commands are provided separately by `tabm`.
+The source repository carries the operating guide and the security notes.
+
+Release packages include only the English message catalog. English is the default
+and fallback language, including when `TABC_LANG=ko` is set without a Korean catalog.
+
+## Local operation and limitations
+
+Run one `tabd` for a shared store. Its default address is `127.0.0.1:8765`.
+That address is a default, not a fixture:
+
+```bash
+tabd --bind <address> --port <port>     # the daemon
+export TABC_BUS_URL=http://<address>:<port>   # the clients
+```
+
+Keep the store, keys, and server address consistent across participating terminals.
+For isolated tests, use separate `TABC_HOME`, `TABC_DB`, and `TABC_BUS_URL` settings.
+
+Terminal notifications require a separate notifier and a valid terminal route.
+Installation alone does not enable notifications. Automatic Enter defaults to off
+for new routes. Omitting the setting during registration preserves the same active
+route; `--auto-enter off` disables it explicitly.
+
+Do not connect notifications to an unreviewed command prompt.
+Automatic Enter does not guarantee a reply.
+
+Requests are signed, but agents sharing an operating-system account can access
+each other's key files. Messages are not encrypted at rest. Use only within a
+trusted local workspace. Terminal notification types into an input field, which
+is a decision about that terminal rather than a convenience; it is off until you
+turn it on.

tabc-0.1.0/PYPI.md

@@ -0,0 +1,104 @@
+# tabc
+
+<img src="https://raw.githubusercontent.com/jultabc/tabc/main/docs/logo.png" alt="tabc" width="320">
+
+A shared inbox for AI agents and programs on one machine.
+Messages are stored locally. Programs can send events; they do not receive replies.
+
+This is an experimental package. It is not a security boundary between agents
+using the same operating-system account. Message delivery does not imply that
+an agent read, understood, or completed a request.
+
+## Install
+
+```bash
+pip install tabc
+```
+
+Installing from TestPyPI is a different command, and the dependency comes from
+the main index:
+
+```bash
+pip install --index-url https://test.pypi.org/simple/ \
+            --extra-index-url https://pypi.org/simple/ tabc
+```
+
+## Requirements
+
+Python 3.9 or later is declared. Installation has been exercised on CPython
+3.11 and 3.13, on macOS. Other versions and operating systems are untested.
+`cryptography` and its platform-dependent dependencies are installed by pip.
+
+## A first round trip
+
+Two shells. If this works, the installation is sound.
+
+```bash
+# shell 1 — start the server, register yourself
+tabd &
+tabc register --node alice --kind generic
+
+# shell 2 — register before anything is sent here
+tabc register --node bob --kind generic
+
+# shell 1 — send
+tabc send --sender alice --to bob --subject "hello" --body "first"
+
+# shell 2 — read it, then record that you did
+tabc pull --node bob --mode full
+tabc ack  --node bob --id <full-uuid> --state READ
+
+# shell 1 — the point: bob: READ
+tabc sent --node alice
+```
+
+The last line is what matters. It shows the message reached the other side,
+rather than showing that sending did not fail. `--id` takes the full UUID from
+the `pull --mode full` detail block, not the truncated one on a title line.
+
+Terminal notification is a separate process and does not start with the
+install; see the repository's guide before turning it on.
+
+## Commands
+
+- `tabc register --node alice --kind codex`: register an agent.
+- `tabc send --sender alice --to bob --subject "Hello" --body "Ready to collaborate."`: send a dm.
+- `tabc dm --node bob`: list unread messages.
+- `tabc read --node bob`: display messages and record them as read.
+- `tabc sent --node alice`: inspect outgoing delivery states.
+- `tabc tac search --node alice --query text`: search joined topics without changing read state.
+
+Register each recipient before sending. tac creators must also join their topic.
+Run `tabc --help` for available commands. The local server is `tabd`; management
+commands are provided separately by `tabm`.
+The source repository carries the operating guide and the security notes.
+
+Release packages include only the English message catalog. English is the default
+and fallback language, including when `TABC_LANG=ko` is set without a Korean catalog.
+
+## Local operation and limitations
+
+Run one `tabd` for a shared store. Its default address is `127.0.0.1:8765`.
+That address is a default, not a fixture:
+
+```bash
+tabd --bind <address> --port <port>     # the daemon
+export TABC_BUS_URL=http://<address>:<port>   # the clients
+```
+
+Keep the store, keys, and server address consistent across participating terminals.
+For isolated tests, use separate `TABC_HOME`, `TABC_DB`, and `TABC_BUS_URL` settings.
+
+Terminal notifications require a separate notifier and a valid terminal route.
+Installation alone does not enable notifications. Automatic Enter defaults to off
+for new routes. Omitting the setting during registration preserves the same active
+route; `--auto-enter off` disables it explicitly.
+
+Do not connect notifications to an unreviewed command prompt.
+Automatic Enter does not guarantee a reply.
+
+Requests are signed, but agents sharing an operating-system account can access
+each other's key files. Messages are not encrypted at rest. Use only within a
+trusted local workspace. Terminal notification types into an input field, which
+is a decision about that terminal rather than a convenience; it is off until you
+turn it on.

tabc-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tabc"
+version = "0.1.0"
+description = "A shared inbox for AI agents and programs on one machine"
+readme = "PYPI.md"
+requires-python = ">=3.9"
+license = { file = "LICENSE" }
+keywords = ["agents", "messaging", "ipc", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Communications",
+]
+# 🔴 One runtime dependency, and it is not optional. Signing used to be a feature
+#    you could leave out: it labelled a sender, nothing depended on the label, and
+#    so the core stayed standard-library-only with `cryptography` behind a `sign`
+#    extra. Authenticating every request by node-key signature ended that —
+#    `tabus.daemon` imports `nodekey` at module level and raises ImportError on the
+#    first line without it. An extra the daemon cannot start without is not an
+#    extra; leaving it optional made the documented `pip install -e .` produce an
+#    installation with no working `tabd`.
+dependencies = ["cryptography>=41"]
+
+[project.scripts]
+tabc = "tabus.cli:main"
+tabm = "tabus.admin:main"
+tabd = "tabus.daemon:main"
+
+[tool.setuptools]
+# 🔴 Named, not found automatically. Auto-discovery would also sweep in `tests`
+#    and `scripts`, which are part of the repository but not part of what a user
+#    installs.
+packages = ["tabus"]
+
+[tool.setuptools.package-data]
+# The message catalogues ship with the code: they are a package resource, not
+# user state, and tabus.lang resolves them relative to the module.
+tabus = ["locales/en.json"]
+
+[tool.setuptools.exclude-package-data]
+tabus = ["locales/ko.json"]

tabc-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tabc-0.1.0/tabc.egg-info/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: tabc
+Version: 0.1.0
+Summary: A shared inbox for AI agents and programs on one machine
+License: MIT License
+        
+        Copyright (c) 2026 TAE HYEONG KIM
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Keywords: agents,messaging,ipc,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Communications
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=41
+Dynamic: license-file
+
+# tabc
+
+<img src="https://raw.githubusercontent.com/jultabc/tabc/main/docs/logo.png" alt="tabc" width="320">
+
+A shared inbox for AI agents and programs on one machine.
+Messages are stored locally. Programs can send events; they do not receive replies.
+
+This is an experimental package. It is not a security boundary between agents
+using the same operating-system account. Message delivery does not imply that
+an agent read, understood, or completed a request.
+
+## Install
+
+```bash
+pip install tabc
+```
+
+Installing from TestPyPI is a different command, and the dependency comes from
+the main index:
+
+```bash
+pip install --index-url https://test.pypi.org/simple/ \
+            --extra-index-url https://pypi.org/simple/ tabc
+```
+
+## Requirements
+
+Python 3.9 or later is declared. Installation has been exercised on CPython
+3.11 and 3.13, on macOS. Other versions and operating systems are untested.
+`cryptography` and its platform-dependent dependencies are installed by pip.
+
+## A first round trip
+
+Two shells. If this works, the installation is sound.
+
+```bash
+# shell 1 — start the server, register yourself
+tabd &
+tabc register --node alice --kind generic
+
+# shell 2 — register before anything is sent here
+tabc register --node bob --kind generic
+
+# shell 1 — send
+tabc send --sender alice --to bob --subject "hello" --body "first"
+
+# shell 2 — read it, then record that you did
+tabc pull --node bob --mode full
+tabc ack  --node bob --id <full-uuid> --state READ
+
+# shell 1 — the point: bob: READ
+tabc sent --node alice
+```
+
+The last line is what matters. It shows the message reached the other side,
+rather than showing that sending did not fail. `--id` takes the full UUID from
+the `pull --mode full` detail block, not the truncated one on a title line.
+
+Terminal notification is a separate process and does not start with the
+install; see the repository's guide before turning it on.
+
+## Commands
+
+- `tabc register --node alice --kind codex`: register an agent.
+- `tabc send --sender alice --to bob --subject "Hello" --body "Ready to collaborate."`: send a dm.
+- `tabc dm --node bob`: list unread messages.
+- `tabc read --node bob`: display messages and record them as read.
+- `tabc sent --node alice`: inspect outgoing delivery states.
+- `tabc tac search --node alice --query text`: search joined topics without changing read state.
+
+Register each recipient before sending. tac creators must also join their topic.
+Run `tabc --help` for available commands. The local server is `tabd`; management
+commands are provided separately by `tabm`.
+The source repository carries the operating guide and the security notes.
+
+Release packages include only the English message catalog. English is the default
+and fallback language, including when `TABC_LANG=ko` is set without a Korean catalog.
+
+## Local operation and limitations
+
+Run one `tabd` for a shared store. Its default address is `127.0.0.1:8765`.
+That address is a default, not a fixture:
+
+```bash
+tabd --bind <address> --port <port>     # the daemon
+export TABC_BUS_URL=http://<address>:<port>   # the clients
+```
+
+Keep the store, keys, and server address consistent across participating terminals.
+For isolated tests, use separate `TABC_HOME`, `TABC_DB`, and `TABC_BUS_URL` settings.
+
+Terminal notifications require a separate notifier and a valid terminal route.
+Installation alone does not enable notifications. Automatic Enter defaults to off
+for new routes. Omitting the setting during registration preserves the same active
+route; `--auto-enter off` disables it explicitly.
+
+Do not connect notifications to an unreviewed command prompt.
+Automatic Enter does not guarantee a reply.
+
+Requests are signed, but agents sharing an operating-system account can access
+each other's key files. Messages are not encrypted at rest. Use only within a
+trusted local workspace. Terminal notification types into an input field, which
+is a decision about that terminal rather than a convenience; it is off until you
+turn it on.

tabc-0.1.0/tabc.egg-info/SOURCES.txt

@@ -0,0 +1,26 @@
+LICENSE
+MANIFEST.in
+PYPI.md
+pyproject.toml
+tabc.egg-info/PKG-INFO
+tabc.egg-info/SOURCES.txt
+tabc.egg-info/dependency_links.txt
+tabc.egg-info/entry_points.txt
+tabc.egg-info/requires.txt
+tabc.egg-info/top_level.txt
+tabus/__init__.py
+tabus/admin.py
+tabus/bus.py
+tabus/cli.py
+tabus/compat_bcn.py
+tabus/compat_busd.py
+tabus/daemon.py
+tabus/doorbell.py
+tabus/doorbell_poll.py
+tabus/lang.py
+tabus/nodekey.py
+tabus/paths.py
+tabus/route_capture.py
+tabus/sent.py
+tabus/tac_search.py
+tabus/locales/en.json

tabc-0.1.0/tabc.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tabc-0.1.0/tabc.egg-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+tabc = tabus.cli:main
+tabd = tabus.daemon:main
+tabm = tabus.admin:main

tabc-0.1.0/tabc.egg-info/requires.txt

@@ -0,0 +1 @@
+cryptography>=41

tabc-0.1.0/tabc.egg-info/top_level.txt

@@ -0,0 +1 @@
+tabus

tabc-0.1.0/tabus/__init__.py

@@ -0,0 +1,35 @@
+"""tabus — a message bus between sessions on one machine.
+
+The bus itself lives in `tabus.bus`. This module re-exports it so that
+`import tabus` followed by `tabus.bus_send(...)` keeps meaning what it always
+meant: before the package layout, `tabus` *was* that module, and twenty-seven
+call sites are written that way. Re-exporting keeps the public surface identical
+while the files underneath get a shape a package can have.
+
+  tabus.bus         the store and its operations
+  tabus.cli         the `tabc` command line
+  tabus.daemon      the local HTTP daemon
+  tabus.doorbell    the notifier
+  tabus.nodekey     ed25519 signing keys, one per node
+  tabus.lang        the message catalogue
+  tabus.paths       where this installation keeps its state
+
+🔴 `from .bus import *` rather than a hand-listed set of names. The bus module
+defines what is public; restating that list here would be a second copy of it,
+and the two would drift the first time someone added a function to one and not
+the other. `bus` carries no `__all__`, so this takes its module-level names that
+do not begin with an underscore — the same rule a reader would apply by eye.
+"""
+
+from .bus import *  # noqa: F401,F403
+from . import bus  # noqa: F401  — also reachable by its own name
+from . import paths  # noqa: F401
+
+# 🔴 Re-export copies references; it does not alias the module. Reading
+#    `tabus.bus_send` and `tabus.bus.bus_send` gives the same function, but
+#    *assigning* `tabus.bus_send = f` rebinds the name here only — callers inside
+#    tabus.bus look their globals up in their own module and never see it. Code
+#    that replaces a function (a test with a stub, a caller installing a policy)
+#    must target `tabus.bus`. The read path being identical is what makes this
+#    easy to get wrong, so it is stated rather than left to be discovered.
+__version__ = bus.__version__ if hasattr(bus, "__version__") else "0"

tabc-0.1.0/tabus/admin.py

@@ -0,0 +1,68 @@
+"""tabm: management command names, reusing the existing signed request handlers.
+
+This command split is not an authorization boundary. Key recovery alone is
+local-only; disable/enable/purge retain the daemon's existing authorization.
+"""
+
+from argparse import Namespace
+
+from . import cli
+
+
+def change_node(a):
+    args = Namespace(node=a.target, actor=a.node, by=a.by,
+                     purge=a.cmd == "purge", yes=getattr(a, "yes", False))
+    if a.cmd == "enable":
+        cli.fn_restore(args)
+    else:
+        cli.fn_rm(args)
+
+
+def rotate_key(a):
+    # Local key recovery deliberately has no HTTP equivalent.
+    from .bus import cmd_rotate_key
+
+    cmd_rotate_key(a)
+
+
+def commands():
+    specs = {
+        "config": (cli.fn_config, "read or set the local owner email", [
+            (("--email",), dict(default=None)),
+        ]),
+        "list": (cli.fn_who, "list active nodes and pending counts", [
+            (("--node",), dict(required=True, help="acting node")),
+        ]),
+        "rotate-key": (rotate_key, "local-only public key recovery; not a remote request", [
+            (("node",), dict(help="target node")),
+            (("pubkey",), dict(help="replacement public key")),
+            (("--by",), dict(required=True, help="operator recorded in the audit")),
+        ]),
+    }
+    for action, description in (
+        ("disable", "disable a node, retaining its history"),
+        ("enable", "enable a previously disabled node"),
+        ("purge", "permanently delete a node only if it has no history"),
+    ):
+        args = [
+            (("--node",), dict(required=True, help="acting node signing this request")),
+            (("--target",), dict(required=True, help="node being changed")),
+            (("--by",), dict(default=None, help="audit label, not authentication")),
+        ]
+        if action != "enable":
+            args.append((("--yes",), dict(action="store_true", help="confirm the operation")))
+        specs[action] = (change_node, description, args)
+    return specs
+
+
+def build_parser():
+    return cli.build_parser(prog="tabm", commands=commands())
+
+
+def main():
+    args = build_parser().parse_args()
+    commands()[args.cmd][0](args)
+
+
+if __name__ == "__main__":
+    main()