ax 0.8.2 → 0.9.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.
package/dist/index.js CHANGED
@@ -1,27 +1,3 @@
1
- // src/contract/version.ts
2
- var BUILT_AGAINST = "1.27.0";
3
-
4
- // src/contract/index.ts
5
- function minor(version) {
6
- const [major = 0, min = 0] = version.split(".").map((n) => Number.parseInt(n, 10));
7
- return [major, min];
8
- }
9
- function isNewerContract(payloadVersion) {
10
- if (!payloadVersion || !/^\d+\.\d+\.\d+$/.test(payloadVersion)) return false;
11
- const [serverMajor, serverMinor] = minor(payloadVersion);
12
- const [builtMajor, builtMinor] = minor(BUILT_AGAINST);
13
- return serverMajor > builtMajor || serverMajor === builtMajor && serverMinor > builtMinor;
14
- }
15
- var warned = false;
16
- function warnOnNewerContract(payloadVersion) {
17
- if (warned || !isNewerContract(payloadVersion)) return;
18
- warned = true;
19
- process.stderr.write(
20
- `ora reports contract ${payloadVersion}; this CLI was built against ${BUILT_AGAINST}. Newer fields may be missing from the output - upgrade with: npm i -g ax@latest
21
- `
22
- );
23
- }
24
-
25
1
  // src/api/shared.ts
