@mochabug/adaptkit 1.0.0-rc.5 → 1.0.0-rc.51

package/bin/genproto/mochabugapis/adapt/graph/signal_binding_pb.d.ts

@@ -1,86 +1,317 @@
-import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
-import type { Value, ValueJson } from "@bufbuild/protobuf/wkt";
-import type { SignalDescriptor, SignalDescriptorJson } from "./signal_descriptor_pb";
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { SignalFormat, SignalFormatJson } from "./signal_format_pb";
 import type { Message } from "@bufbuild/protobuf";
 /**
  * Describes the file mochabugapis/adapt/graph/signal_binding.proto.
  */
 export declare const file_mochabugapis_adapt_graph_signal_binding: GenFile;
 /**
- * Receiver represents an input point for a vertex, which can bind
- * to multiple signals.
+ * SignalBinding represents an input point for a vertex in the computation graph.
+ * Unlike SignalDescriptor which describes what a signal IS (producing one specific format),
+ * a binding describes what formats an input ACCEPTS (potentially accepting multiple formats).
+ *
+ * Bindings enable flexible graph construction by allowing vertices to accept data in
+ * various compatible formats. For example, a text display component might accept strings,
+ * numbers, dates, and booleans, while an image viewer might accept image/* MIME types.
+ *
+ * The binding is connected via a reference — either to a signal in the graph or to a
+ * project-level constant. Validation ensures the format matches one of the accepted formats.
  *
  * @generated from message mochabugapis.adapt.graph.SignalBinding
  */
 export type SignalBinding = Message<"mochabugapis.adapt.graph.SignalBinding"> & {
     /**
-     * The actual signal descriptor.
+     * Identifier for this binding point, following ECMAScript identifier conventions.
+     * Must be unique within the vertex's binding collection.
+     *
+     * Pattern: Must start with letter, $, or _, followed by letters, digits, $, or _
+     * Length: 1-50 characters
      *
-     * @generated from field: mochabugapis.adapt.graph.SignalDescriptor descriptor = 1;
+     * Examples: "inputText", "image_data", "$config", "_internalParam"
+     *
+     * @generated from field: string name = 1;
      */
-    descriptor?: SignalDescriptor;
+    name: string;
     /**
-     * The binding can be a reference to another signal or a constant value.
-     * not required to be set if the descriptor is optional
+     * Human-readable label for the binding, suitable for display in user interfaces.
+     * Describes what this input represents in the context of the vertex.
+     *
+     * Length: Up to 250 characters
      *
-     * @generated from oneof mochabugapis.adapt.graph.SignalBinding.binding
+     * Examples: "Text to Display", "Source Image", "Configuration Object"
+     *
+     * @generated from field: optional string label = 2;
      */
-    binding: {
-        /**
-         * A reference to another signal <vertexid>:<transmitter>:<signal>
-         *
-         * @generated from field: string reference = 2;
-         */
-        value: string;
-        case: "reference";
-    } | {
-        /**
-         * A constant value (must validate against the descriptor)
-         *
-         * @generated from field: google.protobuf.Value constant = 3;
-         */
-        value: Value;
-        case: "constant";
-    } | {
-        case: undefined;
-        value?: undefined;
-    };
+    label?: string;
     /**
-     * The binding may also have one of the 3 error codes
+     * Detailed description of the binding's purpose and accepted data.
+     * Should document what the vertex does with this input and any constraints.
+     *
+     * Length: Up to 1000 characters
+     *
+     * May include:
+     * - What the binding represents in the vertex's operation
+     * - How the data is used or transformed
+     * - Constraints on values or formats
+     * - Examples of valid inputs
      *
-     * @generated from field: optional mochabugapis.adapt.graph.SignalBinding.Error error = 4;
+     * @generated from field: optional string description = 3;
+     */
+    description?: string;
+    /**
+     * Indicates whether this binding must be connected.
+     *
+     * When false or unset: Binding is required and must be connected
+     * When true: Binding is optional and may be left unbound
+     *
+     * Optional bindings provide flexibility, allowing vertices to function
+     * with or without certain inputs (e.g., optional configuration parameters).
+     *
+     * @generated from field: optional bool optional = 4;
+     */
+    optional?: boolean;
+    /**
+     * List of formats this binding accepts. The binding will accept any signal whose
+     * format matches at least one entry in this list.
+     *
+     * Format matching rules:
+     * - JTD schemas: Structural compatibility according to JTD specification
+     * - MIME types (exact): Exact string match (case-insensitive)
+     * - MIME types (wildcard): Pattern matching with * wildcards
+     *   - "image/*" matches "image/png", "image/jpeg", "image/webp", etc.
+     *   - "text/*" matches "text/plain", "text/html", "text/csv", etc.
+     *   - "application/*" matches any application type
+     *
+     * Common patterns:
+     *
+     * Example 1: Text display (accepts primitive types for display as text)
+     *   accepts = [
+     *     { jtd_schema: { type: "string" } },
+     *     { jtd_schema: { type: "float32" } },
+     *     { jtd_schema: { type: "float64" } },
+     *     { jtd_schema: { type: "int32" } },
+     *     { jtd_schema: { type: "boolean" } },
+     *     { jtd_schema: { type: "timestamp" } }
+     *   ]
+     *
+     * Example 2: Image viewer (accepts displayable image formats)
+     *   accepts = [
+     *     { mime_type: "image/*" }  // Accepts any image type
+     *   ]
+     *
+     * Example 3: Document viewer (accepts specific document types)
+     *   accepts = [
+     *     { mime_type: "application/pdf" },
+     *     { mime_type: "text/html" },
+     *     { mime_type: "text/plain" }
+     *   ]
+     *
+     * Example 4: Data processor (accepts structured data)
+     *   accepts = [
+     *     { jtd_schema: { elements: { type: "string" } } },  // Array of strings
+     *     { jtd_schema: { properties: { id: { type: "string" } } } }  // Object with id
+     *   ]
+     *
+     * Validation: At least one format must be specified. Maximum 50 formats to prevent
+     * overly permissive bindings and ensure reasonable validation performance.
+     *
+     * @generated from field: repeated mochabugapis.adapt.graph.SignalFormat accepts = 5;
+     */
+    accepts: SignalFormat[];
+    /**
+     * Reference to another signal in the graph, or a project-level constant.
+     *
+     * Signal reference format: <vertex_id>/<transmitter_name>/<signal_name>
+     * - vertex_id: 4-character alphanumeric identifier (lowercase)
+     * - transmitter_name: ECMAScript identifier for the output transmitter
+     * - signal_name: ECMAScript identifier for the specific signal
+     *
+     * Constant reference format: constant/<constant_name>
+     * - constant_name: ECMAScript identifier for the project-level constant
+     *
+     * Examples:
+     * - "a1b2/output/temperature"    (signal reference)
+     * - "xyz9/results/processedData" (signal reference)
+     * - "constant/apiKey"            (constant reference)
+     * - "constant/threshold"         (constant reference)
+     *
+     * Signal references are resolved during execution by reading from the
+     * referenced transmitter. Constant references are baked into the published
+     * run and must be valid at publish time.
+     *
+     * The referenced signal's or constant's format must match one of the
+     * accepted formats. Validation occurs at graph construction time.
+     *
+     * @generated from field: string reference = 6;
+     */
+    reference: string;
+    /**
+     * Error state of this binding, if any.
+     * Set by the graph validation system when issues are detected.
+     * Should not be set to ERROR_UNSPECIFIED (value 0).
+     *
+     * When unset: Binding is valid
+     * When set: Binding has the specified error and requires correction
+     *
+     * Applications should check this field and provide appropriate user feedback
+     * for bindings in error states.
+     *
+     * @generated from field: optional mochabugapis.adapt.graph.SignalBinding.Error error = 8;
      */
     error?: SignalBinding_Error;
 };
 /**
- * Receiver represents an input point for a vertex, which can bind
- * to multiple signals.
+ * SignalBinding represents an input point for a vertex in the computation graph.
+ * Unlike SignalDescriptor which describes what a signal IS (producing one specific format),
+ * a binding describes what formats an input ACCEPTS (potentially accepting multiple formats).
+ *
+ * Bindings enable flexible graph construction by allowing vertices to accept data in
+ * various compatible formats. For example, a text display component might accept strings,
+ * numbers, dates, and booleans, while an image viewer might accept image/* MIME types.
+ *
+ * The binding is connected via a reference — either to a signal in the graph or to a
+ * project-level constant. Validation ensures the format matches one of the accepted formats.
  *
  * @generated from message mochabugapis.adapt.graph.SignalBinding
  */
 export type SignalBindingJson = {
     /**
-     * The actual signal descriptor.
+     * Identifier for this binding point, following ECMAScript identifier conventions.
+     * Must be unique within the vertex's binding collection.
+     *
+     * Pattern: Must start with letter, $, or _, followed by letters, digits, $, or _
+     * Length: 1-50 characters
+     *
+     * Examples: "inputText", "image_data", "$config", "_internalParam"
      *
-     * @generated from field: mochabugapis.adapt.graph.SignalDescriptor descriptor = 1;
+     * @generated from field: string name = 1;
      */
-    descriptor?: SignalDescriptorJson;
+    name?: string;
     /**
-     * A reference to another signal <vertexid>:<transmitter>:<signal>
+     * Human-readable label for the binding, suitable for display in user interfaces.
+     * Describes what this input represents in the context of the vertex.
+     *
+     * Length: Up to 250 characters
+     *
+     * Examples: "Text to Display", "Source Image", "Configuration Object"
      *
-     * @generated from field: string reference = 2;
+     * @generated from field: optional string label = 2;
      */
-    reference?: string;
+    label?: string;
     /**
-     * A constant value (must validate against the descriptor)
+     * Detailed description of the binding's purpose and accepted data.
+     * Should document what the vertex does with this input and any constraints.
+     *
+     * Length: Up to 1000 characters
+     *
+     * May include:
+     * - What the binding represents in the vertex's operation
+     * - How the data is used or transformed
+     * - Constraints on values or formats
+     * - Examples of valid inputs
      *
-     * @generated from field: google.protobuf.Value constant = 3;
+     * @generated from field: optional string description = 3;
      */
-    constant?: ValueJson;
+    description?: string;
     /**
-     * The binding may also have one of the 3 error codes
+     * Indicates whether this binding must be connected.
+     *
+     * When false or unset: Binding is required and must be connected
+     * When true: Binding is optional and may be left unbound
+     *
+     * Optional bindings provide flexibility, allowing vertices to function
+     * with or without certain inputs (e.g., optional configuration parameters).
      *
-     * @generated from field: optional mochabugapis.adapt.graph.SignalBinding.Error error = 4;
+     * @generated from field: optional bool optional = 4;
+     */
+    optional?: boolean;
+    /**
+     * List of formats this binding accepts. The binding will accept any signal whose
+     * format matches at least one entry in this list.
+     *
+     * Format matching rules:
+     * - JTD schemas: Structural compatibility according to JTD specification
+     * - MIME types (exact): Exact string match (case-insensitive)
+     * - MIME types (wildcard): Pattern matching with * wildcards
+     *   - "image/*" matches "image/png", "image/jpeg", "image/webp", etc.
+     *   - "text/*" matches "text/plain", "text/html", "text/csv", etc.
+     *   - "application/*" matches any application type
+     *
+     * Common patterns:
+     *
+     * Example 1: Text display (accepts primitive types for display as text)
+     *   accepts = [
+     *     { jtd_schema: { type: "string" } },
+     *     { jtd_schema: { type: "float32" } },
+     *     { jtd_schema: { type: "float64" } },
+     *     { jtd_schema: { type: "int32" } },
+     *     { jtd_schema: { type: "boolean" } },
+     *     { jtd_schema: { type: "timestamp" } }
+     *   ]
+     *
+     * Example 2: Image viewer (accepts displayable image formats)
+     *   accepts = [
+     *     { mime_type: "image/*" }  // Accepts any image type
+     *   ]
+     *
+     * Example 3: Document viewer (accepts specific document types)
+     *   accepts = [
+     *     { mime_type: "application/pdf" },
+     *     { mime_type: "text/html" },
+     *     { mime_type: "text/plain" }
+     *   ]
+     *
+     * Example 4: Data processor (accepts structured data)
+     *   accepts = [
+     *     { jtd_schema: { elements: { type: "string" } } },  // Array of strings
+     *     { jtd_schema: { properties: { id: { type: "string" } } } }  // Object with id
+     *   ]
+     *
+     * Validation: At least one format must be specified. Maximum 50 formats to prevent
+     * overly permissive bindings and ensure reasonable validation performance.
+     *
+     * @generated from field: repeated mochabugapis.adapt.graph.SignalFormat accepts = 5;
+     */
+    accepts?: SignalFormatJson[];
+    /**
+     * Reference to another signal in the graph, or a project-level constant.
+     *
+     * Signal reference format: <vertex_id>/<transmitter_name>/<signal_name>
+     * - vertex_id: 4-character alphanumeric identifier (lowercase)
+     * - transmitter_name: ECMAScript identifier for the output transmitter
+     * - signal_name: ECMAScript identifier for the specific signal
+     *
+     * Constant reference format: constant/<constant_name>
+     * - constant_name: ECMAScript identifier for the project-level constant
+     *
+     * Examples:
+     * - "a1b2/output/temperature"    (signal reference)
+     * - "xyz9/results/processedData" (signal reference)
+     * - "constant/apiKey"            (constant reference)
+     * - "constant/threshold"         (constant reference)
+     *
+     * Signal references are resolved during execution by reading from the
+     * referenced transmitter. Constant references are baked into the published
+     * run and must be valid at publish time.
+     *
+     * The referenced signal's or constant's format must match one of the
+     * accepted formats. Validation occurs at graph construction time.
+     *
+     * @generated from field: string reference = 6;
+     */
+    reference?: string;
+    /**
+     * Error state of this binding, if any.
+     * Set by the graph validation system when issues are detected.
+     * Should not be set to ERROR_UNSPECIFIED (value 0).
+     *
+     * When unset: Binding is valid
+     * When set: Binding has the specified error and requires correction
+     *
+     * Applications should check this field and provide appropriate user feedback
+     * for bindings in error states.
+     *
+     * @generated from field: optional mochabugapis.adapt.graph.SignalBinding.Error error = 8;
      */
     error?: SignalBinding_ErrorJson;
 };
