okto-pulse-core 0.1.1__tar.gz

okto_pulse_core-0.1.1/.gitignore

@@ -0,0 +1,37 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+
+# Environment
+.env
+.env.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Claude Code
+.claude/
+
+# Test
+.pytest_cache/
+htmlcov/
+.coverage
+
+# SQLite
+*.db
+
+# MCP config
+.mcp.json

okto_pulse_core-0.1.1/CLA.md

@@ -0,0 +1,47 @@
+# Contributor License Agreement
+
+Thank you for your interest in contributing to Okto Pulse, a project by Okto Labs.
+
+By submitting a contribution (code, documentation, or other materials) to this project, you agree to the following terms:
+
+## 1. Definitions
+
+- **"You"** means the individual or legal entity submitting a contribution.
+- **"Contribution"** means any original work of authorship submitted to the project, including modifications or additions to existing work.
+- **"Project"** means the Okto Pulse software and related repositories maintained by Okto Labs.
+
+## 2. Grant of Rights
+
+You grant to Okto Labs a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable license to:
+
+- Use, reproduce, modify, display, perform, sublicense, and distribute your Contribution as part of the Project
+- Relicense your Contribution under any license, including proprietary licenses
+
+## 3. Ownership
+
+You retain copyright ownership of your Contribution. This agreement does not transfer ownership — it grants a license.
+
+## 4. Representations
+
+You represent that:
+
+- You are legally entitled to grant the above license
+- Your Contribution is your original work (or you have the right to submit it)
+- Your Contribution does not violate any third party's rights
+- If your employer has rights to intellectual property that you create, you have received permission to make the Contribution on behalf of that employer, or your employer has waived such rights
+
+## 5. No Obligation
+
+Okto Labs is not obligated to use your Contribution. Contributions may be accepted, modified, or declined at the project maintainers' discretion.
+
+## 6. How to Sign
+
+By submitting a pull request to any Okto Pulse repository, you indicate your agreement with this CLA. No separate signature is required.
+
+If you are contributing on behalf of a company, please ensure an authorized representative agrees to these terms.
+
+---
+
+Contact: contact@oktolabs.ai
+
+Copyright 2024-2026 Okto Labs. All rights reserved.

okto_pulse_core-0.1.1/LICENSE

