Network-AI
AI integration files

Claude Tools JSON

Claude API and Codex tool-use schema for exposing Network-AI actions.

Source file: claude-tools.json
[
  {
    "name": "delegate_task",
    "description": "Delegate a task to a specialized sub-agent within the Network-AI swarm. The swarm uses a shared blackboard for coordination. Use this to route work to agents like data_analyst, strategy_advisor, or risk_assessor. DENY: Do not delegate tasks that access PAYMENTS, DATABASE, or FILE_EXPORT resources unless a valid AuthGuardian grant token has been obtained for the target agent and resource. Do not delegate tasks outside the current swarm context or to agent IDs not registered in the active swarm. Do not forward raw user input as taskPayload without sanitization.",
    "input_schema": {
      "type": "object",
      "properties": {
        "targetAgent": {
          "type": "string",
          "description": "The identifier of the target agent to receive the task (e.g. data_analyst, strategy_advisor, risk_assessor)"
        },
        "taskPayload": {
          "type": "object",
          "description": "The task context, instructions, and any required data"
        },
        "priority": {
          "type": "string",
          "enum": ["low", "normal", "high", "critical"],
          "description": "Task priority level for queue ordering. Defaults to normal."
        },
        "timeout": {
          "type": "number",
          "description": "Maximum execution time in milliseconds. Defaults to 30000."
        },
        "requiresAuth": {
          "type": "boolean",
          "description": "Whether this task requires AuthGuardian permission grant before execution."
        }
      },
      "required": ["targetAgent", "taskPayload"]
    }
  },
  {
    "name": "query_swarm_state",
    "description": "Query the current state of the agent swarm — active tasks, blackboard contents, agent availability, and permission grants.",
    "input_schema": {
      "type": "object",
      "properties": {
        "scope": {
          "type": "string",
          "enum": ["all", "agents", "tasks", "blackboard", "permissions"],
          "description": "The scope of state information to retrieve. Defaults to all."
        },
        "agentFilter": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Optional list of agent IDs to filter results"
        },
        "includeHistory": {
          "type": "boolean",
          "description": "Include historical task execution data. Defaults to false."
        }
      }
    }
  },
  {
    "name": "spawn_parallel_agents",
    "description": "Spawn multiple sub-agents in parallel for complex task decomposition. Results are combined using a synthesis strategy. DENY: Do not spawn more than the swarm's configured concurrency limit. Do not spawn agents with shell_exec capabilities unless AgentRuntime SandboxPolicy is active and auto_approve is explicitly disabled. Spawning agents that access sensitive resource types (PAYMENTS, DATABASE, EMAIL, FILE_EXPORT) requires a prior AuthGuardian permission grant per agent.",
    "input_schema": {
      "type": "object",
      "properties": {
        "tasks": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "agentType": { "type": "string" },
              "taskPayload": { "type": "object" }
            },
            "required": ["agentType", "taskPayload"]
          },
          "description": "Array of parallel tasks to execute simultaneously"
        },
        "synthesisStrategy": {
          "type": "string",
          "enum": ["merge", "vote", "chain", "first-success"],
          "description": "How to combine results from parallel agents. Defaults to merge."
        }
      },
      "required": ["tasks"]
    }
  },
  {
    "name": "request_permission",
    "description": "Request permission from AuthGuardian before accessing a protected resource type. Always call this before DATABASE, PAYMENTS, EMAIL, or FILE_EXPORT operations.",
    "input_schema": {
      "type": "object",
      "properties": {
        "resourceType": {
          "type": "string",
          "enum": ["DATABASE", "PAYMENTS", "EMAIL", "FILE_EXPORT"],
          "description": "The type of protected resource being requested"
        },
        "justification": {
          "type": "string",
          "description": "Clear reason for requesting access — must be specific to the current task"
        },
        "scope": {
          "type": "string",
          "description": "Specific scope of access needed (e.g. read:invoices, read:revenue)"
        }
      },
      "required": ["resourceType", "justification"]
    }
  },
  {
    "name": "update_blackboard",
    "description": "Write or update an entry on the shared blackboard for cross-agent coordination. The blackboard persists state between agents.",
    "input_schema": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string",
          "description": "The blackboard entry key (e.g. task:001:data_analyst)"
        },
        "value": {
          "description": "The data to store — can be any JSON-serializable value"
        },
        "ttl": {
          "type": "number",
          "description": "Time-to-live in seconds. Entry expires and returns null after this duration."
        }
      },
      "required": ["key", "value"]
    }
  },
  {
    "name": "inject_context",
    "description": "Read the persistent project context (Layer 3 memory) and return a formatted markdown block for injection into an agent system prompt. Contains goals, tech stack, architecture decisions, milestones, and banned approaches that persist across all sessions.",
    "input_schema": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "update_context",
    "description": "Persist a decision, milestone, stack entry, goal, or banned approach to the project context file (Layer 3 memory). Use this to record information that every agent in every future session should know.",
    "input_schema": {
      "type": "object",
      "properties": {
        "section": {
          "type": "string",
          "enum": ["decisions", "milestones", "stack", "goals", "banned", "project"],
          "description": "The context section to update"
        },
        "add": {
          "description": "Item to append — JSON object for decisions/milestones, plain string for goals/banned"
        },
        "set": {
          "type": "object",
          "description": "Key-value pairs to merge (use for stack and project sections)"
        },
        "complete": {
          "type": "string",
          "description": "Milestone name to mark as completed (milestones section only)"
        }
      },
      "required": ["section"]
    }
  },
  {
    "name": "run_qa_harness",
    "description": "Run a batch of blackboard entries through the QA quality gate and return aggregate results including pass rate, contradictions between agents, and a regression snapshot.",
    "input_schema": {
      "type": "object",
      "properties": {
        "scenarios": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": { "type": "string", "description": "Unique scenario identifier" },
              "key": { "type": "string", "description": "Blackboard key" },
              "value": { "description": "The value to gate — any JSON-serializable data" },
              "sourceAgent": { "type": "string", "description": "Agent that produced the value" },
              "minScore": { "type": "number", "description": "Per-scenario quality threshold override (0-1)" }
            },
            "required": ["id", "key", "value", "sourceAgent"]
          },
          "description": "Array of scenarios to run through quality gates"
        },
        "qualityThreshold": {
          "type": "number",
          "description": "Global minimum quality score (0-1). Defaults to 0.7."
        }
      },
      "required": ["scenarios"]
    }
  }
]