@@ -88,40 +319,65 @@ export type SignalBindingJson = {
  * Describes the message mochabugapis.adapt.graph.SignalBinding.
  * Use `create(SignalBindingSchema)` to create a new message.
  */
-export declare const SignalBindingSchema: GenMessage<SignalBinding, SignalBindingJson>;
+export declare const SignalBindingSchema: GenMessage<SignalBinding, {
+    jsonType: SignalBindingJson;
+}>;
 /**
- * Some error codes that can appear on the binding
+ * Error codes that can occur during binding validation or resolution.
+ * These errors are typically set by the graph validation system.
  *
  * @generated from enum mochabugapis.adapt.graph.SignalBinding.Error
  */
 export declare enum SignalBinding_Error {
     /**
-     * Not specified
+     * No error specified. This value should never be explicitly set as it indicates
+     * the absence of an error. The error field should be unset for valid bindings.
      *
      * @generated from enum value: ERROR_UNSPECIFIED = 0;
      */
     UNSPECIFIED = 0,
     /**
-     * Binding is missing, the signal is unbound even though the descriptor requires it to be bound
+     * The binding is unbound (no reference provided) despite being required.
+     * This occurs when:
+     * - The binding is not marked as optional
+     * - The 'reference' field is not set
+     *
+     * Resolution: Provide a signal reference or a constant reference.
      *
      * @generated from enum value: ERROR_UNBOUND = 1;
      */
     UNBOUND = 1,
     /**
-     * The source does not exist
+     * The referenced signal source does not exist in the graph.
+     * This occurs when:
+     * - The reference points to a non-existent vertex ID
+     * - The transmitter name doesn't exist on the referenced vertex
+     * - The signal name doesn't exist on the specified transmitter
+     *
+     * Resolution: Verify the signal reference path and ensure the source vertex,
+     * transmitter, and signal all exist.
      *
      * @generated from enum value: ERROR_INVALID_SOURCE = 2;
      */
     INVALID_SOURCE = 2,
     /**
-     * The schema does not match, the source is valid
+     * The signal format doesn't match any of the accepted formats.
+     * This occurs when:
+     * - The source signal's format (from SignalDescriptor) doesn't match any
+     *   format in the 'accepts' list
+     * - JTD schema validation fails
+     * - MIME type mismatch (including wildcard matching failures)
+     *
+     * Resolution: Either change the binding to accept the source signal's format,
+     * or use a different signal source with a compatible format.
      *
      * @generated from enum value: ERROR_SCHEMA_MISMATCH = 3;
      */
     SCHEMA_MISMATCH = 3
 }
 /**
- * Some error codes that can appear on the binding
+ * Error codes that can occur during binding validation or resolution.
+ * These errors are typically set by the graph validation system.
  *
  * @generated from enum mochabugapis.adapt.graph.SignalBinding.Error
  */

package/bin/genproto/mochabugapis/adapt/graph/signal_binding_pb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal_binding_pb.d.ts","sourceRoot":"","sources":["../../../../../src/genproto/mochabugapis/adapt/graph/signal_binding_pb.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAGjF,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAErF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,4CAA4C,EAAE,OACypB,CAAC;AAErtB;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,wCAAwC,CAAC,GAAG;IAC9E;;;;OAIG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B;;;;;OAKG;IACH,OAAO,EAAE;QACP;;;;WAIG;QACH,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,WAAW,CAAC;KACnB,GAAG;QACF;;;;WAIG;QACH,KAAK,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,UAAU,CAAC;KAClB,GAAG;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IAE3C;;;;OAIG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;OAIG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAElC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;OAIG;IACH,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAAU,CAAC,aAAa,EAAE,iBAAiB,CACf,CAAC;AAE/D;;;;GAIG;AACH,oBAAY,mBAAmB;IAC7B;;;;OAIG;IACH,WAAW,IAAI;IAEf;;;;OAIG;IACH,OAAO,IAAI;IAEX;;;;OAIG;IACH,cAAc,IAAI;IAElB;;;;OAIG;IACH,eAAe,IAAI;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG,eAAe,GAAG,sBAAsB,GAAG,uBAAuB,CAAC;AAE/H;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,OAAO,CAAC,mBAAmB,EAAE,uBAAuB,CAC9B,CAAC"}
+{"version":3,"file":"signal_binding_pb.d.ts","sourceRoot":"","sources":["../../../../../src/genproto/mochabugapis/adapt/graph/signal_binding_pb.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAGjF,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,4CAA4C,EAAE,OACy6B,CAAC;AAEr+B;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,wCAAwC,CAAC,GAAG;IAC9E;;;;;;;;;;OAUG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAAU,CAAC,aAAa,EAAE;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAC,CAC3B,CAAC;AAE/D;;;;;GAKG;AACH,oBAAY,mBAAmB;IAC7B;;;;;OAKG;IACH,WAAW,IAAI;IAEf;;;;;;;;;OASG;IACH,OAAO,IAAI;IAEX;;;;;;;;;;;OAWG;IACH,cAAc,IAAI;IAElB;;;;;;;;;;;;OAYG;IACH,eAAe,IAAI;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG,eAAe,GAAG,sBAAsB,GAAG,uBAAuB,CAAC;AAE/H;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,OAAO,CAAC,mBAAmB,EAAE,uBAAuB,CAC9B,CAAC"}

package/bin/genproto/mochabugapis/adapt/graph/signal_data_pb.d.ts

@@ -0,0 +1,198 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file mochabugapis/adapt/graph/signal_data.proto.
+ */
+export declare const file_mochabugapis_adapt_graph_signal_data: GenFile;
+/**
+ * This represents the actual data in the system
+ *
+ * @generated from message mochabugapis.adapt.graph.SignalData
+ */
+export type SignalData = Message<"mochabugapis.adapt.graph.SignalData"> & {
+    /**
+     * An optional filename associated with the signal.
+     * Supports international filenames with Unicode characters.
+     * Can include extension (e.g., "document.pdf") or be extension-less (e.g., "README").
+     *
+     * Supported characters:
+     * - All Unicode characters (international support)
+     * - All printable ASCII including special characters
+     * - Spaces, dots, hyphens, underscores anywhere in the filename
+     *
+     * Blocked characters (filesystem-illegal):
+     * - Path separators: / \
+     * - Windows-illegal: < > : " | ? *
+     * - Control characters: null bytes, newlines, tabs, etc. (0x00-0x1F)
+     *
+     * Additional restrictions:
+     * - Cannot start or end with whitespace (enforced by CEL)
+     * - Maximum length: 255 characters (filesystem compatibility)
+     *
+     * Examples:
+     * ✅ "document.pdf"
+     * ✅ "my-file_v2.txt"
+     * ✅ "Report (Final).docx"
+     * ✅ "résumé.pdf" (French accents)
+     * ✅ "文档.pdf" (Chinese)
+     * ✅ "файл.txt" (Cyrillic)
+     * ✅ "Project #2.xlsx"
+     * ✅ ".gitignore" (hidden files allowed)
+     * ❌ " file.txt" (starts with space)
+     * ❌ "file.txt " (ends with space)
+     * ❌ "path/to/file.txt" (contains path separator)
+     * ❌ "file\0.txt" (contains null byte)
+     * ❌ "file<name>.txt" (contains Windows-illegal char)
+     *
+     * @generated from field: optional string filename = 1;
+     */
+    filename?: string;
+    /**
+     * The MIME type of the signal data.
+     * Must be a **concrete** MIME type conforming to RFC 6838 (NO wildcards allowed).
+     *
+     * This field specifies the actual format of the binary data in the `data` field.
+     * Unlike SignalFormat which can use wildcards for format families, SignalData
+     * represents actual concrete data and must have a specific MIME type.
+     *
+     * Format requirements:
+     * - Structure: type/subtype (e.g., "image/png", "application/pdf")
+     * - Type must be concrete alphanumeric (no wildcards)
+     * - Subtype must be concrete alphanumeric (no wildcards)
+     * - NO parameters allowed (no semicolons or charset specifications)
+     * - Case-insensitive but conventionally lowercase
+     * - Maximum length: 255 characters (127 for type + "/" + 127 for subtype)
+     *
+     * **No wildcards**: Unlike SignalFormat, wildcards are FORBIDDEN here because
+     * this represents actual data which must have a concrete format.
+     * ❌ "*\/*" - Forbidden (data must have specific format)
+     * ❌ "image/*" - Forbidden (data must be specific image format)
+     * ❌ "*\/png" - Forbidden (semantically invalid anyway)
+     * ✅ "image/png" - Valid (concrete format)
+     * ✅ "application/pdf" - Valid (concrete format)
+     *
+     * **Character Encoding Assumption**:
+     * All text-based formats (text/*, application/json, application/xml, etc.) are
+     * assumed to use UTF-8 encoding. Charset parameters are forbidden.
+     *
+     * Examples of forbidden formats:
+     * ❌ "text/plain; charset=utf-8" (parameters not allowed)
+     * ❌ "image/*" (wildcards not allowed)
+     * ❌ "*\/*" (wildcards not allowed)
+     *
+     * Common concrete examples:
+     * - Images: "image/png", "image/jpeg", "image/webp", "image/gif", "image/svg+xml"
+     * - Documents: "application/pdf", "text/html", "text/markdown", "text/plain"
+     * - Data: "application/json", "application/xml", "text/csv"
+     * - Binary: "application/octet-stream", "application/zip"
+     *
+     * @generated from field: string mime_type = 2;
+     */
+    mimeType: string;
+    /**
+     * The actual raw binary data
+     *
+     * @generated from field: bytes data = 3;
+     */
+    data: Uint8Array;
+};
+/**
+ * This represents the actual data in the system
+ *
+ * @generated from message mochabugapis.adapt.graph.SignalData
+ */
+export type SignalDataJson = {
+    /**
+     * An optional filename associated with the signal.
+     * Supports international filenames with Unicode characters.
+     * Can include extension (e.g., "document.pdf") or be extension-less (e.g., "README").
+     *
+     * Supported characters:
+     * - All Unicode characters (international support)
+     * - All printable ASCII including special characters
+     * - Spaces, dots, hyphens, underscores anywhere in the filename
+     *
+     * Blocked characters (filesystem-illegal):
+     * - Path separators: / \
+     * - Windows-illegal: < > : " | ? *
+     * - Control characters: null bytes, newlines, tabs, etc. (0x00-0x1F)
+     *
+     * Additional restrictions:
+     * - Cannot start or end with whitespace (enforced by CEL)
+     * - Maximum length: 255 characters (filesystem compatibility)
+     *
+     * Examples:
+     * ✅ "document.pdf"
+     * ✅ "my-file_v2.txt"
+     * ✅ "Report (Final).docx"
+     * ✅ "résumé.pdf" (French accents)
+     * ✅ "文档.pdf" (Chinese)
+     * ✅ "файл.txt" (Cyrillic)
+     * ✅ "Project #2.xlsx"
+     * ✅ ".gitignore" (hidden files allowed)
+     * ❌ " file.txt" (starts with space)
+     * ❌ "file.txt " (ends with space)
+     * ❌ "path/to/file.txt" (contains path separator)
+     * ❌ "file\0.txt" (contains null byte)
+     * ❌ "file<name>.txt" (contains Windows-illegal char)
+     *
+     * @generated from field: optional string filename = 1;
+     */
+    filename?: string;
+    /**
+     * The MIME type of the signal data.
+     * Must be a **concrete** MIME type conforming to RFC 6838 (NO wildcards allowed).
+     *
+     * This field specifies the actual format of the binary data in the `data` field.
+     * Unlike SignalFormat which can use wildcards for format families, SignalData
+     * represents actual concrete data and must have a specific MIME type.
+     *
+     * Format requirements:
+     * - Structure: type/subtype (e.g., "image/png", "application/pdf")
+     * - Type must be concrete alphanumeric (no wildcards)
+     * - Subtype must be concrete alphanumeric (no wildcards)
+     * - NO parameters allowed (no semicolons or charset specifications)
+     * - Case-insensitive but conventionally lowercase
+     * - Maximum length: 255 characters (127 for type + "/" + 127 for subtype)
+     *
+     * **No wildcards**: Unlike SignalFormat, wildcards are FORBIDDEN here because
+     * this represents actual data which must have a concrete format.
+     * ❌ "*\/*" - Forbidden (data must have specific format)
+     * ❌ "image/*" - Forbidden (data must be specific image format)
+     * ❌ "*\/png" - Forbidden (semantically invalid anyway)
+     * ✅ "image/png" - Valid (concrete format)
+     * ✅ "application/pdf" - Valid (concrete format)
+     *
+     * **Character Encoding Assumption**:
+     * All text-based formats (text/*, application/json, application/xml, etc.) are
+     * assumed to use UTF-8 encoding. Charset parameters are forbidden.
+     *
+     * Examples of forbidden formats:
+     * ❌ "text/plain; charset=utf-8" (parameters not allowed)
+     * ❌ "image/*" (wildcards not allowed)
+     * ❌ "*\/*" (wildcards not allowed)
+     *
+     * Common concrete examples:
+     * - Images: "image/png", "image/jpeg", "image/webp", "image/gif", "image/svg+xml"
+     * - Documents: "application/pdf", "text/html", "text/markdown", "text/plain"
+     * - Data: "application/json", "application/xml", "text/csv"
+     * - Binary: "application/octet-stream", "application/zip"
+     *
+     * @generated from field: string mime_type = 2;
+     */
+    mimeType?: string;
+    /**
+     * The actual raw binary data
+     *
+     * @generated from field: bytes data = 3;
+     */
+    data?: string;
+};
+/**
+ * Describes the message mochabugapis.adapt.graph.SignalData.
+ * Use `create(SignalDataSchema)` to create a new message.
+ */
+export declare const SignalDataSchema: GenMessage<SignalData, {
+    jsonType: SignalDataJson;
+}>;
+//# sourceMappingURL=signal_data_pb.d.ts.map

package/bin/genproto/mochabugapis/adapt/graph/signal_data_pb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal_data_pb.d.ts","sourceRoot":"","sources":["../../../../../src/genproto/mochabugapis/adapt/graph/signal_data_pb.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAGxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,yCAAyC,EAAE,OAC8zD,CAAC;AAEv3D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,qCAAqC,CAAC,GAAG;IACxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAU,CAAC,UAAU,EAAE;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAC,CACrB,CAAC"}