{ "name": "spin", "runtime": "component", "exports": { "run": { "description": "Execute additional Spin or plugin commands with literal CSV arguments.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." }, "arguments": { "type": "string", "minLength": 1, "description": "Additional literal native tokens in CSV form; CSV quotes preserve commas inside a token." } }, "required": [ "runDir", "arguments" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } }, "version": { "description": "Print the installed Spin version.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." } }, "required": [ "runDir" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } }, "build": { "description": "Build application components with the project toolchains.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." }, "from": { "type": "string", "minLength": 1, "description": "Local app manifest/directory or native remote reference where supported; native CLI validates the source." }, "profile": { "type": "string", "minLength": 1, "description": "Named build profile." }, "components": { "type": "string", "description": "Comma-separated component IDs; omitted builds all components." }, "skipTargetChecks": { "type": "boolean", "description": "Skip deployment-target compatibility checks." }, "skipGenerateWits": { "type": "boolean", "description": "Skip generating dependency WIT files." }, "arguments": { "type": "string", "description": "Additional literal native tokens in CSV form; CSV quotes preserve commas inside a token." } }, "required": [ "runDir" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } }, "registry_push": { "description": "Push an application as an OCI artifact using native registry credentials.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." }, "reference": { "type": "string", "minLength": 1, "description": "OCI registry reference including the desired tag." }, "from": { "type": "string", "minLength": 1, "description": "Local app manifest/directory or native remote reference where supported; native CLI validates the source." }, "profile": { "type": "string", "minLength": 1, "description": "Build profile to push." }, "build": { "type": "boolean", "description": "Build before pushing." }, "compose": { "type": "boolean", "description": "Compose component dependencies before pushing." }, "annotations": { "type": "string", "description": "Comma-separated KEY=VALUE OCI image annotations." }, "cacheDir": { "type": "string", "minLength": 1, "description": "Directory for registry cache data." }, "insecure": { "type": "boolean", "description": "Explicitly ignore registry certificate errors." }, "arguments": { "type": "string", "description": "Additional literal native tokens in CSV form; CSV quotes preserve commas inside a token." } }, "required": [ "runDir", "reference" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } }, "registry_pull": { "description": "Pull an application from an OCI registry.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." }, "reference": { "type": "string", "minLength": 1, "description": "OCI registry reference to pull." }, "prepare": { "type": "string", "minLength": 1, "description": "Output directory for a prepared app; native CLI requires absent or empty directory." }, "cacheDir": { "type": "string", "minLength": 1, "description": "Directory for registry cache data." }, "insecure": { "type": "boolean", "description": "Explicitly ignore registry certificate errors." }, "arguments": { "type": "string", "description": "Additional literal native tokens in CSV form; CSV quotes preserve commas inside a token." } }, "required": [ "runDir", "reference" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } }, "deploy": { "description": "Deploy through the plugin named by SPIN_DEPLOY_PLUGIN; arguments are plugin-specific.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." }, "arguments": { "type": "string", "description": "Additional literal native tokens in CSV form; CSV quotes preserve commas inside a token." } }, "required": [ "runDir" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } }, "cloud_deploy": { "description": "Deploy through the explicitly installed Fermyon cloud plugin.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." }, "from": { "type": "string", "minLength": 1, "description": "Local app manifest/directory or native remote reference where supported; native CLI validates the source." }, "build": { "type": "boolean", "description": "Build the local app before deployment." }, "environmentName": { "type": "string", "minLength": 1, "description": "Saved Fermyon deployment environment." }, "readinessTimeout": { "type": "integer", "minimum": 0, "description": "Readiness wait in seconds; zero skips waiting." }, "variables": { "type": "string", "description": "Comma-separated KEY=VALUE app variables. Avoid passing secrets in argv." }, "keyValues": { "type": "string", "description": "Comma-separated KEY=VALUE entries for the default store." }, "links": { "type": "string", "description": "Comma-separated explicit resource links, such as sqlite:label=database." }, "arguments": { "type": "string", "description": "Additional literal native tokens in CSV form; CSV quotes preserve commas inside a token." } }, "required": [ "runDir" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } }, "cloud_login": { "description": "Authenticate the cloud plugin using inherited SPIN_AUTH_TOKEN without browser login.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." }, "environmentName": { "type": "string", "minLength": 1, "description": "Name under which to save the login." }, "url": { "type": "string", "minLength": 1, "description": "Cloud instance URL." }, "arguments": { "type": "string", "description": "Additional literal native tokens in CSV form; CSV quotes preserve commas inside a token." } }, "required": [ "runDir" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } }, "plugins_install": { "description": "Install a selected deployment/runtime plugin explicitly.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." }, "name": { "type": "string", "minLength": 1, "description": "Plugin name, for example cloud." }, "pluginVersion": { "type": "string", "minLength": 1, "description": "Exact plugin release; omitted uses native selection." }, "yes": { "type": "boolean", "description": "Explicitly accept the plugin installation prompt." }, "arguments": { "type": "string", "description": "Additional literal native tokens in CSV form; CSV quotes preserve commas inside a token." } }, "required": [ "runDir", "name" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } }, "plugins_list": { "description": "Inspect installed Spin plugins.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." }, "installed": { "type": "boolean", "description": "List installed plugins only." }, "arguments": { "type": "string", "description": "Additional literal native tokens in CSV form; CSV quotes preserve commas inside a token." } }, "required": [ "runDir" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } }, "up": { "description": "Run an application in the foreground; use a scoped lifecycle and bounded timeout.", "input": { "type": "object", "properties": { "project": { "type": "string", "default": ".", "minLength": 1, "description": "Working directory containing the source checkout; defaults to the current directory. Default: \".\"." }, "runDir": { "type": "string", "minLength": 1, "description": "Fresh directory for this invocation’s execution report and task logs; must not already exist." }, "executable": { "type": "string", "minLength": 1, "description": "Native CLI executable name or absolute path; defaults to this operation’s tool." }, "timeoutMs": { "type": "integer", "minimum": 1, "default": 900000, "description": "Maximum task duration in milliseconds; defaults to 900000. Default: 900000." }, "artifacts": { "type": "string", "description": "Comma-separated NAME=PATH output artifacts; use CSV double quotes around entries containing commas." }, "from": { "type": "string", "minLength": 1, "description": "Local app manifest/directory or native remote reference where supported; native CLI validates the source." }, "build": { "type": "boolean", "description": "Build the application first." }, "env": { "type": "string", "description": "Comma-separated KEY=VALUE component environment overrides." }, "arguments": { "type": "string", "description": "Additional literal native tokens in CSV form; CSV quotes preserve commas inside a token." } }, "required": [ "runDir" ], "additionalProperties": false }, "output": { "type": "object", "required": [ "outcome", "runDir", "reportPath", "stdoutPath", "stderrPath" ], "properties": { "outcome": { "type": "string" }, "runDir": { "type": "string" }, "reportPath": { "type": "string" }, "stdoutPath": { "type": "string" }, "stderrPath": { "type": "string" } }, "additionalProperties": false } } } }