minicode-ai 0.11.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. package/CHANGELOG.md +98 -0
  2. package/LICENSE +21 -21
  3. package/README.md +4 -4
  4. package/cli/args.ts +46 -0
  5. package/cli/commands/acp.ts +163 -10
  6. package/cli/commands/config.ts +33 -18
  7. package/cli/commands/daemon.ts +515 -0
  8. package/cli/commands/exec.ts +145 -53
  9. package/cli/commands/openwork.ts +986 -0
  10. package/cli/commands/sessions.ts +4 -1
  11. package/cli/commands/stats.ts +34 -4
  12. package/cli/commands.ts +217 -2
  13. package/cli/index.ts +146 -14
  14. package/cli/recovery-warning.ts +115 -0
  15. package/cli/router.ts +32 -1
  16. package/cli/setup.ts +2332 -171
  17. package/cli/tui.ts +113 -7
  18. package/docs/OUTPUT_ARCHITECTURE_AUDIT.md +489 -0
  19. package/docs/OUTPUT_EVENT_MODEL.md +289 -0
  20. package/docs/OUTPUT_IMPLEMENTATION_PLAN.md +391 -0
  21. package/docs/OUTPUT_PROTOCOL_SPEC.md +285 -0
  22. package/docs/OUTPUT_RENDERING_SPEC.md +248 -0
  23. package/docs/OUTPUT_UX_RULES.md +449 -0
  24. package/docs/PLAN_UIUX_V6.md +2 -2
  25. package/docs/README.md +4 -3
  26. package/docs/TERMINAL_CONTRACT.md +278 -66
  27. package/docs/architecture.md +89 -7
  28. package/docs/changelog.md +1 -1
  29. package/docs/choosing-mode.md +2 -2
  30. package/docs/cli.md +9 -5
  31. package/docs/concepts.md +1 -1
  32. package/docs/contributing.md +9 -2
  33. package/docs/environment.md +6 -2
  34. package/docs/exec.md +46 -5
  35. package/docs/memory-sessions.md +2 -0
  36. package/docs/policy-sandbox.md +1 -1
  37. package/docs/pricing-budget.md +1 -1
  38. package/docs/quickstart.md +2 -2
  39. package/docs/repl.md +6 -2
  40. package/docs/security-model.md +1 -1
  41. package/docs/security.md +1 -1
  42. package/docs/skills.md +2 -2
  43. package/docs/terminal.md +9 -5
  44. package/docs/tools.md +1 -1
  45. package/package.json +35 -5
  46. package/src/app/session.ts +261 -15
  47. package/src/app/tool-layer.ts +94 -7
  48. package/src/daemon/approvals.ts +361 -0
  49. package/src/daemon/capability.ts +145 -0
  50. package/src/daemon/children.ts +142 -0
  51. package/src/daemon/client.ts +267 -0
  52. package/src/daemon/control.ts +350 -0
  53. package/src/daemon/discovery.ts +234 -0
  54. package/src/daemon/feed.ts +155 -0
  55. package/src/daemon/framing.ts +94 -0
  56. package/src/daemon/host.ts +316 -0
  57. package/src/daemon/protocol.ts +217 -0
  58. package/src/daemon/resource.ts +170 -0
  59. package/src/daemon/sanitize.ts +57 -0
  60. package/src/daemon/server.ts +627 -0
  61. package/src/daemon/store.ts +317 -0
  62. package/src/daemon/subscription.ts +270 -0
  63. package/src/daemon/telemetry.ts +81 -0
  64. package/src/hooks/run.ts +12 -1
  65. package/src/lib/atomic-write.ts +29 -3
  66. package/src/lib/db-path.ts +26 -0
  67. package/src/lib/keystore.ts +544 -42
  68. package/src/lib/net.ts +43 -1
  69. package/src/lib/safe-open.ts +116 -1
  70. package/src/lib/session-id.ts +15 -0
  71. package/src/lsp/client.ts +123 -5
  72. package/src/mcp/client.ts +139 -17
  73. package/src/mcp/server.ts +177 -50
  74. package/src/mcp/transport.ts +16 -19
  75. package/src/memory/vector.ts +770 -55
  76. package/src/policy/allowlist.ts +14 -2
  77. package/src/policy/bash-guard.ts +105 -10
  78. package/src/policy/compaction.ts +82 -5
  79. package/src/policy/consequence-engine.ts +220 -0
  80. package/src/policy/context.ts +132 -0
  81. package/src/policy/executor.ts +187 -121
  82. package/src/policy/no-progress.ts +559 -0
  83. package/src/policy/permission.ts +4 -8
  84. package/src/policy/pricing.ts +17 -3
  85. package/src/policy/scrub.ts +69 -2
  86. package/src/policy/tool-contract.ts +515 -0
  87. package/src/policy/usage.ts +310 -24
  88. package/src/policy/verifier.ts +6 -3
  89. package/src/policy/work-mode.ts +182 -0
  90. package/src/presentation/adapter.ts +533 -26
  91. package/src/presentation/events.ts +151 -0
  92. package/src/presentation/model.ts +180 -27
  93. package/src/presentation/projection.ts +858 -0
  94. package/src/presentation/reducer.ts +645 -310
  95. package/src/presentation/store.ts +12 -7
  96. package/src/providers/anthropic.ts +18 -10
  97. package/src/providers/responses.ts +17 -7
  98. package/src/runtime/capability.ts +409 -0
  99. package/src/runtime/child-execution.ts +274 -0
  100. package/src/runtime/composition.ts +958 -0
  101. package/src/runtime/dispatch.ts +591 -0
  102. package/src/runtime/execution-backend.ts +632 -0
  103. package/src/runtime/execution-events.ts +272 -0
  104. package/src/runtime/execution-id.ts +230 -0
  105. package/src/runtime/execution-journal.ts +926 -0
  106. package/src/runtime/execution-kernel.ts +456 -0
  107. package/src/runtime/execution-registry.ts +379 -0
  108. package/src/runtime/process-supervision.ts +276 -0
  109. package/src/runtime/production-execution.ts +551 -0
  110. package/src/runtime/production-runtime.ts +217 -0
  111. package/src/runtime/recovery-safety.ts +70 -0
  112. package/src/runtime/recovery.ts +477 -0
  113. package/src/runtime/runtime-capabilities.ts +179 -0
  114. package/src/runtime/runtime-diagnostics.ts +141 -0
  115. package/src/runtime/runtime-host.ts +365 -0
  116. package/src/runtime/runtime-status-facts.ts +222 -0
  117. package/src/runtime/runtime-status-provider.ts +74 -0
  118. package/src/runtime/runtime-status.ts +459 -0
  119. package/src/runtime/runtime-task-admission.ts +101 -0
  120. package/src/runtime/supervisor.ts +444 -0
  121. package/src/session/authority.ts +168 -0
  122. package/src/session/checkpoint.ts +88 -1
  123. package/src/session/context-adapter.ts +251 -0
  124. package/src/session/context-assembly.ts +242 -0
  125. package/src/session/context-identity.ts +389 -0
  126. package/src/session/context-projection.ts +248 -0
  127. package/src/session/context-selector.ts +500 -0
  128. package/src/session/cross-session-adoption.ts +249 -0
  129. package/src/session/full-history-fold.ts +171 -0
  130. package/src/session/identity.ts +192 -0
  131. package/src/session/journal.ts +805 -102
  132. package/src/session/open-work-intent.ts +732 -0
  133. package/src/session/open-work.ts +767 -0
  134. package/src/session/pending-tools.ts +94 -0
  135. package/src/session/persistence.ts +3569 -127
  136. package/src/session/runtime-header.ts +208 -0
  137. package/src/session/shadow-git.ts +13 -5
  138. package/src/session/verification.ts +1623 -0
  139. package/src/task/assignment.ts +136 -0
  140. package/src/task/autonomous-adapter.ts +168 -0
  141. package/src/task/autonomous-context.ts +630 -0
  142. package/src/task/autonomous-policy.ts +490 -0
  143. package/src/task/continuity.ts +179 -0
  144. package/src/task/execution-cancellation.ts +165 -0
  145. package/src/task/graph-validate.ts +379 -0
  146. package/src/task/graph.ts +305 -0
  147. package/src/task/identity.ts +230 -0
  148. package/src/task/model.ts +417 -0
  149. package/src/task/production-scheduler.ts +293 -0
  150. package/src/task/readiness.ts +229 -0
  151. package/src/task/scheduler-observability.ts +387 -0
  152. package/src/task/scheduler.ts +1197 -0
  153. package/src/task/scheduling-policy.ts +165 -0
  154. package/src/task/session-authority.ts +148 -0
  155. package/src/task/session-ownership.ts +211 -0
  156. package/src/task/store.ts +2887 -0
  157. package/src/task/sync.ts +343 -0
  158. package/src/task/trigger.ts +260 -0
  159. package/src/tools/bash.ts +377 -211
  160. package/src/tools/code_run.ts +1 -1
  161. package/src/tools/delete_file.ts +1 -1
  162. package/src/tools/edit.ts +33 -6
  163. package/src/tools/evidence.ts +30 -0
  164. package/src/tools/git.ts +4 -4
  165. package/src/tools/glob.ts +12 -3
  166. package/src/tools/grep.ts +1 -1
  167. package/src/tools/lsp.ts +4 -4
  168. package/src/tools/mcp_call.ts +11 -4
  169. package/src/tools/memory.ts +153 -18
  170. package/src/tools/move_file.ts +1 -1
  171. package/src/tools/patch.ts +1 -1
  172. package/src/tools/read_file.ts +1 -1
  173. package/src/tools/read_image.ts +1 -1
  174. package/src/tools/submit_result.ts +1 -1
  175. package/src/tools/task.ts +437 -41
  176. package/src/tools/todo.ts +662 -35
  177. package/src/tools/web_fetch.ts +4 -2
  178. package/src/tools/web_search.ts +9 -3
  179. package/src/tools/write_file.ts +1 -1
  180. package/src/ui/assistant/simple.ts +123 -50
  181. package/src/ui/assistant/turn-status.ts +17 -3
  182. package/src/ui/contract.ts +184 -0
  183. package/src/ui/footer.ts +54 -18
  184. package/src/ui/i18n/en.ts +62 -6
  185. package/src/ui/i18n/id.ts +62 -6
  186. package/src/ui/input/prompt-engine.ts +120 -25
  187. package/src/ui/render/errors.ts +39 -1
  188. package/src/ui/render/markdown-table.ts +455 -0
  189. package/src/ui/render/markdown.ts +22 -1
  190. package/src/ui/render/table-grid.ts +184 -0
  191. package/src/ui/render/table.ts +15 -76
  192. package/src/ui/runtime/screen.ts +7 -2
  193. package/src/ui/runtime/statusline.ts +25 -6
  194. package/src/ui/tui/app.ts +598 -133
  195. package/src/ui/tui/transcript.ts +531 -89
  196. package/vendor/minicore/VENDOR.md +1 -1
  197. package/vendor/minicore/src/core/budget.ts +25 -25
  198. package/vendor/minicore/src/core/compact.ts +75 -75
  199. package/vendor/minicore/src/core/errors.ts +59 -59
  200. package/vendor/minicore/src/core/events.ts +73 -73
  201. package/vendor/minicore/src/core/executor.ts +139 -139
  202. package/vendor/minicore/src/core/history.ts +31 -31
  203. package/vendor/minicore/src/core/index.ts +41 -41
  204. package/vendor/minicore/src/core/loop.ts +355 -355
  205. package/vendor/minicore/src/core/permission.ts +22 -22
  206. package/vendor/minicore/src/core/provider.ts +39 -39
  207. package/vendor/minicore/src/core/recovery.ts +35 -35
  208. package/vendor/minicore/src/core/session.ts +327 -327
  209. package/vendor/minicore/src/core/snapshot.ts +146 -146
  210. package/vendor/minicore/src/core/tokens.ts +107 -107
  211. package/vendor/minicore/src/core/tool.ts +115 -115
  212. package/vendor/minicore/src/core/types.ts +50 -50
  213. package/vendor/minicore/src/providers/openai-compat.ts +417 -417
  214. package/AGENTS.md +0 -45
  215. package/PLAN.md +0 -491
  216. package/docs/ARCHITECTURE.html +0 -1248
  217. package/docs/CONTROL-PLANE-MAP.md +0 -139
  218. package/docs/HARNESS.md +0 -150
  219. package/docs/SUMMARY.md +0 -52
  220. package/docs/UI_RENDER_PIPELINE.md +0 -165
  221. package/docs/USAGE.md +0 -11
