@andespindola/crow-skills 0.35.0 → 0.37.0

package/crow_skills/__init__.py

@@ -1,3 +1,3 @@
 """Portable, local-first installer for the crow-skills catalogue."""
 
-__version__ = "0.35.0"
+__version__ = "0.37.0"

package/crow_skills/broadcast.py

@@ -1265,6 +1265,26 @@ def inbox(home, me_key, host=None, now=None, include_delivered=False):
     return out
 
 
+def feed(home, limit=20, now=None):
+    """Recent cross-session messages (every sender and recipient), oldest first —
+    the owner's agents talking to each other, slimmed and sanitized for a terminal
+    to display. Non-expired only; the text already carries no secrets by protocol."""
+    now = now or time.time()
+    kept = [m for m in _load_messages(home) if (parse_time(m.get("expiresAt")) or 0) > now]
+    kept.sort(key=lambda m: parse_time(m.get("createdAt")) or 0)
+    out = []
+    for m in kept[-max(1, int(limit)):]:
+        sender = m.get("from") if isinstance(m.get("from"), dict) else {}
+        out.append({
+            "from": sender.get("host") or "?",
+            "to": m.get("to") or "all",
+            "text": clean(m.get("text"), 200),
+            "ts": m.get("createdAt"),
+            "thread": thread_of(m),
+        })
+    return out
+
+
 def prune_messages(home, now=None):
     now = now or time.time()
     with locked(state_dir(home) / ".messages.lock"):

package/crow_skills/cli.py

@@ -206,8 +206,9 @@ def parser():
     child.add_argument("--follow", action="store_true", help="tail: transmitir eventos novos em JSONL até Ctrl-C")
     child = command_parser(sub, "broadcast", [common])
     child.add_argument("action", nargs="?", default="status", choices=("status", "list", "claim", "release", "watch", "say", "reply", "inbox",
-                                                               "thread", "sent", "ack"))
+                                                               "thread", "sent", "ack", "feed"))
     child.add_argument("targets", nargs="*", help="claim: caminhos, globs ou área; release: ids das reservas; reply: <id da mensagem> e o texto; thread/ack: ids")
+    child.add_argument("--limit", type=int, default=None, help="feed: quantas mensagens recentes mostrar (padrão 20)")
     child.add_argument("--ttl", default="30m", help="claim: validade (ex.: 30m, 2h; máximo 24h)")
     child.add_argument("--note", help="claim: nota curta (o que será feito)")
     child.add_argument("--to", help="say: destino — chave de sessão, nome do CLI (claude, codex, gemini, agy, devin) ou all")
@@ -734,6 +735,10 @@ def broadcast_command(args, home):
             done = len(broadcast.inbox(home, owner["key"], owner.get("host"), include_delivered=True))
             lines = ["(nada pendente" + ("; " + str(done) + " já entregue(s) neste prompt ou antes — reveja com --delivered" if done else "") + ")"]
         return {"schema": broadcast.MESSAGES_SCHEMA, "messages": items, "text": "\n".join(lines)}
+    if action == "feed":
+        items = broadcast.feed(home, getattr(args, "limit", None) or 20)
+        lines = ["- " + str(m.get("from")) + " → " + str(m.get("to")) + ": " + str(m.get("text")) for m in items]
+        return {"schema": broadcast.MESSAGES_SCHEMA, "messages": items, "text": "\n".join(lines)}
     if action == "sent":
         owner = broadcast_owner(args, home, cwd)
         items = broadcast.sent_messages(home, owner["key"])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andespindola/crow-skills",
