KosmoKrator

productivity

Travis CI Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Travis CI KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.travis_ci.*. Use lua_read_doc("integrations.travis-ci") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Travis CI workflow without starting an interactive agent session.

Inline Lua call 
kosmo integrations:lua --eval 'dump(app.integrations.travis_ci.get_current_user({}))' --json
Read Lua docs headlessly 
kosmo integrations:lua --eval 'print(docs.read("travis-ci"))' --json
kosmo integrations:lua --eval 'print(docs.read("travis-ci.get_current_user"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua 
local travis_ci = app.integrations.travis_ci
local result = travis_ci.get_current_user({})

dump(result)
Run the workflow 
kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json
Namespace note. integrations:lua exposes app.integrations.travis_ci, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.travis_ci.default.* or app.integrations.travis_ci.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Travis CI, use the narrower mcp:lua command.

MCP Lua command 
# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Travis CI

Travis CI tools are available under app.integrations.travis-ci.

Use this integration to inspect repositories, builds, jobs, job logs, build requests, repository settings, and environment variables through Travis CI API V3. Requests include Travis-API-Version: 3 and Authorization: token <token>.

Repository References

Repository arguments accept:

  • A numeric Travis repository id, such as 891.
  • An owner/name slug, such as acme/web.
  • A provider/owner/name slug, such as github/acme/web.

Slug path parts are URL-encoded before calling Travis.

Examples

List recent builds:

local builds = app.integrations["travis-ci"].travis_ci_list_repository_builds({
  repository = "acme/web",
  query = {
    limit = 10,
    sort_by = "number:desc",
    include = "build.commit,build.jobs"
  }
})

Restart a failed build:

app.integrations["travis-ci"].travis_ci_restart_build({
  build_id = 86601346
})

Fetch a plain text job log:

local log = app.integrations["travis-ci"].travis_ci_get_job_log({
  job_id = 86601347,
  plain_text = true
})

Trigger a build request:

local request = app.integrations["travis-ci"].travis_ci_create_request({
  repository = "acme/web",
  payload = {
    request = {
      branch = "main",
      message = "Triggered by agent"
    }
  }
})

Raw API Helpers

Use raw helpers for newer or long-tail API V3 endpoints:

local repo = app.integrations["travis-ci"].travis_ci_api_get({
  path = "/repo/891",
  query = { include = "repository.current_build" }
})

Raw paths must be relative. Full external URLs are rejected.

Response Shape

JSON responses are returned as Travis provides them. Empty successful responses return { success = true }. Plain text logs return { value = "..." }.

Safety

  • Examples use fake ids and repository names.
  • Tool access depends on the permissions granted to the Travis token.
  • Debug jobs are only available on supported Travis hosts and repositories.
  • Environment variable values may be sensitive; avoid returning or storing secrets in downstream logs.
Raw agent markdown 
# Travis CI

Travis CI tools are available under `app.integrations.travis-ci`.

Use this integration to inspect repositories, builds, jobs, job logs, build requests, repository settings, and environment variables through Travis CI API V3. Requests include `Travis-API-Version: 3` and `Authorization: token <token>`.

## Repository References

Repository arguments accept:

- A numeric Travis repository id, such as `891`.
- An owner/name slug, such as `acme/web`.
- A provider/owner/name slug, such as `github/acme/web`.

Slug path parts are URL-encoded before calling Travis.

## Examples

List recent builds:

```lua
local builds = app.integrations["travis-ci"].travis_ci_list_repository_builds({
  repository = "acme/web",
  query = {
    limit = 10,
    sort_by = "number:desc",
    include = "build.commit,build.jobs"
  }
})
```

Restart a failed build:

```lua
app.integrations["travis-ci"].travis_ci_restart_build({
  build_id = 86601346
})
```

Fetch a plain text job log:

```lua
local log = app.integrations["travis-ci"].travis_ci_get_job_log({
  job_id = 86601347,
  plain_text = true
})
```

Trigger a build request:

```lua
local request = app.integrations["travis-ci"].travis_ci_create_request({
  repository = "acme/web",
  payload = {
    request = {
      branch = "main",
      message = "Triggered by agent"
    }
  }
})
```

## Raw API Helpers

Use raw helpers for newer or long-tail API V3 endpoints:

```lua
local repo = app.integrations["travis-ci"].travis_ci_api_get({
  path = "/repo/891",
  query = { include = "repository.current_build" }
})
```

Raw paths must be relative. Full external URLs are rejected.

## Response Shape

JSON responses are returned as Travis provides them. Empty successful responses return `{ success = true }`. Plain text logs return `{ value = "..." }`.

## Safety

- Examples use fake ids and repository names.
- Tool access depends on the permissions granted to the Travis token.
- Debug jobs are only available on supported Travis hosts and repositories.
- Environment variable values may be sensitive; avoid returning or storing secrets in downstream logs.
Metadata-derived Lua example 
local result = app.integrations.travis_ci.get_current_user({})
print(result)

Functions

get_current_user Read

Get authenticated Travis CI user details.

Lua path
app.integrations.travis_ci.get_current_user
Full name
travis-ci.travis_ci_get_current_user
ParameterTypeRequiredDescription
No parameters.
list_repositories Read

List repositories visible to the current user.

Lua path
app.integrations.travis_ci.list_repositories
Full name
travis-ci.travis_ci_list_repositories
ParameterTypeRequiredDescription
No parameters.
list_owner_repositories Read

List repositories for an owner.

Lua path
app.integrations.travis_ci.list_owner_repositories
Full name
travis-ci.travis_ci_list_owner_repositories
ParameterTypeRequiredDescription
No parameters.
get_repository Read

