@wanasapps/deluge-core 1.2.0 → 1.3.0

package/README.md

@@ -51,6 +51,23 @@ deluge.language.EXTENSIONS;       // ['.ds', '.dg', '.deluge']
 deluge.language.assetPaths;       // absolute paths to the raw files
 ```
 
+## Agent skills
+
+Two generated documents, both from `assets/deluge-reference.json` (scraped from Zoho's Deluge help) via `scripts/gen-skill.js`:
+
+```js
+deluge.language.skill();      // the guide an agent loads while writing Deluge
+deluge.language.reference();  // every statement, data type, function and task, with syntax
+```
+
+`skill()` is the one that ships as `SKILL.md`, so it has a budget: the Agent Skills specification recommends a body under **5,000 tokens**, because it is loaded in full whenever the skill triggers.
+
+It used to be 6,476, because it inlined a name index of all 337 built-in functions and integration tasks — **every one of which already appears in `reference()`, with its exact syntax, parameters and return type**. That index cost ~1,800 tokens on every trigger and bought nothing.
+
+It is now category counts plus a pointer, and the guide is **4,911 tokens**. The guarantee an agent actually needs is unchanged, just relocated: *if a name is not in the reference, it does not exist in Deluge — do not invent one.* A test fails if the body drifts back over the limit.
+
+Hosts should install `reference()` beside the skill (zone writes it to `references/REFERENCE.md`) so the third disclosure stage — load a resource only when needed — actually works.
+
 ## Analysis
 
 Editor-agnostic: returns plain objects, so the same engine can back a `vscode.Diagnostic`, a CLI check, or a CI gate.

package/assets/DELUGE_SKILL.md

@@ -315,7 +315,7 @@ zone crm fn invoke my_function --args '{"id":"1"}'       # call the SAVED functi
 
 # Part 2 — Everything that exists (names only)
 
-Every documented statement, built-in function and integration task, by name, generated from https://www.zoho.com/deluge/help/ (scraped 2026-09-03). If a name is not here, it does not exist in Deluge — do not invent one. For a function's exact syntax, parameters and return type, load the companion skill `zoho-deluge-reference` (or run `zone llm deluge-reference`).
+What exists in Deluge, generated from https://www.zoho.com/deluge/help/ (scraped 2026-09-03). Statements and data types are listed in full below because they are few. The 209 built-in functions and 139 integration tasks are summarised by category — **every one of them is named, with its exact syntax, parameters and return type, in the companion reference**: read `references/REFERENCE.md` in this skill folder, or run `zone llm deluge-reference`. If a name is not there, it does not exist in Deluge — do not invent one.
 
 ## Statements
 
@@ -325,65 +325,13 @@ Every documented statement, built-in function and integration task, by name, gen
 
 `boolean` · `collection` · `date-time` · `decimal` · `key-value` · `list` · `number` · `text` · `time` · `typed list`
 
-## Built-in functions
+## Built-in functions — 209 across 9 categories
 
-**Text** (52): `concat`, `contains`, `containsIgnoreCase`, `endsWith`, `endsWithIgnoreCase`, `equalsIgnoreCase`, `find`, `getAlpha`, `getAlphaNumeric`, `getOccurenceCount`, `getPrefix`, `getPrefixIgnoreCase`, `getSuffix`, `getSuffixIgnoreCase`, `hexToText`, `indexOf`, `isAscii`, `isEmpty`, `lastIndexOf`, `left`, `leftpad`, `len`, `length`, `ltrim`, `matches`, `mid`, `notContains`, `proper`, `remove`, `removeAllAlpha`, `removeAllAlphaNumeric`, `removeFirstOccurence`, `removeLastOccurence`, `repeat`, `replaceAll`, `replaceAllIgnoreCase`, `replaceFirst`, `replaceFirstIgnoreCase`, `reverse`, `right`, `rightpad`, `rtrim`, `startsWith`, `startsWithIgnoreCase`, `subString`, `subText`, `textToHex`, `toList`, `toLowerCase`, `toMap`, `toUpperCase`, `trim`
+**Text** (52) · **Number** (38) · **List** (16) · **Key-value (Map)** (10) · **Collection** (22) · **Date-time** (46) · **Common / conversion** (17) · **Encryption** (6) · **XML** (2)
 
-**Number** (38): `abs`, `acos`, `acosh`, `asin`, `asinh`, `atan`, `atan2`, `atanh`, `average`, `ceil`, `cos`, `cosh`, `exp`, `floor`, `frac`, `isEven`, `isOdd`, `largest`, `log`, `log10`, `max`, `median`, `min`, `nextWeekDay`, `nthLargest`, `nthSmallest`, `power`, `range`, `round`, `sin`, `sinh`, `smallest`, `sqrt`, `tan`, `tanh`, `toHex`, `toText`, `toWords`
+## Integration tasks — 139 across 19 products
 
-**List** (16): `add`, `addAll`, `clear`, `contains`, `distinct`, `get`, `indexOf`, `intersect`, `lastIndexOf`, `remove`, `removeAll`, `removeElement`, `size`, `sort`, `subList`, `toListString`
-
-**Key-value (Map)** (10): `clear`, `containKey`, `containValue`, `get`, `isEmpty`, `keys`, `put`, `putAll`, `remove`, `size`
-
-**Collection** (22): `clear`, `containsKey`, `containsValue`, `delete`, `deleteAll`, `deleteKey`, `deleteKeys`, `distinct`, `duplicate`, `get`, `getKey`, `getLastKey`, `insert`, `insertAll`, `intersect`, `isEmpty`, `keys`, `size`, `sort`, `sortKey`, `update`, `values`
-
-**Date-time** (46): `addBusinessDay`, `addDay`, `addHour`, `addMinutes`, `addMonth`, `addSeconds`, `addWeek`, `addYear`, `day`, `days360`, `daysBetween`, `edate`, `eomonth`, `getDay`, `getDayOfYear`, `getHour`, `getMinutes`, `getMonth`, `getSeconds`, `getWeekOfYear`, `getYear`, `hour`, `hoursBetween`, `minute`, `month`, `monthsBetween`, `now`, `previousWeekDay`, `second`, `subBusinessDay`, `subDay`, `subHour`, `subMinutes`, `subMonth`, `subSeconds`, `subWeek`, `subYear`, `today`, `toStartOfMonth`, `toStartOfWeek`, `totalMonths`, `totalYears`, `unixEpoch`, `weekday`, `workday`, `yearsBetween`
-
-**Common / conversion** (17): `encodeUrl`, `getJson`, `isBlank`, `isDate`, `isFile`, `isNull`, `isNumber`, `isText`, `toDate`, `toDateTimeString`, `toDecimal`, `toJSONList`, `toLong`, `toNumber`, `toString`, `toText`, `toTime`
-
-**Encryption** (6): `aesDecode`, `aesDecode128`, `aesEncode`, `aesEncode128`, `urlDecode`, `urlEncode`
-
-**XML** (2): `toXml`, `toXmlList`
-
-## Integration tasks
-
-**Zoho CRM** (18): `zoho.crm.getAllMeta (via invokeConnector)`, `zoho.crm.getModMeta (via invokeConnector)`, `zoho.crm.getOrgInfo (via invokeConnector)`, `zoho.crm.getOrgVariable`, `zoho.crm.getRecords`, `zoho.crm.setOrganizationVariable (via invokeConnector)`, `zoho.crm.v8.bulkCreate`, `zoho.crm.v8.bulkUpdate`, `zoho.crm.v8.convertLead`, `zoho.crm.v8.createRecord`, `zoho.crm.v8.getFields`, `zoho.crm.v8.getRecordById`, `zoho.crm.v8.getRecords`, `zoho.crm.v8.getRelatedRecords`, `zoho.crm.v8.searchRecords`, `zoho.crm.v8.updateRecord`, `zoho.crm.v8.updateRelatedRecord`, `zoho.crm.v8.upsert`
-
-**Zoho Analytics** (3): `zoho.reports.createRow`, `zoho.reports.deleteRow`, `zoho.reports.updateData`
-
-**Zoho Bookings** (6): `zoho.bookings.createAppointment`, `zoho.bookings.getAvailableSlots`, `zoho.bookings.getRecordById`, `zoho.bookings.getRelatedRecords`, `zoho.bookings.getWorkspaces`, `zoho.bookings.updateRecord`
-
-**Zoho Books** (7): `zoho.books.createRecord`, `zoho.books.getOrganizations`, `zoho.books.getRecords`, `zoho.books.getRecordsByID`, `zoho.books.getTemplates`, `zoho.books.markStatus`, `zoho.books.updateRecord`
-
-**Zoho Calendar** (1): `zoho.calendar.createEvent`
-
-**Zoho Cliq** (10): `zoho.cliq.createRecord`, `zoho.cliq.deleteRecord`, `zoho.cliq.deleteRecords`, `zoho.cliq.getRecordById`, `zoho.cliq.getRecords`, `zoho.cliq.postToBot`, `zoho.cliq.postToChannel`, `zoho.cliq.postToChat`, `zoho.cliq.postToUser`, `zoho.cliq.updateRecord`
-
-**Zoho Creator** (5): `zoho.creator.createRecord`, `zoho.creator.getRecordById`, `zoho.creator.getRecords`, `zoho.creator.updateRecord`, `zoho.creator.updateRecords`
-
-**Zoho Desk** (12): `zoho.desk.create`, `zoho.desk.createRelatedRecord`, `zoho.desk.getRecordById`, `zoho.desk.getRecords`, `zoho.desk.getRelatedRecordById`, `zoho.desk.getRelatedRecords`, `zoho.desk.searchRecords`, `zoho.desk.ticket.merge`, `zoho.desk.ticket.move`, `zoho.desk.ticket.split`, `zoho.desk.update`, `zoho.desk.updateRelatedRecord`
-
-**Zoho Inventory** (6): `zoho.inventory.createRecord`, `zoho.inventory.getOrganizations`, `zoho.inventory.getRecords`, `zoho.inventory.getRecordsByID`, `zoho.inventory.markStatus`, `zoho.inventory.updateRecord`
-
-**Zoho Invoice** (4): `zoho.invoice.create`, `zoho.invoice.getRecordById`, `zoho.invoice.getRecords`, `zoho.invoice.update`
-
-**Zoho Mail** (11): `zoho.mail.createFolder`, `zoho.mail.createTag`, `zoho.mail.getFolders`, `zoho.mail.getLabels`, `zoho.mail.getMessage`, `zoho.mail.markAsRead`, `zoho.mail.markAsUnread`, `zoho.mail.moveToFolder`, `zoho.mail.removeFlag`, `zoho.mail.setFlag`, `zoho.mail.setTag`
-
-**Zoho People** (4): `zoho.people.create`, `zoho.people.getRecordById`, `zoho.people.getRecords`, `zoho.people.update`
-
-**Zoho Projects** (9): `zoho.projects.associateLogs`, `zoho.projects.create`, `zoho.projects.createProject`, `zoho.projects.getPortals`, `zoho.projects.getProjectDetails`, `zoho.projects.getRecordById`, `zoho.projects.getRecords`, `zoho.projects.update`, `zoho.projects.updateAssociateLogs`
-
-**Zoho Recruit** (5): `zoho.recruit.addRecord`, `zoho.recruit.getRecordbyId`, `zoho.recruit.getRecords`, `zoho.recruit.searchRecords`, `zoho.recruit.updateRecord`
-
-**Zoho SalesIQ** (2): `zoho.salesiq.visitorsession.get`, `zoho.salesiq.visitorsession.set`
-
-**Zoho Sheet** (7): `zoho.sheet.createRecords`, `zoho.sheet.find`, `zoho.sheet.getRecords`, `zoho.sheet.getSheets`, `zoho.sheet.insertCSV`, `zoho.sheet.replace`, `zoho.sheet.updateRecords`
-
-**Zoho Billing (Subscriptions)** (4): `zoho.billing.create`, `zoho.billing.getList`, `zoho.billing.retrieve`, `zoho.billing.update`
-
-**Zoho WorkDrive** (3): `zoho.workdrive.createFolder`, `zoho.workdrive.createTeamFolder`, `zoho.workdrive.uploadFile`
-
-**Zoho Writer** (22): `zoho.writer.documents.favorite`, `zoho.writer.documents.lock`, `zoho.writer.documents.MarkAsFinal`, `zoho.writer.documents.markAsReady`, `zoho.writer.documents.setDescription`, `zoho.writer.documents.setName`, `zoho.writer.documents.trackchanges`, `zoho.writer.generateFillableLink`, `zoho.writer.getAllFields`, `zoho.writer.getDocuments`, `zoho.writer.getMergeFields`, `zoho.writer.getMergeTemplates`, `zoho.writer.getSignTemplates`, `zoho.writer.mergeAndInvoke`, `zoho.writer.mergeAndSend`, `zoho.writer.mergeAndSign`, `zoho.writer.shareDocument`, `zoho.writer.signDocument`, `zoho.writer.uploadDocument`, `zoho.writer.v2.mergeAndSend`, `zoho.writer.v2.mergeAndStore`, `zoho.writer.v2.signDocument`
+**Zoho CRM** (18) · **Zoho Analytics** (3) · **Zoho Bookings** (6) · **Zoho Books** (7) · **Zoho Calendar** (1) · **Zoho Cliq** (10) · **Zoho Creator** (5) · **Zoho Desk** (12) · **Zoho Inventory** (6) · **Zoho Invoice** (4) · **Zoho Mail** (11) · **Zoho People** (4) · **Zoho Projects** (9) · **Zoho Recruit** (5) · **Zoho SalesIQ** (2) · **Zoho Sheet** (7) · **Zoho Billing (Subscriptions)** (4) · **Zoho WorkDrive** (3) · **Zoho Writer** (22)
 
 ## System variables