@skillfm/local 2.7.10 → 2.7.11

package/dist/safe/index.d.ts

@@ -1,5 +1,5 @@
-export type { HarnessId, HarnessDetection, SafeInjectResult, } from './types.js';
-export { SKILLFM_MARKER_START, SKILLFM_MARKER_END } from './types.js';
-export { renderSafeGuide, injectOrReplaceBlock, removeBlock, hasMarkerBlock, } from './safe-rules.js';
-export { detectOpenClaw, injectOpenClaw, detectClaudeCode, injectClaudeCode, detectCursor, injectCursor, detectCodex, injectCodex, detectContinue, detectAllHarnesses, injectAllDetected, removeAllInjections, } from './injectors.js';
+export type { HarnessId, HarnessDetection, ForcingInjectResult as SafeContextResult, } from '../agent-forcing/types.js';
+export { SKILLFM_MARKER_START, SKILLFM_MARKER_END, } from '../agent-forcing/types.js';
+export { renderForcingGuide as renderSafeGuide, renderToolsGuideBlock as renderSafeToolsGuideBlock, injectOrReplaceBlock as injectOrReplaceSafeBlock, removeBlock as removeSafeBlock, hasMarkerBlock as hasSafeMarkerBlock, } from '../agent-forcing/forcing-rules.js';
+export { detectOpenClaw, injectOpenClaw, detectClaudeCode, injectClaudeCode, detectCursor, injectCursor, detectCodex, injectCodex, detectContinue, detectAllHarnesses, injectAllDetected, removeAllInjections, } from '../agent-forcing/injectors.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/safe/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/safe/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/safe/index.ts"],"names":[],"mappings":"AAMA,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,mBAAmB,IAAI,iBAAiB,GACzC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,IAAI,eAAe,EACrC,qBAAqB,IAAI,yBAAyB,EAClD,oBAAoB,IAAI,wBAAwB,EAChD,WAAW,IAAI,eAAe,EAC9B,cAAc,IAAI,kBAAkB,GACrC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC"}

package/dist/safe/index.js

@@ -1,6 +1,9 @@
 // sdk/skillfm-local/src/safe/index.ts
-// SAFE Adapter — public API.
-export { SKILLFM_MARKER_START, SKILLFM_MARKER_END } from './types.js';
-export { renderSafeGuide, injectOrReplaceBlock, removeBlock, hasMarkerBlock, } from './safe-rules.js';
-export { detectOpenClaw, injectOpenClaw, detectClaudeCode, injectClaudeCode, detectCursor, injectCursor, detectCodex, injectCodex, detectContinue, detectAllHarnesses, injectAllDetected, removeAllInjections, } from './injectors.js';
+//
+// SAFE alias layer for the legacy agent-forcing implementation.
+// Phase 1 keeps the old implementation in place and exposes a stable SAFE
+// entry point for new code.
+export { SKILLFM_MARKER_START, SKILLFM_MARKER_END, } from '../agent-forcing/types.js';
+export { renderForcingGuide as renderSafeGuide, renderToolsGuideBlock as renderSafeToolsGuideBlock, injectOrReplaceBlock as injectOrReplaceSafeBlock, removeBlock as removeSafeBlock, hasMarkerBlock as hasSafeMarkerBlock, } from '../agent-forcing/forcing-rules.js';
+export { detectOpenClaw, injectOpenClaw, detectClaudeCode, injectClaudeCode, detectCursor, injectCursor, detectCodex, injectCodex, detectContinue, detectAllHarnesses, injectAllDetected, removeAllInjections, } from '../agent-forcing/injectors.js';
 //# sourceMappingURL=index.js.map

package/dist/safe/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/safe/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,6BAA6B;AAO7B,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/safe/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,gEAAgE;AAChE,0EAA0E;AAC1E,4BAA4B;AAO5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,IAAI,eAAe,EACrC,qBAAqB,IAAI,yBAAyB,EAClD,oBAAoB,IAAI,wBAAwB,EAChD,WAAW,IAAI,eAAe,EAC9B,cAAc,IAAI,kBAAkB,GACrC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC"}

package/dist/safe-cli.d.ts

