@ifsoul/core 0.3.0 → 0.5.0

package/dist/packages/protocol/src/index.d.ts

@@ -6,11 +6,6 @@ export declare function canonical(value: unknown): string;
 export { resolveResourceLimits, BUFFERED_JSON_MAX_BYTES, MAX_TIMER_MS, } from "./resource-policy.js";
 export type { BudgetReport } from "./resource-policy.js";
 /** Current train identifier; wire families require exact kind/version validation. */
-export declare const IFSOUL_VERSION: "0.3.0";
-/** Reviewed shape-preserving v0.2 to current adapter. Never mutates stored evidence.
- * v0.1 has no generic semantic adapter. */
-export declare function upgradeDocument<T extends import("./types.js").Envelope>(value: T): Omit<T, "schemaVersion"> & {
-    schemaVersion: typeof IFSOUL_VERSION;
-};
+export declare const IFSOUL_VERSION: "0.5.0";
 /** Structural current ModelProvider spec validation; not a provider wire transport. */
 export declare function validateModelProviderDocument(value: unknown): boolean;

package/dist/packages/protocol/src/index.js

@@ -30,9 +30,9 @@ export function validateDocument(value, expectedKind) {
         !Object.hasOwn(kinds, kind))
         return false;
     const version = value.schemaVersion;
-    if (version !== "draft-0.2.0" && version !== "0.3.0")
+    if (version !== "0.4.0")
         return false;