Get a repository by id or slug.

Lua path
app.integrations.travis_ci.get_repository
Full name
travis-ci.travis_ci_get_repository
ParameterTypeRequiredDescription
No parameters.
activate_repository Write

Activate a repository.

Lua path
app.integrations.travis_ci.activate_repository
Full name
travis-ci.travis_ci_activate_repository
ParameterTypeRequiredDescription
No parameters.
deactivate_repository Write

Deactivate a repository.

Lua path
app.integrations.travis_ci.deactivate_repository
Full name
travis-ci.travis_ci_deactivate_repository
ParameterTypeRequiredDescription
No parameters.
list_builds Read

List builds visible to the current user.

Lua path
app.integrations.travis_ci.list_builds
Full name
travis-ci.travis_ci_list_builds
ParameterTypeRequiredDescription
No parameters.
list_repository_builds Read

List builds for a repository.

Lua path
app.integrations.travis_ci.list_repository_builds
Full name
travis-ci.travis_ci_list_repository_builds
ParameterTypeRequiredDescription
No parameters.
get_build Read

Get one build by id.

Lua path
app.integrations.travis_ci.get_build
Full name
travis-ci.travis_ci_get_build
ParameterTypeRequiredDescription
No parameters.
cancel_build Write

Cancel a running build.

Lua path
app.integrations.travis_ci.cancel_build
Full name
travis-ci.travis_ci_cancel_build
ParameterTypeRequiredDescription
No parameters.
restart_build Write

Restart a completed or canceled build.

Lua path
app.integrations.travis_ci.restart_build
Full name
travis-ci.travis_ci_restart_build
ParameterTypeRequiredDescription
No parameters.
list_jobs Read

List jobs visible to the current user.

Lua path
app.integrations.travis_ci.list_jobs
Full name
travis-ci.travis_ci_list_jobs
ParameterTypeRequiredDescription
No parameters.
list_build_jobs Read

List jobs for one build.

Lua path
app.integrations.travis_ci.list_build_jobs
Full name
travis-ci.travis_ci_list_build_jobs
ParameterTypeRequiredDescription
No parameters.
get_job Read

Get one job by id.

Lua path
app.integrations.travis_ci.get_job
Full name
travis-ci.travis_ci_get_job
ParameterTypeRequiredDescription
No parameters.
cancel_job Write

Cancel a running job.

Lua path
app.integrations.travis_ci.cancel_job
Full name
travis-ci.travis_ci_cancel_job
ParameterTypeRequiredDescription
No parameters.
restart_job Write

Restart a completed or canceled job.

Lua path
app.integrations.travis_ci.restart_job
Full name
travis-ci.travis_ci_restart_job
ParameterTypeRequiredDescription
No parameters.
debug_job Write

Restart a job in debug mode.

Lua path
app.integrations.travis_ci.debug_job
Full name
travis-ci.travis_ci_debug_job
ParameterTypeRequiredDescription
No parameters.
get_job_log Read

Get a job log as JSON or plain text.

Lua path
app.integrations.travis_ci.get_job_log
Full name
travis-ci.travis_ci_get_job_log
ParameterTypeRequiredDescription
No parameters.
list_requests Read

List repository build requests.

Lua path
app.integrations.travis_ci.list_requests
Full name
travis-ci.travis_ci_list_requests
ParameterTypeRequiredDescription
No parameters.
create_request Write

Trigger a repository build request.

Lua path
app.integrations.travis_ci.create_request
Full name
travis-ci.travis_ci_create_request
ParameterTypeRequiredDescription
No parameters.
list_settings Read

List repository settings.

Lua path
app.integrations.travis_ci.list_settings
Full name
travis-ci.travis_ci_list_settings
ParameterTypeRequiredDescription
No parameters.
update_setting Write

Update one repository setting.

Lua path
app.integrations.travis_ci.update_setting
Full name
travis-ci.travis_ci_update_setting
ParameterTypeRequiredDescription
No parameters.
list_env_vars Read

List repository environment variables.

Lua path
app.integrations.travis_ci.list_env_vars
Full name
travis-ci.travis_ci_list_env_vars
ParameterTypeRequiredDescription
No parameters.
create_env_var Write

Create a repository environment variable.

Lua path
app.integrations.travis_ci.create_env_var
Full name
travis-ci.travis_ci_create_env_var
ParameterTypeRequiredDescription
No parameters.
delete_env_var Write

Delete a repository environment variable.

Lua path
app.integrations.travis_ci.delete_env_var
Full name
travis-ci.travis_ci_delete_env_var
ParameterTypeRequiredDescription
No parameters.
api_get Read

Call a safe relative Travis CI GET path.

Lua path
app.integrations.travis_ci.api_get
Full name
travis-ci.travis_ci_api_get
ParameterTypeRequiredDescription
No parameters.
api_post Write

Call a safe relative Travis CI POST path.

Lua path
app.integrations.travis_ci.api_post
Full name
travis-ci.travis_ci_api_post
ParameterTypeRequiredDescription
No parameters.
api_patch Write

Call a safe relative Travis CI PATCH path.

Lua path
app.integrations.travis_ci.api_patch
Full name
travis-ci.travis_ci_api_patch
ParameterTypeRequiredDescription
No parameters.
api_delete Write

Call a safe relative Travis CI DELETE path.

Lua path
app.integrations.travis_ci.api_delete
Full name
travis-ci.travis_ci_api_delete
ParameterTypeRequiredDescription
No parameters.