Squatch Stack

What Squatch Stack (a software and hardware studio in the Missouri Ozarks) builds, and how to reach it.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Browse the Squatch Stack shop (tees, mugs, hats, stickers, posters, totes). Optional text search and kind filter. Prices in USD; tax and shipping are added at checkout.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Words to match in the product name, e.g. 'founder' or 'mug'",
      "type": "string",
      "maxLength": 60
    },
    "kind": {
      "type": "string",
      "enum": [
        "tee",
        "mug",
        "hat",
        "sticker",
        "poster",
        "tote",
        "desk mat"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Show the Squatch Stack goods as an interactive shop the person can browse: photos, colours and sizes, and a Buy button that opens the shop's secure checkout in their browser. Use it when someone wants to look around or buy. Optional search words or kind narrow it. Apps without interactive views get the same list as text.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Words to match, e.g. 'founder' or 'mug'",
      "type": "string",
      "maxLength": 60
    },
    "kind": {
      "type": "string",
      "enum": [
        "tee",
        "mug",
        "hat",
        "sticker",
        "poster",
        "tote",
        "desk mat"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Details for one Squatch Stack product by slug: description, every variant (color/size) with its variant_id and price.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9-]{1,80}$",
      "description": "Product slug from list_goods"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Build a Squatch Stack checkout link for the chosen variants. It does NOT buy anything: give the link to the person, who reviews the cart and pays on the shop's secure checkout (tax and shipping calculated there).

{
  "type": "object",
  "properties": {
    "items": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "variant_id": {
            "type": "string",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "description": "variant_id from get_good"
          },
          "quantity": {
            "default": 1,
            "type": "integer",
            "minimum": 1,
            "maximum": 10
          }
        },
        "required": [
          "variant_id"
        ]
      }
    }
  },
  "required": [
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Find essays from 'Wild Man of the Way' (24 walks on theplainlystated.com) by words, thinker (e.g. Zhuangzi, Seneca, Thoreau) or format. Returns titles, short excerpts and links.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 60
    },
    "format": {
      "type": "string",
      "enum": [
        "short walk",
        "lesson",
        "deep session"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One 'Wild Man of the Way' essay by number (1-24): title, thinkers, reading time, an opening excerpt and the link to read it in full.

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 24
    }
  },
  "required": [
    "n"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Make a ready-to-send email link (mailto) to Squatch Stack with a fitting subject and body. It sends nothing; the person opens it in their mail app.

{
  "type": "object",
  "properties": {
    "topic": {
      "default": "project",
      "type": "string",
      "enum": [
        "project",
        "press",
        "note"
      ]
    },
    "summary": {
      "description": "One or two lines about what they want, placed in the body",
      "type": "string",
      "maxLength": 400
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Tag every word of a 'Buffalo buffalo ...' sentence as city, animal or verb, with a plain-English gloss.

{
  "type": "object",
  "properties": {
    "sentence": {
      "type": "string",
      "maxLength": 400
    }
  },
  "required": [
    "sentence"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Suggest one 'Wild Man of the Way' essay that fits the minutes someone has right now, with a short excerpt and the link. Different each time.

{
  "type": "object",
  "properties": {
    "minutes": {
      "description": "How long they have to read, in minutes",
      "type": "integer",
      "minimum": 1,
      "maximum": 240
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Leave a request in the Squatch Stack inbox: a custom shirt or piece, details or an update on something, help with an order, or anything else. A person reads every one and answers from [email protected] if an email address is given. Returns a reference (SQ-XXXXXX) to check with request_status. It sends no email and charges nothing; the request and the address are kept for 180 days, then deleted. Ask the person before sending their email address.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "custom",
        "details",
        "update",
        "order",
        "other"
      ],
      "description": "custom = make something; details = more about a product or service; update = news on something already asked; order = help with an order; other"
    },
    "message": {
      "type": "string",
      "minLength": 10,
      "maxLength": 2000,
      "description": "What they want, in their words: what, how many, by when"
    },
    "contact": {
      "description": "An email address for the answer. Only with the person's say-so.",
      "type": "string",
      "maxLength": 254
    },
    "about": {
      "description": "Optional: a product slug, a walk number, or an order reference this is about",
      "type": "string",
      "maxLength": 80
    }
  },
  "required": [
    "kind",
    "message"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Where a request sent with request_custom has got to (received, read, replied, closed), and the studio's answer. With the private token (SQ-XXXXXX-XXXXXXXXXX) it shows the answer; with the short reference (SQ-XXXXXX) only the status. Never shows the original message or email address.

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string",
      "maxLength": 24,
      "description": "The token (SQ-XXXXXX-XXXXXXXXXX) or reference (SQ-XXXXXX) request_custom returned"
    }
  },
  "required": [
    "reference"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Who runs this server, how to verify it, exactly what each tool can and cannot do, what is kept, and the limits. Use it when someone asks whether they can trust a link or a request.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}