internal/

directory
v0.17.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 11, 2026 License: AGPL-3.0

Directories

Path Synopsis
Package agent coordinates the server's per-chat runtime: SSE fan-out, the one agent engine and the ACP sessions on it, POST /api/command dispatch, the workspace services (engine calls and observer passes), agent terminals, the browser shell shim, and the MCP runtime registry.
Package agent coordinates the server's per-chat runtime: SSE fan-out, the one agent engine and the ACP sessions on it, POST /api/command dispatch, the workspace services (engine calls and observer passes), agent terminals, the browser shell shim, and the MCP runtime registry.
Package ansitext separates ANSI escape sequences from the text they style.
Package ansitext separates ANSI escape sequences from the text they style.
Package apicaller tells a request from marotte's own page apart from one another program sent.
Package apicaller tells a request from marotte's own page apart from one another program sent.
Package asidefile keeps a state file a store could not read: Move renames it out of the way of the store's next write, and Find tells a later boot that an earlier one left such a copy.
Package asidefile keeps a state file a store could not read: Move renames it out of the way of the store's next write, and Find tells a later boot that an earlier one left such a copy.
Package auth serves /api/whoami, /api/login and /api/logout over marotte's own sign-in vault (internal/signin): the account the agent engine is answered from.
Package auth serves /api/whoami, /api/login and /api/logout over marotte's own sign-in vault (internal/signin): the account the agent engine is answered from.
Package bridge runs the one kiro-cli ACP engine process and the ACP sessions on it.
Package bridge runs the one kiro-cli ACP engine process and the ACP sessions on it.
Package buffer tracks which lines of a file the agent changed and the line delta of one diff.
Package buffer tracks which lines of a file the agent changed and the line delta of one diff.
Package chat implements per-chat persistence: one directory per chat under <dir>/<chat_id>/ holding chat.json, the header, and entries.jsonl, the turn log.
Package chat implements per-chat persistence: one directory per chat under <dir>/<chat_id>/ holding chat.json, the header, and entries.jsonl, the turn log.
archive
Package archive implements chat RETENTION: the age-based purge and its scheduler.
Package archive implements chat RETENTION: the age-based purge and its scheduler.
Package command implements the POST /api/command dispatch table.
Package command implements the POST /api/command dispatch table.
Package composition wires all marotte services together and manages application lifecycle.
Package composition wires all marotte services together and manages application lifecycle.
Package durable supplies the context a durable effect runs under.
Package durable supplies the context a durable effect runs under.
Package filebrowse serves the browser's file surface: browsing, reading, editing, uploading and downloading.
Package filebrowse serves the browser's file surface: browsing, reading, editing, uploading and downloading.
Package filemode makes a file's mode a fact rather than a request.
Package filemode makes a file's mode a fact rather than a request.
Package forges integrates remote git forges (GitHub, GitLab, Gitea/Codeberg).
Package forges integrates remote git forges (GitHub, GitLab, Gitea/Codeberg).
Package httpreply writes what marotte answers an HTTP request with: the named status responses, the error envelope they carry, and the request guards whose failure IS one of those responses.
Package httpreply writes what marotte answers an HTTP request with: the named status responses, the error envelope they carry, and the request guards whose failure IS one of those responses.
Package ids is marotte's identifier vocabulary: it mints the ids the app owns and validates every id the app accepts, one rule read in two directions (NewMessageID and ValidMessageID), so a minted id cannot become one its own boundary rejects.
Package ids is marotte's identifier vocabulary: it mints the ids the app owns and validates every id the app accepts, one rule read in two directions (NewMessageID and ValidMessageID), so a minted id cannot become one its own boundary rejects.
Package kascap declares which capability keys marotte puts on the kiro-cli (KAS) ACP wire, on which call, why, and how KAS resolves each one.
Package kascap declares which capability keys marotte puts on the kiro-cli (KAS) ACP wire, on which call, why, and how KAS resolves each one.
Package kasnode runs kiro-cli's agent server on its own bundled Node.js with the high throughput flags.
Package kasnode runs kiro-cli's agent server on its own bundled Node.js with the high throughput flags.
Package kirosession reaps the kiro-cli / KAS on-disk session state that backs session/load resume: it exists only to reload a chat marotte still keeps, so it dies with that chat.
Package kirosession reaps the kiro-cli / KAS on-disk session state that backs session/load resume: it exists only to reload a chat marotte still keeps, so it dies with that chat.
Package liveness is the one statement of when a quiet SSE client reads gone.
Package liveness is the one statement of when a quiet SSE client reads gone.
Package logctl owns the process-wide slog handler so the debug_logs setting (<configDir>/config.json) flips the level at runtime: Install once at startup picks the boot level, and SetDebug moves a shared slog.LevelVar the handler reads at log time (Info by default, Debug when set).
Package logctl owns the process-wide slog handler so the debug_logs setting (<configDir>/config.json) flips the level at runtime: Install once at startup picks the boot level, and SetDebug moves a shared slog.LevelVar the handler reads at log time (Info by default, Debug when set).
Package logsafe binds runesafe's single-line preset to this app's log surface, so every untrusted string reaches slog through one policy.
Package logsafe binds runesafe's single-line preset to this app's log surface, so every untrusted string reaches slog through one policy.
Package marotte is the app's wire and domain TYPE vocabulary: the shapes that cross the HTTP and SSE boundaries and the shapes its components pass each other.
Package marotte is the app's wire and domain TYPE vocabulary: the shapes that cross the HTTP and SSE boundaries and the shapes its components pass each other.
mcp
Package mcp persists and serves the user's configured MCP servers: one ordered array of Server records in <configDir>/mcp.json, mode 0600, written atomically.
Package mcp persists and serves the user's configured MCP servers: one ordered array of Server records in <configDir>/mcp.json, mode 0600, written atomically.
prewarm
Package prewarm fills the npm CACHE for every enabled stdio MCP server run via `npx`, at container start and when such a server is added or toggled, so the first chat does not pay the 5-15s install.
Package prewarm fills the npm CACHE for every enabled stdio MCP server run via `npx`, at container start and when such a server is added or toggled, so the first chat does not pay the 5-15s install.
Package memlimit reads the container's cgroup memory facts: its memory limit and the kernel's OOM-kill count.
Package memlimit reads the container's cgroup memory facts: its memory limit and the kernel's OOM-kill count.
Package modeltext reads catalog text a model provider authored: whether a description marks the model hidden from the user.
Package modeltext reads catalog text a model provider authored: whether a description marks the model hidden from the user.
Package nodeopts rewrites a NODE_OPTIONS value so it sets the JavaScript heap limit, lexing it the way Node does.
Package nodeopts rewrites a NODE_OPTIONS value so it sets the JavaScript heap limit, lexing it the way Node does.
Package notice owns every notification's words, kind and subject, for the Web Push and the in-page notification alike.
Package notice owns every notification's words, kind and subject, for the Web Push and the in-page notification alike.
Package parallel holds the one bounded fan-out helper two packages need.
Package parallel holds the one bounded fan-out helper two packages need.
Package policyfile reads and writes kiro-cli's native Cedar permission files for the user and workspace scopes, under kiro-cli's state directory: <kiroHome>/settings/permissions.yaml and <kiroHome>/workspace-roots/<workspaceHash>/permissions.yaml.
Package policyfile reads and writes kiro-cli's native Cedar permission files for the user and workspace scopes, under kiro-cli's state directory: <kiroHome>/settings/permissions.yaml and <kiroHome>/workspace-roots/<workspaceHash>/permissions.yaml.
Package powers is marotte's half of Kiro Powers: the official catalogue, the `kiro-cli powers` install verbs, and the legacy `powers.mcpServers` block KAS reads for an installed Power's MCP servers.
Package powers is marotte's half of Kiro Powers: the official catalogue, the `kiro-cli powers` install verbs, and the legacy `powers.mcpServers` block KAS reads for an installed Power's MCP servers.
Package preview serves an agent-written HTML page and the folder it sits in to a sandboxed iframe on marotte's own origin.
Package preview serves an agent-written HTML page and the folder it sits in to a sandboxed iframe on marotte's own origin.
Package procgroup signals a spawned command's whole process group instead of just its head.
Package procgroup signals a spawned command's whole process group instead of just its head.
Package procout captures a spawned process's stdout or stderr under a byte cap, so a runaway child cannot exhaust memory through a pipe marotte drains.
Package procout captures a spawned process's stdout or stderr under a byte cap, so a runaway child cannot exhaust memory through a pipe marotte drains.
Package push manages Web Push subscriptions and delivers VAPID-signed notifications.
Package push manages Web Push subscriptions and delivers VAPID-signed notifications.
Package rpcerr turns a JSON-RPC error from kiro-cli into text a person can read.
Package rpcerr turns a JSON-RPC error from kiro-cli into text a person can read.
Package runlease holds what marotte knows about a workflow run KAS owns: the ENVELOPE (may it start, how long may it execute, is it unattended, what its ending is called).
Package runlease holds what marotte knows about a workflow run KAS owns: the ENVELOPE (may it start, how long may it execute, is it unattended, what its ending is called).
Package sanitize defuses text marotte did not write before it is persisted, echoed to a client, or written to a log: ANSI escape sequences and the invisible Unicode codepoints (TAG characters, zero-width joiners, bidi overrides) that carry prompt injections.
Package sanitize defuses text marotte did not write before it is persisted, echoed to a client, or written to a log: ANSI escape sequences and the invisible Unicode codepoints (TAG characters, zero-width joiners, bidi overrides) that carry prompt injections.
Package schedule computes when a recurring workflow run is next due.
Package schedule computes when a recurring workflow run is next due.
Package secretstore persists the opaque credential blobs KAS asks marotte to hold via the v3 `_kiro/secret/*` requests.
Package secretstore persists the opaque credential blobs KAS asks marotte to hold via the v3 `_kiro/secret/*` requests.
Package securityprofile selects the security profile every session opens with and runs Customize, the one profile change that writes a policy file.
Package securityprofile selects the security profile every session opens with and runs Customize, the one profile change that writes a policy file.
Package server — the Idempotency-Key dedup middleware.
Package server — the Idempotency-Key dedup middleware.
Package settings is the one reader for <configDir>/config.json: Field (typed key), FieldInto (pointer target), FieldStrict (unreadable kept apart from absent, for a caller gating a destructive action) and Read (one parsed generation for several keys), all through one freshness-checked cache capped at maxBytes.
Package settings is the one reader for <configDir>/config.json: Field (typed key), FieldInto (pointer target), FieldStrict (unreadable kept apart from absent, for a caller gating a destructive action) and Read (one parsed generation for several keys), all through one freshness-checked cache capped at maxBytes.
Package signin owns marotte's sign-in to the agent backends: one identity record per backend, kept in <configDir>/signin.json, renewed when the backend asks for it, and answered to the running engine on the backend's host callback.
Package signin owns marotte's sign-in to the agent backends: one identity record per backend, kept in <configDir>/signin.json, renewed when the backend asks for it, and answered to the running engine on the backend's host callback.
kiro
Package kiro is the sign-in backend for the Kiro agent server (KAS): an AWS SSO-OIDC device flow for Builder ID and IAM Identity Center, the Kiro profile lookup, and KAS's host-callback policy.
Package kiro is the sign-in backend for the Kiro agent server (KAS): an AWS SSO-OIDC device flow for Builder ID and IAM Identity Center, the Kiro profile lookup, and KAS's host-callback policy.
Package spec reads a Kiro spec directory the way Kiro does: the roots, the classifier naming a path's spec directory, a tasks.md parser transcribed from the KAS 2.21.4 bundle, the bounded loader, and the spec_changed coalescer.
Package spec reads a Kiro spec directory the way Kiro does: the roots, the classifier naming a path's spec directory, a tasks.md parser transcribed from the KAS 2.21.4 bundle, the bounded loader, and the spec_changed coalescer.
Package specapproval records which phase of which spec a human signed off, against exactly which document version.
Package specapproval records which phase of which spec a human signed off, against exactly which document version.
Package steering generates the steering kiro-cli reads, in two outputs.
Package steering generates the steering kiro-cli reads, in two outputs.
Package subject is the version registry behind the SSE digest: one opaque version string per (kind, ref) subject, minted by the store that owns the subject and read by the resolver and the REST envelopes.
Package subject is the version registry behind the SSE digest: one opaque version string per (kind, ref) subject, minted by the store that owns the subject and read by the resolver and the REST envelopes.
Package systembin resolves an image-baked system binary to an absolute path from a fixed directory set, so a server spawn's argv[0] does not come from PATH, which can hold the tools engine's bin/ on the persistent volume, a directory an agent shell can write.
Package systembin resolves an image-baked system binary to an absolute path from a fixed directory set, so a server spawn's argv[0] does not come from PATH, which can hold the tools engine's bin/ on the persistent volume, a directory an agent shell can write.
Package tabs is the open-tab set: what is open, in what order, at what version.
Package tabs is the open-tab set: what is open, in what order, at what version.
Package testsupport provides the chat-store fakes that more than one sibling package's TEST binary needs, plus the contract suites those packages run against both a fake and the real implementation.
Package testsupport provides the chat-store fakes that more than one sibling package's TEST binary needs, plus the contract suites those packages run against both a fake and the real implementation.
Package textsearch is the substring match kernel every marotte search surface scans with: one fold rule, one occurrence scan reporting positions into the original text, and its Tally.
Package textsearch is the substring match kernel every marotte search surface scans with: one fold rule, one occurrence scan reporting positions into the original text, and its Tally.
Package translate decodes ACP notifications from kiro-cli bridges and dispatches them as domain events (SSE broadcasts, chat-store mutations); Runtime stays the coordinator.
Package translate decodes ACP notifications from kiro-cli bridges and dispatches them as domain events (SSE broadcasts, chat-store mutations); Runtime stays the coordinator.
Package turnlog is the in-memory accumulator for one open turn: per lane, the text or thinking entry still coalescing deltas and the steer carry withheld beside it, frozen into a marotte.Entry when an append ends it.
Package turnlog is the in-memory accumulator for one open turn: per lane, the text or thinking entry still coalescing deltas and the steer carry withheld beside it, frozen into a marotte.Entry when an append ends it.
Package version holds the build version string, stamped by the release image build.
Package version holds the build version string, stamped by the release image build.
Package wirespec is the single source of truth for marotte's wire contract: the registered wire types, the enums, the TS-name and path-name overrides, and the SSE events cmd/wire-codegen feeds into wiregen to emit static-src/wire/*.gen.ts.
Package wirespec is the single source of truth for marotte's wire contract: the registered wire types, the enums, the TS-name and path-name overrides, and the SSE events cmd/wire-codegen feeds into wiregen to emit static-src/wire/*.gen.ts.
Package workflow decodes KAS's workflow-run wire shapes.
Package workflow decodes KAS's workflow-run wire shapes.
Package workspace provides path helpers for kiro-cli's per-user state directory.
Package workspace provides path helpers for kiro-cli's per-user state directory.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL