cogames-agents 0.0.0.10__tar.gz → 0.0.2__tar.gz

{cogames_agents-0.0.0.10 → cogames_agents-0.0.2}/MANIFEST.in

@@ -1,8 +1,6 @@
 # Include Nim source files for building from source distribution
 recursive-include src/cogames_agents/policy/nim_agents *.nim *.nims
 include src/cogames_agents/policy/nim_agents/nimby.lock
-include .nim-version
-include .nimby-version
 
 # Exclude build artifacts
 prune src/cogames_agents/policy/nim_agents/nimbledeps

cogames_agents-0.0.2/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: cogames-agents
+Version: 0.0.2
+Summary: Optional agent policies for CoGames
+Author: Metta AI
+License: MIT
+Project-URL: Homepage, https://github.com/Metta-AI/metta/tree/main/packages/cogames-agents
+Project-URL: Repository, https://github.com/Metta-AI/metta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Requires-Python: <3.13,>=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: cogames>=0.0.1
+Requires-Dist: mettagrid==0.2.0.58
+Requires-Dist: numpy>=2.0.0
+
+# cogames-agents
+
+Optional scripted policies for CoGames. Use them for quick baselines, play/eval smoke tests, or as teacher policies.
+
+## Scripted policy registry
+
+The registry at `cogames_agents.policy.scripted_registry` maps short names to `metta://policy/...` URIs. Scripted agents
+and teachers share these identifiers, so the same name works for evaluation, play, and `TeacherConfig.policy_uri`.
+
+Available scripted policy names:
+
+- `baseline`
+- `ladybug`
+- `thinky`
+- `race_car`
+- `nim_random`
+- `cogsguard`
+- `cogsguard_py`
+- `teacher`
+- `miner`
+- `scout`
+- `aligner`
+- `scrambler`
+
+Role-specific policies are exposed via role names (miner/scout/aligner/scrambler). For the teacher policy, you can pass
+`role_vibes` as a comma-separated list:
+
+```
+metta://policy/teacher?role_vibes=miner,scout
+```
+
+## Recipe usage
+
+The `recipes.experiment.scripted_agents` recipe accepts the same scripted policy names:
+
+```
+./tools/run.py recipes.experiment.scripted_agents.play agent=thinky suite=cvc_arena
+./tools/run.py recipes.experiment.scripted_agents.play agent=miner suite=cogsguard
+```
+
+## Included policies
+
+- Nim policies (short names; default when both exist): `thinky`, `nim_random`, `race_car`, `ladybug`, `cogsguard`
+- Python scripted policies (use `_py` only when Nim exists): `baseline`, `tiny_baseline`, `ladybug_py`, `cogsguard_py`
+- Core scripted policy (in `cogames`): `starter`
+- Scripted roles: `miner`, `scout`, `aligner`, `scrambler`
+- Teacher wrapper: `teacher` (forces an initial role/vibe, then delegates to the Nim policy)

cogames_agents-0.0.2/README.md

@@ -0,0 +1,47 @@
+# cogames-agents
+
+Optional scripted policies for CoGames. Use them for quick baselines, play/eval smoke tests, or as teacher policies.
+
+## Scripted policy registry
+
+The registry at `cogames_agents.policy.scripted_registry` maps short names to `metta://policy/...` URIs. Scripted agents
+and teachers share these identifiers, so the same name works for evaluation, play, and `TeacherConfig.policy_uri`.
+
+Available scripted policy names:
+
+- `baseline`
+- `ladybug`
+- `thinky`
+- `race_car`
+- `nim_random`
+- `cogsguard`
+- `cogsguard_py`
+- `teacher`
+- `miner`
+- `scout`
+- `aligner`
+- `scrambler`
+
+Role-specific policies are exposed via role names (miner/scout/aligner/scrambler). For the teacher policy, you can pass
+`role_vibes` as a comma-separated list:
+
+```
+metta://policy/teacher?role_vibes=miner,scout
+```
+
+## Recipe usage
+
+The `recipes.experiment.scripted_agents` recipe accepts the same scripted policy names:
+
+```
+./tools/run.py recipes.experiment.scripted_agents.play agent=thinky suite=cvc_arena
+./tools/run.py recipes.experiment.scripted_agents.play agent=miner suite=cogsguard
+```
+
+## Included policies
+
+- Nim policies (short names; default when both exist): `thinky`, `nim_random`, `race_car`, `ladybug`, `cogsguard`
+- Python scripted policies (use `_py` only when Nim exists): `baseline`, `tiny_baseline`, `ladybug_py`, `cogsguard_py`
+- Core scripted policy (in `cogames`): `starter`
+- Scripted roles: `miner`, `scout`, `aligner`, `scrambler`
+- Teacher wrapper: `teacher` (forces an initial role/vibe, then delegates to the Nim policy)