@@ -1,23 +1,23 @@
1
- // Permission boundary. The kernel commits to consulting this handler before
2
- // every tool execution; it never enforces its own policy.
3
-
4
- import type { ToolCall } from "./types.ts";
5
- import type { ExecutorDeps } from "./executor.ts";
6
-
7
- /**
8
- * Only "deny" blocks execution. A handler that needs interactive approval
9
- * (e.g. a CLI prompt) is expected to block until it resolves the decision
10
- * internally and then return "allow" or "deny".
11
- */
12
- export type Decision = "allow" | "deny";
13
-
14
- export interface PermissionHandler {
15
- check(call: ToolCall, deps: ExecutorDeps): Promise<Decision>;
16
- /**
17
- * Optional diagnostic for the most recent denial of `call`, so the model
18
- * can steer instead of retrying blindly until max steps. Invoked right
19
- * after `check` returns "deny"; returning undefined/"" keeps the plain
20
- * denial message. Optional — handlers without it behave as before.
21
- */
22
- describeDenial?(call: ToolCall): Promise<string | undefined> | string | undefined;
1
+ // Permission boundary. The kernel commits to consulting this handler before
2
+ // every tool execution; it never enforces its own policy.
3
+
4
+ import type { ToolCall } from "./types.ts";
5
+ import type { ExecutorDeps } from "./executor.ts";
6
+
7
+ /**
8
+ * Only "deny" blocks execution. A handler that needs interactive approval
9
+ * (e.g. a CLI prompt) is expected to block until it resolves the decision
10
+ * internally and then return "allow" or "deny".
11
+ */
12
+ export type Decision = "allow" | "deny";
13
+
14
+ export interface PermissionHandler {
15
+ check(call: ToolCall, deps: ExecutorDeps): Promise<Decision>;
16
+ /**
17
+ * Optional diagnostic for the most recent denial of `call`, so the model
18
+ * can steer instead of retrying blindly until max steps. Invoked right
19
+ * after `check` returns "deny"; returning undefined/"" keeps the plain
20
+ * denial message. Optional — handlers without it behave as before.
21
+ */
22
+ describeDenial?(call: ToolCall): Promise<string | undefined> | string | undefined;
23
23
  }
@@ -1,39 +1,39 @@
1
- // The model contract. The kernel only knows these normalized events; every
2
- // provider adapter (OpenAI-compatible, Anthropic, Gemini, local…) implements
3
- // this one interface. Reasoning/thinking is an optional "extension" event and
4
- // is never required.
5
-
6
- import type { Message } from "./types.ts";
7
- import type { ToolSchema } from "./tool.ts";
8
-
9
- /**
10
- * Why a provider stream ended. The kernel consults this to decide recovery:
11
- * `length` may trigger compaction+retry, `error`/`abort` never retry.
12
- */
13
- export type FinishReason = "stop" | "tool_calls" | "length" | "abort" | "error";
14
-
15
- /**
16
- * The normalized provider stream. Adapters translate their wire format into
17
- * exactly these events; the kernel never sees provider-specific shapes. A
18
- * well-formed stream always ends with a `finish` event.
19
- */
20
- export type ProviderEvent =
21
- | { type: "text"; text: string }
22
- | { type: "tool_call"; id: string; name: string; args: unknown }
23
- | { type: "finish"; reason: FinishReason }
24
- | { type: "extension"; kind: string; data: unknown };
25
-
26
- /** The per-request payload the kernel hands to a provider. */
27
- export interface StreamRequest {
28
- readonly messages: readonly Message[];
29
- readonly tools?: readonly ToolSchema[];
30
- readonly system?: string;
31
- readonly model?: string;
32
- }
33
-
34
- /** A model provider: normalized, stateless, and swappable. */
35
- export interface ModelProvider {
36
- readonly id: string;
37
- readonly models: readonly string[];
38
- stream(request: StreamRequest, signal: AbortSignal): AsyncIterable<ProviderEvent>;
39
- }
1
+ // The model contract. The kernel only knows these normalized events; every
2
+ // provider adapter (OpenAI-compatible, Anthropic, Gemini, local…) implements
3
+ // this one interface. Reasoning/thinking is an optional "extension" event and
4
+ // is never required.
5
+
6
+ import type { Message } from "./types.ts";
7
+ import type { ToolSchema } from "./tool.ts";
8
+
9
+ /**
10
+ * Why a provider stream ended. The kernel consults this to decide recovery:
11
+ * `length` may trigger compaction+retry, `error`/`abort` never retry.
12
+ */
13
+ export type FinishReason = "stop" | "tool_calls" | "length" | "abort" | "error";
14
+
15
+ /**
16
+ * The normalized provider stream. Adapters translate their wire format into
17
+ * exactly these events; the kernel never sees provider-specific shapes. A
18
+ * well-formed stream always ends with a `finish` event.
19
+ */
20
+ export type ProviderEvent =
21
+ | { type: "text"; text: string }
22
+ | { type: "tool_call"; id: string; name: string; args: unknown }
23
+ | { type: "finish"; reason: FinishReason }
24
+ | { type: "extension"; kind: string; data: unknown };
25
+
26
+ /** The per-request payload the kernel hands to a provider. */
27
+ export interface StreamRequest {
28
+ readonly messages: readonly Message[];
29
+ readonly tools?: readonly ToolSchema[];
30
+ readonly system?: string;
31
+ readonly model?: string;
32
+ }
33
+
34
+ /** A model provider: normalized, stateless, and swappable. */
35
+ export interface ModelProvider {
36
+ readonly id: string;
37
+ readonly models: readonly string[];
38
+ stream(request: StreamRequest, signal: AbortSignal): AsyncIterable<ProviderEvent>;
39
+ }
@@ -1,36 +1,36 @@
1
- // Provider-agnostic recovery. Adapters normalize provider-specific errors into
2
- // ProviderError categories; this policy decides what the kernel does about them.
3
-
4
- import type { ProviderError, RecoveryAction } from "./errors.ts";
5
-
6
- export interface RecoveryPolicy {
7
- onError(error: ProviderError, attempt: number): RecoveryAction;
8
- onLength(compacted: boolean): RecoveryAction;
9
- }
10
-
11
- export const maxProviderRetries = 3;
12
-
13
- export const defaultRecoveryPolicy: RecoveryPolicy = {
14
- onError(error, attempt) {
15
- switch (error.category) {
16
- case "auth":
17
- case "invalid_request":
18
- return { type: "throw" };
19
- case "context_length_exceeded":
20
- return { type: "force_compact_and_retry" };
21
- default:
22
- if (attempt > maxProviderRetries) return { type: "throw" };
23
- return { type: "retry", delayMs: backoffDelay(attempt, error.retryAfterMs) };
24
- }
25
- },
26
- onLength(compacted) {
27
- return compacted ? { type: "throw" } : { type: "force_compact_and_retry" };
28
- },
29
- };
30
-
31
- const RETRY_AFTER_MAX_MS = 30_000;
32
-
33
- function backoffDelay(attempt: number, retryAfter?: number): number {
34
- if (retryAfter != null) return Math.min(retryAfter, RETRY_AFTER_MAX_MS);
35
- return Math.min(1_000 * 2 ** (attempt - 1), 8_000);
1
+ // Provider-agnostic recovery. Adapters normalize provider-specific errors into
2
+ // ProviderError categories; this policy decides what the kernel does about them.
3
+
4
+ import type { ProviderError, RecoveryAction } from "./errors.ts";
5
+
6
+ export interface RecoveryPolicy {
7
+ onError(error: ProviderError, attempt: number): RecoveryAction;
8
+ onLength(compacted: boolean): RecoveryAction;
9
+ }
10
+
11
+ export const maxProviderRetries = 3;
12
+
13
+ export const defaultRecoveryPolicy: RecoveryPolicy = {
14
+ onError(error, attempt) {
15
+ switch (error.category) {
16
+ case "auth":
17
+ case "invalid_request":
18
+ return { type: "throw" };
19
+ case "context_length_exceeded":
20
+ return { type: "force_compact_and_retry" };
21
+ default:
22
+ if (attempt > maxProviderRetries) return { type: "throw" };
23
+ return { type: "retry", delayMs: backoffDelay(attempt, error.retryAfterMs) };
24
+ }
25
+ },
26
+ onLength(compacted) {
27
+ return compacted ? { type: "throw" } : { type: "force_compact_and_retry" };
28
+ },
29
+ };
30
+
31
+ const RETRY_AFTER_MAX_MS = 30_000;
32
+
33
+ function backoffDelay(attempt: number, retryAfter?: number): number {
34
+ if (retryAfter != null) return Math.min(retryAfter, RETRY_AFTER_MAX_MS);
35
+ return Math.min(1_000 * 2 ** (attempt - 1), 8_000);
36
36
  }