@agentskit/doc-bridge 1.2.1 → 1.2.3
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 +11 -1
- package/CONTRIBUTING.md +1 -1
- package/README.md +3 -3
- package/action.yml +9 -2
- package/dist/cli/program.js +18 -5
- package/dist/cli/program.js.map +1 -1
- package/dist/index.d.ts +39 -2
- package/dist/index.js +46 -5
- package/dist/index.js.map +1 -1
- package/docs/MARKETPLACE.md +6 -0
- package/docs/POSITIONING.md +12 -1
- package/docs/chat-and-rag.md +1 -1
- package/docs/examples.md +9 -1
- package/docs/for-agents.md +12 -4
- package/docs/getting-started.md +10 -0
- package/docs/guides/cli-map.md +153 -0
- package/docs/guides/gate-ci.md +64 -0
- package/docs/guides/index-and-query.md +75 -0
- package/docs/guides/install-and-run.md +84 -0
- package/docs/guides/mcp-agents.md +63 -0
- package/docs/guides/memory-pipeline.md +105 -0
- package/docs/guides/meta.json +11 -0
- package/docs/index.md +48 -13
- package/docs/mcp.md +9 -0
- package/docs/meta.json +8 -2
- package/docs/playbook/doc-bridge-pattern.md +1 -1
- package/docs/query.md +47 -23
- package/ecosystem-upstream.json +1 -1
- package/ecosystem.json +108 -30
- package/package.json +7 -5
- package/src/conformance/ecosystem-contract.ts +22 -3
- package/src/federation/ecosystem-llms.ts +67 -0
- package/src/index.ts +6 -0
- package/src/playbook/doc-bridge-pattern.ts +1 -1
- package/src/version.ts +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.2.3
|
|
4
|
+
|
|
5
|
+
### Fixed
|
|
6
|
+
- Publish path for seven-product `properties[]` contract and `formatEcosystemLlmsBlock` (v1.2.2 GitHub tag/package.json were misaligned; npm still on 1.2.1)
|
|
7
|
+
- Marketplace Action dogfoods the local workspace package when run in this repository
|
|
8
|
+
- Docs site `llms.txt` renders the shared seven-product mesh with role, maturity, machine index, and **(current)**
|
|
9
|
+
|
|
10
|
+
### Changed
|
|
11
|
+
- Sync `ecosystem.json` upstream snapshot from AgentsKit hub main
|
|
12
|
+
|
|
3
13
|
## 1.2.1
|
|
4
14
|
|
|
5
15
|
### Fixes
|
|
@@ -63,7 +73,7 @@
|
|
|
63
73
|
|
|
64
74
|
### Features
|
|
65
75
|
|
|
66
|
-
- **Landing** — `docs/landing/index.html` deployed to GitHub Pages (`https://
|
|
76
|
+
- **Landing** — `docs/landing/index.html` deployed to GitHub Pages (`https://doc-bridge.agentskit.io/`)
|
|
67
77
|
- **Playbook pattern** — published `docs/playbook/doc-bridge-pattern.md` + `ak-docs playbook pattern [--text]`
|
|
68
78
|
- **Used by** — public AgentsKit surfaces cited on landing (for-agents, Registry, Playbook)
|
|
69
79
|
|
package/CONTRIBUTING.md
CHANGED
|
@@ -18,7 +18,7 @@ pnpm build
|
|
|
18
18
|
- Prefer existing helpers and Node APIs before adding dependencies.
|
|
19
19
|
- Add or update the smallest test that would fail if the behavior regresses.
|
|
20
20
|
- Public contract changes must update the relevant docs under `docs/spec/` or `docs/schemas/`.
|
|
21
|
-
- Dogfood AgentsKit Chat 0.
|
|
21
|
+
- Dogfood AgentsKit Chat 0.4.x only: `@agentskit/chat`, `@agentskit/chat/protocol`, and `@agentskit/chat/react`. Never reintroduce `@agentskit/chat-protocol` or `@agentskit/chat-react` (`pnpm check:no-legacy-chat-imports`).
|
|
22
22
|
|
|
23
23
|
## Pull request checklist
|
|
24
24
|
|
package/README.md
CHANGED
|
@@ -2,12 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@agentskit/doc-bridge)
|
|
4
4
|
[](https://github.com/AgentsKit-io/doc-bridge/actions/workflows/ci.yml)
|
|
5
|
-
[](https://
|
|
5
|
+
[](https://doc-bridge.agentskit.io/)
|
|
6
6
|
[](LICENSE)
|
|
7
7
|
[](package.json)
|
|
8
8
|
[](dist/index.d.ts)
|
|
9
9
|
|
|
10
|
-
**npm:** [`@agentskit/doc-bridge`](https://www.npmjs.com/package/@agentskit/doc-bridge) · **CLI:** `ak-docs` · **Landing:** [agentskit-io.github.io/doc-bridge](https://
|
|
10
|
+
**npm:** [`@agentskit/doc-bridge`](https://www.npmjs.com/package/@agentskit/doc-bridge) · **CLI:** `ak-docs` · **Landing:** [agentskit-io.github.io/doc-bridge](https://doc-bridge.agentskit.io/)
|
|
11
11
|
|
|
12
12
|
**Topics:** `ai-agents` · `documentation` · `developer-experience` · `mcp` · `llms-txt` · `typescript`
|
|
13
13
|
|
|
@@ -297,7 +297,7 @@ pnpm install && pnpm build && pnpm test
|
|
|
297
297
|
pnpm smoke:ollama # optional — skips if Ollama/peers unavailable
|
|
298
298
|
```
|
|
299
299
|
|
|
300
|
-
**Landing:** https://
|
|
300
|
+
**Landing:** https://doc-bridge.agentskit.io/
|
|
301
301
|
|
|
302
302
|
## Contributing
|
|
303
303
|
|
package/action.yml
CHANGED
|
@@ -20,7 +20,7 @@ inputs:
|
|
|
20
20
|
package-version:
|
|
21
21
|
description: Exact @agentskit/doc-bridge npm version (kept in sync with this Action release)
|
|
22
22
|
required: false
|
|
23
|
-
default: '1.2.
|
|
23
|
+
default: '1.2.3'
|
|
24
24
|
|
|
25
25
|
runs:
|
|
26
26
|
using: composite
|
|
@@ -39,7 +39,14 @@ runs:
|
|
|
39
39
|
echo "::error title=Invalid package-version::Use an exact semver version such as 1.2.1"
|
|
40
40
|
exit 2
|
|
41
41
|
fi
|
|
42
|
-
|
|
42
|
+
# When this Action runs against the Doc Bridge repository itself (CI dogfood),
|
|
43
|
+
# install the workspace package so gates exercise the PR under test — not a
|
|
44
|
+
# stale published npm version that may lag the local ecosystem contract.
|
|
45
|
+
if [ -f package.json ] && [ "$(node -p "try{require('./package.json').name}catch{''}")" = "@agentskit/doc-bridge" ]; then
|
|
46
|
+
npm install -g .
|
|
47
|
+
else
|
|
48
|
+
npm install -g "@agentskit/doc-bridge@${DOC_BRIDGE_PACKAGE_VERSION}"
|
|
49
|
+
fi
|
|
43
50
|
|
|
44
51
|
- name: Run gates
|
|
45
52
|
shell: bash
|
package/dist/cli/program.js
CHANGED
|
@@ -716,7 +716,10 @@ var ManifestSchema = z2.object({
|
|
|
716
716
|
schemaVersion: z2.literal(2),
|
|
717
717
|
parentBrand: z2.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema }).passthrough(),
|
|
718
718
|
products: z2.array(ProductSchema).min(1),
|
|
719
|
-
|
|
719
|
+
// Historical four-product shim or full seven-product projection of products[].
|
|
720
|
+
properties: z2.array(LegacyPropertySchema).refine((value) => value.length === 4 || value.length === 7, {
|
|
721
|
+
message: "must project either the legacy four products or the full seven-product catalog"
|
|
722
|
+
}),
|
|
720
723
|
builder: z2.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema, url: HttpsUrlSchema }).passthrough().optional()
|
|
721
724
|
}).passthrough();
|
|
722
725
|
var EvidenceSchema = z2.discriminatedUnion("type", [
|
|
@@ -749,7 +752,16 @@ var ClaimsSchema = z2.object({
|
|
|
749
752
|
manifestSchemaVersion: z2.literal(2),
|
|
750
753
|
products: z2.array(ClaimProductSchema)
|
|
751
754
|
}).passthrough();
|
|
752
|
-
var
|
|
755
|
+
var LEGACY_FOUR_PRODUCT_IDS = ["agentskit", "akos", "playbook", "registry"];
|
|
756
|
+
var FULL_SEVEN_PRODUCT_IDS = [
|
|
757
|
+
"agentskit",
|
|
758
|
+
"registry",
|
|
759
|
+
"agentskit-chat",
|
|
760
|
+
"playbook",
|
|
761
|
+
"doc-bridge",
|
|
762
|
+
"code-review",
|
|
763
|
+
"akos"
|
|
764
|
+
];
|
|
753
765
|
var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
|
|
754
766
|
const manifest = ManifestSchema.parse(manifestInput);
|
|
755
767
|
const claims = ClaimsSchema.parse(claimsInput);
|
|
@@ -775,7 +787,8 @@ var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
|
|
|
775
787
|
if (!products.has(nextId)) throw new Error(`Product ${product.id} references unknown product ${nextId}.`);
|
|
776
788
|
}
|
|
777
789
|
}
|
|
778
|
-
|
|
790
|
+
const propertyIds = manifest.properties.length === 7 ? FULL_SEVEN_PRODUCT_IDS : LEGACY_FOUR_PRODUCT_IDS;
|
|
791
|
+
for (const [index, id] of propertyIds.entries()) {
|
|
779
792
|
const legacy = manifest.properties[index];
|
|
780
793
|
const product = products.get(id);
|
|
781
794
|
if (!legacy || !product || legacy.id !== id || !product.surfaces.home) {
|
|
@@ -1334,7 +1347,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
|
|
|
1334
1347
|
};
|
|
1335
1348
|
|
|
1336
1349
|
// src/version.ts
|
|
1337
|
-
var PACKAGE_VERSION = "1.2.
|
|
1350
|
+
var PACKAGE_VERSION = "1.2.3";
|
|
1338
1351
|
|
|
1339
1352
|
// src/index-builder/capabilities.ts
|
|
1340
1353
|
var renderCapabilitiesJson = (config, index, paths) => {
|
|
@@ -3694,7 +3707,7 @@ Teams track handoff % and human-bridge % daily.
|
|
|
3694
3707
|
- npm: https://www.npmjs.com/package/@agentskit/doc-bridge
|
|
3695
3708
|
- repo: https://github.com/AgentsKit-io/doc-bridge
|
|
3696
3709
|
- skill: https://github.com/AgentsKit-io/doc-bridge/blob/master/docs/skills/doc-bridge.md
|
|
3697
|
-
- landing: https://
|
|
3710
|
+
- landing: https://doc-bridge.agentskit.io/
|
|
3698
3711
|
`;
|
|
3699
3712
|
var docBridgePatternPayload = () => ({
|
|
3700
3713
|
...DOC_BRIDGE_PATTERN_META,
|