@plurnk/plurnk-service 1.16.5 → 1.18.0

package/dist/schemes/Log.sql

@@ -2,7 +2,7 @@
 -- coordinate; KILL mutates only the active projection.
 
 -- PREP: log_read_by_coordinate
-SELECT le.origin, le.op, le.scheme, le.pathname, le.status_rx,
+SELECT le.id, le.origin, le.op, le.scheme, le.pathname, le.status_rx, le.folded,
        le.tx, le.mimetype_tx, le.rx, le.mimetype_rx, le.attrs
 FROM active_log_entries le
 JOIN turns t ON t.id = le.turn_id
@@ -11,7 +11,7 @@ WHERE l.worker_id = $worker_id AND l.sequence = $loop_seq AND t.sequence = $turn
 
 -- PREP: log_id_by_coordinate
 -- Resolve a concrete active log:/// coordinate within the worker.
-SELECT le.id, le.origin, le.op, le.attrs FROM active_log_entries le
+SELECT le.id, le.origin, le.op, le.attrs, le.tx FROM active_log_entries le
 JOIN turns t ON t.id = le.turn_id
 JOIN loops l ON l.id = t.loop_id
 WHERE l.worker_id = $worker_id
@@ -25,7 +25,7 @@ WHERE l.worker_id = $worker_id
 -- coordinate tree. TypeScript appends the canonical projected OP and applies
 -- the authoritative shell-glob match.
 SELECT le.id, (l.sequence || '/' || t.sequence || '/' || le.sequence) AS coordinate,
-       le.origin, le.op, le.attrs
+       le.origin, le.op, le.attrs, le.tx
 FROM active_log_entries le
 JOIN turns t ON t.id = le.turn_id
 JOIN loops l ON l.id = t.loop_id
@@ -51,7 +51,12 @@ SELECT
     le.rx,
     le.mimetype_rx,
     le.attrs,
-    le.folded
+    le.folded,
+    CASE WHEN json_valid(le.rx) THEN (json_type(le.rx, '$.nativeContentHash') = 'text'
+        AND ((SELECT packet FROM turns WHERE id = $turn_id) IS NULL OR EXISTS (
+            SELECT 1 FROM json_each((SELECT packet FROM turns WHERE id = $turn_id), '$.attachments') part
+            WHERE json_extract(part.value, '$.coordinate') = (l.sequence || '/' || t.sequence || '/' || le.sequence)
+        ))) ELSE 0 END AS native_active
 FROM active_log_entries le
 JOIN turns t ON t.id = le.turn_id
 JOIN loops l ON l.id = t.loop_id
@@ -63,15 +68,21 @@ UPDATE log_entry_projections SET folded = $folded
 WHERE log_entry_id = $id AND active = 1 AND json(folded) != json($folded)
 RETURNING log_entry_id AS id;
 
--- PREP: log_set_projection_by_id
--- Direct core-scheme calls use the same collision-checked projection transition
--- as the dispatcher's atomic curation event, without manufacturing an op row.
+-- PREP: log_apply_projection_plan
+-- {§log-curation-direct}: a direct core-scheme curation lands its whole plan or none of it. Every
+-- target's precondition is counted once, before any row changes; one stale target means zero rows.
+-- The same collision-checked transition as the dispatcher's atomic curation event, without an op row.
 UPDATE log_entry_projections
-SET active = $active_after,
-    folded = $folded_after
-WHERE log_entry_id = $id
-  AND active = $active_before
-  AND json(folded) = json($folded_before)
+SET active = json_extract(plan.value, '$.activeAfter'),
+    folded = json_extract(plan.value, '$.foldedAfter')
+FROM json_each($targets) AS plan
+WHERE log_entry_projections.log_entry_id = json_extract(plan.value, '$.id')
+  AND (
+      SELECT COUNT(*) FROM json_each($targets) AS t
+      JOIN log_entry_projections p ON p.log_entry_id = json_extract(t.value, '$.id')
+       AND p.active = json_extract(t.value, '$.activeBefore')
+       AND json(p.folded) = json(json_extract(t.value, '$.foldedBefore'))
+  ) = json_array_length($targets)
 RETURNING log_entry_id AS id;
 
 -- PREP: log_find_candidates
@@ -80,7 +91,7 @@ RETURNING log_entry_id AS id;
 -- fields Log's rx projection renders (FIND must match exactly what READ shows). Coordinate-ordered.
 SELECT
     (l.sequence || '/' || t.sequence || '/' || le.sequence) AS coordinate,
-    le.origin, le.op, le.tx, le.mimetype_tx, le.rx, le.mimetype_rx, le.weight, le.deep_hash, le.attrs
+    le.origin, le.op, le.tx, le.mimetype_tx, le.rx, le.mimetype_rx, le.weight, le.deep_hash, le.attrs, le.folded
 FROM active_log_entries le
 JOIN turns t ON t.id = le.turn_id
 JOIN loops l ON l.id = t.loop_id
