@vellumai/assistant 0.10.3-dev.202606291709.2b4d83d → 0.10.3-dev.202606291850.7e0a3f7

package/openapi.yaml

@@ -4152,6 +4152,15 @@ paths:
                       properties:
                         channel:
                           type: string
+                          enum:
+                            - telegram
+                            - phone
+                            - vellum
+                            - whatsapp
+                            - slack
+                            - email
+                            - platform
+                            - a2a
                         ready:
                           type: boolean
                         setupStatus:
@@ -4230,14 +4239,20 @@ paths:
               type: object
               properties:
                 channel:
-                  type: string
                   description: Optional channel ID to refresh
+                  type: string
+                  enum:
+                    - telegram
+                    - phone
+                    - vellum
+                    - whatsapp
+                    - slack
+                    - email
+                    - platform
+                    - a2a
                 includeRemote:
-                  type: boolean
                   description: Include remote checks (default true)
-              required:
-                - channel
-                - includeRemote
+                  type: boolean
       responses:
         "200":
           description: Successful response
@@ -4255,6 +4270,15 @@ paths:
                       properties:
                         channel:
                           type: string
+                          enum:
+                            - telegram
+                            - phone
+                            - vellum
+                            - whatsapp
+                            - slack
+                            - email
+                            - platform
+                            - a2a
                         ready:
                           type: boolean
                         setupStatus:
@@ -24289,7 +24313,7 @@ paths:
           required: false
           schema:
             type: string
-          description: Filter by skill origin (e.g. 'vellum', 'clawhub', 'skillssh', 'custom').
+          description: Filter by skill origin (e.g. 'vellum', 'clawhub', 'skillssh', 'custom', 'assistant-memory').
         - name: kind
           in: query
           required: false
@@ -24591,6 +24615,60 @@ paths:
                             - category
                             - origin
                           additionalProperties: false
+                        - type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            icon:
+                              type: string
+                            emoji:
+                              type: string
+                            kind:
+                              type: string
+                              enum:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
+                              type: string
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            category:
+                              type: string
+                            owner:
+                              type: object
+                              properties:
+                                kind:
+                                  type: string
+                                  enum:
+                                    - skill
+                                    - mcp
+                                    - plugin
+                                    - workspace
+                                id:
+                                  type: string
+                              required:
+                                - kind
+                                - id
+                              additionalProperties: false
+                            origin:
+                              type: string
+                              const: assistant-memory
+                          required:
+                            - id
+                            - name
+                            - description
+                            - kind
+                            - status
+                            - category
+                            - origin
+                          additionalProperties: false
                       type: object
                     description: Skill objects
                   categoryCounts:
@@ -24976,6 +25054,60 @@ paths:
                           - category
                           - origin
                         additionalProperties: false
+                      - type: object
+                        properties:
+                          id:
+                            type: string
+                          name:
+                            type: string
+                          description:
+                            type: string
+                          icon:
+                            type: string
+                          emoji:
+                            type: string
+                          kind:
+                            type: string
+                            enum:
+                              - bundled
+                              - installed
+                              - catalog
+                          status:
+                            type: string
+                            enum:
+                              - enabled
+                              - disabled
+                              - available
+                          category:
+                            type: string
+                          owner:
+                            type: object
+                            properties:
+                              kind:
+                                type: string
+                                enum:
+                                  - skill
+                                  - mcp
+                                  - plugin
+                                  - workspace
+                              id:
+                                type: string
+                            required:
+                              - kind
+                              - id
+                            additionalProperties: false
+                          origin:
+                            type: string
+                            const: assistant-memory
+                        required:
+                          - id
+                          - name
+                          - description
+                          - kind
+                          - status
+                          - category
+                          - origin
+                        additionalProperties: false
                     description: Skill detail object
                     type: object
                 required:
@@ -25376,6 +25508,60 @@ paths:
                           - category
                           - origin
                         additionalProperties: false
