datalayer-skills 0.2.0__tar.gz

datalayer_skills-0.2.0/.github/workflows/fix-license-header.yaml

@@ -0,0 +1,62 @@
+name: Fix License Headers
+
+on:
+  pull_request_target:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+    
+jobs:
+  header-license-fix:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Checkout the branch from the PR that triggered the job
+        run: gh pr checkout ${{ github.event.pull_request.number }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Fix License Header
+        # pin to include https://github.com/apache/skywalking-eyes/pull/168
+        uses: apache/skywalking-eyes/header@8e837beb243c264ffcd5ea3abd3d5d8975cd0077
+        with:
+          mode: fix
+
+      - name: List files changed
+        id: files-changed
+        shell: bash -l {0}
+        run: |
+          set -ex
+          export CHANGES=$(git status --porcelain | tee /tmp/modified.log | wc -l)
+          cat /tmp/modified.log
+
+          echo "N_CHANGES=${CHANGES}" >> $GITHUB_OUTPUT
+
+          git diff
+
+      - name: Commit any changes
+        if: steps.files-changed.outputs.N_CHANGES != '0'
+        shell: bash -l {0}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          git pull --no-tags
+
+          git add *
+          git commit -m "Automatic application of license header"
+
+          git config push.default upstream
+          git push
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

datalayer_skills-0.2.0/.github/workflows/py-tests.yaml

@@ -0,0 +1,70 @@
+# Copyright (c) 2023-2026 Datalayer, Inc.
+# Distributed under the terms of the Modified BSD License.
+
+name: Py Tests
+
+# The package's tests on every supported Python, and ruff. No secrets: the
+# memory skills run against a fake agent runtime on the loopback.
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'datalayer_skills/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - '.github/workflows/py-tests.yaml'
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'datalayer_skills/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - '.github/workflows/py-tests.yaml'
+
+  workflow_dispatch:
+
+  # Called by the Release workflow: a tag publishes nothing until these pass.
+  workflow_call:
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+          python-version: ${{ matrix.python-version }}
+          activate-environment: true
+
+      - name: Install
+        run: uv pip install ".[test]"
+
+      - name: Run tests
+        run: pytest tests/ -q
+
+  code-style:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+          python-version: '3.12'
+          activate-environment: true
+
+      - name: Ruff
+        run: |
+          uv pip install ruff
+          ruff check .
+          ruff format --check .

datalayer_skills-0.2.0/.github/workflows/release.yaml

@@ -0,0 +1,123 @@
+# Copyright (c) 2023-2026 Datalayer, Inc.
+# Distributed under the terms of the Modified BSD License.
+
+# Publishes the release a tag names to PyPI (datalayer-skills), with no stored
+# token: PyPI trusts this workflow file (OIDC trusted publishing, through the
+# `pypi` environment). The tag must name the version in
+# datalayer_skills/__version__.py; a version already published is skipped.
+# Nothing is built before the tests (py-tests.yaml, called here) pass on the
+# tagged commit.
+
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  tests:
+    uses: ./.github/workflows/py-tests.yaml
+
+  build:
+    needs: tests
+    runs-on: ubuntu-latest
+    outputs:
+      python: ${{ steps.plan.outputs.python }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Check the tag names the version the package carries
+        run: |
+          set -euo pipefail
+          tag="${GITHUB_REF_NAME#v}"
+          version="$(python -c "import re;print(re.search(r'__version__\s*=\s*[\"\']([^\"\']+)', open('datalayer_skills/__version__.py').read())[1])")"
+          echo "tag=$tag version=$version"
+          test "$tag" = "$version"
+
+      - name: Find whether it is published yet
+        id: plan
+        run: |
+          set -euo pipefail
+          version="${GITHUB_REF_NAME#v}"
+          status="$(curl -sL -o /dev/null -w '%{http_code}' "https://pypi.org/pypi/datalayer-skills/$version/json")"
+          if [ "$status" = "200" ]; then
+            echo "PyPI: datalayer-skills $version is already published, skipping"
+            echo "python=" >> "$GITHUB_OUTPUT"
+          else
+            echo "PyPI: datalayer-skills $version will be published"
+            echo "python=yes" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Build
+        if: steps.plan.outputs.python != ''
+        run: |
+          set -euo pipefail
+          python -m pip install --upgrade pip build
+          python -m build --sdist --wheel --outdir dist .
+          ls -la dist
+
+      - name: Check the wheel carries every skill's SKILL.md and scripts
+        if: steps.plan.outputs.python != ''
+        run: |
+          set -euo pipefail
+          wheel="$(ls dist/*.whl)"
+          listing="$(unzip -l "$wheel")"
+          for skill in whoami memory_add memory_search memory_list memory_delete; do
+            grep -q "datalayer_skills/skills/$skill/SKILL.md" <<<"$listing"
+            grep -q "datalayer_skills/skills/$skill/scripts/" <<<"$listing"
+          done
+          unzip -p "$wheel" '*.dist-info/entry_points.txt'
+
+      - uses: actions/upload-artifact@v4
+        if: steps.plan.outputs.python != ''
+        with:
+          name: python
+          path: dist/*
+
+  pypi:
+    needs: build
+    if: needs.build.outputs.python != ''
+    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
+        with:
+          skip-existing: true
+
+  release:
+    name: GitHub release
+    needs: [build, pypi]
+    if: always() && needs.build.result == 'success' && needs.pypi.result != 'failure'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Create the release with generated notes
+        run: |
+          version="${GITHUB_REF_NAME#v}"
+          gh release view "$GITHUB_REF_NAME" >/dev/null 2>&1 && exit 0
+          gh release create "$GITHUB_REF_NAME" --title "Release $version" --generate-notes \
+            --notes "- [PyPI datalayer-skills](https://pypi.org/project/datalayer-skills/$version/)"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

datalayer_skills-0.2.0/.gitignore

@@ -0,0 +1,128 @@
+*.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

datalayer_skills-0.2.0/.licenserc.yaml

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

datalayer_skills-0.2.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025-2026, Datalayer, Inc.
+
+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.

datalayer_skills-0.2.0/Makefile

@@ -0,0 +1,42 @@
+# Copyright (c) 2023-2024 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 .
+
+test: ## Run tests
+	python -m pytest tests/ -v
+
+clean: ## clean
+	git clean -fdx
+
+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/datalayer-skills/#history

datalayer_skills-0.2.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.5
+Name: datalayer_skills
+Version: 0.2.0
+Project-URL: Home, https://github.com/datalayer/skills
+Author-email: Datalayer <info@datalayer.io>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2025-2026, Datalayer, Inc.
+        
+        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.
+License-File: LICENSE
+Keywords: AI,Agents,Datalayer,Skills
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: agent-skills
+Requires-Dist: datalayer-core
+Provides-Extra: lint
+Requires-Dist: ruff; extra == 'lint'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.21; extra == 'test'
+Requires-Dist: pytest>=7.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+<!--
+  ~ Copyright (c) 2025-2026 Datalayer, Inc.
+  ~
+  ~ BSD 3-Clause License
+-->
+
+[![Datalayer](https://images.datalayer.io/legacy/datalayer-25.svg)](https://datalayer.ai)
+
+[![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)
+
+# ☰ 🧰 Datalayer Skills
+
+Agent skills for the [Datalayer](https://datalayer.ai) platform, discovered by
+[agent-skills](https://github.com/datalayer/agent-skills) through Python entry
+points: install the package, and the skills are there.
+
+## Installation
+
+```bash
+pip install datalayer-skills
+```
+
+The Datalayer agent runtime image installs it, so an agent spec names these
+skills by their names (for example `datalayer-memory-add`) and the runtime
+loads them from the entry points, with no skill spec of their own.
+
+## Available Skills
+
+| Skill | Scripts | What it does |
+|-------|---------|--------------|
+| `datalayer-whoami` | `whoami` | The authenticated user's profile from Datalayer IAM |
+| `datalayer-memory-add` | `add` | Keep one thing in the person's memory of the agent, in their words |
+| `datalayer-memory-search` | `search` | The memories closest to a query |
+| `datalayer-memory-list` | `list_memories` | Every memory, newest first, with its id |
+| `datalayer-memory-delete` | `delete`, `delete_all` | Forget one memory by id, or everything once the person confirmed how many |
+
+## The memory skills
+
+An agent whose spec says `memory: mem0` keeps a durable memory of the person
+whose runtime it is: mem0, in PostgreSQL (pgvector) on a Datalayer runtime,
+embedded through ai-inference with the runtime's token. The memory skills let
+the person keep, read, list and delete it on request.
+
+**How the scripts reach the memory.** A skill script runs in the agent's
+sandbox, the Jupyter container beside the agent runtime in the same pod. It
+calls the runtime's memory routes on the pod's loopback (by default
+`http://127.0.0.1:8765`), with the Python standard library only:
+
+| Script | Route |
+|--------|-------|
+| `add` | `POST /api/v1/agents/{agent}/memory` with `{"content", "metadata"}` |
+| `search` | `POST /api/v1/agents/{agent}/memory/search` with `{"query"}` |
+| `list_memories` | `GET /api/v1/agents/{agent}/memory` |
+| `delete` | `DELETE /api/v1/agents/{agent}/memory/{id}` |
+| `delete_all` | `DELETE /api/v1/agents/{agent}/memory?count=N` |
+
+The scripts do not use mem0's client directly. That would need the PostgreSQL
+password and the ai-inference token in the sandbox, which holds neither, and
+it would let the script choose whose memory it opens. Going through the
+runtime needs no egress (the call stays in the pod) and no secret, and keeps
+the scope where agent-runtimes keeps it.
+
+**Scope.** The runtime keeps the memory under the composite key (user, agent):
+the user is the runtime owner's personal account, read from the runtime's
+trusted environment (`DATALAYER_USER_UID`), and the agent is the agent's own
+id. The scripts send neither. An id that is not one of this agent's memories
+of the person is not found, and `delete_all` forgets nothing when the agent
+remembers more than the `count` the person confirmed.
+
+**Which agent.** `--agent` (the agent's name on the runtime), else
+`AGENT_RUNTIMES_AGENT_ID`, else the runtime's only agent. When several agents
+run on the runtime, the script asks for `--agent`.
+
+**Optional environment.** `AGENT_RUNTIMES_URL` (another runtime),
+`AGENT_RUNTIMES_PORT` (its port on the loopback).
+
+## How It Works
+
+The package declares each skill in the `agent_skills.skills` entry-point group
+of `pyproject.toml`:
+
+```toml
+[project.entry-points."agent_skills.skills"]
+datalayer-whoami = "datalayer_skills.skills.whoami"
+datalayer-memory-add = "datalayer_skills.skills.memory_add"
+datalayer-memory-search = "datalayer_skills.skills.memory_search"
+datalayer-memory-list = "datalayer_skills.skills.memory_list"
+datalayer-memory-delete = "datalayer_skills.skills.memory_delete"
+```
+
+Each value is a module that holds a `SKILL.md` and a `scripts/` directory.
+`agent_skills.discover_entrypoint_skills()` loads them, and
+`AgentSkillsToolset(discover_entrypoints=True)` offers them to an agent.
+An agent runtime loads the ones its agent spec names.
+
+## Development
+
+```bash
+pip install -e ".[test]"
+pytest
+```
+
+The tests run each memory script against a fake agent runtime on the
+loopback, and through agent-skills' toolset with an eval sandbox.
+
+## Release
+
+Set the version in `datalayer_skills/__version__.py`, merge to `main`, then
+push the tag `v<version>`. The Release workflow runs the tests, builds, and
+publishes to PyPI through trusted publishing (the `pypi` environment).