markspace 0.1.3b0__tar.gz

markspace-0.1.3b0/.devcontainer/devcontainer.json

@@ -0,0 +1,32 @@
+{
+  "name": "markspace",
+  "image": "mcr.microsoft.com/devcontainers/python:3.11",
+  "features": {
+    "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {
+      "moby": false
+    },
+    "ghcr.io/devcontainers/features/git-lfs:1": {}
+  },
+  "runArgs": [
+    "--network=host",
+    "--name=markspace"
+  ],
+  "mounts": [
+    "source=/var/run/docker.sock,target=/var/run/docker.sock,type=bind"
+  ],
+  "postCreateCommand": ".devcontainer/post_create.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "editorconfig.editorconfig",
+        "elagil.pre-commit-helper",
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "tamasfe.even-better-toml"
+      ],
+      "settings": {
+        "python.defaultInterpreterPath": "/workspaces/markspace/.venv/bin/python"
+      }
+    }
+  }
+}

markspace-0.1.3b0/.devcontainer/post_create.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+# Suppress 'detected dubious ownership' errors for git commands.
+# Must be run every time the container starts since VSCode copies
+# $HOME/.gitconfig of host machine to container on every start.
+git config --global --add safe.directory '*'
+
+# Install project dependencies
+pip install poetry
+poetry install
+
+# Install pre-commit hooks
+poetry run pre-commit install

markspace-0.1.3b0/.env.example

@@ -0,0 +1,23 @@
+# markspace - API keys for LLM experiments
+#
+# Copy this file to .env and fill in your keys.
+# The reference implementation (core, guard, tests) does not require any API keys.
+# Keys are only needed to run the LLM-driven experiments.
+
+# Primary provider: Fireworks (checked first)
+FIREWORKS_API_TOKEN=
+
+# Alternative provider: OpenAI (used if no Fireworks key is set)
+# OPENAI_API_KEY=
+
+# Alternative provider: Google Gemini (OpenAI-compatible endpoint)
+# GEMINI_API_KEY=
+
+# Alternative provider: Anthropic Claude (OpenAI-compatible endpoint)
+# ANTHROPIC_API_KEY=
+
+# Optional: custom Fireworks endpoint
+# FIREWORKS_INFERENCE_ENDPOINT=
+
+# Optional: Inception Labs (only needed for mercury-2 model)
+# INCEPTION_API_KEY=

markspace-0.1.3b0/.gitattributes

@@ -0,0 +1,3 @@
+**/*.jsonl filter=lfs diff=lfs merge=lfs -text
+**/*.png filter=lfs diff=lfs merge=lfs -text
+*.jsonl filter=lfs diff=lfs merge=lfs -text

markspace-0.1.3b0/.github/workflows/publish.yml

@@ -0,0 +1,61 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build dependencies
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-testpypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    needs: publish-testpypi
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

markspace-0.1.3b0/.gitignore

@@ -0,0 +1,44 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+.claude/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.hypothesis/
+
+# Environment
+.env
+
+# Jupyter
+.ipynb_checkpoints/
+
+review/
+demo/
+markspace-ts/
+distill/

markspace-0.1.3b0/.pre-commit-config.yaml

@@ -0,0 +1,12 @@
+repos:
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+      - id: black
+        language_version: python3.11
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets
+        args: ['--baseline', '.secrets.baseline']
+        exclude: '_messages\.jsonl$|experiments/trials/.*\.jsonl$'

markspace-0.1.3b0/.secrets.baseline