@@ -0,0 +1,109 @@
+Elastic License 2.0
+
+Acceptance. By using the software, you agree to all of the terms and
+conditions below.
+
+Copyright 2024-2026 Okto Labs
+
+1. Grant of License. The licensor grants you a non-exclusive, royalty-free,
+worldwide, non-sublicensable, non-transferable license to use, copy,
+distribute, make available, and prepare derivative works of the software,
+in each case subject to the limitations and conditions below.
+
+2. Limitations. You may not provide the software to third parties as a
+hosted or managed service, where the service provides users with access to
+any substantial set of the features or functionality of the software.
+You may not move, change, disable, or circumvent the license key
+functionality in the software, and you may not remove or obscure any
+functionality in the software that is protected by the license key.
+You may not alter, remove, or obscure any licensing, copyright, or other
+notices of the licensor in the software.
+
+3. Patent License. The licensor grants you a license, under any patent
+claims the licensor can license, or becomes able to license, to make, have
+made, use, sell, offer for sale, import and have imported the software.
+However, this license does not cover any patent claims that you cause to be
+infringed by modifications or additions to the software. If you or your
+company make any written claim that the software infringes or contributes
+to infringement of any patent, your patent license for the software granted
+under these terms ends immediately. Your company's patent license granted
+under these terms also ends immediately if your company makes any written
+claim that the software infringes or contributes to infringement of any
+patent.
+
+4. Distribution. You may not alter, remove, or obscure any licensing,
+copyright, or other notices of the licensor in the software. Any
+distribution of the software must include a copy of these terms and
+conditions, and anyone who receives the software from you is bound by these
+terms and conditions.
+
+5. Notices. You must include a copy of these terms with any distribution of
+the software. If you modify the software, you must mark the modifications
+clearly and include the date of the modifications.
+
+6. Termination. If you violate these terms, your licenses will terminate
+automatically. If the licensor notifies you of your violation, and you cease
+all violation of this license no later than 30 days after you receive that
+notice, your licenses will be reinstated retroactively. However, if you
+violate these terms after the reinstatement, all of your licenses will
+terminate permanently.
+
+7. No Other Rights. Except as expressly stated herein, no other rights or
+licenses are granted, express or implied.
+
+8. Limitation on Liability. As far as the law allows, the software comes as
+is, without any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use or nature of
+the software, under any kind of legal claim.
+
+9. Definitions.
+
+"Licensor" means Okto Labs and its
+affiliates.
+
+"Software" means the software the licensor makes available under these
+terms, including any portions, modifications, or derivative works.
+
+"You" means you, individually.
+
+"Your company" means any legal entity, sole proprietorship, or other
+organization that you work for, plus all other organizations that control,
+are controlled by, or are under common control with that organization. The
+term "control" means ownership of substantially all the assets of an entity.
+
+"Your licenses" means the licenses granted to you in Section 1.
+
+"Use" means anything you do with the software in violation of these terms.
+
+
+Addendum: SaaS and Competing Service Definition
+================================================
+
+For the purposes of Section 2 ("Limitations"), the following constitute
+providing the software as a "hosted or managed service":
+
+(a) Offering a hosted platform, application, or API where end users
+    interact with the features or functionality of the software, whether
+    directly or through a wrapper, proxy, or abstraction layer.
+
+(b) Providing the software as a white-label, embedded, or rebranded
+    offering to third parties.
+
+(c) Operating a multi-tenant service where the software's capabilities
+    are a primary value driver for the service offering.
+
+The following are expressly PERMITTED:
+
+(a) Using the software internally within your organization, including
+    for commercial purposes, without restriction.
+
+(b) Using the software to manage your own projects, teams, or products,
+    even in a commercial context.
+
+(c) Integrating the software's MCP tools with AI agents for your own
+    use or your organization's use.
+
+(d) Modifying the software for personal or internal organizational use.
+
+If you are unsure whether your intended use constitutes a competing service,
+contact the licensor at contact@oktolabs.ai for clarification.

