alpi-agent 0.2.93__tar.gz

alpi_agent-0.2.93/LICENSE

@@ -0,0 +1,112 @@
+Business Source License 1.1
+
+Licensor:             Satoshi Ltd. (Hong Kong SAR)
+Licensed Work:        alpi — the source code in this repository at the
+                      time the Licensed Work is accessed.
+                      The Licensed Work is © 2026 Satoshi Ltd.
+Additional Use Grant: You may make production use of the Licensed Work,
+                      provided your use does not include offering the
+                      Licensed Work, or any derivative work based on it,
+                      to third parties on a hosted, embedded, or
+                      managed-service basis. Natural persons using the
+                      Licensed Work on machines they personally control
+                      are covered by this grant for all personal,
+                      research, and non-commercial purposes. Legal
+                      entities (companies, organisations, partnerships,
+                      trusts, government bodies) are covered only for
+                      internal evaluation, development, and
+                      experimentation — production deployment by a
+                      legal entity requires a commercial licence from
+                      the Licensor.
+Change Date:          2030-04-23
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the
+Licensed Work, please contact: info@satoshi-ltd.com
+
+---
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create
+derivative works, redistribute, and make non-production use of the
+Licensed Work. The Licensor may make an Additional Use Grant, above,
+permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first
+publicly available distribution of a specific version of the Licensed
+Work under this Licence, whichever comes first, the Licensor hereby
+grants you rights under the terms of the Change Licence, and the
+rights granted in the paragraph above terminate.
+
+If your use of the Licensed Work does not comply with the
+requirements currently in effect as described in this Licence, you
+must purchase a commercial licence from the Licensor, its affiliated
+entities, or authorised resellers, or you must refrain from using the
+Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative
+works of the Licensed Work, are subject to this Licence. This Licence
+applies separately for each version of the Licensed Work and the
+Change Date may vary for each version of the Licensed Work released
+by Licensor.
+
+You must conspicuously display this Licence on each original or
+modified copy of the Licensed Work. If you receive the Licensed Work
+in original or modified form from a third party, the terms and
+conditions set forth in this Licence apply to your use of that work.
+
+Any use of the Licensed Work in violation of this Licence will
+automatically terminate your rights under this Licence for the
+current and all other versions of the Licensed Work.
+
+This Licence does not grant you any right in any trademark or logo
+of Licensor or its affiliates (provided that you may use a trademark
+or logo of Licensor as expressly required by this Licence).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS
+PROVIDED ON AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL
+WARRANTIES AND CONDITIONS, EXPRESS OR IMPLIED, INCLUDING (WITHOUT
+LIMITATION) WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND
+FITNESS FOR A PARTICULAR PURPOSE.
+
+MariaDB hereby grants you permission to use this Licence's text to
+licence your works, and to refer to it using the trademark
+"Business Source Licence", as long as you comply with the Covenants
+of Licensor below.
+
+---
+
+Covenants of Licensor
+
+In consideration of the right to use this Licence's text and the
+"Business Source Licence" name and trademark, Licensor covenants to
+MariaDB, and to all other recipients of the Licensed Work to be
+provided by Licensor:
+
+1. To specify as the Change Licence the GPL Version 2.0 or any
+   later version, or a licence that is compatible with GPL
+   Version 2.0 or a later version, where "compatible" means that
+   software provided under the Change Licence can be included in
+   a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licences
+   without limitation.
+
+2. To either: (a) specify an additional grant of rights to end
+   users that is at least as permissive as the rights granted
+   under this Licence on the Change Date, or (b) require that the
+   Licensed Work be released under the Change Licence, and in no
+   event later than the Change Date.
+
+3. To specify a Change Date.
+
+4. Not to modify this Licence in any other way.
+
+---
+
+Notice
+
+The Business Source Licence (this document, or the "Licence") is not
+an Open Source licence. However, the Licensed Work will eventually
+be made available under an Open Source Licence, as stated in this
+Licence.

alpi_agent-0.2.93/PKG-INFO

