pointiv-extension-sdk 0.3.1

Python SDK for building Pointiv WASM extensions

pointiv-extension-sdk

Python SDK for Pointiv WASM extensions.

Install

pip install pointiv-extension-sdk

Setup

from pointiv_extension_sdk import Input, output, storage


def execute(input: Input) -> dict[str, str]:
    count = int(storage.read("run_count") or "0") + 1
    storage.write("run_count", str(count))
    result = output.text(f"Hello, {input.text or 'World'}! Run #{count}")
    return {"type": result.type, "value": result.value}

Build to WASM with componentize-py or your Pointiv Python toolchain, then set runtime: "wasm" and main: "extension.wasm" in pointiv-extension.json.

APIs

Module	Permission	What it does
storage	storage	Per-extension key/value store
clipboard	clipboard_read	Read clipboard
ai	ai	LLM completion
http	network	Outbound HTTP
google_calendar	google_calendar	Create Calendar events
google_gmail	google_gmail	Send Gmail
log	none	Log to ~/.pointiv/trace.jsonl

Calls without permission fail safely.

Manifest

{
  "name": "My Extension",
  "description": "What it does",
  "version": "1.0.0",
  "author": "your-name",
  "keywords": ["tag"],
  "runtime": "wasm",
  "main": "extension.wasm",
  "permissions": ["storage", "network", "google_calendar", "google_gmail"]
}

License

MIT