promptopskit 0.3.9 → 0.4.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.
Files changed (70) hide show
  1. package/README.md +91 -7
  2. package/SKILL.md +69 -6
  3. package/dist/{chunk-YNIAA4ZJ.js → chunk-F6UJ73Y6.js} +5 -3
  4. package/dist/chunk-F6UJ73Y6.js.map +1 -0
  5. package/dist/{chunk-O6RQZYS4.js → chunk-HLNVKKMS.js} +16 -5
  6. package/dist/chunk-HLNVKKMS.js.map +1 -0
  7. package/dist/{chunk-4LEPCCSA.js → chunk-JBLUPKY4.js} +144 -3
  8. package/dist/chunk-JBLUPKY4.js.map +1 -0
  9. package/dist/{chunk-LMURMZUA.js → chunk-L2V7LDKD.js} +5 -3
  10. package/dist/chunk-L2V7LDKD.js.map +1 -0
  11. package/dist/{chunk-AN3OR7YC.js → chunk-RY5DVTLV.js} +7 -5
  12. package/dist/chunk-RY5DVTLV.js.map +1 -0
  13. package/dist/chunk-UPTCSWK3.js +60 -0
  14. package/dist/chunk-UPTCSWK3.js.map +1 -0
  15. package/dist/{chunk-V7QY7MRM.js → chunk-XNNDGDPI.js} +50 -3
  16. package/dist/chunk-XNNDGDPI.js.map +1 -0
  17. package/dist/cli/index.js +356 -5
  18. package/dist/cli/index.js.map +1 -1
  19. package/dist/index.cjs +398 -16
  20. package/dist/index.cjs.map +1 -1
  21. package/dist/index.d.cts +4 -4
  22. package/dist/index.d.ts +4 -4
  23. package/dist/index.js +162 -10
  24. package/dist/index.js.map +1 -1
  25. package/dist/providers/anthropic.cjs +200 -5
  26. package/dist/providers/anthropic.cjs.map +1 -1
  27. package/dist/providers/anthropic.d.cts +2 -2
  28. package/dist/providers/anthropic.d.ts +2 -2
  29. package/dist/providers/anthropic.js +3 -3
  30. package/dist/providers/gemini.cjs +191 -5
  31. package/dist/providers/gemini.cjs.map +1 -1
  32. package/dist/providers/gemini.d.cts +2 -2
  33. package/dist/providers/gemini.d.ts +2 -2
  34. package/dist/providers/gemini.js +3 -3
  35. package/dist/providers/openai-responses.cjs +189 -3
  36. package/dist/providers/openai-responses.cjs.map +1 -1
  37. package/dist/providers/openai-responses.d.cts +2 -2
  38. package/dist/providers/openai-responses.d.ts +2 -2
  39. package/dist/providers/openai-responses.js +3 -3
  40. package/dist/providers/openai.cjs +189 -3
  41. package/dist/providers/openai.cjs.map +1 -1
  42. package/dist/providers/openai.d.cts +2 -2
  43. package/dist/providers/openai.d.ts +2 -2
  44. package/dist/providers/openai.js +3 -3
  45. package/dist/providers/openrouter.cjs +224 -6
  46. package/dist/providers/openrouter.cjs.map +1 -1
  47. package/dist/providers/openrouter.d.cts +2 -2
  48. package/dist/providers/openrouter.d.ts +2 -2
  49. package/dist/providers/openrouter.js +4 -4
  50. package/dist/{schema-BKkg93rL.d.cts → schema-B9A1zLRk.d.cts} +482 -2
  51. package/dist/{schema-BKkg93rL.d.ts → schema-B9A1zLRk.d.ts} +482 -2
  52. package/dist/testing.cjs +217 -4
  53. package/dist/testing.cjs.map +1 -1
  54. package/dist/testing.d.cts +59 -2
  55. package/dist/testing.d.ts +59 -2
  56. package/dist/testing.js +70 -2
  57. package/dist/testing.js.map +1 -1
  58. package/dist/{types-CsQ8tON_.d.ts → types-DjGAwJxC.d.ts} +1 -1
  59. package/dist/{types-7cC17GWp.d.cts → types-DpbzzZO2.d.cts} +1 -1
  60. package/dist/usagetap/index.d.cts +2 -2
  61. package/dist/usagetap/index.d.ts +2 -2
  62. package/package.json +2 -2
  63. package/dist/chunk-4LEPCCSA.js.map +0 -1
  64. package/dist/chunk-AN3OR7YC.js.map +0 -1
  65. package/dist/chunk-LMURMZUA.js.map +0 -1
  66. package/dist/chunk-O6RQZYS4.js.map +0 -1
  67. package/dist/chunk-V7QY7MRM.js.map +0 -1
  68. package/dist/chunk-YAD6COQX.js +0 -26
  69. package/dist/chunk-YAD6COQX.js.map +0 -1
  70. package/dist/chunk-YNIAA4ZJ.js.map +0 -1
