← SamvaCONTENT HISTORY

Update to Samva

Snapshot Oct 2, 2026 · 12:02 UTC · version 1.0.0

Collection source: downloaded plugin package.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Integrate and operate Samva email across the Promise and Effect TypeScript SDKs, REST API, CLI, hosted MCP server, dashboard, and SML template editor. Use for sending and tracking email, domains and senders, inbound receiving, webhooks, templates, schedules, campaigns, usage, readiness, authentication, or choosing the right Samva surface. Triggers on samva, samva.dev, the `samva` package, `@samva/cli`, mcp.samva.dev, SAMVA_API_KEY, SML, Samva Markup Language, and template editor agent.",
  "included_files": [
    {
      "relative_path": "references/auth.md",
      "size_in_bytes": 2735
    },
    {
      "relative_path": "references/cli.md",
      "size_in_bytes": 10663
    },
    {
      "relative_path": "references/executor.md",
      "size_in_bytes": 1203
    },
    {
      "relative_path": "references/mcp.md",
      "size_in_bytes": 7795
    },
    {
      "relative_path": "references/sdk.md",
      "size_in_bytes": 5394
    },
    {
      "relative_path": "references/template-authoring.md",
      "size_in_bytes": 8337
    }
  ],
  "name": "samva",
  "skill_md_contents": "---\nname: samva\ndescription: >-\n  Integrate and operate Samva email across the Promise and Effect TypeScript\n  SDKs, REST API, CLI, hosted MCP server, dashboard, and SML template editor.\n  Use for sending and tracking email, domains and senders, inbound receiving,\n  webhooks, templates, schedules, campaigns, usage, readiness, authentication,\n  or choosing the right Samva surface. Triggers on samva, samva.dev, the\n  `samva` package, `@samva/cli`, mcp.samva.dev, SAMVA_API_KEY, SML, Samva\n  Markup Language, and template editor agent.\nmetadata:\n  version: 0.2.2\n---\n\n# Samva\n\nUse Samva's organization-scoped email surfaces for transactional sends,\ntemplates, scheduled email, campaigns, inbound receiving, webhooks, and\noperational checks.\n\n## Choose the surface\n\n```text\nWhat is the intent?\n├─ Add Samva to async/await TypeScript code   → Promise SDK (`samva` or `samva/promises`)\n├─ Add Samva to an Effect application         → Effect SDK (`samva/effect`)\n├─ Call Samva from another runtime            → REST (`https://api.samva.dev/v1`)\n├─ Run or script terminal workflows           → CLI (`@samva/cli`)\n├─ Give an AI agent live Samva tools           → hosted MCP (`https://mcp.samva.dev`)\n├─ Configure or inspect resources visually     → dashboard (`https://samva.dev`)\n└─ Author or repair an SML email template      → template authoring reference\n```\n\n| Surface     | Best for                                   | Authentication                   |\n| ----------- | ------------------------------------------ | -------------------------------- |\n| Promise SDK | TypeScript with Promises                   | API key or OAuth bearer          |\n| Effect SDK  | Native typed Effect programs               | API key or OAuth bearer          |\n| REST        | Non-TypeScript runtimes and direct HTTP    | API key or OAuth bearer          |\n| CLI         | Terminal automation and operator workflows | `SAMVA_API_KEY` or `samva login` |\n| Hosted MCP  | Agents taking live actions                 | API key or OAuth                 |\n| Dashboard   | Visual setup, inspection, and billing      | Browser session                  |\n\nRead only the reference needed for the selected surface:\n\n- [SDK and REST](references/sdk.md): Promise SDK, Effect SDK, and direct HTTP.\n- [CLI](references/cli.md): installation, authentication, and shipped command families.\n- [Hosted MCP](references/mcp.md): endpoint, public tool families, resources, and safe retries.\n- [Template authoring](references/template-authoring.md): revision-safe SML editing and QA.\n- [Authentication](references/auth.md): API keys, OAuth, and organization scoping.\n- [Executor](references/executor.md): add Samva's MCP or REST surface to an Executor workspace.\n\n## Common operating rules\n\n1. Authenticate with an API key for unattended work. Use OAuth for interactive multi-organization\n   work.\n2. Keep the organization implicit with an API key. For OAuth, select or send the organization slug.\n3. Use a stable idempotency key for any send that an automation may retry. Reuse the same key only\n   for the same logical request.\n4. Read a resource after mutating it when later work depends on its current status or revision.\n5. Keep secrets in environment variables. Production API keys start with `samva_sk_live_`; keys\n   outside production start with `samva_sk_test_`.\n\nProduction API base URL: `https://api.samva.dev/v1`.\n\nHosted MCP endpoint: `https://mcp.samva.dev`.\n"
}

SHA-256 of public snapshot: 468e38616ede5ecfa32a4282760370fee58e2c93ca8211d02f4fbe2087eb582f