@skillsmith/core 0.9.0 → 0.10.0

package/dist/src/sync/inventory-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"inventory-types.js","sourceRoot":"","sources":["../../../src/sync/inventory-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,GAAG;IACd,oBAAoB,EAAE,GAAG;IACzB,iBAAiB,EAAE,EAAE;IACrB,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,EAAE;IACZ,eAAe,EAAE,EAAE;IACnB,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,GAAG;IACjB,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,GAAG;IACf,gBAAgB,EAAE,GAAG;IACrB,kBAAkB,EAAE,EAAE;IACtB,iBAAiB,EAAE,EAAE;CACb,CAAA;AAEV,wEAAwE;AACxE,MAAM,CAAC,MAAM,yBAAyB,GAAqC;IACzE,MAAM;IACN,QAAQ;IACR,OAAO;CACC,CAAA"}
+{"version":3,"file":"inventory-types.js","sourceRoot":"","sources":["../../../src/sync/inventory-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA4EH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,GAAG;IACd,oBAAoB,EAAE,GAAG;IACzB,iBAAiB,EAAE,EAAE;IACrB,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,EAAE;IACZ,eAAe,EAAE,EAAE;IACnB,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,GAAG;IACjB,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,GAAG;IACf,UAAU,EAAE,GAAG;IACf,WAAW,EAAE,EAAE;IACf,cAAc,EAAE,GAAG;IACnB,gBAAgB,EAAE,GAAG;IACrB,kBAAkB,EAAE,EAAE;IACtB,iBAAiB,EAAE,EAAE;CACb,CAAA;AAEV,wEAAwE;AACxE,MAAM,CAAC,MAAM,yBAAyB,GAAqC;IACzE,MAAM;IACN,QAAQ;IACR,OAAO;CACC,CAAA"}

package/dist/src/telemetry/agent-marker.d.ts

@@ -0,0 +1,137 @@
+/**
+ * SMI-5456: Agent-mediation marker channel.
+ *
+ * Wave 1 needs to distinguish agent-mediated skill invocations from ambient
+ * ones so the mediation gate (≥25% agent-mediated share by day 30) is
+ * measurable. Two channels feed the three per-event telemetry fields
+ * (`agent_session`, `nudge_origin`, `trigger_id`) plus the per-harness
+ * `framework` attribution (via the vocabulary-validated `harness` hint —
+ * the mediation dashboard's per-harness denominator):
+ *
+ *  1. MCP `_meta` on the tool call (spec-clean; wins when present). No Tier-1
+ *     harness can inject `_meta` on a genuine agent tool call today (Step-0
+ *     spike (e)) — hooks only touch `arguments`, the model has no `_meta`
+ *     schema affordance — so this is forward-looking infrastructure that
+ *     activates the day a harness ships native support.
+ *  2. A session-scoped marker file written by a harness SessionStart hook
+ *     under `~/.skillsmith/agent-markers/` (PRIMARY channel for Wave 1). The
+ *     server treats these files as READ-ONLY: it never writes, updates, or
+ *     deletes them (that is the hook's job at SessionEnd). Stale files that a
+ *     crashed session left behind expire by a session TTL.
+ *
+ * A missing / corrupt / expired file is simply "no marker" — never an error.
+ */
+/** On-disk marker schema version — bump on a breaking shape change. */
+export declare const AGENT_MARKER_SCHEMA_VERSION = 1;
+/**
+ * Session TTL. A marker older than this (measured from its `started_at`) is
+ * ignored as stale.
+ *
+ * Rationale for 12h: the primary staleness control is the hook deleting its
+ * own file at SessionEnd; the TTL only backstops a session that crashed
+ * without cleanup. 12h comfortably spans a long interactive working day so a
+ * genuinely live session is never expired mid-flight, while still ensuring a
+ * marker abandoned by a crash cannot mislabel invocations a day or more later.
+ */
+export declare const AGENT_MARKER_TTL_MS: number;
+/**
+ * Max bytes read from a single marker file.
+ *
+ * `readSessionMarker` runs synchronously on the MCP dispatch hot path (every
+ * tool call). A well-formed marker is a handful of scalar fields — a few
+ * hundred bytes; 16 KiB is generous headroom. Without this cap a corrupt or
+ * hostile file of unbounded size would block the event loop for the full
+ * synchronous `readFileSync` + `JSON.parse` on every single tool call until
+ * the hook cleans it up (or the TTL elapses, which only affects staleness,
+ * not the read cost). Oversized files are treated as corrupt: skipped, never
+ * thrown.
+ */
+export declare const AGENT_MARKER_MAX_FILE_BYTES: number;
+/**
+ * Accepted `harness` vocabulary — the SMI-5012 wire format's `framework` enum
+ * (authoritative list: skill-invoke-telemetry-guide.md § Wire format) minus
+ * `'unknown'`. `'unknown'` is the extractor's absence fallback, not a value a
+ * marker may assert: accepting it would let a marker file overwrite a real
+ * extractor result with noise. Anything outside this set (junk from disk or
+ * `_meta`) resolves to `undefined` and never flows into telemetry.
+ */
+export declare const KNOWN_HARNESS_FRAMEWORKS: readonly ["claude-code", "cursor", "continue", "cline", "copilot", "windsurf", "codex", "vscode", "opencode", "hermes"];
+/** A validated harness/framework value from the marker channel. */
+export type HarnessFramework = (typeof KNOWN_HARNESS_FRAMEWORKS)[number];
+/** The "no marker present" resolution — all fields at their neutral default. */
+export declare const NO_AGENT_MARKER: AgentMarker;
+/**
+ * Resolved marker — the three per-event fields threaded into the telemetry
+ * payload. Always fully populated (neutral defaults when no marker resolves).
+ */
+export interface AgentMarker {
+    /** True when the invocation is part of an agent-mediated session. */
+    agentSession: boolean;
+    /** True when the invocation originated from a nudge (job-9 onboarding). */
+    nudgeOrigin: boolean;
+    /** Paywall / nudge trigger id, or `null` when none applies. */
+    triggerId: string | null;
+    /**
+     * Validated harness identity from the marker channel (the file's `harness`
+     * hint or `_meta.harness`). Feeds the event's `framework` field when the
+     * per-call extractor has nothing better (see wrap.ts). Absent when the
+     * channel supplied no value or an out-of-vocabulary one.
+     */
+    harness?: HarnessFramework;
+}
+/**
+ * On-disk marker file shape (snake_case to match the telemetry wire format).
+ * Written by a harness SessionStart hook; only ever READ by the server.
+ */
+export interface AgentMarkerFile {
+    /** Schema version (see `AGENT_MARKER_SCHEMA_VERSION`). */
+    schema?: number;
+    /** Harness session identifier (the hook's `session_id`). */
+    session_id: string;
+    /** Epoch-ms session start; the TTL is measured from this. */
+    started_at: number;
+    /** Optional harness hint, e.g. `'claude-code'`, `'cursor'`, `'opencode'`. */
+    harness?: string;
+    /** Agent session? Defaults true for a valid marker; set false to opt out. */
+    agent_session?: boolean;
+    /** Nudge-originated? Defaults false. */
+    nudge_origin?: boolean;
+    /** Trigger id, or null. Defaults null. */
+    trigger_id?: string | null;
+}
+/**
+ * Read the freshest non-expired session marker from `~/.skillsmith/agent-markers/`.
+ *
+ * Wave-1 correlation note: the server cannot know its own harness session id,
+ * so it selects the most recently started live marker. Concurrent sessions on
+ * one machine may therefore observe each other's marker — an accepted,
+ * documented imprecision (the `_meta` channel is exact and wins when present).
+ *
+ * @returns the resolved marker, or null when no live marker exists.
+ */
+export declare function readSessionMarker(opts?: {
+    now?: number;
+}): AgentMarker | null;
+/**
+ * Defensively extract the marker fields from an MCP request's `_meta`.
+ *
+ * `_meta` is a loose passthrough schema (SDK 1.29.0), so junk keys and wrong
+ * types must be ignored. Keys are snake_case to match the wire format:
+ * `agent_session`, `nudge_origin`, `trigger_id`, `harness`. Only well-typed
+ * values are returned; everything else is dropped (`harness` additionally
+ * gated on the `KNOWN_HARNESS_FRAMEWORKS` vocabulary).
+ */
+export declare function extractMarkerMeta(meta: unknown): Partial<AgentMarker>;
+/**
+ * Resolve the agent marker for a single tool call.
+ *
+ * Per-field precedence: a value present in `_meta` wins; otherwise the session
+ * marker file supplies it; otherwise the neutral default (`false`/`false`/`null`).
+ *
+ * @param meta - the MCP request's `_meta` object (or undefined).
+ * @param opts.now - injectable clock for tests.
+ */
+export declare function resolveAgentMarker(meta: unknown, opts?: {
+    now?: number;
+}): AgentMarker;
+//# sourceMappingURL=agent-marker.d.ts.map

package/dist/src/telemetry/agent-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-marker.d.ts","sourceRoot":"","sources":["../../../src/telemetry/agent-marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAUH,uEAAuE;AACvE,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAE5C;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,QAAsB,CAAA;AAEtD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,QAAY,CAAA;AAEpD;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,yHAW3B,CAAA;AAEV,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAA;AAWxE,gFAAgF;AAChF,eAAO,MAAM,eAAe,EAAE,WAI5B,CAAA;AAMF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,YAAY,EAAE,OAAO,CAAA;IACrB,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAA;IACpB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,wCAAwC;IACxC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAkFD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,GAAG,IAAI,CAoBjF;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAWrE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,CAS1F"}

package/dist/src/telemetry/agent-marker.js

@@ -0,0 +1,242 @@
+/**
+ * SMI-5456: Agent-mediation marker channel.
+ *
+ * Wave 1 needs to distinguish agent-mediated skill invocations from ambient
+ * ones so the mediation gate (≥25% agent-mediated share by day 30) is
+ * measurable. Two channels feed the three per-event telemetry fields
+ * (`agent_session`, `nudge_origin`, `trigger_id`) plus the per-harness
+ * `framework` attribution (via the vocabulary-validated `harness` hint —
+ * the mediation dashboard's per-harness denominator):
+ *
+ *  1. MCP `_meta` on the tool call (spec-clean; wins when present). No Tier-1
+ *     harness can inject `_meta` on a genuine agent tool call today (Step-0
+ *     spike (e)) — hooks only touch `arguments`, the model has no `_meta`
+ *     schema affordance — so this is forward-looking infrastructure that
+ *     activates the day a harness ships native support.
+ *  2. A session-scoped marker file written by a harness SessionStart hook
+ *     under `~/.skillsmith/agent-markers/` (PRIMARY channel for Wave 1). The
+ *     server treats these files as READ-ONLY: it never writes, updates, or
+ *     deletes them (that is the hook's job at SessionEnd). Stale files that a
+ *     crashed session left behind expire by a session TTL.
+ *
+ * A missing / corrupt / expired file is simply "no marker" — never an error.
+ */
+import { existsSync, lstatSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { getConfigDir } from '../config/index.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** On-disk marker schema version — bump on a breaking shape change. */
+export const AGENT_MARKER_SCHEMA_VERSION = 1;
+/**
+ * Session TTL. A marker older than this (measured from its `started_at`) is
+ * ignored as stale.
+ *
+ * Rationale for 12h: the primary staleness control is the hook deleting its
+ * own file at SessionEnd; the TTL only backstops a session that crashed
+ * without cleanup. 12h comfortably spans a long interactive working day so a
+ * genuinely live session is never expired mid-flight, while still ensuring a
+ * marker abandoned by a crash cannot mislabel invocations a day or more later.
+ */
+export const AGENT_MARKER_TTL_MS = 12 * 60 * 60 * 1000;
+/**
+ * Max bytes read from a single marker file.
+ *
+ * `readSessionMarker` runs synchronously on the MCP dispatch hot path (every
+ * tool call). A well-formed marker is a handful of scalar fields — a few
+ * hundred bytes; 16 KiB is generous headroom. Without this cap a corrupt or
+ * hostile file of unbounded size would block the event loop for the full
+ * synchronous `readFileSync` + `JSON.parse` on every single tool call until
+ * the hook cleans it up (or the TTL elapses, which only affects staleness,
+ * not the read cost). Oversized files are treated as corrupt: skipped, never
+ * thrown.
+ */
+export const AGENT_MARKER_MAX_FILE_BYTES = 16 * 1024;
+/**
+ * Accepted `harness` vocabulary — the SMI-5012 wire format's `framework` enum
+ * (authoritative list: skill-invoke-telemetry-guide.md § Wire format) minus
+ * `'unknown'`. `'unknown'` is the extractor's absence fallback, not a value a
+ * marker may assert: accepting it would let a marker file overwrite a real
+ * extractor result with noise. Anything outside this set (junk from disk or
+ * `_meta`) resolves to `undefined` and never flows into telemetry.
+ */
+export const KNOWN_HARNESS_FRAMEWORKS = [
+    'claude-code',
+    'cursor',
+    'continue',
+    'cline',
+    'copilot',
+    'windsurf',
+    'codex',
+    'vscode',
+    'opencode',
+    'hermes',
+];
+const KNOWN_HARNESS_SET = new Set(KNOWN_HARNESS_FRAMEWORKS);
+/** Validate an untrusted harness value; anything not in the vocabulary → undefined. */
+function validHarness(value) {
+    return typeof value === 'string' && KNOWN_HARNESS_SET.has(value)
+        ? value
+        : undefined;
+}
+/** The "no marker present" resolution — all fields at their neutral default. */
+export const NO_AGENT_MARKER = Object.freeze({
+    agentSession: false,
+    nudgeOrigin: false,
+    triggerId: null,
+});
+// ---------------------------------------------------------------------------
+// Directory resolution (matches getCacheDir override convention, SMI-4577)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve `~/.skillsmith/agent-markers/`.
+ *
+ * `SKILLSMITH_AGENT_MARKER_DIR` overrides the default — mirrors
+ * `SKILLSMITH_CACHE_DIR_OVERRIDE`, needed because macOS `os.homedir()`
+ * resolves via `getpwuid()` and ignores `process.env.HOME` mutations in tests.
+ *
+ * Read-only: this only computes the path, it never creates the directory.
+ */
+function getAgentMarkerDir() {
+    const override = process.env.SKILLSMITH_AGENT_MARKER_DIR;
+    return override && override.length > 0 ? override : join(getConfigDir(), 'agent-markers');
+}
+/**
+ * Read + validate a single marker file. Returns null for anything that is not
+ * a well-formed, non-expired marker (corrupt JSON, wrong shape, missing/invalid
+ * `started_at`, empty `session_id`, past the TTL, not a regular file, or over
+ * `AGENT_MARKER_MAX_FILE_BYTES`). Never throws.
+ */
+function readMarkerFile(path, now) {
+    let raw;
+    try {
+        // `lstatSync` (not `stat`) so a symlink is rejected outright rather than
+        // followed — the directory is documented read-only server-side, so a
+        // symlink here is never something the reader itself created.
+        const stat = lstatSync(path);
+        if (!stat.isFile())
+            return null;
+        if (stat.size > AGENT_MARKER_MAX_FILE_BYTES)
+            return null;
+        raw = readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!data || typeof data !== 'object')
+        return null;
+    const file = data;
+    if (typeof file.session_id !== 'string' || file.session_id.length === 0)
+        return null;
+    const startedAt = file.started_at;
+    if (typeof startedAt !== 'number' || !Number.isFinite(startedAt) || startedAt <= 0)
+        return null;
+    // Expired: older than the TTL. A future timestamp (clock skew) is not stale.
+    if (now - startedAt > AGENT_MARKER_TTL_MS)
+        return null;
+    return { file: file, startedAt };
+}
+/** Map a validated on-disk file to the resolved marker fields. */
+function markerFromFile(file) {
+    return {
+        // A valid marker means "agent session" by presence; honour an explicit opt-out.
+        agentSession: file.agent_session === false ? false : true,
+        nudgeOrigin: file.nudge_origin === true,
+        triggerId: typeof file.trigger_id === 'string' ? file.trigger_id : null,
+        // Vocabulary-gated: junk from disk must not flow into telemetry.
+        harness: validHarness(file.harness),
+    };
+}
+/**
+ * Read the freshest non-expired session marker from `~/.skillsmith/agent-markers/`.
+ *
+ * Wave-1 correlation note: the server cannot know its own harness session id,
+ * so it selects the most recently started live marker. Concurrent sessions on
+ * one machine may therefore observe each other's marker — an accepted,
+ * documented imprecision (the `_meta` channel is exact and wins when present).
+ *
+ * @returns the resolved marker, or null when no live marker exists.
+ */
+export function readSessionMarker(opts = {}) {
+    const now = opts.now ?? Date.now();
+    const dir = getAgentMarkerDir();
+    let names;
+    try {
+        if (!existsSync(dir))
+            return null;
+        names = readdirSync(dir).filter((n) => n.endsWith('.json'));
+    }
+    catch {
+        return null;
+    }
+    let best = null;
+    for (const name of names) {
+        const parsed = readMarkerFile(join(dir, name), now);
+        if (!parsed)
+            continue;
+        if (!best || parsed.startedAt > best.startedAt)
+            best = parsed;
+    }
+    return best ? markerFromFile(best.file) : null;
+}
+// ---------------------------------------------------------------------------
+// `_meta` extraction
+// ---------------------------------------------------------------------------
+/**
+ * Defensively extract the marker fields from an MCP request's `_meta`.
+ *
+ * `_meta` is a loose passthrough schema (SDK 1.29.0), so junk keys and wrong
+ * types must be ignored. Keys are snake_case to match the wire format:
+ * `agent_session`, `nudge_origin`, `trigger_id`, `harness`. Only well-typed
+ * values are returned; everything else is dropped (`harness` additionally
+ * gated on the `KNOWN_HARNESS_FRAMEWORKS` vocabulary).
+ */
+export function extractMarkerMeta(meta) {
+    if (!meta || typeof meta !== 'object')
+        return {};
+    const m = meta;
+    const out = {};
+    if (typeof m.agent_session === 'boolean')
+        out.agentSession = m.agent_session;
+    if (typeof m.nudge_origin === 'boolean')
+        out.nudgeOrigin = m.nudge_origin;
+    if (typeof m.trigger_id === 'string')
+        out.triggerId = m.trigger_id;
+    else if (m.trigger_id === null)
+        out.triggerId = null;
+    const metaHarness = validHarness(m.harness);
+    if (metaHarness !== undefined)
+        out.harness = metaHarness;
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Resolution (precedence: _meta wins per-field, else marker file, else default)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the agent marker for a single tool call.
+ *
+ * Per-field precedence: a value present in `_meta` wins; otherwise the session
+ * marker file supplies it; otherwise the neutral default (`false`/`false`/`null`).
+ *
+ * @param meta - the MCP request's `_meta` object (or undefined).
+ * @param opts.now - injectable clock for tests.
+ */
+export function resolveAgentMarker(meta, opts = {}) {
+    const fromFile = readSessionMarker(opts) ?? NO_AGENT_MARKER;
+    const fromMeta = extractMarkerMeta(meta);
+    return {
+        agentSession: fromMeta.agentSession ?? fromFile.agentSession,
+        nudgeOrigin: fromMeta.nudgeOrigin ?? fromFile.nudgeOrigin,
+        triggerId: fromMeta.triggerId !== undefined ? fromMeta.triggerId : fromFile.triggerId,
+        harness: fromMeta.harness ?? fromFile.harness,
+    };
+}
+//# sourceMappingURL=agent-marker.js.map

package/dist/src/telemetry/agent-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-marker.js","sourceRoot":"","sources":["../../../src/telemetry/agent-marker.ts"],"names":[],"mappings":"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"}

package/dist/src/telemetry/agent-marker.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SMI-5456: Tests for the agent-mediation marker channel.
+ *
+ * Covers the P-5 shared-state invariants for the session marker file:
+ *   - `_meta` wins over the marker file (per-field precedence)
+ *   - marker file alone works
+ *   - neither present ⇒ fields default false / false / null
+ *   - stale (past-TTL) marker is ignored
+ *   - corrupt / malformed marker file is ignored, never throws
+ *   - `_meta` extraction is defensive (junk types dropped)
+ */
+export {};
+//# sourceMappingURL=agent-marker.test.d.ts.map

package/dist/src/telemetry/agent-marker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-marker.test.d.ts","sourceRoot":"","sources":["../../../src/telemetry/agent-marker.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/src/telemetry/agent-marker.test.js

@@ -0,0 +1,202 @@
+/**
+ * SMI-5456: Tests for the agent-mediation marker channel.
+ *
+ * Covers the P-5 shared-state invariants for the session marker file:
+ *   - `_meta` wins over the marker file (per-field precedence)
+ *   - marker file alone works
+ *   - neither present ⇒ fields default false / false / null
+ *   - stale (past-TTL) marker is ignored
+ *   - corrupt / malformed marker file is ignored, never throws
+ *   - `_meta` extraction is defensive (junk types dropped)
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, writeFileSync, rmSync, symlinkSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { resolveAgentMarker, readSessionMarker, extractMarkerMeta, NO_AGENT_MARKER, AGENT_MARKER_TTL_MS, AGENT_MARKER_SCHEMA_VERSION, AGENT_MARKER_MAX_FILE_BYTES, } from './agent-marker.js';
+let markerDir;
+const NOW = 1_720_000_000_000; // fixed clock for deterministic TTL math
+function writeMarker(name, file) {
+    writeFileSync(join(markerDir, name), JSON.stringify(file), 'utf-8');
+}
+function freshMarker(overrides = {}) {
+    return {
+        schema: AGENT_MARKER_SCHEMA_VERSION,
+        session_id: 'sess-1',
+        started_at: NOW - 1000,
+        harness: 'claude-code',
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    markerDir = mkdtempSync(join(tmpdir(), 'skillsmith-marker-'));
+    process.env.SKILLSMITH_AGENT_MARKER_DIR = markerDir;
+});
+afterEach(() => {
+    delete process.env.SKILLSMITH_AGENT_MARKER_DIR;
+    rmSync(markerDir, { recursive: true, force: true });
+});
+// ---------------------------------------------------------------------------
+// readSessionMarker
+// ---------------------------------------------------------------------------
+describe('readSessionMarker', () => {
+    it('returns null when the marker directory does not exist', () => {
+        rmSync(markerDir, { recursive: true, force: true });
+        expect(readSessionMarker({ now: NOW })).toBeNull();
+    });
+    it('reads a fresh marker file (presence ⇒ agent session, harness threaded)', () => {
+        writeMarker('a.json', freshMarker());
+        expect(readSessionMarker({ now: NOW })).toEqual({
+            agentSession: true,
+            nudgeOrigin: false,
+            triggerId: null,
+            harness: 'claude-code',
+        });
+    });
+    it('surfaces explicit nudge_origin + trigger_id from the file', () => {
+        writeMarker('a.json', freshMarker({ nudge_origin: true, trigger_id: 'T1' }));
+        expect(readSessionMarker({ now: NOW })).toEqual({
+            agentSession: true,
+            nudgeOrigin: true,
+            triggerId: 'T1',
+            harness: 'claude-code',
+        });
+    });
+    it('drops an out-of-vocabulary harness value but keeps the marker', () => {
+        writeMarker('a.json', freshMarker({ harness: 'my-cool-editor' }));
+        const resolved = readSessionMarker({ now: NOW });
+        expect(resolved?.agentSession).toBe(true);
+        expect(resolved?.harness).toBeUndefined();
+    });
+    it('drops a wrongly-typed harness value', () => {
+        writeMarker('a.json', freshMarker({ harness: 42 }));
+        expect(readSessionMarker({ now: NOW })?.harness).toBeUndefined();
+    });
+    it('honours an explicit agent_session:false opt-out', () => {
+        writeMarker('a.json', freshMarker({ agent_session: false }));
+        expect(readSessionMarker({ now: NOW })?.agentSession).toBe(false);
+    });
+    it('ignores a marker past the TTL', () => {
+        writeMarker('a.json', freshMarker({ started_at: NOW - AGENT_MARKER_TTL_MS - 1 }));
+        expect(readSessionMarker({ now: NOW })).toBeNull();
+    });
+    it('keeps a marker exactly at the TTL boundary', () => {
+        writeMarker('a.json', freshMarker({ started_at: NOW - AGENT_MARKER_TTL_MS }));
+        expect(readSessionMarker({ now: NOW })?.agentSession).toBe(true);
+    });
+    it('selects the freshest non-expired marker among several', () => {
+        writeMarker('old.json', freshMarker({ session_id: 'old', started_at: NOW - 5000 }));
+        writeMarker('new.json', freshMarker({ session_id: 'new', started_at: NOW - 100, trigger_id: 'T-NEW' }));
+        expect(readSessionMarker({ now: NOW })?.triggerId).toBe('T-NEW');
+    });
+    it('ignores corrupt JSON without throwing', () => {
+        writeFileSync(join(markerDir, 'bad.json'), '{ not valid json', 'utf-8');
+        expect(readSessionMarker({ now: NOW })).toBeNull();
+    });
+    it('ignores a marker missing session_id or started_at', () => {
+        writeMarker('no-session.json', { started_at: NOW - 100 });
+        writeMarker('no-time.json', { session_id: 'x' });
+        expect(readSessionMarker({ now: NOW })).toBeNull();
+    });
+    it('ignores non-.json files and falls back to a valid sibling', () => {
+        writeFileSync(join(markerDir, 'note.txt'), 'ignored', 'utf-8');
+        writeMarker('a.json', freshMarker({ trigger_id: 'T2' }));
+        expect(readSessionMarker({ now: NOW })?.triggerId).toBe('T2');
+    });
+    it('ignores a marker file over AGENT_MARKER_MAX_FILE_BYTES without throwing', () => {
+        // A well-formed marker is a few hundred bytes; pad `trigger_id` past the
+        // cap to simulate a corrupt/hostile oversized file on the hot read path.
+        const oversizedTriggerId = 'x'.repeat(AGENT_MARKER_MAX_FILE_BYTES + 1);
+        writeMarker('huge.json', freshMarker({ trigger_id: oversizedTriggerId }));
+        expect(readSessionMarker({ now: NOW })).toBeNull();
+    });
+    it('ignores a symlink instead of following it', () => {
+        // Target lives OUTSIDE markerDir and is otherwise perfectly valid — if the
+        // reader followed the symlink it would resolve `trigger_id: 'OUTSIDE'`.
+        // `lstat` must reject the symlink entry before `readFileSync` ever runs.
+        const outsideDir = mkdtempSync(join(tmpdir(), 'skillsmith-marker-outside-'));
+        const outsidePath = join(outsideDir, 'target.json');
+        writeFileSync(outsidePath, JSON.stringify(freshMarker({ trigger_id: 'OUTSIDE' })), 'utf-8');
+        symlinkSync(outsidePath, join(markerDir, 'link.json'));
+        expect(readSessionMarker({ now: NOW })).toBeNull();
+        rmSync(outsideDir, { recursive: true, force: true });
+    });
+});
+// ---------------------------------------------------------------------------
+// extractMarkerMeta (defensive _meta validation)
+// ---------------------------------------------------------------------------
+describe('extractMarkerMeta', () => {
+    it('returns empty for non-object input', () => {
+        expect(extractMarkerMeta(undefined)).toEqual({});
+        expect(extractMarkerMeta(null)).toEqual({});
+        expect(extractMarkerMeta('nope')).toEqual({});
+        expect(extractMarkerMeta(42)).toEqual({});
+    });
+    it('extracts well-typed fields', () => {
+        expect(extractMarkerMeta({ agent_session: true, nudge_origin: false, trigger_id: 'T9' })).toEqual({ agentSession: true, nudgeOrigin: false, triggerId: 'T9' });
+    });
+    it('accepts an explicit null trigger_id', () => {
+        expect(extractMarkerMeta({ trigger_id: null })).toEqual({ triggerId: null });
+    });
+    it('drops junk / wrongly-typed values', () => {
+        expect(extractMarkerMeta({
+            agent_session: 'true', // string, not boolean
+            nudge_origin: 1, // number, not boolean
+            trigger_id: 123, // number, not string
+            harness: 'my-cool-editor', // string, but out of vocabulary
+            unrelated: 'ignored',
+        })).toEqual({});
+    });
+    it('accepts a vocabulary harness value', () => {
+        expect(extractMarkerMeta({ harness: 'opencode' })).toEqual({ harness: 'opencode' });
+    });
+});
+// ---------------------------------------------------------------------------
+// resolveAgentMarker (precedence)
+// ---------------------------------------------------------------------------
+describe('resolveAgentMarker', () => {
+    it('returns the neutral default when neither _meta nor file is present', () => {
+        expect(resolveAgentMarker(undefined, { now: NOW })).toEqual(NO_AGENT_MARKER);
+    });
+    it('uses the marker file when _meta is absent', () => {
+        writeMarker('a.json', freshMarker({ nudge_origin: true, trigger_id: 'FILE' }));
+        expect(resolveAgentMarker(undefined, { now: NOW })).toEqual({
+            agentSession: true,
+            nudgeOrigin: true,
+            triggerId: 'FILE',
+            harness: 'claude-code',
+        });
+    });
+    it('lets _meta win over the marker file per field', () => {
+        writeMarker('a.json', freshMarker({ agent_session: true, nudge_origin: true, trigger_id: 'FILE' }));
+        const resolved = resolveAgentMarker({ agent_session: false, trigger_id: 'META' }, { now: NOW });
+        // agent_session + trigger_id come from _meta; nudge_origin + harness fall
+        // back to the file.
+        expect(resolved).toEqual({
+            agentSession: false,
+            nudgeOrigin: true,
+            triggerId: 'META',
+            harness: 'claude-code',
+        });
+    });
+    it('lets a _meta harness win over the file harness', () => {
+        writeMarker('a.json', freshMarker()); // file harness: claude-code
+        expect(resolveAgentMarker({ harness: 'cursor' }, { now: NOW })?.harness).toBe('cursor');
+    });
+    it('a junk _meta harness falls back to the file harness', () => {
+        writeMarker('a.json', freshMarker()); // file harness: claude-code
+        expect(resolveAgentMarker({ harness: 'my-cool-editor' }, { now: NOW })?.harness).toBe('claude-code');
+    });
+    it('lets _meta provide fields with no marker file at all', () => {
+        expect(resolveAgentMarker({ agent_session: true }, { now: NOW })).toEqual({
+            agentSession: true,
+            nudgeOrigin: false,
+            triggerId: null,
+        });
+    });
+    it('an expired file behaves as no file (falls through to _meta / default)', () => {
+        writeMarker('a.json', freshMarker({ started_at: NOW - AGENT_MARKER_TTL_MS - 1, trigger_id: 'STALE' }));
+        expect(resolveAgentMarker(undefined, { now: NOW })).toEqual(NO_AGENT_MARKER);
+    });
+});
+//# sourceMappingURL=agent-marker.test.js.map

package/dist/src/telemetry/agent-marker.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-marker.test.js","sourceRoot":"","sources":["../../../src/telemetry/agent-marker.test.ts"],"names":[],"mappings":"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"}

package/dist/src/telemetry/index.d.ts

@@ -10,7 +10,8 @@ export { SkillsmithTracer, getTracer, initializeTracing, shutdownTracing, traced
 export { MetricsRegistry, getMetrics, initializeMetrics, timeAsync, timeSync, LATENCY_BUCKETS, type MetricsConfig, type MetricLabels, type Counter, type Histogram, type Gauge, type MetricsSnapshot, } from './metrics.js';
 export { exportToPrometheus, getPrometheusMetrics, createPrometheusHandler, type PrometheusExportOptions, } from './prometheus.js';
 export { initializePostHog, shutdownPostHog, flushPostHog, trackEvent, trackSkillSearch, trackSkillView, trackSkillInstall, trackSkillInvoke, trackApiError, identifyUser, isFeatureFlagEnabled, getPostHog, isPostHogEnabled, ALLOWED_TRAITS, type PostHogConfig, type SkillsmithEventType, type SkillEventProperties, type TrackSkillInvokeParams, type AllowedUserTraits, } from './posthog.js';
-export { withTelemetry, isTelemetered, setEmissionGate, type WithTelemetryOpts } from './wrap.js';
+export { withTelemetry, isTelemetered, setEmissionGate, runWithEmissionGate, runWithMarkerContext, type WithTelemetryOpts, } from './wrap.js';
+export { resolveAgentMarker, readSessionMarker, extractMarkerMeta, NO_AGENT_MARKER, AGENT_MARKER_TTL_MS, AGENT_MARKER_SCHEMA_VERSION, KNOWN_HARNESS_FRAMEWORKS, type HarnessFramework, type AgentMarker, type AgentMarkerFile, } from './agent-marker.js';
 /**
  * Initialize all telemetry (tracing + metrics)
  * Call this at application startup