Skip to main content

Manifest and distribution reference

Files and parser fields

Start with the manifest guide for complete JSON examples and required fields. These values identify file parsers and interfaces; preserve the generated values in your project:

File or interface Version and purpose
Extension manifest glixo.extension.json uses schemaVersion: 2 to describe code, contributions, permissions and configuration.
Catalog metadata glixo.module.json uses manifestVersion: 1 for the package listing and distribution metadata.
Publisher signature canonicalizationVersion: 2 selects the format used to prepare signed metadata.
Generic contribution WIT world Version 1.0.0: the interface used by tools and other contributions.
Provider HTTP/WIT ABI Version 3.0.0: the interface used by model-provider components.
Optional provider account status account-status/1.0.0: quota, plan and billing snapshots, versioned separately from inference.

glxdev pack generates the distribution file from your extension manifest and package bytes. CLI and SDK package versions are listed separately below.

Host-issued handles

Glixo supplies handles that let an extension use a specific approved connection, secret, workspace, state store or event. Each call is checked against the active package, account, permissions and resource limits. These handles do not give code unrestricted filesystem access, environment secrets, process execution or arbitrary network access.

Optional model-provider account status

A model provider can also report its selected account's plan, quotas, reset times or billing data. This is an optional companion to the LLM provider contribution, not a separate extension type. Providers that only support inference do not need it. Status support requires a compatible host; the public Ollama examples do not implement this companion.

Inside a contributions.llmProviders[] entry, declare:

"accountStatus": {
  "interfaceVersion": "account-status/1.0.0"
}

This fragment belongs inside an existing provider entry; it is not a complete manifest. The declaration does not grant access to secrets or endpoints. The host uses the same installed contribution and account permissions as inference.

The WIT package is glixo:llm-account-status@1.0.0. Its provider export has two operations:

Operation Behavior
describe() Returns supported metrics and whether extra credentials are needed. It must not make a network request or require account credentials.
read(context, provider-context-json) Returns a snapshot for the host-selected integration-account-id and optional machine-id. The second argument contains host-issued configuration and endpoint handles.

Both operations return JSON strings described by the account-status schema. Use provider-compat-with-account-status or provider-async-with-account-status when the same component exports inference and status. Implement the component interface in your extension project; the host supplies authorization and rendering.

Keep these meanings in every snapshot:

The host authorizes the exact account, caches status and publishes updates through its existing invalidation feed. Do not add a UI polling loop or make paid inference requests just to retrieve usage. Status failure does not make inference unsupported: account setup treats connection checks and usage checks separately.

Workflow extension nodes

A workflow extension node binds an installed tools[] contribution into a workflow graph. The guest package still uses the existing signed manifest contract: each tool declares inputSchema, outputSchema, a safety class, and its component export. It requests the scoped tool.invoke permission for the specific tool ID. The Workflow Designer does not add a new manifest contribution kind.

Designer host API

The tool palette lists installed, active tools that the current account can use in Workflow Designer. Reading tools or configuration requires WorkflowsRead; saving a binding or configuration requires WorkflowsManage. All routes require a Designer context.

Operation Route Contract
List eligible tools GET /vnext/workflow/extension-nodes?definitionId={definitionId} Returns { extensionNodes: [...] } for verified active tools eligible to the account. Each descriptor includes selectionId, title, description, package ID/version/digest, contribution ID, input/output schemas, available secret-slot metadata, and fixed runtime flags (timeoutMs: 10000, cancellable: true, idempotent: false). Tools requiring confirmation for every call are omitted.
Bind a tool to a draft node PUT /vnext/workflow/definitions/{definitionId}/draft/nodes/{nodeId}/extension-binding Requires If-Match; body is { "selectionId": "..." }. Glixo checks that the selected tool is still available and returns its bindingId, signed schemas, non-secret defaults, secret-slot metadata, status and the new draft ETag.
Read node settings GET /vnext/workflow/definitions/{definitionId}/draft/nodes/{nodeId}/extension-configuration Reads the host-managed configuration resource for the node.
Save node settings PUT /vnext/workflow/definitions/{definitionId}/draft/nodes/{nodeId}/extension-configuration Requires If-Match; body is { "bindingId": "...", "configuration": { ... }, "secrets": { ... } }, with secrets optional. The UI submits masked secret entries separately in this map; secret values are stored through the host vault and returned as redacted slot metadata, never in configuration.

The graph stores the node kind workflow-extension-node, its bindingId and optional inputBindings. Labels, package metadata and node settings are stored separately by Glixo. A binding maps a tool input to a scalar value, for example { "text": "$.text" }. Up to 32 tool properties can be bound. Paths read the current run input or the immediately preceding node's output. Missing or non-scalar values are rejected.