-    return (validators[(version === "0.3.0" ? "current_" : "") + kinds[kind]](value) === true);
+    return validators["current_" + kinds[kind]](value) === true;
 }
 /** Canonical local equality for JSON documents; not a signature or authentication proof. */
 export function canonical(value) {
@@ -47,20 +47,7 @@ export function canonical(value) {
 }
 export { resolveResourceLimits, BUFFERED_JSON_MAX_BYTES, MAX_TIMER_MS, } from "./resource-policy.js";
 /** Current train identifier; wire families require exact kind/version validation. */
-export const IFSOUL_VERSION = "0.3.0";
-/** Reviewed shape-preserving v0.2 to current adapter. Never mutates stored evidence.
- * v0.1 has no generic semantic adapter. */
-export function upgradeDocument(value) {
-    if (!validateDocument(value))
-        throw new Error("Unsupported or invalid protocol document");
-    const copy = structuredClone(value);
-    copy.schemaVersion = IFSOUL_VERSION;
-    if (copy.kind === "archive-manifest")
-        throw new Error("Archive files require an explicit manifest rebuild; generic adaptation is unsupported");
-    if (!validateDocument(copy))
-        throw new Error("Unsupported protocol adaptation");
-    return copy;
-}
+export const IFSOUL_VERSION = "0.5.0";
 /** Structural current ModelProvider spec validation; not a provider wire transport. */
 export function validateModelProviderDocument(value) {
     return validators.current_provider(value) === true;

package/dist/packages/protocol/src/types.d.ts

@@ -1,6 +1,6 @@
 /** Convenience views for the implemented slice. JSON Schemas remain normative. */
 export interface Envelope {
-    schemaVersion: "0.3.0" | "draft-0.2.0";
+    schemaVersion: "0.4.0";
     kind: string;
     extensions?: Record<string, unknown>;
     requiredExtensions?: string[];

package/dist/packages/runtime/src/behavior-types.d.ts

@@ -0,0 +1,150 @@
+export type BehaviorPermission = "observe" | "remember" | "updateRelationship" | "speak" | "requestAction";
+export type BehaviorPermissions = Record<BehaviorPermission, boolean>;
+export type BehaviorEventKind = "provocation" | "helpful" | "observation";
+export interface BehaviorPolicy {
+    general: BehaviorPermissions;
+    provocation: BehaviorPermissions;
+}
+export interface BehaviorGoal {
+    goalId: string;
+    objective: string;
+    priority: number;
+    enabled: boolean;
+}
+export interface ParameterDefinition {
+    parameterId: string;
+    label: string;
+    kind: "trait" | "state" | "relationship";
+    scope: "portable" | "world";
+    initial: number;
+    min: number;
+    max: number;
+    maxDelta: number;
+    decay?: {
+        perHour: number;
+        toward: number;
+    };
+}
+export interface BehaviorSettings {
+    policy: BehaviorPolicy;
+    goals: BehaviorGoal[];
+}
+export interface BehaviorOverride {
+    scope: {
+        kind: "npc" | "group" | "world";
+        id: string;
+    };
+    policy?: {
+        general?: Partial<BehaviorPermissions>;
+        provocation?: Partial<BehaviorPermissions>;
+    };
+    goals?: BehaviorGoal[];
+    initialValues?: Record<string, number>;
+}
+export interface BehaviorConfiguration {
+    version: "ifsoul-behavior/0.4.0";
+    revision: number;
+    parameters: ParameterDefinition[];
+    defaults: BehaviorSettings;
+    overrides: BehaviorOverride[];
+}
+/** Injected by trusted server composition; never accepted in configuration bodies. */
+export interface BehaviorOperatorPolicy {
+    canEditConfig: boolean;
+    lockedParameterIds: string[];
+    deniedPermissions: BehaviorPermission[];
+    lockedPolicy: boolean;
+    lockedGoals: boolean;
+}
+export interface BehaviorParameterValue {
+    npcId: string;
+    parameterId: string;
+    targetParticipantId?: string;
+    worldId?: string;
+    value: number;
+    confidence: number;
+    revision: number;
+    updatedAt: number;
+}
+export interface BehaviorChange {
+    changeId: string;
+    npcId: string;
+    parameterId: string;
+    targetParticipantId?: string;
+    worldId?: string;
+    before: number;
+    after: number;
+    confidence: number;
+    revision: number;
+    configRevision: number;
+    evidenceEventIds: string[];
+    reason: string;
+    kind: "evidence" | "decay";
+    recordedAt: number;
+}
+export interface BehaviorProposal {
+    proposalId: string;
+    npcId: string;
+    sessionId: string;
+    configRevision: number;
+    expectedStateRevision: number;
+    changes: {
+        parameterId: string;
+        targetParticipantId?: string;
+        delta: number;
+        confidence: number;
+        evidenceEventIds: string[];
+        reason: string;
+    }[];
+}
+export interface BehaviorObservation {
+    eventId: string;
+    npcId: string;
+    kind: BehaviorEventKind;
+    configRevision: number;
+    permissions: BehaviorPermissions;
+}
+export interface BehaviorState {
+    format: "ifsoul-behavior/0.4.0";
+    config: BehaviorConfiguration;
+    observations: BehaviorObservation[];
+    values: BehaviorParameterValue[];
+    history: BehaviorChange[];
+    proposals: {
+        proposal: BehaviorProposal;
+        revision: number;
+    }[];
+    stateRevisions: Record<string, number>;
+}
+export interface BehaviorInspection {
+    npcId: string;
+    sessionId: string;
+    configRevision: number;
+    stateRevision: number;
+    effective: BehaviorSettings & {
+        initialValues: Record<string, number>;
+    };
+    parameters: ParameterDefinition[];
+    values: BehaviorParameterValue[];
+    history: BehaviorChange[];
+}
+export interface BehaviorEditorSnapshot {
+    config: BehaviorConfiguration;
+    operator: BehaviorOperatorPolicy;
+    catalog: {
+        npcs: {
+            npcId: string;
+            label: string;
+        }[];
+        sessions: {
+            sessionId: string;
+            worldId: string;
+            npcIds: string[];
+        }[];
+        groups: {
+            groupId: string;
+            npcIds: string[];
+        }[];
+        worlds: string[];
+    };
+}

package/dist/packages/runtime/src/behavior-types.js

@@ -0,0 +1 @@
+export {};

package/dist/packages/runtime/src/behavior.d.ts

@@ -0,0 +1,40 @@
+import type { ParticipantState, ParticipantStore, SessionAccess } from "./participants.js";
+import type { BehaviorConfiguration, BehaviorOperatorPolicy, BehaviorPermissions, BehaviorSettings, BehaviorInspection, BehaviorProposal, BehaviorEventKind, BehaviorEditorSnapshot } from "./behavior-types.js";
+export type * from "./behavior-types.js";
+export declare const DEFAULT_BEHAVIOR_OPERATOR: Readonly<BehaviorOperatorPolicy>;
+export interface BehaviorLimits {
+    parameters: number;
+    overrides: number;
+    values: number;
+    history: number;
+    observations: number;
+    proposals: number;
+    changesPerProposal: number;
+    evidencePerChange: number;
+}
+export declare const DEFAULT_BEHAVIOR_LIMITS: Readonly<BehaviorLimits>;
+export declare function defaultBehaviorConfiguration(): BehaviorConfiguration;
+/** World -> matching groups in lexicographic ID order -> NPC -> immutable operator denies. */
+export declare function effectiveBehavior(s: ParticipantState, access: SessionAccess, npcId: string, sessionId: string, operator?: BehaviorOperatorPolicy): BehaviorSettings & {
+    initialValues: Record<string, number>;
+};
+export declare function behaviorPermissions(s: ParticipantState, access: SessionAccess, npcId: string, sessionId: string, eventId?: string, operator?: BehaviorOperatorPolicy): BehaviorPermissions;
+export declare const behaviorRevision: (s: ParticipantState) => number;
+/** Previously unobserved/unremembered evidence never becomes implicit model context. */
+export declare function behaviorEvidenceVisible(s: ParticipantState, access: SessionAccess, npcId: string, sessionId: string, eventId: string, operator?: BehaviorOperatorPolicy): boolean;
+export declare function createBehaviorRuntime(store: ParticipantStore, options?: {
+    operator?: BehaviorOperatorPolicy;
+    limits?: Partial<BehaviorLimits>;
+    ceilings?: Partial<BehaviorLimits>;
+}): {
+    read(a: SessionAccess): BehaviorEditorSnapshot;
+    update(a: SessionAccess, expectedRevision: number, config: BehaviorConfiguration): BehaviorConfiguration;
+    adminInspect(a: SessionAccess, sessionId: string, npcId: string): BehaviorInspection;
+    inspect(a: SessionAccess, sessionId: string, npcId: string): BehaviorInspection;
+    observe(a: SessionAccess, sessionId: string, npcId: string, eventId: string, kind: BehaviorEventKind): {
+        observation: import("./behavior-types.js").BehaviorObservation;
+        fresh: boolean;
+    };
+    apply(a: SessionAccess, proposal: BehaviorProposal, nowMs: number): BehaviorInspection;
+    decay(a: SessionAccess, sessionId: string, npcId: string, nowMs: number): BehaviorInspection;
+};