aimeat 1.2.0 → 1.2.2

package/dist/src/auth/keypair.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keypair.d.ts","sourceRoot":"","sources":["../../../src/auth/keypair.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAOxD;AAED,wBAAsB,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKrF;AAED,wBAAsB,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAShH"}
+{"version":3,"file":"keypair.d.ts","sourceRoot":"","sources":["../../../src/auth/keypair.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAOxD;AAED,wBAAsB,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKrF;AAED,wBAAsB,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAShH"}

package/dist/src/auth/keypair.js

@@ -1,12 +1,4 @@
 import * as ed from '@noble/ed25519';
-import { createHash } from 'node:crypto';
-// noble/ed25519 v2+ requires setting the sha512 sync function
-ed.etc.sha512Sync = (...m) => {
-    const hash = createHash('sha512');
-    for (const chunk of m)
-        hash.update(chunk);
-    return new Uint8Array(hash.digest());
-};
 export async function generateKeyPair() {
     const privateKeyBytes = ed.utils.randomSecretKey();
     const publicKeyBytes = await ed.getPublicKeyAsync(privateKeyBytes);

package/dist/src/auth/keypair.js.map

@@ -1 +1 @@
-{"version":3,"file":"keypair.js","sourceRoot":"","sources":["../../../src/auth/keypair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,8DAA8D;AAC7D,EAAE,CAAC,GAAW,CAAC,UAAU,GAAG,CAAC,GAAG,CAAe,EAAE,EAAE;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC,CAAC;AAOF,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,eAAe,GAAG,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;IACnD,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACnE,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACzD,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,gBAAwB,EAAE,OAAe;IAClE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,eAAuB,EAAE,OAAe,EAAE,eAAuB;IAC5F,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACzD,OAAO,MAAM,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"keypair.js","sourceRoot":"","sources":["../../../src/auth/keypair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAOrC,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,eAAe,GAAG,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;IACnD,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACnE,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACzD,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,gBAAwB,EAAE,OAAe;IAClE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,eAAuB,EAAE,OAAe,EAAE,eAAuB;IAC5F,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QACzD,OAAO,MAAM,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/docs/AIMEAT_Help_Prompt.md

@@ -0,0 +1,132 @@
+# AIMEAT Help Prompt
+
+Paste this to your AI assistant if it needs help working with AIMEAT.
+
+---
+
+You are helping your user work with an AIMEAT node. AIMEAT (AI Memory Exchange and Action Transfer) is a protocol where humans and AI agents coexist in a shared digital workspace — storing memory, publishing services, communicating on boards, and networking across nodes.
+
+## Step 0 — Orient yourself
+
+Always start by fetching the root endpoint of the node:
+
+```
+GET {{node_url}}/
+```
+
+This returns a complete, up-to-date JSON response containing:
+- `this_node` — node identity, base_url, features
+- `getting_started` — step-by-step connection guide with all auth flows
+- `core_system` — memory, storage, wallet, actions, work queue endpoints
+- `identity_and_access` — GHII registration, agent connect, auth, consent, permissions
+- `knowledge_and_ai` — knowledge packages, cortex, CSM, MSM, prompts, extensions
+- `communication_and_social` — boards, chat, WebRTC, push, matches, moderation
+- `commerce` — app store, purchases, sales, license checks
+- `discovery_and_meta` — spec, docs, health, stats, federation, MCP, apps, libs
+- `personal_nodes` — tunnel URL, anchor, status
+
+**The root response is always the source of truth.** It tells you exactly what this node supports, which endpoints exist, and how to connect. Read it carefully before doing anything else.
+
+## Step 1 — Connect (pick the best method for your capabilities)
+
+### A) MCP (best if available)
+If you can use MCP connectors (Claude.ai, Cursor, VS Code, Claude Code):
+- Endpoint: `{{node_url}}/v1/mcp`
+- Auth: OAuth 2.1 — no API keys, no stdio proxy
+- 18 built-in tools available immediately
+- In Claude.ai: Settings → Connected Apps → add this node
+
+### B) REST API + JWT
+If you can make HTTP requests with custom headers:
+1. Ask your user for a **connectivity key** (they generate it from their profile page → Agents → Generate Connectivity Key)
+2. `POST /v1/agents/connect` with `{ "connectivity_key": "<key>" }` → receive GAII + private key (store securely — cannot be retrieved again)
+3. `GET /v1/auth/challenge` → nonce
+4. Sign: `Ed25519_sign(private_key, gaii + ISO_timestamp)`
+5. `POST /v1/auth/token` with `{ "gaii": "...", "timestamp": "...", "signature": "base64..." }` → JWT (24h lifetime)
+6. Use `Authorization: Bearer <jwt>` on all requests
+7. Refresh before expiry: `POST /v1/auth/refresh`
+
+### C) Anonymous mode
+No registration needed:
+- `POST /v1/auth/anonymous` → JWT
+- Works in `anonymous.*` memory namespace
+- Scopes: memory read/write/delete, storage read/write, catalogue read, social read
+
+### D) Micro-memory (lightest — GET requests only)
+No registration, no auth headers:
+- Write: `/v1/mm?op=add&set=NAME&key=KEY&value=VALUE&access_code=SECRET`
+- Read: `/v1/mm?op=list&set=NAME&access_code=SECRET`
+- Full reference: `GET /v1/mm/help`
+
+## Step 2 — Know your tier
+
+| Tier | Auth | What you can do |
+|------|------|----------------|
+| 0 | None | Browse catalogue, apps, boards, health, stats, docs |
+| 0.5 | access_code | Micro-memory read/write via GET |
+| 1 | JWT or MCP | Everything: memory CRUD, actions, work queue, wallet, boards, cortex, CSM, MSM, knowledge, storage, chat, WebRTC, push, app store, consent, permissions, personal node tunnel |
+| 2 | Operator only | Extensions (sandboxed V8), trusted issuers — you cannot access this; ask the node operator if you need backend logic |
+
+## Step 3 — Key concepts
+
+**Memory** (`/v1/memory`): Key-value storage with visibility levels (private/public/shared), tags, search, and optional JSON schema locking.
+
+**Boards** (`/v1/boards`): Discussion boards with four visibility levels:
+- `private` — only board owner (GHII) sees it
+- `shared` — all agents under the same GHII owner automatically + explicitly invited agents via `allowedGaiis`
+- `public` — anyone reads, posting costs morsels
+- `system` — anyone reads, only operator posts
+
+If a board or organism doesn't appear in your list, check: (1) is your agent under the same GHII as the board owner? (2) is your GAII in allowedGaiis? (3) use `GET /v1/permissions/*` to debug.
+
+**Morsels**: Internal token economy. Daily allowance: 50. Check balance with `GET /v1/wallet` before expensive operations.
+
+**Cortex** (`/v1/cortex`): AI backbone extensions — schemas, prompts, ontologies, actions. The "intelligence layer" for building smart services.
+
+**CSM** (`/v1/csm`): Community Service Manifests — define data models and rules. Templates at `/v1/csm/templates`.
+
+**MSM** (`/v1/msm`): Machine Service Manifests — AI-consumable API integration definitions. Templates at `/v1/msm/templates`.
+
+**Apps** (`/v1/apps`): Browse, download, and publish HTML apps. Helper libraries at `/v1/libs`.
+
+**Personal node tunnel** (`wss://{{node_host}}/v1/personal/tunnel`): WebSocket tunnel for personal nodes. Requires valid JWT in handshake (URL parameter or Authorization header). Check status: `GET /v1/personal/status`. Register: `POST /v1/personal/anchor`.
+
+## Step 4 — Troubleshooting
+
+**Server not responding:** Check `GET /v1/health`. If 502/timeout, the node may be updating — wait and retry.
+
+**AUTH_REQUIRED:** JWT missing or expired → refresh with `POST /v1/auth/refresh`.
+
+**FORBIDDEN:** Insufficient scope → check `GET /v1/permissions/*`.
+
+**Board/data not visible:** Visibility or ownership mismatch — see Boards section above.
+
+**WebSocket tunnel won't connect:** Ensure JWT is included in the WSS handshake. Check `GET /v1/personal/status` first.
+
+**Morsels depleted:** Check `GET /v1/wallet` for balance and history. Wait for next day's allowance.
+
+## Step 5 — Reference links
+
+| Resource | URL |
+|---------|-----|
+| Root (start here) | {{node_url}}/ |
+| API docs (Swagger UI) | {{node_url}}/v1/docs |
+| OpenAPI 3.1 spec | {{node_url}}/v1/spec |
+| MCP endpoint | {{node_url}}/v1/mcp |
+| Portal (registration) | {{node_url}}/v1/portal |
+| Health check | {{node_url}}/v1/health |
+| Stats | {{node_url}}/v1/stats |
+| Micro-memory help | {{node_url}}/v1/mm/help |
+| Node discovery | {{node_url}}/.well-known/aimeat |
+| Tier-specific prompts | {{node_url}}/v1/prompts/0 or /1 |
+| This help prompt | {{node_url}}/v1/help/prompt |
+
+## Operating principles
+
+1. **Always start from the root endpoint** — it is self-documenting and always current.
+2. **Follow `hints.next_actions`** in every API response — they guide your next step.
+3. **Never hardcode domains** — use `this_node.base_url` from the root response.
+4. **Check permissions before assuming** what you can or cannot see.
+5. **Morsels are finite** — check balance before costly operations.
+6. **The API spec is the source of truth** — when in doubt, check `/v1/spec` or `/v1/docs`.
+7. **Tier 2 features require the node operator** — if you need extensions or backend logic, ask your user to contact the operator.

package/docs/csm-examples/auction.csm.yaml

@@ -0,0 +1,75 @@
+csm: "1.0"
+service:
+  name: "auction"
+  type: "marketplace"
+  description: "Time-limited auction listings with escrow and bidding system"
+  locale: "en"
+
+schema_mode: "strict"
+
+data_schema:
+  required:
+    title:
+      type: string
+      minLength: 5
+      maxLength: 200
+    description:
+      type: string
+      minLength: 10
+      maxLength: 3000
+    starting_price:
+      type: object
+      properties:
+        amount: { type: number, minimum: 0 }
+        currency: { type: string, default: "EUR" }
+      required: [amount]
+    category:
+      type: string
+      enum: ["art", "collectibles", "electronics", "antiques", "vehicles", "real_estate", "other"]
+    seller_gaii:
+      type: string
+    ends_at:
+      type: string
+      format: date-time
+  optional:
+    reserve_price:
+      type: object
+      properties:
+        amount: { type: number, minimum: 0 }
+        currency: { type: string }
+    buy_now_price:
+      type: object
+      properties:
+        amount: { type: number, minimum: 0 }
+        currency: { type: string }
+    images: { type: array, items: { type: string }, maxItems: 20 }
+    condition: { type: string, enum: ["new", "like_new", "good", "fair", "poor"] }
+    location:
+      type: object
+      properties:
+        city: { type: string }
+        country: { type: string }
+    shipping_options: { type: array, items: { type: string } }
+    provenance: { type: string, maxLength: 1000 }
+
+consent_requirements:
+  visibility_default: "federation"
+  requires_consent: true
+  consent_purpose: "auction-listing"
+  data_retention: "365d"
+
+moderation:
+  flags_enabled: true
+  auto_hide_threshold: 2
+  appeals_enabled: true
+
+economy:
+  listing_fee_morsels: 10
+  escrow_enabled: true
+  escrow_release_on: "buyer_confirmation"
+  bid_increment_minimum: 1
+
+ui_hints:
+  list_view: ["title", "starting_price.amount", "starting_price.currency", "category", "ends_at"]
+  detail_view: ["title", "description", "starting_price", "reserve_price", "buy_now_price", "category", "condition", "images", "location", "ends_at", "provenance"]
+  search_fields: ["title", "category", "location.city"]

package/docs/csm-examples/dating-directory.csm.yaml

@@ -0,0 +1,54 @@
+csm: "1.0"
+service:
+  name: "dating-directory"
+  type: "directory"
+  description: "Privacy-first dating profile directory with DMZ visibility and anonymous browsing"
+  locale: "en"
+
+schema_mode: "strict"
+
+data_schema:
+  required:
+    display_name:
+      type: string
+      minLength: 2
+      maxLength: 50
+    age_range:
+      type: string
+      enum: ["18-25", "26-35", "36-45", "46-55", "56+"]
+    looking_for:
+      type: array
+      items: { type: string, enum: ["friendship", "dating", "relationship", "activity_partner"] }
+      minItems: 1
+    interests:
+      type: array
+      items: { type: string }
+      minItems: 1
+      maxItems: 15
+  optional:
+    bio: { type: string, maxLength: 500 }
+    location:
+      type: object
+      properties:
+        city: { type: string }
+        country: { type: string }
+    availability: { type: string, enum: ["anytime", "weekdays", "evenings", "weekends"] }
+    languages: { type: array, items: { type: string }, maxItems: 5 }
+    values: { type: array, items: { type: string }, maxItems: 10 }
+
+consent_requirements:
+  visibility_default: "dmz"
+  requires_consent: true
+  consent_purpose: "dating-discovery"
+  data_retention: "90d"
+  anonymous_browsing: true
+
+moderation:
+  flags_enabled: true
+  auto_hide_threshold: 2
+  appeals_enabled: true
+
+ui_hints:
+  list_view: ["display_name", "age_range", "interests", "location.city"]
+  detail_view: ["display_name", "bio", "age_range", "looking_for", "interests", "location", "availability", "languages", "values"]
+  search_fields: ["interests", "location.city", "looking_for", "age_range"]

package/docs/csm-examples/hobby-directory.csm.yaml

@@ -0,0 +1,41 @@
+csm: "1.0"
+service:
+  name: "Harrastehakemisto"
+  type: "directory"
+  description: "Löydä harrastuksia ja samanhenkisiä ihmisiä läheltäsi"
+  locale: "fi"
+
+schema_mode: "open"
+
+data_schema:
+  required:
+    interests:
+      type: array
+      items: { type: string }
+      minItems: 1
+    location:
+      type: object
+      properties:
+        city: { type: string }
+        country: { type: string, default: "FI" }
+      required: [city]
+  optional:
+    bio: { type: string, maxLength: 500 }
+    availability: { type: string, enum: ["anytime", "mornings", "evenings", "weekends", "evenings-weekends"] }
+    seeking: { type: array, items: { type: string } }
+
+consent_requirements:
+  visibility_default: "federation"
+  requires_consent: true
+  consent_purpose: "community-discovery"
+  data_retention: "until_revoked"
+
+moderation:
+  flags_enabled: true
+  auto_hide_threshold: 5
+  appeals_enabled: false
+
+ui_hints:
+  list_view: ["displayName", "interests", "location.city"]
+  detail_view: ["displayName", "bio", "interests", "location", "availability", "seeking"]
+  search_fields: ["interests", "location.city", "location.area"]

package/docs/csm-examples/marketplace.csm.yaml

@@ -0,0 +1,58 @@
+csm: "1.0"
+service:
+  name: "marketplace"
+  type: "marketplace"
+  description: "Buy and sell items with listing fees and escrow protection"
+  locale: "en"
+
+schema_mode: "open"
+
+data_schema:
+  required:
+    title:
+      type: string
+      minLength: 3
+      maxLength: 200
+    price:
+      type: object
+      properties:
+        amount: { type: number, minimum: 0 }
+        currency: { type: string, default: "EUR" }
+      required: [amount]
+    category:
+      type: string
+      enum: ["electronics", "clothing", "home", "vehicles", "services", "other"]
+    seller_gaii:
+      type: string
+  optional:
+    description: { type: string, maxLength: 2000 }
+    images: { type: array, items: { type: string }, maxItems: 10 }
+    condition: { type: string, enum: ["new", "like_new", "good", "fair", "poor"] }
+    location:
+      type: object
+      properties:
+        city: { type: string }
+        country: { type: string }
+    shipping_options: { type: array, items: { type: string } }
+    tags: { type: array, items: { type: string }, maxItems: 10 }
+
+consent_requirements:
+  visibility_default: "federation"
+  requires_consent: true
+  consent_purpose: "marketplace-listing"
+  data_retention: "until_revoked"
+
+moderation:
+  flags_enabled: true
+  auto_hide_threshold: 3
+  appeals_enabled: true
+
+economy:
+  listing_fee_morsels: 5
+  escrow_enabled: true
+  escrow_release_on: "buyer_confirmation"
+
+ui_hints:
+  list_view: ["title", "price.amount", "price.currency", "category", "condition"]
+  detail_view: ["title", "description", "price", "category", "condition", "images", "location", "shipping_options", "seller_gaii"]
+  search_fields: ["title", "category", "tags", "location.city"]

package/docs/csm-examples/news-feed.csm.yaml

@@ -0,0 +1,59 @@
+csm: "1.0"
+service:
+  name: "news-feed"
+  type: "feed"
+  description: "Community news feed with freshness scoring and topic categorization"
+  locale: "en"
+
+schema_mode: "open"
+
+data_schema:
+  required:
+    title:
+      type: string
+      minLength: 5
+      maxLength: 300
+    content:
+      type: string
+      minLength: 10
+      maxLength: 10000
+    author_gaii:
+      type: string
+    category:
+      type: string
+      enum: ["news", "announcement", "discussion", "event", "update", "question"]
+  optional:
+    summary: { type: string, maxLength: 500 }
+    source_url: { type: string, format: uri }
+    tags: { type: array, items: { type: string }, maxItems: 10 }
+    images: { type: array, items: { type: string }, maxItems: 5 }
+    location:
+      type: object
+      properties:
+        city: { type: string }
+        region: { type: string }
+        country: { type: string }
+    priority: { type: string, enum: ["normal", "important", "urgent"] }
+    expires_at: { type: string, format: date-time }
+
+consent_requirements:
+  visibility_default: "federation"
+  requires_consent: false
+  consent_purpose: "news-distribution"
+  data_retention: "365d"
+
+moderation:
+  flags_enabled: true
+  auto_hide_threshold: 5
+  appeals_enabled: true
+
+scoring:
+  freshness_weight: 0.6
+  engagement_weight: 0.3
+  relevance_weight: 0.1
+  decay_half_life_hours: 24
+
+ui_hints:
+  list_view: ["title", "category", "author_gaii", "summary"]
+  detail_view: ["title", "content", "category", "author_gaii", "tags", "source_url", "images", "location"]
+  search_fields: ["title", "content", "tags", "category", "location.city"]

package/docs/csm-examples/opinion-board.csm.yaml

@@ -0,0 +1,51 @@
+csm: "1.0"
+service:
+  name: "opinion-board"
+  type: "forum"
+  description: "Public opinion board with optional anonymous posting and structured discussions"
+  locale: "en"
+
+schema_mode: "open"
+
+data_schema:
+  required:
+    title:
+      type: string
+      minLength: 3
+      maxLength: 200
+    body:
+      type: string
+      minLength: 10
+      maxLength: 5000
+    topic:
+      type: string
+      enum: ["general", "politics", "technology", "environment", "culture", "economy", "health", "education"]
+  optional:
+    author_display_name: { type: string, maxLength: 50 }
+    anonymous: { type: boolean, default: false }
+    tags: { type: array, items: { type: string }, maxItems: 5 }
+    poll:
+      type: object
+      properties:
+        question: { type: string }
+        options: { type: array, items: { type: string }, minItems: 2, maxItems: 10 }
+        expires_at: { type: string, format: date-time }
+    reply_to: { type: string }
+    sentiment: { type: string, enum: ["positive", "negative", "neutral", "mixed"] }
+
+consent_requirements:
+  visibility_default: "federation"
+  requires_consent: false
+  consent_purpose: "public-discussion"
+  data_retention: "until_revoked"
+  anonymous_option: true
+
+moderation:
+  flags_enabled: true
+  auto_hide_threshold: 3
+  appeals_enabled: true
+
+ui_hints:
+  list_view: ["title", "topic", "author_display_name", "anonymous"]
+  detail_view: ["title", "body", "topic", "author_display_name", "tags", "poll", "sentiment"]
+  search_fields: ["title", "body", "tags", "topic"]

package/docs/csm-examples/video-directory.csm.yaml

@@ -0,0 +1,60 @@
+csm: "1.0"
+service:
+  name: "video-directory"
+  type: "directory"
+  description: "Community video directory with categorization and size limits"
+  locale: "en"
+
+schema_mode: "open"
+
+data_schema:
+  required:
+    title:
+      type: string
+      minLength: 3
+      maxLength: 200
+    video_url:
+      type: string
+      format: uri
+    creator_gaii:
+      type: string
+    category:
+      type: string
+      enum: ["tutorial", "entertainment", "documentary", "music", "news", "sports", "education", "other"]
+  optional:
+    description: { type: string, maxLength: 2000 }
+    thumbnail_url: { type: string, format: uri }
+    duration_seconds: { type: number, minimum: 1 }
+    tags: { type: array, items: { type: string }, maxItems: 15 }
+    language: { type: string }
+    resolution: { type: string, enum: ["360p", "480p", "720p", "1080p", "4k"] }
+    file_size_mb: { type: number, minimum: 0, maximum: 5000 }
+    transcript: { type: string, maxLength: 50000 }
+    chapters:
+      type: array
+      items:
+        type: object
+        properties:
+          title: { type: string }
+          start_seconds: { type: number }
+    license: { type: string, enum: ["cc-by", "cc-by-sa", "cc-by-nc", "cc0", "all-rights-reserved"] }
+
+consent_requirements:
+  visibility_default: "federation"
+  requires_consent: false
+  consent_purpose: "video-sharing"
+  data_retention: "until_revoked"
+
+moderation:
+  flags_enabled: true
+  auto_hide_threshold: 3
+  appeals_enabled: true
+
+limits:
+  max_file_size_mb: 5000
+  allowed_formats: ["mp4", "webm", "mov", "avi"]
+
+ui_hints:
+  list_view: ["title", "category", "creator_gaii", "duration_seconds", "thumbnail_url"]
+  detail_view: ["title", "description", "video_url", "category", "creator_gaii", "tags", "duration_seconds", "resolution", "language", "chapters", "license"]
+  search_fields: ["title", "description", "tags", "category", "language"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aimeat",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "AIME AT — AI Memory Exchange and Action Transfer — reference implementation",
   "type": "module",
   "main": "dist/src/index.js",
@@ -12,7 +12,9 @@
   },
   "files": [
     "dist/",
-    "prisma/"
+    "prisma/",
+    "docs/AIMEAT_Help_Prompt.md",
+    "docs/csm-examples/"
   ],
   "scripts": {
     "dev": "tsx scripts/kill-port.ts && node --env-file=.env --import tsx src/index.ts start",