{cogames_agents-0.0.0.10 → cogames_agents-0.0.2}/pyproject.toml

@@ -1,26 +1,24 @@
 [build-system]
-requires = ["setuptools==80.9.0", "wheel==0.45.1", "setuptools_scm==8.1.0"]
+requires = ["setuptools==80.9.0", "wheel==0.45.1"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "cogames-agents"
+version = "0.0.2"
 description = "Optional agent policies for CoGames"
-dynamic = ["version"]
 readme = "README.md"
 requires-python = ">=3.12,<3.13"
-license = "MIT"
+license = { text = "MIT" }
 authors = [{ name = "Metta AI" }]
 classifiers = [
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.12",
+  "License :: OSI Approved :: MIT License",
   "Operating System :: POSIX :: Linux",
   "Operating System :: MacOS",
 ]
 urls = { Homepage = "https://github.com/Metta-AI/metta/tree/main/packages/cogames-agents", Repository = "https://github.com/Metta-AI/metta" }
-dependencies = ["cogames==0.3.68", "mettagrid==0.2.0.82", "numpy>=2.0.0"]
-
-[project.optional-dependencies]
-test = ["pytest", "pytest-xdist", "ruff"]
+dependencies = ["cogames>=0.0.1", "mettagrid==0.2.0.58", "numpy>=2.0.0"]
 
 [tool.setuptools.packages.find]
 where = ["src"]
@@ -43,22 +41,6 @@ include-package-data = true
   "policy/nim_agents/bindings/generated/*.py",
 ]
 
