@stigmer/protos 3.2.3 → 3.3.0

package/ai/stigmer/agentic/datastore/v1/record_io_pb.d.ts

@@ -0,0 +1,729 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { DatastoreSubject, DatastoreVerb, FieldDeclaration } from "./spec_pb.js";
+import type { Timestamp, Value } from "@bufbuild/protobuf/wkt";
+import type { JsonObject, Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/agentic/datastore/v1/record_io.proto.
+ */
+export declare const file_ai_stigmer_agentic_datastore_v1_record_io: GenFile;
+/**
+ * RecordEnvelope is a record as returned by every record RPC:
+ * server-managed system fields plus the declared fields.
+ *
+ * @internal
+ * System fields are server-stamped and never caller-writable on any
+ * surface. Record ids follow the platform id convention with prefix
+ * `dsr` (dsr_<lowercase-ulid>). created_by carries the DD-002
+ * attribution subject; own-scoped grants resolve against it, and the
+ * grant system is the privacy boundary for exposing it (own-scoped
+ * readers only ever see themselves).
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.RecordEnvelope
+ */
+export type RecordEnvelope = Message<"ai.stigmer.agentic.datastore.v1.RecordEnvelope"> & {
+    /**
+     * Server-issued record identifier, opaque and immutable.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * When the record was inserted.
+     *
+     * @generated from field: google.protobuf.Timestamp created_at = 2;
+     */
+    createdAt?: Timestamp;
+    /**
+     * When the record was last updated.
+     *
+     * @generated from field: google.protobuf.Timestamp updated_at = 3;
+     */
+    updatedAt?: Timestamp;
+    /**
+     * The verified caller identity that inserted the record.
+     *
+     * @generated from field: ai.stigmer.agentic.datastore.v1.DatastoreSubject created_by = 4;
+     */
+    createdBy?: DatastoreSubject;
+    /**
+     * Declared field values in their canonical encodings.
+     *
+     * @generated from field: google.protobuf.Struct fields = 5;
+     */
+    fields?: JsonObject;
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.RecordEnvelope.
+ * Use `create(RecordEnvelopeSchema)` to create a new message.
+ */
+export declare const RecordEnvelopeSchema: GenMessage<RecordEnvelope>;
+/**
+ * RecordList is a page of records with pagination totals.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.RecordList
+ */
+export type RecordList = Message<"ai.stigmer.agentic.datastore.v1.RecordList"> & {
+    /**
+     * Records in the current page.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.datastore.v1.RecordEnvelope records = 1;
+     */
+    records: RecordEnvelope[];
+    /**
+     * Total count of records matching the filter.
+     *
+     * @generated from field: int32 total = 2;
+     */
+    total: number;
+    /**
+     * Limit applied to this page.
+     *
+     * @generated from field: int32 limit = 3;
+     */
+    limit: number;
+    /**
+     * Offset applied to this page.
+     *
+     * @generated from field: int32 offset = 4;
+     */
+    offset: number;
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.RecordList.
+ * Use `create(RecordListSchema)` to create a new message.
+ */
+export declare const RecordListSchema: GenMessage<RecordList>;
+/**
+ * RecordFilter selects records with typed conditions, all of which must
+ * match.
+ *
+ * @internal
+ * AND-only in v1 (`in` covers single-field disjunction; OR groups are a
+ * recorded growth path). Every expressible condition compiles to an
+ * indexable predicate on both substrates. The server-applied grant
+ * scope (own) composes as an inexpressible conjunction — the grammar
+ * can neither express, relax, nor observe it.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.RecordFilter
+ */
+export type RecordFilter = Message<"ai.stigmer.agentic.datastore.v1.RecordFilter"> & {
+    /**
+     * Conditions combined with AND semantics.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.datastore.v1.RecordCondition conditions = 1;
+     */
+    conditions: RecordCondition[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.RecordFilter.
+ * Use `create(RecordFilterSchema)` to create a new message.
+ */
+export declare const RecordFilterSchema: GenMessage<RecordFilter>;
+/**
+ * RecordCondition tests one field against an operator and value.
+ *
+ * @internal
+ * The per-type operator matrix is domain validation against the
+ * declared schema: eq/neq/in/not_in for string and enum fields; range
+ * operators for numeric and temporal types; is_null/not_null for
+ * optional fields; id by eq/in; created_at/updated_at by range. json
+ * fields and created_by are not filterable.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.RecordCondition
+ */
+export type RecordCondition = Message<"ai.stigmer.agentic.datastore.v1.RecordCondition"> & {
+    /**
+     * Declared field name, or a filterable system field (id, created_at,
+     * updated_at).
+     *
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * Comparison operator.
+     *
+     * @generated from field: ai.stigmer.agentic.datastore.v1.RecordConditionOp op = 2;
+     */
+    op: RecordConditionOp;
+    /**
+     * Comparison value for scalar operators, in the field's canonical
+     * encoding. Unset for is_null / not_null.
+     *
+     * @generated from field: google.protobuf.Value value = 3;
+     */
+    value?: Value;
+    /**
+     * Comparison values for in / not_in.
+     *
+     * @generated from field: repeated google.protobuf.Value values = 4;
+     */
+    values: Value[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.RecordCondition.
+ * Use `create(RecordConditionSchema)` to create a new message.
+ */
+export declare const RecordConditionSchema: GenMessage<RecordCondition>;
+/**
+ * RecordOrderBy sorts results by a single field.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.RecordOrderBy
+ */
+export type RecordOrderBy = Message<"ai.stigmer.agentic.datastore.v1.RecordOrderBy"> & {
+    /**
+     * Declared field name, or a sortable system field (id, created_at,
+     * updated_at).
+     *
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     * Sort direction. Unset defaults to ascending.
+     *
+     * @generated from field: ai.stigmer.agentic.datastore.v1.RecordSortDirection direction = 2;
+     */
+    direction: RecordSortDirection;
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.RecordOrderBy.
+ * Use `create(RecordOrderBySchema)` to create a new message.
+ */
+export declare const RecordOrderBySchema: GenMessage<RecordOrderBy>;
+/**
+ * FindRecordsRequest selects records from one collection.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.FindRecordsRequest
+ */
+export type FindRecordsRequest = Message<"ai.stigmer.agentic.datastore.v1.FindRecordsRequest"> & {
+    /**
+     * Datastore slug, resolved within the organization named by `org` —
+     * records never cross the org boundary.
+     *
+     * @generated from field: string datastore = 1;
+     */
+    datastore: string;
+    /**
+     * Collection to query.
+     *
+     * @generated from field: string collection = 2;
+     */
+    collection: string;
+    /**
+     * Conditions records must match. Empty returns all readable records.
+     *
+     * @generated from field: ai.stigmer.agentic.datastore.v1.RecordFilter filter = 3;
+     */
+    filter?: RecordFilter;
+    /**
+     * Sort order. Unset defaults to created_at descending with id as
+     * tiebreak (deterministic pagination).
+     *
+     * @generated from field: ai.stigmer.agentic.datastore.v1.RecordOrderBy order_by = 4;
+     */
+    orderBy?: RecordOrderBy;
+    /**
+     * Page size. Unset defaults to 25; maximum 100.
+     *
+     * @generated from field: int32 limit = 5;
+     */
+    limit: number;
+    /**
+     * Number of records to skip.
+     *
+     * @generated from field: int32 offset = 6;
+     */
+    offset: number;
+    /**
+     * Data partition to read from. Unset means the "default" partition.
+     *
+     * @internal
+     * Honored for direct platform principals only (console, CLI, SDK,
+     * import). Session-bound runner credentials get their partition
+     * server-derived from the session's agent instance (DD-010 SD-2) and
+     * are rejected with INVALID_ARGUMENT if they supply one — no second
+     * channel, mirroring the sender-identity posture.
+     *
+     * @generated from field: string partition = 7;
+     */
+    partition: string;
+    /**
+     * Organization the datastore belongs to. Direct callers (console,
+     * CLI, SDK, import) set it; unset resolves from the caller's context.
+     *
+     * @internal
+     * Session-bound runner credentials leave it empty — their org is
+     * server-derived from the session (DD-006 reach chain, lands with
+     * T05). In the OSS edition every slug resolves against the local
+     * system org, and a non-matching explicit org is NOT_FOUND (records
+     * stay home).
+     *
+     * @generated from field: string org = 8;
+     */
+    org: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.FindRecordsRequest.
+ * Use `create(FindRecordsRequestSchema)` to create a new message.
+ */
+export declare const FindRecordsRequestSchema: GenMessage<FindRecordsRequest>;
+/**
+ * InsertRecordRequest inserts one record into a collection.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.InsertRecordRequest
+ */
+export type InsertRecordRequest = Message<"ai.stigmer.agentic.datastore.v1.InsertRecordRequest"> & {
+    /**
+     * Datastore slug.
+     *
+     * @generated from field: string datastore = 1;
+     */
+    datastore: string;
+    /**
+     * Collection to insert into.
+     *
+     * @generated from field: string collection = 2;
+     */
+    collection: string;
+    /**
+     * Declared field values in their canonical encodings. System field
+     * names are rejected.
+     *
+     * @generated from field: google.protobuf.Struct record = 3;
+     */
+    record?: JsonObject;
+    /**
+     * Data partition to insert into. Unset means the "default" partition.
+     *
+     * @internal
+     * Same dispatch as FindRecordsRequest.partition: direct principals
+     * only; server-derived (and rejected if supplied) for session-bound
+     * callers. A partition's first write registers it in the datastore's
+     * partition catalog (DD-010 SD-3).
+     *
+     * @generated from field: string partition = 4;
+     */
+    partition: string;
+    /**
+     * Organization the datastore belongs to. Direct callers set it;
+     * unset resolves from the caller's context.
+     *
+     * @internal
+     * Same dispatch as FindRecordsRequest.org.
+     *
+     * @generated from field: string org = 5;
+     */
+    org: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.InsertRecordRequest.
+ * Use `create(InsertRecordRequestSchema)` to create a new message.
+ */
+export declare const InsertRecordRequestSchema: GenMessage<InsertRecordRequest>;
+/**
+ * UpdateRecordRequest updates one record by id with a partial merge.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.UpdateRecordRequest
+ */
+export type UpdateRecordRequest = Message<"ai.stigmer.agentic.datastore.v1.UpdateRecordRequest"> & {
+    /**
+     * Datastore slug.
+     *
+     * @generated from field: string datastore = 1;
+     */
+    datastore: string;
+    /**
+     * Collection holding the record.
+     *
+     * @generated from field: string collection = 2;
+     */
+    collection: string;
+    /**
+     * Id of the record to update.
+     *
+     * @generated from field: string id = 3;
+     */
+    id: string;
+    /**
+     * Fields to change. Only supplied fields change; an explicit null
+     * clears a field. Constraints evaluate on the merged result. System
+     * field names are rejected.
+     *
+     * @generated from field: google.protobuf.Struct fields = 4;
+     */
+    fields?: JsonObject;
+    /**
+     * Data partition holding the record. Unset means the "default"
+     * partition. A record in another partition is NOT_FOUND.
+     *
+     * @internal
+     * Same dispatch as FindRecordsRequest.partition.
+     *
+     * @generated from field: string partition = 5;
+     */
+    partition: string;
+    /**
+     * Organization the datastore belongs to. Direct callers set it;
+     * unset resolves from the caller's context.
+     *
+     * @internal
+     * Same dispatch as FindRecordsRequest.org.
+     *
+     * @generated from field: string org = 6;
+     */
+    org: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.UpdateRecordRequest.
+ * Use `create(UpdateRecordRequestSchema)` to create a new message.
+ */
+export declare const UpdateRecordRequestSchema: GenMessage<UpdateRecordRequest>;
+/**
+ * DeleteRecordRequest deletes one record by id.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.DeleteRecordRequest
+ */
+export type DeleteRecordRequest = Message<"ai.stigmer.agentic.datastore.v1.DeleteRecordRequest"> & {
+    /**
+     * Datastore slug.
+     *
+     * @generated from field: string datastore = 1;
+     */
+    datastore: string;
+    /**
+     * Collection holding the record.
+     *
+     * @generated from field: string collection = 2;
+     */
+    collection: string;
+    /**
+     * Id of the record to delete.
+     *
+     * @generated from field: string id = 3;
+     */
+    id: string;
+    /**
+     * Data partition holding the record. Unset means the "default"
+     * partition. A record in another partition is NOT_FOUND.
+     *
+     * @internal
+     * Same dispatch as FindRecordsRequest.partition.
+     *
+     * @generated from field: string partition = 4;
+     */
+    partition: string;
+    /**
+     * Organization the datastore belongs to. Direct callers set it;
+     * unset resolves from the caller's context.
+     *
+     * @internal
+     * Same dispatch as FindRecordsRequest.org.
+     *
+     * @generated from field: string org = 5;
+     */
+    org: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.DeleteRecordRequest.
+ * Use `create(DeleteRecordRequestSchema)` to create a new message.
+ */
+export declare const DeleteRecordRequestSchema: GenMessage<DeleteRecordRequest>;
+/**
+ * DescribeDatastoreRequest asks for a datastore as the caller
+ * experiences it.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.DescribeDatastoreRequest
+ */
+export type DescribeDatastoreRequest = Message<"ai.stigmer.agentic.datastore.v1.DescribeDatastoreRequest"> & {
+    /**
+     * Datastore slug.
+     *
+     * @generated from field: string datastore = 1;
+     */
+    datastore: string;
+    /**
+     * Organization the datastore belongs to. Direct callers set it;
+     * unset resolves from the caller's context.
+     *
+     * @internal
+     * Same dispatch as FindRecordsRequest.org.
+     *
+     * @generated from field: string org = 2;
+     */
+    org: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.DescribeDatastoreRequest.
+ * Use `create(DescribeDatastoreRequestSchema)` to create a new message.
+ */
+export declare const DescribeDatastoreRequestSchema: GenMessage<DescribeDatastoreRequest>;
+/**
+ * DatastoreDescription is a datastore's schema and the calling
+ * subject's effective access, for agent and client discovery.
+ *
+ * @internal
+ * The projection deliberately excludes operator state (bindings, seed
+ * records, sync report): a caller learns the shape of the data and what
+ * it may do, never who else has access.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.DatastoreDescription
+ */
+export type DatastoreDescription = Message<"ai.stigmer.agentic.datastore.v1.DatastoreDescription"> & {
+    /**
+     * Datastore slug.
+     *
+     * @generated from field: string datastore = 1;
+     */
+    datastore: string;
+    /**
+     * Datastore description from the spec.
+     *
+     * @generated from field: string description = 2;
+     */
+    description: string;
+    /**
+     * IANA timezone bound as `tz` in constraint evaluation.
+     *
+     * @generated from field: string timezone = 3;
+     */
+    timezone: string;
+    /**
+     * Collections with schema and caller-effective access.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.datastore.v1.CollectionDescription collections = 4;
+     */
+    collections: CollectionDescription[];
+    /**
+     * Data partitions that hold records, from the partition catalog.
+     * Always includes "default".
+     *
+     * @internal
+     * Partitions are labels on data, never resources (DD-010 SD-3): a
+     * partition appears here after its first write registers it in the
+     * catalog. The console's partition picker is fed from this list; for
+     * agent callers it is harmless metadata (their partition is
+     * server-derived and not selectable).
+     *
+     * @generated from field: repeated string partitions = 5;
+     */
+    partitions: string[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.DatastoreDescription.
+ * Use `create(DatastoreDescriptionSchema)` to create a new message.
+ */
+export declare const DatastoreDescriptionSchema: GenMessage<DatastoreDescription>;
+/**
+ * CollectionDescription is one collection's schema and the caller's
+ * effective access to it.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.CollectionDescription
+ */
+export type CollectionDescription = Message<"ai.stigmer.agentic.datastore.v1.CollectionDescription"> & {
+    /**
+     * Collection name.
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * Collection description from the spec.
+     *
+     * @generated from field: string description = 2;
+     */
+    description: string;
+    /**
+     * Declared fields with types and canonical encodings.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.datastore.v1.FieldDeclaration fields = 3;
+     */
+    fields: FieldDeclaration[];
+    /**
+     * Declared constraints: names and relayable messages.
+     *
+     * @generated from field: repeated ai.stigmer.agentic.datastore.v1.ConstraintDescription constraints = 4;
+     */
+    constraints: ConstraintDescription[];
+    /**
+     * Verbs the calling subject holds on this collection, with row
+     * scope. Empty means no access (deny by default).
+     *
+     * @generated from field: repeated ai.stigmer.agentic.datastore.v1.VerbGrantDescription access = 5;
+     */
+    access: VerbGrantDescription[];
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.CollectionDescription.
+ * Use `create(CollectionDescriptionSchema)` to create a new message.
+ */
+export declare const CollectionDescriptionSchema: GenMessage<CollectionDescription>;
+/**
+ * ConstraintDescription names a constraint and its relayable message.
+ *
+ * @internal
+ * Expressions and where-conditions are deliberately excluded — the
+ * declared message is the caller-facing contract for violations.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.ConstraintDescription
+ */
+export type ConstraintDescription = Message<"ai.stigmer.agentic.datastore.v1.ConstraintDescription"> & {
+    /**
+     * Constraint name, matching the ErrorInfo constraint on violations.
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * Constraint class.
+     *
+     * @generated from field: ai.stigmer.agentic.datastore.v1.ConstraintKind kind = 2;
+     */
+    kind: ConstraintKind;
+    /**
+     * The declared agent-relayable violation message.
+     *
+     * @generated from field: string message = 3;
+     */
+    message: string;
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.ConstraintDescription.
+ * Use `create(ConstraintDescriptionSchema)` to create a new message.
+ */
+export declare const ConstraintDescriptionSchema: GenMessage<ConstraintDescription>;
+/**
+ * VerbGrantDescription is one verb the caller holds on a collection.
+ *
+ * @generated from message ai.stigmer.agentic.datastore.v1.VerbGrantDescription
+ */
+export type VerbGrantDescription = Message<"ai.stigmer.agentic.datastore.v1.VerbGrantDescription"> & {
+    /**
+     * Granted verb.
+     *
+     * @generated from field: ai.stigmer.agentic.datastore.v1.DatastoreVerb verb = 1;
+     */
+    verb: DatastoreVerb;
+    /**
+     * True when the verb applies only to records the caller created.
+     *
+     * @generated from field: bool own_scope = 2;
+     */
+    ownScope: boolean;
+};
+/**
+ * Describes the message ai.stigmer.agentic.datastore.v1.VerbGrantDescription.
+ * Use `create(VerbGrantDescriptionSchema)` to create a new message.
+ */
+export declare const VerbGrantDescriptionSchema: GenMessage<VerbGrantDescription>;
+/**
+ * RecordConditionOp is the comparison operator of a condition.
+ *
+ * @internal
+ * `is_in` rather than `in` because protoc emits enum constants verbatim
+ * and `in` is a reserved word in Java and Python.
+ *
+ * @generated from enum ai.stigmer.agentic.datastore.v1.RecordConditionOp
+ */
+export declare enum RecordConditionOp {
+    /**
+     * @generated from enum value: record_condition_op_unspecified = 0;
+     */
+    record_condition_op_unspecified = 0,
+    /**
+     * @generated from enum value: eq = 1;
+     */
+    eq = 1,
+    /**
+     * @generated from enum value: neq = 2;
+     */
+    neq = 2,
+    /**
+     * @generated from enum value: gt = 3;
+     */
+    gt = 3,
+    /**
+     * @generated from enum value: gte = 4;
+     */
+    gte = 4,
+    /**
+     * @generated from enum value: lt = 5;
+     */
+    lt = 5,
+    /**
+     * @generated from enum value: lte = 6;
+     */
+    lte = 6,
+    /**
+     * @generated from enum value: is_in = 7;
+     */
+    is_in = 7,
+    /**
+     * @generated from enum value: not_in = 8;
+     */
+    not_in = 8,
+    /**
+     * @generated from enum value: is_null = 9;
+     */
+    is_null = 9,
+    /**
+     * @generated from enum value: not_null = 10;
+     */
+    not_null = 10
+}
+/**
+ * Describes the enum ai.stigmer.agentic.datastore.v1.RecordConditionOp.
+ */
+export declare const RecordConditionOpSchema: GenEnum<RecordConditionOp>;
+/**
+ * RecordSortDirection is the direction of a sort.
+ *
+ * @generated from enum ai.stigmer.agentic.datastore.v1.RecordSortDirection
+ */
+export declare enum RecordSortDirection {
+    /**
+     * @generated from enum value: record_sort_direction_unspecified = 0;
+     */
+    record_sort_direction_unspecified = 0,
+    /**
+     * @generated from enum value: asc = 1;
+     */
+    asc = 1,
+    /**
+     * @generated from enum value: desc = 2;
+     */
+    desc = 2
+}
+/**
+ * Describes the enum ai.stigmer.agentic.datastore.v1.RecordSortDirection.
+ */
+export declare const RecordSortDirectionSchema: GenEnum<RecordSortDirection>;
+/**
+ * ConstraintKind is the class of a declared constraint.
+ *
+ * @generated from enum ai.stigmer.agentic.datastore.v1.ConstraintKind
+ */
+export declare enum ConstraintKind {
+    /**
+     * @generated from enum value: constraint_kind_unspecified = 0;
+     */
+    constraint_kind_unspecified = 0,
+    /**
+     * @generated from enum value: unique = 1;
+     */
+    unique = 1,
+    /**
+     * @generated from enum value: check = 2;
+     */
+    check = 2,
+    /**
+     * @generated from enum value: exists = 3;
+     */
+    exists = 3,
+    /**
+     * @generated from enum value: not_exists = 4;
+     */
+    not_exists = 4
+}
+/**
+ * Describes the enum ai.stigmer.agentic.datastore.v1.ConstraintKind.
+ */
+export declare const ConstraintKindSchema: GenEnum<ConstraintKind>;