Tool tree
Your web. Your space. Shaped with your agent. Explore WEFT, a working prototype for a more personal web.
Implementation
gradeNot graded
gradeNot graded
get_doorway_contextAnswer
Read the active area, private space revision, pending human home request, public handle and separate private-surface/public-draft targets. Saving a request does not start an agent. Personal-only; no credentials or network requests.
View tool JSON
{
"name": "get_doorway_context",
"kind": "answer",
"impl": "imperative",
"description": "Read the active area, private space revision, pending human home request, public handle and separate private-surface/public-draft targets. Saving a request does not start an agent. Personal-only; no credentials or network requests.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}navigate_doorwayAction
Navigate web (private space), public (owner's draft studio), people (profile discovery), or watch (private media). Optional studio tab is public-only. Preserves the current space. No content write, publication, source retrieval or playback. Personal-only.
View tool JSON
{
"name": "navigate_doorway",
"kind": "act",
"impl": "imperative",
"description": "Navigate web (private space), public (owner's draft studio), people (profile discovery), or watch (private media). Optional studio tab is public-only. Preserves the current space. No content write, publication, source retrieval or playback. Personal-only.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"area": {
"type": "string",
"enum": [
"web",
"public",
"people",
"watch"
]
},
"studio": {
"type": "string",
"enum": [
"posts",
"images",
"profile",
"safety"
]
}
},
"required": [
"area"
],
"additionalProperties": false
}
}answer_home_requestAction
Save a short reply to this private space's latest human request. Narration only: does not execute work, verify completion, alter the surface or publish. Use existing tools first when work is requested and report only observed results. Existing consent/review boundaries still apply. Personal-only.
View tool JSON
{
"name": "answer_home_request",
"kind": "act",
"impl": "imperative",
"description": "Save a short reply to this private space's latest human request. Narration only: does not execute work, verify completion, alter the surface or publish. Use existing tools first when work is requested and report only observed results. Existing consent/review boundaries still apply. Personal-only.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"requestId": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"responseText": {
"type": "string",
"minLength": 1,
"maxLength": 600
}
},
"required": [
"requestId",
"responseText"
],
"additionalProperties": false
}
}get_creation_contextAnswer
Read your private image library, post summaries and public-profile draft. Use postId for complete draft text and includeSchema for the edit contract. Does not publish, upload or expose credentials. Personal accounts only.
View tool JSON
{
"name": "get_creation_context",
"kind": "answer",
"impl": "imperative",
"description": "Read your private image library, post summaries and public-profile draft. Use postId for complete draft text and includeSchema for the edit contract. Does not publish, upload or expose credentials. Personal accounts only.",
"inputSchema": {
"type": "object",
"properties": {
"postId": {
"type": "string"
},
"includeSchema": {
"type": "boolean"
}
},
"additionalProperties": false
}
}edit_creationAction
Save a private post or profile draft, or describe an owned private image. Read get_creation_context for the exact schema first. Does NOT publish, upload or alter the private workspace. Profile drafts support customDesign via get_design_contract and profile layout. Opens the matching public studio tab for review. No external image URLs, HTML or credentials.
View tool JSON
{
"name": "edit_creation",
"kind": "act",
"impl": "imperative",
"description": "Save a private post or profile draft, or describe an owned private image. Read get_creation_context for the exact schema first. Does NOT publish, upload or alter the private workspace. Profile drafts support customDesign via get_design_contract and profile layout. Opens the matching public studio tab for review. No external image URLs, HTML or credentials.",
"inputSchema": {
"type": "object",
"properties": {
"edit": {
"type": "object",
"description": "Complete action object from get_creation_context.editSchema, including baseRevision."
}
},
"required": [
"edit"
],
"additionalProperties": false
}
}get_intake_contractAnswer
Read the bounded private snapshot intake contract before transferring authorized results from another tool or conversation. No retrieval, account access or write.
View tool JSON
{
"name": "get_intake_contract",
"kind": "answer",
"impl": "imperative",
"description": "Read the bounded private snapshot intake contract before transferring authorized results from another tool or conversation. No retrieval, account access or write.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}propose_import_bundleAction
Stage up to 12 authorized results for human review. For video collections set bundle.destination to watch_explore: acceptance creates and opens the gallery without a follow-up compose. Supported YouTube URLs are recognised locally. No proposal fetch, arbitrary media, credentials or publication. Assertions/popularity remain unverified. Retry the same idempotency key after human acceptance for saved IDs and actual status. Read get_intake_contract first. Personal spaces only.
View tool JSON
{
"name": "propose_import_bundle",
"kind": "act",
"impl": "imperative",
"description": "Stage up to 12 authorized results for human review. For video collections set bundle.destination to watch_explore: acceptance creates and opens the gallery without a follow-up compose. Supported YouTube URLs are recognised locally. No proposal fetch, arbitrary media, credentials or publication. Assertions/popularity remain unverified. Retry the same idempotency key after human acceptance for saved IDs and actual status. Read get_intake_contract first. Personal spaces only.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"baseRevision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"bundle": {
"type": "object",
"properties": {
"destination": {
"type": "string",
"enum": [
"space",
"watch_explore"
]
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"purpose": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"items": {
"minItems": 1,
"maxItems": 12,
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"summary": {
"type": "string",
"maxLength": 1200
},
"sourceName": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"sourceUrl": {
"type": "string",
"maxLength": 1000,
"format": "uri"
},
"evidence": {
"type": "string",
"enum": [
"source_excerpt",
"agent_summary",
"human_note"
]
}
},
"required": [
"title",
"summary",
"sourceName",
"evidence"
],
"additionalProperties": false
}
}
},
"required": [
"title",
"purpose",
"items"
],
"additionalProperties": false
}
},
"required": [
"baseRevision",
"idempotencyKey",
"bundle"
],
"additionalProperties": false
}
}get_surface_contextAnswer
Read the private space: revision, intent, module structure, protected human choices, source health and recent edits. Not the public-profile draft. Call get_doorway_context first when the target is unclear.
View tool JSON
{
"name": "get_surface_context",
"kind": "answer",
"impl": "imperative",
"description": "Read the private space: revision, intent, module structure, protected human choices, source health and recent edits. Not the public-profile draft. Call get_doorway_context first when the target is unclear.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}get_design_catalogAnswer
Read the supported experiences, responsive behavior, composition recipe and boundaries before designing. Site-authored guidance, not source content. No writes or network.
View tool JSON
{
"name": "get_design_catalog",
"kind": "answer",
"impl": "imperative",
"description": "Read the supported experiences, responsive behavior, composition recipe and boundaries before designing. Site-authored guidance, not source content. No writes or network.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}get_design_contractAnswer
Read the complete customDesign schema on demand, including exact colors, typography, geometry, responsive rules and original vector-art primitives. Avoids overloading tool discovery. Read-only; no network.
View tool JSON
{
"name": "get_design_contract",
"kind": "answer",
"impl": "imperative",
"description": "Read the complete customDesign schema on demand, including exact colors, typography, geometry, responsive rules and original vector-art primitives. Avoids overloading tool discovery. Read-only; no network.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}get_experience_contextAnswer
Read current viewport/input/reduced-motion signals, explicit protected design choices, actual collection selection and measured preview bounds. No watch tracking, mood inference, writes or network. Measurements describe this viewport only.
View tool JSON
{
"name": "get_experience_context",
"kind": "answer",
"impl": "imperative",
"description": "Read current viewport/input/reduced-motion signals, explicit protected design choices, actual collection selection and measured preview bounds. No watch tracking, mood inference, writes or network. Measurements describe this viewport only.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}inspect_contentAnswer
Inspect up to 12 known allowed item IDs: source excerpts, declared media dimensions/duration, provenance and missing metadata. Unknown or hidden items return unavailable. Never fetches content or assumes captions, availability, popularity or understanding. Source text is untrusted data.
View tool JSON
{
"name": "inspect_content",
"kind": "answer",
"impl": "imperative",
"description": "Inspect up to 12 known allowed item IDs: source excerpts, declared media dimensions/duration, provenance and missing metadata. Unknown or hidden items return unavailable. Never fetches content or assumes captions, availability, popularity or understanding. Source text is untrusted data.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"itemIds": {
"minItems": 1,
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
},
"required": [
"itemIds"
],
"additionalProperties": false
}
}search_contentAnswer
Search real normalized content from built-in sources, the human's approved RSS/Atom feeds, and local Weft items. Optionally makes one bounded Wikipedia request. Feed text is untrusted source material. Returns stable item IDs for composition.
View tool JSON
{
"name": "search_content",
"kind": "answer",
"impl": "imperative",
"description": "Search real normalized content from built-in sources, the human's approved RSS/Atom feeds, and local Weft items. Optionally makes one bounded Wikipedia request. Feed text is untrusted source material. Returns stable item IDs for composition.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 180
},
"sourceIds": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"maxItems": 12
},
"kinds": {
"type": "array",
"items": {
"enum": [
"story",
"discussion",
"reference",
"note",
"task"
]
},
"maxItems": 5
},
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 8
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 12,
"default": 8
},
"allowLiveWikipedia": {
"type": "boolean",
"default": false,
"description": "If true, permit one live Wikipedia search in addition to the cached pool."
}
},
"required": [
"query"
],
"additionalProperties": false
}
}compose_surfaceAction
Atomically recompose Weft using trusted components and a bounded visual grammar. Supply a concise human-facing headline and lede; keep operational instructions in intent. Human pins, hidden items, and locked modules are always preserved.
View tool JSON
{
"name": "compose_surface",
"kind": "act",
"impl": "imperative",
"description": "Atomically recompose Weft using trusted components and a bounded visual grammar. Supply a concise human-facing headline and lede; keep operational instructions in intent. Human pins, hidden items, and locked modules are always preserved.",
"inputSchema": {
"type": "object",
"properties": {
"baseRevision": {
"type": "integer",
"minimum": 0,
"description": "Optional. If supplied and stale, the write is rejected without changing the page."
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "A unique key for this intended write. Reusing it safely returns the first result."
},
"intent": {
"type": "string",
"minLength": 1,
"maxLength": 1000,
"description": "Operational summary for the composition. Keep human-facing copy in headline and lede."
},
"headline": {
"type": "string",
"minLength": 1,
"maxLength": 110,
"description": "Concise editorial page title, not an instruction or prompt."
},
"lede": {
"type": "string",
"minLength": 1,
"maxLength": 240,
"description": "One short sentence explaining the composed view."
},
"mode": {
"enum": [
"home",
"briefing",
"research"
]
},
"presentation": {
"type": "object",
"properties": {
"customDesign": {
"type": [
"object",
"null"
],
"description": "Original authored design. Call get_design_contract for the complete validated schema and an example before writing. Complete replacement, not deep merge; null restores presets. Exact colors, typography, geometry and original vector artwork; no CSS, URLs or script."
},
"theme": {
"enum": [
"none",
"botanical",
"coastal",
"observatory"
],
"description": "A complete visual environment, not a topic filter. Botanical supplies drawn foliage and woodland surfaces; coastal supplies waves and shoreline surfaces; observatory supplies orbital artwork. Does not fetch images or change content."
},
"surfaces": {
"enum": [
"auto",
"ruled",
"cards",
"soft"
],
"description": "Module framing independent of theme. auto uses the scene's defaults; ruled is minimal; cards are crisp; soft adds rounded tactile surfaces."
},
"decoration": {
"enum": [
"none",
"quiet",
"expressive"
],
"description": "Amount of bundled decorative scene artwork. Never changes content-media visibility or playback."
},
"grammar": {
"enum": [
"flow",
"stage",
"compare",
"workspace"
]
},
"density": {
"enum": [
"airy",
"balanced",
"dense"
]
},
"emphasis": {
"enum": [
"recency",
"relevance",
"action",
"source"
]
},
"palette": {
"enum": [
"paper",
"stone",
"ink"
]
},
"accent": {
"enum": [
"moss",
"clay",
"ocean"
]
},
"imagery": {
"enum": [
"quiet",
"supporting",
"prominent"
]
},
"typeScale": {
"enum": [
"quiet",
"balanced",
"expressive"
]
},
"character": {
"enum": [
"journal",
"studio",
"workbench"
]
}
},
"required": [
"grammar",
"density",
"emphasis"
],
"additionalProperties": false
},
"modules": {
"type": "array",
"items": {
"description": "One trusted Weft component. Never include HTML, CSS, attribution, or locked state.",
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "hero"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable",
"visual"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "stream"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable",
"visual"
]
},
"groupBy": {
"enum": [
"none",
"source",
"kind",
"time",
"tag"
]
},
"sort": {
"enum": [
"manual",
"newest",
"oldest",
"relevance"
]
}
},
"required": [
"density",
"groupBy",
"sort"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "comparison"
},
"config": {
"type": "object",
"properties": {
"lanes": {
"type": "array",
"minItems": 2,
"maxItems": 4,
"description": "Labelled positions such as optimistic and skeptical.",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6
}
},
"required": [
"label",
"itemIds"
],
"additionalProperties": false
}
}
},
"required": [
"lanes"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "notes"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "actions"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable"
]
},
"sort": {
"enum": [
"manual",
"newest",
"oldest"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "gallery"
},
"config": {
"type": "object",
"description": "Media-first grid, and the only module that plays media in place: a video, audio or embed item becomes a working player the human can start without leaving the page. A stream shows the same item as a still thumbnail with a link. Choose gallery whenever the point is the picture or the footage. get_surface_context reports media.galleryReadyItemIds.",
"properties": {
"tile": {
"enum": [
"small",
"medium",
"large"
]
},
"experience": {
"enum": [
"spotlight",
"grid",
"watch",
"explore"
],
"description": "Watch: large media stage and finite queue. Explore: varied visual collection. Spotlight: piece beside context. Grid: uniform index. All responsive, no autoplay. get_design_catalog explains each."
},
"ratio": {
"enum": [
"square",
"wide",
"native"
]
},
"showTextItems": {
"type": "boolean",
"description": "Include text-only pieces in the browsable collection instead of dropping them."
}
},
"required": [
"tile",
"ratio"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "timeline"
},
"config": {
"type": "object",
"description": "Chronological spine with grouped date markers. Use it when when something happened is the point.",
"properties": {
"direction": {
"enum": [
"newest_first",
"oldest_first"
]
},
"scale": {
"enum": [
"day",
"week",
"month"
]
},
"showExcerpt": {
"type": "boolean"
}
},
"required": [
"direction",
"scale"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
}
]
},
"minItems": 1,
"maxItems": 8
}
},
"required": [
"idempotencyKey",
"intent",
"headline",
"lede",
"mode",
"modules"
],
"additionalProperties": false
}
}preview_surfaceAction
Validate a bounded patch and display its proposed arrangement for human review. Does not save content, alter the live revision, fetch sources or publish. Returns the revision-bound patch to apply with patch_surface. The human can also apply or dismiss the preview in the page.
View tool JSON
{
"name": "preview_surface",
"kind": "act",
"impl": "imperative",
"description": "Validate a bounded patch and display its proposed arrangement for human review. Does not save content, alter the live revision, fetch sources or publish. Returns the revision-bound patch to apply with patch_surface. The human can also apply or dismiss the preview in the page.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"baseRevision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"operations": {
"minItems": 1,
"maxItems": 12,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace_module"
},
"module": {
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 1,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "hero"
},
"config": {
"type": "object",
"properties": {
"density": {
"type": "string",
"enum": [
"compact",
"comfortable",
"visual"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "stream"
},
"config": {
"type": "object",
"properties": {
"density": {
"type": "string",
"enum": [
"compact",
"comfortable",
"visual"
]
},
"groupBy": {
"type": "string",
"enum": [
"none",
"source",
"kind",
"time",
"tag"
]
},
"sort": {
"type": "string",
"enum": [
"manual",
"newest",
"oldest",
"relevance"
]
}
},
"required": [
"density",
"groupBy",
"sort"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "comparison"
},
"config": {
"type": "object",
"properties": {
"lanes": {
"minItems": 2,
"maxItems": 4,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"itemIds": {
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
}
},
"required": [
"label",
"itemIds"
],
"additionalProperties": false
}
}
},
"required": [
"lanes"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "notes"
},
"config": {
"type": "object",
"properties": {
"density": {
"type": "string",
"enum": [
"compact",
"comfortable"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "actions"
},
"config": {
"type": "object",
"properties": {
"density": {
"type": "string",
"enum": [
"compact",
"comfortable"
]
},
"sort": {
"type": "string",
"enum": [
"manual",
"newest",
"oldest"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "gallery"
},
"config": {
"type": "object",
"properties": {
"tile": {
"type": "string",
"enum": [
"small",
"medium",
"large"
]
},
"experience": {
"type": "string",
"enum": [
"spotlight",
"grid",
"watch",
"explore"
]
},
"ratio": {
"type": "string",
"enum": [
"square",
"wide",
"native"
]
},
"showTextItems": {
"type": "boolean"
}
},
"required": [
"tile",
"ratio"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "timeline"
},
"config": {
"type": "object",
"properties": {
"direction": {
"type": "string",
"enum": [
"newest_first",
"oldest_first"
]
},
"scale": {
"type": "string",
"enum": [
"day",
"week",
"month"
]
},
"showExcerpt": {
"type": "boolean"
}
},
"required": [
"direction",
"scale"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
}
]
}
},
"required": [
"op",
"module"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "move_module"
},
"moduleId": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"index": {
"type": "integer",
"minimum": 0,
"maximum": 7
}
},
"required": [
"op",
"moduleId",
"index"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "set_presentation"
},
"presentation": {
"type": "object",
"properties": {
"customDesign": {
"anyOf": [
{
"type": "object",
"description": "Original authored design. Call get_design_contract for the complete validated schema and an example before writing. Complete replacement, not deep merge; null restores presets. Exact colors, typography, geometry and original vector artwork; no CSS, URLs or script."
},
{
"type": "null"
}
]
},
"theme": {
"type": "string",
"enum": [
"none",
"botanical",
"coastal",
"observatory"
]
},
"surfaces": {
"type": "string",
"enum": [
"auto",
"ruled",
"cards",
"soft"
]
},
"decoration": {
"type": "string",
"enum": [
"none",
"quiet",
"expressive"
]
},
"grammar": {
"type": "string",
"enum": [
"flow",
"stage",
"compare",
"workspace"
]
},
"density": {
"type": "string",
"enum": [
"airy",
"balanced",
"dense"
]
},
"emphasis": {
"type": "string",
"enum": [
"recency",
"relevance",
"action",
"source"
]
},
"palette": {
"type": "string",
"enum": [
"paper",
"stone",
"ink"
]
},
"accent": {
"type": "string",
"enum": [
"moss",
"clay",
"ocean"
]
},
"imagery": {
"type": "string",
"enum": [
"quiet",
"supporting",
"prominent"
]
},
"typeScale": {
"type": "string",
"enum": [
"quiet",
"balanced",
"expressive"
]
},
"character": {
"type": "string",
"enum": [
"journal",
"studio",
"workbench"
]
}
},
"required": [
"grammar",
"density",
"emphasis"
],
"additionalProperties": false
}
},
"required": [
"op",
"presentation"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "set_surface_copy"
},
"headline": {
"type": "string",
"minLength": 1,
"maxLength": 110
},
"lede": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
},
"required": [
"op",
"headline"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "rename_module"
},
"moduleId": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"op",
"moduleId",
"title"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "assign_items"
},
"moduleId": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
}
},
"required": [
"op",
"moduleId",
"itemIds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "remove_module"
},
"moduleId": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"op",
"moduleId"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "add_module"
},
"module": {
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 1,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "hero"
},
"config": {
"type": "object",
"properties": {
"density": {
"type": "string",
"enum": [
"compact",
"comfortable",
"visual"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "stream"
},
"config": {
"type": "object",
"properties": {
"density": {
"type": "string",
"enum": [
"compact",
"comfortable",
"visual"
]
},
"groupBy": {
"type": "string",
"enum": [
"none",
"source",
"kind",
"time",
"tag"
]
},
"sort": {
"type": "string",
"enum": [
"manual",
"newest",
"oldest",
"relevance"
]
}
},
"required": [
"density",
"groupBy",
"sort"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "comparison"
},
"config": {
"type": "object",
"properties": {
"lanes": {
"minItems": 2,
"maxItems": 4,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"itemIds": {
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
}
},
"required": [
"label",
"itemIds"
],
"additionalProperties": false
}
}
},
"required": [
"lanes"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "notes"
},
"config": {
"type": "object",
"properties": {
"density": {
"type": "string",
"enum": [
"compact",
"comfortable"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "actions"
},
"config": {
"type": "object",
"properties": {
"density": {
"type": "string",
"enum": [
"compact",
"comfortable"
]
},
"sort": {
"type": "string",
"enum": [
"manual",
"newest",
"oldest"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "gallery"
},
"config": {
"type": "object",
"properties": {
"tile": {
"type": "string",
"enum": [
"small",
"medium",
"large"
]
},
"experience": {
"type": "string",
"enum": [
"spotlight",
"grid",
"watch",
"explore"
]
},
"ratio": {
"type": "string",
"enum": [
"square",
"wide",
"native"
]
},
"showTextItems": {
"type": "boolean"
}
},
"required": [
"tile",
"ratio"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"type": "string",
"const": "timeline"
},
"config": {
"type": "object",
"properties": {
"direction": {
"type": "string",
"enum": [
"newest_first",
"oldest_first"
]
},
"scale": {
"type": "string",
"enum": [
"day",
"week",
"month"
]
},
"showExcerpt": {
"type": "boolean"
}
},
"required": [
"direction",
"scale"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"itemIds",
"layout",
"type",
"config"
],
"additionalProperties": false
}
]
}
},
"required": [
"op",
"module"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"idempotencyKey",
"operations"
],
"additionalProperties": false
}
}focus_surfaceAction
Bring one existing module into a focused view, optionally selecting a visible item in a gallery. Pass moduleId null to return to the whole space. Temporary navigation only: no saved composition change, playback, permission change or publication. Human selections are observable in get_surface_context.view.collections.
View tool JSON
{
"name": "focus_surface",
"kind": "act",
"impl": "imperative",
"description": "Bring one existing module into a focused view, optionally selecting a visible item in a gallery. Pass moduleId null to return to the whole space. Temporary navigation only: no saved composition change, playback, permission change or publication. Human selections are observable in get_surface_context.view.collections.",
"inputSchema": {
"type": "object",
"properties": {
"moduleId": {
"type": [
"string",
"null"
],
"maxLength": 80
},
"itemId": {
"type": "string",
"maxLength": 200,
"description": "Optional visible gallery member to feature. No playback."
}
},
"required": [
"moduleId"
],
"additionalProperties": false
}
}patch_surfaceAction
Apply a small atomic change to surface copy, presentation, or modules. Locked modules and pinned items cannot be removed.
View tool JSON
{
"name": "patch_surface",
"kind": "act",
"impl": "imperative",
"description": "Apply a small atomic change to surface copy, presentation, or modules. Locked modules and pinned items cannot be removed.",
"inputSchema": {
"type": "object",
"properties": {
"baseRevision": {
"type": "integer",
"minimum": 0,
"description": "Optional. If supplied and stale, the write is rejected without changing the page."
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "A unique key for this intended write. Reusing it safely returns the first result."
},
"operations": {
"type": "array",
"minItems": 1,
"maxItems": 12,
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"const": "replace_module"
},
"module": {
"description": "One trusted Weft component. Never include HTML, CSS, attribution, or locked state.",
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "hero"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable",
"visual"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "stream"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable",
"visual"
]
},
"groupBy": {
"enum": [
"none",
"source",
"kind",
"time",
"tag"
]
},
"sort": {
"enum": [
"manual",
"newest",
"oldest",
"relevance"
]
}
},
"required": [
"density",
"groupBy",
"sort"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "comparison"
},
"config": {
"type": "object",
"properties": {
"lanes": {
"type": "array",
"minItems": 2,
"maxItems": 4,
"description": "Labelled positions such as optimistic and skeptical.",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6
}
},
"required": [
"label",
"itemIds"
],
"additionalProperties": false
}
}
},
"required": [
"lanes"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "notes"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "actions"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable"
]
},
"sort": {
"enum": [
"manual",
"newest",
"oldest"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "gallery"
},
"config": {
"type": "object",
"description": "Media-first grid, and the only module that plays media in place: a video, audio or embed item becomes a working player the human can start without leaving the page. A stream shows the same item as a still thumbnail with a link. Choose gallery whenever the point is the picture or the footage. get_surface_context reports media.galleryReadyItemIds.",
"properties": {
"tile": {
"enum": [
"small",
"medium",
"large"
]
},
"experience": {
"enum": [
"spotlight",
"grid",
"watch",
"explore"
],
"description": "Watch: large media stage and finite queue. Explore: varied visual collection. Spotlight: piece beside context. Grid: uniform index. All responsive, no autoplay. get_design_catalog explains each."
},
"ratio": {
"enum": [
"square",
"wide",
"native"
]
},
"showTextItems": {
"type": "boolean",
"description": "Include text-only pieces in the browsable collection instead of dropping them."
}
},
"required": [
"tile",
"ratio"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "timeline"
},
"config": {
"type": "object",
"description": "Chronological spine with grouped date markers. Use it when when something happened is the point.",
"properties": {
"direction": {
"enum": [
"newest_first",
"oldest_first"
]
},
"scale": {
"enum": [
"day",
"week",
"month"
]
},
"showExcerpt": {
"type": "boolean"
}
},
"required": [
"direction",
"scale"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
}
]
}
},
"required": [
"op",
"module"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "move_module"
},
"moduleId": {
"type": "string"
},
"index": {
"type": "integer",
"minimum": 0,
"maximum": 7
}
},
"required": [
"op",
"moduleId",
"index"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "set_surface_copy"
},
"headline": {
"type": "string",
"minLength": 1,
"maxLength": 110
},
"lede": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
},
"required": [
"op",
"headline"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "set_presentation"
},
"presentation": {
"type": "object",
"properties": {
"customDesign": {
"type": [
"object",
"null"
],
"description": "Original authored design. Call get_design_contract for the complete validated schema and an example before writing. Complete replacement, not deep merge; null restores presets. Exact colors, typography, geometry and original vector artwork; no CSS, URLs or script."
},
"theme": {
"enum": [
"none",
"botanical",
"coastal",
"observatory"
],
"description": "A complete visual environment, not a topic filter. Botanical supplies drawn foliage and woodland surfaces; coastal supplies waves and shoreline surfaces; observatory supplies orbital artwork. Does not fetch images or change content."
},
"surfaces": {
"enum": [
"auto",
"ruled",
"cards",
"soft"
],
"description": "Module framing independent of theme. auto uses the scene's defaults; ruled is minimal; cards are crisp; soft adds rounded tactile surfaces."
},
"decoration": {
"enum": [
"none",
"quiet",
"expressive"
],
"description": "Amount of bundled decorative scene artwork. Never changes content-media visibility or playback."
},
"grammar": {
"enum": [
"flow",
"stage",
"compare",
"workspace"
]
},
"density": {
"enum": [
"airy",
"balanced",
"dense"
]
},
"emphasis": {
"enum": [
"recency",
"relevance",
"action",
"source"
]
},
"palette": {
"enum": [
"paper",
"stone",
"ink"
]
},
"accent": {
"enum": [
"moss",
"clay",
"ocean"
]
},
"imagery": {
"enum": [
"quiet",
"supporting",
"prominent"
]
},
"typeScale": {
"enum": [
"quiet",
"balanced",
"expressive"
]
},
"character": {
"enum": [
"journal",
"studio",
"workbench"
]
}
},
"required": [
"grammar",
"density",
"emphasis"
],
"additionalProperties": false
}
},
"required": [
"op",
"presentation"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "rename_module"
},
"moduleId": {
"type": "string"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"op",
"moduleId",
"title"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "assign_items"
},
"moduleId": {
"type": "string"
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
}
},
"required": [
"op",
"moduleId",
"itemIds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "remove_module"
},
"moduleId": {
"type": "string"
}
},
"required": [
"op",
"moduleId"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "add_module"
},
"module": {
"description": "One trusted Weft component. Never include HTML, CSS, attribution, or locked state.",
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "hero"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable",
"visual"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "stream"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable",
"visual"
]
},
"groupBy": {
"enum": [
"none",
"source",
"kind",
"time",
"tag"
]
},
"sort": {
"enum": [
"manual",
"newest",
"oldest",
"relevance"
]
}
},
"required": [
"density",
"groupBy",
"sort"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "comparison"
},
"config": {
"type": "object",
"properties": {
"lanes": {
"type": "array",
"minItems": 2,
"maxItems": 4,
"description": "Labelled positions such as optimistic and skeptical.",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6
}
},
"required": [
"label",
"itemIds"
],
"additionalProperties": false
}
}
},
"required": [
"lanes"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "notes"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "actions"
},
"config": {
"type": "object",
"properties": {
"density": {
"enum": [
"compact",
"comfortable"
]
},
"sort": {
"enum": [
"manual",
"newest",
"oldest"
]
}
},
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "gallery"
},
"config": {
"type": "object",
"description": "Media-first grid, and the only module that plays media in place: a video, audio or embed item becomes a working player the human can start without leaving the page. A stream shows the same item as a still thumbnail with a link. Choose gallery whenever the point is the picture or the footage. get_surface_context reports media.galleryReadyItemIds.",
"properties": {
"tile": {
"enum": [
"small",
"medium",
"large"
]
},
"experience": {
"enum": [
"spotlight",
"grid",
"watch",
"explore"
],
"description": "Watch: large media stage and finite queue. Explore: varied visual collection. Spotlight: piece beside context. Grid: uniform index. All responsive, no autoplay. get_design_catalog explains each."
},
"ratio": {
"enum": [
"square",
"wide",
"native"
]
},
"showTextItems": {
"type": "boolean",
"description": "Include text-only pieces in the browsable collection instead of dropping them."
}
},
"required": [
"tile",
"ratio"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": {
"type": "string",
"maxLength": 300
},
"itemIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 24
},
"layout": {
"type": "object",
"properties": {
"x": {
"type": "integer",
"minimum": 0,
"maximum": 11
},
"y": {
"type": "integer",
"minimum": 0,
"maximum": 99
},
"w": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"h": {
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"x",
"y",
"w",
"h"
],
"additionalProperties": false
},
"type": {
"const": "timeline"
},
"config": {
"type": "object",
"description": "Chronological spine with grouped date markers. Use it when when something happened is the point.",
"properties": {
"direction": {
"enum": [
"newest_first",
"oldest_first"
]
},
"scale": {
"enum": [
"day",
"week",
"month"
]
},
"showExcerpt": {
"type": "boolean"
}
},
"required": [
"direction",
"scale"
],
"additionalProperties": false
}
},
"required": [
"id",
"type",
"title",
"itemIds",
"layout",
"config"
],
"additionalProperties": false
}
]
}
},
"required": [
"op",
"module"
],
"additionalProperties": false
}
]
}
}
},
"required": [
"idempotencyKey",
"operations"
],
"additionalProperties": false
}
}style_surfaceAction
Style the PRIVATE SPACE only; public-profile design uses edit_creation with action draft_profile. Author customDesign for exact colors, typography, geometry and artwork (read get_design_contract), or presets from get_design_catalog. No content/title/module-size changes; only explicit grammar reflows. No arbitrary CSS or HTML.
View tool JSON
{
"name": "style_surface",
"kind": "act",
"impl": "imperative",
"description": "Style the PRIVATE SPACE only; public-profile design uses edit_creation with action draft_profile. Author customDesign for exact colors, typography, geometry and artwork (read get_design_contract), or presets from get_design_catalog. No content/title/module-size changes; only explicit grammar reflows. No arbitrary CSS or HTML.",
"inputSchema": {
"type": "object",
"properties": {
"baseRevision": {
"type": "integer",
"minimum": 0,
"description": "Optional. If supplied and stale, the write is rejected without changing the page."
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "A unique key for this intended write. Reusing it safely returns the first result."
},
"customDesign": {
"type": [
"object",
"null"
],
"description": "Original authored design. Call get_design_contract for the complete validated schema and an example before writing. Complete replacement, not deep merge; null restores presets. Exact colors, typography, geometry and original vector artwork; no CSS, URLs or script."
},
"theme": {
"enum": [
"none",
"botanical",
"coastal",
"observatory"
],
"description": "A complete visual environment, not a topic filter. Botanical supplies drawn foliage and woodland surfaces; coastal supplies waves and shoreline surfaces; observatory supplies orbital artwork. Does not fetch images or change content."
},
"surfaces": {
"enum": [
"auto",
"ruled",
"cards",
"soft"
],
"description": "Module framing independent of theme. auto uses the scene's defaults; ruled is minimal; cards are crisp; soft adds rounded tactile surfaces."
},
"decoration": {
"enum": [
"none",
"quiet",
"expressive"
],
"description": "Amount of bundled decorative scene artwork. Never changes content-media visibility or playback."
},
"grammar": {
"enum": [
"flow",
"stage",
"compare",
"workspace"
]
},
"density": {
"enum": [
"airy",
"balanced",
"dense"
]
},
"emphasis": {
"enum": [
"recency",
"relevance",
"action",
"source"
]
},
"palette": {
"enum": [
"paper",
"stone",
"ink"
]
},
"accent": {
"enum": [
"moss",
"clay",
"ocean"
]
},
"imagery": {
"enum": [
"quiet",
"supporting",
"prominent"
]
},
"typeScale": {
"enum": [
"quiet",
"balanced",
"expressive"
]
},
"character": {
"enum": [
"journal",
"studio",
"workbench"
]
}
},
"required": [
"idempotencyKey"
],
"additionalProperties": false
}
}get_human_editsAnswer
Read the human's direct changes since an optional revision, including pins, hides, locks, moves, renames, note edits, and task toggles. Use before recomposing so the result respects their intent.
View tool JSON
{
"name": "get_human_edits",
"kind": "answer",
"impl": "imperative",
"description": "Read the human's direct changes since an optional revision, including pins, hides, locks, moves, renames, note edits, and task toggles. Use before recomposing so the result respects their intent.",
"inputSchema": {
"type": "object",
"properties": {
"sinceRevision": {
"type": "integer",
"minimum": 0,
"default": 0
}
},
"additionalProperties": false
}
}manage_local_itemsAction
Create or update a local Weft note/task, or toggle a task. External content stays read-only and human-created content is never deleted by this tool.
View tool JSON
{
"name": "manage_local_items",
"kind": "act",
"impl": "imperative",
"description": "Create or update a local Weft note/task, or toggle a task. External content stays read-only and human-created content is never deleted by this tool.",
"inputSchema": {
"type": "object",
"properties": {
"baseRevision": {
"type": "integer",
"minimum": 0,
"description": "Optional. If supplied and stale, the write is rejected without changing the page."
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "A unique key for this intended write. Reusing it safely returns the first result."
},
"action": {
"enum": [
"create",
"update",
"toggle_done"
]
},
"id": {
"type": "string",
"maxLength": 80
},
"kind": {
"enum": [
"note",
"task"
]
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"body": {
"type": "string",
"maxLength": 5000
},
"done": {
"type": "boolean"
}
},
"required": [
"idempotencyKey",
"action"
],
"additionalProperties": false
}
}manage_sourcesAction
List source connections or propose a public source from context the human deliberately shared with you. Proposals never fetch data or connect an account. The human must review them in the page; only approved RSS/Atom feeds become searchable.
View tool JSON
{
"name": "manage_sources",
"kind": "act",
"impl": "imperative",
"description": "List source connections or propose a public source from context the human deliberately shared with you. Proposals never fetch data or connect an account. The human must review them in the page; only approved RSS/Atom feeds become searchable.",
"inputSchema": {
"type": "object",
"properties": {
"action": {
"enum": [
"list",
"propose"
]
},
"kind": {
"enum": [
"rss",
"social",
"email",
"library"
]
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"url": {
"type": "string",
"maxLength": 500
},
"reason": {
"type": "string",
"maxLength": 240,
"description": "Why this source fits the human's stated interests."
}
},
"required": [
"action"
],
"additionalProperties": false
}
}prepare_shareAction
Prepare a share draft from selected modules. The page automatically excludes local notes, tasks, and private source data. This never publishes: the human reviews the draft in the page and chooses how to release it — as a self-contained link, or to their own handle at /@handle, where the author is verified and other people can follow it.
View tool JSON
{
"name": "prepare_share",
"kind": "act",
"impl": "imperative",
"description": "Prepare a share draft from selected modules. The page automatically excludes local notes, tasks, and private source data. This never publishes: the human reviews the draft in the page and chooses how to release it — as a self-contained link, or to their own handle at /@handle, where the author is verified and other people can follow it.",
"inputSchema": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"moduleIds": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 6
}
},
"required": [
"title",
"moduleIds"
],
"additionalProperties": false
}
}read_public_profileAnswer
Read a public Weft profile by handle and list the weaves that person has published. Public data only: a profile carries a handle, a display name, a bio and the titles of published weaves. It never reveals anyone's private space, sources, notes or receipts, and reading a profile neither notifies the person nor follows them.
View tool JSON
{
"name": "read_public_profile",
"kind": "answer",
"impl": "imperative",
"description": "Read a public Weft profile by handle and list the weaves that person has published. Public data only: a profile carries a handle, a display name, a bio and the titles of published weaves. It never reveals anyone's private space, sources, notes or receipts, and reading a profile neither notifies the person nor follows them.",
"inputSchema": {
"type": "object",
"properties": {
"handle": {
"type": "string",
"minLength": 3,
"maxLength": 25,
"description": "The handle to look up, with or without the leading @."
}
},
"required": [
"handle"
],
"additionalProperties": false
}
}follow_personAction
Propose that this space follow another person on Weft. A person is a source here, not a feed: following stages a connection exactly as manage_sources stages an RSS feed, and retrieves nothing until the human approves it in the page. Once approved, what arrives is that person's published items — never their layout. This space keeps its own arrangement, composed by you from material the human chose to let in. Nothing is sent to the person and they are not notified.
View tool JSON
{
"name": "follow_person",
"kind": "act",
"impl": "imperative",
"description": "Propose that this space follow another person on Weft. A person is a source here, not a feed: following stages a connection exactly as manage_sources stages an RSS feed, and retrieves nothing until the human approves it in the page. Once approved, what arrives is that person's published items — never their layout. This space keeps its own arrangement, composed by you from material the human chose to let in. Nothing is sent to the person and they are not notified.",
"inputSchema": {
"type": "object",
"properties": {
"action": {
"enum": [
"list",
"follow"
]
},
"handle": {
"type": "string",
"minLength": 3,
"maxLength": 25,
"description": "Required for follow. The handle to follow, with or without the leading @."
},
"reason": {
"type": "string",
"maxLength": 240,
"description": "Why this person fits what the human said they were interested in."
}
},
"required": [
"action"
],
"additionalProperties": false
}
}