@outfitter/contracts 0.4.1 → 0.4.2

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,60 +0,0 @@
1
- // @bun
2
- // packages/contracts/src/capabilities.ts
3
- var CAPABILITY_SURFACES = ["cli", "mcp", "api", "server"];
4
- var DEFAULT_ACTION_SURFACES = ["cli", "mcp"];
5
- function capability(surfaces = DEFAULT_ACTION_SURFACES, notes) {
6
- return notes ? { surfaces, notes } : { surfaces };
7
- }
8
- function capabilityAll(notes) {
9
- return capability(CAPABILITY_SURFACES, notes);
10
- }
11
- var ACTION_CAPABILITIES = {
12
- navigate: capability(),
13
- back: capability(),
14
- forward: capability(),
15
- reload: capability(),
16
- tab: capability(),
17
- tabs: capability(),
18
- newTab: capability(),
19
- closeTab: capability(),
20
- click: capability(),
21
- type: capability(),
22
- select: capability(),
23
- hover: capability(),
24
- focus: capability(["mcp"]),
25
- scroll: capability(),
26
- press: capability(),
27
- fill: capability(),
28
- find: capability(),
29
- check: capability(),
30
- uncheck: capability(),
31
- upload: capability(),
32
- download: capability(["server"], "Server-only for now"),
33
- dialog: capability(),
34
- waitFor: capability(["mcp"]),
35
- waitForNavigation: capability(["mcp"]),
36
- wait: capability(["mcp"]),
37
- snap: capability(),
38
- screenshot: capability(),
39
- html: capability(["mcp"]),
40
- text: capability(["mcp"]),
41
- marker: capability(),
42
- markers: capability(),
43
- markerGet: capability(),
44
- markerRead: capability(["mcp"]),
45
- markerCompare: capability(),
46
- markerDelete: capability(),
47
- markerResolve: capability(["cli"], "CLI-only for now"),
48
- viewport: capability(),
49
- colorScheme: capability(),
50
- mode: capability(["mcp"]),
51
- evaluate: capability(["mcp"]),
52
- session: capability(),
53
- sessions: capability(["mcp"]),
54
- steps: capability()
55
- };
56
- function getActionsForSurface(surface) {
57
- return Object.entries(ACTION_CAPABILITIES).filter(([, capability2]) => capability2.surfaces.includes(surface)).map(([action]) => action);
58
- }
59
-
60
- export { CAPABILITY_SURFACES, DEFAULT_ACTION_SURFACES, capability, capabilityAll, ACTION_CAPABILITIES, getActionsForSurface };
@@ -1,28 +0,0 @@
1
- // @bun
2
- // packages/contracts/src/actions.ts
3
- var ACTION_SURFACES = ["cli", "mcp", "api", "server"];
4
- var DEFAULT_REGISTRY_SURFACES = ACTION_SURFACES;
5
- function defineAction(action) {
6
- return action;
7
- }
8
- function createActionRegistry() {
9
- const actions = new Map;
10
- return {
11
- add(action) {
12
- actions.set(action.id, action);
13
- return this;
14
- },
15
- list() {
16
- return Array.from(actions.values());
17
- },
18
- get(id) {
19
- return actions.get(id);
20
- },
21
- forSurface(surface) {
22
- const defaults = DEFAULT_REGISTRY_SURFACES;
23
- return Array.from(actions.values()).filter((action) => (action.surfaces ?? defaults).includes(surface));
24
- }
25
- };
26
- }
27
-
28
- export { ACTION_SURFACES, DEFAULT_REGISTRY_SURFACES, defineAction, createActionRegistry };
@@ -1,80 +0,0 @@
1
- // @bun
2
- import {
3
- TimeoutError
4
- } from "./contracts-phjhz5q3.js";
5
-
6
- // packages/contracts/src/resilience.ts
7
- import { Result } from "better-result";
8
- function defaultIsRetryable(error) {
9
- return error.category === "network" || error.category === "timeout" || error.category === "rate_limit";
10
- }
11
- function calculateDelay(attempt, initialDelayMs, maxDelayMs, backoffMultiplier, jitter) {
12
- const baseDelay = initialDelayMs * backoffMultiplier ** (attempt - 1);
13
- const cappedDelay = Math.min(baseDelay, maxDelayMs);
14
- if (jitter) {
15
- const jitterFactor = 0.5 + Math.random();
16
- return Math.floor(cappedDelay * jitterFactor);
17
- }
18
- return cappedDelay;
19
- }
20
- function sleep(ms) {
21
- return new Promise((resolve) => setTimeout(resolve, ms));
22
- }
23
- async function retry(fn, options) {
24
- const maxAttempts = options?.maxAttempts ?? 3;
25
- const initialDelayMs = options?.initialDelayMs ?? 1000;
26
- const maxDelayMs = options?.maxDelayMs ?? 30000;
27
- const backoffMultiplier = options?.backoffMultiplier ?? 2;
28
- const jitter = options?.jitter ?? true;
29
- const isRetryable = options?.isRetryable ?? defaultIsRetryable;
30
- const onRetry = options?.onRetry;
31
- const signal = options?.signal;
32
- let lastError;
33
- let attempt = 0;
34
- while (attempt < maxAttempts) {
35
- attempt++;
36
- if (signal?.aborted) {
37
- return Result.err(lastError ?? new TimeoutError({
38
- message: "Operation cancelled",
39
- operation: "retry",
40
- timeoutMs: 0
41
- }));
42
- }
43
- const result = await fn();
44
- if (result.isOk()) {
45
- return result;
46
- }
47
- lastError = result.error;
48
- if (attempt >= maxAttempts || !isRetryable(lastError)) {
49
- return result;
50
- }
51
- const delayMs = calculateDelay(attempt, initialDelayMs, maxDelayMs, backoffMultiplier, jitter);
52
- if (onRetry) {
53
- onRetry(attempt, lastError, delayMs);
54
- }
55
- await sleep(delayMs);
56
- }
57
- throw new Error("Unexpected: retry loop completed without returning a result");
58
- }
59
- async function withTimeout(fn, options) {
60
- const { timeoutMs, operation = "operation" } = options;
61
- let timeoutId;
62
- const timeoutPromise = new Promise((resolve) => {
63
- timeoutId = setTimeout(() => {
64
- resolve(Result.err(new TimeoutError({
65
- message: `${operation} timed out after ${timeoutMs}ms`,
66
- operation,
67
- timeoutMs
68
- })));
69
- }, timeoutMs);
70
- });
71
- try {
72
- return await Promise.race([fn(), timeoutPromise]);
73
- } finally {
74
- if (timeoutId !== undefined) {
75
- clearTimeout(timeoutId);
76
- }
77
- }
78
- }
79
-
80
- export { retry, withTimeout };
@@ -1,14 +0,0 @@
1
- // @bun
2
- // packages/contracts/src/logging.ts
3
- function createLoggerFactory(adapter) {
4
- return {
5
- createLogger(config) {
6
- return adapter.createLogger(config);
7
- },
8
- async flush() {
9
- await adapter.flush?.();
10
- }
11
- };
12
- }
13
-
14
- export { createLoggerFactory };
@@ -1,341 +0,0 @@
1
- // @bun
2
- // packages/contracts/src/schema.ts
3
- function zodToJsonSchema(schema) {
4
- return convertZodType(schema);
5
- }
6
- function getDef(schemaOrDef) {
7
- if (!schemaOrDef) {
8
- return;
9
- }
10
- if (schemaOrDef._def) {
11
- return schemaOrDef._def;
12
- }
13
- if (schemaOrDef.def) {
14
- return schemaOrDef.def;
15
- }
16
- return schemaOrDef;
17
- }
18
- function getDescription(schema, def) {
19
- if (typeof schema?.description === "string") {
20
- return schema.description;
21
- }
22
- if (typeof def?.description === "string") {
23
- return def.description;
24
- }
25
- return;
26
- }
27
- function convertZodType(schema) {
28
- const def = getDef(schema);
29
- if (!def) {
30
- return {};
31
- }
32
- const typeName = def.typeName ?? def.type;
33
- let jsonSchema;
34
- switch (typeName) {
35
- case "ZodString":
36
- case "string":
37
- jsonSchema = convertString(def);
38
- break;
39
- case "ZodNumber":
40
- case "number":
41
- jsonSchema = convertNumber(def);
42
- break;
43
- case "ZodBoolean":
44
- case "boolean":
45
- jsonSchema = { type: "boolean" };
46
- break;
47
- case "ZodNull":
48
- case "null":
49
- jsonSchema = { type: "null" };
50
- break;
51
- case "ZodUndefined":
52
- case "undefined":
53
- jsonSchema = {};
54
- break;
55
- case "ZodArray":
56
- case "array":
57
- jsonSchema = convertArray(def);
58
- break;
59
- case "ZodObject":
60
- case "object":
61
- jsonSchema = convertObject(def);
62
- break;
63
- case "ZodOptional":
64
- case "optional":
65
- jsonSchema = convertZodType(def.innerType);
66
- break;
67
- case "ZodNullable":
68
- case "nullable":
69
- jsonSchema = {
70
- anyOf: [convertZodType(def.innerType), { type: "null" }]
71
- };
72
- break;
73
- case "ZodDefault":
74
- case "default": {
75
- const defaultValue = typeof def.defaultValue === "function" ? def.defaultValue() : def.defaultValue;
76
- jsonSchema = {
77
- ...convertZodType(def.innerType),
78
- default: defaultValue
79
- };
80
- break;
81
- }
82
- case "ZodEnum":
83
- case "enum": {
84
- const values = def.values ?? Object.values(def.entries ?? {});
85
- jsonSchema = {
86
- type: "string",
87
- enum: values
88
- };
89
- break;
90
- }
91
- case "ZodNativeEnum":
92
- jsonSchema = {
93
- enum: Object.values(def.values ?? def.entries ?? {})
94
- };
95
- break;
96
- case "ZodLiteral":
97
- case "literal": {
98
- const literalValues = Array.isArray(def.values) ? def.values : [def.value].filter((value) => value !== undefined);
99
- if (literalValues.length > 1) {
100
- jsonSchema = {
101
- enum: literalValues
102
- };
103
- break;
104
- }
105
- jsonSchema = literalValues.length ? {
106
- const: literalValues[0]
107
- } : {};
108
- break;
109
- }
110
- case "ZodUnion":
111
- case "union":
112
- jsonSchema = {
113
- anyOf: def.options.map(convertZodType)
114
- };
115
- break;
116
- case "ZodIntersection":
117
- case "intersection":
118
- jsonSchema = {
119
- allOf: [convertZodType(def.left), convertZodType(def.right)]
120
- };
121
- break;
122
- case "ZodRecord":
123
- case "record":
124
- jsonSchema = {
125
- type: "object",
126
- additionalProperties: def.valueType ? convertZodType(def.valueType) : {}
127
- };
128
- break;
129
- case "ZodTuple":
130
- case "tuple":
131
- jsonSchema = {
132
- type: "array",
133
- items: def.items.map(convertZodType)
134
- };
135
- break;
136
- case "ZodAny":
137
- case "any":
138
- jsonSchema = {};
139
- break;
140
- case "ZodUnknown":
141
- case "unknown":
142
- jsonSchema = {};
143
- break;
144
- case "ZodVoid":
145
- case "void":
146
- jsonSchema = {};
147
- break;
148
- case "ZodNever":
149
- case "never":
150
- jsonSchema = { not: {} };
151
- break;
152
- case "ZodEffects":
153
- jsonSchema = convertZodType(def.schema);
154
- break;
155
- case "ZodPipeline":
156
- case "pipe": {
157
- const outputDef = getDef(def.out);
158
- const outputType = outputDef?.typeName ?? outputDef?.type;
159
- jsonSchema = outputType === "transform" ? convertZodType(def.in) : convertZodType(def.out);
160
- break;
161
- }
162
- case "ZodLazy":
163
- case "lazy":
164
- jsonSchema = {};
165
- break;
166
- default:
167
- jsonSchema = {};
168
- break;
169
- }
170
- const description = getDescription(schema, def);
171
- if (description && !jsonSchema.description) {
172
- jsonSchema.description = description;
173
- }
174
- return jsonSchema;
175
- }
176
- function convertString(def) {
177
- const schema = { type: "string" };
178
- if (def.checks) {
179
- for (const check of def.checks) {
180
- const normalizedCheck = check?._zod?.def ?? check?.def ?? check;
181
- if (normalizedCheck?.kind) {
182
- switch (normalizedCheck.kind) {
183
- case "min":
184
- schema.minLength = normalizedCheck.value;
185
- break;
186
- case "max":
187
- schema.maxLength = normalizedCheck.value;
188
- break;
189
- case "length":
190
- schema.minLength = normalizedCheck.value;
191
- schema.maxLength = normalizedCheck.value;
192
- break;
193
- case "email":
194
- schema.pattern = "^[^@]+@[^@]+\\.[^@]+$";
195
- break;
196
- case "url":
197
- schema.pattern = "^https?://";
198
- break;
199
- case "uuid":
200
- schema.pattern = "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$";
201
- break;
202
- case "regex":
203
- schema.pattern = normalizedCheck.regex?.source ?? normalizedCheck.pattern?.source ?? (typeof normalizedCheck.pattern === "string" ? normalizedCheck.pattern : undefined);
204
- break;
205
- default:
206
- break;
207
- }
208
- continue;
209
- }
210
- if (!normalizedCheck?.check) {
211
- continue;
212
- }
213
- switch (normalizedCheck.check) {
214
- case "min_length":
215
- schema.minLength = normalizedCheck.minimum;
216
- break;
217
- case "max_length":
218
- schema.maxLength = normalizedCheck.maximum;
219
- break;
220
- case "string_format":
221
- if (normalizedCheck.pattern) {
222
- schema.pattern = typeof normalizedCheck.pattern === "string" ? normalizedCheck.pattern : normalizedCheck.pattern.source;
223
- }
224
- if (normalizedCheck.format && normalizedCheck.format !== "regex") {
225
- schema.format = normalizedCheck.format;
226
- }
227
- break;
228
- default:
229
- break;
230
- }
231
- }
232
- }
233
- return schema;
234
- }
235
- function convertNumber(def) {
236
- const schema = { type: "number" };
237
- if (def.checks) {
238
- for (const check of def.checks) {
239
- const normalizedCheck = check?._zod?.def ?? check?.def ?? check;
240
- if (normalizedCheck?.kind) {
241
- switch (normalizedCheck.kind) {
242
- case "min":
243
- schema.minimum = normalizedCheck.value;
244
- break;
245
- case "max":
246
- schema.maximum = normalizedCheck.value;
247
- break;
248
- case "int":
249
- schema.type = "integer";
250
- break;
251
- default:
252
- break;
253
- }
254
- continue;
255
- }
256
- if (!normalizedCheck?.check) {
257
- continue;
258
- }
259
- switch (normalizedCheck.check) {
260
- case "greater_than":
261
- if (normalizedCheck.inclusive) {
262
- schema.minimum = normalizedCheck.value;
263
- } else {
264
- schema.exclusiveMinimum = normalizedCheck.value;
265
- }
266
- break;
267
- case "less_than":
268
- if (normalizedCheck.inclusive) {
269
- schema.maximum = normalizedCheck.value;
270
- } else {
271
- schema.exclusiveMaximum = normalizedCheck.value;
272
- }
273
- break;
274
- case "number_format":
275
- if (normalizedCheck.format === "int" || normalizedCheck.format === "safeint") {
276
- schema.type = "integer";
277
- }
278
- break;
279
- default:
280
- break;
281
- }
282
- }
283
- }
284
- return schema;
285
- }
286
- function convertArray(def) {
287
- const element = def.element ?? def.type;
288
- const schema = {
289
- type: "array",
290
- items: element ? convertZodType(element) : {}
291
- };
292
- return schema;
293
- }
294
- function isFieldOptional(fieldDef) {
295
- if (!(fieldDef?.typeName || fieldDef?.type)) {
296
- return false;
297
- }
298
- const typeName = fieldDef.typeName ?? fieldDef.type;
299
- if (typeName === "ZodOptional" || typeName === "ZodDefault" || typeName === "optional" || typeName === "default") {
300
- return true;
301
- }
302
- if (typeName === "ZodEffects") {
303
- return isFieldOptional(getDef(fieldDef.schema));
304
- }
305
- if (typeName === "ZodPipeline" || typeName === "pipe") {
306
- const inputOptional = isFieldOptional(getDef(fieldDef.in));
307
- const outputDef = getDef(fieldDef.out);
308
- const outputType = outputDef?.typeName ?? outputDef?.type;
309
- if (outputType === "transform") {
310
- return inputOptional;
311
- }
312
- const outputOptional = isFieldOptional(outputDef);
313
- return inputOptional && outputOptional;
314
- }
315
- if (typeName === "ZodNullable" || typeName === "nullable") {
316
- return isFieldOptional(getDef(fieldDef.innerType));
317
- }
318
- return false;
319
- }
320
- function convertObject(def) {
321
- const properties = {};
322
- const required = [];
323
- const shape = typeof def.shape === "function" ? def.shape() : def.shape;
324
- for (const [key, value] of Object.entries(shape ?? {})) {
325
- properties[key] = convertZodType(value);
326
- const fieldDef = getDef(value);
327
- if (!isFieldOptional(fieldDef)) {
328
- required.push(key);
329
- }
330
- }
331
- const schema = {
332
- type: "object",
333
- properties
334
- };
335
- if (required.length > 0) {
336
- schema.required = required;
337
- }
338
- return schema;
339
- }
340
-
341
- export { zodToJsonSchema };
@@ -1,32 +0,0 @@
1
- // @bun
2
- // packages/contracts/src/result/utilities.ts
3
- import { Result } from "better-result";
4
- var unwrapOrElse = (result, defaultFn) => {
5
- return result.isOk() ? result.value : defaultFn(result.error);
6
- };
7
- var orElse = (result, fallback) => {
8
- return result.isOk() ? result : fallback;
9
- };
10
- var combine2 = (r1, r2) => {
11
- if (r1.isErr())
12
- return r1;
13
- if (r2.isErr())
14
- return r2;
15
- return Result.ok([r1.value, r2.value]);
16
- };
17
- var combine3 = (r1, r2, r3) => {
18
- if (r1.isErr())
19
- return r1;
20
- if (r2.isErr())
21
- return r2;
22
- if (r3.isErr())
23
- return r3;
24
- return Result.ok([r1.value, r2.value, r3.value]);
25
- };
26
- var expect = (result, message) => {
27
- if (result.isOk())
28
- return result.value;
29
- throw new Error(`${message}: ${String(result.error)}`);
30
- };
31
-
32
- export { unwrapOrElse, orElse, combine2, combine3, expect };
@@ -1,9 +1,4 @@
1
1
  // @bun
2
- import {
3
- DEFAULT_PATTERNS,
4
- DEFAULT_SENSITIVE_KEYS,
5
- createRedactor
6
- } from "./contracts-s15x2rs4.js";
7
2
  import {
8
3
  AlreadyExistsError,
9
4
  AmbiguousError,
@@ -19,6 +14,11 @@ import {
19
14
  TimeoutError,
20
15
  ValidationError
21
16
  } from "./contracts-phjhz5q3.js";
17
+ import {
18
+ DEFAULT_PATTERNS,
19
+ DEFAULT_SENSITIVE_KEYS,
20
+ createRedactor
21
+ } from "./contracts-s15x2rs4.js";
22
22
 
23
23
  // packages/contracts/src/serialization.ts
24
24
  import { Result } from "better-result";