+                      - type: object
+                        properties:
+                          id:
+                            type: string
+                          name:
+                            type: string
+                          description:
+                            type: string
+                          icon:
+                            type: string
+                          emoji:
+                            type: string
+                          kind:
+                            type: string
+                            enum:
+                              - bundled
+                              - installed
+                              - catalog
+                          status:
+                            type: string
+                            enum:
+                              - enabled
+                              - disabled
+                              - available
+                          category:
+                            type: string
+                          owner:
+                            type: object
+                            properties:
+                              kind:
+                                type: string
+                                enum:
+                                  - skill
+                                  - mcp
+                                  - plugin
+                                  - workspace
+                              id:
+                                type: string
+                            required:
+                              - kind
+                              - id
+                            additionalProperties: false
+                          origin:
+                            type: string
+                            const: assistant-memory
+                        required:
+                          - id
+                          - name
+                          - description
+                          - kind
+                          - status
+                          - category
+                          - origin
+                        additionalProperties: false
                     description: Skill metadata
                     type: object
                   files:
@@ -25963,6 +26149,60 @@ paths:
                             - category
                             - origin
                           additionalProperties: false
+                        - type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            icon:
+                              type: string
+                            emoji:
+                              type: string
+                            kind:
+                              type: string
+                              enum:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
+                              type: string
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            category:
+                              type: string
+                            owner:
+                              type: object
+                              properties:
+                                kind:
+                                  type: string
+                                  enum:
+                                    - skill
+                                    - mcp
+                                    - plugin
+                                    - workspace
+                                id:
+                                  type: string
+                              required:
+                                - kind
+                                - id
+                              additionalProperties: false
+                            origin:
+                              type: string
+                              const: assistant-memory
+                          required:
+                            - id
+                            - name
+                            - description
+                            - kind
+                            - status
+                            - category
+                            - origin
+                          additionalProperties: false
                       type: object
                     description: Skill objects matching the search query
                 required:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.10.3-dev.202606291709.2b4d83d",
