@coffer-org/sdk 2.1.3 → 2.2.0

package/dist/field-presets.d.ts

@@ -152,6 +152,22 @@ export declare function snippet(o: CodeOpts & {
     key?: undefined;
     value?: undefined;
 }): FieldMeta;
+export declare const SOURCE_DEFAULT_MAX_BYTES = 262144;
+export declare function isBinaryText(v: string): boolean;
+export interface SourceOpts extends FieldCoreOpts {
+    label?: string;
+}
+export declare function source(o: SourceOpts & {
+    key: string;
+}): FieldItem;
+export declare function source(o: SourceOpts & {
+    value: unknown;
+    key?: undefined;
+}): StaticEl;
+export declare function source(o: SourceOpts & {
+    key?: undefined;
+    value?: undefined;
+}): FieldMeta;
 export interface RatingOpts extends FieldCoreOpts {
     label?: string;
 }
@@ -242,6 +258,7 @@ export declare const presets: {
     tags: typeof tags;
     markdown: typeof markdown;
     snippet: typeof snippet;
+    source: typeof source;
     rating: typeof rating;
     duration: typeof duration;
     reminder: typeof reminder;

package/dist/field-presets.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { real, int, text, date, select, string, group, vmsg, jsonRefined, typeErr, optionalize, applyMultiple, wrapKey, normalizeOpts, } from "./fields.js";
+import { real, int, text, date, select, string, group, vmsg, jsonRefined, typeErr, reqTypeErr, optionalize, applyMultiple, wrapKey, normalizeOpts, } from "./fields.js";
 export function email(raw) {
     const o = normalizeOpts(raw);
     const required = o.required ?? false;
@@ -225,6 +225,34 @@ export function snippet(raw) {
     };
     return wrapKey(norm, meta);
 }
+export const SOURCE_DEFAULT_MAX_BYTES = 262_144;
+export function isBinaryText(v) {
+    return v.includes('\x00') || v.includes('�');
+}
+export function source(raw) {
+    const o = normalizeOpts(raw);
+    const required = o.required ?? false;
+    const ext = o.ext ?? 'txt';
+    const maxBytes = o.maxBytes ?? SOURCE_DEFAULT_MAX_BYTES;
+    const s = z.string(reqTypeErr()).superRefine((v, ctx) => {
+        if (isBinaryText(v)) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: vmsg('source_binary') });
+            return;
+        }
+        if (new TextEncoder().encode(v).length > maxBytes)
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: vmsg('source_too_large', { maxBytes }) });
+    });
+    const meta = {
+        kind: 'source',
+        label: o.label ?? '',
+        required,
+        prim: 'text',
+        column: 'text',
+        hints: { ext, maxBytes, noEditControl: true },
+        zod: optionalize(s, required),
+    };
+    return wrapKey(o, meta);
+}
 export function rating(raw) {
     const o = normalizeOpts(raw);
     const required = o.required ?? false;
@@ -328,6 +356,7 @@ export const presets = {
     tags,
     markdown,
     snippet,
+    source,
     rating,
     duration,
     reminder,

package/dist/fields/normalize.d.ts

@@ -13,6 +13,8 @@ export interface Rules {
     unique?: string[];
     fixed?: boolean;
     exts?: string[];
+    ext?: string;
+    maxBytes?: number;
     lead?: number;
     by?: FieldItem;
 }
@@ -66,6 +68,8 @@ export type NormalizedOpts = {
     unique?: string[];
     fixed?: boolean;
     exts?: string[];
+    ext?: string;
+    maxBytes?: number;
     lead?: number;
     by?: FieldItem;
     min?: number | string;

package/dist/fields/normalize.js

@@ -28,6 +28,8 @@ export function normalizeOpts(rawIn) {
         unique: r.unique,
         fixed: r.fixed,
         exts: r.exts,
+        ext: r.ext,
+        maxBytes: r.maxBytes,
         lead: r.lead,
         by: r.by,
         min: r.min,

package/dist/shelf.d.ts

@@ -24,6 +24,7 @@ export interface ShelfDef {
     icon?: string;
     claude?: string;
     standalone?: boolean;
+    single?: boolean;
     views?: ShelfViews;
     fields: LayoutEl[];
 }

package/dist/shelf.js

@@ -68,7 +68,9 @@ export function defineShelf(m) {
     const dup = keys.find((k, i) => keys.indexOf(k) !== i);
     if (dup)
         throw new Error(`[shelf] ${m.library}/${m.shelf}: duplicate key '${dup}'`);
-    if (m.standalone !== false && !m.views?.list?.fields?.length)
+    if (m.single && !m.claude)
+        throw new Error(`[shelf] ${m.library}/${m.shelf}: single shelf requires \`claude\` — the agent cannot find it otherwise`);
+    if (m.standalone !== false && !m.single && !m.views?.list?.fields?.length)
         console.warn(`[shelf] ${m.library}/${m.shelf}: standalone shelf without an explicit views.list`);
     return m;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/sdk",
-  "version": "2.1.3",
+  "version": "2.2.0",
   "type": "module",
   "engines": {
     "node": ">=24"