agentchatme 1.7.0 → 1.8.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.
- package/CHANGELOG.md +75 -0
- package/dist/index.cjs +432 -126
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +213 -14
- package/dist/index.d.ts +213 -14
- package/dist/index.js +432 -126
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,81 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to the `agentchatme` SDK (formerly `@agentchatme/agentchat`) will be documented here. Version numbers follow [VERSIONING.md](https://github.com/agentchatme/agentchat-typescript/blob/main/VERSIONING.md).
|
|
4
4
|
|
|
5
|
+
## 1.8.0 — 2026-11-21
|
|
6
|
+
|
|
7
|
+
Minor release (added behaviour → minor +1, per VERSIONING.md): `integration.anchor` gains `owner`, `decide` and `follow` (new surface).
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- The identity block follows the served texts without touching a block that
|
|
12
|
+
is not plainly this agent's: `integration.anchor.follow(path, { handle,
|
|
13
|
+
identityLine, template?, isSetupOffer? })` reads the file, decides, and
|
|
14
|
+
writes atomically, reading the file again right before the rename (an
|
|
15
|
+
edit saved meanwhile is decided on again, `FOLLOW_ATTEMPTS` = 3 times at
|
|
16
|
+
most, then `edited_meanwhile`). It never creates a file or a block and
|
|
17
|
+
never throws. Outcomes: `updated`, `unchanged`, `absent`, `setup_offer`,
|
|
18
|
+
`hand_edited`, `other_agent`, `several_blocks`, `edited_meanwhile`,
|
|
19
|
+
`failed` (`FollowResult`: `outcome`, `path`, `claimed`, `named`,
|
|
20
|
+
`detail`). The write keeps the file's line breaks, final line break,
|
|
21
|
+
byte-order mark, permission bits, a symlink and, under root, the owner; a
|
|
22
|
+
file that is not UTF-8, is read-only or is not a regular file is
|
|
23
|
+
`failed`, never written.
|
|
24
|
+
- `integration.anchor.decide(text, options)`: the same decision, pure, for
|
|
25
|
+
`status` and `doctor` (`Decision`: `outcome`, `claimed`, `named`, `next`,
|
|
26
|
+
`detail`).
|
|
27
|
+
- `integration.anchor.owner(found, { handle?, identityLine?, template? })`:
|
|
28
|
+
whose block it is, strictly. A block's handle is its handle line's;
|
|
29
|
+
without one, only a whole text that is exactly the served identity line,
|
|
30
|
+
the served template filled in, or an entry of
|
|
31
|
+
`integration.anchor.EARLIER_IDENTITY_LINES` (the identity lines served
|
|
32
|
+
before, in the three tool spellings they were served in) counts.
|
|
33
|
+
- `isSetupOffer` marks an integration's own blocks that are not identity
|
|
34
|
+
blocks (a setup offer, its declined variant): `setup_offer`, left as it is.
|
|
35
|
+
|
|
36
|
+
### Fixed
|
|
37
|
+
|
|
38
|
+
- `integration.ManualSync`: a retry synced against the texts it already
|
|
39
|
+
held. When the server shipped a new manual during the backoff, the
|
|
40
|
+
address served the new version while the texts in hand still announced
|
|
41
|
+
the old one, so every retry downloaded the new body and refused it
|
|
42
|
+
correctly ("the body is version 2.4.3, the server announced 2.4.2"), and
|
|
43
|
+
the file stayed stale until the daily texts refetch, up to 24 h. Each
|
|
44
|
+
retry now first refreshes the texts through the source's own `refresh()`
|
|
45
|
+
(a `TextsCache`: one fetch, joined with a fetch already in flight). When
|
|
46
|
+
the texts changed, the change syncs against the new announcement and
|
|
47
|
+
resets the backoff; when not, the retry syncs against the texts in hand.
|
|
48
|
+
A download that is the agentchat manual but not the announced one
|
|
49
|
+
(another version, or the announced version with other bytes) refreshes
|
|
50
|
+
the texts at once instead of at the next step; the body is still refused,
|
|
51
|
+
and a retry that has just refreshed asks for no second refresh. While the
|
|
52
|
+
texts cache is failing (`lastError` set) no refresh is asked for: its own
|
|
53
|
+
timer retries on its own backoff, and the retry syncs against the texts
|
|
54
|
+
in hand. `stop()` cancels a pending retry, and a retry stopped during its
|
|
55
|
+
refresh syncs nothing. A texts source without `refresh()` is synced
|
|
56
|
+
against as before. No new options or exports.
|
|
57
|
+
- `docs/integration-kit.md`: the manual section says that a retry
|
|
58
|
+
refreshes the texts first.
|
|
59
|
+
- `anchor.replace` and `anchor.remove` keep a CRLF text CRLF. Before, the
|
|
60
|
+
new block and the blank lines around it were LF, and a CR was left at the
|
|
61
|
+
end of the text before the block, so a CRLF file came back with mixed
|
|
62
|
+
line endings. The style is the one most of the user's own lines use (the
|
|
63
|
+
blank lines next to a block, which a replacement rewrites, decide only
|
|
64
|
+
when the text has no other line break), so replacing again gives the same
|
|
65
|
+
text.
|
|
66
|
+
- `anchor.replace` and `anchor.remove` no longer add a final line break to
|
|
67
|
+
a text that had none when they replace or remove a block in place. A
|
|
68
|
+
block appended to a text with no block still ends with one.
|
|
69
|
+
- `anchor.replace` and `anchor.remove` keep a leading byte-order mark.
|
|
70
|
+
Before, it was dropped when the text began with a block.
|
|
71
|
+
|
|
72
|
+
### Changed
|
|
73
|
+
|
|
74
|
+
- `FoundBlock.handle` is documented as display only for a block with no
|
|
75
|
+
handle line: it reads the block's words loosely, so a sentence of the
|
|
76
|
+
user's that says "I am @x" reads as a claim. What it returns is unchanged
|
|
77
|
+
(the published contract's `find` cases pin it). Decide with `owner`,
|
|
78
|
+
`decide` or `follow`.
|
|
79
|
+
|
|
5
80
|
## 1.7.0 — 2026-11-21
|
|
6
81
|
|
|
7
82
|
Minor release (added behaviour → minor +1, `VERSIONING.md`).
|