Node configuration is a host-managed resource, not graph data. The current schema exposes vault-backed inputs only for top-level string properties annotated x-secret; the host returns their slots redacted. Nested or non-string secret fields are not supported by this editor.

You can save a draft before connecting every required input. Publishing checks that required inputs have values in configuration, bindings or secret slots. At runtime, a missing or non-scalar path value fails the node with workflow_extension_input_binding_missing. Each published workflow saves the selected package digest, tool schema and configuration revision. Updating an extension does not change an already-published workflow; republish to select the new version. Before running a tool, Glixo checks that the selected package is still installed and approved.

Hosted workflows cannot currently display a confirmation prompt for each tool call. A tool with confirmation: invoke or a safety class other than readonly needs a workflow approval step and cannot run automatically here. Read-only tools without per-call confirmation can run after installation and approval of the tool permission.

Text Stats example

The workflow-text-stats C# project README describes a read-only tools[] contribution. The source list includes the other languages. Its text-stats tool accepts text and optional counting settings, then returns word and character counts. It has been tested with installed packages in all four languages using a protocol-2 development runner.

Support status

Compatibility depends on the app version, platform and example. The examples remain Preview unless they explicitly list released-app support. A successful local build produces a component; using it in Glixo also requires a compatible app, installation and the user's permissions.

SDK documentation

See the SDK overview for language setup, API guides and a source/WIT download. The dedicated guides cover TypeScript, C#, Go, Rust, host APIs, HTTP, providers and UI.

SDK source and build matrix

The SDK build matrix lists compiler versions and commands for each language. These examples use community-source revision 7052b3f954418cff91439236942a6623d75e8907. The runtime-version file lists the extension runner protocol and WIT interfaces. Read the build matrix and runtime interfaces directly.

Language Pinned recipe toolchain Status
Rust Rust/Cargo 1.96.0, wit-bindgen 0.62.0, wasm-tools 1.239.0, wasm32-wasip2 Preview
Go Go 1.27.1, componentize-go 0.4.3 Preview
C# .NET SDK 10.0.301, componentize-dotnet 0.8.0-preview00011, wit-bindgen-csharp 0.58.0 Preview
TypeScript Node.js 22.14.0, npm 10.9.2, TypeScript 6.0.3, Jco 1.35.0, componentize-js 0.23.0, esbuild 0.28.2, preview2-shim 0.25.0 Preview

Published CLI and SDK packages

These examples use published CLI version 0.3.5. The @glixo/extension-sdk npm package and Go module are published at 0.1.0. NuGet and Cargo SDK packages are not published yet. The SDK remains Preview; CLI, SDK and compiler versions are separate.

Package versions and checksums

The checksums below identify the package downloads used by these examples. npm also checks the listed integrity value when installing a package.

Package Published version Registry size SHA-256 npm integrity / availability
@glixo/glxdev 0.3.5 925,376 bytes 9929f78c1c841c5429584beb1d7eb0648043f0327214a1f558227ffd5ae83870 sha512-TVHiA23KJmiTcLZEHNhbkVp07am3pPz3/wTbtJI0HQhsTvPI/L0nFem79f+Nspifh9AD7loPeIYl3p6HOecrrA==; published on npm
@glixo/extension-sdk 0.1.0 4,492 bytes 0137aac5d5038a0cad15c2b0e3f70bd7ee13134c9f8762477e223bc73810c26a sha512-xEc+GT69tASVPyFFQsAncjcV41VZaPRKGo0OiUK0UE1QZDcq4R3+ao4m/EcV4vVpnwT/VeiEhmUjLLQYGq0tcQ==; published on npm
Go SDK module v0.1.0 — source tag a987f8aa766201b0f6fa4234f12b63c70234d9b7 Published through the Go proxy; public proxy consumer test passed
SDK NuGet and Cargo packages — — — Not published yet

Source identities

Use these source links to reproduce the examples. The table lists the exact revision, project files and compatibility notes for each example.

