@ampcode/plugin 0.0.0-20260707003429-g69640bc → 0.0.0-20260708002750-gee09e57

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 (2) hide show
  1. package/index.d.ts +16 -0
  2. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -795,6 +795,17 @@ declare module '@ampcode/plugin' {
795
795
  * Options for reading messages from a thread.
796
796
  */
797
797
  export interface ThreadMessagesOptions {
798
+ /**
799
+ * When true, read the full transcript, including messages that have been
800
+ * compacted away.
801
+ *
802
+ * By default, messages are read as a new inference turn would see them:
803
+ * when the thread has been compacted, the latest compaction summary
804
+ * (as a user message) followed by the messages after the compaction cut
805
+ * point; otherwise the full transcript.
806
+ */
807
+ full?: boolean
808
+
798
809
  /**
799
810
  * Where to read from. Defaults to `end` so callers read recent messages by
800
811
  * default instead of accidentally loading the start of a large thread.
@@ -860,6 +871,11 @@ declare module '@ampcode/plugin' {
860
871
  /**
861
872
  * Read messages from the thread in a stable plugin-facing schema.
862
873
  *
874
+ * By default this reads the messages a new inference turn would see:
875
+ * after a compaction, the latest compaction summary and the messages
876
+ * from the compaction cut point onward. Pass `full: true` to read the
877
+ * entire transcript, including compacted-away messages.
878
+ *
863
879
  * Defaults to `{ from: 'end', limit: 10 }`. The maximum `limit`
864
880
  * is 20. Combine with `offset` to fetch more messages.
865
881
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ampcode/plugin",
3
- "version": "0.0.0-20260707003429-g69640bc",
3
+ "version": "0.0.0-20260708002750-gee09e57",
4
4
  "description": "Amp Plugin API",
5
5
  "homepage": "https://ampcode.com/manual/plugin-api",
6
6
  "author": {