answering-machine 0.0.1__tar.gz

answering_machine-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexander Fedotov
+
+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.

answering_machine-0.0.1/MANIFEST.in

@@ -0,0 +1 @@
+include src/answering_machine/*.yaml

answering_machine-0.0.1/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: answering-machine
+Version: 0.0.1
+Summary: Machine description
+Author-email: Machina Ratiocinatrix <machina.ratio@gmail.com>
+Project-URL: Homepage, https://github.com/org_name/answering_machine
+Project-URL: Bug Tracker, https://github.com/org_name/answering_machine/issues
+Keywords: answering-machine
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: electroid>=0.0.16
+Requires-Dist: PyGithub>=2.6.0
+Requires-Dist: PyYAML>=6.0.1
+Requires-Dist: urllib3>=2.0.4
+Requires-Dist: requests>=2.32.3
+Requires-Dist: click>=8.3.0
+Dynamic: license-file
+
+# Answering Machine
+A machine that answers questions.
+<pre>
+  pip install answering-machine
+</pre>
+Then:
+```Python
+  # Python
+  import answering_machine
+```
+Or:
+<pre>
+  uvx answering-machine [ARGUMENT] [OPTION]
+</pre>

answering_machine-0.0.1/README.md

@@ -0,0 +1,14 @@
+# Answering Machine
+A machine that answers questions.
+<pre>
+  pip install answering-machine
+</pre>
+Then:
+```Python
+  # Python
+  import answering_machine
+```
+Or:
+<pre>
+  uvx answering-machine [ARGUMENT] [OPTION]
+</pre>

answering_machine-0.0.1/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=67.0"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "answering-machine"
+version = "0.0.1"
+authors = [
+    {name="Machina Ratiocinatrix", email="machina.ratio@gmail.com"},
+]
+description = "Machine description"
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+]
+
+keywords = ["answering-machine"]
+
+dependencies = [
+    "electroid >= 0.0.16",
+    "PyGithub >= 2.6.0",
+    "PyYAML >= 6.0.1",
+    "urllib3 >= 2.0.4",
+    "requests >= 2.32.3",
+    "click >= 8.3.0"
+]
+
+[project.scripts]
+answering-machine = "answering_machine.cli:main"
+
+[project.urls]
+"Homepage" = "https://github.com/org_name/answering_machine"
+"Bug Tracker" = "https://github.com/org_name/answering_machine/issues"

answering_machine-0.0.1/setup.cfg

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

answering_machine-0.0.1/src/answering_machine/__init__.py

@@ -0,0 +1,15 @@
+# -*- coding: utf-8 -*-
+# Python
+
+"""Copyright (c) Alexander Fedotov.
+This source code is licensed under the license found in the
+LICENSE file in the root directory of this source tree.
+"""
+from .machine import machine
+from .githf import connect_to_repo, read_file
+
+__all__ = [
+    'machine',
+    'connect_to_repo',
+    'read_file'
+]

answering_machine-0.0.1/src/answering_machine/cli.py

@@ -0,0 +1,98 @@
+# -*- coding: utf-8 -*-
+# Python
+
+"""Copyright (c) Alexander Fedotov.
+This source code is licensed under the license found in the
+LICENSE file in the root directory of this source tree.
+"""
+import os
+import sys
+import json
+import click
+
+
+@click.command()
+@click.option('--PROVIDER_API_KEY', envvar='PROVIDER_API_KEY',
+              default='', help='Language Model API provider key.')
+@click.option('--GITHUB_TOKEN', envvar='GITHUB_TOKEN',
+              default='', help='GitHub API token for private repo access.')
+@click.option('--mode', type=click.Choice(['single', 'daemon']),
+              default='single',
+              help='single: one-shot stdin→stdout. '
+                   'interactive: line-delimited JSON loop.')
+def main(provider_api_key, github_token, mode):
+    """Generalizing-Machine: an AI agent communicating via stdin/stdout.
+
+    In 'single' mode (default): reads a full JSON array from stdin,
+    responds once, and exits.
+
+    In 'interactive' mode: reads one JSON line at a time from stdin,
+    responds with one JSON line on stdout, and loops until EOF.
+    """
+    # Set environment variables so electroid and githf pick them up
+    if provider_api_key:
+        os.environ['PROVIDER_API_KEY'] = provider_api_key
+    if github_token:
+        os.environ['GITHUB_TOKEN'] = github_token
+
+    from .machine import machine
+
+    if mode == 'daemon':
+        _run_daemon(machine)
+    else:
+        _run_single(machine)
+
+
+def _run_single(machine):
+    """One-shot mode: read full JSON from stdin, respond, exit."""
+    try:
+        messages = json.load(sys.stdin)
+    except json.JSONDecodeError as e:
+        print(f"Error: invalid JSON on stdin: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    if not isinstance(messages, list):
+        print("Error: stdin must contain a JSON array of messages.",
+              file=sys.stderr)
+        sys.exit(1)
+
+    text, thoughts = machine(messages)
+    json.dump([text, thoughts], sys.stdout)
+
+
+def _run_daemon(machine):
+    """Daemon: line-delimited JSON loop.
+
+    Each line on stdin is a JSON array of messages.
+    Each response is a JSON array [text, thoughts] followed by newline.
+    Loops until EOF on stdin.
+    """
+    print("Generalizing-Machine daemon ready.", file=sys.stderr)
+    try:
+        # Loop blocks until input is available on stdin
+        for line in sys.stdin:
+            line = line.strip()
+            if not line:
+                continue
+
+            try:
+                messages = json.loads(line)
+            except json.JSONDecodeError as e:
+                print(f"Error: invalid JSON: {e}", file=sys.stderr)
+                continue
+
+            if not isinstance(messages, list):
+                print("Error: expected a JSON array of messages.",
+                      file=sys.stderr)
+                continue
+
+            text, thoughts = machine(messages)
+            json.dump([text, thoughts], sys.stdout)
+            sys.stdout.write('\n')
+            sys.stdout.flush()
+    except KeyboardInterrupt:
+        sys.exit(0)
+
+
+if __name__ == '__main__':
+    main()

answering_machine-0.0.1/src/answering_machine/githf.py

@@ -0,0 +1,97 @@
+# -*- coding: utf-8 -*-
+# Python
+
+"""Copyright (c) Alexander Fedotov.
+This source code is licensed under the license found in the
+LICENSE file in the root directory of this source tree.
+"""
+from os import environ
+from github import Github, UnknownObjectException
+from urllib3 import disable_warnings
+
+
+github_token    = environ.get('GITHUB_TOKEN', '')
+github_name     = environ.get('GITHUB_NAME', '')
+github_email    = environ.get('GITHUB_EMAIL', '')
+
+# The useless urllib3 warning is too maddening for an ordinary human being.
+disable_warnings()
+
+
+# Repo
+def connect_to_repo(organization=None,
+                   repository_name=None,
+                   private=False):
+    """
+    Establish a connection with a GitHub repository.
+
+    Args:
+        organization (str, optional): The name of the organization. If not provided,
+            the repository is assumed to be owned by the authenticated user.
+        repository_name (str): The name of the repository.
+        private (bool, optional): Whether the repository is private. Defaults to False.
+
+    Returns:
+        github.Repository.Repository: The GitHub repository object if the connection is successful.
+        None: If the connection fails.
+
+    Raises:
+        github.UnknownObjectException: If the repository does not exist.
+
+    Note:
+        The function requires the following environment variables to be set:
+        - GITHUB_TOKEN: The personal access token for authentication.
+        - GITHUB_NAME: The name of the authenticated user.
+        - GITHUB_EMAIL: The email of the authenticated user.
+
+    """
+
+    gh = Github(github_token, verify=False)
+    if organization:
+        org = gh.get_organization(organization)
+        try:
+            repo = org.get_repo(f'{repository_name}')
+        except UnknownObjectException:
+            # print('Can not connect YOU to this repo in this organization')
+            repo = None
+        return repo
+    else:
+        user = gh.get_user()
+        try:
+            repo = user.get_repo(repository_name)
+        except UnknownObjectException:
+            # print('Can not connect YOU to this repo')
+            repo = None
+        return repo
+
+
+def read_file(repository,
+              file_path):
+    """
+    Read the contents of a file in a GitHub repository.
+
+    Args:
+        repository (github.Repository.Repository): The GitHub repository object.
+        file_path (str): The path to the file in the repository, formatted as
+            'directory_in_repo/subdirectory/file.ext'.
+
+    Returns:
+        str: The contents of the file as a string. If the file does not exist, an empty string is returned.
+
+    Raises:
+        github.UnknownObjectException: If the file does not exist in the repository.
+
+    Note:
+        This function assumes that the repository object has already been authenticated and connected.
+    """
+    try:
+        # Get the file if it exists
+        ingested_file = repository.get_contents(file_path)
+        content = ingested_file.decoded_content.decode("utf-8")
+
+    except UnknownObjectException:
+        # The file doesn't exist
+        # print('The file does not exist')
+        content = ''
+
+    return content

answering_machine-0.0.1/src/answering_machine/machina.yaml

@@ -0,0 +1,3 @@
+# Copyright (c) Alexander Fedotov, 2026. All rights reserved.
+name: answering-machine
+description: You are a Answering-Machine.

answering_machine-0.0.1/src/answering_machine/machine.py

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+# Python
+
+"""Copyright (c) Alexander Fedotov.
+This source code is licensed under the license found in the
+LICENSE file in the root directory of this source tree.
+"""
+import os
+import sys
+import yaml
+from . import githf  # from .
+
+# Constants for the private GitHub repo holding the system prompt
+MACHINE_ORGANIZATION_NAME = 'answering-machine'
+PRIVATE_REPO_WITH_TEXT = 'answering_machine'
+SYSTEM_PROMPT_FILE = 'machina.yaml'
+
+
+def _fetch_instructions():
+    """Retrieve the system prompt from a private GitHub repo.
+    Falls back to the local machina.yaml if GitHub is unreachable.
+    Returns the 'description' field from the YAML as the system prompt string.
+    """
+    try:
+        repo = githf.connect_to_repo(
+            organization=MACHINE_ORGANIZATION_NAME,
+            repository_name=PRIVATE_REPO_WITH_TEXT,
+            private=True
+        )
+        raw_yaml = githf.read_file(
+            repository=repo,
+            file_path=SYSTEM_PROMPT_FILE
+        )
+    except Exception as e:
+        print(f"Warning: could not fetch prompt from GitHub: {e}",
+              file=sys.stderr)
+        local_path = os.path.join(os.path.dirname(__file__), 'machina.yaml')
+        with open(local_path, 'r') as f:
+            raw_yaml = f.read()
+
+    parsed = yaml.safe_load(raw_yaml)
+    return parsed.get('description', 'You are a helpful assistant.')
+
+
+def machine(messages):
+    """Core agent logic.
+
+    1. Fetches the system prompt from a private GitHub repo.
+    2. Calls Anthropic via electroid.cloud() with the messages.
+    3. Returns (text, thoughts) tuple.
+    """
+    # Fetch the confidential system prompt
+    system_prompt = _fetch_instructions()
+    # print(f"System prompt loaded ({len(system_prompt)} chars).", file=sys.stderr)
+
+    # Import electroid here (after env vars have been set by cli.py)
+    import electroid
+
+    # Call the Anthropic API via electroid
+    text, thoughts = electroid.cloud(
+        messages=messages,
+        system=system_prompt,
+        max_tokens=16000
+    )
+
+    return text, thoughts
+
+
+if __name__ == '__main__':
+    machine([])

answering_machine-0.0.1/src/answering_machine.egg-info/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: answering-machine
+Version: 0.0.1
+Summary: Machine description
+Author-email: Machina Ratiocinatrix <machina.ratio@gmail.com>
+Project-URL: Homepage, https://github.com/org_name/answering_machine
+Project-URL: Bug Tracker, https://github.com/org_name/answering_machine/issues
+Keywords: answering-machine
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: electroid>=0.0.16
+Requires-Dist: PyGithub>=2.6.0
+Requires-Dist: PyYAML>=6.0.1
+Requires-Dist: urllib3>=2.0.4
+Requires-Dist: requests>=2.32.3
+Requires-Dist: click>=8.3.0
+Dynamic: license-file
+
+# Answering Machine
+A machine that answers questions.
+<pre>
+  pip install answering-machine
+</pre>
+Then:
+```Python
+  # Python
+  import answering_machine
+```
+Or:
+<pre>
+  uvx answering-machine [ARGUMENT] [OPTION]
+</pre>

answering_machine-0.0.1/src/answering_machine.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+src/answering_machine/__init__.py
+src/answering_machine/cli.py
+src/answering_machine/githf.py
+src/answering_machine/machina.yaml
+src/answering_machine/machine.py
+src/answering_machine.egg-info/PKG-INFO
+src/answering_machine.egg-info/SOURCES.txt
+src/answering_machine.egg-info/dependency_links.txt
+src/answering_machine.egg-info/entry_points.txt
+src/answering_machine.egg-info/requires.txt
+src/answering_machine.egg-info/top_level.txt

answering_machine-0.0.1/src/answering_machine.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

answering_machine-0.0.1/src/answering_machine.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+answering-machine = answering_machine.cli:main

answering_machine-0.0.1/src/answering_machine.egg-info/requires.txt

@@ -0,0 +1,6 @@
+electroid>=0.0.16
+PyGithub>=2.6.0
+PyYAML>=6.0.1
+urllib3>=2.0.4
+requests>=2.32.3
+click>=8.3.0

answering_machine-0.0.1/src/answering_machine.egg-info/top_level.txt

@@ -0,0 +1 @@
+answering_machine