@@ -1,2 +1,8 @@
+type SafeCliDeps = {
+    argv?: string[];
+};
+export declare function runSafeCli(deps?: SafeCliDeps): Promise<void>;
 export declare function cmdSafe(): Promise<void>;
+export declare function cmdForcing(): Promise<void>;
+export {};
 //# sourceMappingURL=safe-cli.d.ts.map

package/dist/safe-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safe-cli.d.ts","sourceRoot":"","sources":["../src/safe-cli.ts"],"names":[],"mappings":"AAeA,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAsC7C"}
+{"version":3,"file":"safe-cli.d.ts","sourceRoot":"","sources":["../src/safe-cli.ts"],"names":[],"mappings":"AAeA,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,wBAAsB,UAAU,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCtE;AAED,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7C;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAGhD"}

package/dist/safe-cli.js

@@ -1,14 +1,15 @@
 // sdk/skillfm-local/src/safe-cli.ts
 //
-// CLI: npx @skillfm/local SAFE <subcommand>
+// CLI: npx @skillfm/local safe <subcommand>
 //   detect       — 仅检测各 harness, 不真改
-//   inject       — 真注入 SKILLFM-AGENT-GUIDE block 到检测到的 harness
+//   inject       — 真注入 SAFE guide 到检测到的 harness
 //   uninstall    — 移除已注入的 block
 //
-// 这是用户手动控制 SAFE 的 CLI fallback (sidecar 启动时也会自动跑 inject).
+// Legacy `forcing` entry point remains as an alias wrapper.
 import { detectAllHarnesses, injectAllDetected, removeAllInjections, } from './safe/index.js';
