induscode 0.1.0__py3-none-any.whl

induscode/__init__.py

@@ -0,0 +1,56 @@
+"""induscode — terminal-first AI coding agent on the indusagi framework.
+
+Python rebuild of the TS ``indusagi-coding-agent`` (lineage v0.1.62). This is
+the namespace barrel — the analogue of the TS ``src/index.ts``, which
+``export * as <subsystem>``-s every subsystem package plus ``VERSION``.
+
+Each subsystem is exposed as a *lazy* namespace attribute via PEP 562 module
+``__getattr__`` (mirroring the framework's ``indusagi/__init__.py``): ``import
+induscode`` stays cheap and side-effect-free, and the Textual-heavy console
+shell is only imported when ``induscode.console`` is first touched. The
+terminal binary is ``entry.py`` (the ``indus`` / ``indusagi`` bin); this barrel
+exists for embedding and testing.
+"""
+
+from induscode.workspace import VERSION
+
+#: Single-sourced from package metadata (see ``workspace/brand.py``).
+__version__ = VERSION
+
+#: Lazy namespace re-exports — the Python analogue of the TS ``src/index.ts``
+#: ``export * as <name> from "./<dir>"`` block. Keyed by the public attribute
+#: name (snake_case), valued by the subsystem package name under ``induscode``.
+#: Lazy so ``import induscode`` does not eagerly pull the Textual console.
+_SUBSYSTEMS = {
+    "workspace": "workspace",
+    "conductor": "conductor",
+    "runtime_bridge": "runtime_bridge",
+    "capability_deck": "capability_deck",
+    "addons": "addons",
+    "briefing": "briefing",
+    "insight": "insight",
+    "window_budget": "window_budget",
+    "transcript_export": "transcript_export",
+    "boot": "boot",
+    "launch": "launch",
+    "settings": "settings",
+    "sessions": "sessions",
+    "channels": "channels",
+    "console": "console",
+    "console_slash": "console_slash",
+    "kit": "kit",
+}
+
+__all__ = ["VERSION", "__version__", *sorted(_SUBSYSTEMS)]
+
+
+def __getattr__(name: str):  # PEP 562 lazy namespace re-exports
+    if name in _SUBSYSTEMS:
+        import importlib
+
+        return importlib.import_module(f"induscode.{_SUBSYSTEMS[name]}")
+    raise AttributeError(f"module 'induscode' has no attribute {name!r}")
+
+
+def __dir__() -> list[str]:
+    return sorted([*globals(), *_SUBSYSTEMS])

induscode/addons/__init__.py

