@ziggs-ai/contracts 0.20.0 → 0.21.0

package/dist/index.d.ts

@@ -7,6 +7,7 @@
  * so any runtime can import it.
  */
 export * from './vocabulary';
+export * from './points';
 export * from './chat';
 export * from './inbox';
 export * from './error';

package/dist/index.js

@@ -23,6 +23,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * so any runtime can import it.
  */
 __exportStar(require("./vocabulary"), exports);
+__exportStar(require("./points"), exports);
 __exportStar(require("./chat"), exports);
 __exportStar(require("./inbox"), exports);
 __exportStar(require("./error"), exports);

package/dist/points.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Points, as people and agents read them.
+ *
+ * Amounts travel as integers of hundredths (500 is ϟ5.00). This is the one way
+ * to show one. The web had it (ZIG-1259); the phone, the backend's own notices
+ * and the agent tools each wrote their own and printed `$5.00` or `500 pez`.
+ * `pez` is the wallet's internal unit code and is never shown.
+ */
+/** The unit. Use it rather than typing the glyph. */
+export declare const POINTS_GLYPH = "\u03DF";
+/** An amount. Always renders: zero is `ϟ0.00`. The sign sits outside the glyph: `-ϟ5.00`. */
+export declare function formatPoints(hundredths: number): string;
+/** A price, where no price and zero are the same fact: the work costs nothing. */
+export declare function formatPointsPrice(hundredths: number | null | undefined): string;

package/dist/points.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Points, as people and agents read them.
+ *
+ * Amounts travel as integers of hundredths (500 is ϟ5.00). This is the one way
+ * to show one. The web had it (ZIG-1259); the phone, the backend's own notices
+ * and the agent tools each wrote their own and printed `$5.00` or `500 pez`.
+ * `pez` is the wallet's internal unit code and is never shown.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POINTS_GLYPH = void 0;
+exports.formatPoints = formatPoints;
+exports.formatPointsPrice = formatPointsPrice;
+/** The unit. Use it rather than typing the glyph. */
+exports.POINTS_GLYPH = 'ϟ';
+/** An amount. Always renders: zero is `ϟ0.00`. The sign sits outside the glyph: `-ϟ5.00`. */
+function formatPoints(hundredths) {
+    const sign = hundredths < 0 ? '-' : '';
+    return `${sign}${exports.POINTS_GLYPH}${(Math.abs(hundredths) / 100).toFixed(2)}`;
+}
+/** A price, where no price and zero are the same fact: the work costs nothing. */
+function formatPointsPrice(hundredths) {
+    if (hundredths == null || hundredths === 0)
+        return 'Free';
+    return formatPoints(hundredths);
+}

package/dist/vocabulary.d.ts

@@ -45,3 +45,21 @@ export type InboxPartyKind = 'human' | 'org';
 export type PartyRole = 'payer' | 'provider' | 'creator' | 'proposedTo' | 'providerPrincipal';
 /** What kind of principal sent a message. */
 export type MessageSenderType = 'user' | 'agent' | 'service' | 'system';
+/**
+ * The file formats a file artifact can carry (not its semantic content type).
+ * The server stores and validates against this list; clients offer it as a
+ * tool parameter. `mp3` is stored and downloaded, never text-extracted.
+ */
+export declare const ARTIFACT_FILE_FORMAT: {
+    readonly PDF: "pdf";
+    readonly DOCX: "docx";
+    readonly HWPX: "hwpx";
+    readonly PPTX: "pptx";
+    readonly MD: "md";
+    readonly TXT: "txt";
+    readonly HTML: "html";
+    readonly MP3: "mp3";
+};
+export type ArtifactFileFormat = (typeof ARTIFACT_FILE_FORMAT)[keyof typeof ARTIFACT_FILE_FORMAT];
+/** Every accepted format, in one list. */
+export declare const ARTIFACT_FILE_FORMATS: readonly ArtifactFileFormat[];

package/dist/vocabulary.js

@@ -7,7 +7,7 @@
  * enum, a switch a consumer needs to make exhaustive.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESOURCE_KINDS = exports.CHAT_ADDRESS_KINDS = exports.GRANT_ACCESS_KINDS = void 0;
+exports.ARTIFACT_FILE_FORMATS = exports.ARTIFACT_FILE_FORMAT = exports.RESOURCE_KINDS = exports.CHAT_ADDRESS_KINDS = exports.GRANT_ACCESS_KINDS = void 0;
 /**
  * What a grant lets its holder do with the scope.
  *
@@ -39,3 +39,20 @@ exports.RESOURCE_KINDS = [
     /** Marketplace request doorbell: a typed inbox channel, not a chat. */
     'request',
 ];
+/**
+ * The file formats a file artifact can carry (not its semantic content type).
+ * The server stores and validates against this list; clients offer it as a
+ * tool parameter. `mp3` is stored and downloaded, never text-extracted.
+ */
+exports.ARTIFACT_FILE_FORMAT = {
+    PDF: 'pdf',
+    DOCX: 'docx',
+    HWPX: 'hwpx',
+    PPTX: 'pptx',
+    MD: 'md',
+    TXT: 'txt',
+    HTML: 'html',
+    MP3: 'mp3',
+};
+/** Every accepted format, in one list. */
+exports.ARTIFACT_FILE_FORMATS = Object.values(exports.ARTIFACT_FILE_FORMAT);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/contracts",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Wire contracts for the Ziggs API — response shapes, error body, and socket events, shared by every client.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",