@@ -0,0 +1,263 @@
+Metadata-Version: 2.4
+Name: alpi-agent
+Version: 0.2.93
+Summary: A profile-based personal AI agent for terminal, messengers, and private ALP networks
+Author: Satoshi Ltd.
+License-Expression: BUSL-1.1
+Project-URL: Homepage, https://alpi.satoshi.ltd
+Project-URL: Repository, https://github.com/satoshi-ltd/alpi
+Project-URL: Issues, https://github.com/satoshi-ltd/alpi/issues
+Project-URL: Changelog, https://github.com/satoshi-ltd/alpi/blob/main/CHANGELOG.md
+Keywords: agent,ai,cli,llm,personal-agent,privacy,agent-to-agent,telegram,imap
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: litellm>=1.50.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: prompt_toolkit>=3.0.43
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: html2text>=2024.2.26
+Requires-Dist: textual>=0.86.0
+Requires-Dist: ddgs>=9.0.0
+Requires-Dist: croniter>=2.0.0
+Requires-Dist: playwright>=1.44
+Requires-Dist: playwright-stealth>=1.0.6
+Requires-Dist: pillow>=10.0
+Requires-Dist: edge-tts>=7.0
+Requires-Dist: faster-whisper>=1.0
+Requires-Dist: cryptography>=42.0
+Requires-Dist: setproctitle>=1.3
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.3.0; extra == "dev"
+Requires-Dist: pip-audit>=2.7; extra == "dev"
+Dynamic: license-file
+
+# alpi
+
+**Your private agent network.**
+
+alpi starts as the agent in your terminal, then grows with you:
+profiles for work, cron, home servers, research, and workgroups with other
+alpis. Each profile owns its memory, keys, model, skills, gateways,
+approvals, and trust boundary. ALP links them across machines without
+a registry, central account, or mandatory cloud.
+
+Bring any model. Keep every key. Run one alpi, or a network that stays
+yours.
+
+## Why alpi exists
+
+Most useful agents eventually become infrastructure: they hold memory,
+touch files, run commands, answer from a phone, wake up on schedules,
+and coordinate work across machines. alpi treats the **profile** as
+the unit of that infrastructure, not the chat.
+
+The design goal is sovereignty:
+
+- **Local-first by default.** State lives under `~/.alpi/` or a named
+  profile. Memory, sessions, skills, keys, logs, and peer lists are
+  files on your machine.
+- **User-owned models.** Fresh profiles ship with no default model.
+  You pick the provider, model, API key, or Ollama server per profile.
+- **Security as product shape.** Shell commands pass a three-tier
+  approval system. Dangerous commands are blocked with no override.
+  Web and email content is treated as hostile data. Skills and MCPs
+  are scanned before install.
+- **Operational UX.** One setup wizard, a live `doctor`, a single
+  per-profile `alpi service` orchestrator (gateway + scheduler + ALP
+  listener on one asyncio loop), merged logs, and cleanup.
+- **Private coordination.** ALP.1 links local profiles, ALP.2 links
+  machines over Noise_XK, and ALP.3 adds shared workgroups. Peers are
+  pinned by Ed25519 identity and governed by fail-closed capabilities.
+  No discovery service, no shared account, no central broker.
+- **Honest provider boundaries.** alpi does not reverse-engineer
+  ChatGPT Plus, Claude Pro, Claude Code, or other first-party
+  subscription clients. If a vendor publishes an official third-party
+  OAuth flow, alpi can adopt it. Until then, users pay per-token API
+  access through their own keys.
+
+## What ships today
+
+The current release ships the full local-to-network shape:
+
+- Textual TUI with streaming replies, slash commands, live tool cards,
+  interrupt, session resume, model switching, and cost/token display.
+- Telegram, IMAP, and Gmail gateways hosted by the unified per-profile
+  service.
+- Inline-learning memory: `USER.md`, `MEMORY.md`, and `AGENT.md`.
+- Live skills under `~/.alpi/skills/<category>/<name>/`, scanner-gated
+  and auto-injected into the system prompt.
+- Multi-provider LLM support through LiteLLM, plus first-class Ollama.
+- Read-only `research(brief, depth)` sub-agent with `quick`, `normal`,
+  and `deep` tiers.
+- Write-capable `delegate` sub-agent for focused file/web/terminal
+  tasks.
+- Cron + one-shot scheduler hosted by the unified service.
+- MCP client for user-configured local MCP servers.
+- ALP.1: intra-machine agent-to-agent links over Unix sockets.
+- ALP.2: inter-machine links over Noise_XK TCP, with per-peer budget
+  and rate-limit enforcement.
+- ALP.3: hub-anchored shared workgroups for multiple alpis and optional
+  human participants.
+- `alpi doctor`, `alpi logs`, one launchd / systemd unit per profile,
+  backup-friendly file layout, and security audit logs.
+
+## Quickstart
+
+```bash
+uv tool install alpi-agent
+alpi setup
+alpi
+alpi doctor
+```
+
+Optional browser support:
+
+```bash
+playwright install chromium
+```
+
+During setup, pick a model, paste the relevant key, and pin a
+workspace. For local-only inference, install Ollama first and add it in
+`alpi setup -> Model`.
+
+Common commands:
+
+```bash
+alpi                         # interactive TUI
+alpi -c                      # resume last session
+alpi -p work                 # use named profile
+alpi chat --once "status?"   # one-shot stdout turn
+
+alpi setup                   # model, gateways, MCPs, sandbox, service
+alpi doctor                  # live health checks
+alpi logs                    # merged profile logs
+
+alpi profile list
+alpi profile create work
+alpi profile remove work
+
+alpi service start|stop|restart|status   # unified per-profile orchestrator
+alpi schedule run-once|fire <job-id>     # operational scheduler verbs
+
+alpi peers key
+alpi peers list
+alpi peers add <id> <pubkey>
+alpi peers ping <id>
+
+alpi workgroup list
+alpi workgroup create <name> --member <peer-id>
+alpi workgroup join <hub-id> <wg_id>
+```
+
+For the first-day walkthrough, see [QUICKSTART.md](QUICKSTART.md).
+
+## Core concepts
+
+**Profiles** are the isolation primitive. A profile is one directory,
+one identity, one model choice, one memory, one skill set, one gateway
+configuration, one schedule surface, and one ALP peer list. The
+default profile lives at `~/.alpi/`; named profiles live under
+`~/.alpi/profiles/<name>/`.
+
+**Memory** is plain Markdown. `USER.md` captures facts about the user,
+`MEMORY.md` captures environment quirks and durable operational facts,
+and `AGENT.md` shapes how alpi should respond. Memory is updated inline
+during conversations; there is no post-session reflection loop.
+
+**Skills** are reusable recipes with a strict directory contract. They
+can include instructions, scripts, references, assets, secrets, and
+state. Mutations go through validation and a security scanner; secrets
+live in either `.env` or a per-skill `secrets/` directory.
+
+**Workspace** is the default root for relative paths, not a fake
+security wall. File tools and terminal can use absolute paths except
+for a sensitive-path denylist. Real workspace-only isolation is the
+opt-in OS sandbox.
+
+**ALP** is the Alpi Link Protocol. Each profile owns an Ed25519 keypair.
+Peers pin pubkeys out of band and grant explicit capabilities such as
+`link.ping`, `link.ask`, and `workgroup.post`. ALP.1 handles same-machine
+profiles over Unix sockets. ALP.2 handles inter-machine links with
+Noise_XK over TCP plus budgets and rate limits. ALP.3 adds
+hub-anchored workgroups.
+
+## Security posture
+
+alpi assumes the LLM is powerful, fallible, and sitting next to user
+credentials. The guardrails are local and layered:
+
+- safe / caution / dangerous command classification;
+- dangerous commands blocked with no config escape hatch;
+- caution commands require interactive approval or configured allowlist;
+- sensitive-path denylist shared across file and terminal posture;
+- SSRF protection on web tools;
+- prompt-injection warnings on fetched web/email content;
+- OSV malware checks before skill or MCP install;
+- optional macOS/Linux OS sandbox per profile;
+- `approval.log` and `agent.log` for audit.
+
+See [docs/SECURITY.md](docs/SECURITY.md) for the full model.
+
+## Documentation
+
+- [QUICKSTART.md](QUICKSTART.md) — install, model, workspace, first chat,
+  gateways, profiles, ALP, doctor.
+- [docs/PROFILES.md](docs/PROFILES.md) — per-profile identity,
+  isolation, state, memory, skills, peers, services.
+- [docs/ALP.md](docs/ALP.md) — wire protocol, identity, signatures,
+  transports, methods, errors, workgroups.
+- [docs/SECURITY.md](docs/SECURITY.md) — threat model, approval gate,
+  sandbox, injection/SSRF/path guards, dependency posture.
+- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — implementation
+  reference for contributors and agents reading the codebase.
+- [docs/CONFIG.md](docs/CONFIG.md) — every YAML key and when it takes
+  effect.
+- [docs/SKILLS.md](docs/SKILLS.md) — skill directory contract,
+  frontmatter, secrets, scanner, validation.
+- [docs/MODELS.md](docs/MODELS.md) — model recommendations for
+  tool-heavy agent use.
+- [docs/DEPLOYMENTS.md](docs/DEPLOYMENTS.md) — laptop, home server,
+  multi-profile, multi-device, family/team, enterprise shapes.
+- [docs/OPERATIONS.md](docs/OPERATIONS.md) — services, logs, upgrades,
+  backup/restore, monitoring, disaster recovery.
+- [docs/ROADMAP.md](docs/ROADMAP.md) — open work and rejected ideas.
+
+## Tests
+
+```bash
+uv run --with pytest pytest -q
+uv run --with pytest pytest --llm
+```
+
+## License
+
+alpi is source-available from day one. The agent core is published by
+[Satoshi Ltd.](https://www.satoshi-ltd.com/) under the
+[Business Source Licence 1.1](LICENSE), with a scheduled conversion to
+Apache 2.0 on 2030-04-23, or four years after each version's first
+public release, whichever comes first.
+
+Personal use, research, evaluation, and non-production deployments are
+free. Commercial production deployments, or offering alpi as a hosted,
+embedded, or managed service, are covered by a Satoshi Ltd. commercial
+licence.
+
+Commercial enquiries: **info@satoshi-ltd.com**.

alpi_agent-0.2.93/README.md

@@ -0,0 +1,212 @@
+# alpi
+
+**Your private agent network.**
+
+alpi starts as the agent in your terminal, then grows with you:
+profiles for work, cron, home servers, research, and workgroups with other
+alpis. Each profile owns its memory, keys, model, skills, gateways,
+approvals, and trust boundary. ALP links them across machines without
+a registry, central account, or mandatory cloud.
+
+Bring any model. Keep every key. Run one alpi, or a network that stays
+yours.
+
+## Why alpi exists
+
+Most useful agents eventually become infrastructure: they hold memory,
+touch files, run commands, answer from a phone, wake up on schedules,
+and coordinate work across machines. alpi treats the **profile** as
+the unit of that infrastructure, not the chat.
+
+The design goal is sovereignty:
+
+- **Local-first by default.** State lives under `~/.alpi/` or a named
+  profile. Memory, sessions, skills, keys, logs, and peer lists are
+  files on your machine.
+- **User-owned models.** Fresh profiles ship with no default model.
+  You pick the provider, model, API key, or Ollama server per profile.
+- **Security as product shape.** Shell commands pass a three-tier
+  approval system. Dangerous commands are blocked with no override.
+  Web and email content is treated as hostile data. Skills and MCPs
+  are scanned before install.
+- **Operational UX.** One setup wizard, a live `doctor`, a single
+  per-profile `alpi service` orchestrator (gateway + scheduler + ALP
+  listener on one asyncio loop), merged logs, and cleanup.
+- **Private coordination.** ALP.1 links local profiles, ALP.2 links
+  machines over Noise_XK, and ALP.3 adds shared workgroups. Peers are
+  pinned by Ed25519 identity and governed by fail-closed capabilities.
+  No discovery service, no shared account, no central broker.
+- **Honest provider boundaries.** alpi does not reverse-engineer
+  ChatGPT Plus, Claude Pro, Claude Code, or other first-party
+  subscription clients. If a vendor publishes an official third-party
+  OAuth flow, alpi can adopt it. Until then, users pay per-token API
+  access through their own keys.
+
+## What ships today
+
+The current release ships the full local-to-network shape:
+
+- Textual TUI with streaming replies, slash commands, live tool cards,
+  interrupt, session resume, model switching, and cost/token display.
+- Telegram, IMAP, and Gmail gateways hosted by the unified per-profile
+  service.
+- Inline-learning memory: `USER.md`, `MEMORY.md`, and `AGENT.md`.
+- Live skills under `~/.alpi/skills/<category>/<name>/`, scanner-gated
+  and auto-injected into the system prompt.
+- Multi-provider LLM support through LiteLLM, plus first-class Ollama.
+- Read-only `research(brief, depth)` sub-agent with `quick`, `normal`,
+  and `deep` tiers.
+- Write-capable `delegate` sub-agent for focused file/web/terminal
+  tasks.
+- Cron + one-shot scheduler hosted by the unified service.
+- MCP client for user-configured local MCP servers.
+- ALP.1: intra-machine agent-to-agent links over Unix sockets.
+- ALP.2: inter-machine links over Noise_XK TCP, with per-peer budget
+  and rate-limit enforcement.
+- ALP.3: hub-anchored shared workgroups for multiple alpis and optional
+  human participants.
+- `alpi doctor`, `alpi logs`, one launchd / systemd unit per profile,
+  backup-friendly file layout, and security audit logs.
+
+## Quickstart
+
+```bash
+uv tool install alpi-agent
+alpi setup
+alpi
+alpi doctor
+```
+
+Optional browser support:
+
+```bash
+playwright install chromium
+```
+
+During setup, pick a model, paste the relevant key, and pin a
+workspace. For local-only inference, install Ollama first and add it in
+`alpi setup -> Model`.
+
+Common commands:
+
+```bash
+alpi                         # interactive TUI
+alpi -c                      # resume last session
+alpi -p work                 # use named profile
+alpi chat --once "status?"   # one-shot stdout turn
+
+alpi setup                   # model, gateways, MCPs, sandbox, service
+alpi doctor                  # live health checks
+alpi logs                    # merged profile logs
+
+alpi profile list
+alpi profile create work
+alpi profile remove work
+
+alpi service start|stop|restart|status   # unified per-profile orchestrator
+alpi schedule run-once|fire <job-id>     # operational scheduler verbs
+
+alpi peers key
+alpi peers list
+alpi peers add <id> <pubkey>
+alpi peers ping <id>
+
+alpi workgroup list
+alpi workgroup create <name> --member <peer-id>
+alpi workgroup join <hub-id> <wg_id>
+```
+
+For the first-day walkthrough, see [QUICKSTART.md](QUICKSTART.md).
+
+## Core concepts
+
+**Profiles** are the isolation primitive. A profile is one directory,
+one identity, one model choice, one memory, one skill set, one gateway
+configuration, one schedule surface, and one ALP peer list. The
+default profile lives at `~/.alpi/`; named profiles live under
+`~/.alpi/profiles/<name>/`.
+
+**Memory** is plain Markdown. `USER.md` captures facts about the user,
+`MEMORY.md` captures environment quirks and durable operational facts,
+and `AGENT.md` shapes how alpi should respond. Memory is updated inline
+during conversations; there is no post-session reflection loop.
+
+**Skills** are reusable recipes with a strict directory contract. They
+can include instructions, scripts, references, assets, secrets, and
+state. Mutations go through validation and a security scanner; secrets
+live in either `.env` or a per-skill `secrets/` directory.
+
+**Workspace** is the default root for relative paths, not a fake
+security wall. File tools and terminal can use absolute paths except
+for a sensitive-path denylist. Real workspace-only isolation is the
+opt-in OS sandbox.
+
+**ALP** is the Alpi Link Protocol. Each profile owns an Ed25519 keypair.
+Peers pin pubkeys out of band and grant explicit capabilities such as
+`link.ping`, `link.ask`, and `workgroup.post`. ALP.1 handles same-machine
+profiles over Unix sockets. ALP.2 handles inter-machine links with
+Noise_XK over TCP plus budgets and rate limits. ALP.3 adds
+hub-anchored workgroups.
+
+## Security posture
+
+alpi assumes the LLM is powerful, fallible, and sitting next to user
+credentials. The guardrails are local and layered:
+
+- safe / caution / dangerous command classification;
+- dangerous commands blocked with no config escape hatch;
+- caution commands require interactive approval or configured allowlist;
+- sensitive-path denylist shared across file and terminal posture;
+- SSRF protection on web tools;
+- prompt-injection warnings on fetched web/email content;
+- OSV malware checks before skill or MCP install;
+- optional macOS/Linux OS sandbox per profile;
+- `approval.log` and `agent.log` for audit.
+
+See [docs/SECURITY.md](docs/SECURITY.md) for the full model.
+
+## Documentation
+
+- [QUICKSTART.md](QUICKSTART.md) — install, model, workspace, first chat,
+  gateways, profiles, ALP, doctor.
+- [docs/PROFILES.md](docs/PROFILES.md) — per-profile identity,
+  isolation, state, memory, skills, peers, services.
+- [docs/ALP.md](docs/ALP.md) — wire protocol, identity, signatures,
+  transports, methods, errors, workgroups.
+- [docs/SECURITY.md](docs/SECURITY.md) — threat model, approval gate,
+  sandbox, injection/SSRF/path guards, dependency posture.
+- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — implementation
+  reference for contributors and agents reading the codebase.
+- [docs/CONFIG.md](docs/CONFIG.md) — every YAML key and when it takes
+  effect.
+- [docs/SKILLS.md](docs/SKILLS.md) — skill directory contract,
+  frontmatter, secrets, scanner, validation.
+- [docs/MODELS.md](docs/MODELS.md) — model recommendations for
+  tool-heavy agent use.
+- [docs/DEPLOYMENTS.md](docs/DEPLOYMENTS.md) — laptop, home server,
+  multi-profile, multi-device, family/team, enterprise shapes.
+- [docs/OPERATIONS.md](docs/OPERATIONS.md) — services, logs, upgrades,
+  backup/restore, monitoring, disaster recovery.
+- [docs/ROADMAP.md](docs/ROADMAP.md) — open work and rejected ideas.
+
+## Tests
+
+```bash
+uv run --with pytest pytest -q
+uv run --with pytest pytest --llm
+```
+
+## License
+
+alpi is source-available from day one. The agent core is published by
+[Satoshi Ltd.](https://www.satoshi-ltd.com/) under the
+[Business Source Licence 1.1](LICENSE), with a scheduled conversion to
+Apache 2.0 on 2030-04-23, or four years after each version's first
+public release, whichever comes first.
+
+Personal use, research, evaluation, and non-production deployments are
+free. Commercial production deployments, or offering alpi as a hosted,
+embedded, or managed service, are covered by a Satoshi Ltd. commercial
+licence.
+
+Commercial enquiries: **info@satoshi-ltd.com**.

alpi_agent-0.2.93/alpi/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.93"

alpi_agent-0.2.93/alpi/__main__.py

@@ -0,0 +1,4 @@
+from alpi.cli import main
+
+if __name__ == "__main__":
+    main()

alpi_agent-0.2.93/alpi/_log.py

@@ -0,0 +1,50 @@
+"""Shared subsystem logging — one rotating file per subsystem in ``~/.alpi/logs/``.
+
+Every subsystem writes to ``{home}/logs/{subsystem}.log`` with the same
+format so ``alpi logs`` can merge them cleanly. The logger is namespaced
+(``alpi.<subsystem>``) and does NOT propagate to the root — it's
+self-contained, so importing this from inside the TUI doesn't leak lines
+into stdout.
+"""
+
+from __future__ import annotations
+
+import logging
+from logging.handlers import RotatingFileHandler
+from pathlib import Path
+
+FORMAT = "%(asctime)s %(levelname)s %(name)s %(message)s"
+MAX_BYTES = 1_000_000
+
+
+def log_dir(home: Path) -> Path:
+    """The canonical logs directory for a profile."""
+    return home / "logs"
+
+
+def log_path(home: Path, subsystem: str) -> Path:
+    return log_dir(home) / f"{subsystem}.log"
+
+
+def get_subsystem_logger(home: Path, subsystem: str) -> logging.Logger:
+    """Return the dedicated logger for ``subsystem``, configured lazily."""
+    name = f"alpi.{subsystem}"
+    logger = logging.getLogger(name)
+    if getattr(logger, "_alpi_configured", False):
+        return logger
+
+    try:
+        d = log_dir(home)
+        d.mkdir(parents=True, exist_ok=True)
+        handler = RotatingFileHandler(
+            d / f"{subsystem}.log", maxBytes=MAX_BYTES, backupCount=0,
+        )
+        handler.setFormatter(logging.Formatter(FORMAT))
+        logger.addHandler(handler)
+    except OSError:
+        pass  # no-op logger — better than crashing if the dir can't be made
+
+    logger.setLevel(logging.INFO)
+    logger.propagate = False
+    logger._alpi_configured = True  # type: ignore[attr-defined]
+    return logger

alpi_agent-0.2.93/alpi/alp/__init__.py

@@ -0,0 +1,18 @@
+"""ALP — Alpi Link Protocol.
+
+Reference implementation of the ALP specification (see
+``docs/ALP.md``). Covers agent-to-agent communication between alpi
+instances: intra-profile on the same machine over a Unix-domain
+socket, inter-machine over Noise_XK-on-TCP, and shared workgroups.
+"""
+
+from __future__ import annotations
+
+PROTOCOL_VERSION = 1
+"""The ALP protocol version this implementation speaks.
+
+Senders tag every envelope with this value. Receivers reject
+messages carrying an unknown version with error ``-32006``. A
+bump is deliberate and lands alongside a changelog entry in
+``docs/ALP.md``.
+"""