agentspecs 0.0.7__tar.gz

agentspecs-0.0.7/.github/workflows/ci.yaml

@@ -0,0 +1,76 @@
+# Copyright (c) 2025-2026 Datalayer, Inc.
+#
+# BSD 3-Clause License
+
+# Builds and tests every push to main and every pull request. Publishing is
+# `release.yaml`'s, on a pushed `v*` tag, and runs these same checks first.
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_call:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+
+      - name: Build the sdist and the wheel
+        run: |
+          python -m pip install --upgrade build twine
+          python -m build --outdir dist
+          twine check --strict dist/*
+
+      - name: Check the wheel carries the specs
+        run: |
+          set -euo pipefail
+          unzip -Z1 dist/*.whl > wheel-files.txt
+          grep -q '^agentspecs/agents/.*\.yaml$' wheel-files.txt
+          grep -q '^agentspecs/models/.*\.yaml$' wheel-files.txt
+          grep -q '^agentspecs/teams/.*\.yaml$' wheel-files.txt
+
+      - name: Import the built wheel
+        run: |
+          python -m venv /tmp/wheel-env
+          /tmp/wheel-env/bin/pip install dist/*.whl
+          cd /tmp
+          /tmp/wheel-env/bin/python -c "import agentspecs; from agentspecs.models import list_models; from agentspecs.teams import list_teams; print(agentspecs.__version__, len(list_models()), 'models,', len(list_teams()), 'teams')"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python
+          path: dist/*
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install
+        run: python -m pip install ".[test]"
+
+      - name: Test
+        run: python -m pytest tests -v

agentspecs-0.0.7/.github/workflows/release.yaml

@@ -0,0 +1,56 @@
+# Copyright (c) 2025-2026 Datalayer, Inc.
+#
+# BSD 3-Clause License
+
+# Publishes the release a tag names to PyPI, with no stored token: PyPI
+# trusts this workflow file (OIDC trusted publishing). The tests and the
+# build are `ci.yaml`'s, run here first; its wheel and sdist are what is
+# published. See RELEASE.md.
+
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  check-tag:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Check the tag names the version being released
+        run: |
+          set -euo pipefail
+          tag="${GITHUB_REF_NAME#v}"
+          version="$(python3 -c "import re;print(re.search(r'__version__\s*=\s*[\"\x27]([^\"\x27]+)', open('agentspecs/__version__.py').read())[1])")"
+          echo "tag=$tag agentspecs=$version"
+          if [ "$tag" != "$version" ]; then
+            echo "::error::Tag v$tag does not match agentspecs $version"
+            exit 1
+          fi
+
+  ci:
+    needs: check-tag
+    uses: ./.github/workflows/ci.yaml
+
+  pypi:
+    needs: ci
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@release/v1

agentspecs-0.0.7/.gitignore

@@ -0,0 +1,136 @@
+*.egg-info/
+.ipynb_checkpoints
+
+# Created by https://www.gitignore.io/api/python
+# Edit at https://www.gitignore.io/?templates=python
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+dist/
+downloads/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+.installed.cfg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environment variables:
+.env
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache
+
+# Pyre type checker
+.pyre/
+
+# End of https://www.gitignore.io/api/python
+
+# OSX files
+.DS_Store
+
+# Include
+!**/.*ignore
+!**/.*rc
+!**/.*rc.js
+!**/.*rc.json
+!**/.*rc.yml
+!**/.*config
+!*.*rc.json
+!.github
+!.devcontainer
+
+untracked_notebooks/*
+.jupyter_ystore
+.jupyter_ystore.db
+docs/.yarn/*
+
+uv.lock
+
+generated
+skills
+examples/agent/*.txt
+
+launcher.py
+
+!docs/docs/skills
+!examples/**/skills
+!skills

agentspecs-0.0.7/.licenserc.yaml

@@ -0,0 +1,18 @@
+header:
+  license:
+    content: |
+      Copyright (c) 2025-2026 Datalayer, Inc.
+
+      BSD 3-Clause License
+
+
+  paths-ignore:
+    - '**/*.ipynb'
+    - '**/*.json'
+    - '**/*.yaml'
+    - '**/*.yml'
+    - '**/.*'
+    - 'docs/**/*'
+    - 'LICENSE'
+
+  comment: on-failure

agentspecs-0.0.7/.pre-commit-config.yaml