@@ -109,7 +120,7 @@ SELECT
     le.deep_hash,
     d.disposition AS deep_disposition,
     d.reason AS deep_reason,
-    le.attrs
+    le.attrs, le.folded
 FROM active_log_entries le
 LEFT JOIN derivations d ON d.deep_hash = le.deep_hash
 JOIN workers w ON w.id = le.worker_id
@@ -119,4 +130,161 @@ WHERE w.workspace_id = $workspace_id
 ORDER BY le.id;
 
 -- PREP: log_set_deep_hash
-UPDATE log_entries SET deep_hash = $deep_hash WHERE id = $log_entry_id;
+UPDATE log_entries SET deep_hash = $deep_hash
+WHERE id = $log_entry_id AND EXISTS (
+    SELECT 1 FROM log_entry_projections
+    WHERE log_entry_id = $log_entry_id AND active = 1 AND json(folded) = json($folded)
+);
+
+-- INIT: log_entries_initialize_projection
+DROP TRIGGER IF EXISTS log_entries_initialize_projection;
+CREATE TRIGGER log_entries_initialize_projection
+AFTER INSERT ON log_entries
+BEGIN
+    INSERT INTO log_entry_projections (log_entry_id, active, folded)
+    VALUES (NEW.id, 1, '[]');
+END;
+
+-- INIT: log_entry_projections_invalidate_derivation
+-- {§log-readable-projection} — derived artifacts describe the active body.
+DROP TRIGGER IF EXISTS log_entry_projections_invalidate_derivation;
+CREATE TRIGGER log_entry_projections_invalidate_derivation
+AFTER UPDATE OF folded, active ON log_entry_projections
+WHEN OLD.active != NEW.active OR json(OLD.folded) != json(NEW.folded)
+BEGIN
+    UPDATE log_entries SET deep_hash = NULL WHERE id = NEW.log_entry_id;
+END;
+
+-- INIT: log_entries_apply_curation
+-- One outer INSERT owns the whole landed curation event: exact selected rows,
+-- their before/after projection, and the resulting current
+-- state. Trigger failure rolls the operation row and all effects back together.
+-- The private plan is erased before INSERT returns.
+-- {§log-kill-scope} — a log KILL either retires a row whole (active 1→0, visibility untouched)
+-- or folds a span of its body (active stays 1, visibility changes).
+DROP TRIGGER IF EXISTS log_entries_apply_curation;
+CREATE TRIGGER log_entries_apply_curation
+AFTER INSERT ON log_entries
+WHEN NEW.op = 'KILL'
+ AND NEW.status_rx < 400
+ AND NEW.scheme = 'log'
+ AND json_type(NEW.attrs, '$.__plurnk_curation') = 'object'
+BEGIN
+    SELECT CASE WHEN
+        COALESCE(json_type(NEW.attrs, '$.__plurnk_curation.targets'), '') != 'array'
+        OR json_array_length(NEW.attrs, '$.__plurnk_curation.targets') = 0
+        OR EXISTS (
+            SELECT 1
+            FROM json_each(NEW.attrs, '$.__plurnk_curation.targets') selected
+            WHERE selected.type != 'object'
+               OR COALESCE(json_type(selected.value, '$.id'), '') != 'integer'
+               OR json_extract(selected.value, '$.id') <= 0
+               OR COALESCE(json_type(selected.value, '$.activeBefore'), '') != 'integer'
+               OR json_extract(selected.value, '$.activeBefore') NOT IN (0, 1)
+               OR COALESCE(json_type(selected.value, '$.activeAfter'), '') != 'integer'
+               OR json_extract(selected.value, '$.activeAfter') NOT IN (0, 1)
+               OR COALESCE(json_type(selected.value, '$.foldedBefore'), '') != 'array'
+               OR COALESCE(json_type(selected.value, '$.foldedAfter'), '') != 'array'
+               OR EXISTS (
+                   SELECT 1 FROM json_each(selected.value) field
+                   WHERE field.key NOT IN ('id', 'activeBefore', 'activeAfter', 'foldedBefore', 'foldedAfter')
+               )
+               OR EXISTS (
+                   SELECT 1
+                   FROM (
+                       SELECT 'before' AS side, range.key, range.value, range.type
+                       FROM json_each(json_extract(selected.value, '$.foldedBefore')) range
+                       UNION ALL
+                       SELECT 'after' AS side, range.key, range.value, range.type
+                       FROM json_each(json_extract(selected.value, '$.foldedAfter')) range
+                   ) range
+                   WHERE range.type != 'array'
+                      OR json_array_length(range.value) != 2
+                      OR COALESCE(json_type(range.value, '$[0]'), '') != 'integer'
+                      OR COALESCE(json_type(range.value, '$[1]'), '') != 'integer'
+                      OR json_extract(range.value, '$[0]') < 1
+                      OR (
+                          json_extract(range.value, '$[1]') != -1
+                          AND json_extract(range.value, '$[1]') < json_extract(range.value, '$[0]')
+                      )
+                      OR EXISTS (
+                          SELECT 1
+                          FROM json_each(
+                              CASE range.side
+                                  WHEN 'before' THEN json_extract(selected.value, '$.foldedBefore')
+                                  ELSE json_extract(selected.value, '$.foldedAfter')
+                              END
+                          ) previous
+                          WHERE previous.key = range.key - 1
+                            AND (
+                                json_extract(previous.value, '$[1]') = -1
+                                OR json_extract(range.value, '$[0]') <= json_extract(previous.value, '$[1]') + 1
+                            )
+                      )
+               )
+        )
+        OR (
+            SELECT COUNT(*) FROM json_each(NEW.attrs, '$.__plurnk_curation.targets')
+        ) != (
+            SELECT COUNT(DISTINCT json_extract(value, '$.id'))
+            FROM json_each(NEW.attrs, '$.__plurnk_curation.targets')
+        )
+        OR EXISTS (
+            SELECT 1
+            FROM json_each(NEW.attrs, '$.__plurnk_curation.targets') selected
+            LEFT JOIN log_entries target ON target.id = json_extract(selected.value, '$.id')
+            LEFT JOIN log_entry_projections projection ON projection.log_entry_id = target.id
+            WHERE target.id IS NULL
+               OR projection.log_entry_id IS NULL
+               OR target.worker_id != NEW.worker_id
+               OR target.id = NEW.id
+               OR projection.active != json_extract(selected.value, '$.activeBefore')
+               OR json(projection.folded) != json(json_extract(selected.value, '$.foldedBefore'))
+               OR NOT (
+                   json_extract(selected.value, '$.activeBefore') = 1
+                   AND (
+                       json_extract(selected.value, '$.activeAfter') = 1
+                       OR json(json_extract(selected.value, '$.foldedBefore')) = json(json_extract(selected.value, '$.foldedAfter'))
+                   )
+               )
+        )
+    THEN RAISE(ABORT, 'invalid private log curation payload') END;
+
+    INSERT INTO log_curation_effects (
+        operation_log_entry_id,
+        target_log_entry_id,
+        active_before,
+        active_after,
+        folded_before,
+        folded_after
+    )
+    SELECT
+        NEW.id,
+        target.id,
+        json_extract(selected.value, '$.activeBefore'),
+        json_extract(selected.value, '$.activeAfter'),
+        json_extract(selected.value, '$.foldedBefore'),
+        json_extract(selected.value, '$.foldedAfter')
+    FROM json_each(NEW.attrs, '$.__plurnk_curation.targets') selected
+    JOIN log_entries target ON target.id = json_extract(selected.value, '$.id');
+
+    UPDATE log_entry_projections
+    SET active = (
+        SELECT json_extract(selected.value, '$.activeAfter')
+        FROM json_each(NEW.attrs, '$.__plurnk_curation.targets') selected
+        WHERE json_extract(selected.value, '$.id') = log_entry_projections.log_entry_id
+    ),
+        folded = (
+        SELECT json_extract(selected.value, '$.foldedAfter')
+        FROM json_each(NEW.attrs, '$.__plurnk_curation.targets') selected
+        WHERE json_extract(selected.value, '$.id') = log_entry_projections.log_entry_id
+    )
+    WHERE log_entry_id IN (
+        SELECT json_extract(value, '$.id')
+        FROM json_each(NEW.attrs, '$.__plurnk_curation.targets')
+    );
+
+    UPDATE log_entries
+    SET attrs = json_remove(attrs, '$.__plurnk_curation')
+    WHERE id = NEW.id;
+END;

