oneshot-python 0.10.1__tar.gz → 0.12.0__tar.gz

{oneshot_python-0.10.1 → oneshot_python-0.12.0}/.gitignore

@@ -81,3 +81,12 @@ apps/video-service/out/
 
 # Simulate-players pool (auto-generated, contains player IDs)
 scripts/.simulate-pool.json
+
+# x402 Bazaar seeder wallet (ephemeral, holds a private key during a partial run)
+scripts/.seed-wallet.json
+
+# Generated digest outputs from scripts/weekly-signal-digest.ts
+output/
+
+# Claude Code agent metadata (lockfile + local settings)
+.claude/

{oneshot_python-0.10.1 → oneshot_python-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oneshot-python
-Version: 0.10.1
+Version: 0.12.0
 Summary: Core Python SDK for the OneShot API — HTTP client with x402 payment handling
 License-Expression: MIT
 Requires-Python: >=3.10

{oneshot_python-0.10.1 → oneshot_python-0.12.0}/README.md

@@ -87,6 +87,37 @@ The SDK operates on **Base Mainnet** with real USDC. Fund your wallet before mak
 - `call_free_post(endpoint, payload=None)` / `acall_free_post(...)` — POST
 - `call_free_patch(endpoint, payload=None)` / `acall_free_patch(...)` — PATCH
 
+### Compute — autonomous goal orchestration
+
+Launch a compute goal and let the orchestrator plan, execute, and iterate. Paid via x402 (same flow as other tools).
+
+```python
+goal = client.compute(
+    objective="Research the top 10 AI startups and build a comparison website",
+    budget_usdc=5.00,
+    max_cost=10.00,
+)
+print(goal["goal_id"])
+
+# Observe
+status = client.get_compute_goal(goal["goal_id"])
+tasks = client.get_compute_tasks(goal["goal_id"])
+budget = client.get_compute_budget(goal["goal_id"])
+
+# Top up a recurring goal (paid)
+client.fund_compute_goal(goal["goal_id"], 10.00)
+
+# Lifecycle
+client.pause_compute_goal(goal["goal_id"])
+client.resume_compute_goal(goal["goal_id"])
+client.cancel_compute_goal(goal["goal_id"], reason="done")
+
+# HITL — respond to an approval task
+client.respond_to_compute_task(goal["goal_id"], "task_01H…", approved=True)
+```
+
+Every method has an `a*` async mirror (`acompute`, `aget_compute_goal`, …).
+
 ## Requirements
 
 - Python 3.10+

oneshot_python-0.12.0/oneshot/__init__.py

@@ -0,0 +1,47 @@
+"""oneshot-python — Core Python SDK for the OneShot API."""
+
+from oneshot._errors import (
+    ContentBlockedError,
+    EmergencyNumberError,
+    JobError,
+    JobTimeoutError,
+    OneShotError,
+    ToolError,
+    ValidationError,
+)
+from oneshot._types import (
+    ComputeBudgetStatus,
+    ComputeCancelResult,
+    ComputeFundResult,
+    ComputeGoalResult,
+    ComputeGoalStatus,
+    ComputePauseResult,
+    ComputeResumeResult,
+    ComputeSchedule,
+    ComputeTask,
+    ComputeTaskResponseResult,
+)
+from oneshot.client import OneShotClient
+from oneshot.x402 import sign_payment_authorization
+
+__all__ = [
+    "OneShotClient",
+    "OneShotError",
+    "ToolError",
+    "JobError",
+    "JobTimeoutError",
+    "ValidationError",
+    "ContentBlockedError",
+    "EmergencyNumberError",
+    "sign_payment_authorization",
+    "ComputeSchedule",
+    "ComputeGoalResult",
+    "ComputeGoalStatus",
+    "ComputeTask",
+    "ComputeBudgetStatus",
+    "ComputeCancelResult",
+    "ComputeTaskResponseResult",
+    "ComputePauseResult",
+    "ComputeResumeResult",
+    "ComputeFundResult",
+]

{oneshot_python-0.10.1 → oneshot_python-0.12.0}/oneshot/_errors.py

@@ -46,3 +46,11 @@ class ContentBlockedError(OneShotError):
     def __init__(self, message: str, categories: list[str]) -> None:
         super().__init__(message)
         self.categories = categories
+
+
+class EmergencyNumberError(OneShotError):
+    """Voice call rejected because the target number is an emergency line."""
+
+    def __init__(self, message: str, blocked_number: str) -> None:
+        super().__init__(message)
+        self.blocked_number = blocked_number

oneshot_python-0.12.0/oneshot/_types.py

@@ -0,0 +1,178 @@
+"""Type hints for the compute orchestration API.
+
+These TypedDicts mirror libs/agent-sdk/src/types.ts field-for-field. They are
+optional at runtime — `OneShotClient` continues to return raw dicts — but
+expose the shape to IDEs and `mypy` so callers get auto-complete + type
+checking when they want it.
+
+Keep the field set IN SYNC with the TS interfaces. If you add a field here,
+add it there (and vice versa).
+"""
+
+from __future__ import annotations
+
+from typing import Any, Optional, TypedDict
+
+
+class ComputeSchedule(TypedDict, total=False):
+    """Recurring-goal schedule. Mirrors `ComputeSchedule` in TS."""
+
+    cron: str
+    budget_per_run: float
+    max_runs: int
+
+
+class ComputeGoalInner(TypedDict, total=False):
+    objective: str
+    budget_usdc: str
+    deadline: str
+    schedule_cron: str
+    budget_per_run: float
+    max_runs: int
+    next_run_at: str
+
+
+class ComputeGoalResult(TypedDict, total=False):
+    """Returned by `compute()` / `acompute()` after the goal is created."""
+
+    goal_id: str
+    request_id: str
+    receipt_id: str
+    status: str
+    message: str
+    memo: str
+    cost: float
+    goal: ComputeGoalInner
+
+
+class ComputeBudgetInner(TypedDict, total=False):
+    total: str
+    spent: str
+    reserved: str
+    remaining: str
+
+
+class ComputeGoalScheduleInner(TypedDict, total=False):
+    cron: str
+    budget_per_run: str
+    max_runs: Optional[int]
+    run_count: int
+    last_run_at: Optional[str]
+    next_run_at: Optional[str]
+
+
+class ComputeGoalStatus(TypedDict, total=False):
+    """Returned by `get_compute_goal()` / `aget_compute_goal()`."""
+
+    id: str
+    status: str
+    name: str
+    objective: str
+    current_phase: Optional[int]
+    plan: Any
+    budget: Optional[ComputeBudgetInner]
+    soul_agent_id: Optional[str]
+    deadline: Optional[str]
+    started_at: Optional[str]
+    completed_at: Optional[str]
+    last_wake_at: Optional[str]
+    next_wake_at: Optional[str]
+    created_at: str
+    schedule: ComputeGoalScheduleInner
+
+
+class ComputeTask(TypedDict, total=False):
+    """Single item from `get_compute_tasks()` / `aget_compute_tasks()`."""
+
+    id: str
+    task_type: str
+    tool: Optional[str]
+    description: str
+    status: str
+    phase: Optional[int]
+    sequence: Optional[int]
+    progress_pct: Optional[float]
+    progress_message: Optional[str]
+    result: Any
+    quoted_usdc: Optional[str]
+    actual_usdc: Optional[str]
+    run_number: Optional[int]
+    started_at: Optional[str]
+    completed_at: Optional[str]
+    created_at: str
+
+
+class ComputeBudgetSpendEntry(TypedDict, total=False):
+    category: str
+    amount_usdc: str
+    description: str
+    created_at: str
+
+
+class ComputeBudgetStatus(TypedDict, total=False):
+    """Returned by `get_compute_budget()` / `aget_compute_budget()`."""
+
+    budgetId: str
+    goalId: str
+    totalBudgetUsdc: str
+    spentUsdc: str
+    reservedUsdc: str
+    remainingUsdc: str
+    spend_entries: list[ComputeBudgetSpendEntry]
+
+
+class ComputeCancelResult(TypedDict, total=False):
+    """Returned by `cancel_compute_goal()`."""
+
+    goal_id: str
+    status: str
+    remaining_budget: str
+
+
+class ComputeTaskResponseResult(TypedDict, total=False):
+    """Returned by `respond_to_compute_task()`."""
+
+    task_id: str
+    goal_id: str
+    task_status: str
+    orchestrator_action: str
+
+
+class ComputePauseResult(TypedDict, total=False):
+    """Returned by `pause_compute_goal()`."""
+
+    goal_id: str
+    status: str
+    run_count: int
+
+
+class ComputeResumeResult(TypedDict, total=False):
+    """Returned by `resume_compute_goal()`."""
+
+    goal_id: str
+    status: str
+    next_run_at: str
+    run_count: int
+
+
+class ComputeFundResult(TypedDict, total=False):
+    """Returned by `fund_compute_goal()`."""
+
+    goal_id: str
+    topped_up: float
+    total_budget: str
+    remaining: str
+
+
+__all__ = [
+    "ComputeSchedule",
+    "ComputeGoalResult",
+    "ComputeGoalStatus",
+    "ComputeTask",
+    "ComputeBudgetStatus",
+    "ComputeCancelResult",
+    "ComputeTaskResponseResult",
+    "ComputePauseResult",
+    "ComputeResumeResult",
+    "ComputeFundResult",
+]