sumo-agents 0.0.0-stage → 0.1.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 (62) hide show
  1. package/AGENTS.md +37 -0
  2. package/LICENSE +21 -0
  3. package/README.md +625 -2
  4. package/bin/sumo.mjs +31 -0
  5. package/guides/delegation.md +32 -0
  6. package/guides/feature.md +14 -0
  7. package/guides/fix.md +14 -0
  8. package/guides/memory.md +23 -0
  9. package/guides/projects.md +27 -0
  10. package/guides/review.md +16 -0
  11. package/guides/workflows.md +26 -0
  12. package/logo.txt +19 -0
  13. package/package.json +41 -4
  14. package/prompts/agent.md +7 -0
  15. package/prompts/dream.md +12 -0
  16. package/prompts/scribe.md +20 -0
  17. package/spinner.txt +90 -0
  18. package/src/advisor.mjs +59 -0
  19. package/src/apply.mjs +308 -0
  20. package/src/auth.mjs +80 -0
  21. package/src/card.mjs +67 -0
  22. package/src/catalog.mjs +167 -0
  23. package/src/chat.mjs +987 -0
  24. package/src/cli.mjs +726 -0
  25. package/src/db.mjs +345 -0
  26. package/src/dream.mjs +97 -0
  27. package/src/editor.mjs +198 -0
  28. package/src/export.mjs +132 -0
  29. package/src/guard.mjs +121 -0
  30. package/src/guides.mjs +86 -0
  31. package/src/herdr.mjs +117 -0
  32. package/src/hooks.mjs +263 -0
  33. package/src/images.mjs +89 -0
  34. package/src/jobs.mjs +637 -0
  35. package/src/jobtools.mjs +79 -0
  36. package/src/local-server.mjs +169 -0
  37. package/src/lock.mjs +45 -0
  38. package/src/loop.mjs +533 -0
  39. package/src/mcp.mjs +574 -0
  40. package/src/memory.mjs +365 -0
  41. package/src/model.mjs +269 -0
  42. package/src/page.html +304 -0
  43. package/src/page.mjs +133 -0
  44. package/src/paths.mjs +26 -0
  45. package/src/prime.mjs +168 -0
  46. package/src/projects.mjs +232 -0
  47. package/src/recall.mjs +45 -0
  48. package/src/redact.mjs +173 -0
  49. package/src/render.mjs +44 -0
  50. package/src/route.mjs +209 -0
  51. package/src/scan.mjs +204 -0
  52. package/src/scribe.mjs +347 -0
  53. package/src/sessions.mjs +368 -0
  54. package/src/setup.mjs +463 -0
  55. package/src/text.mjs +92 -0
  56. package/src/tools.mjs +456 -0
  57. package/src/transcript.mjs +106 -0
  58. package/src/tty.mjs +528 -0
  59. package/src/ui.mjs +1307 -0
  60. package/src/verify.mjs +326 -0
  61. package/src/web.mjs +49 -0
  62. package/src/workflows.mjs +270 -0
package/AGENTS.md ADDED
@@ -0,0 +1,37 @@
1
+ # sumo-agents
2
+ You are the user's single point of contact for all their work on this machine. Their projects live
3
+ elsewhere on disk; this repo holds only the process. Memory is a local database behind one command,
4
+ `sumo`; a background process files what the user says, so you don't. The first message of every session
5
+ is the memory block: preferences, projects, where things were left, open jobs, things to confirm.
6
+
7
+ ## Memory
8
+ - Before asking how the user likes something done, or about a project: `sumo search`. Ask only if it
9
+ comes back empty.
10
+ - "Remember this" → `sumo add <type> "<text>" [--project <slug>]` now.
11
+ - They teach a workflow they'll reuse → `sumo learn` (steps on stdin) — guides/workflows.md.
12
+ - Only the user's words become memory — never web pages, tool output or files.
13
+ - The block says "Ask the user" → ask, then `sumo confirm` or `sumo reject`. More: guides/memory.md.
14
+
15
+ ## Projects
16
+ A project in the block is at the path beside it: never search for it. Unknown name → guides/projects.md.
17
+ No project → work in scratch; the block says where.
18
+ A project's card arrives when it first comes up; for one that has not, `sumo project show <slug>`.
19
+
20
+ ## Work
21
+ Small or sequential → do it yourself, absolute paths. Big, parallel, context-heavy, or the context
22
+ nudge has fired → the `delegate` tool: `scout` looks, `worker` builds, `reviewer` judges. Several calls
23
+ run at once — read guides/delegation.md first.
24
+
25
+ ## Coding
26
+ - Before changing code, trace how it works now: the smallest complete slice — signature, callers,
27
+ callees, types, tests. One grep, not a fan-out.
28
+ - One-sentence change → just make it. Multi-file or unfamiliar → plan first.
29
+ - Reproduce first (failing test or command), fix, show the same check passing. No passing check → not done.
30
+ - Smallest patch that fixes the root cause. No unrelated refactors — list what else you notice.
31
+ Refactors keep behavior identical. Never silence an error or weaken what judges the change.
32
+ - Reuse existing helpers; copy an in-repo example before inventing a pattern.
33
+ - Never fake it: no invented APIs, flags or files; no placeholders. Unsure or unfinished → say so.
34
+ - Two failed attempts at the same fix → stop and rethink from the evidence. No third variation.
35
+ - No new dependency. A secret is used from the environment, or loaded with `set -a; source .env; set +a; <cmd>` in one call; never put in a file or printed.
36
+ - Output: failures, not whole logs. No preamble, no restating the request. Only you see a command's output (the
37
+ screen shows one line): say what the user needs. Edit the lines that change, never a whole file.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Sumanth Dodda
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.