actions-runtime 1.0.2__tar.gz → 1.0.4__tar.gz

{actions_runtime-1.0.2 → actions_runtime-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: actions-runtime
-Version: 1.0.2
+Version: 1.0.4
 Summary: Actions Runtime — serve Python actions through HTTP and MCP
 License: Apache-2.0
 Author: Joshua Yorko
@@ -10,8 +10,8 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: actions-core (>=1.0.0,<2.0.0)
-Requires-Dist: actions-http-helper (>=1.0.0,<2.0.0)
+Requires-Dist: actions-core (>=1.0.2,<2.0.0)
+Requires-Dist: actions-http-helper (>=1.0.3,<2.0.0)
 Requires-Dist: actions-work-items (>=0.4.4,<0.5.0)
 Requires-Dist: aiohttp (>=3.13.2,<4.0.0)
 Requires-Dist: aiosmtplib (>=3.0.0,<4.0.0)
@@ -30,6 +30,7 @@ Requires-Dist: pyyaml (>=6.0.3,<7.0.0)
 Requires-Dist: redis (>=5.0.0,<6.0.0)
 Requires-Dist: requests (>=2,<3)
 Requires-Dist: requests_oauthlib (>=2.0,<3.0)
+Requires-Dist: rfc8785 (==0.1.4)
 Requires-Dist: termcolor (>=3.2.0,<4.0.0)
 Requires-Dist: uvicorn (>=0.38.0,<0.39.0)
 Requires-Dist: watchfiles (>=1.1.1,<2.0.0)
@@ -38,33 +39,36 @@ Project-URL: Homepage, https://github.com/joshyorko/actions/tree/community
 Project-URL: Repository, https://github.com/joshyorko/actions/tree/community
 Description-Content-Type: text/markdown
 
-# actions-runtime
+# Actions Runtime (Action Server)
 
-[Actions Runtime](https://github.com/joshyorko/actions) is a Python framework designed to provide your Python functions to AI Agents. It works both as an MCP Server (hosting tools, resources and prompts) and also provides an OpenAPI compatible API.
+`actions-runtime` is the canonical community PyPI distribution for the **Action Server**. It provides the `action-server` command and the `actions.server` module for serving Python functions to AI agents through MCP and OpenAPI.
 
-A `tool` or `action` in this case is defined as a Python function (which has inputs/outputs defined), which is served by the `Actions Runtime`.
-
-The `Actions Runtime` automatically provides a `/mcp` endpoint for connecting `MCP` clients and also generates an OpenAPI spec for your Python code, enabling different AI/LLM Agents to understand and call your Action. It also manages the Action lifecycle and provides full traceability of what happened during any tool or action call (open the `/runs` endpoint in a browser to see not only inputs and output, but also a full `log.html` with internal details, such as variables and function calls that your Python function executed).
+A `tool` or `action` is a Python function with declared inputs and outputs served by the Action Server. The server also manages the action lifecycle and provides full run traceability.
 
 ## 1. Install Action Server
 
-Action Server is available as a stand-alone executable and via `pip install actions-runtime`.
+Install the canonical community distribution:
+
+```sh
+python -m pip install actions-runtime
+```
 
-The 1.0.1 standalone binaries are unsigned and are not publisher-signed or notarized.
+This installs the `action-server` command in the active Python environment.
 
-> We recommend the executable to prevent confusion in case you have multiple/crowded Python environments, etc.
+### Standalone release binaries
 
-#### For macOS
+The standalone binaries are an alternative compatibility path when a Python environment is not wanted. The 1.0.1 binaries are unsigned and are not publisher-signed or notarized.
+
+#### For macOS (Apple Silicon)
 
 ```sh
-# Install Actions Runtime
-python -m pip install actions-runtime
+curl -o action-server https://github.com/joshyorko/actions/releases/download/actions-runtime-1.0.1/actions-runtime-1.0.1-macos-arm64
+chmod a+x action-server
 ```
 
 #### For Windows
 
 ```sh
-# Download Actions Runtime
 curl -o action-server.exe https://github.com/joshyorko/actions/releases/download/actions-runtime-1.0.1/actions-runtime-1.0.1-windows64.exe
 
 # Add to PATH or move to a folder that is in PATH
@@ -74,7 +78,6 @@ setx PATH=%PATH%;%CD%
 #### For Linux
 
 ```sh
-# Download Actions Runtime
 curl -o action-server https://github.com/joshyorko/actions/releases/download/actions-runtime-1.0.1/actions-runtime-1.0.1-linux64
 chmod a+x action-server
 
@@ -142,6 +145,26 @@ After it's started, it's possible to access the following URLs:
 - `/openapi.json`: Provides the openapi spec for the action server.
 - `/docs`: Provides access to the APIs available in the server and a UI to test it.
 
+## Robot run artifacts
+
+After a Robot task exits, Runtime retains regular files from its configured
+`artifactsDir`, or `output` when absent, including failure diagnostics. List
+them at `/api/runs/{run_id}/artifacts` and download them through the existing
+artifact endpoints with your configured Runtime credentials.
+
+Collection captures the trusted output tree as it exists at task completion.
+Pre-existing files can be included. Avoid concurrent writers while Runtime
+collects the files; collection does not provide an atomic tree snapshot or
+prove which invocation created them. Later source changes do not alter the
+retained copies.
+
+Output roots must be canonical relative paths inside the Robot package.
+Runtime rejects links, hardlinks, special files, portable-name collisions and
+reserved names such as `env.json` and `__action_server_*`. Limits are 50 MiB per
+file, 500 MiB total, 10,000 entries and depth 32. A collection error marks the
+Run failed and preserves its console and any complete files already retained.
+The selected Robot configuration must fit within 64 KiB.
+
 ## Documentation
 
 Explore our [docs](https://github.com/joshyorko/actions/tree/community/action_server/docs) for extensive documentation.

{actions_runtime-1.0.2 → actions_runtime-1.0.4}/README.md

@@ -1,30 +1,33 @@
-# actions-runtime
+# Actions Runtime (Action Server)
 
-[Actions Runtime](https://github.com/joshyorko/actions) is a Python framework designed to provide your Python functions to AI Agents. It works both as an MCP Server (hosting tools, resources and prompts) and also provides an OpenAPI compatible API.
+`actions-runtime` is the canonical community PyPI distribution for the **Action Server**. It provides the `action-server` command and the `actions.server` module for serving Python functions to AI agents through MCP and OpenAPI.
 
-A `tool` or `action` in this case is defined as a Python function (which has inputs/outputs defined), which is served by the `Actions Runtime`.
-
-The `Actions Runtime` automatically provides a `/mcp` endpoint for connecting `MCP` clients and also generates an OpenAPI spec for your Python code, enabling different AI/LLM Agents to understand and call your Action. It also manages the Action lifecycle and provides full traceability of what happened during any tool or action call (open the `/runs` endpoint in a browser to see not only inputs and output, but also a full `log.html` with internal details, such as variables and function calls that your Python function executed).
+A `tool` or `action` is a Python function with declared inputs and outputs served by the Action Server. The server also manages the action lifecycle and provides full run traceability.
 
 ## 1. Install Action Server
 
-Action Server is available as a stand-alone executable and via `pip install actions-runtime`.
+Install the canonical community distribution:
+
+```sh
+python -m pip install actions-runtime
+```
 
-The 1.0.1 standalone binaries are unsigned and are not publisher-signed or notarized.
+This installs the `action-server` command in the active Python environment.
 
-> We recommend the executable to prevent confusion in case you have multiple/crowded Python environments, etc.
+### Standalone release binaries
 
-#### For macOS
+The standalone binaries are an alternative compatibility path when a Python environment is not wanted. The 1.0.1 binaries are unsigned and are not publisher-signed or notarized.
+
+#### For macOS (Apple Silicon)
 
 ```sh
-# Install Actions Runtime
-python -m pip install actions-runtime
+curl -o action-server https://github.com/joshyorko/actions/releases/download/actions-runtime-1.0.1/actions-runtime-1.0.1-macos-arm64
+chmod a+x action-server
 ```
 
 #### For Windows
 
 ```sh
-# Download Actions Runtime
 curl -o action-server.exe https://github.com/joshyorko/actions/releases/download/actions-runtime-1.0.1/actions-runtime-1.0.1-windows64.exe
 
 # Add to PATH or move to a folder that is in PATH
@@ -34,7 +37,6 @@ setx PATH=%PATH%;%CD%
 #### For Linux
 
 ```sh
-# Download Actions Runtime
 curl -o action-server https://github.com/joshyorko/actions/releases/download/actions-runtime-1.0.1/actions-runtime-1.0.1-linux64
 chmod a+x action-server
 
@@ -102,6 +104,26 @@ After it's started, it's possible to access the following URLs:
 - `/openapi.json`: Provides the openapi spec for the action server.
 - `/docs`: Provides access to the APIs available in the server and a UI to test it.
 
+## Robot run artifacts
+
+After a Robot task exits, Runtime retains regular files from its configured
+`artifactsDir`, or `output` when absent, including failure diagnostics. List
+them at `/api/runs/{run_id}/artifacts` and download them through the existing
+artifact endpoints with your configured Runtime credentials.
+
+Collection captures the trusted output tree as it exists at task completion.
+Pre-existing files can be included. Avoid concurrent writers while Runtime
+collects the files; collection does not provide an atomic tree snapshot or
+prove which invocation created them. Later source changes do not alter the
+retained copies.
+
+Output roots must be canonical relative paths inside the Robot package.
+Runtime rejects links, hardlinks, special files, portable-name collisions and
+reserved names such as `env.json` and `__action_server_*`. Limits are 50 MiB per
+file, 500 MiB total, 10,000 entries and depth 32. A collection error marks the
+Run failed and preserves its console and any complete files already retained.
+The selected Robot configuration must fit within 64 KiB.
+
 ## Documentation
 
 Explore our [docs](https://github.com/joshyorko/actions/tree/community/action_server/docs) for extensive documentation.

actions_runtime-1.0.4/oauth2/actions-oauth-config.yaml

@@ -0,0 +1,6 @@
+# Community Runtime does not provide hosted OAuth application registrations.
+# mode: actions fails explicitly for every provider in this catalog.
+# Use mode: custom with your own registered application in --oauth2-settings.
+formatVersion: '1.0.0'
+oauth2Config:
+  providers: {}

actions_runtime-1.0.4/oauth2/oauth-config.yaml

@@ -0,0 +1,9 @@
+# Private operator settings template. No providers are configured by default.
+# Register your own OAuth application, then add a provider with mode: custom,
+# a nonblank clientId, and authorizationEndpoint/tokenEndpoint or public defaults.
+# Omit clientSecret for PKCE S256 when the provider supports public clients.
+# Keep client secrets and tokens out of source control and public build inputs.
+# Register the redirect URI <Runtime base URL>/actions/oauth2/ with your provider.
+formatVersion: '1.0.0'
+oauth2Config:
+  providers: {}

{actions_runtime-1.0.2 → actions_runtime-1.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "actions-runtime"
-version = "1.0.2"
+version = "1.0.4"
 description = "Actions Runtime — serve Python actions through HTTP and MCP"
 authors = ["Joshua Yorko"]
 maintainers = ["Joshua Yorko"]
@@ -9,6 +9,7 @@ repository = "https://github.com/joshyorko/actions/tree/community"
 license = "Apache-2.0"
 packages = [{ include = "actions", from = "src" }]
 include = [
+	{ path = "oauth2/*.yaml", format = "sdist" },
 	"src/actions/server/_static_contents.py",
 	"src/actions/server/_oauth2_config.py",
 	"src/actions/server/bin/rcc*",
@@ -30,12 +31,13 @@ jsonschema = "^4.23.0"
 jsonschema-specifications = "^2024.10.1"
 msgspec = "^0.19"
 psutil = ">=5.0,<8.0"
+rfc8785 = "0.1.4"
 pydantic = "^2.12.4"
 pyyaml = "^6.0.3"
 python = ">=3.12,<3.14"
 requests = "^2"
-actions-core = "^1.0.0"
-actions-http-helper = "^1.0.0"
+actions-core = "^1.0.2"
+actions-http-helper = "^1.0.3"
 termcolor = "^3.2.0"
 uvicorn = "^0.38.0"
 websockets = "^15.0.1"
@@ -53,6 +55,10 @@ redis = "^5.0.0"
 psycopg = { version = "^3.2.0", extras = ["binary"] }
 
 [tool.poetry.group.dev.dependencies]
+actions-http-helper = { path = "../actions-http-helper/", develop = true }
+# Resolve the unpublished monorepo candidate for development; wheel metadata
+# retains the production version floor above and never embeds this source path.
+actions-core = { path = "../actions/", develop = true }
 actions-local-devutils = { path = "../devutils/", develop = true }
 httpx = "^0.28.1"
 types-requests = "^2"
@@ -61,7 +67,9 @@ robocorp-log-pytest = "^0.0.5"
 types-psutil = "^7"
 types-jsonschema = "^4.22.0"
 pyinstaller = "6.16.0"
+types-pyinstaller = "6.16.0.20250918"
 pyinstaller-hooks-contrib = "2025.9"
+pytest-cov = "5.0.0"
 
 [tool.mypy]
 mypy_path = "src:tests"
@@ -87,6 +95,7 @@ testpaths = ["tests"]
 markers = [
     "real_rcc: gated real RCC Environment Artifact execution proof",
     "postgresql: requires a PostgreSQL service",
+    "native_artifact_test: requires a source-bound packaged Runtime artifact manifest",
 ]
 filterwarnings = [
     "ignore:ast.Str is deprecated.*:DeprecationWarning:robocorp\\.log\\._ast_utils",

actions_runtime-1.0.4/setup.py

@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*-
+from setuptools import setup
+
+package_dir = \
+{'': 'src'}
+
+packages = \
+['actions',
+ 'actions.server',
+ 'actions.server._build_common',
+ 'actions.server._common',
+ 'actions.server._common.action_package_handling',
+ 'actions.server._common.package_deps',
+ 'actions.server._common.package_deps.conda_impl',
+ 'actions.server._common.package_deps.pip_impl',
+ 'actions.server._common.termcolors',
+ 'actions.server._preload_actions',
+ 'actions.server._robo_utils',
+ 'actions.server.deployments',
+ 'actions.server.env',
+ 'actions.server.mcp',
+ 'actions.server.migrations',
+ 'actions.server.package',
+ 'actions.server.run_outputs',
+ 'actions.server.vendored_deps',
+ 'actions.server.vendored_deps.action_package_handling',
+ 'actions.server.vendored_deps.package_deps',
+ 'actions.server.vendored_deps.package_deps.conda_impl',
+ 'actions.server.vendored_deps.package_deps.pip_impl',
+ 'actions.server.vendored_deps.termcolors']
+
+package_data = \
+{'': ['*'], 'actions.server': ['bin/*', 'templates/*', 'templates/zips/*']}
+
+install_requires = \
+['actions-core>=1.0.2,<2.0.0',
+ 'actions-http-helper>=1.0.3,<2.0.0',
+ 'actions-work-items>=0.4.4,<0.5.0',
+ 'aiohttp>=3.13.2,<4.0.0',
+ 'aiosmtplib>=3.0.0,<4.0.0',
+ 'croniter>=2.0.0,<3.0.0',
+ 'cryptography>=46.0.3,<47.0.0',
+ 'fastapi-slim>=0.121.1,<0.122.0',
+ 'jsonschema-specifications>=2024.10.1,<2025.0.0',
+ 'jsonschema>=4.23.0,<5.0.0',
+ 'mcp>=2.0.0,<3.0.0',
+ 'msgspec>=0.19,<0.20',
+ 'psutil>=5.0,<8.0',
+ 'psycopg[binary]>=3.2.0,<4.0.0',
+ 'pydantic>=2.12.4,<3.0.0',
+ 'pytz>=2024.1,<2025.0',
+ 'pyyaml>=6.0.3,<7.0.0',
+ 'redis>=5.0.0,<6.0.0',
+ 'requests>=2,<3',
+ 'requests_oauthlib>=2.0,<3.0',
+ 'rfc8785==0.1.4',
+ 'termcolor>=3.2.0,<4.0.0',
+ 'uvicorn>=0.38.0,<0.39.0',
+ 'watchfiles>=1.1.1,<2.0.0',
+ 'websockets>=15.0.1,<16.0.0']
+
+entry_points = \
+{'console_scripts': ['action-server = actions.server.cli:main']}
+
+setup_kwargs = {
+    'name': 'actions-runtime',
+    'version': '1.0.4',
+    'description': 'Actions Runtime — serve Python actions through HTTP and MCP',
+    'long_description': "# Actions Runtime (Action Server)\n\n`actions-runtime` is the canonical community PyPI distribution for the **Action Server**. It provides the `action-server` command and the `actions.server` module for serving Python functions to AI agents through MCP and OpenAPI.\n\nA `tool` or `action` is a Python function with declared inputs and outputs served by the Action Server. The server also manages the action lifecycle and provides full run traceability.\n\n## 1. Install Action Server\n\nInstall the canonical community distribution:\n\n```sh\npython -m pip install actions-runtime\n```\n\nThis installs the `action-server` command in the active Python environment.\n\n### Standalone release binaries\n\nThe standalone binaries are an alternative compatibility path when a Python environment is not wanted. The 1.0.1 binaries are unsigned and are not publisher-signed or notarized.\n\n#### For macOS (Apple Silicon)\n\n```sh\ncurl -o action-server https://github.com/joshyorko/actions/releases/download/actions-runtime-1.0.1/actions-runtime-1.0.1-macos-arm64\nchmod a+x action-server\n```\n\n#### For Windows\n\n```sh\ncurl -o action-server.exe https://github.com/joshyorko/actions/releases/download/actions-runtime-1.0.1/actions-runtime-1.0.1-windows64.exe\n\n# Add to PATH or move to a folder that is in PATH\nsetx PATH=%PATH%;%CD%\n```\n\n#### For Linux\n\n```sh\ncurl -o action-server https://github.com/joshyorko/actions/releases/download/actions-runtime-1.0.1/actions-runtime-1.0.1-linux64\nchmod a+x action-server\n\n# Add to PATH or move to a folder that is in PATH\nsudo mv action-server /usr/local/bin/\n```\n\n## 2. Run your first MCP tool\n\n```sh\n# Bootstrap a new project using this template.\n# You'll be prompted for the name of the project (directory):\naction-server new\n\n# Start Action Server\ncd my-project\naction-server start\n```\n\n👉 You should now have an Action Server running locally at: [http://localhost:8080](http://localhost:8080), so open that in your browser and the web UI will guide you further.\n\n### MCP compatibility\n\n`/mcp` supports the MCP `2026-07-28` per-request contract through the Python\nMCP SDK v2. Clients use `server/discover` and then send calls without an\n`initialize`/`initialized` exchange or `Mcp-Session-Id`. The legacy `/sse`\nendpoint and initialization/session-era compatibility path are intentionally\nnot provided.\n\n## What do you need in your Action Package\n\nAn `Action Package` is currently defined as a local folder that contains at least one Python file containing an action entry point (a Python function marked with `@action` -decorator from `actions`).\n\nThe `package.yaml` file is required for specifying the Python environment and dependencies for your Action ([RCC](https://github.com/joshyorko/rcc/) will be used to automatically bootstrap it and keep it updated given the `package.yaml` contents).\n\n> Note: the `package.yaml` is optional if the action server is not being used as a standalone (i.e.: if it was pip-installed it can use the same python environment where it's installed).\n\n### Community RCC Fork\n\nThis Action Server uses the **joshyorko/rcc v18.19.3** community fork, which provides:\n- **Faster startup** - no proprietary cloud service calls\n- **Official sources** - downloads micromamba directly from conda-forge instead of Robocorp CDN\n- **Decoupled infrastructure** - works fully offline after initial environment bootstrap\n- **Security hardening** - includes upstream archive extraction and TLS fixes, built with Go 1.25.7\n\nEnvironment caching means subsequent startups are near-instant once the holotree is built.\n\n### Bootstrapping a new Action\n\nStart new projects with:\n\n`action-server new`\n\nNote: the `action-server` executable should be automatically added to your Python installation after `pip install actions-runtime`; if it was not, use `python -m actions.server` instead.\n\nAfter creating the project, it's possible to serve the actions under the current directory with:\n\n`action-server start`\n\nFor example: When running `action-server start`, the action server will scan for existing actions under the current directory, and it'll start serving those.\n\nAfter it's started, it's possible to access the following URLs:\n\n- `/index.html`: UI for the Action Server.\n- `/openapi.json`: Provides the openapi spec for the action server.\n- `/docs`: Provides access to the APIs available in the server and a UI to test it.\n\n## Robot run artifacts\n\nAfter a Robot task exits, Runtime retains regular files from its configured\n`artifactsDir`, or `output` when absent, including failure diagnostics. List\nthem at `/api/runs/{run_id}/artifacts` and download them through the existing\nartifact endpoints with your configured Runtime credentials.\n\nCollection captures the trusted output tree as it exists at task completion.\nPre-existing files can be included. Avoid concurrent writers while Runtime\ncollects the files; collection does not provide an atomic tree snapshot or\nprove which invocation created them. Later source changes do not alter the\nretained copies.\n\nOutput roots must be canonical relative paths inside the Robot package.\nRuntime rejects links, hardlinks, special files, portable-name collisions and\nreserved names such as `env.json` and `__action_server_*`. Limits are 50 MiB per\nfile, 500 MiB total, 10,000 entries and depth 32. A collection error marks the\nRun failed and preserves its console and any complete files already retained.\nThe selected Robot configuration must fit within 64 KiB.\n\n## Documentation\n\nExplore our [docs](https://github.com/joshyorko/actions/tree/community/action_server/docs) for extensive documentation.\n\n## Changelog\n\nClean-break Actions Runtime releases and `actions-runtime-*` tags use the\n[Actions Runtime changelog](./docs/ACTIONS_RUNTIME_CHANGELOG.md). The historical\n[Action Server changelog](https://github.com/joshyorko/actions/blob/community/action_server/docs/CHANGELOG.md)\nis retained for the older `action-server-v1.2.x` delivery line.\n\n## Maintainer and attribution\n\nMaintained by Joshua Yorko. Upstream copyright and license attribution is preserved in\n[NOTICE.md](https://github.com/joshyorko/actions/blob/community/NOTICE.md) and\n[LICENSE](https://github.com/joshyorko/actions/blob/community/LICENSE).\n",
+    'author': 'Joshua Yorko',
+    'author_email': 'None',
+    'maintainer': 'Joshua Yorko',
+    'maintainer_email': 'None',
+    'url': 'https://github.com/joshyorko/actions/tree/community',
+    'package_dir': package_dir,
+    'packages': packages,
+    'package_data': package_data,
+    'install_requires': install_requires,
+    'entry_points': entry_points,
+    'python_requires': '>=3.12,<3.14',
+}
+from build import *
+build(setup_kwargs)
+
+setup(**setup_kwargs)

{actions_runtime-1.0.2 → actions_runtime-1.0.4}/src/actions/server/__init__.py

@@ -1,6 +1,6 @@
 from typing import List
 
-__version__ = "1.0.2"
+__version__ = "1.0.4"
 version_info = [int(x) for x in __version__.split(".")]
 
 __all__: List[str] = []