26
2
  function watchdog(ms) {
27
3
  const controller = new AbortController();
@@ -61,8 +37,96 @@ async function errorBodyText(res) {
61
37
  }
62
38
  var pause = (ms) => new Promise((r) => setTimeout(r, ms));
63
39
 
64
- // src/api/audit.ts
40
+ // src/api/agent-files.ts
65
41
  var PUBLIC_BASE = "https://ora.ai";
42
+ var TIMEOUT_MS = 3e4;
43
+ var AgentFilesApiError = class extends Error {
44
+ status;
45
+ payload;
46
+ constructor(message, options = {}) {
47
+ super(message);
48
+ this.name = "AgentFilesApiError";
49
+ this.status = options.status ?? null;
50
+ this.payload = options.payload;
51
+ }
52
+ };
53
+ var SAFE_PATH = /^\/\.well-known\/[a-z0-9][a-z0-9._-]*\.json$/;
54
+ function isSafeAgentFilePath(path) {
55
+ return SAFE_PATH.test(path) && !path.includes("..");
56
+ }
57
+ function trimTrailingSlashes(value) {
58
+ let end = value.length;
59
+ while (end > 0 && value[end - 1] === "/") end--;
60
+ return value.slice(0, end);
61
+ }
62
+ function normalizeDomainInput(input) {
63
+ return trimTrailingSlashes(input.trim().replace(/^https?:\/\//i, ""));
64
+ }
65
+ async function fetchAgentFiles(domain, options = {}) {
66
+ const base = trimTrailingSlashes(options.baseUrl ?? process.env.ORA_API_URL ?? PUBLIC_BASE);
67
+ const url = `${base}/api/agent-files/${encodeURIComponent(normalizeDomainInput(domain))}`;
68
+ let res;
69
+ try {
70
+ res = await fetch(url, {
71
+ headers: { accept: "application/json" },
72
+ signal: AbortSignal.timeout(TIMEOUT_MS)
73
+ });
74
+ } catch (cause) {
75
+ throw new AgentFilesApiError(
76
+ `could not reach ora at ${base}: ${cause instanceof Error ? cause.message : String(cause)}`
77
+ );
78
+ }
79
+ if (!res.ok) {
80
+ const { message, payload } = await errorBody(res);
81
+ throw new AgentFilesApiError(message, { status: res.status, payload });
82
+ }
83
+ const body = await res.json();
84
+ if (!Array.isArray(body?.files)) {
85
+ throw new AgentFilesApiError("ora answered without a files list", {
86
+ status: res.status,
87
+ payload: body
88
+ });
89
+ }
90
+ for (const file of body.files) {
91
+ if (!isSafeAgentFilePath(file.path)) {
92
+ throw new AgentFilesApiError(
93
+ `ora named a file path ax will not write: ${JSON.stringify(file.path)}`,
94
+ {
95
+ status: res.status,
96
+ payload: body
97
+ }
98
+ );
99
+ }
100
+ }
101
+ return body;
102
+ }
103
+
104
+ // src/contract/version.ts
105
+ var BUILT_AGAINST = "1.30.0";
106
+
107
+ // src/contract/index.ts
108
+ function minor(version) {
109
+ const [major = 0, min = 0] = version.split(".").map((n) => Number.parseInt(n, 10));
110
+ return [major, min];
111
+ }
112
+ function isNewerContract(payloadVersion) {
113
+ if (!payloadVersion || !/^\d+\.\d+\.\d+$/.test(payloadVersion)) return false;
114
+ const [serverMajor, serverMinor] = minor(payloadVersion);
115
+ const [builtMajor, builtMinor] = minor(BUILT_AGAINST);
116
+ return serverMajor > builtMajor || serverMajor === builtMajor && serverMinor > builtMinor;
117
+ }
118
+ var warned = false;
119
+ function warnOnNewerContract(payloadVersion) {
120
+ if (warned || !isNewerContract(payloadVersion)) return;
121
+ warned = true;
122
+ process.stderr.write(
123
+ `ora reports contract ${payloadVersion}; this CLI was built against ${BUILT_AGAINST}. Newer fields may be missing from the output - upgrade with: npm i -g ax@latest
124
+ `
125
+ );
126
+ }
127
+
128
+ // src/api/audit.ts
129
+ var PUBLIC_BASE2 = "https://ora.ai";
66
130
  var STREAM_IDLE_MS = 6e4;
67
131
  var POLL_EVERY_MS = 2e3;
68
132
  var POLL_LIMIT = 45;
@@ -81,7 +145,7 @@ function authHeaders(apiKey) {
81
145
  return apiKey ? { authorization: `Bearer ${apiKey}` } : {};
82
146
  }
83
147
  async function performAudit(target, options = {}) {
84
- const base = (options.baseUrl ?? process.env.ORA_API_URL ?? PUBLIC_BASE).replace(/\/+$/, "");
148
+ const base = (options.baseUrl ?? process.env.ORA_API_URL ?? PUBLIC_BASE2).replace(/\/+$/, "");
85
149
  options = { ...options, apiKey: options.apiKey || process.env.ORA_SCAN_API_KEY || void 0 };
86
150
  options.progress?.(`Auditing ${target} with ora`);
87
151
  const streamed = await consumeScanStream(base, target, options);
@@ -261,7 +325,7 @@ function decodeEventBlock(block) {
261
325
  }
262
326
 
263
327
  // src/api/deep-journey.ts
264
- var PUBLIC_BASE2 = "https://ora.ai";
328
+ var PUBLIC_BASE3 = "https://ora.ai";
265
329
  var STREAM_IDLE_MS2 = 12e4;
266
330
  var POLL_EVERY_MS2 = 5e3;
267
331
  var POLL_LIMIT2 = 180;
@@ -281,7 +345,7 @@ var JourneyStreamHttpError = class extends DeepJourneyApiError {
281
345
  retryAfterMs;
282
346
  };
283
347
  function apiBase(baseUrl) {
284
- return (baseUrl ?? process.env.ORA_API_URL ?? PUBLIC_BASE2).replace(/\/+$/, "");
348
+ return (baseUrl ?? process.env.ORA_API_URL ?? PUBLIC_BASE3).replace(/\/+$/, "");
285
349
  }
286
350
  async function getJson(url) {
287
351
  let res;
@@ -567,11 +631,11 @@ async function awaitDetailSettled(base, runId, options) {
567
631
 
568
632
  // src/api/skills.ts
569
633
  import { createHash } from "crypto";
570
- var PUBLIC_BASE3 = "https://ora.ai";
634
+ var PUBLIC_BASE4 = "https://ora.ai";
571
635
  var SkillApiError = class extends Error {
572
636
  };
573
637
  function resolveBase(baseUrl) {
574
- return (baseUrl ?? process.env.ORA_API_URL ?? PUBLIC_BASE3).replace(/\/+$/, "");
638
+ return (baseUrl ?? process.env.ORA_API_URL ?? PUBLIC_BASE4).replace(/\/+$/, "");
575
639
  }
576
640
  async function fetchSkillIndex(baseUrl) {
577
641
  const base = resolveBase(baseUrl);
@@ -621,12 +685,14 @@ async function fetchSkill(name, baseUrl) {
621
685
  return { entry, bytes };
622
686
  }
623
687
  export {
688
+ AgentFilesApiError,
624
689
  AuditApiError,
625
690
  BUILT_AGAINST,
626
691
  DeepJourneyApiError,
627
692
  SkillApiError,
628
693
  performAudit as audit,
629
694
  performDeepJourney as deepJourney,
695
+ fetchAgentFiles,
630
696
  fetchJourneyAgents,
631
697
  fetchJourneyIntents,
632
698
  fetchSkill,