despia-legacy/extension-skill

despia-v3-extensions

Write a Despia V3 Extension, native Swift (iOS) and Kotlin or Java (Android) code that a Despia V3 web-view app calls with extension:// / .

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/despia-legacy/extension-skill --skill despia-v3-extensions

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Despia V3 Extensions

For the Despia V3 runtime only, and experimental. You write native files, describe them in a JSON manifest, and serve them from the web app. Despia approves the files and compiles them into a new native build. The page then calls extension://<name>/<route>?<params>. All facts are in references/; read the file for the step you are on. Never invent manifest fields, types, hooks or error codes. If a fact is not in the references, say so and point to https://docs.despia.com/experiments/v3-extensions .

Workflow

  1. Confirm the app is on Despia V3 and the capability is not already a Despia feature. Read references/limits.md and tell the user the platform limits that apply.
  2. Lay out public/despia/extensions.json and public/despia/<name>/manifest.json with ios/ and android/ beside it (references/manifest.md). The folder name is the extension id and matches [a-z][a-z0-9]{1,23}.
  3. Declare each route, its typed parameters (string, int, bool, enum, https_url), its output variable and callback, and any events (references/manifest.md, references/routes-and-answers.md).
  4. Write the iOS handler (references/ios.md) and the Android handler (references/android.md). Answer every call once, with data or an error code and message.
  5. Declare native work as typed or custom (references/manifest.md). Dependencies must be pinned files in the approval; nothing is downloaded at build time.
  6. Write the web call and its answer handling (references/routes-and-answers.md).
  7. Copy the pattern from examples/recorder/ (the Background Recorder sample, notes in references/recorder-sample.md) when a complete template helps.
  8. Tell the user the approval flow: Despia approves extensions.json and every referenced file, each manifest.json included. Any change needs a new approval and a new native build, never over-the-air. Extensions are enabled per app by Despia. The user owns and maintains the native code; Despia does not support customised code.

Rules

  • Never set what the build owns (bundle id, versions, signing, URL types, App Transport Security, purpose strings and permissions set in Despia, push and associated-domain entitlements). See references/manifest.md.
  • Every file must be named in its manifest.json; hidden files are refused; keep large data native and pass identifiers through the bridge.
  • Do not claim V4 support. First-party V4 support comes through the new package registry.

Docs: https://docs.despia.com/experiments/v3-extensions and https://docs.despia.com/experiments/samples/recorder