studiograph 1.0.0

package/README.md

@@ -0,0 +1,18 @@
+# Studiograph
+
+Team-based AI agent platform with Git-backed knowledge graphs.
+
+## Architecture
+
+**Granular Repos** (one per project/function/resource):
+- **Project repos**: cooper-hewitt/, globalance/, etc.
+- **Function repos**: new-business/, accounting/, hr/, etc.
+- **Shared resources**: templates/, research/, resources/, etc.
+
+**Flexible entity types** - not hardcoded schemas.
+
+## Status
+
+🚧 **Phase 1: MVP Build (In Progress)**
+
+See [Build Plan](../Vaults/Schema/Projects/Studiograph/Build%20Plan.md) for details.

package/dist/agent/orchestrator.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Agent Orchestrator
+ *
+ * Manages the Pi-Mono agent instance and coordinates with workspace managers.
+ * Loads skills, handles system prompts, and manages conversation flow.
+ */
+import { WorkspaceManager } from '../core/workspace-manager.js';
+import { WorkspaceConfig } from '../core/types.js';
+import { GitUser } from '../services/git.js';
+export interface AgentConfig {
+    workspacePath: string;
+    workspaceConfig: WorkspaceConfig;
+    gitUser: GitUser;
+    skillsPath?: string;
+}
+export interface AgentResponse {
+    content: string;
+    toolCalls?: Array<{
+        tool: string;
+        input: any;
+        output: any;
+    }>;
+}
+export declare class AgentOrchestrator {
+    private workspacePath;
+    private workspaceManager;
+    private agent;
+    private config;
+    private gitUser;
+    private skillsPath;
+    constructor(config: AgentConfig);
+    /**
+     * Create Pi-Mono agent with tools and system prompt
+     */
+    private createAgent;
+    /**
+     * Load system prompt from file
+     */
+    private loadSystemPrompt;
+    /**
+     * Get default system prompt
+     */
+    private getDefaultSystemPrompt;
+    /**
+     * Load tools from skills directory
+     */
+    private loadTools;
+    /**
+     * Send a message to the agent
+     */
+    chat(userMessage: string): Promise<AgentResponse>;
+    /**
+     * Get workspace manager (for tools)
+     */
+    getWorkspaceManager(): WorkspaceManager;
+    /**
+     * Get workspace summary
+     */
+    getSummary(): {
+        totalRepos: number;
+        totalEntities: number;
+        entitiesByType: Record<string, number>;
+        entitiesByRepo: Record<string, number>;
+    };
+    /**
+     * Get repository names
+     */
+    getRepoNames(): string[];
+}

package/dist/agent/orchestrator.js

