@grc-claw/agent-runtime 0.8.0

package/dist/hermes-provider.d.ts

@@ -0,0 +1,38 @@
+import { ToolDefinition } from './index.js';
+export interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content?: string | null;
+    name?: string;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+}
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface HermesProviderConfig {
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+}
+/**
+ * A lightweight, zero-dependency provider for OpenAI-compatible endpoints
+ * (e.g. vLLM, OpenRouter, or local Nemotron/Hermes serving).
+ */
+export declare class HermesProvider {
+    private readonly config;
+    constructor(config: HermesProviderConfig);
+    /**
+     * Translates GRC_Claw tool definitions into OpenAI-compatible JSON Schema.
+     */
+    private formatTools;
+    /**
+     * Calls the LLM and returns the assistant's message.
+     */
+    generate(messages: Message[], availableTools: ToolDefinition[]): Promise<Message>;
+}
+//# sourceMappingURL=hermes-provider.d.ts.map

package/dist/hermes-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-provider.d.ts","sourceRoot":"","sources":["../src/hermes-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,oBAAoB;IAEzD;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CA4BxF"}

package/dist/hermes-provider.js

@@ -0,0 +1,60 @@
+/**
+ * A lightweight, zero-dependency provider for OpenAI-compatible endpoints
+ * (e.g. vLLM, OpenRouter, or local Nemotron/Hermes serving).
+ */
+export class HermesProvider {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Translates GRC_Claw tool definitions into OpenAI-compatible JSON Schema.
+     */
+    formatTools(tools) {
+        return tools.map((tool) => ({
+            type: 'function',
+            function: {
+                name: tool.name.replace(/\./g, '__'), // Encode dots as double underscores
+                description: `Execute the ${tool.name} tool. Tier: ${tool.tier}.`,
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        payload: {
+                            type: 'string',
+                            description: 'JSON string of arguments for the tool'
+                        }
+                    },
+                    required: []
+                }
+            }
+        }));
+    }
+    /**
+     * Calls the LLM and returns the assistant's message.
+     */
+    async generate(messages, availableTools) {
+        const url = `${this.config.baseUrl.replace(/\/+$/, '')}/chat/completions`;
+        const body = {
+            model: this.config.model,
+            messages,
+            tools: this.formatTools(availableTools),
+            tool_choice: 'auto',
+            temperature: 0.1, // Low temp for reliable function calling
+        };
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.config.apiKey}`
+            },
+            body: JSON.stringify(body)
+        });
+        if (!response.ok) {
+            const errText = await response.text();
+            throw new Error(`HermesProvider error (${response.status}): ${errText}`);
+        }
+        const data = await response.json();
+        return data.choices[0].message;
+    }
+}
+//# sourceMappingURL=hermes-provider.js.map

package/dist/hermes-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-provider.js","sourceRoot":"","sources":["../src/hermes-provider.ts"],"names":[],"mappings":"AAyBA;;;GAGG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;IAAG,CAAC;IAE7D;;OAEG;IACK,WAAW,CAAC,KAAuB;QACzC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,oCAAoC;gBAC1E,WAAW,EAAE,eAAe,IAAI,CAAC,IAAI,gBAAgB,IAAI,CAAC,IAAI,GAAG;gBACjE,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,uCAAuC;yBACrD;qBACF;oBACD,QAAQ,EAAE,EAAE;iBACb;aACF;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAmB,EAAE,cAAgC;QAClE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,mBAAmB,CAAC;QAE1E,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,QAAQ;YACR,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;YACvC,WAAW,EAAE,MAAM;YACnB,WAAW,EAAE,GAAG,EAAE,yCAAyC;SAC5D,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;aAC9C;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,CAAC,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACjC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,133 @@
+export type ToolTier = 'read' | 'write' | 'destructive';
+export interface ToolDefinition {
+    name: string;
+    tier: ToolTier;
+    allowedPrefixes?: string[];
+}
+export interface SoDRule {
+    conflictRoleA: string;
+    conflictRoleB: string;
+    ruleName?: string;
+    severity?: 'LOW' | 'MEDIUM' | 'HIGH';
+}
+export interface ExecPolicyConfig {
+    maxCallsPerTurn: number;
+    callTimeoutMs: number;
+    defaultSandbox: 'docker' | 'host';
+    canaryTools?: string[];
+    sodRules?: SoDRule[];
+    nonSovereignProviders?: string[];
+    sovereignRestrictedTools?: string[];
+}
+export interface ToolInvocation {
+    tool: string;
+    args: Record<string, unknown>;
+    approvalToken?: string;
+    idempotencyKey?: string;
+    agentRole?: string;
+    llmProviderId?: string;
+    thought?: string;
+}
+export interface ExecDecision {
+    allowed: boolean;
+    reason: string;
+    sandbox: 'docker' | 'host' | 'denied';
+    requiresApproval: boolean;
+    toxicityScore?: number;
+    anomaliesDetected?: string[];
+}
+export declare const BUILTIN_AGENT_TOOLS: ToolDefinition[];
+/** Three-phase exec policy: allowlist → approval → sandbox + Swarm Harness checks */
+export declare class ExecPolicy {
+    private readonly tools;
+    readonly config: ExecPolicyConfig;
+    constructor(tools?: ToolDefinition[], config?: Partial<ExecPolicyConfig>);
+    evaluate(inv: ToolInvocation, approvedDestructive?: boolean): ExecDecision;
+}
+export interface AgentAuditEntry {
+    at: string;
+    sessionId: string;
+    tool: string;
+    decision: ExecDecision;
+    argsRedacted: Record<string, unknown>;
+}
+export declare function calculateStringSimilarity(s1: string, s2: string): number;
+export declare class AgentSession {
+    readonly sessionId: string;
+    private readonly policy;
+    private readonly store?;
+    private calls;
+    private readonly audit;
+    private toxicityScore;
+    private readonly thoughtsHistory;
+    private readonly callHistory;
+    constructor(sessionId: string, policy: ExecPolicy, store?: PersistentMemoryStore | undefined);
+    getState(): {
+        calls: number;
+        toxicityScore: number;
+        callHistory: {
+            tool: string;
+            argsString: string;
+            agentRole?: string;
+            timestamp: number;
+        }[];
+        audit: AgentAuditEntry[];
+        thoughtsHistory: string[];
+    };
+    loadState(state: any): void;
+    invoke(inv: ToolInvocation): Promise<ExecDecision>;
+    getAuditLog(): AgentAuditEntry[];
+    getToxicityScore(): number;
+}
+export declare class PersistentMemoryStore {
+    private memoryDir;
+    constructor(memoryDir?: string);
+    saveSession(session: AgentSession): void;
+    loadSession(sessionId: string, session: AgentSession): boolean;
+}
+export interface MemoryNode {
+    id: string;
+    label: string;
+    type: string;
+    properties: Record<string, any>;
+}
+export interface MemoryEdge {
+    source: string;
+    target: string;
+    relationship: string;
+}
+export declare class VectorGraphMemory {
+    private nodes;
+    private edges;
+    constructor();
+    query(queryText: string): {
+        nodes: MemoryNode[];
+        edges: MemoryEdge[];
+    };
+    queryHomomorphic(queryCiphertext: string, publicKeyHash: string): {
+        resultsCiphertext: string;
+        matchesCount: number;
+    };
+}
+export interface SkillDefinition {
+    id: string;
+    name: string;
+    category: string;
+    description: string;
+    playbook: {
+        steps: string[];
+        requiredInputs: string[];
+        outputs: string[];
+    };
+    source: string;
+}
+export declare class SkillsRegistry {
+    private skills;
+    constructor();
+    query(queryText: string): SkillDefinition[];
+    load(id: string): SkillDefinition | undefined;
+    getTotalCount(): number;
+}
+export * from './hermes-provider.js';
+export * from './orchestrator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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