@tethral/acr-sdk 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
- import type { RegistrationRequest, RegistrationResponse, InteractionReceipt, SkillCheckResponse, FrictionReport } from './types.js';
2
- export type { RegistrationRequest, RegistrationResponse, InteractionReceipt, SkillCheckResponse, FrictionReport, ProviderClass, TargetSystemType, InteractionCategory, InteractionStatus, AnomalyCategory, ThreatLevel, FrictionSummary, TargetFriction, } from './types.js';
1
+ import type { RegistrationRequest, RegistrationResponse, InteractionReceipt, SkillCheckResponse, FrictionReport, SkillCatalogEntry, SkillVersionHistory, SkillSearchResult } from './types.js';
2
+ export type { RegistrationRequest, RegistrationResponse, InteractionReceipt, SkillCheckResponse, FrictionReport, ProviderClass, TargetSystemType, InteractionCategory, InteractionStatus, AnomalyCategory, ThreatLevel, FrictionSummary, TargetFriction, SkillCatalogEntry, SkillVersionEntry, SkillVersionHistory, SkillSearchResult, } from './types.js';
3
3
  export interface ACRClientConfig {
4
4
  apiUrl?: string;
5
5
  resolverUrl?: string;
@@ -49,6 +49,32 @@ export declare class ACRClient {
49
49
  database: string;
50
50
  timestamp: string;
51
51
  }>;
52
+ searchSkills(searchQuery: string, options?: {
53
+ source?: string;
54
+ category?: string;
55
+ threat_level?: string;
56
+ limit?: number;
57
+ offset?: number;
58
+ }): Promise<SkillSearchResult>;
59
+ getSkillCatalog(skillId: string): Promise<SkillCatalogEntry>;
60
+ getSkillVersions(skillId: string): Promise<SkillVersionHistory>;
61
+ getSkillChanges(since?: string): Promise<{
62
+ changes: Array<{
63
+ skill_id: string;
64
+ skill_name: string;
65
+ version: string | null;
66
+ content_changed_at: string;
67
+ }>;
68
+ count: number;
69
+ }>;
70
+ getCrawlSources(): Promise<{
71
+ sources: Array<{
72
+ source_id: string;
73
+ source_type: string;
74
+ enabled: boolean;
75
+ last_crawl_status: string;
76
+ }>;
77
+ }>;
52
78
  }
53
79
  export declare class ACRError extends Error {
54
80
  code: string;
package/dist/src/index.js CHANGED
@@ -54,6 +54,34 @@ export class ACRClient {
54
54
  async getHealth() {
55
55
  return this.get('/api/v1/health');
56
56
  }
57
+ // Skill Catalog methods
58
+ async searchSkills(searchQuery, options) {
59
+ const params = new URLSearchParams({ q: searchQuery });
60
+ if (options?.source)
61
+ params.set('source', options.source);
62
+ if (options?.category)
63
+ params.set('category', options.category);
64
+ if (options?.threat_level)
65
+ params.set('threat_level', options.threat_level);
66
+ if (options?.limit)
67
+ params.set('limit', String(options.limit));
68
+ if (options?.offset)
69
+ params.set('offset', String(options.offset));
70
+ return this.get(`/api/v1/skill-catalog/search?${params}`);
71
+ }
72
+ async getSkillCatalog(skillId) {
73
+ return this.get(`/api/v1/skill-catalog/${skillId}`);
74
+ }
75
+ async getSkillVersions(skillId) {
76
+ return this.get(`/api/v1/skill-catalog/${skillId}/versions`);
77
+ }
78
+ async getSkillChanges(since) {
79
+ const params = since ? `?since=${since}` : '';
80
+ return this.get(`/api/v1/skill-catalog/changes${params}`);
81
+ }
82
+ async getCrawlSources() {
83
+ return this.get('/api/v1/skill-catalog/sources');
84
+ }
57
85
  }
58
86
  export class ACRError extends Error {
59
87
  code;
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,SAAS;IACZ,MAAM,CAAS;IACf,WAAW,CAAS;IAE5B,YAAY,SAA0B,EAAE;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,sBAAsB,CAAC;QACjF,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC;IACvD,CAAC;IAEO,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAa;QAC/C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACpH,OAAO,IAAS,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,WAAW,GAAG,KAAK;QACpD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACpH,OAAO,IAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAA4B;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAA+C;QACjE,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAkD;QACrE,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,WAGxC;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAgB;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,kBAAkB,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,QAAoC,KAAK;QAChF,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,OAAO,mBAAmB,KAAK,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IAED,wBAAwB;IAExB,KAAK,CAAC,YAAY,CAAC,WAAmB,EAAE,OAMvC;QACC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QACvD,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,OAAO,EAAE,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,OAAO,EAAE,YAAY;YAAE,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5E,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,GAAG,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,yBAAyB,OAAO,WAAW,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAc;QAClC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,IAAI,CAAS;IACb,UAAU,CAAS;IAEnB,YAAY,IAAY,EAAE,OAAe,EAAE,UAAkB;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,OAAO,EAAE,SAAS,IAAI,OAAO,EAAE,CAAC"}
@@ -77,6 +77,59 @@ export interface SkillCheckResponse {
77
77
  threat_level?: ThreatLevel;
78
78
  first_seen?: string;
79
79
  last_seen?: string;
80
+ description?: string;
81
+ version?: string;
82
+ author?: string;
83
+ category?: string;
84
+ tags?: string[];
85
+ is_current_version?: boolean;
86
+ current_hash?: string;
87
+ versions_behind?: number;
88
+ skill_status?: string;
89
+ }
90
+ export interface SkillCatalogEntry {
91
+ skill_id: string;
92
+ skill_name: string;
93
+ skill_source: string;
94
+ source_url: string;
95
+ current_hash: string | null;
96
+ skill_content?: string | null;
97
+ description: string | null;
98
+ version: string | null;
99
+ author: string | null;
100
+ tags: string[];
101
+ requires: string[];
102
+ category: string | null;
103
+ content_snippet: string | null;
104
+ status: string;
105
+ threat_level?: ThreatLevel;
106
+ agent_count?: number;
107
+ last_crawled_at: string | null;
108
+ content_changed_at: string | null;
109
+ quality_score?: number;
110
+ versions?: SkillVersionEntry[];
111
+ }
112
+ export interface SkillVersionEntry {
113
+ skill_hash: string;
114
+ version: string | null;
115
+ previous_version: string | null;
116
+ change_type: string;
117
+ detected_at: string;
118
+ threat_level?: ThreatLevel;
119
+ agent_count?: number;
120
+ }
121
+ export interface SkillVersionHistory {
122
+ skill_id: string;
123
+ skill_name: string;
124
+ skill_source: string;
125
+ current_version: string | null;
126
+ versions: SkillVersionEntry[];
127
+ }
128
+ export interface SkillSearchResult {
129
+ skills: SkillCatalogEntry[];
130
+ total: number;
131
+ limit: number;
132
+ offset: number;
80
133
  }
81
134
  export interface FrictionSummary {
82
135
  total_interactions: number;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tethral/acr-sdk",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "Zero-dependency TypeScript SDK for the ACR (Agent Composition Records) network.",
5
5
  "type": "module",
6
6
  "main": "dist/src/index.js",
@@ -28,6 +28,6 @@
28
28
  "files": ["dist", "README.md", "LICENSE"],
29
29
  "publishConfig": {
30
30
  "access": "public",
31
- "provenance": true
31
+ "provenance": false
32
32
  }
33
33
  }