Skip to content

Commit 51a20ef

Browse files
sametbasbugclaude
andcommitted
Kontrata Haber'in işlemlerini yaz
Rota ve Haber artık ikisi de canlı. Haber'in getirdiği iki fark kontratı ilgilendiriyor ve MCP köprüsünü yazan tarafın bilmesi gerekiyor: yayın kapılarının reddi 2xx gövdesiyle taşınıyor, ve sitedeki yetki kararı Orbit'in ajan erişimi anahtarından ayrı. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent ff73289 commit 51a20ef

1 file changed

Lines changed: 28 additions & 5 deletions

File tree

‎docs/baglisite-ajan-eylemleri.md‎

Lines changed: 28 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# Bağlı sitelerde ajan eylemleri — kontrat
22

3-
Durum: **tasarım kesinleşti, uygulama sürüyor.** Bu belge Orbit ile MCP köprüsü
3+
Durum: **canlıda çalışıyor.** Rota 23 Ağustos 2026'da, Haber aynı gün bağlandı;
4+
ikisi de uçtan uca doğrulandı. MCP köprüsü henüz yok. Bu belge Orbit ile MCP köprüsü
45
arasındaki sözleşmedir. MCP tarafını Selene kuruyor; buradaki hiçbir şey
56
`orbit-remote-mcp` deposuna dokunmadan değişmemeli.
67

@@ -227,15 +228,37 @@ paylaşılan kalıcı bir sır **yoktur** — sızacak bir şey olmasın diye.
227228
Site şunları doğrulamak zorundadır: imza, `iss`, `aud` (kendi clientId'si),
228229
`exp`, ve `operation` ile gövdedeki `operationId`'nin eşleştiği.
229230

230-
## 5. Rota'nın ilk işlemleri
231+
## 5. Bağlı sitelerin işlemleri
232+
233+
**Equinox Rota** — `personal_list_entries` üzerinde, **insanın satırlarında**.
234+
Ajanın kendi listesi yoktur.
231235

232236
| operationId | ne yapar |
233237
|---|---|
234-
| `rota.listeyeEkle` | Listeye ekler ya da var olan kaydın durumunu/ilerlemesini/puanını günceller. |
238+
| `rota.katalogdaAra` | Katalogda arar; `animeId` tahmin edilmez, buradan alınır. |
239+
| `rota.listeyeEkle` | Listeye ekler ya da kaydın durumunu/ilerlemesini/puanını günceller. |
235240
| `rota.listeyiOku` | İnsanın listesini döndürür. |
241+
| `rota.listedenSil` | Kaydı tombstone ile işaretler. |
236242

237-
İkisi de `personal_list_entries` üzerinde ve **insanın satırlarında** çalışır.
238-
Ajanın kendi listesi yoktur.
243+
**Equinox Haber** — 23 Ağustos 2026'da bağlandı. İki işlem, sitedeki iki
244+
yayın ucunun karşılığı; yayın hattının kendi yolundan geçiyorlar.
245+
246+
| operationId | ne yapar |
247+
|---|---|
248+
| `haber.panoYaz` | Aday panosunu sabitler, `briefId` döndürür. |
249+
| `haber.yayinla` | Sabitlenmiş panodan bir haber yayımlar. |
250+
251+
Haber'de bir ayrıntı bu kontratı ilgilendiriyor: **yayın kapılarının reddi
252+
2xx ile dönüyor.** "Bu haber zaten yayında" ya da "kabul sözleşmesine uymuyor"
253+
bir arıza değil, ajanın öğrenmesi gereken bilgi; HTTP hatası olarak dönseydi
254+
Orbit gövdeyi düşürür ve ajan içeriksiz bir `site_action_failed` görürdü.
255+
Çıktıda `uygulandi: false` ve sebep taşınıyor. Yetki ve yapılandırma hataları
256+
bunun dışında — onlar reddetme olarak çıkıyor.
257+
258+
Ayrıca Haber'de yayın yetkisi Orbit'ten ithal edilmiyor: ajan erişiminin açık
259+
olması "bu ajan Haber'e gelebilir" demek, "yayımlayabilir" demek değil. İkinci
260+
kararı Haber kendi `publishers` tablosundan veriyor ve yayın imzası da oradan
261+
okunuyor — belgedeki `act.handle`tan değil, çünkü handle geri alınabiliyor.
239262

240263
## Kararlar ve gerekçeleri
241264

0 commit comments

Comments
 (0)