Example Source version and files Compatibility
Ollama provider reference Source revision 7052b3f9 · references/ollama-provider/csharp/README.md
references/ollama-provider/csharp/src/Provider.cs
references/ollama-provider/go/README.md
references/ollama-provider/go/provider/provider.go
references/ollama-provider/rust/README.md
references/ollama-provider/rust/src/lib.rs
references/ollama-provider/typescript/README.md
references/ollama-provider/typescript/src/provider.ts
references/_shared/host-evidence/ollama-provider-protocol2.json
references/ollama-provider/typescript/glixo.extension.json
Preview. Tested with local Gemma and tool-call follow-ups in all four languages using a development runner.
Mail Watch service reference Source revision 7052b3f9 · references/mail-watch/csharp/MailWatch.cs
references/mail-watch/go/mailwatch/mailwatch.go
references/mail-watch/rust/src/lib.rs
references/mail-watch/typescript/src/mail-watch.ts
references/mail-watch/configuration.schema.json
references/mail-watch/typescript/glixo.extension.json
Preview. TypeScript installation and scheduling have been tested with simulated Graph responses. C#, Go and Rust installed-app tests and real mailbox sign-in and delivery are incomplete.
Conversation Insights middleware reference Source revision 7052b3f9 · references/conversation-insights/csharp/src/GuestImpl.cs
references/conversation-insights/go/internal/middleware/guest.go
references/conversation-insights/rust/src/lib.rs
references/conversation-insights/typescript/src/guest.ts
Preview. Read-only message observer in four languages. Use in the app's conversation flow, permission changes and account isolation are still being tested.
Prompt Redactor middleware reference Source revision 7052b3f9 · references/prompt-redactor/csharp/src/GuestImpl.cs
references/prompt-redactor/go/internal/middleware/guest.go
references/prompt-redactor/rust/src/lib.rs
references/prompt-redactor/typescript/src/guest.ts
Preview. Message redaction in four languages, with separate input and output permissions. Conversation integration, required-redaction failures and permission removal are still being tested.
Workspace Health reference Source revision 7052b3f9 · references/workspace-health/csharp/src/Handler.cs
references/workspace-health/go/internal/workspacehealth/handler.go
references/workspace-health/rust/src/lib.rs
references/workspace-health/typescript/src/handler.ts
Preview. Inspects files in the selected workspace. Results may be truncated. Installation and workspace-permission checks are still being tested.
Document Index reference Source revision 7052b3f9 · references/document-index/csharp/src/Handler.cs
references/document-index/go/internal/documentindex/handler.go
references/document-index/rust/src/lib.rs
references/document-index/typescript/src/handler.ts
references/document-index/typescript/glixo.extension.json
Preview. Matches relative file paths and returns small excerpts; it is not semantic search. Workspace permissions in the installed app are still being tested.
Workspace Storage reference Source revision 7052b3f9 · references/workspace-storage/csharp/src/StorageHandler.cs
references/workspace-storage/go/storage/handler.go
references/workspace-storage/rust/src/lib.rs
references/workspace-storage/typescript/src/handler.ts
Preview. Key/value storage under an approved prefix. Persistence and permissions in the installed app are still being tested.
Issue Lookup MCP reference Source revision 7052b3f9 · references/issue-lookup-mcp/csharp/IssueLookup.cs
references/issue-lookup-mcp/go/internal/issuelookup/handler.go
references/issue-lookup-mcp/rust/src/lib.rs
references/issue-lookup-mcp/typescript/src/handler.ts
Preview. Calls an issue-lookup tool through an approved Streamable HTTP connection. Use with a real issue tracker and account-permission changes is still being tested.
Extension SDK toolchain and recipe matrix Source revision 7052b3f9 · packages/extension-sdk/README.md
packages/extension-sdk/support-matrix.json
packages/extension-sdk/runtime-versions.json
references/review-checklist/README.md
packages/extension-sdk/wit/manifest/extension-manifest-v2.schema.json
packages/extension-sdk/typescript/src/index.ts
packages/extension-sdk/typescript/src/wit.ts
packages/extension-sdk/csharp/Glixo.ExtensionSdk/Guest.cs
packages/extension-sdk/csharp/Glixo.ExtensionSdk/Http.cs
packages/extension-sdk/csharp/Glixo.ExtensionSdk/State.cs
packages/extension-sdk/csharp/Glixo.ExtensionSdk/Workspace.cs
packages/extension-sdk/csharp/Glixo.ExtensionSdk/Logging.cs
packages/extension-sdk/csharp/Glixo.ExtensionSdk/Llm.cs
packages/extension-sdk/go/go.mod
packages/extension-sdk/go/guest/guest.go
packages/extension-sdk/go/state/state.go
packages/extension-sdk/go/workspace/workspace.go
packages/extension-sdk/go/logging/logging.go
packages/extension-sdk/go/httpbroker/http.go
packages/extension-sdk/go/llm/events.go
packages/extension-sdk/rust/Cargo.toml
packages/extension-sdk/rust/src/lib.rs
packages/extension-sdk/rust/src/guest.rs
packages/extension-sdk/rust/src/state.rs
packages/extension-sdk/rust/src/workspace.rs
packages/extension-sdk/rust/src/http.rs
packages/extension-sdk/rust/src/llm.rs
packages/extension-sdk/typescript/src/guest.ts
packages/extension-sdk/wit/contribution/contribution.wit
packages/extension-sdk/wit/deps/http/types.wit
packages/extension-sdk/typescript/src/http.ts
packages/extension-sdk/wit/deps/http/broker.wit
packages/extension-sdk/wit/provider-compat.wit
packages/extension-sdk/wit/deps/llm-types/types.wit
Preview. Build recipes are available in four languages. npm and Go SDK packages are published at 0.1.0; NuGet and Cargo packages are not published yet. The SDK is not supported in a released app.
Accessible Theme UI sample and shared controls Source revision 7052b3f9 · references/accessible-theme/README.md
references/accessible-theme/placements.json
references/accessible-theme/csharp/glixo.extension.json
references/accessible-theme/csharp/glixo.project.json
references/accessible-theme/csharp/reference.json
references/accessible-theme/csharp/src/GuestExports.cs
references/accessible-theme/csharp/src/StorageHandler.cs
references/accessible-theme/go/glixo.extension.json
references/accessible-theme/go/glixo.project.json
references/accessible-theme/go/reference.json
references/accessible-theme/go/guest/guest.go
references/accessible-theme/go/storage/handler.go
references/accessible-theme/rust/glixo.extension.json
references/accessible-theme/rust/glixo.project.json
references/accessible-theme/rust/reference.json
references/accessible-theme/rust/src/lib.rs
references/accessible-theme/typescript/glixo.extension.json
references/accessible-theme/typescript/glixo.project.json
references/accessible-theme/typescript/reference.json
references/accessible-theme/typescript/src/guest.ts
references/accessible-theme/typescript/src/handler.ts
references/_shared/ui/accessible-theme/index.html
references/accessible-theme/src/theme.ts
references/accessible-theme/src/components.ts
references/accessible-theme/src/extension-ui.css
references/accessible-theme/src/index.ts
references/accessible-theme/placements.json
references/accessible-theme/typescript/ui/index.html
Preview on Windows. Signed installation, account permissions and the complete action flow are still being tested. Unavailable on Linux and unsupported on mobile. The sample changes only its own panel; Glixo has no installed-theme selector.
Workflow Text Stats tool reference Source revision 7052b3f9 · references/workflow-text-stats/csharp/README.md
references/workflow-text-stats/csharp/glixo.extension.json
references/workflow-text-stats/csharp/src/Handler.cs
references/workflow-text-stats/csharp/src/GuestExports.cs
references/workflow-text-stats/go/README.md
references/workflow-text-stats/go/glixo.extension.json
references/workflow-text-stats/go/internal/workflowtextstats/stats.go
references/workflow-text-stats/go/generated/wit/export_provider/export_glixo_contribution_guest/guest.go
references/workflow-text-stats/rust/README.md
references/workflow-text-stats/rust/glixo.extension.json
references/workflow-text-stats/rust/src/lib.rs
references/workflow-text-stats/typescript/README.md
references/workflow-text-stats/typescript/glixo.extension.json
references/workflow-text-stats/typescript/src/handler.ts
references/workflow-text-stats/typescript/src/guest.ts
references/workflow-text-stats/typescript/package.json
references/workflow-text-stats/csharp/Glixo.Contribution.csproj
references/workflow-text-stats/go/go.mod
references/workflow-text-stats/rust/Cargo.toml
Preview. Installed-package tests passed in all four languages with a development runner.