package/dist/schemes/Prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Prompt.d.ts","sourceRoot":"","sources":["../../src/schemes/Prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChJ,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAU9D,MAAM,CAAC,OAAO,OAAO,MAAO,YAAW,aAAa;IAChD,MAAM,CAAC,QAAQ,EAAE,cAAc,CAa7B;IAII,SAAS,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAGtG;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAE7E;CACJ"}
+{"version":3,"file":"Prompt.d.ts","sourceRoot":"","sources":["../../src/schemes/Prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChJ,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAI9D,MAAM,CAAC,OAAO,OAAO,MAAO,YAAW,aAAa;IAChD,MAAM,CAAC,QAAQ,EAAE,cAAc,CAW7B;IAGI,SAAS,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAGtG;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAE7E;CACJ"}

package/dist/schemes/Prompt.js

@@ -1,28 +1,19 @@
 import LineAnchors from "../content/line-anchors.js";
-// {§prompt-self-only} — prompt:// carries the worker's own task frames: each loop's prompt at
-// prompt:///<loopSeq>/<turnSeq>, owned by the worker via owner_id — the address carries only the
-// loop coordinate, so no worker identity ever rides a pathname or a packet. SELF-ONLY by
-// construction: packets are per-worker and every cross-worker prompt flow (parent→child inject,
-// the drain's orphan promotion) is engine-mediated, so the face takes no authority slot — a
-// worker only ever addresses its own frames. Engine-authored (writableBy excludes the model);
-// prompt-target log rows remain ordinary curatable memory.
+// {§prompt-address}: immutable-to-model task frames at literal workspace addresses.
 export default class Prompt {
     static manifest = {
         name: "prompt",
+        authority: "resource",
         channels: { body: "text/markdown" },
         defaultChannel: "body",
         category: "data",
-        entryOwner: "worker",
-        inherit: "snapshot",
         writableBy: ["client", "_plurnk"],
         volatile: false,
         modelVisible: true,
         folderScopes: true,
         textEditScopes: true,
-        example: "### READ0 (prompt:///1/1)",
     };
-    // Engine and client prompt writers persist the frame owner-keyed to the
-    // worker it addresses. The actionless prompt log row is written separately.
+    // The actionless prompt log row is written separately from its source entry.
     async editBatch(statements, ctx) {
         LineAnchors.assertResolved(statements);
         return ctx.entries.operations.editBatch(statements);

package/dist/schemes/Prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"Prompt.js","sourceRoot":"","sources":["../../src/schemes/Prompt.ts"],"names":[],"mappings":"AAEA,OAAO,WAAW,MAAM,4BAA4B,CAAC;AAErD,8FAA8F;AAC9F,iGAAiG;AACjG,yFAAyF;AACzF,gGAAgG;AAChG,4FAA4F;AAC5F,8FAA8F;AAC9F,2DAA2D;AAC3D,MAAM,CAAC,OAAO,OAAO,MAAM;IACvB,MAAM,CAAC,QAAQ,GAAmB;QAC9B,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;QACnC,cAAc,EAAE,MAAM;QACtB,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,QAAQ;QACpB,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QACjC,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,OAAO,EAAE,2BAA2B;KACvC,CAAC;IAEF,wEAAwE;IACxE,4EAA4E;IAC5E,KAAK,CAAC,SAAS,CAAC,UAA4C,EAAE,GAAc;QACxE,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACvC,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAc;QAC/C,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACJ"}
+{"version":3,"file":"Prompt.js","sourceRoot":"","sources":["../../src/schemes/Prompt.ts"],"names":[],"mappings":"AAEA,OAAO,WAAW,MAAM,4BAA4B,CAAC;AAErD,oFAAoF;AACpF,MAAM,CAAC,OAAO,OAAO,MAAM;IACvB,MAAM,CAAC,QAAQ,GAAmB;QAC9B,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;QACnC,cAAc,EAAE,MAAM;QACtB,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QACjC,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;KACvB,CAAC;IAEF,6EAA6E;IAC7E,KAAK,CAAC,SAAS,CAAC,UAA4C,EAAE,GAAc;QACxE,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACvC,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAc;QAC/C,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACJ"}

package/dist/schemes/QuestionTool.d.ts

@@ -5,6 +5,11 @@ export declare const questionRuntimeDecl: {
     glyph: string;
     summary: string;
     invocation: {
+        target: {
+            role: string;
+            kind: "literal";
+            required: false;
+        };
         body: {
             role: string;
             required: true;

package/dist/schemes/QuestionTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QuestionTool.d.ts","sourceRoot":"","sources":["../../src/schemes/QuestionTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAW,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAe,MAAM,sBAAsB,CAAC;AAcxH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;CAgBT,CAAC;AAExB,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,YAAY;IAClD,IAAa,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,CAE3C;IAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAEpD;IAEQ,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE9C;IAEc,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAEnD;IAEc,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAqD7F;CACJ"}
+{"version":3,"file":"QuestionTool.d.ts","sourceRoot":"","sources":["../../src/schemes/QuestionTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAW,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAe,MAAM,sBAAsB,CAAC;AAcxH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;CAiBT,CAAC;AAExB,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,YAAY;IAClD,IAAa,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,CAE3C;IAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAEpD;IAEQ,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE9C;IAEc,KAAK,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAEnD;IAEc,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA4C7F;CACJ"}

package/dist/schemes/QuestionTool.js

@@ -1,7 +1,7 @@
 import { BaseExecutor, Results } from "@plurnk/plurnk-execs";
 import { Validator } from "@plurnk/plurnk-contracts";
 // {§question-tool} — the native request-user-input runtime. The model asks the
-// human through one registered EXEC tool, wired directly against the standard
+// human through one registered executor tool, wired directly against the standard
 // client-interaction lifecycle (no loopback MCP, no proposal masquerade). The
 // body is the MCP2 2026-07-28 form-elicitation shape verbatim —
 // `{ message, requestedSchema }` — and the result is the standard
@@ -14,6 +14,7 @@ export const questionRuntimeDecl = {
     glyph: "❓",
     summary: "Ask the user to answer a question.",
     invocation: {
+        target: { role: "label", kind: "literal", required: false },
         body: { role: "MCP2 form-elicitation object", required: true },
         example: { body: QUESTION_BODY_EXAMPLE },
     },
@@ -24,7 +25,7 @@ export const questionRuntimeDecl = {
 | \`message\` | The question shown to the user (non-empty string). |
 | \`requestedSchema\` | JSON Schema object the user's answer must satisfy; \`enum\`/enumNames/oneOf/array/boolean/string/number forms supported. |
 
-The tool pauses its loop until the user answers. The result is \`{ "action": "accept", "content": <answer> }\` or \`{ "action": "cancel" }\`.`,
+An optional target is a label, not a recipient. The result is \`{ "action": "accept", "content": <answer> }\` or \`{ "action": "cancel" }\`; a waiting loop resumes when the answer arrives.`,
 };
 export default class QuestionTool extends BaseExecutor {
     get traits() {
@@ -56,8 +57,7 @@ export default class QuestionTool extends BaseExecutor {
             return Results.failure("executor:question", "invalid-body", 400, "The question body must carry a non-empty message and a requestedSchema object.", {}, { recovery: "Use the MCP2 form-elicitation shape: { message, requestedSchema }.", retryable: false });
         }
         signal.throwIfAborted();
-        // The contracts-owned wire is the exact shape MCP2 MRTR elicitation
-        // already produces; the executor owns only the mapping from the body.
+        // The interaction schema describes the answer, not this executor's output.
         const request = Validator.assertClientInteractionRequest({
             toolName: "question",
             arguments: { message: r.message, requestedSchema: r.requestedSchema },
@@ -65,17 +65,9 @@ export default class QuestionTool extends BaseExecutor {
             responseSchema: r.requestedSchema,
         });
         const resolution = await interact(request);
-        // The resolution payload IS the standard ElicitResult — return it
-        // verbatim when well-formed; otherwise wrap it as the accepted content.
-        const payload = resolution.status === "resolved" ? resolution.payload : undefined;
-        const result = payload !== null && typeof payload === "object"
-            && (payload.action === "accept"
-                || payload.action === "decline"
-                || payload.action === "cancel")
-            ? payload
-            : resolution.status === "cancelled"
-                ? { action: "cancel" }
-                : { action: "accept", content: payload ?? {} };
+        const result = resolution.status === "cancelled"
+            ? { action: "cancel" }
+            : { action: "accept", content: resolution.payload };
         write("results", `${JSON.stringify(result, null, 2)}\n`, "application/json");
         setState("results", "closed");
         return { status: 200, attrs: { action: result.action } };

package/dist/schemes/QuestionTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"QuestionTool.js","sourceRoot":"","sources":["../../src/schemes/QuestionTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,+EAA+E;AAC/E,8EAA8E;AAC9E,8EAA8E;AAC9E,gEAAgE;AAChE,kEAAkE;AAClE,2EAA2E;AAC3E,yEAAyE;AACzE,oEAAoE;AAEpE,MAAM,qBAAqB,GAAG,uLAAuL,CAAC;AAEtN,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,oCAAoC;IAC7C,UAAU,EAAE;QACR,IAAI,EAAE,EAAE,IAAI,EAAE,8BAA8B,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC9D,OAAO,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE;KAC3C;IACD,OAAO,EAAE;;;;;;;8IAOiI;CACvH,CAAC;AAExB,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,YAAY;IAClD,IAAa,MAAM;QACf,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAAE,CAAC;IACzD,CAAC;IAEQ,MAAM,CAAC,OAAsB;QAClC,OAAO,MAAM,CAAC;IAClB,CAAC;IAEQ,KAAK,CAAC,KAAK;QAChB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACrD,CAAC;IAEQ,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAY;QACpE,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACL,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC/B,OAAO,OAAO,CAAC,OAAO,CAClB,mBAAmB,EACnB,cAAc,EACd,GAAG,EACH,sCAAsC,EACtC,EAAE,EACF,EAAE,QAAQ,EAAE,oEAAoE,EAAE,SAAS,EAAE,KAAK,EAAE,CACvG,CAAC;QACN,CAAC;QACD,MAAM,CAAC,GAAG,MAAiE,CAAC;QAC5E,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;eAChC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;eACvD,OAAO,CAAC,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;YACzE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC/B,OAAO,OAAO,CAAC,OAAO,CAClB,mBAAmB,EACnB,cAAc,EACd,GAAG,EACH,gFAAgF,EAChF,EAAE,EACF,EAAE,QAAQ,EAAE,oEAAoE,EAAE,SAAS,EAAE,KAAK,EAAE,CACvG,CAAC;QACN,CAAC;QACD,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,oEAAoE;QACpE,sEAAsE;QACtE,MAAM,OAAO,GAAG,SAAS,CAAC,8BAA8B,CAAC;YACrD,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC,eAAe,EAAE;YACrE,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,cAAc,EAAE,CAAC,CAAC,eAA0C;SAC/D,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3C,kEAAkE;QAClE,wEAAwE;QACxE,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,MAAM,MAAM,GAAG,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;eACvD,CAAE,OAAgC,CAAC,MAAM,KAAK,QAAQ;mBACjD,OAAgC,CAAC,MAAM,KAAK,SAAS;mBACrD,OAAgC,CAAC,MAAM,KAAK,QAAQ,CAAC;YAC7D,CAAC,CAAC,OAAyE;YAC3E,CAAC,CAAC,UAAU,CAAC,MAAM,KAAK,WAAW;gBAC/B,CAAC,CAAC,EAAE,MAAM,EAAE,QAAiB,EAAE;gBAC/B,CAAC,CAAC,EAAE,MAAM,EAAE,QAAiB,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QAChE,KAAK,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QAC7E,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IAC7D,CAAC;CACJ"}
+{"version":3,"file":"QuestionTool.js","sourceRoot":"","sources":["../../src/schemes/QuestionTool.ts"],"names":[],"mappings":"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"}

package/dist/schemes/Skill.d.ts

@@ -1,10 +1,15 @@
-import type { EntryEditResult, EntryFindResult, ResolvedEditStatement, SchemeCtx, SchemeHandler, SchemeManifest, SchemeResult } from "@plurnk/plurnk-schemes";
-import type { FindStatement, SendStatement } from "@plurnk/plurnk-contracts";
-export default class Skill implements SchemeHandler {
+import { type SkillTree } from "@plurnk/plurnk-agent-skills";
+import { type FindStatement, type ParsedPath } from "@plurnk/plurnk-contracts";
+import { type ByteSource, type EntryAddress, type EntryCoordinate, type RepresentationPreparationRequest, type RepresentationPreparationResult, type SchemeHandler, type SchemeManifest } from "@plurnk/plurnk-schemes";
+import { CoreSchemeAdapterBase, type CoreSchemeCallContext } from "../core/CoreSchemeServices.ts";
+import { type FindResult } from "./_entry-find.ts";
+export default class Skill extends CoreSchemeAdapterBase implements SchemeHandler {
+    #private;
     static manifest: SchemeManifest;
-    editBatch(statements: readonly ResolvedEditStatement[], ctx: SchemeCtx): Promise<EntryEditResult>;
-    edit(statement: ResolvedEditStatement, ctx: SchemeCtx): Promise<EntryEditResult>;
-    send(statement: SendStatement, ctx: SchemeCtx): Promise<SchemeResult>;
-    find(statement: FindStatement, ctx: SchemeCtx): Promise<EntryFindResult>;
+    constructor(trees: (workspaceId: number) => ReadonlyMap<string, SkillTree>);
+    resolveEntryAddress(target: ParsedPath, ctx: CoreSchemeCallContext): Promise<EntryAddress | null>;
+    byteSource({ authority, pathname }: EntryCoordinate, ctx: CoreSchemeCallContext): ByteSource;
+    prepareRepresentation(request: RepresentationPreparationRequest, ctx: CoreSchemeCallContext): Promise<RepresentationPreparationResult>;
+    find(statement: FindStatement, ctx: CoreSchemeCallContext): Promise<FindResult>;
 }
 //# sourceMappingURL=Skill.d.ts.map

package/dist/schemes/Skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Skill.d.ts","sourceRoot":"","sources":["../../src/schemes/Skill.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC9J,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG7E,MAAM,CAAC,OAAO,OAAO,KAAM,YAAW,aAAa;IAC/C,MAAM,CAAC,QAAQ,EAAE,cAAc,CAY7B;IAEI,SAAS,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAGtG;IAEK,IAAI,CAAC,SAAS,EAAE,qBAAqB,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAErF;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAE1E;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAE7E;CACJ"}
+{"version":3,"file":"Skill.d.ts","sourceRoot":"","sources":["../../src/schemes/Skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAc,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3F,OAAO,EAEH,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,EACpC,KAAK,aAAa,EAClB,KAAK,cAAc,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAOlG,OAAkB,EAAmB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI/E,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,qBAAsB,YAAW,aAAa;;IAC7E,MAAM,CAAC,QAAQ,EAAE,cAAc,CAU7B;IAIF,YAAY,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,EAGzE;IAEK,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAItG;IAED,UAAU,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,qBAAqB,GAAG,UAAU,CAG3F;IA+DD,qBAAqB,CAAC,OAAO,EAAE,gCAAgC,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAErI;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6CpF;CACJ"}

package/dist/schemes/Skill.js

@@ -1,35 +1,163 @@
-// PROVISIONAL: this handler delegates to the shared entry operation surface,
-// but its scheme-specific semantics are not yet designed. It is a generic
-// model-writable data scheme, NOT the Agent Skills feature — that surface is
-// worker://~/_plurnk/skills/ ({§skills-functionality}). Its future (rename or
-// retirement) is a separate design ruling.
-import LineAnchors from "../content/line-anchors.js";
-export default class Skill {
+var _a;
+import { SkillResourceError } from "@plurnk/plurnk-agent-skills";
+import { PathSyntax } from "@plurnk/plurnk-contracts";
+import { MimetypeInputLimitError } from "@plurnk/plurnk-mimetypes";
+import { GeneratedByteSource, } from "@plurnk/plurnk-schemes";
+import { CoreSchemeAdapterBase } from "../core/CoreSchemeServices.js";
+import { entryCoordinateOf } from "../core/plurnk-uri.js";
+import FileMaterialization from "../core/file-materialization.js";
+import MimetypeBinary from "../content/mimetype-binary.js";
+import Results from "../core/results.js";
+import EntryCrud from "./_entry-crud.js";
+import EntryFind, { emptyFindFields } from "./_entry-find.js";
+import { pathScope, pathScopeMatches } from "./_path-scope.js";
+// {§skills-resources} The resource tree is truth; entries are demand-loaded projections.
+class Skill extends CoreSchemeAdapterBase {
     static manifest = {
         name: "skill",
-        channels: { body: "text/markdown" },
+        authority: "resource",
+        channels: {},
         defaultChannel: "body",
         category: "data",
-        entryOwner: "worker",
-        inherit: "snapshot",
-        writableBy: ["model", "client"],
+        writableBy: ["_plurnk", "plugin"],
         volatile: false,
-        modelVisible: true,
         folderScopes: true,
-        textEditScopes: true,
+        modelVisible: true,
     };
-    async editBatch(statements, ctx) {
-        LineAnchors.assertResolved(statements);
-        return ctx.entries.operations.editBatch(statements);
+    #trees;
+    constructor(trees) {
+        super();
+        this.#trees = trees;
+    }
+    async resolveEntryAddress(target, ctx) {
+        const address = entryCoordinateOf(target, "resource");
+        const trees = this.#trees(ctx.workspaceId);
+        return PathSyntax.hasGlob(address.authority) || trees.has(address.authority) ? address : null;
+    }
+    byteSource({ authority, pathname }, ctx) {
+        return this.#trees(ctx.workspaceId).get(authority)?.resource(pathname.replace(/^\//u, ""))
+            ?? new GeneratedByteSource(async () => null);
+    }
+    static #refusal(cause, address) {
+        const target = `skill://${address.authority}${address.pathname}`;
+        if (cause?.code === "ENOENT") {
+            return Results.failure("scheme:skill", "entry-not-found", 404, `No skill resource exists at ${target}.`, {}, { target });
+        }
+        if (cause instanceof SkillResourceError) {
+            const outside = cause.code === "SKILL_PATH_OUTSIDE_ROOT";
+            return Results.failure("scheme:skill", outside ? "resource-outside-root" : "resource-invalid", outside ? 403 : 400, cause.message, {}, { target });
+        }
+        throw cause;
+    }
+    async #materialize(address, core) {
+        try {
+            const source = this.byteSource(address, core);
+            const size = await source.size();
+            if (size === null)
+                return _a.#refusal({ code: "ENOENT" }, address);
+            const mimetypes = core.mimetypes;
+            if (mimetypes === undefined)
+                throw new Error("Skill requires the configured mimetype registry.");
+            const mimetype = await FileMaterialization.detectSourceMimetype(address.pathname, source, mimetypes);
+            let content = "";
+            let outputMimetype = mimetype;
+            let attributes = {};
+            if (await MimetypeBinary.isBinaryMimetype(mimetype, mimetypes)) {
+                let metadata = { mimetype };
+                try {
+                    const projected = await mimetypes.projectReadableStream(_a.#chunks(source, size), mimetype);
+                    if (projected !== null) {
+                        content = projected.content;
+                        outputMimetype = "text/markdown";
+                        metadata = { mimetype: projected.sourceMimetype, facts: projected.facts };
+                    }
+                }
+                catch (cause) {
+                    if (!(cause instanceof MimetypeInputLimitError))
+                        throw cause;
+                    metadata = { mimetype, maximumBytes: cause.maximumBytes, observedBytes: cause.observedBytes };
+                }
+                attributes = { sourceProjection: metadata };
+            }
+            else {
+                const materialization = FileMaterialization.classify(size);
+                if (materialization.disposition === "input-limit") {
+                    const rejection = FileMaterialization.rejection(`skill://${address.authority}${address.pathname}`, materialization);
+                    return Results.failure("scheme:skill", rejection.code, rejection.status, rejection.detail, {}, rejection.extensions);
+                }
+                content = new TextDecoder().decode(await source.read(1, size));
+            }
+            const written = await EntryCrud.writeEntry(address, {
+                channels: { body: { content, mimetype: outputMimetype } },
+                attributes,
+            }, core, "skill");
+            return written.status >= 400 ? written : { status: 200 };
+        }
+        catch (cause) {
+            return _a.#refusal(cause, address);
+        }
     }
-    async edit(statement, ctx) {
-        return this.editBatch([statement], ctx);
+    static async *#chunks(source, size) {
+        for (let start = 1; start <= size; start += 65536) {
+            yield await source.read(start, Math.min(start + 65535, size));
+        }
     }
-    async send(statement, ctx) {
-        return ctx.entries.operations.send(statement);
+    prepareRepresentation(request, ctx) {
+        return this.#materialize(request, this.coreContext(ctx));
     }
     async find(statement, ctx) {
-        return ctx.entries.operations.find(statement);
+        const core = this.coreContext(ctx);
+        if (statement.target === null)
+            return { ...emptyFindFields(), ...Results.failure("scheme:skill", "target-required", 400, "FIND requires a skill resource target.") };
+        const coordinate = entryCoordinateOf(statement.target, "resource");
+        const authorityScope = pathScope(coordinate.authority, false);
+        const scope = pathScope(coordinate.pathname, true);
+        const inScope = (pathname) => scope.kind === "glob" && scope.shallowPrefix !== null
+            ? pathname.startsWith(scope.shallowPrefix)
+            : pathScopeMatches(scope, pathname);
+        const trees = this.#trees(core.workspaceId);
+        const available = new Set();
+        for (const [authority, tree] of trees) {
+            if (!pathScopeMatches(authorityScope, authority))
+                continue;
+            try {
+                const paths = scope.kind === "exact"
+                    ? [scope.pathname.replace(/^\//u, "")]
+                    : await tree.list();
+                for (const relative of paths) {
+                    const pathname = `/${relative}`;
+                    // A shallow FIND also needs deeper names for its folder summaries.
+                    if (!inScope(pathname))
+                        continue;
+                    const prepared = await this.#materialize({ authority, pathname }, core);
+                    if (prepared.status === 404)
+                        continue;
+                    if (prepared.status !== 200)
+                        return { ...emptyFindFields(), ...prepared };
+                    available.add(`${authority}\0${pathname}`);
+                }
+            }
+            catch (cause) {
+                return { ...emptyFindFields(), ..._a.#refusal(cause, { authority, pathname: coordinate.pathname }) };
+            }
+        }
+        const cached = await core.db.find_workspace_entry_candidate_ids.all({
+            workspace_id: core.workspaceId, scheme: "skill",
+            authority: null, scope_prefix: null, channel: "body",
+        });
+        for (const address of cached) {
+            if (!trees.has(address.authority)
+                || (pathScopeMatches(authorityScope, address.authority)
+                    && inScope(address.pathname)
+                    && !available.has(`${address.authority}\0${address.pathname}`))) {
+                await EntryCrud.deleteEntry(address, core, "skill");
+            }
+        }
+        return EntryFind.findWorkspaceEntries(statement, core, _a.manifest, {
+            bytes: (pathname, authority) => this.byteSource({ authority, pathname }, core),
+        });
     }
 }
+_a = Skill;
+export default Skill;
 //# sourceMappingURL=Skill.js.map

package/dist/schemes/Skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"Skill.js","sourceRoot":"","sources":["../../src/schemes/Skill.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,8EAA8E;AAC9E,2CAA2C;AAI3C,OAAO,WAAW,MAAM,4BAA4B,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,KAAK;IACtB,MAAM,CAAC,QAAQ,GAAmB;QAC9B,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;QACnC,cAAc,EAAE,MAAM;QACtB,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,QAAQ;QACpB,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC/B,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;KACvB,CAAC;IAEF,KAAK,CAAC,SAAS,CAAC,UAA4C,EAAE,GAAc;QACxE,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACvC,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAgC,EAAE,GAAc;QACvD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAc;QAC/C,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAwB,EAAE,GAAc;QAC/C,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACJ"}
+{"version":3,"file":"Skill.js","sourceRoot":"","sources":["../../src/schemes/Skill.ts"],"names":[],"mappings":"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"}