@graphorin/skills 0.5.0 → 0.6.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 +33 -0
- package/README.md +13 -11
- package/anthropic-spec-snapshot.json +1 -1
- package/dist/activation/index.js +2 -2
- package/dist/activation/index.js.map +1 -1
- package/dist/errors/index.d.ts +1 -1
- package/dist/errors/index.js.map +1 -1
- package/dist/frontmatter/index.d.ts +1 -1
- package/dist/frontmatter/index.d.ts.map +1 -1
- package/dist/frontmatter/index.js +9 -4
- package/dist/frontmatter/index.js.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/dist/loader/index.d.ts.map +1 -1
- package/dist/loader/index.js +3 -3
- package/dist/loader/index.js.map +1 -1
- package/dist/migration/index.d.ts +2 -2
- package/dist/migration/index.js +2 -2
- package/dist/migration/index.js.map +1 -1
- package/dist/registry/bridge.js.map +1 -1
- package/dist/registry/index.d.ts +3 -3
- package/dist/registry/index.js.map +1 -1
- package/dist/spec/index.d.ts +13 -9
- package/dist/spec/index.d.ts.map +1 -1
- package/dist/spec/index.js +13 -9
- package/dist/spec/index.js.map +1 -1
- package/dist/types/index.d.ts +16 -16
- package/package.json +4 -4
package/dist/types/index.d.ts
CHANGED
|
@@ -10,7 +10,7 @@ import { ResolvedTool, Tool } from "@graphorin/core";
|
|
|
10
10
|
* sandbox tier resolver treats `'unknown'` like `'untrusted'`
|
|
11
11
|
* (mandatory `worker-threads + no-net + no-fs`); the supply-chain
|
|
12
12
|
* installer treats it as untrusted EXCEPT that the signature
|
|
13
|
-
* requirement is downgraded from mandatory to optional
|
|
13
|
+
* requirement is downgraded from mandatory to optional - signature
|
|
14
14
|
* is a trust upgrade, not a gate (Phase 08 § Risks & mitigations).
|
|
15
15
|
*
|
|
16
16
|
* @stable
|
|
@@ -43,11 +43,11 @@ type SkillTrustLevelValue = SkillsTrustLevel;
|
|
|
43
43
|
/**
|
|
44
44
|
* Source descriptor for a {@link loadSkills} request.
|
|
45
45
|
*
|
|
46
|
-
* - `'folder'`
|
|
47
|
-
* - `'npm-package'`
|
|
48
|
-
* - `'git-repo'`
|
|
46
|
+
* - `'folder'` - load from a directory on disk.
|
|
47
|
+
* - `'npm-package'` - install via the supply-chain installer + load.
|
|
48
|
+
* - `'git-repo'` - shallow-clone via the supply-chain installer +
|
|
49
49
|
* load.
|
|
50
|
-
* - `'inline'`
|
|
50
|
+
* - `'inline'` - the caller supplies a parsed skill structure;
|
|
51
51
|
* useful for tests and embedded fixtures.
|
|
52
52
|
*
|
|
53
53
|
* @stable
|
|
@@ -59,7 +59,7 @@ type SkillSource = {
|
|
|
59
59
|
* Operator-supplied trust level. When present it overrides the
|
|
60
60
|
* skill's self-declared `graphorin-trust-level`. Without it, a
|
|
61
61
|
* folder's self-declared `trusted` / `trusted-with-scripts` is
|
|
62
|
-
* capped at `'unknown'`
|
|
62
|
+
* capped at `'unknown'` - a downloaded directory cannot promote
|
|
63
63
|
* itself; trust is granted by the integrator, never the artifact.
|
|
64
64
|
*/
|
|
65
65
|
readonly trustLevel?: SkillTrustLevel;
|
|
@@ -79,7 +79,7 @@ type SkillSource = {
|
|
|
79
79
|
};
|
|
80
80
|
/**
|
|
81
81
|
* Pre-built tool record accepted by the inline source. The loader
|
|
82
|
-
* does not parse the tool
|
|
82
|
+
* does not parse the tool - it forwards the record to the agent
|
|
83
83
|
* runtime which feeds it through `stampSkillTool(...)` before
|
|
84
84
|
* registering with `@graphorin/tools`.
|
|
85
85
|
*
|
|
@@ -104,7 +104,7 @@ interface InlineSkill {
|
|
|
104
104
|
* these via {@link Skill.tools} so {@link SkillRegistry.tools}
|
|
105
105
|
* returns them deduplicated by `tool.name`.
|
|
106
106
|
*
|
|
107
|
-
* Folder / npm / git sources do not carry tool implementations
|
|
107
|
+
* Folder / npm / git sources do not carry tool implementations -
|
|
108
108
|
* the agent runtime (Phase 12) materialises them from the skill's
|
|
109
109
|
* `tools/` directory. The inline source is the only path through
|
|
110
110
|
* which tests + bundled defaults can ship pre-built tools.
|
|
@@ -138,7 +138,7 @@ interface FrontmatterDiagnostic {
|
|
|
138
138
|
}
|
|
139
139
|
/**
|
|
140
140
|
* Validated skill metadata. Always available on the registry without
|
|
141
|
-
* loading the body
|
|
141
|
+
* loading the body - this is the always-present **Tier 1** payload
|
|
142
142
|
* that the system prompt advertises.
|
|
143
143
|
*
|
|
144
144
|
* @stable
|
|
@@ -161,7 +161,7 @@ interface SkillMetadata {
|
|
|
161
161
|
readonly graphorinAnthropicSpec?: string;
|
|
162
162
|
/** Author-declared graphorin runtime / extension version. */
|
|
163
163
|
readonly graphorinVersion?: string;
|
|
164
|
-
/** Raw frontmatter (read-only) for power users
|
|
164
|
+
/** Raw frontmatter (read-only) for power users - every loader user can re-derive bespoke fields. */
|
|
165
165
|
readonly raw: Readonly<Record<string, unknown>>;
|
|
166
166
|
}
|
|
167
167
|
/**
|
|
@@ -235,12 +235,12 @@ interface SkillResource {
|
|
|
235
235
|
* Loaded skill record returned by {@link SkillRegistry.getSkill} and
|
|
236
236
|
* {@link loadSkills}. Three-tier semantics:
|
|
237
237
|
*
|
|
238
|
-
* - {@link Skill.metadata}
|
|
239
|
-
* - {@link Skill.body}
|
|
238
|
+
* - {@link Skill.metadata} - always available (parsed at load time).
|
|
239
|
+
* - {@link Skill.body} - lazy; resolved on first call. Cached for
|
|
240
240
|
* subsequent calls.
|
|
241
|
-
* - {@link Skill.resources}
|
|
241
|
+
* - {@link Skill.resources} - lazy listing; resource bytes are only
|
|
242
242
|
* read when {@link SkillResource.read} is invoked.
|
|
243
|
-
* - {@link Skill.tools}
|
|
243
|
+
* - {@link Skill.tools} - derived from the `graphorin-tools`
|
|
244
244
|
* declarations; the actual `Tool[]` is materialised by the agent
|
|
245
245
|
* runtime through the `@graphorin/tools` registry.
|
|
246
246
|
*
|
|
@@ -266,7 +266,7 @@ interface Skill {
|
|
|
266
266
|
diagnostics(): ReadonlyArray<FrontmatterDiagnostic>;
|
|
267
267
|
}
|
|
268
268
|
/**
|
|
269
|
-
* Activated skill
|
|
269
|
+
* Activated skill - what the agent runtime sees after the model (or a
|
|
270
270
|
* slash command) elects a skill. Carries the loaded body + declared
|
|
271
271
|
* tools so the runtime can inject them into the conversation.
|
|
272
272
|
*
|
|
@@ -278,7 +278,7 @@ interface ActivatedSkill {
|
|
|
278
278
|
readonly resources: ReadonlyArray<SkillResource>;
|
|
279
279
|
/**
|
|
280
280
|
* Tools made available to the model while the skill is active.
|
|
281
|
-
* The agent runtime (Phase 12) is the canonical producer
|
|
281
|
+
* The agent runtime (Phase 12) is the canonical producer - it
|
|
282
282
|
* resolves the skill's `tools/` directory or the inline-supplied
|
|
283
283
|
* `Tool[]` and feeds each entry through `stampSkillTool(...)` so
|
|
284
284
|
* the resulting `ResolvedTool` carries the right trust class +
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@graphorin/skills",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "Skills surface for the Graphorin framework: loader for the SKILL.md packaging format with three-tier progressive disclosure (metadata / body / resources), frontmatter validator implementing the field-resolution algorithm and conflict policy from ADR-043, registry with auto-activation + slash-command activation, supply-chain hardening (signature verification + `--ignore-scripts` enforcement via @graphorin/security), sandbox-tier propagation for untrusted skills, handoff input-filter declaration recognition, and idempotent migrate-frontmatter library.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Oleksiy Stepurenko",
|
|
@@ -82,9 +82,9 @@
|
|
|
82
82
|
],
|
|
83
83
|
"dependencies": {
|
|
84
84
|
"yaml": "^2.8.0",
|
|
85
|
-
"@graphorin/core": "0.
|
|
86
|
-
"@graphorin/
|
|
87
|
-
"@graphorin/
|
|
85
|
+
"@graphorin/core": "0.6.0",
|
|
86
|
+
"@graphorin/security": "0.6.0",
|
|
87
|
+
"@graphorin/tools": "0.6.0"
|
|
88
88
|
},
|
|
89
89
|
"publishConfig": {
|
|
90
90
|
"access": "public",
|