@punica/editor 1.35.0 → 1.36.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punica/editor",
-  "version": "1.35.0",
+  "version": "1.36.0",
   "description": "Punica Editor",
   "private": false,
   "type": "module",

package/types/index.d.ts

@@ -254,6 +254,43 @@ export function emitShellEvent(opts: ShellEventOptions): boolean;
  */
 export const WORKSPACE_STATE_GITIGNORE: string;
 
+/**
+ * The agent-mode policy profile: what the gate does with a call whose actor
+ * is `ai`, before any `.punica/policy.yaml` rule is consulted. The default
+ * holds every `write` and every `high`-risk call for a person and auto-runs
+ * the rest; a host may install its own with `setAgentPolicyProfile`. Exported
+ * so a host that explains a verdict without dispatching reads the same
+ * function the gate reads.
+ */
+export type AgentPolicyDecision = 'auto' | 'approval';
+export type AgentPolicyRisk = 'low' | 'medium' | 'high';
+export type AgentPolicySideEffect = 'none' | 'read' | 'write' | 'network';
+export interface AgentPolicyProfileInput {
+  capabilityId: string;
+  risk: AgentPolicyRisk;
+  sideEffect: AgentPolicySideEffect;
+}
+export type AgentPolicyProfile = (input: AgentPolicyProfileInput) => AgentPolicyDecision;
+export const defaultAgentPolicyProfile: AgentPolicyProfile;
+export function getAgentPolicyProfile(): AgentPolicyProfile;
+export function setAgentPolicyProfile(profile: AgentPolicyProfile | undefined): void;
+
+/**
+ * The gate's classifier from a declaration's `sideEffects` array to the one
+ * side effect the agent-mode profile reads: `write` beats `network` beats
+ * `read` beats `none`.
+ */
+export function sideEffectArrayToEnum(values: string[] | undefined): AgentPolicySideEffect;
+
+/**
+ * Whether critical events are written to the workspace's `.punica/events`.
+ * On by default. A host turns it off before `initialize()` for a boot that
+ * only reads, so the boot leaves no file behind; publishing, subscriptions
+ * and the in-memory audit ring are unaffected.
+ */
+export function setEventPersistence(enabled: boolean): void;
+export function isEventPersistenceEnabled(): boolean;
+
 /** The core-owned ApplicationProfile mechanism (`punica.shell.Profile`). */
 export const Profile: {
   readonly manager: import('punica').shell.Profile.IProfileManager;