-export async function cmdSafe() {
-    const sub = process.argv[3] ?? 'detect';
+export async function runSafeCli(deps = {}) {
+    const argv = deps.argv ?? process.argv;
+    const sub = argv[3] ?? 'detect';
     if (sub === 'detect') {
         const detections = await detectAllHarnesses();
         console.log('🤖 SkillFM SAFE — Detection');
@@ -50,4 +51,11 @@ export async function cmdSafe() {
     }
     process.exit(0);
 }
+export async function cmdSafe() {
+    await runSafeCli();
+}
+export async function cmdForcing() {
+    console.error("[skillfm-local] 'forcing' has been renamed to 'safe'; use `skillfm-local safe ...`.");
+    await runSafeCli();
+}
 //# sourceMappingURL=safe-cli.js.map

package/dist/safe-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"safe-cli.js","sourceRoot":"","sources":["../src/safe-cli.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,4CAA4C;AAC5C,qCAAqC;AACrC,+DAA+D;AAC/D,gCAAgC;AAChC,EAAE;AACF,0DAA0D;AAE1D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;IAExC,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;gBACjC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO;oBAC9B,CAAC,CAAC,QAAQ,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;SAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,cAAc,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC9E,IAAI,CAAC,CAAC,cAAc;oBAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,IAAI,UAAU,EAAE,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"safe-cli.js","sourceRoot":"","sources":["../src/safe-cli.ts"],"names":[],"mappings":"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"}

package/dist/safe-observation/collector.d.ts

@@ -0,0 +1,21 @@
+import type { BrainPushClient } from '../scheduler/types.js';
+export interface SafeObservationCollectorOptions {
+    skillfmHome?: string;
+    brain?: Pick<BrainPushClient, 'pushSafeSkillObservations'>;
+    logger?: Pick<Console, 'warn'>;
+}
+export interface SafeObservationContextInput {
+    skillSlug: string;
+    request: unknown;
+}
+export interface SafeObservationCaptureInput {
+    skillSlug: string;
+    response: unknown;
+}
+export declare class SafeObservationCollector {
+    private readonly opts;
+    constructor(opts?: SafeObservationCollectorOptions);
+    injectInstallConsent(input: SafeObservationContextInput): Promise<unknown>;
+    capture(input: SafeObservationCaptureInput): Promise<void>;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/safe-observation/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/safe-observation/collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D,MAAM,WAAW,+BAA+B;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,2BAA2B,CAAC,CAAC;IAC3D,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;gBAE3C,IAAI,GAAE,+BAAoC;IAIhD,oBAAoB,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,OAAO,CAAC;IAM1E,OAAO,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;CAcjE"}

package/dist/safe-observation/collector.js

@@ -0,0 +1,101 @@
+import { appendSafeObservationCase, readInstallConsentGrant, } from './store.js';
+export class SafeObservationCollector {
+    opts;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    async injectInstallConsent(input) {
+        const grant = await readInstallConsentGrant(input.skillSlug, this.opts.skillfmHome);
+        if (!grant)
+            return input.request;
+        return injectGrantIntoRequest(input.request, grant);
+    }
+    async capture(input) {
+        const observation = extractSafeObservation(input.response);
+        if (!observation)
+            return;
+        const grant = await readInstallConsentGrant(input.skillSlug, this.opts.skillfmHome);
+        const enriched = grant ? applyGrantToObservation(observation, grant) : observation;
+        await appendSafeObservationCase(input.skillSlug, enriched, this.opts.skillfmHome);
+        if (!shouldUpload(grant))
+            return;
+        const result = await this.opts.brain?.pushSafeSkillObservations([enriched]);
+        if (result && !result.ok) {
+            this.opts.logger?.warn?.(`[safe-observation] brain push failed: ${result.error ?? 'unknown error'}`);
+        }
+    }
+}
+function injectGrantIntoRequest(request, grant) {
+    if (!request || typeof request !== 'object' || Array.isArray(request))
+        return request;
+    const obj = request;
+    const context = obj.context && typeof obj.context === 'object' && !Array.isArray(obj.context)
+        ? obj.context
+        : {};
+    return {
+        ...obj,
+        context: {
+            ...context,
+            safe_observation_upload_scope: grant.upload_scope,
+            safe_observation_consent_grant_id: grant.status === 'accepted' ? grant.consent_grant_id : undefined,
+            safe_observation_reward_policy_ref: grant.reward_policy_ref,
+            safe_observation_consented_at: grant.consented_at,
+        },
+    };
+}
+function extractSafeObservation(response) {
+    if (!response || typeof response !== 'object')
+        return null;
+    const root = response;
+    const direct = root.safe_observation;
+    if (direct && typeof direct === 'object')
+        return direct;
+    const data = root.data;
+    if (!data || typeof data !== 'object')
+        return null;
+    const dataObj = data;
+    const output = dataObj.output;
+    if (!output || typeof output !== 'object')
+        return null;
+    const observation = output.safe_observation;
+    return observation && typeof observation === 'object' ? observation : null;
+}
+function applyGrantToObservation(observation, grant) {
+    if (!observation || typeof observation !== 'object' || Array.isArray(observation))
+        return observation;
+    const obj = observation;
+    const safe = obj.safe && typeof obj.safe === 'object' && !Array.isArray(obj.safe)
+        ? obj.safe
+        : {};
+    const consent = safe.consent && typeof safe.consent === 'object' && !Array.isArray(safe.consent)
+        ? safe.consent
+        : {};
+    const reward = obj.reward && typeof obj.reward === 'object' && !Array.isArray(obj.reward)
+        ? obj.reward
+        : {};
+    const uploadScope = grant.status === 'accepted' ? grant.upload_scope : 'local_only';
+    const eligible = grant.status === 'accepted' && uploadScope !== 'local_only' && reward.eligible !== false;
+    return {
+        ...obj,
+        safe: {
+            ...safe,
+            consent: {
+                ...consent,
+                local_record: true,
+                upload_scope: uploadScope,
+                consent_source: grant.status === 'accepted' ? 'skill_install' : undefined,
+                consent_grant_id: grant.status === 'accepted' ? grant.consent_grant_id : undefined,
+                consented_at: grant.consented_at,
+            },
+        },
+        reward: {
+            ...reward,
+            eligible,
+            policy_id: grant.reward_policy_ref ?? reward.policy_id,
+        },
+    };
+}
+function shouldUpload(grant) {
+    return Boolean(grant && grant.status === 'accepted' && grant.upload_scope !== 'local_only');
+}
+//# sourceMappingURL=collector.js.map

package/dist/safe-observation/collector.js.map

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

package/dist/safe-observation/store.d.ts

@@ -0,0 +1,34 @@
+export type SafeShareScope = 'local_only' | 'aggregate' | 'redacted_case' | 'public_case';
+export interface SafeObservationConsentGrant {
+    consent_grant_id: string;
+    skill_slug: string;
+    skill_version: string;
+    consent_source: 'skill_install';
+    status: 'accepted' | 'declined';
+    upload_scope: SafeShareScope;
+    reward_policy_ref?: string;
+    consented_at: string;
+    user_can_revoke: true;
+}
+export interface CreateInstallConsentGrantInput {
+    skillSlug: string;
+    skillVersion: string;
+    decision?: 'accepted' | 'declined';
+    uploadScope?: SafeShareScope;
+    rewardPolicyRef?: string;
+    skillfmHome?: string;
+}
+export interface LocalCaseRecord {
+    case_id: string;
+    emitted_at: string;
+    skill_slug: string;
+    observation: unknown;
+}
+export declare function defaultSkillfmHome(): string;
+export declare function consentGrantPath(skillSlug: string, skillfmHome?: string): string;
+export declare function casesJsonlPath(skillSlug: string, skillfmHome?: string): string;
+export declare function createInstallConsentGrant(input: CreateInstallConsentGrantInput): Promise<SafeObservationConsentGrant>;
+export declare function readInstallConsentGrant(skillSlug: string, skillfmHome?: string): Promise<SafeObservationConsentGrant | null>;
+export declare function appendSafeObservationCase(skillSlug: string, observation: unknown, skillfmHome?: string): Promise<LocalCaseRecord>;
+export declare function readSafeObservationCases(skillSlug: string, skillfmHome?: string): Promise<LocalCaseRecord[]>;
+//# sourceMappingURL=store.d.ts.map

package/dist/safe-observation/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/safe-observation/store.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,eAAe,GAAG,aAAa,CAAC;AAE1F,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,eAAe,CAAC;IAChC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,YAAY,EAAE,cAAc,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACnC,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,SAAuB,GAAG,MAAM,CAE9F;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,SAAuB,GAAG,MAAM,CAE5F;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAyBtC;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,WAAW,SAAuB,GACjC,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAO7C;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO,EACpB,WAAW,SAAuB,GACjC,OAAO,CAAC,eAAe,CAAC,CAgB1B;AAED,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,WAAW,SAAuB,GACjC,OAAO,CAAC,eAAe,EAAE,CAAC,CAU5B"}

package/dist/safe-observation/store.js

@@ -0,0 +1,80 @@
+// SAFE observation local store.
+//
+// Full evidence stays on the user's machine. Upload is a separate consent-gated
+// step handled by BrainPushClient.
+import { appendFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { createHash, randomUUID } from 'node:crypto';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+export function defaultSkillfmHome() {
+    return process.env.SKILLFM_HOME || join(homedir(), '.skillfm');
+}
+export function consentGrantPath(skillSlug, skillfmHome = defaultSkillfmHome()) {
+    return join(skillfmHome, 'safe-consent-grants', `${skillSlug}.json`);
+}
+export function casesJsonlPath(skillSlug, skillfmHome = defaultSkillfmHome()) {
+    return join(skillfmHome, 'capsule-cases', `${skillSlug}.jsonl`);
+}
+export async function createInstallConsentGrant(input) {
+    const status = input.decision ?? 'declined';
+    const uploadScope = status === 'accepted' ? (input.uploadScope ?? 'aggregate') : 'local_only';
+    const consentedAt = new Date().toISOString();
+    const stablePart = createHash('sha256')
+        .update(`${input.skillSlug}:${input.skillVersion}:${consentedAt}:${randomUUID()}`)
+        .digest('hex')
+        .slice(0, 20);
+    const grant = {
+        consent_grant_id: `grant_${stablePart}`,
+        skill_slug: input.skillSlug,
+        skill_version: input.skillVersion,
+        consent_source: 'skill_install',
+        status,
+        upload_scope: uploadScope,
+        reward_policy_ref: input.rewardPolicyRef,
+        consented_at: consentedAt,
+        user_can_revoke: true,
+    };
+    const path = consentGrantPath(input.skillSlug, input.skillfmHome);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(grant, null, 2)}\n`, 'utf8');
+    return grant;
+}
+export async function readInstallConsentGrant(skillSlug, skillfmHome = defaultSkillfmHome()) {
+    try {
+        const raw = await readFile(consentGrantPath(skillSlug, skillfmHome), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function appendSafeObservationCase(skillSlug, observation, skillfmHome = defaultSkillfmHome()) {
+    const emittedAt = new Date().toISOString();
+    const caseId = `case_${createHash('sha256')
+        .update(`${skillSlug}:${emittedAt}:${JSON.stringify(observation)}`)
+        .digest('hex')
+        .slice(0, 24)}`;
+    const record = {
+        case_id: caseId,
+        emitted_at: emittedAt,
+        skill_slug: skillSlug,
+        observation,
+    };
+    const path = casesJsonlPath(skillSlug, skillfmHome);
+    await mkdir(dirname(path), { recursive: true });
+    await appendFile(path, `${JSON.stringify(record)}\n`, 'utf8');
+    return record;
+}
+export async function readSafeObservationCases(skillSlug, skillfmHome = defaultSkillfmHome()) {
+    try {
+        const raw = await readFile(casesJsonlPath(skillSlug, skillfmHome), 'utf8');
+        return raw
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/safe-observation/store.js.map

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

package/dist/save-token/gateway-setup.d.ts

@@ -1,5 +1,9 @@
 import type { GatewayDetection } from './types.js';
 export declare const SKILLFM_GATEWAY_BASE_URL: string;
+export declare function normalizeShellGatewayBlocks(content: string, gatewayBaseUrl?: string): {
+    content: string;
+    removed_count: number;
+};
 /**
  * 检测各 IDE 的配置 + 当前 BASE_URL
  */
@@ -18,10 +22,36 @@ export interface SetupResult {
     revert_command?: string;
     error?: string;
 }
-export declare function setupClaudeCodeGateway(): Promise<SetupResult>;
-export declare function setupShellEnvGateway(): Promise<SetupResult>;
+type GatewayFetch = (input: string, init?: {
+    method?: string;
+    signal?: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json?: () => Promise<unknown>;
+}>;
+export interface GatewayReadiness {
+    ok: boolean;
+    gateway_base_url: string;
+    checked_url: string;
+    status?: number;
+    gateway_kind?: string;
+    capabilities?: string[];
+    error?: string;
+}
+export interface GatewaySetupOptions {
+    gatewayBaseUrl?: string;
+    gatewayReadiness?: GatewayReadiness;
+    detections?: GatewayDetection[];
+    fetchImpl?: GatewayFetch;
+    timeoutMs?: number;
+}
+export declare function checkGatewayReadiness(opts?: GatewaySetupOptions): Promise<GatewayReadiness>;
+export declare function setupClaudeCodeGateway(opts?: GatewaySetupOptions): Promise<SetupResult>;
+export declare function setupShellEnvGateway(opts?: GatewaySetupOptions): Promise<SetupResult>;
 /**
  * 一键配 — 所有检测到的 IDE
  */
-export declare function setupAllDetectedGateways(): Promise<SetupResult[]>;
+export declare function setupAllDetectedGateways(opts?: GatewaySetupOptions): Promise<SetupResult[]>;
+export {};
 //# sourceMappingURL=gateway-setup.d.ts.map

package/dist/save-token/gateway-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-setup.d.ts","sourceRoot":"","sources":["../../src/save-token/gateway-setup.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,YAAY,CAAC;AAEvE,eAAO,MAAM,wBAAwB,QAAuE,CAAC;AAE7G;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsB9D;AAyFD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,WAAW,CAAC,CAiCnE;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,WAAW,CAAC,CAoCjE;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAcvE"}
+{"version":3,"file":"gateway-setup.d.ts","sourceRoot":"","sources":["../../src/save-token/gateway-setup.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,YAAY,CAAC;AAEvE,eAAO,MAAM,wBAAwB,QAAuE,CAAC;AAoC7G,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAiC,GAChD;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAO5C;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsB9D;AAkGD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,YAAY,GAAG,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAC7C,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiErG;AA+BD,wBAAsB,sBAAsB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CAkCjG;AAED,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,CA8B/F;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAwBrG"}