@@ -0,0 +1,211 @@
+/**
+ * Agent Orchestrator
+ *
+ * Manages the Pi-Mono agent instance and coordinates with workspace managers.
+ * Loads skills, handles system prompts, and manages conversation flow.
+ */
+import { readFileSync, existsSync, readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+import { getModel } from '@mariozechner/pi-ai';
+import { Agent } from '@mariozechner/pi-agent-core';
+import { WorkspaceManager } from '../core/workspace-manager.js';
+import { createGraphTools } from './tools/graph-tools.js';
+export class AgentOrchestrator {
+    workspacePath;
+    workspaceManager;
+    agent;
+    config;
+    gitUser;
+    skillsPath;
+    constructor(config) {
+        this.workspacePath = config.workspacePath;
+        this.config = config.workspaceConfig;
+        this.gitUser = config.gitUser;
+        this.skillsPath = config.skillsPath || join(this.workspacePath, 'skills');
+        // Initialize workspace manager
+        const orchestratorUser = { ...this.gitUser, role: 'admin' };
+        this.workspaceManager = new WorkspaceManager(this.workspacePath, this.config, this.gitUser, orchestratorUser);
+        // Initialize Pi-Mono agent
+        this.agent = this.createAgent();
+    }
+    /**
+     * Create Pi-Mono agent with tools and system prompt
+     */
+    createAgent() {
+        // Get model from config
+        const provider = this.config.model_provider || 'anthropic';
+        const modelId = this.config.model_id || 'claude-sonnet-4-5-20250929';
+        const apiKey = this.config.api_key || process.env.ANTHROPIC_API_KEY || '';
+        if (!apiKey) {
+            throw new Error('API key not found in config or environment');
+        }
+        const model = getModel(provider, modelId);
+        // Load system prompt
+        const systemPrompt = this.loadSystemPrompt();
+        // Load tools
+        const tools = this.loadTools();
+        // Create agent with API key getter
+        const agent = new Agent({
+            getApiKey: () => apiKey,
+        });
+        // Set model, system prompt, and tools
+        agent.setModel(model);
+        agent.setSystemPrompt(systemPrompt);
+        agent.setTools(tools);
+        return agent;
+    }
+    /**
+     * Load system prompt from file
+     */
+    loadSystemPrompt() {
+        const promptPath = join(__dirname, 'prompts', 'system.md');
+        if (!existsSync(promptPath)) {
+            // Fallback to basic prompt
+            return this.getDefaultSystemPrompt();
+        }
+        return readFileSync(promptPath, 'utf-8');
+    }
+    /**
+     * Get default system prompt
+     */
+    getDefaultSystemPrompt() {
+        const workspaceSummary = this.workspaceManager.getSummary();
+        const repoList = this.workspaceManager
+            .getAllRepoConfigs()
+            .map(r => `  - ${r.name} (${r.type}): ${r.description}`)
+            .join('\n');
+        return `# Studiograph AI Assistant
+
+You are Studiograph, an AI assistant helping creative teams manage their knowledge graphs.
+
+## Workspace Summary
+
+**Team:** ${this.config.team_name}
+**Repositories:** ${workspaceSummary.totalRepos}
+**Total Entities:** ${workspaceSummary.totalEntities}
+
+**Available Repositories:**
+${repoList}
+
+## Your Capabilities
+
+You can help with:
+- Creating and managing entities (projects, clients, decisions, references, etc.)
+- Searching across repositories
+- Validating wikilinks and relationships
+- Uploading and managing assets
+- Generating insights from the knowledge graph
+
+## Guidelines
+
+- Always ask clarifying questions before creating entities
+- Validate wikilinks to ensure data integrity
+- Suggest related entities based on context
+- Be proactive in maintaining the knowledge graph
+- Use the tools available to you effectively
+
+## Available Tools
+
+You have access to graph management tools that allow you to:
+- Create, read, update, and delete entities
+- Search and filter entities
+- Manage wikilinks and relationships
+- Upload and manage assets
+
+Use these tools to help users build and navigate their knowledge graph.
+`;
+    }
+    /**
+     * Load tools from skills directory
+     */
+    loadTools() {
+        const tools = [];
+        // Load built-in graph tools
+        const graphTools = createGraphTools(this.workspaceManager, this.gitUser);
+        tools.push(...graphTools);
+        // Load custom skills from skills directory
+        if (existsSync(this.skillsPath)) {
+            try {
+                const skillFiles = readdirSync(this.skillsPath).filter(f => f.endsWith('.js'));
+                for (const skillFile of skillFiles) {
+                    try {
+                        const skillPath = join(this.skillsPath, skillFile);
+                        const skill = require(skillPath);
+                        if (skill.default && typeof skill.default === 'object') {
+                            tools.push(skill.default);
+                        }
+                    }
+                    catch (error) {
+                        console.warn(`Failed to load skill ${skillFile}:`, error);
+                    }
+                }
+            }
+            catch (error) {
+                console.warn('Failed to load skills:', error);
+            }
+        }
+        return tools;
+    }
+    /**
+     * Send a message to the agent
+     */
+    async chat(userMessage) {
+        return new Promise((resolve, reject) => {
+            let content = '';
+            const toolCalls = [];
+            // Subscribe to agent events
+            const unsubscribe = this.agent.subscribe((event) => {
+                if (event.type === 'message_update') {
+                    const msgEvent = event.assistantMessageEvent;
+                    if (msgEvent.type === 'text_delta') {
+                        content += msgEvent.delta;
+                    }
+                }
+                else if (event.type === 'message_end') {
+                    // Extract tool calls from message content
+                    const msg = event.message;
+                    if (msg.role === 'assistant') {
+                        for (const block of msg.content) {
+                            if (block.type === 'toolCall') {
+                                toolCalls.push({
+                                    tool: block.name,
+                                    input: block.input,
+                                    output: null, // Will be populated by tool execution
+                                });
+                            }
+                        }
+                    }
+                    unsubscribe();
+                    resolve({ content, toolCalls });
+                }
+            });
+            // Send message and handle errors
+            this.agent.prompt(userMessage).catch((error) => {
+                unsubscribe();
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Get workspace manager (for tools)
+     */
+    getWorkspaceManager() {
+        return this.workspaceManager;
+    }
+    /**
+     * Get workspace summary
+     */
+    getSummary() {
+        return this.workspaceManager.getSummary();
+    }
+    /**
+     * Get repository names
+     */
+    getRepoNames() {
+        return this.workspaceManager.getRepoNames();
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/agent/orchestrator.js.map

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

package/dist/agent/tools/graph-tools.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Graph Management Tools for Pi-Mono Agent
+ *
+ * These tools allow the agent to interact with the knowledge graph:
+ * - Create, read, update, delete entities
+ * - Search and filter
+ * - Manage wikilinks
+ * - Upload assets
+ */
+import { WorkspaceManager } from '../../core/workspace-manager.js';
+/**
+ * Create graph tools for the agent
+ */
+export declare function createGraphTools(workspaceManager: WorkspaceManager, gitUser: {
+    id: string;
+    name: string;
+    email: string;
+}): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{}>;
+    execute: (toolCallId: string, params: any) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: any;
+    }>;
+}[];