+  "version": "0.10.3-dev.202606291850.7e0a3f7",
   "license": "MIT",
   "type": "module",
   "exports": {

package/src/__tests__/clawhub.test.ts

@@ -130,6 +130,10 @@ describe("clawhubInstall staging", () => {
         "# Staged Skill\n",
       );
       expect(existsSync(join(stagedSkillDir, "install-meta.json"))).toBe(true);
+      const meta = JSON.parse(
+        readFileSync(join(stagedSkillDir, "install-meta.json"), "utf-8"),
+      ) as SkillInstallMeta;
+      expect(meta.author).toBe("user");
     } finally {
       Bun.spawn = originalSpawn;
       rmSync(projectRoot, { recursive: true, force: true });

package/src/__tests__/conversation-app-control-instantiation.test.ts

@@ -201,6 +201,7 @@ mock.module("../skills/catalog-cache.js", () => ({
 }));
 mock.module("../skills/install-meta.js", () => ({
   readInstallMeta: () => null,
+  touchSkillLastUsed: () => false,
 }));
 mock.module("../telemetry/skill-loaded-events-store.js", () => ({
   recordSkillLoadedEvent: () => {},

package/src/__tests__/conversation-skill-tools.test.ts

@@ -38,6 +38,8 @@ let recordedSkillLoadedEvents: SkillLoadedEventRecord[] = [];
 let mockRecordSkillLoadedFailure = false;
 /** Skill IDs for which registerSkillTools throws (simulates a different-owner tool name collision). */
 let mockRegisterFailures: Set<string> = new Set();
+/** `(skillDir, today)` pairs captured by the mocked touchSkillLastUsed. */
+let recordedLastUsedTouches: Array<{ skillDir: string; today: string }> = [];
 
 // ---------------------------------------------------------------------------
 // Mocks — must be set up before importing the module under test
@@ -249,6 +251,10 @@ mock.module("../skills/install-meta.js", () => ({
     const skillId = parts[parts.length - 1];
     return mockInstallMetas[skillId] ?? null;
   },
+  touchSkillLastUsed: (skillDir: string, today: string) => {
+    recordedLastUsedTouches.push({ skillDir, today });
+    return true;
+  },
 }));
 
 mock.module("../skills/catalog-cache.js", () => ({
@@ -1174,6 +1180,153 @@ describe("skill_loaded telemetry recording", () => {
   });
 });
 
+// ---------------------------------------------------------------------------
+// lastUsedAt stamping on managed-skill load
+// ---------------------------------------------------------------------------
+
+describe("lastUsedAt stamping on managed-skill load", () => {
+  let sessionState: Map<string, string>;
+
+  // The projection layer computes `today` from the local clock; mirror that
+  // expression so the assertion stays correct regardless of the run date.
+  const expectedToday = new Date().toLocaleDateString("en-CA");
+
+  beforeEach(() => {
+    mockCatalog = [];
+    mockManifests = {};
+    mockRegisteredTools = new Map();
+    mockUnregisteredSkillIds = [];
+    mockSkillRefCount = new Map();
+    mockVersionHashes = {};
+    mockVersionHashErrors = new Set();
+    mockInstallMetas = {};
+    recordedSkillLoadedEvents = [];
+    recordedLastUsedTouches = [];
+    sessionState = new Map<string, string>();
+  });
+
+  test("managed skill load stamps lastUsedAt with today's date and its directory", () => {
+    mockCatalog = [makeSkill("homemade")];
+    mockManifests = { homemade: makeManifest(["hm_run"]) };
+    mockInstallMetas = {
+      homemade: { origin: "custom", installedAt: "2026-01-01T00:00:00Z" },
+    };
+
+    const history: Message[] = [
+      ...skillLoadMessages('<loaded_skill id="homemade" />'),
+    ];
+    projectSkillTools(history, { previouslyActiveSkillIds: sessionState });
+
+    expect(recordedLastUsedTouches).toEqual([
+      { skillDir: "/skills/homemade", today: expectedToday },
+    ]);
+  });
+
+  test("stamps managed skills even when telemetry is off (ungated)", () => {
+    // origin: "custom" is suppressed for telemetry but must still be stamped.
+    mockCatalog = [makeSkill("homemade")];
+    mockManifests = { homemade: makeManifest(["hm_run"]) };
+    mockInstallMetas = {
+      homemade: { origin: "custom", installedAt: "2026-01-01T00:00:00Z" },
+    };
+
+    const history: Message[] = [
+      ...skillLoadMessages('<loaded_skill id="homemade" />'),
+    ];
+    // No telemetry option passed.
+    projectSkillTools(history, { previouslyActiveSkillIds: sessionState });
+
+    expect(recordedSkillLoadedEvents).toHaveLength(0);
+    expect(recordedLastUsedTouches).toHaveLength(1);
+    expect(recordedLastUsedTouches[0].skillDir).toBe("/skills/homemade");
+  });
+
+  test("instruction-only managed skill (no TOOLS.json) is stamped", () => {
+    mockCatalog = [makeSkill("catalog-skill")];
+    // No manifest — instruction-only managed skill.
+    mockInstallMetas = {
+      "catalog-skill": {
+        origin: "vellum",
+        installedAt: "2026-01-01T00:00:00Z",
+      },
+    };
+
+    const history: Message[] = [
+      ...skillLoadMessages('<loaded_skill id="catalog-skill" />'),
+    ];
+    projectSkillTools(history, { previouslyActiveSkillIds: sessionState });
+
+    expect(recordedLastUsedTouches).toEqual([
+      { skillDir: "/skills/catalog-skill", today: expectedToday },
+    ]);
+  });
+
+  test("bundled skills are NOT stamped", () => {
+    mockCatalog = [makeSkill("notes", undefined, "bundled")];
+    mockManifests = { notes: makeManifest(["notes_add"]) };
+
+    const history: Message[] = [
+      ...skillLoadMessages('<loaded_skill id="notes" />'),
+    ];
+    projectSkillTools(history, {
+      previouslyActiveSkillIds: sessionState,
+      telemetry: { conversationId: "conv-xyz", attribution: null },
+    });
+
+    // Telemetry still fires for the bundled skill, but no usage stamp.
+    expect(recordedSkillLoadedEvents).toHaveLength(1);
+    expect(recordedLastUsedTouches).toHaveLength(0);
+  });
+
+  test("workspace skills are NOT stamped", () => {
+    mockCatalog = [makeSkill("local-helper", undefined, "workspace")];
+    mockManifests = { "local-helper": makeManifest(["lh_run"]) };
+
+    const history: Message[] = [
+      ...skillLoadMessages('<loaded_skill id="local-helper" />'),
+    ];
+    projectSkillTools(history, { previouslyActiveSkillIds: sessionState });
+
+    expect(recordedLastUsedTouches).toHaveLength(0);
+  });
+
+  test("a still-active skill on a later turn does not re-stamp", () => {
+    mockCatalog = [makeSkill("homemade")];
+    mockManifests = { homemade: makeManifest(["hm_run"]) };
+    mockInstallMetas = {
+      homemade: { origin: "custom", installedAt: "2026-01-01T00:00:00Z" },
+    };
+
+    const history: Message[] = [
+      ...skillLoadMessages('<loaded_skill id="homemade" />'),
+    ];
+    projectSkillTools(history, { previouslyActiveSkillIds: sessionState });
+    projectSkillTools(history, { previouslyActiveSkillIds: sessionState });
+
+    // Stamping rides the same load events as telemetry — once per activation.
+    expect(recordedLastUsedTouches).toHaveLength(1);
+  });
+
+  test("version-hash change re-registers and re-stamps the managed skill", () => {
+    mockCatalog = [makeSkill("homemade")];
+    mockManifests = { homemade: makeManifest(["hm_run"]) };
+    mockInstallMetas = {
+      homemade: { origin: "custom", installedAt: "2026-01-01T00:00:00Z" },
+    };
+    mockVersionHashes = { homemade: "v1:hash-aaa" };
+
+    const history: Message[] = [
+      ...skillLoadMessages('<loaded_skill id="homemade" />'),
+    ];
+    projectSkillTools(history, { previouslyActiveSkillIds: sessionState });
+
+    mockVersionHashes = { homemade: "v1:hash-bbb" };
+    projectSkillTools(history, { previouslyActiveSkillIds: sessionState });
+
+    expect(recordedLastUsedTouches).toHaveLength(2);
+  });
+});
+
 // ---------------------------------------------------------------------------
 // resolveTools callback integration tests
 // ---------------------------------------------------------------------------

package/src/__tests__/injector-v3-suppression.test.ts

@@ -55,10 +55,14 @@ mock.module("../plugins/injector-registry.js", () => ({
 }));
 
 // `applyRuntimeInjections` reads the v3-live gate (`config.memory.v3.live`)
-// via `isMemoryV3Live`; drive it directly through this slot per-test.
+// via `isMemoryV3Live`; drive it directly through this slot per-test. The
+// import graph also pulls `isProcToSkillsActive` (the permission policy-context
+// precomputes the proc-to-skills gate), so the wholesale mock must expose it —
+// keyed off the same v3-live slot.
 let memoryV3LiveSlot = false;
 mock.module("../config/memory-v3-gate.js", () => ({
   isMemoryV3Live: () => memoryV3LiveSlot,
+  isProcToSkillsActive: () => false,
 }));
 
 const { applyRuntimeInjections } =

package/src/__tests__/install-meta.test.ts

@@ -15,6 +15,7 @@ import {
   computeSkillHash,
   readInstallMeta,
   type SkillInstallMeta,
+  touchSkillLastUsed,
   writeInstallMeta,
 } from "../skills/install-meta.js";
 
@@ -108,6 +109,36 @@ describe("writeInstallMeta", () => {
     expect(parsed.contentHash).toBe("v2:abc123def456");
   });
 
+  test("round-trips optional author and lastUsedAt fields", () => {
+    const dir = makeTempDir();
+    const meta: SkillInstallMeta = {
+      origin: "custom",
+      installedAt: "2026-01-15T10:30:00.000Z",
+      author: "user",
+      lastUsedAt: "2026-02-01",
+    };
+
+    writeInstallMeta(dir, meta);
+
+    const result = readInstallMeta(dir);
+    expect(result).not.toBeNull();
+    expect(result!.author).toBe("user");
+    expect(result!.lastUsedAt).toBe("2026-02-01");
+  });
+
+  test("leaves author and lastUsedAt unset when omitted", () => {
+    const dir = makeTempDir();
+    writeInstallMeta(dir, {
+      origin: "custom",
+      installedAt: "2026-01-15T10:30:00.000Z",
+    });
+
+    const result = readInstallMeta(dir);
+    expect(result).not.toBeNull();
+    expect(result!.author).toBeUndefined();
+    expect(result!.lastUsedAt).toBeUndefined();
+  });
+
   test("overwrites existing install-meta.json", () => {
     const dir = makeTempDir();
     writeInstallMeta(dir, {
@@ -327,6 +358,79 @@ describe("readInstallMeta", () => {
   });
 });
 
+// ─── touchSkillLastUsed ─────────────────────────────────────────────────────
+
+describe("touchSkillLastUsed", () => {
+  function lastUsedDate(dir: string): string | undefined {
+    return readInstallMeta(dir)?.lastUsedAt?.slice(0, 10);
+  }
+
+  test("returns false and writes nothing when install metadata is absent", () => {
+    const dir = makeTempDir();
+    expect(touchSkillLastUsed(dir, "2026-06-22")).toBe(false);
+    expect(existsSync(join(dir, "install-meta.json"))).toBe(false);
+  });
+
+  test("first stamp writes today's date and returns true", () => {
+    const dir = makeTempDir();
+    writeInstallMeta(dir, {
+      origin: "custom",
+      installedAt: "2026-01-15T10:30:00.000Z",
+      author: "assistant",
+    });
+
+    expect(touchSkillLastUsed(dir, "2026-06-22")).toBe(true);
+    expect(lastUsedDate(dir)).toBe("2026-06-22");
+    // Existing fields are preserved.
+    const meta = readInstallMeta(dir);
+    expect(meta!.origin).toBe("custom");
+    expect(meta!.author).toBe("assistant");
+    expect(meta!.installedAt).toBe("2026-01-15T10:30:00.000Z");
+    // The stamp is a full ISO timestamp, not a bare date.
+    expect(meta!.lastUsedAt).toBe("2026-06-22T00:00:00.000Z");
+  });
+
+  test("second stamp on the same day is a no-op (debounced)", () => {
+    const dir = makeTempDir();
+    writeInstallMeta(dir, {
+      origin: "custom",
+      installedAt: "2026-01-15T10:30:00.000Z",
+      lastUsedAt: "2026-06-22T08:00:00.000Z",
+    });
+
+    expect(touchSkillLastUsed(dir, "2026-06-22")).toBe(false);
+    // The existing timestamp is untouched.
+    expect(readInstallMeta(dir)!.lastUsedAt).toBe("2026-06-22T08:00:00.000Z");
+  });
+
+  test("stamp on a later day rewrites lastUsedAt", () => {
+    const dir = makeTempDir();
+    writeInstallMeta(dir, {
+      origin: "custom",
+      installedAt: "2026-01-15T10:30:00.000Z",
+      lastUsedAt: "2026-06-22T08:00:00.000Z",
+    });
+
+    expect(touchSkillLastUsed(dir, "2026-06-23")).toBe(true);
+    expect(lastUsedDate(dir)).toBe("2026-06-23");
+  });
+
+  test("stamps over a malformed install-meta.json via legacy version.json fallback", () => {
+    const dir = makeTempDir();
+    writeFileSync(join(dir, "install-meta.json"), "{bad json", "utf-8");
+    writeFileSync(
+      join(dir, "version.json"),
+      JSON.stringify({ version: "1.0.0" }),
+      "utf-8",
+    );
+
+    expect(touchSkillLastUsed(dir, "2026-06-22")).toBe(true);
+    const meta = readInstallMeta(dir);
+    expect(meta!.origin).toBe("vellum");
+    expect(meta!.lastUsedAt).toBe("2026-06-22T00:00:00.000Z");
+  });
+});
+
 // ─── computeSkillHash ───────────────────────────────────────────────────────
 
 describe("computeSkillHash", () => {