@papr/memory 1.16.0 → 1.18.0

package/resources/schemas.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.mts","sourceRoot":"","sources":["../src/resources/schemas.ts"],"names":[],"mappings":"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"}

package/resources/schemas.d.ts

@@ -0,0 +1,404 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Schemas extends APIResource {
+    /**
+     * Create a new user-defined graph schema.
+     *
+     *     This endpoint allows users to define custom node types and relationships for their knowledge graph.
+     *     The schema will be validated and stored for use in future memory extractions.
+     *
+     *     **Features:**
+     *     - Define custom node types with properties and validation rules
+     *     - Define custom relationship types with constraints
+     *     - Automatic validation against system schemas
+     *     - Support for different scopes (personal, workspace, organization)
+     *     - **Enum support**: Use `enum_values` to restrict property values to a predefined list (max 10 values)
+     *     - **Auto-indexing**: Required properties are automatically indexed in Neo4j for optimal query performance
+     *
+     *     **Property Types & Validation:**
+     *     - `string`: Text values with optional `enum_values`, `min_length`, `max_length`, `pattern`
+     *     - `integer`: Whole numbers with optional `min_value`, `max_value`
+     *     - `float`: Decimal numbers with optional `min_value`, `max_value`
+     *     - `boolean`: True/false values
+     *     - `datetime`: ISO 8601 timestamp strings
+     *     - `array`: Lists of values
+     *     - `object`: Complex nested objects
+     *
+     *     **Enum Values:**
+     *     - Add `enum_values` to any string property to restrict values to a predefined list
+     *     - Maximum 10 enum values allowed per property
+     *     - Use with `default` to set a default enum value
+     *     - Example: `"enum_values": ["small", "medium", "large"]`
+     *
+     *     **When to Use Enums:**
+     *     - Limited, well-defined options (≤10 values): sizes, statuses, categories, priorities
+     *     - Controlled vocabularies: "active/inactive", "high/medium/low", "bronze/silver/gold"
+     *     - When you want exact matching and no variations
+     *
+     *     **When to Avoid Enums:**
+     *     - Open-ended text fields: names, titles, descriptions, addresses
+     *     - Large sets of options (>10): countries, cities, product models
+     *     - When you want semantic similarity matching for entity resolution
+     *     - Dynamic or frequently changing value sets
+     *
+     *     **Unique Identifiers & Entity Resolution:**
+     *     - Properties marked as `unique_identifiers` are used for entity deduplication and merging
+     *     - **With enum_values**: Exact matching is used - entities with the same enum value are considered identical
+     *     - **Without enum_values**: Semantic similarity matching is used - entities with similar meanings are automatically merged
+     *     - Example: A "name" unique_identifier without enums will merge "Apple Inc" and "Apple Inc." as the same entity
+     *     - Example: A "sku" unique_identifier with enums will only merge entities with exactly matching SKU codes
+     *     - Use enums for unique_identifiers when you have a limited, predefined set of values (≤10 options)
+     *     - Avoid enums for unique_identifiers when you have broad, open-ended values or >10 possible options
+     *     - **Best practices**: Use enums for controlled vocabularies (status codes, categories), avoid for open text (company names, product titles)
+     *     - **In the example above**: "name" uses semantic similarity (open-ended), "sku" uses exact matching (controlled set)
+     *
+     *     **LLM-Friendly Descriptions:**
+     *     - Write detailed property descriptions that guide the LLM on expected formats and usage
+     *     - Include examples of typical values (e.g., "Product name, typically 2-4 words like 'iPhone 15 Pro'")
+     *     - Specify data formats and constraints clearly (e.g., "Price in USD as decimal number")
+     *     - For enums, explain when to use each option (e.g., "use 'new' for brand new items")
+     *
+     *     **Authentication Required**:
+     *     One of the following authentication methods must be used:
+     *     - Bearer token in `Authorization` header
+     *     - API Key in `X-API-Key` header
+     *     - Session token in `X-Session-Token` header
+     *
+     *     **Required Headers**:
+     *     - Content-Type: application/json
+     *     - X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
+     */
+    create(body: SchemaCreateParams, options?: RequestOptions): APIPromise<SchemaCreateResponse>;
+    /**
+     * Get a specific schema by ID.
+     *
+     *     Returns the complete schema definition including node types, relationship types,
+     *     and metadata. User must have read access to the schema.
+     */
+    retrieve(schemaID: string, options?: RequestOptions): APIPromise<SchemaRetrieveResponse>;
+    /**
+     * Update an existing schema.
+     *
+     *     Allows modification of schema properties, node types, and relationship types.
+     *     User must have write access to the schema. Updates create a new version
+     *     while preserving the existing data.
+     */
+    update(schemaID: string, params: SchemaUpdateParams, options?: RequestOptions): APIPromise<SchemaUpdateResponse>;
+    /**
+     * List all schemas accessible to the authenticated user.
+     *
+     *     Returns schemas that the user owns or has read access to, including:
+     *     - Personal schemas created by the user
+     *     - Workspace schemas shared within the user's workspace
+     *     - Organization schemas available to the user's organization
+     *
+     *     **Authentication Required**:
+     *     One of the following authentication methods must be used:
+     *     - Bearer token in `Authorization` header
+     *     - API Key in `X-API-Key` header
+     *     - Session token in `X-Session-Token` header
+     */
+    list(query?: SchemaListParams | null | undefined, options?: RequestOptions): APIPromise<SchemaListResponse>;
+    /**
+     * Delete a schema.
+     *
+     *     Soft deletes the schema by marking it as archived. The schema data and
+     *     associated graph nodes/relationships are preserved for data integrity.
+     *     User must have write access to the schema.
+     */
+    delete(schemaID: string, options?: RequestOptions): APIPromise<unknown>;
+}
+/**
+ * Complete user-defined graph schema
+ */
+export interface UserGraphSchemaOutput {
+    name: string;
+    id?: string;
+    created_at?: string;
+    description?: string | null;
+    last_used_at?: string | null;
+    /**
+     * Custom node types (max 15 per schema)
+     */
+    node_types?: {
+        [key: string]: UserGraphSchemaOutput.NodeTypes;
+    };
+    organization_id?: string | null;
+    read_access?: Array<string>;
+    /**
+     * Custom relationship types (max 20 per schema)
+     */
+    relationship_types?: {
+        [key: string]: UserGraphSchemaOutput.RelationshipTypes;
+    };
+    scope?: 'personal' | 'workspace' | 'organization';
+    status?: 'draft' | 'active' | 'deprecated' | 'archived';
+    updated_at?: string | null;
+    usage_count?: number;
+    user_id?: string | {
+        [key: string]: unknown;
+    } | null;
+    version?: string;
+    workspace_id?: string | {
+        [key: string]: unknown;
+    } | null;
+    write_access?: Array<string>;
+}
+export declare namespace UserGraphSchemaOutput {
+    /**
+     * User-defined node type
+     */
+    interface NodeTypes {
+        label: string;
+        name: string;
+        color?: string | null;
+        description?: string | null;
+        icon?: string | null;
+        /**
+         * Node properties (max 15 per node type)
+         */
+        properties?: {
+            [key: string]: NodeTypes.Properties;
+        };
+        required_properties?: Array<string>;
+        /**
+         * Properties that uniquely identify this node type. Used for MERGE operations to
+         * avoid duplicates. Example: ['name', 'email'] for Customer nodes.
+         */
+        unique_identifiers?: Array<string>;
+    }
+    namespace NodeTypes {
+        /**
+         * Property definition for nodes/relationships
+         */
+        interface Properties {
+            type: 'string' | 'integer' | 'float' | 'boolean' | 'array' | 'datetime' | 'object';
+            default?: unknown;
+            description?: string | null;
+            /**
+             * List of allowed enum values (max 10)
+             */
+            enum_values?: Array<string> | null;
+            max_length?: number | null;
+            max_value?: number | null;
+            min_length?: number | null;
+            min_value?: number | null;
+            pattern?: string | null;
+            required?: boolean;
+        }
+    }
+    /**
+     * User-defined relationship type
+     */
+    interface RelationshipTypes {
+        allowed_source_types: Array<string>;
+        allowed_target_types: Array<string>;
+        label: string;
+        name: string;
+        cardinality?: 'one-to-one' | 'one-to-many' | 'many-to-many';
+        color?: string | null;
+        description?: string | null;
+        properties?: {
+            [key: string]: RelationshipTypes.Properties;
+        };
+    }
+    namespace RelationshipTypes {
+        /**
+         * Property definition for nodes/relationships
+         */
+        interface Properties {
+            type: 'string' | 'integer' | 'float' | 'boolean' | 'array' | 'datetime' | 'object';
+            default?: unknown;
+            description?: string | null;
+            /**
+             * List of allowed enum values (max 10)
+             */
+            enum_values?: Array<string> | null;
+            max_length?: number | null;
+            max_value?: number | null;
+            min_length?: number | null;
+            min_value?: number | null;
+            pattern?: string | null;
+            required?: boolean;
+        }
+    }
+}
+/**
+ * Response model for schema operations
+ */
+export interface SchemaCreateResponse {
+    success: boolean;
+    code?: number;
+    /**
+     * Complete user-defined graph schema
+     */
+    data?: UserGraphSchemaOutput | null;
+    error?: string | null;
+}
+/**
+ * Response model for schema operations
+ */
+export interface SchemaRetrieveResponse {
+    success: boolean;
+    code?: number;
+    /**
+     * Complete user-defined graph schema
+     */
+    data?: UserGraphSchemaOutput | null;
+    error?: string | null;
+}
+/**
+ * Response model for schema operations
+ */
+export interface SchemaUpdateResponse {
+    success: boolean;
+    code?: number;
+    /**
+     * Complete user-defined graph schema
+     */
+    data?: UserGraphSchemaOutput | null;
+    error?: string | null;
+}
+/**
+ * Response model for listing schemas
+ */
+export interface SchemaListResponse {
+    success: boolean;
+    code?: number;
+    data?: Array<UserGraphSchemaOutput> | null;
+    error?: string | null;
+    total?: number;
+}
+export type SchemaDeleteResponse = unknown;
+export interface SchemaCreateParams {
+    name: string;
+    id?: string;
+    created_at?: string;
+    description?: string | null;
+    last_used_at?: string | null;
+    /**
+     * Custom node types (max 15 per schema)
+     */
+    node_types?: {
+        [key: string]: SchemaCreateParams.NodeTypes;
+    };
+    organization_id?: string | null;
+    read_access?: Array<string>;
+    /**
+     * Custom relationship types (max 20 per schema)
+     */
+    relationship_types?: {
+        [key: string]: SchemaCreateParams.RelationshipTypes;
+    };
+    scope?: 'personal' | 'workspace' | 'organization';
+    status?: 'draft' | 'active' | 'deprecated' | 'archived';
+    updated_at?: string | null;
+    usage_count?: number;
+    user_id?: string | {
+        [key: string]: unknown;
+    } | null;
+    version?: string;
+    workspace_id?: string | {
+        [key: string]: unknown;
+    } | null;
+    write_access?: Array<string>;
+}
+export declare namespace SchemaCreateParams {
+    /**
+     * User-defined node type
+     */
+    interface NodeTypes {
+        label: string;
+        name: string;
+        color?: string | null;
+        description?: string | null;
+        icon?: string | null;
+        /**
+         * Node properties (max 15 per node type)
+         */
+        properties?: {
+            [key: string]: NodeTypes.Properties;
+        };
+        required_properties?: Array<string>;
+        /**
+         * Properties that uniquely identify this node type. Used for MERGE operations to
+         * avoid duplicates. Example: ['name', 'email'] for Customer nodes.
+         */
+        unique_identifiers?: Array<string>;
+    }
+    namespace NodeTypes {
+        /**
+         * Property definition for nodes/relationships
+         */
+        interface Properties {
+            type: 'string' | 'integer' | 'float' | 'boolean' | 'array' | 'datetime' | 'object';
+            default?: unknown;
+            description?: string | null;
+            /**
+             * List of allowed enum values (max 10)
+             */
+            enum_values?: Array<string> | null;
+            max_length?: number | null;
+            max_value?: number | null;
+            min_length?: number | null;
+            min_value?: number | null;
+            pattern?: string | null;
+            required?: boolean;
+        }
+    }
+    /**
+     * User-defined relationship type
+     */
+    interface RelationshipTypes {
+        allowed_source_types: Array<string>;
+        allowed_target_types: Array<string>;
+        label: string;
+        name: string;
+        cardinality?: 'one-to-one' | 'one-to-many' | 'many-to-many';
+        color?: string | null;
+        description?: string | null;
+        properties?: {
+            [key: string]: RelationshipTypes.Properties;
+        };
+    }
+    namespace RelationshipTypes {
+        /**
+         * Property definition for nodes/relationships
+         */
+        interface Properties {
+            type: 'string' | 'integer' | 'float' | 'boolean' | 'array' | 'datetime' | 'object';
+            default?: unknown;
+            description?: string | null;
+            /**
+             * List of allowed enum values (max 10)
+             */
+            enum_values?: Array<string> | null;
+            max_length?: number | null;
+            max_value?: number | null;
+            min_length?: number | null;
+            min_value?: number | null;
+            pattern?: string | null;
+            required?: boolean;
+        }
+    }
+}
+export interface SchemaUpdateParams {
+    body: {
+        [key: string]: unknown;
+    };
+}
+export interface SchemaListParams {
+    /**
+     * Filter by status (draft, active, deprecated, archived)
+     */
+    status_filter?: string | null;
+    /**
+     * Filter by workspace ID
+     */
+    workspace_id?: string | null;
+}
+export declare namespace Schemas {
+    export { type UserGraphSchemaOutput as UserGraphSchemaOutput, type SchemaCreateResponse as SchemaCreateResponse, type SchemaRetrieveResponse as SchemaRetrieveResponse, type SchemaUpdateResponse as SchemaUpdateResponse, type SchemaListResponse as SchemaListResponse, type SchemaDeleteResponse as SchemaDeleteResponse, type SchemaCreateParams as SchemaCreateParams, type SchemaUpdateParams as SchemaUpdateParams, type SchemaListParams as SchemaListParams, };
+}
+//# sourceMappingURL=schemas.d.ts.map