okto_pulse_core-0.1.1/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: okto-pulse-core
+Version: 0.1.1
+Summary: Okto Pulse Core — spec-driven project management engine with MCP support for AI agents
+Project-URL: Homepage, https://github.com/OktoLabsAI/okto-pulse-core
+Project-URL: Documentation, https://github.com/OktoLabsAI/okto-pulse-core#readme
+Project-URL: Repository, https://github.com/OktoLabsAI/okto-pulse-core
+Project-URL: Issues, https://github.com/OktoLabsAI/okto-pulse-core/issues
+Author-email: Okto Labs <contact@oktolabs.ai>
+License: Elastic-2.0
+License-File: LICENSE
+Keywords: ai-agents,kanban,mcp,project-management,spec-driven
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Scheduling
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: aiofiles<26.0.0,>=23.2.0
+Requires-Dist: aiosqlite<1.0.0,>=0.19.0
+Requires-Dist: asyncpg<1.0.0,>=0.29
+Requires-Dist: fastapi<1.0.0,>=0.109.0
+Requires-Dist: fastmcp<3.0.0,>=2.0.0
+Requires-Dist: mcp<2.0.0,>=1.0.0
+Requires-Dist: pydantic-settings<3.0.0,>=2.1.0
+Requires-Dist: pydantic<3.0.0,>=2.5.0
+Requires-Dist: python-multipart<1.0.0,>=0.0.6
+Requires-Dist: sqlalchemy[asyncio]<3.0.0,>=2.0.0
+Requires-Dist: uvicorn[standard]<1.0.0,>=0.27.0
+Description-Content-Type: text/markdown
+
+# okto-pulse-core
+
+Core engine for [Okto Pulse](https://github.com/OktoLabsAI/okto-pulse) — shared models, services, API routes, and MCP server.
+
+> **You probably want to install [`okto-pulse`](https://pypi.org/project/okto-pulse/) instead.**
+> This package is the internal engine. The `okto-pulse` package provides the CLI, frontend, and everything you need to get started.
+
+## What's inside
+
+- **27 SQLAlchemy models** — Boards, Cards, Specs, Ideations, Refinements, Agents, etc.
+- **18 service classes** — Full business logic with governance rules
+- **11 API route modules** — FastAPI REST endpoints
+- **119+ MCP tools** — Complete Model Context Protocol server for AI agent integration
+- **App factory** — `create_app()` with dependency injection for auth and storage providers
+
+## License
+
+[Elastic License 2.0](./LICENSE) — free for personal and commercial use. Cannot be offered as a hosted/managed service.

okto_pulse_core-0.1.1/README.md

@@ -0,0 +1,18 @@
+# okto-pulse-core
+
+Core engine for [Okto Pulse](https://github.com/OktoLabsAI/okto-pulse) — shared models, services, API routes, and MCP server.
+
+> **You probably want to install [`okto-pulse`](https://pypi.org/project/okto-pulse/) instead.**
+> This package is the internal engine. The `okto-pulse` package provides the CLI, frontend, and everything you need to get started.
+
+## What's inside
+
+- **27 SQLAlchemy models** — Boards, Cards, Specs, Ideations, Refinements, Agents, etc.
+- **18 service classes** — Full business logic with governance rules
+- **11 API route modules** — FastAPI REST endpoints
+- **119+ MCP tools** — Complete Model Context Protocol server for AI agent integration
+- **App factory** — `create_app()` with dependency injection for auth and storage providers
+
+## License
+
+[Elastic License 2.0](./LICENSE) — free for personal and commercial use. Cannot be offered as a hosted/managed service.

okto_pulse_core-0.1.1/TRADEMARKS.md

@@ -0,0 +1,49 @@
+# Trademark Policy
+
+## Trademarks
+
+The following are trademarks of Okto Labs:
+
+- **Okto Labs** — the company name and brand
+- **Okto Pulse** — the product name
+- **OktoLabs logo** — the octopus/circuit design mark (all variants)
+
+## Permitted Use
+
+You **may**:
+
+- State that your project is "based on Okto Pulse" or "compatible with Okto Pulse"
+- Use the project name in factual references (documentation, articles, comparisons)
+- Use the name when required by the license attribution notice
+
+## Prohibited Use
+
+You **may not** without prior written authorization:
+
+- Use "Okto Pulse", "Okto Labs", or the logo in your product name, service name, or domain name
+- Create the impression that your product or service is endorsed, sponsored, or affiliated with Okto Labs
+- Use the logo or any confusingly similar mark in your product's interface, marketing, or branding
+- Offer a product or service under a name that includes "Okto" in combination with "Pulse", "Labs", or similar terms
+
+## Derivative Works and Forks
+
+If you create a fork or derivative work:
+
+- You **must remove** all Okto Labs trademarks, logos, and branding from the software
+- You **must choose** a distinct name that does not suggest affiliation with Okto Labs
+- You **must retain** the copyright and license notices as required by the license
+
+## Logo Usage
+
+The OktoLabs logo files included in this repository (`logo-light.jpg`, `logo-dark.jpg`, `favicon.jpg`) are provided solely for use within unmodified distributions of the software. They may not be used in derivative works, forks, or third-party products.
+
+## Contact
+
+For trademark usage requests or questions:
+
+- Email: contact@oktolabs.ai
+- GitHub: https://github.com/OktoLabsAI
+
+---
+
+Copyright 2024-2026 Okto Labs. All rights reserved.

okto_pulse_core-0.1.1/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "okto-pulse-core"
+version = "0.1.1"
+description = "Okto Pulse Core — spec-driven project management engine with MCP support for AI agents"
+requires-python = ">=3.11"
+license = {text = "Elastic-2.0"}
+authors = [
+    {name = "Okto Labs", email = "contact@oktolabs.ai"},
+]
+keywords = ["kanban", "project-management", "mcp", "ai-agents", "spec-driven"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Office/Business :: Scheduling",
+    "Framework :: FastAPI",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "fastapi>=0.109.0,<1.0.0",
+    "uvicorn[standard]>=0.27.0,<1.0.0",
+    "pydantic>=2.5.0,<3.0.0",
+    "pydantic-settings>=2.1.0,<3.0.0",
+    "aiofiles>=23.2.0,<26.0.0",
+    "python-multipart>=0.0.6,<1.0.0",
+    "sqlalchemy[asyncio]>=2.0.0,<3.0.0",
+    "aiosqlite>=0.19.0,<1.0.0",
+    "asyncpg>=0.29,<1.0.0",
+    "fastmcp>=2.0.0,<3.0.0",
+    "mcp>=1.0.0,<2.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/OktoLabsAI/okto-pulse-core"
+Documentation = "https://github.com/OktoLabsAI/okto-pulse-core#readme"
+Repository = "https://github.com/OktoLabsAI/okto-pulse-core"
+Issues = "https://github.com/OktoLabsAI/okto-pulse-core/issues"
+
+[project.readme]
+file = "README.md"
+content-type = "text/markdown"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/okto_pulse"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"src/okto_pulse/core/mcp/agent_instructions.md" = "okto_pulse/core/mcp/agent_instructions.md"

okto_pulse_core-0.1.1/src/okto_pulse/core/__init__.py

@@ -0,0 +1,12 @@
+"""Okto Pulse Core — shared logic for all editions."""
+
+__version__ = "0.1.0"
+
+from okto_pulse.core.infra.auth import (
+    AuthProvider, configure_auth, get_auth_provider,
+    get_current_user, get_current_user_id, get_realm_id, require_user,
+)
+from okto_pulse.core.infra.config import CoreSettings, get_settings, configure_settings
+from okto_pulse.core.infra.database import Base, get_db, get_db_session, init_db, close_db
+from okto_pulse.core.infra.permissions import Permissions, check_permission, has_permission
+from okto_pulse.core.infra.storage import StorageProvider, FileSystemStorageProvider, configure_storage, get_storage_provider

okto_pulse_core-0.1.1/src/okto_pulse/core/api/__init__.py

@@ -0,0 +1,4 @@
+"""Core API routes."""
+from okto_pulse.core.api.router import api_router
+
+__all__ = ["api_router"]

okto_pulse_core-0.1.1/src/okto_pulse/core/api/agents.py

@@ -0,0 +1,210 @@
+"""Agent API endpoints."""
+
+from fastapi import APIRouter, Depends, HTTPException, status
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from okto_pulse.core.infra.auth import require_user
+from okto_pulse.core.infra.database import get_db
+from okto_pulse.core.models import (
+    AgentBoardOverridesUpdate,
+    AgentBoardResponse,
+    AgentCreate,
+    AgentResponse,
+    AgentSummary,
+    AgentUpdate,
+)
+from okto_pulse.core.services import AgentService, BoardService
+
+router = APIRouter()
+
+
+# ---------------------------------------------------------------------------
+# Global agent CRUD (ownership via created_by)
+# ---------------------------------------------------------------------------
+
+
+@router.post("", response_model=AgentResponse, status_code=status.HTTP_201_CREATED)
+async def create_agent(
+    data: AgentCreate,
+    user_id: str = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """Create a new global agent (not tied to any board)."""
+    service = AgentService(db)
+    agent, api_key = await service.create_agent(user_id, data)
+    await db.commit()
+    agent = await service.get_agent(agent.id)
+
+    response = AgentResponse.model_validate(agent)
+    response.api_key = api_key
+    return response
+
+
+@router.get("", response_model=list[AgentResponse])
+async def list_my_agents(
+    user_id: str = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """List all agents owned by the current user (with api_key)."""
+    service = AgentService(db)
+    agents = await service.list_agents_for_user(user_id)
+    return agents
+
+
+@router.get("/board/{board_id}", response_model=list[AgentSummary])
+async def list_agents_for_board(
+    board_id: str,
+    user_id: str = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """List all agents with access to a board."""
+    board_service = BoardService(db)
+    board = await board_service.get_board(board_id, user_id)
+    if not board:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Board not found")
+
+    service = AgentService(db)
+    agents = await service.list_agents_for_board(board_id)
+    return agents
+
+
+@router.get("/{agent_id}", response_model=AgentResponse)
+async def get_agent(
+    agent_id: str,
+    user_id: str = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """Get an agent by ID (owner only)."""
+    service = AgentService(db)
+    agent = await service.get_agent(agent_id)
+    if not agent or agent.created_by != user_id:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Agent not found")
+    return agent
+
+
+@router.patch("/{agent_id}", response_model=AgentResponse)
+async def update_agent(
+    agent_id: str,
+    data: AgentUpdate,
+    user_id: str = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """Update an agent (owner only)."""
+    service = AgentService(db)
+    agent = await service.get_agent(agent_id)
+    if not agent or agent.created_by != user_id:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Agent not found")
+
+    updated = await service.update_agent(agent_id, data)
+    await db.commit()
+    updated = await service.get_agent(agent_id)
+    return updated
+
+
+@router.post("/{agent_id}/regenerate-key", response_model=dict)
+async def regenerate_agent_key(
+    agent_id: str,
+    user_id: str = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """Regenerate an agent's API key (owner only)."""
+    service = AgentService(db)
+    agent = await service.get_agent(agent_id)
+    if not agent or agent.created_by != user_id:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Agent not found")
+
+    updated, new_key = await service.regenerate_key(agent_id)
+    await db.commit()
+
+    return {"message": "API key regenerated", "api_key": new_key}
+
+
+@router.delete("/{agent_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_agent(
+    agent_id: str,
+    user_id: str = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """Delete an agent (owner only)."""
+    service = AgentService(db)
+    agent = await service.get_agent(agent_id)
+    if not agent or agent.created_by != user_id:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Agent not found")
+
+    await service.delete_agent(agent_id)
+    await db.commit()
+
+
+# ---------------------------------------------------------------------------
+# Board access grant / revoke
+# ---------------------------------------------------------------------------
+
+
+@router.post(
+    "/{agent_id}/boards/{board_id}",
+    response_model=AgentBoardResponse,
+    status_code=status.HTTP_201_CREATED,
+)
+async def grant_board_access(
+    agent_id: str,
+    board_id: str,
+    user_id: str = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """Grant an agent access to a board. Requires owning both the agent and the board."""
+    service = AgentService(db)
+    agent = await service.get_agent(agent_id)
+    if not agent or agent.created_by != user_id:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Agent not found")
+
+    board_service = BoardService(db)
+    board = await board_service.get_board(board_id, user_id)
+    if not board:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Board not found")
+
+    if await service.agent_has_board_access(agent_id, board_id):
+        raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail="Access already granted")
+
+    grant = await service.grant_board_access(agent_id, board_id, user_id)
+    await db.commit()
+    return grant
+
+
+@router.patch("/{agent_id}/boards/{board_id}", response_model=AgentBoardResponse)
+async def update_board_overrides(
+    agent_id: str,
+    board_id: str,
+    data: AgentBoardOverridesUpdate,
+    user_id: str = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """Update permission overrides for an agent on a board (ceiling model)."""
+    service = AgentService(db)
+    agent = await service.get_agent(agent_id)
+    if not agent or agent.created_by != user_id:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Agent not found")
+
+    ab = await service.update_board_overrides(agent_id, board_id, data.permission_overrides)
+    if not ab:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Board access not found")
+    await db.commit()
+    return ab
+
+
+@router.delete("/{agent_id}/boards/{board_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def revoke_board_access(
+    agent_id: str,
+    board_id: str,
+    user_id: str = Depends(require_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """Revoke an agent's access to a board. Requires owning the agent or the board."""
+    service = AgentService(db)
+    agent = await service.get_agent(agent_id)
+    if not agent or agent.created_by != user_id:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Agent not found")
+
+    revoked = await service.revoke_board_access(agent_id, board_id)
+    if not revoked:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Access not found")
+    await db.commit()