create-principles-disciple 1.147.12 → 1.147.13

package/plugin/dist/hooks/controlled-admission.d.ts

@@ -0,0 +1,87 @@
+import type { PluginHookBeforePromptBuildEvent } from '../openclaw-sdk.js';
+import type { AdaptiveActivationConfig } from './adaptive-activation-config.js';
+export declare const CONTROLLED_ADMISSION_ENV: {
+    readonly admissionFile: 'PD_AA_ADMISSION_FILE';
+    readonly experimentRoot: 'PD_AA_EXPERIMENT_ROOT';
+};
+export type ControlledAdmissionReason = 'admission_native_identity_present' | 'admission_path_outside_root' | 'admission_file_invalid' | 'admission_input_mismatch' | 'admission_input_parse_mismatch' | 'admission_manifest_mismatch' | 'admission_target_mismatch' | 'admission_mapping_mismatch' | 'admission_session_mismatch' | 'admission_agent_to_agent' | 'admission_scene_mismatch' | 'admission_expired' | 'admission_already_consumed' | 'admission_claim_write_failed';
+export interface ControlledAdmissionEnvironment {
+    enabled: boolean;
+    admissionFile?: string;
+    experimentRoot?: string;
+}
+export interface ControlledAdmissionIdentity {
+    admissionId: string;
+    operator: string;
+    purpose: string;
+    inputSha256: string;
+    manifestSha256: string;
+    mappingSha256: string;
+    targetArtifactId: string;
+    targetActivationId: string;
+    expiresAt: string;
+    consumedAt: string;
+    consumedBy: {
+        sessionId: string;
+        runId: string | null;
+        hookInvocationId: string;
+    };
+}
+export interface ControlledAdmissionManifest {
+    targetArtifactId: string;
+    targetActivationId: string;
+    sourceRef: string;
+    fixtureFile: string;
+    fixtureSha256: string;
+    expectedToolName: string;
+    expectedContentMarker: string;
+    configSnapshot: Record<string, unknown>;
+}
+export interface ControlledAdmissionClaim {
+    claimId: string;
+    identity: ControlledAdmissionIdentity;
+    manifest: ControlledAdmissionManifest;
+    admittedText: string;
+    hookInvocationId: string;
+}
+export type ControlledAdmissionClaimResult = {
+    status: 'disabled';
+} | {
+    status: 'rejected';
+    reason: ControlledAdmissionReason;
+    detail?: string;
+} | {
+    status: 'claimed';
+    claim: ControlledAdmissionClaim;
+};
+export interface ControlledAdmissionClaimRequest {
+    event: PluginHookBeforePromptBuildEvent;
+    workspaceDir: string;
+    sessionId: string | undefined;
+    runId?: string | null;
+    mapping: AdaptiveActivationConfig;
+    hookInvocationId: string;
+    now?: number;
+}
+/**
+ * The controlled admission branch is opt-in per isolated process only. There is
+ * no persisted configuration and no plugin default that could enable it.
+ */
+export declare function readControlledAdmissionEnvironment(env?: NodeJS.ProcessEnv): ControlledAdmissionEnvironment;
+export declare function isControlledAdmissionConfigured(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Takes the same-round provider→prompt handoff for the exact host event object
+ * and hook invocation. A duplicate callback, a new run with the same input, a
+ * cross-session callback or a post-tool second request cannot take it: either
+ * the entry is already gone or its identity does not match.
+ */
+export declare function takeControlledAdmissionHandoff(event: PluginHookBeforePromptBuildEvent, hookInvocationId: string | undefined, now?: number): ControlledAdmissionClaim | null;
+/** Journal close / abnormal exit removes the handoff entry; disk `consumedAt` stays authoritative. */
+export declare function releaseControlledAdmissionClaim(claim: ControlledAdmissionClaim | null | undefined): void;
+export declare function resetControlledAdmissionCacheForTest(): void;
+/**
+ * Exclusive read→validate→write consumption. The lock, every read, the consumed
+ * marker write and its rollback happen inside one mutual exclusion region, so
+ * two callers can never both observe an unconsumed admission.
+ */
+export declare function claimControlledAdmission(request: ControlledAdmissionClaimRequest): ControlledAdmissionClaimResult;

package/plugin/dist/hooks/prompt.d.ts

@@ -27,7 +27,7 @@ export declare function beginAdaptivePromptInvocation(ctx: PluginHookAgentContex
 }, target: {
     artifactId: string;
     activationId: string;
-}, runtimeMode: string): string;
+}, runtimeMode: string, hookInvocationId?: string): string;
 export declare function handleBeforePromptBuild(event: PluginHookBeforePromptBuildEvent, ctx: PluginHookAgentContext & {
     api?: PromptHookApi;
 }, sharedActivePrinciplePrompt?: ActivePrinciplePromptResult): Promise<PluginHookBeforePromptBuildResult | void>;

package/plugin/dist/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Principles Disciple is an AI Agent Governance System. Stop correcting the same AI behavior across sessions. Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles.",
-  "version": "2.6.5",
+  "version": "2.7.0",
   "activation": {
     "onStartup": true,
     "onCapabilities": [

package/plugin/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Principles Disciple is an AI Agent Governance System. Stop correcting the same AI behavior across sessions. Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles.",
-  "version": "2.6.4",
+  "version": "2.6.5",
   "activation": {
     "onStartup": true,
     "onCapabilities": [

package/plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "2.6.4",
+  "version": "2.6.5",
   "description": "Principles Disciple is an AI Agent Governance System. Stop correcting the same AI behavior across sessions. Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles.",
   "type": "module",
   "main": "./dist/index.js",

package/release-manager/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-principles-disciple",
-  "version": "1.147.12",
+  "version": "1.147.13",
   "description": "Interactive CLI installer for Principles Disciple OpenClaw plugin",
   "type": "module",
   "bin": {