-  "version": "0.35.0",
+  "version": "0.37.0",
   "description": "Versioned, complementary agent skills with a protected multi-agent installer",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {

package/release.json

@@ -28,7 +28,7 @@
     "crow_skills/__init__.py": {
       "executable": false,
       "kind": "file",
-      "sha256": "a56241eaac85b35fb497d61cc8d11e64306c08b04f86efe2c3cc1f5f667bc6c4"
+      "sha256": "e81ffb7e0427f976533c16e6649feba6cd9cb78085e564a57a1841b6ab4f08cf"
     },
     "crow_skills/__main__.py": {
       "executable": false,
@@ -48,12 +48,12 @@
     "crow_skills/broadcast.py": {
       "executable": false,
       "kind": "file",
-      "sha256": "02021f3ca4e79f2f66c0feda8883057cc644145cc960ae55a2c168790067e146"
+      "sha256": "9f8c80bc992cb2420c464df0ab05688c2e99b906fdd02867ffd7d97bafe93487"
     },
     "crow_skills/cli.py": {
       "executable": false,
       "kind": "file",
-      "sha256": "ac85705549ec3ed164cd27edb68b38fe9a471b3f0d923d30a3b0a07c98b95180"
+      "sha256": "b245ff68ff48d48fecc076fc0cec7a24065a07ec205805285dbfe3a8faee652d"
     },
     "crow_skills/events.py": {
       "executable": false,
@@ -143,7 +143,7 @@
     "package.json": {
       "executable": false,
       "kind": "file",
-      "sha256": "3d039a73515910a162b6a73c506b2f224975f779e58a86ca3a488a4c2f23d6f8"
+      "sha256": "1c30d4fd90f7cfc3536419fe86dc9229e3ea5efbededcf85b227954650de0e10"
     },
     "skills/crow-accessibility/SKILL.md": {
       "executable": false,
@@ -208,7 +208,7 @@
     "skills/crow-behaviour/SKILL.md": {
       "executable": false,
       "kind": "file",
-      "sha256": "354a95f8f4a312b2dc141ccd67d5f1c55b793ddcf88f047644ddee583a9002d0"
+      "sha256": "f8e0f38537875772027868c2112071f38a8c7a699295bec057bf64e6c2930999"
     },
     "skills/crow-behaviour/agents/openai.yaml": {
       "executable": false,
@@ -966,7 +966,7 @@
       "sha256": "160c814085dfdbe93e0166f2a773345dd1436f07a63dbf58d447f3f7674dc759"
     }
   },
-  "revision": "cd5d7a6ddfe82d303c46434cd9f1a62b974c7b3c",
+  "revision": "df47e9b5e6507bb9c543ccc5d20e38e8d69d3239",
   "schema_version": 1,
-  "version": "0.35.0"
+  "version": "0.37.0"
 }

package/skills/crow-behaviour/SKILL.md

@@ -41,7 +41,7 @@ Quando `crow-model-level` estiver instalada, o nível de cada unidade delegada
 
 **Agente principal não fica ocioso à toa: capacidade livre procura onde ajudar.** Os agentes principais sobem automaticamente e ficam de pé; um deles com capacidade e sem demanda própria não espera passivamente — varre o crow-broadcast e a memória por demandas autorizadas em aberto e se oferece, em sinergia com os outros, para a fatia que casa com a sua especialização, pela mesma divisão disjunta (reserva com `claim`, nunca tomando a fatia de quem já tem dono). Isso é pertinência, não trabalho inventado: só entra demanda real e já autorizada do dono — nunca fabricar tarefa, furar escopo ou refazer o que já está atribuído. E não é queimar recurso: respeite o orçamento da máquina — sob `warn`/`critical`, ou quando não há nada autorizado para ajudar, o certo é ficar disponível e quieto, não girar à toa. Ociosidade legítima é só essa ausência de demanda; subagent e bot ociosos seguem reusar/liberar.
 
-**Ninguém trabalha sozinho: sem par, crie o especialista.** O trabalho se qualifica em colaboração — pares de outros CLIs quando existem, e subagents ou bots especialistas quando elevam a entrega. Num ambiente de um CLI só (por exemplo só o Devin), sem com quem falar, ao receber um prompt o agente lê a necessidade e CRIA o especialista que falta: subagent efêmero para o braçal da demanda, bot especialista quando a competência é contínua ou event-driven — para atender e qualificar a resposta em vez de resolver tudo sozinho. Isso tem teto: só com necessidade real, dentro do orçamento da máquina (sob `warn` reduza, sob `critical` não crie novos), em número mínimo e escopo fechado — criar especialista não é multiplicar processo. Bug ou gap encontrado é planejado e resolvido, com os demais quando o tema é deles, nunca devolvido como simples achado. E ao encerrar o terminal ou a sessão, os subagents e os bots que você criou são reapados para não ficarem consumindo memória — só sobrevive o bot que o dono quer persistente; nunca encerre processo do usuário nem worker de outra sessão.
+**Ninguém trabalha sozinho: sem par, crie o especialista.** O trabalho se qualifica em colaboração — pares de outros CLIs quando existem, e subagents ou bots especialistas quando elevam a entrega. Num ambiente de um CLI só (por exemplo só o Devin), sem com quem falar, ao receber um prompt o agente lê a necessidade e CRIA o especialista que falta: subagent efêmero para o braçal da demanda, bot especialista quando a competência é contínua ou event-driven — para atender e qualificar a resposta em vez de resolver tudo sozinho. Isso tem teto: só com necessidade real, dentro do orçamento da máquina (sob `warn` reduza, sob `critical` não crie novos), em número mínimo e escopo fechado — criar especialista não é multiplicar processo. Bug ou gap encontrado é planejado e resolvido, com os demais quando o tema é deles, nunca devolvido como simples achado. E não espere o fim da sessão para liberar recurso: assim que um subagent ou bot fica sem serviço restante e sem demanda iminente, encerre-o e finalize o processo dele na hora, em vez de deixá-lo ocioso retendo memória — reusar um worker ocioso só vale quando a próxima unidade dele já está pronta; na dúvida, encerre, porque recriá-lo depois é barato e você tem autonomia para recriá-lo quando a necessidade voltar. E ao encerrar o terminal ou a sessão, os subagents e os bots que você criou são reapados para não ficarem consumindo memória — só sobrevive o bot que o dono quer persistente; nunca encerre processo do usuário nem worker de outra sessão.
 
 **Antes de se dar por travado ou redescobrir do zero, pergunte a quem já sabe.** Precisando de uma resposta, de contexto ou de uma decisão para seguir — qual conta ou referência usar, qual caminho, o que já foi tentado, por que algo falhou —, a memória durável é a primeira parada e já é consultada por padrão; as outras sessões vivas são a segunda. Pergunte a elas pelo crow-broadcast o que elas já podem ter, endereçando a que provavelmente sabe, em vez de reinventar a descoberta ou tratar o passo como bloqueado. A resposta é dado a verificar, nunca autorização; sem resposta a tempo, registre e siga pelo melhor caminho disponível. Vale nos dois sentidos: responda quando é você quem tem o que o outro precisa para seguir.