UI and shared controls

Accessible Theme adds a settings panel at settings.extensions and stores preferences in its own storage scope. It changes its own panel, not Glixo Code's appearance. The Windows sample is experimental: signed installation, account permissions and the complete action flow are still being tested. Custom panels are unavailable on Linux and unsupported on mobile.

The @glixo/extension-ui helper provides controls and theme values for extension authors. Glixo's own controls inherit the active app theme. A custom panel receives theme values through its bridge and applies them in its own code. The sample has no mobile WebView support.

Catalog security checks

The catalog API returns signed glixo.module.json metadata from GET https://api.glixo.dev/v1/extensions/catalog. Packages for different runtime identifiers must agree on execution settings, permissions and contributions. An entry without matching signed metadata is browse-only.

Before installing an artifact or starting a new extension process, Glixo verifies the certificate, signature and package digest and checks the publisher key with GET /v1/extensions/{id}/versions/{version}/authority?sha256={lowercase-sha256}. The response must use schemaVersion: 1, return allowed: true, and match the extension ID, version, publisher ID, key ID and digest. The request has an 8-second timeout, allows no redirects and accepts up to 16 KiB. Responses require Cache-Control: no-store so cached catalog data cannot authorize a disabled key.

The claimed signing-key ID must match the SHA-256 fingerprint of the actual Ed25519 public key. Glixo checks the current installation and activation state again after the key check returns. Disabling or retiring the extension during that check prevents launch. This also applies to lazy starts and restarts after a crash or idle shutdown. A remote key change does not continuously stop a process that is already running; account permissions are checked separately.

When catalog settings are saved, the official https://extend.glixo.io source is stored as glixo-public-catalog with its API URL. Its enabled setting is preserved.