@agentproto/apps 0.4.0 → 0.5.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/README.md CHANGED
@@ -25,6 +25,7 @@ An app here is a plain `AppHandle` — `codeTeam.agents`, `codeTeam.workflows`,
25
25
  | `code-team` | `@agentproto/apps/code-team` | `implementer` → `reviewer` → `fixer` | `deliver-change` |
26
26
  | `content-team` | `@agentproto/apps/content-team` | `researcher` → `writer` → `editor` → `illustrator` | `produce-content`, `produce-cover` |
27
27
  | `mail-triage` | `@agentproto/apps/mail-triage` | `triager` | `triage-inbox` |
28
+ | `media-viewer` | `@agentproto/apps/media-viewer` | `cataloger` | `scan-media` |
28
29
 
29
30
  Each team is a folder with `agents/<name>.ts` (one self-contained file per agent
30
31
  — its `defineAgent` handle + `body`) and `workflows/<name>.ts`, composed in the
@@ -38,6 +39,20 @@ team's `index.ts`. A new team is a sibling folder + a re-export.
38
39
  - **On disk** — `await team.emit(dir)` writes the AGENT.md / WORKFLOW.md
39
40
  manifests for a runtime that loads a workspace from disk. No Mastra needed.
40
41
 
42
+ ## Emitting the whole catalog
43
+
44
+ `@agentproto/apps` also ships an `agentproto-apps-sync` binary that emits every
45
+ bundled app to disk and writes a flat catalog:
46
+
47
+ ```bash
48
+ npx agentproto-apps-sync [--base-dir <dir>]
49
+ ```
50
+
51
+ The default base directory is `~/.agentproto/apps`. It writes each app's
52
+ manifests under `<baseDir>/<slug>/` and a summary catalog to
53
+ `<baseDir>/../app-catalog.json` (so `~/.agentproto/app-catalog.json` by
54
+ default).
55
+
41
56
  ## Generic by design
42
57
 
43
58
  Team ids are `@agentproto/…` and depend on **no** product package (the
@@ -0,0 +1,23 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * `agentproto-apps-sync` — emit every bundled `@agentproto/apps` app to disk
4
+ * and write a catalog of what landed where.
5
+ *
6
+ * Each app's `AGENT.md` / `WORKFLOW.md` / `APP.md` manifests are written
7
+ * under `<baseDir>/<slug>` via `AppHandle.emit` (see `@agentproto/app-kit`'s
8
+ * `emitApp`); the catalog is a flat index a host can read without walking
9
+ * every app's directory (`app_install`'s own discovery path already reads
10
+ * each `APP.md` individually — this is a cheaper "what's on disk" summary
11
+ * for the sync bin's own log, not a replacement for that).
12
+ */
13
+ interface CatalogEntry {
14
+ readonly appId: string;
15
+ readonly name: string;
16
+ readonly description: string;
17
+ readonly dir: string;
18
+ readonly category: string;
19
+ }
20
+ export declare function syncApps(baseDir: string): Promise<CatalogEntry[]>;
21
+ export declare function writeCatalog(baseDir: string, catalog: readonly CatalogEntry[]): Promise<string>;
22
+ export {};
23
+ //# sourceMappingURL=sync.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/bin/sync.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAYH,UAAU,YAAY;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AASD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAevE;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAKrG"}