@@ -103,6 +103,29 @@ function mergeOverride(base, override) {
103
103
  if (override.response !== void 0) {
104
104
  result.response = { ...result.response, ...override.response };
105
105
  }
106
+ if (override.cache !== void 0) {
107
+ result.cache = {
108
+ ...result.cache,
109
+ ...override.cache,
110
+ openai: mergeRecordBlock(result.cache?.openai, override.cache.openai),
111
+ anthropic: mergeRecordBlock(result.cache?.anthropic, override.cache.anthropic),
112
+ gemini: mergeRecordBlock(result.cache?.gemini, override.cache.gemini),
113
+ google: mergeRecordBlock(result.cache?.google, override.cache.google)
114
+ };
115
+ }
116
+ if (override.raw !== void 0) {
117
+ result.raw = {
118
+ ...result.raw,
119
+ ...override.raw,
120
+ openai: mergeRecordBlock(result.raw?.openai, override.raw.openai),
121
+ "openai-responses": mergeRecordBlock(result.raw?.["openai-responses"], override.raw["openai-responses"]),
122
+ openai_responses: mergeRecordBlock(result.raw?.openai_responses, override.raw.openai_responses),
123
+ anthropic: mergeRecordBlock(result.raw?.anthropic, override.raw.anthropic),
124
+ gemini: mergeRecordBlock(result.raw?.gemini, override.raw.gemini),
125
+ google: mergeRecordBlock(result.raw?.google, override.raw.google),
126
+ openrouter: mergeRecordBlock(result.raw?.openrouter, override.raw.openrouter)
127
+ };
128
+ }
106
129
  if (override.provider_options !== void 0) {
107
130
  result.provider_options = {
108
131
  ...result.provider_options,
@@ -114,11 +137,19 @@ function mergeOverride(base, override) {
114
137
  gemini: {
115
138
  ...result.provider_options?.gemini,
116
139
  ...override.provider_options.gemini
140
+ },
141
+ openrouter: {
142
+ ...result.provider_options?.openrouter,
143
+ ...override.provider_options.openrouter
117
144
  }
118
145
  };
119
146
  }
120
147
  return result;
121
148
  }
149
+ function mergeRecordBlock(base, override) {
150
+ if (override === void 0) return base;
151
+ return { ...base, ...override };
152
+ }
122
153
 
123
154
  // src/providers/resolve-asset.ts
124
155
  function resolveAssetForProvider(asset, runtime = {}) {
@@ -222,23 +253,42 @@ var ResponseSchema = import_zod.z.object({
222
253
  stream: import_zod.z.boolean().optional(),
223
254
  schema: import_zod.z.record(import_zod.z.unknown()).optional(),
224
255
  schema_name: import_zod.z.string().optional(),
256
+ schema_description: import_zod.z.string().optional(),
225
257
  schema_strict: import_zod.z.boolean().optional()
226
258
  });
227
259
  var AnthropicProviderOptionsSchema = import_zod.z.object({
228
260
  top_k: import_zod.z.number().int().min(0).optional(),
229
- tool_choice: import_zod.z.record(import_zod.z.unknown()).optional()
261
+ tool_choice: import_zod.z.record(import_zod.z.unknown()).optional(),
262
+ output_config: import_zod.z.record(import_zod.z.unknown()).optional()
230
263
  });
231
264
  var GeminiProviderOptionsSchema = import_zod.z.object({
232
265
  candidate_count: import_zod.z.number().int().positive().optional(),
233
266
  top_k: import_zod.z.number().int().min(0).optional(),
234
267
  seed: import_zod.z.number().int().optional(),
235
268
  response_schema: import_zod.z.record(import_zod.z.unknown()).optional(),
269
+ response_json_schema: import_zod.z.record(import_zod.z.unknown()).optional(),
236
270
  response_modalities: import_zod.z.array(import_zod.z.string()).optional(),
237
271
  thinking_budget_tokens: import_zod.z.number().int().positive().optional()
238
272
  });
273
+ var OpenRouterProviderOptionsSchema = import_zod.z.object({
274
+ provider: import_zod.z.record(import_zod.z.unknown()).optional(),
275
+ transforms: import_zod.z.array(import_zod.z.string()).optional(),
276
+ plugins: import_zod.z.array(import_zod.z.record(import_zod.z.unknown())).optional(),
277
+ models: import_zod.z.array(import_zod.z.string()).optional()
278
+ });
239
279
  var ProviderOptionsSchema = import_zod.z.object({
240
280
  anthropic: AnthropicProviderOptionsSchema.optional(),
241
- gemini: GeminiProviderOptionsSchema.optional()
281
+ gemini: GeminiProviderOptionsSchema.optional(),
282
+ openrouter: OpenRouterProviderOptionsSchema.optional()
283
+ });
284
+ var RawProviderBodySchema = import_zod.z.object({
285
+ openai: import_zod.z.record(import_zod.z.unknown()).optional(),
286
+ "openai-responses": import_zod.z.record(import_zod.z.unknown()).optional(),
287
+ openai_responses: import_zod.z.record(import_zod.z.unknown()).optional(),
288
+ anthropic: import_zod.z.record(import_zod.z.unknown()).optional(),
289
+ gemini: import_zod.z.record(import_zod.z.unknown()).optional(),
290
+ google: import_zod.z.record(import_zod.z.unknown()).optional(),
291
+ openrouter: import_zod.z.record(import_zod.z.unknown()).optional()
242
292
  });
243
293
  var OpenAICacheSchema = import_zod.z.object({
244
294
  prompt_cache_key: import_zod.z.string().min(1).optional(),
@@ -311,6 +361,7 @@ var PromptAssetOverridesSchema = import_zod.z.object({
311
361
  sampling: SamplingSchema.optional(),
312
362
  response: ResponseSchema.optional(),
313
363
  cache: CacheSchema.optional(),
364
+ raw: RawProviderBodySchema.optional(),
314
365
  tools: import_zod.z.array(ToolRefSchema).optional(),
315
366
  provider_options: ProviderOptionsSchema.optional()
316
367
  });
@@ -343,6 +394,7 @@ var PromptAssetSchema = import_zod.z.object({
343
394
  sampling: SamplingSchema.optional(),
344
395
  response: ResponseSchema.optional(),
345
396
  cache: CacheSchema.optional(),
397
+ raw: RawProviderBodySchema.optional(),
346
398
  tools: import_zod.z.array(ToolRefSchema).optional(),
347
399
  provider_options: ProviderOptionsSchema.optional(),
348
400
  mcp: MCPSchema.optional(),
@@ -356,6 +408,123 @@ var PromptAssetSchema = import_zod.z.object({
356
408
  source: SourceSchema.optional()
357
409
  });
358
410
 
411
+ // src/parser/frontmatter-guard.ts
412
+ var FRONT_MATTER_DELIMITER = /^---[ \t]*$/;
413
+ var REGEX_FIELD = /^(?<indent>\s*)(?<field>allow_regex|deny_regex)\s*:\s*(?<value>.*)$/;
414
+ var PATTERN_FIELD = /^(?<indent>\s*)pattern\s*:\s*(?<value>.*)$/;
415
+ var INLINE_PATTERN_FIELD = /(?:^|[{,]\s*)pattern\s*:\s*(?<value>"(?:\\.|[^"\\])*")/;
416
+ function assertRegexFrontMatterQuoting(content, filePath) {
417
+ const frontMatter = extractFrontMatter(content);
418
+ if (!frontMatter) {
419
+ return;
420
+ }
421
+ let pendingRegex;
422
+ for (const [index, line] of frontMatter.lines.entries()) {
423
+ const lineNumber = frontMatter.startLine + index;
424
+ const regexMatch = line.match(REGEX_FIELD);
425
+ if (regexMatch?.groups) {
426
+ const field = regexMatch.groups.field;
427
+ const indent2 = regexMatch.groups.indent.length;
428
+ const value = regexMatch.groups.value.trim();
429
+ pendingRegex = value === "" ? { field, indent: indent2 } : void 0;
430
+ assertNoUnescapedBackslashInDoubleQuotedRegex(value, field, filePath, lineNumber);
431
+ assertNoUnescapedBackslashInInlinePattern(value, field, filePath, lineNumber);
432
+ continue;
433
+ }
434
+ if (!pendingRegex) {
435
+ continue;
436
+ }
437
+ if (line.trim() === "" || line.trimStart().startsWith("#")) {
438
+ continue;
439
+ }
440
+ const indent = line.match(/^\s*/)?.[0].length ?? 0;
441
+ if (indent <= pendingRegex.indent) {
442
+ pendingRegex = void 0;
443
+ continue;
444
+ }
445
+ const patternMatch = line.match(PATTERN_FIELD);
446
+ if (!patternMatch?.groups) {
447
+ continue;
448
+ }
449
+ assertNoUnescapedBackslashInDoubleQuotedRegex(
450
+ patternMatch.groups.value.trim(),
451
+ `${pendingRegex.field}.pattern`,
452
+ filePath,
453
+ lineNumber
454
+ );
455
+ }
456
+ }
457
+ function assertNoUnescapedBackslashInInlinePattern(value, field, filePath, lineNumber) {
458
+ const match = value.match(INLINE_PATTERN_FIELD);
459
+ const pattern = match?.groups?.value;
460
+ if (!pattern) {
461
+ return;
462
+ }
463
+ assertNoUnescapedBackslashInDoubleQuotedRegex(pattern, `${field}.pattern`, filePath, lineNumber);
464
+ }
465
+ function extractFrontMatter(content) {
466
+ const lines = content.split(/\r?\n/);
467
+ if (!FRONT_MATTER_DELIMITER.test(lines[0] ?? "")) {
468
+ return void 0;
469
+ }
470
+ for (let index = 1; index < lines.length; index += 1) {
471
+ if (FRONT_MATTER_DELIMITER.test(lines[index] ?? "")) {
472
+ return {
473
+ lines: lines.slice(1, index),
474
+ startLine: 2
475
+ };
476
+ }
477
+ }
478
+ return void 0;
479
+ }
480
+ function assertNoUnescapedBackslashInDoubleQuotedRegex(value, field, filePath, lineNumber) {
481
+ if (!value.startsWith('"')) {
482
+ return;
483
+ }
484
+ const quoted = readDoubleQuotedScalar(value);
485
+ if (!quoted) {
486
+ return;
487
+ }
488
+ if (!hasUnescapedBackslash(quoted)) {
489
+ return;
490
+ }
491
+ const location = filePath ? `${filePath}:${lineNumber}` : `line ${lineNumber}`;
492
+ throw new Error(
493
+ `POK013: Invalid context regex YAML at ${location}, field "${field}": double-quoted regex strings treat backslashes as YAML escapes. Use unquoted /pattern/i literal form, single quotes, or double each backslash.`
494
+ );
495
+ }
496
+ function readDoubleQuotedScalar(value) {
497
+ let result = "";
498
+ for (let index = 1; index < value.length; index += 1) {
499
+ const char = value[index];
500
+ if (char === '"') {
501
+ return result;
502
+ }
503
+ result += char;
504
+ if (char === "\\" && index + 1 < value.length) {
505
+ index += 1;
506
+ result += value[index];
507
+ }
508
+ }
509
+ return void 0;
510
+ }
511
+ function hasUnescapedBackslash(value) {
512
+ for (let index = 0; index < value.length; index += 1) {
513
+ if (value[index] !== "\\") {
514
+ continue;
515
+ }
516
+ let count = 1;
517
+ while (value[index + count] === "\\") {
518
+ count += 1;
519
+ }
520
+ if (count % 2 === 1) {
521
+ return true;
522
+ }
523
+ index += count - 1;
524
+ }
525
+ return false;
526
+ }
527
+
359
528
  // src/parser/sections.ts
360
529
  var SECTION_MAP = {
361
530
  "system instructions": "system_instructions",
@@ -396,6 +565,7 @@ function extractSections(body) {
396
565
 
397
566
  // src/parser/parser.ts
398
567
  function parsePrompt(content, filePath) {
568
+ assertRegexFrontMatterQuoting(content, filePath);
399
569
  const { data: frontMatter, content: body } = (0, import_gray_matter.default)(content);
400
570
  const sections = extractSections(body);
401
571
  const raw = {
@@ -952,6 +1122,21 @@ function withPromptInputSupport(adapter) {
952
1122
  };
953
1123
  }
954
1124
 
1125
+ // src/providers/raw.ts
1126
+ function applyRawProviderBody(body, asset, provider) {
1127
+ const raw = getRawProviderBody(asset, provider);
1128
+ return raw ? { ...body, ...raw } : body;
1129
+ }
1130
+ function getRawProviderBody(asset, provider) {
1131
+ if (provider === "openai-responses") {
1132
+ return asset.raw?.["openai-responses"] ?? asset.raw?.openai_responses;
1133
+ }
1134
+ if (provider === "gemini") {
1135
+ return asset.raw?.gemini ?? asset.raw?.google;
1136
+ }
1137
+ return asset.raw?.[provider];
1138
+ }
1139
+
955
1140
  // src/providers/anthropic.ts
956
1141
  var anthropicAdapter = withPromptInputSupport({
957
1142
  name: "anthropic",
@@ -971,8 +1156,8 @@ var anthropicAdapter = withPromptInputSupport({
971
1156
  if (resolvedAsset.reasoning?.effort !== void 0) {
972
1157
  warnings.push("Anthropic uses budget_tokens for thinking, not effort. effort will be mapped approximately.");
973
1158
  }
974
- if (resolvedAsset.response?.schema !== void 0) {
975
- warnings.push("Anthropic does not support response.schema structured output in this adapter. It will be ignored.");
1159
+ if (resolvedAsset.response?.schema !== void 0 && resolvedAsset.response?.format !== "json") {
1160
+ warnings.push("Anthropic response.schema is mapped to output_config.format and should usually be paired with response.format: json.");
976
1161
  }
977
1162
  if (resolvedAsset.provider_options?.anthropic?.top_k !== void 0 && resolvedAsset.provider_options.anthropic.top_k < 0) {
978
1163
  errors.push("Anthropic provider_options.top_k must be >= 0.");
@@ -1036,6 +1221,16 @@ var anthropicAdapter = withPromptInputSupport({
1036
1221
  if (resolvedAsset.provider_options?.anthropic?.top_k !== void 0) {
1037
1222
  body.top_k = resolvedAsset.provider_options.anthropic.top_k;
1038
1223
  }
1224
+ if (resolvedAsset.provider_options?.anthropic?.output_config !== void 0) {
1225
+ body.output_config = resolvedAsset.provider_options.anthropic.output_config;
1226
+ } else if (resolvedAsset.response?.schema !== void 0) {
1227
+ body.output_config = {
1228
+ format: {
1229
+ type: "json_schema",
1230
+ schema: resolvedAsset.response.schema
1231
+ }
1232
+ };
1233
+ }
1039
1234
  if (resolvedAsset.response?.stream !== void 0) {
1040
1235
  body.stream = resolvedAsset.response.stream;
1041
1236
  }
@@ -1069,7 +1264,7 @@ var anthropicAdapter = withPromptInputSupport({
1069
1264
  body.tool_choice = resolvedAsset.provider_options.anthropic.tool_choice;
1070
1265
  }
1071
1266
  return {
1072
- body,
1267
+ body: applyRawProviderBody(body, resolvedAsset, "anthropic"),
1073
1268
  provider: "anthropic",
1074
1269
  model: resolvedAsset.model ?? "unknown"
1075
1270
  };