package/resources/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/resources/schemas.ts"],"names":[],"mappings":"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"}

package/resources/schemas.js

@@ -0,0 +1,127 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Schemas = void 0;
+const resource_1 = require("../core/resource.js");
+const path_1 = require("../internal/utils/path.js");
+class Schemas extends resource_1.APIResource {
+    /**
+     * Create a new user-defined graph schema.
+     *
+     *     This endpoint allows users to define custom node types and relationships for their knowledge graph.
+     *     The schema will be validated and stored for use in future memory extractions.
+     *
+     *     **Features:**
+     *     - Define custom node types with properties and validation rules
+     *     - Define custom relationship types with constraints
+     *     - Automatic validation against system schemas
+     *     - Support for different scopes (personal, workspace, organization)
+     *     - **Enum support**: Use `enum_values` to restrict property values to a predefined list (max 10 values)
+     *     - **Auto-indexing**: Required properties are automatically indexed in Neo4j for optimal query performance
+     *
+     *     **Property Types & Validation:**
+     *     - `string`: Text values with optional `enum_values`, `min_length`, `max_length`, `pattern`
+     *     - `integer`: Whole numbers with optional `min_value`, `max_value`
+     *     - `float`: Decimal numbers with optional `min_value`, `max_value`
+     *     - `boolean`: True/false values
+     *     - `datetime`: ISO 8601 timestamp strings
+     *     - `array`: Lists of values
+     *     - `object`: Complex nested objects
+     *
+     *     **Enum Values:**
+     *     - Add `enum_values` to any string property to restrict values to a predefined list
+     *     - Maximum 10 enum values allowed per property
+     *     - Use with `default` to set a default enum value
+     *     - Example: `"enum_values": ["small", "medium", "large"]`
+     *
+     *     **When to Use Enums:**
+     *     - Limited, well-defined options (≤10 values): sizes, statuses, categories, priorities
+     *     - Controlled vocabularies: "active/inactive", "high/medium/low", "bronze/silver/gold"
+     *     - When you want exact matching and no variations
+     *
+     *     **When to Avoid Enums:**
+     *     - Open-ended text fields: names, titles, descriptions, addresses
+     *     - Large sets of options (>10): countries, cities, product models
+     *     - When you want semantic similarity matching for entity resolution
+     *     - Dynamic or frequently changing value sets
+     *
+     *     **Unique Identifiers & Entity Resolution:**
+     *     - Properties marked as `unique_identifiers` are used for entity deduplication and merging
+     *     - **With enum_values**: Exact matching is used - entities with the same enum value are considered identical
+     *     - **Without enum_values**: Semantic similarity matching is used - entities with similar meanings are automatically merged
+     *     - Example: A "name" unique_identifier without enums will merge "Apple Inc" and "Apple Inc." as the same entity
+     *     - Example: A "sku" unique_identifier with enums will only merge entities with exactly matching SKU codes
+     *     - Use enums for unique_identifiers when you have a limited, predefined set of values (≤10 options)
+     *     - Avoid enums for unique_identifiers when you have broad, open-ended values or >10 possible options
+     *     - **Best practices**: Use enums for controlled vocabularies (status codes, categories), avoid for open text (company names, product titles)
+     *     - **In the example above**: "name" uses semantic similarity (open-ended), "sku" uses exact matching (controlled set)
+     *
+     *     **LLM-Friendly Descriptions:**
+     *     - Write detailed property descriptions that guide the LLM on expected formats and usage
+     *     - Include examples of typical values (e.g., "Product name, typically 2-4 words like 'iPhone 15 Pro'")
+     *     - Specify data formats and constraints clearly (e.g., "Price in USD as decimal number")
+     *     - For enums, explain when to use each option (e.g., "use 'new' for brand new items")
+     *
+     *     **Authentication Required**:
+     *     One of the following authentication methods must be used:
+     *     - Bearer token in `Authorization` header
+     *     - API Key in `X-API-Key` header
+     *     - Session token in `X-Session-Token` header
+     *
+     *     **Required Headers**:
+     *     - Content-Type: application/json
+     *     - X-Client-Type: (e.g., 'papr_plugin', 'browser_extension')
+     */
+    create(body, options) {
+        return this._client.post('/v1/schemas', { body, ...options });
+    }
+    /**
+     * Get a specific schema by ID.
+     *
+     *     Returns the complete schema definition including node types, relationship types,
+     *     and metadata. User must have read access to the schema.
+     */
+    retrieve(schemaID, options) {
+        return this._client.get((0, path_1.path) `/v1/schemas/${schemaID}`, options);
+    }
+    /**
+     * Update an existing schema.
+     *
+     *     Allows modification of schema properties, node types, and relationship types.
+     *     User must have write access to the schema. Updates create a new version
+     *     while preserving the existing data.
+     */
+    update(schemaID, params, options) {
+        const { body } = params;
+        return this._client.put((0, path_1.path) `/v1/schemas/${schemaID}`, { body: body, ...options });
+    }
+    /**
+     * List all schemas accessible to the authenticated user.
+     *
+     *     Returns schemas that the user owns or has read access to, including:
+     *     - Personal schemas created by the user
+     *     - Workspace schemas shared within the user's workspace
+     *     - Organization schemas available to the user's organization
+     *
+     *     **Authentication Required**:
+     *     One of the following authentication methods must be used:
+     *     - Bearer token in `Authorization` header
+     *     - API Key in `X-API-Key` header
+     *     - Session token in `X-Session-Token` header
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/schemas', { query, ...options });
+    }
+    /**
+     * Delete a schema.
+     *
+     *     Soft deletes the schema by marking it as archived. The schema data and
+     *     associated graph nodes/relationships are preserved for data integrity.
+     *     User must have write access to the schema.
+     */
+    delete(schemaID, options) {
+        return this._client.delete((0, path_1.path) `/v1/schemas/${schemaID}`, options);
+    }
+}
+exports.Schemas = Schemas;
+//# sourceMappingURL=schemas.js.map

package/resources/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/resources/schemas.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAA8C;AAE9C,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkEG;IACH,MAAM,CAAC,IAAwB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAAgB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA0B,EAC1B,OAAwB;QAExB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAgB,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;CACF;AAjID,0BAiIC"}