@advicenxt/sbp-server 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,247 @@
+/**
+ * SBP Core Types
+ * Stigmergic Blackboard Protocol v0.1
+ */
+export interface ExponentialDecay {
+    type: "exponential";
+    half_life_ms: number;
+}
+export interface LinearDecay {
+    type: "linear";
+    rate_per_ms: number;
+}
+export interface StepDecay {
+    type: "step";
+    steps: Array<{
+        at_ms: number;
+        intensity: number;
+    }>;
+}
+export interface ImmortalDecay {
+    type: "immortal";
+}
+export type DecayModel = ExponentialDecay | LinearDecay | StepDecay | ImmortalDecay;
+export interface Pheromone {
+    id: string;
+    trail: string;
+    type: string;
+    emitted_at: number;
+    last_reinforced_at: number;
+    initial_intensity: number;
+    decay_model: DecayModel;
+    payload: Record<string, unknown>;
+    source_agent?: string;
+    tags: string[];
+    ttl_floor: number;
+}
+export interface PheromoneSnapshot {
+    id: string;
+    trail: string;
+    type: string;
+    current_intensity: number;
+    payload: Record<string, unknown>;
+    age_ms: number;
+    tags: string[];
+}
+export interface TagFilter {
+    any?: string[];
+    all?: string[];
+    none?: string[];
+}
+export interface ThresholdCondition {
+    type: "threshold";
+    trail: string;
+    signal_type: string;
+    tags?: TagFilter;
+    aggregation: "sum" | "max" | "avg" | "count" | "any";
+    operator: ">=" | ">" | "<=" | "<" | "==" | "!=";
+    value: number;
+}
+export interface CompositeCondition {
+    type: "composite";
+    operator: "and" | "or" | "not";
+    conditions: ScentCondition[];
+}
+export interface RateCondition {
+    type: "rate";
+    trail: string;
+    signal_type: string;
+    metric: "emissions_per_second" | "intensity_delta";
+    window_ms: number;
+    operator: ">=" | ">" | "<=" | "<";
+    value: number;
+}
+export interface PatternCondition {
+    type: "pattern";
+    /** Sequence of pheromone types to match */
+    sequence: Array<{
+        trail: string;
+        signal_type: string;
+        min_intensity?: number;
+    }>;
+    /** Time window in which the full sequence must appear */
+    window_ms: number;
+    /** Whether the sequence must appear in order (default: true) */
+    ordered?: boolean;
+}
+export type ScentCondition = ThresholdCondition | CompositeCondition | RateCondition | PatternCondition;
+export type MergeStrategy = "reinforce" | "replace" | "max" | "add" | "new";
+export type TriggerMode = "level" | "edge_rising" | "edge_falling";
+export interface Scent {
+    scent_id: string;
+    agent_endpoint: string;
+    condition: ScentCondition;
+    cooldown_ms: number;
+    activation_payload: Record<string, unknown>;
+    trigger_mode: TriggerMode;
+    hysteresis: number;
+    max_execution_ms: number;
+    last_triggered_at: number | null;
+    last_condition_met: boolean;
+    context_trails?: string[];
+}
+export interface EmitParams {
+    trail: string;
+    type: string;
+    intensity: number;
+    decay?: DecayModel;
+    payload?: Record<string, unknown>;
+    tags?: string[];
+    merge_strategy?: MergeStrategy;
+    source_agent?: string;
+}
+export interface EmitResult {
+    pheromone_id: string;
+    action: "created" | "reinforced" | "replaced" | "merged";
+    previous_intensity?: number;
+    new_intensity: number;
+}
+export interface SniffParams {
+    trails?: string[];
+    types?: string[];
+    min_intensity?: number;
+    max_age_ms?: number;
+    tags?: TagFilter;
+    limit?: number;
+    include_evaporated?: boolean;
+}
+export interface AggregateStats {
+    count: number;
+    sum_intensity: number;
+    max_intensity: number;
+    avg_intensity: number;
+}
+export interface SniffResult {
+    timestamp: number;
+    pheromones: PheromoneSnapshot[];
+    aggregates: Record<string, AggregateStats>;
+}
+export interface RegisterScentParams {
+    scent_id: string;
+    agent_endpoint: string;
+    condition: ScentCondition;
+    cooldown_ms?: number;
+    activation_payload?: Record<string, unknown>;
+    trigger_mode?: TriggerMode;
+    hysteresis?: number;
+    max_execution_ms?: number;
+    context_trails?: string[];
+}
+export interface RegisterScentResult {
+    scent_id: string;
+    status: "registered" | "updated";
+    current_condition_state: {
+        met: boolean;
+        partial?: Record<string, boolean>;
+    };
+}
+export interface DeregisterScentParams {
+    scent_id: string;
+}
+export interface DeregisterScentResult {
+    scent_id: string;
+    status: "deregistered" | "not_found";
+}
+export interface TriggerPayload {
+    scent_id: string;
+    triggered_at: number;
+    condition_snapshot: Record<string, {
+        value: number;
+        pheromone_ids: string[];
+    }>;
+    context_pheromones: PheromoneSnapshot[];
+    activation_payload: Record<string, unknown>;
+}
+export interface EvaporateParams {
+    trail?: string;
+    types?: string[];
+    older_than_ms?: number;
+    below_intensity?: number;
+    tags?: TagFilter;
+}
+export interface EvaporateResult {
+    evaporated_count: number;
+    trails_affected: string[];
+}
+export interface InspectParams {
+    include?: Array<"trails" | "scents" | "stats">;
+}
+export interface TrailInfo {
+    name: string;
+    pheromone_count: number;
+    total_intensity: number;
+    avg_intensity: number;
+}
+export interface ScentInfo {
+    scent_id: string;
+    agent_endpoint: string;
+    condition_met: boolean;
+    in_cooldown: boolean;
+    last_triggered_at: number | null;
+}
+export interface InspectResult {
+    timestamp: number;
+    trails?: TrailInfo[];
+    scents?: ScentInfo[];
+    stats?: {
+        total_pheromones: number;
+        active_pheromones: number;
+        total_scents: number;
+        uptime_ms: number;
+    };
+}
+export interface JsonRpcRequest<T = unknown> {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params: T;
+}
+export interface JsonRpcSuccessResponse<T = unknown> {
+    jsonrpc: "2.0";
+    id: string | number;
+    result: T;
+}
+export interface JsonRpcErrorResponse {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export type JsonRpcResponse<T = unknown> = JsonRpcSuccessResponse<T> | JsonRpcErrorResponse;
+export declare const SBP_ERROR_CODES: {
+    readonly TRAIL_NOT_FOUND: -32001;
+    readonly SCENT_NOT_FOUND: -32002;
+    readonly PAYLOAD_VALIDATION_FAILED: -32003;
+    readonly RATE_LIMITED: -32004;
+    readonly UNAUTHORIZED: -32005;
+    readonly INVALID_CONDITION: -32006;
+};
+export declare class SbpError extends Error {
+    code: number;
+    data?: unknown | undefined;
+    constructor(code: number, message: string, data?: unknown | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,26 @@
+/**
+ * SBP Core Types
+ * Stigmergic Blackboard Protocol v0.1
+ */
+// ============================================================================
+// ERROR CODES
+// ============================================================================
+export const SBP_ERROR_CODES = {
+    TRAIL_NOT_FOUND: -32001,
+    SCENT_NOT_FOUND: -32002,
+    PAYLOAD_VALIDATION_FAILED: -32003,
+    RATE_LIMITED: -32004,
+    UNAUTHORIZED: -32005,
+    INVALID_CONDITION: -32006,
+};
+export class SbpError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = "SbpError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgSH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe,EAAE,CAAC,KAAK;IACvB,eAAe,EAAE,CAAC,KAAK;IACvB,yBAAyB,EAAE,CAAC,KAAK;IACjC,YAAY,EAAE,CAAC,KAAK;IACpB,YAAY,EAAE,CAAC,KAAK;IACpB,iBAAiB,EAAE,CAAC,KAAK;CACjB,CAAC;AAEX,MAAM,OAAO,QAAS,SAAQ,KAAK;IAExB;IAEA;IAHT,YACS,IAAY,EACnB,OAAe,EACR,IAAc;QAErB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QAEZ,SAAI,GAAJ,IAAI,CAAU;QAGrB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/validation.d.ts

@@ -0,0 +1,296 @@
+/**
+ * SBP Input Validation
+ * Zod schemas for all JSON-RPC params and protocol messages
+ */
+import { z } from "zod";
+export declare const EmitParamsSchema: z.ZodObject<{
+    trail: z.ZodString;
+    type: z.ZodString;
+    intensity: z.ZodNumber;
+    decay: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"exponential">;
+        half_life_ms: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        half_life_ms: number;
+        type: "exponential";
+    }, {
+        half_life_ms: number;
+        type: "exponential";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"linear">;
+        rate_per_ms: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "linear";
+        rate_per_ms: number;
+    }, {
+        type: "linear";
+        rate_per_ms: number;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"step">;
+        steps: z.ZodArray<z.ZodObject<{
+            at_ms: z.ZodNumber;
+            intensity: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            intensity: number;
+            at_ms: number;
+        }, {
+            intensity: number;
+            at_ms: number;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "step";
+        steps: {
+            intensity: number;
+            at_ms: number;
+        }[];
+    }, {
+        type: "step";
+        steps: {
+            intensity: number;
+            at_ms: number;
+        }[];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"immortal">;
+    }, "strip", z.ZodTypeAny, {
+        type: "immortal";
+    }, {
+        type: "immortal";
+    }>]>>;
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    merge_strategy: z.ZodOptional<z.ZodEnum<["reinforce", "replace", "max", "add", "new"]>>;
+    source_agent: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    trail: string;
+    type: string;
+    intensity: number;
+    decay?: {
+        half_life_ms: number;
+        type: "exponential";
+    } | {
+        type: "linear";
+        rate_per_ms: number;
+    } | {
+        type: "step";
+        steps: {
+            intensity: number;
+            at_ms: number;
+        }[];
+    } | {
+        type: "immortal";
+    } | undefined;
+    payload?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    merge_strategy?: "max" | "reinforce" | "replace" | "add" | "new" | undefined;
+    source_agent?: string | undefined;
+}, {
+    trail: string;
+    type: string;
+    intensity: number;
+    decay?: {
+        half_life_ms: number;
+        type: "exponential";
+    } | {
+        type: "linear";
+        rate_per_ms: number;
+    } | {
+        type: "step";
+        steps: {
+            intensity: number;
+            at_ms: number;
+        }[];
+    } | {
+        type: "immortal";
+    } | undefined;
+    payload?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    merge_strategy?: "max" | "reinforce" | "replace" | "add" | "new" | undefined;
+    source_agent?: string | undefined;
+}>;
+export declare const SniffParamsSchema: z.ZodObject<{
+    trails: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    min_intensity: z.ZodOptional<z.ZodNumber>;
+    max_age_ms: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodObject<{
+        any: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        all: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        none: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        any?: string[] | undefined;
+        all?: string[] | undefined;
+        none?: string[] | undefined;
+    }, {
+        any?: string[] | undefined;
+        all?: string[] | undefined;
+        none?: string[] | undefined;
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    include_evaporated: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    trails?: string[] | undefined;
+    tags?: {
+        any?: string[] | undefined;
+        all?: string[] | undefined;
+        none?: string[] | undefined;
+    } | undefined;
+    types?: string[] | undefined;
+    min_intensity?: number | undefined;
+    max_age_ms?: number | undefined;
+    limit?: number | undefined;
+    include_evaporated?: boolean | undefined;
+}, {
+    trails?: string[] | undefined;
+    tags?: {
+        any?: string[] | undefined;
+        all?: string[] | undefined;
+        none?: string[] | undefined;
+    } | undefined;
+    types?: string[] | undefined;
+    min_intensity?: number | undefined;
+    max_age_ms?: number | undefined;
+    limit?: number | undefined;
+    include_evaporated?: boolean | undefined;
+}>;
+export declare const RegisterScentParamsSchema: z.ZodObject<{
+    scent_id: z.ZodString;
+    agent_endpoint: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    condition: z.ZodType<any, z.ZodTypeDef, any>;
+    cooldown_ms: z.ZodOptional<z.ZodNumber>;
+    activation_payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    trigger_mode: z.ZodOptional<z.ZodEnum<["level", "edge_rising", "edge_falling"]>>;
+    hysteresis: z.ZodOptional<z.ZodNumber>;
+    max_execution_ms: z.ZodOptional<z.ZodNumber>;
+    context_trails: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    scent_id: string;
+    agent_endpoint: string;
+    condition?: any;
+    cooldown_ms?: number | undefined;
+    activation_payload?: Record<string, unknown> | undefined;
+    trigger_mode?: "level" | "edge_rising" | "edge_falling" | undefined;
+    hysteresis?: number | undefined;
+    max_execution_ms?: number | undefined;
+    context_trails?: string[] | undefined;
+}, {
+    scent_id: string;
+    agent_endpoint?: string | undefined;
+    condition?: any;
+    cooldown_ms?: number | undefined;
+    activation_payload?: Record<string, unknown> | undefined;
+    trigger_mode?: "level" | "edge_rising" | "edge_falling" | undefined;
+    hysteresis?: number | undefined;
+    max_execution_ms?: number | undefined;
+    context_trails?: string[] | undefined;
+}>;
+export declare const DeregisterScentParamsSchema: z.ZodObject<{
+    scent_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    scent_id: string;
+}, {
+    scent_id: string;
+}>;
+export declare const EvaporateParamsSchema: z.ZodObject<{
+    trail: z.ZodOptional<z.ZodString>;
+    types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    older_than_ms: z.ZodOptional<z.ZodNumber>;
+    below_intensity: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodObject<{
+        any: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        all: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        none: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        any?: string[] | undefined;
+        all?: string[] | undefined;
+        none?: string[] | undefined;
+    }, {
+        any?: string[] | undefined;
+        all?: string[] | undefined;
+        none?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    trail?: string | undefined;
+    tags?: {
+        any?: string[] | undefined;
+        all?: string[] | undefined;
+        none?: string[] | undefined;
+    } | undefined;
+    types?: string[] | undefined;
+    older_than_ms?: number | undefined;
+    below_intensity?: number | undefined;
+}, {
+    trail?: string | undefined;
+    tags?: {
+        any?: string[] | undefined;
+        all?: string[] | undefined;
+        none?: string[] | undefined;
+    } | undefined;
+    types?: string[] | undefined;
+    older_than_ms?: number | undefined;
+    below_intensity?: number | undefined;
+}>;
+export declare const InspectParamsSchema: z.ZodObject<{
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<["trails", "scents", "stats"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    include?: ("trails" | "scents" | "stats")[] | undefined;
+}, {
+    include?: ("trails" | "scents" | "stats")[] | undefined;
+}>;
+export declare const SubscribeParamsSchema: z.ZodObject<{
+    scent_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    scent_id: string;
+}, {
+    scent_id: string;
+}>;
+export declare const UnsubscribeParamsSchema: z.ZodObject<{
+    scent_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    scent_id: string;
+}, {
+    scent_id: string;
+}>;
+export declare const JsonRpcRequestSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    method: z.ZodString;
+    params: z.ZodDefault<z.ZodOptional<z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string | number;
+    method: string;
+    jsonrpc: "2.0";
+    params?: unknown;
+}, {
+    id: string | number;
+    method: string;
+    jsonrpc: "2.0";
+    params?: unknown;
+}>;
+export interface ValidationError {
+    code: -32600 | -32602;
+    message: string;
+    data?: unknown;
+}
+/**
+ * Validate a JSON-RPC request envelope.
+ * Returns the parsed request or a JSON-RPC error.
+ */
+export declare function validateEnvelope(body: unknown): {
+    ok: true;
+    request: z.infer<typeof JsonRpcRequestSchema>;
+} | {
+    ok: false;
+    error: ValidationError;
+};
+/**
+ * Validate method-specific params.
+ * Returns the parsed params or a JSON-RPC error.
+ */
+export declare function validateParams(method: string, params: unknown): {
+    ok: true;
+    params: unknown;
+} | {
+    ok: false;
+    error: ValidationError;
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4GxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUpC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;EAEtC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMhC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AAMH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAkBH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,GACZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAarG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GACd;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAmBvE"}