@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.
@@ -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 signature
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'` 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 +
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'` the caller supplies a parsed skill structure;
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'` a downloaded directory cannot promote
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 it forwards the record to the agent
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 this is the always-present **Tier 1** payload
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 every loader user can re-derive bespoke fields. */
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} always available (parsed at load time).
239
- * - {@link Skill.body} lazy; resolved on first call. Cached for
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} lazy listing; resource bytes are only
241
+ * - {@link Skill.resources} - lazy listing; resource bytes are only
242
242
  * read when {@link SkillResource.read} is invoked.
243
- * - {@link Skill.tools} derived from the `graphorin-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 what the agent runtime sees after the model (or a
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 it
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.5.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.5.0",
86
- "@graphorin/tools": "0.5.0",
87
- "@graphorin/security": "0.5.0"
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",