agenteng 0.0.1__tar.gz

agenteng-0.0.1/.dockerignore

@@ -0,0 +1,52 @@
+.git
+.github
+.venv
+.venv-docs
+site
+venv
+.cache
+.env
+.env.*
+!.env.example
+__pycache__
+*.pyc
+.pytest_cache
+.ruff_cache
+.mypy_cache
+dist
+build
+.private
+PLAN.md
+RLM-DESIGN.md
+docs/IMPLEMENTATION.md
+.agenteng
+proposal-drafts
+submissions
+participant-access*.txt
+attendees*.csv
+members*.csv
+contacts*.csv
+/draft.json
+/draft.md
+/talk.json
+/talk.md
+/proposal.json
+/proposal.md
+/proposal-*.json
+/proposal-*.md
+*.pem
+*.key
+*.p12
+*.pfx
+*.credentials.json
+service-account*.json
+experiments
+tests
+.aws
+.azure
+.gcloud
+.terraform
+*.tfstate
+*.tfstate.*
+*.sqlite*
+*.db*

agenteng-0.0.1/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.{json,yml,yaml}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

agenteng-0.0.1/.env.example

@@ -0,0 +1,21 @@
+# Default requests use lookup; engine selection is explicit.
+AGENTENG_ENABLE_STANDARD=0
+AGENTENG_ENABLE_RLM=0
+AGENTENG_PUBLIC_URL=https://a2a.agentengineering.world
+# Optional model operations require a server-side token and a configured model.
+# AGENTENG_OPERATOR_TOKEN=
+# AGENTENG_MODEL_API_KEY=
+# AGENTENG_MODEL_BASE_URL=https://api.openai.com/v1
+# AGENTENG_MODEL=
+# AGENTENG_CATALOGUE=/absolute/path/catalogue.json
+AGENTENG_ALLOWED_ORIGINS=https://agentengineering.world
+
+# Single-organizer private intake pilot; default off. Requires persistent private storage.
+AGENTENG_ENABLE_INTAKE=0
+# AGENTENG_INBOX=/persistent/private/agenteng.sqlite3
+# AGENTENG_INTAKE_PRIVACY_NOTICE=Operator-approved notice: recipient, use, deletion contact, retention and backups.
+AGENTENG_INTAKE_RETENTION_DAYS=90
+AGENTENG_INTAKE_CAPACITY=1000
+# AGENTENG_CALLS=/persistent/private/calls.json
+# Client-only credential issued separately for each participant; never commit it.
+# AGENTENG_PARTICIPANT_TOKEN=

agenteng-0.0.1/.gcloudignore