@@ -0,0 +1,131 @@
+{
+  "version": "1.5.0",
+  "plugins_used": [
+    {
+      "name": "ArtifactoryDetector"
+    },
+    {
+      "name": "AWSKeyDetector"
+    },
+    {
+      "name": "AzureStorageKeyDetector"
+    },
+    {
+      "name": "Base64HighEntropyString",
+      "limit": 4.5
+    },
+    {
+      "name": "BasicAuthDetector"
+    },
+    {
+      "name": "CloudantDetector"
+    },
+    {
+      "name": "DiscordBotTokenDetector"
+    },
+    {
+      "name": "GitHubTokenDetector"
+    },
+    {
+      "name": "GitLabTokenDetector"
+    },
+    {
+      "name": "HexHighEntropyString",
+      "limit": 3.0
+    },
+    {
+      "name": "IbmCloudIamDetector"
+    },
+    {
+      "name": "IbmCosHmacDetector"
+    },
+    {
+      "name": "IPPublicDetector"
+    },
+    {
+      "name": "JwtTokenDetector"
+    },
+    {
+      "name": "KeywordDetector",
+      "keyword_exclude": ""
+    },
+    {
+      "name": "MailchimpDetector"
+    },
+    {
+      "name": "NpmDetector"
+    },
+    {
+      "name": "OpenAIDetector"
+    },
+    {
+      "name": "PrivateKeyDetector"
+    },
+    {
+      "name": "PypiTokenDetector"
+    },
+    {
+      "name": "SendGridDetector"
+    },
+    {
+      "name": "SlackDetector"
+    },
+    {
+      "name": "SoftlayerDetector"
+    },
+    {
+      "name": "SquareOAuthDetector"
+    },
+    {
+      "name": "StripeDetector"
+    },
+    {
+      "name": "TelegramBotTokenDetector"
+    },
+    {
+      "name": "TwilioKeyDetector"
+    }
+  ],
+  "filters_used": [
+    {
+      "path": "detect_secrets.filters.allowlist.is_line_allowlisted"
+    },
+    {
+      "path": "detect_secrets.filters.common.is_ignored_due_to_verification_policies",
+      "min_level": 2
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_indirect_reference"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_likely_id_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_lock_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_not_alphanumeric_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_potential_uuid"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_prefixed_with_dollar_sign"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_sequential_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_swagger_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_templated_secret"
+    },
+    {
+      "path": "detect_secrets.filters.regex.should_exclude_file",
+      "pattern": ["_messages\\.jsonl$"]
+    }
+  ],
+  "results": {},
+  "generated_at": "2026-02-28T22:04:31Z"
+}

markspace-0.1.3b0/CITATION.cff

@@ -0,0 +1,24 @@
+cff-version: 1.2.0
+title: markspace
+message: "If you use this work, please cite it using the metadata below."
+type: software
+version: 0.1.3-beta
+date-released: 2026-03-23
+doi: 10.5281/zenodo.18990235
+url: https://github.com/opinionated-systems/markspace
+abstract: >
+  Markspace is a coordination protocol for LLM agent fleets based
+  on stigmergy - indirect coordination through traces left in a
+  shared environment. A deterministic guard layer at the environment
+  boundary enforces identity, scope, and conflict resolution outside
+  the agents, so safety guarantees hold independent of agent behavior.
+  The protocol defines five mark types encoding distinct epistemic
+  roles, three visibility levels, three conflict policies, and
+  trust-weighted decay. The included Python package is a reference
+  implementation used to verify 66 formal properties experimentally.
+authors:
+  - family-names: Loose
+    given-names: Andre
+    affiliation: Opinionated Systems, Inc.
+    email: andre@opinionated.systems
+license: MIT

markspace-0.1.3b0/LICENSE-CC-BY-4.0

@@ -0,0 +1,19 @@
+Creative Commons Attribution 4.0 International
+
+Copyright (c) Opinionated Systems, Inc.
+
+This license applies to the MarkSpace protocol specification and
+documentation files located in the docs/ directory.
+
+You are free to:
+
+  Share - copy and redistribute the material in any medium or format
+  Adapt - remix, transform, and build upon the material for any purpose,
+          including commercially
+
+Under the following terms:
+
+  Attribution - You must give appropriate credit, provide a link to the
+                license, and indicate if changes were made.
+
+Full legal text: https://creativecommons.org/licenses/by/4.0/legalcode

markspace-0.1.3b0/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Opinionated Systems, Inc.
+
+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.