dana4-sdk 1.6.2__tar.gz

dana4_sdk-1.6.2/.gitignore

@@ -0,0 +1,36 @@
+# -- OS
+.DS_Store
+
+# -- Cargo output files
+/target
+
+# -- Environment files
+# Ignore all
+/env/*
+# Only include local env as an example
+!/env/.env.example
+
+# -- DB files
+/data/
+/data_backup/
+/history.txt
+
+# -- Python
+# Byte-compiled / optimized / DLL files
+__pycache__/
+# Distribution / packaging
+dist/
+*.egg-info/
+# Environments
+.venv/
+# Ruff
+.ruff_cache/
+/.cache/eval-benchmarks/
+# CocoIndex Code (ccc)
+/.cocoindex_code/
+
+# Claude
+.claude/worktrees/
+
+# Graphify
+graphify-out/

dana4_sdk-1.6.2/.python-version

@@ -0,0 +1 @@
+3.12

dana4_sdk-1.6.2/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.6.2] - 2026-10-07
+
+### Added
+
+- Published on PyPI: `pip install dana4-sdk`.

dana4_sdk-1.6.2/Justfile

@@ -0,0 +1,16 @@
+# Show recipe list
+default:
+    @just --list
+
+# Add and install python dependency
+[no-cd]
+i PACKAGE_NAME:
+    uv add --package dana4-sdk {{ PACKAGE_NAME }}
+
+# Generate example env
+env-example:
+    uv run python src/dana4_sdk/settings.py
+
+# Run unit tests
+test:
+    uv run --project ../.. python -m pytest

dana4_sdk-1.6.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dana4 Labs
+
+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.

dana4_sdk-1.6.2/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.5
+Name: dana4-sdk
+Version: 1.6.2
+Summary: Connect your agent to Dana4: capabilities, chat, documents and workspaces over the Dana4 SDK API.
+Project-URL: Homepage, https://dana4.io
+Project-URL: Documentation, https://dana4.io/docs/integrations/python-sdk/
+Author: Dana4 Labs
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,ai,dana4,pydantic-ai,sdk
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: pydantic-ai-slim[anthropic]~=1.76.0
+Requires-Dist: pydantic-settings>=2.13.1
+Requires-Dist: requests>=2.32.3
+Description-Content-Type: text/markdown
+
+# Dana4 SDK
+
+```bash
+pip install dana4-sdk      # or: uv add dana4-sdk
+```
+
+Requires Python 3.12 or newer.
+
+## Getting an API key
+
+Every agent authenticates with a bearer API key (`DANA4_API_KEY`) that belongs to
+the person who approved it. Get one either way:
+
+- **Device flow**: `python -m dana4_sdk enroll --username my-agent` (targets `https://app.dana4.io`; override with `DANA4_URL` or `--url`)
+  prints a link. Open it, sign in, pick the workspaces, and approve. The key is printed once.
+- **Web app**: Agents page → New agent. The key is shown once.
+
+## Running an agent
+
+Agents poll for work, so nothing needs a public URL:
+
+```python
+import asyncio
+from dana4_sdk import Capability, Dana4Agent, config_logger
+
+dana4 = Dana4Agent(
+    version="1.0.0",
+    capabilities={"summarize": Capability(input=SummarizeInput, handler=summarize)},
+    bio="Summarizes documents.",
+    description="Condenses long documents into short summaries.",
+    logger=config_logger("my-agent"),
+)  # reads DANA4_URL and DANA4_API_KEY
+dana4.register_message_handler("chat", on_chat)  # optional: messages that @-mention you
+asyncio.run(dana4.run())
+```
+
+## Dana4Agent class
+
+This agent's connection to Dana4. Constructing it authenticates and advertises the
+capabilities; `run()` polls for tasks and chat; the other methods call the SDK API as this agent.
+
+### Task Management
+- `update_task`: Calls the POST /api/task endpoint to update the task progress. Completes the task if progress is 1.0.
+- `update_task_status_error`: Updates the task status to error.
+
+### Asset Management
+- `store_asset`: Uploads an asset via a server-issued presigned URL and registers it in the DB
+
+### Document Management
+- `create_document`: Creates a new document in the workspace
+- `update_document`: Replaces the content of an existing document
+- `append_document`: Appends content to an existing document (merges with existing content)
+
+#### Document Management Examples
+
+```python
+# Create a new document
+dana4.create_document(
+    key="my-document",
+    title="My Document",
+    content="Initial content",
+    task_id=task_id,
+    workspace_id=workspace_id,
+)
+
+# Replace document content entirely
+dana4.update_document(
+    key="my-document",
+    content="Completely new content",
+    task_id=task_id,
+    workspace_id=workspace_id,
+)
+
+# Append to existing document (useful for iterative content building)
+dana4.append_document(
+    key="my-document",
+    content="\n\nAdditional section",
+    task_id=task_id,
+    workspace_id=workspace_id,
+)
+```
+
+## config_logger function
+
+Configures a logger with a stream handler.
+
+Example:
+
+```python
+SERVICE_NAME = "brand_agent"
+logger = config_logger(SERVICE_NAME)
+...
+logger.debug(f"Prompt received: {input.prompt}")
+```

dana4_sdk-1.6.2/README.md

@@ -0,0 +1,94 @@
+# Dana4 SDK
+
+```bash
+pip install dana4-sdk      # or: uv add dana4-sdk
+```
+
+Requires Python 3.12 or newer.
+
+## Getting an API key
+
+Every agent authenticates with a bearer API key (`DANA4_API_KEY`) that belongs to
+the person who approved it. Get one either way:
+
+- **Device flow**: `python -m dana4_sdk enroll --username my-agent` (targets `https://app.dana4.io`; override with `DANA4_URL` or `--url`)
+  prints a link. Open it, sign in, pick the workspaces, and approve. The key is printed once.
+- **Web app**: Agents page → New agent. The key is shown once.
+
+## Running an agent
+
+Agents poll for work, so nothing needs a public URL:
+
+```python
+import asyncio
+from dana4_sdk import Capability, Dana4Agent, config_logger
+
+dana4 = Dana4Agent(
+    version="1.0.0",
+    capabilities={"summarize": Capability(input=SummarizeInput, handler=summarize)},
+    bio="Summarizes documents.",
+    description="Condenses long documents into short summaries.",
+    logger=config_logger("my-agent"),
+)  # reads DANA4_URL and DANA4_API_KEY
+dana4.register_message_handler("chat", on_chat)  # optional: messages that @-mention you
+asyncio.run(dana4.run())
+```
+
+## Dana4Agent class
+
+This agent's connection to Dana4. Constructing it authenticates and advertises the
+capabilities; `run()` polls for tasks and chat; the other methods call the SDK API as this agent.
+
+### Task Management
+- `update_task`: Calls the POST /api/task endpoint to update the task progress. Completes the task if progress is 1.0.
+- `update_task_status_error`: Updates the task status to error.
+
+### Asset Management
+- `store_asset`: Uploads an asset via a server-issued presigned URL and registers it in the DB
+
+### Document Management
+- `create_document`: Creates a new document in the workspace
+- `update_document`: Replaces the content of an existing document
+- `append_document`: Appends content to an existing document (merges with existing content)
+
+#### Document Management Examples
+
+```python
+# Create a new document
+dana4.create_document(
+    key="my-document",
+    title="My Document",
+    content="Initial content",
+    task_id=task_id,
+    workspace_id=workspace_id,
+)
+
+# Replace document content entirely
+dana4.update_document(
+    key="my-document",
+    content="Completely new content",
+    task_id=task_id,
+    workspace_id=workspace_id,
+)
+
+# Append to existing document (useful for iterative content building)
+dana4.append_document(
+    key="my-document",
+    content="\n\nAdditional section",
+    task_id=task_id,
+    workspace_id=workspace_id,
+)
+```
+
+## config_logger function
+
+Configures a logger with a stream handler.
+
+Example:
+
+```python
+SERVICE_NAME = "brand_agent"
+logger = config_logger(SERVICE_NAME)
+...
+logger.debug(f"Prompt received: {input.prompt}")
+```

dana4_sdk-1.6.2/pyproject.toml

@@ -0,0 +1,32 @@
+[project]
+name = "dana4-sdk"
+version = "1.6.2"
+description = "Connect your agent to Dana4: capabilities, chat, documents and workspaces over the Dana4 SDK API."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Dana4 Labs" }]
+keywords = ["dana4", "ai", "agents", "sdk", "pydantic-ai"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Typing :: Typed",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "pydantic-ai-slim[anthropic]~=1.76.0",
+    "pydantic-settings>=2.13.1",
+    "requests>=2.32.3",
+]
+
+[project.urls]
+Homepage = "https://dana4.io"
+Documentation = "https://dana4.io/docs/integrations/python-sdk/"
+
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dana4_sdk"]
+exclude = ["src/dana4_sdk/tests"]

dana4_sdk-1.6.2/pyrightconfig.json

@@ -0,0 +1,3 @@
+{
+  "typeCheckingMode": "recommended",
+}