@plasm_lang/vercel-agent 0.3.78 → 0.3.81

package/templates/mcp-radar/agent/catalogs/hackernews/domain.yaml

@@ -0,0 +1,329 @@
+version: 2
+auth:
+  scheme: none
+http_backend: https://hacker-news.firebaseio.com
+entities:
+  Item:
+    id_field: id
+    description: A Hacker News item (story, comment, job, poll, or poll option). Use item_search (Algolia) to discover ids.
+      from text, then item_get for full rows from Firebase. Feed endpoints return only numeric ids; use item_get to load title,
+      text, score, and comment trees. Direct replies are listed under kids as further item ids. Poll posts expose poll option
+      ids under parts; each option is another Item row.
+    fields:
+      id:
+        required: true
+        value_ref: nv_item_id
+      type:
+        required: false
+        value_ref: nv_item_type
+      by:
+        required: false
+        value_ref: nv_item_by
+      time:
+        required: false
+        value_ref: nv_item_time
+      title:
+        required: false
+        value_ref: nv_item_title
+      text:
+        required: false
+        value_ref: nv_item_text
+      url:
+        required: false
+        value_ref: nv_item_url
+      score:
+        required: false
+        value_ref: nv_item_score
+      descendants:
+        required: false
+        value_ref: nv_item_descendants
+      parent:
+        required: false
+        value_ref: nv_item_parent
+      poll:
+        required: false
+        value_ref: nv_item_poll
+      parts:
+        required: false
+        value_ref: nv_item_parts
+      deleted:
+        required: false
+        value_ref: nv_item_deleted
+      dead:
+        required: false
+        value_ref: nv_item_dead
+    relations:
+      kids:
+        description: Direct child item ids (typically comments under a story).
+        target: Item
+        cardinality: many
+        materialize:
+          kind: from_parent_get
+          path:
+          - key: kids
+          - wildcard: true
+      poll_options:
+        description: Poll option rows referenced by parts (each id is an Item).
+        target: Item
+        cardinality: many
+        materialize:
+          kind: from_parent_get
+          path:
+          - key: parts
+          - wildcard: true
+  User:
+    id_field: id
+    description: A Hacker News user profile keyed by username. The submitted list holds item ids only; fetch each via item_get.
+      when you need titles or comment bodies.
+    fields:
+      id:
+        required: true
+        value_ref: nv_user_id
+      created:
+        required: false
+        value_ref: nv_user_created
+      karma:
+        required: false
+        value_ref: nv_user_karma
+      about:
+        required: false
+        value_ref: nv_user_about
+      delay:
+        required: false
+        value_ref: nv_user_delay
+    relations:
+      submitted:
+        description: Item ids this user has submitted.
+        target: Item
+        cardinality: many
+        materialize:
+          kind: from_parent_get
+          path:
+          - key: submitted
+          - wildcard: true
+  MaxItemId:
+    id_field: id
+    description: Current largest item id reported by maxitem.json (a bare JSON integer on the wire). Hydrate the referenced.
+      row with item_get when you need the full record.
+    fields:
+      id:
+        required: true
+        value_ref: nv_max_item_id_id
+  RecentUpdatedItem:
+    id_field: id
+    description: Item ids listed under updates.json items (live slice of ids with recent activity). Each entry is an id only.
+      use item_get for payloads.
+    fields:
+      id:
+        required: true
+        value_ref: nv_recent_updated_item_id
+  RecentUpdatedUser:
+    id_field: id
+    description: Usernames listed under updates.json profiles (accounts whose profile data changed). Each entry is the username.
+      string only; use user_get for karma and about text.
+    fields:
+      id:
+        required: true
+        value_ref: nv_recent_updated_user_id
+capabilities:
+  item_search:
+    description: Full-text search over HN via the public Algolia index (https://hn.algolia.com/api). Returns story Item rows.
+      with id from objectID and title/url from the hit; use item_get to hydrate the full Firebase record, kids, and score.
+    kind: search
+    entity: Item
+    provides:
+    - id
+    - title
+    - url
+    parameters:
+    - name: query
+      value_ref: nv_wire_str_short
+      required: true
+      role: search
+    - name: tags
+      value_ref: nv_wire_str_short
+      required: false
+      role: filter
+    - name: page
+      value_ref: nv_wire_int
+      required: false
+      role: response_control
+    - name: per_page
+      value_ref: nv_wire_int
+      required: false
+      role: response_control
+  item_search_by_date:
+    description: Same as item_search but sorted by time (search_by_date). Use for recency; combine with item_get for full.
+      items.
+    kind: search
+    entity: Item
+    provides:
+    - id
+    - title
+    - url
+    parameters:
+    - name: query
+      value_ref: nv_wire_str_short
+      required: true
+      role: search
+    - name: tags
+      value_ref: nv_wire_str_short
+      required: false
+      role: filter
+    - name: page
+      value_ref: nv_wire_int
+      required: false
+      role: response_control
+    - name: per_page
+      value_ref: nv_wire_int
+      required: false
+      role: response_control
+  item_feed_query:
+    description: Ordered list of item ids for a public feed (top, new, best, ask, show, or job). Each entry is an Item id only.
+      hydrate with item_get for full records and kids.
+    kind: query
+    entity: Item
+    provides:
+    - id
+    parameters:
+    - name: feed
+      value_ref: nv_item_feed_query_feed
+      required: true
+      role: filter
+  max_item_id_query:
+    description: Current largest item id (maxitem.json).
+    kind: query
+    entity: MaxItemId
+    provides:
+    - id
+  recent_updated_item_query:
+    description: Item ids from the live updates snapshot (updates.json items array).
+    kind: query
+    entity: RecentUpdatedItem
+    provides:
+    - id
+  recent_updated_user_query:
+    description: Usernames from the live updates snapshot (updates.json profiles array).
+    kind: query
+    entity: RecentUpdatedUser
+    provides:
+    - id
+  item_get:
+    kind: get
+    entity: Item
+    provides:
+    - id
+    - type
+    - by
+    - time
+    - title
+    - text
+    - url
+    - score
+    - descendants
+    - parent
+    - poll
+    - parts
+    - deleted
+    - dead
+  user_get:
+    description: Load a user profile by username.
+    kind: get
+    entity: User
+    provides:
+    - id
+    - created
+    - karma
+    - about
+    - delay
+values:
+  nv_item_by:
+    type: string
+    string_semantics: short
+    description: Username of the author when present.
+  nv_item_dead:
+    type: boolean
+    description: Whether the item is dead.
+  nv_item_deleted:
+    type: boolean
+    description: Whether the item was deleted.
+  nv_item_descendants:
+    type: integer
+    description: Comment count for stories when known.
+  nv_item_feed_query_feed:
+    type: select
+    allowed_values:
+    - top
+    - new
+    - best
+    - ask
+    - show
+    - job
+  nv_item_id:
+    type: integer
+    description: Numeric item id used in Firebase paths.
+  nv_item_parent:
+    type: integer
+    description: Parent item id for comments and poll options.
+  nv_item_poll:
+    type: integer
+    description: Poll id when this item is a story that hosts a poll.
+  nv_item_score:
+    type: integer
+    description: Net votes for stories and jobs when present.
+  nv_item_text:
+    type: string
+    string_semantics: markdown
+    description: Comment or story text payload when present.
+  nv_item_time:
+    type: integer
+    description: Unix time the item was created.
+  nv_item_title:
+    type: string
+    string_semantics: short
+    description: Story or job title when applicable.
+  nv_item_type:
+    type: string
+    string_semantics: short
+    description: Wire kind such as story, comment, job, poll, or pollopt.
+  nv_item_url:
+    type: string
+    string_semantics: short
+    description: Outbound link for link posts when present.
+  nv_max_item_id_id:
+    type: integer
+    description: Largest item id currently allocated on HN.
+  nv_recent_updated_item_id:
+    type: integer
+    description: Item id from the live updates snapshot.
+  nv_recent_updated_user_id:
+    type: string
+    string_semantics: short
+    description: Username from the live updates snapshot.
+  nv_user_about:
+    type: string
+    string_semantics: markdown
+    description: Self-description text when set.
+  nv_user_created:
+    type: integer
+    description: Unix time the account was created.
+  nv_user_delay:
+    type: integer
+    description: Account delay setting when present.
+  nv_user_id:
+    type: string
+    string_semantics: short
+    description: Unique username.
+  nv_user_karma:
+    type: integer
+    description: User karma score.
+  nv_wire_int:
+    type: integer
+  nv_wire_str_short:
+    type: string
+    string_semantics: short
+  nv_item_parts:
+    type: array
+    items:
+      value_ref: nv_wire_int
+    description: Poll option item ids when type is poll (empty or absent otherwise).

package/templates/mcp-radar/agent/catalogs/hackernews/eval/cases.yaml

@@ -0,0 +1,112 @@
+# Hacker News — NL→Plasm eval cases (schema: hackernews)
+- id: hn-01
+  schema: hackernews
+  goal: Top story id list from the front page feed
+  tags: [query, enum]
+  covers: [query_filtered]
+  expect:
+    entities_any: [Item]
+    pred_fields_any: [feed]
+    pred_values_any: [top]
+
+- id: hn-02
+  schema: hackernews
+  goal: Newest story ids
+  tags: [query, enum]
+  covers: [query_filtered]
+  expect:
+    entities_any: [Item]
+    pred_fields_any: [feed]
+    pred_values_any: [new]
+
+- id: hn-03
+  schema: hackernews
+  goal: Show HN category story ids
+  tags: [query, enum]
+  covers: [query_filtered]
+  expect:
+    entities_any: [Item]
+    pred_fields_any: [feed]
+    pred_values_any: [show]
+
+- id: hn-04
+  schema: hackernews
+  goal: Fetch item 8863
+  tags: [get]
+  covers: [get]
+  expect:
+    entities_any: [Item]
+
+- id: hn-05
+  schema: hackernews
+  goal: Load user jl
+  tags: [get]
+  covers: [get]
+  expect:
+    entities_any: [User]
+
+- id: hn-06
+  schema: hackernews
+  goal: Item 1 and only its title field
+  tags: [get, projection]
+  covers: [get, projection]
+  expect:
+    entities_any: [Item]
+    projection_contains: [title]
+
+- id: hn-07
+  schema: hackernews
+  goal: Story 8863 and expand its direct replies
+  tags: [chain]
+  covers: [chain]
+  expect:
+    entities_any: [Item]
+    chain_selectors_any: [kids]
+
+- id: hn-08
+  schema: hackernews
+  goal: >-
+    Compare item 1 and user jl in one pass so both profiles are available for discussion.
+  tags: [multi_step]
+  covers: [multi_step]
+  expect:
+    entities_any: [Item, User]
+
+- id: hn-09
+  schema: hackernews
+  goal: >-
+    Snapshot the live max item id, the recent item id slice from updates, and the recent
+    username slice from updates in one analysis pass.
+  tags: [query_all]
+  covers: [query_all]
+  expect:
+    entities_any: [MaxItemId, RecentUpdatedItem, RecentUpdatedUser]
+
+- id: hn-10
+  schema: hackernews
+  goal: Poll item 126809 and list its poll option rows
+  tags: [chain]
+  covers: [chain]
+  expect:
+    entities_any: [Item]
+    chain_selectors_any: [poll_options]
+
+- id: hn-11
+  schema: hackernews
+  goal: Search HN stories for “rust memory safety” and list matching item ids
+  tags: [search]
+  covers: [search_text]
+  expect:
+    entities_any: [Item]
+    pred_fields_any: [query]
+
+- id: hn-12
+  schema: hackernews
+  goal: >-
+    Find HN stories mentioning “Show HN”, then load item 1 by id for the classic “Y Combinator”
+    post in one pass.
+  tags: [search, get, multi_step]
+  covers: [search_text, get, multi_step]
+  expect:
+    entities_any: [Item]
+    pred_fields_any: [query]

package/templates/mcp-radar/agent/catalogs/hackernews/mappings.yaml

@@ -0,0 +1,129 @@
+# Hacker News: Firebase v0 (https://github.com/HackerNews/API) plus the public
+# Algolia HN search API (https://hn.algolia.com/api) — two origins, one CGS. Firebase paths are
+# relative to http_backend; search uses a full https:// URL so plasm-runtime joins the absolute
+# request URL without double-prefixing the catalog origin (see `join_base_url_path`).
+
+item_search:
+  method: GET
+  path:
+  - type: literal
+    value: "https://hn.algolia.com/api/v1/search"
+  response:
+    items: hits
+  query:
+    type: object
+    fields:
+    - - query
+      - type: var
+        name: query
+    - - tags
+      - type: if
+        condition: { type: exists, var: tags }
+        then_expr: { type: var, name: tags }
+        else_expr: { type: const, value: "story" }
+    - - page
+      - type: if
+        condition: { type: exists, var: page }
+        then_expr: { type: var, name: page }
+        else_expr: { type: const, value: null }
+    - - hitsPerPage
+      - type: if
+        condition: { type: exists, var: per_page }
+        then_expr: { type: var, name: per_page }
+        else_expr: { type: const, value: null }
+
+item_search_by_date:
+  method: GET
+  path:
+  - type: literal
+    value: "https://hn.algolia.com/api/v1/search_by_date"
+  response:
+    items: hits
+  query:
+    type: object
+    fields:
+    - - query
+      - type: var
+        name: query
+    - - tags
+      - type: if
+        condition: { type: exists, var: tags }
+        then_expr: { type: var, name: tags }
+        else_expr: { type: const, value: "story" }
+    - - page
+      - type: if
+        condition: { type: exists, var: page }
+        then_expr: { type: var, name: page }
+        else_expr: { type: const, value: null }
+    - - hitsPerPage
+      - type: if
+        condition: { type: exists, var: per_page }
+        then_expr: { type: var, name: per_page }
+        else_expr: { type: const, value: null }
+
+item_feed_query:
+  method: GET
+  path:
+    - type: literal
+      value: v0
+    - type: var
+      name: feed
+      suffix: stories.json
+
+max_item_id_query:
+  method: GET
+  path:
+    - type: literal
+      value: v0
+    - type: literal
+      value: maxitem.json
+  response:
+    wrap_root_scalar: true
+
+recent_updated_item_query:
+  method: GET
+  path:
+    - type: literal
+      value: v0
+    - type: literal
+      value: updates.json
+  response:
+    items_path:
+    - items
+
+recent_updated_user_query:
+  method: GET
+  path:
+    - type: literal
+      value: v0
+    - type: literal
+      value: updates.json
+  response:
+    items_path:
+    - profiles
+
+item_get:
+  method: GET
+  response:
+    single: true
+  path:
+    - type: literal
+      value: v0
+    - type: literal
+      value: item
+    - type: var
+      name: id
+      suffix: .json
+
+user_get:
+  method: GET
+  response:
+    single: true
+  path:
+    - type: literal
+      value: v0
+    - type: literal
+      value: user
+    - type: var
+      name: id
+      suffix: .json