@@ -0,0 +1,38 @@
+ci:
+  autoupdate_schedule: monthly
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: end-of-file-fixer
+      - id: check-case-conflict
+      - id: check-executables-have-shebangs
+      - id: requirements-txt-fixer
+      - id: check-added-large-files
+      - id: check-case-conflict
+      - id: check-toml
+      - id: check-yaml
+      - id: debug-statements
+      - id: forbid-new-submodules
+      - id: check-builtin-literals
+      - id: trailing-whitespace
+
+  - repo: https://github.com/python-jsonschema/check-jsonschema
+    rev: 0.29.4
+    hooks:
+      - id: check-github-workflows
+
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.19
+    hooks:
+      - id: mdformat
+        additional_dependencies:
+          [mdformat-gfm, mdformat-frontmatter, mdformat-footnote]
+
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: ["--fix"]
+      - id: ruff-format

agentspecs-0.0.7/.vscode/settings.json

@@ -0,0 +1,9 @@
+{
+    "python-envs.pythonProjects": [
+        {
+            "path": ".",
+            "envManager": "ms-python.python:conda",
+            "packageManager": "ms-python.python:conda"
+        }
+    ]
+}

agentspecs-0.0.7/CHANGELOG.md

@@ -0,0 +1,7 @@
+<!--
+  ~ Copyright (c) 2025-2026 Datalayer, Inc.
+  ~
+  ~ BSD 3-Clause License
+-->
+
+# Changelog

agentspecs-0.0.7/Dockerfile

@@ -0,0 +1,19 @@
+# Copyright (c) 2025-2026 Datalayer, Inc.
+#
+# BSD 3-Clause License
+
+FROM python:3.10-slim
+
+WORKDIR /app
+
+COPY pyproject.toml pyproject.toml
+COPY LICENSE LICENSE
+COPY README.md README.md
+COPY agentspecs/* agentspecs/
+
+RUN pip install -e .
+
+RUN pip uninstall -y pycrdt datalayer_pycrdt
+RUN pip install datalayer_pycrdt==0.12.17
+
+CMD ["python", "-m", "agentspecs.server"]

agentspecs-0.0.7/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Datalayer
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

agentspecs-0.0.7/Makefile

@@ -0,0 +1,82 @@
+# Copyright (c) 2025-2026 Datalayer, Inc.
+#
+# BSD 3-Clause License
+
+SHELL=/bin/bash
+
+.DEFAULT_GOAL := default
+
+.PHONY: clean build test
+
+VERSION = "0.0.3"
+
+default: all ## Default target is all.
+
+help: ## display this help.
+	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z_-]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+all: clean dev ## Clean Install and Build
+
+install:
+	pip install .
+
+dev:
+	pip install ".[test,lint,typing]"
+
+build:
+	pip install build
+	python -m build .
+
+clean: ## clean
+	git clean -fdx
+
+test: ## Run tests
+	python -m pytest tests/ -v
+
+start-agent: ## Start the MCP agent CLI (stdio server). Usage: make start-agent [MODEL=<model>]
+	python examples/agent/agent_cli.py $(if $(MODEL),--model $(MODEL),)
+
+start-agentspecs: ## Start the Agentspecs agent CLI (stdio server). Usage: make start-agentspecs [MODEL=<model>]
+	python examples/agent/agent_cli.py --codemode $(if $(MODEL),--model $(MODEL),)
+
+build-docker:
+	docker buildx build --platform linux/amd64,linux/arm64 -t datalayer/agentspecs:${VERSION} .
+	docker image tag datalayer/agentspecs:${VERSION} datalayer/agentspecs:latest
+
+start-docker:
+	docker run -i --rm \
+	  -e SERVER_URL=http://localhost:8888 \
+	  -e TOKEN=MY_TOKEN \
+	  -e NOTEBOOK_PATH=notebook.ipynb \
+	  --network=host \
+	  datalayer/agentspecs:latest
+
+pull-docker:
+	docker image pull datalayer/agentspecs:latest
+
+push-docker:
+	docker push datalayer/agentspecs:${VERSION}
+	docker push datalayer/agentspecs:latest
+
+claude-linux:
+	NIXPKGS_ALLOW_UNFREE=1 nix run github:k3d3/claude-desktop-linux-flake \
+		--impure \
+		--extra-experimental-features flakes \
+		--extra-experimental-features nix-command
+
+jupyterlab:
+	pip uninstall -y pycrdt datalayer_pycrdt
+	pip install datalayer_pycrdt
+	jupyter lab \
+		--port 8888 \
+		--ip 0.0.0.0 \
+		--ServerApp.root_dir ./dev/content \
+		--IdentityProvider.token MY_TOKEN
+
+publish-pypi: # publish the pypi package
+	git clean -fdx && \
+		python -m build
+	@exec echo
+	@exec echo twine upload ./dist/*-py3-none-any.whl
+	@exec echo
+	@exec echo https://pypi.org/project/agentspecs/#history