@@ -0,0 +1,176 @@
+"""Addons subsystem — public barrel.
+
+Re-exports the FROZEN third-party customization contract: the
+:class:`AddonManifest` an addon module provides and the :class:`AddonSurface`
+its ``register`` entry point receives, the colon-named :data:`HookEvent`
+taxonomy with its observe/transform/gate :data:`HookHandler` middleware and
+the :class:`EventDispatcher` that runs them, the tool-boundary
+:class:`ToolInterceptor` stages and the :class:`InterceptorChain` pipeline
+that folds them around a tool execution, the capabilities an addon
+contributes (:data:`AddonTool`, :class:`AddonCommand`), the injectable
+:class:`ModuleLoader` + :class:`AddonDiscovery` loading seam, and the typed
+:class:`AddonFault`.
+
+Behavior modules:
+
+- ``loader`` — the importlib-backed :class:`ModuleLoader` (the TS jiti
+  sandbox collapses: Python addons are ``.py`` and ``import indusagi.*``
+  just works), plus the verbatim path-hygiene helpers
+  (:func:`scrub_invisible`, :func:`expand_path`, :func:`resolve_path`).
+- ``manifest`` — scan a ``.indus/addons`` directory for entry modules
+  (``*.py`` files and packages holding ``__init__.py``) and fold an
+  :class:`AddonDiscovery` config into id-stamped :class:`AddonSource`
+  records.
+- ``dispatch`` — the unified :class:`AddonEventDispatcher` (observe /
+  transform / gate) and the tool-boundary :class:`AddonInterceptorChain`,
+  plus the :func:`subscription` / :func:`interceptor` minters.
+- ``surface`` — the per-addon recording :class:`AddonSurface` the host hands
+  to an addon's ``register``.
+- ``host`` — the assembly point: discover + load (injectable loader),
+  register each addon against a fresh surface, fold every
+  :class:`RegisteredManifest` into one registry, and wire the dispatch
+  engine + interceptor chain + collected commands/tools.
+
+Consumers import the addon surface from ``induscode.addons`` rather than
+reaching into individual modules.
+"""
+
+from __future__ import annotations
+
+from .contract import (
+    ADDONS_DIR,
+    BUNDLED_NAMESPACES,
+    AddonCommand,
+    AddonDiscovery,
+    AddonFault,
+    AddonFaultKind,
+    AddonFaultListener,
+    AddonId,
+    AddonManifest,
+    AddonSource,
+    AddonSurface,
+    AddonTool,
+    AgentMessage,
+    AgentTool,
+    AgentToolResult,
+    ArgsRewrite,
+    BundledNamespace,
+    CommandContext,
+    CommandRun,
+    CommandSpec,
+    Component,
+    DispatchOutcome,
+    EnterFn,
+    EnterOutcome,
+    EventDispatcher,
+    EventSubscription,
+    ExecOutcome,
+    ExecuteFn,
+    ExitFn,
+    ExitOutcome,
+    FrameworkHandles,
+    GateDecision,
+    GateHandler,
+    HookEvent,
+    HookHandler,
+    HookKind,
+    InterceptorChain,
+    InterceptorStage,
+    InterceptResult,
+    KeyId,
+    Model,
+    ModuleLoader,
+    ObserveHandler,
+    RegisteredManifest,
+    Schema,
+    ThinkingLevel,
+    ToolEnterContext,
+    ToolExitContext,
+    ToolInterceptor,
+    TransformHandler,
+    addon_fault,
+    addon_id,
+    empty_manifest,
+)
+from .dispatch import (
+    AddonEventDispatcher,
+    AddonInterceptorChain,
+    interceptor,
+    subscription,
+)
+from .host import AddonHost, AddonRegistry, AddonSurfaceBundle, create_addon_host
+from .loader import create_module_loader, expand_path, resolve_path, scrub_invisible
+from .manifest import discover_addons, discover_sources
+from .surface import RecordingSurface, create_surface
+
+__all__ = [
+    "ADDONS_DIR",
+    "AddonCommand",
+    "AddonDiscovery",
+    "AddonEventDispatcher",
+    "AddonFault",
+    "AddonFaultKind",
+    "AddonFaultListener",
+    "AddonHost",
+    "AddonId",
+    "AddonInterceptorChain",
+    "AddonManifest",
+    "AddonRegistry",
+    "AddonSource",
+    "AddonSurface",
+    "AddonSurfaceBundle",
+    "AddonTool",
+    "AgentMessage",
+    "AgentTool",
+    "AgentToolResult",
+    "ArgsRewrite",
+    "BUNDLED_NAMESPACES",
+    "BundledNamespace",
+    "CommandContext",
+    "CommandRun",
+    "CommandSpec",
+    "Component",
+    "DispatchOutcome",
+    "EnterFn",
+    "EnterOutcome",
+    "EventDispatcher",
+    "EventSubscription",
+    "ExecOutcome",
+    "ExecuteFn",
+    "ExitFn",
+    "ExitOutcome",
+    "FrameworkHandles",
+    "GateDecision",
+    "GateHandler",
+    "HookEvent",
+    "HookHandler",
+    "HookKind",
+    "InterceptResult",
+    "InterceptorChain",
+    "InterceptorStage",
+    "KeyId",
+    "Model",
+    "ModuleLoader",
+    "ObserveHandler",
+    "RecordingSurface",
+    "RegisteredManifest",
+    "Schema",
+    "ThinkingLevel",
+    "ToolEnterContext",
+    "ToolExitContext",
+    "ToolInterceptor",
+    "TransformHandler",
+    "addon_fault",
+    "addon_id",
+    "create_addon_host",
+    "create_module_loader",
+    "create_surface",
+    "discover_addons",
+    "discover_sources",
+    "empty_manifest",
+    "expand_path",
+    "interceptor",
+    "resolve_path",
+    "scrub_invisible",
+    "subscription",
+]