pi-agnes-tools 0.1.0 → 0.3.1

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/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "pi-agnes-tools",
3
- "version": "0.1.0",
4
- "description": "Pi extension that exposes Agnes AI image/video generation as callable tools (no model switch needed). Pairs with pi-agnes for auth.",
3
+ "version": "0.3.1",
4
+ "description": "Pi extension for Agnes AI: text model catalog (selectable via /model) plus image/video generation as custom tools + skill. No model switch needed for media.",
5
5
  "type": "module",
6
6
  "keywords": [
7
7
  "pi",
@@ -20,6 +20,7 @@
20
20
  },
21
21
  "files": [
22
22
  "extensions",
23
+ "skills",
23
24
  "README.md"
24
25
  ],
25
26
  "scripts": {
@@ -33,6 +34,9 @@
33
34
  "pi": {
34
35
  "extensions": [
35
36
  "./extensions"
37
+ ],
38
+ "skills": [
39
+ "./skills"
36
40
  ]
37
41
  }
38
42
  }
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: agnes-media
3
+ description: Generate images and videos with Agnes AI. Use when the user asks for a generated image, video, illustration, texture, mockup, image-to-video, keyframes, or media content from Agnes. Calls the pi-agnes-tools custom tools (agnes_image, agnes_video) — no model switch needed.
4
+ ---
5
+
6
+ # Agnes Media (image & video)
7
+
8
+ Generate media via the `pi-agnes-tools` tools. They hit the Agnes REST APIs
9
+ directly — do NOT switch to an Agnes model.
10
+
11
+ ## Tools
12
+
13
+ ### `agnes_image` — text-to-image / reference-conditioned image
14
+
15
+ | Param | Notes |
16
+ |---|---|
17
+ | `prompt` | required — describe the image concretely (subject, style, palette, composition) |
18
+ | `model` | default `agnes-image-2.5-flash`; others: `agnes-image-2.1-flash`, `agnes-image-2.0-flash` |
19
+ | `endpoint` | `agnes` (international, default) or `agnes-cn` (China) |
20
+ | `images` | optional base64 data URIs for reference/conditioning |
21
+ | `response_format` | default `png` |
22
+
23
+ ### `agnes_video` — text-to-video / image-to-video / keyframes
24
+
25
+ | Param | Notes |
26
+ |---|---|
27
+ | `prompt` | required — describe motion and scene |
28
+ | `model` | default `agnes-video-2.5-flash`; others: `agnes-video-2.5`, `agnes-video-v2.0` |
29
+ | `endpoint` | `agnes` (default) or `agnes-cn` |
30
+ | `images` | 1 image = image-to-video; >1 = keyframes mode (base64 data URIs) |
31
+ | `num_frames` / `frame_rate` | defaults 121 / 24 |
32
+
33
+ ## Notes
34
+
35
+ - Images save to `.pi/generated-images/`, videos to `.pi/generated-videos/`
36
+ (project-relative); results report a `file://` link plus a possibly-expiring
37
+ remote URL.
38
+ - Video is async: the tool polls until done (up to 30 min). Start the call,
39
+ don't busy-poll yourself.
40
+ - Auth: `AGNES_API_KEY` / `AGNES_CN_API_KEY` env, else the `/login`-stored
41
+ Agnes key.
42
+ - Reference images in `images` must be full data URIs
43
+ (`data:image/png;base64,...`); read the file first, base64 it.