Decode an AIPM 1.0 URL

Copy this script and run it with any Python 3.x installation. No external dependencies — standard library only. This is the most durable decode method.

#!/usr/bin/env python3
"""
AIPM 1.0 URL decoder — stdlib only, no external dependencies.
Specification: https://aipmq.org/1.0/spec/

Usage:
  python3 aipm_decode.py 'https://aipmq.org/1.0/aipm/?v=1.0&role=prompted&...'
  python3 aipm_decode.py        # paste URL when prompted
"""
import sys, json, zlib, base64
from urllib.parse import urlparse, parse_qs


FIELD_LABELS = {
    'v':      'AIPM version',
    'role':   'Human role',
    'model':  'AI model',
    'ctx':    'Context / prompt',
    'date':   'Date',
    'show':   'Show mode',
    'src':    'Content URL',
    'hs':     'Content hash (SHA)',
    'type':   'Content type',
    'doc':    'Full Context Document URL',
    'hd':     'Document hash (SHA)',
    'author': 'Author',
    'org':    'Organisation',
    'lang':   'Language',
    'prev':   'Previous mark URL',
    'qr':     'QR only (qr=0 = URL only)',
}


def decode_aipm_url(url: str) -> dict:
    """Parse an AIPM URL and return its metadata fields."""
    parsed = urlparse(url.strip())
    fragment = parsed.query  # AIPM 1.0 used query params, not hash fragments
    if not fragment:
        raise ValueError("No hash fragment found in URL. "
                         "AIPM metadata lives after the '#' character.")

    params = parse_qs(fragment, keep_blank_values=True)
    get = lambda k: params.get(k, [None])[0]

    z = get('z')
    if z:
        # Decompress deflate-raw + base64url payload (AIPM 1.1+)
        b64 = z.replace('-', '+').replace('_', '/')
        b64 += '=' * (-len(b64) % 4)   # restore base64 padding
        raw = base64.b64decode(b64)
        # wbits=-15 → raw DEFLATE (RFC 1951), no zlib/gzip wrapper
        return json.loads(zlib.decompress(raw, wbits=-15))
    else:
        # Plain params (human-readable, no compression)
        fields = ['v', 'role', 'model', 'ctx', 'date', 'show',
                  'src', 'hs', 'type', 'doc', 'hd',
                  'author', 'org', 'lang', 'prev', 'qr']
        return {k: get(k) for k in fields if get(k) is not None}


def main():
    if len(sys.argv) > 1:
        url = ' '.join(sys.argv[1:])
    else:
        url = input('Paste AIPM URL: ').strip()

    data = decode_aipm_url(url)
    print()
    max_label = max((len(FIELD_LABELS.get(k, k)) for k in data), default=10)
    for k, v in data.items():
        label = FIELD_LABELS.get(k, k)
        print(f'  {label:<{max_label}} : {v}')
    print()


if __name__ == '__main__':
    main()