pointiv-extension-sdk 0.3.4

Python SDK for building Pointiv WASM extensions

pointiv-extension-sdk

Python SDK for Pointiv WASM extensions.

Install

pip install pointiv-extension-sdk

Setup

extism-py requires @extism.import_fn host bindings in the compiled entry file. Declare them in host_bindings.py, wire the SDK with bind, then build a merged entry:

# host_bindings.py
import extism
from pointiv_extension_sdk import bind

@extism.import_fn("extism:host", "pointiv_storage_read")
def pointiv_storage_read(key: str) -> str: pass

@extism.import_fn("extism:host", "pointiv_storage_write")
def pointiv_storage_write(key: str, value: str): pass

@extism.import_fn("extism:host", "pointiv_storage_delete")
def pointiv_storage_delete(key: str): pass

bind.storage_hosts(pointiv_storage_read, pointiv_storage_write, pointiv_storage_delete)

cat host_bindings.py main.py > entry.py
extism-py entry.py -o extension.wasm

See the Python starter for a full example.

Build to WASM with extism-py, 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.

Python/WASM limitations

extism-py cannot call zero-argument host functions reliably. These APIs raise NotImplementedError in Python/WASM builds:

• storage.list()
• clipboard.read()

Use storage.read() / storage.write() / storage.delete() instead. Host functions use the extism:host namespace (Pointiv registers both extism:host and extism:host/user).

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