dashclaw 2.2.0 → 2.3.0

package/README.md

@@ -75,7 +75,7 @@ claw.update_outcome(action_id, status="completed")
 The v2.1.5 SDK is optimized for stability and zero-overhead governance:
 
 ### Core Runtime
-- `guard(context)` -- Policy evaluation ("Can I do X?")
+- `guard(context)` -- Policy evaluation ("Can I do X?"). Returns `risk_score` (server-computed) and `agent_risk_score` (raw agent value)
 - `createAction(action)` -- Lifecycle tracking ("I am doing X")
 - `updateOutcome(id, outcome)` -- Result recording ("X finished with Y")
 - `recordAssumption(assumption)` -- Integrity tracking ("I believe Z while doing X")
@@ -99,7 +99,23 @@ The v2.1.5 SDK is optimized for stability and zero-overhead governance:
 
 ### Compliance & Audit
 - `createScorer(name, type, config)` -- Define automated evaluations.
-- `createScoringProfile(profile)` -- Weighted quality scoring.
+- `createScoringProfile(profile)` -- Create a weighted multi-dimensional scoring profile.
+- `listScoringProfiles(filters)` -- List all scoring profiles.
+- `getScoringProfile(profileId)` -- Get a profile with its dimensions.
+- `updateScoringProfile(profileId, updates)` -- Update profile metadata or composite method.
+- `deleteScoringProfile(profileId)` -- Delete a scoring profile.
+- `addScoringDimension(profileId, dimension)` -- Add a dimension to a profile.
+- `updateScoringDimension(profileId, dimensionId, updates)` -- Update a dimension's scale or weight.
+- `deleteScoringDimension(profileId, dimensionId)` -- Remove a dimension from a profile.
+- `scoreWithProfile(profileId, action)` -- Score a single action; returns composite + per-dimension breakdown.
+- `batchScoreWithProfile(profileId, actions)` -- Score multiple actions; returns results + summary stats.
+- `getProfileScores(filters)` -- List stored profile scores (filter by profile_id, agent_id, action_id).
+- `getProfileScoreStats(profileId)` -- Aggregate stats: avg, min, max, stddev for a profile.
+- `createRiskTemplate(template)` -- Define rules for automatic risk score computation.
+- `listRiskTemplates(filters)` -- List all risk templates.
+- `updateRiskTemplate(templateId, updates)` -- Update a risk template's rules or base_risk.
+- `deleteRiskTemplate(templateId)` -- Delete a risk template.
+- `autoCalibrate(options)` -- Analyze historical actions and suggest percentile-based scoring scales.
 - `mapCompliance(framework)` -- Map behavior to regulatory controls.
 - `getProofReport(format)` -- Generate audit-ready evidence exports.
 - `getActivityLogs(filters)` -- Query the immutable audit trail.

package/dashclaw.js

@@ -57,6 +57,10 @@ class DashClaw {
     const data = await res.json();
 
     if (!res.ok) {
+      if (res.status === 403 && data.decision && data.decision.decision === 'block') {
+        throw new GuardBlockedError(data.decision);
+      }
+
       // Prioritize reason (from governance blocks) over generic error field
       const errorMessage = data.reason || data.error || `Request failed with status ${res.status}`;
       const err = new Error(errorMessage);
@@ -309,6 +313,118 @@ class DashClaw {
     return this._request('/api/scoring/profiles', 'POST', profile);
   }
 
+  /**
+   * GET /api/scoring/profiles
+   */
+  async listScoringProfiles(filters = {}) {
+    return this._request('/api/scoring/profiles', 'GET', null, filters);
+  }
+
+  /**
+   * GET /api/scoring/profiles/:id
+   */
+  async getScoringProfile(profileId) {
+    return this._request(`/api/scoring/profiles/${profileId}`, 'GET');
+  }
+
+  /**
+   * PATCH /api/scoring/profiles/:id
+   */
+  async updateScoringProfile(profileId, updates) {
+    return this._request(`/api/scoring/profiles/${profileId}`, 'PATCH', updates);
+  }
+
+  /**
+   * DELETE /api/scoring/profiles/:id
+   */
+  async deleteScoringProfile(profileId) {
+    return this._request(`/api/scoring/profiles/${profileId}`, 'DELETE');
+  }
+
+  /**
+   * POST /api/scoring/profiles/:id/dimensions
+   */
+  async addScoringDimension(profileId, dimension) {
+    return this._request(`/api/scoring/profiles/${profileId}/dimensions`, 'POST', dimension);
+  }
+
+  /**
+   * PATCH /api/scoring/profiles/:id/dimensions/:dimId
+   */
+  async updateScoringDimension(profileId, dimensionId, updates) {
+    return this._request(`/api/scoring/profiles/${profileId}/dimensions/${dimensionId}`, 'PATCH', updates);
+  }
+
+  /**
+   * DELETE /api/scoring/profiles/:id/dimensions/:dimId
+   */
+  async deleteScoringDimension(profileId, dimensionId) {
+    return this._request(`/api/scoring/profiles/${profileId}/dimensions/${dimensionId}`, 'DELETE');
+  }
+
+  /**
+   * POST /api/scoring/score — score a single action against a profile
+   */
+  async scoreWithProfile(profileId, action) {
+    return this._request('/api/scoring/score', 'POST', { profile_id: profileId, action });
+  }
+
+  /**
+   * POST /api/scoring/score — batch score multiple actions against a profile
+   */
+  async batchScoreWithProfile(profileId, actions) {
+    return this._request('/api/scoring/score', 'POST', { profile_id: profileId, actions });
+  }
+
+  /**
+   * GET /api/scoring/score — list stored profile scores
+   */
+  async getProfileScores(filters = {}) {
+    return this._request('/api/scoring/score', 'GET', null, filters);
+  }
+
+  /**
+   * GET /api/scoring/score?view=stats — aggregate stats for a profile
+   */
+  async getProfileScoreStats(profileId) {
+    return this._request('/api/scoring/score', 'GET', null, { profile_id: profileId, view: 'stats' });
+  }
+
+  /**
+   * POST /api/scoring/risk-templates
+   */
+  async createRiskTemplate(template) {
+    return this._request('/api/scoring/risk-templates', 'POST', template);
+  }
+
+  /**
+   * GET /api/scoring/risk-templates
+   */
+  async listRiskTemplates(filters = {}) {
+    return this._request('/api/scoring/risk-templates', 'GET', null, filters);
+  }
+
+  /**
+   * PATCH /api/scoring/risk-templates/:id
+   */
+  async updateRiskTemplate(templateId, updates) {
+    return this._request(`/api/scoring/risk-templates/${templateId}`, 'PATCH', updates);
+  }
+
+  /**
+   * DELETE /api/scoring/risk-templates/:id
+   */
+  async deleteRiskTemplate(templateId) {
+    return this._request(`/api/scoring/risk-templates/${templateId}`, 'DELETE');
+  }
+
+  /**
+   * POST /api/scoring/calibrate — analyze historical data and suggest dimension thresholds
+   */
+  async autoCalibrate(options = {}) {
+    return this._request('/api/scoring/calibrate', 'POST', options);
+  }
+
   /**
    * GET /api/compliance/map
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dashclaw",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Minimal governance runtime for AI agents. Intercept, govern, and verify agent actions.",
   "type": "module",
   "publishConfig": {