@@ -0,0 +1,5 @@
+# Cloud Build uploads must use the same private/local exclusions as Git.
+.gcloudignore
+.git
+.git/**
+#!include:.gitignore

agenteng-0.0.1/.gitattributes

@@ -0,0 +1,9 @@
+# Keep source, scripts and catalogue bytes consistent across platforms.
+* text=auto eol=lf
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.pdf binary
+*.whl binary

agenteng-0.0.1/.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,36 @@
+name: Bug report
+description: Report an issue with the CLI, catalogue, MCP or A2A behavior.
+title: '[Bug] '
+body:
+  - type: markdown
+    attributes:
+      value: >-
+        Please remove credentials, personal data and private event information.
+        Vulnerabilities belong in private security reporting; see SECURITY.md.
+  - type: input
+    id: version
+    attributes:
+      label: AgentEng version and environment
+      placeholder: '0.0.1; Python 3.12; Linux; CLI / MCP / A2A'
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Minimal steps to reproduce
+      description: Include a redacted command or request, plus the public event ID if relevant.
+    validations:
+      required: true
+  - type: textarea
+    id: result
+    attributes:
+      label: Expected and actual behavior
+    validations:
+      required: true
+  - type: checkboxes
+    id: privacy
+    attributes:
+      label: Public report
+      options:
+        - label: I removed credentials and private/personal information.
+          required: true

agenteng-0.0.1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Private speaker proposal or organizer enquiry
+    url: https://agentengineering.world/#faq
+    about: Contact events@agentengineering.world; keep proposals and contact details out of public issues.

agenteng-0.0.1/.github/ISSUE_TEMPLATE/event_idea.yml

@@ -0,0 +1,56 @@
+name: Public event idea
+description: Discuss a conference topic or workshop idea you want to share publicly.
+title: '[Event idea] '
+body:
+  - type: markdown
+    attributes:
+      value: >-
+        This issue and its edit history are public. Do not include email addresses,
+        private speaker proposals or confidential material. For a private proposal,
+        contact events@agentengineering.world. Discussion is not an event booking,
+        active call for proposals or promise of organizer action.
+  - type: input
+    id: topic
+    attributes:
+      label: Working topic
+      placeholder: 'Practitioner workshop on evaluating agent memory'
+    validations:
+      required: true
+  - type: textarea
+    id: audience
+    attributes:
+      label: Audience and problem
+      description: Who would benefit, and what would they learn or work on?
+    validations:
+      required: true
+  - type: dropdown
+    id: format
+    attributes:
+      label: Possible format
+      options:
+        - Discussion / brainstorming
+        - Practitioner meetup
+        - Workshop
+        - Conference session
+        - Other format described below
+    validations:
+      required: true
+  - type: input
+    id: location
+    attributes:
+      label: Suggested city or online format
+      description: Optional suggestion; no venue or schedule is implied.
+  - type: textarea
+    id: outline
+    attributes:
+      label: Outline and public references
+      description: Optional context, links and alternatives. No personal contact details.
+  - type: checkboxes
+    id: expectations
+    attributes:
+      label: Public discussion and organizer discretion
+      options:
+        - label: I want this idea shared publicly and have removed private information.
+          required: true
+        - label: Submission, comments and interest do not guarantee review, acceptance or an event.
+          required: true

agenteng-0.0.1/.github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,34 @@
+name: Software feature idea
+description: Suggest an improvement to the open-source software.
+title: '[Feature] '
+body:
+  - type: markdown
+    attributes:
+      value: >-
+        Ideas are considered by maintainers, without a promised implementation or timeline.
+        For conference topics, use Public event idea. For private proposals, contact the organizer.
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: Describe the user and concrete workflow.
+    validations:
+      required: true
+  - type: textarea
+    id: approach
+    attributes:
+      label: Suggested behavior and alternatives
+    validations:
+      required: true
+  - type: textarea
+    id: contribute
+    attributes:
+      label: Would you like to help?
+      description: Optional; proposing a feature does not require you to implement it.
+  - type: checkboxes
+    id: expectations
+    attributes:
+      label: Expectations
+      options:
+        - label: This suggestion does not create a commitment to implement it or respond by a deadline.
+          required: true

agenteng-0.0.1/.github/ISSUE_TEMPLATE/tool.yml

@@ -0,0 +1,35 @@
+name: Tool-directory suggestion or correction
+description: Suggest a public tool, corrected link, duplicate merge or discipline tag.
+title: '[Tools] '
+body:
+  - type: markdown
+    attributes:
+      value: >-
+        Provide primary public sources. Listing is not an endorsement or a promise
+        of inclusion, response or a review deadline. Do not share credentials,
+        personal contact details or private speaker proposals here.
+  - type: input
+    id: tool
+    attributes:
+      label: Tool name or existing ID
+    validations:
+      required: true
+  - type: textarea
+    id: change
+    attributes:
+      label: Suggested addition or correction
+      description: Explain the name, links, duplicate or discipline mapping to change.
+    validations:
+      required: true
+  - type: textarea
+    id: sources
+    attributes:
+      label: Primary public references
+      description: Official product documentation, repository or announcement links.
+    validations:
+      required: true
+  - type: input
+    id: affiliation
+    attributes:
+      label: Relevant affiliation
+      description: Disclose whether you maintain, work for or sponsor the project.

agenteng-0.0.1/.github/pull_request_template.md

@@ -0,0 +1,14 @@
+## Change
+
+Describe the problem and resulting behavior. Link the relevant issue if there is one.
+
+## Validation
+
+Describe meaningful checks and any limitations. For docs-only changes, state that.
+
+## Review
+
+- [ ] This contains no credentials, private proposals, attendee/contact data or internal notes.
+- [ ] Public event changes cite their source; unknown details remain unknown.
+- [ ] Optional model/recursion limits and default model-free behavior are preserved.
+- [ ] I agree to the project's contribution license and Code of Conduct.

agenteng-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+"on":
+  push:
+    branches: ['**']
+  pull_request:
+  workflow_call:
+    inputs:
+      source_ref:
+        type: string
+        required: false
+        default: ''
+      release_tag:
+        type: string
+        required: false
+        default: ''
+permissions:
+  contents: read
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ['3.12', '3.13']
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.source_ref || github.sha }}
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: '0.8.0'
+          python-version: ${{ matrix.python }}
+      - run: uv sync --frozen --all-extras
+      - name: Check package and release versions
+        env:
+          RELEASE_TAG: ${{ inputs.release_tag }}
+        run: |
+          if [ -n "$RELEASE_TAG" ]; then
+            uv run --frozen python scripts/check-release-metadata.py --tag "$RELEASE_TAG"
+          else
+            uv run --frozen python scripts/check-release-metadata.py
+          fi
+      - run: uv run --frozen python scripts/check-public-release.py
+      - run: uv run --frozen ruff check src tests scripts
+      - run: uv run --frozen ruff format --check src tests scripts
+      - run: uv run --frozen pytest -q
+      - run: uv build
+      - run: uv run --frozen python scripts/check-public-release.py --artifacts
+      - run: uv run --frozen python scripts/verify-release.py
+      - run: uv run --frozen python scripts/stage-release.py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: agenteng-python-${{ matrix.python }}
+          path: dist/

agenteng-0.0.1/.github/workflows/docs.yml

@@ -0,0 +1,60 @@
+name: Documentation
+
+"on":
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - 'requirements-docs.txt'
+      - '.github/workflows/docs.yml'
+  pull_request:
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - 'requirements-docs.txt'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: '0.8.0'
+          python-version: '3.12'
+      - name: Install documentation tooling
+        run: |
+          uv venv .venv-docs --python 3.12
+          uv pip install --python .venv-docs/bin/python -r requirements-docs.txt
+      - name: Build documentation
+        run: .venv-docs/bin/python -m mkdocs build --strict
+      - uses: actions/upload-pages-artifact@v3
+        if: github.repository == 'SuperagenticAI/agenteng' && github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+        with:
+          path: site
+
+  deploy:
+    if: github.repository == 'SuperagenticAI/agenteng' && github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/configure-pages@v5
+      - name: Publish to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

agenteng-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,128 @@
+name: Publish
+
+"on":
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Existing release tag to retry, for example v0.0.1'
+        required: true
+        type: string
+
+permissions:
+  contents: read
+
+# Serialize reruns of each tag; never cancel an in-progress PyPI upload.
+concurrency:
+  group: publish-${{ inputs.tag || github.ref_name }}
+  cancel-in-progress: false
+
+jobs:
+  resolve:
+    if: github.repository == 'SuperagenticAI/agenteng'
+    runs-on: ubuntu-latest
+    outputs:
+      tag: ${{ steps.release.outputs.tag }}
+      commit: ${{ steps.release.outputs.commit }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Resolve an existing version tag to an immutable commit
+        id: release
+        env:
+          RELEASE_TAG: ${{ inputs.tag || github.ref_name }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          python - <<'PY'
+          import os, re, sys
+          tag = os.environ['RELEASE_TAG']
+          pattern = r'v[0-9]+\.[0-9]+\.[0-9]+(?:(?:a|b|rc)[0-9]+)?(?:\.post[0-9]+)?(?:\.dev[0-9]+)?'
+          if not re.fullmatch(pattern, tag):
+              sys.exit('Use a version tag such as v0.0.1 or v0.2.0rc1.')
+          PY
+          commit=$(git rev-parse --verify "refs/tags/${RELEASE_TAG}^{commit}")
+          printf 'tag=%s\ncommit=%s\n' "$RELEASE_TAG" "$commit" >> "$GITHUB_OUTPUT"
+
+  verify:
+    needs: resolve
+    uses: ./.github/workflows/ci.yml
+    with:
+      source_ref: ${{ needs.resolve.outputs.commit }}
+      release_tag: ${{ needs.resolve.outputs.tag }}
+
+  publish:
+    needs: [resolve, verify]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      # Publish the exact Python 3.12 artifacts verified by CI; do not rebuild
+      # in the credentialed job. Both Python test jobs must have succeeded.
+      - uses: actions/download-artifact@v4
+        with:
+          name: agenteng-python-3.12
+          path: dist
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: '0.8.0'
+      - name: Check the release tag still identifies the verified commit
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RELEASE_TAG: ${{ needs.resolve.outputs.tag }}
+          RELEASE_COMMIT: ${{ needs.resolve.outputs.commit }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          remote_commit=$(gh api "repos/${GH_REPO}/commits/${RELEASE_TAG}" --jq '.sha')
+          if [ "$remote_commit" != "$RELEASE_COMMIT" ]; then
+            echo 'Release tag moved after verification; refusing to publish.' >&2
+            exit 1
+          fi
+      - name: Publish verified distributions to PyPI
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          if [ -z "$UV_PUBLISH_TOKEN" ]; then
+            echo 'Configure the repository secret PYPI_API_TOKEN with access to agenteng.' >&2
+            exit 1
+          fi
+          uv publish --trusted-publishing never --check-url https://pypi.org/simple/ dist/*.whl dist/*.tar.gz
+      - name: Create or update the GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RELEASE_TAG: ${{ needs.resolve.outputs.tag }}
+          RELEASE_COMMIT: ${{ needs.resolve.outputs.commit }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          # Check tag identity again before attaching the verified files.
+          remote_commit=$(gh api "repos/${GH_REPO}/commits/${RELEASE_TAG}" --jq '.sha')
+          if [ "$remote_commit" != "$RELEASE_COMMIT" ]; then
+            echo 'Release tag moved after verification; refusing to attach artifacts.' >&2
+            exit 1
+          fi
+          python - <<'PY'
+          import hashlib
+          from pathlib import Path
+          distributions = sorted([*Path('dist').glob('*.whl'), *Path('dist').glob('*.tar.gz')])
+          Path('dist/SHA256SUMS').write_text(''.join(
+              f'{hashlib.sha256(p.read_bytes()).hexdigest()}  {p.name}\n' for p in distributions
+          ))
+          PY
+          if gh release view "$RELEASE_TAG" >/dev/null 2>&1; then
+            gh release upload "$RELEASE_TAG" dist/*.whl dist/*.tar.gz dist/SHA256SUMS --clobber
+          else
+            prerelease=()
+            if [[ "$RELEASE_TAG" =~ (a|b|rc)[0-9]+|\.dev[0-9]+ ]]; then
+              prerelease=(--prerelease)
+            fi
+            gh release create "$RELEASE_TAG" dist/*.whl dist/*.tar.gz dist/SHA256SUMS \
+              --verify-tag --title "AgentEng ${RELEASE_TAG#v}" --generate-notes "${prerelease[@]}"
+          fi

agenteng-0.0.1/.gitignore

@@ -0,0 +1,92 @@
+# Local environments, dependencies and Python caches
+.venv/
+.venv-docs/
+venv/
+env/
+__pypackages__/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+.cache/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.tox/
+.nox/
+
+# Build/release output (the installer source stays in src/agenteng/data)
+build/
+/site/
+dist/
+wheelhouse/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+
+# Credentials and operator configuration; keep the empty example public
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+*.p12
+*.pfx
+*.credentials.json
+service-account*.json
+.aws/
+.azure/
+.gcloud/
+.terraform/
+*.tfstate
+*.tfstate.*
+
+# Private plans, working notes and future proposal/contact storage
+.private/
+/PLAN.md
+/RLM-DESIGN.md
+/docs/IMPLEMENTATION.md
+.agenteng/
+proposal-drafts/
+submissions/
+participant-access*.txt
+attendees.csv
+attendees-*.csv
+attendees_*.csv
+members.csv
+members-*.csv
+members_*.csv
+contacts.csv
+contacts-*.csv
+contacts_*.csv
+# Common exports from the documented local drafting commands
+/draft.json
+/draft.md
+/talk.json
+/talk.md
+/proposal.json
+/proposal.md
+/proposal-*.json
+/proposal-*.md
+*.sqlite
+*.sqlite3
+*.db
+*.db-journal
+*.sqlite-journal
+*.sqlite3-journal
+*.db-wal
+*.db-shm
+*.sqlite-wal
+*.sqlite-shm
+*.sqlite3-wal
+*.sqlite3-shm
+
+# Local editor/system state and logs
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*.swo
+*.log
+*.tmp

agenteng-0.0.1/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+## Unreleased
+
+### Changed
+
+- Align the initial package and installer release to `0.0.1`; derive the HTTP API version from package metadata and show the expected tag in release-check failures.
+
+- Use `agenteng` as the Python package distribution name, matching the CLI and module.
+
+### Added
+
+- Tag-triggered Cloud Build deployment with release validation, generated Cloud Run URL setup, dedicated runtime identity, live MCP/A2A checks and a console setup guide.
+
+- Minimal Markdown documentation with the official logo and favicon, MkDocs Material preview and GitHub Pages publishing.
+
+- Version-tag PyPI publishing and GitHub releases using verified CI artifacts, with release metadata validation and existing-tag retry support.
+
+- Offline tool directory: 456 listings covering 461 attributed source entries across twelve disciplines; CLI/MCP/A2A list, search, filters, aliases and pagination, crawlable pages/feed, and validated maintainer import.
+
+- Public event catalogue with source attribution, snapshot freshness and timezone-aware event states.
+- `agenteng` CLI for events, speakers, agendas, published ticket terms, recordings, search and session/calendar planning.
+- One-tool MCP server over stdio and Streamable HTTP; A2A 1.0 discovery and JSON-RPC adapter.
+- Optional ordinary synthesis and Monty RLM, disabled by default, with one child or leaf delegation and depth one.
+- Versioned wheel installer, release staging, Cloud Run configuration and local/CI verification.
+- Read-only participation guidance for talk and event ideas, with explicit organizer discretion.
+- Apache-2.0 license, contributor/security/community documentation and GitHub issue forms.
+- London/San Francisco discovery, source-backed invited-programme policy, crawlable event pages/JSON-LD, event feeds and agent/crawler guides.
+- Codex, Claude Code, Cursor and generic MCP connection instructions plus a remote stdio bridge.
+- Guided offline drafts, completeness checks and private-permission JSON/Markdown export.
+- Opt-in single-organizer SQLite intake pilot: participant credentials, confirmed previews, durable receipts, scoped status/history, withdrawal, retention and local organizer review.
+
+Public endpoints and package distribution have not been published. Hosted intake remains disabled by default and requires persistent private storage; the supplied Cloud Run configuration serves public discovery/drafting.

agenteng-0.0.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,11 @@
+# Community Code of Conduct
+
+We want Agent Engineering HQ to be welcoming to practitioners with different backgrounds, experience levels and perspectives. This policy applies to the project's issues, pull requests, discussions and community interactions connected with the project.
+
+Treat people with respect. Critique ideas and implementation choices without personal attacks. Make room for beginners, communicate constructively and respect privacy and consent.
+
+Harassment, threats, discriminatory remarks, sexualized conduct, doxxing, spam and publication of someone else's private information are not acceptable. Do not pressure maintainers or organizers to accept a contribution, proposal, commercial offer or event commitment.
+
+Report concerns privately to [events@agentengineering.world](mailto:events@agentengineering.world). Include relevant links and the context needed to understand the concern; avoid public allegations or sharing unnecessary personal information. Reports will be handled as privately as practical.
+
+Maintainers and organizers may remove content, ask for changes, restrict participation or ban participants when necessary. Decisions depend on context and impact. The same expectations apply to maintainers and organizers.