diff --git a/apps/ui/html/agents.html b/apps/ui/html/agents.html index 825837c..ef14ef6 100644 --- a/apps/ui/html/agents.html +++ b/apps/ui/html/agents.html @@ -56,7 +56,7 @@
- +
⌘K @@ -66,11 +66,11 @@
-
AT
+
AT
- +
@@ -82,11 +82,11 @@
-
AT
+
AT
-
Operator
-
Admin · acme-workspace
+
Crank
+
—
- +
⌘K @@ -63,11 +63,11 @@
-
AT
+
AT
-
Operator
-
Admin · acme-workspace
+
Crank
+
—
- +
⌘K @@ -63,11 +63,11 @@
-
AT
+
AT
-
Operator
-
Admin · acme-workspace
+
Crank
+
—
+
⌘K @@ -63,11 +63,11 @@
-
AT
+
AT
-
Operator
-
Admin · acme-workspace
+
Crank
+
—
- +
@@ -69,11 +69,11 @@
-
AT
+
AT
-
Operator
-
Admin · acme-workspace
+
Crank
+
—
-
REST / HTTP
-
Standard HTTP verbs over a RESTful endpoint. The most broadly supported option.
+
REST / HTTP
+
Standard HTTP verbs over a RESTful endpoint. The most broadly supported option.
GET POST @@ -49,11 +49,11 @@
-
GraphQL
-
Query and mutate a GraphQL schema. Supports queries and mutations over one fixed operation.
+
GraphQL
+
Query and mutate a GraphQL schema. Supports queries and mutations over one fixed operation.
- Query - Mutation + Query + Mutation
@@ -68,10 +68,10 @@
-
gRPC
-
High-performance binary RPC over HTTP/2. Ideal for low-latency internal services.
+
gRPC
+
High-performance binary RPC over HTTP/2. Ideal for low-latency internal services.
- Unary + Unary Protobuf
diff --git a/apps/ui/html/wizard/step2.html b/apps/ui/html/wizard/step2.html index 4beb8d2..84bce0f 100644 --- a/apps/ui/html/wizard/step2.html +++ b/apps/ui/html/wizard/step2.html @@ -21,10 +21,10 @@
-
Upstream
-
Shared host, base URL, and authentication
+
Upstream
+
Shared host, base URL, and authentication
- Required + Required
@@ -32,7 +32,7 @@
- Select an upstream… + Select an upstream…
@@ -45,7 +45,7 @@ -
@@ -58,7 +58,7 @@
- +
@@ -69,7 +69,7 @@ - Register new upstream + Register new upstream
@@ -77,18 +77,18 @@
- + -
Unique identifier for this upstream.
+
Unique identifier for this upstream.
- + -
Root URL — no trailing slash. Supports ${secrets.*}.
+
Root URL — no trailing slash. Supports ${secrets.*}.
- +
@@ -98,11 +98,11 @@ "Authorization": "${secrets.API_KEY}" }
-
These headers are sent on every request to this upstream. Use secrets for credentials.
+
These headers are sent on every request to this upstream. Use secrets for credentials.
- - + +
@@ -119,19 +119,19 @@
-
Endpoint
-
Path and HTTP method for this specific operation
+
Endpoint
+
Path and HTTP method for this specific operation
- Required + Required
-
Appended to the upstream base URL. Use {param} for path variables.
+
Appended to the upstream base URL. Use {param} for path variables.
diff --git a/apps/ui/html/wizard/step3-graphql.html b/apps/ui/html/wizard/step3-graphql.html index eb17f74..125210d 100644 --- a/apps/ui/html/wizard/step3-graphql.html +++ b/apps/ui/html/wizard/step3-graphql.html @@ -18,20 +18,20 @@
-
Operation type
-
GraphQL operation kind — subscriptions are not supported
+
Operation type
+
GraphQL operation kind — subscriptions are not supported
- Required + Required
@@ -47,10 +47,10 @@
-
Query document
-
GraphQL document with typed variable declarations
+
Query document
+
GraphQL document with typed variable declarations
- Required + Required
@@ -82,10 +82,8 @@
-
Variables are mapped in step 5
-
- Declare all variables in the query document using the $variable: Type syntax. In step 5 you will map MCP input fields to these variables. Crank serialises the final {"query","variables"} payload automatically. -
+
Variables are mapped in step 5
+
Declare all variables in the query document using the $variable: Type syntax. In step 5 you will map MCP input fields to these variables. Crank serializes the final {"query","variables"} payload automatically.
diff --git a/apps/ui/html/wizard/step3-grpc.html b/apps/ui/html/wizard/step3-grpc.html index 509b114..c1b7762 100644 --- a/apps/ui/html/wizard/step3-grpc.html +++ b/apps/ui/html/wizard/step3-grpc.html @@ -12,15 +12,15 @@
@@ -32,10 +32,10 @@
-
Proto definition
-
Upload or paste your .proto file
+
Proto definition
+
Upload or paste your .proto file
- Required + Required
-
Drop .proto file here
-
or click to browse
+
Drop .proto file here
+
or click to browse
- +
- - + +
@@ -82,14 +82,14 @@
-
Select method
- Required +
Select method
+ Required
@@ -106,8 +106,8 @@
-
Descriptor-driven discovery
-
Use the saved draft and a descriptor set to discover services through the backend
+
Descriptor-driven discovery
+
Use the saved draft and a descriptor set to discover services through the backend
@@ -115,30 +115,30 @@
- No upstream selected - Select an upstream in step 2 first + No upstream selected + Select an upstream in step 2 first
@@ -147,14 +147,14 @@
-
Select method
- Required +
Select method
+ Required
@@ -171,27 +171,27 @@
-
Method route
-
Full gRPC path to the unary method
+
Method route
+
Full gRPC path to the unary method
- Required + Required
- + -
Format: /[package.]ServiceName/MethodName
+
Format: /[package.]ServiceName/MethodName
- + -
Protobuf message name, for documentation.
+
Protobuf message name, for documentation.
- + -
Protobuf message name, for documentation.
+
Protobuf message name, for documentation.
@@ -199,8 +199,8 @@
-
Input and output schemas are defined in step 4
-
In manual mode you only need the route. The MCP tool input/output schemas — which the LLM uses to call this tool — are configured in the next step regardless of Protobuf definitions.
+
Input and output schemas are defined in step 4
+
In manual mode you only need the route. The MCP tool input/output schemas — which the LLM uses to call this tool — are configured in the next step regardless of Protobuf definitions.
@@ -212,27 +212,27 @@
-
Method signature
+
Method signature
- gRPC route + gRPC route
- Request + Request
- Response + Response
diff --git a/apps/ui/html/wizard/step3-rest.html b/apps/ui/html/wizard/step3-rest.html index 6c0566d..f5d7082 100644 --- a/apps/ui/html/wizard/step3-rest.html +++ b/apps/ui/html/wizard/step3-rest.html @@ -18,32 +18,32 @@
-
HTTP method
-
Verb sent to the upstream on every tool invocation
+
HTTP method
+
Verb sent to the upstream on every tool invocation
- Required + Required
@@ -60,31 +60,31 @@
-
Request format
-
Content negotiation and serialisation
+
Request format
+
Content negotiation and serialisation
- Optional + Optional
- + -
How the request body is encoded when sent to the upstream.
+
How the request body is encoded when sent to the upstream.
- + -
Accepted response content types from the upstream server.
+
Accepted response content types from the upstream server.
diff --git a/apps/ui/html/wizard/step4.html b/apps/ui/html/wizard/step4.html index 2d918bf..8469977 100644 --- a/apps/ui/html/wizard/step4.html +++ b/apps/ui/html/wizard/step4.html @@ -16,47 +16,47 @@
-
Tool identity
-
Machine-readable name and LLM-facing description
+
Tool identity
+
Machine-readable name and LLM-facing description
-
Machine-readable identifier used in MCP tool calls. Only lowercase letters, numbers and underscores. Cannot be changed after publishing.
+
Machine-readable identifier used in MCP tool calls. Only lowercase letters, numbers and underscores. Cannot be changed after publishing.
-
Human-readable name shown in the console and audit log.
+
Human-readable name shown in the console and audit log.
-
Short imperative sentence shown in the MCP tool manifest.
+
Short imperative sentence shown in the MCP tool manifest.
-
LLM-facing description. Be precise — this is the primary signal the model uses to decide whether to invoke this tool.
+
LLM-facing description. Be precise — this is the primary signal the model uses to decide whether to invoke this tool.
@@ -68,10 +68,8 @@
-
Writing effective descriptions
-
- Start with a verb ("Creates", "Fetches", "Updates"). Mention key input requirements. Describe what a successful response looks like. Avoid vague phrasing like "handles" or "manages". See description best practices → -
+
Writing effective descriptions
+
Start with a verb ("Creates", "Fetches", "Updates"). Mention key input requirements. Describe what a successful response looks like. Avoid vague phrasing like "handles" or "manages". See description best practices →
@@ -84,10 +82,10 @@
-
Input schema
-
Parameters the LLM passes when calling this tool
+
Input schema
+
Parameters the LLM passes when calling this tool
- JSON Schema draft-07 + JSON Schema draft-07
@@ -122,10 +120,10 @@
-
Output schema
-
Shape of the data returned to the LLM after a successful call
+
Output schema
+
Shape of the data returned to the LLM after a successful call
- JSON Schema draft-07 + JSON Schema draft-07
@@ -153,10 +151,8 @@
-
Schemas are protocol-agnostic
-
- These schemas describe the MCP contract, not the upstream wire format. Field mapping in Step 5 translates between the two. You can upload a sample JSON response to auto-generate the output schema. -
+
Schemas are protocol-agnostic
+
These schemas describe the MCP contract, not the upstream wire format. Field mapping in Step 5 translates between the two. You can upload a sample JSON response to auto-generate the output schema.
diff --git a/apps/ui/html/wizard/step5.html b/apps/ui/html/wizard/step5.html index cc1a1c3..ffb37a7 100644 --- a/apps/ui/html/wizard/step5.html +++ b/apps/ui/html/wizard/step5.html @@ -9,7 +9,7 @@
- Input → Request + Input → Request
@@ -31,7 +31,7 @@ source: "$.input.source"
- Response → Output + Response → Output
@@ -51,7 +51,7 @@ owner_id: "$.response.data.owner.id"
- Execution + Execution
@@ -64,10 +64,10 @@ owner_id: "$.response.data.owner.id"
-
Execution config
-
Timeouts, retry policy and auth profile reference
+
Execution config
+
Timeouts, retry policy and auth profile reference
- Optional + Optional
@@ -88,7 +88,7 @@ tls:
- Live validation and publishing + Live validation and publishing
@@ -98,7 +98,7 @@ tls:
-
Draft actions
+
Draft actions
@@ -109,8 +109,8 @@ tls:
-
Live actions save the draft first
-
Sample uploads, test runs, YAML actions, publish and gRPC descriptor discovery all persist the current draft before calling the backend.
+
Live actions save the draft first
+
Sample uploads, test runs, YAML actions, publish and gRPC descriptor discovery all persist the current draft before calling the backend.
@@ -123,14 +123,14 @@ tls:
-
Samples and draft generation
-
Persist input/output samples, then generate schemas and mappings from real payloads.
+
Samples and draft generation
+
Persist input/output samples, then generate schemas and mappings from real payloads.
- +
- +
- - + +
- +
- +
- +
@@ -204,16 +204,16 @@ tls:
-
gRPC descriptor set
-
Upload a compiled descriptor set and discover unary methods from the saved draft.
+
gRPC descriptor set
+
Upload a compiled descriptor set and discover unary methods from the saved draft.
- - - No descriptor set selected + + + No descriptor set selected
@@ -228,20 +228,20 @@ tls:
-
YAML import and export
-
Move operation drafts between environments without leaving the wizard.
+
YAML import and export
+
Move operation drafts between environments without leaving the wizard.
- - - + + +
- - + +
@@ -254,14 +254,14 @@ tls:
-
Publish
-
Save the current draft and expose it to published agents.
+
Publish
+
Save the current draft and expose it to published agents.
-
Publishing uses the current draft version from this wizard session.
+
Publishing uses the current draft version from this wizard session.
- +
@@ -272,10 +272,8 @@ tls:
-
Operation stays editable in this wizard
-
- Saving creates or updates the current draft in place. Use the live actions above to upload samples, test the draft, export or import YAML, and publish when the upstream contract is ready. -
+
Operation stays editable in this wizard
+
Saving creates or updates the current draft in place. Use the live actions above to upload samples, test the draft, export or import YAML, and publish when the upstream contract is ready.
diff --git a/apps/ui/html/workspace-setup.html b/apps/ui/html/workspace-setup.html index 0d426d5..97b3eb1 100644 --- a/apps/ui/html/workspace-setup.html +++ b/apps/ui/html/workspace-setup.html @@ -167,11 +167,11 @@
AT
-
Operator (you)
+
Crank (you)
operator@acme.com
Today
- Owner + Owner
BS
@@ -181,11 +181,11 @@
2 days ago
- @@ -197,11 +197,11 @@
1 week ago
- @@ -213,11 +213,11 @@
Never
- @@ -235,8 +235,8 @@
Invited 3 days ago · not yet accepted
—
- Developer - @@ -246,19 +246,19 @@
Roles & permissions
- Owner + Owner
Full workspace control, billing access, can transfer or delete the workspace.
- Admin + Admin
Manage members and roles, create and edit all operations and agents, manage API keys.
- Developer + Developer
Create and edit operations and agents. Cannot manage members or workspace settings.
- Viewer + Viewer
Read-only access to operations, agents, and logs.
diff --git a/apps/ui/index.html b/apps/ui/index.html index 75b15d5..fa03f88 100644 --- a/apps/ui/index.html +++ b/apps/ui/index.html @@ -55,7 +55,7 @@
- @@ -72,12 +72,12 @@
-
AT
+
AT
-
Operator
-
Admin · acme-workspace
+
Crank
+
—
' : '' + roleLabel(membership.role) + '' @@ -189,7 +189,7 @@ function renderInvitations() { '
' + '
—
' + '' + roleLabel(invitation.role) + '' + - ''; pending.appendChild(row);