-[tool.setuptools_scm]
-tag_regex = "^cogames-agents-v(?P<version>\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?)$"
-version_scheme = "no-guess-dev"
-local_scheme = "no-local-version"
-root = "../.."
-fallback_version = "0.0.0"
-git_describe_command = [
-  "git",
-  "describe",
-  "--dirty",
-  "--tags",
-  "--long",
-  "--match",
-  "cogames-agents-v*",
-]
-
 [tool.uv]
 cache-keys = [
   { file = "src/cogames_agents/policy/nim_agents/nim_agents.nim" },

{cogames_agents-0.0.0.10 → cogames_agents-0.0.2}/setup.py

@@ -20,16 +20,8 @@ from setuptools.dist import Distribution
 NIM_AGENTS_DIR = Path(__file__).parent / "src" / "cogames_agents" / "policy" / "nim_agents"
 NIMBY_LOCK = NIM_AGENTS_DIR / "nimby.lock"
 BINDINGS_DIR = NIM_AGENTS_DIR / "bindings" / "generated"
-
-_PKG_ROOT = Path(__file__).resolve().parent
-
-
-def _read_dotfile_version(path: Path) -> str:
-    return path.read_text().strip()
-
-
-NIM_VERSION = _read_dotfile_version(_PKG_ROOT / ".nim-version")
-NIMBY_VERSION = _read_dotfile_version(_PKG_ROOT / ".nimby-version")
+REQUIRED_NIM_VERSION = os.environ.get("COGAMES_NIM_VERSION", "2.2.6")
+NIMBY_VERSION = os.environ.get("COGAMES_NIMBY_VERSION", "0.1.13")
 
 
 def _get_nimby_url() -> str | None:
@@ -39,53 +31,53 @@ def _get_nimby_url() -> str | None:
 
     if system == "Linux" and arch == "x86_64":
         return f"https://github.com/treeform/nimby/releases/download/{NIMBY_VERSION}/nimby-Linux-X64"
-    elif system == "Linux" and arch == "aarch64":
-        return f"https://github.com/treeform/nimby/releases/download/{NIMBY_VERSION}/nimby-Linux-ARM64"
     elif system == "Darwin" and arch == "arm64":
         return f"https://github.com/treeform/nimby/releases/download/{NIMBY_VERSION}/nimby-macOS-ARM64"
     elif system == "Darwin" and arch == "x86_64":
         return f"https://github.com/treeform/nimby/releases/download/{NIMBY_VERSION}/nimby-macOS-X64"
     else:
+        # For unsupported platforms (e.g., Linux ARM64), nimby must be pre-installed
         return None
 
 
-def _nim_already_installed() -> bool:
-    nim = shutil.which("nim")
-    if nim is None:
-        return False
-    result = subprocess.run([nim, "--version"], capture_output=True, text=True)
-    return f"Nim Compiler Version {NIM_VERSION}" in result.stdout
-
-
 def _build_nim() -> None:
     system = platform.system()
     arch = platform.machine()
 
-    if _nim_already_installed():
-        pass
-    elif (nimby_url := _get_nimby_url()) is not None:
-        nim_bin_dir = Path.home() / ".nimby" / "nim" / "bin"
+    nimby_url = _get_nimby_url()
+    nim_bin_dir = Path.home() / ".nimby" / "nim" / "bin"
+
+    if nimby_url is not None:
+        # Download and install nimby
         dst = nim_bin_dir / "nimby"
         with tempfile.TemporaryDirectory() as tmp:
             nimby = Path(tmp) / "nimby"
             urllib.request.urlretrieve(nimby_url, nimby)
             nimby.chmod(nimby.stat().st_mode | stat.S_IEXEC)
-            subprocess.check_call([str(nimby), "use", NIM_VERSION])
+            subprocess.check_call([str(nimby), "use", REQUIRED_NIM_VERSION])
 
             dst.parent.mkdir(parents=True, exist_ok=True)
             shutil.copy2(nimby, dst)
 
         os.environ["PATH"] = f"{dst.parent}{os.pathsep}" + os.environ.get("PATH", "")
-        os.environ["PATH"] = f"{nim_bin_dir}{os.pathsep}" + os.environ.get("PATH", "")
     else:
-        raise RuntimeError(
-            f"Nim {NIM_VERSION} is not installed and nimby download is not available for {system} {arch}. "
-            "Please install Nim manually (https://nim-lang.org/install.html) or build nimby from source."
-        )
-
-    # Sync Nim dependencies using nimby
-    if shutil.which("nimby") is not None:
-        subprocess.check_call(["nimby", "sync", "-g", str(NIMBY_LOCK)], cwd=NIM_AGENTS_DIR)
+        # For unsupported platforms, assume nim/nimby are pre-installed
+        if shutil.which("nim") is None:
+            raise RuntimeError(
+                f"Nim is not installed and nimby download is not available for {system} {arch}. "
+                "Please install Nim manually (https://nim-lang.org/install.html) or build nimby from source."
+            )
+
+    # Ensure nim/nimble binaries installed by nimby are discoverable by subprocesses.
+    os.environ["PATH"] = f"{nim_bin_dir}{os.pathsep}" + os.environ.get("PATH", "")
+
+    # Sync Nim dependencies
+    if NIMBY_LOCK.exists():
+        if shutil.which("nimby") is not None:
+            subprocess.check_call(["nimby", "sync", "-g", str(NIMBY_LOCK)], cwd=NIM_AGENTS_DIR)
+        else:
+            # nimby not available (unsupported platform with manual Nim install) - use nimble directly
+            subprocess.check_call(["nimble", "install", "-y"], cwd=NIM_AGENTS_DIR)
 
     # Create output directory for compiled binaries
     BINDINGS_DIR.mkdir(parents=True, exist_ok=True)

cogames_agents-0.0.0.10/src/cogames_agents/policy/scripted_agent/cogsguard/teacher.py → cogames_agents-0.0.2/src/cogames_agents/policy/cogsguard_teacher.py

@@ -6,12 +6,11 @@ import numpy as np
 
 from cogames_agents.policy.nim_agents.agents import CogsguardAgentsMultiPolicy
 from cogames_agents.policy.scripted_agent.cogsguard.types import Role as CogsguardRole
-from cogames_agents.policy.scripted_agent.common.roles import ROLE_VIBES
 from mettagrid.policy.policy import AgentPolicy, MultiAgentPolicy
 from mettagrid.policy.policy_env_interface import PolicyEnvInterface
 from mettagrid.simulator import Action, AgentObservation
 
-DEFAULT_ROLE_VIBES = tuple(ROLE_VIBES)
+DEFAULT_ROLE_VIBES = ("miner", "scout", "aligner", "scrambler")
 
 
 class CogsguardTeacherPolicy(MultiAgentPolicy):
@@ -36,6 +35,7 @@ class CogsguardTeacherPolicy(MultiAgentPolicy):
         self._last_action_feature_id = self._find_feature_id("last_action")
 
         self._role_action_ids = self._resolve_role_actions(role_vibes)
+        self._episode_index = [0] * self._num_agents
         self._reset_episode_state()
 
     def agent_policy(self, agent_id: int) -> AgentPolicy:
@@ -142,7 +142,6 @@ class CogsguardTeacherPolicy(MultiAgentPolicy):
         return role_action_ids
 
     def _reset_episode_state(self) -> None:
-        self._episode_index = [0] * self._num_agents
         self._forced_vibe = [False] * self._num_agents
         self._last_episode_pct = [-1] * self._num_agents
         self._step_in_episode = [0] * self._num_agents

{cogames_agents-0.0.0.10 → cogames_agents-0.0.2}/src/cogames_agents/policy/nim_agents/__init__.py

@@ -6,12 +6,12 @@ __all__ = [
     "RandomAgentsMultiPolicy",
     "ThinkyAgentsMultiPolicy",
     "RaceCarAgentsMultiPolicy",
-    "CogsguardAlignAllAgentsMultiPolicy",
+    "LadyBugAgentsMultiPolicy",
 ]
 
 # Re-export the policy classes for convenience
 from cogames_agents.policy.nim_agents.agents import (  # noqa: F401
-    CogsguardAlignAllAgentsMultiPolicy,
+    LadyBugAgentsMultiPolicy,
     RaceCarAgentsMultiPolicy,
     RandomAgentsMultiPolicy,
     ThinkyAgentsMultiPolicy,

{cogames_agents-0.0.0.10 → cogames_agents-0.0.2}/src/cogames_agents/policy/nim_agents/agents.py

@@ -55,24 +55,19 @@ class RaceCarAgentsMultiPolicy(NimMultiAgentPolicy):
         )
 
 
-class CogsguardAgentsMultiPolicy(NimMultiAgentPolicy):
-    short_names = ["role"]
+class LadyBugAgentsMultiPolicy(NimMultiAgentPolicy):
+    short_names = ["ladybug"]
 
-    def __init__(
-        self,
-        policy_env_info: PolicyEnvInterface,
-        agent_ids: Sequence[int] | None = None,
-        **_: object,
-    ):
+    def __init__(self, policy_env_info: PolicyEnvInterface, agent_ids: Sequence[int] | None = None):
         super().__init__(
             policy_env_info,
-            nim_policy_factory=na.CogsguardPolicy,
+            nim_policy_factory=na.LadybugPolicy,
             agent_ids=agent_ids,
         )
 
 
-class CogsguardAlignAllAgentsMultiPolicy(NimMultiAgentPolicy):
-    short_names = ["alignall"]
+class CogsguardAgentsMultiPolicy(NimMultiAgentPolicy):
+    short_names = ["cogsguard"]
 
     def __init__(
         self,
@@ -82,6 +77,6 @@ class CogsguardAlignAllAgentsMultiPolicy(NimMultiAgentPolicy):
     ):
         super().__init__(
             policy_env_info,
-            nim_policy_factory=na.CogsguardAlignAllPolicy,
+            nim_policy_factory=na.CogsguardPolicy,
             agent_ids=agent_ids,
         )

{cogames_agents-0.0.0.10 → cogames_agents-0.0.2}/src/cogames_agents/policy/nim_agents/cogsguard_agents.nim

@@ -8,8 +8,8 @@ const
   CargoPerMiner = 40
   ExploreSteps = 8
   RoleNames = ["miner", "scout", "aligner", "scrambler"]
-  DepotTags = ["junction", "junction", "supply_depot"]
-  HubTags = ["hub", "hub", "main_nexus"]
+  DepotTags = ["charger", "junction", "supply_depot"]
+  HubTags = ["hub", "assembler", "main_nexus"]
   StationTags = ["miner_station", "scout_station", "aligner_station", "scrambler_station"]
   ResourceNames = ["carbon", "oxygen", "germanium", "silicon"]
 
@@ -21,9 +21,6 @@ const Offsets4 = [
 ]
 
 type
-  SmartRoleCoordinator* = ref object
-    numAgents: int
-
   CogsguardAgent* = ref object
     agentId*: int
     cfg: Config
@@ -46,15 +43,9 @@ type
     chest: Option[Location]
 
     actionIds: Table[string, int]
-    lastEpisodePct: int
-    stepInEpisode: int
-    assignedRoleIdx: int
-    lastHeart: int
-    lastInfluence: int
 
   CogsguardPolicy* = ref object
     agents*: seq[CogsguardAgent]
-    smartRoleCoordinator: SmartRoleCoordinator
 
 proc getVibeName(agent: CogsguardAgent, vibeId: int): string =
   if vibeId >= 0 and vibeId < agent.cfg.vibeNames.len:
@@ -68,91 +59,6 @@ proc actionForVibe(agent: CogsguardAgent, vibe: string): int =
   let actionName = "change_vibe_" & vibe
   return agent.getActionId(actionName)
 
-proc roleIndex(roleName: string): int =
-  for idx, name in RoleNames:
-    if name == roleName:
-      return idx
-  return -1
-
-proc chooseSmartRole(coordinator: SmartRoleCoordinator, policy: CogsguardPolicy, agentId: int): int =
-  discard coordinator
-  discard agentId
-  var hasHub = false
-  var hasChest = false
-  var roleCounts = newSeq[int](RoleNames.len)
-  var junctionCounts: array[3, int] # cogs, clips, neutral/unknown
-  var heartsTotal = 0
-  var influenceTotal = 0
-  var maxStructuresSeen = 0
-
-  for agent in policy.agents:
-    if agent.hub.isSome:
-      hasHub = true
-    if agent.chest.isSome:
-      hasChest = true
-
-    if agent.assignedRoleIdx >= 0 and agent.assignedRoleIdx < RoleNames.len:
-      roleCounts[agent.assignedRoleIdx] += 1
-
-    heartsTotal += agent.lastHeart
-    influenceTotal += agent.lastInfluence
-
-    let structuresSeen = agent.depots.len + agent.stations.len + agent.extractors.len
-    if structuresSeen > maxStructuresSeen:
-      maxStructuresSeen = structuresSeen
-
-    var agentCounts: array[3, int]
-    for _, alignment in agent.depots:
-      if alignment == 1:
-        agentCounts[0] += 1
-      elif alignment == -1:
-        agentCounts[1] += 1
-      else:
-        agentCounts[2] += 1
-    for i in 0 .. 2:
-      if agentCounts[i] > junctionCounts[i]:
-        junctionCounts[i] = agentCounts[i]
-
-  if not hasHub or not hasChest:
-    return roleIndex("scout")
-
-  let minerIdx = roleIndex("miner")
-  if minerIdx >= 0 and roleCounts[minerIdx] == 0:
-    return minerIdx
-
-  let knownChargers = junctionCounts[0] + junctionCounts[1] + junctionCounts[2]
-  if knownChargers == 0:
-    return roleIndex("scout")
-
-  if junctionCounts[1] > 0 and heartsTotal > 0:
-    return roleIndex("scrambler")
-  if junctionCounts[2] > 0 and heartsTotal > 0 and influenceTotal > 0:
-    return roleIndex("aligner")
-
-  if maxStructuresSeen < 10:
-    return roleIndex("scout")
-  return minerIdx
-
-proc updateEpisodeState(agent: CogsguardAgent, episodePct: int) =
-  if episodePct == -1:
-    return
-
-  var newEpisode = false
-  if agent.lastEpisodePct == -1:
-    newEpisode = true
-  elif episodePct < agent.lastEpisodePct:
-    newEpisode = true
-  elif agent.lastEpisodePct > 0 and episodePct == 0:
-    newEpisode = true
-
-  if newEpisode:
-    agent.stepInEpisode = 0
-    agent.assignedRoleIdx = -1
-  else:
-    agent.stepInEpisode += 1
-
-  agent.lastEpisodePct = episodePct
-
 proc featureValue(
   features: seq[FeatureValue],
   featureId: int
@@ -431,7 +337,6 @@ proc parseVisible(
     result[location].add(FeatureValue(featureId: featureId.int, value: value.int))
 
 proc step*(
-  policy: CogsguardPolicy,
   agent: CogsguardAgent,
   numAgents: int,
   numTokens: int,
@@ -456,32 +361,17 @@ proc step*(
     let invGermanium = agent.cfg.getInventory(visible, agent.cfg.features.invGermanium)
     let invSilicon = agent.cfg.getInventory(visible, agent.cfg.features.invSilicon)
     let invHeart = agent.cfg.getInventory(visible, agent.cfg.features.invHeart)
-    let invInfluence =
-      if agent.cfg.features.invInfluence != 0:
-        agent.cfg.getInventory(visible, agent.cfg.features.invInfluence)
-      else:
-        0
     let invMiner = agent.cfg.getInventory(visible, agent.cfg.features.invMiner)
     let invScout = agent.cfg.getInventory(visible, agent.cfg.features.invScout)
     let invAligner = agent.cfg.getInventory(visible, agent.cfg.features.invAligner)
     let invScrambler = agent.cfg.getInventory(visible, agent.cfg.features.invScrambler)
     let cargo = invCarbon + invOxygen + invGermanium + invSilicon
 
-    agent.lastHeart = invHeart
-    agent.lastInfluence = invInfluence
-
-    let episodePct = agent.cfg.getEpisodeCompletionPct(visible)
-    agent.updateEpisodeState(episodePct)
-
     var action = agent.cfg.actions.noop
 
     if vibeName == "gear":
-      if agent.assignedRoleIdx < 0:
-        var selectedIdx = policy.smartRoleCoordinator.chooseSmartRole(policy, agent.agentId)
-        if selectedIdx < 0 or selectedIdx >= RoleNames.len:
-          selectedIdx = agent.random.rand(0 ..< RoleNames.len)
-        agent.assignedRoleIdx = selectedIdx
-      action = agent.actionForVibe(RoleNames[agent.assignedRoleIdx])
+      let choice = agent.random.rand(0 ..< RoleNames.len)
+      action = agent.actionForVibe(RoleNames[choice])
     elif vibeName == "miner":
       action = agent.actMiner(cargo, invMiner)
     elif vibeName == "scout":
@@ -519,18 +409,13 @@ proc newCogsguardAgent*(agentId: int, environmentConfig: string): CogsguardAgent
   result.actionIds = initTable[string, int]()
   for id, name in config.config.actions:
     result.actionIds[name] = id
-  result.lastEpisodePct = -1
-  result.stepInEpisode = 0
-  result.assignedRoleIdx = -1
-  result.lastHeart = 0
-  result.lastInfluence = 0
 
 proc newCogsguardPolicy*(environmentConfig: string): CogsguardPolicy =
   let cfg = parseConfig(environmentConfig)
   var agents: seq[CogsguardAgent] = @[]
   for id in 0 ..< cfg.config.numAgents:
     agents.add(newCogsguardAgent(id, environmentConfig))
-  CogsguardPolicy(agents: agents, smartRoleCoordinator: SmartRoleCoordinator(numAgents: agents.len))
+  CogsguardPolicy(agents: agents)
 
 proc stepBatch*(
   policy: CogsguardPolicy,
@@ -552,4 +437,4 @@ proc stepBatch*(
     let idx = int(ids[i])
     let obsPtr = cast[pointer](obsArray[idx * obsStride].addr)
     let actPtr = cast[ptr int32](actionArray[idx].addr)
-    step(policy, policy.agents[idx], numAgents, numTokens, sizeToken, obsPtr, numActions, actPtr)
+    step(policy.agents[idx], numAgents, numTokens, sizeToken, obsPtr, numActions, actPtr)