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

pltr_cli-0.13.0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,56 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'

pltr_cli-0.13.0/.github/workflows/claude.yml

@@ -0,0 +1,49 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'

{pltr_cli-0.11.0 → pltr_cli-0.13.0}/.gitignore

@@ -144,5 +144,12 @@ cython_debug/
 config.ini
 credentials.json
 
+# Test data files (avoid committing test outputs to root)
+/children.csv
+/folder_info.json
+/folders.json
+/*.csv
+/*.json
+
 # ruff
 .ruff_cache/

{pltr_cli-0.11.0 → pltr_cli-0.13.0}/.pre-commit-config.yaml

@@ -41,7 +41,7 @@ repos:
 
   # Python code formatting with Ruff
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.9
+    rev: v0.12.8
     hooks:
       - id: ruff
         name: Ruff linter

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pltr-cli
-Version: 0.11.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,8 +27,9 @@ 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
 Requires-Dist: requests>=2.32.4
 Requires-Dist: rich>=14.1.0
@@ -37,7 +38,7 @@ Description-Content-Type: text/markdown
 
 # pltr-cli
 
-A comprehensive command-line interface for Palantir Foundry APIs, providing 80+ commands for data analysis, dataset management, ontology operations, orchestration, SQL queries, folder management, and administrative tasks.
+A comprehensive command-line interface for Palantir Foundry APIs, providing 81+ commands for data analysis, dataset management, ontology operations, orchestration, SQL queries, folder management, and administrative tasks.
 
 ## Overview
 
@@ -55,6 +56,9 @@ A comprehensive command-line interface for Palantir Foundry APIs, providing 80+
 - 🎯 **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
@@ -215,6 +219,7 @@ pltr connectivity import table <conn-rid> <table-name> <dataset-rid> --execute
 # Administrative
 pltr admin user current        # Current user info
 pltr admin user list          # List users
+pltr third-party-apps get <rid>  # Get third-party application details
 
 # Interactive & Tools
 pltr shell                    # Interactive mode
@@ -332,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:
@@ -470,7 +521,7 @@ See **[API Wrapper Documentation](docs/api/wrapper.md)** for detailed architectu
 
 pltr-cli is **production-ready** with comprehensive features:
 
-- ✅ **80+ Commands** across 10 command groups
+- ✅ **81+ Commands** across 11 command groups
 - ✅ **273 Unit Tests** with 67% code coverage
 - ✅ **Published on PyPI** with automated releases
 - ✅ **Cross-Platform** support (Windows, macOS, Linux)

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

@@ -1,6 +1,6 @@
 # pltr-cli
 
-A comprehensive command-line interface for Palantir Foundry APIs, providing 80+ commands for data analysis, dataset management, ontology operations, orchestration, SQL queries, folder management, and administrative tasks.
+A comprehensive command-line interface for Palantir Foundry APIs, providing 81+ commands for data analysis, dataset management, ontology operations, orchestration, SQL queries, folder management, and administrative tasks.
 
 ## Overview
 
@@ -18,6 +18,9 @@ A comprehensive command-line interface for Palantir Foundry APIs, providing 80+
 - 🎯 **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
@@ -178,6 +181,7 @@ pltr connectivity import table <conn-rid> <table-name> <dataset-rid> --execute
 # Administrative
 pltr admin user current        # Current user info
 pltr admin user list          # List users
+pltr third-party-apps get <rid>  # Get third-party application details
 
 # Interactive & Tools
 pltr shell                    # Interactive mode
@@ -295,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:
@@ -433,7 +483,7 @@ See **[API Wrapper Documentation](docs/api/wrapper.md)** for detailed architectu
 
 pltr-cli is **production-ready** with comprehensive features:
 
-- ✅ **80+ Commands** across 10 command groups
+- ✅ **81+ Commands** across 11 command groups
 - ✅ **273 Unit Tests** with 67% code coverage
 - ✅ **Published on PyPI** with automated releases
 - ✅ **Cross-Platform** support (Windows, macOS, Linux)

pltr_cli-0.13.0/claude_skill/README.md

@@ -0,0 +1,51 @@
+# pltr-cli Claude Code Skill
+
+This directory contains a Claude Code skill for working with Palantir Foundry using the pltr-cli.
+
+## Installation
+
+### Use Within This Repository
+
+The skill is automatically available when using Claude Code in this repository.
+
+### Install Globally
+
+```bash
+cp -r claude_skill ~/.claude/skills/pltr
+```
+
+## Structure
+
+```
+claude_skill/
+├── SKILL.md                    # Main skill definition
+├── reference/                  # Command references (loaded on-demand)
+│   ├── quick-start.md         # Setup and authentication
+│   ├── dataset-commands.md    # Dataset operations
+│   ├── sql-commands.md        # SQL queries
+│   ├── orchestration-commands.md  # Builds, jobs, schedules
+│   ├── ontology-commands.md   # Ontology operations
+│   ├── admin-commands.md      # User/group management
+│   ├── filesystem-commands.md # Folders, spaces, projects
+│   ├── connectivity-commands.md   # Connections, imports
+│   └── mediasets-commands.md  # Media operations
+└── workflows/                  # Common patterns
+    ├── data-analysis.md       # Analysis workflows
+    ├── data-pipeline.md       # ETL and pipelines
+    └── permission-management.md   # Access control
+```
+
+## Usage
+
+Ask Claude Code questions about Foundry tasks:
+
+- "How do I query a dataset?"
+- "Help me set up a daily build schedule"
+- "Grant viewer access to john.doe on my dataset"
+- "Execute SQL query to count rows"
+
+Claude will automatically use this skill to provide accurate guidance.
+
+## Documentation
+
+See [docs/user-guide/claude-skill.md](../docs/user-guide/claude-skill.md) for full documentation.

pltr_cli-0.13.0/claude_skill/SKILL.md

@@ -0,0 +1,188 @@
+---
+name: pltr-cli
+description: Helps you work with Palantir Foundry using the pltr CLI. Use this when you need to query datasets, manage orchestration builds, work with ontologies, run SQL queries, manage folders/spaces/projects, copy datasets, or perform admin operations in Foundry. Triggers: Foundry, pltr, dataset, SQL query, ontology, build, schedule, RID.
+---
+
+# pltr-cli: Palantir Foundry CLI
+
+This skill helps you use the pltr-cli to interact with Palantir Foundry effectively.
+
+## Compatibility
+
+- **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.69.0
+
+## Overview
+
+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
+- **Orchestration**: Manage builds, jobs, and schedules
+- **Filesystem**: Folders, spaces, projects, resources
+- **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
+
+### RID-Based API
+The Foundry API is **RID-based** (Resource Identifier). Most commands require RIDs:
+- **Datasets**: `ri.foundry.main.dataset.{uuid}`
+- **Folders**: `ri.compass.main.folder.{uuid}` (root: `ri.compass.main.folder.0`)
+- **Builds**: `ri.orchestration.main.build.{uuid}`
+- **Schedules**: `ri.orchestration.main.schedule.{uuid}`
+- **Ontologies**: `ri.ontology.main.ontology.{uuid}`
+
+Users must know RIDs in advance (from Foundry web UI or previous API calls).
+
+### Authentication
+Before using any command, ensure authentication is configured:
+```bash
+# Configure interactively
+pltr configure configure
+
+# Or use environment variables
+export FOUNDRY_TOKEN="your-token"
+export FOUNDRY_HOST="foundry.company.com"
+
+# Verify connection
+pltr verify
+```
+
+### Output Formats
+All commands support multiple output formats:
+```bash
+pltr <command> --format table    # Default: Rich table
+pltr <command> --format json     # JSON output
+pltr <command> --format csv      # CSV format
+pltr <command> --output file.csv # Save to file
+```
+
+### Profile Selection
+Use `--profile` to switch between Foundry instances:
+```bash
+pltr <command> --profile production
+pltr <command> --profile development
+```
+
+## Reference Files
+
+Load these files based on the user's task:
+
+| Task Type | Reference File |
+|-----------|----------------|
+| Setup, authentication, getting started | `reference/quick-start.md` |
+| Dataset operations (get, files, branches, transactions) | `reference/dataset-commands.md` |
+| SQL queries | `reference/sql-commands.md` |
+| Builds, jobs, schedules | `reference/orchestration-commands.md` |
+| Ontologies, objects, actions | `reference/ontology-commands.md` |
+| Users, groups, roles, orgs | `reference/admin-commands.md` |
+| 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
+
+For common multi-step tasks:
+
+| Workflow | File |
+|----------|------|
+| Data exploration, SQL analysis, ontology queries | `workflows/data-analysis.md` |
+| ETL pipelines, scheduled jobs, data quality | `workflows/data-pipeline.md` |
+| Setting up permissions, resource roles, access control | `workflows/permission-management.md` |
+
+## Common Commands Quick Reference
+
+```bash
+# Verify setup
+pltr verify
+
+# Current user info
+pltr admin user current
+
+# Execute SQL query
+pltr sql execute "SELECT * FROM my_table LIMIT 10"
+
+# Get dataset info
+pltr dataset get ri.foundry.main.dataset.abc123
+
+# List files in dataset
+pltr dataset files list ri.foundry.main.dataset.abc123
+
+# Download file from dataset
+pltr dataset files get ri.foundry.main.dataset.abc123 "/path/file.csv" "./local.csv"
+
+# Copy dataset to another folder
+pltr cp ri.foundry.main.dataset.abc123 ri.compass.main.folder.target456
+
+# List folder contents
+pltr folder list ri.compass.main.folder.0  # root folder
+
+# Search builds
+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
+
+1. **Always verify authentication first**: Run `pltr verify` before starting work
+2. **Use appropriate output format**: JSON for programmatic use, CSV for spreadsheets, table for readability
+3. **Use async for large queries**: `pltr sql submit` + `pltr sql wait` for long-running queries
+4. **Export results**: Use `--output` to save results for further analysis
+5. **Use shell mode for exploration**: `pltr shell` provides tab completion and history
+
+## Getting Help
+
+```bash
+pltr --help                    # All commands
+pltr <command> --help          # Command help
+pltr <command> <sub> --help    # Subcommand help
+```