pltr-cli 0.12.0__tar.gz → 0.13.0__tar.gz

{pltr_cli-0.12.0 → pltr_cli-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pltr-cli
-Version: 0.12.0
+Version: 0.13.0
 Summary: Command-line interface for Palantir Foundry APIs
 Project-URL: Homepage, https://github.com/anjor/pltr-cli
 Project-URL: Repository, https://github.com/anjor/pltr-cli
@@ -27,7 +27,7 @@ Classifier: Topic :: System :: Systems Administration
 Classifier: Topic :: Utilities
 Requires-Python: >=3.9
 Requires-Dist: click-repl>=0.3.0
-Requires-Dist: foundry-platform-sdk>=1.27.0
+Requires-Dist: foundry-platform-sdk<2.0.0,>=1.69.0
 Requires-Dist: keyring>=25.6.0
 Requires-Dist: pandas>=2.0.0
 Requires-Dist: python-dotenv>=1.1.1
@@ -56,6 +56,9 @@ A comprehensive command-line interface for Palantir Foundry APIs, providing 81+
 - 🎯 **Comprehensive Ontology Access**: 13 commands for objects, actions, and queries
 - 🏗️ **Orchestration Management**: Create, manage, and monitor builds, jobs, and schedules
 - 🎬 **MediaSets Operations**: Upload, download, and manage media content with transaction support
+- 🤖 **Models Management**: Create and inspect ML models and versions in the model registry
+- 🌊 **Streams Management**: Manage streaming datasets and publish real-time data
+- 💬 **Language Models**: Interact with Claude and OpenAI embeddings for LLM operations
 - 📝 **Full SQL Support**: Execute, submit, monitor, and export query results
 - 👥 **Admin Operations**: User, group, role, and organization management (16 commands)
 - 💻 **Interactive Shell**: REPL mode with tab completion and command history
@@ -334,6 +337,52 @@ pltr media-sets download ri.mediasets.main.media-set.abc \
 - Preview mode (`--preview`)
 - Transaction-based upload workflow
 
+### 🤖 Models Commands
+
+pltr-cli provides support for managing ML models and versions in the Foundry model registry. This is distinct from the LanguageModels module, which handles LLM chat and embeddings.
+
+**Note**: The SDK does not provide a way to list all models. Use the Foundry web UI or Ontology API to discover models.
+
+#### Model Operations
+```bash
+# Create a new model
+pltr models model create "fraud-detector" --folder ri.compass.main.folder.xxx
+
+# Get model details
+pltr models model get ri.foundry.main.model.abc123
+
+# Get model as JSON
+pltr models model get ri.foundry.main.model.abc123 --format json
+```
+
+#### Model Version Operations
+```bash
+# List all versions of a model
+pltr models version list ri.foundry.main.model.abc123
+
+# List with pagination
+pltr models version list ri.foundry.main.model.abc123 --page-size 50
+
+# Get next page
+pltr models version list ri.foundry.main.model.abc123 \
+  --page-size 50 --page-token <token-from-previous-response>
+
+# Get specific version details
+pltr models version get ri.foundry.main.model.abc123 v1.0.0
+
+# Save version details to file
+pltr models version get ri.foundry.main.model.abc123 v1.0.0 \
+  --format json --output version-details.json
+```
+
+**All Models commands support:**
+- Multiple output formats (table, JSON, CSV)
+- File output (`--output filename`)
+- Profile selection (`--profile production`)
+- Preview mode (`--preview`)
+
+**Note**: Model version creation requires specialized ML tooling and is not provided via CLI. Use the Python SDK directly for version creation with dill-serialized models.
+
 ### 📊 Dataset Transaction Management
 
 pltr-cli provides comprehensive transaction management for datasets, allowing atomic operations with rollback capability:

{pltr_cli-0.12.0 → pltr_cli-0.13.0}/README.md

@@ -18,6 +18,9 @@ A comprehensive command-line interface for Palantir Foundry APIs, providing 81+
 - 🎯 **Comprehensive Ontology Access**: 13 commands for objects, actions, and queries
 - 🏗️ **Orchestration Management**: Create, manage, and monitor builds, jobs, and schedules
 - 🎬 **MediaSets Operations**: Upload, download, and manage media content with transaction support
+- 🤖 **Models Management**: Create and inspect ML models and versions in the model registry
+- 🌊 **Streams Management**: Manage streaming datasets and publish real-time data
+- 💬 **Language Models**: Interact with Claude and OpenAI embeddings for LLM operations
 - 📝 **Full SQL Support**: Execute, submit, monitor, and export query results
 - 👥 **Admin Operations**: User, group, role, and organization management (16 commands)
 - 💻 **Interactive Shell**: REPL mode with tab completion and command history
@@ -296,6 +299,52 @@ pltr media-sets download ri.mediasets.main.media-set.abc \
 - Preview mode (`--preview`)
 - Transaction-based upload workflow
 
+### 🤖 Models Commands
+
+pltr-cli provides support for managing ML models and versions in the Foundry model registry. This is distinct from the LanguageModels module, which handles LLM chat and embeddings.
+
+**Note**: The SDK does not provide a way to list all models. Use the Foundry web UI or Ontology API to discover models.
+
+#### Model Operations
+```bash
+# Create a new model
+pltr models model create "fraud-detector" --folder ri.compass.main.folder.xxx
+
+# Get model details
+pltr models model get ri.foundry.main.model.abc123
+
+# Get model as JSON
+pltr models model get ri.foundry.main.model.abc123 --format json
+```
+
+#### Model Version Operations
+```bash
+# List all versions of a model
+pltr models version list ri.foundry.main.model.abc123
+
+# List with pagination
+pltr models version list ri.foundry.main.model.abc123 --page-size 50
+
+# Get next page
+pltr models version list ri.foundry.main.model.abc123 \
+  --page-size 50 --page-token <token-from-previous-response>
+
+# Get specific version details
+pltr models version get ri.foundry.main.model.abc123 v1.0.0
+
+# Save version details to file
+pltr models version get ri.foundry.main.model.abc123 v1.0.0 \
+  --format json --output version-details.json
+```
+
+**All Models commands support:**
+- Multiple output formats (table, JSON, CSV)
+- File output (`--output filename`)
+- Profile selection (`--profile production`)
+- Preview mode (`--preview`)
+
+**Note**: Model version creation requires specialized ML tooling and is not provided via CLI. Use the Python SDK directly for version creation with dill-serialized models.
+
 ### 📊 Dataset Transaction Management
 
 pltr-cli provides comprehensive transaction management for datasets, allowing atomic operations with rollback capability:

{pltr_cli-0.12.0 → pltr_cli-0.13.0}/claude_skill/SKILL.md

@@ -9,14 +9,14 @@ This skill helps you use the pltr-cli to interact with Palantir Foundry effectiv
 
 ## Compatibility
 
-- **Skill version**: 1.0.0
-- **pltr-cli version**: 0.11.0+
+- **Skill version**: 1.1.0
+- **pltr-cli version**: 0.12.0+
 - **Python**: 3.9, 3.10, 3.11, 3.12
-- **Dependencies**: foundry-platform-sdk >= 1.27.0
+- **Dependencies**: foundry-platform-sdk >= 1.69.0
 
 ## Overview
 
-pltr-cli is a comprehensive CLI with 80+ commands for:
+pltr-cli is a comprehensive CLI with 100+ commands for:
 - **Dataset operations**: Get info, list files, download files, manage branches and transactions
 - **SQL queries**: Execute queries, export results, manage async queries
 - **Ontology**: List ontologies, object types, objects, execute actions and queries
@@ -25,6 +25,11 @@ pltr-cli is a comprehensive CLI with 80+ commands for:
 - **Admin**: User, group, role management
 - **Connectivity**: External connections and data imports
 - **MediaSets**: Media file management
+- **Language Models**: Interact with Anthropic Claude models and OpenAI embeddings
+- **Streams**: Create and manage streaming datasets, publish real-time data
+- **Functions**: Execute queries and inspect value types
+- **AIP Agents**: Manage AI agents, sessions, and versions
+- **Models**: ML model registry for model and version management
 
 ## Critical Concepts
 
@@ -83,6 +88,11 @@ Load these files based on the user's task:
 | Folders, spaces, projects, resources, permissions | `reference/filesystem-commands.md` |
 | Connections, imports | `reference/connectivity-commands.md` |
 | Media sets, media items | `reference/mediasets-commands.md` |
+| Anthropic Claude models, OpenAI embeddings | `reference/language-models-commands.md` |
+| Streaming datasets, real-time data publishing | `reference/streams-commands.md` |
+| Functions queries, value types | `reference/functions-commands.md` |
+| AIP Agents, sessions, versions | `reference/aip-agents-commands.md` |
+| ML model registry, model versions | `reference/models-commands.md` |
 
 ## Workflow Files
 
@@ -126,6 +136,39 @@ pltr orchestration builds search
 
 # Interactive shell mode
 pltr shell
+
+# Send message to Claude model
+pltr language-models anthropic messages ri.language-models.main.model.xxx \
+    --message "Explain this concept"
+
+# Generate embeddings
+pltr language-models openai embeddings ri.language-models.main.model.xxx \
+    --input "Sample text"
+
+# Create streaming dataset
+pltr streams dataset create my-stream \
+    --folder ri.compass.main.folder.xxx \
+    --schema '{"fieldSchemaList": [{"name": "value", "type": "STRING"}]}'
+
+# Publish record to stream
+pltr streams stream publish ri.foundry.main.dataset.xxx \
+    --branch master \
+    --record '{"value": "hello"}'
+
+# Execute a function query
+pltr functions query execute myQuery --parameters '{"limit": 10}'
+
+# Get AIP Agent info
+pltr aip-agents get ri.foundry.main.agent.abc123
+
+# List agent sessions
+pltr aip-agents sessions list ri.foundry.main.agent.abc123
+
+# Get ML model info
+pltr models model get ri.foundry.main.model.abc123
+
+# List model versions
+pltr models version list ri.foundry.main.model.abc123
 ```
 
 ## Best Practices

pltr_cli-0.13.0/claude_skill/reference/aip-agents-commands.md

@@ -0,0 +1,209 @@
+# AIP Agents Commands
+
+Commands for managing AIP Agents, their conversation sessions, and version history in Foundry.
+
+## RID Formats
+- **Agent**: `ri.foundry.main.agent.{uuid}`
+- **Session**: `ri.foundry.main.session.{uuid}`
+
+## Agent Commands
+
+### Get Agent
+
+Get detailed information about an AIP Agent.
+
+```bash
+pltr aip-agents get AGENT_RID [OPTIONS]
+
+# Options:
+#   --version, -v TEXT      Agent version (e.g., '1.0') [default: latest published]
+#   --format, -f TEXT       Output format (table, json, csv)
+#   --output, -o TEXT       Output file path
+#   --profile, -p TEXT      Profile name
+
+# Examples
+
+# Get latest published version of agent
+pltr aip-agents get ri.foundry.main.agent.abc123
+
+# Get specific version
+pltr aip-agents get ri.foundry.main.agent.abc123 --version 1.5
+
+# Output as JSON
+pltr aip-agents get ri.foundry.main.agent.abc123 --format json
+
+# Save to file
+pltr aip-agents get ri.foundry.main.agent.abc123 \
+    --format json \
+    --output agent-info.json
+```
+
+## Session Commands
+
+### List Sessions
+
+List conversation sessions for an agent.
+
+**Important:** This only lists sessions created via the API. Sessions created in AIP Agent Studio will not appear.
+
+```bash
+pltr aip-agents sessions list AGENT_RID [OPTIONS]
+
+# Options:
+#   --page-size INTEGER     Number of sessions per page
+#   --max-pages INTEGER     Maximum pages to fetch [default: 1]
+#   --all                   Fetch all available sessions (overrides --max-pages)
+#   --format, -f TEXT       Output format (table, json, csv)
+#   --output, -o TEXT       Output file path
+#   --profile, -p TEXT      Profile name
+
+# Examples
+
+# List first page of sessions
+pltr aip-agents sessions list ri.foundry.main.agent.abc123
+
+# List all sessions
+pltr aip-agents sessions list ri.foundry.main.agent.abc123 --all
+
+# List first 3 pages with 50 sessions each
+pltr aip-agents sessions list ri.foundry.main.agent.abc123 \
+    --page-size 50 --max-pages 3
+
+# Export to CSV
+pltr aip-agents sessions list ri.foundry.main.agent.abc123 \
+    --all --format csv --output sessions.csv
+```
+
+### Get Session
+
+Get detailed information about a specific conversation session.
+
+```bash
+pltr aip-agents sessions get AGENT_RID SESSION_RID [OPTIONS]
+
+# Options:
+#   --format, -f TEXT       Output format (table, json, csv)
+#   --output, -o TEXT       Output file path
+#   --profile, -p TEXT      Profile name
+
+# Examples
+
+# Get session details
+pltr aip-agents sessions get \
+    ri.foundry.main.agent.abc123 \
+    ri.foundry.main.session.xyz789
+
+# Export session details to JSON
+pltr aip-agents sessions get \
+    ri.foundry.main.agent.abc123 \
+    ri.foundry.main.session.xyz789 \
+    --format json --output session.json
+```
+
+## Version Commands
+
+### List Versions
+
+List all versions for an AIP Agent. Versions are returned in descending order (most recent first).
+
+```bash
+pltr aip-agents versions list AGENT_RID [OPTIONS]
+
+# Options:
+#   --page-size INTEGER     Number of versions per page
+#   --max-pages INTEGER     Maximum pages to fetch [default: 1]
+#   --all                   Fetch all available versions (overrides --max-pages)
+#   --format, -f TEXT       Output format (table, json, csv)
+#   --output, -o TEXT       Output file path
+#   --profile, -p TEXT      Profile name
+
+# Examples
+
+# List first page of versions
+pltr aip-agents versions list ri.foundry.main.agent.abc123
+
+# List all versions
+pltr aip-agents versions list ri.foundry.main.agent.abc123 --all
+
+# Export all versions to CSV
+pltr aip-agents versions list ri.foundry.main.agent.abc123 \
+    --all --format csv --output versions.csv
+```
+
+## Session Visibility Note
+
+**API Sessions Only:** The `sessions list` command only shows sessions created through the API. Sessions created interactively in AIP Agent Studio are not visible through this endpoint.
+
+To work with all sessions including those from AIP Agent Studio, use the Foundry web interface.
+
+## Pagination
+
+Both `sessions list` and `versions list` support pagination:
+
+| Option | Description |
+|--------|-------------|
+| `--page-size N` | Number of items per page |
+| `--max-pages N` | Maximum pages to fetch (default: 1) |
+| `--all` | Fetch all available items |
+
+```bash
+# Fetch first 100 sessions across 2 pages of 50 each
+pltr aip-agents sessions list ri.foundry.main.agent.abc123 \
+    --page-size 50 --max-pages 2
+
+# Fetch everything
+pltr aip-agents sessions list ri.foundry.main.agent.abc123 --all
+```
+
+## Common Patterns
+
+### Inspect Agent Before Using
+
+```bash
+# Get agent details to understand its capabilities
+pltr aip-agents get ri.foundry.main.agent.abc123 --format json
+
+# Check available versions
+pltr aip-agents versions list ri.foundry.main.agent.abc123
+```
+
+### Export Session History
+
+```bash
+# List all sessions and export
+pltr aip-agents sessions list ri.foundry.main.agent.abc123 \
+    --all \
+    --format json \
+    --output all-sessions.json
+
+# Get details for specific session
+pltr aip-agents sessions get \
+    ri.foundry.main.agent.abc123 \
+    ri.foundry.main.session.xyz789 \
+    --format json \
+    --output session-details.json
+```
+
+### Track Agent Version History
+
+```bash
+# Export complete version history
+pltr aip-agents versions list ri.foundry.main.agent.abc123 \
+    --all \
+    --format csv \
+    --output agent-versions.csv
+```
+
+### Compare Agent Versions
+
+```bash
+# Get specific version details
+pltr aip-agents get ri.foundry.main.agent.abc123 --version 1.0 \
+    --format json --output v1.json
+
+pltr aip-agents get ri.foundry.main.agent.abc123 --version 2.0 \
+    --format json --output v2.json
+
+# Compare with diff
+diff v1.json v2.json
+```

{pltr_cli-0.12.0 → pltr_cli-0.13.0}/claude_skill/reference/filesystem-commands.md

@@ -59,17 +59,22 @@ pltr folder batch-get ri.compass.main.folder.abc123 ri.compass.main.folder.def45
 ### Create Space
 
 ```bash
-pltr space create DISPLAY_NAME ORGANIZATION_RID [OPTIONS]
+pltr space create DISPLAY_NAME [OPTIONS]
 
-# Options:
+# Required Options:
+#   --enrollment-rid, -e     Enrollment Resource Identifier
+#   --organization, -org     Organization RID(s) (can specify multiple)
+#   --deletion-policy-org    Organization RID(s) for deletion policy (can specify multiple)
+
+# Optional:
 #   --description TEXT       Space description
-#   --default-roles TEXT     Comma-separated default roles
-#   --role-grants TEXT       Role grants config (JSON)
 
 # Example
-pltr space create "Data Science Team" ri.compass.main.organization.abc123 \
-  --description "Space for analytics work" \
-  --default-roles "viewer,editor"
+pltr space create "Data Science Team" \
+  --enrollment-rid ri.enrollment.main.enrollment.abc123 \
+  --organization ri.compass.main.organization.xyz456 \
+  --deletion-policy-org ri.compass.main.organization.xyz456 \
+  --description "Space for analytics work"
 ```
 
 ### Get Space
@@ -96,25 +101,6 @@ pltr space update SPACE_RID [--display-name TEXT] [--description TEXT]
 pltr space delete SPACE_RID [--yes]
 ```
 
-### Space Member Management
-
-```bash
-# List members
-pltr space members SPACE_RID
-
-# Add member
-pltr space add-member SPACE_RID PRINCIPAL_ID PRINCIPAL_TYPE ROLE_NAME
-# PRINCIPAL_TYPE: "User" or "Group"
-
-# Remove member
-pltr space remove-member SPACE_RID PRINCIPAL_ID PRINCIPAL_TYPE
-
-# Examples
-pltr space add-member ri.compass.main.space.abc123 john.doe User editor
-pltr space add-member ri.compass.main.space.abc123 data-team Group viewer
-pltr space remove-member ri.compass.main.space.abc123 john.doe User
-```
-
 ## Project Commands
 
 ### Create Project
@@ -139,7 +125,6 @@ pltr project get PROJECT_RID
 pltr project list [--space-rid RID]
 pltr project update PROJECT_RID [--display-name TEXT] [--description TEXT]
 pltr project delete PROJECT_RID [--confirm]
-pltr project batch-get PROJECT_RIDS...
 ```
 
 ### Add Organizations to Project
@@ -223,22 +208,10 @@ pltr resource batch-get RESOURCE_RIDS...
 
 ```bash
 # Get metadata
-pltr resource metadata get RESOURCE_RID
-
-# Set metadata (JSON)
-pltr resource metadata set RESOURCE_RID '{"owner": "data-team", "env": "production"}'
-
-# Delete metadata keys
-pltr resource metadata delete RESOURCE_RID "key1,key2"
-```
-
-### Move Resource
-
-```bash
-pltr resource move RESOURCE_RID TARGET_FOLDER_RID
+pltr resource get-metadata RESOURCE_RID [--format FORMAT]
 
 # Example
-pltr resource move ri.foundry.main.dataset.abc123 ri.compass.main.folder.new456
+pltr resource get-metadata ri.foundry.main.dataset.abc123 --format json
 ```
 
 ## Resource Lifecycle Commands
@@ -413,13 +386,13 @@ pltr resource-role grant $DATASET analytics-team Group editor
 pltr resource-role grant $DATASET john.analyst User viewer
 ```
 
-### Organize resources
+### Find resources
 ```bash
-# Search and move datasets
+# Search for datasets
 pltr resource search "sales" --resource-type dataset --format json --output sales.json
 
-# Move to organized folder
+# Get resource details
 for rid in $(cat sales.json | jq -r '.[].rid'); do
-  pltr resource move "$rid" ri.compass.main.folder.sales-data
+  pltr resource get "$rid" --format json
 done
 ```